driftdetect-cortex 0.9.41

package/dist/embeddings/cache/l2-sqlite.js

@@ -0,0 +1,308 @@
+/**
+ * L2 SQLite Cache
+ *
+ * Persistent SQLite cache for computed embeddings.
+ * Slower than L1 but survives restarts.
+ *
+ * @module embeddings/cache/l2-sqlite
+ */
+/**
+ * Default configuration
+ */
+const DEFAULT_CONFIG = {
+    tableName: 'embedding_cache',
+    maxEntries: 100000,
+    ttl: 0, // No expiry by default
+};
+/**
+ * L2 SQLite Cache for persistent embedding storage
+ */
+export class L2SQLiteCache {
+    db = null;
+    config;
+    hits = 0;
+    misses = 0;
+    _initialized = false;
+    constructor(config) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    /**
+     * Initialize with database connection
+     */
+    async initialize(db) {
+        this.db = db;
+        await this.ensureTable();
+        this._initialized = true;
+    }
+    /**
+     * Check if cache is initialized
+     */
+    get initialized() {
+        return this._initialized;
+    }
+    /**
+     * Get embedding from cache
+     */
+    async get(hash) {
+        if (!this.db)
+            return null;
+        try {
+            const row = this.db.prepare(`
+        SELECT embedding, created_at FROM ${this.config.tableName}
+        WHERE hash = ?
+      `).get(hash);
+            if (!row) {
+                this.misses++;
+                return null;
+            }
+            // Check TTL
+            if (this.config.ttl > 0) {
+                const createdAt = new Date(row.created_at).getTime();
+                if (Date.now() - createdAt > this.config.ttl) {
+                    await this.delete(hash);
+                    this.misses++;
+                    return null;
+                }
+            }
+            // Update access time
+            this.db.prepare(`
+        UPDATE ${this.config.tableName}
+        SET last_access = datetime('now'), access_count = access_count + 1
+        WHERE hash = ?
+      `).run(hash);
+            this.hits++;
+            return this.deserializeEmbedding(row.embedding);
+        }
+        catch {
+            this.misses++;
+            return null;
+        }
+    }
+    /**
+     * Set embedding in cache
+     */
+    async set(hash, embedding) {
+        if (!this.db)
+            return;
+        try {
+            // Check capacity
+            if (this.config.maxEntries > 0) {
+                const count = this.getCount();
+                if (count >= this.config.maxEntries) {
+                    await this.evictLRU(Math.ceil(this.config.maxEntries * 0.1)); // Evict 10%
+                }
+            }
+            const serialized = this.serializeEmbedding(embedding);
+            this.db.prepare(`
+        INSERT OR REPLACE INTO ${this.config.tableName}
+        (hash, embedding, dimensions, created_at, last_access, access_count)
+        VALUES (?, ?, ?, datetime('now'), datetime('now'), 1)
+      `).run(hash, serialized, embedding.length);
+        }
+        catch (error) {
+            console.error('L2 cache set error:', error);
+        }
+    }
+    /**
+     * Check if hash exists in cache
+     */
+    async has(hash) {
+        if (!this.db)
+            return false;
+        try {
+            const row = this.db.prepare(`
+        SELECT 1 FROM ${this.config.tableName} WHERE hash = ?
+      `).get(hash);
+            return !!row;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Delete entry from cache
+     */
+    async delete(hash) {
+        if (!this.db)
+            return false;
+        try {
+            const result = this.db.prepare(`
+        DELETE FROM ${this.config.tableName} WHERE hash = ?
+      `).run(hash);
+            return result.changes > 0;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Clear all entries
+     */
+    async clear() {
+        if (!this.db)
+            return;
+        try {
+            this.db.prepare(`DELETE FROM ${this.config.tableName}`).run();
+            this.hits = 0;
+            this.misses = 0;
+        }
+        catch (error) {
+            console.error('L2 cache clear error:', error);
+        }
+    }
+    /**
+     * Get cache statistics
+     */
+    async getStats() {
+        const size = this.getCount();
+        const bytesUsed = this.getBytesUsed();
+        const total = this.hits + this.misses;
+        return {
+            size,
+            maxSize: this.config.maxEntries,
+            bytesUsed,
+            hits: this.hits,
+            misses: this.misses,
+            hitRate: total > 0 ? this.hits / total : 0,
+        };
+    }
+    /**
+     * Get multiple embeddings at once
+     */
+    async getBatch(hashes) {
+        const result = new Map();
+        if (!this.db || hashes.length === 0)
+            return result;
+        try {
+            const placeholders = hashes.map(() => '?').join(',');
+            const rows = this.db.prepare(`
+        SELECT hash, embedding FROM ${this.config.tableName}
+        WHERE hash IN (${placeholders})
+      `).all(...hashes);
+            for (const row of rows) {
+                result.set(row.hash, this.deserializeEmbedding(row.embedding));
+                this.hits++;
+            }
+            this.misses += hashes.length - rows.length;
+        }
+        catch (error) {
+            console.error('L2 cache getBatch error:', error);
+        }
+        return result;
+    }
+    /**
+     * Set multiple embeddings at once
+     */
+    async setBatch(entries) {
+        if (!this.db || entries.length === 0)
+            return;
+        try {
+            const insert = this.db.prepare(`
+        INSERT OR REPLACE INTO ${this.config.tableName}
+        (hash, embedding, dimensions, created_at, last_access, access_count)
+        VALUES (?, ?, ?, datetime('now'), datetime('now'), 1)
+      `);
+            const transaction = this.db.transaction((items) => {
+                for (const { hash, embedding } of items) {
+                    insert.run(hash, this.serializeEmbedding(embedding), embedding.length);
+                }
+            });
+            transaction(entries);
+        }
+        catch (error) {
+            console.error('L2 cache setBatch error:', error);
+        }
+    }
+    /**
+     * Evict expired entries
+     */
+    async evictExpired() {
+        if (!this.db || this.config.ttl === 0)
+            return 0;
+        try {
+            const cutoff = new Date(Date.now() - this.config.ttl).toISOString();
+            const result = this.db.prepare(`
+        DELETE FROM ${this.config.tableName}
+        WHERE created_at < ?
+      `).run(cutoff);
+            return result.changes;
+        }
+        catch {
+            return 0;
+        }
+    }
+    // Private helpers
+    async ensureTable() {
+        if (!this.db)
+            return;
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS ${this.config.tableName} (
+        hash TEXT PRIMARY KEY,
+        embedding BLOB NOT NULL,
+        dimensions INTEGER NOT NULL,
+        created_at TEXT DEFAULT (datetime('now')),
+        last_access TEXT DEFAULT (datetime('now')),
+        access_count INTEGER DEFAULT 1
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_${this.config.tableName}_last_access
+      ON ${this.config.tableName}(last_access);
+
+      CREATE INDEX IF NOT EXISTS idx_${this.config.tableName}_created_at
+      ON ${this.config.tableName}(created_at);
+    `);
+    }
+    getCount() {
+        if (!this.db)
+            return 0;
+        try {
+            const row = this.db.prepare(`
+        SELECT COUNT(*) as count FROM ${this.config.tableName}
+      `).get();
+            return row.count;
+        }
+        catch {
+            return 0;
+        }
+    }
+    getBytesUsed() {
+        if (!this.db)
+            return 0;
+        try {
+            const row = this.db.prepare(`
+        SELECT SUM(LENGTH(embedding)) as bytes FROM ${this.config.tableName}
+      `).get();
+            return row.bytes ?? 0;
+        }
+        catch {
+            return 0;
+        }
+    }
+    async evictLRU(count) {
+        if (!this.db)
+            return;
+        try {
+            this.db.prepare(`
+        DELETE FROM ${this.config.tableName}
+        WHERE hash IN (
+          SELECT hash FROM ${this.config.tableName}
+          ORDER BY last_access ASC
+          LIMIT ?
+        )
+      `).run(count);
+        }
+        catch (error) {
+            console.error('L2 cache evictLRU error:', error);
+        }
+    }
+    serializeEmbedding(embedding) {
+        // Store as Float32Array for efficiency
+        const float32 = new Float32Array(embedding);
+        return Buffer.from(float32.buffer);
+    }
+    deserializeEmbedding(buffer) {
+        const float32 = new Float32Array(buffer.buffer, buffer.byteOffset, buffer.length / 4);
+        return Array.from(float32);
+    }
+}
+//# sourceMappingURL=l2-sqlite.js.map

package/dist/embeddings/cache/l2-sqlite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"l2-sqlite.js","sourceRoot":"","sources":["../../../src/embeddings/cache/l2-sqlite.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAgBH;;GAEG;AACH,MAAM,cAAc,GAAkB;IACpC,SAAS,EAAE,iBAAiB;IAC5B,UAAU,EAAE,MAAM;IAClB,GAAG,EAAE,CAAC,EAAE,uBAAuB;CAChC,CAAC;AAoBF;;GAEG;AACH,MAAM,OAAO,aAAa;IAChB,EAAE,GAA6B,IAAI,CAAC;IACpC,MAAM,CAAgB;IACtB,IAAI,GAAG,CAAC,CAAC;IACT,MAAM,GAAG,CAAC,CAAC;IACX,YAAY,GAAG,KAAK,CAAC;IAE7B,YAAY,MAA+B;QACzC,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,MAAM,EAAE,CAAC;IACjD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU,CAAC,EAAqB;QACpC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QACzB,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CAAC,IAAY;QACpB,IAAI,CAAC,IAAI,CAAC,EAAE;YAAE,OAAO,IAAI,CAAC;QAE1B,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;4CACU,IAAI,CAAC,MAAM,CAAC,SAAS;;OAE1D,CAAC,CAAC,GAAG,CAAC,IAAI,CAA0D,CAAC;YAEtE,IAAI,CAAC,GAAG,EAAE,CAAC;gBACT,IAAI,CAAC,MAAM,EAAE,CAAC;gBACd,OAAO,IAAI,CAAC;YACd,CAAC;YAED,YAAY;YACZ,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC;gBACxB,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,OAAO,EAAE,CAAC;gBACrD,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;oBAC7C,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;oBACxB,IAAI,CAAC,MAAM,EAAE,CAAC;oBACd,OAAO,IAAI,CAAC;gBACd,CAAC;YACH,CAAC;YAED,qBAAqB;YACrB,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;iBACL,IAAI,CAAC,MAAM,CAAC,SAAS;;;OAG/B,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAEb,IAAI,CAAC,IAAI,EAAE,CAAC;YACZ,OAAO,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAClD,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,CAAC,MAAM,EAAE,CAAC;YACd,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CAAC,IAAY,EAAE,SAAmB;QACzC,IAAI,CAAC,IAAI,CAAC,EAAE;YAAE,OAAO;QAErB,IAAI,CAAC;YACH,iBAAiB;YACjB,IAAI,IAAI,CAAC,MAAM,CAAC,UAAU,GAAG,CAAC,EAAE,CAAC;gBAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAC9B,IAAI,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;oBACpC,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY;gBAC5E,CAAC;YACH,CAAC;YAED,MAAM,UAAU,GAAG,IAAI,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC;YAEtD,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;iCACW,IAAI,CAAC,MAAM,CAAC,SAAS;;;OAG/C,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,UAAU,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;QAC7C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,qBAAqB,EAAE,KAAK,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CAAC,IAAY;QACpB,IAAI,CAAC,IAAI,CAAC,EAAE;YAAE,OAAO,KAAK,CAAC;QAE3B,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;wBACV,IAAI,CAAC,MAAM,CAAC,SAAS;OACtC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAEb,OAAO,CAAC,CAAC,GAAG,CAAC;QACf,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,IAAY;QACvB,IAAI,CAAC,IAAI,CAAC,EAAE;YAAE,OAAO,KAAK,CAAC;QAE3B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;sBACf,IAAI,CAAC,MAAM,CAAC,SAAS;OACpC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAEb,OAAO,MAAM,CAAC,OAAO,GAAG,CAAC,CAAC;QAC5B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,IAAI,CAAC,EAAE;YAAE,OAAO;QAErB,IAAI,CAAC;YACH,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,eAAe,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC;YAC9D,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;YACd,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;QAClB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,uBAAuB,EAAE,KAAK,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ;QACZ,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC7B,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;QACtC,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC;QAEtC,OAAO;YACL,IAAI;YACJ,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU;YAC/B,SAAS;YACT,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,OAAO,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;SAC3C,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ,CAAC,MAAgB;QAC7B,MAAM,MAAM,GAAG,IAAI,GAAG,EAAoB,CAAC;QAC3C,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,MAAM,CAAC;QAEnD,IAAI,CAAC;YACH,MAAM,YAAY,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACrD,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;sCACG,IAAI,CAAC,MAAM,CAAC,SAAS;yBAClC,YAAY;OAC9B,CAAC,CAAC,GAAG,CAAC,GAAG,MAAM,CAA+C,CAAC;YAEhE,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;gBACvB,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC;gBAC/D,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,CAAC;YAED,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC7C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,0BAA0B,EAAE,KAAK,CAAC,CAAC;QACnD,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ,CAAC,OAAqD;QAClE,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAE7C,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;iCACJ,IAAI,CAAC,MAAM,CAAC,SAAS;;;OAG/C,CAAC,CAAC;YAEH,MAAM,WAAW,GAAG,IAAI,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC,KAAqB,EAAE,EAAE;gBAChE,KAAK,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,KAAK,EAAE,CAAC;oBACxC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,kBAAkB,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;gBACzE,CAAC;YACH,CAAC,CAAC,CAAC;YAEH,WAAW,CAAC,OAAO,CAAC,CAAC;QACvB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,0BAA0B,EAAE,KAAK,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,YAAY;QAChB,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC;YAAE,OAAO,CAAC,CAAC;QAEhD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;YACpE,MAAM,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;sBACf,IAAI,CAAC,MAAM,CAAC,SAAS;;OAEpC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAEf,OAAO,MAAM,CAAC,OAAO,CAAC;QACxB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,CAAC;QACX,CAAC;IACH,CAAC;IAED,kBAAkB;IAEV,KAAK,CAAC,WAAW;QACvB,IAAI,CAAC,IAAI,CAAC,EAAE;YAAE,OAAO;QAErB,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC;mCACkB,IAAI,CAAC,MAAM,CAAC,SAAS;;;;;;;;;uCASjB,IAAI,CAAC,MAAM,CAAC,SAAS;WACjD,IAAI,CAAC,MAAM,CAAC,SAAS;;uCAEO,IAAI,CAAC,MAAM,CAAC,SAAS;WACjD,IAAI,CAAC,MAAM,CAAC,SAAS;KAC3B,CAAC,CAAC;IACL,CAAC;IAEO,QAAQ;QACd,IAAI,CAAC,IAAI,CAAC,EAAE;YAAE,OAAO,CAAC,CAAC;QAEvB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;wCACM,IAAI,CAAC,MAAM,CAAC,SAAS;OACtD,CAAC,CAAC,GAAG,EAAuB,CAAC;YAE9B,OAAO,GAAG,CAAC,KAAK,CAAC;QACnB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,CAAC;QACX,CAAC;IACH,CAAC;IAEO,YAAY;QAClB,IAAI,CAAC,IAAI,CAAC,EAAE;YAAE,OAAO,CAAC,CAAC;QAEvB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;sDACoB,IAAI,CAAC,MAAM,CAAC,SAAS;OACpE,CAAC,CAAC,GAAG,EAA8B,CAAC;YAErC,OAAO,GAAG,CAAC,KAAK,IAAI,CAAC,CAAC;QACxB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,CAAC;QACX,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,QAAQ,CAAC,KAAa;QAClC,IAAI,CAAC,IAAI,CAAC,EAAE;YAAE,OAAO;QAErB,IAAI,CAAC;YACH,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;sBACA,IAAI,CAAC,MAAM,CAAC,SAAS;;6BAEd,IAAI,CAAC,MAAM,CAAC,SAAS;;;;OAI3C,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,0BAA0B,EAAE,KAAK,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IAEO,kBAAkB,CAAC,SAAmB;QAC5C,uCAAuC;QACvC,MAAM,OAAO,GAAG,IAAI,YAAY,CAAC,SAAS,CAAC,CAAC;QAC5C,OAAO,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACrC,CAAC;IAEO,oBAAoB,CAAC,MAAc;QACzC,MAAM,OAAO,GAAG,IAAI,YAAY,CAC9B,MAAM,CAAC,MAAM,EACb,MAAM,CAAC,UAAU,EACjB,MAAM,CAAC,MAAM,GAAG,CAAC,CAClB,CAAC;QACF,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;CACF"}

package/dist/embeddings/cache/l3-precomputed.d.ts

@@ -0,0 +1,106 @@
+/**
+ * L3 Precomputed Cache
+ *
+ * Precomputed embeddings for common patterns, file types,
+ * and intents. Loaded at startup for instant access.
+ *
+ * @module embeddings/cache/l3-precomputed
+ */
+/**
+ * Intent types for precomputed embeddings
+ */
+export type Intent = 'add_feature' | 'fix_bug' | 'refactor' | 'add_test' | 'security_audit' | 'performance' | 'documentation';
+/**
+ * L3 cache configuration
+ */
+export interface L3CacheConfig {
+    /** Whether to load patterns */
+    loadPatterns: boolean;
+    /** Whether to load file types */
+    loadFileTypes: boolean;
+    /** Whether to load intents */
+    loadIntents: boolean;
+}
+/**
+ * L3 Precomputed Cache for instant access to common embeddings
+ */
+export declare class L3PrecomputedCache {
+    private patterns;
+    private fileTypes;
+    private intents;
+    private config;
+    private initialized;
+    constructor(config?: Partial<L3CacheConfig>);
+    /**
+     * Initialize the cache
+     */
+    initialize(): Promise<void>;
+    /**
+     * Get embedding by key and type
+     */
+    get(key: string, type: 'pattern' | 'fileType' | 'intent'): number[] | null;
+    /**
+     * Get pattern embedding
+     */
+    getPattern(name: string): number[] | null;
+    /**
+     * Get file type embedding
+     */
+    getFileType(type: string): number[] | null;
+    /**
+     * Get intent embedding
+     */
+    getIntent(intent: Intent): number[] | null;
+    /**
+     * List available patterns
+     */
+    listPatterns(): string[];
+    /**
+     * List available file types
+     */
+    listFileTypes(): string[];
+    /**
+     * List available intents
+     */
+    listIntents(): Intent[];
+    /**
+     * Add custom pattern embedding
+     */
+    addPattern(name: string, embedding: number[]): void;
+    /**
+     * Add custom file type embedding
+     */
+    addFileType(type: string, embedding: number[]): void;
+    /**
+     * Find closest pattern to an embedding
+     */
+    findClosestPattern(embedding: number[]): {
+        pattern: string;
+        similarity: number;
+    } | null;
+    /**
+     * Find closest file type to an embedding
+     */
+    findClosestFileType(embedding: number[]): {
+        fileType: string;
+        similarity: number;
+    } | null;
+    /**
+     * Find closest intent to an embedding
+     */
+    findClosestIntent(embedding: number[]): {
+        intent: Intent;
+        similarity: number;
+    } | null;
+    /**
+     * Get cache statistics
+     */
+    getStats(): {
+        patterns: number;
+        fileTypes: number;
+        intents: number;
+        initialized: boolean;
+    };
+    private cosineSimilarity;
+}
+//# sourceMappingURL=l3-precomputed.d.ts.map

package/dist/embeddings/cache/l3-precomputed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"l3-precomputed.d.ts","sourceRoot":"","sources":["../../../src/embeddings/cache/l3-precomputed.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,MAAM,MAAM,MAAM,GACd,aAAa,GACb,SAAS,GACT,UAAU,GACV,UAAU,GACV,gBAAgB,GAChB,aAAa,GACb,eAAe,CAAC;AAEpB;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,+BAA+B;IAC/B,YAAY,EAAE,OAAO,CAAC;IACtB,iCAAiC;IACjC,aAAa,EAAE,OAAO,CAAC;IACvB,8BAA8B;IAC9B,WAAW,EAAE,OAAO,CAAC;CACtB;AA+FD;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAoC;IACpD,OAAO,CAAC,SAAS,CAAoC;IACrD,OAAO,CAAC,OAAO,CAAoC;IACnD,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,WAAW,CAAS;gBAEhB,MAAM,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC;IAI3C;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAwBjC;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,UAAU,GAAG,QAAQ,GAAG,MAAM,EAAE,GAAG,IAAI;IAa1E;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI;IAIzC;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI;IAI1C;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI;IAI1C;;OAEG;IACH,YAAY,IAAI,MAAM,EAAE;IAIxB;;OAEG;IACH,aAAa,IAAI,MAAM,EAAE;IAIzB;;OAEG;IACH,WAAW,IAAI,MAAM,EAAE;IAIvB;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI;IAInD;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI;IAIpD;;OAEG;IACH,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAiBvF;;OAEG;IACH,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAiBzF;;OAEG;IACH,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAiBrF;;OAEG;IACH,QAAQ,IAAI;QACV,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,OAAO,CAAC;KACtB;IAWD,OAAO,CAAC,gBAAgB;CAkBzB"}

package/dist/embeddings/cache/l3-precomputed.js

@@ -0,0 +1,270 @@
+/**
+ * L3 Precomputed Cache
+ *
+ * Precomputed embeddings for common patterns, file types,
+ * and intents. Loaded at startup for instant access.
+ *
+ * @module embeddings/cache/l3-precomputed
+ */
+/**
+ * Default configuration
+ */
+const DEFAULT_CONFIG = {
+    loadPatterns: true,
+    loadFileTypes: true,
+    loadIntents: true,
+};
+/**
+ * Precomputed pattern embeddings
+ * These are deterministic embeddings for common code patterns
+ */
+const PATTERN_EMBEDDINGS = {
+    'async-await': generatePatternEmbedding('async-await', 768),
+    'error-handling': generatePatternEmbedding('error-handling', 768),
+    'middleware': generatePatternEmbedding('middleware', 768),
+    'factory': generatePatternEmbedding('factory', 768),
+    'singleton': generatePatternEmbedding('singleton', 768),
+    'observer': generatePatternEmbedding('observer', 768),
+    'repository': generatePatternEmbedding('repository', 768),
+    'service': generatePatternEmbedding('service', 768),
+    'controller': generatePatternEmbedding('controller', 768),
+    'validator': generatePatternEmbedding('validator', 768),
+    'transformer': generatePatternEmbedding('transformer', 768),
+    'hook': generatePatternEmbedding('hook', 768),
+    'component': generatePatternEmbedding('component', 768),
+    'test': generatePatternEmbedding('test', 768),
+    'config': generatePatternEmbedding('config', 768),
+};
+/**
+ * Precomputed file type embeddings
+ */
+const FILE_TYPE_EMBEDDINGS = {
+    'typescript': generatePatternEmbedding('typescript', 768),
+    'javascript': generatePatternEmbedding('javascript', 768),
+    'python': generatePatternEmbedding('python', 768),
+    'java': generatePatternEmbedding('java', 768),
+    'csharp': generatePatternEmbedding('csharp', 768),
+    'go': generatePatternEmbedding('go', 768),
+    'rust': generatePatternEmbedding('rust', 768),
+    'php': generatePatternEmbedding('php', 768),
+    'ruby': generatePatternEmbedding('ruby', 768),
+    'sql': generatePatternEmbedding('sql', 768),
+    'json': generatePatternEmbedding('json', 768),
+    'yaml': generatePatternEmbedding('yaml', 768),
+    'markdown': generatePatternEmbedding('markdown', 768),
+};
+/**
+ * Precomputed intent embeddings
+ */
+const INTENT_EMBEDDINGS = {
+    'add_feature': generatePatternEmbedding('add_feature', 768),
+    'fix_bug': generatePatternEmbedding('fix_bug', 768),
+    'refactor': generatePatternEmbedding('refactor', 768),
+    'add_test': generatePatternEmbedding('add_test', 768),
+    'security_audit': generatePatternEmbedding('security_audit', 768),
+    'performance': generatePatternEmbedding('performance', 768),
+    'documentation': generatePatternEmbedding('documentation', 768),
+};
+/**
+ * Generate a deterministic embedding for a pattern name
+ */
+function generatePatternEmbedding(name, dimensions) {
+    const embedding = new Array(dimensions).fill(0);
+    // Use hash-based generation for deterministic embeddings
+    let hash = 5381;
+    for (let i = 0; i < name.length; i++) {
+        hash = ((hash << 5) + hash) + name.charCodeAt(i);
+        hash = hash | 0;
+    }
+    // Generate embedding values
+    for (let i = 0; i < dimensions; i++) {
+        const seed = hash + i * 31;
+        embedding[i] = Math.sin(seed * 12.9898) * 0.5;
+    }
+    // Normalize
+    const magnitude = Math.sqrt(embedding.reduce((sum, v) => sum + v * v, 0));
+    if (magnitude > 0) {
+        for (let i = 0; i < dimensions; i++) {
+            embedding[i] /= magnitude;
+        }
+    }
+    return embedding;
+}
+/**
+ * L3 Precomputed Cache for instant access to common embeddings
+ */
+export class L3PrecomputedCache {
+    patterns = new Map();
+    fileTypes = new Map();
+    intents = new Map();
+    config;
+    initialized = false;
+    constructor(config) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    /**
+     * Initialize the cache
+     */
+    async initialize() {
+        if (this.initialized)
+            return;
+        if (this.config.loadPatterns) {
+            for (const [name, embedding] of Object.entries(PATTERN_EMBEDDINGS)) {
+                this.patterns.set(name, embedding);
+            }
+        }
+        if (this.config.loadFileTypes) {
+            for (const [name, embedding] of Object.entries(FILE_TYPE_EMBEDDINGS)) {
+                this.fileTypes.set(name, embedding);
+            }
+        }
+        if (this.config.loadIntents) {
+            for (const [name, embedding] of Object.entries(INTENT_EMBEDDINGS)) {
+                this.intents.set(name, embedding);
+            }
+        }
+        this.initialized = true;
+    }
+    /**
+     * Get embedding by key and type
+     */
+    get(key, type) {
+        switch (type) {
+            case 'pattern':
+                return this.patterns.get(key) ?? null;
+            case 'fileType':
+                return this.fileTypes.get(key) ?? null;
+            case 'intent':
+                return this.intents.get(key) ?? null;
+            default:
+                return null;
+        }
+    }
+    /**
+     * Get pattern embedding
+     */
+    getPattern(name) {
+        return this.patterns.get(name) ?? null;
+    }
+    /**
+     * Get file type embedding
+     */
+    getFileType(type) {
+        return this.fileTypes.get(type) ?? null;
+    }
+    /**
+     * Get intent embedding
+     */
+    getIntent(intent) {
+        return this.intents.get(intent) ?? null;
+    }
+    /**
+     * List available patterns
+     */
+    listPatterns() {
+        return Array.from(this.patterns.keys());
+    }
+    /**
+     * List available file types
+     */
+    listFileTypes() {
+        return Array.from(this.fileTypes.keys());
+    }
+    /**
+     * List available intents
+     */
+    listIntents() {
+        return Array.from(this.intents.keys());
+    }
+    /**
+     * Add custom pattern embedding
+     */
+    addPattern(name, embedding) {
+        this.patterns.set(name, embedding);
+    }
+    /**
+     * Add custom file type embedding
+     */
+    addFileType(type, embedding) {
+        this.fileTypes.set(type, embedding);
+    }
+    /**
+     * Find closest pattern to an embedding
+     */
+    findClosestPattern(embedding) {
+        let bestPattern = null;
+        let bestSimilarity = -1;
+        for (const [pattern, patternEmb] of this.patterns) {
+            const similarity = this.cosineSimilarity(embedding, patternEmb);
+            if (similarity > bestSimilarity) {
+                bestSimilarity = similarity;
+                bestPattern = pattern;
+            }
+        }
+        if (bestPattern === null)
+            return null;
+        return { pattern: bestPattern, similarity: bestSimilarity };
+    }
+    /**
+     * Find closest file type to an embedding
+     */
+    findClosestFileType(embedding) {
+        let bestType = null;
+        let bestSimilarity = -1;
+        for (const [fileType, typeEmb] of this.fileTypes) {
+            const similarity = this.cosineSimilarity(embedding, typeEmb);
+            if (similarity > bestSimilarity) {
+                bestSimilarity = similarity;
+                bestType = fileType;
+            }
+        }
+        if (bestType === null)
+            return null;
+        return { fileType: bestType, similarity: bestSimilarity };
+    }
+    /**
+     * Find closest intent to an embedding
+     */
+    findClosestIntent(embedding) {
+        let bestIntent = null;
+        let bestSimilarity = -1;
+        for (const [intent, intentEmb] of this.intents) {
+            const similarity = this.cosineSimilarity(embedding, intentEmb);
+            if (similarity > bestSimilarity) {
+                bestSimilarity = similarity;
+                bestIntent = intent;
+            }
+        }
+        if (bestIntent === null)
+            return null;
+        return { intent: bestIntent, similarity: bestSimilarity };
+    }
+    /**
+     * Get cache statistics
+     */
+    getStats() {
+        return {
+            patterns: this.patterns.size,
+            fileTypes: this.fileTypes.size,
+            intents: this.intents.size,
+            initialized: this.initialized,
+        };
+    }
+    // Private helpers
+    cosineSimilarity(a, b) {
+        const minLen = Math.min(a.length, b.length);
+        let dotProduct = 0;
+        let normA = 0;
+        let normB = 0;
+        for (let i = 0; i < minLen; i++) {
+            dotProduct += a[i] * b[i];
+            normA += a[i] * a[i];
+            normB += b[i] * b[i];
+        }
+        const magnitude = Math.sqrt(normA) * Math.sqrt(normB);
+        if (magnitude === 0)
+            return 0;
+        return dotProduct / magnitude;
+    }
+}
+//# sourceMappingURL=l3-precomputed.js.map