@mysten-incubation/devstack 0.1.0 → 0.2.0

package/dist/surfaces/tui/display-derivation.mjs

@@ -1,4 +1,65 @@
 //#region src/surfaces/tui/display-derivation.ts
+/**
+* Derive the single canonical surface-neutral ViewModel from a snapshot.
+* Pure. No surface coupling — substrate types only.
+*/
+const deriveStackViewModel = (state) => {
+	let readyRows = 0;
+	let activeRows = 0;
+	let failedRows = 0;
+	let waitingRows = 0;
+	let stoppedRows = 0;
+	for (const row of state.rows) switch (row.status) {
+		case "ready":
+		case "done":
+			readyRows += 1;
+			break;
+		case "acquiring":
+		case "stopping":
+			activeRows += 1;
+			break;
+		case "failed":
+			failedRows += 1;
+			break;
+		case "pending":
+			waitingRows += 1;
+			break;
+		case "stopped":
+			stoppedRows += 1;
+			break;
+		default: row.status;
+	}
+	return {
+		total: state.rows.length,
+		readyRows,
+		activeRows,
+		failedRows,
+		waitingRows,
+		stoppedRows,
+		endpointCount: visibleEndpointCount(state.rows, state.endpoints),
+		accountCount: state.accounts.length,
+		packageCount: state.packages.length,
+		errorCount: state.errors.length
+	};
+};
+/**
+* Resolve the canonical counts to a health enum under a NAMED policy.
+* The two policies are documented divergent and kept separate:
+*
+*   policy='tui': total===0 → empty; failed>0 → blocked;
+*     (active>0 || waiting>0 || stopped>0) → active; else ready.
+*     (Preserves the TUI operator signal where anything not-yet-settled
+*      — including a stopped row — reads as `active`.)
+*
+*   policy='web': failed>0 → blocked; active>0 → active;
+*     total>0 && (ready+stopped)===total → ready; else empty.
+*     (Preserves the web GraphQL contract where `stopped` folds into the
+*      ready denominator and a pending-only stack reads as `empty`.)
+*/
+const deriveHealth = (counts, policy) => {
+	if (policy === "tui") return counts.total === 0 ? "empty" : counts.failedRows > 0 ? "blocked" : counts.activeRows > 0 || counts.waitingRows > 0 || counts.stoppedRows > 0 ? "active" : "ready";
+	return counts.failedRows > 0 ? "blocked" : counts.activeRows > 0 ? "active" : counts.total > 0 && counts.readyRows + counts.stoppedRows === counts.total ? "ready" : "empty";
+};
 /** Pure: status → ANSI glyph. */
 const statusGlyph = (status) => {
 	switch (status) {
@@ -165,23 +226,26 @@ const groupRows = (rows, endpoints = []) => {
 		rows: buckets.get(section) ?? []
 	}));
 };
+/**
+* TUI dashboard summary. Delegates to the canonical `deriveStackViewModel`
+* + `deriveHealth(counts, 'tui')`. The `waitingRows` field folds the
+* discrete `stoppedRows` back in (the TUI counts stopped rows as
+* "waiting") so `dashboardSummaryLine` and its consumers get the TUI's
+* expected shape.
+*/
 const deriveDashboardSummary = (state) => {
-	const readyRows = state.rows.filter((row) => row.status === "ready" || row.status === "done").length;
-	const activeRows = state.rows.filter((row) => row.status === "acquiring" || row.status === "stopping").length;
-	const failedRows = state.rows.filter((row) => row.status === "failed").length;
-	const waitingRows = state.rows.filter((row) => row.status === "pending" || row.status === "stopped").length;
-	const health = state.rows.length === 0 ? "empty" : failedRows > 0 ? "blocked" : activeRows > 0 || waitingRows > 0 ? "active" : "ready";
+	const vm = deriveStackViewModel(state);
 	return {
-		totalRows: state.rows.length,
-		readyRows,
-		activeRows,
-		failedRows,
-		waitingRows,
-		endpointCount: visibleEndpointCount(state.rows, state.endpoints),
-		accountCount: state.accounts.length,
-		packageCount: state.packages.length,
-		errorCount: state.errors.length,
-		health
+		totalRows: vm.total,
+		readyRows: vm.readyRows,
+		activeRows: vm.activeRows,
+		failedRows: vm.failedRows,
+		waitingRows: vm.waitingRows + vm.stoppedRows,
+		endpointCount: vm.endpointCount,
+		accountCount: vm.accountCount,
+		packageCount: vm.packageCount,
+		errorCount: vm.errorCount,
+		health: deriveHealth(vm, "tui")
 	};
 };
 const visibleEndpointCount = (rows, endpoints) => {
@@ -339,6 +403,6 @@ const isOperationalEndpoint = (rowKey, endpoint) => {
 	return OPERATIONAL_ENDPOINT_FIELDS.has(field);
 };
 //#endregion
-export { accountCells, accountLine, dashboardSummaryLine, deriveDashboardSummary, deriveDisplayCells, endpointLine, errorSummaryFor, groupRows, labelForRow, packageCells, packageLine, roleLabel, sectionColor, statusLabel, visibleEndpointsForRow };
+export { accountCells, accountLine, dashboardSummaryLine, deriveDashboardSummary, deriveDisplayCells, deriveHealth, deriveStackViewModel, endpointLine, errorSummaryFor, groupRows, labelForRow, packageCells, packageLine, roleLabel, sectionColor, statusLabel, visibleEndpointsForRow };
 
 //# sourceMappingURL=display-derivation.mjs.map

package/dist/surfaces/tui/display-derivation.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"display-derivation.mjs","names":[],"sources":["../../../src/surfaces/tui/display-derivation.ts"],"sourcesContent":["// INVARIANT: this module is Ink-free, React-free, and DOM-free. Its\n// only imports are `type`-only from `substrate/`. Every export returns\n// a plain TS value (string, ColorToken, plain object) — never a JSX or\n// Ink component. This is what lets a future web dashboard reuse the\n// same status→glyph/label/color derivation a browser renderer would\n// otherwise have to duplicate. Do not import from `ink`, `react`, or\n// any sibling `*.tsx` here.\n//\n// Display derivation — the load-bearing transducer that makes the\n// \"no display vocab in projection\" invariant testable.\n//\n// The renderer consumes ONLY the typed projection (`Row`, `Endpoint`,\n// `StructuredError`, `LifecycleStatus`, `PluginRole`, ...) from\n// `substrate/projection.ts`. Every visible glyph, color, label, and\n// narration string is computed HERE from `row.role`, `row.status`,\n// `row.phase`, `row.lastError`, etc.\n//\n// HARD INVARIANT: this module never reads a field named `title`,\n// `primary`, or `extras` — those fields don't exist on the projection\n// (the substrate's `__ProjectionFieldsClosed` guard fails to compile\n// if they did). The TUI's test of that invariant is: every visible\n// cell rendered by `resource-table.tsx` flows through one of these pure\n// functions.\n//\n// Pure. No Effect, no IO, no clocks. Input typed projection → output\n// strings + enum-y \"color tokens\" (resolved to terminal colors by the\n// Ink layer via `Text color={…}`).\n\nimport type { LifecycleStatus, PhaseNarration, PluginRole } from '../../substrate/lifecycle.ts';\nimport type {\n\tAccountProjection,\n\tEndpoint,\n\tPackageProjection,\n\tRow,\n\tRowSection,\n\tStructuredError,\n\tSubscribableState,\n} from '../../substrate/projection.ts';\n\nexport type { RowSection } from '../../substrate/projection.ts';\n\n// -----------------------------------------------------------------------------\n// Color tokens\n// -----------------------------------------------------------------------------\n\n/**\n * Closed set of color tokens the TUI uses. Ink resolves these to ANSI\n * sequences. NO_COLOR / FORCE_COLOR / TERM=dumb are honored by Ink's\n * defaults (Tension: TUI must not override user color preferences).\n */\nexport type ColorToken = 'yellow' | 'green' | 'red' | 'magenta' | 'cyan' | 'blueBright' | 'white';\n\n// -----------------------------------------------------------------------------\n// Display cells — the public output shape of this module\n// -----------------------------------------------------------------------------\n\n/**\n * Per-row display cells the row renderer consumes. None of these\n * fields are read from the projection — they are computed from\n * `Row.role` + `Row.status` + `Row.phase` + `Row.lastError`.\n *\n * Naming note: we DELIBERATELY avoid the words `title`, `primary`,\n * `extras` in this type's field names to make the invariant grep-able.\n * `label` is computed from `key`; `narration` from `phase`;\n * `summary` from `lastError`.\n */\nexport interface DisplayCells {\n\t/** Status glyph (single char). */\n\treadonly statusGlyph: string;\n\t/** Status color token. */\n\treadonly statusColor: ColorToken;\n\t/** Status label (short verbal, e.g. \"ready\"). */\n\treadonly statusLabel: string;\n\t/** Role glyph (single char). */\n\treadonly roleGlyph: string;\n\t/** Role label (e.g. \"service\"). */\n\treadonly roleLabel: string;\n\t/** Computed row label — derived from `row.key`, not from any\n\t *  projection-side `title`. */\n\treadonly label: string;\n\t/** Narration line — formatted from `row.phase`. */\n\treadonly narration: string;\n\t/** Error summary — formatted from `row.lastError`. */\n\treadonly errorSummary: string;\n\t/** Color the row's label should render in (role-derived,\n\t *  optionally tinted by status). */\n\treadonly labelColor: ColorToken;\n\t/** Group bucket for dashboard sectioning. */\n\treadonly section: RowSection;\n\t/** Plugin-owner chip derived from the row key. */\n\treadonly owner: string;\n\t/** Main row value: usually the first endpoint or latest useful line. */\n\treadonly headline: string;\n\t/** Secondary details visible in the detail pane. */\n\treadonly secondary: ReadonlyArray<string>;\n}\n\nexport interface DisplayRow {\n\treadonly row: Row;\n\treadonly cells: DisplayCells;\n}\n\nexport interface DisplaySection {\n\treadonly key: RowSection;\n\treadonly label: string;\n\treadonly rows: ReadonlyArray<DisplayRow>;\n}\n\nexport interface DashboardSummary {\n\treadonly totalRows: number;\n\treadonly readyRows: number;\n\treadonly activeRows: number;\n\treadonly failedRows: number;\n\treadonly waitingRows: number;\n\treadonly endpointCount: number;\n\treadonly accountCount: number;\n\treadonly packageCount: number;\n\treadonly errorCount: number;\n\treadonly health: 'ready' | 'active' | 'blocked' | 'empty';\n}\n\n// -----------------------------------------------------------------------------\n// Status → glyph / color / label\n// -----------------------------------------------------------------------------\n\n/** Pure: status → ANSI glyph. */\nexport const statusGlyph = (status: LifecycleStatus): string => {\n\tswitch (status) {\n\t\tcase 'pending':\n\t\t\treturn '○';\n\t\tcase 'acquiring':\n\t\t\treturn '◐';\n\t\tcase 'ready':\n\t\t\treturn '●';\n\t\tcase 'failed':\n\t\t\treturn '✖';\n\t\tcase 'stopping':\n\t\t\treturn '◑';\n\t\tcase 'stopped':\n\t\t\treturn '◌';\n\t\tcase 'done':\n\t\t\treturn '✓';\n\t\tdefault: {\n\t\t\tconst _exhaustive: never = status;\n\t\t\tvoid _exhaustive;\n\t\t\treturn '?';\n\t\t}\n\t}\n};\n\n/** Pure: status → color token. */\nexport const statusColor = (status: LifecycleStatus): ColorToken => {\n\tswitch (status) {\n\t\tcase 'pending':\n\t\t\treturn 'white';\n\t\tcase 'acquiring':\n\t\t\treturn 'yellow';\n\t\tcase 'ready':\n\t\t\treturn 'green';\n\t\tcase 'failed':\n\t\t\treturn 'red';\n\t\tcase 'stopping':\n\t\t\treturn 'yellow';\n\t\tcase 'stopped':\n\t\t\treturn 'white';\n\t\tcase 'done':\n\t\t\treturn 'green';\n\t\tdefault: {\n\t\t\tconst _exhaustive: never = status;\n\t\t\tvoid _exhaustive;\n\t\t\treturn 'white';\n\t\t}\n\t}\n};\n\n/** Pure: status → short operator-facing label. */\nexport const statusLabel = (status: LifecycleStatus): string => {\n\tswitch (status) {\n\t\tcase 'pending':\n\t\t\treturn 'pending';\n\t\tcase 'acquiring':\n\t\t\treturn 'starting';\n\t\tcase 'ready':\n\t\t\treturn 'ready';\n\t\tcase 'failed':\n\t\t\treturn 'failed';\n\t\tcase 'stopping':\n\t\t\treturn 'stopping';\n\t\tcase 'stopped':\n\t\t\treturn 'stopped';\n\t\tcase 'done':\n\t\t\treturn 'done';\n\t\tdefault: {\n\t\t\tconst _exhaustive: never = status;\n\t\t\tvoid _exhaustive;\n\t\t\treturn 'unknown';\n\t\t}\n\t}\n};\n\n// -----------------------------------------------------------------------------\n// Role -> glyph / label / color\n// -----------------------------------------------------------------------------\n\n/** Pure: role -> ANSI glyph. */\nexport const roleGlyph = (role: PluginRole): string => {\n\tswitch (role) {\n\t\tcase 'service':\n\t\t\treturn '⚙';\n\t\tcase 'task':\n\t\t\treturn '⚡';\n\t\tdefault: {\n\t\t\tconst _exhaustive: never = role;\n\t\t\tvoid _exhaustive;\n\t\t\treturn '?';\n\t\t}\n\t}\n};\n\n/** Pure: role -> short label. */\nexport const roleLabel = (role: PluginRole): string => {\n\tswitch (role) {\n\t\tcase 'service':\n\t\t\treturn 'service';\n\t\tcase 'task':\n\t\t\treturn 'task';\n\t\tdefault: {\n\t\t\tconst _exhaustive: never = role;\n\t\t\tvoid _exhaustive;\n\t\t\treturn 'unknown';\n\t\t}\n\t}\n};\n\n/** Pure: role -> label color token. */\nexport const roleLabelColor = (role: PluginRole): ColorToken => {\n\tswitch (role) {\n\t\tcase 'service':\n\t\t\treturn 'cyan';\n\t\tcase 'task':\n\t\t\treturn 'magenta';\n\t\tdefault: {\n\t\t\tconst _exhaustive: never = role;\n\t\t\tvoid _exhaustive;\n\t\t\treturn 'white';\n\t\t}\n\t}\n};\n\n// -----------------------------------------------------------------------------\n// Row label — derived from `key`, not from any pre-baked title\n// -----------------------------------------------------------------------------\n\n/**\n * Compute a human-friendly row label from the opaque branded plugin\n * key. The substrate keeps `key` an opaque digest; the renderer is\n * the layer that interprets it. We strip a few conventional prefixes\n * (`devstack:`, `app:`) plus instance counters so common cases read\n * cleanly.\n *\n * The function consumes `key` only — never `row.title`, which doesn't\n * exist in the projection.\n */\nexport const labelForRow = (key: string): string => {\n\tconst normalized = normalizeKey(key);\n\tconst parts = normalized.split(/[/:]/).filter((part) => part.length > 0);\n\tif (parts.length >= 2 && isSectionish(parts[0]!)) return humanizeToken(parts[parts.length - 1]!);\n\treturn humanizeToken(parts[parts.length - 1] ?? normalized);\n};\n\nexport const ownerForRow = (key: string): string => {\n\tconst normalized = normalizeKey(key);\n\tconst first = normalized.split(/[/:._#-]/).find((part) => part.length > 0);\n\treturn first === undefined ? 'plugin' : humanizeToken(first);\n};\n\n/** Pure: pick the row's dashboard section. Reads `row.section`\n *  directly; if the plugin declared an `endpointSection` AND the row\n *  owns a routed endpoint, the endpoint variant wins. NEVER pattern-\n *  matches on `row.key`; the classifier is plugin-declared at\n *  `definePlugin({ section, endpointSection })` time and stamped by\n *  the supervisor. */\nexport const sectionForRow = (\n\trow: Pick<Row, 'key' | 'endpoints' | 'section' | 'endpointSection'>,\n\tendpoints: ReadonlyArray<Endpoint> = [],\n): RowSection => {\n\tconst ownsEndpoint = endpointsForRow(row, endpoints).length > 0 || row.endpoints.length > 0;\n\treturn ownsEndpoint && row.endpointSection !== row.section ? row.endpointSection : row.section;\n};\n\n/** Pure: section -> scope-chip color token used by the event log /\n *  activity stream. Coloring is driven by `RowSection` so the renderer\n *  doesn't pattern-match on plugin names. */\nexport const sectionColor = (section: RowSection): ColorToken => {\n\tswitch (section) {\n\t\tcase 'service':\n\t\t\treturn 'cyan';\n\t\tcase 'package':\n\t\t\treturn 'blueBright';\n\t\tcase 'account':\n\t\t\treturn 'magenta';\n\t\tcase 'action':\n\t\t\treturn 'magenta';\n\t\tcase 'app':\n\t\t\treturn 'white';\n\t\tcase 'other':\n\t\t\treturn 'cyan';\n\t\tdefault: {\n\t\t\tconst _exhaustive: never = section;\n\t\t\tvoid _exhaustive;\n\t\t\treturn 'cyan';\n\t\t}\n\t}\n};\n\nexport const sectionLabel = (section: RowSection): string => {\n\tswitch (section) {\n\t\tcase 'service':\n\t\t\treturn 'Services';\n\t\tcase 'package':\n\t\t\treturn 'Packages';\n\t\tcase 'account':\n\t\t\treturn 'Accounts';\n\t\tcase 'action':\n\t\t\treturn 'Actions';\n\t\tcase 'app':\n\t\t\treturn 'App';\n\t\tcase 'other':\n\t\t\treturn 'Other';\n\t\tdefault: {\n\t\t\tconst _exhaustive: never = section;\n\t\t\tvoid _exhaustive;\n\t\t\treturn 'Other';\n\t\t}\n\t}\n};\n\nexport const endpointsForRow = (\n\trow: Pick<Row, 'key' | 'endpoints'>,\n\tendpoints: ReadonlyArray<Endpoint>,\n): ReadonlyArray<Endpoint> =>\n\tendpoints.filter(\n\t\t(endpoint) => row.endpoints.includes(endpoint.endpointKey) || endpoint.pluginKey === row.key,\n\t);\n\nconst OPERATIONAL_ENDPOINT_FIELDS = new Set(['url', 'rpcUrl', 'faucetUrl', 'graphqlUrl']);\n\nexport const visibleEndpointsForRow = (\n\trow: Pick<Row, 'key' | 'endpoints'>,\n\tendpoints: ReadonlyArray<Endpoint>,\n): ReadonlyArray<Endpoint> => {\n\tconst rowEndpoints = endpointsForRow(row, endpoints);\n\tconst routed = rowEndpoints.filter((endpoint) => !isOperationalEndpoint(row.key, endpoint));\n\treturn routed.length > 0 ? routed : rowEndpoints;\n};\n\nexport const headlineForRow = (row: Row, endpoints: ReadonlyArray<Endpoint> = []): string => {\n\tconst rowEndpoints = visibleEndpointsForRow(row, endpoints);\n\tif (rowEndpoints.length > 0) return endpointLine(rowEndpoints[0]!);\n\tif (row.lastError !== null && row.status === 'failed') return errorSummaryFor(row.lastError);\n\treturn narrationFor(row.phase, row.status);\n};\n\nexport const secondaryForRow = (\n\trow: Row,\n\tendpoints: ReadonlyArray<Endpoint> = [],\n): ReadonlyArray<string> => {\n\tconst out: Array<string> = [];\n\tconst rowEndpoints = endpointsForRow(row, endpoints);\n\tfor (const endpoint of rowEndpoints.slice(1)) out.push(endpointLine(endpoint));\n\tif (row.logTail.truncated) out.push('log tail truncated');\n\treturn out;\n};\n\nexport const groupRows = (\n\trows: ReadonlyArray<Row>,\n\tendpoints: ReadonlyArray<Endpoint> = [],\n): ReadonlyArray<DisplaySection> => {\n\tconst buckets = new Map<RowSection, Array<DisplayRow>>();\n\tfor (const row of rows) {\n\t\tconst cells = deriveDisplayCells(row, endpoints);\n\t\tconst list = buckets.get(cells.section) ?? [];\n\t\tlist.push({ row, cells });\n\t\tbuckets.set(cells.section, list);\n\t}\n\tconst order: ReadonlyArray<RowSection> = [\n\t\t'service',\n\t\t'package',\n\t\t'account',\n\t\t'action',\n\t\t'app',\n\t\t'other',\n\t];\n\treturn order\n\t\t.filter((section) => buckets.has(section))\n\t\t.map((section) => ({\n\t\t\tkey: section,\n\t\t\tlabel: sectionLabel(section),\n\t\t\trows: buckets.get(section) ?? [],\n\t\t}));\n};\n\nexport const deriveDashboardSummary = (\n\tstate: Pick<SubscribableState, 'rows' | 'endpoints' | 'accounts' | 'packages' | 'errors'>,\n): DashboardSummary => {\n\tconst readyRows = state.rows.filter(\n\t\t(row) => row.status === 'ready' || row.status === 'done',\n\t).length;\n\tconst activeRows = state.rows.filter(\n\t\t(row) => row.status === 'acquiring' || row.status === 'stopping',\n\t).length;\n\tconst failedRows = state.rows.filter((row) => row.status === 'failed').length;\n\tconst waitingRows = state.rows.filter(\n\t\t(row) => row.status === 'pending' || row.status === 'stopped',\n\t).length;\n\tconst health =\n\t\tstate.rows.length === 0\n\t\t\t? 'empty'\n\t\t\t: failedRows > 0\n\t\t\t\t? 'blocked'\n\t\t\t\t: activeRows > 0 || waitingRows > 0\n\t\t\t\t\t? 'active'\n\t\t\t\t\t: 'ready';\n\treturn {\n\t\ttotalRows: state.rows.length,\n\t\treadyRows,\n\t\tactiveRows,\n\t\tfailedRows,\n\t\twaitingRows,\n\t\tendpointCount: visibleEndpointCount(state.rows, state.endpoints),\n\t\taccountCount: state.accounts.length,\n\t\tpackageCount: state.packages.length,\n\t\terrorCount: state.errors.length,\n\t\thealth,\n\t};\n};\n\nconst visibleEndpointCount = (\n\trows: ReadonlyArray<Row>,\n\tendpoints: ReadonlyArray<Endpoint>,\n): number => {\n\tconst rowOwned = new Set<Endpoint['endpointKey']>();\n\tconst visible = new Set<Endpoint['endpointKey']>();\n\tfor (const row of rows) {\n\t\tfor (const endpoint of endpointsForRow(row, endpoints)) {\n\t\t\trowOwned.add(endpoint.endpointKey);\n\t\t}\n\t\tfor (const endpoint of visibleEndpointsForRow(row, endpoints)) {\n\t\t\tvisible.add(endpoint.endpointKey);\n\t\t}\n\t}\n\tfor (const endpoint of endpoints) {\n\t\tif (!rowOwned.has(endpoint.endpointKey)) visible.add(endpoint.endpointKey);\n\t}\n\treturn visible.size;\n};\n\nexport const dashboardSummaryLine = (summary: DashboardSummary): string =>\n\t[\n\t\t`${summary.readyRows}/${summary.totalRows} ready`,\n\t\tsummary.activeRows > 0 ? `${summary.activeRows} active` : null,\n\t\tsummary.waitingRows > 0 ? `${summary.waitingRows} waiting` : null,\n\t\tsummary.failedRows > 0 ? `${summary.failedRows} failed` : null,\n\t\t`${summary.endpointCount} urls`,\n\t\t`${summary.accountCount} accounts`,\n\t\tsummary.packageCount > 0 ? `${summary.packageCount} packages` : null,\n\t\tsummary.errorCount === 0 ? 'no errors' : `${summary.errorCount} errors`,\n\t]\n\t\t.filter((part): part is string => part !== null)\n\t\t.join('  ');\n\n// -----------------------------------------------------------------------------\n// Phase narration formatting\n// -----------------------------------------------------------------------------\n\n/**\n * Pure: phase narration string → renderable verb form. Phase is\n * free-form upstream (Tension 14). The renderer's job is to make it\n * legible; we keep this minimal — single-line, no fancy verb tense\n * inference. The truncation cap protects against pathological long\n * narrations.\n */\nexport const narrationFor = (phase: PhaseNarration | null, status: LifecycleStatus): string => {\n\tif (phase === null || phase.trim().length === 0) {\n\t\t// No phase set; surface a status-derived default for `acquiring`,\n\t\t// stay silent otherwise (Tension: don't manufacture text the\n\t\t// engine didn't ask for).\n\t\treturn status === 'acquiring' ? 'starting…' : '';\n\t}\n\tconst trimmed = phase.trim();\n\tconst TRUNC = 80;\n\treturn trimmed.length > TRUNC ? `${trimmed.slice(0, TRUNC - 1)}…` : trimmed;\n};\n\n// -----------------------------------------------------------------------------\n// Error summary formatting\n// -----------------------------------------------------------------------------\n\nconst ERR_SUMMARY_TRUNC = 120;\n\n/**\n * Pure: `Row.lastError` → renderable in-row summary. Keep it short;\n * detailed error context belongs in the activity/log stream.\n */\nexport const errorSummaryFor = (error: StructuredError | null): string => {\n\tif (error === null) return '';\n\tconst head = `${error.tag}: ${error.summary}`;\n\tconst detail = error.chain.find((line) => line !== head && line !== error.tag);\n\tconst compactDetail =\n\t\tdetail === undefined ? undefined : detail.replace(/^[A-Za-z0-9_[\\]-]+:\\s*/, '');\n\tconst summary = compactDetail === undefined ? head : `${head}: ${compactDetail}`;\n\treturn summary.length > ERR_SUMMARY_TRUNC\n\t\t? `${summary.slice(0, ERR_SUMMARY_TRUNC - 1)}…`\n\t\t: summary;\n};\n\n// -----------------------------------------------------------------------------\n// Endpoint formatting\n// -----------------------------------------------------------------------------\n\n/**\n * Pure: `Endpoint` → renderable line. Renderers prefer `displayUrl`\n * when set (codegen-friendly variant), falling back to `url`.\n */\nexport const endpointLine = (endpoint: Endpoint): string => {\n\tconst target = endpoint.displayUrl ?? endpoint.url;\n\tconst backing =\n\t\tendpoint.displayUrl !== null && endpoint.displayUrl !== endpoint.url\n\t\t\t? ` -> ${endpoint.url}`\n\t\t\t: '';\n\tconst protocol = endpoint.wireProtocol === 'http' ? '' : ` [${endpoint.wireProtocol}]`;\n\treturn `${endpoint.name}: ${target}${backing}${protocol}`;\n};\n\nexport const endpointsSummaryForRow = (\n\trow: Pick<Row, 'key' | 'endpoints'>,\n\tendpoints: ReadonlyArray<Endpoint>,\n): string => {\n\tconst rowEndpoints = visibleEndpointsForRow(row, endpoints);\n\tif (rowEndpoints.length === 0) return '';\n\treturn rowEndpoints.map(endpointLine).join(' | ');\n};\n\nexport const accountLine = (account: AccountProjection): string => {\n\tconst address = account.address ?? '<pending>';\n\tconst scheme = account.scheme ?? 'scheme pending';\n\tconst source = account.source ?? 'source pending';\n\tconst funding = accountFundingLine(account.funding);\n\tconst wallet = account.walletVisible ? 'wallet' : null;\n\treturn [humanizeToken(account.name), address, scheme, source, funding, wallet]\n\t\t.filter((part): part is string => part !== null && part.length > 0)\n\t\t.join('  ');\n};\n\nexport const packageLine = (pkg: PackageProjection): string => {\n\treturn [humanizeToken(pkg.name), pkg.packageId, pkg.mvrPlaceholder, pkg.kind]\n\t\t.filter((part): part is string => part !== null && part.length > 0)\n\t\t.join('  ');\n};\n\nexport interface AccountCells {\n\treadonly name: string;\n\treadonly address: string;\n\treadonly scheme: string;\n\treadonly source: string;\n\treadonly funding: string;\n}\n\nexport interface PackageCells {\n\treadonly name: string;\n\treadonly packageId: string;\n\treadonly mvr: string;\n\treadonly kind: string;\n\treadonly detail: string;\n}\n\nexport const accountCells = (account: AccountProjection): AccountCells => ({\n\tname: humanizeToken(account.name),\n\taddress: account.address ?? '<pending>',\n\tscheme: account.scheme ?? 'pending',\n\tsource: account.source ?? 'pending',\n\tfunding: accountFundingLine(account.funding),\n});\n\nconst accountFundingLine = (funding: AccountProjection['funding']): string => {\n\tconst entries = funding.entries ?? [];\n\tif (entries.length > 0) {\n\t\tconst rendered = entries\n\t\t\t.map(\n\t\t\t\t(entry) => `${entry.coin}:${entry.amount}${entry.status === 'skipped' ? ' skipped' : ''}`,\n\t\t\t)\n\t\t\t.join(', ');\n\t\treturn funding.status === 'funded' ? `funded ${rendered}` : `funding ${rendered}`;\n\t}\n\tswitch (funding.status) {\n\t\tcase 'pending':\n\t\t\treturn funding.requestedMist === null\n\t\t\t\t? 'funding pending'\n\t\t\t\t: `funding ${funding.requestedMist}`;\n\t\tcase 'funded':\n\t\t\treturn funding.balanceMist !== null\n\t\t\t\t? `funded ${funding.balanceMist}`\n\t\t\t\t: funding.requestedMist !== null\n\t\t\t\t\t? `funded ${funding.requestedMist}`\n\t\t\t\t\t: 'funded';\n\t\tcase 'skipped':\n\t\t\treturn 'funding skipped';\n\t\tcase 'failed':\n\t\t\treturn 'funding failed';\n\t\tcase 'unknown':\n\t\t\treturn 'funding unknown';\n\t\tdefault: {\n\t\t\tconst _exhaustive: never = funding.status;\n\t\t\tvoid _exhaustive;\n\t\t\treturn '';\n\t\t}\n\t}\n};\n\nexport const packageCells = (pkg: PackageProjection): PackageCells => ({\n\tname: humanizeToken(pkg.name),\n\tpackageId: pkg.packageId,\n\tmvr: pkg.mvrPlaceholder,\n\tkind: pkg.kind,\n\tdetail: pkg.kind,\n});\n\n// -----------------------------------------------------------------------------\n// Top-level entry point\n// -----------------------------------------------------------------------------\n\n/**\n * Derive every visible display cell for a single row.\n *\n * Consumes ONLY `row.key`, `row.role`, `row.status`, `row.phase`,\n * `row.lastError`, `row.endpoints` (rendered separately by\n * `resource-table.tsx`), or `row.logTail` (kept in the projection\n * for renderer variants that need tails, but not used as primary\n * dashboard state because generic lifecycle log lines duplicate the\n * table).\n */\nexport const deriveDisplayCells = (\n\trow: Row,\n\tendpoints: ReadonlyArray<Endpoint> = [],\n): DisplayCells => ({\n\tstatusGlyph: statusGlyph(row.status),\n\tstatusColor: statusColor(row.status),\n\tstatusLabel: statusLabel(row.status),\n\troleGlyph: roleGlyph(row.role),\n\troleLabel: roleLabel(row.role),\n\tlabel: labelForRow(row.key),\n\tnarration: narrationFor(row.phase, row.status),\n\terrorSummary: errorSummaryFor(row.lastError),\n\tlabelColor: roleLabelColor(row.role),\n\tsection: sectionForRow(row, endpoints),\n\towner: ownerForRow(row.key),\n\theadline: headlineForRow(row, endpoints),\n\tsecondary: secondaryForRow(row, endpoints),\n});\n\nconst normalizeKey = (key: string): string =>\n\tkey\n\t\t.replace(/^@devstack\\//, '')\n\t\t.replace(/^(devstack:|app:)/, '')\n\t\t.replace(/#\\d+$/, '')\n\t\t.replace(/\\/\\d+$/, '');\n\nconst humanizeToken = (token: string): string =>\n\ttoken.replace(/[-_]+/g, ' ').replace(/^\\w/, (head) => head.toUpperCase());\n\nconst containsKeyPart = (key: string, parts: ReadonlyArray<string>): boolean => {\n\tconst tokens = key.split(/[/:._#-]/).filter((part) => part.length > 0);\n\treturn tokens.some((token) => parts.includes(token));\n};\n\nconst isSectionish = (token: string): boolean =>\n\tcontainsKeyPart(token.toLowerCase(), ['service', 'package', 'account', 'action', 'app']);\n\nconst isOperationalEndpoint = (rowKey: Pick<Row, 'key'>['key'], endpoint: Endpoint): boolean => {\n\tif (endpoint.pluginKey !== rowKey) return false;\n\tconst prefix = `${rowKey}:`;\n\tif (!endpoint.endpointKey.startsWith(prefix)) return false;\n\tconst field = endpoint.endpointKey.slice(prefix.length);\n\treturn OPERATIONAL_ENDPOINT_FIELDS.has(field);\n};\n\n// -----------------------------------------------------------------------------\n// Compile-time invariant\n// -----------------------------------------------------------------------------\n//\n// Renderer code must never see a `title`/`primary`/`extras` field on\n// `Row`. If the projection ever sprouts one, the substrate's\n// `__ProjectionFieldsClosed` guard fails first; this module-local\n// guard exists as a second layer that explicitly mentions the\n// forbidden field names so a future renderer-side regression is\n// caught at the renderer boundary, not at the substrate boundary.\n\ntype _NoForbiddenOnRow = 'title' extends keyof Row\n\t? never\n\t: 'primary' extends keyof Row\n\t\t? never\n\t\t: 'extras' extends keyof Row\n\t\t\t? never\n\t\t\t: true;\n\n/** Renderer-side compile-time guard. If this resolves to `never`,\n *  the renderer is reading a forbidden display-vocabulary field from\n *  the projection. */\nexport type __TuiDisplayVocabClean = _NoForbiddenOnRow extends true ? true : never;\n"],"mappings":"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"}
+{"version":3,"file":"display-derivation.mjs","names":[],"sources":["../../../src/surfaces/tui/display-derivation.ts"],"sourcesContent":["// INVARIANT: this module is Ink-free, React-free, and DOM-free. Its\n// only imports are `type`-only from `substrate/`. Every export returns\n// a plain TS value (string, ColorToken, plain object) — never a JSX or\n// Ink component. This is what lets a future web dashboard reuse the\n// same status→glyph/label/color derivation a browser renderer would\n// otherwise have to duplicate. Do not import from `ink`, `react`, or\n// any sibling `*.tsx` here.\n//\n// Display derivation — the load-bearing transducer that makes the\n// \"no display vocab in projection\" invariant testable.\n//\n// The renderer consumes ONLY the typed projection (`Row`, `Endpoint`,\n// `StructuredError`, `LifecycleStatus`, `PluginRole`, ...) from\n// `substrate/projection.ts`. Every visible glyph, color, label, and\n// narration string is computed HERE from `row.role`, `row.status`,\n// `row.phase`, `row.lastError`, etc.\n//\n// HARD INVARIANT: this module never reads a field named `title`,\n// `primary`, or `extras` — those fields don't exist on the projection\n// (the substrate's `__ProjectionFieldsClosed` guard fails to compile\n// if they did). The TUI's test of that invariant is: every visible\n// cell rendered by `resource-table.tsx` flows through one of these pure\n// functions.\n//\n// Pure. No Effect, no IO, no clocks. Input typed projection → output\n// strings + enum-y \"color tokens\" (resolved to terminal colors by the\n// Ink layer via `Text color={…}`).\n\nimport type { LifecycleStatus, PhaseNarration, PluginRole } from '../../substrate/lifecycle.ts';\nimport type {\n\tAccountProjection,\n\tEndpoint,\n\tPackageProjection,\n\tRow,\n\tRowSection,\n\tStructuredError,\n\tSubscribableState,\n} from '../../substrate/projection.ts';\n\nexport type { RowSection } from '../../substrate/projection.ts';\n\n// -----------------------------------------------------------------------------\n// Color tokens\n// -----------------------------------------------------------------------------\n\n/**\n * Closed set of color tokens the TUI uses. Ink resolves these to ANSI\n * sequences. NO_COLOR / FORCE_COLOR / TERM=dumb are honored by Ink's\n * defaults (Tension: TUI must not override user color preferences).\n */\nexport type ColorToken = 'yellow' | 'green' | 'red' | 'magenta' | 'cyan' | 'blueBright' | 'white';\n\n// -----------------------------------------------------------------------------\n// Display cells — the public output shape of this module\n// -----------------------------------------------------------------------------\n\n/**\n * Per-row display cells the row renderer consumes. None of these\n * fields are read from the projection — they are computed from\n * `Row.role` + `Row.status` + `Row.phase` + `Row.lastError`.\n *\n * Naming note: we DELIBERATELY avoid the words `title`, `primary`,\n * `extras` in this type's field names to make the invariant grep-able.\n * `label` is computed from `key`; `narration` from `phase`;\n * `summary` from `lastError`.\n */\nexport interface DisplayCells {\n\t/** Status glyph (single char). */\n\treadonly statusGlyph: string;\n\t/** Status color token. */\n\treadonly statusColor: ColorToken;\n\t/** Status label (short verbal, e.g. \"ready\"). */\n\treadonly statusLabel: string;\n\t/** Role glyph (single char). */\n\treadonly roleGlyph: string;\n\t/** Role label (e.g. \"service\"). */\n\treadonly roleLabel: string;\n\t/** Computed row label — derived from `row.key`, not from any\n\t *  projection-side `title`. */\n\treadonly label: string;\n\t/** Narration line — formatted from `row.phase`. */\n\treadonly narration: string;\n\t/** Error summary — formatted from `row.lastError`. */\n\treadonly errorSummary: string;\n\t/** Color the row's label should render in (role-derived,\n\t *  optionally tinted by status). */\n\treadonly labelColor: ColorToken;\n\t/** Group bucket for dashboard sectioning. */\n\treadonly section: RowSection;\n\t/** Plugin-owner chip derived from the row key. */\n\treadonly owner: string;\n\t/** Main row value: usually the first endpoint or latest useful line. */\n\treadonly headline: string;\n\t/** Secondary details visible in the detail pane. */\n\treadonly secondary: ReadonlyArray<string>;\n}\n\nexport interface DisplayRow {\n\treadonly row: Row;\n\treadonly cells: DisplayCells;\n}\n\nexport interface DisplaySection {\n\treadonly key: RowSection;\n\treadonly label: string;\n\treadonly rows: ReadonlyArray<DisplayRow>;\n}\n\nexport interface DashboardSummary {\n\treadonly totalRows: number;\n\treadonly readyRows: number;\n\treadonly activeRows: number;\n\treadonly failedRows: number;\n\treadonly waitingRows: number;\n\treadonly endpointCount: number;\n\treadonly accountCount: number;\n\treadonly packageCount: number;\n\treadonly errorCount: number;\n\treadonly health: HealthState;\n}\n\n// -----------------------------------------------------------------------------\n// Surface-neutral stack ViewModel — the single canonical bucketing\n// -----------------------------------------------------------------------------\n\n/**\n * The one canonical health-derived enum. The same four states are shared\n * by both surface policies; only the *bucketing rules* differ (see\n * `deriveHealth`).\n */\nexport type HealthState = 'ready' | 'active' | 'blocked' | 'empty';\n\n/**\n * Surface-neutral roll-up of a projection snapshot. ONE canonical\n * bucketing that every surface (TUI dashboard, web GraphQL\n * `StackState.summary`, CLI `status`) derives from — no surface gets to\n * re-count rows on its own.\n *\n * The `stopped` status is surfaced here as its OWN discrete count rather\n * than folded into either `ready` or `waiting`. No surface loses\n * information: `deriveHealth(counts, policy)` re-applies each surface's documented\n * rule, and the web adapter folds `stopped` into its GraphQL `ready`\n * contract INSIDE the web adapter — never in this shared shape.\n *\n * ready/active/failed/waiting follow the web switch (was\n * `computeHealthSummary`) with `stopped` pulled out separately:\n *   - readyRows:   ready | done\n *   - activeRows:  acquiring | stopping\n *   - failedRows:  failed\n *   - waitingRows: pending\n *   - stoppedRows: stopped\n */\nexport interface StackViewModel {\n\treadonly total: number;\n\treadonly readyRows: number;\n\treadonly activeRows: number;\n\treadonly failedRows: number;\n\treadonly waitingRows: number;\n\treadonly stoppedRows: number;\n\treadonly endpointCount: number;\n\treadonly accountCount: number;\n\treadonly packageCount: number;\n\treadonly errorCount: number;\n}\n\n/** Health bucketing policy. `'tui'` preserves the operator-facing TUI\n *  rule (pending/stopped/mid-flight all read as \"system not settled\" →\n *  `active`); `'web'` preserves the GraphQL contract (stopped folds into\n *  ready, pending-only reads as `empty`). The two policies are kept\n *  NAMED and SEPARATE — never unified — so neither surface regresses. */\nexport type HealthPolicy = 'tui' | 'web';\n\n/**\n * Derive the single canonical surface-neutral ViewModel from a snapshot.\n * Pure. No surface coupling — substrate types only.\n */\nexport const deriveStackViewModel = (\n\tstate: Pick<SubscribableState, 'rows' | 'endpoints' | 'accounts' | 'packages' | 'errors'>,\n): StackViewModel => {\n\tlet readyRows = 0;\n\tlet activeRows = 0;\n\tlet failedRows = 0;\n\tlet waitingRows = 0;\n\tlet stoppedRows = 0;\n\tfor (const row of state.rows) {\n\t\tswitch (row.status) {\n\t\t\tcase 'ready':\n\t\t\tcase 'done':\n\t\t\t\treadyRows += 1;\n\t\t\t\tbreak;\n\t\t\tcase 'acquiring':\n\t\t\tcase 'stopping':\n\t\t\t\tactiveRows += 1;\n\t\t\t\tbreak;\n\t\t\tcase 'failed':\n\t\t\t\tfailedRows += 1;\n\t\t\t\tbreak;\n\t\t\tcase 'pending':\n\t\t\t\twaitingRows += 1;\n\t\t\t\tbreak;\n\t\t\tcase 'stopped':\n\t\t\t\tstoppedRows += 1;\n\t\t\t\tbreak;\n\t\t\tdefault: {\n\t\t\t\tconst _exhaustive: never = row.status;\n\t\t\t\tvoid _exhaustive;\n\t\t\t}\n\t\t}\n\t}\n\treturn {\n\t\ttotal: state.rows.length,\n\t\treadyRows,\n\t\tactiveRows,\n\t\tfailedRows,\n\t\twaitingRows,\n\t\tstoppedRows,\n\t\tendpointCount: visibleEndpointCount(state.rows, state.endpoints),\n\t\taccountCount: state.accounts.length,\n\t\tpackageCount: state.packages.length,\n\t\terrorCount: state.errors.length,\n\t};\n};\n\n/**\n * Resolve the canonical counts to a health enum under a NAMED policy.\n * The two policies are documented divergent and kept separate:\n *\n *   policy='tui': total===0 → empty; failed>0 → blocked;\n *     (active>0 || waiting>0 || stopped>0) → active; else ready.\n *     (Preserves the TUI operator signal where anything not-yet-settled\n *      — including a stopped row — reads as `active`.)\n *\n *   policy='web': failed>0 → blocked; active>0 → active;\n *     total>0 && (ready+stopped)===total → ready; else empty.\n *     (Preserves the web GraphQL contract where `stopped` folds into the\n *      ready denominator and a pending-only stack reads as `empty`.)\n */\nexport const deriveHealth = (\n\tcounts: Pick<\n\t\tStackViewModel,\n\t\t'total' | 'readyRows' | 'activeRows' | 'failedRows' | 'waitingRows' | 'stoppedRows'\n\t>,\n\tpolicy: HealthPolicy,\n): HealthState => {\n\tif (policy === 'tui') {\n\t\treturn counts.total === 0\n\t\t\t? 'empty'\n\t\t\t: counts.failedRows > 0\n\t\t\t\t? 'blocked'\n\t\t\t\t: counts.activeRows > 0 || counts.waitingRows > 0 || counts.stoppedRows > 0\n\t\t\t\t\t? 'active'\n\t\t\t\t\t: 'ready';\n\t}\n\treturn counts.failedRows > 0\n\t\t? 'blocked'\n\t\t: counts.activeRows > 0\n\t\t\t? 'active'\n\t\t\t: counts.total > 0 && counts.readyRows + counts.stoppedRows === counts.total\n\t\t\t\t? 'ready'\n\t\t\t\t: 'empty';\n};\n\n// -----------------------------------------------------------------------------\n// Status → glyph / color / label\n// -----------------------------------------------------------------------------\n\n/** Pure: status → ANSI glyph. */\nexport const statusGlyph = (status: LifecycleStatus): string => {\n\tswitch (status) {\n\t\tcase 'pending':\n\t\t\treturn '○';\n\t\tcase 'acquiring':\n\t\t\treturn '◐';\n\t\tcase 'ready':\n\t\t\treturn '●';\n\t\tcase 'failed':\n\t\t\treturn '✖';\n\t\tcase 'stopping':\n\t\t\treturn '◑';\n\t\tcase 'stopped':\n\t\t\treturn '◌';\n\t\tcase 'done':\n\t\t\treturn '✓';\n\t\tdefault: {\n\t\t\tconst _exhaustive: never = status;\n\t\t\tvoid _exhaustive;\n\t\t\treturn '?';\n\t\t}\n\t}\n};\n\n/** Pure: status → color token. */\nexport const statusColor = (status: LifecycleStatus): ColorToken => {\n\tswitch (status) {\n\t\tcase 'pending':\n\t\t\treturn 'white';\n\t\tcase 'acquiring':\n\t\t\treturn 'yellow';\n\t\tcase 'ready':\n\t\t\treturn 'green';\n\t\tcase 'failed':\n\t\t\treturn 'red';\n\t\tcase 'stopping':\n\t\t\treturn 'yellow';\n\t\tcase 'stopped':\n\t\t\treturn 'white';\n\t\tcase 'done':\n\t\t\treturn 'green';\n\t\tdefault: {\n\t\t\tconst _exhaustive: never = status;\n\t\t\tvoid _exhaustive;\n\t\t\treturn 'white';\n\t\t}\n\t}\n};\n\n/** Pure: status → short operator-facing label. */\nexport const statusLabel = (status: LifecycleStatus): string => {\n\tswitch (status) {\n\t\tcase 'pending':\n\t\t\treturn 'pending';\n\t\tcase 'acquiring':\n\t\t\treturn 'starting';\n\t\tcase 'ready':\n\t\t\treturn 'ready';\n\t\tcase 'failed':\n\t\t\treturn 'failed';\n\t\tcase 'stopping':\n\t\t\treturn 'stopping';\n\t\tcase 'stopped':\n\t\t\treturn 'stopped';\n\t\tcase 'done':\n\t\t\treturn 'done';\n\t\tdefault: {\n\t\t\tconst _exhaustive: never = status;\n\t\t\tvoid _exhaustive;\n\t\t\treturn 'unknown';\n\t\t}\n\t}\n};\n\n// -----------------------------------------------------------------------------\n// Role -> glyph / label / color\n// -----------------------------------------------------------------------------\n\n/** Pure: role -> ANSI glyph. */\nexport const roleGlyph = (role: PluginRole): string => {\n\tswitch (role) {\n\t\tcase 'service':\n\t\t\treturn '⚙';\n\t\tcase 'task':\n\t\t\treturn '⚡';\n\t\tdefault: {\n\t\t\tconst _exhaustive: never = role;\n\t\t\tvoid _exhaustive;\n\t\t\treturn '?';\n\t\t}\n\t}\n};\n\n/** Pure: role -> short label. */\nexport const roleLabel = (role: PluginRole): string => {\n\tswitch (role) {\n\t\tcase 'service':\n\t\t\treturn 'service';\n\t\tcase 'task':\n\t\t\treturn 'task';\n\t\tdefault: {\n\t\t\tconst _exhaustive: never = role;\n\t\t\tvoid _exhaustive;\n\t\t\treturn 'unknown';\n\t\t}\n\t}\n};\n\n/** Pure: role -> label color token. */\nexport const roleLabelColor = (role: PluginRole): ColorToken => {\n\tswitch (role) {\n\t\tcase 'service':\n\t\t\treturn 'cyan';\n\t\tcase 'task':\n\t\t\treturn 'magenta';\n\t\tdefault: {\n\t\t\tconst _exhaustive: never = role;\n\t\t\tvoid _exhaustive;\n\t\t\treturn 'white';\n\t\t}\n\t}\n};\n\n// -----------------------------------------------------------------------------\n// Row label — derived from `key`, not from any pre-baked title\n// -----------------------------------------------------------------------------\n\n/**\n * Compute a human-friendly row label from the opaque branded plugin\n * key. The substrate keeps `key` an opaque digest; the renderer is\n * the layer that interprets it. We strip a few conventional prefixes\n * (`devstack:`, `app:`) plus instance counters so common cases read\n * cleanly.\n *\n * The function consumes `key` only — never `row.title`, which doesn't\n * exist in the projection.\n */\nexport const labelForRow = (key: string): string => {\n\tconst normalized = normalizeKey(key);\n\tconst parts = normalized.split(/[/:]/).filter((part) => part.length > 0);\n\tif (parts.length >= 2 && isSectionish(parts[0]!)) return humanizeToken(parts[parts.length - 1]!);\n\treturn humanizeToken(parts[parts.length - 1] ?? normalized);\n};\n\nexport const ownerForRow = (key: string): string => {\n\tconst normalized = normalizeKey(key);\n\tconst first = normalized.split(/[/:._#-]/).find((part) => part.length > 0);\n\treturn first === undefined ? 'plugin' : humanizeToken(first);\n};\n\n/** Pure: pick the row's dashboard section. Reads `row.section`\n *  directly; if the plugin declared an `endpointSection` AND the row\n *  owns a routed endpoint, the endpoint variant wins. NEVER pattern-\n *  matches on `row.key`; the classifier is plugin-declared at\n *  `definePlugin({ section, endpointSection })` time and stamped by\n *  the supervisor. */\nexport const sectionForRow = (\n\trow: Pick<Row, 'key' | 'endpoints' | 'section' | 'endpointSection'>,\n\tendpoints: ReadonlyArray<Endpoint> = [],\n): RowSection => {\n\tconst ownsEndpoint = endpointsForRow(row, endpoints).length > 0 || row.endpoints.length > 0;\n\treturn ownsEndpoint && row.endpointSection !== row.section ? row.endpointSection : row.section;\n};\n\n/** Pure: section -> scope-chip color token used by the event log /\n *  activity stream. Coloring is driven by `RowSection` so the renderer\n *  doesn't pattern-match on plugin names. */\nexport const sectionColor = (section: RowSection): ColorToken => {\n\tswitch (section) {\n\t\tcase 'service':\n\t\t\treturn 'cyan';\n\t\tcase 'package':\n\t\t\treturn 'blueBright';\n\t\tcase 'account':\n\t\t\treturn 'magenta';\n\t\tcase 'action':\n\t\t\treturn 'magenta';\n\t\tcase 'app':\n\t\t\treturn 'white';\n\t\tcase 'other':\n\t\t\treturn 'cyan';\n\t\tdefault: {\n\t\t\tconst _exhaustive: never = section;\n\t\t\tvoid _exhaustive;\n\t\t\treturn 'cyan';\n\t\t}\n\t}\n};\n\nexport const sectionLabel = (section: RowSection): string => {\n\tswitch (section) {\n\t\tcase 'service':\n\t\t\treturn 'Services';\n\t\tcase 'package':\n\t\t\treturn 'Packages';\n\t\tcase 'account':\n\t\t\treturn 'Accounts';\n\t\tcase 'action':\n\t\t\treturn 'Actions';\n\t\tcase 'app':\n\t\t\treturn 'App';\n\t\tcase 'other':\n\t\t\treturn 'Other';\n\t\tdefault: {\n\t\t\tconst _exhaustive: never = section;\n\t\t\tvoid _exhaustive;\n\t\t\treturn 'Other';\n\t\t}\n\t}\n};\n\nexport const endpointsForRow = (\n\trow: Pick<Row, 'key' | 'endpoints'>,\n\tendpoints: ReadonlyArray<Endpoint>,\n): ReadonlyArray<Endpoint> =>\n\tendpoints.filter(\n\t\t(endpoint) => row.endpoints.includes(endpoint.endpointKey) || endpoint.pluginKey === row.key,\n\t);\n\nconst OPERATIONAL_ENDPOINT_FIELDS = new Set(['url', 'rpcUrl', 'faucetUrl', 'graphqlUrl']);\n\nexport const visibleEndpointsForRow = (\n\trow: Pick<Row, 'key' | 'endpoints'>,\n\tendpoints: ReadonlyArray<Endpoint>,\n): ReadonlyArray<Endpoint> => {\n\tconst rowEndpoints = endpointsForRow(row, endpoints);\n\tconst routed = rowEndpoints.filter((endpoint) => !isOperationalEndpoint(row.key, endpoint));\n\treturn routed.length > 0 ? routed : rowEndpoints;\n};\n\nexport const headlineForRow = (row: Row, endpoints: ReadonlyArray<Endpoint> = []): string => {\n\tconst rowEndpoints = visibleEndpointsForRow(row, endpoints);\n\tif (rowEndpoints.length > 0) return endpointLine(rowEndpoints[0]!);\n\tif (row.lastError !== null && row.status === 'failed') return errorSummaryFor(row.lastError);\n\treturn narrationFor(row.phase, row.status);\n};\n\nexport const secondaryForRow = (\n\trow: Row,\n\tendpoints: ReadonlyArray<Endpoint> = [],\n): ReadonlyArray<string> => {\n\tconst out: Array<string> = [];\n\tconst rowEndpoints = endpointsForRow(row, endpoints);\n\tfor (const endpoint of rowEndpoints.slice(1)) out.push(endpointLine(endpoint));\n\tif (row.logTail.truncated) out.push('log tail truncated');\n\treturn out;\n};\n\nexport const groupRows = (\n\trows: ReadonlyArray<Row>,\n\tendpoints: ReadonlyArray<Endpoint> = [],\n): ReadonlyArray<DisplaySection> => {\n\tconst buckets = new Map<RowSection, Array<DisplayRow>>();\n\tfor (const row of rows) {\n\t\tconst cells = deriveDisplayCells(row, endpoints);\n\t\tconst list = buckets.get(cells.section) ?? [];\n\t\tlist.push({ row, cells });\n\t\tbuckets.set(cells.section, list);\n\t}\n\tconst order: ReadonlyArray<RowSection> = [\n\t\t'service',\n\t\t'package',\n\t\t'account',\n\t\t'action',\n\t\t'app',\n\t\t'other',\n\t];\n\treturn order\n\t\t.filter((section) => buckets.has(section))\n\t\t.map((section) => ({\n\t\t\tkey: section,\n\t\t\tlabel: sectionLabel(section),\n\t\t\trows: buckets.get(section) ?? [],\n\t\t}));\n};\n\n/**\n * TUI dashboard summary. Delegates to the canonical `deriveStackViewModel`\n * + `deriveHealth(counts, 'tui')`. The `waitingRows` field folds the\n * discrete `stoppedRows` back in (the TUI counts stopped rows as\n * \"waiting\") so `dashboardSummaryLine` and its consumers get the TUI's\n * expected shape.\n */\nexport const deriveDashboardSummary = (\n\tstate: Pick<SubscribableState, 'rows' | 'endpoints' | 'accounts' | 'packages' | 'errors'>,\n): DashboardSummary => {\n\tconst vm = deriveStackViewModel(state);\n\treturn {\n\t\ttotalRows: vm.total,\n\t\treadyRows: vm.readyRows,\n\t\tactiveRows: vm.activeRows,\n\t\tfailedRows: vm.failedRows,\n\t\t// TUI's `waitingRows` counts pending + stopped together.\n\t\twaitingRows: vm.waitingRows + vm.stoppedRows,\n\t\tendpointCount: vm.endpointCount,\n\t\taccountCount: vm.accountCount,\n\t\tpackageCount: vm.packageCount,\n\t\terrorCount: vm.errorCount,\n\t\thealth: deriveHealth(vm, 'tui'),\n\t};\n};\n\nconst visibleEndpointCount = (\n\trows: ReadonlyArray<Row>,\n\tendpoints: ReadonlyArray<Endpoint>,\n): number => {\n\tconst rowOwned = new Set<Endpoint['endpointKey']>();\n\tconst visible = new Set<Endpoint['endpointKey']>();\n\tfor (const row of rows) {\n\t\tfor (const endpoint of endpointsForRow(row, endpoints)) {\n\t\t\trowOwned.add(endpoint.endpointKey);\n\t\t}\n\t\tfor (const endpoint of visibleEndpointsForRow(row, endpoints)) {\n\t\t\tvisible.add(endpoint.endpointKey);\n\t\t}\n\t}\n\tfor (const endpoint of endpoints) {\n\t\tif (!rowOwned.has(endpoint.endpointKey)) visible.add(endpoint.endpointKey);\n\t}\n\treturn visible.size;\n};\n\nexport const dashboardSummaryLine = (summary: DashboardSummary): string =>\n\t[\n\t\t`${summary.readyRows}/${summary.totalRows} ready`,\n\t\tsummary.activeRows > 0 ? `${summary.activeRows} active` : null,\n\t\tsummary.waitingRows > 0 ? `${summary.waitingRows} waiting` : null,\n\t\tsummary.failedRows > 0 ? `${summary.failedRows} failed` : null,\n\t\t`${summary.endpointCount} urls`,\n\t\t`${summary.accountCount} accounts`,\n\t\tsummary.packageCount > 0 ? `${summary.packageCount} packages` : null,\n\t\tsummary.errorCount === 0 ? 'no errors' : `${summary.errorCount} errors`,\n\t]\n\t\t.filter((part): part is string => part !== null)\n\t\t.join('  ');\n\n// -----------------------------------------------------------------------------\n// Phase narration formatting\n// -----------------------------------------------------------------------------\n\n/**\n * Pure: phase narration string → renderable verb form. Phase is\n * free-form upstream (Tension 14). The renderer's job is to make it\n * legible; we keep this minimal — single-line, no fancy verb tense\n * inference. The truncation cap protects against pathological long\n * narrations.\n */\nexport const narrationFor = (phase: PhaseNarration | null, status: LifecycleStatus): string => {\n\tif (phase === null || phase.trim().length === 0) {\n\t\t// No phase set; surface a status-derived default for `acquiring`,\n\t\t// stay silent otherwise (Tension: don't manufacture text the\n\t\t// engine didn't ask for).\n\t\treturn status === 'acquiring' ? 'starting…' : '';\n\t}\n\tconst trimmed = phase.trim();\n\tconst TRUNC = 80;\n\treturn trimmed.length > TRUNC ? `${trimmed.slice(0, TRUNC - 1)}…` : trimmed;\n};\n\n// -----------------------------------------------------------------------------\n// Error summary formatting\n// -----------------------------------------------------------------------------\n\nconst ERR_SUMMARY_TRUNC = 120;\n\n/**\n * Pure: `Row.lastError` → renderable in-row summary. Keep it short;\n * detailed error context belongs in the activity/log stream.\n */\nexport const errorSummaryFor = (error: StructuredError | null): string => {\n\tif (error === null) return '';\n\tconst head = `${error.tag}: ${error.summary}`;\n\tconst detail = error.chain.find((line) => line !== head && line !== error.tag);\n\tconst compactDetail =\n\t\tdetail === undefined ? undefined : detail.replace(/^[A-Za-z0-9_[\\]-]+:\\s*/, '');\n\tconst summary = compactDetail === undefined ? head : `${head}: ${compactDetail}`;\n\treturn summary.length > ERR_SUMMARY_TRUNC\n\t\t? `${summary.slice(0, ERR_SUMMARY_TRUNC - 1)}…`\n\t\t: summary;\n};\n\n// -----------------------------------------------------------------------------\n// Endpoint formatting\n// -----------------------------------------------------------------------------\n\n/**\n * Pure: `Endpoint` → renderable line. Renderers prefer `displayUrl`\n * when set (codegen-friendly variant), falling back to `url`.\n */\nexport const endpointLine = (endpoint: Endpoint): string => {\n\tconst target = endpoint.displayUrl ?? endpoint.url;\n\tconst backing =\n\t\tendpoint.displayUrl !== null && endpoint.displayUrl !== endpoint.url\n\t\t\t? ` -> ${endpoint.url}`\n\t\t\t: '';\n\tconst protocol = endpoint.wireProtocol === 'http' ? '' : ` [${endpoint.wireProtocol}]`;\n\treturn `${endpoint.name}: ${target}${backing}${protocol}`;\n};\n\nexport const accountLine = (account: AccountProjection): string => {\n\tconst address = account.address ?? '<pending>';\n\tconst scheme = account.scheme ?? 'scheme pending';\n\tconst source = account.source ?? 'source pending';\n\tconst funding = accountFundingLine(account.funding);\n\tconst wallet = account.walletVisible ? 'wallet' : null;\n\treturn [humanizeToken(account.name), address, scheme, source, funding, wallet]\n\t\t.filter((part): part is string => part !== null && part.length > 0)\n\t\t.join('  ');\n};\n\nexport const packageLine = (pkg: PackageProjection): string => {\n\treturn [humanizeToken(pkg.name), pkg.packageId, pkg.mvrPlaceholder, pkg.kind]\n\t\t.filter((part): part is string => part !== null && part.length > 0)\n\t\t.join('  ');\n};\n\nexport interface AccountCells {\n\treadonly name: string;\n\treadonly address: string;\n\treadonly scheme: string;\n\treadonly source: string;\n\treadonly funding: string;\n}\n\nexport interface PackageCells {\n\treadonly name: string;\n\treadonly packageId: string;\n\treadonly mvr: string;\n\treadonly kind: string;\n\treadonly detail: string;\n}\n\nexport const accountCells = (account: AccountProjection): AccountCells => ({\n\tname: humanizeToken(account.name),\n\taddress: account.address ?? '<pending>',\n\tscheme: account.scheme ?? 'pending',\n\tsource: account.source ?? 'pending',\n\tfunding: accountFundingLine(account.funding),\n});\n\nconst accountFundingLine = (funding: AccountProjection['funding']): string => {\n\tconst entries = funding.entries ?? [];\n\tif (entries.length > 0) {\n\t\tconst rendered = entries\n\t\t\t.map(\n\t\t\t\t(entry) => `${entry.coin}:${entry.amount}${entry.status === 'skipped' ? ' skipped' : ''}`,\n\t\t\t)\n\t\t\t.join(', ');\n\t\treturn funding.status === 'funded' ? `funded ${rendered}` : `funding ${rendered}`;\n\t}\n\tswitch (funding.status) {\n\t\tcase 'pending':\n\t\t\treturn funding.requestedMist === null\n\t\t\t\t? 'funding pending'\n\t\t\t\t: `funding ${funding.requestedMist}`;\n\t\tcase 'funded':\n\t\t\treturn funding.balanceMist !== null\n\t\t\t\t? `funded ${funding.balanceMist}`\n\t\t\t\t: funding.requestedMist !== null\n\t\t\t\t\t? `funded ${funding.requestedMist}`\n\t\t\t\t\t: 'funded';\n\t\tcase 'skipped':\n\t\t\treturn 'funding skipped';\n\t\tcase 'failed':\n\t\t\treturn 'funding failed';\n\t\tcase 'unknown':\n\t\t\treturn 'funding unknown';\n\t\tdefault: {\n\t\t\tconst _exhaustive: never = funding.status;\n\t\t\tvoid _exhaustive;\n\t\t\treturn '';\n\t\t}\n\t}\n};\n\nexport const packageCells = (pkg: PackageProjection): PackageCells => ({\n\tname: humanizeToken(pkg.name),\n\tpackageId: pkg.packageId,\n\tmvr: pkg.mvrPlaceholder,\n\tkind: pkg.kind,\n\tdetail: pkg.kind,\n});\n\n// -----------------------------------------------------------------------------\n// Top-level entry point\n// -----------------------------------------------------------------------------\n\n/**\n * Derive every visible display cell for a single row.\n *\n * Consumes ONLY `row.key`, `row.role`, `row.status`, `row.phase`,\n * `row.lastError`, `row.endpoints` (rendered separately by\n * `resource-table.tsx`), or `row.logTail` (kept in the projection\n * for renderer variants that need tails, but not used as primary\n * dashboard state because generic lifecycle log lines duplicate the\n * table).\n */\nexport const deriveDisplayCells = (\n\trow: Row,\n\tendpoints: ReadonlyArray<Endpoint> = [],\n): DisplayCells => ({\n\tstatusGlyph: statusGlyph(row.status),\n\tstatusColor: statusColor(row.status),\n\tstatusLabel: statusLabel(row.status),\n\troleGlyph: roleGlyph(row.role),\n\troleLabel: roleLabel(row.role),\n\tlabel: labelForRow(row.key),\n\tnarration: narrationFor(row.phase, row.status),\n\terrorSummary: errorSummaryFor(row.lastError),\n\tlabelColor: roleLabelColor(row.role),\n\tsection: sectionForRow(row, endpoints),\n\towner: ownerForRow(row.key),\n\theadline: headlineForRow(row, endpoints),\n\tsecondary: secondaryForRow(row, endpoints),\n});\n\nconst normalizeKey = (key: string): string =>\n\tkey\n\t\t.replace(/^@devstack\\//, '')\n\t\t.replace(/^(devstack:|app:)/, '')\n\t\t.replace(/#\\d+$/, '')\n\t\t.replace(/\\/\\d+$/, '');\n\nconst humanizeToken = (token: string): string =>\n\ttoken.replace(/[-_]+/g, ' ').replace(/^\\w/, (head) => head.toUpperCase());\n\nconst containsKeyPart = (key: string, parts: ReadonlyArray<string>): boolean => {\n\tconst tokens = key.split(/[/:._#-]/).filter((part) => part.length > 0);\n\treturn tokens.some((token) => parts.includes(token));\n};\n\nconst isSectionish = (token: string): boolean =>\n\tcontainsKeyPart(token.toLowerCase(), ['service', 'package', 'account', 'action', 'app']);\n\nconst isOperationalEndpoint = (rowKey: Pick<Row, 'key'>['key'], endpoint: Endpoint): boolean => {\n\tif (endpoint.pluginKey !== rowKey) return false;\n\tconst prefix = `${rowKey}:`;\n\tif (!endpoint.endpointKey.startsWith(prefix)) return false;\n\tconst field = endpoint.endpointKey.slice(prefix.length);\n\treturn OPERATIONAL_ENDPOINT_FIELDS.has(field);\n};\n\n// -----------------------------------------------------------------------------\n// Compile-time invariant\n// -----------------------------------------------------------------------------\n//\n// Renderer code must never see a `title`/`primary`/`extras` field on\n// `Row`. If the projection ever sprouts one, the substrate's\n// `__ProjectionFieldsClosed` guard fails first; this module-local\n// guard exists as a second layer that explicitly mentions the\n// forbidden field names so a future renderer-side regression is\n// caught at the renderer boundary, not at the substrate boundary.\n\ntype _NoForbiddenOnRow = 'title' extends keyof Row\n\t? never\n\t: 'primary' extends keyof Row\n\t\t? never\n\t\t: 'extras' extends keyof Row\n\t\t\t? never\n\t\t\t: true;\n\n/** Renderer-side compile-time guard. If this resolves to `never`,\n *  the renderer is reading a forbidden display-vocabulary field from\n *  the projection. */\nexport type __TuiDisplayVocabClean = _NoForbiddenOnRow extends true ? true : never;\n"],"mappings":"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"}

package/dist/surfaces/tui/errors.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"errors.mjs","names":[],"sources":["../../../src/surfaces/tui/errors.ts"],"sourcesContent":["// TUI surface errors.\n//\n// Architecture §11 (Renderer): the renderer surface satisfies the\n// `Renderer` contract from `contracts/renderer.ts`, which already\n// defines `RendererError`. The TUI surface adds NO new error tags of\n// its own beyond the contract's two reasons — `mount-failed` and\n// `subscription-lost`. Anything that would be a third reason is\n// either upstream (lifecycle event from the engine, projected into\n// `state.errors[]`) or a programmer-error defect (Effect.die).\n//\n// This module exists as a single import site for the TUI's error\n// constructors so the surface code never reaches across the substrate\n// boundary directly when fabricating its typed failures.\n\nimport type { RendererError } from '../../contracts/renderer.ts';\n\n/** Construct a `mount-failed` renderer error. */\nexport const mountFailed = (detail: string): RendererError => ({\n\t_tag: 'RendererError',\n\treason: 'mount-failed',\n\tdetail,\n});\n\n/** Construct a `subscription-lost` renderer error. */\nexport const subscriptionLost = (detail: string): RendererError => ({\n\t_tag: 'RendererError',\n\treason: 'subscription-lost',\n\tdetail,\n});\n\n// Re-export the shared contract type so callers in this surface only\n// need to import from one place.\nexport type { RendererError };\n"],"mappings":";;AAiBA,MAAa,eAAe,YAAmC;CAC9D,MAAM;CACN,QAAQ;CACR;CACA"}
+{"version":3,"file":"errors.mjs","names":[],"sources":["../../../src/surfaces/tui/errors.ts"],"sourcesContent":["// TUI surface errors.\n//\n// Architecture §11 (Renderer): the renderer surface satisfies the\n// `Renderer` contract from `contracts/renderer.ts`, which already\n// defines `RendererError`. The TUI surface adds NO new error tags of\n// its own beyond the contract's two reasons — `mount-failed` and\n// `subscription-lost`. Anything that would be a third reason is\n// either upstream (lifecycle event from the engine, projected into\n// `state.errors[]`) or a programmer-error defect (Effect.die).\n//\n// This module exists as a single import site for the TUI's error\n// constructors so the surface code never reaches across the substrate\n// boundary directly when fabricating its typed failures.\n\nimport type { RendererError } from '../../contracts/renderer.ts';\n\n/** Construct a `mount-failed` renderer error. */\nexport const mountFailed = (detail: string): RendererError => ({\n\t_tag: 'RendererError',\n\treason: 'mount-failed',\n\tdetail,\n});\n\n// Re-export the shared contract type so callers in this surface only\n// need to import from one place.\nexport type { RendererError };\n"],"mappings":";;AAiBA,MAAa,eAAe,YAAmC;CAC9D,MAAM;CACN,QAAQ;CACR;AACD"}

package/dist/surfaces/tui/event-log.mjs

@@ -52,15 +52,6 @@ const eventLogLineFromEvent = (event, seq, sectionLookup = () => void 0) => {
 			scopeColor: "white",
 			message: `shutdown hard-kill escalated by ${event.signal} (exit ${event.exitCode})`
 		});
-		case "snapshot.captureStarted": return line({
-			id,
-			level: "info",
-			at,
-			scope: "Snapshot",
-			scopeColor: "blueBright",
-			message: event.name === void 0 ? "capture started" : `capture started for ${event.name}`
-		});
-		case "snapshot.captureProgress": return null;
 		case "snapshot.captureSkipped": return line({
 			id,
 			level: "warn",

package/dist/surfaces/tui/event-log.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"event-log.mjs","names":[],"sources":["../../../src/surfaces/tui/event-log.ts"],"sourcesContent":["import type { EngineEvent } from '../../substrate/events.ts';\nimport type { RowSection } from '../../substrate/projection.ts';\nimport {\n\terrorSummaryFor,\n\tlabelForRow,\n\tsectionColor,\n\ttype ColorToken,\n} from './display-derivation.ts';\nimport { eventAt } from '../../substrate/event-time.ts';\n\nexport interface EventLogLine {\n\treadonly id: string;\n\treadonly time: string;\n\treadonly scope: string;\n\treadonly scopeColor: ColorToken;\n\treadonly message: string;\n\treadonly text: string;\n\treadonly level: 'info' | 'warn' | 'error';\n}\n\nexport const MAX_EVENT_LOG_LINES = 200;\n\n/** Pure: lookup a row's plugin-declared section by `pluginKey`. The\n *  event log accepts this as a parameter rather than computing it\n *  itself — the substrate forbids the renderer from pattern-matching\n *  plugin-name substrings. Callers (e.g. `app.tsx`) build the lookup\n *  from the live `state.rows` projection. */\nexport type SectionLookup = (pluginKey: string) => RowSection | undefined;\n\nexport const eventLogLineFromEvent = (\n\tevent: EngineEvent,\n\tseq: number,\n\tsectionLookup: SectionLookup = () => undefined,\n): EventLogLine | null => {\n\tconst at = eventAt(event);\n\tconst id = `${at}-${seq}-${event.tag}`;\n\tconst scopeColorFor = (pluginKey: string): ColorToken =>\n\t\tsectionColor(sectionLookup(pluginKey) ?? 'other');\n\tswitch (event.tag) {\n\t\tcase 'log.appended':\n\t\t\tif (event.level === 'info' || isRedundantPluginLog(event.line)) return null;\n\t\t\treturn line({\n\t\t\t\tid,\n\t\t\t\tat,\n\t\t\t\tlevel: event.level,\n\t\t\t\tscope: labelForRow(event.pluginKey),\n\t\t\t\tscopeColor: scopeColorFor(event.pluginKey),\n\t\t\t\tmessage: event.line,\n\t\t\t});\n\t\tcase 'error.reported':\n\t\t\treturn line({\n\t\t\t\tid,\n\t\t\t\tlevel: event.error.severity === 'warn' ? 'warn' : 'error',\n\t\t\t\tat,\n\t\t\t\tscope: event.error.pluginKey === null ? 'Stack' : labelForRow(event.error.pluginKey),\n\t\t\t\tscopeColor: event.error.pluginKey === null ? 'white' : scopeColorFor(event.error.pluginKey),\n\t\t\t\tmessage: `failed: ${errorSummaryFor(event.error)}`,\n\t\t\t});\n\t\tcase 'build.statusChanged':\n\t\tcase 'lifecycle.statusChanged':\n\t\tcase 'lifecycle.phaseSet':\n\t\tcase 'endpoint.registered':\n\t\tcase 'projection.updated':\n\t\t\treturn null;\n\t\tcase 'restart.requested':\n\t\t\treturn line({\n\t\t\t\tid,\n\t\t\t\tlevel: 'warn',\n\t\t\t\tat,\n\t\t\t\tscope: 'Stack',\n\t\t\t\tscopeColor: 'white',\n\t\t\t\tmessage: `restart requested for ${targetLabel(event.target)}`,\n\t\t\t});\n\t\tcase 'restart.completed':\n\t\t\treturn line({\n\t\t\t\tid,\n\t\t\t\tlevel: 'info',\n\t\t\t\tat,\n\t\t\t\tscope: 'Stack',\n\t\t\t\tscopeColor: 'white',\n\t\t\t\tmessage: `restart completed for ${targetLabel(event.target)}`,\n\t\t\t});\n\t\tcase 'shutdown.escalated':\n\t\t\treturn line({\n\t\t\t\tid,\n\t\t\t\tlevel: 'warn',\n\t\t\t\tat,\n\t\t\t\tscope: 'Stack',\n\t\t\t\tscopeColor: 'white',\n\t\t\t\tmessage: `shutdown hard-kill escalated by ${event.signal} (exit ${event.exitCode})`,\n\t\t\t});\n\t\tcase 'snapshot.captureStarted':\n\t\t\treturn line({\n\t\t\t\tid,\n\t\t\t\tlevel: 'info',\n\t\t\t\tat,\n\t\t\t\tscope: 'Snapshot',\n\t\t\t\tscopeColor: 'blueBright',\n\t\t\t\tmessage: event.name === undefined ? 'capture started' : `capture started for ${event.name}`,\n\t\t\t});\n\t\tcase 'snapshot.captureProgress':\n\t\t\treturn null;\n\t\tcase 'snapshot.captureSkipped':\n\t\t\treturn line({\n\t\t\t\tid,\n\t\t\t\tlevel: 'warn',\n\t\t\t\tat,\n\t\t\t\tscope: 'Snapshot',\n\t\t\t\tscopeColor: 'blueBright',\n\t\t\t\tmessage: 'capture already running',\n\t\t\t});\n\t\tcase 'snapshot.captureFailed':\n\t\t\treturn line({\n\t\t\t\tid,\n\t\t\t\tlevel: 'error',\n\t\t\t\tat,\n\t\t\t\tscope: 'Snapshot',\n\t\t\t\tscopeColor: 'blueBright',\n\t\t\t\tmessage:\n\t\t\t\t\tevent.name === undefined\n\t\t\t\t\t\t? `capture failed: ${event.summary}`\n\t\t\t\t\t\t: `capture failed for ${event.name}: ${event.summary}`,\n\t\t\t});\n\t\tcase 'snapshot.captured':\n\t\t\treturn line({\n\t\t\t\tid,\n\t\t\t\tlevel: 'info',\n\t\t\t\tat,\n\t\t\t\tscope: 'Snapshot',\n\t\t\t\tscopeColor: 'blueBright',\n\t\t\t\tmessage:\n\t\t\t\t\tevent.name === undefined\n\t\t\t\t\t\t? `captured ${event.snapshotId}`\n\t\t\t\t\t\t: `captured ${event.name} (${event.snapshotId})`,\n\t\t\t});\n\t\tcase 'snapshot.restored':\n\t\t\treturn line({\n\t\t\t\tid,\n\t\t\t\tlevel: 'info',\n\t\t\t\tat,\n\t\t\t\tscope: 'Snapshot',\n\t\t\t\tscopeColor: 'blueBright',\n\t\t\t\tmessage: `restored ${event.snapshotId}`,\n\t\t\t});\n\t\tcase 'engine.orchestrator.dispatchFailed':\n\t\t\t// A capability sink (e.g. `routable`) rejected, but the plugin is\n\t\t\t// left `ready` on purpose (non-fatal sink — see\n\t\t\t// dispatch-contributions.ts). Previously suppressed here, which\n\t\t\t// meant a live-dashboard operator saw a green stack with dead\n\t\t\t// RPC/wallet routing. Surface it as a warning so the failure is\n\t\t\t// visible; lead with the cause `_tag` when present so the line\n\t\t\t// names WHICH orchestrator broke.\n\t\t\treturn line({\n\t\t\t\tid,\n\t\t\t\tlevel: 'warn',\n\t\t\t\tat,\n\t\t\t\tscope: labelForRow(event.pluginKey),\n\t\t\t\tscopeColor: scopeColorFor(event.pluginKey),\n\t\t\t\tmessage:\n\t\t\t\t\tevent.causeType === undefined\n\t\t\t\t\t\t? `routing sink '${event.kind}' failed: ${event.message}`\n\t\t\t\t\t\t: `routing sink '${event.kind}' failed (${event.causeType}): ${event.message}`,\n\t\t\t});\n\t\tcase 'endpoint.released':\n\t\tcase 'strategy.registered':\n\t\tcase 'strategy.unregistered':\n\t\tcase 'manifest.flushed':\n\t\tcase 'codegen.emitted':\n\t\t\treturn null;\n\t\tdefault: {\n\t\t\tconst _exhaustive: never = event;\n\t\t\tvoid _exhaustive;\n\t\t\treturn null;\n\t\t}\n\t}\n};\n\nexport const shutdownRequestedLine = (at: number, seq: number): EventLogLine => ({\n\tid: `${at}-${seq}-shutdown.requested`,\n\ttime: time(at),\n\tscope: 'Stack',\n\tscopeColor: 'white',\n\tmessage: 'shutdown requested; waiting for graceful stop',\n\tlevel: 'warn',\n\ttext: `${time(at)} shutdown requested; waiting for graceful stop`,\n});\n\nexport const appendEventLogLine = (\n\tlines: ReadonlyArray<EventLogLine>,\n\tnext: EventLogLine | null,\n): ReadonlyArray<EventLogLine> => {\n\tif (next === null) return lines;\n\tconst appended = [...lines, next];\n\treturn appended.length > MAX_EVENT_LOG_LINES ? appended.slice(-MAX_EVENT_LOG_LINES) : appended;\n};\n\n/**\n * Batched variant of `appendEventLogLine`: append many lines, slice to\n * the bound ONCE. The per-event variant rebuilt the array on every\n * call; a 100-event burst therefore allocated 100 arrays and ran the\n * `.slice(-MAX_EVENT_LOG_LINES)` projection 100 times. The plural form\n * collapses that to one allocation + one bound check — matching the\n * microtask-batched dispatch path in `app.tsx`.\n *\n * `nexts` may contain `null` entries (the same null-pass-through\n * contract as the singular form) — they're filtered before append.\n * Returns the input array unchanged when no real lines remain so\n * `setEventLog`'s referential-equality short-circuit still fires.\n */\nexport const appendEventLogLines = (\n\tlines: ReadonlyArray<EventLogLine>,\n\tnexts: ReadonlyArray<EventLogLine | null>,\n): ReadonlyArray<EventLogLine> => {\n\tconst real: Array<EventLogLine> = [];\n\tfor (const line of nexts) {\n\t\tif (line !== null) real.push(line);\n\t}\n\tif (real.length === 0) return lines;\n\tconst appended = lines.length === 0 ? real : [...lines, ...real];\n\treturn appended.length > MAX_EVENT_LOG_LINES ? appended.slice(-MAX_EVENT_LOG_LINES) : appended;\n};\n\nconst time = (at: number): string => new Date(at).toISOString().slice(11, 19);\n\nconst targetLabel = (target: 'stack' | { readonly pluginKey: string }): string =>\n\ttarget === 'stack' ? 'stack' : target.pluginKey;\n\nconst line = (input: {\n\treadonly id: string;\n\treadonly at: number;\n\treadonly level: EventLogLine['level'];\n\treadonly scope: string;\n\treadonly scopeColor: ColorToken;\n\treadonly message: string;\n}): EventLogLine => {\n\tconst renderedTime = time(input.at);\n\treturn {\n\t\tid: input.id,\n\t\ttime: renderedTime,\n\t\tscope: input.scope,\n\t\tscopeColor: input.scopeColor,\n\t\tmessage: input.message,\n\t\tlevel: input.level,\n\t\ttext: `${renderedTime} ${input.scope}: ${input.message}`,\n\t};\n};\n\nconst isRedundantPluginLog = (message: string): boolean => {\n\tconst normalized = message.trim().toLowerCase();\n\treturn (\n\t\tnormalized === 'plugin acquire start' ||\n\t\tnormalized === 'plugin ready' ||\n\t\tnormalized === 'plugin acquire failed'\n\t);\n};\n\n// Scope-chip color is driven by `Row.section`, looked up via the\n// `sectionLookup` argument the host (app.tsx / tests) constructs from\n// the live projection. Keeps the renderer name-blind: it sees only the\n// closed `RowSection` vocabulary (`service` / `package` / `account` /\n// ...), never a substring of a plugin name. Plugin authors declare\n// their section once via `definePlugin({ section })`.\n"],"mappings":"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"}
+{"version":3,"file":"event-log.mjs","names":[],"sources":["../../../src/surfaces/tui/event-log.ts"],"sourcesContent":["import type { EngineEvent } from '../../substrate/events.ts';\nimport type { RowSection } from '../../substrate/projection.ts';\nimport {\n\terrorSummaryFor,\n\tlabelForRow,\n\tsectionColor,\n\ttype ColorToken,\n} from './display-derivation.ts';\nimport { eventAt } from '../../substrate/event-time.ts';\n\nexport interface EventLogLine {\n\treadonly id: string;\n\treadonly time: string;\n\treadonly scope: string;\n\treadonly scopeColor: ColorToken;\n\treadonly message: string;\n\treadonly text: string;\n\treadonly level: 'info' | 'warn' | 'error';\n}\n\nexport const MAX_EVENT_LOG_LINES = 200;\n\n/** Pure: lookup a row's plugin-declared section by `pluginKey`. The\n *  event log accepts this as a parameter rather than computing it\n *  itself — the substrate forbids the renderer from pattern-matching\n *  plugin-name substrings. Callers (e.g. `app.tsx`) build the lookup\n *  from the live `state.rows` projection. */\nexport type SectionLookup = (pluginKey: string) => RowSection | undefined;\n\nexport const eventLogLineFromEvent = (\n\tevent: EngineEvent,\n\tseq: number,\n\tsectionLookup: SectionLookup = () => undefined,\n): EventLogLine | null => {\n\tconst at = eventAt(event);\n\tconst id = `${at}-${seq}-${event.tag}`;\n\tconst scopeColorFor = (pluginKey: string): ColorToken =>\n\t\tsectionColor(sectionLookup(pluginKey) ?? 'other');\n\tswitch (event.tag) {\n\t\tcase 'log.appended':\n\t\t\tif (event.level === 'info' || isRedundantPluginLog(event.line)) return null;\n\t\t\treturn line({\n\t\t\t\tid,\n\t\t\t\tat,\n\t\t\t\tlevel: event.level,\n\t\t\t\tscope: labelForRow(event.pluginKey),\n\t\t\t\tscopeColor: scopeColorFor(event.pluginKey),\n\t\t\t\tmessage: event.line,\n\t\t\t});\n\t\tcase 'error.reported':\n\t\t\treturn line({\n\t\t\t\tid,\n\t\t\t\tlevel: event.error.severity === 'warn' ? 'warn' : 'error',\n\t\t\t\tat,\n\t\t\t\tscope: event.error.pluginKey === null ? 'Stack' : labelForRow(event.error.pluginKey),\n\t\t\t\tscopeColor: event.error.pluginKey === null ? 'white' : scopeColorFor(event.error.pluginKey),\n\t\t\t\tmessage: `failed: ${errorSummaryFor(event.error)}`,\n\t\t\t});\n\t\tcase 'build.statusChanged':\n\t\tcase 'lifecycle.statusChanged':\n\t\tcase 'lifecycle.phaseSet':\n\t\tcase 'endpoint.registered':\n\t\tcase 'projection.updated':\n\t\t\treturn null;\n\t\tcase 'restart.requested':\n\t\t\treturn line({\n\t\t\t\tid,\n\t\t\t\tlevel: 'warn',\n\t\t\t\tat,\n\t\t\t\tscope: 'Stack',\n\t\t\t\tscopeColor: 'white',\n\t\t\t\tmessage: `restart requested for ${targetLabel(event.target)}`,\n\t\t\t});\n\t\tcase 'restart.completed':\n\t\t\treturn line({\n\t\t\t\tid,\n\t\t\t\tlevel: 'info',\n\t\t\t\tat,\n\t\t\t\tscope: 'Stack',\n\t\t\t\tscopeColor: 'white',\n\t\t\t\tmessage: `restart completed for ${targetLabel(event.target)}`,\n\t\t\t});\n\t\tcase 'shutdown.escalated':\n\t\t\treturn line({\n\t\t\t\tid,\n\t\t\t\tlevel: 'warn',\n\t\t\t\tat,\n\t\t\t\tscope: 'Stack',\n\t\t\t\tscopeColor: 'white',\n\t\t\t\tmessage: `shutdown hard-kill escalated by ${event.signal} (exit ${event.exitCode})`,\n\t\t\t});\n\t\tcase 'snapshot.captureSkipped':\n\t\t\treturn line({\n\t\t\t\tid,\n\t\t\t\tlevel: 'warn',\n\t\t\t\tat,\n\t\t\t\tscope: 'Snapshot',\n\t\t\t\tscopeColor: 'blueBright',\n\t\t\t\tmessage: 'capture already running',\n\t\t\t});\n\t\tcase 'snapshot.captureFailed':\n\t\t\treturn line({\n\t\t\t\tid,\n\t\t\t\tlevel: 'error',\n\t\t\t\tat,\n\t\t\t\tscope: 'Snapshot',\n\t\t\t\tscopeColor: 'blueBright',\n\t\t\t\tmessage:\n\t\t\t\t\tevent.name === undefined\n\t\t\t\t\t\t? `capture failed: ${event.summary}`\n\t\t\t\t\t\t: `capture failed for ${event.name}: ${event.summary}`,\n\t\t\t});\n\t\tcase 'snapshot.captured':\n\t\t\treturn line({\n\t\t\t\tid,\n\t\t\t\tlevel: 'info',\n\t\t\t\tat,\n\t\t\t\tscope: 'Snapshot',\n\t\t\t\tscopeColor: 'blueBright',\n\t\t\t\tmessage:\n\t\t\t\t\tevent.name === undefined\n\t\t\t\t\t\t? `captured ${event.snapshotId}`\n\t\t\t\t\t\t: `captured ${event.name} (${event.snapshotId})`,\n\t\t\t});\n\t\tcase 'snapshot.restored':\n\t\t\treturn line({\n\t\t\t\tid,\n\t\t\t\tlevel: 'info',\n\t\t\t\tat,\n\t\t\t\tscope: 'Snapshot',\n\t\t\t\tscopeColor: 'blueBright',\n\t\t\t\tmessage: `restored ${event.snapshotId}`,\n\t\t\t});\n\t\tcase 'engine.orchestrator.dispatchFailed':\n\t\t\t// A buffered contribution (e.g. `routable`) failed when the\n\t\t\t// supervisor replayed it through the `ContributionDispatcher`, but\n\t\t\t// the plugin is left `ready` on purpose (non-fatal dispatch — see\n\t\t\t// `dispatchBufferedContributions` in acquire-node.ts). Previously\n\t\t\t// suppressed here, which meant a live-dashboard operator saw a\n\t\t\t// green stack with dead RPC/wallet routing. Surface it as a\n\t\t\t// warning so the failure is visible; lead with the cause `_tag`\n\t\t\t// when present so the line names WHICH orchestrator broke.\n\t\t\treturn line({\n\t\t\t\tid,\n\t\t\t\tlevel: 'warn',\n\t\t\t\tat,\n\t\t\t\tscope: labelForRow(event.pluginKey),\n\t\t\t\tscopeColor: scopeColorFor(event.pluginKey),\n\t\t\t\tmessage:\n\t\t\t\t\tevent.causeType === undefined\n\t\t\t\t\t\t? `routing sink '${event.kind}' failed: ${event.message}`\n\t\t\t\t\t\t: `routing sink '${event.kind}' failed (${event.causeType}): ${event.message}`,\n\t\t\t});\n\t\tcase 'endpoint.released':\n\t\tcase 'strategy.registered':\n\t\tcase 'strategy.unregistered':\n\t\tcase 'manifest.flushed':\n\t\tcase 'codegen.emitted':\n\t\t\treturn null;\n\t\tdefault: {\n\t\t\tconst _exhaustive: never = event;\n\t\t\tvoid _exhaustive;\n\t\t\treturn null;\n\t\t}\n\t}\n};\n\nexport const shutdownRequestedLine = (at: number, seq: number): EventLogLine => ({\n\tid: `${at}-${seq}-shutdown.requested`,\n\ttime: time(at),\n\tscope: 'Stack',\n\tscopeColor: 'white',\n\tmessage: 'shutdown requested; waiting for graceful stop',\n\tlevel: 'warn',\n\ttext: `${time(at)} shutdown requested; waiting for graceful stop`,\n});\n\nexport const appendEventLogLine = (\n\tlines: ReadonlyArray<EventLogLine>,\n\tnext: EventLogLine | null,\n): ReadonlyArray<EventLogLine> => {\n\tif (next === null) return lines;\n\tconst appended = [...lines, next];\n\treturn appended.length > MAX_EVENT_LOG_LINES ? appended.slice(-MAX_EVENT_LOG_LINES) : appended;\n};\n\n/**\n * Batched variant of `appendEventLogLine`: append many lines, slice to\n * the bound ONCE. The per-event variant rebuilt the array on every\n * call; a 100-event burst therefore allocated 100 arrays and ran the\n * `.slice(-MAX_EVENT_LOG_LINES)` projection 100 times. The plural form\n * collapses that to one allocation + one bound check — matching the\n * microtask-batched dispatch path in `app.tsx`.\n *\n * `nexts` may contain `null` entries (the same null-pass-through\n * contract as the singular form) — they're filtered before append.\n * Returns the input array unchanged when no real lines remain so\n * `setEventLog`'s referential-equality short-circuit still fires.\n */\nexport const appendEventLogLines = (\n\tlines: ReadonlyArray<EventLogLine>,\n\tnexts: ReadonlyArray<EventLogLine | null>,\n): ReadonlyArray<EventLogLine> => {\n\tconst real: Array<EventLogLine> = [];\n\tfor (const line of nexts) {\n\t\tif (line !== null) real.push(line);\n\t}\n\tif (real.length === 0) return lines;\n\tconst appended = lines.length === 0 ? real : [...lines, ...real];\n\treturn appended.length > MAX_EVENT_LOG_LINES ? appended.slice(-MAX_EVENT_LOG_LINES) : appended;\n};\n\nconst time = (at: number): string => new Date(at).toISOString().slice(11, 19);\n\nconst targetLabel = (target: 'stack' | { readonly pluginKey: string }): string =>\n\ttarget === 'stack' ? 'stack' : target.pluginKey;\n\nconst line = (input: {\n\treadonly id: string;\n\treadonly at: number;\n\treadonly level: EventLogLine['level'];\n\treadonly scope: string;\n\treadonly scopeColor: ColorToken;\n\treadonly message: string;\n}): EventLogLine => {\n\tconst renderedTime = time(input.at);\n\treturn {\n\t\tid: input.id,\n\t\ttime: renderedTime,\n\t\tscope: input.scope,\n\t\tscopeColor: input.scopeColor,\n\t\tmessage: input.message,\n\t\tlevel: input.level,\n\t\ttext: `${renderedTime} ${input.scope}: ${input.message}`,\n\t};\n};\n\nconst isRedundantPluginLog = (message: string): boolean => {\n\tconst normalized = message.trim().toLowerCase();\n\treturn (\n\t\tnormalized === 'plugin acquire start' ||\n\t\tnormalized === 'plugin ready' ||\n\t\tnormalized === 'plugin acquire failed'\n\t);\n};\n\n// Scope-chip color is driven by `Row.section`, looked up via the\n// `sectionLookup` argument the host (app.tsx / tests) constructs from\n// the live projection. Keeps the renderer name-blind: it sees only the\n// closed `RowSection` vocabulary (`service` / `package` / `account` /\n// ...), never a substring of a plugin name. Plugin authors declare\n// their section once via `definePlugin({ section })`.\n"],"mappings":"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"}

package/dist/surfaces/tui/heartbeat.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"heartbeat.mjs","names":[],"sources":["../../../src/surfaces/tui/heartbeat.tsx"],"sourcesContent":["// Heartbeat indicator.\n//\n// Distilled/21-tui § Invariants: \"Frame stability: rendering must\n// short-circuit when nothing has changed.\" The heartbeat indicator\n// gives the operator a visible signal that the renderer is alive\n// even when the projection isn't ticking — without re-rendering the\n// whole tree. It's a single character that cycles through a small\n// alphabet on a clock; the dashboard places it in the header.\n//\n// We use `useEffect` + `setInterval` so the heartbeat doesn't depend\n// on the projection at all. When the projection IS ticking, frames\n// are driven by the SubscriptionRef subscription; the heartbeat\n// continues to spin to give long-quiet-stack feedback.\n\nimport { Text } from 'ink';\nimport type React from 'react';\nimport { useEffect, useState } from 'react';\n\nimport type { ColorToken } from './display-derivation.ts';\n\nconst FRAMES = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'] as const;\n\nexport interface HeartbeatProps {\n\t/** Tick interval in ms. Default 120ms. */\n\treadonly intervalMs?: number;\n\t/** Color token. Default terminal foreground. */\n\treadonly color?: ColorToken;\n}\n\nexport const Heartbeat = ({\n\tintervalMs = 120,\n\tcolor = 'white',\n}: HeartbeatProps): React.JSX.Element => {\n\tconst [frame, setFrame] = useState(0);\n\tuseEffect(() => {\n\t\tconst id = setInterval(() => {\n\t\t\tsetFrame((f) => (f + 1) % FRAMES.length);\n\t\t}, intervalMs);\n\t\treturn () => clearInterval(id);\n\t}, [intervalMs]);\n\treturn <Text color={color}>{FRAMES[frame]}</Text>;\n};\n"],"mappings":";;;;AAoBA,MAAM,SAAS;CAAC;CAAK;CAAK;CAAK;CAAK;CAAK;CAAK;CAAK;CAAK;CAAK;CAAI;AASjE,MAAa,aAAa,EACzB,aAAa,KACb,QAAQ,cACgC;CACxC,MAAM,CAAC,OAAO,YAAY,SAAS,EAAE;AACrC,iBAAgB;EACf,MAAM,KAAK,kBAAkB;AAC5B,aAAU,OAAO,IAAI,KAAK,OAAO,OAAO;KACtC,WAAW;AACd,eAAa,cAAc,GAAG;IAC5B,CAAC,WAAW,CAAC;AAChB,QAAO,oBAAC,MAAD;EAAa;YAAQ,OAAO;EAAc,CAAA"}
+{"version":3,"file":"heartbeat.mjs","names":[],"sources":["../../../src/surfaces/tui/heartbeat.tsx"],"sourcesContent":["// Heartbeat indicator.\n//\n// Distilled/21-tui § Invariants: \"Frame stability: rendering must\n// short-circuit when nothing has changed.\" The heartbeat indicator\n// gives the operator a visible signal that the renderer is alive\n// even when the projection isn't ticking — without re-rendering the\n// whole tree. It's a single character that cycles through a small\n// alphabet on a clock; the dashboard places it in the header.\n//\n// We use `useEffect` + `setInterval` so the heartbeat doesn't depend\n// on the projection at all. When the projection IS ticking, frames\n// are driven by the SubscriptionRef subscription; the heartbeat\n// continues to spin to give long-quiet-stack feedback.\n\nimport { Text } from 'ink';\nimport type React from 'react';\nimport { useEffect, useState } from 'react';\n\nimport type { ColorToken } from './display-derivation.ts';\n\nconst FRAMES = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'] as const;\n\nexport interface HeartbeatProps {\n\t/** Tick interval in ms. Default 120ms. */\n\treadonly intervalMs?: number;\n\t/** Color token. Default terminal foreground. */\n\treadonly color?: ColorToken;\n}\n\nexport const Heartbeat = ({\n\tintervalMs = 120,\n\tcolor = 'white',\n}: HeartbeatProps): React.JSX.Element => {\n\tconst [frame, setFrame] = useState(0);\n\tuseEffect(() => {\n\t\tconst id = setInterval(() => {\n\t\t\tsetFrame((f) => (f + 1) % FRAMES.length);\n\t\t}, intervalMs);\n\t\treturn () => clearInterval(id);\n\t}, [intervalMs]);\n\treturn <Text color={color}>{FRAMES[frame]}</Text>;\n};\n"],"mappings":";;;;AAoBA,MAAM,SAAS;CAAC;CAAK;CAAK;CAAK;CAAK;CAAK;CAAK;CAAK;CAAK;CAAK;AAAG;AAShE,MAAa,aAAa,EACzB,aAAa,KACb,QAAQ,cACgC;CACxC,MAAM,CAAC,OAAO,YAAY,SAAS,CAAC;CACpC,gBAAgB;EACf,MAAM,KAAK,kBAAkB;GAC5B,UAAU,OAAO,IAAI,KAAK,OAAO,MAAM;EACxC,GAAG,UAAU;EACb,aAAa,cAAc,EAAE;CAC9B,GAAG,CAAC,UAAU,CAAC;CACf,OAAO,oBAAC,MAAD;EAAa;YAAQ,OAAO;CAAa,CAAA;AACjD"}

package/dist/surfaces/tui/index.mjs

@@ -1,6 +1,6 @@
+import "./display-derivation.mjs";
 import { mountFailed } from "./errors.mjs";
 import { detectMode } from "./mode-detect.mjs";
-import "./display-derivation.mjs";
 import { makePlainRenderer } from "./plain-renderer.mjs";
 import { Effect, Stream, SubscriptionRef } from "effect";
 //#region src/surfaces/tui/index.ts
@@ -18,7 +18,7 @@ import { Effect, Stream, SubscriptionRef } from "effect";
 const makeTuiSurface = (options = {}) => {
 	switch (detectMode(options.mode)) {
 		case "silent": return makeSilentRenderer();
-		case "plain": return makePlainRenderer();
+		case "plain": return makePlainRenderer({ quiet: options.quiet });
 		case "ink": return makeInkRenderer({ publishCommand: options.publishCommand ?? (() => {}) });
 		default: return makeSilentRenderer();
 	}

package/dist/surfaces/tui/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../../src/surfaces/tui/index.ts"],"sourcesContent":["// TUI surface entry point.\n//\n// Selects the renderer mode (ink / plain / silent), returns a\n// `Renderer`-contract-satisfying value the supervisor can mount once\n// per process. The supervisor wires the SubscriptionRef and event\n// stream in; this surface does the rest.\n//\n// Architecture §11 + distilled/21-tui:\n//   - One mount per process (the engine cycle re-runs many times;\n//     mount survives).\n//   - No engine handle is captured here — only the SubscriptionRef +\n//     event Stream + command publisher.\n//   - Mode selection follows `mode-detect.ts`: explicit > TTY-detect.\n//\n// This file deliberately does NOT import `ink` at the top level so\n// non-TTY users (CI, scripts) don't pay the ink import cost. The ink\n// renderer is lazy-imported behind the `ink` mode branch via the\n// adjacent `mount-ink.tsx` helper (which owns the JSX).\n\nimport { Effect, Stream, SubscriptionRef } from 'effect';\n\nimport type { Renderer } from '../../contracts/renderer.ts';\nimport type { EngineCommand, EngineEvent } from '../../substrate/events.ts';\nimport type { SubscribableState } from '../../substrate/projection.ts';\nimport { mountFailed } from './errors.ts';\nimport { type RendererMode, detectMode } from './mode-detect.ts';\nimport { makePlainRenderer } from './plain-renderer.ts';\n\nexport interface TuiSurfaceOptions {\n\t/** Explicit mode override. `undefined` → auto-detect via stdout. */\n\treadonly mode?: RendererMode;\n\t/** Command publisher — every keypress turns into a typed\n\t *  `EngineCommand` invoked here. Required for `ink` mode; ignored\n\t *  for `plain` / `silent` (those modes are pure consumers). */\n\treadonly publishCommand?: (command: EngineCommand) => void;\n}\n\n/**\n * Build the TUI renderer. The returned `Renderer` is the contract the\n * supervisor mounts (once per process); the supervisor passes the\n * SubscriptionRef + event Stream into `renderer.mount`.\n *\n * Mode selection:\n *   - `options.mode === 'silent'` → no-op renderer (no output).\n *   - `options.mode === 'plain'`  → structured stderr lines.\n *   - `options.mode === 'ink'`    → live Ink dashboard.\n *   - `undefined`                 → `detectMode()` (TTY → ink else plain).\n */\nexport const makeTuiSurface = (options: TuiSurfaceOptions = {}): Renderer => {\n\tconst mode = detectMode(options.mode);\n\tswitch (mode) {\n\t\tcase 'silent':\n\t\t\treturn makeSilentRenderer();\n\t\tcase 'plain':\n\t\t\treturn makePlainRenderer();\n\t\tcase 'ink':\n\t\t\treturn makeInkRenderer({\n\t\t\t\tpublishCommand:\n\t\t\t\t\toptions.publishCommand ??\n\t\t\t\t\t(() => {\n\t\t\t\t\t\t/* no publisher wired → keypresses are silently dropped.\n\t\t\t\t\t\t * The CLI/supervisor wiring is expected to provide one;\n\t\t\t\t\t\t * we don't fail-fast on missing publisher so headless\n\t\t\t\t\t\t * test mounts work. */\n\t\t\t\t\t}),\n\t\t\t});\n\t\tdefault: {\n\t\t\tconst _exhaustive: never = mode;\n\t\t\tvoid _exhaustive;\n\t\t\treturn makeSilentRenderer();\n\t\t}\n\t}\n};\n\n// -----------------------------------------------------------------------------\n// Silent renderer\n// -----------------------------------------------------------------------------\n\nconst makeSilentRenderer = (): Renderer => ({\n\tmount: (stateRef, events) =>\n\t\t// Drain the event stream so back-pressure doesn't accumulate;\n\t\t// emit nothing. Keep the SubscriptionRef alive (no-op read).\n\t\tEffect.gen(function* () {\n\t\t\tyield* SubscriptionRef.get(stateRef);\n\t\t\tyield* Stream.runDrain(events);\n\t\t}).pipe(\n\t\t\tEffect.catch((cause: unknown) =>\n\t\t\t\tEffect.fail(mountFailed(cause instanceof Error ? cause.message : String(cause))),\n\t\t\t),\n\t\t),\n\tflush: Effect.void,\n});\n\n// -----------------------------------------------------------------------------\n// Ink renderer (lazy-loaded; depends on `ink` + `react`)\n// -----------------------------------------------------------------------------\n\ninterface InkRendererOptions {\n\treadonly publishCommand: (command: EngineCommand) => void;\n}\n\nconst makeInkRenderer = (options: InkRendererOptions): Renderer => ({\n\tmount: (stateRef, events) =>\n\t\tEffect.gen(function* () {\n\t\t\t// Lazy-import the JSX mount helper. The dynamic import\n\t\t\t// keeps the static graph thin for non-TTY callers.\n\t\t\tconst { mountInkApp } = yield* Effect.tryPromise({\n\t\t\t\ttry: () => import('./mount-ink.tsx'),\n\t\t\t\tcatch: (cause) =>\n\t\t\t\t\tmountFailed(\n\t\t\t\t\t\t`ink lazy import failed: ${cause instanceof Error ? cause.message : String(cause)}`,\n\t\t\t\t\t),\n\t\t\t});\n\n\t\t\tyield* mountInkApp({\n\t\t\t\tstateRef,\n\t\t\t\tevents,\n\t\t\t\tpublishCommand: options.publishCommand,\n\t\t\t});\n\t\t}),\n\tflush: Effect.void,\n});\n\n// -----------------------------------------------------------------------------\n// Public exports\n// -----------------------------------------------------------------------------\n\nexport type { Renderer } from '../../contracts/renderer.ts';\nexport type { RendererMode } from './mode-detect.ts';\nexport { detectMode, resolveMode } from './mode-detect.ts';\nexport { deriveDisplayCells } from './display-derivation.ts';\nexport { formatEventLine, formatHeartbeat } from './plain-renderer.ts';\nexport type { EngineCommand, EngineEvent, SubscribableState };\n"],"mappings":";;;;;;;;;;;;;;;;;AAgDA,MAAa,kBAAkB,UAA6B,EAAE,KAAe;AAE5E,SADa,WAAW,QAAQ,KACpB,EAAZ;EACC,KAAK,SACJ,QAAO,oBAAoB;EAC5B,KAAK,QACJ,QAAO,mBAAmB;EAC3B,KAAK,MACJ,QAAO,gBAAgB,EACtB,gBACC,QAAQ,yBACD,KAMR,CAAC;EACH,QAGC,QAAO,oBAAoB;;;AAS9B,MAAM,4BAAsC;CAC3C,QAAQ,UAAU,WAGjB,OAAO,IAAI,aAAa;AACvB,SAAO,gBAAgB,IAAI,SAAS;AACpC,SAAO,OAAO,SAAS,OAAO;GAC7B,CAAC,KACF,OAAO,OAAO,UACb,OAAO,KAAK,YAAY,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM,CAAC,CAAC,CAChF,CACD;CACF,OAAO,OAAO;CACd;AAUD,MAAM,mBAAmB,aAA2C;CACnE,QAAQ,UAAU,WACjB,OAAO,IAAI,aAAa;EAGvB,MAAM,EAAE,gBAAgB,OAAO,OAAO,WAAW;GAChD,WAAW,OAAO;GAClB,QAAQ,UACP,YACC,2BAA2B,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM,GACjF;GACF,CAAC;AAEF,SAAO,YAAY;GAClB;GACA;GACA,gBAAgB,QAAQ;GACxB,CAAC;GACD;CACH,OAAO,OAAO;CACd"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../src/surfaces/tui/index.ts"],"sourcesContent":["// TUI surface entry point.\n//\n// Selects the renderer mode (ink / plain / silent), returns a\n// `Renderer`-contract-satisfying value the supervisor can mount once\n// per process. The supervisor wires the SubscriptionRef and event\n// stream in; this surface does the rest.\n//\n// Architecture §11 + distilled/21-tui:\n//   - One mount per process (the engine cycle re-runs many times;\n//     mount survives).\n//   - No engine handle is captured here — only the SubscriptionRef +\n//     event Stream + command publisher.\n//   - Mode selection follows `mode-detect.ts`: explicit > TTY-detect.\n//\n// This file deliberately does NOT import `ink` at the top level so\n// non-TTY users (CI, scripts) don't pay the ink import cost. The ink\n// renderer is lazy-imported behind the `ink` mode branch via the\n// adjacent `mount-ink.tsx` helper (which owns the JSX).\n\nimport { Effect, Stream, SubscriptionRef } from 'effect';\n\nimport type { Renderer } from '../../contracts/renderer.ts';\nimport type { EngineCommand, EngineEvent } from '../../substrate/events.ts';\nimport type { SubscribableState } from '../../substrate/projection.ts';\nimport { mountFailed } from './errors.ts';\nimport { type RendererMode, detectMode } from './mode-detect.ts';\nimport { makePlainRenderer } from './plain-renderer.ts';\n\nexport interface TuiSurfaceOptions {\n\t/** Explicit mode override. `undefined` → auto-detect via stdout. */\n\treadonly mode?: RendererMode;\n\t/** Command publisher — every keypress turns into a typed\n\t *  `EngineCommand` invoked here. Required for `ink` mode; ignored\n\t *  for `plain` / `silent` (those modes are pure consumers). */\n\treadonly publishCommand?: (command: EngineCommand) => void;\n\t/** Plain-mode quiet filter — emit only readiness/endpoint/codegen\n\t *  milestones + warnings/errors instead of every event. Ignored for\n\t *  `ink` / `silent`. See {@link makePlainRenderer}. */\n\treadonly quiet?: boolean;\n}\n\n/**\n * Build the TUI renderer. The returned `Renderer` is the contract the\n * supervisor mounts (once per process); the supervisor passes the\n * SubscriptionRef + event Stream into `renderer.mount`.\n *\n * Mode selection:\n *   - `options.mode === 'silent'` → no-op renderer (no output).\n *   - `options.mode === 'plain'`  → structured stderr lines.\n *   - `options.mode === 'ink'`    → live Ink dashboard.\n *   - `undefined`                 → `detectMode()` (TTY → ink else plain).\n */\nexport const makeTuiSurface = (options: TuiSurfaceOptions = {}): Renderer => {\n\tconst mode = detectMode(options.mode);\n\tswitch (mode) {\n\t\tcase 'silent':\n\t\t\treturn makeSilentRenderer();\n\t\tcase 'plain':\n\t\t\treturn makePlainRenderer({ quiet: options.quiet });\n\t\tcase 'ink':\n\t\t\treturn makeInkRenderer({\n\t\t\t\tpublishCommand:\n\t\t\t\t\toptions.publishCommand ??\n\t\t\t\t\t(() => {\n\t\t\t\t\t\t/* no publisher wired → keypresses are silently dropped.\n\t\t\t\t\t\t * The CLI/supervisor wiring is expected to provide one;\n\t\t\t\t\t\t * we don't fail-fast on missing publisher so headless\n\t\t\t\t\t\t * test mounts work. */\n\t\t\t\t\t}),\n\t\t\t});\n\t\tdefault: {\n\t\t\tconst _exhaustive: never = mode;\n\t\t\tvoid _exhaustive;\n\t\t\treturn makeSilentRenderer();\n\t\t}\n\t}\n};\n\n// -----------------------------------------------------------------------------\n// Silent renderer\n// -----------------------------------------------------------------------------\n\nconst makeSilentRenderer = (): Renderer => ({\n\tmount: (stateRef, events) =>\n\t\t// Drain the event stream so back-pressure doesn't accumulate;\n\t\t// emit nothing. Keep the SubscriptionRef alive (no-op read).\n\t\tEffect.gen(function* () {\n\t\t\tyield* SubscriptionRef.get(stateRef);\n\t\t\tyield* Stream.runDrain(events);\n\t\t}).pipe(\n\t\t\tEffect.catch((cause: unknown) =>\n\t\t\t\tEffect.fail(mountFailed(cause instanceof Error ? cause.message : String(cause))),\n\t\t\t),\n\t\t),\n\tflush: Effect.void,\n});\n\n// -----------------------------------------------------------------------------\n// Ink renderer (lazy-loaded; depends on `ink` + `react`)\n// -----------------------------------------------------------------------------\n\ninterface InkRendererOptions {\n\treadonly publishCommand: (command: EngineCommand) => void;\n}\n\nconst makeInkRenderer = (options: InkRendererOptions): Renderer => ({\n\tmount: (stateRef, events) =>\n\t\tEffect.gen(function* () {\n\t\t\t// Lazy-import the JSX mount helper. The dynamic import\n\t\t\t// keeps the static graph thin for non-TTY callers.\n\t\t\tconst { mountInkApp } = yield* Effect.tryPromise({\n\t\t\t\ttry: () => import('./mount-ink.tsx'),\n\t\t\t\tcatch: (cause) =>\n\t\t\t\t\tmountFailed(\n\t\t\t\t\t\t`ink lazy import failed: ${cause instanceof Error ? cause.message : String(cause)}`,\n\t\t\t\t\t),\n\t\t\t});\n\n\t\t\tyield* mountInkApp({\n\t\t\t\tstateRef,\n\t\t\t\tevents,\n\t\t\t\tpublishCommand: options.publishCommand,\n\t\t\t});\n\t\t}),\n\tflush: Effect.void,\n});\n\n// -----------------------------------------------------------------------------\n// Public exports\n// -----------------------------------------------------------------------------\n\nexport type { Renderer } from '../../contracts/renderer.ts';\nexport type { RendererMode } from './mode-detect.ts';\nexport { detectMode, resolveMode } from './mode-detect.ts';\nexport { deriveDisplayCells } from './display-derivation.ts';\nexport { formatEventLine, formatHeartbeat } from './plain-renderer.ts';\nexport type { EngineCommand, EngineEvent, SubscribableState };\n"],"mappings":";;;;;;;;;;;;;;;;;AAoDA,MAAa,kBAAkB,UAA6B,CAAC,MAAgB;CAE5E,QADa,WAAW,QAAQ,IACrB,GAAX;EACC,KAAK,UACJ,OAAO,mBAAmB;EAC3B,KAAK,SACJ,OAAO,kBAAkB,EAAE,OAAO,QAAQ,MAAM,CAAC;EAClD,KAAK,OACJ,OAAO,gBAAgB,EACtB,gBACC,QAAQ,yBACD,CAKP,GACF,CAAC;EACF,SAGC,OAAO,mBAAmB;CAE5B;AACD;AAMA,MAAM,4BAAsC;CAC3C,QAAQ,UAAU,WAGjB,OAAO,IAAI,aAAa;EACvB,OAAO,gBAAgB,IAAI,QAAQ;EACnC,OAAO,OAAO,SAAS,MAAM;CAC9B,CAAC,CAAC,CAAC,KACF,OAAO,OAAO,UACb,OAAO,KAAK,YAAY,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CAAC,CAAC,CAChF,CACD;CACD,OAAO,OAAO;AACf;AAUA,MAAM,mBAAmB,aAA2C;CACnE,QAAQ,UAAU,WACjB,OAAO,IAAI,aAAa;EAGvB,MAAM,EAAE,gBAAgB,OAAO,OAAO,WAAW;GAChD,WAAW,OAAO;GAClB,QAAQ,UACP,YACC,2BAA2B,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,GACjF;EACF,CAAC;EAED,OAAO,YAAY;GAClB;GACA;GACA,gBAAgB,QAAQ;EACzB,CAAC;CACF,CAAC;CACF,OAAO,OAAO;AACf"}

package/dist/surfaces/tui/input.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"input.mjs","names":[],"sources":["../../../src/surfaces/tui/input.tsx"],"sourcesContent":["// Keyboard input handler.\n//\n// HARD INVARIANT (distilled/21-tui § Learnings #3): keypress handlers\n// MUST NOT call engine methods directly. They publish typed\n// `EngineCommand` values onto a `CommandPublisher` callback the\n// surface receives at mount time. The engine consumes the channel on\n// the other end; the renderer has no awareness of supervisor\n// internals like Deferred / Queue / scope structure.\n//\n// Key map (architecture §11 + distilled/21-tui §Responsibilities):\n//\n//   q | Q                  -> 'shutdown.requested'\n//   r | R                  -> 'stack.restart'\n//   ctrl-c                 -> first press 'shutdown.requested'; repeat\n//                             press escalates to\n//                             'shutdown.hardKillRequested'. Ink handles\n//                             Ctrl-C in-process when `exitOnCtrlC:\n//                             false`, so this mirrors the process-level\n//                             signal handler for TTY users.\n//   s | S                  -> open snapshot-name prompt\n//\n// Defensive: useInput is mounted at the dashboard root level, NOT in\n// per-row components, so a re-rendered row never re-registers a\n// handler.\n\nimport { useInput } from 'ink';\nimport { useRef } from 'react';\n\nimport type { EngineCommand } from '../../substrate/events.ts';\n\n/**\n * Command publisher. A pure callback the renderer invokes with a\n * typed `EngineCommand`. The surface layer wires this to whatever\n * channel the engine is consuming on (Effect Queue, EventEmitter,\n * etc.); the renderer doesn't care.\n */\nexport type CommandPublisher = (command: EngineCommand) => void;\n\nexport interface InputHandlerProps {\n\t/** Publish a typed EngineCommand. */\n\treadonly publish: CommandPublisher;\n\t/** `null` means normal keymap mode; string means snapshot-name prompt mode. */\n\treadonly snapshotPromptValue: string | null;\n\t/** Update the snapshot prompt. Pass `null` to close it. */\n\treadonly onSnapshotPromptChange: (value: string | null) => void;\n\t/** Disable input handling (e.g. shutting-down state); defaults\n\t *  to false. */\n\treadonly disabled?: boolean;\n}\n\nexport interface CommandForKeyOptions {\n\treadonly shutdownAlreadyRequested?: boolean;\n\treadonly now?: () => number;\n}\n\nexport interface InputActionForKeyOptions extends CommandForKeyOptions {\n\treadonly snapshotPromptValue?: string | null;\n}\n\ninterface KeyFlags {\n\treadonly ctrl?: boolean;\n\treadonly return?: boolean;\n\treadonly escape?: boolean;\n\treadonly backspace?: boolean;\n\treadonly delete?: boolean;\n}\n\nexport type InputAction =\n\t| { readonly tag: 'publish'; readonly command: EngineCommand }\n\t| { readonly tag: 'snapshotPrompt.open' }\n\t| { readonly tag: 'snapshotPrompt.update'; readonly value: string }\n\t| { readonly tag: 'snapshotPrompt.cancel' };\n\nconst MAX_SNAPSHOT_NAME_LENGTH = 128;\n\nconst isPrintableSnapshotNameCharacter = (character: string): boolean => {\n\tconst codePoint = character.codePointAt(0);\n\treturn codePoint !== undefined && codePoint >= 0x20 && codePoint !== 0x7f;\n};\n\nconst printableSnapshotNameInput = (input: string): string =>\n\tArray.from(input)\n\t\t.filter(isPrintableSnapshotNameCharacter)\n\t\t.join('')\n\t\t.slice(0, MAX_SNAPSHOT_NAME_LENGTH);\n\n/**\n * Renderless component — mounts `useInput` at the dashboard root.\n * Returns `null` so it composes inside layout boxes without taking\n * up space.\n */\nexport const commandForKey = (\n\tinput: string,\n\tctrl: boolean,\n\toptions: CommandForKeyOptions = {},\n): EngineCommand | null => {\n\tif (ctrl && input === 'c') {\n\t\tif (options.shutdownAlreadyRequested === true) {\n\t\t\treturn {\n\t\t\t\ttag: 'shutdown.hardKillRequested',\n\t\t\t\tsignal: 'SIGINT',\n\t\t\t\texitCode: 130,\n\t\t\t\tat: options.now?.() ?? Date.now(),\n\t\t\t};\n\t\t}\n\t\treturn { tag: 'shutdown.requested' };\n\t}\n\tswitch (input) {\n\t\tcase 'q':\n\t\tcase 'Q':\n\t\t\treturn { tag: 'shutdown.requested' };\n\t\tcase 'r':\n\t\tcase 'R':\n\t\t\treturn { tag: 'stack.restart' };\n\t\tdefault:\n\t\t\treturn null;\n\t}\n};\n\nexport const inputActionForKey = (\n\tinput: string,\n\tkey: KeyFlags,\n\toptions: InputActionForKeyOptions = {},\n): InputAction | null => {\n\tif (options.snapshotPromptValue !== null && options.snapshotPromptValue !== undefined) {\n\t\tif (key.ctrl === true && input === 'c') {\n\t\t\tconst command = commandForKey(input, true, options);\n\t\t\treturn command === null ? null : { tag: 'publish', command };\n\t\t}\n\t\tif (key.escape === true) return { tag: 'snapshotPrompt.cancel' };\n\t\tif (key.return === true) {\n\t\t\tconst name = options.snapshotPromptValue.trim();\n\t\t\treturn {\n\t\t\t\ttag: 'publish',\n\t\t\t\tcommand:\n\t\t\t\t\tname.length === 0 ? { tag: 'snapshot.capture' } : { tag: 'snapshot.capture', name },\n\t\t\t};\n\t\t}\n\t\tif (key.backspace === true || key.delete === true) {\n\t\t\treturn {\n\t\t\t\ttag: 'snapshotPrompt.update',\n\t\t\t\tvalue: options.snapshotPromptValue.slice(0, -1),\n\t\t\t};\n\t\t}\n\t\tif (key.ctrl === true) return null;\n\t\tconst printable = printableSnapshotNameInput(input);\n\t\tif (printable.length === 0) return null;\n\t\treturn {\n\t\t\ttag: 'snapshotPrompt.update',\n\t\t\tvalue: `${options.snapshotPromptValue}${printable}`.slice(0, MAX_SNAPSHOT_NAME_LENGTH),\n\t\t};\n\t}\n\n\tif (input === 's' || input === 'S') return { tag: 'snapshotPrompt.open' };\n\tconst command = commandForKey(input, key.ctrl === true, options);\n\treturn command === null ? null : { tag: 'publish', command };\n};\n\nexport const InputHandler = ({\n\tpublish,\n\tsnapshotPromptValue,\n\tonSnapshotPromptChange,\n\tdisabled = false,\n}: InputHandlerProps): null => {\n\tconst shutdownRequested = useRef(false);\n\tuseInput(\n\t\t(input, key) => {\n\t\t\tif (disabled) return;\n\t\t\tconst action = inputActionForKey(input, key, {\n\t\t\t\tsnapshotPromptValue,\n\t\t\t\tshutdownAlreadyRequested: shutdownRequested.current,\n\t\t\t});\n\t\t\tswitch (action?.tag) {\n\t\t\t\tcase 'publish': {\n\t\t\t\t\tconst { command } = action;\n\t\t\t\t\tif (\n\t\t\t\t\t\tcommand.tag === 'shutdown.requested' ||\n\t\t\t\t\t\tcommand.tag === 'shutdown.hardKillRequested'\n\t\t\t\t\t) {\n\t\t\t\t\t\tonSnapshotPromptChange(null);\n\t\t\t\t\t\tshutdownRequested.current = true;\n\t\t\t\t\t}\n\t\t\t\t\tif (command.tag === 'snapshot.capture') {\n\t\t\t\t\t\tonSnapshotPromptChange(null);\n\t\t\t\t\t}\n\t\t\t\t\tpublish(command);\n\t\t\t\t\tbreak;\n\t\t\t\t}\n\t\t\t\tcase 'snapshotPrompt.open':\n\t\t\t\t\tonSnapshotPromptChange('');\n\t\t\t\t\tbreak;\n\t\t\t\tcase 'snapshotPrompt.update':\n\t\t\t\t\tonSnapshotPromptChange(action.value);\n\t\t\t\t\tbreak;\n\t\t\t\tcase 'snapshotPrompt.cancel':\n\t\t\t\t\tonSnapshotPromptChange(null);\n\t\t\t\t\tbreak;\n\t\t\t\tdefault:\n\t\t\t\t\tbreak;\n\t\t\t}\n\t\t},\n\t\t{ isActive: !disabled },\n\t);\n\treturn null;\n};\n"],"mappings":";;;AAyEA,MAAM,2BAA2B;AAEjC,MAAM,oCAAoC,cAA+B;CACxE,MAAM,YAAY,UAAU,YAAY,EAAE;AAC1C,QAAO,cAAc,KAAA,KAAa,aAAa,MAAQ,cAAc;;AAGtE,MAAM,8BAA8B,UACnC,MAAM,KAAK,MAAM,CACf,OAAO,iCAAiC,CACxC,KAAK,GAAG,CACR,MAAM,GAAG,yBAAyB;;;;;;AAOrC,MAAa,iBACZ,OACA,MACA,UAAgC,EAAE,KACR;AAC1B,KAAI,QAAQ,UAAU,KAAK;AAC1B,MAAI,QAAQ,6BAA6B,KACxC,QAAO;GACN,KAAK;GACL,QAAQ;GACR,UAAU;GACV,IAAI,QAAQ,OAAO,IAAI,KAAK,KAAK;GACjC;AAEF,SAAO,EAAE,KAAK,sBAAsB;;AAErC,SAAQ,OAAR;EACC,KAAK;EACL,KAAK,IACJ,QAAO,EAAE,KAAK,sBAAsB;EACrC,KAAK;EACL,KAAK,IACJ,QAAO,EAAE,KAAK,iBAAiB;EAChC,QACC,QAAO;;;AAIV,MAAa,qBACZ,OACA,KACA,UAAoC,EAAE,KACd;AACxB,KAAI,QAAQ,wBAAwB,QAAQ,QAAQ,wBAAwB,KAAA,GAAW;AACtF,MAAI,IAAI,SAAS,QAAQ,UAAU,KAAK;GACvC,MAAM,UAAU,cAAc,OAAO,MAAM,QAAQ;AACnD,UAAO,YAAY,OAAO,OAAO;IAAE,KAAK;IAAW;IAAS;;AAE7D,MAAI,IAAI,WAAW,KAAM,QAAO,EAAE,KAAK,yBAAyB;AAChE,MAAI,IAAI,WAAW,MAAM;GACxB,MAAM,OAAO,QAAQ,oBAAoB,MAAM;AAC/C,UAAO;IACN,KAAK;IACL,SACC,KAAK,WAAW,IAAI,EAAE,KAAK,oBAAoB,GAAG;KAAE,KAAK;KAAoB;KAAM;IACpF;;AAEF,MAAI,IAAI,cAAc,QAAQ,IAAI,WAAW,KAC5C,QAAO;GACN,KAAK;GACL,OAAO,QAAQ,oBAAoB,MAAM,GAAG,GAAG;GAC/C;AAEF,MAAI,IAAI,SAAS,KAAM,QAAO;EAC9B,MAAM,YAAY,2BAA2B,MAAM;AACnD,MAAI,UAAU,WAAW,EAAG,QAAO;AACnC,SAAO;GACN,KAAK;GACL,OAAO,GAAG,QAAQ,sBAAsB,YAAY,MAAM,GAAG,yBAAyB;GACtF;;AAGF,KAAI,UAAU,OAAO,UAAU,IAAK,QAAO,EAAE,KAAK,uBAAuB;CACzE,MAAM,UAAU,cAAc,OAAO,IAAI,SAAS,MAAM,QAAQ;AAChE,QAAO,YAAY,OAAO,OAAO;EAAE,KAAK;EAAW;EAAS;;AAG7D,MAAa,gBAAgB,EAC5B,SACA,qBACA,wBACA,WAAW,YACmB;CAC9B,MAAM,oBAAoB,OAAO,MAAM;AACvC,WACE,OAAO,QAAQ;AACf,MAAI,SAAU;EACd,MAAM,SAAS,kBAAkB,OAAO,KAAK;GAC5C;GACA,0BAA0B,kBAAkB;GAC5C,CAAC;AACF,UAAQ,QAAQ,KAAhB;GACC,KAAK,WAAW;IACf,MAAM,EAAE,YAAY;AACpB,QACC,QAAQ,QAAQ,wBAChB,QAAQ,QAAQ,8BACf;AACD,4BAAuB,KAAK;AAC5B,uBAAkB,UAAU;;AAE7B,QAAI,QAAQ,QAAQ,mBACnB,wBAAuB,KAAK;AAE7B,YAAQ,QAAQ;AAChB;;GAED,KAAK;AACJ,2BAAuB,GAAG;AAC1B;GACD,KAAK;AACJ,2BAAuB,OAAO,MAAM;AACpC;GACD,KAAK;AACJ,2BAAuB,KAAK;AAC5B;GACD,QACC;;IAGH,EAAE,UAAU,CAAC,UAAU,CACvB;AACD,QAAO"}
+{"version":3,"file":"input.mjs","names":[],"sources":["../../../src/surfaces/tui/input.tsx"],"sourcesContent":["// Keyboard input handler.\n//\n// HARD INVARIANT (distilled/21-tui § Learnings #3): keypress handlers\n// MUST NOT call engine methods directly. They publish typed\n// `EngineCommand` values onto a `CommandPublisher` callback the\n// surface receives at mount time. The engine consumes the channel on\n// the other end; the renderer has no awareness of supervisor\n// internals like Deferred / Queue / scope structure.\n//\n// Key map (architecture §11 + distilled/21-tui §Responsibilities):\n//\n//   q | Q                  -> 'shutdown.requested'\n//   r | R                  -> 'stack.restart'\n//   ctrl-c                 -> first press 'shutdown.requested'; repeat\n//                             press escalates to\n//                             'shutdown.hardKillRequested'. Ink handles\n//                             Ctrl-C in-process when `exitOnCtrlC:\n//                             false`, so this mirrors the process-level\n//                             signal handler for TTY users.\n//   s | S                  -> open snapshot-name prompt\n//\n// Defensive: useInput is mounted at the dashboard root level, NOT in\n// per-row components, so a re-rendered row never re-registers a\n// handler.\n\nimport { useInput } from 'ink';\nimport { useRef } from 'react';\n\nimport type { EngineCommand } from '../../substrate/events.ts';\n\n/**\n * Command publisher. A pure callback the renderer invokes with a\n * typed `EngineCommand`. The surface layer wires this to whatever\n * channel the engine is consuming on (Effect Queue, EventEmitter,\n * etc.); the renderer doesn't care.\n */\nexport type CommandPublisher = (command: EngineCommand) => void;\n\nexport interface InputHandlerProps {\n\t/** Publish a typed EngineCommand. */\n\treadonly publish: CommandPublisher;\n\t/** `null` means normal keymap mode; string means snapshot-name prompt mode. */\n\treadonly snapshotPromptValue: string | null;\n\t/** Update the snapshot prompt. Pass `null` to close it. */\n\treadonly onSnapshotPromptChange: (value: string | null) => void;\n\t/** Disable input handling (e.g. shutting-down state); defaults\n\t *  to false. */\n\treadonly disabled?: boolean;\n}\n\nexport interface CommandForKeyOptions {\n\treadonly shutdownAlreadyRequested?: boolean;\n\treadonly now?: () => number;\n}\n\nexport interface InputActionForKeyOptions extends CommandForKeyOptions {\n\treadonly snapshotPromptValue?: string | null;\n}\n\ninterface KeyFlags {\n\treadonly ctrl?: boolean;\n\treadonly return?: boolean;\n\treadonly escape?: boolean;\n\treadonly backspace?: boolean;\n\treadonly delete?: boolean;\n}\n\nexport type InputAction =\n\t| { readonly tag: 'publish'; readonly command: EngineCommand }\n\t| { readonly tag: 'snapshotPrompt.open' }\n\t| { readonly tag: 'snapshotPrompt.update'; readonly value: string }\n\t| { readonly tag: 'snapshotPrompt.cancel' };\n\nconst MAX_SNAPSHOT_NAME_LENGTH = 128;\n\nconst isPrintableSnapshotNameCharacter = (character: string): boolean => {\n\tconst codePoint = character.codePointAt(0);\n\treturn codePoint !== undefined && codePoint >= 0x20 && codePoint !== 0x7f;\n};\n\nconst printableSnapshotNameInput = (input: string): string =>\n\tArray.from(input)\n\t\t.filter(isPrintableSnapshotNameCharacter)\n\t\t.join('')\n\t\t.slice(0, MAX_SNAPSHOT_NAME_LENGTH);\n\n/**\n * Renderless component — mounts `useInput` at the dashboard root.\n * Returns `null` so it composes inside layout boxes without taking\n * up space.\n */\nexport const commandForKey = (\n\tinput: string,\n\tctrl: boolean,\n\toptions: CommandForKeyOptions = {},\n): EngineCommand | null => {\n\tif (ctrl && input === 'c') {\n\t\tif (options.shutdownAlreadyRequested === true) {\n\t\t\treturn {\n\t\t\t\ttag: 'shutdown.hardKillRequested',\n\t\t\t\tsignal: 'SIGINT',\n\t\t\t\texitCode: 130,\n\t\t\t\tat: options.now?.() ?? Date.now(),\n\t\t\t};\n\t\t}\n\t\treturn { tag: 'shutdown.requested' };\n\t}\n\tswitch (input) {\n\t\tcase 'q':\n\t\tcase 'Q':\n\t\t\treturn { tag: 'shutdown.requested' };\n\t\tcase 'r':\n\t\tcase 'R':\n\t\t\treturn { tag: 'stack.restart' };\n\t\tdefault:\n\t\t\treturn null;\n\t}\n};\n\nexport const inputActionForKey = (\n\tinput: string,\n\tkey: KeyFlags,\n\toptions: InputActionForKeyOptions = {},\n): InputAction | null => {\n\tif (options.snapshotPromptValue !== null && options.snapshotPromptValue !== undefined) {\n\t\tif (key.ctrl === true && input === 'c') {\n\t\t\tconst command = commandForKey(input, true, options);\n\t\t\treturn command === null ? null : { tag: 'publish', command };\n\t\t}\n\t\tif (key.escape === true) return { tag: 'snapshotPrompt.cancel' };\n\t\tif (key.return === true) {\n\t\t\tconst name = options.snapshotPromptValue.trim();\n\t\t\treturn {\n\t\t\t\ttag: 'publish',\n\t\t\t\tcommand:\n\t\t\t\t\tname.length === 0 ? { tag: 'snapshot.capture' } : { tag: 'snapshot.capture', name },\n\t\t\t};\n\t\t}\n\t\tif (key.backspace === true || key.delete === true) {\n\t\t\treturn {\n\t\t\t\ttag: 'snapshotPrompt.update',\n\t\t\t\tvalue: options.snapshotPromptValue.slice(0, -1),\n\t\t\t};\n\t\t}\n\t\tif (key.ctrl === true) return null;\n\t\tconst printable = printableSnapshotNameInput(input);\n\t\tif (printable.length === 0) return null;\n\t\treturn {\n\t\t\ttag: 'snapshotPrompt.update',\n\t\t\tvalue: `${options.snapshotPromptValue}${printable}`.slice(0, MAX_SNAPSHOT_NAME_LENGTH),\n\t\t};\n\t}\n\n\tif (input === 's' || input === 'S') return { tag: 'snapshotPrompt.open' };\n\tconst command = commandForKey(input, key.ctrl === true, options);\n\treturn command === null ? null : { tag: 'publish', command };\n};\n\nexport const InputHandler = ({\n\tpublish,\n\tsnapshotPromptValue,\n\tonSnapshotPromptChange,\n\tdisabled = false,\n}: InputHandlerProps): null => {\n\tconst shutdownRequested = useRef(false);\n\tuseInput(\n\t\t(input, key) => {\n\t\t\tif (disabled) return;\n\t\t\tconst action = inputActionForKey(input, key, {\n\t\t\t\tsnapshotPromptValue,\n\t\t\t\tshutdownAlreadyRequested: shutdownRequested.current,\n\t\t\t});\n\t\t\tswitch (action?.tag) {\n\t\t\t\tcase 'publish': {\n\t\t\t\t\tconst { command } = action;\n\t\t\t\t\tif (\n\t\t\t\t\t\tcommand.tag === 'shutdown.requested' ||\n\t\t\t\t\t\tcommand.tag === 'shutdown.hardKillRequested'\n\t\t\t\t\t) {\n\t\t\t\t\t\tonSnapshotPromptChange(null);\n\t\t\t\t\t\tshutdownRequested.current = true;\n\t\t\t\t\t}\n\t\t\t\t\tif (command.tag === 'snapshot.capture') {\n\t\t\t\t\t\tonSnapshotPromptChange(null);\n\t\t\t\t\t}\n\t\t\t\t\tpublish(command);\n\t\t\t\t\tbreak;\n\t\t\t\t}\n\t\t\t\tcase 'snapshotPrompt.open':\n\t\t\t\t\tonSnapshotPromptChange('');\n\t\t\t\t\tbreak;\n\t\t\t\tcase 'snapshotPrompt.update':\n\t\t\t\t\tonSnapshotPromptChange(action.value);\n\t\t\t\t\tbreak;\n\t\t\t\tcase 'snapshotPrompt.cancel':\n\t\t\t\t\tonSnapshotPromptChange(null);\n\t\t\t\t\tbreak;\n\t\t\t\tdefault:\n\t\t\t\t\tbreak;\n\t\t\t}\n\t\t},\n\t\t{ isActive: !disabled },\n\t);\n\treturn null;\n};\n"],"mappings":";;;AAyEA,MAAM,2BAA2B;AAEjC,MAAM,oCAAoC,cAA+B;CACxE,MAAM,YAAY,UAAU,YAAY,CAAC;CACzC,OAAO,cAAc,KAAA,KAAa,aAAa,MAAQ,cAAc;AACtE;AAEA,MAAM,8BAA8B,UACnC,MAAM,KAAK,KAAK,CAAC,CACf,OAAO,gCAAgC,CAAC,CACxC,KAAK,EAAE,CAAC,CACR,MAAM,GAAG,wBAAwB;;;;;;AAOpC,MAAa,iBACZ,OACA,MACA,UAAgC,CAAC,MACP;CAC1B,IAAI,QAAQ,UAAU,KAAK;EAC1B,IAAI,QAAQ,6BAA6B,MACxC,OAAO;GACN,KAAK;GACL,QAAQ;GACR,UAAU;GACV,IAAI,QAAQ,MAAM,KAAK,KAAK,IAAI;EACjC;EAED,OAAO,EAAE,KAAK,qBAAqB;CACpC;CACA,QAAQ,OAAR;EACC,KAAK;EACL,KAAK,KACJ,OAAO,EAAE,KAAK,qBAAqB;EACpC,KAAK;EACL,KAAK,KACJ,OAAO,EAAE,KAAK,gBAAgB;EAC/B,SACC,OAAO;CACT;AACD;AAEA,MAAa,qBACZ,OACA,KACA,UAAoC,CAAC,MACb;CACxB,IAAI,QAAQ,wBAAwB,QAAQ,QAAQ,wBAAwB,KAAA,GAAW;EACtF,IAAI,IAAI,SAAS,QAAQ,UAAU,KAAK;GACvC,MAAM,UAAU,cAAc,OAAO,MAAM,OAAO;GAClD,OAAO,YAAY,OAAO,OAAO;IAAE,KAAK;IAAW;GAAQ;EAC5D;EACA,IAAI,IAAI,WAAW,MAAM,OAAO,EAAE,KAAK,wBAAwB;EAC/D,IAAI,IAAI,WAAW,MAAM;GACxB,MAAM,OAAO,QAAQ,oBAAoB,KAAK;GAC9C,OAAO;IACN,KAAK;IACL,SACC,KAAK,WAAW,IAAI,EAAE,KAAK,mBAAmB,IAAI;KAAE,KAAK;KAAoB;IAAK;GACpF;EACD;EACA,IAAI,IAAI,cAAc,QAAQ,IAAI,WAAW,MAC5C,OAAO;GACN,KAAK;GACL,OAAO,QAAQ,oBAAoB,MAAM,GAAG,EAAE;EAC/C;EAED,IAAI,IAAI,SAAS,MAAM,OAAO;EAC9B,MAAM,YAAY,2BAA2B,KAAK;EAClD,IAAI,UAAU,WAAW,GAAG,OAAO;EACnC,OAAO;GACN,KAAK;GACL,OAAO,GAAG,QAAQ,sBAAsB,YAAY,MAAM,GAAG,wBAAwB;EACtF;CACD;CAEA,IAAI,UAAU,OAAO,UAAU,KAAK,OAAO,EAAE,KAAK,sBAAsB;CACxE,MAAM,UAAU,cAAc,OAAO,IAAI,SAAS,MAAM,OAAO;CAC/D,OAAO,YAAY,OAAO,OAAO;EAAE,KAAK;EAAW;CAAQ;AAC5D;AAEA,MAAa,gBAAgB,EAC5B,SACA,qBACA,wBACA,WAAW,YACmB;CAC9B,MAAM,oBAAoB,OAAO,KAAK;CACtC,UACE,OAAO,QAAQ;EACf,IAAI,UAAU;EACd,MAAM,SAAS,kBAAkB,OAAO,KAAK;GAC5C;GACA,0BAA0B,kBAAkB;EAC7C,CAAC;EACD,QAAQ,QAAQ,KAAhB;GACC,KAAK,WAAW;IACf,MAAM,EAAE,YAAY;IACpB,IACC,QAAQ,QAAQ,wBAChB,QAAQ,QAAQ,8BACf;KACD,uBAAuB,IAAI;KAC3B,kBAAkB,UAAU;IAC7B;IACA,IAAI,QAAQ,QAAQ,oBACnB,uBAAuB,IAAI;IAE5B,QAAQ,OAAO;IACf;GACD;GACA,KAAK;IACJ,uBAAuB,EAAE;IACzB;GACD,KAAK;IACJ,uBAAuB,OAAO,KAAK;IACnC;GACD,KAAK;IACJ,uBAAuB,IAAI;IAC3B;GACD,SACC;EACF;CACD,GACA,EAAE,UAAU,CAAC,SAAS,CACvB;CACA,OAAO;AACR"}

package/dist/surfaces/tui/mode-detect.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"mode-detect.mjs","names":[],"sources":["../../../src/surfaces/tui/mode-detect.ts"],"sourcesContent":["// Renderer mode detection.\n//\n// Architecture §11 + distilled/21-tui §Renderers: three renderer\n// variants exist (ink dashboard, plain, silent). Selection rule:\n//\n//   1. Explicit `mode` argument wins (CLI flag or programmable\n//      surface override).\n//   2. Otherwise, auto-resolve by inspecting `process.stdout.isTTY`\n//      (TTY → ink; non-TTY → plain).\n//   3. `silent` is only selected when explicitly requested.\n//\n// NO_COLOR / FORCE_COLOR / TERM=dumb are handled by Ink/upstream —\n// we don't override here (architecture invariant: defer to upstream\n// color conventions).\n//\n// Pure module; the detection ITSELF doesn't run side effects — it\n// reads `process.stdout.isTTY` once at call time but the surface\n// machinery decides when to call it.\n\n/** Closed set of renderer modes. Adding a mode is an architecture\n *  revision (see distilled/21-tui § Renderers). */\nexport type RendererMode = 'ink' | 'plain' | 'silent';\n\nexport interface ModeDetectInput {\n\t/** Explicit override from CLI flag / config / programmable\n\t *  surface. `undefined` → auto-detect. */\n\treadonly requested?: RendererMode;\n\t/** Whether stdout is a TTY. Pass `process.stdout.isTTY` from the\n\t *  caller; we keep this dependency-injectable for testability. */\n\treadonly stdoutIsTty: boolean;\n}\n\n/**\n * Resolve the active renderer mode.\n *\n *   requested      | stdoutIsTty | result\n *   ---------------+-------------+--------\n *   'ink'          |  any        | 'ink'\n *   'plain'        |  any        | 'plain'\n *   'silent'       |  any        | 'silent'\n *   undefined      |  true       | 'ink'\n *   undefined      |  false      | 'plain'\n *\n * Note: the `'ink'` explicit override on a non-TTY is allowed and is\n * the operator's problem (e.g. invoked under a TTY-emulating\n * wrapper). The auto path NEVER picks `'ink'` for a non-TTY.\n */\nexport const resolveMode = (input: ModeDetectInput): RendererMode => {\n\tif (input.requested) return input.requested;\n\treturn input.stdoutIsTty ? 'ink' : 'plain';\n};\n\n/**\n * Detect-from-process convenience for callers that don't need the\n * pure `resolveMode` separation. Reads `process.stdout.isTTY` once.\n */\nexport const detectMode = (requested?: RendererMode): RendererMode =>\n\tresolveMode({\n\t\trequested,\n\t\tstdoutIsTty: Boolean(process.stdout.isTTY),\n\t});\n"],"mappings":";;;;;;;;;;;;;;;;AA+CA,MAAa,eAAe,UAAyC;AACpE,KAAI,MAAM,UAAW,QAAO,MAAM;AAClC,QAAO,MAAM,cAAc,QAAQ;;;;;;AAOpC,MAAa,cAAc,cAC1B,YAAY;CACX;CACA,aAAa,QAAQ,QAAQ,OAAO,MAAM;CAC1C,CAAC"}
+{"version":3,"file":"mode-detect.mjs","names":[],"sources":["../../../src/surfaces/tui/mode-detect.ts"],"sourcesContent":["// Renderer mode detection.\n//\n// Architecture §11 + distilled/21-tui §Renderers: three renderer\n// variants exist (ink dashboard, plain, silent). Selection rule:\n//\n//   1. Explicit `mode` argument wins (CLI flag or programmable\n//      surface override).\n//   2. Otherwise, auto-resolve by inspecting `process.stdout.isTTY`\n//      (TTY → ink; non-TTY → plain).\n//   3. `silent` is only selected when explicitly requested.\n//\n// NO_COLOR / FORCE_COLOR / TERM=dumb are handled by Ink/upstream —\n// we don't override here (architecture invariant: defer to upstream\n// color conventions).\n//\n// Pure module; the detection ITSELF doesn't run side effects — it\n// reads `process.stdout.isTTY` once at call time but the surface\n// machinery decides when to call it.\n\n/** Closed set of renderer modes. Adding a mode is an architecture\n *  revision (see distilled/21-tui § Renderers). */\nexport type RendererMode = 'ink' | 'plain' | 'silent';\n\nexport interface ModeDetectInput {\n\t/** Explicit override from CLI flag / config / programmable\n\t *  surface. `undefined` → auto-detect. */\n\treadonly requested?: RendererMode;\n\t/** Whether stdout is a TTY. Pass `process.stdout.isTTY` from the\n\t *  caller; we keep this dependency-injectable for testability. */\n\treadonly stdoutIsTty: boolean;\n}\n\n/**\n * Resolve the active renderer mode.\n *\n *   requested      | stdoutIsTty | result\n *   ---------------+-------------+--------\n *   'ink'          |  any        | 'ink'\n *   'plain'        |  any        | 'plain'\n *   'silent'       |  any        | 'silent'\n *   undefined      |  true       | 'ink'\n *   undefined      |  false      | 'plain'\n *\n * Note: the `'ink'` explicit override on a non-TTY is allowed and is\n * the operator's problem (e.g. invoked under a TTY-emulating\n * wrapper). The auto path NEVER picks `'ink'` for a non-TTY.\n */\nexport const resolveMode = (input: ModeDetectInput): RendererMode => {\n\tif (input.requested) return input.requested;\n\treturn input.stdoutIsTty ? 'ink' : 'plain';\n};\n\n/**\n * Detect-from-process convenience for callers that don't need the\n * pure `resolveMode` separation. Reads `process.stdout.isTTY` once.\n */\nexport const detectMode = (requested?: RendererMode): RendererMode =>\n\tresolveMode({\n\t\trequested,\n\t\tstdoutIsTty: Boolean(process.stdout.isTTY),\n\t});\n"],"mappings":";;;;;;;;;;;;;;;;AA+CA,MAAa,eAAe,UAAyC;CACpE,IAAI,MAAM,WAAW,OAAO,MAAM;CAClC,OAAO,MAAM,cAAc,QAAQ;AACpC;;;;;AAMA,MAAa,cAAc,cAC1B,YAAY;CACX;CACA,aAAa,QAAQ,QAAQ,OAAO,KAAK;AAC1C,CAAC"}

package/dist/surfaces/tui/mount-ink.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"mount-ink.mjs","names":[],"sources":["../../../src/surfaces/tui/mount-ink.tsx"],"sourcesContent":["// Ink mount helper.\n//\n// Owns the `<App/>` JSX expression so `index.ts` stays a plain `.ts`\n// file (no JSX). Lazy-imported from `index.ts` only when the `ink`\n// mode is selected, so CI / non-TTY callers don't pay the ink+react\n// import cost.\n//\n// The mount itself awaits `instance.waitUntilExit()` so the surface's\n// mount Effect remains open until the user exits the ink app or the\n// supervisor finalizes the scope.\n\nimport { Effect, Scope, Stream, SubscriptionRef } from 'effect';\nimport { render } from 'ink';\n\nimport type { EngineCommand, EngineEvent } from '../../substrate/events.ts';\nimport type { SubscribableState } from '../../substrate/projection.ts';\nimport { App } from './app.tsx';\nimport { mountFailed, type RendererError } from './errors.ts';\n\nexport interface MountInkAppInput {\n\treadonly stateRef: SubscriptionRef.SubscriptionRef<SubscribableState>;\n\treadonly events: Stream.Stream<EngineEvent, never>;\n\treadonly publishCommand: (command: EngineCommand) => void;\n}\n\nexport const INK_RENDER_OPTIONS = {\n\texitOnCtrlC: false,\n\tpatchConsole: true,\n} as const;\n\nexport const mountInkApp = (\n\tinput: MountInkAppInput,\n): Effect.Effect<void, RendererError, Scope.Scope> =>\n\tEffect.gen(function* () {\n\t\tconst instance = yield* Effect.try({\n\t\t\ttry: () =>\n\t\t\t\trender(\n\t\t\t\t\t<App stateRef={input.stateRef} events={input.events} publish={input.publishCommand} />,\n\t\t\t\t\tINK_RENDER_OPTIONS,\n\t\t\t\t),\n\t\t\tcatch: (cause) => mountFailed(cause instanceof Error ? cause.message : String(cause)),\n\t\t});\n\n\t\tyield* Effect.addFinalizer(() =>\n\t\t\tEffect.sync(() => {\n\t\t\t\tinstance.unmount();\n\t\t\t}),\n\t\t);\n\n\t\tyield* Effect.tryPromise({\n\t\t\ttry: () => instance.waitUntilExit(),\n\t\t\tcatch: (cause) =>\n\t\t\t\tmountFailed(\n\t\t\t\t\t`ink waitUntilExit failed: ${cause instanceof Error ? cause.message : String(cause)}`,\n\t\t\t\t),\n\t\t});\n\t});\n"],"mappings":";;;;;;AAyBA,MAAa,qBAAqB;CACjC,aAAa;CACb,cAAc;CACd;AAED,MAAa,eACZ,UAEA,OAAO,IAAI,aAAa;CACvB,MAAM,WAAW,OAAO,OAAO,IAAI;EAClC,WACC,OACC,oBAAC,KAAD;GAAK,UAAU,MAAM;GAAU,QAAQ,MAAM;GAAQ,SAAS,MAAM;GAAkB,CAAA,EACtF,mBACA;EACF,QAAQ,UAAU,YAAY,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM,CAAC;EACrF,CAAC;AAEF,QAAO,OAAO,mBACb,OAAO,WAAW;AACjB,WAAS,SAAS;GACjB,CACF;AAED,QAAO,OAAO,WAAW;EACxB,WAAW,SAAS,eAAe;EACnC,QAAQ,UACP,YACC,6BAA6B,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM,GACnF;EACF,CAAC;EACD"}
+{"version":3,"file":"mount-ink.mjs","names":[],"sources":["../../../src/surfaces/tui/mount-ink.tsx"],"sourcesContent":["// Ink mount helper.\n//\n// Owns the `<App/>` JSX expression so `index.ts` stays a plain `.ts`\n// file (no JSX). Lazy-imported from `index.ts` only when the `ink`\n// mode is selected, so CI / non-TTY callers don't pay the ink+react\n// import cost.\n//\n// The mount itself awaits `instance.waitUntilExit()` so the surface's\n// mount Effect remains open until the user exits the ink app or the\n// supervisor finalizes the scope.\n\nimport { Effect, Scope, Stream, SubscriptionRef } from 'effect';\nimport { render } from 'ink';\n\nimport type { EngineCommand, EngineEvent } from '../../substrate/events.ts';\nimport type { SubscribableState } from '../../substrate/projection.ts';\nimport { App } from './app.tsx';\nimport { mountFailed, type RendererError } from './errors.ts';\n\nexport interface MountInkAppInput {\n\treadonly stateRef: SubscriptionRef.SubscriptionRef<SubscribableState>;\n\treadonly events: Stream.Stream<EngineEvent, never>;\n\treadonly publishCommand: (command: EngineCommand) => void;\n}\n\nexport const INK_RENDER_OPTIONS = {\n\texitOnCtrlC: false,\n\tpatchConsole: true,\n} as const;\n\nexport const mountInkApp = (\n\tinput: MountInkAppInput,\n): Effect.Effect<void, RendererError, Scope.Scope> =>\n\tEffect.gen(function* () {\n\t\tconst instance = yield* Effect.try({\n\t\t\ttry: () =>\n\t\t\t\trender(\n\t\t\t\t\t<App stateRef={input.stateRef} events={input.events} publish={input.publishCommand} />,\n\t\t\t\t\tINK_RENDER_OPTIONS,\n\t\t\t\t),\n\t\t\tcatch: (cause) => mountFailed(cause instanceof Error ? cause.message : String(cause)),\n\t\t});\n\n\t\tyield* Effect.addFinalizer(() =>\n\t\t\tEffect.sync(() => {\n\t\t\t\tinstance.unmount();\n\t\t\t}),\n\t\t);\n\n\t\tyield* Effect.tryPromise({\n\t\t\ttry: () => instance.waitUntilExit(),\n\t\t\tcatch: (cause) =>\n\t\t\t\tmountFailed(\n\t\t\t\t\t`ink waitUntilExit failed: ${cause instanceof Error ? cause.message : String(cause)}`,\n\t\t\t\t),\n\t\t});\n\t});\n"],"mappings":";;;;;;AAyBA,MAAa,qBAAqB;CACjC,aAAa;CACb,cAAc;AACf;AAEA,MAAa,eACZ,UAEA,OAAO,IAAI,aAAa;CACvB,MAAM,WAAW,OAAO,OAAO,IAAI;EAClC,WACC,OACC,oBAAC,KAAD;GAAK,UAAU,MAAM;GAAU,QAAQ,MAAM;GAAQ,SAAS,MAAM;EAAiB,CAAA,GACrF,kBACD;EACD,QAAQ,UAAU,YAAY,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CAAC;CACrF,CAAC;CAED,OAAO,OAAO,mBACb,OAAO,WAAW;EACjB,SAAS,QAAQ;CAClB,CAAC,CACF;CAEA,OAAO,OAAO,WAAW;EACxB,WAAW,SAAS,cAAc;EAClC,QAAQ,UACP,YACC,6BAA6B,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,GACnF;CACF,CAAC;AACF,CAAC"}