@ouro.bot/cli 0.1.0-alpha.14 → 0.1.0-alpha.140

package/dist/heart/daemon/heartbeat-timer.js

@@ -0,0 +1,131 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HeartbeatTimer = exports.DEFAULT_CADENCE_MS = void 0;
+exports.parseCadenceMs = parseCadenceMs;
+const runtime_1 = require("../../nerves/runtime");
+const parser_1 = require("../../repertoire/tasks/parser");
+exports.DEFAULT_CADENCE_MS = 30 * 60 * 1000; // 30 minutes
+function parseCadenceMs(raw) {
+    if (typeof raw !== "string")
+        return null;
+    const value = raw.trim();
+    if (!value)
+        return null;
+    const match = /^(\d+)(m|h|d)$/.exec(value);
+    if (!match)
+        return null;
+    const interval = Number.parseInt(match[1], 10);
+    if (!Number.isFinite(interval) || interval <= 0)
+        return null;
+    const unit = match[2];
+    if (unit === "m")
+        return interval * 60 * 1000;
+    if (unit === "h")
+        return interval * 60 * 60 * 1000;
+    return interval * 24 * 60 * 60 * 1000;
+}
+class HeartbeatTimer {
+    agent;
+    sendToAgent;
+    readFileSync;
+    readdirSync;
+    heartbeatTaskDir;
+    runtimeStatePath;
+    now;
+    pendingTimer = null;
+    constructor(options) {
+        this.agent = options.agent;
+        this.sendToAgent = options.sendToAgent;
+        this.readFileSync = options.deps.readFileSync;
+        this.readdirSync = options.deps.readdirSync;
+        this.heartbeatTaskDir = options.deps.heartbeatTaskDir;
+        this.runtimeStatePath = options.deps.runtimeStatePath;
+        this.now = options.deps.now ?? (() => Date.now());
+    }
+    start() {
+        this.scheduleNext();
+    }
+    stop() {
+        if (this.pendingTimer !== null) {
+            clearTimeout(this.pendingTimer);
+            this.pendingTimer = null;
+        }
+    }
+    scheduleNext() {
+        const cadenceMs = this.readCadence();
+        const lastCompletedAt = this.readLastCompletedAt();
+        const nowMs = this.now();
+        let delay;
+        if (lastCompletedAt === null) {
+            // Never run before — fire immediately
+            delay = 0;
+        }
+        else {
+            const elapsed = nowMs - lastCompletedAt;
+            delay = Math.max(0, cadenceMs - elapsed);
+        }
+        this.pendingTimer = setTimeout(() => {
+            this.fire();
+        }, delay);
+    }
+    fire() {
+        this.pendingTimer = null;
+        (0, runtime_1.emitNervesEvent)({
+            component: "daemon",
+            event: "daemon.heartbeat_fire",
+            message: "heartbeat timer fired",
+            meta: { agent: this.agent },
+        });
+        this.sendToAgent(this.agent, { type: "heartbeat" });
+        this.scheduleNext();
+    }
+    readCadence() {
+        // Scan habits dir for *-heartbeat.md
+        let files;
+        try {
+            files = this.readdirSync(this.heartbeatTaskDir);
+        }
+        catch {
+            return exports.DEFAULT_CADENCE_MS;
+        }
+        const heartbeatFile = files.find((f) => f.endsWith("-heartbeat.md"));
+        if (!heartbeatFile)
+            return exports.DEFAULT_CADENCE_MS;
+        try {
+            const content = this.readFileSync(`${this.heartbeatTaskDir}/${heartbeatFile}`, "utf-8");
+            const cadence = this.extractCadenceFromTaskFile(content);
+            return cadence ?? exports.DEFAULT_CADENCE_MS;
+        }
+        catch {
+            return exports.DEFAULT_CADENCE_MS;
+        }
+    }
+    extractCadenceFromTaskFile(content) {
+        // Parse frontmatter from task file to get cadence value
+        const lines = content.split(/\r?\n/);
+        if (lines[0]?.trim() !== "---")
+            return null;
+        const closing = lines.findIndex((line, index) => index > 0 && line.trim() === "---");
+        if (closing === -1)
+            return null;
+        const rawFrontmatter = lines.slice(1, closing).join("\n");
+        const frontmatter = (0, parser_1.parseFrontmatter)(rawFrontmatter);
+        return parseCadenceMs(frontmatter.cadence);
+    }
+    readLastCompletedAt() {
+        try {
+            const raw = this.readFileSync(this.runtimeStatePath, "utf-8");
+            const state = JSON.parse(raw);
+            if (typeof state.lastCompletedAt !== "string")
+                return null;
+            const ms = new Date(state.lastCompletedAt).getTime();
+            if (Number.isNaN(ms))
+                return null;
+            return ms;
+        }
+        catch {
+            return null;
+        }
+    }
+}
+exports.HeartbeatTimer = HeartbeatTimer;

package/dist/heart/daemon/hooks/bundle-meta.js

@@ -0,0 +1,92 @@
+"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.bundleMetaHook = bundleMetaHook;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const runtime_1 = require("../../../nerves/runtime");
+async function bundleMetaHook(ctx) {
+    (0, runtime_1.emitNervesEvent)({
+        component: "daemon",
+        event: "daemon.bundle_meta_hook_start",
+        message: "running bundle-meta update hook",
+        meta: { agentRoot: ctx.agentRoot, currentVersion: ctx.currentVersion },
+    });
+    const metaPath = path.join(ctx.agentRoot, "bundle-meta.json");
+    let existing;
+    try {
+        if (fs.existsSync(metaPath)) {
+            const raw = fs.readFileSync(metaPath, "utf-8");
+            existing = JSON.parse(raw);
+        }
+    }
+    catch {
+        // Malformed JSON -- treat as missing, will overwrite with fresh
+        existing = undefined;
+    }
+    const updated = {
+        runtimeVersion: ctx.currentVersion,
+        bundleSchemaVersion: existing?.bundleSchemaVersion ?? 1,
+        lastUpdated: new Date().toISOString(),
+    };
+    // Save old runtimeVersion as previousRuntimeVersion (if there was one)
+    if (existing?.runtimeVersion) {
+        updated.previousRuntimeVersion = existing.runtimeVersion;
+    }
+    try {
+        fs.writeFileSync(metaPath, JSON.stringify(updated, null, 2) + "\n", "utf-8");
+    }
+    catch (err) {
+        const errorMessage = err instanceof Error ? err.message : /* v8 ignore next -- defensive: non-Error catch branch @preserve */ String(err);
+        (0, runtime_1.emitNervesEvent)({
+            component: "daemon",
+            event: "daemon.bundle_meta_hook_error",
+            message: "bundle-meta hook write failed",
+            meta: { agentRoot: ctx.agentRoot, error: errorMessage },
+        });
+        return { ok: false, error: errorMessage };
+    }
+    (0, runtime_1.emitNervesEvent)({
+        component: "daemon",
+        event: "daemon.bundle_meta_hook_end",
+        message: "bundle-meta updated",
+        meta: {
+            agentRoot: ctx.agentRoot,
+            runtimeVersion: updated.runtimeVersion,
+            previousRuntimeVersion: updated.previousRuntimeVersion,
+        },
+    });
+    return { ok: true };
+}

package/dist/heart/daemon/launchd.js

@@ -0,0 +1,159 @@
+"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.DAEMON_PLIST_LABEL = void 0;
+exports.generateDaemonPlist = generateDaemonPlist;
+exports.writeLaunchAgentPlist = writeLaunchAgentPlist;
+exports.installLaunchAgent = installLaunchAgent;
+exports.uninstallLaunchAgent = uninstallLaunchAgent;
+exports.isDaemonInstalled = isDaemonInstalled;
+const path = __importStar(require("path"));
+const runtime_1 = require("../../nerves/runtime");
+exports.DAEMON_PLIST_LABEL = "bot.ouro.daemon";
+function plistFilePath(homeDir) {
+    return path.join(homeDir, "Library", "LaunchAgents", `${exports.DAEMON_PLIST_LABEL}.plist`);
+}
+function userLaunchDomain(userUid) {
+    return `gui/${userUid}`;
+}
+function generateDaemonPlist(options) {
+    (0, runtime_1.emitNervesEvent)({
+        component: "daemon",
+        event: "daemon.launchd_generate_plist",
+        message: "generating daemon plist",
+        meta: { entryPath: options.entryPath, socketPath: options.socketPath },
+    });
+    const lines = [
+        `<?xml version="1.0" encoding="UTF-8"?>`,
+        `<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">`,
+        `<plist version="1.0">`,
+        `<dict>`,
+        `  <key>Label</key>`,
+        `  <string>${exports.DAEMON_PLIST_LABEL}</string>`,
+        `  <key>ProgramArguments</key>`,
+        `  <array>`,
+        `    <string>${options.nodePath}</string>`,
+        `    <string>${options.entryPath}</string>`,
+        `    <string>--socket</string>`,
+        `    <string>${options.socketPath}</string>`,
+        `  </array>`,
+        `  <key>RunAtLoad</key>`,
+        `  <true/>`,
+        `  <key>KeepAlive</key>`,
+        `  <true/>`,
+    ];
+    if (options.envPath) {
+        lines.push(`  <key>EnvironmentVariables</key>`, `  <dict>`, `    <key>PATH</key>`, `    <string>${options.envPath}</string>`, `  </dict>`);
+    }
+    if (options.logDir) {
+        lines.push(`  <key>StandardOutPath</key>`, `  <string>${path.join(options.logDir, "ouro-daemon-stdout.log")}</string>`, `  <key>StandardErrorPath</key>`, `  <string>${path.join(options.logDir, "ouro-daemon-stderr.log")}</string>`);
+    }
+    lines.push(`</dict>`, `</plist>`, ``);
+    return lines.join("\n");
+}
+function writeLaunchAgentPlist(deps, options) {
+    const launchAgentsDir = path.join(deps.homeDir, "Library", "LaunchAgents");
+    deps.mkdirp(launchAgentsDir);
+    if (options.logDir) {
+        deps.mkdirp(options.logDir);
+    }
+    const fullPath = plistFilePath(deps.homeDir);
+    const xml = generateDaemonPlist(options);
+    deps.writeFile(fullPath, xml);
+    (0, runtime_1.emitNervesEvent)({
+        component: "daemon",
+        event: "daemon.launchd_plist_written",
+        message: "daemon launch agent plist written",
+        meta: { plistPath: fullPath, entryPath: options.entryPath, socketPath: options.socketPath },
+    });
+    return fullPath;
+}
+function installLaunchAgent(deps, options) {
+    (0, runtime_1.emitNervesEvent)({
+        component: "daemon",
+        event: "daemon.launchd_install",
+        message: "installing launch agent",
+        meta: { entryPath: options.entryPath, socketPath: options.socketPath },
+    });
+    const fullPath = plistFilePath(deps.homeDir);
+    const domain = userLaunchDomain(deps.userUid);
+    // Unload existing (best effort) for idempotent re-install
+    if (deps.existsFile(fullPath)) {
+        try {
+            deps.exec(`launchctl bootout ${domain} "${fullPath}"`);
+        }
+        catch { /* best effort */ }
+    }
+    writeLaunchAgentPlist(deps, options);
+    deps.exec(`launchctl bootstrap ${domain} "${fullPath}"`);
+    (0, runtime_1.emitNervesEvent)({
+        component: "daemon",
+        event: "daemon.launchd_installed",
+        message: "launch agent installed",
+        meta: { plistPath: fullPath },
+    });
+}
+function uninstallLaunchAgent(deps) {
+    (0, runtime_1.emitNervesEvent)({
+        component: "daemon",
+        event: "daemon.launchd_uninstall",
+        message: "uninstalling launch agent",
+        meta: {},
+    });
+    const fullPath = plistFilePath(deps.homeDir);
+    const domain = userLaunchDomain(deps.userUid);
+    if (deps.existsFile(fullPath)) {
+        try {
+            deps.exec(`launchctl bootout ${domain} "${fullPath}"`);
+        }
+        catch { /* best effort */ }
+        deps.removeFile(fullPath);
+    }
+    (0, runtime_1.emitNervesEvent)({
+        component: "daemon",
+        event: "daemon.launchd_uninstalled",
+        message: "launch agent uninstalled",
+        meta: { plistPath: fullPath },
+    });
+}
+function isDaemonInstalled(deps) {
+    (0, runtime_1.emitNervesEvent)({
+        component: "daemon",
+        event: "daemon.launchd_check_installed",
+        message: "checking if daemon is installed",
+        meta: {},
+    });
+    return deps.existsFile(plistFilePath(deps.homeDir));
+}

package/dist/heart/daemon/log-tailer.js

@@ -37,10 +37,10 @@ exports.discoverLogFiles = discoverLogFiles;
 exports.readLastLines = readLastLines;
 exports.formatLogLine = formatLogLine;
 exports.tailLogs = tailLogs;
-const os = __importStar(require("os"));
 const path = __importStar(require("path"));
 const nerves_1 = require("../../nerves");
 const runtime_1 = require("../../nerves/runtime");
+const identity_1 = require("../identity");
 const LEVEL_COLORS = {
     debug: "\x1b[2m",
     info: "\x1b[36m",
@@ -49,11 +49,12 @@ const LEVEL_COLORS = {
 };
 function discoverLogFiles(options) {
     /* v8 ignore start -- integration: default DI stubs for real OS @preserve */
-    const homeDir = options.homeDir ?? os.homedir();
     const existsSync = options.existsSync ?? (() => false);
     const readdirSync = options.readdirSync ?? (() => []);
     /* v8 ignore stop */
-    const logDir = path.join(homeDir, ".agentstate", "daemon", "logs");
+    const logDir = options.homeDir
+        ? path.join(options.homeDir, "AgentBundles", `${options.agentName ?? "slugger"}.ouro`, "state", "daemon", "logs")
+        : (0, identity_1.getAgentDaemonLogsDir)(options.agentName);
     const files = [];
     if (existsSync(logDir)) {
         for (const name of readdirSync(logDir)) {