Skip to content

Commit 13bb561

Browse files
reid-spencerclaude
andcommitted
Measure [1.5] rather than leaving it reasoned, and say why it waits
The entry was written from reading the code. Measured now: adding a brief to a step inside a `sequence` makes Root2JsonFixturesTest report BriefDescription 2 -> 1 — top-level survives, nested does not. The repro is two minutes and is written down. The fixture change is reverted rather than left in the tree, because it turns two suites red and a permanently-red gate stops being read. Not fixed in the same session deliberately: closing it changes the JSON INPUT surface's document schema, and [1.1] is Reid's open question about whether that surface should exist at all. If it goes away the fix is free and write-side only; if it stays, a schema change wants announcing rather than discovering. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
1 parent dc28a0e commit 13bb561

1 file changed

Lines changed: 18 additions & 0 deletions

File tree

BACKLOG.md

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -671,6 +671,24 @@ that needs a ruling before either can be fixed.
671671
`JsonAstBuilder.nestedInteraction`, which exists to make the gap visible at the
672672
code rather than only here.
673673

674+
**MEASURED 2026-08-17, not reasoned** — the entry was first written from
675+
reading the code, and this repo's own rule is that a claim about behaviour
676+
needs a run. Add a `with { briefly "…" }` to a step inside a `sequence` in
677+
`language/input/refusal-reason.riddl` and run
678+
`riddlLib/testOnly *Root2JsonFixturesTest*`: it reports
679+
**`BriefDescription: 2 -> 1`** — the top-level step's brief survives, the
680+
nested one does not. That is a two-minute reproduction for whoever takes this.
681+
The fixture change was REVERTED rather than left in place, because it turns two
682+
suites red and a permanently-red gate stops being read.
683+
684+
**DELIBERATELY NOT FIXED in the same session that found it**, and the reason is
685+
[1.1]: Reid asked on 2026-08-16 whether the JSON INPUT surface should exist at
686+
all. Closing this means changing that surface's document schema — nested steps
687+
going from `{"kind": …}` to `{"interaction": {"kind": …}, "brief": …}` — which
688+
is a compatibility event for every consumer reading it. **Settle [1.1] first;
689+
if the input surface goes away, this fix is free (write-side only), and if it
690+
stays, the schema change wants announcing rather than discovering.**
691+
674692
- **~~[2.2] superseded framing~~ (kept only so the reasoning is not re-derived).**
675693
**CORRECTED 2026-08-16 by Reid, and the previous framing was wrong.** This
676694
entry said the operand "should name an invariant, NOT prose", and offered as a

0 commit comments

Comments
 (0)