mirror of
https://github.com/Druthulu/BFM-decomp
synced 2026-09-27 14:02:04 -04:00
Drew T
e05dc116be
CURRENT_PHASE.md gains a CRASH-RECOVERY checkpoint (not a fresh-session handoff): what is running, restart order, the measured fleet/scaling facts, the fixes that must not regress, and the ordered work queue. Lanes: drafter (never stop it), gater (restartable), maintenance (free A-prop sibling lane), stallguard (60s auto-repair). Drafting holds no lock; one narrow draw-vs-gate lock exists because build_wave_atlas reads corpus.stubs and misreads substituted drafts mid-gate. main is off the wave critical path — 157 drafts parked to .run/main_queue/ rather than stalling the gater for another hour on a bisecting whole-EXE rebuild. api_agent: 5xx retried like 429 (a 502 was abandoning functions at near-19), HTTP_TIMEOUT 420s not 1800 (a hung request parked an agent 30 min), EXTRA_READABLE for tooling briefs, and bare-directory paths no longer refused against their own granted root.
phase-ends/ — the living record
PhaseEnd_Phase[N].md— written at each phase boundary (format defined inPROJECT_CONTEXT.md). Append-only history: build log, deviations, commit message, rules added, changelog. Never deleted.CURRENT_PHASE.md— the in-phase autonomous log: approved phase plan, per-task checkboxes, current task pointer, blockers. Created at phase start, updated after every task, absorbed into the PhaseEnd file and deleted at phase close. This is the crash/compaction recovery point.- Sessions read
PROJECT_CONTEXT.md, then everyPhaseEnd_*.mdin numeric order, thenCURRENT_PHASE.md(if present) — in that order, every session.