the ledger records which step finished, not just that one did

"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 <noreply@anthropic.com>
Officer-Session: 656f5c85-e49a-4f1f-b9f3-042a04b4d043

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.',