@ouro.bot/cli 0.1.0-alpha.443 → 0.1.0-alpha.445

package/changelog.json

@@ -1,6 +1,22 @@
 {
   "_note": "This changelog is maintained as part of the PR/version-bump workflow. Agent-curated, not auto-generated. Agents read this file directly via read_file to understand what changed between versions.",
   "versions": [
+    {
+      "version": "0.1.0-alpha.445",
+      "changes": [
+        "`ouro up` no longer smears old lines across the screen when the live frame shrinks. The boot checklist and daemon-start polling now share one overwrite primitive, so long waits keep breathing without duplicating the masthead or leaving stale rows behind.",
+        "`ouro status` is back to being a compact runtime cockpit instead of a generic wizard board. The TTY command now routes through the dense status deck again, so operators get the fast, scannable view they actually need.",
+        "The boot surface itself is lighter and truer: the masthead only uses the wide wordmark when it really fits, the checklist stays in plan order while a middle step is active, and the current-work panel now reads like a real boot sequencer instead of a stack of `Overview` cards."
+      ]
+    },
+    {
+      "version": "0.1.0-alpha.444",
+      "changes": [
+        "`ouro up` now treats daemon startup as one truthful boot story across fresh starts and daemon replacement: both paths wait on the same current-boot readiness check, keep narrating real progress while the background service warms up, and stop calling startup done just because one quick socket probe answered.",
+        "Slow real-world boots now get more patience and better visibility. The default startup timeout was extended to 60 seconds, the boot checklist keeps printing live startup detail instead of stalling on a blinking cursor, and replacement boot failures now land as a failed `starting daemon` step with plain-language diagnosis.",
+        "Startup failures now behave like failures to the shell as well as to the human: `ouro up` sets a non-zero exit code when daemon boot does not finish, and `ouro logs` is wired into the installed CLI again so the recovery path it points to actually opens the live daemon/agent log tail."
+      ]
+    },
     {
       "version": "0.1.0-alpha.443",
       "changes": [

package/dist/heart/daemon/cli-defaults.js

@@ -514,11 +514,16 @@ function createDefaultOuroCliDeps(socketPath = socket_client_1.DEFAULT_DAEMON_SO
         sendCommand: socket_client_1.sendDaemonCommand,
         startDaemonProcess: defaultStartDaemonProcess,
         writeStdout: defaultWriteStdout,
+        setExitCode: (code) => {
+            const current = typeof process.exitCode === "number" ? process.exitCode : 0;
+            process.exitCode = Math.max(current, code);
+        },
         writeRaw: defaultWriteRaw,
         isTTY: process.stdout.isTTY === true,
         checkSocketAlive: socket_client_1.checkDaemonSocketAlive,
         cleanupStaleSocket: defaultCleanupStaleSocket,
         fallbackPendingMessage: defaultFallbackPendingMessage,
+        tailLogs: (options) => (0, log_tailer_1.tailLogs)(options),
         healthFilePath: (0, daemon_health_1.getDefaultHealthPath)(),
         readHealthState: daemon_health_1.readHealth,
         readHealthUpdatedAt: defaultReadHealthUpdatedAt,
@@ -528,7 +533,7 @@ function createDefaultOuroCliDeps(socketPath = socket_client_1.DEFAULT_DAEMON_SO
         updateCheckTimeoutMs: update_checker_1.CLI_UPDATE_CHECK_TIMEOUT_MS,
         startupPollIntervalMs: 250,
         startupStabilityWindowMs: 1_500,
-        startupTimeoutMs: 10_000,
+        startupTimeoutMs: 60_000,
         startupRetryLimit: 1,
         listDiscoveredAgents: defaultListDiscoveredAgents,
         runHatchFlow: hatch_flow_1.runHatchFlow,

package/dist/heart/daemon/cli-exec.js

@@ -39,6 +39,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.summarizeDaemonStartupFailure = summarizeDaemonStartupFailure;
 exports.mergeStartupStability = mergeStartupStability;
 exports.ensureDaemonRunning = ensureDaemonRunning;
 exports.listGithubCopilotModels = listGithubCopilotModels;
@@ -100,7 +101,7 @@ const agent_discovery_1 = require("./agent-discovery");
 const connect_bay_1 = require("./connect-bay");
 const runtime_capability_check_1 = require("../runtime-capability-check");
 // ── ensureDaemonRunning ──
-const DEFAULT_DAEMON_STARTUP_TIMEOUT_MS = 10_000;
+const DEFAULT_DAEMON_STARTUP_TIMEOUT_MS = 60_000;
 const DEFAULT_DAEMON_STARTUP_POLL_INTERVAL_MS = 500;
 const DEFAULT_DAEMON_STARTUP_STABILITY_WINDOW_MS = 1_500;
 const DEFAULT_DAEMON_STARTUP_RETRY_LIMIT = 1;
@@ -122,6 +123,31 @@ function summarizeCliUpdateCheckStatus(error, timedOut = false) {
     }
     return "skipped; update check unavailable";
 }
+function returnCliFailure(deps, message, exitCode = 1) {
+    deps.setExitCode?.(exitCode);
+    deps.writeStdout(message);
+    return message;
+}
+function summarizeDaemonStartupFailure(result) {
+    if (result.startupFailureReason && result.startupFailureReason.trim().length > 0) {
+        return result.startupFailureReason;
+    }
+    const firstLine = result.message.split(/\r?\n/, 1)[0]?.trim();
+    return firstLine && firstLine.length > 0
+        ? firstLine
+        : "background service failed to finish booting";
+}
+function formatDaemonStartupProgressLine(serviceLabel, status, latestEvent) {
+    const base = status === "waiting"
+        ? `waiting for the ${serviceLabel} to answer`
+        : status === "answering"
+            ? `${serviceLabel} answered\n- waiting for this boot to publish its ready signal`
+            : `${serviceLabel} answered\n- ready signal received; making sure it holds`;
+    const trimmedEvent = latestEvent?.trim();
+    return trimmedEvent && status !== "stabilizing"
+        ? `${base}\n- latest daemon event: ${trimmedEvent}`
+        : base;
+}
 async function runCliUpdateCheckWithTimeout(checkForCliUpdate, timeoutMs = update_checker_1.CLI_UPDATE_CHECK_TIMEOUT_MS) {
     return await new Promise((resolve, reject) => {
         let settled = false;
@@ -629,7 +655,7 @@ async function ensureDaemonRunning(deps, options = {}) {
             // The daemon writes structured events to daemon.ndjson in the first
             // agent bundle's state/daemon/logs/ directory. Read the last line to
             // surface what it's currently doing (e.g., "starting auto-start agents").
-            const bundlesRoot = (0, identity_1.getAgentBundlesRoot)();
+            const bundlesRoot = deps.bundlesRoot ?? (0, identity_1.getAgentBundlesRoot)();
             if (!fs.existsSync(bundlesRoot))
                 return null;
             const agents = fs.readdirSync(bundlesRoot).filter((d) => d.endsWith(".ouro"));
@@ -706,9 +732,27 @@ async function ensureDaemonRunning(deps, options = {}) {
             startDaemonProcess: deps.startDaemonProcess,
             checkSocketAlive: deps.checkSocketAlive,
             onProgress: deps.reportDaemonStartupPhase,
+            waitForDaemonStartup: async ({ pid }) => {
+                const startupFailure = await waitForDaemonStartup(deps, {
+                    bootStartedAtMs: (deps.now ?? Date.now)(),
+                    pid,
+                    serviceLabel: "replacement background service",
+                    readLatestDaemonEvent: readLatestDaemonStartupEvent,
+                });
+                return startupFailure
+                    ? { ok: false, reason: startupFailure.reason }
+                    : { ok: true };
+            },
         });
-        if (!runtimeResult.verifyStartupStatus) {
-            return runtimeResult;
+        if (!runtimeResult.ok) {
+            return {
+                ok: false,
+                alreadyRunning: runtimeResult.alreadyRunning,
+                message: runtimeResult.message,
+                verifyStartupStatus: runtimeResult.verifyStartupStatus,
+                startedPid: runtimeResult.startedPid,
+                startupFailureReason: runtimeResult.startupFailureReason ?? null,
+            };
         }
         const stability = await (0, startup_tui_1.pollDaemonStartup)({
             sendCommand: deps.sendCommand,
@@ -729,8 +773,12 @@ async function ensureDaemonRunning(deps, options = {}) {
             render: !deps.reportDaemonStartupPhase,
         });
         return {
+            ok: true,
             alreadyRunning: runtimeResult.alreadyRunning,
             message: runtimeResult.message,
+            verifyStartupStatus: runtimeResult.verifyStartupStatus,
+            startedPid: runtimeResult.startedPid,
+            startupFailureReason: null,
             stability,
         };
     }
@@ -750,6 +798,8 @@ async function ensureDaemonRunning(deps, options = {}) {
         const startupFailure = await waitForDaemonStartup(deps, {
             bootStartedAtMs,
             pid: lastPid,
+            serviceLabel: "new background service",
+            readLatestDaemonEvent: readLatestDaemonStartupEvent,
         });
         if (!startupFailure) {
             const stability = await (0, startup_tui_1.pollDaemonStartup)({
@@ -771,8 +821,10 @@ async function ensureDaemonRunning(deps, options = {}) {
                 render: !deps.reportDaemonStartupPhase,
             });
             return {
+                ok: true,
                 alreadyRunning: false,
                 message: `daemon started (pid ${lastPid ?? "unknown"})`,
+                startupFailureReason: null,
                 stability,
             };
         }
@@ -783,8 +835,10 @@ async function ensureDaemonRunning(deps, options = {}) {
         deps.reportDaemonStartupPhase?.("background service startup went sideways once; trying one more time");
     }
     return {
+        ok: false,
         alreadyRunning: false,
         message: formatDaemonStartupFailureMessage(lastPid, lastFailure, deps),
+        startupFailureReason: lastFailure.reason,
     };
 }
 function hasStartupHealthMonitor(deps) {
@@ -809,14 +863,14 @@ function hasFreshCurrentBootHealthSignal(deps, bootStartedAtMs, pid) {
 }
 function formatDaemonStartupFailureMessage(pid, failure, deps) {
     const lines = [
-        `daemon spawned (pid ${pid ?? "unknown"}) but failed to stabilize: ${failure.reason}`,
+        `background service started (pid ${pid ?? "unknown"}) but did not finish booting: ${failure.reason}`,
     ];
     const recentLogLines = deps.readRecentDaemonLogLines?.(DEFAULT_DAEMON_STARTUP_LOG_LINES) ?? [];
     if (recentLogLines.length > 0) {
         lines.push("recent daemon logs:");
         lines.push(...recentLogLines.map((line) => `  ${line}`));
     }
-    lines.push("fix hint for daemon: check daemon logs or run `ouro doctor`");
+    lines.push("Run `ouro logs` to watch live startup logs or `ouro doctor` for a deeper diagnosis.");
     return lines.join("\n");
 }
 async function waitForDaemonStartup(deps, options) {
@@ -830,13 +884,17 @@ async function waitForDaemonStartup(deps, options) {
     let stableSinceMs = null;
     let sawSocket = false;
     if (!useHealthMonitor) {
-        const verified = await verifyDaemonAlive(deps.checkSocketAlive, deps.socketPath, timeoutMs, pollIntervalMs, sleep, now);
-        return verified
-            ? null
-            : {
-                reason: `daemon failed to respond within ${Math.ceil(timeoutMs / 1000)}s`,
-                retryable: false,
-            };
+        while (now() < deadline) {
+            await sleep(pollIntervalMs);
+            const latestEvent = options.readLatestDaemonEvent?.() ?? null;
+            deps.reportDaemonStartupPhase?.(formatDaemonStartupProgressLine(options.serviceLabel, "waiting", latestEvent));
+            if (await deps.checkSocketAlive(deps.socketPath))
+                return null;
+        }
+        return {
+            reason: `${options.serviceLabel} did not answer within ${Math.ceil(timeoutMs / 1000)}s`,
+            retryable: false,
+        };
     }
     while (now() < deadline) {
         await sleep(pollIntervalMs);
@@ -844,40 +902,37 @@ async function waitForDaemonStartup(deps, options) {
         if (!aliveNow) {
             if (sawSocket) {
                 return {
-                    reason: "daemon socket disappeared during startup",
+                    reason: `${options.serviceLabel} answered once and then disappeared during startup`,
                     retryable: true,
                 };
             }
+            const latestEvent = options.readLatestDaemonEvent?.() ?? null;
+            deps.reportDaemonStartupPhase?.(formatDaemonStartupProgressLine(options.serviceLabel, "waiting", latestEvent));
             continue;
         }
         if (!sawSocket) {
             sawSocket = true;
             stableSinceMs = now();
-            deps.reportDaemonStartupPhase?.("verifying daemon health");
+            const latestEvent = options.readLatestDaemonEvent?.() ?? null;
+            deps.reportDaemonStartupPhase?.(formatDaemonStartupProgressLine(options.serviceLabel, "answering", latestEvent));
         }
         if (!hasFreshCurrentBootHealthSignal(deps, options.bootStartedAtMs, options.pid)) {
+            const latestEvent = options.readLatestDaemonEvent?.() ?? null;
+            deps.reportDaemonStartupPhase?.(formatDaemonStartupProgressLine(options.serviceLabel, "answering", latestEvent));
             continue;
         }
+        deps.reportDaemonStartupPhase?.(formatDaemonStartupProgressLine(options.serviceLabel, "stabilizing"));
         if (stableSinceMs !== null && now() - stableSinceMs >= stabilityWindowMs) {
             return null;
         }
     }
     return {
         reason: sawSocket
-            ? "daemon did not publish fresh health for the current boot attempt"
-            : `daemon failed to respond within ${Math.ceil(timeoutMs / 1000)}s`,
+            ? `${options.serviceLabel} answered but this boot never published a ready signal within ${Math.ceil(timeoutMs / 1000)}s`
+            : `${options.serviceLabel} did not answer within ${Math.ceil(timeoutMs / 1000)}s`,
         retryable: sawSocket,
     };
 }
-async function verifyDaemonAlive(checkSocketAlive, socketPath, maxWaitMs = 10_000, pollIntervalMs = 500, sleep = defaultSleep, now = Date.now) {
-    const deadline = now() + maxWaitMs;
-    while (now() < deadline) {
-        await sleep(pollIntervalMs);
-        if (await checkSocketAlive(socketPath))
-            return true;
-    }
-    return false;
-}
 function defaultSleep(ms) {
     return new Promise((resolve) => setTimeout(resolve, ms));
 }
@@ -4144,22 +4199,19 @@ async function runOuroCli(args, deps = (0, cli_defaults_1.createDefaultOuroCliDe
                 if (command.noRepair) {
                     writeProviderRepairSummary(deps, "Provider checks need attention", preflightProviderDegraded);
                     const message = "daemon not started: provider checks need repair. Run `ouro repair` or rerun `ouro up` to choose a repair path.";
-                    deps.writeStdout(message);
-                    return message;
+                    return returnCliFailure(deps, message);
                 }
                 const repairResult = await runReadinessRepairForDegraded(preflightProviderDegraded, deps);
                 if (!repairResult.repairsAttempted) {
                     writeProviderRepairSummary(deps, "Provider checks still need attention", repairResult.remainingDegraded);
                     const message = "daemon not started: provider checks need repair. Run `ouro repair` or rerun `ouro up` to choose a repair path.";
-                    deps.writeStdout(message);
-                    return message;
+                    return returnCliFailure(deps, message);
                 }
                 const remainingDegraded = repairResult.remainingDegraded;
                 if (remainingDegraded.length > 0) {
                     writeProviderRepairSummary(deps, "Still needs attention", remainingDegraded);
                     const message = "daemon not started: provider checks still need repair.";
-                    deps.writeStdout(message);
-                    return message;
+                    return returnCliFailure(deps, message);
                 }
                 deps.writeStdout("All set. Provider checks recovered after repair.");
             }
@@ -4172,12 +4224,11 @@ async function runOuroCli(args, deps = (0, cli_defaults_1.createDefaultOuroCliDe
                 progress.announceStep?.(label);
             },
         }, { initialAlive: daemonAliveBeforeStart });
-        if (daemonResult.verifyStartupStatus === false) {
+        if (!daemonResult.ok) {
             ;
-            progress.announceStep?.("replacement daemon did not answer in time");
+            progress.failPhase?.("starting daemon", summarizeDaemonStartupFailure(daemonResult));
             progress.end();
-            deps.writeStdout(daemonResult.message);
-            return daemonResult.message;
+            return returnCliFailure(deps, daemonResult.message);
         }
         progress.completePhase("starting daemon", daemonProgressSummary(daemonResult));
         if (!providerChecksAlreadyRun || daemonResult.alreadyRunning) {
@@ -4193,8 +4244,7 @@ async function runOuroCli(args, deps = (0, cli_defaults_1.createDefaultOuroCliDe
             progress.failPhase?.("final daemon check", finalDaemonCheck.summary);
             progress.end();
             const message = finalDaemonCheck.message ?? "background service stopped before boot finished";
-            deps.writeStdout(message);
-            return message;
+            return returnCliFailure(deps, message);
         }
         progress.completePhase("final daemon check", finalDaemonCheck.summary);
         progress.end();
@@ -5706,17 +5756,7 @@ async function runOuroCli(args, deps = (0, cli_defaults_1.createDefaultOuroCliDe
     }
     const fallbackMessage = response.summary ?? response.message ?? (response.ok ? "ok" : `error: ${response.error ?? "unknown error"}`);
     const message = command.kind === "daemon.status"
-        ? (() => {
-            const payload = (0, cli_render_1.parseStatusPayload)(response.data);
-            if (payload && ttyBoardEnabled(deps)) {
-                return (0, human_command_screens_1.renderHouseStatusScreen)({
-                    payload,
-                    isTTY: true,
-                    columns: deps.stdoutColumns ?? process.stdout.columns,
-                }).trimEnd();
-            }
-            return (0, cli_render_1.formatDaemonStatusOutput)(response, fallbackMessage);
-        })()
+        ? (0, cli_render_1.formatDaemonStatusOutput)(response, fallbackMessage)
         : fallbackMessage;
     deps.writeStdout(message);
     return message;

package/dist/heart/daemon/daemon-cli.js

@@ -14,7 +14,7 @@
  * ouro-entry.ts, ouro-bot-wrapper.ts) continue to work unchanged.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.readFirstBundleMetaVersion = exports.createDefaultOuroCliDeps = exports.pingGithubCopilotModel = exports.listGithubCopilotModels = exports.ensureDaemonRunning = exports.runOuroCli = exports.parseOuroCommand = void 0;
+exports.readFirstBundleMetaVersion = exports.createDefaultOuroCliDeps = exports.pingGithubCopilotModel = exports.summarizeDaemonStartupFailure = exports.listGithubCopilotModels = exports.ensureDaemonRunning = exports.runOuroCli = exports.parseOuroCommand = void 0;
 // ── Parsing ──
 var cli_parse_1 = require("./cli-parse");
 Object.defineProperty(exports, "parseOuroCommand", { enumerable: true, get: function () { return cli_parse_1.parseOuroCommand; } });
@@ -23,6 +23,7 @@ var cli_exec_1 = require("./cli-exec");
 Object.defineProperty(exports, "runOuroCli", { enumerable: true, get: function () { return cli_exec_1.runOuroCli; } });
 Object.defineProperty(exports, "ensureDaemonRunning", { enumerable: true, get: function () { return cli_exec_1.ensureDaemonRunning; } });
 Object.defineProperty(exports, "listGithubCopilotModels", { enumerable: true, get: function () { return cli_exec_1.listGithubCopilotModels; } });
+Object.defineProperty(exports, "summarizeDaemonStartupFailure", { enumerable: true, get: function () { return cli_exec_1.summarizeDaemonStartupFailure; } });
 var provider_ping_1 = require("../provider-ping");
 Object.defineProperty(exports, "pingGithubCopilotModel", { enumerable: true, get: function () { return provider_ping_1.pingGithubCopilotModel; } });
 // ── Defaults ──

package/dist/heart/daemon/daemon-runtime-sync.js

@@ -111,10 +111,14 @@ async function ensureCurrentDaemonRuntime(deps) {
             catch (error) {
                 const reason = formatErrorReason(error);
                 result = {
+                    ok: false,
                     alreadyRunning: true,
                     message: includesVersionDrift
                         ? `daemon already running (${deps.socketPath}; could not replace the older background service ${runningVersion} -> ${deps.localVersion}: ${reason})`
                         : `daemon already running (${deps.socketPath}; could not replace the older background service after runtime drift ${publicDriftSummary}: ${reason})`,
+                    startupFailureReason: includesVersionDrift
+                        ? "could not replace the older background service"
+                        : "could not replace the older background service after runtime drift",
                 };
                 (0, runtime_1.emitNervesEvent)({
                     level: "warn",
@@ -144,16 +148,23 @@ async function ensureCurrentDaemonRuntime(deps) {
             deps.onProgress?.("starting the replacement background service");
             const started = await deps.startDaemonProcess(deps.socketPath);
             const pid = started.pid ?? "unknown";
-            const verified = await verifyDaemonStarted(deps);
+            const startupCheck = deps.waitForDaemonStartup
+                ? await deps.waitForDaemonStartup({ pid: started.pid ?? null })
+                : { ok: await verifyDaemonStarted(deps) };
+            const verified = startupCheck.ok;
             /* v8 ignore next -- daemon liveness failure: requires real daemon crash timing @preserve */
-            const suffix = verified ? "" : "\nreplacement daemon did not answer in time; check logs with `ouro logs` or run `ouro doctor`.";
+            const suffix = verified
+                ? ""
+                : `\n${startupCheck.reason ?? "replacement background service did not answer in time"}; check logs with \`ouro logs\` or run \`ouro doctor\`.`;
             result = {
+                ok: verified,
                 alreadyRunning: false,
                 message: includesVersionDrift
                     ? `replaced an older background service ${runningVersion} -> ${deps.localVersion} (pid ${pid})${suffix}`
                     : `replaced an older background service after runtime drift: ${publicDriftSummary} (pid ${pid})${suffix}`,
                 verifyStartupStatus: verified,
                 startedPid: started.pid ?? null,
+                startupFailureReason: verified ? null : (startupCheck.reason ?? "replacement background service did not answer in time"),
             };
             (0, runtime_1.emitNervesEvent)({
                 component: "daemon",
@@ -180,6 +191,7 @@ async function ensureCurrentDaemonRuntime(deps) {
         }
         if (!isKnownVersion(localRuntime.version) || !isKnownVersion(runningVersion)) {
             result = {
+                ok: true,
                 alreadyRunning: true,
                 message: `daemon already running (${deps.socketPath}; unable to verify version)`,
             };
@@ -208,6 +220,7 @@ async function ensureCurrentDaemonRuntime(deps) {
     catch (error) {
         const reason = formatErrorReason(error);
         const result = {
+            ok: true,
             alreadyRunning: true,
             message: `daemon already running (${deps.socketPath}; unable to verify version: ${reason})`,
         };
@@ -230,10 +243,12 @@ async function ensureCurrentDaemonRuntime(deps) {
         return result;
     }
     const result = {
+        ok: true,
         alreadyRunning: true,
         message: `daemon already running (${deps.socketPath})`,
         verifyStartupStatus: true,
         startedPid: null,
+        startupFailureReason: null,
     };
     (0, runtime_1.emitNervesEvent)({
         component: "daemon",

package/dist/heart/daemon/human-command-screens.js

@@ -7,7 +7,6 @@ exports.renderAgentPickerScreen = renderAgentPickerScreen;
 exports.resolveNamedAgentSelection = resolveNamedAgentSelection;
 exports.renderHumanReadinessBoard = renderHumanReadinessBoard;
 exports.renderHumanCommandBoard = renderHumanCommandBoard;
-exports.renderHouseStatusScreen = renderHouseStatusScreen;
 const runtime_1 = require("../../nerves/runtime");
 const terminal_ui_1 = require("./terminal-ui");
 function renderScreenEvent(screen) {
@@ -155,82 +154,3 @@ function renderHumanCommandBoard(options) {
         prompt: options.prompt,
     });
 }
-function renderHouseStatusScreen(options) {
-    renderScreenEvent("house-status");
-    const sections = [
-        {
-            title: "Runtime",
-            lines: [
-                `Daemon: ${options.payload.overview.daemon}`,
-                `Health: ${options.payload.overview.health}`,
-                `Outlook: ${options.payload.overview.outlookUrl}`,
-                `Updated: ${options.payload.overview.lastUpdated}`,
-            ],
-        },
-    ];
-    if (options.payload.agents.length > 0) {
-        sections.push({
-            title: "Agents",
-            lines: options.payload.agents.map((agent) => `${agent.name} — ${agent.enabled ? "enabled" : "disabled"}`),
-        });
-    }
-    if (options.payload.providers.length > 0) {
-        sections.push({
-            title: "Providers",
-            lines: options.payload.providers.map((provider) => {
-                const detail = [provider.readiness, provider.detail, provider.source, provider.credential].filter(Boolean).join("; ");
-                return `${provider.agent} ${provider.lane} — ${provider.provider} / ${provider.model}${detail ? ` — ${detail}` : ""}`;
-            }),
-        });
-    }
-    if (options.payload.senses.length > 0) {
-        sections.push({
-            title: "Senses",
-            lines: options.payload.senses.map((sense) => {
-                const status = sense.enabled ? sense.status : "disabled";
-                return `${sense.agent} — ${sense.label ?? sense.sense} — ${status}${sense.detail ? ` — ${sense.detail}` : ""}`;
-            }),
-        });
-    }
-    if (options.payload.workers.length > 0) {
-        sections.push({
-            title: "Workers",
-            lines: options.payload.workers.map((worker) => {
-                const details = [`restarts: ${worker.restartCount}`];
-                if (worker.pid !== null)
-                    details.unshift(`pid ${worker.pid}`);
-                if (worker.lastExitCode !== null)
-                    details.push(`exit=${worker.lastExitCode}`);
-                if (worker.lastSignal !== null)
-                    details.push(`signal=${worker.lastSignal}`);
-                if (worker.errorReason)
-                    details.push(`error: ${worker.errorReason}`);
-                if (worker.fixHint)
-                    details.push(`fix: ${worker.fixHint}`);
-                return `${worker.agent} — ${worker.worker} — ${worker.status} — ${details.join("; ")}`;
-            }),
-        });
-    }
-    if (options.payload.sync.length > 0) {
-        sections.push({
-            title: "Git sync",
-            lines: options.payload.sync.map((row) => {
-                if (!row.enabled)
-                    return `${row.agent} — disabled`;
-                if (row.gitInitialized === false)
-                    return `${row.agent} — needs git init`;
-                if (row.remoteUrl)
-                    return `${row.agent} — ${row.remote} -> ${row.remoteUrl}`;
-                return `${row.agent} — local only`;
-            }),
-        });
-    }
-    return renderHumanCommandBoard({
-        title: "Ouro status",
-        subtitle: "Current runtime status for this machine.",
-        summary: "What is running, what is stopped, and what needs attention.",
-        isTTY: options.isTTY,
-        columns: options.columns,
-        sections,
-    });
-}

package/dist/heart/daemon/startup-tui.js

@@ -17,6 +17,7 @@ exports.renderWaitingForDaemon = renderWaitingForDaemon;
 exports.pollDaemonStartup = pollDaemonStartup;
 const cli_render_1 = require("./cli-render");
 const runtime_1 = require("../../nerves/runtime");
+const terminal_ui_1 = require("./terminal-ui");
 // ── Constants ──
 const SPINNER_FRAMES = "⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏";
 const STABILITY_THRESHOLD_MS = 5_000;
@@ -248,16 +249,7 @@ function colorStatus(status) {
     return `${statusColor}${status}${RESET}`;
 }
 function renderStartupLines(lines, prevLineCount, isTTY) {
-    if (!isTTY)
-        return lines.join("\n") + "\n";
-    let output = "";
-    if (prevLineCount > 0) {
-        output += `\x1b[${prevLineCount}A`;
-    }
-    for (const line of lines) {
-        output += `\x1b[2K${line}\n`;
-    }
-    return output;
+    return (0, terminal_ui_1.renderOverwriteFrame)(lines, prevLineCount, isTTY);
 }
 /* v8 ignore start -- process liveness check: uses real process.kill(0), tested via deployment @preserve */
 function defaultIsProcessAlive(pid) {

package/dist/heart/daemon/terminal-ui.js

@@ -4,6 +4,7 @@ exports.stripAnsi = stripAnsi;
 exports.visibleLength = visibleLength;
 exports.padAnsi = padAnsi;
 exports.wrapPlain = wrapPlain;
+exports.renderOverwriteFrame = renderOverwriteFrame;
 exports.renderOuroMasthead = renderOuroMasthead;
 exports.formatActionActorLabel = formatActionActorLabel;
 exports.renderTerminalBoard = renderTerminalBoard;
@@ -16,6 +17,7 @@ const SCALE = "\x1b[38;2;45;148;71m";
 const GLOW = "\x1b[38;2;74;227;108m";
 const BONE = "\x1b[38;2;237;242;238m";
 const MIST = "\x1b[38;2;154;174;159m";
+const ALERT = "\x1b[38;2;255;106;106m";
 const ANSI_RE = /\x1b\[[0-9;]*m/g;
 const MASTHEAD_WORD = "OUROBOROS";
 const CLASSIC_WORDMARK_GLYPHS = {
@@ -71,6 +73,25 @@ function boardWidth(columns) {
     const requested = columns ?? 88;
     return Math.max(58, Math.min(requested, 96));
 }
+function renderOverwriteFrame(lines, prevLineCount, isTTY) {
+    if (!isTTY)
+        return `${lines.join("\n")}\n`;
+    let output = "";
+    if (prevLineCount > 0) {
+        output += `\x1b[${prevLineCount}A`;
+    }
+    for (const line of lines) {
+        output += `\x1b[2K${line}\n`;
+    }
+    const extraLineCount = Math.max(0, prevLineCount - lines.length);
+    for (let i = 0; i < extraLineCount; i++) {
+        output += "\x1b[2K\n";
+    }
+    if (extraLineCount > 0) {
+        output += `\x1b[${extraLineCount}A`;
+    }
+    return output;
+}
 function renderPanelTTY(title, lines, width) {
     const innerWidth = Math.max(8, width - 4);
     const topPrefix = `╭─ ${title} `;
@@ -94,15 +115,18 @@ function renderPanelPlain(title, lines) {
     ];
 }
 function mastheadArt(columns) {
-    if ((columns ?? 88) >= 74) {
-        const rows = Array.from({ length: 5 }, () => []);
-        for (const letter of MASTHEAD_WORD.split("")) {
-            const glyph = CLASSIC_WORDMARK_GLYPHS[letter];
-            for (const [index, line] of glyph.entries()) {
-                rows[index].push(line);
-            }
+    const rows = Array.from({ length: 5 }, () => []);
+    for (const letter of MASTHEAD_WORD.split("")) {
+        const glyph = CLASSIC_WORDMARK_GLYPHS[letter];
+        for (const [index, line] of glyph.entries()) {
+            rows[index].push(line);
         }
-        return rows.map((row) => row.join(" "));
+    }
+    const classicWordmark = rows.map((row) => row.join(" "));
+    const availableColumns = columns ?? 88;
+    const classicWidth = Math.max(...classicWordmark.map((line) => line.length));
+    if (availableColumns >= classicWidth) {
+        return classicWordmark;
     }
     return [MASTHEAD_WORD];
 }
@@ -182,7 +206,58 @@ function formatOperationStep(step) {
     const detail = step.detail ? ` — ${step.detail}` : "";
     return `${marker} ${step.label}${detail}`;
 }
+function operationMarkerTone(status) {
+    switch (status) {
+        case "done":
+            return GLOW;
+        case "active":
+            return BONE;
+        case "failed":
+            return ALERT;
+        case "pending":
+        default:
+            return MIST;
+    }
+}
+function renderOperationStepTTY(step) {
+    const marker = step.status === "done"
+        ? "✓"
+        : step.status === "failed"
+            ? "✗"
+            : step.status === "active"
+                ? "→"
+                : "○";
+    const label = color(step.label, step.status === "pending" ? MIST : BONE, step.status !== "pending");
+    const detail = step.detail ? ` ${color(`— ${step.detail}`, MIST)}` : "";
+    return `${color(marker, operationMarkerTone(step.status), true)} ${label}${detail}`;
+}
+function renderOperationSectionTTY(title, lines, width) {
+    const rule = "─".repeat(Math.max(8, width - title.length - 3));
+    return [
+        `${color("─ ", CANOPY)}${color(title, BONE, true)} ${color(rule, CANOPY)}`,
+        ...lines.map((line) => `  ${line}`),
+    ];
+}
+function renderOperationSectionPlain(title, lines) {
+    return [
+        title,
+        ...lines.map((line) => `  ${plainLine(line)}`),
+    ];
+}
 function renderTerminalOperation(options) {
+    if (!options.suppressEvent) {
+        (0, runtime_1.emitNervesEvent)({
+            component: "daemon",
+            event: "daemon.terminal_operation_rendered",
+            message: "rendered terminal operation surface",
+            meta: {
+                title: options.title,
+                steps: options.steps?.length ?? 0,
+                hasCurrentStep: !!options.currentStep,
+                tty: options.isTTY,
+            },
+        });
+    }
     const steps = options.steps ?? [];
     const currentLines = options.currentStep
         ? [
@@ -191,25 +266,34 @@ function renderTerminalOperation(options) {
         ]
         : ["Standing by."];
     const progressLines = steps.length > 0
-        ? steps.map((step) => formatOperationStep(step))
+        ? options.isTTY
+            ? steps.map((step) => renderOperationStepTTY(step))
+            : steps.map((step) => formatOperationStep(step))
         : ["No active steps yet."];
-    return renderTerminalBoard({
+    const width = boardWidth(options.columns);
+    const blocks = [];
+    blocks.push(renderOuroMasthead({
         isTTY: options.isTTY,
-        columns: options.columns,
-        masthead: options.masthead,
-        title: options.title,
-        summary: options.summary,
-        sections: [
-            {
-                title: options.currentTitle ?? "Right now",
-                lines: currentLines,
-            },
-            {
-                title: options.stepsTitle ?? "Progress",
-                lines: progressLines,
-            },
-        ],
-        prompt: options.prompt,
-        suppressEvent: options.suppressEvent,
-    });
+        columns: width,
+        subtitle: options.masthead?.subtitle,
+    }).trimEnd());
+    const introLines = [
+        options.isTTY ? color(options.title, BONE, true) : options.title,
+        ...(options.summary
+            ? wrapPlain(options.summary, Math.max(20, width - 2)).map((line) => options.isTTY ? color(line, MIST) : line)
+            : []),
+    ];
+    blocks.push(introLines.join("\n"));
+    const renderedSteps = options.isTTY
+        ? renderOperationSectionTTY(options.stepsTitle ?? "Checklist", progressLines, width)
+        : renderOperationSectionPlain(options.stepsTitle ?? "Checklist", progressLines);
+    const renderedCurrent = options.isTTY
+        ? renderOperationSectionTTY(options.currentTitle ?? "Current work", currentLines.map((line, index) => index === 0 ? color(line, BONE, true) : color(line, MIST)), width)
+        : renderOperationSectionPlain(options.currentTitle ?? "Current work", currentLines);
+    blocks.push(renderedSteps.join("\n"));
+    blocks.push(renderedCurrent.join("\n"));
+    if (options.prompt) {
+        blocks.push(options.isTTY ? color(options.prompt, BONE, true) : options.prompt);
+    }
+    return `${blocks.join("\n\n")}\n`;
 }

package/dist/heart/daemon/up-progress.js

@@ -219,19 +219,7 @@ class UpProgress {
             return "";
         }
         const lines = this.renderLines(now);
-        let output = "";
-        if (this.prevLineCount > 0) {
-            output += `\x1b[${this.prevLineCount}A`;
-        }
-        for (const line of lines) {
-            output += `\x1b[2K${line}\n`;
-        }
-        // Clear any leftover lines from previous render that are no longer needed
-        if (lines.length < this.prevLineCount) {
-            for (let i = 0; i < this.prevLineCount - lines.length; i++) {
-                output += `\x1b[2K\n`;
-            }
-        }
+        const output = (0, terminal_ui_1.renderOverwriteFrame)(lines, this.prevLineCount, true);
         this.prevLineCount = lines.length;
         return output;
     }
@@ -301,14 +289,8 @@ class UpProgress {
     }
     renderUpScreen(now) {
         const seenLabels = new Set();
-        const steps = this.completed.map((phase) => {
-            seenLabels.add(phase.label);
-            return {
-                label: this.renderUpStepLabel(phase.label),
-                status: phase.status === "failure" ? "failed" : "done",
-                detail: phase.detail,
-            };
-        });
+        const completedByLabel = new Map(this.completed.map((phase) => [phase.label, phase]));
+        const steps = [];
         let currentStepLabel = this.completed.some((phase) => phase.status === "failure")
             ? "Boot paused."
             : this.completed.length > 0
@@ -322,19 +304,44 @@ class UpProgress {
             const spinner = SPINNER_FRAMES[frameIndex];
             currentStepLabel = `${spinner} ${this.renderUpStepLabel(this.currentPhase.label)} (${elapsedSec}s)`;
             currentStepDetails = splitDetailLines(this.currentPhase.detail);
-            steps.push({
-                label: this.renderUpStepLabel(this.currentPhase.label),
-                status: "active",
-            });
-            seenLabels.add(this.currentPhase.label);
         }
         for (const label of this.upPhasePlan) {
-            if (!seenLabels.has(label)) {
+            seenLabels.add(label);
+            const completedPhase = completedByLabel.get(label);
+            if (completedPhase) {
+                steps.push({
+                    label: this.renderUpStepLabel(label),
+                    status: completedPhase.status === "failure" ? "failed" : "done",
+                    detail: completedPhase.detail,
+                });
+                continue;
+            }
+            if (this.currentPhase?.label === label) {
                 steps.push({
                     label: this.renderUpStepLabel(label),
-                    status: "pending",
+                    status: "active",
                 });
+                continue;
             }
+            steps.push({
+                label: this.renderUpStepLabel(label),
+                status: "pending",
+            });
+        }
+        for (const phase of this.completed) {
+            if (!seenLabels.has(phase.label)) {
+                steps.push({
+                    label: this.renderUpStepLabel(phase.label),
+                    status: phase.status === "failure" ? "failed" : "done",
+                    detail: phase.detail,
+                });
+            }
+        }
+        if (this.currentPhase && !seenLabels.has(this.currentPhase.label)) {
+            steps.push({
+                label: this.renderUpStepLabel(this.currentPhase.label),
+                status: "active",
+            });
         }
         return (0, terminal_ui_1.renderTerminalOperation)({
             isTTY: true,
@@ -342,8 +349,8 @@ class UpProgress {
             masthead: {
                 subtitle: "Booting the local agent runtime.",
             },
-            title: "Ouro boot checklist",
-            summary: "Ouro will check for updates, prepare this machine, verify the providers your agents use right now, start the background service, and make sure it stays up.",
+            title: "Starting Ouro",
+            summary: "Ouro is bringing the local agent runtime online and will stop here if anything needs attention.",
             currentStep: {
                 label: currentStepLabel,
                 detailLines: currentStepDetails,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ouro.bot/cli",
-  "version": "0.1.0-alpha.443",
+  "version": "0.1.0-alpha.445",
   "main": "dist/heart/daemon/ouro-entry.js",
   "bin": {
     "cli": "dist/heart/daemon/ouro-bot-entry.js",