@ouro.bot/cli 0.1.0-alpha.210 → 0.1.0-alpha.211

package/changelog.json

@@ -1,6 +1,12 @@
 {
   "_note": "This changelog is maintained as part of the PR/version-bump workflow. Agent-curated, not auto-generated. Agents read this file directly via read_file to understand what changed between versions.",
   "versions": [
+    {
+      "version": "0.1.0-alpha.211",
+      "changes": [
+        "refactor: extract duplicated patterns into shared utilities — mind/embedding-provider.ts (shared OpenAI embedding client from diary + associative-recall), arc/json-store.ts (shared JSON file CRUD from obligations + cares + intentions), repertoire/api-client.ts (shared HTTP request helper from graph + ado + github clients). M12 (channel callback factory) skipped: CLI and Teams streaming implementations are too different for clean abstraction."
+      ]
+    },
     {
       "version": "0.1.0-alpha.210",
       "changes": [

package/dist/arc/cares.js

@@ -38,24 +38,15 @@ exports.readCares = readCares;
 exports.readActiveCares = readActiveCares;
 exports.updateCare = updateCare;
 exports.resolveCare = resolveCare;
-const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const runtime_1 = require("../nerves/runtime");
-const sync_1 = require("../heart/sync");
+const json_store_1 = require("./json-store");
 function caresDir(agentRoot) {
     return path.join(agentRoot, "arc", "cares");
 }
-function careFilePath(agentRoot, id) {
-    return path.join(caresDir(agentRoot), `${id}.json`);
-}
-function generateId() {
-    const timestamp = Date.now();
-    const random = Math.random().toString(36).slice(2, 10);
-    return `care-${timestamp}-${random}`;
-}
 function createCare(agentRoot, input) {
     const now = new Date().toISOString();
-    const id = generateId();
+    const id = (0, json_store_1.generateTimestampId)("care");
     const care = {
         id,
         label: input.label,
@@ -73,11 +64,7 @@ function createCare(agentRoot, input) {
         createdAt: now,
         updatedAt: now,
     };
-    const dir = caresDir(agentRoot);
-    fs.mkdirSync(dir, { recursive: true });
-    const filePath = careFilePath(agentRoot, id);
-    fs.writeFileSync(filePath, JSON.stringify(care, null, 2), "utf-8");
-    (0, sync_1.trackSyncWrite)(filePath);
+    (0, json_store_1.writeJsonFile)(caresDir(agentRoot), id, care);
     (0, runtime_1.emitNervesEvent)({
         component: "heart",
         event: "heart.care_created",
@@ -88,31 +75,11 @@ function createCare(agentRoot, input) {
 }
 function readCares(agentRoot) {
     const dir = caresDir(agentRoot);
-    if (!fs.existsSync(dir)) {
-        (0, runtime_1.emitNervesEvent)({
-            component: "heart",
-            event: "heart.cares_read",
-            message: "read cares: directory missing, returning empty",
-            meta: { count: 0 },
-        });
-        return [];
-    }
-    const files = fs.readdirSync(dir).filter((f) => f.endsWith(".json"));
-    const cares = [];
-    for (const file of files) {
-        try {
-            const content = fs.readFileSync(path.join(dir, file), "utf-8");
-            const care = JSON.parse(content);
-            cares.push(care);
-        }
-        catch {
-            // Skip malformed JSON files gracefully
-        }
-    }
+    const cares = (0, json_store_1.readJsonDir)(dir);
     (0, runtime_1.emitNervesEvent)({
         component: "heart",
         event: "heart.cares_read",
-        message: `read ${cares.length} cares`,
+        message: cares.length === 0 ? "read cares: directory missing, returning empty" : `read ${cares.length} cares`,
         meta: { count: cares.length },
     });
     return cares;
@@ -129,16 +96,10 @@ function readActiveCares(agentRoot) {
     return active;
 }
 function readCareFile(agentRoot, id) {
-    const filePath = careFilePath(agentRoot, id);
-    if (!fs.existsSync(filePath)) {
-        throw new Error(`Care not found: ${id}`);
-    }
-    return JSON.parse(fs.readFileSync(filePath, "utf-8"));
+    return (0, json_store_1.readJsonFileOrThrow)(caresDir(agentRoot), id, "Care");
 }
 function writeCareFile(agentRoot, care) {
-    const filePath = careFilePath(agentRoot, care.id);
-    fs.writeFileSync(filePath, JSON.stringify(care, null, 2), "utf-8");
-    (0, sync_1.trackSyncWrite)(filePath);
+    (0, json_store_1.writeJsonFile)(caresDir(agentRoot), care.id, care);
 }
 function updateCare(agentRoot, id, updates) {
     const care = readCareFile(agentRoot, id);

package/dist/arc/intentions.js

@@ -37,21 +37,12 @@ exports.captureIntention = captureIntention;
 exports.readOpenIntentions = readOpenIntentions;
 exports.resolveIntention = resolveIntention;
 exports.dismissIntention = dismissIntention;
-const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const runtime_1 = require("../nerves/runtime");
-const sync_1 = require("../heart/sync");
+const json_store_1 = require("./json-store");
 function intentionsDir(agentRoot) {
     return path.join(agentRoot, "arc", "intentions");
 }
-function intentionFilePath(agentRoot, id) {
-    return path.join(intentionsDir(agentRoot), `${id}.json`);
-}
-function generateId() {
-    const timestamp = Date.now();
-    const random = Math.random().toString(36).slice(2, 10);
-    return `int-${timestamp}-${random}`;
-}
 const SALIENCE_ORDER = {
     high: 3,
     medium: 2,
@@ -64,7 +55,7 @@ function salienceRank(salience) {
 }
 function captureIntention(agentRoot, input) {
     const now = new Date().toISOString();
-    const id = generateId();
+    const id = (0, json_store_1.generateTimestampId)("int");
     const intention = {
         id,
         content: input.content,
@@ -78,11 +69,7 @@ function captureIntention(agentRoot, input) {
         ...(input.relatedCareId ? { relatedCareId: input.relatedCareId } : {}),
         ...(input.nudgeAfter ? { nudgeAfter: input.nudgeAfter } : {}),
     };
-    const dir = intentionsDir(agentRoot);
-    fs.mkdirSync(dir, { recursive: true });
-    const filePath = intentionFilePath(agentRoot, id);
-    fs.writeFileSync(filePath, JSON.stringify(intention, null, 2), "utf-8");
-    (0, sync_1.trackSyncWrite)(filePath);
+    (0, json_store_1.writeJsonFile)(intentionsDir(agentRoot), id, intention);
     (0, runtime_1.emitNervesEvent)({
         component: "heart",
         event: "heart.intention_captured",
@@ -93,30 +80,9 @@ function captureIntention(agentRoot, input) {
 }
 function readOpenIntentions(agentRoot, options) {
     const dir = intentionsDir(agentRoot);
-    if (!fs.existsSync(dir)) {
-        (0, runtime_1.emitNervesEvent)({
-            component: "heart",
-            event: "heart.intentions_read",
-            message: "read intentions: directory missing, returning empty",
-            meta: { count: 0 },
-        });
-        return [];
-    }
+    const all = (0, json_store_1.readJsonDir)(dir);
     const limit = options?.limit ?? 20;
-    const files = fs.readdirSync(dir).filter((f) => f.endsWith(".json"));
-    const intentions = [];
-    for (const file of files) {
-        try {
-            const content = fs.readFileSync(path.join(dir, file), "utf-8");
-            const intention = JSON.parse(content);
-            if (intention.status === "open") {
-                intentions.push(intention);
-            }
-        }
-        catch {
-            // Skip malformed JSON files
-        }
-    }
+    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);
@@ -134,16 +100,10 @@ function readOpenIntentions(agentRoot, options) {
     return result;
 }
 function readIntentionFile(agentRoot, id) {
-    const filePath = intentionFilePath(agentRoot, id);
-    if (!fs.existsSync(filePath)) {
-        throw new Error(`Intention not found: ${id}`);
-    }
-    return JSON.parse(fs.readFileSync(filePath, "utf-8"));
+    return (0, json_store_1.readJsonFileOrThrow)(intentionsDir(agentRoot), id, "Intention");
 }
 function writeIntentionFile(agentRoot, intention) {
-    const filePath = intentionFilePath(agentRoot, intention.id);
-    fs.writeFileSync(filePath, JSON.stringify(intention, null, 2), "utf-8");
-    (0, sync_1.trackSyncWrite)(filePath);
+    (0, json_store_1.writeJsonFile)(intentionsDir(agentRoot), intention.id, intention);
 }
 function resolveIntention(agentRoot, id) {
     const intention = readIntentionFile(agentRoot, id);

package/dist/arc/json-store.js

@@ -0,0 +1,120 @@
+"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"));
+const sync_1 = require("../heart/sync");
+/**
+ * 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.
+ * Automatically calls trackSyncWrite.
+ */
+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");
+    (0, sync_1.trackSyncWrite)(filePath);
+}

package/dist/arc/obligations.js

@@ -48,22 +48,13 @@ exports.createReturnObligation = createReturnObligation;
 exports.readReturnObligation = readReturnObligation;
 exports.advanceReturnObligation = advanceReturnObligation;
 exports.listActiveReturnObligations = listActiveReturnObligations;
-const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const identity_1 = require("../heart/identity");
 const runtime_1 = require("../nerves/runtime");
-const sync_1 = require("../heart/sync");
+const json_store_1 = require("./json-store");
 function obligationsDir(agentRoot) {
     return path.join(agentRoot, "arc", "obligations");
 }
-function obligationFilePath(agentRoot, id) {
-    return path.join(obligationsDir(agentRoot), `${id}.json`);
-}
-function generateId() {
-    const timestamp = Date.now();
-    const random = Math.random().toString(36).slice(2, 10);
-    return `${timestamp}-${random}`;
-}
 function isOpenObligationStatus(status) {
     return status !== "fulfilled";
 }
@@ -72,7 +63,7 @@ function isOpenObligation(obligation) {
 }
 function createObligation(agentRoot, input) {
     const now = new Date().toISOString();
-    const id = generateId();
+    const id = (0, json_store_1.generateTimestampId)();
     const obligation = {
         id,
         origin: input.origin,
@@ -82,11 +73,7 @@ function createObligation(agentRoot, input) {
         createdAt: now,
         updatedAt: now,
     };
-    const dir = obligationsDir(agentRoot);
-    fs.mkdirSync(dir, { recursive: true });
-    const filePath = obligationFilePath(agentRoot, id);
-    fs.writeFileSync(filePath, JSON.stringify(obligation, null, 2), "utf-8");
-    (0, sync_1.trackSyncWrite)(filePath);
+    (0, json_store_1.writeJsonFile)(obligationsDir(agentRoot), id, obligation);
     (0, runtime_1.emitNervesEvent)({
         component: "engine",
         event: "engine.obligation_created",
@@ -101,46 +88,17 @@ function createObligation(agentRoot, input) {
     return obligation;
 }
 function readObligations(agentRoot) {
-    const dir = obligationsDir(agentRoot);
-    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 obligations = [];
-    for (const file of jsonFiles) {
-        try {
-            const raw = fs.readFileSync(path.join(dir, file), "utf-8");
-            const parsed = JSON.parse(raw);
-            if (typeof parsed.id === "string" && typeof parsed.content === "string") {
-                obligations.push(parsed);
-            }
-        }
-        catch {
-            // skip malformed files
-        }
-    }
-    return obligations;
+    const all = (0, json_store_1.readJsonDir)(obligationsDir(agentRoot));
+    return all.filter((parsed) => typeof parsed.id === "string" && typeof parsed.content === "string");
 }
 function readPendingObligations(agentRoot) {
     return readObligations(agentRoot).filter(isOpenObligation);
 }
 function advanceObligation(agentRoot, obligationId, update) {
-    const filePath = obligationFilePath(agentRoot, obligationId);
-    let obligation;
-    try {
-        const raw = fs.readFileSync(filePath, "utf-8");
-        obligation = JSON.parse(raw);
-    }
-    catch {
+    const dir = obligationsDir(agentRoot);
+    const obligation = (0, json_store_1.readJsonFile)(dir, obligationId);
+    if (!obligation)
         return;
-    }
     const previousStatus = obligation.status;
     if (update.status) {
         obligation.status = update.status;
@@ -161,8 +119,7 @@ function advanceObligation(agentRoot, obligationId, update) {
         obligation.latestNote = update.latestNote;
     }
     obligation.updatedAt = new Date().toISOString();
-    fs.writeFileSync(filePath, JSON.stringify(obligation, null, 2), "utf-8");
-    (0, sync_1.trackSyncWrite)(filePath);
+    (0, json_store_1.writeJsonFile)(dir, obligationId, obligation);
     (0, runtime_1.emitNervesEvent)({
         component: "engine",
         event: "engine.obligation_advanced",
@@ -181,15 +138,9 @@ function advanceObligation(agentRoot, obligationId, update) {
 }
 function fulfillObligation(agentRoot, obligationId) {
     advanceObligation(agentRoot, obligationId, { status: "fulfilled" });
-    const filePath = obligationFilePath(agentRoot, obligationId);
-    let obligation;
-    try {
-        const raw = fs.readFileSync(filePath, "utf-8");
-        obligation = JSON.parse(raw);
-    }
-    catch {
+    const obligation = (0, json_store_1.readJsonFile)(obligationsDir(agentRoot), obligationId);
+    if (!obligation)
         return;
-    }
     (0, runtime_1.emitNervesEvent)({
         component: "engine",
         event: "engine.obligation_fulfilled",
@@ -208,16 +159,15 @@ function findPendingObligationForOrigin(agentRoot, origin) {
         && ob.origin.key === origin.key);
 }
 function enrichObligation(agentRoot, id, meaning) {
-    const filePath = obligationFilePath(agentRoot, id);
-    if (!fs.existsSync(filePath)) {
+    const dir = obligationsDir(agentRoot);
+    const existing = (0, json_store_1.readJsonFile)(dir, id);
+    if (!existing) {
         throw new Error(`Obligation not found: ${id}`);
     }
-    const raw = fs.readFileSync(filePath, "utf-8");
-    const obligation = JSON.parse(raw);
+    const obligation = existing;
     obligation.meaning = meaning;
     obligation.updatedAt = new Date().toISOString();
-    fs.writeFileSync(filePath, JSON.stringify(obligation, null, 2), "utf-8");
-    (0, sync_1.trackSyncWrite)(filePath);
+    (0, json_store_1.writeJsonFile)(dir, id, obligation);
     (0, runtime_1.emitNervesEvent)({
         component: "engine",
         event: "engine.obligation_enriched",
@@ -238,10 +188,8 @@ function getReturnObligationsDir(agentName) {
 }
 function createReturnObligation(agentName, obligation) {
     const dir = getReturnObligationsDir(agentName);
-    fs.mkdirSync(dir, { recursive: true });
+    (0, json_store_1.writeJsonFile)(dir, obligation.id, obligation);
     const filePath = path.join(dir, `${obligation.id}.json`);
-    fs.writeFileSync(filePath, JSON.stringify(obligation, null, 2), "utf8");
-    (0, sync_1.trackSyncWrite)(filePath);
     (0, runtime_1.emitNervesEvent)({
         event: "mind.obligation_created",
         component: "mind",
@@ -255,14 +203,7 @@ function createReturnObligation(agentName, obligation) {
     return filePath;
 }
 function readReturnObligation(agentName, obligationId) {
-    const dir = getReturnObligationsDir(agentName);
-    try {
-        const raw = fs.readFileSync(path.join(dir, `${obligationId}.json`), "utf-8");
-        return JSON.parse(raw);
-    }
-    catch {
-        return null;
-    }
+    return (0, json_store_1.readJsonFile)(getReturnObligationsDir(agentName), obligationId);
 }
 function advanceReturnObligation(agentName, obligationId, update) {
     const existing = readReturnObligation(agentName, obligationId);
@@ -275,10 +216,7 @@ function advanceReturnObligation(agentName, obligationId, update) {
         ...(update.returnedAt !== undefined ? { returnedAt: update.returnedAt } : {}),
         ...(update.returnTarget !== undefined ? { returnTarget: update.returnTarget } : {}),
     };
-    const dir = getReturnObligationsDir(agentName);
-    const advancedFilePath = path.join(dir, `${obligationId}.json`);
-    fs.writeFileSync(advancedFilePath, JSON.stringify(updated, null, 2), "utf8");
-    (0, sync_1.trackSyncWrite)(advancedFilePath);
+    (0, json_store_1.writeJsonFile)(getReturnObligationsDir(agentName), obligationId, updated);
     (0, runtime_1.emitNervesEvent)({
         event: "mind.obligation_advanced",
         component: "mind",
@@ -292,30 +230,8 @@ function advanceReturnObligation(agentName, obligationId, update) {
     return updated;
 }
 function listActiveReturnObligations(agentName) {
-    const dir = getReturnObligationsDir(agentName);
-    if (!fs.existsSync(dir))
-        return [];
-    let entries;
-    try {
-        entries = fs.readdirSync(dir);
-    }
-    catch {
-        return [];
-    }
-    const obligations = [];
-    for (const file of entries) {
-        if (!file.endsWith(".json"))
-            continue;
-        try {
-            const raw = fs.readFileSync(path.join(dir, file), "utf-8");
-            const parsed = JSON.parse(raw);
-            if (parsed.status === "queued" || parsed.status === "running") {
-                obligations.push(parsed);
-            }
-        }
-        catch {
-            // skip unparseable
-        }
-    }
-    return obligations.sort((a, b) => a.createdAt - b.createdAt);
+    const all = (0, json_store_1.readJsonDir)(getReturnObligationsDir(agentName));
+    return all
+        .filter((parsed) => parsed.status === "queued" || parsed.status === "running")
+        .sort((a, b) => a.createdAt - b.createdAt);
 }

package/dist/mind/associative-recall.js

@@ -39,47 +39,17 @@ exports.searchJournalIndex = searchJournalIndex;
 exports.injectAssociativeRecall = injectAssociativeRecall;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
-const config_1 = require("../heart/config");
 const runtime_1 = require("../nerves/runtime");
 const diary_1 = require("./diary");
-const DEFAULT_EMBEDDING_MODEL = "text-embedding-3-small";
+const embedding_provider_1 = require("./embedding-provider");
 const DEFAULT_MIN_SCORE = 0.5;
 const DEFAULT_TOP_K = 3;
-class OpenAIEmbeddingProvider {
-    apiKey;
-    model;
-    constructor(apiKey, model = DEFAULT_EMBEDDING_MODEL) {
-        this.apiKey = apiKey;
-        this.model = model;
-    }
-    async embed(texts) {
-        const response = await fetch("https://api.openai.com/v1/embeddings", {
-            method: "POST",
-            headers: {
-                Authorization: `Bearer ${this.apiKey}`,
-                "Content-Type": "application/json",
-            },
-            body: JSON.stringify({
-                model: this.model,
-                input: texts,
-            }),
-        });
-        if (!response.ok) {
-            throw new Error(`embedding request failed: ${response.status} ${response.statusText}`);
-        }
-        const payload = (await response.json());
-        if (!payload.data || payload.data.length !== texts.length) {
-            throw new Error("embedding response missing expected vectors");
-        }
-        return payload.data.map((entry) => entry.embedding);
-    }
-}
 function createDefaultProvider() {
-    const apiKey = (0, config_1.getOpenAIEmbeddingsApiKey)();
-    if (!apiKey) {
+    const provider = (0, embedding_provider_1.createDefaultEmbeddingProvider)();
+    if (!provider) {
         throw new Error("openaiEmbeddingsApiKey not configured");
     }
-    return new OpenAIEmbeddingProvider(apiKey);
+    return provider;
 }
 function readFacts(diaryRoot) {
     const factsPath = path.join(diaryRoot, "facts.jsonl");

package/dist/mind/diary.js

@@ -43,44 +43,14 @@ exports.searchDiaryEntries = searchDiaryEntries;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const crypto_1 = require("crypto");
-const config_1 = require("../heart/config");
 const identity_1 = require("../heart/identity");
 const runtime_1 = require("../nerves/runtime");
 const sync_1 = require("../heart/sync");
 const associative_recall_1 = require("./associative-recall");
+const embedding_provider_1 = require("./embedding-provider");
 const DEDUP_THRESHOLD = 0.6;
 const SEMANTIC_DEDUP_THRESHOLD = 0.95;
 const ENTITY_TOKEN = /[a-z0-9]+/g;
-const DEFAULT_EMBEDDING_MODEL = "text-embedding-3-small";
-class OpenAIEmbeddingProvider {
-    apiKey;
-    model;
-    constructor(apiKey, model = DEFAULT_EMBEDDING_MODEL) {
-        this.apiKey = apiKey;
-        this.model = model;
-    }
-    async embed(texts) {
-        const response = await fetch("https://api.openai.com/v1/embeddings", {
-            method: "POST",
-            headers: {
-                Authorization: `Bearer ${this.apiKey}`,
-                "Content-Type": "application/json",
-            },
-            body: JSON.stringify({
-                model: this.model,
-                input: texts,
-            }),
-        });
-        if (!response.ok) {
-            throw new Error(`embedding request failed: ${response.status} ${response.statusText}`);
-        }
-        const payload = (await response.json());
-        if (!payload.data || payload.data.length !== texts.length) {
-            throw new Error("embedding response missing expected vectors");
-        }
-        return payload.data.map((entry) => entry.embedding);
-    }
-}
 function ensureDiaryStorePaths(rootDir) {
     const factsPath = path.join(rootDir, "facts.jsonl");
     const entitiesPath = path.join(rootDir, "entities.json");
@@ -219,14 +189,8 @@ function appendEntriesWithDedup(stores, incoming, options) {
     });
     return { added, skipped };
 }
-function createDefaultEmbeddingProvider() {
-    const apiKey = (0, config_1.getOpenAIEmbeddingsApiKey)().trim();
-    if (!apiKey)
-        return null;
-    return new OpenAIEmbeddingProvider(apiKey);
-}
 async function buildEmbedding(text, embeddingProvider) {
-    const provider = embeddingProvider ?? createDefaultEmbeddingProvider();
+    const provider = embeddingProvider ?? (0, embedding_provider_1.createDefaultEmbeddingProvider)();
     if (!provider) {
         (0, runtime_1.emitNervesEvent)({
             level: "warn",
@@ -287,7 +251,7 @@ async function backfillEmbeddings(options) {
     const needsEmbedding = facts.filter((f) => !Array.isArray(f.embedding) || f.embedding.length === 0);
     if (needsEmbedding.length === 0)
         return { total: facts.length, backfilled: 0, failed: 0 };
-    const provider = options?.embeddingProvider ?? createDefaultEmbeddingProvider();
+    const provider = options?.embeddingProvider ?? (0, embedding_provider_1.createDefaultEmbeddingProvider)();
     if (!provider) {
         (0, runtime_1.emitNervesEvent)({
             level: "warn",
@@ -364,7 +328,7 @@ async function searchDiaryEntries(query, facts, embeddingProvider) {
     if (embeddedFacts.length === 0) {
         return substringFallback();
     }
-    const provider = embeddingProvider ?? createDefaultEmbeddingProvider();
+    const provider = embeddingProvider ?? (0, embedding_provider_1.createDefaultEmbeddingProvider)();
     if (!provider) {
         return substringFallback();
     }

package/dist/mind/embedding-provider.js

@@ -0,0 +1,60 @@
+"use strict";
+/**
+ * Shared OpenAI embedding provider.
+ *
+ * Both diary.ts and associative-recall.ts need to call the OpenAI embeddings
+ * API. This module provides the shared implementation so neither duplicates
+ * the fetch logic.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenAIEmbeddingProvider = void 0;
+exports.createDefaultEmbeddingProvider = createDefaultEmbeddingProvider;
+const config_1 = require("../heart/config");
+const runtime_1 = require("../nerves/runtime");
+const DEFAULT_EMBEDDING_MODEL = "text-embedding-3-small";
+class OpenAIEmbeddingProvider {
+    apiKey;
+    model;
+    constructor(apiKey, model = DEFAULT_EMBEDDING_MODEL) {
+        this.apiKey = apiKey;
+        this.model = model;
+    }
+    async embed(texts) {
+        const response = await fetch("https://api.openai.com/v1/embeddings", {
+            method: "POST",
+            headers: {
+                Authorization: `Bearer ${this.apiKey}`,
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify({
+                model: this.model,
+                input: texts,
+            }),
+        });
+        if (!response.ok) {
+            throw new Error(`embedding request failed: ${response.status} ${response.statusText}`);
+        }
+        const payload = (await response.json());
+        if (!payload.data || payload.data.length !== texts.length) {
+            throw new Error("embedding response missing expected vectors");
+        }
+        return payload.data.map((entry) => entry.embedding);
+    }
+}
+exports.OpenAIEmbeddingProvider = OpenAIEmbeddingProvider;
+/**
+ * Create a default embedding provider from the configured API key.
+ * Returns null if no key is configured.
+ */
+function createDefaultEmbeddingProvider() {
+    const apiKey = (0, config_1.getOpenAIEmbeddingsApiKey)().trim();
+    if (!apiKey)
+        return null;
+    (0, runtime_1.emitNervesEvent)({
+        component: "mind",
+        event: "mind.embedding_provider_created",
+        message: "default embedding provider created",
+        meta: { model: DEFAULT_EMBEDDING_MODEL },
+    });
+    return new OpenAIEmbeddingProvider(apiKey);
+}

package/dist/nerves/coverage/file-completeness.js

@@ -61,6 +61,11 @@ const DISPATCH_EXEMPT_PATTERNS = [
     // cli-parse and cli-render are pure functions with no side effects.
     "daemon/cli-parse",
     "daemon/cli-render",
+    // Shared utility modules: pure helpers consumed by modules that own observability.
+    "arc/json-store",
+    "repertoire/api-client",
+    "repertoire/github-client",
+    "mind/embedding-provider",
 ];
 function isDispatchExempt(filePath) {
     return DISPATCH_EXEMPT_PATTERNS.some((pattern) => filePath.includes(pattern));

package/dist/repertoire/ado-client.js

@@ -9,6 +9,7 @@ exports.discoverOrganizations = discoverOrganizations;
 exports.discoverProjects = discoverProjects;
 const api_error_1 = require("../heart/api-error");
 const runtime_1 = require("../nerves/runtime");
+const api_client_1 = require("./api-client");
 const ADO_BASE = "https://dev.azure.com";
 const VSSPS_BASE = "https://app.vssps.visualstudio.com";
 const DEFAULT_API_VERSION = "api-version=7.1";
@@ -30,62 +31,20 @@ function resolveContentType(method, path) {
 // Generic ADO API request. Returns response body as pretty-printed JSON string.
 // `host` overrides the base URL for non-standard APIs (e.g. "vsapm.dev.azure.com", "vssps.dev.azure.com").
 async function adoRequest(token, method, org, path, body, host) {
-    try {
-        const base = host ? `https://${host}/${org}` : `${ADO_BASE}/${org}`;
-        (0, runtime_1.emitNervesEvent)({
-            event: "client.request_start",
-            component: "clients",
-            message: "starting ADO request",
-            meta: { client: "ado", method, org, path },
-        });
-        const fullPath = ensureApiVersion(path);
-        const url = `${base}${fullPath}`;
-        const contentType = resolveContentType(method, path);
-        const opts = {
-            method,
-            headers: {
-                Authorization: `Bearer ${token}`,
-                "Content-Type": contentType,
-            },
-        };
-        if (body)
-            opts.body = body;
-        const res = await fetch(url, opts);
-        if (!res.ok) {
-            (0, runtime_1.emitNervesEvent)({
-                level: "error",
-                event: "client.error",
-                component: "clients",
-                message: "ADO request failed",
-                meta: { client: "ado", method, org, path, status: res.status },
-            });
-            return (0, api_error_1.handleApiError)(res, "ADO", "ado");
-        }
-        const data = await res.json();
-        (0, runtime_1.emitNervesEvent)({
-            event: "client.request_end",
-            component: "clients",
-            message: "ADO request completed",
-            meta: { client: "ado", method, org, path, success: true },
-        });
-        return JSON.stringify(data, null, 2);
-    }
-    catch (err) {
-        (0, runtime_1.emitNervesEvent)({
-            level: "error",
-            event: "client.error",
-            component: "clients",
-            message: "ADO request threw exception",
-            meta: {
-                client: "ado",
-                method,
-                org,
-                path,
-                reason: err instanceof Error ? err.message : String(err),
-            },
-        });
-        return (0, api_error_1.handleApiError)(err, "ADO", "ado");
-    }
+    const base = host ? `https://${host}/${org}` : `${ADO_BASE}/${org}`;
+    const fullPath = ensureApiVersion(path);
+    return (0, api_client_1.apiRequest)({
+        baseUrl: base,
+        method,
+        path: fullPath,
+        token,
+        clientName: "ado",
+        serviceLabel: "ADO",
+        connectionName: "ado",
+        body,
+        contentType: resolveContentType(method, path),
+        eventMeta: { org },
+    });
 }
 // Backward-compatible thin wrapper: runs WIQL query and returns formatted work items.
 async function queryWorkItems(token, org, query) {

package/dist/repertoire/api-client.js

@@ -0,0 +1,71 @@
+"use strict";
+/**
+ * Shared HTTP API client for Graph, ADO, and GitHub clients.
+ *
+ * All three API clients follow the same pattern: emit request_start event,
+ * build request with auth header, fetch, handle errors, emit request_end,
+ * and return pretty-printed JSON. This module extracts that shared logic.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.apiRequest = apiRequest;
+const api_error_1 = require("../heart/api-error");
+const runtime_1 = require("../nerves/runtime");
+/**
+ * Execute an authenticated API request with standard logging and error handling.
+ * Returns the response body as a pretty-printed JSON string.
+ */
+async function apiRequest(options) {
+    const { baseUrl, method, path, token, clientName, serviceLabel, connectionName, body, extraHeaders, contentType, eventMeta, } = options;
+    try {
+        (0, runtime_1.emitNervesEvent)({
+            event: "client.request_start",
+            component: "clients",
+            message: `starting ${serviceLabel} request`,
+            meta: { client: clientName, method, path, ...eventMeta },
+        });
+        const url = `${baseUrl}${path}`;
+        const headers = {
+            Authorization: `Bearer ${token}`,
+            "Content-Type": contentType ?? "application/json",
+            ...extraHeaders,
+        };
+        const opts = { method, headers };
+        if (body)
+            opts.body = body;
+        const res = await fetch(url, opts);
+        if (!res.ok) {
+            (0, runtime_1.emitNervesEvent)({
+                level: "error",
+                event: "client.error",
+                component: "clients",
+                message: `${serviceLabel} request failed`,
+                meta: { client: clientName, method, path, status: res.status, ...eventMeta },
+            });
+            return (0, api_error_1.handleApiError)(res, serviceLabel, connectionName);
+        }
+        const data = await res.json();
+        (0, runtime_1.emitNervesEvent)({
+            event: "client.request_end",
+            component: "clients",
+            message: `${serviceLabel} request completed`,
+            meta: { client: clientName, method, path, success: true, ...eventMeta },
+        });
+        return JSON.stringify(data, null, 2);
+    }
+    catch (err) {
+        (0, runtime_1.emitNervesEvent)({
+            level: "error",
+            event: "client.error",
+            component: "clients",
+            message: `${serviceLabel} request threw exception`,
+            meta: {
+                client: clientName,
+                method,
+                path,
+                reason: err instanceof Error ? err.message : String(err),
+                ...eventMeta,
+            },
+        });
+        return (0, api_error_1.handleApiError)(err, serviceLabel, connectionName);
+    }
+}

package/dist/repertoire/github-client.js

@@ -3,62 +3,21 @@
 // Provides a generic githubRequest() for arbitrary GitHub REST API endpoints.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.githubRequest = githubRequest;
-const api_error_1 = require("../heart/api-error");
-const runtime_1 = require("../nerves/runtime");
+const api_client_1 = require("./api-client");
 const GITHUB_BASE = "https://api.github.com";
 // Generic GitHub API request. Returns response body as pretty-printed JSON string.
 async function githubRequest(token, method, path, body) {
-    try {
-        (0, runtime_1.emitNervesEvent)({
-            event: "client.request_start",
-            component: "clients",
-            message: "starting GitHub request",
-            meta: { client: "github", method, path },
-        });
-        const url = `${GITHUB_BASE}${path}`;
-        const opts = {
-            method,
-            headers: {
-                Authorization: `Bearer ${token}`,
-                Accept: "application/vnd.github+json",
-                "Content-Type": "application/json",
-            },
-        };
-        if (body)
-            opts.body = body;
-        const res = await fetch(url, opts);
-        if (!res.ok) {
-            (0, runtime_1.emitNervesEvent)({
-                level: "error",
-                event: "client.error",
-                component: "clients",
-                message: "GitHub request failed",
-                meta: { client: "github", method, path, status: res.status },
-            });
-            return (0, api_error_1.handleApiError)(res, "GitHub", "github");
-        }
-        const data = await res.json();
-        (0, runtime_1.emitNervesEvent)({
-            event: "client.request_end",
-            component: "clients",
-            message: "GitHub request completed",
-            meta: { client: "github", method, path, success: true },
-        });
-        return JSON.stringify(data, null, 2);
-    }
-    catch (err) {
-        (0, runtime_1.emitNervesEvent)({
-            level: "error",
-            event: "client.error",
-            component: "clients",
-            message: "GitHub request threw exception",
-            meta: {
-                client: "github",
-                method,
-                path,
-                reason: err instanceof Error ? err.message : String(err),
-            },
-        });
-        return (0, api_error_1.handleApiError)(err, "GitHub", "github");
-    }
+    return (0, api_client_1.apiRequest)({
+        baseUrl: GITHUB_BASE,
+        method,
+        path,
+        token,
+        clientName: "github",
+        serviceLabel: "GitHub",
+        connectionName: "github",
+        body,
+        extraHeaders: {
+            Accept: "application/vnd.github+json",
+        },
+    });
 }

package/dist/repertoire/graph-client.js

@@ -7,61 +7,20 @@ exports.graphRequest = graphRequest;
 exports.getProfile = getProfile;
 const api_error_1 = require("../heart/api-error");
 const runtime_1 = require("../nerves/runtime");
+const api_client_1 = require("./api-client");
 const GRAPH_BASE = "https://graph.microsoft.com/v1.0";
 // Generic Graph API request. Returns response body as pretty-printed JSON string.
 async function graphRequest(token, method, path, body) {
-    try {
-        (0, runtime_1.emitNervesEvent)({
-            event: "client.request_start",
-            component: "clients",
-            message: "starting Graph request",
-            meta: { client: "graph", method, path },
-        });
-        const url = `${GRAPH_BASE}${path}`;
-        const opts = {
-            method,
-            headers: {
-                Authorization: `Bearer ${token}`,
-                "Content-Type": "application/json",
-            },
-        };
-        if (body)
-            opts.body = body;
-        const res = await fetch(url, opts);
-        if (!res.ok) {
-            (0, runtime_1.emitNervesEvent)({
-                level: "error",
-                event: "client.error",
-                component: "clients",
-                message: "Graph request failed",
-                meta: { client: "graph", method, path, status: res.status },
-            });
-            return (0, api_error_1.handleApiError)(res, "Graph", "graph");
-        }
-        const data = await res.json();
-        (0, runtime_1.emitNervesEvent)({
-            event: "client.request_end",
-            component: "clients",
-            message: "Graph request completed",
-            meta: { client: "graph", method, path, success: true },
-        });
-        return JSON.stringify(data, null, 2);
-    }
-    catch (err) {
-        (0, runtime_1.emitNervesEvent)({
-            level: "error",
-            event: "client.error",
-            component: "clients",
-            message: "Graph request threw exception",
-            meta: {
-                client: "graph",
-                method,
-                path,
-                reason: err instanceof Error ? err.message : String(err),
-            },
-        });
-        return (0, api_error_1.handleApiError)(err, "Graph", "graph");
-    }
+    return (0, api_client_1.apiRequest)({
+        baseUrl: GRAPH_BASE,
+        method,
+        path,
+        token,
+        clientName: "graph",
+        serviceLabel: "Graph",
+        connectionName: "graph",
+        body,
+    });
 }
 // Backward-compatible thin wrapper: fetches /me and formats as human-readable text.
 async function getProfile(token) {

package/package.json

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