@openrig/cli 0.5.12 → 0.5.14

package/tui/dist/render.js

@@ -1,3 +1,7 @@
+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";
@@ -9,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";
@@ -22,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) {
@@ -434,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) => {
@@ -469,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;
@@ -530,13 +552,13 @@ function instanceContentLines(state, snap, host, contentWidth, motion) {
                     fields: [
                         { label: "identity", value: host.name },
                         { label: "transport", value: host.id ?? "local" },
-                        { label: "shape", value: `${host.rigs.length} rigs · ${host.rigs.reduce((n, rig) => n + rig.pods.reduce((m, pod) => m + pod.agents.length, 0), 0)} seats` },
+                        { label: "shape", value: host.rigs.some(r => r.inventoryUnavailable) ? `${host.rigs.length} rigs · seat inventory incomplete` : `${host.rigs.length} rigs · ${host.rigs.reduce((n, rig) => n + rig.pods.reduce((m, pod) => m + pod.agents.length, 0), 0)} seats` },
                     ],
                 },
                 {
                     title: "rigs",
                     lines: host.rigs.length > 0
-                        ? host.rigs.map((rig) => listItem(alignedRow([[rig.name, 20], [rig.lifecycleState ?? "unknown", 20], [`${rig.pods.length} pods · ${rig.pods.reduce((n, pod) => n + pod.agents.length, 0)} seats`, 24]]), { type: "drill", resource: "rig", name: rig.name, target: { host: host.name } }))
+                        ? host.rigs.map((rig) => listItem(alignedRow([[rig.name, 20], [rig.lifecycleState ?? "unknown", 20], [rig.inventoryUnavailable ? "inventory unavailable" : `${rig.pods.length} pods · ${rig.pods.reduce((n, pod) => n + pod.agents.length, 0)} seats`, 24]]), { type: "drill", resource: "rig", name: rig.name, target: { host: host.name } }))
                         : [{ text: "  (no local rigs served — proven empty)" }],
                 },
             ]),
@@ -591,7 +613,7 @@ function instanceContentLines(state, snap, host, contentWidth, motion) {
         const rigAction = { type: "drill", resource: "rig", name: rig.name, target: { host: host.name } };
         if (agents.length === 0) {
             lines.push({
-                text: tableRow(columns, { rig: rig.name, pod: "—", seat: "(no seats)", status: rig.lifecycleState ?? "unknown" }),
+                text: tableRow(columns, { rig: rig.name, pod: "—", seat: rig.inventoryUnavailable ? "(read failed)" : "(no seats)", status: rig.lifecycleState ?? "unknown" }),
                 action: rigAction,
             });
             continue;
@@ -627,11 +649,17 @@ 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({ text: "" }, { text: host.rigs.some(r => r.inventoryUnavailable) ? `${host.rigs.length} rigs · inventory incomplete · ${seatCount} seats read` : `${host.rigs.length} rigs · ${seatCount} seats · ${workingCount} working · ${attentionCount} need attention · ${openCount} open rows` });
     lines.push(...recentLines(snap, scope, contentWidth, false, state.timeZone));
     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 = [];
@@ -639,12 +667,16 @@ 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)
         return healthDetailLines(snap, state.healthOpen, contentWidth, state.timeZone);
+    if (state.section === "system")
+        return [{ text: "System · Instance health" }, { text: "" }, ...healthListLines(snap, { kind: "instance", local: true }, contentWidth)];
     // 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") {
@@ -677,9 +709,18 @@ function contentLines(state, snap, contentWidth, motion) {
         const host = (hostName ? snap.hosts.find((candidate) => candidate.name === hostName) : snap.hosts[0]);
         if (leaf?.kind === "host" && host)
             return instanceContentLines(state, snap, host, contentWidth, motion);
-        const rigName = state.drill.find((d) => d.kind === "rig")?.name ?? snap.hosts[0]?.rigs[0]?.name;
+        if (!leaf && host?.rigs.length)
+            return wrapDetailLines([
+                { text: `TOPOLOGY · ${host.name}` }, { text: "Choose a rig to read its seats and work." },
+                { text: `${host.rigs.length} rig${host.rigs.length === 1 ? "" : "s"} · select one in Explorer` },
+                { text: "Bright ▦ live agents · gray ▦ none · ? unknown" },
+            ], contentWidth);
+        const rigName = state.drill.find((d) => d.kind === "rig")?.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
@@ -694,6 +735,10 @@ function contentLines(state, snap, contentWidth, motion) {
             }
             return [{ text: "(no rigs served — proven empty, not fabricated)" }];
         }
+        if (rig.inventoryNotLoaded)
+            return [{ text: `Reading ${rig.name}…` }];
+        if (rig.inventoryUnavailable)
+            return [{ text: `Inventory unavailable for ${rig.name} · refresh to Retry` }];
         const podFilter = leaf?.kind === "pod" ? leaf.name : null;
         const all = rig.pods.flatMap((p) => p.agents.map((a) => ({ pod: p.name, ...a })));
         const rows = all
@@ -848,13 +893,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 ?? []) {
@@ -871,8 +916,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 ?? [];
@@ -994,142 +1037,106 @@ 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: "" });
+            if (snap.specsLoaded !== false && !snap.readErrors.some(e => e.startsWith("specs-library")))
+                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 missionOverview = !!state.scopesMission && !state.scopesSelected && !state.executionOpen;
+        const projectHeader = state.project ? missionOverview
+            ? [{ text: `PROJECT ${state.project.id}`, action: { type: "project-source" } }, ...wrapDetailLines(errors, contentWidth)]
+            : [...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 + (m.error ? " · source unavailable" : ""), { 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.
         const sel = state.scopesSelected;
         const missionName = state.scopesMission;
+        const mission = snap.scopes?.find(m => m.mission === missionName);
+        if (mission?.error)
+            return [...projectHeader, ...wrapDetailLines([{ text: `${missionName} · Source unavailable` }, { text: mission.error }, { text: "Correct the source and refresh; Back returns to other missions." }], contentWidth)];
         const execution = snap.execution?.mission === missionName ? snap.execution : null;
         const detail = sel
             ? (snap.scopes ?? []).find((m) => m.mission === sel.mission)?.slices.find((sl) => sl.dirName === sel.slice) ?? null
             : null;
+        if (detail?.error)
+            return [...projectHeader, ...wrapDetailLines([{ text: `${missionName}/${detail.dirName} · Source unavailable` }, { text: detail.error }, { text: "Correct the source and refresh; Back returns to other slices." }], contentWidth)];
+        if (!sel && !state.executionOpen)
+            projectHeader.push(...(mission?.slices.filter(s => s.error) ?? []).map(s => listItem(`${s.dirName} · source unavailable`, { type: "scopes-open", mission: missionName, slice: s.dirName })));
         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})` }];
 }
@@ -1216,6 +1223,15 @@ function pushExplorerTargets(hitMap, row, display, y, explorerWidth) {
     }
     hitMap.push({ y, x1: 1, x2: explorerWidth, action: row.action });
 }
+function readStatus(load, zone) {
+    const at = load.retainedAt ?? load.lastSuccessAt;
+    const basis = at === undefined ? "" : ` · last ${displayTime(new Date(at).toISOString(), zone)}`;
+    if (load.inFlight)
+        return `${load.settled ? "Refreshing" : "Loading"}…${basis} · ? Help`;
+    if (load.stale)
+        return `${at === undefined ? "Read failed" : "Could not refresh"}${basis} · refresh to Retry`;
+    return `Tab complete · ? help${basis}`;
+}
 function renderPulseScreen(state, snap, options, inputLine) {
     const { cols = 120, rows = 32, nowMs = 0 } = options;
     const explW = explorerWidth(cols);
@@ -1249,7 +1265,9 @@ function renderPulseScreen(state, snap, options, inputLine) {
     const contentTargets = [];
     const flashRows = [];
     let flashAck = false;
-    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));
+    lines.push(pad(`cmd ▸ ${inputLine}▊${inputLine ? "" : "  " + readStatus(load, state.timeZone)}`, cols));
+    if (load.stale && !inputLine)
+        hitMap.push({ y: 1, x1: 9, x2: cols, action: { type: "noop" } });
     if (options.completion) {
         lines.push(pad(options.completion.message, cols));
         for (const candidate of options.completion.candidates.slice(0, 4))
@@ -1257,21 +1275,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));
@@ -1463,18 +1466,34 @@ 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.selected}`);
-        const scroll = startup.expanded ? startup.scroll : Math.max(0, selected - Math.max(1, rows - 12));
+        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("↑↓ choose · Enter select · r refresh · d details · Esc back · q quit", cols);
+        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
@@ -1529,7 +1548,7 @@ export function renderScreen(state, snap, options = {}, inputLine = "") {
     // PULSE (founder Option-B): a content-pane view inside the NORMAL explorer│
     // content chrome — renderPulseScreen builds its own split (sidebar + lanes)
     // and rides the same segRows paint path, so it returns before the table layout.
-    if (state.viewTab === "pulse")
+    if (state.viewTab === "pulse" && options.load?.settled !== false)
         return renderPulseScreen(state, snap, options, inputLine);
     // S19 round-5 (guard): one spinner frame per render pass from caller time;
     // `loading` comes from the refresh OWNER (omitted = settled — demo/fixture
@@ -1548,8 +1567,10 @@ 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).
-    lines.push(pad(`cmd ▸ ${inputLine}▊${inputLine ? "" : "  Tab complete · ? help · timezone"}`, cols));
+    // paints the cell; the shared motion clock controls its visibility).
+    lines.push(pad(`cmd ▸ ${inputLine}▊${inputLine ? "" : "  " + readStatus(load, state.timeZone)}`, cols));
+    if (load.stale && !inputLine)
+        hitMap.push({ y: 1, x1: 9, x2: cols, action: { type: "noop" } });
     if (options.completion) {
         lines.push(pad(options.completion.message, cols));
         for (const candidate of options.completion.candidates.slice(0, 4))
@@ -1557,31 +1578,26 @@ 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: "FEED", system: "SYSTEM · HEALTH", config: "SYSTEM · CONFIGURATION", connections: "SYSTEM · CONNECTIONS" }[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 contentWidth = Math.max(cols - explW - (fullReading ? 1 : 2), 0);
+    const previous = !load.settled && !state.externalUrl ? options.previousPage : undefined;
+    const content = previous
+        ? [...wrapDetailLines([{ text: `Previous: ${previous.state.section} · ${previous.state.file ? `${previous.state.file.root}/${previous.state.file.path}` : previous.state.drill.map(d => d.name).join(" / ") || [previous.state.project?.id, previous.state.scopesMission, previous.state.terminalView].filter(Boolean).join(" / ") || "overview"}` }], contentWidth),
+            { text: `Opening ${sectionTitle.toLowerCase()}… · Explorer remains available` },
+            ...contentLines(previous.state, previous.snapshot, contentWidth, { ...motion, loading: false }).map(line => ({ text: line.text }))]
+        : !load.settled && !state.externalUrl
+            ? [{ text: `${sectionTitle} · choose a location in Explorer` }, { text: `${motion.frame} ${sectionTitle.toLowerCase()} read pending…` }]
+            : contentLines(state, snap, contentWidth, motion);
+    if (!load.settled && !reduced)
+        motion.used = true;
     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
@@ -1653,7 +1669,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 });
@@ -1665,12 +1681,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);
         }
@@ -1681,8 +1697,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("");