@north-light/crouter 0.3.197 → 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/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' } };

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

@@ -7,10 +7,12 @@ import { basename, resolve, join } from 'node:path';
 import { ApiError } from '../../../api/index.js';
 import { assetRoot } from '../../../core/asset-root.js';
 import { pageManifestPath, reviewPath } from '../../../core/human/convention.js';
+import { parsePage } from '../../../core/human/page.js';
 import { renderPageHtml } from '../../../core/human/page-render.js';
 import { ticketsRoot } from '../../../core/human/root.js';
 import { scanInbox, scanPageHistory } from '../../../core/human/scan.js';
 import { readPageTicket, readTicketResult, validatePageTicketResponses, writePageProgress, } from '../../../core/human/tickets.js';
+import { describePageAnswer } from '../../../core/human/answer.js';
 import { readConfig } from '../../../core/config.js';
 import { cancelHumanTicket, resolvePageTicket } from '../../human/finish.js';
 import { filterTerminalReviewTickets } from '../../../core/review/ticket-filter.js';
@@ -80,6 +82,8 @@ function pageSlotToDTO(slot) {
         dto.id = slot.id;
     if (slot.unvalidated === true)
         dto.unvalidated = true;
+    if (slot.display === true)
+        dto.display = true;
     return dto;
 }
 function pageManifestToDTO(manifest) {
@@ -102,6 +106,8 @@ function pageManifestToDTO(manifest) {
             source.askedBy = manifest.source.askedBy;
         if (manifest.source.blockedSince !== undefined)
             source.blockedSince = manifest.source.blockedSince;
+        if (manifest.source.profileName !== undefined)
+            source.profileName = manifest.source.profileName;
         if (manifest.source.nodeId !== undefined)
             source.nodeId = manifest.source.nodeId;
         if (Object.keys(source).length > 0)
@@ -163,7 +169,7 @@ function isSlotValidationError(err) {
 // GET /v1/human/inbox — enumerate
 // ===========================================================================
 function handleList() {
-    const productKinds = readConfig('user').page_components ?? [];
+    const productKinds = readConfig('user').page_components;
     const allItems = scanInbox(productKinds);
     const filtered = filterTerminalReviewTickets(allItems);
     const tickets = filtered.map((item) => {
@@ -210,7 +216,7 @@ function handleHistory(ctx) {
     if (!nodeId || typeof nodeId !== 'string') {
         throw new ApiError(400, 'invalid_request', 'history requires a node_id query param');
     }
-    const productKinds = readConfig('user').page_components ?? [];
+    const productKinds = readConfig('user').page_components;
     const history = scanPageHistory(nodeId, productKinds);
     const canonicalRoot = realpathSync(ticketsRoot());
     const tickets = history.map((item) => {
@@ -230,6 +236,8 @@ function handleHistory(ctx) {
         };
         if (item.subtitle !== '')
             dto.subtitle = item.subtitle;
+        if (item.answerDigest !== undefined)
+            dto.answer_digest = item.answerDigest;
         return dto;
     });
     return { status: 200, body: { tickets } };
@@ -245,7 +253,7 @@ function handleGetPage(ctx) {
     if (resolved.kind === 'review') {
         throw new ApiError(409, 'ticket_kind_unsupported', 'review tickets have no page read operation');
     }
-    const productKinds = readConfig('user').page_components ?? [];
+    const productKinds = readConfig('user').page_components;
     let ticket;
     try {
         ticket = readPageTicket(resolved.dir, productKinds);
@@ -287,7 +295,7 @@ async function handleRespond(ctx) {
     if (result?.kind === 'canceled') {
         throw new ApiError(409, 'ticket_canceled', 'canceled tickets cannot be answered');
     }
-    const productKinds = readConfig('user').page_components ?? [];
+    const productKinds = readConfig('user').page_components;
     try {
         validatePageTicketResponses(resolved.dir, request.responses, productKinds);
     }
@@ -330,7 +338,7 @@ function handleProgress(ctx) {
     if (result !== null && result.kind !== 'canceled') {
         throw new ApiError(409, 'ticket_already_resolved', 'ticket was already resolved');
     }
-    const productKinds = readConfig('user').page_components ?? [];
+    const productKinds = readConfig('user').page_components;
     try {
         writePageProgress(resolved.dir, request.responses, productKinds);
         return { status: 200, body: {} };
@@ -390,7 +398,14 @@ function handleGetResponse(ctx) {
     if (result.kind !== 'page') {
         throw new ApiError(409, 'ticket_kind_mismatch', 'unexpected result kind');
     }
-    return { status: 200, body: result };
+    const productKinds = readConfig('user').page_components;
+    try {
+        const manifest = parsePage(resolved.dir, productKinds);
+        return { status: 200, body: { ...result, answer: describePageAnswer(manifest, result.responses, { completedAt: result.completedAt, productKinds }) } };
+    }
+    catch {
+        throw new ApiError(500, 'internal', 'the ticket answer could not be read');
+    }
 }
 // ===========================================================================
 // GET /v1/human/inbox/:ticket_id/render — the page's HTML payload
@@ -403,7 +418,7 @@ function handleRenderPage(ctx) {
     if (resolved.kind === 'review') {
         throw new ApiError(409, 'ticket_kind_unsupported', 'review tickets have no page render operation');
     }
-    const productKinds = readConfig('user').page_components ?? [];
+    const productKinds = readConfig('user').page_components;
     // Addressable for pending, resolved, and canceled tickets alike — the same
     // read rule as the detail route: a page stays readable after it resolves.
     let ticket;

package/dist/daemon/cron-run.js

@@ -163,6 +163,16 @@ function resolveLiveProfile(c) {
         return null;
     }
 }
+function resolveLiveProfileName(c) {
+    if (c.profile == null)
+        return undefined;
+    try {
+        return loadProfileManifest(c.profile).manifest.name;
+    }
+    catch {
+        return undefined;
+    }
+}
 // ---------------------------------------------------------------------------
 // Delivery sinks
 // ---------------------------------------------------------------------------
@@ -223,10 +233,14 @@ function deliverHumanSink(c, stdout) {
     // half-built `nfy-*` directory behind.
     let prepared;
     try {
+        const profileName = resolveLiveProfileName(c);
         prepared = preparePage({
             sourceFile: synthesized.path,
-            dialect: 'md',
-            source: { sessionName: `cron ${c.name} (${c.cron_id})` },
+            dialect: 'html',
+            source: {
+                sessionName: `cron ${c.name} (${c.cron_id})`,
+                ...(profileName === undefined ? {} : { profileName }),
+            },
             productKinds: readConfig('user').page_components,
         });
     }

package/dist/daemon/crtrd.js

@@ -8,7 +8,7 @@
 // The fleet registry's entry IS the node's liveness — no pid probe, no grace
 // clock. A broker's real `exit` event enqueues an exit-policy job on the
 // daemon's serial work lane (never inline on the Node event callback), where
-// classifyDeadNode — one pure 9-row policy table over durable row state —
+// classifyDeadNode — one pure 8-row policy table over durable row state —
 // decides forget / dormant / respawn / boot-failure. The startup recovery
 // sweep classifies boot-time dead rows through the SAME table, so exit
 // recovery and startup recovery can never diverge. Every broker's argv is

package/dist/daemon/fleet.d.ts

@@ -10,12 +10,16 @@ import type { HostHandle } from '../core/runtime/host.js';
  *  seeing a silent `dead`. */
 export declare function surfaceBootFailure(meta: NodeMeta): Promise<void>;
 /** Whether a dead relaunch should resume the saved session strictly, or retry
- *  as a fresh cycle instead. A cycling attempt (cycle_pending) that dies
- *  before session_start must retry AS a cycle — a strict reopen only restores
- *  the transcript at an idle prompt, it cannot restart the dead engine turn.
- *  A dirty interrupted BUSY turn also requests a cycle; a broker-certified
- *  clean abort is handled explicitly by classifyDeadNode before this fallback. */
-export declare function retryResumeMode(meta: Pick<NodeMeta, 'cycle_pending'> | null, interruptedTurn?: boolean): boolean;
+ *  as a fresh cycle instead. A cycling attempt (cycle_pending) that dies before
+ *  session_start must retry AS a cycle: the fresh branch it was opening is not
+ *  confirmed, so resuming would silently continue the old leaf the refresh was
+ *  meant to leave behind.
+ *
+ *  An interrupted turn is NOT a reason to cycle. A strict reopen does restore
+ *  the transcript at an idle prompt without restarting the dead turn — but the
+ *  fix for that is the continuation prompt recovery delivers (see `#respawn`),
+ *  not throwing the conversation away. */
+export declare function retryResumeMode(meta: Pick<NodeMeta, 'cycle_pending'> | null): boolean;
 export type DeadNodeAction = 'forget' | 'respawn-fresh' | 'dormant' | 'respawn-cycle' | 'respawn-resume' | 'boot-failure';
 /** The narrow durable state the policy table reads. Structural (a Pick, not
  *  NodeMeta itself) so tests fabricate table rows directly. */
@@ -23,10 +27,18 @@ export type DeadNodeRow = Pick<NodeMeta, 'status' | 'intent' | 'pi_session_id' |
 /** One pure function producing the action for a node known-dead. Used at
  *  exactly two call sites — an exit-policy job and the startup recovery sweep
  *  (design D-12) — so exit recovery and startup recovery can never diverge.
- *  Evaluated in table order; `busy` is the on-disk busy marker. A clean-abort
- *  certificate is written by the broker only after Pi persisted its aborted
- *  entry; without it, a set busy marker means a dirty mid-turn crash. */
-export declare function classifyDeadNode(row: DeadNodeRow | null, busy: boolean, cleanAbort?: boolean): DeadNodeAction;
+ *  Evaluated in table order; `busy` is the on-disk busy marker.
+ *
+ *  `busy` no longer selects the ACTION. Whether the engine died mid-turn or
+ *  parked at an idle prompt, the saved transcript is equally resumable — pi
+ *  persists whole entries (`appendFileSync` per line) so a killed generation
+ *  simply leaves the file ending at its last complete entry, and the loader
+ *  skips a malformed line rather than rejecting the session. A mid-turn death
+ *  needs the turn re-driven, which is a continuation prompt on top of the
+ *  resume (see `#respawn`), not a fresh branch. `busy` therefore survives here
+ *  only to route a node that died before session_start ever recorded a session
+ *  to a fresh relaunch instead of terminalizing it as a boot failure. */
+export declare function classifyDeadNode(row: DeadNodeRow | null, busy: boolean): DeadNodeAction;
 /** An exit with uptime at or above this resets the consecutive-failure
  *  counter before classification; a shorter-lived exit increments it. */
 export declare const HEALTHY_UPTIME_MS = 60000;