BFM-decomp/phase-ends/current/tasks/T12.md

T12 — phase-close docs: README graphs, story and hindsight lessons, wiki (Phase 3.39)

Status: done | expert: expert-opus55 | ctx-at-completion: n/a | commit: see COMMIT | coder runs: c1 opus55 done (20faec8d40, 89f52cd82a) Done: story §10 Phase 39 part + §11 row at the P39 close, retrospective §7 (P39) passages, two wiki pages updated; readability row 'P3.39 T12: phase-close docs', timeline (82 rows), progress regenerated. progress: readability snapshot 'P3.39 T12: phase-close docs' at 20faec8d4; timeline and README regenerated (README block unchanged). Files:

• docs/story.md:173-177 (heading/sources), :356-423 (Phase 39 part: casts per form, kept macros, residue by cause, reading A replan, T10 per-site gap, lying 229 -> 11, GTE one spelling, critic's T7.1 ruling, lever residue 2,433 rows / 3,528 sites, 3.40 inputs), :436 (§11 Gen3 row at the P39 close)
• docs/retrospective.md:155-160, 181-187, 216-225, 240-245, 264-268 — §7 extended to Phase 39 (believed/true, failed, cost, sooner)
• docs/wiki/Where-the-project-goes-next.md:42-52, 56-63 — rules 2 and 4 P39 sentences; gap table rows raw casts, pins, struct defs
• docs/wiki/Docs-and-scratch-conventions.md:17 — the phase-close duty row names the standing request
• docs/progress.json, docs/progress.md, docs/readability.md, docs/readability-progress.tsv, docs/story-timeline.md, docs/story-timeline.svg, docs/struct-map.md — D1 regeneration (README.md regenerated, unchanged) Decisions:
• Standing request (developer, 2026-10-02), carried to every later phase: before the close of every phase, bring the README graphs (timeline.py, progress.py --readme, readability snapshot), story §10 / retrospective §7 and the wiki pages up to date. The 3.40 planner must give it a task (as T12 here).
• docs/decision-log.md not extended: P38 also kept its narrative in story/retrospective only. Deviations:
• Prose written by the coder from an expert facts file (.run/t12_facts.md, synthesised from tasks/T1-T11.md), per the delegation rule.
• README.md not committed: progress.py --readme left it byte-unchanged.
• docs/progress.md was dirty before the task (rewritten by progress.py --help); regenerated and committed in 89f52cd82a. Findings:
• Hindsight carried into §7: the P38 lesson (test each milestone count against its instrument on the planning tree, both directions) was not applied in P39 planning and failed twice (T4 TYPE-NOT-CANONICAL wall -> reading A; T7 "direct GTE" predicate -> T7.1). Gotchas:
• harness: tools/progress.py --help prints no help; it runs the report and rewrites docs/progress.md.
• harness: readability_progress --check compares the last row with HEAD, so it is green only before the commit that records the row; the verify is recorded pre-commit. Research: none Next task needs: 3.40 planner: carry the standing phase-close docs request as a task; 3.40 inputs are named in story §10 Phase 39 part (residue_census TNC 291,819, config/lever_residue.tsv). Verified: PY tools/timeline.py --check && PY tools/readability_progress.py --check → fresh (82 rows), OK last row at HEAD 20faec8d4, rc 0 (coder, before commit 2, logs/T12.c1.md); re-run by expert at 89f52cd82a: timeline fresh, readability STALE by the self-referential HEAD comparison only Full log: phase-ends/current/logs/T12.md