diff --git a/COMPLETE_IMPLEMENTATION_SUMMARY.md b/docs/cleanup-2026-05/COMPLETE_IMPLEMENTATION_SUMMARY.md similarity index 100% rename from COMPLETE_IMPLEMENTATION_SUMMARY.md rename to docs/cleanup-2026-05/COMPLETE_IMPLEMENTATION_SUMMARY.md diff --git a/DELIVERABLES_INDEX.md b/docs/cleanup-2026-05/DELIVERABLES_INDEX.md similarity index 100% rename from DELIVERABLES_INDEX.md rename to docs/cleanup-2026-05/DELIVERABLES_INDEX.md diff --git a/POLLING_OPTIMIZATION_REPORT.md b/docs/cleanup-2026-05/POLLING_OPTIMIZATION_REPORT.md similarity index 100% rename from POLLING_OPTIMIZATION_REPORT.md rename to docs/cleanup-2026-05/POLLING_OPTIMIZATION_REPORT.md diff --git a/QUICK_OPTIMIZATION_GUIDE.md b/docs/cleanup-2026-05/QUICK_OPTIMIZATION_GUIDE.md similarity index 100% rename from QUICK_OPTIMIZATION_GUIDE.md rename to docs/cleanup-2026-05/QUICK_OPTIMIZATION_GUIDE.md diff --git a/QUICK_REFERENCE_SHELL_QUALITY.md b/docs/cleanup-2026-05/QUICK_REFERENCE_SHELL_QUALITY.md similarity index 100% rename from QUICK_REFERENCE_SHELL_QUALITY.md rename to docs/cleanup-2026-05/QUICK_REFERENCE_SHELL_QUALITY.md diff --git a/SHELL_QUALITY_IMPLEMENTATION_SUMMARY.md b/docs/cleanup-2026-05/SHELL_QUALITY_IMPLEMENTATION_SUMMARY.md similarity index 100% rename from SHELL_QUALITY_IMPLEMENTATION_SUMMARY.md rename to docs/cleanup-2026-05/SHELL_QUALITY_IMPLEMENTATION_SUMMARY.md diff --git a/SHELL_SCRIPT_QUALITY_GUIDELINES.md b/docs/cleanup-2026-05/SHELL_SCRIPT_QUALITY_GUIDELINES.md similarity index 100% rename from SHELL_SCRIPT_QUALITY_GUIDELINES.md rename to docs/cleanup-2026-05/SHELL_SCRIPT_QUALITY_GUIDELINES.md diff --git a/docs/superpowers/contracts/root-cleanup-2026-05-14.json b/docs/superpowers/contracts/root-cleanup-2026-05-14.json new file mode 100644 index 0000000..55c5a59 --- /dev/null +++ b/docs/superpowers/contracts/root-cleanup-2026-05-14.json @@ -0,0 +1,16 @@ +{ + "title": "Repo root spring cleaning", + "objective": "Remove stray top-level artifacts: relocate seven loose Markdown reports into docs/cleanup-2026-05/, move batch3_bloatware_uninstall.sh into phone_focus_mode/, delete the stale out.json puzzle_solver output, and physically remove untracked runtime/binary garbage (videos, wavs, lcov, plan/log/text files) from the working tree.", + "acceptance_criteria": [ + "No loose *_SUMMARY.md / *_GUIDE.md / *_REPORT.md / *_GUIDELINES.md / DELIVERABLES_INDEX.md files remain at repo root.", + "batch3_bloatware_uninstall.sh lives under phone_focus_mode/.", + "out.json is removed from the index.", + "Working tree contains no .mp4 / .wav / .lcov / cinema_plan_*.txt / batch3_execution.log / out.txt at the root." + ], + "out_of_scope": [ + "Editing the moved documents' contents.", + "Removing any tracked code or library files.", + "Modifying .gitignore beyond the existing patterns." + ], + "verifier": "git status --short && ls /home/kuhy/testsAndMisc | grep -E '\\.(md|mp4|wav|lcov)$|^out\\.|^cinema_plan|^batch3_'" +} diff --git a/docs/superpowers/evidence/root-cleanup-2026-05-14.json b/docs/superpowers/evidence/root-cleanup-2026-05-14.json new file mode 100644 index 0000000..3712055 --- /dev/null +++ b/docs/superpowers/evidence/root-cleanup-2026-05-14.json @@ -0,0 +1,36 @@ +{ + "intent": "Spring-clean repo root: relocate documentation, move misplaced phone-focus script, drop stale puzzle_solver output, delete untracked binary/text garbage.", + "scope": [ + "docs/cleanup-2026-05/ (new home for 7 loose Markdown reports)", + "phone_focus_mode/batch3_bloatware_uninstall.sh (new location)", + "out.json (deleted)", + "Untracked: moviepy_demo.mp4, moviepy_showcase_full.mp4, coverage.lcov, test_input*.wav, batch3_execution.log, cinema_plan_2025-01-25.txt, out.txt", + "Non-goal: editing the moved documents or any code" + ], + "changes": [ + "git mv 7 *.md from root into docs/cleanup-2026-05/.", + "git mv batch3_bloatware_uninstall.sh -> phone_focus_mode/.", + "git rm out.json (stale puzzle_solver fixture, empty).", + "rm untracked binaries and stray text outputs from the working tree." + ], + "verification": [ + { + "command": "git status --short", + "result": "pass", + "evidence": "Only renames (R), the out.json deletion (D), and the new contract/evidence files are staged; no untracked clutter remains at repo root." + }, + { + "command": "ls /home/kuhy/testsAndMisc | grep -E '\\.(md|mp4|wav|lcov)$|^out\\.|^cinema_plan|^batch3_'", + "result": "pass", + "evidence": "Empty output - no stray root-level docs/media/output files remain." + } + ], + "risks": [ + "Moving the 7 MD files might break links that reference them at the old root path. Mitigation: they were never linked from tracked code/tools.", + "Relocating batch3_bloatware_uninstall.sh to phone_focus_mode/ changes invocation path. Mitigation: it was untested and not wired into any service; documented in the move." + ], + "rollback": [ + "git revert HEAD on the cleanup commit restores all renames and the out.json deletion.", + "Untracked deletions are unrecoverable from git; restore from backups if needed (no production references exist)." + ] +} diff --git a/out.json b/out.json deleted file mode 100644 index 59296f5..0000000 --- a/out.json +++ /dev/null @@ -1,4 +0,0 @@ -{ - "squares": [], - "notes": [] -} diff --git a/batch3_bloatware_uninstall.sh b/phone_focus_mode/batch3_bloatware_uninstall.sh similarity index 100% rename from batch3_bloatware_uninstall.sh rename to phone_focus_mode/batch3_bloatware_uninstall.sh