diff --git a/docs/CURRENT-STATE.md b/docs/CURRENT-STATE.md index 13c53bc..51f0798 100644 --- a/docs/CURRENT-STATE.md +++ b/docs/CURRENT-STATE.md @@ -208,7 +208,7 @@ | # | Gate | What closes it | Owner | Evidence of current state | |---|------|----------------|-------|---------------------------| | G1 | Audit Phase 3: fresh-agent grounding test | 3 clean-context probes score the 7-question set against this doc; holes map made | session | CLOSED 2026-07-18: 3 probes, 21/21 PASS, holes H1 (amended into G9) + H2 (no action) -- `docs/audit/phase3-grounding-test-20260718.md` | -| G2 | Audit Phase 4: GA-R1..R7 structural rulings + the stage-status vocabulary A/B | operator rules each individually | operator | IN PROGRESS: GA-R3, GA-R5, GA-R1 RATIFIED 2026-07-18 (`docs/audit/ga-rulings.md`); GA-R2 draft delivered; GA-R6, GA-R4, GA-R7, vocabulary A/B pending | +| G2 | Audit Phase 4: GA-R1..R7 structural rulings + the stage-status vocabulary A/B | operator rules each individually | operator | IN PROGRESS: GA-R3, GA-R5, GA-R1, GA-R2 RATIFIED 2026-07-18 (`docs/audit/ga-rulings.md`); GA-R6 draft delivered; GA-R4, GA-R7, vocabulary A/B pending | | G3 | Audit Phase 5: repair sweep of GA-F01..F14 (incl. memory hygiene GA-F05..F08, skill sweep) | operator-gated fix batches, each commit naming its GA-F | operator + session | FREEZE in effect; zero fixes applied (charter section 1) | | G4 | The two D-130 verifications (charter-exempt, read-only/throwaway): (v7) v0.9.8 volume-replace-under-running-domain on a throwaway domain; (v8) lifecycle ignore_changes suppression of the forced replacement | run them, capture output | session | TO RUN (`docs/audit/env-snapshot-20260718.md:47-49`) | | G5 | D-130 mechanism ruling (seed-volume durable fix) | operator rules in Phase 5, quoting G4's captured output | operator | D-130 unassigned; next-free D confirmed 130 (`ledger-scan` run 2026-07-18; no `^## D-130` in design-decisions.md) | diff --git a/docs/audit/ga-rulings.md b/docs/audit/ga-rulings.md index 87c0e56..674ac23 100644 --- a/docs/audit/ga-rulings.md +++ b/docs/audit/ga-rulings.md @@ -182,9 +182,26 @@ ## GA-R2 -- Changelog consolidation -**Status: DRAFT (delivered 2026-07-18; awaiting operator ruling).** +**Status: RATIFIED 2026-07-18 (operator, with amendments D1 + D2).** +Question as presented (2026-07-18): "Adopt GA-R2 as written -- including +the under-25-file target and the one-time Phase-5 consolidation of the +existing 95 changelogs -- or with what amendment?" Operator answer +(2026-07-18), exact utterance: "Ratify with D1 and D2: Amendment D1 +(sharpens rule 5): 'One changelog per session: a session appends to its +own single changelog rather than minting per-topic files. Multiple +same-day changelogs are legitimate only when they belong to distinct +sessions.' That caps creation at session count by construction. ; +Amendment D2 (extends rule 4): 'The Phase-5 sweep dispositions every +docs/ file, not only the changelog class: each non-changelog file is +routed per rule 3 (durable home / archive / retained with one-line +justification), and each consolidation commit's message manifests the +source files it consolidated. The under-25 target counts the top-level +docs/ working set; docs/archive/ and dated capture directories under +docs/audit/ are excluded from the count but not from routing +discipline.'" -**Proposed ruling text:** +**Ratified ruling text (as amended; rule 4 extended by D2, rule 5 +extended by D1):** 1. Changelogs are session-scoped scratch: they record what a session did. They are NEVER citable as status authority (Phase 1 proved they lie -- @@ -201,12 +218,53 @@ alone and is not copied anywhere. 4. Working-set target: docs/ under 25 files. The one-time Phase-5 sweep consolidates the existing 95 changelogs per stage to reach it, history - preserved. + preserved. The Phase-5 sweep dispositions EVERY docs/ file, not only + the changelog class: each non-changelog file is routed per rule 3 + (durable home / archive / retained with one-line justification), and + each consolidation commit's message manifests the source files it + consolidated. The under-25 target counts the top-level docs/ working + set; docs/archive/ and dated capture directories under docs/audit/ + are excluded from the count but not from routing discipline. 5. A changelog is named and scoped to its session and stage; nothing in a changelog outlives consolidation except by moving to a durable home - (rule 3). No new doc class is created to work around this. + (rule 3). No new doc class is created to work around this. One + changelog per session: a session appends to its own single changelog + rather than minting per-topic files. Multiple same-day changelogs are + legitimate only when they belong to distinct sessions (creation is + thereby capped at session count by construction). --- -Drafts not yet delivered: GA-R6, GA-R4, GA-R7, stage-status vocabulary -A/B (in that order). +## GA-R6 -- Executable definition of done + +**Status: DRAFT (delivered 2026-07-18; awaiting operator ruling).** + +**Proposed ruling text:** + +1. A stage or gate is CLOSED only when a NAMED executable check passes -- + a script, harness, or gauntlet target -- and the closing commit + records the check's captured output or cites its dated capture file. + Prose cannot close a stage. +2. The check is named IN ADVANCE in the gate's CURRENT-STATE.md row (the + "what closes it" cell names the executable), so closure is mechanical, + not judged after the fact. +3. For the current gate specifically (G9 / DC0 readiness): the captured + outer plan must read EXACTLY the expected triple recorded in + CURRENT-STATE.md section 5 -- which, per the operator's GA-F01 + direction, does not exist until D-130 is ruled -- AND the fresh-agent + grounding-test question 7 passes against the post-fix repo. (The + charter's original hard-coded 5/0/6 wording is superseded by the + section-5 mechanism, per the charter's own escape clause in Phase 6 + item 4.) +4. Stage close includes the standing close-out set as executable items: + gauntlet ALL GREEN, repo-lint 0-fail, the stage branch merged per the + workflow's cross-cutting discipline, the skill sweep done, and (per + GA-R2) the stage's consolidation commit landed. +5. A closed stage's definition-of-done record (the named check + its + output citation) rotates to the stage's consolidated record or + as-built per GA-R1 rule 5. + +--- + +Drafts not yet delivered: GA-R4, GA-R7, stage-status vocabulary A/B (in +that order).