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

package/changelog.json

@@ -1,6 +1,14 @@
 {
   "_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.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/cli-exec.js

@@ -1211,7 +1211,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 +1281,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 +1298,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 +1493,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 +1999,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 +2166,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 +2247,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 +2276,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 +2371,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}`,
@@ -5379,7 +5379,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 +5430,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/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`;
 }

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

@@ -296,10 +296,10 @@ class UpProgress {
             isTTY: true,
             columns: this.columns,
             masthead: {
-                subtitle: "Preparing the house.",
+                subtitle: "Starting 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: "Starting Ouro",
+            summary: "Ouro is starting the background runtime, checking credentials, and surfacing anything that needs attention before chat begins.",
             currentStep: {
                 label: currentStepLabel,
                 detailLines: currentStepDetails,

package/package.json

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