From ea4b8a1e5f3e948fabfa7ba03619efd74d8422f5 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Andr=C3=A9=20Padez?= Date: Tue, 25 Aug 2026 08:33:12 +0000 Subject: [PATCH] the ledger records which step finished, not just that one did MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit "done" stopped being enough the moment there was more than one step. an item transcribed but never filed and an item that went all the way through are different states, and a ledger that cannot tell them apart cannot resume, cannot report, and cannot answer "was this ever sent?". so: a line per STEP rather than per item. the same hash appears once for each stage it reaches — acted on, classified, dispatched, and where it went — and the latest line for a hash is its current state. append-only holds, because no line is ever edited. it is also the only way to find what got stuck. an item acted on but never classified is invisible otherwise: not in the backlog, because the trigger has seen it, and not finished either. Co-Authored-By: Claude Opus 5 Officer-Session: 656f5c85-e49a-4f1f-b9f3-042a04b4d043 --- src/servers/api/command-hq/directory.ts | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/src/servers/api/command-hq/directory.ts b/src/servers/api/command-hq/directory.ts index 18d87892..001f4ecb 100644 --- a/src/servers/api/command-hq/directory.ts +++ b/src/servers/api/command-hq/directory.ts @@ -290,6 +290,19 @@ export function commanderClaudeMd(params: CommanderClaudeMdParams): string { 'Two consequences to accept deliberately. The same content under two names is one item, done once. And', 'deleting an output does not bring it back, because the ledger still says done.', '', + '**A line says WHICH STEP finished, not just that something did.** Acted on, classified, dispatched —', + 'and where it went. "Done" is not enough once there is more than one step: an item that was transcribed', + 'and never filed and an item that went all the way through are different states, and a ledger that', + 'cannot tell them apart cannot resume, cannot report, and cannot answer "was this ever sent?".', + '', + 'So append a line per step, not per item: the same hash appears once for each stage it reaches, and the', + 'latest line for a hash is its current state. That keeps the append-only property — no line is ever', + 'edited — while still recording progress through a pipeline that takes minutes and can die in the', + 'middle of it.', + '', + 'It is also the only way to find what got stuck. An item acted on but never classified is invisible', + 'otherwise: it is not in the backlog, because the trigger has seen it, and it is not finished either.', + '', '**Never put your BOOKKEEPING into what you watch.** The ledger, the reports, the logs, the state —', 'those live here, in your own directory. The reference path holds its subject and nothing about how you', 'are getting on with it.',