refactor: Gate 6 batch 5 remove strategies spectral import facades

Delete graphfl_lab/strategies/spectral star-import wrappers; canonical
strategy code remains under strategies/graphfl. spectral_fl shim unchanged.

Co-authored-by: Cursor <cursoragent@cursor.com>

Author: 2-mean

MIGRATION.md

@@ -25,7 +25,7 @@ python run_experiment.py --track cora ...
 During deprecation, old names remain available where documented:
 
 ```text
-spectral_fl
+spectral_fl (shim; `strategies.spectral` import path removed in Gate 6 batch 5)
 configs/general/...
 result_general_*   (readers only; new runs no longer write mirrors)
 general_suite_*    (readers only; new runs no longer write mirrors)

README.md

@@ -332,7 +332,6 @@ New code uses `vision`, `graphfl`, `graph_filtered_*`.
 | Old name | Role |
 |---|---|
 | `spectral_fl` | old package import shim |
-| `graphfl_lab/strategies/spectral/` | `graphfl_lab/strategies/graphfl/` wrapper |
 | `spectral_filtered_*`, `spectral_filter_strength` | config/result compatibility alias |
 | `general_suite_*`, `result_general_*` | historical output filenames (readers only; new runs use vision names) |
 

docs/maintenance/cleanup-status.md

@@ -10,11 +10,11 @@ disagree, rerun the relevant gate check and update this file from the result.
 | Field | Value |
 |---|---|
 | current_gate | Gate 4c complete on `main`; Gate 6 batches 1–3 in progress on `main` |
-| status | PR #2 merged; nightly 26288800411 green; Gate 6 batches 2–4 landed; `graphfl_lab/strategies/spectral/` and `spectral_fl` shim still present per `gate-6-prep.md` |
+| status | PR #2 merged; nightly 26288800411 green; Gate 6 batches 2–5 landed; `spectral_fl` shim and root `general_*` CLI facades remain per `gate-6-prep.md` |
 | owner | codex |
 | started_at | 2026-05-21 |
 | last_verified | see `docs/maintenance/last_gate_check.json` |
-| next_step | Gate 6 batch 5: remove `graphfl_lab/strategies/spectral/` wrappers; then `spectral_fl` shim and root `general_*` CLI facades; re-run CI/nightly after batch 5 |
+| next_step | Confirm CI green on batch 5 commit; then batch 6 (`spectral_fl` shim) only after grep shows no remaining imports; batch 7 legacy CLI tokens last |
 
 Only one Gate branch should be active at a time. In short: use a single Gate branch.
 If parallel work is
@@ -270,6 +270,7 @@ result-schema contracts.
 | 2026-05-22 | Gate 6 batch 2: new suite/vision runs should stop duplicating `general_*` artifact files while readers still resolve legacy paths. | Drop `general_suite_*` and `result_general_*` writers; add `scripts/dev/migrate_serialized_objects.py` for serialized inventory. |
 | 2026-05-22 | Gate 6 batch 3: root `run_general_*` and `plot_general_*` / `merge_general_*` / `deep_dive_general` wrappers only re-exported vision CLIs after C5. | Delete wrappers; compile canonical `run_vision_*` in CI/nightly; drop `run_general_experiment` from `gate-check 4b` contract. |
 | 2026-05-22 | Gate 6 batch 4: `graphfl_lab/experiments/general/` and `suites/general/` were star-import facades with no remaining in-repo consumers after batch 3. | Delete import-path wrappers; keep root `general_*` CLI shims and `strategies/spectral/` for batch 5+. |
+| 2026-05-22 | Gate 6 batch 5: `graphfl_lab/strategies/spectral/` mirrored `strategies/graphfl` with no in-repo Python imports; spectral math stays under `graph/operators` and `graphfl` modules. | Delete strategy import facades; use `graphfl_lab.strategies.graphfl` (or `spectral_fl.strategies.graphfl` via shim until batch 6). |
 
 ## Gate 4c Local Readiness
 
@@ -280,7 +281,7 @@ present: scripts/dev/golden.py + tests/dev/test_golden.py + tests/golden/README.
 local pass: python scripts/dev/run.py gate-check 4c
 local pass: python scripts/dev/run.py gate-check 5d-prep
 Gate 6 entry: pragmatic policy (4c + merge CI green; optional 1 more green before first deletion)
-Gate 6 hard removal: batches 2–4 done; batches 5–8 remain — see docs/maintenance/gate-6-prep.md
+Gate 6 hard removal: batches 2–5 done; batches 6–8 remain — see docs/maintenance/gate-6-prep.md
 ```
 
 ## Closure Policy

docs/maintenance/gate-6-prep.md

@@ -35,7 +35,7 @@ replace with the recommended check above unless you explicitly want a week-long
 2. [x] Remove compatibility **writers** of duplicate artifacts (`general_suite_*`, `result_general_*` mirrors); readers still accept legacy paths.
 3. [x] Remove `run_general_*` root wrappers and `plot_general_*` / `merge_general_*` / `deep_dive_general` script wrappers.
 4. [x] Remove `graphfl_lab/experiments/general/` and `graphfl_lab/experiments/suites/general/` import facades.
-5. Remove `graphfl_lab/strategies/spectral/` wrappers (keep real spectral math names in operators).
+5. [x] Remove `graphfl_lab/strategies/spectral/` wrappers (keep real spectral math names in operators).
 6. Remove `spectral_fl` package shim last, after grep shows no remaining imports outside tests explicitly checking deprecation.
 7. Remove legacy CLI choices (`spectral_filtered_*` inputs) and old suite token spellings only after suite/history policy is frozen.
 8. Update `docs/maintenance/cleanup-status.md` to `closed` and link from `docs/removed-materials.md`.

docs/maintenance/last_gate_check.json

@@ -2,6 +2,6 @@
   "gate": "5d-prep",
   "pass": true,
   "failed_checks": [],
-  "verified_at": "2026-05-22T13:06:11.020488+00:00",
-  "commit_sha": "a0ccd8d3a882a6b78946b058112df32582f30747"
+  "verified_at": "2026-05-22T13:09:27.027433+00:00",
+  "commit_sha": "a81d70286aa817c3fcd012dc30a9ae263386ef62"
 }

docs/structure.md

@@ -93,7 +93,6 @@ graphfl_lab/spectral_diagnostics.py
 graphfl_lab/strategy.py
 graphfl_lab/suite_stats.py
 graphfl_lab/update_graph.py
-graphfl_lab/strategies/spectral/
 graphfl_lab/experiments/suite.py
 graphfl_lab/experiments/stress_grid.py
 graphfl_lab/experiments/client_count_sweep.py
@@ -109,7 +108,6 @@ run_vision_*.py (canonical entrypoints; `run_general_*` removed Gate 6 batch 3)
 | `graphfl_lab/experiments/` | orchestration, subprocesses, metadata, output files | graph math, strategy internals |
 | `graphfl_lab/graph/` | relation graph construction | Flower strategies, experiment runners |
 | `graphfl_lab/strategies/graphfl/` | server-side aggregation behavior | config paths, suite output layouts |
-| `graphfl_lab/strategies/spectral/` | compatibility wrapper | new logic |
 | `graphfl_lab/strategies/baselines/` | baseline strategies, tracing helpers | graph builder internals |
 | `graphfl_lab/designs/` | method composition metadata | experiment execution |
 | `graphfl_lab/lifecycle/` | contracts, traces, state store, side-effect-free diagnostics | runtime graph builders |