twining-mcp 1.3.0

package/dist/embeddings/embedder.d.ts

@@ -0,0 +1,24 @@
+export declare class Embedder {
+    private static instances;
+    private readonly twiningDir;
+    private pipeline;
+    private fallbackMode;
+    private initPromise;
+    constructor(twiningDir: string);
+    /** Get or create a singleton instance for a given twiningDir. */
+    static getInstance(twiningDir: string): Embedder;
+    /** Reset singleton instances (for testing). */
+    static resetInstances(): void;
+    /** Generate a 384-dimensional embedding for the given text. Returns null if in fallback mode. */
+    embed(text: string): Promise<number[] | null>;
+    /** Generate embeddings for multiple texts. Returns null for any that fail. */
+    embedBatch(texts: string[]): Promise<(number[] | null)[]>;
+    /** Whether the embedder has fallen back to keyword-only mode. */
+    isFallbackMode(): boolean;
+    /** Whether the pipeline has been initialized (for testing). */
+    isInitialized(): boolean;
+    /** Initialize the ONNX pipeline. Called lazily on first embed(). */
+    private initialize;
+    private doInitialize;
+}
+//# sourceMappingURL=embedder.d.ts.map

package/dist/embeddings/embedder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedder.d.ts","sourceRoot":"","sources":["../../src/embeddings/embedder.ts"],"names":[],"mappings":"AAaA,qBAAa,QAAQ;IACnB,OAAO,CAAC,MAAM,CAAC,SAAS,CAA+B;IAEvD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAA0C;IAC1D,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,WAAW,CAA8B;gBAErC,UAAU,EAAE,MAAM;IAI9B,iEAAiE;IACjE,MAAM,CAAC,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,QAAQ;IAQhD,+CAA+C;IAC/C,MAAM,CAAC,cAAc,IAAI,IAAI;IAI7B,iGAAiG;IAC3F,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC;IAsBnD,8EAA8E;IACxE,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;IAyB/D,iEAAiE;IACjE,cAAc,IAAI,OAAO;IAIzB,+DAA+D;IAC/D,aAAa,IAAI,OAAO;IAIxB,oEAAoE;YACtD,UAAU;YAWV,YAAY;CAqB3B"}

package/dist/embeddings/embedder.js

@@ -0,0 +1,109 @@
+/**
+ * Lazy-loaded singleton embedding pipeline using @huggingface/transformers.
+ * Uses all-MiniLM-L6-v2 (384 dimensions) via ONNX runtime.
+ * Falls back gracefully to keyword-only mode if ONNX fails.
+ */
+import path from "node:path";
+export class Embedder {
+    static instances = new Map();
+    twiningDir;
+    pipeline = null;
+    fallbackMode = false;
+    initPromise = null;
+    constructor(twiningDir) {
+        this.twiningDir = twiningDir;
+    }
+    /** Get or create a singleton instance for a given twiningDir. */
+    static getInstance(twiningDir) {
+        const existing = Embedder.instances.get(twiningDir);
+        if (existing)
+            return existing;
+        const instance = new Embedder(twiningDir);
+        Embedder.instances.set(twiningDir, instance);
+        return instance;
+    }
+    /** Reset singleton instances (for testing). */
+    static resetInstances() {
+        Embedder.instances.clear();
+    }
+    /** Generate a 384-dimensional embedding for the given text. Returns null if in fallback mode. */
+    async embed(text) {
+        if (this.fallbackMode)
+            return null;
+        if (!this.pipeline) {
+            await this.initialize();
+        }
+        if (this.fallbackMode || !this.pipeline)
+            return null;
+        try {
+            const output = await this.pipeline(text, {
+                pooling: "mean",
+                normalize: true,
+            });
+            return Array.from(output.data);
+        }
+        catch (error) {
+            // Transient embedding errors don't trigger fallback mode
+            console.error("[twining] Embedding error (non-fatal):", error);
+            return null;
+        }
+    }
+    /** Generate embeddings for multiple texts. Returns null for any that fail. */
+    async embedBatch(texts) {
+        if (this.fallbackMode)
+            return texts.map(() => null);
+        if (!this.pipeline) {
+            await this.initialize();
+        }
+        if (this.fallbackMode || !this.pipeline)
+            return texts.map(() => null);
+        const results = [];
+        for (const text of texts) {
+            try {
+                const output = await this.pipeline(text, {
+                    pooling: "mean",
+                    normalize: true,
+                });
+                results.push(Array.from(output.data));
+            }
+            catch (error) {
+                console.error("[twining] Batch embedding error (non-fatal):", error);
+                results.push(null);
+            }
+        }
+        return results;
+    }
+    /** Whether the embedder has fallen back to keyword-only mode. */
+    isFallbackMode() {
+        return this.fallbackMode;
+    }
+    /** Whether the pipeline has been initialized (for testing). */
+    isInitialized() {
+        return this.pipeline !== null || this.fallbackMode;
+    }
+    /** Initialize the ONNX pipeline. Called lazily on first embed(). */
+    async initialize() {
+        // Prevent concurrent initialization
+        if (this.initPromise) {
+            await this.initPromise;
+            return;
+        }
+        this.initPromise = this.doInitialize();
+        await this.initPromise;
+    }
+    async doInitialize() {
+        try {
+            // Dynamic import to avoid loading ONNX at module evaluation time
+            const { pipeline, env } = await import("@huggingface/transformers");
+            // Configure model cache within .twining/
+            env.cacheDir = path.join(this.twiningDir, "models");
+            // Create the feature extraction pipeline
+            this.pipeline = (await pipeline("feature-extraction", "Xenova/all-MiniLM-L6-v2"));
+        }
+        catch (error) {
+            console.error("[twining] ONNX embedding initialization failed. Falling back to keyword search:", error);
+            this.fallbackMode = true;
+        }
+    }
+}
+//# sourceMappingURL=embedder.js.map

package/dist/embeddings/embedder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedder.js","sourceRoot":"","sources":["../../src/embeddings/embedder.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,IAAI,MAAM,WAAW,CAAC;AAQ7B,MAAM,OAAO,QAAQ;IACX,MAAM,CAAC,SAAS,GAAG,IAAI,GAAG,EAAoB,CAAC;IAEtC,UAAU,CAAS;IAC5B,QAAQ,GAAqC,IAAI,CAAC;IAClD,YAAY,GAAG,KAAK,CAAC;IACrB,WAAW,GAAyB,IAAI,CAAC;IAEjD,YAAY,UAAkB;QAC5B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;IAED,iEAAiE;IACjE,MAAM,CAAC,WAAW,CAAC,UAAkB;QACnC,MAAM,QAAQ,GAAG,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACpD,IAAI,QAAQ;YAAE,OAAO,QAAQ,CAAC;QAC9B,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,UAAU,CAAC,CAAC;QAC1C,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QAC7C,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,+CAA+C;IAC/C,MAAM,CAAC,cAAc;QACnB,QAAQ,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IAC7B,CAAC;IAED,iGAAiG;IACjG,KAAK,CAAC,KAAK,CAAC,IAAY;QACtB,IAAI,IAAI,CAAC,YAAY;YAAE,OAAO,IAAI,CAAC;QAEnC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;QAC1B,CAAC;QAED,IAAI,IAAI,CAAC,YAAY,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAC;QAErD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE;gBACvC,OAAO,EAAE,MAAM;gBACf,SAAS,EAAE,IAAI;aAChB,CAAC,CAAC;YACH,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACjC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,yDAAyD;YACzD,OAAO,CAAC,KAAK,CAAC,wCAAwC,EAAE,KAAK,CAAC,CAAC;YAC/D,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,8EAA8E;IAC9E,KAAK,CAAC,UAAU,CAAC,KAAe;QAC9B,IAAI,IAAI,CAAC,YAAY;YAAE,OAAO,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;QAEpD,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;QAC1B,CAAC;QAED,IAAI,IAAI,CAAC,YAAY,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,OAAO,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;QAEtE,MAAM,OAAO,GAAwB,EAAE,CAAC;QACxC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE;oBACvC,OAAO,EAAE,MAAM;oBACf,SAAS,EAAE,IAAI;iBAChB,CAAC,CAAC;gBACH,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;YACxC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,KAAK,CAAC,8CAA8C,EAAE,KAAK,CAAC,CAAC;gBACrE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACrB,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,iEAAiE;IACjE,cAAc;QACZ,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED,+DAA+D;IAC/D,aAAa;QACX,OAAO,IAAI,CAAC,QAAQ,KAAK,IAAI,IAAI,IAAI,CAAC,YAAY,CAAC;IACrD,CAAC;IAED,oEAAoE;IAC5D,KAAK,CAAC,UAAU;QACtB,oCAAoC;QACpC,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,MAAM,IAAI,CAAC,WAAW,CAAC;YACvB,OAAO;QACT,CAAC;QAED,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;QACvC,MAAM,IAAI,CAAC,WAAW,CAAC;IACzB,CAAC;IAEO,KAAK,CAAC,YAAY;QACxB,IAAI,CAAC;YACH,iEAAiE;YACjE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,MAAM,MAAM,CAAC,2BAA2B,CAAC,CAAC;YAEpE,yCAAyC;YACzC,GAAG,CAAC,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;YAEpD,yCAAyC;YACzC,IAAI,CAAC,QAAQ,GAAG,CAAC,MAAM,QAAQ,CAC7B,oBAAoB,EACpB,yBAAyB,CAC1B,CAAyC,CAAC;QAC7C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CACX,iFAAiF,EACjF,KAAK,CACN,CAAC;YACF,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QAC3B,CAAC;IACH,CAAC"}

package/dist/embeddings/index-manager.d.ts

@@ -0,0 +1,27 @@
+/** Embedding index structure — spec section 5.3 */
+export interface EmbeddingIndex {
+    model: string;
+    dimension: number;
+    entries: {
+        id: string;
+        vector: number[];
+    }[];
+}
+export type IndexName = "blackboard" | "decisions";
+export declare class IndexManager {
+    private readonly embeddingsDir;
+    constructor(twiningDir: string);
+    /** Get the file path for a named index. */
+    private indexPath;
+    /** Load an embedding index. Returns empty index if file doesn't exist. */
+    load(indexName: IndexName): Promise<EmbeddingIndex>;
+    /** Save an embedding index atomically with file locking. */
+    save(indexName: IndexName, index: EmbeddingIndex): Promise<void>;
+    /** Add a single entry to an index. Loads, appends, saves atomically. */
+    addEntry(indexName: IndexName, id: string, vector: number[]): Promise<void>;
+    /** Remove entries by IDs from an index. */
+    removeEntries(indexName: IndexName, ids: string[]): Promise<void>;
+    /** Get a single vector by ID. Returns null if not found. */
+    getVector(indexName: IndexName, id: string): Promise<number[] | null>;
+}
+//# sourceMappingURL=index-manager.d.ts.map

package/dist/embeddings/index-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-manager.d.ts","sourceRoot":"","sources":["../../src/embeddings/index-manager.ts"],"names":[],"mappings":"AAUA,mDAAmD;AACnD,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE;QACP,EAAE,EAAE,MAAM,CAAC;QACX,MAAM,EAAE,MAAM,EAAE,CAAC;KAClB,EAAE,CAAC;CACL;AAaD,MAAM,MAAM,SAAS,GAAG,YAAY,GAAG,WAAW,CAAC;AAEnD,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;gBAE3B,UAAU,EAAE,MAAM;IAK9B,2CAA2C;IAC3C,OAAO,CAAC,SAAS;IAIjB,0EAA0E;IACpE,IAAI,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,cAAc,CAAC;IAoBzD,4DAA4D;IACtD,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBtE,wEAAwE;IAClE,QAAQ,CACZ,SAAS,EAAE,SAAS,EACpB,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,MAAM,EAAE,GACf,OAAO,CAAC,IAAI,CAAC;IA8BhB,2CAA2C;IACrC,aAAa,CAAC,SAAS,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBvE,4DAA4D;IACtD,SAAS,CACb,SAAS,EAAE,SAAS,EACpB,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC;CAK5B"}

package/dist/embeddings/index-manager.js

@@ -0,0 +1,115 @@
+/**
+ * Embedding index CRUD operations.
+ * JSON-based storage in .twining/embeddings/ with file locking.
+ * Matches spec section 5.3 index structure.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import lockfile from "proper-lockfile";
+import { ensureDir } from "../storage/file-store.js";
+const LOCK_OPTIONS = {
+    retries: { retries: 10, factor: 1.5, minTimeout: 50, maxTimeout: 1000 },
+    stale: 10000,
+};
+const DEFAULT_INDEX = {
+    model: "all-MiniLM-L6-v2",
+    dimension: 384,
+    entries: [],
+};
+export class IndexManager {
+    embeddingsDir;
+    constructor(twiningDir) {
+        this.embeddingsDir = path.join(twiningDir, "embeddings");
+        ensureDir(this.embeddingsDir);
+    }
+    /** Get the file path for a named index. */
+    indexPath(indexName) {
+        return path.join(this.embeddingsDir, `${indexName}.index`);
+    }
+    /** Load an embedding index. Returns empty index if file doesn't exist. */
+    async load(indexName) {
+        const filePath = this.indexPath(indexName);
+        if (!fs.existsSync(filePath)) {
+            return { ...DEFAULT_INDEX, entries: [] };
+        }
+        try {
+            const content = fs.readFileSync(filePath, "utf-8");
+            if (!content.trim()) {
+                return { ...DEFAULT_INDEX, entries: [] };
+            }
+            return JSON.parse(content);
+        }
+        catch {
+            console.error(`[twining] Corrupt embedding index ${indexName}, returning empty`);
+            return { ...DEFAULT_INDEX, entries: [] };
+        }
+    }
+    /** Save an embedding index atomically with file locking. */
+    async save(indexName, index) {
+        const filePath = this.indexPath(indexName);
+        // Ensure file exists for proper-lockfile
+        if (!fs.existsSync(filePath)) {
+            fs.writeFileSync(filePath, "");
+        }
+        const release = await lockfile.lock(filePath, LOCK_OPTIONS);
+        try {
+            fs.writeFileSync(filePath, JSON.stringify(index));
+        }
+        finally {
+            await release();
+        }
+    }
+    /** Add a single entry to an index. Loads, appends, saves atomically. */
+    async addEntry(indexName, id, vector) {
+        const filePath = this.indexPath(indexName);
+        // Ensure file exists for proper-lockfile
+        if (!fs.existsSync(filePath)) {
+            fs.writeFileSync(filePath, "");
+        }
+        const release = await lockfile.lock(filePath, LOCK_OPTIONS);
+        try {
+            // Read current index
+            const content = fs.readFileSync(filePath, "utf-8");
+            const index = content.trim() ? JSON.parse(content) : { ...DEFAULT_INDEX, entries: [] };
+            // Replace existing entry with same ID, or append
+            const existingIdx = index.entries.findIndex((e) => e.id === id);
+            if (existingIdx >= 0) {
+                index.entries[existingIdx] = { id, vector };
+            }
+            else {
+                index.entries.push({ id, vector });
+            }
+            // Write back
+            fs.writeFileSync(filePath, JSON.stringify(index));
+        }
+        finally {
+            await release();
+        }
+    }
+    /** Remove entries by IDs from an index. */
+    async removeEntries(indexName, ids) {
+        const filePath = this.indexPath(indexName);
+        if (!fs.existsSync(filePath))
+            return;
+        const release = await lockfile.lock(filePath, LOCK_OPTIONS);
+        try {
+            const content = fs.readFileSync(filePath, "utf-8");
+            if (!content.trim())
+                return;
+            const index = JSON.parse(content);
+            const idSet = new Set(ids);
+            index.entries = index.entries.filter((e) => !idSet.has(e.id));
+            fs.writeFileSync(filePath, JSON.stringify(index));
+        }
+        finally {
+            await release();
+        }
+    }
+    /** Get a single vector by ID. Returns null if not found. */
+    async getVector(indexName, id) {
+        const index = await this.load(indexName);
+        const entry = index.entries.find((e) => e.id === id);
+        return entry?.vector ?? null;
+    }
+}
+//# sourceMappingURL=index-manager.js.map

package/dist/embeddings/index-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-manager.js","sourceRoot":"","sources":["../../src/embeddings/index-manager.ts"],"names":[],"mappings":"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"}

package/dist/embeddings/search.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Semantic search with cosine similarity and keyword fallback.
+ * Uses embedder for vector search, falls back to term-frequency
+ * keyword search when ONNX is unavailable.
+ */
+import type { Embedder } from "./embedder.js";
+import type { IndexManager } from "./index-manager.js";
+import type { BlackboardEntry, Decision } from "../utils/types.js";
+export interface BlackboardSearchResult {
+    entry: BlackboardEntry;
+    relevance: number;
+}
+export interface DecisionSearchResult {
+    decision: Decision;
+    relevance: number;
+}
+export interface SearchResults<T> {
+    results: T[];
+    fallback_mode: boolean;
+}
+export declare class SearchEngine {
+    private readonly embedder;
+    private readonly indexManager;
+    constructor(embedder: Embedder, indexManager: IndexManager);
+    /** Search blackboard entries by semantic similarity or keyword fallback. */
+    searchBlackboard(query: string, entries: BlackboardEntry[], options?: {
+        entry_types?: string[];
+        limit?: number;
+    }): Promise<SearchResults<BlackboardSearchResult>>;
+    /** Search decisions by semantic similarity or keyword fallback. */
+    searchDecisions(query: string, decisions: Decision[], options?: {
+        limit?: number;
+    }): Promise<SearchResults<DecisionSearchResult>>;
+}
+/**
+ * Cosine similarity for pre-normalized vectors (dot product).
+ * Since all-MiniLM-L6-v2 outputs normalized vectors, cosine similarity
+ * simplifies to the dot product.
+ */
+export declare function cosineSimilarity(a: number[], b: number[]): number;
+/**
+ * Term-frequency based keyword search for fallback mode.
+ * Scores each item by how many query terms appear and how often.
+ */
+export declare function keywordSearch(query: string, items: {
+    id: string;
+    text: string;
+}[], limit: number): {
+    id: string;
+    score: number;
+}[];
+//# sourceMappingURL=search.d.ts.map

package/dist/embeddings/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/embeddings/search.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAEnE,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,eAAe,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,QAAQ,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,OAAO,EAAE,CAAC,EAAE,CAAC;IACb,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;IACpC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;gBAEhC,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,YAAY;IAK1D,4EAA4E;IACtE,gBAAgB,CACpB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,eAAe,EAAE,EAC1B,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GACnD,OAAO,CAAC,aAAa,CAAC,sBAAsB,CAAC,CAAC;IA4EjD,mEAAmE;IAC7D,eAAe,CACnB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,QAAQ,EAAE,EACrB,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAC3B,OAAO,CAAC,aAAa,CAAC,oBAAoB,CAAC,CAAC;CAmEhD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAOjE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,EACb,KAAK,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,EACrC,KAAK,EAAE,MAAM,GACZ;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,CAiCjC"}

package/dist/embeddings/search.js

@@ -0,0 +1,170 @@
+export class SearchEngine {
+    embedder;
+    indexManager;
+    constructor(embedder, indexManager) {
+        this.embedder = embedder;
+        this.indexManager = indexManager;
+    }
+    /** Search blackboard entries by semantic similarity or keyword fallback. */
+    async searchBlackboard(query, entries, options) {
+        const limit = options?.limit ?? 10;
+        let filtered = entries;
+        // Apply type filter
+        if (options?.entry_types && options.entry_types.length > 0) {
+            filtered = filtered.filter((e) => options.entry_types.includes(e.entry_type));
+        }
+        if (filtered.length === 0) {
+            return { results: [], fallback_mode: this.embedder.isFallbackMode() };
+        }
+        // Try semantic search first
+        if (!this.embedder.isFallbackMode()) {
+            const queryVector = await this.embedder.embed(query);
+            if (queryVector) {
+                const index = await this.indexManager.load("blackboard");
+                const vectorMap = new Map(index.entries.map((e) => [e.id, e.vector]));
+                const scored = [];
+                for (const entry of filtered) {
+                    const entryVector = vectorMap.get(entry.id);
+                    if (entryVector) {
+                        const relevance = cosineSimilarity(queryVector, entryVector);
+                        scored.push({ entry, relevance });
+                    }
+                    else {
+                        // Entry has no embedding — use keyword as individual fallback
+                        const text = entry.summary + " " + entry.detail;
+                        const kwResults = keywordSearch(query, [{ id: entry.id, text }], 1);
+                        const score = kwResults[0]?.score ?? 0;
+                        if (score > 0) {
+                            scored.push({ entry, relevance: score * 0.5 }); // Discount keyword scores
+                        }
+                    }
+                }
+                scored.sort((a, b) => b.relevance - a.relevance);
+                return {
+                    results: scored.slice(0, limit),
+                    fallback_mode: false,
+                };
+            }
+        }
+        // Keyword fallback
+        const items = filtered.map((e) => ({
+            id: e.id,
+            text: e.summary + " " + e.detail,
+        }));
+        const kwResults = keywordSearch(query, items, limit);
+        const idToScore = new Map(kwResults.map((r) => [r.id, r.score]));
+        const results = [];
+        for (const entry of filtered) {
+            const score = idToScore.get(entry.id);
+            if (score !== undefined && score > 0) {
+                results.push({ entry, relevance: score });
+            }
+        }
+        results.sort((a, b) => b.relevance - a.relevance);
+        return {
+            results: results.slice(0, limit),
+            fallback_mode: true,
+        };
+    }
+    /** Search decisions by semantic similarity or keyword fallback. */
+    async searchDecisions(query, decisions, options) {
+        const limit = options?.limit ?? 10;
+        if (decisions.length === 0) {
+            return { results: [], fallback_mode: this.embedder.isFallbackMode() };
+        }
+        // Try semantic search first
+        if (!this.embedder.isFallbackMode()) {
+            const queryVector = await this.embedder.embed(query);
+            if (queryVector) {
+                const index = await this.indexManager.load("decisions");
+                const vectorMap = new Map(index.entries.map((e) => [e.id, e.vector]));
+                const scored = [];
+                for (const decision of decisions) {
+                    const decisionVector = vectorMap.get(decision.id);
+                    if (decisionVector) {
+                        const relevance = cosineSimilarity(queryVector, decisionVector);
+                        scored.push({ decision, relevance });
+                    }
+                    else {
+                        const text = decision.summary + " " + decision.rationale + " " + decision.context;
+                        const kwResults = keywordSearch(query, [{ id: decision.id, text }], 1);
+                        const score = kwResults[0]?.score ?? 0;
+                        if (score > 0) {
+                            scored.push({ decision, relevance: score * 0.5 });
+                        }
+                    }
+                }
+                scored.sort((a, b) => b.relevance - a.relevance);
+                return {
+                    results: scored.slice(0, limit),
+                    fallback_mode: false,
+                };
+            }
+        }
+        // Keyword fallback
+        const items = decisions.map((d) => ({
+            id: d.id,
+            text: d.summary + " " + d.rationale + " " + d.context,
+        }));
+        const kwResults = keywordSearch(query, items, limit);
+        const idToScore = new Map(kwResults.map((r) => [r.id, r.score]));
+        const results = [];
+        for (const decision of decisions) {
+            const score = idToScore.get(decision.id);
+            if (score !== undefined && score > 0) {
+                results.push({ decision, relevance: score });
+            }
+        }
+        results.sort((a, b) => b.relevance - a.relevance);
+        return {
+            results: results.slice(0, limit),
+            fallback_mode: true,
+        };
+    }
+}
+/**
+ * Cosine similarity for pre-normalized vectors (dot product).
+ * Since all-MiniLM-L6-v2 outputs normalized vectors, cosine similarity
+ * simplifies to the dot product.
+ */
+export function cosineSimilarity(a, b) {
+    let sum = 0;
+    const len = Math.min(a.length, b.length);
+    for (let i = 0; i < len; i++) {
+        sum += a[i] * b[i];
+    }
+    return sum;
+}
+/**
+ * Term-frequency based keyword search for fallback mode.
+ * Scores each item by how many query terms appear and how often.
+ */
+export function keywordSearch(query, items, limit) {
+    const queryTerms = query
+        .toLowerCase()
+        .split(/\s+/)
+        .filter((t) => t.length > 0);
+    if (queryTerms.length === 0)
+        return [];
+    const results = [];
+    for (const item of items) {
+        const textLower = item.text.toLowerCase();
+        let score = 0;
+        for (const term of queryTerms) {
+            if (textLower.includes(term)) {
+                // Count occurrences with diminishing returns
+                const parts = textLower.split(term);
+                const matches = parts.length - 1;
+                score += Math.log(1 + matches);
+            }
+        }
+        // Normalize by number of query terms
+        const normalizedScore = score / queryTerms.length;
+        if (normalizedScore > 0) {
+            results.push({ id: item.id, score: normalizedScore });
+        }
+    }
+    results.sort((a, b) => b.score - a.score);
+    return results.slice(0, limit);
+}
+//# sourceMappingURL=search.js.map

package/dist/embeddings/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/embeddings/search.ts"],"names":[],"mappings":"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"}

package/dist/engine/archiver.d.ts

@@ -0,0 +1,28 @@
+import type { BlackboardStore } from "../storage/blackboard-store.js";
+import type { BlackboardEngine } from "./blackboard.js";
+import type { IndexManager } from "../embeddings/index-manager.js";
+export declare class Archiver {
+    private readonly twiningDir;
+    private readonly blackboardStore;
+    private readonly blackboardEngine;
+    private readonly indexManager;
+    constructor(twiningDir: string, blackboardStore: BlackboardStore, blackboardEngine: BlackboardEngine, indexManager: IndexManager | null);
+    /**
+     * Archive old blackboard entries.
+     * Decision entries are never archived (LIFE-03).
+     * Archived entries are moved to archive/{YYYY-MM-DD}-blackboard.jsonl.
+     * Optionally posts a summary finding (LIFE-02).
+     */
+    archive(options?: {
+        before?: string;
+        keep_decisions?: boolean;
+        summarize?: boolean;
+    }): Promise<{
+        archived_count: number;
+        archive_file: string;
+        summary?: string;
+    }>;
+    /** Build a human-readable summary of archived entries. */
+    private buildSummary;
+}
+//# sourceMappingURL=archiver.d.ts.map

package/dist/engine/archiver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"archiver.d.ts","sourceRoot":"","sources":["../../src/engine/archiver.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAQnE,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkB;IAClD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAmB;IACpD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAsB;gBAGjD,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,eAAe,EAChC,gBAAgB,EAAE,gBAAgB,EAClC,YAAY,EAAE,YAAY,GAAG,IAAI;IAQnC;;;;;OAKG;IACG,OAAO,CAAC,OAAO,CAAC,EAAE;QACtB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,SAAS,CAAC,EAAE,OAAO,CAAC;KACrB,GAAG,OAAO,CAAC;QACV,cAAc,EAAE,MAAM,CAAC;QACvB,YAAY,EAAE,MAAM,CAAC;QACrB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IA0GF,0DAA0D;IAC1D,OAAO,CAAC,YAAY;CA8BrB"}