@backendkit-labs/agent-enterprise 0.3.6 → 0.4.1

package/dist/rag/SimpleEmbedder.d.ts

@@ -5,19 +5,41 @@
  *   1. Tokenising text into lowercase alphanumeric tokens
  *   2. Mapping each token to a bucket via djb2 hash % DIMS
  *   3. Accumulating term-frequency counts in the bucket
- *   4. L2-normalising to a unit vector
+ *   4. Weighting each bucket by inverse document frequency (rarer buckets score higher)
+ *   5. L2-normalising to a unit vector
  *
  * Not semantically equivalent to transformer embeddings, but clusters texts
  * with shared vocabulary close together — sufficient to find notes whose
- * content matches the query's key terms.
+ * content matches the query's key terms, and the IDF term keeps common
+ * words (the, and, sistema, ...) from drowning out the words that actually
+ * distinguish one note from another.
  *
  * Use this when Ollama is not available (dev, CI, pilot). For production,
  * prefer OllamaEmbedder with nomic-embed-text for semantic accuracy.
  */
 import type { Embedder } from './ObsidianRAGProvider';
 export declare class SimpleEmbedder implements Embedder {
+    private readonly statsPath?;
     readonly model = "simple-tfidf-256";
+    private docCount;
+    private readonly docFreq;
+    private loaded;
+    /**
+     * @param statsPath Optional path to persist document-frequency stats across
+     * process restarts. Without it, IDF starts fresh (pure TF) every time the
+     * process starts and improves as more text gets embedded during that run.
+     */
+    constructor(statsPath?: string | undefined);
+    private ensureLoaded;
+    private persist;
+    /** Smoothed IDF — always positive, well-defined even when a bucket has never been seen (df=0). */
+    private idf;
+    private vectorise;
+    /** Registers `text` as a corpus document (updates docFreq/docCount), then vectorises it against the updated stats. */
+    private observe;
+    /** Indexing path — each text counts toward the corpus's document-frequency stats. */
     embed(texts: string[]): Promise<number[][]>;
+    /** Query path — a search query is not a new corpus document, so it's weighted read-only against current stats, never counted. */
     embedOne(text: string): Promise<number[]>;
 }
 //# sourceMappingURL=SimpleEmbedder.d.ts.map

package/dist/rag/SimpleEmbedder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SimpleEmbedder.d.ts","sourceRoot":"","sources":["../../src/rag/SimpleEmbedder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAyCtD,qBAAa,cAAe,YAAW,QAAQ;IAC3C,QAAQ,CAAC,KAAK,sBAAsB;IAE9B,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;IAI3C,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CAGlD"}
+{"version":3,"file":"SimpleEmbedder.d.ts","sourceRoot":"","sources":["../../src/rag/SimpleEmbedder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AA4BtD,qBAAa,cAAe,YAAW,QAAQ;IAY/B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;IAXvC,QAAQ,CAAC,KAAK,sBAAsB;IAEpC,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;IACrD,OAAO,CAAC,MAAM,CAAS;IAEvB;;;;OAIG;gBAC0B,SAAS,CAAC,EAAE,MAAM,YAAA;YAEjC,YAAY;YAgBZ,OAAO;IAUrB,kGAAkG;IAClG,OAAO,CAAC,GAAG;IAKX,OAAO,CAAC,SAAS;IAuBjB,sHAAsH;IACtH,OAAO,CAAC,OAAO;IAOf,qFAAqF;IAC/E,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;IAOjD,iIAAiI;IAC3H,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CAIlD"}

package/dist/rag/SimpleEmbedder.js

@@ -6,17 +6,54 @@
  *   1. Tokenising text into lowercase alphanumeric tokens
  *   2. Mapping each token to a bucket via djb2 hash % DIMS
  *   3. Accumulating term-frequency counts in the bucket
- *   4. L2-normalising to a unit vector
+ *   4. Weighting each bucket by inverse document frequency (rarer buckets score higher)
+ *   5. L2-normalising to a unit vector
  *
  * Not semantically equivalent to transformer embeddings, but clusters texts
  * with shared vocabulary close together — sufficient to find notes whose
- * content matches the query's key terms.
+ * content matches the query's key terms, and the IDF term keeps common
+ * words (the, and, sistema, ...) from drowning out the words that actually
+ * distinguish one note from another.
  *
  * Use this when Ollama is not available (dev, CI, pilot). For production,
  * prefer OllamaEmbedder with nomic-embed-text for semantic accuracy.
  */
+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.SimpleEmbedder = void 0;
+const fs = __importStar(require("fs/promises"));
 const DIMS = 256;
 function djb2(str) {
     let h = 5381;
@@ -33,32 +70,94 @@ function tokenise(text) {
         .split(/[^a-z0-9]+/)
         .filter(t => t.length > 2); // skip 1-2 char noise tokens
 }
-function vectorise(text) {
-    const vec = new Array(DIMS).fill(0);
-    const tokens = tokenise(text);
-    if (tokens.length === 0)
+class SimpleEmbedder {
+    statsPath;
+    model = 'simple-tfidf-256';
+    docCount = 0;
+    docFreq = new Map();
+    loaded = false;
+    /**
+     * @param statsPath Optional path to persist document-frequency stats across
+     * process restarts. Without it, IDF starts fresh (pure TF) every time the
+     * process starts and improves as more text gets embedded during that run.
+     */
+    constructor(statsPath) {
+        this.statsPath = statsPath;
+    }
+    async ensureLoaded() {
+        if (this.loaded)
+            return;
+        this.loaded = true;
+        if (!this.statsPath)
+            return;
+        try {
+            const raw = await fs.readFile(this.statsPath, 'utf-8');
+            const data = JSON.parse(raw);
+            this.docCount = data.docCount;
+            for (const [bucket, count] of Object.entries(data.docFreq)) {
+                this.docFreq.set(Number(bucket), count);
+            }
+        }
+        catch {
+            // No stats file yet — start fresh.
+        }
+    }
+    async persist() {
+        if (!this.statsPath)
+            return;
+        const data = {
+            version: 1,
+            docCount: this.docCount,
+            docFreq: Object.fromEntries(this.docFreq),
+        };
+        await fs.writeFile(this.statsPath, JSON.stringify(data), 'utf-8');
+    }
+    /** Smoothed IDF — always positive, well-defined even when a bucket has never been seen (df=0). */
+    idf(bucket) {
+        const df = this.docFreq.get(bucket) ?? 0;
+        return Math.log((this.docCount + 1) / (df + 1)) + 1;
+    }
+    vectorise(text) {
+        const vec = new Array(DIMS).fill(0);
+        const tokens = tokenise(text);
+        if (tokens.length === 0)
+            return vec;
+        for (const t of tokens) {
+            vec[djb2(t) % DIMS] += 1;
+        }
+        // Weight each occupied bucket by IDF, then L2-normalise.
+        let norm = 0;
+        for (let i = 0; i < DIMS; i++) {
+            if (vec[i] > 0)
+                vec[i] *= this.idf(i);
+            norm += vec[i] * vec[i];
+        }
+        norm = Math.sqrt(norm);
+        if (norm > 0) {
+            for (let i = 0; i < DIMS; i++)
+                vec[i] /= norm;
+        }
         return vec;
-    for (const t of tokens) {
-        vec[djb2(t) % DIMS] += 1;
     }
-    // L2 normalise
-    let norm = 0;
-    for (const v of vec)
-        norm += v * v;
-    norm = Math.sqrt(norm);
-    if (norm > 0) {
-        for (let i = 0; i < DIMS; i++)
-            vec[i] /= norm;
+    /** Registers `text` as a corpus document (updates docFreq/docCount), then vectorises it against the updated stats. */
+    observe(text) {
+        const buckets = new Set(tokenise(text).map(t => djb2(t) % DIMS));
+        for (const b of buckets)
+            this.docFreq.set(b, (this.docFreq.get(b) ?? 0) + 1);
+        this.docCount++;
+        return this.vectorise(text);
     }
-    return vec;
-}
-class SimpleEmbedder {
-    model = 'simple-tfidf-256';
+    /** Indexing path — each text counts toward the corpus's document-frequency stats. */
     async embed(texts) {
-        return texts.map(vectorise);
+        await this.ensureLoaded();
+        const vectors = texts.map(t => this.observe(t));
+        await this.persist();
+        return vectors;
     }
+    /** Query path — a search query is not a new corpus document, so it's weighted read-only against current stats, never counted. */
     async embedOne(text) {
-        return vectorise(text);
+        await this.ensureLoaded();
+        return this.vectorise(text);
     }
 }
 exports.SimpleEmbedder = SimpleEmbedder;

package/dist/rag/SimpleEmbedder.js.map

@@ -1 +1 @@
-{"version":3,"file":"SimpleEmbedder.js","sourceRoot":"","sources":["../../src/rag/SimpleEmbedder.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;GAeG;;;AAIH,MAAM,IAAI,GAAG,GAAG,CAAC;AAEjB,SAAS,IAAI,CAAC,GAAW;IACrB,IAAI,CAAC,GAAG,IAAI,CAAC;IACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AACvB,CAAC;AAED,SAAS,QAAQ,CAAC,IAAY;IAC1B,OAAO,IAAI;SACN,WAAW,EAAE;SACb,SAAS,CAAC,KAAK,CAAC;SAChB,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAG,mBAAmB;SAC3C,KAAK,CAAC,YAAY,CAAC;SACnB,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAS,6BAA6B;AACzE,CAAC;AAED,SAAS,SAAS,CAAC,IAAY;IAC3B,MAAM,GAAG,GAAG,IAAI,KAAK,CAAS,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC;IAEpC,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACrB,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IAED,eAAe;IACf,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,KAAK,MAAM,CAAC,IAAI,GAAG;QAAE,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC;IACnC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;QACX,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE;YAAE,GAAG,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;IAClD,CAAC;IAED,OAAO,GAAG,CAAC;AACf,CAAC;AAED,MAAa,cAAc;IACd,KAAK,GAAG,kBAAkB,CAAC;IAEpC,KAAK,CAAC,KAAK,CAAC,KAAe;QACvB,OAAO,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,IAAY;QACvB,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;CACJ;AAVD,wCAUC"}
+{"version":3,"file":"SimpleEmbedder.js","sourceRoot":"","sources":["../../src/rag/SimpleEmbedder.ts"],"names":[],"mappings":"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"}

package/dist/rag/VaultWriter.d.ts

@@ -19,6 +19,9 @@ export interface WriteNoteParams {
  * Notes use standard YAML frontmatter so the VaultIndexer picks them up
  * on the next incremental index() call, making them immediately searchable
  * by any agent or human that queries the vault.
+ *
+ * Concurrent writes are serialized with a per-file lock (wx atomic open)
+ * so multiple agents writing simultaneously cannot corrupt each other's notes.
  */
 export declare class VaultWriter {
     private readonly vaultPath;

package/dist/rag/VaultWriter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"VaultWriter.d.ts","sourceRoot":"","sources":["../../src/rag/VaultWriter.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAElE,MAAM,WAAW,kBAAkB;IAC/B,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED;;;;;;GAMG;AACH,qBAAa,WAAW;IACpB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;gBAEzB,IAAI,EAAE,kBAAkB;IAK9B,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC;IAuCzD;;;OAGG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc;CAgC9C"}
+{"version":3,"file":"VaultWriter.d.ts","sourceRoot":"","sources":["../../src/rag/VaultWriter.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAElE,MAAM,WAAW,kBAAkB;IAC/B,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED;;;;;;;;;GASG;AACH,qBAAa,WAAW;IACpB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAW;IACrC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;gBAEzB,IAAI,EAAE,kBAAkB;IAK9B,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC;IAwBzD;;;OAGG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc;CAgC9C"}

package/dist/rag/VaultWriter.js

@@ -43,6 +43,9 @@ const agent_core_1 = require("@backendkit-labs/agent-core");
  * Notes use standard YAML frontmatter so the VaultIndexer picks them up
  * on the next incremental index() call, making them immediately searchable
  * by any agent or human that queries the vault.
+ *
+ * Concurrent writes are serialized with a per-file lock (wx atomic open)
+ * so multiple agents writing simultaneously cannot corrupt each other's notes.
  */
 class VaultWriter {
     vaultPath;
@@ -65,24 +68,9 @@ class VaultWriter {
         const filename = `${date}-${slug}.md`;
         const dir = path.join(this.vaultPath, this.agentFolder);
         await fs.mkdir(dir, { recursive: true });
-        const tagsLine = tags.length
-            ? `[${tags.map(t => `"${t}"`).join(', ')}]`
-            : '[]';
-        const lines = [
-            '---',
-            `title: "${title}"`,
-            `author: "agent/${agentId}"`,
-            `date: ${date}`,
-            `tags: ${tagsLine}`,
-        ];
-        if (description)
-            lines.push(`description: "${description}"`);
-        if (related_notes.length) {
-            lines.push(`related_notes: [${related_notes.map(n => `"${n}"`).join(', ')}]`);
-        }
-        lines.push('---', '', content);
         const filePath = path.join(dir, filename);
-        await fs.writeFile(filePath, lines.join('\n'), 'utf-8');
+        const body = buildNote({ title, content, agentId, tags, description, related_notes, date });
+        await withFileLock(filePath, () => fs.writeFile(filePath, body, 'utf-8'));
         return filePath;
     }
     /**
@@ -114,4 +102,62 @@ class VaultWriter {
     }
 }
 exports.VaultWriter = VaultWriter;
+// ── Helpers ───────────────────────────────────────────────────────────────────
+function buildNote(p) {
+    const tagsLine = p.tags?.length
+        ? `[${p.tags.map(t => `"${t}"`).join(', ')}]`
+        : '[]';
+    const lines = [
+        '---',
+        `title: "${p.title}"`,
+        `author: "agent/${p.agentId}"`,
+        `date: ${p.date}`,
+        `tags: ${tagsLine}`,
+    ];
+    if (p.description)
+        lines.push(`description: "${p.description}"`);
+    if (p.related_notes?.length) {
+        lines.push(`related_notes: [${p.related_notes.map(n => `"${n}"`).join(', ')}]`);
+    }
+    lines.push('---', '', p.content);
+    return lines.join('\n');
+}
+/**
+ * Serialize writes to the same file path using an adjacent .lock file.
+ * Uses O_EXCL (wx flag) for atomic creation — only one process/coroutine
+ * can hold the lock at a time. Retries with exponential backoff.
+ */
+async function withFileLock(filePath, fn) {
+    const lockPath = `${filePath}.lock`;
+    const maxRetries = 10;
+    const baseDelay = 50;
+    let fd = null;
+    for (let attempt = 0; attempt < maxRetries; attempt++) {
+        try {
+            // wx = O_WRONLY | O_CREAT | O_EXCL — fails atomically if lock exists
+            fd = await fs.open(lockPath, 'wx');
+            break;
+        }
+        catch {
+            if (attempt < maxRetries - 1) {
+                await sleep(baseDelay * 2 ** attempt + Math.random() * baseDelay);
+            }
+            else {
+                throw new Error(`Could not acquire lock for ${path.basename(filePath)} after ${maxRetries} attempts`);
+            }
+        }
+    }
+    try {
+        return await fn();
+    }
+    finally {
+        if (fd) {
+            await fd.close().catch(() => { });
+            await fs.unlink(lockPath).catch(() => { });
+        }
+    }
+}
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
 //# sourceMappingURL=VaultWriter.js.map

package/dist/rag/VaultWriter.js.map

@@ -1 +1 @@
-{"version":3,"file":"VaultWriter.js","sourceRoot":"","sources":["../../src/rag/VaultWriter.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"VaultWriter.js","sourceRoot":"","sources":["../../src/rag/VaultWriter.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,gDAAoC;AAEpC,2CAA6B;AAC7B,4DAA4D;AAmB5D;;;;;;;;;GASG;AACH,MAAa,WAAW;IACH,SAAS,CAAW;IACpB,WAAW,CAAS;IAErC,YAAY,IAAwB;QAChC,IAAI,CAAC,SAAS,GAAK,IAAI,CAAC,SAAS,CAAC;QAClC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI,SAAS,CAAC;IACrD,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,MAAuB;QACnC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,GAAG,EAAE,EAAE,WAAW,GAAG,EAAE,EAAE,aAAa,GAAG,EAAE,EAAE,GAAG,MAAM,CAAC;QAE5F,MAAM,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACnD,MAAM,IAAI,GAAG,KAAK;aACb,WAAW,EAAE;aACb,SAAS,CAAC,KAAK,CAAC;aAChB,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;aACrB,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC;aAC5B,IAAI,EAAE;aACN,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;aACpB,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAElB,MAAM,QAAQ,GAAG,GAAG,IAAI,IAAI,IAAI,KAAK,CAAC;QACtC,MAAM,GAAG,GAAQ,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QAC7D,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAEzC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QAC1C,MAAM,IAAI,GAAO,SAAS,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAEhG,MAAM,YAAY,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;QAC1E,OAAO,QAAQ,CAAC;IACpB,CAAC;IAED;;;OAGG;IACH,UAAU,CAAC,OAAe;QACtB,MAAM,IAAI,GAAG,IAAI,CAAC;QAClB,OAAO,IAAA,uBAAU,EAAC;YACd,IAAI,EAAE,iBAAiB;YACvB,WAAW,EACP,iEAAiE;gBACjE,8EAA8E;gBAC9E,oDAAoD;gBACpD,6EAA6E;YACjF,KAAK,EAAE,cAAC,CAAC,MAAM,CAAC;gBACZ,KAAK,EAAE,cAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;gBAClE,OAAO,EAAE,cAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CACxB,uDAAuD;oBACvD,0DAA0D,CAC7D;gBACD,IAAI,EAAE,cAAC,CAAC,KAAK,CAAC,cAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAC1C,4EAA4E,CAC/E;gBACD,WAAW,EAAE,cAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CACvC,0CAA0C,CAC7C;gBACD,aAAa,EAAE,cAAC,CAAC,KAAK,CAAC,cAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CACnD,wFAAwF;oBACxF,uFAAuF,CAC1F;aACJ,CAAC;YACF,OAAO,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,aAAa,EAAE,EAAE,EAAE;gBACpE,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,aAAa,EAAE,CAAC,CAAC;gBACrG,OAAO,6BAA6B,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YAClE,CAAC;SACJ,CAAC,CAAC;IACP,CAAC;CACJ;AArED,kCAqEC;AAED,iFAAiF;AAEjF,SAAS,SAAS,CAAC,CAAqC;IACpD,MAAM,QAAQ,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM;QAC3B,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;QAC7C,CAAC,CAAC,IAAI,CAAC;IAEX,MAAM,KAAK,GAAa;QACpB,KAAK;QACL,WAAW,CAAC,CAAC,KAAK,GAAG;QACrB,kBAAkB,CAAC,CAAC,OAAO,GAAG;QAC9B,SAAS,CAAC,CAAC,IAAI,EAAE;QACjB,SAAS,QAAQ,EAAE;KACtB,CAAC;IACF,IAAI,CAAC,CAAC,WAAW;QAAE,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC;IACjE,IAAI,CAAC,CAAC,aAAa,EAAE,MAAM,EAAE,CAAC;QAC1B,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACpF,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;IACjC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED;;;;GAIG;AACH,KAAK,UAAU,YAAY,CAAI,QAAgB,EAAE,EAAoB;IACjE,MAAM,QAAQ,GAAK,GAAG,QAAQ,OAAO,CAAC;IACtC,MAAM,UAAU,GAAG,EAAE,CAAC;IACtB,MAAM,SAAS,GAAI,EAAE,CAAC;IAEtB,IAAI,EAAE,GAAsC,IAAI,CAAC;IAEjD,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC;QACpD,IAAI,CAAC;YACD,qEAAqE;YACrE,EAAE,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;YACnC,MAAM;QACV,CAAC;QAAC,MAAM,CAAC;YACL,IAAI,OAAO,GAAG,UAAU,GAAG,CAAC,EAAE,CAAC;gBAC3B,MAAM,KAAK,CAAC,SAAS,GAAG,CAAC,IAAI,OAAO,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;YACtE,CAAC;iBAAM,CAAC;gBACJ,MAAM,IAAI,KAAK,CAAC,8BAA8B,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,UAAU,UAAU,WAAW,CAAC,CAAC;YAC1G,CAAC;QACL,CAAC;IACL,CAAC;IAED,IAAI,CAAC;QACD,OAAO,MAAM,EAAE,EAAE,CAAC;IACtB,CAAC;YAAS,CAAC;QACP,IAAI,EAAE,EAAE,CAAC;YACL,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YACjC,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAC9C,CAAC;IACL,CAAC;AACL,CAAC;AAED,SAAS,KAAK,CAAC,EAAU;IACrB,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC"}

package/dist/reflection/EnterpriseReflection.d.ts

@@ -0,0 +1,108 @@
+import type { FailureRecord, DetectedPattern, ManifestPolicyRule } from '@backendkit-labs/agent-core/reflection';
+import type { GateRecord } from '../flow/ComplianceGate.js';
+export interface EnterpriseReflectionOptions {
+    /** Absolute path to the Obsidian vault. Generated manifest lives inside it. */
+    vaultPath: string;
+    /**
+     * App name for the catalog scope.
+     * MUST differ from 'deepseek-code' to avoid collision with the coding agent.
+     * Default: 'bk-enterprise'
+     */
+    appName?: string;
+    /**
+     * Override path for manifest.yaml.
+     * Default: {vaultPath}/politicas/_generated/manifest.yaml
+     */
+    manifestPath?: string;
+}
+export interface PendingPromotion {
+    pattern: DetectedPattern;
+    detectedAt: string;
+}
+/**
+ * Adapter that wires the ReflectionEngine (from agent-core, built for coding
+ * agents) to enterprise business agents — without modifying agent-core.
+ *
+ * Key differences vs the coding-agent usage:
+ *   - Isolated catalog: appName='bk-enterprise', useGlobalDir=false
+ *   - autoPromote=false: every promotion requires human approval
+ *   - Threshold by severity: critical=1, high=2, medium/low=3
+ *   - Source of incidents: ComplianceGate (evaluator≠executor guaranteed)
+ *   - manifest.yaml lives inside the vault (auditable, versionable via git)
+ */
+export declare class EnterpriseReflection {
+    private readonly engine;
+    private readonly registry;
+    private readonly manifestPath;
+    private readonly activeDomains;
+    private initialized;
+    private readonly pendingMap;
+    constructor(opts: EnterpriseReflectionOptions);
+    /**
+     * Must be called once before any other method.
+     * Registers enterprise domains in the DomainRegistry and initializes
+     * the engine catalog from disk.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Records the outcome of a resolved ComplianceGate.
+     * Only failed criteria and process violations generate incidents.
+     * Passed gates produce no catalog entries.
+     */
+    recordGateOutcome(record: GateRecord): Promise<FailureRecord[]>;
+    /**
+     * Scans for patterns using per-severity thresholds.
+     * Does NOT promote — patterns accumulate in pendingPromotions() for human review.
+     */
+    detect(domain?: string): Promise<DetectedPattern[]>;
+    /**
+     * Returns patterns that crossed the promotion threshold but haven't been
+     * promoted yet (autoPromote=false). Show these to the human approver.
+     */
+    pendingPromotions(): Promise<PendingPromotion[]>;
+    /**
+     * Promotes a detected pattern to a deterministic policyRule in manifest.yaml.
+     * Requires an explicit approver identity — logged in the manifest metadata.
+     *
+     * After approval the pattern is removed from pendingPromotions().
+     */
+    approvePromotion(pattern: DetectedPattern, approver: string): Promise<ManifestPolicyRule>;
+    /**
+     * Rejects a promotion — removes from pending without writing to manifest.
+     * The reason is stored as a resolved-but-not-promoted audit note.
+     */
+    rejectPromotion(pattern: DetectedPattern, approver: string, reason: string): Promise<void>;
+    /**
+     * Returns active policyRules from manifest.yaml, optionally filtered by domain.
+     * Call this BEFORE executing a step to inject deterministic constraints.
+     */
+    activeRules(filter?: {
+        domain?: string;
+    }): Promise<ManifestPolicyRule[]>;
+    /**
+     * Records whether applying a rule led to a successful or failed outcome.
+     * Outcomes feed demotionCandidates() — rules with many failures signal
+     * that the rule itself may be wrong.
+     */
+    recordRuleOutcome(ruleId: string, outcome: 'success' | 'failure'): Promise<void>;
+    /**
+     * Returns rules whose failure rate exceeds minFailureRatio (default 0.5)
+     * with at least minTotal applications (default 4).
+     *
+     * These are candidates for human-gated demotion — symmetric with promotion:
+     * the rulebook only changes in either direction with human approval.
+     */
+    demotionCandidates(opts?: {
+        minFailureRatio?: number;
+        minTotal?: number;
+    }): Promise<ManifestPolicyRule[]>;
+    /**
+     * Removes a rule from manifest.yaml after human approval of demotion.
+     * Symmetric with approvePromotion — requires explicit approver.
+     */
+    approveDemotion(ruleId: string, approver: string, reason: string): Promise<boolean>;
+    stats(): Promise<import("@backendkit-labs/agent-core").ReflectionStats>;
+    private assertInitialized;
+    private annotateApproval;
+}
+//# sourceMappingURL=EnterpriseReflection.d.ts.map

package/dist/reflection/EnterpriseReflection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EnterpriseReflection.d.ts","sourceRoot":"","sources":["../../src/reflection/EnterpriseReflection.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AACjH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAM5D,MAAM,WAAW,2BAA2B;IACxC,+EAA+E;IAC/E,SAAS,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,gBAAgB;IAC7B,OAAO,EAAI,eAAe,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;CACtB;AAID;;;;;;;;;;GAUG;AACH,qBAAa,oBAAoB;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0B;IACjD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsB;IAC/C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAU;IACvC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAW;IACzC,OAAO,CAAU,WAAW,CAAY;IAIxC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAuC;gBAEtD,IAAI,EAAE,2BAA2B;IA0B7C;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAuBjC;;;;OAIG;IACG,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAQrE;;;OAGG;IACG,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IA+BzD;;;OAGG;IACG,iBAAiB,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAOtD;;;;;OAKG;IACG,gBAAgB,CAAC,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAgB/F;;;OAGG;IACG,eAAe,CACjB,OAAO,EAAG,eAAe,EACzB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAI,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC;IAoBhB;;;OAGG;IACG,WAAW,CAAC,MAAM,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAQ9E;;;;OAIG;IACG,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAKtF;;;;;;OAMG;IACG,kBAAkB,CAAC,IAAI,GAAE;QAAE,eAAe,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAanH;;;OAGG;IACG,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAsBnF,KAAK;IAOX,OAAO,CAAC,iBAAiB;YAMX,gBAAgB;CAgBjC"}