@openrig/cli 0.5.10 → 0.5.12

package/tui/dist/render.js

@@ -1,3 +1,7 @@
+import { DEFAULT_TIME_ZONE, displayTime } from "./time.js";
+import { startupLines } from "./startup.js";
+import { configLines } from "./config/config-model.js";
+import { connectionsLines } from "./connections/connections-model.js";
 // Hand-rolled ANSI renderer (Phase-0 substrate decision). Pure function:
 // (state, snapshot) → {lines, hitMap, explorerRows}. BOTH panes emit hit
 // targets — explorer rows AND content-pane surfaces (table rows, view tabs,
@@ -18,7 +22,7 @@ import { buildLedgerExplorer } from "./crash-cart/ledger-explorer.js";
 import { runtimeMarkSegs } from "./topology/runtime-marks.js";
 import { barCells, flashActive, reducedMotion, spinnerFrame } from "./motion.js";
 import { explorerWidth, MOTION_FRAME_MS } from "./visual-layout.js";
-import { detailPage, fieldLine, sectionRule, listItem, alignedRow, LABEL_W } from "./detail.js";
+import { detailPage, fieldLine, sectionRule, listItem, alignedRow, LABEL_W, wrapDetailLines } from "./detail.js";
 import { healthAgentLines, healthDetailLines, healthListLines, healthSummaryLine } from "./health/health-model.js";
 function pad(text, width) {
     const t = String(text ?? "");
@@ -216,7 +220,7 @@ function workRows(rows, width) {
         ];
     });
 }
-function agentDetailLines(snap, found, contentWidth) {
+function agentDetailLines(snap, found, contentWidth, timeZone = DEFAULT_TIME_ZONE) {
     const { agent, rig, pod } = found;
     const session = agent.session;
     const specInLibrary = !!agent.spec && !!findSpec(snap, agent.spec);
@@ -271,7 +275,7 @@ function agentDetailLines(snap, found, contentWidth) {
                     ...(activityReason ? [{ label: "reason", value: activityReason }] : []),
                     ...(agent.activity?.decidedBy ? [{ label: "decided by", value: agent.activity.decidedBy }] : []),
                     ...(agent.activity?.signalSource || agent.activity?.signalReason ? [{ label: "signal", value: `${agent.activity.signalSource ?? "unknown"} · ${agent.activity.signalReason ?? "no reason"}` }] : []),
-                    ...(agent.activity?.eventAt ? [{ label: "changed", value: agent.activity.eventAt }] : []),
+                    ...(agent.activity?.eventAt ? [{ label: "changed", value: displayTime(agent.activity.eventAt, timeZone) }] : []),
                 ],
             },
             {
@@ -307,10 +311,16 @@ function agentDetailLines(snap, found, contentWidth) {
                 ],
             },
             {
-                title: "SPEC",
+                title: "SPEC · effective seat binding",
                 fields: [specInLibrary
                         ? { label: "spec", value: agent.spec, link: { type: "cross", kind: "spec-of", name: agent.name, target: { host: found.host.name, rig: rig.name, pod: pod.name } } }
                         : { label: "spec", value: agent.spec ? `${agent.spec}  (not in library)` : "—" }],
+                lines: [
+                    ...wrapDetailValue("profile", agent.profile ?? "not served", contentWidth),
+                    ...wrapDetailValue("version", agent.specVersion ?? "not served", contentWidth),
+                    ...wrapDetailValue("source hash", agent.specHash ?? "not served", contentWidth),
+                    ...wrapDetailValue("basis", "Served seat binding; the authored library may have changed since launch.", contentWidth),
+                ],
             },
         ]),
     ];
@@ -335,12 +345,6 @@ function tabsLine(state, suffix) {
     }
     return [{ text, zones }];
 }
-function localClock(iso) {
-    const date = new Date(iso);
-    if (Number.isNaN(date.getTime()))
-        return "??:??";
-    return `${String(date.getHours()).padStart(2, "0")}:${String(date.getMinutes()).padStart(2, "0")}`;
-}
 function queueRows(snap) {
     return [...snap.attention, ...snap.blocked, ...snap.inProgress, ...snap.pending, ...snap.recentlyFinished];
 }
@@ -381,53 +385,54 @@ function recentScopeMatches(snap, scope) {
         return false;
     return scope.kind === "instance" || (served.kind === "rig" && served.rig === scope.rig);
 }
-function recentLines(snap, scope, width, expanded) {
+function recentLines(snap, scope, width, expanded, timeZone) {
     if (!recentScopeMatches(snap, scope) || snap.recentTransitions == null)
         return [];
-    const timeW = 5;
     const rows = expanded ? snap.recentTransitions : snap.recentTransitions.slice(-5);
     const lines = [
         ...(expanded ? [] : [{ text: "" }]),
-        sectionRule(`RECENT · ${scope.kind === "instance" ? "instance" : `rig ${scope.rig}`} · material queue transitions · newest last`, width),
+        sectionRule(`RECENT · ${scope.kind === "instance" ? "instance" : `rig ${scope.rig}`}`, width),
+        { text: "  Recorded queue changes · oldest to newest · Enter inspects" },
     ];
     if (rows.length === 0)
         return [...lines, { text: "  No recorded transitions in the current window." }];
-    if (width < 78) {
-        const rigW = scope.kind === "instance" ? 9 : 0;
-        const changeW = Math.max(16, width - timeW - rigW - 2);
-        lines.push({ text: alignedRow([["TIME", timeW], ...(rigW ? [["RIG", rigW]] : []), ["CHANGE", changeW]]) });
-        for (const row of rows) {
-            const action = recentTargetAction(snap, row);
-            lines.push({
-                text: alignedRow([[localClock(row.ts), timeW], ...(rigW ? [[pad(row.rig ?? "?", rigW), rigW]] : []), [pad(row.change, changeW), changeW]]).slice(0, width),
-                ...(action ? { action } : {}),
-            });
-            lines.push({ text: `      ${pad(row.actorSession, Math.max(8, width - 8))}`.slice(0, width), ...(action ? { action } : {}) });
-            lines.push({ text: `      → ${row.target}`.slice(0, width), ...(action ? { action } : {}) });
-            lines.push(...wrapDetailValue("work", recentWorkText(snap, row), width)
-                .map((line) => ({ ...line, ...(action ? { action } : {}) })));
-        }
-        return lines;
-    }
-    const rigW = scope.kind === "instance" ? Math.min(16, Math.max(9, Math.floor(width * 0.13))) : 0;
-    const actorW = Math.min(26, Math.max(16, Math.floor(width * 0.21)));
-    const changeW = Math.min(36, Math.max(20, Math.floor(width * 0.28)));
-    const targetW = Math.max(10, width - timeW - rigW - actorW - changeW - (scope.kind === "instance" ? 4 : 3));
-    lines.push({ text: alignedRow([["TIME", timeW], ...(scope.kind === "instance" ? [["RIG", rigW]] : []), ["ACTOR", actorW], ["CHANGE", changeW], ["TARGET", targetW]]) });
     for (const row of rows) {
-        const action = recentTargetAction(snap, row);
-        const text = alignedRow([
-            [localClock(row.ts), timeW],
-            ...(scope.kind === "instance" ? [[pad(row.rig ?? "?", rigW), rigW]] : []),
-            [pad(row.actorSession, actorW), actorW],
-            [pad(row.change, changeW), changeW],
-            [pad(row.target, targetW), targetW],
-        ]).slice(0, width);
-        lines.push({ text, ...(action ? { action } : {}) });
-        lines.push(...wrapDetailValue("work", recentWorkText(snap, row), width)
-            .map((line) => ({ ...line, ...(action ? { action } : {}) })));
+        lines.push(listItem(`${displayTime(row.ts, timeZone)} · #${row.transitionId}`, { type: "recent-open", transitionId: row.transitionId }), { text: `    ${row.actorSession || "actor unknown"} · ${row.change || "change unknown"}` }, { text: `    ${recentWorkText(snap, row)}` }, { text: `    ${row.targetKind}: ${row.target}${scope.kind === "instance" ? ` · rig ${row.rig ?? "unknown"}` : ""}` }, { text: "" });
     }
-    return lines;
+    return wrapDetailLines(lines, width);
+}
+function recentDetailLines(state, snap, width) {
+    const row = state.recentOpen;
+    const target = recentTargetAction(snap, row);
+    return wrapDetailLines([
+        { text: `Recent event #${row.transitionId} · Esc returns` },
+        fieldLine({ label: "when", value: displayTime(row.ts, state.timeZone) }),
+        fieldLine({ label: "actor", value: row.actorSession || "unknown" }),
+        fieldLine({ label: "change", value: row.change || "unknown" }),
+        fieldLine({ label: "work", value: recentWorkText(snap, row) }),
+        fieldLine({ label: "target", value: `${row.targetKind}: ${row.target}` }),
+        fieldLine({ label: "rig", value: row.rig ?? "not served" }),
+        fieldLine({ label: "queue item", value: row.qitemId }),
+        fieldLine({ label: "raw time", value: row.ts }),
+        { text: "  This is the recorded change, not an independent check of its outcome." },
+        ...(target ? [listItem("Related work / owner", target)] : [{ text: "  Related work is outside the current snapshot." }]),
+        listItem("Back · Esc", { type: "back" }),
+    ], width);
+}
+function timeZoneLines(state, width) {
+    return wrapDetailLines([
+        { text: "Local time · presentation setting" },
+        fieldLine({ label: "timezone", value: state.timeZone }),
+        ...(state.timeZoneWarning ? [{ text: `  ${state.timeZoneWarning}` }] : []),
+        { text: "  Absolute times include date and zone. Daylight saving follows the named zone. Elapsed ages stay relative; source timestamps are unchanged." },
+        { text: "" },
+        { text: "  Change the persistent setting from the shell, then reopen this TUI:" },
+        { text: "  rig config set ui.timezone Europe/London" },
+        { text: "  rig config reset ui.timezone" },
+        { text: "  rig config get ui.timezone --show-source" },
+        { text: "  Default: America/Los_Angeles. OPENRIG_UI_TIMEZONE overrides the file setting on this TUI's instance." },
+        listItem("Back · Esc", { type: "back" }),
+    ], width);
 }
 function specTabsLine(state, name) {
     const active = state.viewTab === "topology" || state.viewTab === "yaml" ? state.viewTab : "configuration";
@@ -511,7 +516,7 @@ function instanceContentLines(state, snap, host, contentWidth, motion) {
     if (state.viewTab === "health")
         return [...lines, { text: "" }, ...healthListLines(snap, scope, contentWidth)];
     if (state.viewTab === "recent") {
-        const recent = recentLines(snap, scope, contentWidth, true);
+        const recent = recentLines(snap, scope, contentWidth, true, state.timeZone);
         return recent.length > 0
             ? [...lines, ...recent]
             : [...lines, { text: "" }, { text: motion.loading ? `${motion.frame} instance RECENT read pending` : "(instance RECENT window not served)" }];
@@ -623,15 +628,23 @@ function instanceContentLines(state, snap, host, contentWidth, motion) {
         }
     }
     lines.push({ text: "" }, { text: `${host.rigs.length} rigs · ${seatCount} seats · ${workingCount} working · ${attentionCount} need attention · ${openCount} open rows` });
-    lines.push(...recentLines(snap, scope, contentWidth, false));
+    lines.push(...recentLines(snap, scope, contentWidth, false, state.timeZone));
     return lines;
 }
 function contentLines(state, snap, contentWidth, motion) {
     const contentWidthForGraph = contentWidth;
     void contentWidthForGraph;
     const lines = [];
+    if (state.timeZoneHelp)
+        return timeZoneLines(state, contentWidth);
+    if (state.recentOpen)
+        return recentDetailLines(state, snap, contentWidth);
+    if (state.section === "config")
+        return configLines(state, snap, contentWidth);
+    if (state.section === "connections")
+        return connectionsLines(snap, contentWidth, state.timeZone);
     if (state.healthOpen)
-        return healthDetailLines(snap, state.healthOpen, contentWidth);
+        return healthDetailLines(snap, state.healthOpen, contentWidth, state.timeZone);
     // PULSE is a FULL-WIDTH view handled by an early return in renderScreen
     // (renderPulseScreen) — it never reaches the sidebar+content layout below.
     if (state.section === "topology") {
@@ -658,7 +671,7 @@ function contentLines(state, snap, contentWidth, motion) {
             const found = hostName ? findAgent(snap, leaf.name, { host: hostName, rig: rigName, pod: podName }) : findAgent(snap, leaf.name);
             if (!found)
                 return [{ text: `agent "${leaf.name}" not in the current snapshot` }];
-            return agentDetailLines(snap, found, contentWidth);
+            return agentDetailLines(snap, found, contentWidth, state.timeZone);
         }
         const hostName = state.drill.find((d) => d.kind === "host")?.name;
         const host = (hostName ? snap.hosts.find((candidate) => candidate.name === hostName) : snap.hosts[0]);
@@ -692,7 +705,7 @@ function contentLines(state, snap, contentWidth, motion) {
         if (state.viewTab === "health")
             return [...lines, { text: "" }, ...healthListLines(snap, healthScope, contentWidth)];
         if (state.viewTab === "recent") {
-            const recent = recentLines(snap, { kind: "rig", rig: rig.name }, contentWidth, true);
+            const recent = recentLines(snap, { kind: "rig", rig: rig.name }, contentWidth, true, state.timeZone);
             return recent.length > 0
                 ? [...lines, ...recent]
                 : [...lines, { text: "" }, { text: motion.loading ? `${motion.frame} rig RECENT read pending` : "(rig RECENT window not served)" }];
@@ -745,6 +758,7 @@ function contentLines(state, snap, contentWidth, motion) {
             lines.push({ text: `  style: ${state.graphStyle} · style hatchet|braille|braille-fallback rides the command bar` });
             return lines;
         }
+        lines.push(listItem("CONFIG · instance settings", { type: "jump", section: "config" }));
         lines.push(healthSummaryLine(snap, healthScope, contentWidth));
         lines.push({ text: state.filter ? `/ filter agents: ${state.filter} · / replace · esc clear` : "/ filter agents…" });
         if (state.viewTab === "overview") {
@@ -826,7 +840,7 @@ function contentLines(state, snap, contentWidth, motion) {
         const attention = rows.filter((agent) => /attention|needs|blocked|unknown|failed/.test(agent.status)).length;
         lines.push({ text: `${rows.length} seats · ${working} working · ${attention} need attention · ${rows.reduce((n, agent) => n + queueFacts(snap, agent.session).count, 0)} open rows` });
         if (!podFilter)
-            lines.push(...recentLines(snap, { kind: "rig", rig: rig.name }, contentWidth, false));
+            lines.push(...recentLines(snap, { kind: "rig", rig: rig.name }, contentWidth, false, state.timeZone));
         return lines;
     }
     if (state.section === "specs") {
@@ -835,8 +849,28 @@ function contentLines(state, snap, contentWidth, motion) {
             const spec = findSpec(snap, leaf.name);
             if (!spec)
                 return [{ text: `spec "${leaf.name}" not in the current snapshot` }];
-            if (spec.kind === "rig") {
+            if (spec.kind === "rig")
                 lines.push(specTabsLine(state, spec.name));
+            lines.push({ text: `${spec.kind} spec ${spec.name}` });
+            lines.push(fieldLine({ label: "purpose", value: spec.description ?? "not declared in the available source" }));
+            lines.push(fieldLine({ label: "provenance", value: `${sourceProvenance(spec)} · ${spec.sourceState ?? "source state not served"}` }));
+            lines.push(fieldLine({ label: "source", value: spec.sourcePath ?? "path unavailable" }));
+            lines.push({ text: "  Authored declaration. Resource availability is not the effective loadout of a running seat." });
+            lines.push(sectionRule("Observed consumers · open for effective runtime/configuration", contentWidth));
+            for (const consumer of spec.consumers ?? []) {
+                const resource = consumer.agent ? "agent" : "rig";
+                lines.push(listItem(`${consumer.agent ?? consumer.rig} · ${consumer.status ?? "unknown"}${consumer.runtime ? ` · ${consumer.runtime}` : ""}${consumer.model ? ` · ${consumer.model}` : ""}`, { type: "drill", resource, name: consumer.agent ?? consumer.rig, target: { host: consumer.host, rig: consumer.rig } }));
+            }
+            if (spec.consumers && !spec.consumers.length)
+                lines.push({ text: "  No consumers observed in the available local inventory (remote seats are not enumerated)." });
+            if (spec.consumers === undefined)
+                lines.push({ text: "  Consumer projection unavailable." });
+            for (const error of snap.readErrors.filter((error) => error.startsWith("nodes(") || error.startsWith("rig-spec(") || error.startsWith("rigs-summary:")))
+                lines.push({ text: `  Inventory incomplete: ${error}` });
+            lines.push(listItem("Back · Esc", { type: "back" }));
+            if (spec.sourceUnavailable)
+                return wrapDetailLines([...lines, { text: `  Source unavailable: ${spec.sourceUnavailable}` }], contentWidth);
+            if (spec.kind === "rig") {
                 if (spec.sourcePath)
                     lines.push(fieldLine({ label: "source", value: `${displayPath(spec.sourcePath, 56)} · ${sourceProvenance(spec)}` }));
                 if (state.viewTab === "topology") {
@@ -848,7 +882,7 @@ function contentLines(state, snap, contentWidth, motion) {
                     lines.push({ text: "" });
                     if (nodes.length === 0) {
                         lines.push({ text: "  (topology projection is empty)" });
-                        return lines;
+                        return wrapDetailLines(lines, contentWidth);
                     }
                     lines.push({ text: `  ${alignedRow(NODE_COLS)}` });
                     lines.push({ text: `  ${"─".repeat(NODE_COLS.reduce((n, [, w]) => n + w + 1, -1))}` });
@@ -860,12 +894,12 @@ function contentLines(state, snap, contentWidth, motion) {
                         for (const edge of graphEdges)
                             lines.push({ text: `  ${alignedRow([[edge.source, 16], ["→", 2], [edge.target, 20]])} (${edge.kind})` });
                     }
-                    return lines;
+                    return wrapDetailLines(lines, contentWidth);
                 }
                 if (state.viewTab === "yaml") {
                     for (const rawLine of (spec.raw ?? "# raw YAML unavailable").split("\n"))
                         lines.push({ text: `  ${rawLine}` });
-                    return lines;
+                    return wrapDetailLines(lines, contentWidth);
                 }
                 const members = spec.pods?.reduce((count, pod) => count + pod.members.length, 0) ?? spec.legacyNodes?.length ?? 0;
                 const edges = (spec.edges?.length ?? 0) + (spec.pods?.reduce((count, pod) => count + pod.edges.length, 0) ?? 0);
@@ -940,12 +974,12 @@ function contentLines(state, snap, contentWidth, motion) {
                         fields: [{ label: "source", value: spec.sourcePath ? `${displayPath(spec.sourcePath, 56)} · ${sourceProvenance(spec)}` : "—" }],
                     },
                     {
-                        title: "where it runs",
+                        title: "Declared rig references",
                         fields: [
                             ...((spec.usedByRigs?.length ?? 0) === 0
-                                ? [{ label: "used by", value: "—" }]
+                                ? [{ label: "declared by", value: "—" }]
                                 : (spec.usedByRigs ?? []).map((rig) => ({
-                                    label: "used by",
+                                    label: "declared by",
                                     value: `rig ${rig}`,
                                     link: { type: "drill", resource: "spec", name: rig },
                                 }))),
@@ -958,7 +992,7 @@ function contentLines(state, snap, contentWidth, motion) {
                     },
                 ]));
             }
-            return lines;
+            return wrapDetailLines(lines, contentWidth);
         }
         lines.push({ text: "SPEC LIBRARY" });
         lines.push({ text: state.filter ? `/ filter specs: ${state.filter} · / replace · esc clear` : "/ filter specs…" });
@@ -1055,6 +1089,16 @@ function contentLines(state, snap, contentWidth, motion) {
         return lines;
     }
     if (state.section === "scopes") {
+        if (!state.scopesMission && snap.execution) {
+            const selected = snap.execution;
+            const instances = selected.lifecycle_instances;
+            return wrapDetailLines([
+                { text: "SCOPES · choose a mission in the explorer" },
+                listItem(`Default mission · ${selected.mission}`, { type: "scopes-mission-open", mission: selected.mission }),
+                { text: `  Workflows: ${instances ? instances.map((instance) => String(instance.status ?? "unknown")).join(", ") || "none bound" : "projection unavailable"}` },
+                { text: `  Execution snapshot: ${displayTime(selected.derived_at, state.timeZone)}. Other missions load when selected.` },
+            ], contentWidth);
+        }
         // SCOPES owns both levels. Both mission-graph and Explorer slice routes land
         // on the same execution-backed canonical detail; store-direct content is
         // composed into that page instead of surviving as a competing destination.
@@ -1068,16 +1112,16 @@ function contentLines(state, snap, contentWidth, motion) {
             return executionContentLines(execution, snap.scopes, snap.readErrors, state.executionOpen, contentWidth, false, snap.sliceDetail, {
                 collapseReqs: state.scopesCollapseReqs,
                 narrative: state.scopesNarrative,
-            });
+            }, state.timeZone);
         }
         if (detail && execution) {
             return executionContentLines(execution, snap.scopes, snap.readErrors, `slice:${detail.id ?? detail.dirName}`, contentWidth, false, snap.sliceDetail, {
                 collapseReqs: state.scopesCollapseReqs,
                 narrative: state.scopesNarrative,
-            });
+            }, state.timeZone);
         }
         if (!detail && missionName) {
-            const lines = executionContentLines(execution, snap.scopes, snap.readErrors, state.executionOpen, contentWidth, !snap.hydratedAt || snap.executionMission !== missionName);
+            const lines = executionContentLines(execution, snap.scopes, snap.readErrors, state.executionOpen, contentWidth, !snap.hydratedAt || snap.executionMission !== missionName, undefined, undefined, state.timeZone);
             return execution ? lines : [{ text: `  ${missionName} EXECUTION` }, ...lines];
         }
         return scopesContentLines(detail, missionName, {
@@ -1128,11 +1172,15 @@ function keybindHints(state) {
     // hint hid exactly where it was needed). When ↑↓ themselves scroll (a
     // scrollable spec detail), the nav label says so; otherwise ↑↓ move and the
     // page keys carry the scroll.
+    if (state.section === "config")
+        return state.configKey
+            ? `${specDetailArrowsScroll(state) ? "↑↓ scroll" : "↑↓ move"} · esc back · v select/copy · refresh · q quit`
+            : "↑↓ move · ←→ pane · ⏎ open · / search · esc back · refresh · q quit";
     const arrowsScroll = specDetailArrowsScroll(state);
     const nav = arrowsScroll ? "↑↓ scroll" : "↑↓ move";
     const pageScroll = state.contentMaxOffset > 0 && !arrowsScroll ? "⇞⇟ scroll · " : "";
     const filter = state.filter ? "/ replace · esc clear" : "/ filter";
-    return `${nav} · ←→ pane · ⏎ open · ${pageScroll}: command · ${filter} · v select/copy · f footer · q quit`;
+    return `${nav} · ←→ pane · ⏎ open · ${pageScroll}: command · ${filter} · S startup · v select/copy · f footer · q quit`;
 }
 /** The PULSE view renders FULL-WIDTH with NO explorer sidebar (increment 2). A
  * minimal self-contained screen: cmd bar + a full-width titled rule + the pulse
@@ -1201,7 +1249,14 @@ function renderPulseScreen(state, snap, options, inputLine) {
     const contentTargets = [];
     const flashRows = [];
     let flashAck = false;
-    lines.push(pad(`cmd ▸ ${inputLine}▊`, cols));
+    lines.push(pad(`cmd ▸ ${inputLine}▊${load.stale ? " · readiness unconfirmed — refreshing or authority unavailable" : load.connection && load.connection !== "connected" ? " · live updates unavailable — last HTTP basis; quiet refresh active" : inputLine ? "" : "  Tab complete · ? help · timezone"}`, cols));
+    if (options.completion) {
+        lines.push(pad(options.completion.message, cols));
+        for (const candidate of options.completion.candidates.slice(0, 4))
+            lines.push(pad(`  ${candidate}`, cols));
+        if (options.completion.candidates.length > 4)
+            lines.push(pad("  … keep typing to narrow matches", cols));
+    }
     // REGISTRY I3 — the palette overlay: fuzzy rows over the ONE registry; unavailable
     // entries render DIMMED-WITH-REASON, never hidden (PM pin); bounded height.
     if (state.palette) {
@@ -1223,7 +1278,7 @@ function renderPulseScreen(state, snap, options, inputLine) {
     const contentWidth = Math.max(cols - explW - 2, 0);
     const model = buildPulseModel(snap, nowMs);
     const chromeRows = 3; // bottom rule + hint bar + status line
-    const bodyRows = Math.max(rows - 2 - chromeRows, 1);
+    const bodyRows = Math.max(rows - lines.length - chromeRows, 1);
     const maxContentOffset = Math.max(renderPulseView(model).length - bodyRows, 0);
     const contentStart = Math.min(state.contentOffset, maxContentOffset);
     // Lane cells (column-major), CLIPPED to the content width: a cell whose column
@@ -1309,7 +1364,7 @@ function renderPulseScreen(state, snap, options, inputLine) {
     // the footer's live "updated Ns ago" IS the ongoing refresh signal (reader
     // clock), so a settled empty view stays calm. Reduced motion → static "·".
     const loadTag = loading ? `  ${frame} loading` : "";
-    lines.push(pad(`[${state.instanceId}] ${state.section}${drillPath ? " · " + drillPath : ""}${state.lastError ? "  ✗ " + state.lastError : ""}${state.notice ? "  ▸ " + state.notice : ""}${readWarn}${loadTag}`, cols));
+    lines.push(pad(`[${state.instanceId}] ${state.section}${drillPath ? " · " + drillPath : ""}${state.lastError ? "  ✗ " + state.lastError : ""}${state.notice ? "  ▸ " + state.notice : ""}${readWarn}${loadTag}${state.timeZoneWarning ? " · ⚠ timezone; run timezone" : ""}`, cols));
     while (lines.length < rows)
         lines.push("");
     const anyFlash = model.lanes.some((l) => l.rows.some((r) => r.flashed));
@@ -1356,7 +1411,7 @@ function wrapContentLines(content, width) {
             }
             const chunk = rest.slice(0, cut).trimEnd();
             rest = rest.slice(cut).replace(/^\s+/, "");
-            out.push(first ? { text: chunk, segs: item.segs } : { text: indent + chunk });
+            out.push(first ? { text: chunk, segs: item.segs, action: item.action } : { text: indent + chunk });
             first = false;
         }
     }
@@ -1366,9 +1421,10 @@ function crashCartShell(content, led, contentTitle, cols, rows, inputLine, opts)
     const explW = explorerWidth(cols);
     const lines = [];
     const segRows = {};
+    const hitMap = [];
     lines.push(pad(`cmd ▸ ${inputLine}▊`, cols));
     lines.push(paneRule(cols, explW, "top", "{ EXPLORER }", contentTitle));
-    // The ledger-fed explorer column: the honest marker, then one row per rig (name + seat count).
+    // The explorer's source note, then any discovered rigs (name + seat count).
     const leftRows = [led.note, "", ...led.rows.map((r) => `${r.label} (${r.seatCount})`)];
     const contentWidth = Math.max(cols - explW - 2, 0);
     if (opts?.wrap)
@@ -1384,6 +1440,8 @@ function crashCartShell(content, led, contentTitle, cols, rows, inputLine, opts)
         const left = pad(leftRows[i] ?? "", explW);
         const citem = content[scroll + i];
         const contentText = (citem?.text ?? "").slice(0, contentWidth);
+        if (citem?.action)
+            hitMap.push({ y, x1: explW + 2, x2: cols, action: citem.action });
         lines.push(pad(`${left}┃ ${contentText}`, cols));
         if (citem?.segs)
             segRows[y] = truncateSegs(citem.segs, contentWidth);
@@ -1391,13 +1449,13 @@ function crashCartShell(content, led, contentTitle, cols, rows, inputLine, opts)
     lines.push(paneRule(cols, explW, "bottom"));
     lines.push(pad("", cols));
     const scrollHint = contentMaxOffset > 0 ? ` · ↑↓ scroll (${scroll}/${contentMaxOffset})` : "";
-    lines.push(pad(`[crash-cart] daemon down · explorer ${led.note}${scrollHint}`, cols));
+    lines.push(pad(`[crash-cart] ${led.note}${scrollHint}`, cols));
     while (lines.length < rows)
         lines.push("");
     return {
         lines: lines.slice(0, rows),
         explorerWidth: explW,
-        hitMap: [],
+        hitMap,
         contentTargets: [],
         contentMaxOffset,
         explorerRows: [],
@@ -1407,6 +1465,18 @@ function crashCartShell(content, led, contentTitle, cols, rows, inputLine, opts)
 export function renderScreen(state, snap, options = {}, inputLine = "") {
     const { cols = 120, rows = 32, nowMs = 0 } = options;
     const explW = explorerWidth(cols);
+    if (options.startup?.open) {
+        const startup = options.startup;
+        const content = wrapContentLines(startupLines(startup).map((line) => ({ ...line,
+            text: line.text.replace(/\x1b\[[0-9;?]*[A-Za-z]/g, "").replace(/[\x00-\x1f\x7f]/g, " ")
+                .replace(/(https?:\/\/)[^\s/@]+:[^\s/@]+@/gi, "$1[redacted]@").replace(/Bearer\s+[^\s]+/gi, "Bearer [redacted]"),
+        })), Math.max(1, cols - explW - 2));
+        const selected = content.findIndex((line) => line.action?.type === "startup" && line.action.key === `select:${startup.selected}`);
+        const scroll = startup.expanded ? startup.scroll : Math.max(0, selected - Math.max(1, rows - 12));
+        const screen = crashCartShell(content, { note: "startup", rows: [] }, "START AND RETURN", cols, rows, "", { scroll });
+        screen.lines[rows - 1] = pad("↑↓ choose · Enter select · r refresh · d details · Esc back · q quit", cols);
+        return screen;
+    }
     // 5.2 crash-cart (shell-placement rework, ruling 3c6c2be0): daemon-DOWN renders as a CONTENT-PANE
     // view inside the standard shell — the explorer sidebar is ALWAYS present, ledger-fed + honestly
     // marked (from the SAME one-JSON discovery, never a second read). Content moves into the right pane
@@ -1423,17 +1493,37 @@ export function renderScreen(state, snap, options = {}, inputLine = "") {
             scroll: options.restoreScroll ?? 0,
         });
     }
+    if (options.unavailable) {
+        const detail = options.unavailable
+            .replace(/\x1b\[[0-9;?]*[A-Za-z]/g, "")
+            .replace(/[\x00-\x1f\x7f]/g, " ")
+            .replace(/(https?:\/\/)[^\s/@]+:[^\s/@]+@/gi, "$1[redacted]@")
+            .replace(/Bearer\s+[^\s]+/gi, "Bearer [redacted]");
+        const summary = /NODE_MODULE_VERSION|ERR_DLOPEN_FAILED|better-sqlite3/i.test(detail)
+            ? "The installed native module cannot load in this runtime. Repair the installation prerequisite, then retry."
+            : "Startup state could not be read. Retry after resolving the reported prerequisite.";
+        return crashCartShell([
+            { text: "Startup prerequisite unavailable" },
+            { text: summary },
+            { text: "Saved identity and conversation history have not been classified as missing." },
+            { text: "" },
+            { text: "r retry · d details · q quit" },
+            ...(options.unavailableExpanded ? [{ text: "" }, { text: detail }] : []),
+        ], { note: "state unavailable", rows: [] }, "STARTUP", cols, rows, inputLine, { wrap: true, scroll: options.restoreScroll ?? 0 });
+    }
     if (options.daemonState === "down" && options.crashCart) {
         const led = buildLedgerExplorer(options.crashCart.foundOnHost);
         // B1 ROUND 10 — when a confirm is armed, render it at the TOP of the cockpit (where the operator
         // looks) so the first ⏎ is visibly acknowledged; wrap so the sentence is not clipped at the pane edge.
-        const content = options.confirm
-            ? [...renderConfirmBanner(options.confirm), ...renderCrashCartView(options.crashCart)]
-            : renderCrashCartView(options.crashCart);
+        const content = options.starting
+            ? [{ text: `Starting daemon at ${options.starting}…` }, { text: "Seats remain stopped until selected." }]
+            : options.confirm
+                ? [...renderConfirmBanner(options.confirm), ...renderCrashCartView(options.crashCart)]
+                : renderCrashCartView(options.crashCart);
         return crashCartShell(content, led, "CRASH-CART", cols, rows, inputLine, options.confirm ? { wrap: true } : undefined);
     }
     if (options.daemonState === "unverified" && options.daemonEvidence) {
-        const led = buildLedgerExplorer([]); // no rigs listed when we cannot verify — honest empty ledger
+        const led = { note: "daemon unverified", rows: [] }; // No ledger discovery occurred on this path.
         return crashCartShell(renderUnverifiedView(options.daemonEvidence), led, "DAEMON?", cols, rows, inputLine);
     }
     // PULSE (founder Option-B): a content-pane view inside the NORMAL explorer│
@@ -1459,7 +1549,14 @@ export function renderScreen(state, snap, options = {}, inputLine = "") {
     // shell accepts typing from the empty state, so the honest readiness
     // affordance must show BEFORE the first key (no new focus state; stylize
     // gives the cell SGR blink; zero effect on hit geometry).
-    lines.push(pad(`cmd ▸ ${inputLine}▊`, cols));
+    lines.push(pad(`cmd ▸ ${inputLine}▊${inputLine ? "" : "  Tab complete · ? help · timezone"}`, cols));
+    if (options.completion) {
+        lines.push(pad(options.completion.message, cols));
+        for (const candidate of options.completion.candidates.slice(0, 4))
+            lines.push(pad(`  ${candidate}`, cols));
+        if (options.completion.candidates.length > 4)
+            lines.push(pad("  … keep typing to narrow matches", cols));
+    }
     // REGISTRY I3 — the palette overlay: fuzzy rows over the ONE registry; unavailable
     // entries render DIMMED-WITH-REASON, never hidden (PM pin); bounded height.
     if (state.palette) {
@@ -1497,7 +1594,7 @@ export function renderScreen(state, snap, options = {}, inputLine = "") {
     const liveFlashes = (options.rowFlashes ?? []).filter((f) => flashActive(f.at, nowMs, 600, reduced));
     const ackFlashes = (options.rowFlashes ?? []).filter((f) => flashActive(f.at, nowMs, 600, false));
     const chromeRows = footer ? 4 : 3; // bottom rule + hint bar + status line (+ footer)
-    const bodyRows = Math.max(rows - 2 - chromeRows, 1);
+    const bodyRows = Math.max(rows - lines.length - chromeRows, 1);
     const explorerStart = Math.min(Math.max(state.selection - bodyRows + 1, 0), Math.max(explorer.length - bodyRows, 0));
     const contentRows = content.length > bodyRows ? Math.max(bodyRows - 1, 0) : bodyRows;
     const maxContentOffset = Math.max(content.length - contentRows, 0);
@@ -1581,12 +1678,12 @@ export function renderScreen(state, snap, options = {}, inputLine = "") {
             segRows[y] = rowSegs;
     }
     if (footer)
-        lines.push(pad(`≋ ${footer.tsEmitted.slice(11, 16)} ${footer.sourceSession}: ${footer.body}`, cols));
+        lines.push(pad(`≋ ${displayTime(footer.tsEmitted, state.timeZone)} ${footer.sourceSession}: ${footer.body}`, cols));
     const drillPath = state.drill.map((d) => d.name).join(" → ");
     const readWarn = snap.readErrors.length > 0 ? `  ⚠ ${snap.readErrors.length} read(s) failed: ${snap.readErrors[0]}` : "";
     lines.push(paneRule(cols, explW, "bottom"));
     lines.push(pad(keybindHints(state), cols));
-    lines.push(pad(`[${state.instanceId}] ${state.section}${drillPath ? " · " + drillPath : ""}${state.lastError ? "  ✗ " + state.lastError : ""}${state.notice ? "  ▸ " + state.notice : ""}${readWarn}`, cols));
+    lines.push(pad(`[${state.instanceId}] ${state.section}${drillPath ? " · " + drillPath : ""}${state.lastError ? "  ✗ " + state.lastError : ""}${state.notice ? "  ▸ " + state.notice : ""}${readWarn}${state.timeZoneWarning ? " · ⚠ timezone; run timezone" : ""}`, cols));
     while (lines.length < rows)
         lines.push("");
     return {