@ouro.bot/cli 0.1.0-alpha.60 → 0.1.0-alpha.600

package/dist/arc/attention-types.js

@@ -0,0 +1,8 @@
+"use strict";
+/**
+ * Shared attention queue types.
+ *
+ * Canonical home for the AttentionItem interface — consumed by heart/, repertoire/, nerves/, and senses/.
+ * Placed in heart/ because attention is a turn-coordination concern.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/arc/cares.js

@@ -0,0 +1,140 @@
+"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.createCare = createCare;
+exports.readCares = readCares;
+exports.readActiveCares = readActiveCares;
+exports.updateCare = updateCare;
+exports.resolveCare = resolveCare;
+const path = __importStar(require("path"));
+const runtime_1 = require("../nerves/runtime");
+const json_store_1 = require("./json-store");
+function caresDir(agentRoot) {
+    return path.join(agentRoot, "arc", "cares");
+}
+function createCare(agentRoot, input) {
+    const now = new Date().toISOString();
+    const id = (0, json_store_1.generateTimestampId)("care");
+    const care = {
+        id,
+        label: input.label,
+        why: input.why,
+        kind: input.kind,
+        status: input.status,
+        salience: input.salience,
+        steward: input.steward,
+        relatedFriendIds: input.relatedFriendIds,
+        relatedAgentIds: input.relatedAgentIds,
+        relatedObligationIds: input.relatedObligationIds,
+        relatedEpisodeIds: input.relatedEpisodeIds,
+        currentRisk: input.currentRisk,
+        nextCheckAt: input.nextCheckAt,
+        createdAt: now,
+        updatedAt: now,
+    };
+    (0, json_store_1.writeJsonFile)(caresDir(agentRoot), id, care);
+    (0, runtime_1.emitNervesEvent)({
+        component: "heart",
+        event: "heart.care_created",
+        message: `care created: ${input.label}`,
+        meta: { careId: id, status: input.status, salience: input.salience },
+    });
+    return care;
+}
+function readCares(agentRoot) {
+    const dir = caresDir(agentRoot);
+    const cares = (0, json_store_1.readJsonDir)(dir);
+    (0, runtime_1.emitNervesEvent)({
+        component: "heart",
+        event: "heart.cares_read",
+        message: cares.length === 0 ? "read cares: directory missing, returning empty" : `read ${cares.length} cares`,
+        meta: { count: cares.length },
+    });
+    return cares;
+}
+function readActiveCares(agentRoot) {
+    const all = readCares(agentRoot);
+    const active = all.filter((c) => c.status === "active" || c.status === "watching");
+    (0, runtime_1.emitNervesEvent)({
+        component: "heart",
+        event: "heart.active_cares_read",
+        message: `read ${active.length} active cares`,
+        meta: { count: active.length, total: all.length },
+    });
+    return active;
+}
+function readCareFile(agentRoot, id) {
+    return (0, json_store_1.readJsonFileOrThrow)(caresDir(agentRoot), id, "Care");
+}
+function writeCareFile(agentRoot, care) {
+    (0, json_store_1.writeJsonFile)(caresDir(agentRoot), care.id, care);
+}
+function updateCare(agentRoot, id, updates) {
+    const care = readCareFile(agentRoot, id);
+    const now = new Date().toISOString();
+    const updated = {
+        ...care,
+        ...updates,
+        id: care.id, // protect ID from overwrite
+        createdAt: care.createdAt, // protect createdAt
+        updatedAt: now,
+    };
+    writeCareFile(agentRoot, updated);
+    (0, runtime_1.emitNervesEvent)({
+        component: "heart",
+        event: "heart.care_updated",
+        message: `care updated: ${updated.label}`,
+        meta: { careId: id, updates: Object.keys(updates) },
+    });
+    return updated;
+}
+function resolveCare(agentRoot, id) {
+    const care = readCareFile(agentRoot, id);
+    const now = new Date().toISOString();
+    const resolved = {
+        ...care,
+        status: "resolved",
+        resolvedAt: now,
+        updatedAt: now,
+    };
+    writeCareFile(agentRoot, resolved);
+    (0, runtime_1.emitNervesEvent)({
+        component: "heart",
+        event: "heart.care_resolved",
+        message: `care resolved: ${resolved.label}`,
+        meta: { careId: id },
+    });
+    return resolved;
+}

package/dist/arc/episodes.js

@@ -0,0 +1,117 @@
+"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.emitEpisode = emitEpisode;
+exports.readRecentEpisodes = readRecentEpisodes;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const runtime_1 = require("../nerves/runtime");
+function episodesDir(agentRoot) {
+    return path.join(agentRoot, "arc", "episodes");
+}
+function generateId() {
+    const timestamp = Date.now();
+    const random = Math.random().toString(36).slice(2, 10);
+    return `ep-${timestamp}-${random}`;
+}
+function emitEpisode(agentRoot, input) {
+    const now = new Date().toISOString();
+    const id = generateId();
+    const episode = {
+        id,
+        timestamp: now,
+        kind: input.kind,
+        summary: input.summary,
+        whyItMattered: input.whyItMattered,
+        relatedEntities: input.relatedEntities,
+        salience: input.salience,
+        ...(input.meta ? { meta: input.meta } : {}),
+    };
+    const dir = episodesDir(agentRoot);
+    fs.mkdirSync(dir, { recursive: true });
+    const filePath = path.join(dir, `${id}.json`);
+    fs.writeFileSync(filePath, JSON.stringify(episode, null, 2), "utf-8");
+    (0, runtime_1.emitNervesEvent)({
+        component: "mind",
+        event: "mind.episode_emitted",
+        message: `episode emitted: ${input.kind}`,
+        meta: {
+            episodeId: id,
+            kind: input.kind,
+            salience: input.salience,
+        },
+    });
+    return episode;
+}
+function readRecentEpisodes(agentRoot, options) {
+    const dir = episodesDir(agentRoot);
+    if (!fs.existsSync(dir)) {
+        (0, runtime_1.emitNervesEvent)({
+            component: "mind",
+            event: "mind.episodes_read",
+            message: "read episodes: directory missing, returning empty",
+            meta: { count: 0 },
+        });
+        return [];
+    }
+    const limit = options?.limit ?? 50;
+    const since = options?.since;
+    const kinds = options?.kinds;
+    const files = fs.readdirSync(dir).filter((f) => f.endsWith(".json"));
+    const episodes = [];
+    for (const file of files) {
+        try {
+            const content = fs.readFileSync(path.join(dir, file), "utf-8");
+            const episode = JSON.parse(content);
+            if (since && episode.timestamp < since)
+                continue;
+            if (kinds && !kinds.includes(episode.kind))
+                continue;
+            episodes.push(episode);
+        }
+        catch {
+            // Skip malformed JSON files gracefully
+        }
+    }
+    episodes.sort((a, b) => b.timestamp.localeCompare(a.timestamp));
+    const result = episodes.slice(0, limit);
+    (0, runtime_1.emitNervesEvent)({
+        component: "mind",
+        event: "mind.episodes_read",
+        message: `read ${result.length} recent episodes`,
+        meta: { count: result.length, total: episodes.length, limit },
+    });
+    return result;
+}

package/dist/arc/intentions.js

@@ -0,0 +1,133 @@
+"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.captureIntention = captureIntention;
+exports.readOpenIntentions = readOpenIntentions;
+exports.resolveIntention = resolveIntention;
+exports.dismissIntention = dismissIntention;
+const path = __importStar(require("path"));
+const runtime_1 = require("../nerves/runtime");
+const json_store_1 = require("./json-store");
+function intentionsDir(agentRoot) {
+    return path.join(agentRoot, "arc", "intentions");
+}
+const SALIENCE_ORDER = {
+    high: 3,
+    medium: 2,
+    low: 1,
+};
+function salienceRank(salience) {
+    if (!salience)
+        return 0;
+    return SALIENCE_ORDER[salience] ?? 0;
+}
+function captureIntention(agentRoot, input) {
+    const now = new Date().toISOString();
+    const id = (0, json_store_1.generateTimestampId)("int");
+    const intention = {
+        id,
+        content: input.content,
+        status: "open",
+        createdAt: now,
+        updatedAt: now,
+        ...(input.salience ? { salience: input.salience } : {}),
+        source: input.source,
+        ...(input.relatedFriendId ? { relatedFriendId: input.relatedFriendId } : {}),
+        ...(input.relatedObligationId ? { relatedObligationId: input.relatedObligationId } : {}),
+        ...(input.relatedCareId ? { relatedCareId: input.relatedCareId } : {}),
+        ...(input.nudgeAfter ? { nudgeAfter: input.nudgeAfter } : {}),
+    };
+    (0, json_store_1.writeJsonFile)(intentionsDir(agentRoot), id, intention);
+    (0, runtime_1.emitNervesEvent)({
+        component: "heart",
+        event: "heart.intention_captured",
+        message: `intention captured: ${input.content.slice(0, 60)}`,
+        meta: { intentionId: id, source: input.source, salience: input.salience },
+    });
+    return intention;
+}
+function readOpenIntentions(agentRoot, options) {
+    const dir = intentionsDir(agentRoot);
+    const all = (0, json_store_1.readJsonDir)(dir);
+    const limit = options?.limit ?? 20;
+    const intentions = all.filter((i) => i.status === "open");
+    // Sort by salience descending, then createdAt descending
+    intentions.sort((a, b) => {
+        const salienceDiff = salienceRank(b.salience) - salienceRank(a.salience);
+        if (salienceDiff !== 0)
+            return salienceDiff;
+        return b.createdAt.localeCompare(a.createdAt);
+    });
+    const result = intentions.slice(0, limit);
+    (0, runtime_1.emitNervesEvent)({
+        component: "heart",
+        event: "heart.intentions_read",
+        message: `read ${result.length} open intentions`,
+        meta: { count: result.length, total: intentions.length, limit },
+    });
+    return result;
+}
+function readIntentionFile(agentRoot, id) {
+    return (0, json_store_1.readJsonFileOrThrow)(intentionsDir(agentRoot), id, "Intention");
+}
+function writeIntentionFile(agentRoot, intention) {
+    (0, json_store_1.writeJsonFile)(intentionsDir(agentRoot), intention.id, intention);
+}
+function resolveIntention(agentRoot, id) {
+    const intention = readIntentionFile(agentRoot, id);
+    intention.status = "done";
+    intention.updatedAt = new Date().toISOString();
+    writeIntentionFile(agentRoot, intention);
+    (0, runtime_1.emitNervesEvent)({
+        component: "heart",
+        event: "heart.intention_resolved",
+        message: `intention resolved: ${intention.content.slice(0, 60)}`,
+        meta: { intentionId: id },
+    });
+    return intention;
+}
+function dismissIntention(agentRoot, id) {
+    const intention = readIntentionFile(agentRoot, id);
+    intention.status = "dismissed";
+    intention.updatedAt = new Date().toISOString();
+    writeIntentionFile(agentRoot, intention);
+    (0, runtime_1.emitNervesEvent)({
+        component: "heart",
+        event: "heart.intention_dismissed",
+        message: `intention dismissed: ${intention.content.slice(0, 60)}`,
+        meta: { intentionId: id },
+    });
+    return intention;
+}

package/dist/arc/json-store.js

@@ -0,0 +1,117 @@
+"use strict";
+/**
+ * Shared JSON file store helpers for arc/ modules.
+ *
+ * obligations.ts, cares.ts, and intentions.ts all use the same pattern:
+ * individual JSON files in a directory, with read-all / read-one / write-one
+ * operations. This module extracts those patterns.
+ */
+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.generateTimestampId = generateTimestampId;
+exports.readJsonDir = readJsonDir;
+exports.readJsonFile = readJsonFile;
+exports.readJsonFileOrThrow = readJsonFileOrThrow;
+exports.writeJsonFile = writeJsonFile;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+/**
+ * Generate a timestamped random ID.
+ * @param prefix Optional prefix (e.g. "care", "int"). Omit for plain timestamp IDs.
+ */
+function generateTimestampId(prefix) {
+    const timestamp = Date.now();
+    const random = Math.random().toString(36).slice(2, 10);
+    return prefix ? `${prefix}-${timestamp}-${random}` : `${timestamp}-${random}`;
+}
+/**
+ * Read all JSON files from a directory, parse each, and return an array.
+ * Silently skips malformed files. Returns empty array if directory is missing.
+ */
+function readJsonDir(dir) {
+    if (!fs.existsSync(dir))
+        return [];
+    let entries;
+    try {
+        entries = fs.readdirSync(dir);
+    }
+    catch {
+        /* v8 ignore next -- defensive: readdirSync race after existsSync @preserve */
+        return [];
+    }
+    const jsonFiles = entries.filter((entry) => entry.endsWith(".json")).sort();
+    const records = [];
+    for (const file of jsonFiles) {
+        try {
+            const raw = fs.readFileSync(path.join(dir, file), "utf-8");
+            records.push(JSON.parse(raw));
+        }
+        catch {
+            // Skip malformed JSON files
+        }
+    }
+    return records;
+}
+/**
+ * Read a single JSON file by ID from a directory.
+ * Returns null if the file doesn't exist or is unparseable.
+ */
+function readJsonFile(dir, id) {
+    try {
+        const raw = fs.readFileSync(path.join(dir, `${id}.json`), "utf-8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Read a single JSON file by ID, throwing if not found.
+ */
+function readJsonFileOrThrow(dir, id, label) {
+    const filePath = path.join(dir, `${id}.json`);
+    if (!fs.existsSync(filePath)) {
+        throw new Error(`${label} not found: ${id}`);
+    }
+    return JSON.parse(fs.readFileSync(filePath, "utf-8"));
+}
+/**
+ * Write a record to a JSON file, creating the directory if needed.
+ */
+function writeJsonFile(dir, id, record) {
+    fs.mkdirSync(dir, { recursive: true });
+    const filePath = path.join(dir, `${id}.json`);
+    fs.writeFileSync(filePath, JSON.stringify(record, null, 2), "utf-8");
+}