@ouro.bot/cli 0.1.0-alpha.431 → 0.1.0-alpha.433

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

@@ -14,7 +14,7 @@ exports.getCommandHelp = getCommandHelp;
 exports.COMMAND_REGISTRY = {
     up: {
         category: "Lifecycle",
-        description: "Start the ouro daemon. In a human TTY, bare `ouro` opens the home screen instead; noninteractive shells still route bare `ouro` to `ouro up`.",
+        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`.",
         usage: "ouro [up] [--no-repair]",
         example: "ouro up --no-repair",
     },
@@ -32,7 +32,7 @@ exports.COMMAND_REGISTRY = {
     },
     status: {
         category: "Lifecycle",
-        description: "Show daemon status",
+        description: "Show the house status",
         usage: "ouro status",
         example: "ouro status",
     },
@@ -273,7 +273,7 @@ const SUBCOMMAND_HELP = {
         example: "ouro auth switch --provider minimax",
     },
     "connect perplexity": {
-        description: "Connect Perplexity search for this agent",
+        description: "Connect portable Perplexity search that travels with this agent",
         usage: "ouro connect perplexity [--agent <name>]",
         example: "ouro connect perplexity",
     },
@@ -283,17 +283,17 @@ const SUBCOMMAND_HELP = {
         example: "ouro connect providers",
     },
     "connect embeddings": {
-        description: "Connect memory embeddings for this agent",
+        description: "Connect portable memory embeddings that travel with this agent",
         usage: "ouro connect embeddings [--agent <name>]",
         example: "ouro connect embeddings",
     },
     "connect teams": {
-        description: "Connect Microsoft Teams credentials and enable the Teams sense",
+        description: "Connect portable Microsoft Teams credentials and enable the Teams sense",
         usage: "ouro connect teams [--agent <name>]",
         example: "ouro connect teams",
     },
     "connect bluebubbles": {
-        description: "Attach BlueBubbles iMessage to this machine only",
+        description: "Attach BlueBubbles iMessage to this machine only; it does not travel with the agent",
         usage: "ouro connect bluebubbles [--agent <name>]",
         example: "ouro connect bluebubbles",
     },

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

@@ -6,6 +6,8 @@ exports.renderOuroHomeScreen = renderOuroHomeScreen;
 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) {
@@ -34,7 +36,7 @@ function buildOuroHomeActions(agents) {
     }));
     return [
         ...actions,
-        { key: String(actions.length + 1), label: "Bring the system online", kind: "up", command: "ouro up" },
+        { 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 + 4), label: "Show help", kind: "help", command: "ouro --help" },
@@ -59,7 +61,9 @@ function renderOuroHomeScreen(options) {
     const sections = [
         {
             title: options.agents.length === 0 ? "Start here" : "Around the house",
-            lines: actions.map((action) => `${action.key}. ${action.label}`),
+            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.`),
         },
     ];
     const actionRows = actions.map((action, index) => ({
@@ -79,7 +83,7 @@ function renderOuroHomeScreen(options) {
         title: "Ouro home",
         summary: options.agents.length === 0
             ? "Hatch someone new or bring an existing bundle aboard."
-            : "Pick an agent or system action without memorizing commands.",
+            : "Choose who to wake or what to prepare without memorizing commands.",
         sections,
         actions: actionRows,
         prompt: `Choose [1-${actions.length}] or type a name: `,
@@ -125,6 +129,19 @@ function renderHumanReadinessBoard(options) {
             ...item.detailLines,
         ],
     }));
+    return renderHumanCommandBoard({
+        title: options.title,
+        subtitle: options.subtitle,
+        summary: options.snapshot.summary,
+        isTTY: options.isTTY,
+        columns: options.columns,
+        sections,
+        actions: options.snapshot.nextActions,
+        prompt: options.prompt,
+    });
+}
+function renderHumanCommandBoard(options) {
+    renderScreenEvent("command-board");
     return (0, terminal_ui_1.renderTerminalBoard)({
         isTTY: options.isTTY,
         columns: options.columns,
@@ -132,9 +149,88 @@ function renderHumanReadinessBoard(options) {
             subtitle: options.subtitle,
         },
         title: options.title,
-        summary: options.snapshot.summary,
-        sections,
-        actions: options.snapshot.nextActions,
+        summary: options.summary,
+        sections: options.sections,
+        actions: options.actions,
         prompt: options.prompt,
     });
 }
+function renderHouseStatusScreen(options) {
+    renderScreenEvent("house-status");
+    const sections = [
+        {
+            title: "House pulse",
+            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: "House status",
+        subtitle: "The house is awake enough to answer clearly.",
+        summary: "What is awake, resting, or asking for care.",
+        isTTY: options.isTTY,
+        columns: options.columns,
+        sections,
+    });
+}

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

@@ -7,6 +7,7 @@ exports.wrapPlain = wrapPlain;
 exports.renderOuroMasthead = renderOuroMasthead;
 exports.formatActionActorLabel = formatActionActorLabel;
 exports.renderTerminalBoard = renderTerminalBoard;
+exports.renderTerminalOperation = renderTerminalOperation;
 const runtime_1 = require("../../nerves/runtime");
 const RESET = "\x1b[0m";
 const BOLD = "\x1b[1m";
@@ -87,11 +88,14 @@ function renderPanelPlain(title, lines) {
 function mastheadArt(columns) {
     if ((columns ?? 88) >= 74) {
         return [
-            "  ____  _   _ ____   ___  ____   ___  ____   ___  ____",
-            " / __ \\| | | |  _ \\ / _ \\|  _ \\ / _ \\| __ ) / _ \\|  _ \\",
-            "| |  | | | | | |_) | | | | |_) | | | |  _ \\| | | | |_) |",
-            "| |__| | |_| |  _ <| |_| |  _ <| |_| | |_) | |_| |  _ <",
-            " \\____/ \\___/|_| \\_\\\\___/|_| \\_\\\\___/|____/ \\___/|_| \\_\\",
+            "              .----------------------------.",
+            "          .--'    O U R O B O R O S        '--.",
+            "        .'       .--------------------.       '.",
+            "       /        /  .--------------.   \\        \\",
+            "       \\        \\  '--------------'   /        /",
+            "        '.       '--------------------'      .'",
+            "          '--._                          _.--'",
+            "               '------------------------'",
         ];
     }
     return [
@@ -101,10 +105,11 @@ function mastheadArt(columns) {
 }
 function renderOuroMasthead(options) {
     const lines = mastheadArt(options.columns);
+    const subtitle = options.subtitle ?? "the house wakes when called";
     const branded = [
         ...lines,
         "OUROBOROS",
-        ...(options.subtitle ? [options.subtitle] : []),
+        subtitle,
     ];
     if (!options.isTTY) {
         return `${branded.join("\n")}\n`;
@@ -112,7 +117,7 @@ function renderOuroMasthead(options) {
     const ttyLines = [
         ...lines.map((line, index) => color(line, index < 2 ? GLOW : SCALE, true)),
         color("OUROBOROS", BONE, true),
-        ...(options.subtitle ? [color(options.subtitle, MIST)] : []),
+        color(subtitle, MIST),
     ];
     return `${ttyLines.join("\n")}\n`;
 }
@@ -126,17 +131,19 @@ function renderActionLine(action) {
     return `${action.label} ${chips.join(" ")}`;
 }
 function renderTerminalBoard(options) {
-    (0, runtime_1.emitNervesEvent)({
-        component: "daemon",
-        event: "daemon.terminal_board_rendered",
-        message: "rendered shared terminal board",
-        meta: {
-            title: options.title,
-            sections: options.sections?.length ?? 0,
-            actions: options.actions?.length ?? 0,
-            tty: options.isTTY,
-        },
-    });
+    if (!options.suppressEvent) {
+        (0, runtime_1.emitNervesEvent)({
+            component: "daemon",
+            event: "daemon.terminal_board_rendered",
+            message: "rendered shared terminal board",
+            meta: {
+                title: options.title,
+                sections: options.sections?.length ?? 0,
+                actions: options.actions?.length ?? 0,
+                tty: options.isTTY,
+            },
+        });
+    }
     const width = boardWidth(options.columns);
     const blocks = [];
     blocks.push(renderOuroMasthead({
@@ -167,3 +174,45 @@ function renderTerminalBoard(options) {
     }
     return `${blocks.join("\n\n")}\n`;
 }
+function formatOperationStep(step) {
+    const marker = step.status === "done"
+        ? "✓"
+        : step.status === "failed"
+            ? "✗"
+            : step.status === "active"
+                ? "→"
+                : "○";
+    const detail = step.detail ? ` — ${step.detail}` : "";
+    return `${marker} ${step.label}${detail}`;
+}
+function renderTerminalOperation(options) {
+    const steps = options.steps ?? [];
+    const currentLines = options.currentStep
+        ? [
+            options.currentStep.label,
+            ...(options.currentStep.detailLines ?? []),
+        ]
+        : ["Standing by."];
+    const progressLines = steps.length > 0
+        ? steps.map((step) => formatOperationStep(step))
+        : ["No active steps yet."];
+    return renderTerminalBoard({
+        isTTY: options.isTTY,
+        columns: options.columns,
+        masthead: options.masthead,
+        title: options.title,
+        summary: options.summary,
+        sections: [
+            {
+                title: "Right now",
+                lines: currentLines,
+            },
+            {
+                title: "Progress",
+                lines: progressLines,
+            },
+        ],
+        prompt: options.prompt,
+        suppressEvent: options.suppressEvent,
+    });
+}

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

@@ -14,6 +14,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CommandProgress = exports.UpProgress = void 0;
 const runtime_1 = require("../../nerves/runtime");
+const terminal_ui_1 = require("./terminal-ui");
 // ── ANSI constants (shared with startup-tui.ts pattern) ──
 const SPINNER_FRAMES = "\u280B\u2819\u2839\u2838\u283C\u2834\u2826\u2827\u2807\u280F";
 const RESET = "\x1b[0m";
@@ -33,6 +34,7 @@ function splitDetailLines(detail) {
 class UpProgress {
     write;
     isTTY;
+    columns;
     now;
     autoRender;
     renderIntervalMs;
@@ -51,6 +53,7 @@ class UpProgress {
         this.write = options?.write ?? ((text) => process.stdout.write(text));
         /* v8 ignore next -- thin wrapper: real isTTY check injected for testability @preserve */
         this.isTTY = options?.isTTY ?? (process.stdout.isTTY === true);
+        this.columns = options?.columns;
         /* v8 ignore next -- thin wrapper: real Date.now injected for testability @preserve */
         this.now = options?.now ?? (() => Date.now());
         this.autoRender = options?.autoRender ?? false;
@@ -191,28 +194,7 @@ class UpProgress {
         if (!this.isTTY) {
             return "";
         }
-        const lines = [];
-        // Completed phases
-        for (const phase of this.completed) {
-            const detailStr = phase.detail ? ` ${DIM}\u2014 ${phase.detail}${RESET}` : "";
-            if (phase.status === "failure") {
-                lines.push(`  ${RED}\u2717${RESET} ${phase.label}${detailStr}`);
-            }
-            else {
-                lines.push(`  ${GREEN}\u2713${RESET} ${phase.label}${detailStr}`);
-            }
-        }
-        // Current phase with spinner
-        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];
-            lines.push(`  ${BOLD}${spinner}${RESET} ${this.currentPhase.label} ${DIM}(${elapsedSec}s)${RESET}`);
-            for (const detailLine of splitDetailLines(this.currentPhase.detail)) {
-                lines.push(`    ${DIM}${detailLine}${RESET}`);
-            }
-        }
+        const lines = this.renderLines(now);
         let output = "";
         if (this.prevLineCount > 0) {
             output += `\x1b[${this.prevLineCount}A`;
@@ -262,9 +244,69 @@ class UpProgress {
     }
     flushRender() {
         const output = this.render(this.now());
-        if (output) {
-            this.write(output);
+        this.write(output);
+    }
+    renderLines(now) {
+        if (this.eventScope === "up") {
+            return this.renderUpScreen(now);
+        }
+        const lines = [];
+        for (const phase of this.completed) {
+            const detailStr = phase.detail ? ` ${DIM}\u2014 ${phase.detail}${RESET}` : "";
+            if (phase.status === "failure") {
+                lines.push(`  ${RED}\u2717${RESET} ${phase.label}${detailStr}`);
+            }
+            else {
+                lines.push(`  ${GREEN}\u2713${RESET} ${phase.label}${detailStr}`);
+            }
+        }
+        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];
+            lines.push(`  ${BOLD}${spinner}${RESET} ${this.currentPhase.label} ${DIM}(${elapsedSec}s)${RESET}`);
+            for (const detailLine of splitDetailLines(this.currentPhase.detail)) {
+                lines.push(`    ${DIM}${detailLine}${RESET}`);
+            }
+        }
+        return lines;
+    }
+    renderUpScreen(now) {
+        const steps = this.completed.map((phase) => ({
+            label: phase.label,
+            status: phase.status === "failure" ? "failed" : "done",
+            detail: phase.detail,
+        }));
+        let currentStepLabel = "Standing by.";
+        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)`;
+            currentStepDetails = splitDetailLines(this.currentPhase.detail);
+            steps.push({
+                label: this.currentPhase.label,
+                status: "active",
+            });
         }
+        return (0, terminal_ui_1.renderTerminalOperation)({
+            isTTY: true,
+            columns: this.columns,
+            masthead: {
+                subtitle: "Preparing the house.",
+            },
+            title: "Preparing the house",
+            summary: "Ouro is warming the background systems and checking what still needs care before anyone steps in.",
+            currentStep: {
+                label: currentStepLabel,
+                detailLines: currentStepDetails,
+            },
+            steps,
+            suppressEvent: true,
+        }).trimEnd().split("\n");
     }
 }
 exports.UpProgress = UpProgress;

package/dist/heart/versioning/update-checker.js

@@ -33,12 +33,14 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.CLI_UPDATE_CHECK_TIMEOUT_MS = void 0;
 exports.checkForUpdate = checkForUpdate;
 exports.startUpdateChecker = startUpdateChecker;
 exports.stopUpdateChecker = stopUpdateChecker;
 const semver = __importStar(require("semver"));
 const runtime_1 = require("../../nerves/runtime");
 const DEFAULT_INTERVAL_MS = 30 * 60 * 1000; // 30 minutes
+exports.CLI_UPDATE_CHECK_TIMEOUT_MS = 3_000;
 async function checkForUpdate(currentVersion, deps) {
     (0, runtime_1.emitNervesEvent)({
         component: "daemon",

package/package.json

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