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

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.443",
+      "changes": [
+        "`ouro up` now renders as a real boot checklist instead of a loose progress wall: the screen shows the full startup path up front, marks what is running now, and keeps pending steps visible so humans can see where Ouro is in the bring-up flow.",
+        "Provider checks during startup now narrate the providers each selected lane is actually using, translate noisy vault chatter into plain language, and keep the live-check copy truthful instead of implying that every configured provider was checked.",
+        "`ouro up` no longer reports success just because the daemon answered once during startup. Before handing control back, Ouro now performs one final daemon-status handoff check and fails with a clear diagnosis if the background service stopped before boot actually finished."
+      ]
+    },
+    {
+      "version": "0.1.0-alpha.442",
+      "changes": [
+        "The shared CLI masthead now lands as a clean `OUROBOROS` wordmark instead of the older circle treatment, with compact/plain render paths trimmed down so the banner feels intentional rather than doubled or noisy.",
+        "The main human-facing screens now use warmer but more concrete first-run language: `ouro up`, the home screen, status, help, hatch, vault outcomes, and the connections screen now explain what Ouro is actually doing without leaning on unexplained `house` or `bay` metaphors.",
+        "Failed live provider checks in the connections screen now stay in the honest `needs attention` bucket instead of being downgraded to `needs credentials`, and hermetic runtime plus packaged-install coverage lock the wording into the shipped CLI."
+      ]
+    },
     {
       "version": "0.1.0-alpha.441",
       "changes": [

package/dist/heart/daemon/agent-config-check.js

@@ -318,6 +318,33 @@ function failedPingResult(agentName, lane, provider, model, result) {
 function credentialRecordForLane(pool, provider) {
     return pool.providers[provider];
 }
+function laneAudienceLabel(lane) {
+    return lane === "outward" ? "chat" : "inner dialog";
+}
+function bindingLabel(binding) {
+    return `${binding.provider} / ${binding.model}`;
+}
+function selectedProviderPlan(agentName, state) {
+    return [
+        `${agentName}: checking the providers this agent uses right now`,
+        ...["outward", "inner"].map((lane) => `- ${laneAudienceLabel(lane)}: ${bindingLabel(state.lanes[lane])}`),
+    ].join("\n");
+}
+function mapVaultRefreshProgress(agentName, onProgress) {
+    return (message) => {
+        if (message.startsWith("reading vault items for ")) {
+            onProgress(`${agentName}: opening saved provider credentials in the vault`);
+            return;
+        }
+        if (message === "parsing provider credentials...") {
+            onProgress(`${agentName}: organizing saved provider credentials`);
+        }
+    };
+}
+function providerPingSubject(agentName, lanes) {
+    const laneList = lanes.map((lane) => laneAudienceLabel(lane)).join(" + ");
+    return `${agentName} (${laneList})`;
+}
 /**
  * Structural validation only. Live provider credential validation belongs to
  * checkAgentConfigWithProviderHealth(), which reads the agent vault and pings.
@@ -352,8 +379,9 @@ async function checkAgentConfigWithProviderHealth(agentName, bundlesRoot, deps =
         return stateResult.result;
     if (stateResult.disabled)
         return { ok: true };
+    deps.onProgress?.(selectedProviderPlan(agentName, stateResult.state));
     const ping = deps.pingProvider ?? (await Promise.resolve().then(() => __importStar(require("../provider-ping")))).pingProvider;
-    const poolResult = await (0, provider_credentials_1.refreshProviderCredentialPool)(agentName, deps.onProgress ? { onProgress: deps.onProgress } : undefined);
+    const poolResult = await (0, provider_credentials_1.refreshProviderCredentialPool)(agentName, deps.onProgress ? { onProgress: mapVaultRefreshProgress(agentName, deps.onProgress) } : undefined);
     const pingGroups = new Map();
     const lanes = ["outward", "inner"];
     for (const lane of lanes) {
@@ -390,7 +418,11 @@ async function checkAgentConfigWithProviderHealth(agentName, bundlesRoot, deps =
         const result = await ping(group.provider, providerCredentialConfig(group.record), {
             model: group.model,
             ...(deps.onProgress
-                ? (0, provider_ping_progress_1.createProviderPingProgressReporter)({ provider: group.provider, model: group.model }, deps.onProgress)
+                ? (0, provider_ping_progress_1.createProviderPingProgressReporter)({
+                    provider: group.provider,
+                    model: group.model,
+                    subject: providerPingSubject(agentName, group.lanes),
+                }, deps.onProgress)
                 : {}),
         });
         return { group, result };

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

@@ -160,7 +160,6 @@ async function checkAgentProviders(deps, agentsOverride, onProgress) {
     const degraded = [];
     for (const agent of [...new Set(agents)]) {
         try {
-            onProgress?.(`${agent}: checking providers...`);
             const result = await checkAgentProviderHealth(agent, bundlesRoot, deps, onProgress);
             if (result.ok)
                 continue;
@@ -358,9 +357,14 @@ function writeProviderRepairSummary(deps, title, degraded) {
 }
 function providerRepairCountSummary(count) {
     if (count === 0)
-        return "ok";
+        return "selected providers answered live checks";
     return `${count} ${count === 1 ? "needs" : "need"} attention`;
 }
+function bootPhasePlan(daemonAlive) {
+    return daemonAlive
+        ? ["update check", "system setup", "starting daemon", "provider checks", "final daemon check"]
+        : ["update check", "system setup", "provider checks", "starting daemon", "final daemon check"];
+}
 function createHumanCommandProgress(deps, commandName) {
     return new up_progress_1.CommandProgress({
         write: deps.writeRaw ?? deps.writeStdout,
@@ -387,8 +391,67 @@ function daemonProgressSummary(result) {
     if (result.alreadyRunning)
         return "already running";
     if (result.message.includes("replaced"))
-        return "replacement ready";
-    return "ready";
+        return "replacement answered";
+    return "background service answered";
+}
+function finalDaemonFailureMessage(deps, reason) {
+    const lines = [`background service stopped before boot finished: ${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("Run `ouro up` again or `ouro doctor` for a deeper diagnosis.");
+    return lines.join("\n");
+}
+async function verifyDaemonReadyForHandoff(deps) {
+    const socketAlive = await deps.checkSocketAlive(deps.socketPath);
+    if (!socketAlive) {
+        return {
+            ok: false,
+            summary: "background service stopped",
+            message: finalDaemonFailureMessage(deps, "the daemon socket is no longer answering"),
+        };
+    }
+    try {
+        const response = await deps.sendCommand(deps.socketPath, { kind: "daemon.status" });
+        if (!response.ok) {
+            const reason = response.error ?? response.message ?? "daemon status did not answer cleanly";
+            return {
+                ok: false,
+                summary: "daemon status did not answer",
+                message: finalDaemonFailureMessage(deps, reason),
+            };
+        }
+        const payload = (0, cli_render_1.parseStatusPayload)(response.data);
+        if (!payload) {
+            return {
+                ok: true,
+                summary: "daemon answered",
+            };
+        }
+        if (payload.overview.daemon !== "running") {
+            return {
+                ok: false,
+                summary: `daemon reported ${payload.overview.daemon}`,
+                message: finalDaemonFailureMessage(deps, `the daemon reported state ${payload.overview.daemon}`),
+            };
+        }
+        const workerCount = payload.workers.length;
+        return {
+            ok: true,
+            summary: workerCount === 0
+                ? "daemon answered"
+                : `${workerCount} worker${workerCount === 1 ? "" : "s"} still answering`,
+        };
+    }
+    catch (error) {
+        return {
+            ok: false,
+            summary: "daemon status did not answer",
+            message: finalDaemonFailureMessage(deps, error instanceof Error ? error.message : String(error)),
+        };
+    }
 }
 async function reportPostRepairProviderHealth(deps, repairedAgents, onProgress) {
     const remainingDegraded = await checkAgentProviders(deps, repairedAgents, onProgress);
@@ -1211,7 +1274,7 @@ async function executeVaultUnlock(command, deps) {
             {
                 title: "Next moves",
                 lines: [
-                    `Run ouro up to let the house retry ${command.agent}.`,
+                    `Run ouro up so Ouro can check ${command.agent} again.`,
                     `If credentials are still missing, run ouro auth --agent ${command.agent} --provider <provider>.`,
                 ],
             },
@@ -1281,7 +1344,7 @@ async function executeVaultCreate(command, deps) {
     ];
     return writeCommandOutcome(deps, {
         title: "Credential vault",
-        subtitle: `${command.agent} has a vault home now.`,
+        subtitle: `${command.agent}'s credential vault is ready.`,
         summary: `All raw credentials for ${command.agent} now live in this vault.`,
         sections: [
             {
@@ -1298,7 +1361,7 @@ async function executeVaultCreate(command, deps) {
                 title: "Next moves",
                 lines: [
                     `Authenticate the providers ${command.agent} should use with ouro auth --agent ${command.agent} --provider <provider>.`,
-                    `Then run ouro up so the house can bring ${command.agent} online.`,
+                    `Then run ouro up so Ouro can bring ${command.agent} online.`,
                 ],
             },
         ],
@@ -1493,7 +1556,7 @@ async function executeVaultRecover(command, deps) {
                 title: "Next moves",
                 lines: [
                     `Run ouro auth verify --agent ${command.agent} to re-check the stored providers.`,
-                    `Then run ouro up so the house can retry ${command.agent}.`,
+                    `Then run ouro up so Ouro can check ${command.agent} again.`,
                 ],
             },
         ],
@@ -1999,7 +2062,7 @@ async function buildConnectMenu(agent, deps, onProgress) {
         {
             option: "1",
             name: "Providers",
-            section: "Provider core",
+            section: "Providers",
             status: providerSummary.status,
             detailLines: providerSummary.detailLines,
             laneSummaries: providerSummary.laneSummaries,
@@ -2166,7 +2229,7 @@ async function executeConnectPerplexity(agent, deps) {
         ],
         nextMoves: [
             "Ask the agent to search.",
-            `Reopen the connect bay with ouro connect --agent ${agent} whenever you want to review capabilities.`,
+            `Reopen the connections screen with ouro connect --agent ${agent} whenever you want to review capabilities.`,
         ],
         fallbackLines: [
             `Perplexity connected for ${agent}`,
@@ -2247,7 +2310,7 @@ async function executeConnectEmbeddings(agent, deps) {
                 ],
                 nextMoves: [
                     `Rerun ouro connect embeddings --agent ${agent} with a working key.`,
-                    `Use ouro connect --agent ${agent} to review the rest of the capability bay.`,
+                    `Use ouro connect --agent ${agent} to review the rest of the connections screen.`,
                 ],
                 fallbackLines: [
                     `Embeddings key was saved for ${agent}, but the live check failed.`,
@@ -2276,7 +2339,7 @@ async function executeConnectEmbeddings(agent, deps) {
         ],
         nextMoves: [
             "Ask the agent to search notes or memory.",
-            `Reopen the connect bay with ouro connect --agent ${agent} whenever you want to review capabilities.`,
+            `Reopen the connections screen with ouro connect --agent ${agent} whenever you want to review capabilities.`,
         ],
         fallbackLines: [
             `Embeddings connected for ${agent}`,
@@ -2371,7 +2434,7 @@ async function executeConnectTeams(agent, deps) {
         ],
         nextMoves: [
             "Run ouro up so the daemon picks up the Teams sense change.",
-            `Reopen the connect bay with ouro connect --agent ${agent} whenever you want to review capabilities.`,
+            `Reopen the connections screen with ouro connect --agent ${agent} whenever you want to review capabilities.`,
         ],
         fallbackLines: [
             `Teams connected for ${agent}`,
@@ -3939,6 +4002,8 @@ async function runOuroCli(args, deps = (0, cli_defaults_1.createDefaultOuroCliDe
             now: deps.now ?? (() => Date.now()),
             autoRender: true,
         });
+        const daemonAliveAtBootStart = await deps.checkSocketAlive(deps.socketPath);
+        progress.setPhasePlan?.(bootPhasePlan(daemonAliveAtBootStart));
         // ── versioned CLI update check ──
         if (deps.checkForCliUpdate) {
             progress.startPhase("update check");
@@ -4067,6 +4132,7 @@ async function runOuroCli(args, deps = (0, cli_defaults_1.createDefaultOuroCliDe
             promptInput: deps.promptInput,
         });
         const daemonAliveBeforeStart = await deps.checkSocketAlive(deps.socketPath);
+        progress.setPhasePlan?.(bootPhasePlan(daemonAliveBeforeStart));
         let providerChecksAlreadyRun = false;
         if (!daemonAliveBeforeStart) {
             progress.startPhase("provider checks");
@@ -4120,6 +4186,17 @@ async function runOuroCli(args, deps = (0, cli_defaults_1.createDefaultOuroCliDe
             daemonResult.stability = mergeStartupStability(daemonResult.stability, providerDegraded);
             progress.completePhase("provider checks", providerRepairCountSummary(providerDegraded.length));
         }
+        progress.startPhase("final daemon check");
+        const finalDaemonCheck = await verifyDaemonReadyForHandoff(deps);
+        if (!finalDaemonCheck.ok) {
+            ;
+            progress.failPhase?.("final daemon check", finalDaemonCheck.summary);
+            progress.end();
+            const message = finalDaemonCheck.message ?? "background service stopped before boot finished";
+            deps.writeStdout(message);
+            return message;
+        }
+        progress.completePhase("final daemon check", finalDaemonCheck.summary);
         progress.end();
         // Interactive repair for degraded agents (Unit 5) — skipped by --no-repair (Unit 6)
         if (daemonResult.stability?.degraded && daemonResult.stability.degraded.length > 0) {
@@ -5379,7 +5456,7 @@ async function runOuroCli(args, deps = (0, cli_defaults_1.createDefaultOuroCliDe
             if (ttyBoardEnabled(deps)) {
                 deps.writeStdout(renderCommandBoard(deps, {
                     title: "Hatch an agent",
-                    subtitle: "Let’s bring a new agent into the house.",
+                    subtitle: "Let’s set up a new agent.",
                     summary: "Ouro will walk through the essentials, then hand the conversation to the specialist.",
                     sections: [
                         {
@@ -5430,7 +5507,7 @@ async function runOuroCli(args, deps = (0, cli_defaults_1.createDefaultOuroCliDe
                     lines: [
                         `Bundle: ${result.bundleRoot}`,
                         `Specialist identity: ${result.selectedIdentity}`,
-                        `House status: ${daemonResult.message}`,
+                        `Runtime status: ${daemonResult.message}`,
                     ],
                 },
                 {

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

@@ -14,7 +14,7 @@ exports.getCommandHelp = getCommandHelp;
 exports.COMMAND_REGISTRY = {
     up: {
         category: "Lifecycle",
-        description: "Prepare the house: start the background runtime, refresh what this machine needs, and surface anything still asking for care. In a human TTY, bare `ouro` opens the home screen instead; noninteractive shells still route bare `ouro` to `ouro up`.",
+        description: "Start and check Ouro: bring up the background runtime, refresh what this machine needs, and show anything that still needs attention. In a human TTY, bare `ouro` opens the home screen instead; noninteractive shells still route bare `ouro` to `ouro up`.",
         usage: "ouro [up] [--no-repair]",
         example: "ouro up --no-repair",
     },
@@ -32,7 +32,7 @@ exports.COMMAND_REGISTRY = {
     },
     status: {
         category: "Lifecycle",
-        description: "Show the house status",
+        description: "Show Ouro status for this machine",
         usage: "ouro status",
         example: "ouro status",
     },
@@ -165,7 +165,7 @@ exports.COMMAND_REGISTRY = {
     },
     connect: {
         category: "Auth",
-        description: "Connect providers, portable integrations, and local senses from one guided bay",
+        description: "Set up providers, portable integrations, and local senses from one guided screen",
         usage: "ouro connect [providers|perplexity|embeddings|teams|bluebubbles] [--agent <name>]",
         example: "ouro connect",
         subcommands: ["providers", "perplexity", "embeddings", "teams", "bluebubbles"],
@@ -278,7 +278,7 @@ const SUBCOMMAND_HELP = {
         example: "ouro connect perplexity",
     },
     "connect providers": {
-        description: "Open provider auth from the connect bay without remembering the auth command",
+        description: "Open provider setup from the connections screen without remembering the auth command",
         usage: "ouro connect providers [--agent <name>]",
         example: "ouro connect providers",
     },

package/dist/heart/daemon/connect-bay.js

@@ -87,9 +87,8 @@ function resolveProviderHealthStatus(providerHealth) {
         return "needs setup";
     if (issue?.kind === "provider-credentials-missing")
         return "needs credentials";
-    if (issue?.kind === "provider-live-check-failed") {
-        return issue.actions[0]?.kind === "provider-auth" ? "needs credentials" : "needs attention";
-    }
+    if (issue?.kind === "provider-live-check-failed")
+        return "needs attention";
     const error = String(providerHealth.error).toLowerCase();
     const fix = String(providerHealth.fix).toLowerCase();
     if (error.includes("failed live check"))
@@ -169,8 +168,8 @@ function panel(title, body, width) {
     return lines;
 }
 function renderHeader(agent, width) {
-    return panel(`${agent} connect bay`, [
-        tty("Bring one capability online.", BONE, true),
+    return panel(`${agent} connections`, [
+        tty("Set up or review one capability at a time.", BONE, true),
         tty("Everything on this screen was checked live just now.", MIST),
     ], width);
 }
@@ -266,23 +265,23 @@ function renderTtyBay(entries, options) {
     const masthead = (0, terminal_ui_1.renderOuroMasthead)({
         isTTY: true,
         columns,
-        subtitle: "Bring one capability online at a time.",
+        subtitle: "Set up connections one step at a time.",
     }).trimEnd();
     const header = renderHeader(options.agent, fullWidth);
     const nextEntry = entries.find((entry) => isProblemStatus(entry.status));
-    const providerEntry = entries.find((entry) => entry.section === "Provider core");
+    const providerEntry = entries.find((entry) => entry.section === "Providers");
     const portableEntries = entries.filter((entry) => entry.section === "Portable");
     const machineEntries = entries.filter((entry) => entry.section === "This machine");
     const wide = columns >= 118;
     const footer = [
-        tty("Pick a path. Type the number or the name.", MIST),
+        tty("Choose a number, or type the capability name.", MIST),
         options.prompt,
     ];
     if (!wide) {
         const panels = [
             header,
-            panel("Next best move", nextMoveBody(nextEntry), fullWidth),
-            panel("Provider core", renderProviderBody(providerEntry, fullWidth), fullWidth),
+            panel("Recommended next step", nextMoveBody(nextEntry), fullWidth),
+            panel("Providers", renderProviderBody(providerEntry, fullWidth), fullWidth),
             panel("Portable", renderCapabilityBody(portableEntries, fullWidth), fullWidth),
             panel("This machine", renderCapabilityBody(machineEntries, fullWidth), fullWidth),
         ];
@@ -291,18 +290,18 @@ function renderTtyBay(entries, options) {
     const gap = 2;
     const leftWidth = Math.max(52, Math.floor((fullWidth - gap) / 2));
     const rightWidth = Math.max(40, fullWidth - gap - leftWidth);
-    const topRow = combineColumns(panel("Next best move", nextMoveBody(nextEntry), leftWidth), panel("This machine", renderCapabilityBody(machineEntries, rightWidth), rightWidth), leftWidth, rightWidth, gap);
-    const bottomRow = combineColumns(panel("Provider core", renderProviderBody(providerEntry, leftWidth), leftWidth), panel("Portable", renderCapabilityBody(portableEntries, rightWidth), rightWidth), leftWidth, rightWidth, gap);
+    const topRow = combineColumns(panel("Recommended next step", nextMoveBody(nextEntry), leftWidth), panel("This machine", renderCapabilityBody(machineEntries, rightWidth), rightWidth), leftWidth, rightWidth, gap);
+    const bottomRow = combineColumns(panel("Providers", renderProviderBody(providerEntry, leftWidth), leftWidth), panel("Portable", renderCapabilityBody(portableEntries, rightWidth), rightWidth), leftWidth, rightWidth, gap);
     return [masthead, "", ...header, "", ...topRow, "", ...bottomRow, "", ...footer].join("\n");
 }
 function renderNonTtyBay(entries, options) {
     const nextEntry = entries.find((entry) => isProblemStatus(entry.status));
     const lines = [
-        `${options.agent} connect bay`,
-        "Bring one capability online. Provider status was checked live just now.",
+        `${options.agent} connections`,
+        "Set up or review one capability at a time. Provider status was checked live just now.",
         "",
-        "Next best move",
-        "--------------",
+        "Recommended next step",
+        "---------------------",
     ];
     if (!nextEntry) {
         lines.push("Everything here is ready. Pick what you want to review or refresh.");
@@ -315,7 +314,7 @@ function renderNonTtyBay(entries, options) {
             lines.push(`run: ${nextEntry.nextAction}`);
     }
     lines.push("");
-    for (const section of ["Provider core", "Portable", "This machine"]) {
+    for (const section of ["Providers", "Portable", "This machine"]) {
         lines.push(section);
         lines.push("-".repeat(Math.max(6, section.length + 4)));
         for (const entry of entries.filter((candidate) => candidate.section === section)) {
@@ -338,7 +337,7 @@ function renderNonTtyBay(entries, options) {
     }
     lines.push("6. Not now");
     lines.push("");
-    lines.push("Pick a path. Type the number or the name.");
+    lines.push("Choose a number, or type the capability name.");
     lines.push(options.prompt);
     return lines.join("\n");
 }

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

@@ -21,7 +21,7 @@ function renderScreenEvent(screen) {
 function buildOuroHomeActions(agents) {
     if (agents.length === 0) {
         return [
-            { key: "1", label: "Hatch a new agent", kind: "hatch", command: "ouro hatch" },
+            { key: "1", label: "Create a new agent", kind: "hatch", command: "ouro hatch" },
             { key: "2", label: "Clone an existing bundle", kind: "clone", command: "ouro clone <remote>" },
             { key: "3", label: "Show help", kind: "help", command: "ouro --help" },
             { key: "4", label: "Exit", kind: "exit", command: "exit" },
@@ -36,9 +36,9 @@ function buildOuroHomeActions(agents) {
     }));
     return [
         ...actions,
-        { key: String(actions.length + 1), label: "Prepare the house", kind: "up", command: "ouro up" },
-        { key: String(actions.length + 2), label: "Connect an agent", kind: "connect", command: "ouro connect --agent <agent>" },
-        { key: String(actions.length + 3), label: "Repair an agent", kind: "repair", command: "ouro repair --agent <agent>" },
+        { key: String(actions.length + 1), label: "Start or check Ouro", kind: "up", command: "ouro up" },
+        { key: String(actions.length + 2), label: "Set up connections", kind: "connect", command: "ouro connect --agent <agent>" },
+        { key: String(actions.length + 3), label: "Fix setup issues", kind: "repair", command: "ouro repair --agent <agent>" },
         { key: String(actions.length + 4), label: "Show help", kind: "help", command: "ouro --help" },
         { key: String(actions.length + 5), label: "Exit", kind: "exit", command: "exit" },
     ];
@@ -60,10 +60,10 @@ function renderOuroHomeScreen(options) {
     const actions = buildOuroHomeActions(options.agents);
     const sections = [
         {
-            title: options.agents.length === 0 ? "Start here" : "Around the house",
+            title: options.agents.length === 0 ? "Start here" : "Available agents",
             lines: options.agents.length === 0
-                ? ["No agents are home yet. Hatch someone new or bring an existing bundle aboard."]
-                : options.agents.map((agent) => `${agent} is home and ready when called.`),
+                ? ["No agents are set up on this machine yet."]
+                : options.agents.map((agent) => `${agent} is available.`),
         },
     ];
     const actionRows = actions.map((action, index) => ({
@@ -77,13 +77,13 @@ function renderOuroHomeScreen(options) {
         columns: options.columns,
         masthead: {
             subtitle: options.agents.length === 0
-                ? "No agents are home yet."
-                : "Welcome home.",
+                ? "No agents are set up on this machine yet."
+                : "Choose an agent or a setup task.",
         },
         title: "Ouro home",
         summary: options.agents.length === 0
-            ? "Hatch someone new or bring an existing bundle aboard."
-            : "Choose who to wake or what to prepare without memorizing commands.",
+            ? "Create a new agent or clone an existing bundle to get started."
+            : "Choose an agent or a setup task without memorizing commands.",
         sections,
         actions: actionRows,
         prompt: `Choose [1-${actions.length}] or type a name: `,
@@ -159,7 +159,7 @@ function renderHouseStatusScreen(options) {
     renderScreenEvent("house-status");
     const sections = [
         {
-            title: "House pulse",
+            title: "Runtime",
             lines: [
                 `Daemon: ${options.payload.overview.daemon}`,
                 `Health: ${options.payload.overview.health}`,
@@ -226,9 +226,9 @@ function renderHouseStatusScreen(options) {
         });
     }
     return renderHumanCommandBoard({
-        title: "House status",
-        subtitle: "The house is awake enough to answer clearly.",
-        summary: "What is awake, resting, or asking for care.",
+        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/provider-ping-progress.js

@@ -33,11 +33,16 @@ function providerRetryTiming(delayMs) {
     return `in ${rounded}`;
 }
 function formatProviderAttemptProgress(context, attempt, maxAttempts) {
-    return `checking ${formatProviderPingLabel(context)} (attempt ${attempt} of ${maxAttempts})...`;
+    const prefix = context.subject ? `${context.subject}: ` : "";
+    return `${prefix}checking ${formatProviderPingLabel(context)} (attempt ${attempt} of ${maxAttempts})...`;
 }
-function formatProviderRetryProgress(record, maxAttempts) {
+function formatProviderRetryProgress(context, record, maxAttempts) {
     const nextAttempt = Math.min(record.attempt + 1, maxAttempts);
-    return `${formatProviderPingLabel(record)}: ${providerRetryReason(record)}; retrying ${providerRetryTiming(record.delayMs)} (attempt ${nextAttempt} of ${maxAttempts})`;
+    const retryDetail = `${providerRetryReason(record)}; retrying ${providerRetryTiming(record.delayMs)} (attempt ${nextAttempt} of ${maxAttempts})`;
+    if (context.subject) {
+        return `${context.subject}: ${retryDetail} while checking ${formatProviderPingLabel(context)}`;
+    }
+    return `${formatProviderPingLabel(record)}: ${retryDetail}`;
 }
 function createProviderPingProgressReporter(context, onProgress) {
     return {
@@ -70,7 +75,7 @@ function createProviderPingProgressReporter(context, onProgress) {
                     classification: record.classification ?? "unknown",
                 },
             });
-            onProgress(formatProviderRetryProgress(record, maxAttempts));
+            onProgress(formatProviderRetryProgress(context, record, maxAttempts));
         },
     };
 }

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

@@ -104,26 +104,17 @@ function mastheadArt(columns) {
         }
         return rows.map((row) => row.join(" "));
     }
-    return [
-        "  O U R O B O R O S",
-        "  -----------------",
-    ];
+    return [MASTHEAD_WORD];
 }
 function renderOuroMasthead(options) {
-    const lines = mastheadArt(options.columns);
-    const subtitle = options.subtitle ?? "the house wakes when called";
-    const branded = [
-        ...lines,
-        MASTHEAD_WORD,
-        subtitle,
-    ];
+    const lines = options.isTTY ? mastheadArt(options.columns) : [MASTHEAD_WORD];
+    const branded = options.subtitle ? [...lines, options.subtitle] : lines;
     if (!options.isTTY) {
         return `${branded.join("\n")}\n`;
     }
     const ttyLines = [
         ...lines.map((line, index) => color(line, index < 2 ? GLOW : SCALE, true)),
-        color(MASTHEAD_WORD, BONE, true),
-        color(subtitle, MIST),
+        ...(options.subtitle ? [color(options.subtitle, MIST)] : []),
     ];
     return `${ttyLines.join("\n")}\n`;
 }
@@ -210,11 +201,11 @@ function renderTerminalOperation(options) {
         summary: options.summary,
         sections: [
             {
-                title: "Right now",
+                title: options.currentTitle ?? "Right now",
                 lines: currentLines,
             },
             {
-                title: "Progress",
+                title: options.stepsTitle ?? "Progress",
                 lines: progressLines,
             },
         ],

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

@@ -22,6 +22,22 @@ const BOLD = "\x1b[1m";
 const DIM = "\x1b[2m";
 const GREEN = "\x1b[38;2;46;204;64m";
 const RED = "\x1b[38;2;255;106;106m";
+const BASE_UP_PHASE_PLAN = [
+    "update check",
+    "system setup",
+    "provider checks",
+    "starting daemon",
+    "final daemon check",
+];
+const FRIENDLY_UP_PHASE_LABELS = {
+    "update check": "Check for updates",
+    "system setup": "Prepare this machine",
+    "agent updates": "Update installed agents",
+    "bundle cleanup": "Clean up stale bundles",
+    "provider checks": "Check the providers your agents use right now",
+    "starting daemon": "Start the background service",
+    "final daemon check": "Confirm the background service stayed up",
+};
 function splitDetailLines(detail) {
     if (!detail)
         return [];
@@ -45,6 +61,7 @@ class UpProgress {
     completed = [];
     currentPhase = null;
     currentDetail = null;
+    upPhasePlan = BASE_UP_PHASE_PLAN;
     prevLineCount = 0;
     ended = false;
     renderTimer = null;
@@ -96,6 +113,13 @@ class UpProgress {
             return;
         this.write(`    ${label}\n`);
     }
+    setPhasePlan(labels) {
+        const nextPlan = [...new Set(labels.map((label) => label.trim()).filter((label) => label.length > 0))];
+        this.upPhasePlan = nextPlan.length > 0 ? nextPlan : BASE_UP_PHASE_PLAN;
+        if (this.isTTY && this.eventScope === "up") {
+            this.flushRender();
+        }
+    }
     /**
      * Update the sub-step detail on the current spinner phase. Rendered as
      * "label (Xs) -- detail" in TTY mode. In non-TTY mode, writes changed
@@ -272,39 +296,61 @@ class UpProgress {
         }
         return lines;
     }
+    renderUpStepLabel(label) {
+        return FRIENDLY_UP_PHASE_LABELS[label] ?? label;
+    }
     renderUpScreen(now) {
-        const steps = this.completed.map((phase) => ({
-            label: phase.label,
-            status: phase.status === "failure" ? "failed" : "done",
-            detail: phase.detail,
-        }));
-        let currentStepLabel = "Standing by.";
+        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,
+            };
+        });
+        let currentStepLabel = this.completed.some((phase) => phase.status === "failure")
+            ? "Boot paused."
+            : this.completed.length > 0
+                ? "Boot checklist complete."
+                : "Waiting to begin.";
         let currentStepDetails = [];
         if (this.currentPhase) {
             const elapsed = now - this.currentPhase.startedAt;
             const elapsedSec = (elapsed / 1000).toFixed(1);
             const frameIndex = Math.floor(elapsed / 80) % SPINNER_FRAMES.length;
             const spinner = SPINNER_FRAMES[frameIndex];
-            currentStepLabel = `${spinner} ${this.currentPhase.label} (${elapsedSec}s)`;
+            currentStepLabel = `${spinner} ${this.renderUpStepLabel(this.currentPhase.label)} (${elapsedSec}s)`;
             currentStepDetails = splitDetailLines(this.currentPhase.detail);
             steps.push({
-                label: this.currentPhase.label,
+                label: this.renderUpStepLabel(this.currentPhase.label),
                 status: "active",
             });
+            seenLabels.add(this.currentPhase.label);
+        }
+        for (const label of this.upPhasePlan) {
+            if (!seenLabels.has(label)) {
+                steps.push({
+                    label: this.renderUpStepLabel(label),
+                    status: "pending",
+                });
+            }
         }
         return (0, terminal_ui_1.renderTerminalOperation)({
             isTTY: true,
             columns: this.columns,
             masthead: {
-                subtitle: "Preparing the house.",
+                subtitle: "Booting the local agent runtime.",
             },
-            title: "Preparing the house",
-            summary: "Ouro is warming the background systems and checking what still needs care before anyone steps in.",
+            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.",
             currentStep: {
                 label: currentStepLabel,
                 detailLines: currentStepDetails,
             },
             steps,
+            currentTitle: "Doing now",
+            stepsTitle: "Boot checklist",
             suppressEvent: true,
         }).trimEnd().split("\n");
     }

package/package.json

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