docs: Gate 6 batch 8 close cleanup-status and record tombstones

Mark cleanup-status closed, expand removed-materials with Gate 6 removal
inventory and post-Gate-6 debt, and point migration/plan docs at the closure.

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

Author: 2-mean

MIGRATION.md

@@ -2,7 +2,8 @@
 
 This guide tracks the staged migration from the historical `spectral_fl`
 identity to the planned `graphfl_lab` identity. The migration is not complete
-yet; follow `docs/maintenance/cleanup-status.md` for current gate status.
+yet. Gate 6 hard cleanup is complete; see `docs/removed-materials.md` for
+tombstones and `docs/maintenance/cleanup-status.md` (closed) for the execution log.
 
 ## For Users
 

docs/framework/cleanup-plan.md

@@ -14,9 +14,9 @@ Stage risky renames: canonical name -> alias -> internal migration -> docs/confi
 
 ## Resumable Execution
 
-Long-running cleanup/rename work is tracked in
-`docs/maintenance/cleanup-status.md`. Use that file for current gate state,
-unexpected findings, existing-plan mapping, and the next safe action.
+Gate 6 hard cleanup is complete. The execution log is in
+`docs/maintenance/cleanup-status.md` (**closed**). Removal tombstones and
+post-Gate-6 compatibility debt are in `docs/removed-materials.md`.
 
 Gate checks run through:
 

docs/maintenance/cleanup-status.md

@@ -1,20 +1,23 @@
 # GraphFL Lab Cleanup Status
 
-This file is the source of truth for the staged cleanup/rename execution state.
-Git is the source of truth for code state; this file records intent,
-checkpoint status, and the next safe action. If Git state and this file
-disagree, rerun the relevant gate check and update this file from the result.
+**Status: closed** (Gate 6 hard cleanup complete on `main`, 2026-05-22).
+
+This file recorded the staged cleanup/rename execution. Git remains the source of
+truth for code; long-term removal notes and tombstones live in
+[`docs/removed-materials.md`](../removed-materials.md). Rerun
+`python scripts/dev/run.py gate-check <gate>` only when reopening maintenance work.
 
 ## Current Status
 
 | Field | Value |
 |---|---|
-| current_gate | Gate 4c complete on `main`; Gate 6 batch 7 in progress on `main` |
-| status | PR #2 merged; nightly 26288800411 green; Gate 6 batches 2–7 landed; batch 8 (close status doc) and `general_*` CLI facades remain |
+| current_gate | Gate 6 complete (batches 2–7 on `main`; batch 8 doc closure) |
+| status | **closed** — PR #2 merged; nightly 26288800411; Gate 6 batches 2–7 landed; CI green on batch 7 (`26290266011`) |
 | owner | codex |
 | started_at | 2026-05-21 |
-| last_verified | see `docs/maintenance/last_gate_check.json` |
-| next_step | Batch 8: mark `cleanup-status.md` closed, extend `removed-materials.md` tombstones; optional: remove root `general_*` CLI facades in a later batch if still listed in compatibility docs |
+| closed_at | 2026-05-22 |
+| last_verified | `docs/maintenance/last_gate_check.json` (5d-prep pass after batch 7) |
+| next_step | none for Gate 6; optional post-Gate-6 debt: `graphfl_lab/general_*` CLI facades (see `removed-materials.md`) |
 
 Only one Gate branch should be active at a time. In short: use a single Gate branch.
 If parallel work is
@@ -275,6 +278,7 @@ result-schema contracts.
 | 2026-05-22 | Deleting only `spectral_fl/__init__.py` left an on-disk `spectral_fl/__pycache__` tree; Python 3 still exposed a namespace package and gate-check 3 flagged the tracked path until the directory was removed. | Delete the full `spectral_fl/` directory (not only `__init__.py`); assert `ModuleNotFoundError` after clearing `sys.modules`. |
 | 2026-05-22 | Gate 6 batch 7 pre-check: no `configs/**` files use `ours_spectral_filtered_*` or `spectral_filtered_*`; reporting still pairs legacy result variant tags via `reporting.py` prefixes. | Remove CLI `choices`/dual flags and suite `parse_target_variant` spectral branch; keep `config_io` JSON key alias, lifecycle/strategy input aliases, and report readers. |
 | 2026-05-22 | Gate 6 batch 7: public CLI listed `spectral_filtered_*` choices and dual `--spectral-filter-strength`; suite parser accepted `ours_spectral_filtered_*` launch tokens. | Drop argparse choices/flags and suite launch tokens; keep runtime aggregation aliases and `reporting.py` legacy result-tag pairing for historical artifacts. |
+| 2026-05-22 | Gate 6 batch 8: hard-removal checklist in `gate-6-prep.md` steps 1–7 complete; batch 8 is documentation closure only. | Mark this file `closed`; record Gate 6 tombstones in `docs/removed-materials.md`; leave `general_*` CLI facades as documented post-Gate-6 debt. |
 
 ## Gate 4c Local Readiness
 
@@ -284,11 +288,11 @@ present: docs/maintenance/last_nightly_run.json (run 26288800411, success)
 present: scripts/dev/golden.py + tests/dev/test_golden.py + tests/golden/README.md
 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–7 done; batch 8 (doc closure) remains — see docs/maintenance/gate-6-prep.md
+Gate 6: batches 2–7 complete; batch 8 doc closure complete — see docs/removed-materials.md
 ```
 
 ## Closure Policy
 
-After Gate 6 completes, mark this file `closed`. Keep only a tombstone link from
-`docs/removed-materials.md`.
+This file is **closed**. Gate 6 hard cleanup (batches 2–7) and documentation
+closure (batch 8) are complete. Historical findings above are preserved for
+audit; active removal inventory is in `docs/removed-materials.md`.

docs/maintenance/gate-6-prep.md

@@ -38,7 +38,7 @@ replace with the recommended check above unless you explicitly want a week-long
 5. [x] Remove `graphfl_lab/strategies/spectral/` wrappers (keep real spectral math names in operators).
 6. [x] Remove `spectral_fl` package shim last, after grep shows no remaining imports outside tests explicitly checking deprecation.
 7. [x] 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`.
+8. [x] Update `docs/maintenance/cleanup-status.md` to `closed` and link from `docs/removed-materials.md`.
 
 ## Verify After Each Batch
 

docs/maintenance/last_gate_check.json

@@ -2,6 +2,6 @@
   "gate": "5d-prep",
   "pass": true,
   "failed_checks": [],
-  "verified_at": "2026-05-22T13:20:40.596332+00:00",
-  "commit_sha": "ff62dd5850d7320b1b192ec3be9b8b382b75b092"
+  "verified_at": "2026-05-22T13:25:49.091264+00:00",
+  "commit_sha": "3442c0caf7e818d39bd2d6b5f36e68cc15f6df03"
 }

docs/removed-materials.md

@@ -1,21 +1,45 @@
 # Removed Materials And Tombstones
 
 This document records material removed or archived during the GraphFL Lab
-cleanup/rename. It is also the long-term pointer for closed maintenance
-documents after Gate 6.
+cleanup/rename. It is the long-term pointer for closed maintenance documents
+after Gate 6.
 
 ## Release Anchors
 
 | Anchor | Status | Notes |
 |---|---|---|
 | `pre-graphfl-rename` | created | SHA `e647da931bb3a78cc228ac2ad31103537b5ed640`; Gate 0 workspace baseline before Gate 1 inventory. |
 
+## Gate 6 Hard Cleanup (2026-05-22)
+
+Execution log (findings and decisions): [`docs/maintenance/cleanup-status.md`](maintenance/cleanup-status.md) (**closed**).
+
+| Removed surface | Batch | Replacement / policy |
+|---|---|---|
+| `general_suite_*` / `result_general_*` artifact **writers** | 2 | New runs emit `vision_suite_*` / `result_vision_*` only; readers still resolve legacy paths |
+| `run_general_*` root entrypoints | 3 | `run_vision_*` |
+| `plot_general_convergence.py`, `merge_general_fedavg_ours.py`, `deep_dive_general.py` | 3 | `plot_vision_convergence.py` and vision-named analysis helpers |
+| `graphfl_lab/experiments/general/`, `graphfl_lab/experiments/suites/general/` | 4 | `graphfl_lab/experiments/vision/`, `suites/vision/` |
+| `graphfl_lab/strategies/spectral/` import facades | 5 | `graphfl_lab/strategies/graphfl/` |
+| `spectral_fl/` package shim | 6 | `graphfl_lab`; scan pickles via `scripts/dev/migrate_serialized_objects.py` |
+| CLI `spectral_filtered_*` argparse choices; `--spectral-filter-strength` flag | 7 | `graph_filtered_*` choices; `--graph-filter-strength`; JSON key alias `spectral_filter_strength` retained in `config_io` |
+| Suite launch tokens `ours_spectral_filtered_*` | 7 | `ours_graph_filtered_*`; legacy result tags still paired in `reporting.py` |
+
+## Post-Gate-6 Compatibility Debt (intentional)
+
+| Surface | Status | Notes |
+|---|---|---|
+| `graphfl_lab/general_*`, `graphfl_lab/cli/general_*` | retained | thin CLI/import facades; not part of Gate 6 batch 2–7 |
+| `general_suite_*` / `result_general_*` artifact **readers** | retained | historical experiment directories |
+| Runtime `spectral_filtered_*` aggregation **input** aliases | retained | lifecycle/strategy accept legacy target strings |
+| `spectral_filter_strength` in traces / JSON config keys | retained | maps to `graph_filter_strength` |
+
 ## Tombstones
 
 | Path or material | Status | Replacement |
 |---|---|---|
-| `spectral_fl/__init__.py` (package shim) | removed Gate 6 batch 6 | `graphfl_lab` canonical imports; serialized assets scanned via `scripts/dev/migrate_serialized_objects.py` |
-| `docs/maintenance/cleanup-status.md` | active until Gate 6 | After Gate 6, mark closed and link from this table. |
+| `docs/maintenance/cleanup-status.md` | **closed** Gate 6 batch 8 | This file + git history; use `gate-check` when reopening maintenance |
+| `spectral_fl/__init__.py` (package shim) | removed Gate 6 batch 6 | `graphfl_lab` canonical imports |
 | `docs/framework/experimental-design.md` | removed duplicate bridge | `docs/framework/graph_fl_experimental_design.md`, `docs/framework/graph_fl_experimental_design_appendix.md` |
 
 ## Archive Policy