From 84632cef34e300a724a91c24fa544c0ebb616193 Mon Sep 17 00:00:00 2001 From: Krzysztof kuhy Rudnicki Date: Thu, 14 May 2026 20:01:09 +0200 Subject: [PATCH] chore: spring-clean repo root (move docs, relocate batch3 script, drop stale outputs) - Move 7 loose top-level Markdown reports under docs/cleanup-2026-05/. - Relocate batch3_bloatware_uninstall.sh into phone_focus_mode/ where its ADB/phone wiring belongs. - Delete tracked out.json (empty puzzle_solver fixture). - Remove untracked clutter (mp4/wav/lcov/log/txt) from the working tree. --- .../COMPLETE_IMPLEMENTATION_SUMMARY.md | 0 .../cleanup-2026-05/DELIVERABLES_INDEX.md | 0 .../POLLING_OPTIMIZATION_REPORT.md | 0 .../QUICK_OPTIMIZATION_GUIDE.md | 0 .../QUICK_REFERENCE_SHELL_QUALITY.md | 0 .../SHELL_QUALITY_IMPLEMENTATION_SUMMARY.md | 0 .../SHELL_SCRIPT_QUALITY_GUIDELINES.md | 0 .../contracts/root-cleanup-2026-05-14.json | 16 +++++++++ .../evidence/root-cleanup-2026-05-14.json | 36 +++++++++++++++++++ out.json | 4 --- .../batch3_bloatware_uninstall.sh | 0 11 files changed, 52 insertions(+), 4 deletions(-) rename COMPLETE_IMPLEMENTATION_SUMMARY.md => docs/cleanup-2026-05/COMPLETE_IMPLEMENTATION_SUMMARY.md (100%) rename DELIVERABLES_INDEX.md => docs/cleanup-2026-05/DELIVERABLES_INDEX.md (100%) rename POLLING_OPTIMIZATION_REPORT.md => docs/cleanup-2026-05/POLLING_OPTIMIZATION_REPORT.md (100%) rename QUICK_OPTIMIZATION_GUIDE.md => docs/cleanup-2026-05/QUICK_OPTIMIZATION_GUIDE.md (100%) rename QUICK_REFERENCE_SHELL_QUALITY.md => docs/cleanup-2026-05/QUICK_REFERENCE_SHELL_QUALITY.md (100%) rename SHELL_QUALITY_IMPLEMENTATION_SUMMARY.md => docs/cleanup-2026-05/SHELL_QUALITY_IMPLEMENTATION_SUMMARY.md (100%) rename SHELL_SCRIPT_QUALITY_GUIDELINES.md => docs/cleanup-2026-05/SHELL_SCRIPT_QUALITY_GUIDELINES.md (100%) create mode 100644 docs/superpowers/contracts/root-cleanup-2026-05-14.json create mode 100644 docs/superpowers/evidence/root-cleanup-2026-05-14.json delete mode 100644 out.json rename batch3_bloatware_uninstall.sh => phone_focus_mode/batch3_bloatware_uninstall.sh (100%) 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