@north-light/crouter 0.3.182 → 0.3.183

package/dist/core/runtime/tmux-bindings.js

@@ -161,23 +161,40 @@ function normalizedStrokeParts(stroke) {
     return { key: parts.pop(), modifiers: parts };
 }
 function tmuxKey(stroke) {
+    return tmuxKeyNames(stroke)[0];
+}
+/** Every tmux key name one physical chord can arrive as, most specific first.
+ *
+ *  tmux derives the name from the bytes the terminal sent, and a terminal sends
+ *  different bytes for the same chord depending on whether extended keys are
+ *  active — which changes per pane, since the pane's application turns them on.
+ *  tmux does not normalize across those encodings, so a chord bound under one
+ *  name is simply dead under the others. Verified against tmux 3.7b by writing
+ *  raw bytes to an attached client; for Alt+Shift+F:
+ *
+ *    ESC F           (legacy meta prefix)                -> `M-F`
+ *    ESC [70;4u  / ESC [27;4;70~   (shifted keysym)      -> `M-S-F`
+ *    ESC [102;4u / ESC [27;4;102~  (base keysym)         -> `M-S-f`
+ *
+ *  Shift alone never survives as a modifier — every encoding of Shift+G lands
+ *  on `G` — so only chords that pair Shift with Ctrl or Alt carry aliases. */
+function tmuxKeyNames(stroke) {
     let { key, modifiers: modifierParts } = normalizedStrokeParts(stroke);
     const modifiers = new Set(modifierParts);
-    if (modifiers.has('shift') && key.length === 1 && /[a-z]/.test(key)) {
-        // tmux names a shifted printable with its uppercase character even when an
-        // extended-key terminal also preserves Shift as a modifier: Alt+Shift+F is
-        // `M-S-F`. Shift by itself needs only the uppercase character (`F`).
-        key = key.toUpperCase();
-        if (!modifiers.has('ctrl') && !modifiers.has('alt'))
-            modifiers.delete('shift');
-    }
-    key = TMUX_NAMED_KEYS[key] ?? key;
-    const prefix = [
+    const name = (character, shift) => [
         modifiers.has('ctrl') ? 'C-' : '',
         modifiers.has('alt') ? 'M-' : '',
-        modifiers.has('shift') ? 'S-' : '',
+        shift ? 'S-' : '',
+        TMUX_NAMED_KEYS[character] ?? character,
     ].join('');
-    return `${prefix}${key}`;
+    if (modifiers.has('shift') && key.length === 1 && /[a-z]/.test(key)) {
+        const shifted = key.toUpperCase();
+        // Shift-only: tmux always collapses it into the uppercase character.
+        if (!modifiers.has('ctrl') && !modifiers.has('alt'))
+            return [name(shifted, false)];
+        return [name(shifted, true), name(shifted, false), name(key, true)];
+    }
+    return [name(key, modifiers.has('shift'))];
 }
 function menuSelector(stroke) {
     const { key, modifiers } = normalizedStrokeParts(stroke);
@@ -386,7 +403,7 @@ export function occupiedTmuxRootGestures(gestures) {
         const parsed = parseTmuxBinding(line);
         return parsed?.table === ROOT_TABLE ? [parsed.key] : [];
     }));
-    return gestures.filter((gesture) => !gesture.includes(' > ') && occupied.has(tmuxKey(gesture)));
+    return gestures.filter((gesture) => !gesture.includes(' > ') && tmuxKeyNames(gesture).some((key) => occupied.has(key)));
 }
 function isInstalledPair(value) {
     return typeof value === 'object' && value !== null
@@ -547,9 +564,10 @@ function reconcileTmuxBindings(bindingSnapshot, passthroughSnapshot = []) {
         for (const gesture of bindings.gestures(bindingId)) {
             if (gesture.includes(' > '))
                 continue;
-            const key = tmuxKey(gesture);
-            if (!desiredWrappers.has(key))
-                desiredWrappers.set(key, { bindingId, gesture });
+            for (const key of tmuxKeyNames(gesture)) {
+                if (!desiredWrappers.has(key))
+                    desiredWrappers.set(key, { bindingId, gesture });
+            }
         }
     }
     // Restore every wrapper crouter still owns before the ordinary binding sweep.
@@ -610,7 +628,8 @@ function reconcileTmuxBindings(bindingSnapshot, passthroughSnapshot = []) {
     const menuActions = resolvedMenuActions(bindings);
     const menuCommand = buildMenuArgs(' crtr ', menuItems(bindings, menuActions));
     for (const gesture of bindings.gestures('crtr.tmux.menu.open')) {
-        install(ROOT_TABLE, tmuxKey(gesture), menuCommand, 'crtr.tmux.menu.open', gesture);
+        for (const key of tmuxKeyNames(gesture))
+            install(ROOT_TABLE, key, menuCommand, 'crtr.tmux.menu.open', gesture);
     }
     for (const definition of BINDING_CATALOG) {
         if (definition.pair?.field !== 'menu')
@@ -625,12 +644,15 @@ function reconcileTmuxBindings(bindingSnapshot, passthroughSnapshot = []) {
         if (command === null)
             throw new Error(`no direct tmux action for paired menu binding ${menuId}`);
         for (const gesture of bindings.gestures(globalId)) {
-            install(ROOT_TABLE, tmuxKey(gesture), command.argv, globalId, gesture);
+            for (const key of tmuxKeyNames(gesture))
+                install(ROOT_TABLE, key, command.argv, globalId, gesture);
         }
     }
     for (const id of ['crtr.tmux.node.next', 'crtr.tmux.node.previous', 'crtr.tmux.inbox.toggle']) {
-        for (const gesture of bindings.gestures(id))
-            install(ROOT_TABLE, tmuxKey(gesture), actionCommand(id), id, gesture);
+        for (const gesture of bindings.gestures(id)) {
+            for (const key of tmuxKeyNames(gesture))
+                install(ROOT_TABLE, key, actionCommand(id), id, gesture);
+        }
     }
     // Wrap only occupied roots. Unoccupied gestures already reach the pane and do
     // not need crouter ownership. Re-read the installed line as the fingerprint;

package/dist/core/runtime/tool-group-summary.js

@@ -49,20 +49,16 @@ const SUMMARY_SYSTEM_PROMPT = 'Create a structured recap of this coding-agent to
     'Omit inbox receipt, delivery, and queueing; node-response and report bookkeeping; help lookups; status checks; and summary-generation activity. ' +
     'A node response may support a substantive outcome, but its arrival or resummarization is never itself an outcome. ' +
     'If no meaningful outcome remains after those omissions, submit the single bullet "No meaningful changes." ' +
-    'Count nodes created, and separately count distinct files removed from disk, only when the supplied tool arguments or results evidence them; otherwise use zero, even when the corresponding mechanics are omitted from bullets. ' +
+    'Count distinct files removed from disk only when the supplied tool arguments or results evidence them; otherwise use zero, even when the corresponding mechanics are omitted from bullets. ' +
     'A deleted file is one that no longer exists after the segment, never a file that was merely edited or overwritten, and a recursive or wildcard removal of an unknown number of files counts as one. ' +
     'Do not invent success when a result shows failure. ' +
-    'Call submit_summary exactly once with bullets, nodesSpawned, and filesDeleted, then stop.';
+    'Call submit_summary exactly once with bullets and filesDeleted, then stop.';
 const SUBMIT_SUMMARY_SCHEMA = Type.Object({
     bullets: Type.Array(Type.String({
         minLength: 1,
         maxLength: 120,
         description: 'A very short, plain-English outcome without bullet markers, identifiers, or operational bookkeeping.',
     }), { minItems: 1, maxItems: 5 }),
-    nodesSpawned: Type.Integer({
-        minimum: 0,
-        description: 'Count of nodes created during the supplied segment, or zero when none are evidenced.',
-    }),
     filesDeleted: Type.Integer({
         minimum: 0,
         description: 'Count of distinct files removed from disk during the supplied segment, or zero when none are evidenced.',

package/dist/core/substrate/injected-store.d.ts

@@ -1,3 +1,9 @@
+/** The process-shared dedup set for a node: loaded from disk once, then the
+ *  SAME Set instance on every call, so all hooks in this pi process grow and
+ *  consult one set. Daemon-side deliveries (a warm-spare claim) write the disk
+ *  file from another process; consumers that must see those merge the plain
+ *  `loadInjectedDocs` result in before rendering. */
+export declare function sharedInjectedDocs(nodeId: string): Set<string>;
 /** Rehydrate a node's on-read dedup set from disk. Returns an empty set when the
  *  file is absent, unreadable, or malformed (a fresh transcript, or a node that
  *  has not yet surfaced any on-read doc). */

package/dist/core/substrate/injected-store.js

@@ -19,6 +19,24 @@
 // never a crash — a dedup miss must never break a read or a revive.
 import { readFileSync, writeFileSync, rmSync } from 'node:fs';
 import { injectedDocsPath } from '../canvas/paths.js';
+/** Per-process cache behind `sharedInjectedDocs`: one Set instance per node,
+ *  shared by every extension in the pi process (context-intro's workspace-open
+ *  render and doc-substrate's on-read hook), so a doc delivered by one hook is
+ *  already in the set the other dedups against. */
+const cache = new Map();
+/** The process-shared dedup set for a node: loaded from disk once, then the
+ *  SAME Set instance on every call, so all hooks in this pi process grow and
+ *  consult one set. Daemon-side deliveries (a warm-spare claim) write the disk
+ *  file from another process; consumers that must see those merge the plain
+ *  `loadInjectedDocs` result in before rendering. */
+export function sharedInjectedDocs(nodeId) {
+    let seen = cache.get(nodeId);
+    if (seen === undefined) {
+        seen = loadInjectedDocs(nodeId);
+        cache.set(nodeId, seen);
+    }
+    return seen;
+}
 /** Rehydrate a node's on-read dedup set from disk. Returns an empty set when the
  *  file is absent, unreadable, or malformed (a fresh transcript, or a node that
  *  has not yet surfaced any on-read doc). */
@@ -46,6 +64,7 @@ export function saveInjectedDocs(nodeId, seen) {
 /** Drop a node's persisted dedup set. Called by the launch paths that start a
  *  FRESH transcript, so the new conversation surfaces docs from scratch. */
 export function clearInjectedDocs(nodeId) {
+    cache.delete(nodeId);
     try {
         rmSync(injectedDocsPath(nodeId), { force: true });
     }

package/dist/core/substrate/on-read-node.d.ts

@@ -3,5 +3,7 @@
 export declare function renderOnReadDocs(nodeId: string, readFilePath: string, seen?: Set<string>): string;
 /** Surface workspace-wide docs during first-message assembly, using the node's
  *  recorded cwd and selected profile. `.` is a reserved applies-to target
- *  meaning “when this project store is mounted by cwd/profile”. */
-export declare function renderWorkspaceOpenDocs(nodeId: string): string;
+ *  meaning “when this project store is mounted by cwd/profile” (and, on the
+ *  read event, “a file under the store's owning dir was read”). `seen` is the
+ *  transcript-scoped dedup set shared with the on-read hook. */
+export declare function renderWorkspaceOpenDocs(nodeId: string, seen?: Set<string>): string;

package/dist/core/substrate/on-read-node.js

@@ -22,14 +22,16 @@ export function renderOnReadDocs(nodeId, readFilePath, seen = new Set()) {
 }
 /** Surface workspace-wide docs during first-message assembly, using the node's
  *  recorded cwd and selected profile. `.` is a reserved applies-to target
- *  meaning “when this project store is mounted by cwd/profile”. */
-export function renderWorkspaceOpenDocs(nodeId) {
+ *  meaning “when this project store is mounted by cwd/profile” (and, on the
+ *  read event, “a file under the store's owning dir was read”). `seen` is the
+ *  transcript-scoped dedup set shared with the on-read hook. */
+export function renderWorkspaceOpenDocs(nodeId, seen = new Set()) {
     try {
         const subject = assembleNodeSubject(nodeId);
         const node = getNode(nodeId);
         if (subject === null || node === null)
             return '';
-        return renderWorkspaceOpenDocsForSubject(subject, node.cwd, node.profile_id ?? null);
+        return renderWorkspaceOpenDocsForSubject(subject, node.cwd, node.profile_id ?? null, seen);
     }
     catch {
         return '';

package/dist/core/substrate/on-read.d.ts

@@ -3,5 +3,7 @@ import type { NodeConfigSubject } from './subject-fields.js';
  * daemon snapshot subject. */
 export declare function renderOnReadDocsForSubject(subject: NodeConfigSubject, readFilePath: string, seen?: Set<string>): string;
 /** Workspace boot docs using the snapshot's cwd/profile instead of a canvas
- * lookup. */
-export declare function renderWorkspaceOpenDocsForSubject(subject: NodeConfigSubject, cwd: string, profileId: string | null): string;
+ * lookup. `seen` is the transcript-scoped dedup set shared with the on-read
+ * hook, so a front door delivered here never re-delivers on a later read
+ * beneath its store. */
+export declare function renderWorkspaceOpenDocsForSubject(subject: NodeConfigSubject, cwd: string, profileId: string | null, seen?: Set<string>): string;

package/dist/core/substrate/on-read.js

@@ -12,10 +12,16 @@
 //     visible substrate doc. Project stores encountered between that file and
 //     the filesystem root join the resolved cwd/profile corpus, so a nested
 //     workspace can contribute guidance exactly when a file beneath it is read.
+//     On this event the reserved `applies-to: "."` target means "the read file
+//     is under the doc's store's owning directory" — a nested store's front
+//     door surfaces on the first read beneath it, delivery driven purely by
+//     filesystem truth.
 //   • Opening a workspace evaluates the reserved `applies-to: "."` target for
 //     every project store mounted by the cwd and selected profile. This happens
 //     while the first-message bearings are assembled, so workspace-wide context
 //     arrives before the task rather than waiting for an arbitrary first file.
+//     Both hooks share one transcript-scoped dedup set, so a doc delivered at
+//     workspace open never re-delivers on a later matching read.
 //
 // `read-when` remains an additional OR trigger over a read markdown file's own
 // frontmatter. It does not replace `applies-to`: every non-none file-read rung
@@ -25,7 +31,7 @@
 // is the whole on-read model, so directory INDEX ceilings remain a boot-catalog
 // concern and do not cap a deliberately matched document.
 import { homedir } from 'node:os';
-import { basename, dirname, matchesGlob, parse, relative, sep } from 'node:path';
+import { basename, dirname, isAbsolute, matchesGlob, parse, relative, sep } from 'node:path';
 import { CRTR_DIR_NAME } from '../../types.js';
 import { pathExists, readText, walkFiles } from '../fs-utils.js';
 import { parseFrontmatterGeneric } from '../frontmatter.js';
@@ -175,6 +181,18 @@ function globMatches(glob, absReadFile, owningRoot) {
         }
     });
 }
+/** True when the read file sits beneath the doc's store's owning directory —
+ *  the read-event meaning of the reserved `applies-to: "."` target. Callers
+ *  additionally guard on `doc.scope === 'project'`: a profile store's path
+ *  computes an owning root of `~`, and user/builtin/node docs likewise have no
+ *  project-owning dir, so `.` outside a project store must never match. */
+function underOwningRoot(doc, absReadFile) {
+    const root = owningRootOf(doc);
+    if (root === null)
+        return false;
+    const rel = relative(realpathOrSelf(root), absReadFile);
+    return rel !== '' && !rel.startsWith('..') && !isAbsolute(rel);
+}
 function readFileFrontmatter(absReadFile) {
     if (!/\.(md|mdx|markdown)$/i.test(absReadFile))
         return {};
@@ -186,7 +204,9 @@ function readFileFrontmatter(absReadFile) {
     }
 }
 function matchesReadEvent(doc, absReadFile, readFrontmatter) {
-    const pathMatch = doc.appliesTo?.some((glob) => globMatches(glob, absReadFile, owningRootOf(doc))) === true;
+    const pathMatch = doc.appliesTo?.some((glob) => glob.trim() === '.'
+        ? doc.scope === 'project' && underOwningRoot(doc, absReadFile)
+        : globMatches(glob, absReadFile, owningRootOf(doc))) === true;
     const frontmatterMatch = doc.readWhen !== undefined &&
         Object.keys(readFrontmatter).length > 0 &&
         evalCondition(doc.readWhen, readFrontmatter);
@@ -245,8 +265,10 @@ export function renderOnReadDocsForSubject(subject, readFilePath, seen = new Set
     return renderCandidates(subject, docs, seen);
 }
 /** Workspace boot docs using the snapshot's cwd/profile instead of a canvas
- * lookup. */
-export function renderWorkspaceOpenDocsForSubject(subject, cwd, profileId) {
+ * lookup. `seen` is the transcript-scoped dedup set shared with the on-read
+ * hook, so a front door delivered here never re-delivers on a later read
+ * beneath its store. */
+export function renderWorkspaceOpenDocsForSubject(subject, cwd, profileId, seen = new Set()) {
     let docs;
     try {
         docs = listProjectMemoryDocs(cwd, profileId)
@@ -264,5 +286,5 @@ export function renderWorkspaceOpenDocsForSubject(subject, cwd, profileId) {
         const depth = aRoot.split(sep).filter(Boolean).length - bRoot.split(sep).filter(Boolean).length;
         return depth || aRoot.localeCompare(bRoot) || a.path.localeCompare(b.path);
     });
-    return renderCandidates(subject, docs, new Set());
+    return renderCandidates(subject, docs, seen);
 }

package/dist/pi-extensions/canvas-context-intro.d.ts

@@ -68,7 +68,7 @@ interface PiLike {
 }
 /** Build the full bearings baseline for a conversation without inherited
  *  crouter context. Exported for testing. */
-export declare function buildContextIntro(nodeId: string): Promise<string>;
+export declare function buildContextIntro(nodeId: string, seen?: Set<string>): Promise<string>;
 /** Build the compact node-scoped update for a fork whose copied branch already
  *  carries a full crouter baseline. Exported for testing. */
 export declare function buildForkContextIntro(nodeId: string): Promise<string>;

package/dist/pi-extensions/canvas-context-intro.js

@@ -30,6 +30,7 @@ import { CONTEXT_INTRO_CUSTOM_TYPE } from '../shared/generated-context.js';
 import { brokerExtensionState } from '../core/runtime/broker/daemon-ops.js';
 import { buildContextBearingsFromState, buildForkBearingsFromState, buildProjectContextBlockForBroker } from '../core/runtime/broker-extension-render.js';
 import { situationalContextBlock } from '../core/runtime/situational-context.js';
+import { saveInjectedDocs, sharedInjectedDocs } from '../core/substrate/injected-store.js';
 import { truncateToWidth } from './truncate.js';
 /** The `customType` stamped on the injected session message. Used both to write
  *  the entry and to detect it on resume (the idempotency guard). Defined beside
@@ -41,9 +42,9 @@ export { CONTEXT_INTRO_CUSTOM_TYPE };
 // ---------------------------------------------------------------------------
 /** Build the full bearings baseline for a conversation without inherited
  *  crouter context. Exported for testing. */
-export async function buildContextIntro(nodeId) {
+export async function buildContextIntro(nodeId, seen) {
     const state = await brokerExtensionState(nodeId);
-    return buildContextBearingsFromState(state, buildProjectContextBlockForBroker(state.node.cwd), situationalContextBlock(nodeId));
+    return buildContextBearingsFromState(state, buildProjectContextBlockForBroker(state.node.cwd), situationalContextBlock(nodeId), seen);
 }
 /** Build the compact node-scoped update for a fork whose copied branch already
  *  carries a full crouter baseline. Exported for testing. */
@@ -160,15 +161,25 @@ export function registerCanvasContextIntro(pi) {
         // this fork's new node-scoped facts. A non-crouter branch has no such entry.
         const inherited = contextEntries.length > 0;
         const forked = state.node.fork_from !== null;
+        // The baseline branch renders workspace-open docs, so it threads the
+        // PROCESS-SHARED dedup set: the on-read hook (canvas-doc-substrate) holds
+        // the same Set instance, so a front door delivered here never re-delivers
+        // on a later read beneath its store. The fork branch renders no workspace
+        // docs and needs no set.
+        const seen = inherited && forked ? undefined : sharedInjectedDocs(nodeId);
         const content = inherited && forked
             ? buildForkBearingsFromState(state, situationalContextBlock(nodeId))
-            : buildContextBearingsFromState(state, buildProjectContextBlockForBroker(state.node.cwd), situationalContextBlock(nodeId));
+            : buildContextBearingsFromState(state, buildProjectContextBlockForBroker(state.node.cwd), situationalContextBlock(nodeId), seen);
         pi.sendMessage({
             customType: CONTEXT_INTRO_CUSTOM_TYPE,
             content,
             display: true,
             details: { nodeId },
         });
+        // Persist what the baseline delivered so the dedup survives a later
+        // dormancy → revive(resume) into a fresh process.
+        if (seen !== undefined)
+            saveInjectedDocs(nodeId, seen);
     });
 }
 export default registerCanvasContextIntro;

package/dist/pi-extensions/canvas-doc-substrate.js

@@ -36,7 +36,7 @@ import { brokerExtensionState } from '../core/runtime/broker/daemon-ops.js';
 import { renderPreferencesFromState } from '../core/runtime/broker-extension-render.js';
 import { renderOnReadDocsForSubject } from '../core/substrate/on-read.js';
 import { clearSessionCache } from '../core/substrate/session-cache.js';
-import { loadInjectedDocs, saveInjectedDocs } from '../core/substrate/injected-store.js';
+import { loadInjectedDocs, saveInjectedDocs, sharedInjectedDocs } from '../core/substrate/injected-store.js';
 import { autoLoadedContextInner, mergeAutoLoadedContext } from './envelope-merge.js';
 // ---------------------------------------------------------------------------
 // Extension
@@ -65,7 +65,12 @@ export function registerCanvasDocSubstrate(pi) {
     // dedup must carry forward. The one launch path that begins a FRESH transcript
     // (reviveNode with resume=false) deletes the file, so a new conversation
     // rehydrates empty here. See core/substrate/injected-store.ts.
-    const injectedDocs = loadInjectedDocs(nodeId);
+    //
+    // The set is the PROCESS-SHARED instance (sharedInjectedDocs), so the
+    // context-intro extension's workspace-open render grows the same set this
+    // hook dedups against — a front door delivered at boot never re-delivers on
+    // a later read beneath its store.
+    const injectedDocs = sharedInjectedDocs(nodeId);
     pi.on('session_start', () => {
         // Only the per-session substrate PARSE cache resets each session (so the
         // corpus is re-scanned, picking up memory writes). injectedDocs is
@@ -112,6 +117,12 @@ export function registerCanvasDocSubstrate(pi) {
             const expanded = rawPath.startsWith('~') ? join(homedir(), rawPath.slice(1)) : rawPath;
             const absFile = resolve(cwd, expanded);
             const state = await brokerExtensionState(nodeId);
+            // Merge the on-disk set: an out-of-process delivery (the daemon's
+            // warm-spare claim pushes bearings — including workspace-open docs —
+            // into the live session and persists what it delivered) must dedup here
+            // too. Cheap: one tiny JSON read per `read`.
+            for (const real of loadInjectedDocs(nodeId))
+                injectedDocs.add(real);
             const injected = renderOnReadDocsForSubject(state.subject, absFile, injectedDocs);
             if (injected === '')
                 return; // nothing surfaced — pass the read through unchanged

package/dist/shared/generated-context.d.ts

@@ -46,6 +46,10 @@ export declare function generatedContextText(message: GeneratedContextMessageLik
 export declare function formatContextNudge(note: string): string;
 export declare function isInboxDigest(text: string): boolean;
 export declare function extractInboxSender(text: string): string | null;
+/** Node ids whose section of this digest reports a finished node. Sections are
+ *  delimited by their `From <sender>` headers, so a final never attaches to the
+ *  neighbouring sender. */
+export declare function inboxFinishedSenders(text: string): string[];
 /** Exact producer-owned marker for the continuation a successor broker inserts
  * after a runtime restart. Other recovery bodies intentionally do not match. */
 export declare function isRuntimeRestartContinuation(message: GeneratedContextMessageLike): boolean;

package/dist/shared/generated-context.js

@@ -101,14 +101,33 @@ function nudgeSummary(body) {
 // Senders are node ids, the two reserved words, or the daemon itself (crtrd —
 // review notes and other daemon-originated node messages).
 const INBOX_HEADER_RE = /^From ([a-z0-9]+(?:-[a-z0-9]+)+|system|human|crtrd) — (\d+) update/m;
+const INBOX_HEADERS_RE = /^From ([a-z0-9]+(?:-[a-z0-9]+)+|system|human|crtrd) — (\d+) update/gm;
+// Entry lines inside a section, rendered by core/runtime/broker/inbox.ts as
+// `  [<kind>]`. A final is the one kind that ends the sender's node.
+const FINISHED_ENTRY_RE = /^ {2}\[(?:final|completed)\]/m;
 export function isInboxDigest(text) {
     return INBOX_HEADER_RE.test(text);
 }
 export function extractInboxSender(text) {
     return INBOX_HEADER_RE.exec(text)?.[1] ?? null;
 }
+/** Node ids whose section of this digest reports a finished node. Sections are
+ *  delimited by their `From <sender>` headers, so a final never attaches to the
+ *  neighbouring sender. */
+export function inboxFinishedSenders(text) {
+    const headers = [...text.matchAll(INBOX_HEADERS_RE)];
+    const senders = [];
+    for (const [index, header] of headers.entries()) {
+        const start = header.index ?? 0;
+        const end = headers[index + 1]?.index ?? text.length;
+        const sender = header[1];
+        if (sender !== undefined && FINISHED_ENTRY_RE.test(text.slice(start, end)))
+            senders.push(sender);
+    }
+    return senders;
+}
 function inboxSummary(body) {
-    const headers = [...body.matchAll(/^From ([a-z0-9]+(?:-[a-z0-9]+)+|system|human|crtrd) — (\d+) update/gm)];
+    const headers = [...body.matchAll(INBOX_HEADERS_RE)];
     if (headers.length === 0)
         return 'node update';
     const updates = headers.reduce((total, match) => total + Number(match[2] ?? 0), 0);

package/dist/shared/tool-groups.d.ts

@@ -1,9 +1,9 @@
 /** Broker-generated activity recap for one completed tool-call group. Changed
- * files are counted deterministically by the viewer's GroupActivityRecorder;
- * deletions have no tool of their own, so only the model can evidence them. */
+ * files and spawned/finished nodes are counted deterministically by the viewer's
+ * GroupActivityRecorder; deletions have no tool of their own, so only the model
+ * can evidence them. */
 export interface ToolGroupSummary {
     bullets: string[];
-    nodesSpawned: number;
     filesDeleted: number;
 }
 export interface ToolGroupMessageLike {

package/dist/shared/tool-groups.js

@@ -2,7 +2,7 @@
 // Keep this independent of renderer state: both live event tracking and snapshot
 // reconstruction must agree on which prose closes a run of tools.
 import { generatedContextPresentation, generatedContextText } from './generated-context.js';
-const TOOL_GROUP_SUMMARY_KEYS = new Set(['bullets', 'nodesSpawned', 'filesDeleted']);
+const TOOL_GROUP_SUMMARY_KEYS = new Set(['bullets', 'filesDeleted']);
 const MAX_TOOL_GROUP_BULLETS = 5;
 const MAX_TOOL_GROUP_BULLET_LENGTH = 1_000;
 /** Validate the one durable summary shape and cap its display-sized fields.
@@ -19,15 +19,12 @@ export function normalizeToolGroupSummary(value) {
         return null;
     if (!record.bullets.every((bullet) => typeof bullet === 'string' && bullet.trim() !== ''))
         return null;
-    if (typeof record.nodesSpawned !== 'number' || !Number.isSafeInteger(record.nodesSpawned) || record.nodesSpawned < 0)
-        return null;
     if (typeof record.filesDeleted !== 'number' || !Number.isSafeInteger(record.filesDeleted) || record.filesDeleted < 0)
         return null;
     return {
         bullets: record.bullets
             .slice(0, MAX_TOOL_GROUP_BULLETS)
             .map((bullet) => bullet.trim().slice(0, MAX_TOOL_GROUP_BULLET_LENGTH).trimEnd()),
-        nodesSpawned: record.nodesSpawned,
         filesDeleted: record.filesDeleted,
     };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@north-light/crouter",
-  "version": "0.3.182",
+  "version": "0.3.183",
   "description": "crtr — agent runtime with memory, plugins, and marketplaces",
   "type": "module",
   "main": "dist/index.js",

package/runtime.lock.json

@@ -1,12 +1,12 @@
 {
   "name": "@north-light/crouter",
-  "version": "0.3.182",
+  "version": "0.3.183",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@north-light/crouter",
-      "version": "0.3.182",
+      "version": "0.3.183",
       "hasInstallScript": true,
       "license": "MIT",
       "dependencies": {

package/scripts/postinstall.mjs

@@ -40,7 +40,7 @@ async function main() {
     console.warn('[crtr postinstall] runtime installation failed (non-fatal); no runtime generation was produced. Run `crtr` for remediation guidance or reinstall:', error?.message ?? error);
   }
   await provisionRenderer();
-  console.log('crouter installed. Run `crtr sys setup` to install the companion pi extensions, Claude OAuth, tmux/nvim, and your Exa key.');
+  console.log('crouter installed. Run `crtr sys setup` to install the companion pi extensions, Claude OAuth, and tmux/nvim.');
 }
 
 await main();

package/dist/clients/attach/render/markdown-headings.js

@@ -1,93 +0,0 @@
-// Terminal-specific Markdown heading hierarchy for the attach viewer.
-//
-// pi-tui's MarkdownTheme exposes one `heading(text)` callback without the
-// heading depth. Its renderer does know the depth, but does not pass it to the
-// theme, so every heading otherwise receives the same yellow mdHeading paint.
-// Decorate only the source text of H3–H6 before it reaches pi-tui: pi still
-// owns parsing, wrapping, inline formatting, and H1/H2's established styling.
-// This stays attach-local — persisted messages and copied text remain ordinary
-// Markdown without terminal escape sequences.
-//
-// The same per-block copy carries the viewer's other source-text transform:
-// private-use `U+XXXX` references become their glyphs (see glyph-codepoints.ts),
-// so an agent that cannot type a Nerd Font character can still put one on
-// screen.
-import { expandGlyphCodepoints } from './glyph-codepoints.js';
-const ATX_HEADING = /^(\s{0,3})(#{3,6})(?:[ \t]+|$)(.*?)([ \t]+#+[ \t]*)?$/;
-const FENCE_OPEN = /^\s{0,3}(`{3,}|~{3,})/;
-// A constant-lightness ramp from warm yellow to cool blue, with saturation
-// deliberately reduced at each step so the hierarchy recedes rather than
-// becoming a tour of unrelated accent colors.
-const HEADING_COLORS = [
-    [232, 194, 104],
-    [207, 194, 145],
-    [181, 184, 174],
-    [157, 170, 180],
-    [135, 153, 164],
-    [116, 135, 147],
-];
-function headingColor(level) {
-    const [r, g, b] = HEADING_COLORS[level - 1];
-    return (text) => `\x1b[1;38;2;${r};${g};${b}m${text}\x1b[22;39m`;
-}
-/** Style ATX headings with a scan-friendly terminal hierarchy. The Markdown
- * markers are syntax, not content, so omit them from the rendered line.
- * Fenced examples remain literal Markdown, never decorated terminal output. */
-export function styleAttachMarkdownHeadings(markdown) {
-    let fence;
-    return markdown.split('\n').map((line) => {
-        const fenceMatch = FENCE_OPEN.exec(line);
-        if (fence !== undefined) {
-            if (fenceMatch?.[1][0] === fence)
-                fence = undefined;
-            return line;
-        }
-        if (fenceMatch) {
-            fence = fenceMatch[1][0];
-            return line;
-        }
-        const match = ATX_HEADING.exec(line);
-        if (!match)
-            return line;
-        const [, indent, hashes, body, closing = ''] = match;
-        if (body === '')
-            return line;
-        return `${indent}${headingColor(hashes.length)(body)}`;
-    }).join('\n');
-}
-/** Every source-text transform the viewer applies to a Markdown-bearing block,
- *  in one place: heading hierarchy, then glyph expansion. */
-function renderableText(markdown) {
-    return expandGlyphCodepoints(styleAttachMarkdownHeadings(markdown));
-}
-/** Copy a pi message for terminal rendering and decorate only Markdown-bearing
- * text/thinking blocks. The broker's source event is never mutated. */
-export function styleAttachMessageMarkdown(message) {
-    if (typeof message !== 'object' || message === null || !('content' in message))
-        return message;
-    const candidate = message;
-    if (typeof candidate.content === 'string') {
-        return { ...candidate, content: renderableText(candidate.content) };
-    }
-    if (!Array.isArray(candidate.content))
-        return message;
-    return {
-        ...candidate,
-        content: candidate.content.map((part) => {
-            if (typeof part !== 'object' || part === null)
-                return part;
-            const block = part;
-            if (block.type === 'text' && typeof block.text === 'string') {
-                return { ...block, text: renderableText(block.text) };
-            }
-            if (block.type === 'thinking' && typeof block.thinking === 'string') {
-                return { ...block, thinking: renderableText(block.thinking) };
-            }
-            return part;
-        }),
-    };
-}
-/** Copy an expanded pi summary without changing its persisted source. */
-export function styleAttachSummaryMarkdown(message) {
-    return { ...message, summary: renderableText(message.summary) };
-}

package/dist/commands/search/answer.d.ts

@@ -1 +0,0 @@
-export declare const answerLeaf: import("../../core/command.js").LeafDef;