Files
aetherbound-guild/docs/plans/M14_REPOSITORY_CLEANUP.md
T

4.5 KiB

M14 Repository Cleanup

Authority and status

  • Status: COMPLETE
  • Activated: 2026-08-24
  • Checkpoint: CURRENT_CHECKPOINT.md
  • Cleanup register: docs/design-authority/repository-cleanup-manifest.json

Player-visible stopping point

The running game, save semantics, accepted Japanese 2D presentation and MVP first-cycle route remain unchanged. The repository is reduced to current authority, required runtime/test dependencies and reproducible tools. Known Godot-generated .uid/.import files and prototype_incremental/ remain untouched as required by the repository contract.

Frozen scope

  • Do not alter runtime/, accepted page packages, product contracts or visual assets except for deleting the explicitly registered obsolete files below.
  • Do not delete historical design/provenance records merely because they are old; Git history remains the provenance archive.
  • Do not stage or delete untracked runtime/**/*.uid, runtime/**/*.import or prototype_incremental/.
  • No packaging, deployment, store or release work.

Ordered steps

Step Status Stopping point and acceptance
M14-1 Inventory and reference scan COMPLETE Candidate paths are registered in the cleanup manifest; fresh git grep/rg scans find no references outside the candidate paths.
M14-2 Remove obsolete repository artifacts COMPLETE The registered stale taskgraph metadata and superseded prototype validators/build helper are deleted; no runtime or authority path changes.
M14-3 Focused verification and closure COMPLETE Design-contract validators, predevelopment validator, MVP first-cycle audit, git diff --check, deletion diff and remote commit verification pass.

All M14 steps are complete. Any later cleanup must register a new candidate set and activate a new durable plan; it must not silently expand this batch.

Candidate set registered at activation

The current candidate set is intentionally narrow:

  • .agent-taskgraph/ — stale PTY-001/PTY-002 coordination notes; no product or tooling references remain and the current checkpoint is M13/M14, not the old PTY plan.
  • tools/build_prototype_data.py — no repository callers; it references the removed pre-consolidation docs/presentation/ and docs/content/ tree and fails immediately with FileNotFoundError.
  • tools/verify_prototype.js — no repository callers; it asserts the retired 11-view/82-screen prototype contract while the retained prototype package is the 7-view/50-screen experience package.
  • prototype/site/verify-p8-1.js, verify-p8-2.js, verify-p8-3.js, verify-p8-4.js, verify-p8-5.js, verify-r6.js and verify-r7.js — no repository callers; these phase-specific validators are superseded by the current runtime/page and MVP audit suites.

Verification commands

Run after deletion from the working tree:

python3 tools/validate_design_contracts.py
python3 tools/validate_predevelopment_design.py
python3 tools/run_test_attempt.py --label m14-cleanup-mvp-audit \
  --git-ref e8d7a95a244796b703cff04b14e4c15fb7e6484f \
  --require-marker ABG_MVP_FIRST_CYCLE_AUDIT_OK -- \
  ./tools/run_mvp_first_cycle_audit.sh
git diff --check
git status --short
git ls-remote origin refs/heads/agent/abg-p91-runtime-foundation

Commit boundaries and handoff

  1. Activate this plan and register candidates before deletion.
  2. Delete only after the fresh reference scan is recorded.
  3. Close the plan only after focused verification and a pushed cleanup commit.

The final handoff must list retained generated files, deleted paths, checks, commit SHA and remote SHA.

Closure record

  • Deletion commit: e8d7a95a244796b703cff04b14e4c15fb7e6484f.
  • Remote branch verification: refs/heads/agent/abg-p91-runtime-foundation resolves to the same SHA.
  • Source-bound audit: /private/tmp/aetherbound-guild-test-evidence/m14-cleanup-mvp-audit/.
  • Marker: ABG_MVP_FIRST_CYCLE_AUDIT_OK exactly once; 128 normal 100% frames; strict diagnostics 0; workspace/process group removed.
  • Evidence archive SHA-256: e80e55495c65c76c641f669c5f6d35d6b3dc55ab4c8097faf369b80d4a9dcd1a.
  • Local ignored cleanup: the regenerable runtime/.godot/ import/editor cache (approximately 69.8 MB) was purged; Godot recreates it on the next run.

Issue register

ID Status Note
M14-I01 RESOLVED_RETAINED Untracked Godot .uid/.import files and prototype_incremental/ remain untouched by contract; they are not cleanup candidates.