Skip to content

Commit 1c3fae0

Browse files
hyperpolymathclaude
andcommitted
docs: Stage B properly CLOSED — truth the #215 ADR-012 won't-fix (Refs #176 #215)
The ledger said Stage B "near-closed (residual #215 families remain, one family per PR)". That is stale and actively misleading: #215 is CLOSED with an owner-ratified ADR-012 disposition that the residual ~68 S/R + state-401 R/R conflicts are an INTENTIONAL WON'T-FIX. Menhir resolves them correctly, the full gate proves every accepted parse is the intended one, and eliminating them is exactly the systemic precedence/left-factoring contortion (estate-wide blast radius, cosmetic-only payoff) ADR-012 forbids. Closure is by disclosure, not surgery: `just build` masks the benign notices but prints the count + correctness proof + ADR pointer; `just build-loud` / `dune build` reveal all (verified present in justfile; policy in docs/specs/SETTLED-DECISIONS.adoc "Parser-Conflict Disclosure"). "near-closed" invited the precise grammar work ADR-012 forbids — a documentation-drift hazard (DOC-01..09 / #176). Corrected: - docs/ECOSYSTEM.adoc Stage B row: near-closed -> CLOSED + the ADR-012 residual-conflict disposition + the disclosure mechanism + an explicit "do not reopen" note. - docs/TECH-DEBT.adoc critical-path: Stage B CLOSED (ADR-012 won't-fix). - docs/CAPABILITY-MATRIX.adoc parser row: Stage B CLOSED, no longer "tracked as the #215 workstream". Docs-only; gate unaffected. Refs #176 #215 (not Closes — #215 already closed; this truths the ledger to match its disposition). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1 parent 5cca379 commit 1c3fae0

3 files changed

Lines changed: 20 additions & 5 deletions

File tree

docs/CAPABILITY-MATRIX.adoc

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -61,8 +61,12 @@ Gate baseline at reconstruction: **`opam exec --switch=. -- dune runtest
6161
|Lexer |works |Full Unicode. Quantity-literal `ZERO`/`ONE` tokens are *not*
6262
emitted (QTT numeric surface uses `:1`/`:0`/`:ω` sugar parsed elsewhere).
6363

64-
|Parser |works |Menhir grammar, ADR-009 conformance. Residual grammar
65-
conflicts tracked as the #215 family workstream (Stage B). *Module-qualified
64+
|Parser |works |Menhir grammar, ADR-009 conformance. Stage B *CLOSED*:
65+
#215 closed with the owner-ratified ADR-012 disposition — the residual
66+
~68 S/R + state-401 R/R conflicts are an *intentional won't-fix* (Menhir
67+
resolves them correctly; the gate proves every parse is intended;
68+
eliminating them is the contortion ADR-012 forbids). `just build` masks
69+
+ proves them, `just build-loud`/`dune build` reveal all. *Module-qualified
6670
type/effect paths now parse* — `Pkg.Type` / `Pkg::Type` (mixed, deep),
6771
`::` canonical (ADR-014, PR #241, Refs #228; zero Menhir conflict delta).
6872
Cleared the dominant estate parse blocker (was 525/1177 `.affine`);

docs/ECOSYSTEM.adoc

Lines changed: 13 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -54,8 +54,19 @@ recovery). |*CLOSED* |`affine-types = wired-and-reachable`,
5454

5555
|*B* |Grammar conformance + conflict elimination: ADR-009 conformance, the
5656
#215 conflict-family workstream, ADR-012 ("grammar changes are correctness
57-
assertions"). |*near-closed* |Family B (`return`/`resume`, PR #224) merged;
58-
residual S/R + state-401 R/R families remain (one family per PR).
57+
assertions"). |*CLOSED* |#215 closed with an owner-ratified *ADR-012
58+
disposition*: families A/C/D/F + the EXTERN bug fixed on correctness
59+
grounds (#216/#217/#219/#222/#223); family B (`return`/`resume`, #224)
60+
shipped as a *correctness* change, conflict-count-neutral. The residual
61+
~68 S/R + state-401 R/R are *intentional WON'T-FIX*: Menhir resolves them
62+
correctly, the full gate proves every accepted parse is the intended one,
63+
and removing them is the systemic precedence/left-factoring contortion
64+
(estate-wide blast radius, cosmetic-only payoff) ADR-012 *forbids*.
65+
Closure is by *disclosure, not surgery*: `just build` masks the benign
66+
notices but prints the count + correctness proof + ADR pointer; `just
67+
build-loud` / `dune build` reveal all (policy:
68+
`docs/specs/SETTLED-DECISIONS.adoc` "Parser-Conflict Disclosure"). Do
69+
*not* reopen residual-conflict elimination — it is settled won't-fix.
5970

6071
|*C* |Standard library AOT: every stdlib file compiles
6172
resolve→typecheck→codegen, gated in CI. |*CLOSED 2026-05-18* |19/19 stdlib

docs/TECH-DEBT.adoc

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ toc::[]
2626
[source]
2727
----
2828
Stage A CLOSED ───────────────────────────────────────────────┐
29-
Stage B near-closed (#215 residual families)
29+
Stage B CLOSED (#215; residual conflicts = ADR-012 won't-fix)
3030
Stage C CLOSED 2026-05-18 (#128/#135 stdlib AOT) │
3131
3232
Stage D ACTIVE ── CORE-01 (#177) ─┐ (base lang

0 commit comments

Comments
 (0)