feat(queue): queue as data A1, journal, lock, CLI and verify (#1508)

packages/queue, scripts/queue-commit.sh, scripts/git-hooks and scripts/test-queue.sh, plus docs/plans/BRIEF-TEMPLATE.md. There is no queue.json yet, so verify skips until the genesis commit after A2. Darkwing built it, and Filbert reviewed R0 (6933b885, changes requested) and r1 (e464be6c, approved). The 20 files match manifest 85a8a453. The nine suites passed on an index export, including the new queue suite. test-queue.sh joins the suite list in AGENTS.md. Lead decisions 20, 23 and 26. Co-Authored-By: Claude Opus 5.5 <[email protected]>
2026-09-26 19:07:48 -05:00
parent 91df7d6b54
commit 34a72af912
32 changed files with 11592 additions and 1 deletions
@@ -415,3 +415,5 @@ are never rewritten or removed; corrections are new entries.
 2026-09-26T23:37:23Z | Filbert (T3 Claude Code, thread 9cb9731e) | CHAT-03 brief R1 review (#1507 row 5), BRIEF.md 5dd447f7 | changes requested: B1 R3-1 premise wrong for Pi 0.85.1, B2 foreign-writer detection has no entry ids, B3 schema gaps (unavailable event, turnProof queue text), B4 no live-root refusal, B5 increment order and done gate, B6 claim two-key and reserved gaps; review agents/filbert/work/chat-03-brief-review-2026-09-26.md ec00544e
 2026-09-26T23:52:04Z | Sage (T3 Claude Code, thread 1ef1e4f8) | SetSpark approver fix in shared-signals | Sage subagent wrote it, Rocko R1 revise (706e9ac1), R2 approve (c190814b); suites 188/131, vault 45 PASS; committed and pushed shared-signals cc74d92. Deploy to VM 1022 and production survey go to Jason. Lead decision 24.
 2026-09-26T23:58:21Z | Sage (T3 Claude Code, thread 1ef1e4f8) | #1507 CHAT-03 brief r2 | Rocko R2 revise (07b938fb), one blocking finding on stop proof vs interruption; V-1 accepted with limits, lead decision 25; r3 to Dewey. A2 carry-forward 773dbd75 accepted.
+2026-09-27T00:04:42Z | Filbert (T3 Claude Code, thread 9cb9731e) | Queue A1 (#1508) r1 re-review and N13 | approved: delta-r1 b733b894, manifest-r1 85a8a453, n13.patch 00868b2f; review agents/filbert/work/queue-a1-review-r1-2026-09-26.md e464be6c; three non-blocking notes
+2026-09-27T00:07:44Z | Sage (T3 Claude Code, thread 1ef1e4f8) | #1508 queue A1 commit | Filbert approved r1 (e464be6c); 20 files match 85a8a453; nine suites green on the index incl. queue; test-queue.sh added to AGENTS.md suites; lead decision 26 (P1-P3 to A2, N13-a declined). A2 started.
@@ -307,3 +307,13 @@ which stay with him. Each item names who decided it and what happened.
    Rocko's R2 on the same brief (07b938fb) requests one change: an idle
    slot with empty clears does not prove an interrupted turn. Dewey
    separates receipt settlement from the stop proof in r3.
+26. **Queue A1 committed. A2 starts.** Filbert approved r1 (e464be6c). He
+    agrees with Darkwing's refusal of a later round whose kept issue has
+    left the row until `--issue` names one; that detail belongs with item
+    23. Filbert's r1 notes all go into A2 before genesis, as Darkwing
+    proposed (carry-forward b2a738f0): P1, the unguarded release on the
+    gate paths, with a test; P2, each round records its own issue, which
+    changes the round schema; P3, unlock returns the result and the warning
+    separately. N13-a, having the check apply the patch instead of copying
+    the suites, won't be done: the approval pins the patch and the suite
+    hashes, and Filbert applied the patch himself. Darkwing starts A2 now.
@@ -0,0 +1,49 @@
+# Brief template
+
+Copy the section below into the brief file for a queue row, one `##`
+heading per row. The row records the file path and that heading as its
+brief anchor (`--brief docs/plans/<file>.md#<heading>`), plus the git blob
+of the committed file.
+
+Rules the queue enforces (queue-as-data plan 8.13):
+- the brief is committed before `queue add` or a brief change names it; a
+  staged or untracked brief is refused;
+- the heading occurs exactly once in the file;
+- a later edit to a committed brief makes `next` flag the row and `start`
+  refuse until the lead re-pins it.
+
+`queued` means the brief exists, not that it is accepted. The row moves to
+`briefed` when a privileged actor (jason or sage) accepts it; the owner
+can't.
+
+---
+
+## <Piece name, the row's one-line piece text>
+
+### Problem
+
+What is wrong or missing today, with evidence: file paths, issue numbers,
+command output. One paragraph.
+
+### Owner and reviewer
+
+- Owner: the seat that does the work.
+- Reviewer: the seat that reviews it, or "none" and why.
+
+### Files owned
+
+Every path this piece may create or change. Anything else is out of scope
+unless the brief is amended.
+
+### What ships
+
+The concrete result: code, tests, docs. Name the test suites that must pass.
+
+### Out of scope
+
+What this piece deliberately leaves alone, and where that work goes.
+
+### Gate
+
+Who says yes, and on what evidence: the command to run, the output to
+expect, or the comment to read.