chore: prune boilerplate and refresh stale docs

- Remove 257 redundant per-definition comment stubs across the package
- Drop dead nonlocal declarations in autoslicer_detection.py
- Document the swapped flag and swap_left_right in architecture docs
- Remove unsupported 'legacy override' claims from autotune/runtime docs

docs/architecture.md

@@ -95,10 +95,11 @@ Key properties:
 
 ## Geometry Model
 
-`PhotoSlice` stores 4-point quadrilateral and flags:
+`PhotoSlice` stores a 4-point quadrilateral and flags:
 
 - `locked`
 - `side_handles_enabled`
+- `swapped` (persistent left/right mirror state, honored by normalization)
 
 It supports:
 
@@ -106,6 +107,7 @@ It supports:
 - rectangle detection (`is_perfect_rectangle`)
 - squarize while preserving tilt
 - reset to axis-aligned orientation
+- explicit left/right swap (`swap_left_right`)
 
 ## Persistence Model