From 6eecbfcca112374e71adb38e5efd7836b4900b7e Mon Sep 17 00:00:00 2001 From: Levi Neuwirth Date: Sun, 9 Aug 2026 14:00:53 +0200 Subject: [PATCH] docs: record discovery Stage 2 framing approval Revision 3 was approved 2026-08-09 at 6a9a25d, after the three stale internal references were cleared. The lane heading and the framing status line both still said "in review", which is the kind of contradiction that makes a reader trust whichever line they hit first. The lane entry now also records WHAT the three review rounds found, rather than only how many there were. A count says the doc was reviewed; the list says what class of error it was reviewed for, which is the part a later reader can act on. Co-Authored-By: Claude Opus 5 Claude-Session: https://claude.ai/code/session_016bqGA6s9tTUFzYpbeW3tai --- docs/active-work.md | 12 +++++++++--- docs/discovery-stage2-framing.md | 4 ++-- 2 files changed, 11 insertions(+), 5 deletions(-) diff --git a/docs/active-work.md b/docs/active-work.md index 23c7d20..b13f606 100644 --- a/docs/active-work.md +++ b/docs/active-work.md @@ -265,7 +265,7 @@ also removed: this branch's "R8 NEEDS A LANE" investigation block, and durable facts are in the retired registry row and the handoff §6 census. -## Discovery Stage 2 — BRANCHED, framing in review +## Discovery Stage 2 — BRANCHED, pre-implementation **Written with the lane's first commit**, per the standing correction from #171 and #215. @@ -275,8 +275,14 @@ from #171 and #215. tip** — the ref, not a SHA. Recover with `git fetch githubsucks && git checkout discovery-stage2`. -- **Framing `docs/discovery-stage2-framing.md`, revision 3**, in - review. Scope: `COHERENCE.md` §5's "M-x rows are still bare names". +- **Framing `docs/discovery-stage2-framing.md`, revision 3, APPROVED + 2026-08-09** after three review rounds. Each round found the previous + one reasoning about a mechanism instead of reading it — an in-place + field change that postcard cannot make compatible, a TUI that never + reads the message at all, a round-trip test that freezes nothing, a + cache hazard the per-peer render state makes impossible, and a + clipping rule unachievable at narrow widths. + Scope: `COHERENCE.md` §5's "M-x rows are still bare names". Descriptions already exist on `Command` and are already rendered by `help.list-commands`; they are missing at the one moment they would change a decision. diff --git a/docs/discovery-stage2-framing.md b/docs/discovery-stage2-framing.md index 993ab75..56da2bf 100644 --- a/docs/discovery-stage2-framing.md +++ b/docs/discovery-stage2-framing.md @@ -1,7 +1,7 @@ # Discovery Stage 2 — M-x rows stop being bare names -**Status: framing pass, revision 3. Pre-implementation. Awaiting -approval.** +**Status: revision 3, APPROVED 2026-08-09. Implementation may +proceed.** **Revision 3 fixes three things revision 2 asserted without checking the mechanism it was reasoning about**: a "frozen-shape" test that