@openrig/cli 0.5.11 → 0.5.13

package/tui/dist/render.js

@@ -1,4 +1,10 @@
+import { helpScreen } from "./commands/help.js";
+import { commandFocusVisible } from "./motion.js";
+import { attentionLines } from "./attention/attention-model.js";
+import { fileLines, externalLines, fileTargetForPath, referenceLines, referenceAction } from "./reading.js";
 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
@@ -7,10 +13,8 @@ import { connectionsLines } from "./connections/connections-model.js";
 // SAME semantic actions commands produce (PIN 1). Isolated seam: a substrate
 // swap touches only this module (spike verdict revisit trigger).
 import { computeExplorerRows, findAgent, findSpec, findAgentBySession, agentsRunningSpec, agentsRunningSpecTargets, specDetailArrowsScroll } from "./state.js";
-import { filterPalette } from "./commands/palette.js";
 import { scopesContentLines } from "./scopes/scopes-model.js";
 import { executionContentLines, executionSliceStripLines } from "./execution/execution-model.js";
-import { COMMAND_REGISTRY } from "./commands/registry.js";
 import { navigatorDisplay } from "./navigator.js";
 import { renderGraphStyle } from "./topology/render-graph.js";
 import { buildPulseModel } from "./pulse/pulse-model.js";
@@ -20,6 +24,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 { terminalLines } from "./terminals/terminal-model.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) {
@@ -432,11 +437,11 @@ function timeZoneLines(state, width) {
         listItem("Back · Esc", { type: "back" }),
     ], width);
 }
-function specTabsLine(state, name) {
+function specTabsLine(state) {
     const active = state.viewTab === "topology" || state.viewTab === "yaml" ? state.viewTab : "configuration";
     const labels = ["topology", "configuration", "yaml"];
     const parts = labels.map((tab) => (tab === active ? `[ ${tab.toUpperCase()} ]` : `  ${tab.toUpperCase()}  `));
-    const text = `rig spec ${name}   ${parts.join(" ")}`;
+    const text = parts.join(" ");
     return {
         text,
         zones: labels.map((tab, index) => {
@@ -467,6 +472,25 @@ function sourceProvenance(spec) {
         return "user library";
     return spec.sourceState === "library_item" ? "library" : "source unknown";
 }
+function specSourceLines(spec, snap) {
+    if (!spec.sourcePath)
+        return [{ text: "Source path unavailable; no current-file claim." }];
+    const target = fileTargetForPath(spec.resolvedSourcePath ?? spec.sourcePath, snap.fileRoots ?? []) ?? { root: "", path: spec.sourcePath };
+    const lines = [fieldLine({ label: "source", value: `${displayPath(spec.sourcePath, 56)} · ${sourceProvenance(spec)}` }), listItem("View current source", { type: "file-open", target })];
+    if (!target.root)
+        lines.push({ text: "Source is not mapped to a configured readable root." });
+    if (target.root) {
+        lines.push({ text: `Readable root: ${target.root}` }, ...referenceLines(spec.description ?? "", target));
+        const markdownLinks = new Set([...((spec.description ?? "").matchAll(/\[[^\]\n]+\]\(<?([^\s)>]+)/g))].map((match) => match[1]));
+        // Prose paths stay relative to the named source, not an inferred checkout.
+        for (const match of (spec.description ?? "").matchAll(/(?:[\w.-]+\/)+[\w.-]+\.(?:md|txt|ya?ml)(?:#[\w-]+)?/g)) {
+            if (markdownLinks.has(match[0]))
+                continue;
+            lines.push(listItem(`Reference: ${match[0]} · relative to source`, referenceAction(target, match[0])));
+        }
+    }
+    return lines;
+}
 function displayPath(path, max = 68) {
     if (path.length <= max)
         return path;
@@ -630,6 +654,12 @@ function instanceContentLines(state, snap, host, contentWidth, motion) {
     return lines;
 }
 function contentLines(state, snap, contentWidth, motion) {
+    if (state.file) {
+        const read = JSON.stringify(snap.fileRead?.target) === JSON.stringify(state.file) ? snap.fileRead?.result : null;
+        return [...(state.project ? wrapDetailLines([{ text: `Project ${state.project.id} · ${state.project.root}` }], contentWidth) : []), ...fileLines(read, state.file, contentWidth)];
+    }
+    if (state.externalUrl)
+        return externalLines(state.externalUrl, contentWidth);
     const contentWidthForGraph = contentWidth;
     void contentWidthForGraph;
     const lines = [];
@@ -637,6 +667,10 @@ function contentLines(state, snap, contentWidth, motion) {
         return timeZoneLines(state, contentWidth);
     if (state.recentOpen)
         return recentDetailLines(state, snap, contentWidth);
+    if (state.section === "terminals")
+        return terminalLines(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)
@@ -676,6 +710,9 @@ function contentLines(state, snap, contentWidth, motion) {
         const rigName = state.drill.find((d) => d.kind === "rig")?.name ?? snap.hosts[0]?.rigs[0]?.name;
         const rig = host?.rigs.find((candidate) => candidate.name === rigName);
         if (!rig || !host) {
+            const notLoaded = snap.readErrors.find((error) => error.startsWith("Live data not loaded"));
+            if (notLoaded)
+                return [{ text: notLoaded }];
             // round-6 (guard): the ROOT topology branch consumes the OWNER's load
             // truth like every other read surface — a real in-flight cold start
             // renders the spinner; after settlement only a NAMED rigs-summary
@@ -754,7 +791,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("Configuration and human routes", { type: "jump", section: "connections" }));
+        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") {
@@ -844,13 +881,13 @@ function contentLines(state, snap, contentWidth, motion) {
         if (leaf?.kind === "spec") {
             const spec = findSpec(snap, leaf.name);
             if (!spec)
-                return [{ text: `spec "${leaf.name}" not in the current snapshot` }];
+                return [{ text: snap.readErrors.find((error) => error.startsWith("specs-library")) ?? (!snap.specsLoaded ? "Specs catalog read pending" : `spec "${leaf.name}" not in the current catalog`) }];
             if (spec.kind === "rig")
-                lines.push(specTabsLine(state, spec.name));
+                lines.push(specTabsLine(state));
             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(...specSourceLines(spec, snap));
             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 ?? []) {
@@ -867,8 +904,6 @@ function contentLines(state, snap, contentWidth, motion) {
             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") {
                     // ROUND-4 item 1: the established table treatment, not unformatted rows
                     const nodes = spec.graph?.nodes ?? [];
@@ -990,111 +1025,64 @@ function contentLines(state, snap, contentWidth, motion) {
             }
             return wrapDetailLines(lines, contentWidth);
         }
-        lines.push({ text: "SPEC LIBRARY" });
-        lines.push({ text: state.filter ? `/ filter specs: ${state.filter} · / replace · esc clear` : "/ filter specs…" });
-        // mirrors the explorer exactly (same grouping, same expansion state, same
-        // filter-overrides-collapse rule) — glance consistency across panes
-        const expandedSet = new Set(state.expanded);
-        for (const kind of ["rig", "agent", "workflow"]) {
-            const shown = snap.specs.filter((s) => s.kind === kind).filter((s) => !state.filter || s.name.includes(state.filter));
-            if (shown.length === 0 && !snap.specs.some((s) => s.kind === kind))
-                continue;
-            lines.push({ text: `  ${kind.toUpperCase()} (${shown.length})` });
-            if (kind !== "agent") {
-                for (const s of shown)
-                    lines.push({ text: `    ▪ ${s.name}`, action: { type: "drill", resource: "spec", name: s.name } });
-                continue;
-            }
-            const groups = new Map();
-            for (const s of shown) {
-                const namespace = s.namespace ?? "(root)";
-                groups.set(namespace, [...(groups.get(namespace) ?? []), s]);
-            }
-            for (const [namespace, specs] of [...groups.entries()].sort(([a], [b]) => a.localeCompare(b))) {
-                const open = namespace === "(root)" || expandedSet.has(`folder:${namespace}`) || !!state.filter;
-                if (namespace !== "(root)")
-                    lines.push({
-                        text: `    ${open ? "▾" : "▸"} ${namespace}/ (${specs.length})`,
-                        action: { type: "toggle-expand", key: `folder:${namespace}` },
-                    });
-                if (!open)
-                    continue;
-                for (const s of specs)
-                    lines.push({
-                        text: `${namespace === "(root)" ? "    " : "      "}▪ ${s.name}`,
-                        action: { type: "drill", resource: "spec", name: s.name },
-                    });
-            }
-        }
-        if (snap.specs.length === 0) {
-            // round-5 (guard): spin only while the owner is loading; settled empty
-            // is PROVEN empty and a settled failure is named — neither spins
-            if (motion.loading) {
-                if (!motion.reduced)
-                    motion.used = true;
-                lines.push({ text: `  ${motion.frame} library read pending — honest-empty` });
-            }
-            else if (snap.readErrors.some((e) => e.startsWith("specs-library"))) {
-                lines.push({ text: "  ✕ library read failed — named in the status line" });
-            }
-            else {
-                lines.push({ text: "  (library empty — proven, no specs served)" });
-            }
-        }
-        return lines;
-    }
-    if (state.section === "needs") {
-        lines.push({ text: "NEEDS-YOU" });
-        for (const item of snap.needs) {
-            // open/navigate is the ONLY in-TUI action (B3): the click target joins
-            // the item's session back to topology; unresolvable targets never
-            // advertise a control that can only fail.
-            lines.push(needsLine(item.source === "agent" ? "  ☐ " : "  ⚑ ", item, snap));
-        }
-        if (snap.needs.length === 0 && snap.humanQueueProbed)
-            lines.push({ text: "  (no fleet attention items right now)" });
-        if (snap.hostsDown.length > 0) {
-            // composed BESIDE the items (a separate shipped read), never into the item shape
-            lines.push({ text: "" });
-            lines.push({ text: "  hosts/rigs down:" });
-            // NB: glyphs here must be single-cell — U+26D4 ⛔ is emoji-width (2 cells)
-            // and wraps a full-width padded line, shearing every row below it.
-            for (const h of snap.hostsDown)
-                lines.push({ text: `  ✖ ${alignedRow([[h.hostId, 28], [h.status, 26]])} ${h.error ?? ""}`.trimEnd() });
+        if (state.filter)
+            lines.push({ text: `/ filter specs: ${state.filter} · / replace · esc clear` });
+        const selected = computeExplorerRows(state, snap)[state.selection]?.action;
+        const spec = selected?.type === "drill" && selected.resource === "spec" ? findSpec(snap, selected.name) : null;
+        if (spec) {
+            lines.push({ text: `${spec.name} · ${spec.kind} · ${sourceProvenance(spec)}` });
+            lines.push({ text: "" }, { text: spec.description?.trim() || "Purpose not declared in the available source." });
+            if (spec.kind === "rig")
+                lines.push(fieldLine({ label: "contents", value: `${spec.pods?.length ?? 0} pods · ${spec.pods?.reduce((n, p) => n + p.members.length, 0) ?? spec.legacyNodes?.length ?? 0} members · ${spec.agentRefs?.join(", ") || "no member references served"}` }));
+            else if (spec.kind === "agent")
+                lines.push(fieldLine({ label: "contents", value: `${spec.runtime ?? "runtime not declared"} · ${(spec.skills ?? []).length} skills · ${(spec.startupFiles ?? []).length} startup files` }));
+            else
+                lines.push(fieldLine({ label: "contents", value: `${spec.rolesCount ?? "unknown"} roles · ${spec.stepsCount ?? "unknown"} steps` }));
+            lines.push({ text: "" }, listItem("Read details · Enter", { type: "drill", resource: "spec", name: spec.name }), ...specSourceLines(spec, snap));
+            if (spec.sourceUnavailable)
+                lines.push({ text: `Source unavailable: ${spec.sourceUnavailable}` });
         }
-        lines.push({ text: "" });
-        if (!snap.humanQueueProbed) {
-            if (motion.loading) {
-                // region discipline (max ONE persistent animation): while a derived ⚑
-                // item pulses on this page, the pending spinner degrades to the honest
-                // static dot instead of animating beside it
-                const pulseVisible = snap.needs.some((item) => item.source === "derived") && !motion.reduced;
-                const spin = pulseVisible ? "·" : motion.frame;
-                if (!pulseVisible && !motion.reduced)
-                    motion.used = true;
-                lines.push({ text: `  ${spin} human-queue: not yet known (read pending)` });
-            }
-            else {
-                // round-5 (guard): settled-unprobed is a static truth (hosts down or
-                // registry unavailable) — "(read pending)" would be a false claim
-                lines.push({ text: "  human-queue: not yet known (hosts unreachable or registry unavailable)" });
+        else {
+            lines.push({ text: "SPEC LIBRARY" }, { text: "Choose a spec at left to preview its purpose, contents and source." }, { text: "Enter reads details · / filters · source opens current disk content" }, { text: "" });
+            for (const kind of ["rig", "agent", "workflow"])
+                lines.push({ text: `${kind}: ${snap.specs.filter((spec) => spec.kind === kind).length} available` });
+            if (!snap.specs.length) {
+                if (motion.loading) {
+                    if (!motion.reduced)
+                        motion.used = true;
+                    lines.push({ text: `  ${motion.frame} library read pending` });
+                }
+                else {
+                    const failure = snap.readErrors.find((error) => error.startsWith("specs-library"));
+                    const notLoaded = snap.readErrors.find((error) => error.startsWith("Live data not loaded"));
+                    lines.push({ text: failure ? `  ✕ library read failed: ${failure}` : notLoaded ?? (snap.specsLoaded === false ? "Specs catalog read unavailable" : "  (library empty — proven, no specs served)") });
+                }
             }
         }
-        else if (!snap.needs.some((item) => item.source === "agent"))
-            lines.push({ text: "  human-queue: no items (proven empty — surfacing adoption pending)" });
-        return lines;
+        return wrapDetailLines(lines, contentWidth);
     }
+    if (state.section === "needs")
+        return attentionLines(state, snap, contentWidth);
     if (state.section === "scopes") {
-        if (!state.scopesMission && snap.execution) {
-            const selected = snap.execution;
-            const instances = selected.lifecycle_instances;
+        const catalog = snap.projects;
+        if (!state.project && catalog !== undefined)
             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.` },
+                { text: "PROJECTS · select a project" },
+                { text: catalog ? `Catalog: ${catalog.catalogPath}` : "Project catalog unavailable or loading" },
+                ...(snap.readErrors ?? []).map(text => ({ text })),
+                ...(catalog?.projects ?? []).flatMap(p => [listItem(`${p.name} · ${p.id}`, { type: "project-select", id: p.id }), { text: p.root }, ...(p.error ? [{ text: `Unavailable: ${p.error}` }] : [])]),
+                ...(catalog?.projects.length === 0 ? [{ text: "No projects declared in this catalog." }] : []),
             ], contentWidth);
-        }
+        const identity = state.project ? wrapDetailLines([{ text: `PROJECT ${state.project.id}` }, { text: state.project.root }], contentWidth) : [];
+        if (state.project && (snap.projectRead?.id !== state.project.id || snap.projectRead?.root !== state.project.root))
+            return [...identity, { text: "Reading selected project…" }];
+        const entry = catalog?.projects.find(p => p.id === state.project.id && p.root === state.project.root);
+        const errors = (snap.readErrors ?? []).map(text => ({ text: `Unavailable: ${text}` }));
+        const projectHeader = state.project ? [...identity, listItem("Read current source", { type: "project-source" }), ...wrapDetailLines(errors, contentWidth)] : [];
+        if (state.project && (!entry || entry.error))
+            return [...projectHeader, { text: "Choose a project again or go Back." }];
+        if (state.project && !state.scopesMission)
+            return [...projectHeader, { text: "Choose a mission" }, ...(snap.scopes ?? []).map(m => listItem(m.mission, { type: "scopes-mission-open", mission: m.mission })), ...(!snap.scopes?.length && !errors.length ? [{ text: "No missions found in this project." }] : [])];
         // 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.
@@ -1105,27 +1093,27 @@ function contentLines(state, snap, contentWidth, motion) {
             ? (snap.scopes ?? []).find((m) => m.mission === sel.mission)?.slices.find((sl) => sl.dirName === sel.slice) ?? null
             : null;
         if (state.executionOpen && execution) {
-            return executionContentLines(execution, snap.scopes, snap.readErrors, state.executionOpen, contentWidth, false, snap.sliceDetail, {
-                collapseReqs: state.scopesCollapseReqs,
-                narrative: state.scopesNarrative,
-            }, state.timeZone);
+            return [...projectHeader, ...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);
+            return [...projectHeader, ...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, undefined, undefined, state.timeZone);
-            return execution ? lines : [{ text: `  ${missionName} EXECUTION` }, ...lines];
+            return [...projectHeader, ...(execution ? lines : [{ text: `  ${missionName} EXECUTION` }, ...lines])];
         }
-        return scopesContentLines(detail, missionName, {
-            collapseReqs: state.scopesCollapseReqs,
-            narrative: state.scopesNarrative,
-            width: contentWidth,
-            executionStrip: detail ? executionSliceStripLines(null, detail.id ?? detail.dirName, detail.dirName, contentWidth, detail.status) : undefined,
-        });
+        return [...projectHeader, ...scopesContentLines(detail, missionName, {
+                collapseReqs: state.scopesCollapseReqs,
+                narrative: state.scopesNarrative,
+                width: contentWidth,
+                executionStrip: detail ? executionSliceStripLines(null, detail.id ?? detail.dirName, detail.dirName, contentWidth, detail.status) : undefined,
+            })];
     }
     return [{ text: `(${state.section})` }];
 }
@@ -1168,11 +1156,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
@@ -1241,7 +1233,7 @@ function renderPulseScreen(state, snap, options, inputLine) {
     const contentTargets = [];
     const flashRows = [];
     let flashAck = false;
-    lines.push(pad(`cmd ▸ ${inputLine}▊${inputLine ? "" : "  Tab complete · ? help · timezone"}`, 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))
@@ -1249,21 +1241,6 @@ function renderPulseScreen(state, snap, options, inputLine) {
         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) {
-        const rows = filterPalette(state.palette.query, COMMAND_REGISTRY, options.commandContext ?? "standard");
-        const sel = Math.min(state.palette.selection, Math.max(0, rows.length - 1));
-        lines.push(pad(`? ${state.palette.query}▊  (${rows.length} commands · ↑↓ · ⏎ run · esc close)`, cols));
-        for (let i = 0; i < Math.min(rows.length, 8); i += 1) {
-            const r = rows[i];
-            const mark = i === sel ? "▸" : " ";
-            const label = `${r.entry.name}${r.entry.args ? " " + r.entry.args : ""}`;
-            const alias = r.entry.aliases.length ? ` (${r.entry.aliases.join(",")})` : "";
-            const tail = r.available ? r.entry.description : `${r.entry.description} — unavailable: ${r.reason}`;
-            lines.push(pad(`${mark} ${label}${alias}  ${tail}`, cols));
-        }
-    }
     const explorerTitle = state.focusedPane === "explorer" ? "{ EXPLORER }" : "EXPLORER";
     const contentTitle = state.focusedPane === "content" ? "{ PULSE }" : "PULSE";
     lines.push(paneRule(cols, explW, "top", explorerTitle, contentTitle));
@@ -1403,7 +1380,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;
         }
     }
@@ -1413,6 +1390,7 @@ 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 explorer's source note, then any discovered rigs (name + seat count).
@@ -1431,6 +1409,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);
@@ -1444,7 +1424,7 @@ function crashCartShell(content, led, contentTitle, cols, rows, inputLine, opts)
     return {
         lines: lines.slice(0, rows),
         explorerWidth: explW,
-        hitMap: [],
+        hitMap,
         contentTargets: [],
         contentMaxOffset,
         explorerRows: [],
@@ -1452,8 +1432,36 @@ function crashCartShell(content, led, contentTitle, cols, rows, inputLine, opts)
     };
 }
 export function renderScreen(state, snap, options = {}, inputLine = "") {
+    if (state.palette)
+        return helpScreen(state.palette, options.commandContext ?? "standard", options.cols ?? 120, options.rows ?? 32);
+    const screen = renderBody(state, snap, options, inputLine);
+    const commandReady = !options.startup?.open && !options.restore && !options.unavailable && (!options.daemonState || options.daemonState === "up");
+    if (commandReady) {
+        const reduced = reducedMotion();
+        if (!commandFocusVisible(options.nowMs ?? 0, inputLine.length > 0, reduced)) {
+            const line = screen.lines[0];
+            screen.lines[0] = line.slice(0, 6) + " " + line.slice(7);
+        }
+        screen.commandMotionActive = !reduced && inputLine.length === 0;
+    }
+    return screen;
+}
+function renderBody(state, snap, options = {}, inputLine = "") {
     const { cols = 120, rows = 32, nowMs = 0 } = options;
-    const explW = explorerWidth(cols);
+    const fullReading = !options.startup?.open && (!!state.file || !!state.externalUrl || (cols <= 90 && state.section === "specs" && state.drill.length > 0));
+    const explW = fullReading ? 0 : 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.local?.selected ?? startup.selected}`);
+        const scroll = startup.local && !startup.local.result.entries ? startup.local.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("? Help · w Skip · L Local · ↑↓ scroll · Enter read · 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
@@ -1470,13 +1478,33 @@ 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) {
@@ -1505,7 +1533,7 @@ export function renderScreen(state, snap, options = {}, inputLine = "") {
     // current insertion point for EMPTY and non-empty buffers alike — the
     // 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).
+    // paints the cell; the shared motion clock controls its visibility).
     lines.push(pad(`cmd ▸ ${inputLine}▊${inputLine ? "" : "  Tab complete · ? help · timezone"}`, cols));
     if (options.completion) {
         lines.push(pad(options.completion.message, cols));
@@ -1514,31 +1542,16 @@ export function renderScreen(state, snap, options = {}, inputLine = "") {
         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) {
-        const rows = filterPalette(state.palette.query, COMMAND_REGISTRY, options.commandContext ?? "standard");
-        const sel = Math.min(state.palette.selection, Math.max(0, rows.length - 1));
-        lines.push(pad(`? ${state.palette.query}▊  (${rows.length} commands · ↑↓ · ⏎ run · esc close)`, cols));
-        for (let i = 0; i < Math.min(rows.length, 8); i += 1) {
-            const r = rows[i];
-            const mark = i === sel ? "▸" : " ";
-            const label = `${r.entry.name}${r.entry.args ? " " + r.entry.args : ""}`;
-            const alias = r.entry.aliases.length ? ` (${r.entry.aliases.join(",")})` : "";
-            const tail = r.available ? r.entry.description : `${r.entry.description} — unavailable: ${r.reason}`;
-            lines.push(pad(`${mark} ${label}${alias}  ${tail}`, cols));
-        }
-    }
-    const sectionTitle = { topology: "TOPOLOGY", specs: "SPECS", needs: "NEEDS-YOU" }[state.section] ?? state.section.toUpperCase();
+    const sectionTitle = { topology: "TOPOLOGY", specs: "SPECS", scopes: "PROJECTS", needs: "ATTENTION" }[state.section] ?? state.section.toUpperCase();
     // active-pane emphasis (k9s-class chrome): the focused pane's title is bracketed
     const explorerTitle = state.focusedPane === "explorer" ? "{ EXPLORER }" : "EXPLORER";
     const contentTitle = state.focusedPane === "content" ? `{ ${sectionTitle} }` : sectionTitle;
-    lines.push(paneRule(cols, explW, "top", explorerTitle, contentTitle));
-    const explorer = computeExplorerRows(state, snap);
+    lines.push(fullReading ? pad(`━ ${state.file ? "READ" : state.externalUrl ? "EXTERNAL URL" : "SPECS"} · Esc / ← Back `, cols) : paneRule(cols, explW, "top", explorerTitle, contentTitle));
+    const explorer = fullReading ? [] : computeExplorerRows(state, snap);
     // Slice-17: the file-tree re-skin is a DISPLAY transform only — rows, keys,
     // actions, and the hit-map all keep resolving against the row model above.
     const { labels: explorerDisplay, metas: explorerMetas } = navigatorDisplay(explorer, snap, explW - 1);
-    const content = contentLines(state, snap, Math.max(cols - explW - 2, 0), motion);
+    const content = contentLines(state, snap, Math.max(cols - explW - (fullReading ? 1 : 2), 0), motion);
     const footer = state.footerOn ? snap.stream.at(-1) : undefined;
     // round-5 (guard): the tmux-style ONE-SHOT activity flash targets the
     // flashed agent's EXPLORER row — per-seat pane-output events from the
@@ -1610,7 +1623,7 @@ export function renderScreen(state, snap, options = {}, inputLine = "") {
             else
                 contentMarker = "›";
         }
-        lines.push(pad(`${left}┃${contentMarker}${contentText}`, cols));
+        lines.push(pad(fullReading ? `${contentMarker}${contentText}` : `${left}┃${contentMarker}${contentText}`, cols));
         if (row) {
             pushExplorerTargets(hitMap, row, explorerDisplay[explorerIndex] ?? row.label, y, explW);
             explorerRows.push({ ...row, y });
@@ -1622,12 +1635,12 @@ export function renderScreen(state, snap, options = {}, inputLine = "") {
         }
         // zones first: hit lookup takes the first match, so a zone wins over the row-wide action
         for (const z of zones) {
-            const target = { y, x1: explW + 3 + z.start, x2: explW + 2 + z.end, action: z.action };
+            const target = { y, x1: (fullReading ? 2 : explW + 3) + z.start, x2: (fullReading ? 1 : explW + 2) + z.end, action: z.action };
             hitMap.push(target);
             contentTargets.push(target);
         }
         if (item?.action) {
-            const target = { y, x1: explW + 3, x2: cols, action: item.action };
+            const target = { y, x1: fullReading ? 2 : explW + 3, x2: cols, action: item.action };
             hitMap.push(target);
             contentTargets.push(target);
         }
@@ -1638,8 +1651,8 @@ export function renderScreen(state, snap, options = {}, inputLine = "") {
         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(fullReading ? "━".repeat(cols) : paneRule(cols, explW, "bottom"));
+    lines.push(pad(fullReading ? "↑↓ scroll / links · → links · Enter open · Esc Back · refresh · v copy" : keybindHints(state), 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("");