@mysten-incubation/devstack 0.0.0

package/dist/surfaces/cli/sysexits.mjs

@@ -0,0 +1,139 @@
+//#region src/surfaces/cli/sysexits.ts
+/** Sysexits-named exit codes (numeric values are stable; do NOT reuse). */
+const ExitCode = {
+	/** Successful termination. */
+	OK: 0,
+	/** Generic catch-all failure. Use only when no specific code applies. */
+	GENERIC: 1,
+	/** Devstack-domain: supervisor for the target stack is already live
+	*  in another process. Destructive verbs refuse with this code. */
+	SUPERVISOR_LIVE: 40,
+	/** Devstack-domain: requested snapshot name / id not found. */
+	SNAPSHOT_NOT_FOUND: 41,
+	/** Devstack-domain: seed manifest mismatch between current chain
+	*  identity and the snapshot/seed being restored. */
+	SEED_MISMATCH: 42,
+	/** Devstack-domain: destructive verb requires explicit confirm but
+	*  `--no-input` / non-TTY / no `--yes` is in effect, or the
+	*  interactive prompt was declined. */
+	CONFIRM_REQUIRED: 43,
+	/** Bad usage (unknown flag, malformed args, mutually-exclusive
+	*  flag pair, ambiguous reference). */
+	USAGE: 64,
+	/** Input data malformed (config schema invalid, JSON parse error
+	*  inside a snapshot manifest, etc.). */
+	DATA_ERR: 65,
+	/** Cannot open input (config not found, snapshot file missing). */
+	NO_INPUT: 66,
+	/** Internal software error / unhandled defect. Default for
+	*  defects that escape Effect.catchAll. */
+	SOFTWARE: 70,
+	/** Service required by the CLI is unavailable (Docker daemon
+	*  unreachable, network down). */
+	UNAVAILABLE: 69,
+	/** Output file/directory cannot be created (permissions, disk
+	*  full). */
+	CANT_CREATE: 73,
+	/** Temporary failure; retry might succeed (lock contention,
+	*  transient daemon hiccup). */
+	TEMP_FAIL: 75,
+	/** Configuration error — the user's devstack.config.ts is wrong
+	*  in a way that prevents *any* verb from running. */
+	CONFIG: 78
+};
+/** Human-readable identifier for an exit code. Used by the
+*  `schema --json` command and by the envelope `error.code` field. */
+const exitCodeName = (code) => {
+	switch (code) {
+		case ExitCode.OK: return "OK";
+		case ExitCode.GENERIC: return "GENERIC";
+		case ExitCode.SUPERVISOR_LIVE: return "SUPERVISOR_LIVE";
+		case ExitCode.SNAPSHOT_NOT_FOUND: return "SNAPSHOT_NOT_FOUND";
+		case ExitCode.SEED_MISMATCH: return "SEED_MISMATCH";
+		case ExitCode.CONFIRM_REQUIRED: return "CONFIRM_REQUIRED";
+		case ExitCode.USAGE: return "USAGE";
+		case ExitCode.DATA_ERR: return "DATA_ERR";
+		case ExitCode.NO_INPUT: return "NO_INPUT";
+		case ExitCode.SOFTWARE: return "SOFTWARE";
+		case ExitCode.UNAVAILABLE: return "UNAVAILABLE";
+		case ExitCode.CANT_CREATE: return "CANT_CREATE";
+		case ExitCode.TEMP_FAIL: return "TEMP_FAIL";
+		case ExitCode.CONFIG: return "CONFIG";
+	}
+};
+const exitCodeTable = [
+	{
+		code: ExitCode.OK,
+		name: "OK",
+		description: "Successful termination."
+	},
+	{
+		code: ExitCode.GENERIC,
+		name: "GENERIC",
+		description: "Generic failure; no specific code applies."
+	},
+	{
+		code: ExitCode.SUPERVISOR_LIVE,
+		name: "SUPERVISOR_LIVE",
+		description: "Devstack: supervisor for the target stack is already live in another process."
+	},
+	{
+		code: ExitCode.SNAPSHOT_NOT_FOUND,
+		name: "SNAPSHOT_NOT_FOUND",
+		description: "Devstack: requested snapshot name or id not found."
+	},
+	{
+		code: ExitCode.SEED_MISMATCH,
+		name: "SEED_MISMATCH",
+		description: "Devstack: seed-manifest mismatch (chain identity diverges from snapshot)."
+	},
+	{
+		code: ExitCode.CONFIRM_REQUIRED,
+		name: "CONFIRM_REQUIRED",
+		description: "Devstack: destructive verb needs confirmation or the prompt was declined."
+	},
+	{
+		code: ExitCode.USAGE,
+		name: "USAGE",
+		description: "Bad command-line usage."
+	},
+	{
+		code: ExitCode.DATA_ERR,
+		name: "DATA_ERR",
+		description: "Input data malformed."
+	},
+	{
+		code: ExitCode.NO_INPUT,
+		name: "NO_INPUT",
+		description: "Required input could not be opened."
+	},
+	{
+		code: ExitCode.UNAVAILABLE,
+		name: "UNAVAILABLE",
+		description: "A required service (e.g. Docker daemon) is unavailable."
+	},
+	{
+		code: ExitCode.SOFTWARE,
+		name: "SOFTWARE",
+		description: "Internal software error."
+	},
+	{
+		code: ExitCode.CANT_CREATE,
+		name: "CANT_CREATE",
+		description: "Cannot create output (permissions, disk)."
+	},
+	{
+		code: ExitCode.TEMP_FAIL,
+		name: "TEMP_FAIL",
+		description: "Transient failure; retry may succeed."
+	},
+	{
+		code: ExitCode.CONFIG,
+		name: "CONFIG",
+		description: "User configuration error."
+	}
+];
+//#endregion
+export { ExitCode, exitCodeName, exitCodeTable };
+
+//# sourceMappingURL=sysexits.mjs.map

package/dist/surfaces/cli/sysexits.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"sysexits.mjs","names":[],"sources":["../../../src/surfaces/cli/sysexits.ts"],"sourcesContent":["// CLI surface — sysexits.h exit codes.\n//\n// Architecture (distilled/20-cli.md § Invariants) requires a single\n// centralized table. Numbers are pinned, names are stable, new\n// devstack-domain codes are added at the END of the domain block (so\n// downstream scripts keying off numerics never shift).\n//\n// Reference: /usr/include/sysexits.h (BSD-derived). We use only the\n// subset that maps to CLI failure shapes; everything else collapses to\n// `EX_SOFTWARE` (70). The devstack-domain block (40-43) is a private\n// extension carved out below the standard 64-78 range so it cannot\n// collide with the OS table.\n//\n// Surface invariant: every CLI failure carries one of these codes in\n// the JSON envelope's `error.exitCode` AND drives `process.exitCode`.\n// \"1 for everything\" is explicitly disallowed by the architecture.\n\n/** Sysexits-named exit codes (numeric values are stable; do NOT reuse). */\nexport const ExitCode = {\n\t/** Successful termination. */\n\tOK: 0,\n\t/** Generic catch-all failure. Use only when no specific code applies. */\n\tGENERIC: 1,\n\t/** Devstack-domain: supervisor for the target stack is already live\n\t *  in another process. Destructive verbs refuse with this code. */\n\tSUPERVISOR_LIVE: 40,\n\t/** Devstack-domain: requested snapshot name / id not found. */\n\tSNAPSHOT_NOT_FOUND: 41,\n\t/** Devstack-domain: seed manifest mismatch between current chain\n\t *  identity and the snapshot/seed being restored. */\n\tSEED_MISMATCH: 42,\n\t/** Devstack-domain: destructive verb requires explicit confirm but\n\t *  `--no-input` / non-TTY / no `--yes` is in effect, or the\n\t *  interactive prompt was declined. */\n\tCONFIRM_REQUIRED: 43,\n\t/** Bad usage (unknown flag, malformed args, mutually-exclusive\n\t *  flag pair, ambiguous reference). */\n\tUSAGE: 64,\n\t/** Input data malformed (config schema invalid, JSON parse error\n\t *  inside a snapshot manifest, etc.). */\n\tDATA_ERR: 65,\n\t/** Cannot open input (config not found, snapshot file missing). */\n\tNO_INPUT: 66,\n\t/** Internal software error / unhandled defect. Default for\n\t *  defects that escape Effect.catchAll. */\n\tSOFTWARE: 70,\n\t/** Service required by the CLI is unavailable (Docker daemon\n\t *  unreachable, network down). */\n\tUNAVAILABLE: 69,\n\t/** Output file/directory cannot be created (permissions, disk\n\t *  full). */\n\tCANT_CREATE: 73,\n\t/** Temporary failure; retry might succeed (lock contention,\n\t *  transient daemon hiccup). */\n\tTEMP_FAIL: 75,\n\t/** Configuration error — the user's devstack.config.ts is wrong\n\t *  in a way that prevents *any* verb from running. */\n\tCONFIG: 78,\n} as const;\n\nexport type ExitCode = (typeof ExitCode)[keyof typeof ExitCode];\n\n/** Human-readable identifier for an exit code. Used by the\n *  `schema --json` command and by the envelope `error.code` field. */\nexport const exitCodeName = (code: ExitCode): string => {\n\tswitch (code) {\n\t\tcase ExitCode.OK:\n\t\t\treturn 'OK';\n\t\tcase ExitCode.GENERIC:\n\t\t\treturn 'GENERIC';\n\t\tcase ExitCode.SUPERVISOR_LIVE:\n\t\t\treturn 'SUPERVISOR_LIVE';\n\t\tcase ExitCode.SNAPSHOT_NOT_FOUND:\n\t\t\treturn 'SNAPSHOT_NOT_FOUND';\n\t\tcase ExitCode.SEED_MISMATCH:\n\t\t\treturn 'SEED_MISMATCH';\n\t\tcase ExitCode.CONFIRM_REQUIRED:\n\t\t\treturn 'CONFIRM_REQUIRED';\n\t\tcase ExitCode.USAGE:\n\t\t\treturn 'USAGE';\n\t\tcase ExitCode.DATA_ERR:\n\t\t\treturn 'DATA_ERR';\n\t\tcase ExitCode.NO_INPUT:\n\t\t\treturn 'NO_INPUT';\n\t\tcase ExitCode.SOFTWARE:\n\t\t\treturn 'SOFTWARE';\n\t\tcase ExitCode.UNAVAILABLE:\n\t\t\treturn 'UNAVAILABLE';\n\t\tcase ExitCode.CANT_CREATE:\n\t\t\treturn 'CANT_CREATE';\n\t\tcase ExitCode.TEMP_FAIL:\n\t\t\treturn 'TEMP_FAIL';\n\t\tcase ExitCode.CONFIG:\n\t\t\treturn 'CONFIG';\n\t}\n};\n\n/** Schema-emit entry: full table of `(code, name, description)`. The\n *  programmable `schema --json` command serializes this verbatim. */\nexport interface ExitCodeEntry {\n\treadonly code: ExitCode;\n\treadonly name: string;\n\treadonly description: string;\n}\n\nexport const exitCodeTable: ReadonlyArray<ExitCodeEntry> = [\n\t{ code: ExitCode.OK, name: 'OK', description: 'Successful termination.' },\n\t{\n\t\tcode: ExitCode.GENERIC,\n\t\tname: 'GENERIC',\n\t\tdescription: 'Generic failure; no specific code applies.',\n\t},\n\t{\n\t\tcode: ExitCode.SUPERVISOR_LIVE,\n\t\tname: 'SUPERVISOR_LIVE',\n\t\tdescription: 'Devstack: supervisor for the target stack is already live in another process.',\n\t},\n\t{\n\t\tcode: ExitCode.SNAPSHOT_NOT_FOUND,\n\t\tname: 'SNAPSHOT_NOT_FOUND',\n\t\tdescription: 'Devstack: requested snapshot name or id not found.',\n\t},\n\t{\n\t\tcode: ExitCode.SEED_MISMATCH,\n\t\tname: 'SEED_MISMATCH',\n\t\tdescription: 'Devstack: seed-manifest mismatch (chain identity diverges from snapshot).',\n\t},\n\t{\n\t\tcode: ExitCode.CONFIRM_REQUIRED,\n\t\tname: 'CONFIRM_REQUIRED',\n\t\tdescription: 'Devstack: destructive verb needs confirmation or the prompt was declined.',\n\t},\n\t{ code: ExitCode.USAGE, name: 'USAGE', description: 'Bad command-line usage.' },\n\t{ code: ExitCode.DATA_ERR, name: 'DATA_ERR', description: 'Input data malformed.' },\n\t{ code: ExitCode.NO_INPUT, name: 'NO_INPUT', description: 'Required input could not be opened.' },\n\t{\n\t\tcode: ExitCode.UNAVAILABLE,\n\t\tname: 'UNAVAILABLE',\n\t\tdescription: 'A required service (e.g. Docker daemon) is unavailable.',\n\t},\n\t{ code: ExitCode.SOFTWARE, name: 'SOFTWARE', description: 'Internal software error.' },\n\t{\n\t\tcode: ExitCode.CANT_CREATE,\n\t\tname: 'CANT_CREATE',\n\t\tdescription: 'Cannot create output (permissions, disk).',\n\t},\n\t{\n\t\tcode: ExitCode.TEMP_FAIL,\n\t\tname: 'TEMP_FAIL',\n\t\tdescription: 'Transient failure; retry may succeed.',\n\t},\n\t{ code: ExitCode.CONFIG, name: 'CONFIG', description: 'User configuration error.' },\n];\n"],"mappings":";;AAkBA,MAAa,WAAW;;CAEvB,IAAI;;CAEJ,SAAS;;;CAGT,iBAAiB;;CAEjB,oBAAoB;;;CAGpB,eAAe;;;;CAIf,kBAAkB;;;CAGlB,OAAO;;;CAGP,UAAU;;CAEV,UAAU;;;CAGV,UAAU;;;CAGV,aAAa;;;CAGb,aAAa;;;CAGb,WAAW;;;CAGX,QAAQ;CACR;;;AAMD,MAAa,gBAAgB,SAA2B;AACvD,SAAQ,MAAR;EACC,KAAK,SAAS,GACb,QAAO;EACR,KAAK,SAAS,QACb,QAAO;EACR,KAAK,SAAS,gBACb,QAAO;EACR,KAAK,SAAS,mBACb,QAAO;EACR,KAAK,SAAS,cACb,QAAO;EACR,KAAK,SAAS,iBACb,QAAO;EACR,KAAK,SAAS,MACb,QAAO;EACR,KAAK,SAAS,SACb,QAAO;EACR,KAAK,SAAS,SACb,QAAO;EACR,KAAK,SAAS,SACb,QAAO;EACR,KAAK,SAAS,YACb,QAAO;EACR,KAAK,SAAS,YACb,QAAO;EACR,KAAK,SAAS,UACb,QAAO;EACR,KAAK,SAAS,OACb,QAAO;;;AAYV,MAAa,gBAA8C;CAC1D;EAAE,MAAM,SAAS;EAAI,MAAM;EAAM,aAAa;EAA2B;CACzE;EACC,MAAM,SAAS;EACf,MAAM;EACN,aAAa;EACb;CACD;EACC,MAAM,SAAS;EACf,MAAM;EACN,aAAa;EACb;CACD;EACC,MAAM,SAAS;EACf,MAAM;EACN,aAAa;EACb;CACD;EACC,MAAM,SAAS;EACf,MAAM;EACN,aAAa;EACb;CACD;EACC,MAAM,SAAS;EACf,MAAM;EACN,aAAa;EACb;CACD;EAAE,MAAM,SAAS;EAAO,MAAM;EAAS,aAAa;EAA2B;CAC/E;EAAE,MAAM,SAAS;EAAU,MAAM;EAAY,aAAa;EAAyB;CACnF;EAAE,MAAM,SAAS;EAAU,MAAM;EAAY,aAAa;EAAuC;CACjG;EACC,MAAM,SAAS;EACf,MAAM;EACN,aAAa;EACb;CACD;EAAE,MAAM,SAAS;EAAU,MAAM;EAAY,aAAa;EAA4B;CACtF;EACC,MAAM,SAAS;EACf,MAAM;EACN,aAAa;EACb;CACD;EACC,MAAM,SAAS;EACf,MAAM;EACN,aAAa;EACb;CACD;EAAE,MAAM,SAAS;EAAQ,MAAM;EAAU,aAAa;EAA6B;CACnF"}

package/dist/surfaces/tui/app.mjs

@@ -0,0 +1,104 @@
+import { Dashboard } from "./dashboard.mjs";
+import { appendEventLogLine, eventLogLineFromEvent, shutdownRequestedLine } from "./event-log.mjs";
+import { InputHandler } from "./input.mjs";
+import { Effect, Fiber, Stream, SubscriptionRef } from "effect";
+import { useEffect, useRef, useState } from "react";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+//#region src/surfaces/tui/app.tsx
+const App = ({ stateRef, events, publish }) => {
+	const [state, setState] = useState(() => Effect.runSync(SubscriptionRef.get(stateRef)));
+	const [eventLog, setEventLog] = useState([]);
+	const [snapshotPromptValue, setSnapshotPromptValue] = useState(null);
+	const [snapshotStatus, setSnapshotStatus] = useState(null);
+	const eventSeq = useRef(0);
+	const shutdownLogged = useRef(false);
+	useEffect(() => {
+		const fiber = Effect.runFork(Stream.runForEach(SubscriptionRef.changes(stateRef), (next) => Effect.sync(() => setState(next))));
+		return () => {
+			Effect.runFork(Fiber.interrupt(fiber));
+		};
+	}, [stateRef]);
+	useEffect(() => {
+		const fiber = Effect.runFork(Stream.runForEach(events, (event) => Effect.sync(() => {
+			const line = eventLogLineFromEvent(event, eventSeq.current++);
+			setEventLog((prev) => appendEventLogLine(prev, line));
+			switch (event.tag) {
+				case "snapshot.captureStarted":
+					setSnapshotStatus({
+						tag: "running",
+						phase: "starting",
+						...event.snapshotId === void 0 ? {} : { snapshotId: event.snapshotId },
+						...event.name === void 0 ? {} : { name: event.name },
+						at: event.at
+					});
+					break;
+				case "snapshot.captureProgress":
+					setSnapshotStatus((prev) => ({
+						tag: "running",
+						phase: event.phase,
+						...event.snapshotId === void 0 ? prev?.tag === "running" && prev.snapshotId !== void 0 ? { snapshotId: prev.snapshotId } : {} : { snapshotId: event.snapshotId },
+						...event.name === void 0 ? prev?.tag === "running" && prev.name !== void 0 ? { name: prev.name } : {} : { name: event.name },
+						...event.detail === void 0 ? {} : { detail: event.detail },
+						...event.pausedContainers === void 0 ? {} : { pausedContainers: event.pausedContainers },
+						...event.totalContainers === void 0 ? {} : { totalContainers: event.totalContainers },
+						at: event.at
+					}));
+					break;
+				case "snapshot.captureSkipped":
+					setSnapshotStatus({
+						tag: "skipped",
+						reason: event.reason,
+						at: event.at
+					});
+					break;
+				case "snapshot.captureFailed":
+					setSnapshotStatus({
+						tag: "failed",
+						...event.snapshotId === void 0 ? {} : { snapshotId: event.snapshotId },
+						...event.name === void 0 ? {} : { name: event.name },
+						summary: event.summary,
+						at: event.at
+					});
+					break;
+				case "snapshot.captured":
+					setSnapshotStatus({
+						tag: "captured",
+						snapshotId: event.snapshotId,
+						...event.name === void 0 ? {} : { name: event.name },
+						at: event.at
+					});
+					break;
+				default: break;
+			}
+		})));
+		return () => {
+			Effect.runFork(Fiber.interrupt(fiber));
+		};
+	}, [events]);
+	useEffect(() => {
+		if (state.cycle.phase === "shutting-down") {
+			setSnapshotPromptValue(null);
+			setSnapshotStatus(null);
+			if (shutdownLogged.current) return;
+			shutdownLogged.current = true;
+			const line = shutdownRequestedLine(Date.now(), eventSeq.current++);
+			setEventLog((prev) => appendEventLogLine(prev, line));
+			return;
+		}
+		shutdownLogged.current = false;
+	}, [state.cycle.phase]);
+	return /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx(InputHandler, {
+		publish,
+		snapshotPromptValue,
+		onSnapshotPromptChange: setSnapshotPromptValue
+	}), /* @__PURE__ */ jsx(Dashboard, {
+		state,
+		eventLog,
+		snapshotPromptValue,
+		snapshotStatus
+	})] });
+};
+//#endregion
+export { App };
+
+//# sourceMappingURL=app.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"app.mjs","names":[],"sources":["../../../src/surfaces/tui/app.tsx"],"sourcesContent":["// Ink app root — the React tree mounted by `render()`.\n//\n// Reads from the `SubscriptionRef<SubscribableState>` from the\n// substrate's projection layer. The initial render samples the current\n// value synchronously; subsequent frame updates come from the\n// subscription. No polling loops, no setInterval-driven sampling.\n// The heartbeat component spins on its own timer for liveness, but\n// it does NOT trigger dashboard re-renders for projection data.\n//\n// Per architecture (distilled/21-tui § Learnings #3 + § Invariants):\n//   - The renderer NEVER calls engine methods. Input handlers publish\n//     typed `EngineCommand`s through the `publish` callback prop.\n//   - Mount is process-scoped and survives engine cycle swaps; the\n//     SubscriptionRef's lifecycle is decoupled from the engine cycle.\n//   - Frame stability: SubscriptionRef updates already short-circuit\n//     when reference equality holds (Effect's Ref impl).\n//\n// Runtime escape note: `Effect.runFork` is necessary at the\n// SubscriptionRef → React state boundary (React's hook model is\n// synchronous; Effect can't render). It is the ONLY escape this\n// surface uses, scoped to the App's mount lifetime. This is the\n// \"properly-scoped fiber on each surface\" pattern called out in\n// distilled/21-tui § Opportunities.\n\nimport { Effect, Fiber, Stream, SubscriptionRef } from 'effect';\nimport type React from 'react';\nimport { useEffect, useRef, useState } from 'react';\n\nimport type { EngineEvent } from '../../substrate/events.ts';\nimport type { SubscribableState } from '../../substrate/projection.ts';\nimport { Dashboard, type SnapshotStatus } from './dashboard.tsx';\nimport {\n\tappendEventLogLine,\n\teventLogLineFromEvent,\n\tshutdownRequestedLine,\n\ttype EventLogLine,\n} from './event-log.ts';\nimport { InputHandler, type CommandPublisher } from './input.tsx';\n\nexport interface AppProps {\n\t/** The renderer-facing subscribable projection. */\n\treadonly stateRef: SubscriptionRef.SubscriptionRef<SubscribableState>;\n\t/** Live engine event stream. */\n\treadonly events: Stream.Stream<EngineEvent, never>;\n\t/** Typed command-publisher callback. */\n\treadonly publish: CommandPublisher;\n}\n\nexport const App = ({ stateRef, events, publish }: AppProps): React.JSX.Element => {\n\tconst [state, setState] = useState<SubscribableState>(() =>\n\t\tEffect.runSync(SubscriptionRef.get(stateRef)),\n\t);\n\tconst [eventLog, setEventLog] = useState<ReadonlyArray<EventLogLine>>([]);\n\tconst [snapshotPromptValue, setSnapshotPromptValue] = useState<string | null>(null);\n\tconst [snapshotStatus, setSnapshotStatus] = useState<SnapshotStatus | null>(null);\n\tconst eventSeq = useRef(0);\n\tconst shutdownLogged = useRef(false);\n\n\tuseEffect(() => {\n\t\t// Stream.runForEach pulls each new state from the\n\t\t// SubscriptionRef and pushes it into React state. The fiber is\n\t\t// owned by this effect; cleanup interrupts it.\n\t\tconst fiber = Effect.runFork(\n\t\t\tStream.runForEach(SubscriptionRef.changes(stateRef), (next) =>\n\t\t\t\tEffect.sync(() => setState(next)),\n\t\t\t),\n\t\t);\n\t\treturn () => {\n\t\t\t// Interrupt the subscription fiber on unmount.\n\t\t\tEffect.runFork(Fiber.interrupt(fiber));\n\t\t};\n\t}, [stateRef]);\n\n\tuseEffect(() => {\n\t\tconst fiber = Effect.runFork(\n\t\t\tStream.runForEach(events, (event) =>\n\t\t\t\tEffect.sync(() => {\n\t\t\t\t\tconst line = eventLogLineFromEvent(event, eventSeq.current++);\n\t\t\t\t\tsetEventLog((prev) => appendEventLogLine(prev, line));\n\t\t\t\t\tswitch (event.tag) {\n\t\t\t\t\t\tcase 'snapshot.captureStarted':\n\t\t\t\t\t\t\tsetSnapshotStatus({\n\t\t\t\t\t\t\t\ttag: 'running',\n\t\t\t\t\t\t\t\tphase: 'starting',\n\t\t\t\t\t\t\t\t...(event.snapshotId === undefined ? {} : { snapshotId: event.snapshotId }),\n\t\t\t\t\t\t\t\t...(event.name === undefined ? {} : { name: event.name }),\n\t\t\t\t\t\t\t\tat: event.at,\n\t\t\t\t\t\t\t});\n\t\t\t\t\t\t\tbreak;\n\t\t\t\t\t\tcase 'snapshot.captureProgress':\n\t\t\t\t\t\t\tsetSnapshotStatus((prev) => ({\n\t\t\t\t\t\t\t\ttag: 'running',\n\t\t\t\t\t\t\t\tphase: event.phase,\n\t\t\t\t\t\t\t\t...(event.snapshotId === undefined\n\t\t\t\t\t\t\t\t\t? prev?.tag === 'running' && prev.snapshotId !== undefined\n\t\t\t\t\t\t\t\t\t\t? { snapshotId: prev.snapshotId }\n\t\t\t\t\t\t\t\t\t\t: {}\n\t\t\t\t\t\t\t\t\t: { snapshotId: event.snapshotId }),\n\t\t\t\t\t\t\t\t...(event.name === undefined\n\t\t\t\t\t\t\t\t\t? prev?.tag === 'running' && prev.name !== undefined\n\t\t\t\t\t\t\t\t\t\t? { name: prev.name }\n\t\t\t\t\t\t\t\t\t\t: {}\n\t\t\t\t\t\t\t\t\t: { name: event.name }),\n\t\t\t\t\t\t\t\t...(event.detail === undefined ? {} : { detail: event.detail }),\n\t\t\t\t\t\t\t\t...(event.pausedContainers === undefined\n\t\t\t\t\t\t\t\t\t? {}\n\t\t\t\t\t\t\t\t\t: { pausedContainers: event.pausedContainers }),\n\t\t\t\t\t\t\t\t...(event.totalContainers === undefined\n\t\t\t\t\t\t\t\t\t? {}\n\t\t\t\t\t\t\t\t\t: { totalContainers: event.totalContainers }),\n\t\t\t\t\t\t\t\tat: event.at,\n\t\t\t\t\t\t\t}));\n\t\t\t\t\t\t\tbreak;\n\t\t\t\t\t\tcase 'snapshot.captureSkipped':\n\t\t\t\t\t\t\tsetSnapshotStatus({\n\t\t\t\t\t\t\t\ttag: 'skipped',\n\t\t\t\t\t\t\t\treason: event.reason,\n\t\t\t\t\t\t\t\tat: event.at,\n\t\t\t\t\t\t\t});\n\t\t\t\t\t\t\tbreak;\n\t\t\t\t\t\tcase 'snapshot.captureFailed':\n\t\t\t\t\t\t\tsetSnapshotStatus({\n\t\t\t\t\t\t\t\ttag: 'failed',\n\t\t\t\t\t\t\t\t...(event.snapshotId === undefined ? {} : { snapshotId: event.snapshotId }),\n\t\t\t\t\t\t\t\t...(event.name === undefined ? {} : { name: event.name }),\n\t\t\t\t\t\t\t\tsummary: event.summary,\n\t\t\t\t\t\t\t\tat: event.at,\n\t\t\t\t\t\t\t});\n\t\t\t\t\t\t\tbreak;\n\t\t\t\t\t\tcase 'snapshot.captured':\n\t\t\t\t\t\t\tsetSnapshotStatus({\n\t\t\t\t\t\t\t\ttag: 'captured',\n\t\t\t\t\t\t\t\tsnapshotId: event.snapshotId,\n\t\t\t\t\t\t\t\t...(event.name === undefined ? {} : { name: event.name }),\n\t\t\t\t\t\t\t\tat: event.at,\n\t\t\t\t\t\t\t});\n\t\t\t\t\t\t\tbreak;\n\t\t\t\t\t\tdefault:\n\t\t\t\t\t\t\tbreak;\n\t\t\t\t\t}\n\t\t\t\t}),\n\t\t\t),\n\t\t);\n\t\treturn () => {\n\t\t\tEffect.runFork(Fiber.interrupt(fiber));\n\t\t};\n\t}, [events]);\n\n\tuseEffect(() => {\n\t\tif (state.cycle.phase === 'shutting-down') {\n\t\t\tsetSnapshotPromptValue(null);\n\t\t\tsetSnapshotStatus(null);\n\t\t\tif (shutdownLogged.current) return;\n\t\t\tshutdownLogged.current = true;\n\t\t\tconst line = shutdownRequestedLine(Date.now(), eventSeq.current++);\n\t\t\tsetEventLog((prev) => appendEventLogLine(prev, line));\n\t\t\treturn;\n\t\t}\n\t\tshutdownLogged.current = false;\n\t}, [state.cycle.phase]);\n\n\treturn (\n\t\t<>\n\t\t\t<InputHandler\n\t\t\t\tpublish={publish}\n\t\t\t\tsnapshotPromptValue={snapshotPromptValue}\n\t\t\t\tonSnapshotPromptChange={setSnapshotPromptValue}\n\t\t\t/>\n\t\t\t<Dashboard\n\t\t\t\tstate={state}\n\t\t\t\teventLog={eventLog}\n\t\t\t\tsnapshotPromptValue={snapshotPromptValue}\n\t\t\t\tsnapshotStatus={snapshotStatus}\n\t\t\t/>\n\t\t</>\n\t);\n};\n"],"mappings":"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"}

package/dist/surfaces/tui/dashboard.mjs

@@ -0,0 +1,261 @@
+import { dashboardSummaryLine, deriveDashboardSummary } from "./display-derivation.mjs";
+import { Heartbeat } from "./heartbeat.mjs";
+import { ResourceTables } from "./resource-table.mjs";
+import { Box, Static, Text } from "ink";
+import { jsx, jsxs } from "react/jsx-runtime";
+//#region src/surfaces/tui/dashboard.tsx
+const phaseColor = (phase) => {
+	switch (phase) {
+		case "running": return "green";
+		case "booting":
+		case "restarting": return "yellow";
+		case "shutting-down": return "red";
+		default: return "white";
+	}
+};
+const logMessageColor = (level) => {
+	switch (level) {
+		case "info": return "white";
+		case "warn": return "yellow";
+		case "error": return "red";
+	}
+};
+const healthColor = (health) => {
+	switch (health) {
+		case "ready": return "green";
+		case "active": return "yellow";
+		case "blocked": return "red";
+		case "empty": return "white";
+	}
+};
+const snapshotLabel = (status) => {
+	if ("name" in status && status.name !== void 0) return status.name;
+	if ("snapshotId" in status && status.snapshotId !== void 0) return status.snapshotId;
+	return "manual snapshot";
+};
+const snapshotPhaseLabel = (phase) => {
+	switch (phase) {
+		case "starting": return "starting";
+		case "quiescing": return "checking participants";
+		case "pausing": return "pausing containers";
+		case "paused": return "stack paused";
+		case "capturing-containers": return "capturing containers";
+		case "saving-images": return "saving images";
+		case "capturing-host-tree": return "capturing files";
+		case "saving-state": return "saving state";
+		case "saving-contributions": return "saving metadata";
+		case "writing-metadata": return "finalizing";
+		case "resuming": return "resuming stack";
+	}
+};
+const snapshotPhaseMeansPaused = (phase) => phase === "paused" || phase === "capturing-containers" || phase === "saving-images" || phase === "capturing-host-tree" || phase === "saving-state" || phase === "saving-contributions" || phase === "writing-metadata" || phase === "resuming";
+const SnapshotStatusLine = ({ status }) => {
+	switch (status.tag) {
+		case "running": {
+			const paused = snapshotPhaseMeansPaused(status.phase);
+			const count = status.pausedContainers !== void 0 && status.totalContainers !== void 0 ? `${status.pausedContainers}/${status.totalContainers}` : null;
+			return /* @__PURE__ */ jsxs(Box, {
+				flexDirection: "row",
+				gap: 1,
+				marginTop: 1,
+				children: [
+					/* @__PURE__ */ jsx(Text, {
+						color: paused ? "yellow" : "cyan",
+						children: "Snapshot:"
+					}),
+					/* @__PURE__ */ jsx(Text, { children: snapshotLabel(status) }),
+					/* @__PURE__ */ jsx(Text, {
+						color: paused ? "yellow" : "cyan",
+						children: snapshotPhaseLabel(status.phase)
+					}),
+					paused && /* @__PURE__ */ jsx(Text, {
+						color: "yellow",
+						children: "stack paused"
+					}),
+					count !== null && /* @__PURE__ */ jsx(Text, {
+						dimColor: true,
+						children: count
+					}),
+					status.detail !== void 0 && /* @__PURE__ */ jsx(Text, {
+						dimColor: true,
+						children: status.detail
+					})
+				]
+			});
+		}
+		case "captured": return /* @__PURE__ */ jsxs(Box, {
+			flexDirection: "row",
+			gap: 1,
+			marginTop: 1,
+			children: [
+				/* @__PURE__ */ jsx(Text, {
+					color: "green",
+					children: "Snapshot:"
+				}),
+				/* @__PURE__ */ jsx(Text, { children: snapshotLabel(status) }),
+				/* @__PURE__ */ jsx(Text, {
+					color: "green",
+					children: "saved"
+				}),
+				/* @__PURE__ */ jsx(Text, {
+					dimColor: true,
+					children: status.snapshotId
+				})
+			]
+		});
+		case "skipped": return /* @__PURE__ */ jsxs(Box, {
+			flexDirection: "row",
+			gap: 1,
+			marginTop: 1,
+			children: [/* @__PURE__ */ jsx(Text, {
+				color: "yellow",
+				children: "Snapshot:"
+			}), /* @__PURE__ */ jsx(Text, {
+				color: "yellow",
+				children: "capture already running"
+			})]
+		});
+		case "failed": return /* @__PURE__ */ jsxs(Box, {
+			flexDirection: "row",
+			gap: 1,
+			marginTop: 1,
+			children: [
+				/* @__PURE__ */ jsx(Text, {
+					color: "red",
+					children: "Snapshot:"
+				}),
+				/* @__PURE__ */ jsx(Text, { children: snapshotLabel(status) }),
+				/* @__PURE__ */ jsx(Text, {
+					color: "red",
+					children: "failed"
+				}),
+				/* @__PURE__ */ jsx(Text, {
+					dimColor: true,
+					children: status.summary
+				})
+			]
+		});
+	}
+};
+const Dashboard = ({ state, eventLog, snapshotPromptValue, snapshotStatus }) => {
+	const { identity, cycle, rows, endpoints, accounts, packages } = state;
+	const summary = deriveDashboardSummary(state);
+	return /* @__PURE__ */ jsxs(Box, {
+		flexDirection: "column",
+		children: [
+			eventLog.length > 0 && /* @__PURE__ */ jsx(Static, {
+				items: [...eventLog],
+				children: (entry) => /* @__PURE__ */ jsxs(Box, {
+					flexDirection: "row",
+					gap: 1,
+					children: [
+						/* @__PURE__ */ jsx(Text, {
+							dimColor: true,
+							children: entry.time
+						}),
+						/* @__PURE__ */ jsx(Text, {
+							color: entry.scopeColor,
+							children: entry.scope
+						}),
+						/* @__PURE__ */ jsx(Text, {
+							color: logMessageColor(entry.level),
+							children: entry.message
+						})
+					]
+				}, entry.id)
+			}),
+			state.stackBuild.length > 0 && /* @__PURE__ */ jsx(Static, {
+				items: [...state.stackBuild],
+				children: (entry, idx) => /* @__PURE__ */ jsxs(Text, {
+					dimColor: true,
+					children: [
+						"[build] ",
+						entry.pluginKey ?? "<stack>",
+						" - ",
+						entry.phase,
+						" ",
+						entry.progress
+					]
+				}, idx)
+			}),
+			/* @__PURE__ */ jsxs(Box, {
+				flexDirection: "row",
+				gap: 2,
+				marginTop: 1,
+				children: [
+					/* @__PURE__ */ jsxs(Text, {
+						bold: true,
+						color: "cyan",
+						children: [
+							identity.app,
+							"/",
+							identity.stack
+						]
+					}),
+					/* @__PURE__ */ jsxs(Text, {
+						dimColor: true,
+						children: ["network=", identity.network]
+					}),
+					/* @__PURE__ */ jsxs(Text, {
+						dimColor: true,
+						children: ["cycle=", cycle.id]
+					}),
+					/* @__PURE__ */ jsx(Text, {
+						color: phaseColor(cycle.phase),
+						children: cycle.phase
+					}),
+					/* @__PURE__ */ jsx(Heartbeat, {})
+				]
+			}),
+			/* @__PURE__ */ jsx(Box, { children: /* @__PURE__ */ jsx(Text, {
+				color: healthColor(summary.health),
+				children: dashboardSummaryLine(summary)
+			}) }),
+			/* @__PURE__ */ jsx(Box, {
+				flexDirection: "column",
+				marginTop: 1,
+				children: /* @__PURE__ */ jsx(ResourceTables, {
+					rows,
+					endpoints,
+					accounts,
+					packages
+				})
+			}),
+			snapshotPromptValue !== null && /* @__PURE__ */ jsxs(Box, {
+				flexDirection: "row",
+				gap: 1,
+				marginTop: 1,
+				children: [
+					/* @__PURE__ */ jsx(Text, {
+						color: "cyan",
+						children: "Snapshot name:"
+					}),
+					/* @__PURE__ */ jsx(Text, { children: snapshotPromptValue.length === 0 ? "<auto>" : snapshotPromptValue }),
+					/* @__PURE__ */ jsx(Text, {
+						inverse: true,
+						children: " "
+					}),
+					/* @__PURE__ */ jsx(Text, {
+						dimColor: true,
+						children: "Enter save Esc cancel"
+					})
+				]
+			}),
+			snapshotStatus !== null && /* @__PURE__ */ jsx(SnapshotStatusLine, { status: snapshotStatus }),
+			/* @__PURE__ */ jsxs(Box, {
+				flexDirection: "row",
+				gap: 2,
+				marginTop: 1,
+				children: [
+					/* @__PURE__ */ jsx(Text, { children: "[q] quit" }),
+					/* @__PURE__ */ jsx(Text, { children: "[r] restart stack" }),
+					/* @__PURE__ */ jsx(Text, { children: "[s] snapshot name" })
+				]
+			})
+		]
+	});
+};
+//#endregion
+export { Dashboard };
+
+//# sourceMappingURL=dashboard.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard.mjs","names":[],"sources":["../../../src/surfaces/tui/dashboard.tsx"],"sourcesContent":["// Dashboard — composes the visible TUI: header, rows, endpoints,\n// log tails, heartbeat.\n//\n// Reads ONLY the typed projection (`SubscribableState`). Calls the\n// pure derivation helpers in `display-derivation.ts` for every visible\n// cell. The dashboard does NOT subscribe to the SubscriptionRef\n// itself — `app.tsx` owns the subscription and feeds `state` in as a\n// prop. This keeps the dashboard pure-render-of-state, which is what\n// the architecture's \"frame stability\" invariant requires.\n\nimport { Box, Static, Text } from 'ink';\nimport type React from 'react';\n\nimport type { SnapshotCaptureProgressPhase } from '../../substrate/events.ts';\nimport type { SubscribableState } from '../../substrate/projection.ts';\nimport type { EventLogLine } from './event-log.ts';\nimport { Heartbeat } from './heartbeat.tsx';\nimport { ResourceTables } from './resource-table.tsx';\nimport { dashboardSummaryLine, deriveDashboardSummary } from './display-derivation.ts';\n\nconst phaseColor = (\n\tphase: SubscribableState['cycle']['phase'],\n): 'green' | 'yellow' | 'red' | 'white' => {\n\tswitch (phase) {\n\t\tcase 'running':\n\t\t\treturn 'green';\n\t\tcase 'booting':\n\t\tcase 'restarting':\n\t\t\treturn 'yellow';\n\t\tcase 'shutting-down':\n\t\t\treturn 'red';\n\t\tdefault:\n\t\t\treturn 'white';\n\t}\n};\n\nexport interface DashboardProps {\n\treadonly state: SubscribableState;\n\treadonly eventLog: ReadonlyArray<EventLogLine>;\n\treadonly snapshotPromptValue: string | null;\n\treadonly snapshotStatus: SnapshotStatus | null;\n}\n\nexport type SnapshotStatus =\n\t| {\n\t\t\treadonly tag: 'running';\n\t\t\treadonly phase: SnapshotCaptureProgressPhase | 'starting';\n\t\t\treadonly snapshotId?: string;\n\t\t\treadonly name?: string;\n\t\t\treadonly detail?: string;\n\t\t\treadonly pausedContainers?: number;\n\t\t\treadonly totalContainers?: number;\n\t\t\treadonly at: number;\n\t  }\n\t| {\n\t\t\treadonly tag: 'captured';\n\t\t\treadonly snapshotId: string;\n\t\t\treadonly name?: string;\n\t\t\treadonly at: number;\n\t  }\n\t| {\n\t\t\treadonly tag: 'skipped';\n\t\t\treadonly reason: 'already-running';\n\t\t\treadonly at: number;\n\t  }\n\t| {\n\t\t\treadonly tag: 'failed';\n\t\t\treadonly snapshotId?: string;\n\t\t\treadonly name?: string;\n\t\t\treadonly summary: string;\n\t\t\treadonly at: number;\n\t  };\n\nconst logMessageColor = (level: EventLogLine['level']): 'white' | 'yellow' | 'red' => {\n\tswitch (level) {\n\t\tcase 'info':\n\t\t\treturn 'white';\n\t\tcase 'warn':\n\t\t\treturn 'yellow';\n\t\tcase 'error':\n\t\t\treturn 'red';\n\t}\n};\n\nconst healthColor = (\n\thealth: ReturnType<typeof deriveDashboardSummary>['health'],\n): 'green' | 'yellow' | 'red' | 'white' => {\n\tswitch (health) {\n\t\tcase 'ready':\n\t\t\treturn 'green';\n\t\tcase 'active':\n\t\t\treturn 'yellow';\n\t\tcase 'blocked':\n\t\t\treturn 'red';\n\t\tcase 'empty':\n\t\t\treturn 'white';\n\t}\n};\n\nconst snapshotLabel = (status: SnapshotStatus): string => {\n\tif ('name' in status && status.name !== undefined) return status.name;\n\tif ('snapshotId' in status && status.snapshotId !== undefined) return status.snapshotId;\n\treturn 'manual snapshot';\n};\n\nconst snapshotPhaseLabel = (phase: SnapshotCaptureProgressPhase | 'starting'): string => {\n\tswitch (phase) {\n\t\tcase 'starting':\n\t\t\treturn 'starting';\n\t\tcase 'quiescing':\n\t\t\treturn 'checking participants';\n\t\tcase 'pausing':\n\t\t\treturn 'pausing containers';\n\t\tcase 'paused':\n\t\t\treturn 'stack paused';\n\t\tcase 'capturing-containers':\n\t\t\treturn 'capturing containers';\n\t\tcase 'saving-images':\n\t\t\treturn 'saving images';\n\t\tcase 'capturing-host-tree':\n\t\t\treturn 'capturing files';\n\t\tcase 'saving-state':\n\t\t\treturn 'saving state';\n\t\tcase 'saving-contributions':\n\t\t\treturn 'saving metadata';\n\t\tcase 'writing-metadata':\n\t\t\treturn 'finalizing';\n\t\tcase 'resuming':\n\t\t\treturn 'resuming stack';\n\t}\n};\n\nconst snapshotPhaseMeansPaused = (phase: SnapshotCaptureProgressPhase | 'starting'): boolean =>\n\tphase === 'paused' ||\n\tphase === 'capturing-containers' ||\n\tphase === 'saving-images' ||\n\tphase === 'capturing-host-tree' ||\n\tphase === 'saving-state' ||\n\tphase === 'saving-contributions' ||\n\tphase === 'writing-metadata' ||\n\tphase === 'resuming';\n\nconst SnapshotStatusLine = ({ status }: { readonly status: SnapshotStatus }): React.JSX.Element => {\n\tswitch (status.tag) {\n\t\tcase 'running': {\n\t\t\tconst paused = snapshotPhaseMeansPaused(status.phase);\n\t\t\tconst count =\n\t\t\t\tstatus.pausedContainers !== undefined && status.totalContainers !== undefined\n\t\t\t\t\t? `${status.pausedContainers}/${status.totalContainers}`\n\t\t\t\t\t: null;\n\t\t\treturn (\n\t\t\t\t<Box flexDirection=\"row\" gap={1} marginTop={1}>\n\t\t\t\t\t<Text color={paused ? 'yellow' : 'cyan'}>Snapshot:</Text>\n\t\t\t\t\t<Text>{snapshotLabel(status)}</Text>\n\t\t\t\t\t<Text color={paused ? 'yellow' : 'cyan'}>{snapshotPhaseLabel(status.phase)}</Text>\n\t\t\t\t\t{paused && <Text color=\"yellow\">stack paused</Text>}\n\t\t\t\t\t{count !== null && <Text dimColor>{count}</Text>}\n\t\t\t\t\t{status.detail !== undefined && <Text dimColor>{status.detail}</Text>}\n\t\t\t\t</Box>\n\t\t\t);\n\t\t}\n\t\tcase 'captured':\n\t\t\treturn (\n\t\t\t\t<Box flexDirection=\"row\" gap={1} marginTop={1}>\n\t\t\t\t\t<Text color=\"green\">Snapshot:</Text>\n\t\t\t\t\t<Text>{snapshotLabel(status)}</Text>\n\t\t\t\t\t<Text color=\"green\">saved</Text>\n\t\t\t\t\t<Text dimColor>{status.snapshotId}</Text>\n\t\t\t\t</Box>\n\t\t\t);\n\t\tcase 'skipped':\n\t\t\treturn (\n\t\t\t\t<Box flexDirection=\"row\" gap={1} marginTop={1}>\n\t\t\t\t\t<Text color=\"yellow\">Snapshot:</Text>\n\t\t\t\t\t<Text color=\"yellow\">capture already running</Text>\n\t\t\t\t</Box>\n\t\t\t);\n\t\tcase 'failed':\n\t\t\treturn (\n\t\t\t\t<Box flexDirection=\"row\" gap={1} marginTop={1}>\n\t\t\t\t\t<Text color=\"red\">Snapshot:</Text>\n\t\t\t\t\t<Text>{snapshotLabel(status)}</Text>\n\t\t\t\t\t<Text color=\"red\">failed</Text>\n\t\t\t\t\t<Text dimColor>{status.summary}</Text>\n\t\t\t\t</Box>\n\t\t\t);\n\t}\n};\n\nexport const Dashboard = ({\n\tstate,\n\teventLog,\n\tsnapshotPromptValue,\n\tsnapshotStatus,\n}: DashboardProps): React.JSX.Element => {\n\tconst { identity, cycle, rows, endpoints, accounts, packages } = state;\n\tconst summary = deriveDashboardSummary(state);\n\n\treturn (\n\t\t<Box flexDirection=\"column\">\n\t\t\t{eventLog.length > 0 && (\n\t\t\t\t<Static items={[...eventLog]}>\n\t\t\t\t\t{(entry) => (\n\t\t\t\t\t\t<Box key={entry.id} flexDirection=\"row\" gap={1}>\n\t\t\t\t\t\t\t<Text dimColor>{entry.time}</Text>\n\t\t\t\t\t\t\t<Text color={entry.scopeColor}>{entry.scope}</Text>\n\t\t\t\t\t\t\t<Text color={logMessageColor(entry.level)}>{entry.message}</Text>\n\t\t\t\t\t\t</Box>\n\t\t\t\t\t)}\n\t\t\t\t</Static>\n\t\t\t)}\n\n\t\t\t{state.stackBuild.length > 0 && (\n\t\t\t\t<Static items={[...state.stackBuild]}>\n\t\t\t\t\t{(entry, idx) => (\n\t\t\t\t\t\t<Text key={idx} dimColor>\n\t\t\t\t\t\t\t[build] {entry.pluginKey ?? '<stack>'} - {entry.phase} {entry.progress}\n\t\t\t\t\t\t</Text>\n\t\t\t\t\t)}\n\t\t\t\t</Static>\n\t\t\t)}\n\n\t\t\t{/* Header — identity + cycle + heartbeat */}\n\t\t\t<Box flexDirection=\"row\" gap={2} marginTop={1}>\n\t\t\t\t<Text bold color=\"cyan\">\n\t\t\t\t\t{identity.app}/{identity.stack}\n\t\t\t\t</Text>\n\t\t\t\t<Text dimColor>network={identity.network}</Text>\n\t\t\t\t<Text dimColor>cycle={cycle.id}</Text>\n\t\t\t\t<Text color={phaseColor(cycle.phase)}>{cycle.phase}</Text>\n\t\t\t\t<Heartbeat />\n\t\t\t</Box>\n\t\t\t<Box>\n\t\t\t\t<Text color={healthColor(summary.health)}>{dashboardSummaryLine(summary)}</Text>\n\t\t\t</Box>\n\n\t\t\t<Box flexDirection=\"column\" marginTop={1}>\n\t\t\t\t<ResourceTables rows={rows} endpoints={endpoints} accounts={accounts} packages={packages} />\n\t\t\t</Box>\n\n\t\t\t{snapshotPromptValue !== null && (\n\t\t\t\t<Box flexDirection=\"row\" gap={1} marginTop={1}>\n\t\t\t\t\t<Text color=\"cyan\">Snapshot name:</Text>\n\t\t\t\t\t<Text>{snapshotPromptValue.length === 0 ? '<auto>' : snapshotPromptValue}</Text>\n\t\t\t\t\t<Text inverse> </Text>\n\t\t\t\t\t<Text dimColor>Enter save Esc cancel</Text>\n\t\t\t\t</Box>\n\t\t\t)}\n\n\t\t\t{snapshotStatus !== null && <SnapshotStatusLine status={snapshotStatus} />}\n\n\t\t\t{/* Footer — commands. */}\n\t\t\t<Box flexDirection=\"row\" gap={2} marginTop={1}>\n\t\t\t\t<Text>[q] quit</Text>\n\t\t\t\t<Text>[r] restart stack</Text>\n\t\t\t\t<Text>[s] snapshot name</Text>\n\t\t\t</Box>\n\t\t</Box>\n\t);\n};\n"],"mappings":"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"}