11%

Section 07: Close-out — Cluster Bug Retirement + TPR + Hygiene

Status: Not Started Goal: Cluster retirement. Per bug-tracker/clusters.md Cluster C: this umbrella’s completion retires BUG-04-119/091/061/114 in lockstep, since the umbrella IS the cure (per plans/aims-burden-tracking/ obe_on_completion: precedent).

Context: §02–§06 delivered code + tests. This section runs the cross-cutting review gates that catch integration issues, then performs the mechanical retirement work.

Reference implementations: N/A (orchestration only).

Depends on: §02, §03, §04, §05, §06 all status: complete.

Intelligence Reconnaissance

Queries planned at section start:

  • scripts/intel-query.sh --human symbol-plans "collect_mono_functions" --repo ori — final cross-plan reference audit; verify no stale references to the pre-§02 4-arg signature anywhere.
  • scripts/intel-query.sh --human bugs-for aot-mono-completeness — confirm the four absorbed bugs are the only open bugs blocking this plan.

Results summary (≤500 chars, recorded 2026-05-14) [ori]: TO BE POPULATED at section start by running the queries above. Scaffold authored 2026-05-14 — queries deferred until §02–§06 are complete and the audit surface reflects the landed cure.

07.1 Full-plan /tpr-review

File(s): N/A (review orchestration)

  • Invoke /tpr-review on the full commit set spanning §02–§06 commits. Per .claude/rules/skill-control-contract.md §Caller Foreground Dispatch Contract: foreground only, 20-45 min wall-clock per round, up to 5 rounds.
  • Reviewers: codex + gemini + opencode (auto-resolved per orchestrator-identity-detection).
  • Apply trust-tier verification per tp-help/consensus-loop-wrapper.md §2: gemini findings get full independent verification against actual code; codex/opencode findings get spot-check.
  • Iterate fix-and-re-run until consensus clean.
  • Record per-round findings in this section’s ### Findings block; flip each to Resolved: as fixed.
  • Subsection close-out (07.1) — MANDATORY before §07.2:
    • /tpr-review returns status: clean, exit_reason: converged (or cap_reached_clean).
    • Zero open findings.
    • Run /improve-tooling retrospectively on §07.1 — capture any tooling pain from the multi-round TPR.

07.2 Full-plan /impl-hygiene-review

File(s): N/A (review orchestration)

  • Invoke /impl-hygiene-review with autoscope over the §02–§06 work arc (per CLAUDE.md §Fix Completeness: hygiene runs AFTER TPR).
  • Apply findings inline per impl-hygiene.md §Findings Disposition — every hygiene finding fixed in this section’s commit, never deferred to bug.
  • Subsection close-out (07.2) — MANDATORY before §07.3:
    • /impl-hygiene-review returns clean.
    • All findings resolved inline.

07.3 Bug retirement + cluster update

File(s): bug-tracker/section-04-codegen-llvm.md, bug-tracker/clusters.md, possibly bug-tracker/plans/BUG-04-NNN/ if any scaffolded mid-plan.

  • In bug-tracker/section-04-codegen-llvm.md: flip the four tracker entries to - [x]:
    • [BUG-04-119][high] → - [x] with Resolved: 2026-MM-DD by plans/aot-mono-completeness/section-02-import-sigs-traversal.md annotation.
    • [BUG-04-091][high] → - [x] with Resolved: 2026-MM-DD by plans/aot-mono-completeness/section-03-inherent-method-mono.md.
    • [BUG-04-061][medium] → - [x] with Resolved: 2026-MM-DD by plans/aot-mono-completeness/section-04-complex-generic-arg-mono.md.
    • [BUG-04-114][medium] → - [x] with Resolved: 2026-MM-DD by plans/aot-mono-completeness/section-05-builtin-apply-mono.md.
  • Inside each entry body, add **Delivered by:** [plans/aot-mono-completeness/section-NN-*.md](../plans/aot-mono-completeness/section-NN-*.md) (per impl-hygiene.md §PLAN_DELIVERY_DRIFT cross-ref).
  • In bug-tracker/clusters.md: update Cluster C entry:
    • Change “Proposed plan: plans/aot-mono-completeness/” → “Active plan: plans/aot-mono-completeness/ (complete 2026-MM-DD)”.
    • Add a final line noting closure.
  • If any of the four bugs had bug-tracker/plans/BUG-04-NNN/ directories scaffolded mid-plan (by an intervening /fix-bug run before the umbrella absorbed them), move those plan dirs to bug-tracker/plans/completed/BUG-04-NNN/. Verify via ls bug-tracker/plans/BUG-04-{119,091,061,114} before vs after.
  • Subsection close-out (07.3) — MANDATORY before §07.4:
    • Four entries flipped to [x] with Resolved: annotations.
    • Cluster C updated to reflect closure.
    • Any intervening plan dirs moved to completed/.

07.4 Plan-corpus check + commit + version bump

File(s): N/A (verification + orchestration)

  • Run python -m scripts.plan_corpus check plans/aot-mono-completeness/. Exit 0 required.
  • Run python -m scripts.plan_corpus coherence plans/aot-mono-completeness/. Exit 0 required.
  • Run python3 scripts/prose-lint.py plans/aot-mono-completeness/. Exit 0 required.
  • Run compiler_repo/scripts/bump-build.sh to advance BUILD_NUMBER.
  • Invoke /commit-push to ship the close-out commits (cluster retirement, version bump, any TPR-driven fixes from §07.1, hygiene fixes from §07.2). Commit message conventional-commit type: feat (the four absorbed bugs are user-visible behavior gains).
  • Verify the wrapper-repo + compiler_repo commits push cleanly.
  • Subsection close-out (07.4) — status: complete:
    • plan_corpus check + coherence + prose-lint all exit 0.
    • BUILD_NUMBER bumped.
    • /commit-push succeeded.

07.N Completion Checklist

  • All 07.1, 07.2, 07.3, 07.4 subsections status: complete.
  • All four mission success criteria met (see 00-overview.md):
    • BUG-04-119 retired; tests pass.
    • BUG-04-091 retired; test_generic_method_on_generic_type un-ignored and passes.
    • BUG-04-061 retired; Option<[int]>.unwrap() works.
    • BUG-04-114 retired; __cast in generic body works.
  • ./test-all.sh green.
  • Dual-exec parity preserved.
  • Plan frontmatter (00-overview.md) flipped to status: complete, reviewed: true.
  • Section frontmatter (this file) flipped to status: complete, reviewed: true.