@ouro.bot/cli 0.1.0-alpha.8 → 0.1.0-alpha.800

package/dist/heart/daemon/stale-bundle-prune.js

@@ -0,0 +1,113 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pruneStaleEphemeralBundles = pruneStaleEphemeralBundles;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const identity_1 = require("../identity");
+const runtime_1 = require("../../nerves/runtime");
+/**
+ * Scan the bundles root for `.ouro` directories that have no bundle contract
+ * or durable state markers (definitively dead ephemeral bundles) and delete
+ * them.
+ *
+ * Returns a list of pruned bundle directory names (e.g. `["stale.ouro"]`)
+ * for display purposes. Bundles that have `agent.json` -- even if disabled
+ * -- are never deleted. Task-doc-only bundles are also durable work state, so
+ * directories with state roots such as `tasks`, `desk`, `arc`, `state`, or
+ * `.git` are preserved. Errors on individual bundles are swallowed so that one
+ * permission-denied doesn't block pruning the rest.
+ */
+function pruneStaleEphemeralBundles(deps = {}) {
+    const bundlesRoot = deps.bundlesRoot ?? (0, identity_1.getAgentBundlesRoot)();
+    const readdirSync = deps.readdirSync ?? fs.readdirSync;
+    const existsSync = deps.existsSync ?? fs.existsSync;
+    const rmSync = deps.rmSync ?? fs.rmSync;
+    let entries;
+    try {
+        entries = readdirSync(bundlesRoot, { withFileTypes: true });
+    }
+    catch {
+        return [];
+    }
+    const pruned = [];
+    for (const entry of entries) {
+        if (!entry.isDirectory() || !entry.name.endsWith(".ouro"))
+            continue;
+        const bundlePath = path.join(bundlesRoot, entry.name);
+        if (hasDurableBundleMarker(bundlePath, existsSync))
+            continue;
+        try {
+            rmSync(bundlePath, { recursive: true, force: true });
+            pruned.push(entry.name);
+            (0, runtime_1.emitNervesEvent)({
+                level: "info",
+                component: "daemon",
+                event: "daemon.stale_bundle_pruned",
+                message: `pruned stale ephemeral bundle: ${entry.name}`,
+                meta: { bundle: entry.name, bundlePath },
+            });
+        }
+        catch (error) {
+            (0, runtime_1.emitNervesEvent)({
+                level: "warn",
+                component: "daemon",
+                event: "daemon.stale_bundle_prune_error",
+                message: `failed to prune stale bundle: ${entry.name}`,
+                meta: {
+                    bundle: entry.name,
+                    bundlePath,
+                    error: error instanceof Error ? error.message : String(error),
+                },
+            });
+        }
+    }
+    return pruned;
+}
+const DURABLE_BUNDLE_MARKERS = [
+    "agent.json",
+    "tasks",
+    "desk",
+    "arc",
+    "state",
+    "habits",
+    "friends",
+    "facts",
+    "vault",
+    ".git",
+];
+function hasDurableBundleMarker(bundlePath, existsSync) {
+    return DURABLE_BUNDLE_MARKERS.some((marker) => existsSync(path.join(bundlePath, marker)));
+}

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

@@ -0,0 +1,339 @@
+"use strict";
+/**
+ * Startup TUI — real-time progress display for `ouro up`.
+ *
+ * Replaces the old `verifyDaemonAlive()` socket poll with a richer system
+ * that shows per-agent status, waits for stability, and reports degraded
+ * agents with actionable error information.
+ *
+ * Pure functions (`renderStartupProgress`, `assessStability`) are fully
+ * testable. The polling loop (`pollDaemonStartup`) uses dependency injection
+ * for all I/O.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assessStability = assessStability;
+exports.renderStartupProgress = renderStartupProgress;
+exports.renderWaitingForDaemon = renderWaitingForDaemon;
+exports.pollDaemonStartup = pollDaemonStartup;
+exports.defaultIsProcessAlive = defaultIsProcessAlive;
+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;
+const POLL_INTERVAL_MS = 500;
+const STARTUP_POLL_TIMEOUT_MS = 180_000;
+// ── ANSI helpers ──
+const RESET = "\x1b[0m";
+const BOLD = "\x1b[1m";
+const DIM = "\x1b[2m";
+const GREEN = "\x1b[38;2;46;204;64m";
+const RED = "\x1b[38;2;231;76;60m";
+const YELLOW = "\x1b[38;2;230;190;50m";
+// ── Pure functions ──
+/**
+ * Assess whether all workers have reached a terminal state (stable or crashed).
+ * A worker is "stable" when status is "running" and it has been running for
+ * at least STABILITY_THRESHOLD_MS. A worker is "definitively failed" when
+ * status is "crashed". All other states are unresolved.
+ */
+function assessStability(payload, now) {
+    const stable = [];
+    const degraded = [];
+    let allResolved = true;
+    for (const worker of payload.workers) {
+        if (isPassiveStoppedWorker(worker)) {
+            continue;
+        }
+        else if (worker.status === "crashed") {
+            degraded.push({
+                agent: worker.agent,
+                errorReason: worker.errorReason ?? "unknown error",
+                fixHint: worker.fixHint ?? "check daemon logs",
+            });
+        }
+        else if (worker.status === "running" && worker.startedAt !== null) {
+            const startedMs = new Date(worker.startedAt).getTime();
+            const runningMs = now - startedMs;
+            if (runningMs >= STABILITY_THRESHOLD_MS) {
+                stable.push(worker.agent);
+            }
+            else {
+                allResolved = false;
+            }
+        }
+        else {
+            // starting, stopped, or running with null startedAt — not yet resolved
+            allResolved = false;
+        }
+    }
+    return { resolved: allResolved, stable, degraded };
+}
+/**
+ * Build an ANSI string for in-place terminal display during polling.
+ * Uses cursor-up and line-clear escapes to overwrite previous output.
+ */
+function renderStartupProgress(payload, elapsed, prevLineCount = 0, options = {}) {
+    const isTTY = options.isTTY ?? true;
+    const frameIndex = Math.floor(elapsed / 100) % SPINNER_FRAMES.length;
+    const spinner = SPINNER_FRAMES[frameIndex];
+    const lines = [];
+    const elapsedSec = (elapsed / 1000).toFixed(1);
+    lines.push(isTTY
+        ? `${spinner} ${BOLD}waiting for agents${RESET} ${DIM}(${elapsedSec}s)${RESET}`
+        : `${spinner} waiting for agents (${elapsedSec}s)`);
+    for (const worker of payload.workers) {
+        const statusText = isTTY ? colorStatus(worker.status) : worker.status;
+        lines.push(`  ${worker.agent}/${worker.worker}: ${statusText}`);
+    }
+    return renderStartupLines(lines, prevLineCount, isTTY);
+}
+/**
+ * Render a pre-socket status line showing what the daemon is doing.
+ */
+function renderWaitingForDaemon(elapsed, latestEvent, prevLineCount = 0, options = {}) {
+    const isTTY = options.isTTY ?? true;
+    const elapsedSec = (elapsed / 1000).toFixed(1);
+    const frameIndex = Math.floor(elapsed / 100) % SPINNER_FRAMES.length;
+    const spinner = SPINNER_FRAMES[frameIndex];
+    const lines = [];
+    lines.push(isTTY
+        ? `${spinner} ${BOLD}starting background service${RESET} ${DIM}(${elapsedSec}s)${RESET}`
+        : `${spinner} starting background service (${elapsedSec}s)`);
+    if (latestEvent) {
+        const detail = `latest daemon event: ${latestEvent}`;
+        lines.push(isTTY ? `  ${DIM}${detail}${RESET}` : `  ${detail}`);
+    }
+    return renderStartupLines(lines, prevLineCount, isTTY);
+}
+/**
+ * Render the final summary after all agents have resolved.
+ */
+function renderFinalSummary(result, isTTY) {
+    const lines = [];
+    for (const agent of result.stable) {
+        lines.push(isTTY ? `  ${GREEN}\u2713${RESET} ${agent}: ${GREEN}stable${RESET}` : `  \u2713 ${agent}: stable`);
+    }
+    for (const d of result.degraded) {
+        lines.push(isTTY ? `  ${RED}\u2717${RESET} ${d.agent}: ${RED}degraded${RESET}` : `  \u2717 ${d.agent}: degraded`);
+        if (d.errorReason !== "unknown error") {
+            lines.push(isTTY ? `    ${DIM}error: ${d.errorReason}${RESET}` : `    error: ${d.errorReason}`);
+        }
+        if (d.fixHint !== "check daemon logs") {
+            lines.push(isTTY ? `    ${DIM}fix:   ${d.fixHint}${RESET}` : `    fix:   ${d.fixHint}`);
+        }
+    }
+    if (!isTTY)
+        return lines.join("\n") + "\n";
+    return lines.map((line) => `\x1b[2K${line}`).join("\n") + "\n";
+}
+// ── Polling loop ──
+/**
+ * Poll the daemon's status socket until all agents are stable or definitively
+ * failed, rendering real-time progress to the terminal.
+ *
+ * Detects daemon process death: if the spawned PID is no longer alive and the
+ * socket never came up, reports the failure immediately instead of spinning.
+ */
+async function pollDaemonStartup(deps) {
+    const startTime = deps.now();
+    const maxWaitMs = deps.maxWaitMs ?? STARTUP_POLL_TIMEOUT_MS;
+    let prevLineCount = 0;
+    const isTTY = deps.isTTY ?? true;
+    const isAlive = deps.isProcessAlive ?? defaultIsProcessAlive;
+    const shouldRender = deps.render ?? true;
+    let lastProgress = null;
+    const reportProgress = (message) => {
+        if (!deps.onProgress || message === lastProgress)
+            return;
+        lastProgress = message;
+        deps.onProgress(message);
+    };
+    (0, runtime_1.emitNervesEvent)({
+        component: "daemon",
+        event: "daemon.startup_poll_start",
+        message: "beginning startup stability polling",
+        meta: { socketPath: deps.socketPath, daemonPid: deps.daemonPid },
+    });
+    while (true) {
+        const now = deps.now();
+        const elapsed = now - startTime;
+        let payload = null;
+        try {
+            const response = await deps.sendCommand(deps.socketPath, { kind: "daemon.status" });
+            payload = (0, cli_render_1.parseStatusPayload)(response.data);
+        }
+        catch {
+            // Socket not yet available — check if the daemon process is still alive
+            if (deps.daemonPid !== null && !isAlive(deps.daemonPid)) {
+                const latestEvent = deps.readLatestDaemonEvent?.() ?? null;
+                const errorMsg = latestEvent ?? "daemon process died during startup";
+                (0, runtime_1.emitNervesEvent)({
+                    level: "error",
+                    component: "daemon",
+                    event: "daemon.startup_process_died",
+                    message: "daemon process died before socket came up",
+                    meta: { pid: deps.daemonPid, lastEvent: latestEvent },
+                });
+                // Clear the waiting line
+                if (isTTY && prevLineCount > 0) {
+                    let clear = `\x1b[${prevLineCount}A`;
+                    for (let i = 0; i < prevLineCount; i++)
+                        clear += `\x1b[2K\n`;
+                    deps.writeRaw(clear);
+                }
+                return {
+                    stable: [],
+                    degraded: [{ agent: "daemon", errorReason: errorMsg, fixHint: "check daemon logs or run `ouro doctor`" }],
+                };
+            }
+            const latestEvent = deps.readLatestDaemonEvent?.() ?? null;
+            if (elapsed >= maxWaitMs) {
+                const errorMsg = latestEvent
+                    ? `daemon did not answer within ${(maxWaitMs / 1000).toFixed(0)}s; latest event: ${latestEvent}`
+                    : `daemon did not answer within ${(maxWaitMs / 1000).toFixed(0)}s`;
+                const result = {
+                    stable: [],
+                    degraded: [{ agent: "daemon", errorReason: errorMsg, fixHint: "check daemon logs or run `ouro doctor`" }],
+                };
+                if (shouldRender) {
+                    const summary = renderFinalSummary(result, isTTY);
+                    deps.writeRaw(summary);
+                }
+                (0, runtime_1.emitNervesEvent)({
+                    level: "error",
+                    component: "daemon",
+                    event: "daemon.startup_poll_timeout",
+                    message: "daemon startup polling timed out before the daemon answered",
+                    meta: { socketPath: deps.socketPath, daemonPid: deps.daemonPid, elapsedMs: elapsed, maxWaitMs, lastEvent: latestEvent },
+                });
+                return result;
+            }
+            // Show what the daemon is doing from its log
+            reportProgress([
+                "waiting for Ouro to answer",
+                latestEvent ? `- latest daemon event: ${latestEvent}` : "- background service is still starting",
+            ].join("\n"));
+            if (shouldRender) {
+                const output = renderWaitingForDaemon(elapsed, latestEvent, prevLineCount, { isTTY });
+                deps.writeRaw(output);
+                prevLineCount = latestEvent ? 2 : 1;
+            }
+        }
+        if (payload) {
+            reportProgress(formatStartupProgressDetail(payload));
+            if (shouldRender) {
+                const output = renderStartupProgress(payload, elapsed, prevLineCount, { isTTY });
+                deps.writeRaw(output);
+                prevLineCount = payload.workers.length + 1;
+            }
+            const assessment = assessStability(payload, now);
+            if (assessment.resolved) {
+                const result = {
+                    stable: assessment.stable,
+                    degraded: assessment.degraded,
+                };
+                if (shouldRender) {
+                    const summary = renderFinalSummary(result, isTTY);
+                    deps.writeRaw(summary);
+                }
+                (0, runtime_1.emitNervesEvent)({
+                    component: "daemon",
+                    event: "daemon.startup_poll_end",
+                    message: "startup polling complete",
+                    meta: {
+                        stableCount: result.stable.length,
+                        degradedCount: result.degraded.length,
+                        elapsedMs: elapsed,
+                    },
+                });
+                return result;
+            }
+            if (elapsed >= maxWaitMs) {
+                const result = buildTimedOutStartupResult(payload, assessment, maxWaitMs);
+                if (shouldRender) {
+                    const summary = renderFinalSummary(result, isTTY);
+                    deps.writeRaw(summary);
+                }
+                (0, runtime_1.emitNervesEvent)({
+                    level: "error",
+                    component: "daemon",
+                    event: "daemon.startup_poll_timeout",
+                    message: "daemon startup polling timed out with unresolved workers",
+                    meta: {
+                        socketPath: deps.socketPath,
+                        daemonPid: deps.daemonPid,
+                        elapsedMs: elapsed,
+                        maxWaitMs,
+                        stableCount: result.stable.length,
+                        degradedCount: result.degraded.length,
+                    },
+                });
+                return result;
+            }
+        }
+        await deps.sleep(POLL_INTERVAL_MS);
+    }
+}
+function buildTimedOutStartupResult(payload, assessment, maxWaitMs) {
+    const stable = [...assessment.stable];
+    const degraded = [...assessment.degraded];
+    const stableAgents = new Set(stable);
+    const degradedAgents = new Set();
+    for (const worker of degraded)
+        degradedAgents.add(worker.agent);
+    const seconds = (maxWaitMs / 1000).toFixed(0);
+    for (const worker of payload.workers) {
+        if (isPassiveStoppedWorker(worker))
+            continue;
+        if (stableAgents.has(worker.agent) || degradedAgents.has(worker.agent))
+            continue;
+        degraded.push({
+            agent: worker.agent,
+            errorReason: `startup timed out after ${seconds}s while worker was ${worker.status}`,
+            fixHint: worker.errorReason
+                ? worker.fixHint ?? "check daemon logs"
+                : "run `ouro status` or `ouro doctor` for current worker details; the daemon is still answering",
+        });
+    }
+    return { stable, degraded };
+}
+function isPassiveStoppedWorker(worker) {
+    return worker.autoStart === false && worker.status === "stopped";
+}
+function formatStartupWorkerLine(payload) {
+    const base = `- ${payload.agent}/${payload.worker}: ${payload.status}`;
+    if (payload.status === "crashed" && payload.errorReason) {
+        return `${base} (${payload.errorReason})`;
+    }
+    return base;
+}
+function formatStartupProgressDetail(payload) {
+    if (payload.workers.length === 0)
+        return "Ouro answered";
+    return [
+        "Ouro answered",
+        ...payload.workers.map((worker) => formatStartupWorkerLine(worker)),
+    ].join("\n");
+}
+function colorStatus(status) {
+    const statusColor = status === "running" ? GREEN
+        : status === "crashed" ? RED
+            : YELLOW;
+    return `${statusColor}${status}${RESET}`;
+}
+function renderStartupLines(lines, prevLineCount, isTTY) {
+    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) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/* v8 ignore stop */