@mysten-incubation/devstack 0.0.0

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

@@ -0,0 +1,395 @@
+//#region src/surfaces/tui/display-derivation.ts
+const ROW_SECTION_CLASSIFIERS = [
+	{
+		prefixes: ["package:", "package/"],
+		section: "package"
+	},
+	{
+		prefixes: ["account/"],
+		section: "account"
+	},
+	{
+		prefixes: ["action:", "action/"],
+		section: "action"
+	},
+	{
+		prefixes: ["coin:"],
+		section: "action"
+	},
+	{
+		prefixes: ["app:", "app/"],
+		section: "app",
+		endpointSection: "service"
+	},
+	{
+		prefixes: ["host-service/"],
+		section: "service"
+	},
+	{
+		prefixes: ["sui"],
+		section: "service"
+	},
+	{
+		prefixes: ["wallet"],
+		section: "service"
+	},
+	{
+		prefixes: ["walrus:", "walrus/"],
+		section: "service"
+	},
+	{
+		prefixes: ["seal:", "seal/"],
+		section: "service"
+	},
+	{
+		prefixes: ["deepbook:", "deepbook/"],
+		section: "service"
+	},
+	{
+		prefixes: ["postgres"],
+		section: "service"
+	},
+	{
+		prefixes: ["faucet"],
+		section: "service"
+	}
+];
+/** Pure: status → ANSI glyph. */
+const statusGlyph = (status) => {
+	switch (status) {
+		case "pending": return "○";
+		case "acquiring": return "◐";
+		case "ready": return "●";
+		case "failed": return "✖";
+		case "stopping": return "◑";
+		case "stopped": return "◌";
+		case "done": return "✓";
+		default: return "?";
+	}
+};
+/** Pure: status → color token. */
+const statusColor = (status) => {
+	switch (status) {
+		case "pending": return "white";
+		case "acquiring": return "yellow";
+		case "ready": return "green";
+		case "failed": return "red";
+		case "stopping": return "yellow";
+		case "stopped": return "white";
+		case "done": return "green";
+		default: return "white";
+	}
+};
+/** Pure: status → short operator-facing label. */
+const statusLabel = (status) => {
+	switch (status) {
+		case "pending": return "pending";
+		case "acquiring": return "starting";
+		case "ready": return "ready";
+		case "failed": return "failed";
+		case "stopping": return "stopping";
+		case "stopped": return "stopped";
+		case "done": return "done";
+		default: return "unknown";
+	}
+};
+/** Pure: role -> ANSI glyph. */
+const roleGlyph = (role) => {
+	switch (role) {
+		case "service": return "⚙";
+		case "task": return "⚡";
+		default: return "?";
+	}
+};
+/** Pure: role -> short label. */
+const roleLabel = (role) => {
+	switch (role) {
+		case "service": return "service";
+		case "task": return "task";
+		default: return "unknown";
+	}
+};
+/** Pure: role -> label color token. */
+const roleLabelColor = (role) => {
+	switch (role) {
+		case "service": return "cyan";
+		case "task": return "magenta";
+		default: return "white";
+	}
+};
+/**
+* Compute a human-friendly row label from the opaque branded plugin
+* key. The substrate keeps `key` an opaque digest; the renderer is
+* the layer that interprets it. We strip a few conventional prefixes
+* (`devstack:`, `app:`) plus instance counters so common cases read
+* cleanly.
+*
+* The function consumes `key` only — never `row.title`, which doesn't
+* exist in the projection.
+*/
+const labelForRow = (key) => {
+	const normalized = normalizeKey(key);
+	const parts = normalized.split(/[/:]/).filter((part) => part.length > 0);
+	if (parts.length >= 2 && isSectionish(parts[0])) return humanizeToken(parts[parts.length - 1]);
+	return humanizeToken(parts[parts.length - 1] ?? normalized);
+};
+const ownerForRow = (key) => {
+	const first = normalizeKey(key).split(/[/:._#-]/).find((part) => part.length > 0);
+	return first === void 0 ? "plugin" : humanizeToken(first);
+};
+const sectionForRow = (row, endpoints = []) => {
+	const normalized = normalizeClassificationKey(row.key).toLowerCase();
+	const ownsEndpoint = endpointsForRow(row, endpoints).length > 0 || row.endpoints.length > 0;
+	const classifier = rowSectionClassifierFor(normalized);
+	if (classifier !== void 0) {
+		if (ownsEndpoint && classifier.endpointSection !== void 0) return classifier.endpointSection;
+		return classifier.section;
+	}
+	if (row.role === "service" || ownsEndpoint) return "service";
+	if (row.role === "task") return "action";
+	return "other";
+};
+const sectionLabel = (section) => {
+	switch (section) {
+		case "service": return "Services";
+		case "package": return "Packages";
+		case "account": return "Accounts";
+		case "action": return "Actions";
+		case "app": return "App";
+		case "other": return "Other";
+		default: return "Other";
+	}
+};
+const endpointsForRow = (row, endpoints) => endpoints.filter((endpoint) => row.endpoints.includes(endpoint.endpointKey) || endpoint.endpointKey.startsWith(row.key));
+const OPERATIONAL_ENDPOINT_FIELDS = new Set([
+	"url",
+	"rpcUrl",
+	"faucetUrl",
+	"graphqlUrl"
+]);
+const visibleEndpointsForRow = (row, endpoints) => {
+	const rowEndpoints = endpointsForRow(row, endpoints);
+	const routed = rowEndpoints.filter((endpoint) => !isOperationalEndpoint(row.key, endpoint));
+	return routed.length > 0 ? routed : rowEndpoints;
+};
+const headlineForRow = (row, endpoints = []) => {
+	const rowEndpoints = visibleEndpointsForRow(row, endpoints);
+	if (rowEndpoints.length > 0) return endpointLine(rowEndpoints[0]);
+	if (row.lastError !== null && row.status === "failed") return errorSummaryFor(row.lastError);
+	return narrationFor(row.phase, row.status);
+};
+const secondaryForRow = (row, endpoints = []) => {
+	const out = [];
+	const rowEndpoints = endpointsForRow(row, endpoints);
+	for (const endpoint of rowEndpoints.slice(1)) out.push(endpointLine(endpoint));
+	if (row.logTail.truncated) out.push("log tail truncated");
+	return out;
+};
+const groupRows = (rows, endpoints = []) => {
+	const buckets = /* @__PURE__ */ new Map();
+	for (const row of rows) {
+		const cells = deriveDisplayCells(row, endpoints);
+		const list = buckets.get(cells.section) ?? [];
+		list.push({
+			row,
+			cells
+		});
+		buckets.set(cells.section, list);
+	}
+	return [
+		"service",
+		"package",
+		"account",
+		"action",
+		"app",
+		"other"
+	].filter((section) => buckets.has(section)).map((section) => ({
+		key: section,
+		label: sectionLabel(section),
+		rows: buckets.get(section) ?? []
+	}));
+};
+const deriveDashboardSummary = (state) => {
+	const readyRows = state.rows.filter((row) => row.status === "ready" || row.status === "done").length;
+	const activeRows = state.rows.filter((row) => row.status === "acquiring" || row.status === "stopping").length;
+	const failedRows = state.rows.filter((row) => row.status === "failed").length;
+	const waitingRows = state.rows.filter((row) => row.status === "pending" || row.status === "stopped").length;
+	const health = state.rows.length === 0 ? "empty" : failedRows > 0 ? "blocked" : activeRows > 0 || waitingRows > 0 ? "active" : "ready";
+	return {
+		totalRows: state.rows.length,
+		readyRows,
+		activeRows,
+		failedRows,
+		waitingRows,
+		endpointCount: visibleEndpointCount(state.rows, state.endpoints),
+		accountCount: state.accounts.length,
+		packageCount: state.packages.length,
+		errorCount: state.errors.length,
+		health
+	};
+};
+const visibleEndpointCount = (rows, endpoints) => {
+	const rowOwned = /* @__PURE__ */ new Set();
+	const visible = /* @__PURE__ */ new Set();
+	for (const row of rows) {
+		for (const endpoint of endpointsForRow(row, endpoints)) rowOwned.add(endpoint.endpointKey);
+		for (const endpoint of visibleEndpointsForRow(row, endpoints)) visible.add(endpoint.endpointKey);
+	}
+	for (const endpoint of endpoints) if (!rowOwned.has(endpoint.endpointKey)) visible.add(endpoint.endpointKey);
+	return visible.size;
+};
+const dashboardSummaryLine = (summary) => [
+	`${summary.readyRows}/${summary.totalRows} ready`,
+	summary.activeRows > 0 ? `${summary.activeRows} active` : null,
+	summary.waitingRows > 0 ? `${summary.waitingRows} waiting` : null,
+	summary.failedRows > 0 ? `${summary.failedRows} failed` : null,
+	`${summary.endpointCount} urls`,
+	`${summary.accountCount} accounts`,
+	summary.packageCount > 0 ? `${summary.packageCount} packages` : null,
+	summary.errorCount === 0 ? "no errors" : `${summary.errorCount} errors`
+].filter((part) => part !== null).join("  ");
+/**
+* Pure: phase narration string → renderable verb form. Phase is
+* free-form upstream (Tension 14). The renderer's job is to make it
+* legible; we keep this minimal — single-line, no fancy verb tense
+* inference. The truncation cap protects against pathological long
+* narrations.
+*/
+const narrationFor = (phase, status) => {
+	if (phase === null || phase.trim().length === 0) return status === "acquiring" ? "starting…" : "";
+	const trimmed = phase.trim();
+	const TRUNC = 80;
+	return trimmed.length > TRUNC ? `${trimmed.slice(0, TRUNC - 1)}…` : trimmed;
+};
+const ERR_SUMMARY_TRUNC = 120;
+/**
+* Pure: `Row.lastError` → renderable in-row summary. Keep it short;
+* detailed error context belongs in the activity/log stream.
+*/
+const errorSummaryFor = (error) => {
+	if (error === null) return "";
+	const head = `${error.tag}: ${error.summary}`;
+	const detail = error.chain.find((line) => line !== head && line !== error.tag);
+	const compactDetail = detail === void 0 ? void 0 : detail.replace(/^[A-Za-z0-9_[\]-]+:\s*/, "");
+	const summary = compactDetail === void 0 ? head : `${head}: ${compactDetail}`;
+	return summary.length > ERR_SUMMARY_TRUNC ? `${summary.slice(0, ERR_SUMMARY_TRUNC - 1)}…` : summary;
+};
+/**
+* Pure: `Endpoint` → renderable line. Renderers prefer `displayUrl`
+* when set (codegen-friendly variant), falling back to `url`.
+*/
+const endpointLine = (endpoint) => {
+	const target = endpoint.displayUrl ?? endpoint.url;
+	const backing = endpoint.displayUrl !== null && endpoint.displayUrl !== endpoint.url ? ` -> ${endpoint.url}` : "";
+	const protocol = endpoint.wireProtocol === "http" ? "" : ` [${endpoint.wireProtocol}]`;
+	return `${endpoint.name}: ${target}${backing}${protocol}`;
+};
+const accountLine = (account) => {
+	const address = account.address ?? "<pending>";
+	const scheme = account.scheme ?? "scheme pending";
+	const source = account.source ?? "source pending";
+	const funding = accountFundingLine(account.funding);
+	const wallet = account.walletVisible ? "wallet" : null;
+	return [
+		humanizeToken(account.name),
+		address,
+		scheme,
+		source,
+		funding,
+		wallet
+	].filter((part) => part !== null && part.length > 0).join("  ");
+};
+const packageLine = (pkg) => {
+	return [
+		humanizeToken(pkg.name),
+		pkg.packageId,
+		pkg.mvrPlaceholder,
+		pkg.kind
+	].filter((part) => part !== null && part.length > 0).join("  ");
+};
+const accountCells = (account) => ({
+	name: humanizeToken(account.name),
+	address: account.address ?? "<pending>",
+	scheme: account.scheme ?? "pending",
+	source: account.source ?? "pending",
+	funding: accountFundingLine(account.funding)
+});
+const accountFundingLine = (funding) => {
+	const entries = funding.entries ?? [];
+	if (entries.length > 0) {
+		const rendered = entries.map((entry) => `${entry.coin}:${entry.amount}${entry.status === "skipped" ? " skipped" : ""}`).join(", ");
+		return funding.status === "funded" ? `funded ${rendered}` : `funding ${rendered}`;
+	}
+	switch (funding.status) {
+		case "pending": return funding.requestedMist === null ? "funding pending" : `funding ${funding.requestedMist}`;
+		case "funded": return funding.balanceMist !== null ? `funded ${funding.balanceMist}` : funding.requestedMist !== null ? `funded ${funding.requestedMist}` : "funded";
+		case "skipped": return "funding skipped";
+		case "failed": return "funding failed";
+		case "unknown": return "funding unknown";
+		default:
+			funding.status;
+			return "";
+	}
+};
+const packageCells = (pkg) => ({
+	name: humanizeToken(pkg.name),
+	packageId: pkg.packageId,
+	mvr: pkg.mvrPlaceholder,
+	kind: pkg.kind,
+	detail: pkg.kind
+});
+/**
+* Derive every visible display cell for a single row.
+*
+* Consumes ONLY `row.key`, `row.role`, `row.status`, `row.phase`,
+* `row.lastError`, `row.endpoints` (rendered separately by
+* `resource-table.tsx`), or `row.logTail` (kept in the projection
+* for renderer variants that need tails, but not used as primary
+* dashboard state because generic lifecycle log lines duplicate the
+* table).
+*/
+const deriveDisplayCells = (row, endpoints = []) => ({
+	statusGlyph: statusGlyph(row.status),
+	statusColor: statusColor(row.status),
+	statusLabel: statusLabel(row.status),
+	roleGlyph: roleGlyph(row.role),
+	roleLabel: roleLabel(row.role),
+	label: labelForRow(row.key),
+	narration: narrationFor(row.phase, row.status),
+	errorSummary: errorSummaryFor(row.lastError),
+	labelColor: roleLabelColor(row.role),
+	section: sectionForRow(row, endpoints),
+	owner: ownerForRow(row.key),
+	headline: headlineForRow(row, endpoints),
+	secondary: secondaryForRow(row, endpoints)
+});
+const normalizeKey = (key) => key.replace(/^@devstack\//, "").replace(/^(devstack:|app:)/, "").replace(/#\d+$/, "").replace(/\/\d+$/, "");
+const normalizeClassificationKey = (key) => key.replace(/^@devstack\//, "").replace(/^devstack:/, "").replace(/#\d+$/, "").replace(/\/\d+$/, "");
+const humanizeToken = (token) => token.replace(/[-_]+/g, " ").replace(/^\w/, (head) => head.toUpperCase());
+const containsKeyPart = (key, parts) => {
+	return key.split(/[/:._#-]/).filter((part) => part.length > 0).some((token) => parts.includes(token));
+};
+const isSectionish = (token) => containsKeyPart(token.toLowerCase(), [
+	"service",
+	"package",
+	"account",
+	"action",
+	"app"
+]);
+const rowSectionClassifierFor = (key) => ROW_SECTION_CLASSIFIERS.find((classifier) => classifier.prefixes.some((prefix) => keyMatchesClassifierPrefix(key, prefix)));
+const keyMatchesClassifierPrefix = (key, prefix) => {
+	if (prefix.endsWith(":") || prefix.endsWith("/")) return key.startsWith(prefix);
+	if (key === prefix) return true;
+	const next = key[prefix.length];
+	return key.startsWith(prefix) && next !== void 0 && "/:._-".includes(next);
+};
+const isOperationalEndpoint = (rowKey, endpoint) => {
+	const prefix = `${rowKey}:`;
+	if (!endpoint.endpointKey.startsWith(prefix)) return false;
+	const field = endpoint.endpointKey.slice(prefix.length);
+	return OPERATIONAL_ENDPOINT_FIELDS.has(field);
+};
+//#endregion
+export { accountCells, accountLine, dashboardSummaryLine, deriveDashboardSummary, deriveDisplayCells, endpointLine, errorSummaryFor, groupRows, labelForRow, packageCells, packageLine, roleLabel, statusLabel, visibleEndpointsForRow };
+
+//# sourceMappingURL=display-derivation.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"display-derivation.mjs","names":[],"sources":["../../../src/surfaces/tui/display-derivation.ts"],"sourcesContent":["// Display derivation — the load-bearing transducer that makes the\n// \"no display vocab in projection\" invariant testable.\n//\n// The renderer consumes ONLY the typed projection (`Row`, `Endpoint`,\n// `StructuredError`, `LifecycleStatus`, `PluginRole`, ...) from\n// `substrate/projection.ts`. Every visible glyph, color, label, and\n// narration string is computed HERE from `row.role`, `row.status`,\n// `row.phase`, `row.lastError`, etc.\n//\n// HARD INVARIANT: this module never reads a field named `title`,\n// `primary`, or `extras` — those fields don't exist on the projection\n// (the substrate's `__ProjectionFieldsClosed` guard fails to compile\n// if they did). The TUI's test of that invariant is: every visible\n// cell rendered by `resource-table.tsx` flows through one of these pure\n// functions.\n//\n// Pure. No Effect, no IO, no clocks. Input typed projection → output\n// strings + enum-y \"color tokens\" (resolved to terminal colors by the\n// Ink layer via `Text color={…}`).\n\nimport type { LifecycleStatus, PhaseNarration, PluginRole } from '../../substrate/lifecycle.ts';\nimport type {\n\tAccountProjection,\n\tEndpoint,\n\tPackageProjection,\n\tRow,\n\tStructuredError,\n\tSubscribableState,\n} from '../../substrate/projection.ts';\n\n// -----------------------------------------------------------------------------\n// Color tokens\n// -----------------------------------------------------------------------------\n\n/**\n * Closed set of color tokens the TUI uses. Ink resolves these to ANSI\n * sequences. NO_COLOR / FORCE_COLOR / TERM=dumb are honored by Ink's\n * defaults (Tension: TUI must not override user color preferences).\n */\nexport type ColorToken = 'yellow' | 'green' | 'red' | 'magenta' | 'cyan' | 'blueBright' | 'white';\n\n// -----------------------------------------------------------------------------\n// Display cells — the public output shape of this module\n// -----------------------------------------------------------------------------\n\n/**\n * Per-row display cells the row renderer consumes. None of these\n * fields are read from the projection — they are computed from\n * `Row.role` + `Row.status` + `Row.phase` + `Row.lastError`.\n *\n * Naming note: we DELIBERATELY avoid the words `title`, `primary`,\n * `extras` in this type's field names to make the invariant grep-able.\n * `label` is computed from `key`; `narration` from `phase`;\n * `summary` from `lastError`.\n */\nexport interface DisplayCells {\n\t/** Status glyph (single char). */\n\treadonly statusGlyph: string;\n\t/** Status color token. */\n\treadonly statusColor: ColorToken;\n\t/** Status label (short verbal, e.g. \"ready\"). */\n\treadonly statusLabel: string;\n\t/** Role glyph (single char). */\n\treadonly roleGlyph: string;\n\t/** Role label (e.g. \"service\"). */\n\treadonly roleLabel: string;\n\t/** Computed row label — derived from `row.key`, not from any\n\t *  projection-side `title`. */\n\treadonly label: string;\n\t/** Narration line — formatted from `row.phase`. */\n\treadonly narration: string;\n\t/** Error summary — formatted from `row.lastError`. */\n\treadonly errorSummary: string;\n\t/** Color the row's label should render in (role-derived,\n\t *  optionally tinted by status). */\n\treadonly labelColor: ColorToken;\n\t/** Group bucket for dashboard sectioning. */\n\treadonly section: RowSection;\n\t/** Plugin-owner chip derived from the row key. */\n\treadonly owner: string;\n\t/** Main row value: usually the first endpoint or latest useful line. */\n\treadonly headline: string;\n\t/** Secondary details visible in the detail pane. */\n\treadonly secondary: ReadonlyArray<string>;\n}\n\nexport type RowSection = 'service' | 'package' | 'account' | 'action' | 'app' | 'other';\n\ninterface RowSectionClassifier {\n\treadonly prefixes: ReadonlyArray<string>;\n\treadonly section: RowSection;\n\treadonly endpointSection?: RowSection;\n}\n\nconst ROW_SECTION_CLASSIFIERS = [\n\t{ prefixes: ['package:', 'package/'], section: 'package' },\n\t{ prefixes: ['account/'], section: 'account' },\n\t{ prefixes: ['action:', 'action/'], section: 'action' },\n\t{ prefixes: ['coin:'], section: 'action' },\n\t{ prefixes: ['app:', 'app/'], section: 'app', endpointSection: 'service' },\n\t{ prefixes: ['host-service/'], section: 'service' },\n\t{ prefixes: ['sui'], section: 'service' },\n\t{ prefixes: ['wallet'], section: 'service' },\n\t{ prefixes: ['walrus:', 'walrus/'], section: 'service' },\n\t{ prefixes: ['seal:', 'seal/'], section: 'service' },\n\t{ prefixes: ['deepbook:', 'deepbook/'], section: 'service' },\n\t{ prefixes: ['postgres'], section: 'service' },\n\t{ prefixes: ['faucet'], section: 'service' },\n] as const satisfies ReadonlyArray<RowSectionClassifier>;\n\nexport interface DisplayRow {\n\treadonly row: Row;\n\treadonly cells: DisplayCells;\n}\n\nexport interface DisplaySection {\n\treadonly key: RowSection;\n\treadonly label: string;\n\treadonly rows: ReadonlyArray<DisplayRow>;\n}\n\nexport interface DashboardSummary {\n\treadonly totalRows: number;\n\treadonly readyRows: number;\n\treadonly activeRows: number;\n\treadonly failedRows: number;\n\treadonly waitingRows: number;\n\treadonly endpointCount: number;\n\treadonly accountCount: number;\n\treadonly packageCount: number;\n\treadonly errorCount: number;\n\treadonly health: 'ready' | 'active' | 'blocked' | 'empty';\n}\n\n// -----------------------------------------------------------------------------\n// Status → glyph / color / label\n// -----------------------------------------------------------------------------\n\n/** Pure: status → ANSI glyph. */\nexport const statusGlyph = (status: LifecycleStatus): string => {\n\tswitch (status) {\n\t\tcase 'pending':\n\t\t\treturn '○';\n\t\tcase 'acquiring':\n\t\t\treturn '◐';\n\t\tcase 'ready':\n\t\t\treturn '●';\n\t\tcase 'failed':\n\t\t\treturn '✖';\n\t\tcase 'stopping':\n\t\t\treturn '◑';\n\t\tcase 'stopped':\n\t\t\treturn '◌';\n\t\tcase 'done':\n\t\t\treturn '✓';\n\t\tdefault: {\n\t\t\tconst _exhaustive: never = status;\n\t\t\tvoid _exhaustive;\n\t\t\treturn '?';\n\t\t}\n\t}\n};\n\n/** Pure: status → color token. */\nexport const statusColor = (status: LifecycleStatus): ColorToken => {\n\tswitch (status) {\n\t\tcase 'pending':\n\t\t\treturn 'white';\n\t\tcase 'acquiring':\n\t\t\treturn 'yellow';\n\t\tcase 'ready':\n\t\t\treturn 'green';\n\t\tcase 'failed':\n\t\t\treturn 'red';\n\t\tcase 'stopping':\n\t\t\treturn 'yellow';\n\t\tcase 'stopped':\n\t\t\treturn 'white';\n\t\tcase 'done':\n\t\t\treturn 'green';\n\t\tdefault: {\n\t\t\tconst _exhaustive: never = status;\n\t\t\tvoid _exhaustive;\n\t\t\treturn 'white';\n\t\t}\n\t}\n};\n\n/** Pure: status → short operator-facing label. */\nexport const statusLabel = (status: LifecycleStatus): string => {\n\tswitch (status) {\n\t\tcase 'pending':\n\t\t\treturn 'pending';\n\t\tcase 'acquiring':\n\t\t\treturn 'starting';\n\t\tcase 'ready':\n\t\t\treturn 'ready';\n\t\tcase 'failed':\n\t\t\treturn 'failed';\n\t\tcase 'stopping':\n\t\t\treturn 'stopping';\n\t\tcase 'stopped':\n\t\t\treturn 'stopped';\n\t\tcase 'done':\n\t\t\treturn 'done';\n\t\tdefault: {\n\t\t\tconst _exhaustive: never = status;\n\t\t\tvoid _exhaustive;\n\t\t\treturn 'unknown';\n\t\t}\n\t}\n};\n\n// -----------------------------------------------------------------------------\n// Role -> glyph / label / color\n// -----------------------------------------------------------------------------\n\n/** Pure: role -> ANSI glyph. */\nexport const roleGlyph = (role: PluginRole): string => {\n\tswitch (role) {\n\t\tcase 'service':\n\t\t\treturn '⚙';\n\t\tcase 'task':\n\t\t\treturn '⚡';\n\t\tdefault: {\n\t\t\tconst _exhaustive: never = role;\n\t\t\tvoid _exhaustive;\n\t\t\treturn '?';\n\t\t}\n\t}\n};\n\n/** Pure: role -> short label. */\nexport const roleLabel = (role: PluginRole): string => {\n\tswitch (role) {\n\t\tcase 'service':\n\t\t\treturn 'service';\n\t\tcase 'task':\n\t\t\treturn 'task';\n\t\tdefault: {\n\t\t\tconst _exhaustive: never = role;\n\t\t\tvoid _exhaustive;\n\t\t\treturn 'unknown';\n\t\t}\n\t}\n};\n\n/** Pure: role -> label color token. */\nexport const roleLabelColor = (role: PluginRole): ColorToken => {\n\tswitch (role) {\n\t\tcase 'service':\n\t\t\treturn 'cyan';\n\t\tcase 'task':\n\t\t\treturn 'magenta';\n\t\tdefault: {\n\t\t\tconst _exhaustive: never = role;\n\t\t\tvoid _exhaustive;\n\t\t\treturn 'white';\n\t\t}\n\t}\n};\n\n// -----------------------------------------------------------------------------\n// Row label — derived from `key`, not from any pre-baked title\n// -----------------------------------------------------------------------------\n\n/**\n * Compute a human-friendly row label from the opaque branded plugin\n * key. The substrate keeps `key` an opaque digest; the renderer is\n * the layer that interprets it. We strip a few conventional prefixes\n * (`devstack:`, `app:`) plus instance counters so common cases read\n * cleanly.\n *\n * The function consumes `key` only — never `row.title`, which doesn't\n * exist in the projection.\n */\nexport const labelForRow = (key: string): string => {\n\tconst normalized = normalizeKey(key);\n\tconst parts = normalized.split(/[/:]/).filter((part) => part.length > 0);\n\tif (parts.length >= 2 && isSectionish(parts[0]!)) return humanizeToken(parts[parts.length - 1]!);\n\treturn humanizeToken(parts[parts.length - 1] ?? normalized);\n};\n\nexport const ownerForRow = (key: string): string => {\n\tconst normalized = normalizeKey(key);\n\tconst first = normalized.split(/[/:._#-]/).find((part) => part.length > 0);\n\treturn first === undefined ? 'plugin' : humanizeToken(first);\n};\n\nexport const sectionForRow = (\n\trow: Pick<Row, 'key' | 'role' | 'endpoints'>,\n\tendpoints: ReadonlyArray<Endpoint> = [],\n): RowSection => {\n\tconst normalized = normalizeClassificationKey(row.key).toLowerCase();\n\tconst ownsEndpoint = endpointsForRow(row, endpoints).length > 0 || row.endpoints.length > 0;\n\tconst classifier = rowSectionClassifierFor(normalized);\n\tif (classifier !== undefined) {\n\t\tif (ownsEndpoint && classifier.endpointSection !== undefined) return classifier.endpointSection;\n\t\treturn classifier.section;\n\t}\n\tif (row.role === 'service' || ownsEndpoint) return 'service';\n\tif (row.role === 'task') return 'action';\n\treturn 'other';\n};\n\nexport const sectionLabel = (section: RowSection): string => {\n\tswitch (section) {\n\t\tcase 'service':\n\t\t\treturn 'Services';\n\t\tcase 'package':\n\t\t\treturn 'Packages';\n\t\tcase 'account':\n\t\t\treturn 'Accounts';\n\t\tcase 'action':\n\t\t\treturn 'Actions';\n\t\tcase 'app':\n\t\t\treturn 'App';\n\t\tcase 'other':\n\t\t\treturn 'Other';\n\t\tdefault: {\n\t\t\tconst _exhaustive: never = section;\n\t\t\tvoid _exhaustive;\n\t\t\treturn 'Other';\n\t\t}\n\t}\n};\n\nexport const endpointsForRow = (\n\trow: Pick<Row, 'key' | 'endpoints'>,\n\tendpoints: ReadonlyArray<Endpoint>,\n): ReadonlyArray<Endpoint> =>\n\tendpoints.filter(\n\t\t(endpoint) =>\n\t\t\trow.endpoints.includes(endpoint.endpointKey) || endpoint.endpointKey.startsWith(row.key),\n\t);\n\nconst OPERATIONAL_ENDPOINT_FIELDS = new Set(['url', 'rpcUrl', 'faucetUrl', 'graphqlUrl']);\n\nexport const visibleEndpointsForRow = (\n\trow: Pick<Row, 'key' | 'endpoints'>,\n\tendpoints: ReadonlyArray<Endpoint>,\n): ReadonlyArray<Endpoint> => {\n\tconst rowEndpoints = endpointsForRow(row, endpoints);\n\tconst routed = rowEndpoints.filter((endpoint) => !isOperationalEndpoint(row.key, endpoint));\n\treturn routed.length > 0 ? routed : rowEndpoints;\n};\n\nexport const headlineForRow = (row: Row, endpoints: ReadonlyArray<Endpoint> = []): string => {\n\tconst rowEndpoints = visibleEndpointsForRow(row, endpoints);\n\tif (rowEndpoints.length > 0) return endpointLine(rowEndpoints[0]!);\n\tif (row.lastError !== null && row.status === 'failed') return errorSummaryFor(row.lastError);\n\treturn narrationFor(row.phase, row.status);\n};\n\nexport const secondaryForRow = (\n\trow: Row,\n\tendpoints: ReadonlyArray<Endpoint> = [],\n): ReadonlyArray<string> => {\n\tconst out: Array<string> = [];\n\tconst rowEndpoints = endpointsForRow(row, endpoints);\n\tfor (const endpoint of rowEndpoints.slice(1)) out.push(endpointLine(endpoint));\n\tif (row.logTail.truncated) out.push('log tail truncated');\n\treturn out;\n};\n\nexport const groupRows = (\n\trows: ReadonlyArray<Row>,\n\tendpoints: ReadonlyArray<Endpoint> = [],\n): ReadonlyArray<DisplaySection> => {\n\tconst buckets = new Map<RowSection, Array<DisplayRow>>();\n\tfor (const row of rows) {\n\t\tconst cells = deriveDisplayCells(row, endpoints);\n\t\tconst list = buckets.get(cells.section) ?? [];\n\t\tlist.push({ row, cells });\n\t\tbuckets.set(cells.section, list);\n\t}\n\tconst order: ReadonlyArray<RowSection> = [\n\t\t'service',\n\t\t'package',\n\t\t'account',\n\t\t'action',\n\t\t'app',\n\t\t'other',\n\t];\n\treturn order\n\t\t.filter((section) => buckets.has(section))\n\t\t.map((section) => ({\n\t\t\tkey: section,\n\t\t\tlabel: sectionLabel(section),\n\t\t\trows: buckets.get(section) ?? [],\n\t\t}));\n};\n\nexport const deriveDashboardSummary = (\n\tstate: Pick<SubscribableState, 'rows' | 'endpoints' | 'accounts' | 'packages' | 'errors'>,\n): DashboardSummary => {\n\tconst readyRows = state.rows.filter(\n\t\t(row) => row.status === 'ready' || row.status === 'done',\n\t).length;\n\tconst activeRows = state.rows.filter(\n\t\t(row) => row.status === 'acquiring' || row.status === 'stopping',\n\t).length;\n\tconst failedRows = state.rows.filter((row) => row.status === 'failed').length;\n\tconst waitingRows = state.rows.filter(\n\t\t(row) => row.status === 'pending' || row.status === 'stopped',\n\t).length;\n\tconst health =\n\t\tstate.rows.length === 0\n\t\t\t? 'empty'\n\t\t\t: failedRows > 0\n\t\t\t\t? 'blocked'\n\t\t\t\t: activeRows > 0 || waitingRows > 0\n\t\t\t\t\t? 'active'\n\t\t\t\t\t: 'ready';\n\treturn {\n\t\ttotalRows: state.rows.length,\n\t\treadyRows,\n\t\tactiveRows,\n\t\tfailedRows,\n\t\twaitingRows,\n\t\tendpointCount: visibleEndpointCount(state.rows, state.endpoints),\n\t\taccountCount: state.accounts.length,\n\t\tpackageCount: state.packages.length,\n\t\terrorCount: state.errors.length,\n\t\thealth,\n\t};\n};\n\nconst visibleEndpointCount = (\n\trows: ReadonlyArray<Row>,\n\tendpoints: ReadonlyArray<Endpoint>,\n): number => {\n\tconst rowOwned = new Set<Endpoint['endpointKey']>();\n\tconst visible = new Set<Endpoint['endpointKey']>();\n\tfor (const row of rows) {\n\t\tfor (const endpoint of endpointsForRow(row, endpoints)) {\n\t\t\trowOwned.add(endpoint.endpointKey);\n\t\t}\n\t\tfor (const endpoint of visibleEndpointsForRow(row, endpoints)) {\n\t\t\tvisible.add(endpoint.endpointKey);\n\t\t}\n\t}\n\tfor (const endpoint of endpoints) {\n\t\tif (!rowOwned.has(endpoint.endpointKey)) visible.add(endpoint.endpointKey);\n\t}\n\treturn visible.size;\n};\n\nexport const dashboardSummaryLine = (summary: DashboardSummary): string =>\n\t[\n\t\t`${summary.readyRows}/${summary.totalRows} ready`,\n\t\tsummary.activeRows > 0 ? `${summary.activeRows} active` : null,\n\t\tsummary.waitingRows > 0 ? `${summary.waitingRows} waiting` : null,\n\t\tsummary.failedRows > 0 ? `${summary.failedRows} failed` : null,\n\t\t`${summary.endpointCount} urls`,\n\t\t`${summary.accountCount} accounts`,\n\t\tsummary.packageCount > 0 ? `${summary.packageCount} packages` : null,\n\t\tsummary.errorCount === 0 ? 'no errors' : `${summary.errorCount} errors`,\n\t]\n\t\t.filter((part): part is string => part !== null)\n\t\t.join('  ');\n\n// -----------------------------------------------------------------------------\n// Phase narration formatting\n// -----------------------------------------------------------------------------\n\n/**\n * Pure: phase narration string → renderable verb form. Phase is\n * free-form upstream (Tension 14). The renderer's job is to make it\n * legible; we keep this minimal — single-line, no fancy verb tense\n * inference. The truncation cap protects against pathological long\n * narrations.\n */\nexport const narrationFor = (phase: PhaseNarration | null, status: LifecycleStatus): string => {\n\tif (phase === null || phase.trim().length === 0) {\n\t\t// No phase set; surface a status-derived default for `acquiring`,\n\t\t// stay silent otherwise (Tension: don't manufacture text the\n\t\t// engine didn't ask for).\n\t\treturn status === 'acquiring' ? 'starting…' : '';\n\t}\n\tconst trimmed = phase.trim();\n\tconst TRUNC = 80;\n\treturn trimmed.length > TRUNC ? `${trimmed.slice(0, TRUNC - 1)}…` : trimmed;\n};\n\n// -----------------------------------------------------------------------------\n// Error summary formatting\n// -----------------------------------------------------------------------------\n\nconst ERR_SUMMARY_TRUNC = 120;\n\n/**\n * Pure: `Row.lastError` → renderable in-row summary. Keep it short;\n * detailed error context belongs in the activity/log stream.\n */\nexport const errorSummaryFor = (error: StructuredError | null): string => {\n\tif (error === null) return '';\n\tconst head = `${error.tag}: ${error.summary}`;\n\tconst detail = error.chain.find((line) => line !== head && line !== error.tag);\n\tconst compactDetail =\n\t\tdetail === undefined ? undefined : detail.replace(/^[A-Za-z0-9_[\\]-]+:\\s*/, '');\n\tconst summary = compactDetail === undefined ? head : `${head}: ${compactDetail}`;\n\treturn summary.length > ERR_SUMMARY_TRUNC\n\t\t? `${summary.slice(0, ERR_SUMMARY_TRUNC - 1)}…`\n\t\t: summary;\n};\n\n// -----------------------------------------------------------------------------\n// Endpoint formatting\n// -----------------------------------------------------------------------------\n\n/**\n * Pure: `Endpoint` → renderable line. Renderers prefer `displayUrl`\n * when set (codegen-friendly variant), falling back to `url`.\n */\nexport const endpointLine = (endpoint: Endpoint): string => {\n\tconst target = endpoint.displayUrl ?? endpoint.url;\n\tconst backing =\n\t\tendpoint.displayUrl !== null && endpoint.displayUrl !== endpoint.url\n\t\t\t? ` -> ${endpoint.url}`\n\t\t\t: '';\n\tconst protocol = endpoint.wireProtocol === 'http' ? '' : ` [${endpoint.wireProtocol}]`;\n\treturn `${endpoint.name}: ${target}${backing}${protocol}`;\n};\n\nexport const endpointsSummaryForRow = (\n\trow: Pick<Row, 'key' | 'endpoints'>,\n\tendpoints: ReadonlyArray<Endpoint>,\n): string => {\n\tconst rowEndpoints = visibleEndpointsForRow(row, endpoints);\n\tif (rowEndpoints.length === 0) return '';\n\treturn rowEndpoints.map(endpointLine).join(' | ');\n};\n\nexport const accountLine = (account: AccountProjection): string => {\n\tconst address = account.address ?? '<pending>';\n\tconst scheme = account.scheme ?? 'scheme pending';\n\tconst source = account.source ?? 'source pending';\n\tconst funding = accountFundingLine(account.funding);\n\tconst wallet = account.walletVisible ? 'wallet' : null;\n\treturn [humanizeToken(account.name), address, scheme, source, funding, wallet]\n\t\t.filter((part): part is string => part !== null && part.length > 0)\n\t\t.join('  ');\n};\n\nexport const packageLine = (pkg: PackageProjection): string => {\n\treturn [humanizeToken(pkg.name), pkg.packageId, pkg.mvrPlaceholder, pkg.kind]\n\t\t.filter((part): part is string => part !== null && part.length > 0)\n\t\t.join('  ');\n};\n\nexport interface AccountCells {\n\treadonly name: string;\n\treadonly address: string;\n\treadonly scheme: string;\n\treadonly source: string;\n\treadonly funding: string;\n}\n\nexport interface PackageCells {\n\treadonly name: string;\n\treadonly packageId: string;\n\treadonly mvr: string;\n\treadonly kind: string;\n\treadonly detail: string;\n}\n\nexport const accountCells = (account: AccountProjection): AccountCells => ({\n\tname: humanizeToken(account.name),\n\taddress: account.address ?? '<pending>',\n\tscheme: account.scheme ?? 'pending',\n\tsource: account.source ?? 'pending',\n\tfunding: accountFundingLine(account.funding),\n});\n\nconst accountFundingLine = (funding: AccountProjection['funding']): string => {\n\tconst entries = funding.entries ?? [];\n\tif (entries.length > 0) {\n\t\tconst rendered = entries\n\t\t\t.map(\n\t\t\t\t(entry) => `${entry.coin}:${entry.amount}${entry.status === 'skipped' ? ' skipped' : ''}`,\n\t\t\t)\n\t\t\t.join(', ');\n\t\treturn funding.status === 'funded' ? `funded ${rendered}` : `funding ${rendered}`;\n\t}\n\tswitch (funding.status) {\n\t\tcase 'pending':\n\t\t\treturn funding.requestedMist === null\n\t\t\t\t? 'funding pending'\n\t\t\t\t: `funding ${funding.requestedMist}`;\n\t\tcase 'funded':\n\t\t\treturn funding.balanceMist !== null\n\t\t\t\t? `funded ${funding.balanceMist}`\n\t\t\t\t: funding.requestedMist !== null\n\t\t\t\t\t? `funded ${funding.requestedMist}`\n\t\t\t\t\t: 'funded';\n\t\tcase 'skipped':\n\t\t\treturn 'funding skipped';\n\t\tcase 'failed':\n\t\t\treturn 'funding failed';\n\t\tcase 'unknown':\n\t\t\treturn 'funding unknown';\n\t\tdefault: {\n\t\t\tconst _exhaustive: never = funding.status;\n\t\t\tvoid _exhaustive;\n\t\t\treturn '';\n\t\t}\n\t}\n};\n\nexport const packageCells = (pkg: PackageProjection): PackageCells => ({\n\tname: humanizeToken(pkg.name),\n\tpackageId: pkg.packageId,\n\tmvr: pkg.mvrPlaceholder,\n\tkind: pkg.kind,\n\tdetail: pkg.kind,\n});\n\n// -----------------------------------------------------------------------------\n// Top-level entry point\n// -----------------------------------------------------------------------------\n\n/**\n * Derive every visible display cell for a single row.\n *\n * Consumes ONLY `row.key`, `row.role`, `row.status`, `row.phase`,\n * `row.lastError`, `row.endpoints` (rendered separately by\n * `resource-table.tsx`), or `row.logTail` (kept in the projection\n * for renderer variants that need tails, but not used as primary\n * dashboard state because generic lifecycle log lines duplicate the\n * table).\n */\nexport const deriveDisplayCells = (\n\trow: Row,\n\tendpoints: ReadonlyArray<Endpoint> = [],\n): DisplayCells => ({\n\tstatusGlyph: statusGlyph(row.status),\n\tstatusColor: statusColor(row.status),\n\tstatusLabel: statusLabel(row.status),\n\troleGlyph: roleGlyph(row.role),\n\troleLabel: roleLabel(row.role),\n\tlabel: labelForRow(row.key),\n\tnarration: narrationFor(row.phase, row.status),\n\terrorSummary: errorSummaryFor(row.lastError),\n\tlabelColor: roleLabelColor(row.role),\n\tsection: sectionForRow(row, endpoints),\n\towner: ownerForRow(row.key),\n\theadline: headlineForRow(row, endpoints),\n\tsecondary: secondaryForRow(row, endpoints),\n});\n\nconst normalizeKey = (key: string): string =>\n\tkey\n\t\t.replace(/^@devstack\\//, '')\n\t\t.replace(/^(devstack:|app:)/, '')\n\t\t.replace(/#\\d+$/, '')\n\t\t.replace(/\\/\\d+$/, '');\n\nconst normalizeClassificationKey = (key: string): string =>\n\tkey\n\t\t.replace(/^@devstack\\//, '')\n\t\t.replace(/^devstack:/, '')\n\t\t.replace(/#\\d+$/, '')\n\t\t.replace(/\\/\\d+$/, '');\n\nconst humanizeToken = (token: string): string =>\n\ttoken.replace(/[-_]+/g, ' ').replace(/^\\w/, (head) => head.toUpperCase());\n\nconst containsKeyPart = (key: string, parts: ReadonlyArray<string>): boolean => {\n\tconst tokens = key.split(/[/:._#-]/).filter((part) => part.length > 0);\n\treturn tokens.some((token) => parts.includes(token));\n};\n\nconst isSectionish = (token: string): boolean =>\n\tcontainsKeyPart(token.toLowerCase(), ['service', 'package', 'account', 'action', 'app']);\n\nconst rowSectionClassifierFor = (key: string): RowSectionClassifier | undefined =>\n\tROW_SECTION_CLASSIFIERS.find((classifier) =>\n\t\tclassifier.prefixes.some((prefix) => keyMatchesClassifierPrefix(key, prefix)),\n\t);\n\nconst keyMatchesClassifierPrefix = (key: string, prefix: string): boolean => {\n\tif (prefix.endsWith(':') || prefix.endsWith('/')) return key.startsWith(prefix);\n\tif (key === prefix) return true;\n\tconst next = key[prefix.length];\n\treturn key.startsWith(prefix) && next !== undefined && '/:._-'.includes(next);\n};\n\nconst isOperationalEndpoint = (rowKey: Pick<Row, 'key'>['key'], endpoint: Endpoint): boolean => {\n\tconst prefix = `${rowKey}:`;\n\tif (!endpoint.endpointKey.startsWith(prefix)) return false;\n\tconst field = endpoint.endpointKey.slice(prefix.length);\n\treturn OPERATIONAL_ENDPOINT_FIELDS.has(field);\n};\n\n// -----------------------------------------------------------------------------\n// Compile-time invariant\n// -----------------------------------------------------------------------------\n//\n// Renderer code must never see a `title`/`primary`/`extras` field on\n// `Row`. If the projection ever sprouts one, the substrate's\n// `__ProjectionFieldsClosed` guard fails first; this module-local\n// guard exists as a second layer that explicitly mentions the\n// forbidden field names so a future renderer-side regression is\n// caught at the renderer boundary, not at the substrate boundary.\n\ntype _NoForbiddenOnRow = 'title' extends keyof Row\n\t? never\n\t: 'primary' extends keyof Row\n\t\t? never\n\t\t: 'extras' extends keyof Row\n\t\t\t? never\n\t\t\t: true;\n\n/** Renderer-side compile-time guard. If this resolves to `never`,\n *  the renderer is reading a forbidden display-vocabulary field from\n *  the projection. */\nexport type __TuiDisplayVocabClean = _NoForbiddenOnRow extends true ? true : never;\n"],"mappings":"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"}

package/dist/surfaces/tui/errors.mjs

@@ -0,0 +1,11 @@
+//#region src/surfaces/tui/errors.ts
+/** Construct a `mount-failed` renderer error. */
+const mountFailed = (detail) => ({
+	_tag: "RendererError",
+	reason: "mount-failed",
+	detail
+});
+//#endregion
+export { mountFailed };
+
+//# sourceMappingURL=errors.mjs.map

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

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

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

@@ -0,0 +1,155 @@
+import { errorSummaryFor, labelForRow } from "./display-derivation.mjs";
+const eventLogLineFromEvent = (event, seq) => {
+	const at = eventAt(event);
+	const id = `${at}-${seq}-${event.tag}`;
+	switch (event.tag) {
+		case "log.appended":
+			if (event.level === "info" || isRedundantPluginLog(event.line)) return null;
+			return line({
+				id,
+				at,
+				level: event.level,
+				scope: labelForRow(event.pluginKey),
+				scopeColor: colorForPluginKey(event.pluginKey),
+				message: event.line
+			});
+		case "error.reported": return line({
+			id,
+			level: event.error.severity === "warn" ? "warn" : "error",
+			at,
+			scope: event.error.pluginKey === null ? "Stack" : labelForRow(event.error.pluginKey),
+			scopeColor: event.error.pluginKey === null ? "white" : colorForPluginKey(event.error.pluginKey),
+			message: `failed: ${errorSummaryFor(event.error)}`
+		});
+		case "build.statusChanged":
+		case "lifecycle.statusChanged":
+		case "lifecycle.phaseSet":
+		case "endpoint.registered":
+		case "account.updated":
+		case "package.updated": return null;
+		case "restart.requested": return line({
+			id,
+			level: "warn",
+			at,
+			scope: "Stack",
+			scopeColor: "white",
+			message: `restart requested for ${targetLabel(event.target)}`
+		});
+		case "restart.completed": return line({
+			id,
+			level: "info",
+			at,
+			scope: "Stack",
+			scopeColor: "white",
+			message: `restart completed for ${targetLabel(event.target)}`
+		});
+		case "shutdown.escalated": return line({
+			id,
+			level: "warn",
+			at,
+			scope: "Stack",
+			scopeColor: "white",
+			message: `shutdown hard-kill escalated by ${event.signal} (exit ${event.exitCode})`
+		});
+		case "snapshot.captureStarted": return line({
+			id,
+			level: "info",
+			at,
+			scope: "Snapshot",
+			scopeColor: "blueBright",
+			message: event.name === void 0 ? "capture started" : `capture started for ${event.name}`
+		});
+		case "snapshot.captureProgress": return null;
+		case "snapshot.captureSkipped": return line({
+			id,
+			level: "warn",
+			at,
+			scope: "Snapshot",
+			scopeColor: "blueBright",
+			message: "capture already running"
+		});
+		case "snapshot.captureFailed": return line({
+			id,
+			level: "error",
+			at,
+			scope: "Snapshot",
+			scopeColor: "blueBright",
+			message: event.name === void 0 ? `capture failed: ${event.summary}` : `capture failed for ${event.name}: ${event.summary}`
+		});
+		case "snapshot.captured": return line({
+			id,
+			level: "info",
+			at,
+			scope: "Snapshot",
+			scopeColor: "blueBright",
+			message: event.name === void 0 ? `captured ${event.snapshotId}` : `captured ${event.name} (${event.snapshotId})`
+		});
+		case "snapshot.restored": return line({
+			id,
+			level: "info",
+			at,
+			scope: "Snapshot",
+			scopeColor: "blueBright",
+			message: `restored ${event.snapshotId}`
+		});
+		case "endpoint.released":
+		case "strategy.registered":
+		case "strategy.unregistered":
+		case "manifest.flushed":
+		case "codegen.emitted": return null;
+		default: return null;
+	}
+};
+const shutdownRequestedLine = (at, seq) => ({
+	id: `${at}-${seq}-shutdown.requested`,
+	time: time(at),
+	scope: "Stack",
+	scopeColor: "white",
+	message: "shutdown requested; waiting for graceful stop",
+	level: "warn",
+	text: `${time(at)} shutdown requested; waiting for graceful stop`
+});
+const appendEventLogLine = (lines, next) => {
+	if (next === null) return lines;
+	const appended = [...lines, next];
+	return appended.length > 200 ? appended.slice(-200) : appended;
+};
+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 time = (at) => new Date(at).toISOString().slice(11, 19);
+const targetLabel = (target) => target === "stack" ? "stack" : target.pluginKey;
+const line = (input) => {
+	const renderedTime = time(input.at);
+	return {
+		id: input.id,
+		time: renderedTime,
+		scope: input.scope,
+		scopeColor: input.scopeColor,
+		message: input.message,
+		level: input.level,
+		text: `${renderedTime} ${input.scope}: ${input.message}`
+	};
+};
+const isRedundantPluginLog = (message) => {
+	const normalized = message.trim().toLowerCase();
+	return normalized === "plugin acquire start" || normalized === "plugin ready" || normalized === "plugin acquire failed";
+};
+const colorForPluginKey = (pluginKey) => {
+	const normalized = pluginKey.toLowerCase();
+	if (normalized.includes("account")) return "magenta";
+	if (normalized.includes("package")) return "blueBright";
+	if (normalized.includes("action")) return "magenta";
+	if (normalized.includes("app") || normalized.includes("frontend")) return "white";
+	return "cyan";
+};
+//#endregion
+export { appendEventLogLine, eventLogLineFromEvent, shutdownRequestedLine };
+
+//# sourceMappingURL=event-log.mjs.map