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

101 lines
4.5 KiB
Markdown

# 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:
```text
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. |