@north-light/crouter 0.3.196 → 0.3.198

package/dist/core/human/tickets.js

@@ -5,7 +5,7 @@ import { z } from 'zod';
 import { buildPageSummary } from './summary.js';
 import { atomicWriteJson, clearProgress, claimPath, pageManifestPath, pagePath, progressPath, publishJsonExclusive, requireTicket, responsePath, reviewPath } from './convention.js';
 import { validateReviewDescriptor, validateReviewProjection } from './review-schema.js';
-import { derivePageManifestFromDocument, parsePage, PageAuthoringError } from './page.js';
+import { derivePageManifestFromDocument, parsePage, PageAuthoringError, snapshotPageSources } from './page.js';
 import { validatePageResponses, validatePartialPageResponses } from './page-schema.js';
 import { signalInboxActivity } from './root.js';
 import { readTicketClaim, releaseClaimLocked, withTicketLock } from './claim.js';
@@ -62,7 +62,9 @@ export function preparePage(opts) {
         throw new PageAuthoringError(`page source file does not exist: ${opts.sourceFile}`);
     const document = readFileSync(opts.sourceFile, 'utf8');
     const stamped = { ...(opts.source ?? {}), blockedSince: opts.source?.blockedSince ?? new Date().toISOString() };
-    return { dialect: opts.dialect, document, manifest: derivePageManifestFromDocument(document, opts.dialect, opts.productKinds ?? [], stamped) };
+    const authored = derivePageManifestFromDocument(document, opts.dialect, opts.productKinds ?? [], stamped);
+    const manifest = snapshotPageSources(authored, opts.productKinds ?? []);
+    return { dialect: opts.dialect, document, manifest };
 }
 /** Publish one prepared page ticket: the authored source plus its manifest, exclusively. */
 export function publishPage(dir, prepared) {
@@ -170,7 +172,7 @@ function completePageLocked(dir, responses, claimToken, opts) {
     requireClaimOwnership(dir, claimToken);
     const manifest = requirePage(dir, opts.productKinds ?? []);
     const parsedResponses = validatePageResponses(manifest, responses);
-    const result = { schema: 'crtr.page-response/v1', kind: 'page', responses: parsedResponses, summary: buildPageSummary(manifest, parsedResponses), completedAt: opts.completedAt ?? new Date().toISOString() };
+    const result = { schema: 'crtr.page-response/v1', kind: 'page', responses: parsedResponses, summary: buildPageSummary(manifest, parsedResponses, opts.productKinds), completedAt: opts.completedAt ?? new Date().toISOString() };
     const won = exclusiveResult(dir, result);
     clearOwnedWork(dir, claimToken);
     return { won, result: won ? result : readTicketResult(dir) ?? result };

package/dist/core/human/types.d.ts

@@ -4,6 +4,8 @@ export interface TicketSource {
     sessionName?: string;
     askedBy?: string;
     blockedSince?: string;
+    /** Profile name the originating node runs under. Product consumers use this stable name to resolve the applet or worker identity behind the ticket. */
+    profileName?: string;
     /** Originating canvas node id (CRTR_NODE_ID) when the ask was raised inside a crouter canvas node. */
     nodeId?: string;
 }
@@ -48,6 +50,8 @@ export interface ReviewTicketSummary extends TicketSummaryBase {
 /** Page triage fields: a client picks a transcript rendering without a second fetch. */
 export interface PageTicketSummary extends TicketSummaryBase {
     kind: 'page';
+    /** Present on resolved history entries; the stored one-line response digest. */
+    answerDigest?: string;
     dialect: 'md' | 'html';
     placement: 'inline' | 'panel';
     steps: number;

package/dist/core/keybindings/catalog.d.ts

@@ -3,13 +3,13 @@ import type { AttachBindingId, AttachMenuBindingId } from './attach-control.js';
 type TmuxMenuAction = 'open' | 'attach' | 'show' | 'view-settings' | 'fold-tools' | 'metadata' | 'promote' | 'demote-mode' | 'resume' | 'fork' | 'demote' | 'make-resident' | 'detach' | 'close-subtree' | 'background-bash' | 'file-review' | 'pin' | 'reload-viewer' | 'recap' | 'context' | 'providers' | 'plugins' | 'graph' | 'focus-manager' | 'copy-id' | 'issues';
 type TmuxMenuEntryAction = Exclude<TmuxMenuAction, 'open' | 'attach'> | `issue.${'idea' | 'bug'}`;
 type GraphAction = 'down' | 'up' | 'first' | 'last' | 'collapse-or-manager' | 'expand-or-child' | 'focus' | 'revive' | 'focus-manager' | 'close-subtree' | 'dismiss';
-type BrowseAction = 'quit' | 'down' | 'up' | 'first' | 'last' | 'expand-or-child' | 'collapse-or-parent' | 'toggle-fold' | 'tab-next' | 'tab-previous' | `tab.${1 | 2 | 3 | 4 | 5}` | 'close-subtree' | 'confirm-close' | 'sort' | 'scope' | 'profile' | 'residents' | 'preview' | 'search' | 'revive-now' | 'focus' | 'focus-background';
+type BrowseAction = 'quit' | 'down' | 'up' | 'first' | 'last' | 'expand-or-child' | 'collapse-or-parent' | 'toggle-fold' | 'tab-next' | 'tab-previous' | `tab.${1 | 2 | 3 | 4 | 5}` | 'close-subtree' | 'confirm-close' | 'sort' | 'scope' | 'profile' | 'residents' | 'preview' | 'search' | 'revive-now' | 'focus' | 'focus-background' | 'yank-id';
 type ProfileMenuAction = 'up' | 'down' | 'select' | 'accept-default' | 'abort' | `slot.${1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9}` | 'create' | 'search-existing' | 'use-root' | 'set-default' | 'add-directory' | 'unpin';
 type SetupAction = 'cancel' | 'tab-next' | 'tab-previous' | 'open' | 'list-down' | 'list-up' | 'toggle' | 'details' | 'advance' | 'cell-previous' | 'cell-next';
 type SetupKeybindingAction = 'edit' | 'commit-edit' | 'cancel-edit' | 'unbind' | 'reset-row' | 'reset-all' | 'save' | 'discard' | 'page-up' | 'page-down' | 'filter' | 'filter-delete' | 'filter-clear';
 type SetupModelsAction = 'open' | 'commit' | 'cancel' | 'scope-next';
 export type BindingId = `crtr.tmux.menu.${TmuxMenuAction}` | `crtr.tmux.menu.issue.${'idea' | 'bug'}` | AttachMenuBindingId | `crtr.tmux.menu-global.${TmuxMenuEntryAction}` | `crtr.tmux.node.${'next' | 'previous'}` | 'crtr.tmux.inbox.toggle' | `crtr.attach.scroll.${'up' | 'down' | 'page-up' | 'page-down' | 'live'}` | 'crtr.attach.mouse.toggle' | 'crtr.attach.copy.message' | 'crtr.attach.help.toggle' | AttachBindingId | `crtr.graph.${GraphAction}` | `crtr.graph.confirm.${'accept' | 'cancel'}` | `crtr.inspector.${'force-quit' | 'down' | 'up' | 'section-next' | 'section-prev' | 'page-down' | 'page-up' | 'toggle-detail' | 'cancel-item' | 'open-log' | 'confirm' | 'dismiss' | 'retarget' | 'refresh' | 'quit'}` | `crtr.browse.${BrowseAction}` | `crtr.browse.search.${'cancel' | 'commit' | 'delete' | 'quit'}` | `crtr.profile.menu.${ProfileMenuAction}` | `crtr.profile.search.${'up' | 'down' | 'pick' | 'back' | 'delete' | 'abort'}` | `crtr.setup.${SetupAction}` | `crtr.setup.confirm.${'accept' | 'back'}` | `crtr.setup.keybindings.${SetupKeybindingAction}` | `crtr.setup.models.${SetupModelsAction}`;
-export declare const BINDING_CATALOG: readonly [BindingDefinition<"crtr.tmux.menu.open">, BindingDefinition<"crtr.tmux.menu.attach">, ...(BindingDefinition<BindingId> | BindingDefinition<"crtr.tmux.node.next"> | BindingDefinition<"crtr.tmux.node.previous"> | BindingDefinition<"crtr.tmux.inbox.toggle"> | BindingDefinition<"crtr.attach.scroll.up"> | BindingDefinition<"crtr.attach.scroll.down"> | BindingDefinition<"crtr.attach.scroll.page-up"> | BindingDefinition<"crtr.attach.scroll.page-down"> | BindingDefinition<"crtr.attach.scroll.live"> | BindingDefinition<"crtr.attach.mouse.toggle"> | BindingDefinition<"crtr.attach.copy.message"> | BindingDefinition<"crtr.graph.down"> | BindingDefinition<"crtr.graph.up"> | BindingDefinition<"crtr.graph.first"> | BindingDefinition<"crtr.graph.last"> | BindingDefinition<"crtr.graph.collapse-or-manager"> | BindingDefinition<"crtr.graph.expand-or-child"> | BindingDefinition<"crtr.graph.focus"> | BindingDefinition<"crtr.graph.revive"> | BindingDefinition<"crtr.graph.focus-manager"> | BindingDefinition<"crtr.graph.close-subtree"> | BindingDefinition<"crtr.graph.dismiss"> | BindingDefinition<"crtr.graph.confirm.accept"> | BindingDefinition<"crtr.graph.confirm.cancel"> | BindingDefinition<"crtr.inspector.force-quit"> | BindingDefinition<"crtr.inspector.down"> | BindingDefinition<"crtr.inspector.up"> | BindingDefinition<"crtr.inspector.section-next"> | BindingDefinition<"crtr.inspector.section-prev"> | BindingDefinition<"crtr.inspector.page-down"> | BindingDefinition<"crtr.inspector.page-up"> | BindingDefinition<"crtr.inspector.toggle-detail"> | BindingDefinition<"crtr.inspector.cancel-item"> | BindingDefinition<"crtr.inspector.open-log"> | BindingDefinition<"crtr.inspector.confirm"> | BindingDefinition<"crtr.inspector.dismiss"> | BindingDefinition<"crtr.inspector.retarget"> | BindingDefinition<"crtr.inspector.refresh"> | BindingDefinition<"crtr.inspector.quit"> | BindingDefinition<"crtr.browse.quit"> | BindingDefinition<"crtr.browse.down"> | BindingDefinition<"crtr.browse.up"> | BindingDefinition<"crtr.browse.first"> | BindingDefinition<"crtr.browse.last"> | BindingDefinition<"crtr.browse.expand-or-child"> | BindingDefinition<"crtr.browse.collapse-or-parent"> | BindingDefinition<"crtr.browse.toggle-fold"> | BindingDefinition<"crtr.browse.tab-next"> | BindingDefinition<"crtr.browse.tab-previous"> | BindingDefinition<"crtr.browse.tab.2" | "crtr.browse.tab.1" | "crtr.browse.tab.3" | "crtr.browse.tab.4" | "crtr.browse.tab.5"> | BindingDefinition<"crtr.browse.close-subtree"> | BindingDefinition<"crtr.browse.confirm-close"> | BindingDefinition<"crtr.browse.sort"> | BindingDefinition<"crtr.browse.scope"> | BindingDefinition<"crtr.browse.profile"> | BindingDefinition<"crtr.browse.residents"> | BindingDefinition<"crtr.browse.preview"> | BindingDefinition<"crtr.browse.search"> | BindingDefinition<"crtr.browse.revive-now"> | BindingDefinition<"crtr.browse.focus"> | BindingDefinition<"crtr.browse.focus-background"> | BindingDefinition<"crtr.browse.search.cancel"> | BindingDefinition<"crtr.browse.search.commit"> | BindingDefinition<"crtr.browse.search.delete"> | BindingDefinition<"crtr.browse.search.quit"> | BindingDefinition<"crtr.profile.menu.up"> | BindingDefinition<"crtr.profile.menu.down"> | BindingDefinition<"crtr.profile.menu.select"> | BindingDefinition<"crtr.profile.menu.accept-default"> | BindingDefinition<"crtr.profile.menu.abort"> | BindingDefinition<"crtr.profile.menu.slot.2" | "crtr.profile.menu.slot.1" | "crtr.profile.menu.slot.3" | "crtr.profile.menu.slot.4" | "crtr.profile.menu.slot.5" | "crtr.profile.menu.slot.6" | "crtr.profile.menu.slot.7" | "crtr.profile.menu.slot.8" | "crtr.profile.menu.slot.9">)[], BindingDefinition<"crtr.profile.menu.create">, BindingDefinition<"crtr.profile.menu.search-existing">, BindingDefinition<"crtr.profile.menu.use-root">, BindingDefinition<"crtr.profile.menu.set-default">, BindingDefinition<"crtr.profile.menu.add-directory">, BindingDefinition<"crtr.profile.menu.unpin">, BindingDefinition<"crtr.profile.search.up">, BindingDefinition<"crtr.profile.search.down">, BindingDefinition<"crtr.profile.search.pick">, BindingDefinition<"crtr.profile.search.back">, BindingDefinition<"crtr.profile.search.delete">, BindingDefinition<"crtr.profile.search.abort">, BindingDefinition<"crtr.setup.cancel">, BindingDefinition<"crtr.setup.tab-next">, BindingDefinition<"crtr.setup.tab-previous">, BindingDefinition<"crtr.setup.open">, BindingDefinition<"crtr.setup.list-down">, BindingDefinition<"crtr.setup.list-up">, BindingDefinition<"crtr.setup.toggle">, BindingDefinition<"crtr.setup.details">, BindingDefinition<"crtr.setup.advance">, BindingDefinition<"crtr.setup.confirm.accept">, BindingDefinition<"crtr.setup.confirm.back">, BindingDefinition<"crtr.setup.keybindings.edit">, BindingDefinition<"crtr.setup.keybindings.commit-edit">, BindingDefinition<"crtr.setup.keybindings.cancel-edit">, BindingDefinition<"crtr.setup.keybindings.unbind">, BindingDefinition<"crtr.setup.keybindings.reset-row">, BindingDefinition<"crtr.setup.keybindings.reset-all">, BindingDefinition<"crtr.setup.keybindings.save">, BindingDefinition<"crtr.setup.keybindings.discard">, BindingDefinition<"crtr.setup.keybindings.page-up">, BindingDefinition<"crtr.setup.keybindings.page-down">, BindingDefinition<"crtr.setup.keybindings.filter">, BindingDefinition<"crtr.setup.keybindings.filter-delete">, BindingDefinition<"crtr.setup.keybindings.filter-clear">, BindingDefinition<"crtr.setup.cell-previous">, BindingDefinition<"crtr.setup.cell-next">, BindingDefinition<"crtr.setup.models.open">, BindingDefinition<"crtr.setup.models.scope-next">, BindingDefinition<"crtr.setup.models.commit">, BindingDefinition<"crtr.setup.models.cancel">];
+export declare const BINDING_CATALOG: readonly [BindingDefinition<"crtr.tmux.menu.open">, BindingDefinition<"crtr.tmux.menu.attach">, ...(BindingDefinition<BindingId> | BindingDefinition<"crtr.tmux.node.next"> | BindingDefinition<"crtr.tmux.node.previous"> | BindingDefinition<"crtr.tmux.inbox.toggle"> | BindingDefinition<"crtr.attach.scroll.up"> | BindingDefinition<"crtr.attach.scroll.down"> | BindingDefinition<"crtr.attach.scroll.page-up"> | BindingDefinition<"crtr.attach.scroll.page-down"> | BindingDefinition<"crtr.attach.scroll.live"> | BindingDefinition<"crtr.attach.mouse.toggle"> | BindingDefinition<"crtr.attach.copy.message"> | BindingDefinition<"crtr.graph.down"> | BindingDefinition<"crtr.graph.up"> | BindingDefinition<"crtr.graph.first"> | BindingDefinition<"crtr.graph.last"> | BindingDefinition<"crtr.graph.collapse-or-manager"> | BindingDefinition<"crtr.graph.expand-or-child"> | BindingDefinition<"crtr.graph.focus"> | BindingDefinition<"crtr.graph.revive"> | BindingDefinition<"crtr.graph.focus-manager"> | BindingDefinition<"crtr.graph.close-subtree"> | BindingDefinition<"crtr.graph.dismiss"> | BindingDefinition<"crtr.graph.confirm.accept"> | BindingDefinition<"crtr.graph.confirm.cancel"> | BindingDefinition<"crtr.inspector.force-quit"> | BindingDefinition<"crtr.inspector.down"> | BindingDefinition<"crtr.inspector.up"> | BindingDefinition<"crtr.inspector.section-next"> | BindingDefinition<"crtr.inspector.section-prev"> | BindingDefinition<"crtr.inspector.page-down"> | BindingDefinition<"crtr.inspector.page-up"> | BindingDefinition<"crtr.inspector.toggle-detail"> | BindingDefinition<"crtr.inspector.cancel-item"> | BindingDefinition<"crtr.inspector.open-log"> | BindingDefinition<"crtr.inspector.confirm"> | BindingDefinition<"crtr.inspector.dismiss"> | BindingDefinition<"crtr.inspector.retarget"> | BindingDefinition<"crtr.inspector.refresh"> | BindingDefinition<"crtr.inspector.quit"> | BindingDefinition<"crtr.browse.quit"> | BindingDefinition<"crtr.browse.down"> | BindingDefinition<"crtr.browse.up"> | BindingDefinition<"crtr.browse.first"> | BindingDefinition<"crtr.browse.last"> | BindingDefinition<"crtr.browse.expand-or-child"> | BindingDefinition<"crtr.browse.collapse-or-parent"> | BindingDefinition<"crtr.browse.toggle-fold"> | BindingDefinition<"crtr.browse.tab-next"> | BindingDefinition<"crtr.browse.tab-previous"> | BindingDefinition<"crtr.browse.tab.2" | "crtr.browse.tab.1" | "crtr.browse.tab.3" | "crtr.browse.tab.4" | "crtr.browse.tab.5"> | BindingDefinition<"crtr.browse.close-subtree"> | BindingDefinition<"crtr.browse.confirm-close"> | BindingDefinition<"crtr.browse.sort"> | BindingDefinition<"crtr.browse.scope"> | BindingDefinition<"crtr.browse.profile"> | BindingDefinition<"crtr.browse.residents"> | BindingDefinition<"crtr.browse.preview"> | BindingDefinition<"crtr.browse.search"> | BindingDefinition<"crtr.browse.revive-now"> | BindingDefinition<"crtr.browse.focus"> | BindingDefinition<"crtr.browse.focus-background"> | BindingDefinition<"crtr.browse.yank-id"> | BindingDefinition<"crtr.browse.search.cancel"> | BindingDefinition<"crtr.browse.search.commit"> | BindingDefinition<"crtr.browse.search.delete"> | BindingDefinition<"crtr.browse.search.quit"> | BindingDefinition<"crtr.profile.menu.up"> | BindingDefinition<"crtr.profile.menu.down"> | BindingDefinition<"crtr.profile.menu.select"> | BindingDefinition<"crtr.profile.menu.accept-default"> | BindingDefinition<"crtr.profile.menu.abort"> | BindingDefinition<"crtr.profile.menu.slot.2" | "crtr.profile.menu.slot.1" | "crtr.profile.menu.slot.3" | "crtr.profile.menu.slot.4" | "crtr.profile.menu.slot.5" | "crtr.profile.menu.slot.6" | "crtr.profile.menu.slot.7" | "crtr.profile.menu.slot.8" | "crtr.profile.menu.slot.9">)[], BindingDefinition<"crtr.profile.menu.create">, BindingDefinition<"crtr.profile.menu.search-existing">, BindingDefinition<"crtr.profile.menu.use-root">, BindingDefinition<"crtr.profile.menu.set-default">, BindingDefinition<"crtr.profile.menu.add-directory">, BindingDefinition<"crtr.profile.menu.unpin">, BindingDefinition<"crtr.profile.search.up">, BindingDefinition<"crtr.profile.search.down">, BindingDefinition<"crtr.profile.search.pick">, BindingDefinition<"crtr.profile.search.back">, BindingDefinition<"crtr.profile.search.delete">, BindingDefinition<"crtr.profile.search.abort">, BindingDefinition<"crtr.setup.cancel">, BindingDefinition<"crtr.setup.tab-next">, BindingDefinition<"crtr.setup.tab-previous">, BindingDefinition<"crtr.setup.open">, BindingDefinition<"crtr.setup.list-down">, BindingDefinition<"crtr.setup.list-up">, BindingDefinition<"crtr.setup.toggle">, BindingDefinition<"crtr.setup.details">, BindingDefinition<"crtr.setup.advance">, BindingDefinition<"crtr.setup.confirm.accept">, BindingDefinition<"crtr.setup.confirm.back">, BindingDefinition<"crtr.setup.keybindings.edit">, BindingDefinition<"crtr.setup.keybindings.commit-edit">, BindingDefinition<"crtr.setup.keybindings.cancel-edit">, BindingDefinition<"crtr.setup.keybindings.unbind">, BindingDefinition<"crtr.setup.keybindings.reset-row">, BindingDefinition<"crtr.setup.keybindings.reset-all">, BindingDefinition<"crtr.setup.keybindings.save">, BindingDefinition<"crtr.setup.keybindings.discard">, BindingDefinition<"crtr.setup.keybindings.page-up">, BindingDefinition<"crtr.setup.keybindings.page-down">, BindingDefinition<"crtr.setup.keybindings.filter">, BindingDefinition<"crtr.setup.keybindings.filter-delete">, BindingDefinition<"crtr.setup.keybindings.filter-clear">, BindingDefinition<"crtr.setup.cell-previous">, BindingDefinition<"crtr.setup.cell-next">, BindingDefinition<"crtr.setup.models.open">, BindingDefinition<"crtr.setup.models.scope-next">, BindingDefinition<"crtr.setup.models.commit">, BindingDefinition<"crtr.setup.models.cancel">];
 export declare const BINDING_IDS: ReadonlySet<string>;
 /** True for an action whose direct gesture is handled inside an attach viewer.
  *  Tmux menu selectors and root shortcuts are chrome, not pane input. */

package/dist/core/keybindings/catalog.js

@@ -142,6 +142,7 @@ function browseBindings() {
         b('crtr.browse.revive-now', 'Browse and pickers', 'Revive now', 'Revive the selected node now.', ['shift+k'], 'terminal', [nav]),
         b('crtr.browse.focus', 'Browse and pickers', 'Focus node', 'Focus the selected node.', ['enter', 'o'], 'terminal', [nav]),
         b('crtr.browse.focus-background', 'Browse and pickers', 'Focus node (keep browsing)', 'Focus the selected node without leaving the navigator.', ['shift+o'], 'terminal', [nav]),
+        b('crtr.browse.yank-id', 'Browse and pickers', 'Yank node id', 'Copy the selected node id to the system clipboard.', ['y'], 'terminal', [nav]),
         b('crtr.browse.search.cancel', 'Browse and pickers', 'Cancel search', 'Cancel browse search.', ['escape'], 'terminal', ['browse.search'], 'dismiss-modal'),
         b('crtr.browse.search.commit', 'Browse and pickers', 'Commit search', 'Apply browse search.', ['enter'], 'terminal', ['browse.search']),
         b('crtr.browse.search.delete', 'Browse and pickers', 'Delete search text', 'Delete the previous search character.', ['backspace'], 'terminal', ['browse.search']),

package/dist/core/review/realize.js

@@ -6,6 +6,7 @@ import { atomicWriteJson } from '../human/convention.js';
 import { ticketDir } from '../human/root.js';
 import { submitReview } from '../human/tickets.js';
 import { NodeIdConflictError, spawnNode } from '../runtime/nodes.js';
+import { loadProfileManifest } from '../profiles/manifest.js';
 import { transition } from '../runtime/lifecycle.js';
 import { reviveNode } from '../runtime/revive.js';
 import { awaitCompanionBind, spawnReviewCompanion } from './companion.js';
@@ -126,6 +127,10 @@ function publishTicket(review) {
         throw bridgeUnsubscribed(review, '');
     if (review.subtitle === null)
         throw new Error(`ticket review has no subtitle: ${review.review_id}`);
+    const origin = requireOrigin(review);
+    const profileName = origin.profile_id == null
+        ? undefined
+        : loadProfileManifest(origin.profile_id).manifest.name;
     submitReview({
         dir: ticketDir(review.bridge_node_id),
         review: {
@@ -133,7 +138,10 @@ function publishTicket(review) {
             ...(review.output_path !== null ? { output: review.output_path } : {}),
             title: basename(review.file),
             subtitle: review.subtitle,
-            source: { nodeId: review.origin_node_id },
+            source: {
+                nodeId: review.origin_node_id,
+                ...(profileName === undefined ? {} : { profileName }),
+            },
             blockedSince: review.created,
         },
     });

package/dist/core/runtime/boot-root.js

@@ -89,7 +89,12 @@ export async function bootRoot(opts) {
     // user's OWN pre-existing shell pane (not one crtr split open): on a
     // detach-reap of an empty root it must delete the node WITHOUT kill-pane, else
     // a plain ctrl+c closes the user's whole tmux pane.
-    const attachEnv = { ...process.env, ...viewerSplitEnv(), CRTR_ATTACH_WAIT_MS: '30000' };
+    const attachEnv = {
+        ...process.env,
+        ...viewerSplitEnv(),
+        CRTR_ATTACH_WAIT_MS: '30000',
+        ...(opts.prompt !== undefined && opts.prompt !== '' ? { CRTR_ATTACH_INITIAL_WHIP: '1' } : {}),
+    };
     if (here !== null)
         attachEnv['CRTR_ATTACH_BORROWED_PANE'] = here.pane;
     mark('boot_root.viewer_spawn');

package/dist/core/runtime/broker.js

@@ -120,7 +120,8 @@ export function disposeActiveSession() {
 // ---------------------------------------------------------------------------
 export async function runBroker(nodeId, startupAt = process.hrtime.bigint(), startupTs = new Date().toISOString()) {
     // A clean-abort certificate belongs only to the dead broker that wrote it.
-    // Fleet classification consumes it before launching this successor.
+    // Fleet classification consumes it as proof that the dead broker had a turn
+    // in flight even though Pi's settled abort already cleared the busy marker.
     clearCleanAbort(nodeId);
     // The canonical broker event source (job/log.jsonl) is bound before any other
     // work in this function — no path/env/state setup may precede it, and the
@@ -594,9 +595,10 @@ export async function runBroker(nodeId, startupAt = process.hrtime.bigint(), sta
     // A daemon fleet bounce gives a busy Pi a short, bounded chance to persist
     // its aborted turn before teardown. `session.abort()` resolves only after Pi
     // reaches idle (and thus after its message_end persistence); only then may we
-    // leave the durable clean-abort certificate that changes recovery to resume.
-    // A timeout/rejection deliberately leaves no certificate, preserving dirty
-    // crash → recovery-cycle behavior and the fleet's shared SIGKILL deadline.
+    // leave the durable clean-abort certificate that preserves the otherwise
+    // cleared evidence that this broker had a turn in flight. A timeout/rejection
+    // deliberately leaves no certificate: the surviving busy marker carries the
+    // same interrupted-turn fact through the fleet's shared SIGKILL deadline.
     const ABORT_BEFORE_EXIT_MS = 2_500;
     let signalExitInFlight = false;
     const abortAndExit = async (reason) => {
@@ -633,8 +635,8 @@ export async function runBroker(nodeId, startupAt = process.hrtime.bigint(), sta
             }
             else if (frameDispatch.pendingPromptDispatches() > 0 || rebind.isAgentRunActive()) {
                 // The engine never reached an abortable persisted turn in the budget.
-                // Preserve the existing dirty-death recovery cycle rather than certifying
-                // a session that may not contain the prompt it was preparing.
+                // Preserve the dirty interrupted-turn witness so recovery resumes the
+                // saved transcript and explicitly re-drives the stopped work.
                 markBusy(nodeId);
             }
         }

package/dist/core/runtime/busy.d.ts

@@ -4,12 +4,13 @@ export declare function markBusy(nodeId: string): void;
 /** Clear the mid-run marker after Pi settles, however it routed. Best-effort. */
 export declare function clearBusy(nodeId: string): void;
 /** Certify that this broker aborted a busy turn and Pi persisted its settled
- * aborted entry before teardown. The daemon consumes this durable certificate
- * once to resume with a continuation; a dirty death never writes it. */
+ * aborted entry before teardown. Settling clears the busy marker, so the daemon
+ * consumes this durable certificate as the surviving interrupted-turn witness
+ * and resumes with a continuation. A dirty death instead leaves `busy` behind. */
 export declare function markCleanAbort(nodeId: string): void;
 /** Remove a consumed clean-abort certificate as a broker boots. */
 export declare function clearCleanAbort(nodeId: string): void;
-/** Whether the dead broker left a persisted clean-abort certificate. */
+/** Whether the dead broker left a persisted clean-abort turn witness. */
 export declare function hasCleanAbort(nodeId: string): boolean;
 /** Is the node currently inside a turn? AND this with `pidAlive` at the call
  *  site — a stale marker from a crashed pi is harmless because the dead pid

package/dist/core/runtime/busy.js

@@ -44,8 +44,9 @@ export function clearBusy(nodeId) {
     }
 }
 /** Certify that this broker aborted a busy turn and Pi persisted its settled
- * aborted entry before teardown. The daemon consumes this durable certificate
- * once to resume with a continuation; a dirty death never writes it. */
+ * aborted entry before teardown. Settling clears the busy marker, so the daemon
+ * consumes this durable certificate as the surviving interrupted-turn witness
+ * and resumes with a continuation. A dirty death instead leaves `busy` behind. */
 export function markCleanAbort(nodeId) {
     try {
         mkdirSync(jobDir(nodeId), { recursive: true });
@@ -64,7 +65,7 @@ export function clearCleanAbort(nodeId) {
         /* best-effort */
     }
 }
-/** Whether the dead broker left a persisted clean-abort certificate. */
+/** Whether the dead broker left a persisted clean-abort turn witness. */
 export function hasCleanAbort(nodeId) {
     return existsSync(cleanAbortPath(nodeId));
 }

package/dist/core/runtime/spawn.js

@@ -401,15 +401,15 @@ export async function spawnChildPrepared(opts, beforeBrokerLaunch) {
                     // have bound view.sock yet. Hand the attach pane CRTR_ATTACH_WAIT_MS so
                     // it self-polls the socket until it accepts instead of connecting once,
                     // finding a cold socket, and closing the pane instantly — the exact
-                    // mechanism bootRoot uses. Mark this as the initial auto-opened child
-                    // viewer too, so whip_mode can greet it without firing on ordinary
-                    // focus/attach paths. No pre-wait in this CLI subprocess.
+                    // mechanism bootRoot uses. A child with a kickoff prompt marks its
+                    // initial viewer for whip_mode; ordinary focus/attach paths stay
+                    // silent. No pre-wait in this CLI subprocess.
                     const viewer = openViewerWindow(meta.node_id, parentViewer.session ?? '', {
                         name: fullName(meta),
                         cwd: opts.cwd,
                         besidePane: parentViewer.pane,
                         waitForBroker: true,
-                        initialWhip: true,
+                        initialWhip: hasKickoff,
                     });
                     if (viewer !== null && viewer.pane !== null && viewer.pane !== '') {
                         session = viewer.session;

package/dist/core/termrender/display.d.ts

@@ -6,7 +6,11 @@ export interface DisplayOpts {
     /** Pane budget per window before `'auto'` opens a new window. Default 3. */
     maxPanes?: number;
 }
-export declare function countPanesInCurrentWindow(): number;
-export declare function display(path: string, opts?: DisplayOpts): {
-    paneId?: string;
+export type DisplayResult = {
+    paneId: string;
+    reason?: never;
+} | {
+    paneId?: never;
+    reason: string;
 };
+export declare function display(path: string, opts?: DisplayOpts): DisplayResult;

package/dist/core/termrender/display.js

@@ -1,19 +1,55 @@
 import { spawnSync } from 'node:child_process';
-import { displayInPane } from './termrender.js';
-export function countPanesInCurrentWindow() {
-    // -t '' targets the current window of the current session.
-    const result = spawnSync('tmux', ['list-panes', '-F', '#{pane_id}'], {
+import { resolve } from 'node:path';
+import { breakPane, closePane, currentTmux, paneOfNode, splitWindow, } from '../runtime/placement-tmux.js';
+import { documentWatchCommand } from './termrender.js';
+function targetPane() {
+    const callerPane = process.env['TMUX_PANE'];
+    if (callerPane !== undefined && callerPane !== '')
+        return callerPane;
+    const nodeId = process.env['CRTR_NODE_ID'];
+    if (nodeId !== undefined && nodeId !== '') {
+        const viewerPane = paneOfNode(nodeId);
+        if (viewerPane !== null)
+            return viewerPane;
+    }
+    return currentTmux()?.pane ?? null;
+}
+function countPanes(target) {
+    const result = spawnSync('tmux', ['list-panes', '-t', target, '-F', '#{pane_id}'], {
         encoding: 'utf8',
     });
     if (result.status !== 0)
-        return 0;
+        return null;
     return result.stdout.split('\n').filter((line) => line.trim() !== '').length;
 }
 export function display(path, opts) {
     const window = (opts?.window === 'split' || opts?.window === 'new') ? opts.window : 'auto';
     const maxPanes = (opts?.maxPanes !== undefined && opts.maxPanes > 0) ? opts.maxPanes : 3;
-    const newWindow = window === 'new' ||
-        (window === 'auto' && countPanesInCurrentWindow() >= maxPanes);
-    // The pane always watches the file — displayed docs are live by definition.
-    return displayInPane(path, { newWindow });
+    const command = documentWatchCommand(resolve(path));
+    if (command === null)
+        return { reason: 'renderer unavailable' };
+    const target = targetPane();
+    if (target === null)
+        return { reason: 'no pane on screen' };
+    let newWindow = window === 'new';
+    if (window === 'auto') {
+        const paneCount = countPanes(target);
+        if (paneCount === null)
+            return { reason: `tmux could not inspect target pane ${target}` };
+        newWindow = paneCount >= maxPanes;
+    }
+    const pane = splitWindow(target, {
+        cwd: process.cwd(),
+        env: {},
+        command,
+    });
+    if (pane === null)
+        return { reason: `tmux could not split target pane ${target}` };
+    if (!newWindow)
+        return { paneId: pane };
+    const opened = breakPane(pane);
+    if (opened !== null)
+        return { paneId: opened.pane };
+    closePane(pane);
+    return { reason: 'tmux could not move the document pane into a new window' };
 }

package/dist/core/termrender/termrender.d.ts

@@ -59,15 +59,6 @@ export declare function checkMarkdown(md: string): {
     ok: false;
     error: string;
 };
-export interface DisplayInPaneOpts {
-    /** Open in a new tmux window instead of splitting the current one. */
-    newWindow?: boolean;
-}
-/**
- * Spawn termrender into a live tmux pane. The pane-budget policy (whether to
- * split vs open a new window) is decided by the caller (`src/surfaces/
- * display.ts`); this is the thin managed-binary spawn it delegates to.
- */
-export declare function displayInPane(path: string, opts?: DisplayInPaneOpts): {
-    paneId?: string;
-};
+/** Shell command for a pane that live-renders `path` with crouter's pinned
+ *  termrender. Null means the managed renderer could not be provisioned. */
+export declare function documentWatchCommand(path: string): string | null;

package/dist/core/termrender/termrender.js

@@ -3,6 +3,7 @@ import { existsSync, readFileSync, writeFileSync, statSync, mkdirSync, unlinkSyn
 import { homedir } from 'node:os';
 import { join, resolve } from 'node:path';
 import stringWidth from 'string-width';
+import { shellQuote } from '../../shared/shell-quote.js';
 import { withExclusiveDirectoryLock } from '../exclusive-lock.js';
 import { TERMRENDER_VERSION } from './version.js';
 // ── The sole org-wide termrender binding ─────────────────────────────────────
@@ -703,43 +704,11 @@ export function checkMarkdown(md) {
     }
     return { ok: true };
 }
-/**
- * Spawn termrender into a live tmux pane. The pane-budget policy (whether to
- * split vs open a new window) is decided by the caller (`src/surfaces/
- * display.ts`); this is the thin managed-binary spawn it delegates to.
- */
-export function displayInPane(path, opts = {}) {
+/** Shell command for a pane that live-renders `path` with crouter's pinned
+ *  termrender. Null means the managed renderer could not be provisioned. */
+export function documentWatchCommand(path) {
     ensureRenderer();
     if (rendererState !== 'ready')
-        return {};
-    // Always watch: a displayed pane is a live view of the file by definition.
-    const args = ['pane', 'open', path, '--watch'];
-    args.push('--window', opts.newWindow ? 'new' : 'split');
-    const result = spawnSync(VENV_BIN, args, {
-        encoding: 'utf-8',
-        stdio: ['pipe', 'pipe', 'pipe'],
-    });
-    // A spawn fault (binary broke) invalidates readiness; a non-zero exit (e.g.
-    // tmux refused, bad path) is not an environment fault and must not.
-    if (result.error) {
-        invalidateRenderer('pane open');
-        return {};
-    }
-    if (result.status !== 0)
-        return {};
-    // `encoding: 'utf-8'` makes spawnSync return stdout as a string.
-    const rawStdout = result.stdout;
-    if (!rawStdout)
-        return {};
-    let parsed = null;
-    try {
-        parsed = JSON.parse(rawStdout.trim());
-    }
-    catch {
-        return {};
-    }
-    if (parsed && typeof parsed.pane_id === 'string' && parsed.pane_id) {
-        return { paneId: parsed.pane_id };
-    }
-    return {};
+        return null;
+    return `${shellQuote(VENV_BIN)} doc watch ${shellQuote(path)}`;
 }

package/dist/core/user-settings.d.ts

@@ -147,6 +147,21 @@ export declare const CONFIG_SETTINGS_COVERAGE: {
             setFromString: (config: ScopeConfig, raw: string) => string | null;
         };
     };
+    html_surface: {
+        surface: "settings";
+        setting: {
+            key: "html_surface";
+            label: string;
+            description: string;
+            valueConstraint: string;
+            applies: string;
+            group: "display";
+            order: number;
+            format: (config: ScopeConfig) => "on" | "off";
+            cycle: (config: ScopeConfig) => void;
+            setFromString: (config: ScopeConfig, raw: string) => string | null;
+        };
+    };
     whip_messages: {
         surface: "specialized";
         owner: string;
@@ -196,10 +211,10 @@ export declare const CONFIG_SETTINGS_COVERAGE: {
             setFromString: (config: ScopeConfig, raw: string) => string | null;
         };
     };
-    html_pages: {
+    bash_tool_purpose: {
         surface: "settings";
         setting: {
-            key: "html_pages";
+            key: "bash_tool_purpose";
             label: string;
             description: string;
             valueConstraint: string;

package/dist/core/user-settings.js

@@ -176,7 +176,7 @@ export const CONFIG_SETTINGS_COVERAGE = {
         setting: {
             key: 'whip_mode',
             label: 'Whip mode',
-            description: 'Play the whip animation when you send a prompt and when an automatically opened child viewer starts.',
+            description: 'Play the whip animation when you send a prompt and when a viewer opens for an agent with an initial prompt.',
             valueConstraint: 'true|false',
             applies: 'Applies on the next attach.',
             group: 'display',
@@ -192,6 +192,27 @@ export const CONFIG_SETTINGS_COVERAGE = {
             },
         },
     },
+    html_surface: {
+        surface: 'settings',
+        setting: {
+            key: 'html_surface',
+            label: 'HTML human surface',
+            description: 'Prompt agents to use HTML pages by default for structured or interactive content shown to you.',
+            valueConstraint: 'true|false',
+            applies: 'Applies when human command help is assembled.',
+            group: 'display',
+            order: 37,
+            format: (config) => config.html_surface ? 'on' : 'off',
+            cycle: (config) => { config.html_surface = !config.html_surface; },
+            setFromString: (config, raw) => {
+                const value = booleanFromString(raw, 'html_surface');
+                if (typeof value === 'string')
+                    return value;
+                config.html_surface = value;
+                return null;
+            },
+        },
+    },
     whip_messages: { surface: 'specialized', owner: 'sys config set whip_messages' },
     mouse_mode_default: {
         surface: 'settings',
@@ -254,23 +275,23 @@ export const CONFIG_SETTINGS_COVERAGE = {
             },
         },
     },
-    html_pages: {
+    bash_tool_purpose: {
         surface: 'settings',
         setting: {
-            key: 'html_pages',
-            label: 'HTML pages',
-            description: 'Teach agent help the HTML page-authoring dialect. Off keeps page authoring Markdown-only.',
+            key: 'bash_tool_purpose',
+            label: 'Bash purpose field',
+            description: 'Expose the optional purpose label to agents in the bash tool schema. Off removes the field without disabling the bash valve.',
             valueConstraint: 'true|false',
-            applies: 'Applies on the next help request.',
+            applies: 'Applies on the next node session.',
             group: 'display',
-            order: 70,
-            format: (config) => config.html_pages ? 'on' : 'off',
-            cycle: (config) => { config.html_pages = !config.html_pages; },
+            order: 25,
+            format: (config) => config.bash_tool_purpose ? 'on' : 'off',
+            cycle: (config) => { config.bash_tool_purpose = !config.bash_tool_purpose; },
             setFromString: (config, raw) => {
-                const value = booleanFromString(raw, 'html_pages');
+                const value = booleanFromString(raw, 'bash_tool_purpose');
                 if (typeof value === 'string')
                     return value;
-                config.html_pages = value;
+                config.bash_tool_purpose = value;
                 return null;
             },
         },

package/dist/daemon/api/handlers/human.js

@@ -93,7 +93,7 @@ async function handleResolve(ctx) {
     const request = requireResolveRequest(ctx);
     const dir = ticketDir(nodeId);
     requirePageTicket(dir);
-    const productKinds = readConfig('user').page_components ?? [];
+    const productKinds = readConfig('user').page_components;
     const responses = preflightResolve(() => validatePageTicketResponses(dir, request.responses, productKinds));
     await resolvePageTicket(nodeId, responses, productKinds);
     return { status: 200, body: { delivered: true, kind: 'page' } };