@crouton-kit/crouter 0.3.45 → 0.3.47

package/dist/build-root.js

@@ -18,7 +18,6 @@ const SUBTREE_LOADERS = {
     push: async () => (await import('./commands/push.js')).registerPush(),
     canvas: async () => (await import('./commands/canvas.js')).registerCanvas(),
     surface: async () => (await import('./commands/surface.js')).registerSurface(),
-    worktree: async () => (await import('./commands/worktree.js')).registerWorktree(),
 };
 /** Every shipped subtree name. Cheap (no module loading) — the front-door
  *  recursion guard and the dispatcher's first-token routing need only names. */

package/dist/builtin-memory/00-runtime-base.md

@@ -38,5 +38,8 @@ Two different moves; don't conflate them. **Promote** when the *shape* of the jo
 
 Don't promote or yield for work that fits one window — finish it with `crtr push final`.
 
+## Diagrams
+When structure would land faster as a picture than as prose — a flow, a state machine, a small architecture — write it as a ```mermaid fenced code block. The human's viewer renders it inline as a terminal diagram. Reach for it when the shape is the point, not for everything.
+
 ## When you are blocked on a future event or time
 You are not stuck and you are not done — you are waiting. Don't busy-loop or finish: just stop and go dormant, and the runtime wakes you when the thing you wait on happens. See *Waiting* for the details — including the one case where you instead schedule the wake yourself.

package/dist/builtin-memory/internal/nodes-and-canvas.md

@@ -44,6 +44,6 @@ Tear-down: `node lifecycle close` cascade-cancels a node + its exclusive subtree
 
 ## Revive & the daemon
 
-A dormant node (done/idle/dead/canceled) is reopened with `canvas revive` (resumes the saved conversation, or `--fresh` to restart clean). `reviveNode()` is the **only** sanctioned launcher of a node's broker engine — it builds the pi invocation, sets `CRTR_NODE_ID` + canvas extensions, runs `transition('revive')`, and starts the headless broker host, keeping the db row and broker process in lockstep. Never spawn `pi --session` raw, and never open a node by spawning pi directly — UIs go through `node focus` / `canvas revive`.
+A dormant node (done/idle/dead/canceled) is reopened with `node lifecycle revive <id>` (resumes the saved conversation, or `--fresh` to restart clean); mass-reconnecting EVERY disconnected node at once (a reboot/crash recovery) is `canvas revive --all` instead. `reviveNode()` is the **only** sanctioned launcher of a node's broker engine — it builds the pi invocation, sets `CRTR_NODE_ID` + canvas extensions, runs `transition('revive')`, and starts the headless broker host, keeping the db row and broker process in lockstep. Never spawn `pi --session` raw, and never open a node by spawning pi directly — UIs go through `node focus` / `node lifecycle revive`.
 
-The **daemon** (`crtrd`, managed via `canvas daemon start/stop/status`) is a thin supervisor: it polls broker liveness via `pi_pid` and auto-revives active/idle nodes whose broker exited. It does NOT host agents, open viewers, or auto-revive *canceled* nodes (reach for `canvas revive` for those). After rebuilding crouter's `dist/`, restart the daemon — it loads compiled code at start and never reloads it. Restarting is safe: it never signals running nodes.
+The **daemon** (`crtrd`, managed via `canvas daemon start/stop/status`) is a thin supervisor: it polls broker liveness via `pi_pid` and auto-revives active/idle nodes whose broker exited. It does NOT host agents, open viewers, or auto-revive *canceled* nodes (reach for `node lifecycle revive` for those). After rebuilding crouter's `dist/`, restart the daemon — it loads compiled code at start and never reloads it. Restarting is safe: it never signals running nodes.

package/dist/builtin-memory/wedged-child-on-runaway-bash.md

@@ -13,7 +13,7 @@ A base node can wedge INDEFINITELY on a single runaway bash command (classic: `g
 **Remediation branches on whether the tree has a descendant (issue #119):**
 
 - **A subprocess exists (the common case)** — a runaway bash/find/grep is the likely cause. The daemon does NOT touch the engine here; you kill the subprocess yourself (see below).
-- **No subprocess exists** — the broker pid stands alone in its own tree (the engine itself stalled, e.g. mid a `model_change`, with nothing a human could kill). The daemon performs the ONLY remaining remediation itself: it SIGTERMs the broker (the same on-demand kick `canvas revive --now` does), and its own dead-pid crash-grace path resumes it on the saved session within ~20s, no lost context. The resume alone can leave the node IDLE rather than mid-turn (it reloads the session but doesn't restart the dead turn) — if telemetry stays frozen after the kick, nudge it (see "No-subprocess case" below).
+- **No subprocess exists** — the broker pid stands alone in its own tree (the engine itself stalled, e.g. mid a `model_change`, with nothing a human could kill). The daemon performs the ONLY remaining remediation itself: it SIGTERMs the broker (the same on-demand kick `node lifecycle revive --now` does), and its own dead-pid crash-grace path resumes it on the saved session within ~20s, no lost context. The resume alone can leave the node IDLE rather than mid-turn (it reloads the session but doesn't restart the dead turn) — if telemetry stays frozen after the kick, nudge it (see "No-subprocess case" below).
 
 **Why it used to be invisible to the orchestrator:** the wake spine only fires on a child's push/finalize/crash. A child wedged *mid-turn* does none of those — its row stays `status=active` and the dashboard shows it `●` working. Before #110, the parent got no wake at all, so an entire wave could stall for hours looking healthy; cli-verbs-B2 sat wedged ~2h14m on a `grep /` before a safety-deadline inspection caught it. The daemon-side detection above closes that gap; you should no longer need to notice a wedge by elapsed-time vibes alone — but if you do (the daemon hasn't caught up yet, or the wedge is younger than its grace window), the manual inspection below still works.
 
@@ -30,5 +30,5 @@ The wedge can outlive any subprocess, or exist with none at all. A node (includi
 **This is now the daemon's own remediation (issue #119) — it auto-kicks the broker for you.** If it hasn't caught up yet (younger than the wedge grace, or the daemon was down), do it manually:
 
 1. `kill -TERM <broker_pid>` — the wedged broker. Confirm it dies (`ps -p <pid>`) and that no orphan subprocess lingers (`ps -o pid,ppid,command | awk '$2==<pid>'`).
-2. The **daemon auto-resumes** it within ~20s on the saved session — a fresh broker pid appears (`node inspect show`), `status=active`, `intent=null`, `view.sock` accepts connections. (No manual `canvas revive` needed if the daemon is up; do it manually only if it doesn't come back.)
+2. The **daemon auto-resumes** it within ~20s on the saved session — a fresh broker pid appears (`node inspect show`), `status=active`, `intent=null`, `view.sock` accepts connections. (No manual `node lifecycle revive` needed if the daemon is up; do it manually only if it doesn't come back.)
 3. **The resume alone leaves it IDLE** — it loads the session but does not restart the dead turn, so telemetry stays frozen and it processes nothing. Send a `--tier critical` `node msg` to force a fresh turn (critical = interrupt + new turn). Word it as a recovery notice: tell it the broker was wedged, to re-orient from `context/roadmap.md`/feed, and NOT to trust that recent inbox context survived (cursor may have advanced past messages the wedged engine never folded into the conversation). Confirm success by watching `telemetry.json` `updated_at` go current and the node run bash again.

package/dist/builtin-views/chat/web.jsx

@@ -129,7 +129,7 @@ function connectionGuidance(state) {
         Comp: NotReady,
         headline: 'node is asleep',
         explanation: 'Focus or revive the node first, then reconnect.',
-        nextStep: `crtr node focus ${target} · or crtr canvas revive ${target}`,
+        nextStep: `crtr node focus ${target} · or crtr node lifecycle revive ${target}`,
       };
     case 'no-node':
       return {

package/dist/clients/attach/__tests__/crtr-output-render.test.js

@@ -745,8 +745,8 @@ test('a crtr canvas attention map card collapses to a hottest-id digest, PASS wh
         .join('\n');
     assert.match(expanded, /counts: \{"n1":0,"n2":3,"n3":5\}/);
 });
-test('a crtr canvas revive card collapses to a kicked/revived status line, argv-recovered id', () => {
-    const kickedDef = createCrtrBashToolDefinition({ command: 'crtr canvas revive mq2jpqz5-87fa626e --now' });
+test('a crtr node lifecycle revive card collapses to a kicked/revived status line, argv-recovered id', () => {
+    const kickedDef = createCrtrBashToolDefinition({ command: 'crtr node lifecycle revive mq2jpqz5-87fa626e --now' });
     const kicked = kickedDef
         .renderResult({ content: [{ type: 'text', text: ['- session: mysession', '- kicked: true', '', 'Sent SIGTERM to worker-a (mq2jpqz5-87fa626e, pid 456).'].join('\n') }] }, { expanded: false }, theme, {})
         .render(120)
@@ -757,7 +757,7 @@ test('a crtr canvas revive card collapses to a kicked/revived status line, argv-
         .render(120)
         .join('\n');
     assert.match(kickedExpanded, /Sent SIGTERM to worker-a \(mq2jpqz5-87fa626e, pid 456\)\./);
-    const revivedDef = createCrtrBashToolDefinition({ command: 'crtr canvas revive mq2jpqz5-87fa626e' });
+    const revivedDef = createCrtrBashToolDefinition({ command: 'crtr node lifecycle revive mq2jpqz5-87fa626e' });
     const revived = revivedDef
         .renderResult({ content: [{ type: 'text', text: ['- session: mysession', '- resumed: true', '- ready: true'].join('\n') }] }, { expanded: false }, theme, {})
         .render(120)
@@ -780,9 +780,11 @@ test('a crtr canvas revive card collapses to a kicked/revived status line, argv-
         .join('\n');
     assert.match(notReadyExpanded, /resumed: false/);
     assert.match(notReadyExpanded, /ready: false/);
-    // `--all` carries a `- mode:` bullet and is deliberately skipped (null) —
-    // falls through to generic truncation, raw `mode` text survives.
-    const allPreview = revivedDef
+    // `canvas revive --all` carries a `- mode:` bullet; no summarizer is
+    // registered for it (rare admin path) — falls through to generic
+    // truncation, raw `mode` text survives.
+    const allDef = createCrtrBashToolDefinition({ command: 'crtr canvas revive --all' });
+    const allPreview = allDef
         .renderResult({ content: [{ type: 'text', text: '- mode: preview\n- candidates: mq1' }] }, { expanded: false }, theme, {})
         .render(120)
         .join('\n');
@@ -907,10 +909,10 @@ const HISTORY_SHOW_OUTPUT = [
     '| n1:docs/design.md | doc | 2026-01-03T00:00:00.000Z | Design doc |',
     '| n1:roadmap.md | roadmap | 2026-01-04T00:00:00.000Z | Roadmap |',
     '',
-    'Read one with `canvas history read <ref>`; reopen the node with `canvas revive n1`.',
+    'Read one with `canvas history read <ref>`; reopen the node with `node lifecycle revive n1`.',
 ].join('\n');
-test('a crtr canvas history show card collapses to a node line + type-count digest, not the raw table', () => {
-    const def = createCrtrBashToolDefinition({ command: 'crtr canvas history show n1' });
+test('a crtr node inspect artifacts card collapses to a node line + type-count digest, not the raw table', () => {
+    const def = createCrtrBashToolDefinition({ command: 'crtr node inspect artifacts n1' });
     const collapsed = def
         .renderResult({ content: [{ type: 'text', text: HISTORY_SHOW_OUTPUT }] }, { expanded: false }, theme, {})
         .render(120)