From 405b3574d230d9dc8b9c12e3a7fbdaf72198e13a Mon Sep 17 00:00:00 2001 From: Vuong Hoang Date: Wed, 2 Sep 2026 09:33:17 -0700 Subject: [PATCH] =?UTF-8?q?docs(althing):=20the=20measured=20case=20for=20?= =?UTF-8?q?cc=20=E2=80=94=20a=20pane=20poke=20lands=20in=20prompt=20histor?= =?UTF-8?q?y,=20cc=20does=20not?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/runbooks/althing-deploy.md | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/docs/runbooks/althing-deploy.md b/docs/runbooks/althing-deploy.md index 15cc528..b7946d8 100644 --- a/docs/runbooks/althing-deploy.md +++ b/docs/runbooks/althing-deploy.md @@ -175,6 +175,25 @@ command: althing-route declare --pid # prefers cc, falls back to pane +**Why cc is worth an undocumented dependency, in one measurement.** A pane poke +is typed into the session and submitted, so Claude Code records it in the +operator's prompt history exactly as if he had written it — 8 herald-written +entries accumulated across three projects, permanently in up-arrow recall. A cc +poke enters none: 2 delivered, 0 entries. Verified from the herald log against +the history on 2026-09-02. Channel sequence on one seat that day, all three in +order: + + 09-01 21:44 poked via fifo the old way, later reaped + 09-02 08:34 could NOT reach via pane guard 4 refusing: he was typing + 09-02 09:07 poked via pane typed into his input line + 09-02 09:14 poked via cc arrived as a peer message + 09-02 09:31 poked via cc after crossSessionInbound accept + +⚠ **Count herald pokes by the whole display string, not by grepping +`ALTHING-HERALD`.** The substring matches the operator's own messages when he +pastes a hold notice into one, so the count runs high and the excess reads as +new activity. See the identity-not-resemblance note in the audit section. + ⚠ **Ordering constraint at any upgrade that changes the channel set:** a pre-3.3.0 herald refuses `channel=cc` at parse, so a seat that declares the new channel before the herald restarts goes silently pull-only. `uv tool install