@ouro.bot/cli 0.1.0-alpha.56 → 0.1.0-alpha.560

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

@@ -0,0 +1,330 @@
+"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;
+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 (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 (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 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 */

package/dist/heart/daemon/task-scheduler.js

@@ -39,6 +39,7 @@ const path = __importStar(require("path"));
 const identity_1 = require("../identity");
 const runtime_1 = require("../../nerves/runtime");
 const parser_1 = require("../../repertoire/tasks/parser");
+const cadence_1 = require("./cadence");
 function walkMarkdownFiles(root, readdirSync, existsSync, files) {
     if (!existsSync(root))
         return;
@@ -53,29 +54,6 @@ function walkMarkdownFiles(root, readdirSync, existsSync, files) {
         }
     }
 }
-function parseCadence(raw) {
-    if (typeof raw !== "string")
-        return null;
-    const value = raw.trim();
-    if (!value)
-        return null;
-    // Cron format (minute hour day month weekday)
-    if (/^\S+\s+\S+\s+\S+\s+\S+\s+\S+$/.test(value)) {
-        return value;
-    }
-    const cadenceMatch = /^(\d+)(m|h|d)$/.exec(value);
-    if (!cadenceMatch)
-        return null;
-    const interval = Number.parseInt(cadenceMatch[1], 10);
-    if (!Number.isFinite(interval) || interval <= 0)
-        return null;
-    const unit = cadenceMatch[2];
-    if (unit === "m")
-        return `*/${interval} * * * *`;
-    if (unit === "h")
-        return `0 */${interval} * * *`;
-    return `0 0 */${interval} * *`;
-}
 function parseScheduledAt(raw) {
     if (typeof raw !== "string")
         return null;
@@ -140,7 +118,7 @@ class TaskDrivenScheduler {
         const nextTaskPaths = new Map();
         for (const agent of this.agents) {
             const taskRoot = path.join(this.bundlesRoot, `${agent}.ouro`, "tasks");
-            const collections = ["one-shots", "ongoing", "habits"];
+            const collections = ["one-shots", "ongoing"];
             const files = [];
             for (const collection of collections) {
                 walkMarkdownFiles(path.join(taskRoot, collection), this.readdirSync, this.existsSync, files);
@@ -157,7 +135,7 @@ class TaskDrivenScheduler {
                 nextTaskPaths.set(`${agent}:${taskId}`, filePath);
                 if (task.status === "done")
                     continue;
-                const cadence = parseCadence(task.frontmatter.cadence);
+                const cadence = (0, cadence_1.parseCadenceToCron)(task.frontmatter.cadence);
                 if (cadence) {
                     const id = `${agent}:${taskId}:cadence`;
                     nextJobs.set(id, {