@mysten-incubation/devstack 0.0.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"event-log.mjs","names":[],"sources":["../../../src/surfaces/tui/event-log.ts"],"sourcesContent":["import type { EngineEvent } from '../../substrate/events.ts';\nimport { errorSummaryFor, labelForRow, type ColorToken } from './display-derivation.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\nexport const eventLogLineFromEvent = (event: EngineEvent, seq: number): EventLogLine | null => {\n\tconst at = eventAt(event);\n\tconst id = `${at}-${seq}-${event.tag}`;\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: colorForPluginKey(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:\n\t\t\t\t\tevent.error.pluginKey === null ? 'white' : colorForPluginKey(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 'account.updated':\n\t\tcase 'package.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 '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\nconst eventAt = (event: EngineEvent): number => {\n\tif ('at' in event && typeof event.at === 'number') return event.at;\n\tswitch (event.tag) {\n\t\tcase 'endpoint.registered':\n\t\t\treturn event.endpoint.registeredAt;\n\t\tcase 'error.reported':\n\t\t\treturn event.error.at;\n\t\tcase 'build.statusChanged':\n\t\t\treturn event.entry.startedAt;\n\t\tdefault:\n\t\t\treturn Date.now();\n\t}\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\nconst colorForPluginKey = (pluginKey: string): ColorToken => {\n\tconst normalized = pluginKey.toLowerCase();\n\tif (normalized.includes('account')) return 'magenta';\n\tif (normalized.includes('package')) return 'blueBright';\n\tif (normalized.includes('action')) return 'magenta';\n\tif (normalized.includes('app') || normalized.includes('frontend')) return 'white';\n\treturn 'cyan';\n};\n"],"mappings":"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"}

package/dist/surfaces/tui/heartbeat.mjs

@@ -0,0 +1,33 @@
+import { Text } from "ink";
+import { useEffect, useState } from "react";
+import { jsx } from "react/jsx-runtime";
+//#region src/surfaces/tui/heartbeat.tsx
+const FRAMES = [
+	"⠋",
+	"⠙",
+	"⠹",
+	"⠸",
+	"⠼",
+	"⠴",
+	"⠦",
+	"⠧",
+	"⠇",
+	"⠏"
+];
+const Heartbeat = ({ intervalMs = 120, color = "white" }) => {
+	const [frame, setFrame] = useState(0);
+	useEffect(() => {
+		const id = setInterval(() => {
+			setFrame((f) => (f + 1) % FRAMES.length);
+		}, intervalMs);
+		return () => clearInterval(id);
+	}, [intervalMs]);
+	return /* @__PURE__ */ jsx(Text, {
+		color,
+		children: FRAMES[frame]
+	});
+};
+//#endregion
+export { Heartbeat };
+
+//# sourceMappingURL=heartbeat.mjs.map

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

@@ -0,0 +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"}

package/dist/surfaces/tui/index.mjs

@@ -0,0 +1,50 @@
+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
+/**
+* Build the TUI renderer. The returned `Renderer` is the contract the
+* supervisor mounts (once per process); the supervisor passes the
+* SubscriptionRef + event Stream into `renderer.mount`.
+*
+* Mode selection:
+*   - `options.mode === 'silent'` → no-op renderer (no output).
+*   - `options.mode === 'plain'`  → structured stderr lines.
+*   - `options.mode === 'ink'`    → live Ink dashboard.
+*   - `undefined`                 → `detectMode()` (TTY → ink else plain).
+*/
+const makeTuiSurface = (options = {}) => {
+	switch (detectMode(options.mode)) {
+		case "silent": return makeSilentRenderer();
+		case "plain": return makePlainRenderer();
+		case "ink": return makeInkRenderer({ publishCommand: options.publishCommand ?? (() => {}) });
+		default: return makeSilentRenderer();
+	}
+};
+const makeSilentRenderer = () => ({
+	mount: (stateRef, events) => Effect.gen(function* () {
+		yield* SubscriptionRef.get(stateRef);
+		yield* Stream.runDrain(events);
+	}).pipe(Effect.catch((cause) => Effect.fail(mountFailed(cause instanceof Error ? cause.message : String(cause))))),
+	flush: Effect.void
+});
+const makeInkRenderer = (options) => ({
+	mount: (stateRef, events) => Effect.gen(function* () {
+		const { mountInkApp } = yield* Effect.tryPromise({
+			try: () => import("./mount-ink.mjs"),
+			catch: (cause) => mountFailed(`ink lazy import failed: ${cause instanceof Error ? cause.message : String(cause)}`)
+		});
+		yield* mountInkApp({
+			stateRef,
+			events,
+			publishCommand: options.publishCommand
+		});
+	}),
+	flush: Effect.void
+});
+//#endregion
+export { makeTuiSurface };
+
+//# sourceMappingURL=index.mjs.map

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

@@ -0,0 +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"}

package/dist/surfaces/tui/input.mjs

@@ -0,0 +1,104 @@
+import { useInput } from "ink";
+import { useRef } from "react";
+//#region src/surfaces/tui/input.tsx
+const MAX_SNAPSHOT_NAME_LENGTH = 128;
+const printableSnapshotNameInput = (input) => input.replace(/[\u0000-\u001f\u007f]/g, "").slice(0, MAX_SNAPSHOT_NAME_LENGTH);
+/**
+* Renderless component — mounts `useInput` at the dashboard root.
+* Returns `null` so it composes inside layout boxes without taking
+* up space.
+*/
+const commandForKey = (input, ctrl, options = {}) => {
+	if (ctrl && input === "c") {
+		if (options.shutdownAlreadyRequested === true) return {
+			tag: "shutdown.hardKillRequested",
+			signal: "SIGINT",
+			exitCode: 130,
+			at: options.now?.() ?? Date.now()
+		};
+		return { tag: "shutdown.requested" };
+	}
+	switch (input) {
+		case "q":
+		case "Q": return { tag: "shutdown.requested" };
+		case "r":
+		case "R": return { tag: "stack.restart" };
+		default: return null;
+	}
+};
+const inputActionForKey = (input, key, options = {}) => {
+	if (options.snapshotPromptValue !== null && options.snapshotPromptValue !== void 0) {
+		if (key.ctrl === true && input === "c") {
+			const command = commandForKey(input, true, options);
+			return command === null ? null : {
+				tag: "publish",
+				command
+			};
+		}
+		if (key.escape === true) return { tag: "snapshotPrompt.cancel" };
+		if (key.return === true) {
+			const name = options.snapshotPromptValue.trim();
+			return {
+				tag: "publish",
+				command: name.length === 0 ? { tag: "snapshot.capture" } : {
+					tag: "snapshot.capture",
+					name
+				}
+			};
+		}
+		if (key.backspace === true || key.delete === true) return {
+			tag: "snapshotPrompt.update",
+			value: options.snapshotPromptValue.slice(0, -1)
+		};
+		if (key.ctrl === true) return null;
+		const printable = printableSnapshotNameInput(input);
+		if (printable.length === 0) return null;
+		return {
+			tag: "snapshotPrompt.update",
+			value: `${options.snapshotPromptValue}${printable}`.slice(0, MAX_SNAPSHOT_NAME_LENGTH)
+		};
+	}
+	if (input === "s" || input === "S") return { tag: "snapshotPrompt.open" };
+	const command = commandForKey(input, key.ctrl === true, options);
+	return command === null ? null : {
+		tag: "publish",
+		command
+	};
+};
+const InputHandler = ({ publish, snapshotPromptValue, onSnapshotPromptChange, disabled = false }) => {
+	const shutdownRequested = useRef(false);
+	useInput((input, key) => {
+		if (disabled) return;
+		const action = inputActionForKey(input, key, {
+			snapshotPromptValue,
+			shutdownAlreadyRequested: shutdownRequested.current
+		});
+		switch (action?.tag) {
+			case "publish": {
+				const { command } = action;
+				if (command.tag === "shutdown.requested" || command.tag === "shutdown.hardKillRequested") {
+					onSnapshotPromptChange(null);
+					shutdownRequested.current = true;
+				}
+				if (command.tag === "snapshot.capture") onSnapshotPromptChange(null);
+				publish(command);
+				break;
+			}
+			case "snapshotPrompt.open":
+				onSnapshotPromptChange("");
+				break;
+			case "snapshotPrompt.update":
+				onSnapshotPromptChange(action.value);
+				break;
+			case "snapshotPrompt.cancel":
+				onSnapshotPromptChange(null);
+				break;
+			default: break;
+		}
+	}, { isActive: !disabled });
+	return null;
+};
+//#endregion
+export { InputHandler };
+
+//# sourceMappingURL=input.mjs.map

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

@@ -0,0 +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 printableSnapshotNameInput = (input: string): string =>\n\tinput.replace(/[\\u0000-\\u001f\\u007f]/g, '').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,8BAA8B,UACnC,MAAM,QAAQ,0BAA0B,GAAG,CAAC,MAAM,GAAG,yBAAyB;;;;;;AAO/E,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"}

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

@@ -0,0 +1,32 @@
+//#region src/surfaces/tui/mode-detect.ts
+/**
+* Resolve the active renderer mode.
+*
+*   requested      | stdoutIsTty | result
+*   ---------------+-------------+--------
+*   'ink'          |  any        | 'ink'
+*   'plain'        |  any        | 'plain'
+*   'silent'       |  any        | 'silent'
+*   undefined      |  true       | 'ink'
+*   undefined      |  false      | 'plain'
+*
+* Note: the `'ink'` explicit override on a non-TTY is allowed and is
+* the operator's problem (e.g. invoked under a TTY-emulating
+* wrapper). The auto path NEVER picks `'ink'` for a non-TTY.
+*/
+const resolveMode = (input) => {
+	if (input.requested) return input.requested;
+	return input.stdoutIsTty ? "ink" : "plain";
+};
+/**
+* Detect-from-process convenience for callers that don't need the
+* pure `resolveMode` separation. Reads `process.stdout.isTTY` once.
+*/
+const detectMode = (requested) => resolveMode({
+	requested,
+	stdoutIsTty: Boolean(process.stdout.isTTY)
+});
+//#endregion
+export { detectMode, resolveMode };
+
+//# sourceMappingURL=mode-detect.mjs.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,31 @@
+import { mountFailed } from "./errors.mjs";
+import { App } from "./app.mjs";
+import { Effect } from "effect";
+import { render } from "ink";
+import { jsx } from "react/jsx-runtime";
+//#region src/surfaces/tui/mount-ink.tsx
+const INK_RENDER_OPTIONS = {
+	exitOnCtrlC: false,
+	patchConsole: true
+};
+const mountInkApp = (input) => Effect.gen(function* () {
+	const instance = yield* Effect.try({
+		try: () => render(/* @__PURE__ */ jsx(App, {
+			stateRef: input.stateRef,
+			events: input.events,
+			publish: input.publishCommand
+		}), INK_RENDER_OPTIONS),
+		catch: (cause) => mountFailed(cause instanceof Error ? cause.message : String(cause))
+	});
+	yield* Effect.addFinalizer(() => Effect.sync(() => {
+		instance.unmount();
+	}));
+	yield* Effect.tryPromise({
+		try: () => instance.waitUntilExit(),
+		catch: (cause) => mountFailed(`ink waitUntilExit failed: ${cause instanceof Error ? cause.message : String(cause)}`)
+	});
+});
+//#endregion
+export { INK_RENDER_OPTIONS, mountInkApp };
+
+//# sourceMappingURL=mount-ink.mjs.map

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

@@ -0,0 +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"}

package/dist/surfaces/tui/plain-renderer.mjs

@@ -0,0 +1,170 @@
+import { mountFailed } from "./errors.mjs";
+import { accountLine, endpointLine, labelForRow, packageLine, roleLabel, statusLabel } from "./display-derivation.mjs";
+import { Effect, Stream, SubscriptionRef } from "effect";
+//#region src/surfaces/tui/plain-renderer.ts
+/**
+* Plain-renderer line shape (each call returns exactly one line, no
+* trailing newline).
+*
+*   <iso-timestamp> <level> <event-tag> <key>=<value> ...
+*
+* Example:
+*   2026-05-19T20:11:32.001Z INFO lifecycle.statusChanged key=sui from=starting to=ready
+*   2026-05-19T20:11:32.500Z WARN log.appended key=walrus line="failed to bind port 9000"
+*   2026-05-19T20:11:33.000Z INFO endpoint.registered name=aggregator url=http://localhost:9000
+*/
+const formatEventLine = (event) => {
+	const ts = isoTimestamp(eventAt(event));
+	const level = levelForEvent(event);
+	const payload = payloadFor(event);
+	return `${ts} ${level} ${event.tag} ${payload}`;
+};
+/**
+* Build a plain renderer satisfying the `Renderer` contract.
+*
+* Mount subscribes to the live event stream, writes one line per
+* event to stderr. The state-ref is sampled for the initial sweep
+* (one line per declared row) so a renderer attached after boot
+* still sees a coherent baseline.
+*/
+const makePlainRenderer = () => ({
+	mount: (stateRef, events) => Effect.gen(function* () {
+		yield* emitInitialSweep(yield* SubscriptionRef.get(stateRef));
+		yield* events.pipe(Stream.runForEach((event) => writeStderrLine(formatEventLine(event))));
+	}).pipe(Effect.catch((cause) => Effect.fail(mountFailed(cause instanceof Error ? cause.message : String(cause))))),
+	flush: Effect.void.pipe(Effect.catch(() => Effect.fail(mountFailed("flush"))))
+});
+const isoTimestamp = (at) => new Date(at || Date.now()).toISOString();
+const eventAt = (event) => {
+	if ("at" in event && typeof event.at === "number") return event.at;
+	switch (event.tag) {
+		case "endpoint.registered": return event.endpoint.registeredAt;
+		case "error.reported": return event.error.at;
+		case "build.statusChanged": return event.entry.startedAt;
+		default: return Date.now();
+	}
+};
+const levelForEvent = (event) => {
+	switch (event.tag) {
+		case "log.appended": return event.level === "error" ? "ERROR" : event.level === "warn" ? "WARN" : "INFO";
+		case "error.reported": return event.error.severity === "fatal" || event.error.severity === "error" ? "ERROR" : "WARN";
+		default: return "INFO";
+	}
+};
+const payloadFor = (event) => {
+	switch (event.tag) {
+		case "lifecycle.statusChanged": return kv({
+			key: event.pluginKey,
+			from: statusLabel(event.from),
+			to: statusLabel(event.to)
+		});
+		case "lifecycle.phaseSet": return kv({
+			key: event.pluginKey,
+			phase: event.phase ?? ""
+		});
+		case "log.appended": return kv({
+			key: event.pluginKey,
+			line: event.line
+		});
+		case "endpoint.registered": return kv({
+			key: event.endpoint.endpointKey,
+			name: event.endpoint.name,
+			displayUrl: event.endpoint.displayUrl ?? event.endpoint.url,
+			url: event.endpoint.url,
+			wire: event.endpoint.wireProtocol
+		});
+		case "account.updated": return kv({
+			key: event.account.key,
+			row: event.account.rowKey ?? "",
+			name: event.account.name,
+			address: event.account.address ?? "",
+			scheme: event.account.scheme ?? "",
+			source: event.account.source ?? "",
+			funding: event.account.funding.status,
+			fundingEntries: (event.account.funding.entries ?? []).map((entry) => `${entry.coin}:${entry.amount}:${entry.status}`).join(","),
+			requestedMist: event.account.funding.requestedMist ?? "",
+			balanceMist: event.account.funding.balanceMist ?? ""
+		});
+		case "package.updated": return kv({
+			key: event.package.key,
+			row: event.package.rowKey ?? "",
+			name: event.package.name,
+			kind: event.package.kind,
+			packageId: event.package.packageId,
+			upgradeCapId: event.package.upgradeCapId ?? "",
+			mvr: event.package.mvrPlaceholder
+		});
+		case "endpoint.released": return kv({ key: event.endpointKey });
+		case "strategy.registered": return kv({
+			capability: event.capabilityKey,
+			autoMounted: event.autoMounted
+		});
+		case "strategy.unregistered": return kv({ capability: event.capabilityKey });
+		case "manifest.flushed": return kv({ version: event.manifestVersion });
+		case "codegen.emitted": return kv({ files: event.files.length });
+		case "error.reported": return kv({
+			key: event.error.pluginKey ?? "",
+			tag: event.error.tag,
+			summary: event.error.summary,
+			cause: event.error.chain.join(" | "),
+			severity: event.error.severity
+		});
+		case "build.statusChanged": return kv({
+			key: event.entry.pluginKey ?? "",
+			phase: event.entry.phase,
+			progress: event.entry.progress
+		});
+		case "restart.requested":
+		case "restart.completed": return kv({ target: event.target === "stack" ? "stack" : event.target.pluginKey });
+		case "shutdown.escalated": return kv({
+			mode: "hard-kill",
+			signal: event.signal,
+			exitCode: event.exitCode
+		});
+		case "snapshot.captureStarted": return kv({
+			snapshotId: event.snapshotId,
+			name: event.name
+		});
+		case "snapshot.captureProgress": return kv({
+			snapshotId: event.snapshotId,
+			name: event.name,
+			phase: event.phase,
+			detail: event.detail,
+			paused: event.pausedContainers,
+			total: event.totalContainers
+		});
+		case "snapshot.captureSkipped": return kv({ reason: event.reason });
+		case "snapshot.captureFailed": return kv({
+			snapshotId: event.snapshotId,
+			name: event.name,
+			summary: event.summary
+		});
+		case "snapshot.captured":
+		case "snapshot.restored": return kv({ snapshotId: event.snapshotId });
+		default: return "";
+	}
+};
+const kv = (record) => Object.entries(record).filter(([, v]) => v !== "" && v !== null && v !== void 0).map(([k, v]) => `${k}=${quoteIfNeeded(String(v))}`).join(" ");
+const quoteIfNeeded = (s) => /[\s"]/.test(s) ? quote(s) : s;
+const quote = (s) => `"${s.replace(/"/g, "\\\"")}"`;
+const emitInitialSweep = (state) => Effect.gen(function* () {
+	yield* writeStderrLine(`${isoTimestamp(state.cycle.startedAt || Date.now())} INFO stack.identity app=${state.identity.app} stack=${state.identity.stack} network=${state.identity.network} cycle=${state.cycle.id}`);
+	for (const row of state.rows) yield* writeStderrLine(`${isoTimestamp(Date.now())} INFO row.declared ${kv({
+		key: row.key,
+		label: labelForRow(row.key),
+		role: roleLabel(row.role),
+		status: statusLabel(row.status)
+	})}`);
+	for (const endpoint of state.endpoints) yield* writeStderrLine(`${isoTimestamp(endpoint.registeredAt)} INFO endpoint.registered ${endpointLine(endpoint)}`);
+	for (const account of state.accounts) yield* writeStderrLine(`${isoTimestamp(account.updatedAt)} INFO account.updated ${accountLine(account)}`);
+	for (const pkg of state.packages) yield* writeStderrLine(`${isoTimestamp(pkg.updatedAt)} INFO package.updated ${packageLine(pkg)}`);
+});
+const writeStderrLine = (line) => Effect.sync(() => {
+	try {
+		process.stderr.write(`${line}\n`);
+	} catch (err) {}
+});
+//#endregion
+export { formatEventLine, makePlainRenderer };
+
+//# sourceMappingURL=plain-renderer.mjs.map

package/dist/surfaces/tui/plain-renderer.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"plain-renderer.mjs","names":[],"sources":["../../../src/surfaces/tui/plain-renderer.ts"],"sourcesContent":["// Plain (non-TTY) renderer.\n//\n// Architecture §11 + distilled/21-tui §Renderers: when stdout is not\n// a TTY (CI, pipe, log file), the live ink dashboard is replaced by\n// a structured line stream. One line per event; periodic heartbeat\n// per internally-acquiring row, surfaced to operators as \"starting\".\n//\n// Discipline:\n//   - One line per EngineEvent — no batching, no aggregation, no\n//     diffing. Each event maps to exactly one structured line.\n//   - Writes to stderr (architecture invariant: plain renderer goes\n//     to stderr so stdout stays clean for whatever consumes the\n//     pipe).\n//   - EPIPE swallowed (pipe-safety invariant).\n//   - Pure formatting helpers exposed for tests; the Effect-shaped\n//     side is the `mount` function.\n//   - Heartbeat formatting is pure here; scheduling belongs to the\n//     renderer mount path. The architecture says it\n//     \"anchors on first sighting in the internal acquiring state; phase\n//     changes do NOT reset the clock; a late tick emits exactly one\n//     heartbeat (no backlog catch-up)\". The seam is exposed via\n//     `formatHeartbeat`.\n\nimport { Effect, Stream, SubscriptionRef } from 'effect';\n\nimport type { Renderer } from '../../contracts/renderer.ts';\nimport type { EngineEvent } from '../../substrate/events.ts';\nimport type { SubscribableState } from '../../substrate/projection.ts';\nimport {\n\taccountLine,\n\tendpointLine,\n\tlabelForRow,\n\tnarrationFor,\n\tpackageLine,\n\troleLabel,\n\tstatusLabel,\n} from './display-derivation.ts';\nimport { mountFailed } from './errors.ts';\n\n// -----------------------------------------------------------------------------\n// Line shape — pure formatters\n// -----------------------------------------------------------------------------\n\n/**\n * Plain-renderer line shape (each call returns exactly one line, no\n * trailing newline).\n *\n *   <iso-timestamp> <level> <event-tag> <key>=<value> ...\n *\n * Example:\n *   2026-05-19T20:11:32.001Z INFO lifecycle.statusChanged key=sui from=starting to=ready\n *   2026-05-19T20:11:32.500Z WARN log.appended key=walrus line=\"failed to bind port 9000\"\n *   2026-05-19T20:11:33.000Z INFO endpoint.registered name=aggregator url=http://localhost:9000\n */\nexport const formatEventLine = (event: EngineEvent): string => {\n\tconst ts = isoTimestamp(eventAt(event));\n\tconst level = levelForEvent(event);\n\tconst payload = payloadFor(event);\n\treturn `${ts} ${level} ${event.tag} ${payload}`;\n};\n\n/**\n * Heartbeat line for an in-flight internal acquiring row. Emitted by the\n * scheduler at architecture-blessed intervals; this function is the\n * pure formatter only.\n */\nexport const formatHeartbeat = (\n\tnow: number,\n\tkey: string,\n\tphase: string | null,\n\troleToken: string,\n): string => {\n\tconst ts = isoTimestamp(now);\n\tconst narration = narrationFor(phase, 'acquiring');\n\treturn `${ts} INFO heartbeat key=${key} role=${roleToken} narration=${quote(narration)}`;\n};\n\n// -----------------------------------------------------------------------------\n// Renderer implementation\n// -----------------------------------------------------------------------------\n\n/**\n * Build a plain renderer satisfying the `Renderer` contract.\n *\n * Mount subscribes to the live event stream, writes one line per\n * event to stderr. The state-ref is sampled for the initial sweep\n * (one line per declared row) so a renderer attached after boot\n * still sees a coherent baseline.\n */\nexport const makePlainRenderer = (): Renderer => ({\n\tmount: (stateRef, events) =>\n\t\tEffect.gen(function* () {\n\t\t\tconst initial = yield* SubscriptionRef.get(stateRef);\n\t\t\tyield* emitInitialSweep(initial);\n\t\t\tyield* events.pipe(Stream.runForEach((event) => writeStderrLine(formatEventLine(event))));\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.pipe(Effect.catch(() => Effect.fail(mountFailed('flush')))),\n});\n\n// -----------------------------------------------------------------------------\n// Internals — formatting\n// -----------------------------------------------------------------------------\n\nconst isoTimestamp = (at: number): string => new Date(at || Date.now()).toISOString();\n\nconst eventAt = (event: EngineEvent): number => {\n\tif ('at' in event && typeof event.at === 'number') return event.at;\n\tswitch (event.tag) {\n\t\tcase 'endpoint.registered':\n\t\t\treturn event.endpoint.registeredAt;\n\t\tcase 'error.reported':\n\t\t\treturn event.error.at;\n\t\tcase 'build.statusChanged':\n\t\t\treturn event.entry.startedAt;\n\t\tdefault:\n\t\t\treturn Date.now();\n\t}\n};\n\nconst levelForEvent = (event: EngineEvent): 'INFO' | 'WARN' | 'ERROR' => {\n\tswitch (event.tag) {\n\t\tcase 'log.appended':\n\t\t\treturn event.level === 'error' ? 'ERROR' : event.level === 'warn' ? 'WARN' : 'INFO';\n\t\tcase 'error.reported':\n\t\t\treturn event.error.severity === 'fatal' || event.error.severity === 'error'\n\t\t\t\t? 'ERROR'\n\t\t\t\t: 'WARN';\n\t\tdefault:\n\t\t\treturn 'INFO';\n\t}\n};\n\nconst payloadFor = (event: EngineEvent): string => {\n\tswitch (event.tag) {\n\t\tcase 'lifecycle.statusChanged':\n\t\t\treturn kv({\n\t\t\t\tkey: event.pluginKey,\n\t\t\t\tfrom: statusLabel(event.from),\n\t\t\t\tto: statusLabel(event.to),\n\t\t\t});\n\t\tcase 'lifecycle.phaseSet':\n\t\t\treturn kv({\n\t\t\t\tkey: event.pluginKey,\n\t\t\t\tphase: event.phase ?? '',\n\t\t\t});\n\t\tcase 'log.appended':\n\t\t\treturn kv({\n\t\t\t\tkey: event.pluginKey,\n\t\t\t\tline: event.line,\n\t\t\t});\n\t\tcase 'endpoint.registered':\n\t\t\treturn kv({\n\t\t\t\tkey: event.endpoint.endpointKey,\n\t\t\t\tname: event.endpoint.name,\n\t\t\t\tdisplayUrl: event.endpoint.displayUrl ?? event.endpoint.url,\n\t\t\t\turl: event.endpoint.url,\n\t\t\t\twire: event.endpoint.wireProtocol,\n\t\t\t});\n\t\tcase 'account.updated':\n\t\t\treturn kv({\n\t\t\t\tkey: event.account.key,\n\t\t\t\trow: event.account.rowKey ?? '',\n\t\t\t\tname: event.account.name,\n\t\t\t\taddress: event.account.address ?? '',\n\t\t\t\tscheme: event.account.scheme ?? '',\n\t\t\t\tsource: event.account.source ?? '',\n\t\t\t\tfunding: event.account.funding.status,\n\t\t\t\tfundingEntries: (event.account.funding.entries ?? [])\n\t\t\t\t\t.map((entry) => `${entry.coin}:${entry.amount}:${entry.status}`)\n\t\t\t\t\t.join(','),\n\t\t\t\trequestedMist: event.account.funding.requestedMist ?? '',\n\t\t\t\tbalanceMist: event.account.funding.balanceMist ?? '',\n\t\t\t});\n\t\tcase 'package.updated':\n\t\t\treturn kv({\n\t\t\t\tkey: event.package.key,\n\t\t\t\trow: event.package.rowKey ?? '',\n\t\t\t\tname: event.package.name,\n\t\t\t\tkind: event.package.kind,\n\t\t\t\tpackageId: event.package.packageId,\n\t\t\t\tupgradeCapId: event.package.upgradeCapId ?? '',\n\t\t\t\tmvr: event.package.mvrPlaceholder,\n\t\t\t});\n\t\tcase 'endpoint.released':\n\t\t\treturn kv({ key: event.endpointKey });\n\t\tcase 'strategy.registered':\n\t\t\treturn kv({\n\t\t\t\tcapability: event.capabilityKey,\n\t\t\t\tautoMounted: event.autoMounted,\n\t\t\t});\n\t\tcase 'strategy.unregistered':\n\t\t\treturn kv({ capability: event.capabilityKey });\n\t\tcase 'manifest.flushed':\n\t\t\treturn kv({ version: event.manifestVersion });\n\t\tcase 'codegen.emitted':\n\t\t\treturn kv({ files: event.files.length });\n\t\tcase 'error.reported':\n\t\t\treturn kv({\n\t\t\t\tkey: event.error.pluginKey ?? '',\n\t\t\t\ttag: event.error.tag,\n\t\t\t\tsummary: event.error.summary,\n\t\t\t\tcause: event.error.chain.join(' | '),\n\t\t\t\tseverity: event.error.severity,\n\t\t\t});\n\t\tcase 'build.statusChanged':\n\t\t\treturn kv({\n\t\t\t\tkey: event.entry.pluginKey ?? '',\n\t\t\t\tphase: event.entry.phase,\n\t\t\t\tprogress: event.entry.progress,\n\t\t\t});\n\t\tcase 'restart.requested':\n\t\tcase 'restart.completed':\n\t\t\treturn kv({\n\t\t\t\ttarget: event.target === 'stack' ? 'stack' : event.target.pluginKey,\n\t\t\t});\n\t\tcase 'shutdown.escalated':\n\t\t\treturn kv({\n\t\t\t\tmode: 'hard-kill',\n\t\t\t\tsignal: event.signal,\n\t\t\t\texitCode: event.exitCode,\n\t\t\t});\n\t\tcase 'snapshot.captureStarted':\n\t\t\treturn kv({ snapshotId: event.snapshotId, name: event.name });\n\t\tcase 'snapshot.captureProgress':\n\t\t\treturn kv({\n\t\t\t\tsnapshotId: event.snapshotId,\n\t\t\t\tname: event.name,\n\t\t\t\tphase: event.phase,\n\t\t\t\tdetail: event.detail,\n\t\t\t\tpaused: event.pausedContainers,\n\t\t\t\ttotal: event.totalContainers,\n\t\t\t});\n\t\tcase 'snapshot.captureSkipped':\n\t\t\treturn kv({ reason: event.reason });\n\t\tcase 'snapshot.captureFailed':\n\t\t\treturn kv({ snapshotId: event.snapshotId, name: event.name, summary: event.summary });\n\t\tcase 'snapshot.captured':\n\t\tcase 'snapshot.restored':\n\t\t\treturn kv({ snapshotId: event.snapshotId });\n\t\tdefault: {\n\t\t\tconst _exhaustive: never = event;\n\t\t\tvoid _exhaustive;\n\t\t\treturn '';\n\t\t}\n\t}\n};\n\nconst kv = (record: Readonly<Record<string, unknown>>): string =>\n\tObject.entries(record)\n\t\t.filter(([, v]) => v !== '' && v !== null && v !== undefined)\n\t\t.map(([k, v]) => `${k}=${quoteIfNeeded(String(v))}`)\n\t\t.join(' ');\n\nconst quoteIfNeeded = (s: string): string => (/[\\s\"]/.test(s) ? quote(s) : s);\n\nconst quote = (s: string): string => `\"${s.replace(/\"/g, '\\\\\"')}\"`;\n\n// -----------------------------------------------------------------------------\n// Internals — initial sweep\n// -----------------------------------------------------------------------------\n\nconst emitInitialSweep = (state: SubscribableState): Effect.Effect<void> =>\n\tEffect.gen(function* () {\n\t\tyield* writeStderrLine(\n\t\t\t`${isoTimestamp(state.cycle.startedAt || Date.now())} INFO stack.identity app=${state.identity.app} stack=${state.identity.stack} network=${state.identity.network} cycle=${state.cycle.id}`,\n\t\t);\n\t\tfor (const row of state.rows) {\n\t\t\tyield* writeStderrLine(\n\t\t\t\t`${isoTimestamp(Date.now())} INFO row.declared ${kv({\n\t\t\t\t\tkey: row.key,\n\t\t\t\t\tlabel: labelForRow(row.key),\n\t\t\t\t\trole: roleLabel(row.role),\n\t\t\t\t\tstatus: statusLabel(row.status),\n\t\t\t\t})}`,\n\t\t\t);\n\t\t}\n\t\tfor (const endpoint of state.endpoints) {\n\t\t\tyield* writeStderrLine(\n\t\t\t\t`${isoTimestamp(endpoint.registeredAt)} INFO endpoint.registered ${endpointLine(endpoint)}`,\n\t\t\t);\n\t\t}\n\t\tfor (const account of state.accounts) {\n\t\t\tyield* writeStderrLine(\n\t\t\t\t`${isoTimestamp(account.updatedAt)} INFO account.updated ${accountLine(account)}`,\n\t\t\t);\n\t\t}\n\t\tfor (const pkg of state.packages) {\n\t\t\tyield* writeStderrLine(\n\t\t\t\t`${isoTimestamp(pkg.updatedAt)} INFO package.updated ${packageLine(pkg)}`,\n\t\t\t);\n\t\t}\n\t});\n\n// -----------------------------------------------------------------------------\n// Internals — IO (pipe-safe)\n// -----------------------------------------------------------------------------\n\nconst writeStderrLine = (line: string): Effect.Effect<void> =>\n\tEffect.sync(() => {\n\t\ttry {\n\t\t\tprocess.stderr.write(`${line}\\n`);\n\t\t} catch (err) {\n\t\t\t// EPIPE swallowed (pipe-safety invariant); other errors\n\t\t\t// likewise swallowed because \"rendering never crashes the\n\t\t\t// stack\" (distilled/21-tui § Invariants).\n\t\t\tvoid err;\n\t\t}\n\t});\n"],"mappings":"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"}