agentic-qe 2.8.1 → 2.8.2

package/dist/code-intelligence/embeddings/EmbeddingCacheFactory.js

@@ -0,0 +1,301 @@
+"use strict";
+/**
+ * Embedding Cache Factory
+ *
+ * Creates embedding caches with configurable backends and auto-pruning.
+ * Provides unified interface for memory, Redis, and SQLite backends.
+ *
+ * @module code-intelligence/embeddings/EmbeddingCacheFactory
+ * @see Issue #146 - Security Hardening: SP-2 Dedicated Embedding Cache
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EnhancedEmbeddingCache = exports.DEFAULT_CACHE_CONFIG = void 0;
+exports.createBackend = createBackend;
+exports.createEmbeddingCache = createEmbeddingCache;
+exports.createMemoryCache = createMemoryCache;
+exports.createRedisCache = createRedisCache;
+exports.createSQLiteCache = createSQLiteCache;
+const types_js_1 = require("./backends/types.js");
+const MemoryBackend_js_1 = require("./backends/MemoryBackend.js");
+const RedisBackend_js_1 = require("./backends/RedisBackend.js");
+const SQLiteBackend_js_1 = require("./backends/SQLiteBackend.js");
+const crypto_1 = require("crypto");
+/**
+ * Default cache configuration
+ */
+exports.DEFAULT_CACHE_CONFIG = {
+    backend: 'memory',
+    maxSize: types_js_1.DEFAULT_MAX_SIZE,
+    ttlMs: types_js_1.DEFAULT_TTL_MS,
+    autoPruneIntervalMs: 60 * 60 * 1000, // 1 hour
+    debug: false,
+};
+/**
+ * Enhanced Embedding Cache with pluggable backends
+ *
+ * Features:
+ * - Pluggable backends (memory, Redis, SQLite)
+ * - Content hash-based deduplication
+ * - Automatic TTL-based expiration
+ * - Auto-pruning scheduler
+ * - Cache statistics
+ */
+class EnhancedEmbeddingCache {
+    constructor(backend, config = {}) {
+        this.pruneInterval = null;
+        this.hits = 0;
+        this.misses = 0;
+        this.initialized = false;
+        this.backend = backend;
+        this.config = { ...exports.DEFAULT_CACHE_CONFIG, ...config };
+    }
+    /**
+     * Initialize the cache and start auto-pruning
+     */
+    async initialize() {
+        if (this.initialized)
+            return;
+        await this.backend.initialize();
+        // Start auto-pruning if configured
+        if (this.config.autoPruneIntervalMs > 0) {
+            this.startAutoPrune();
+        }
+        this.initialized = true;
+        this.log('Cache initialized');
+    }
+    /**
+     * Close the cache and stop auto-pruning
+     */
+    async close() {
+        this.stopAutoPrune();
+        await this.backend.close();
+        this.initialized = false;
+        this.log('Cache closed');
+    }
+    /**
+     * Generate content hash for cache key
+     */
+    hashContent(content, model) {
+        return (0, crypto_1.createHash)('sha256')
+            .update(`${model}:${content}`)
+            .digest('hex');
+    }
+    /**
+     * Get cached embedding
+     */
+    async get(content, model) {
+        const key = this.hashContent(content, model);
+        const entry = await this.backend.get(key);
+        if (entry) {
+            this.hits++;
+            return entry.embedding;
+        }
+        this.misses++;
+        return null;
+    }
+    /**
+     * Store embedding in cache
+     */
+    async set(content, model, embedding) {
+        const key = this.hashContent(content, model);
+        const entry = {
+            embedding,
+            timestamp: Date.now(),
+            model,
+        };
+        await this.backend.set(key, entry);
+    }
+    /**
+     * Check if embedding is cached
+     */
+    async has(content, model) {
+        const key = this.hashContent(content, model);
+        return this.backend.has(key);
+    }
+    /**
+     * Delete cached embedding
+     */
+    async delete(content, model) {
+        const key = this.hashContent(content, model);
+        return this.backend.delete(key);
+    }
+    /**
+     * Clear all cached embeddings
+     */
+    async clear() {
+        await this.backend.clear();
+        this.hits = 0;
+        this.misses = 0;
+    }
+    /**
+     * Get cache statistics
+     */
+    async getStats() {
+        const size = await this.backend.size();
+        const total = this.hits + this.misses;
+        const hitRate = total > 0 ? this.hits / total : 0;
+        return {
+            size,
+            hitRate,
+            hits: this.hits,
+            misses: this.misses,
+            backendType: this.config.backend,
+        };
+    }
+    /**
+     * Batch check for multiple contents
+     */
+    async batchHas(contents, model) {
+        const results = new Map();
+        // Process in parallel with Promise.all
+        const checks = contents.map(async (content) => {
+            const exists = await this.has(content, model);
+            return { content, exists };
+        });
+        const resolved = await Promise.all(checks);
+        for (const { content, exists } of resolved) {
+            results.set(content, exists);
+        }
+        return results;
+    }
+    /**
+     * Batch get for multiple contents
+     */
+    async batchGet(contents, model) {
+        const results = new Map();
+        const gets = contents.map(async (content) => {
+            const embedding = await this.get(content, model);
+            return { content, embedding };
+        });
+        const resolved = await Promise.all(gets);
+        for (const { content, embedding } of resolved) {
+            results.set(content, embedding);
+        }
+        return results;
+    }
+    /**
+     * Prune expired entries
+     */
+    async prune() {
+        return this.backend.pruneExpired(this.config.ttlMs);
+    }
+    /**
+     * Check if backend is healthy
+     */
+    async isHealthy() {
+        return this.backend.isHealthy();
+    }
+    /**
+     * Get backend name
+     */
+    getBackendName() {
+        return this.backend.name;
+    }
+    // ============================================
+    // Auto-Pruning
+    // ============================================
+    startAutoPrune() {
+        if (this.pruneInterval)
+            return;
+        this.pruneInterval = setInterval(async () => {
+            try {
+                const pruned = await this.prune();
+                if (pruned > 0) {
+                    this.log(`Auto-pruned ${pruned} expired entries`);
+                }
+            }
+            catch (error) {
+                this.log(`Auto-prune error: ${error.message}`);
+            }
+        }, this.config.autoPruneIntervalMs);
+        this.log(`Auto-pruning started (interval: ${this.config.autoPruneIntervalMs}ms)`);
+    }
+    stopAutoPrune() {
+        if (this.pruneInterval) {
+            clearInterval(this.pruneInterval);
+            this.pruneInterval = null;
+            this.log('Auto-pruning stopped');
+        }
+    }
+    log(message) {
+        if (this.config.debug) {
+            console.log(`[EmbeddingCache:${this.backend.name}] ${message}`);
+        }
+    }
+}
+exports.EnhancedEmbeddingCache = EnhancedEmbeddingCache;
+// ============================================
+// Factory Functions
+// ============================================
+/**
+ * Create a backend instance based on configuration
+ */
+function createBackend(config) {
+    switch (config.backend) {
+        case 'memory':
+            return new MemoryBackend_js_1.MemoryStorageBackend({
+                maxSize: config.maxSize,
+                defaultTtlMs: config.ttlMs,
+                debug: config.debug,
+                ...config.memory,
+            });
+        case 'redis':
+            if (!config.redis) {
+                throw new Error('Redis backend requires redis configuration');
+            }
+            return new RedisBackend_js_1.RedisStorageBackend({
+                ...config.redis,
+                maxSize: config.maxSize,
+                defaultTtlMs: config.ttlMs,
+                debug: config.debug,
+            });
+        case 'sqlite':
+            if (!config.sqlite) {
+                throw new Error('SQLite backend requires sqlite configuration');
+            }
+            return new SQLiteBackend_js_1.SQLiteStorageBackend({
+                ...config.sqlite,
+                maxSize: config.maxSize,
+                defaultTtlMs: config.ttlMs,
+                debug: config.debug,
+            });
+        default:
+            throw new Error(`Unknown backend type: ${config.backend}`);
+    }
+}
+/**
+ * Create an embedding cache with the specified configuration
+ */
+function createEmbeddingCache(config = {}) {
+    const fullConfig = { ...exports.DEFAULT_CACHE_CONFIG, ...config };
+    const backend = createBackend(fullConfig);
+    return new EnhancedEmbeddingCache(backend, fullConfig);
+}
+/**
+ * Create a memory-backed embedding cache
+ */
+function createMemoryCache(options = {}) {
+    return createEmbeddingCache({
+        backend: 'memory',
+        memory: options,
+    });
+}
+/**
+ * Create a Redis-backed embedding cache
+ */
+function createRedisCache(options) {
+    return createEmbeddingCache({
+        backend: 'redis',
+        redis: options,
+    });
+}
+/**
+ * Create a SQLite-backed embedding cache
+ */
+function createSQLiteCache(options) {
+    return createEmbeddingCache({
+        backend: 'sqlite',
+        sqlite: options,
+    });
+}
+//# sourceMappingURL=EmbeddingCacheFactory.js.map

package/dist/code-intelligence/embeddings/EmbeddingCacheFactory.js.map

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

package/dist/code-intelligence/embeddings/NomicEmbedder.d.ts

@@ -8,13 +8,81 @@
  * - Embedding caching with content hashing
  * - Progress tracking for large batches
  * - Error handling and retries
+ * - Pluggable storage backends (SP-2 - Issue #146)
  */
-import { CodeChunk, EmbeddingBatchResult, ProgressCallback } from './types';
+import { EmbeddingCache } from './EmbeddingCache';
+import { EnhancedEmbeddingCache, type EmbeddingCacheConfig } from './EmbeddingCacheFactory.js';
+import type { BackendType } from './backends/types.js';
+import { CodeChunk, EmbeddingBatchResult, ProgressCallback, CacheStats } from './types';
+/**
+ * Configuration for NomicEmbedder
+ */
+export interface NomicEmbedderConfig {
+    /** Ollama base URL (default: http://localhost:11434) */
+    ollamaBaseUrl?: string;
+    /** Batch size for processing (default: 100) */
+    batchSize?: number;
+    /** Maximum cache size for memory backend (default: 10000) */
+    maxCacheSize?: number;
+    /**
+     * Storage backend type (SP-2 - Issue #146)
+     * - 'memory': In-memory with LRU (default, backward compatible)
+     * - 'redis': Distributed caching (requires Redis config)
+     * - 'sqlite': Persistent local storage
+     */
+    cacheBackend?: BackendType;
+    /** Full cache configuration for advanced setups */
+    cacheConfig?: Partial<EmbeddingCacheConfig>;
+    /** Pre-configured cache instance (for dependency injection) */
+    cache?: EmbeddingCache | EnhancedEmbeddingCache;
+}
 export declare class NomicEmbedder {
     private client;
     private cache;
+    private enhancedCache?;
     private batchSize;
-    constructor(ollamaBaseUrl?: string, maxCacheSize?: number, batchSize?: number);
+    private cacheInitialized;
+    /**
+     * Create a NomicEmbedder instance
+     *
+     * @example Basic usage (backward compatible):
+     * ```typescript
+     * const embedder = new NomicEmbedder();
+     * ```
+     *
+     * @example With configuration object:
+     * ```typescript
+     * const embedder = new NomicEmbedder({
+     *   ollamaBaseUrl: 'http://localhost:11434',
+     *   cacheBackend: 'sqlite',
+     *   cacheConfig: { sqlite: { dbPath: './data/embeddings.db' } }
+     * });
+     * await embedder.initializeCache();
+     * ```
+     *
+     * @example Legacy constructor (deprecated but supported):
+     * ```typescript
+     * const embedder = new NomicEmbedder('http://localhost:11434', 5000, 50);
+     * ```
+     */
+    constructor(configOrUrl?: NomicEmbedderConfig | string, maxCacheSize?: number, batchSize?: number);
+    /**
+     * Initialize the cache backend (required for Redis/SQLite)
+     * No-op for simple in-memory cache
+     */
+    initializeCache(): Promise<void>;
+    /**
+     * Close the cache backend and release resources
+     */
+    closeCache(): Promise<void>;
+    /**
+     * Check if using enhanced cache with pluggable backend
+     */
+    isUsingEnhancedCache(): boolean;
+    /**
+     * Get the cache backend type
+     */
+    getCacheBackendType(): string;
     /**
      * Generate embedding for a single text string
      */
@@ -35,13 +103,16 @@ export declare class NomicEmbedder {
     /**
      * Clear the embedding cache
      */
-    clearCache(): void;
+    clearCache(): Promise<void>;
     /**
      * Get cache statistics
      */
-    getCacheStats(): import("./types").CacheStats;
+    getCacheStats(): Promise<CacheStats & {
+        backendType?: BackendType;
+    }>;
     /**
      * Get cache memory usage estimate
+     * Note: Only available for simple in-memory cache
      */
     getCacheMemoryUsage(): number;
     /**
@@ -54,8 +125,9 @@ export declare class NomicEmbedder {
     getServerInfo(): Promise<import("./types").OllamaHealthResponse | null>;
     /**
      * Evict old cache entries
+     * Note: For enhanced cache with Redis/SQLite, TTL-based expiration is automatic
      */
-    evictOldCacheEntries(ageMs: number): number;
+    evictOldCacheEntries(ageMs: number): Promise<number>;
     /**
      * Warmup cache with common code patterns
      */
@@ -67,7 +139,7 @@ export declare class NomicEmbedder {
     /**
      * Estimate total time for embedding batch
      */
-    estimateBatchTime(chunkCount: number, assumedTimePerEmbeddingMs?: number): number;
+    estimateBatchTime(chunkCount: number, assumedTimePerEmbeddingMs?: number): Promise<number>;
     /**
      * Get configuration info
      */

package/dist/code-intelligence/embeddings/NomicEmbedder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NomicEmbedder.d.ts","sourceRoot":"","sources":["../../../src/code-intelligence/embeddings/NomicEmbedder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,EACL,SAAS,EAET,oBAAoB,EAEpB,gBAAgB,EAEjB,MAAM,SAAS,CAAC;AAEjB,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,KAAK,CAAiB;IAC9B,OAAO,CAAC,SAAS,CAAS;gBAGxB,aAAa,CAAC,EAAE,MAAM,EACtB,YAAY,CAAC,EAAE,MAAM,EACrB,SAAS,GAAE,MAAoC;IAOjD;;OAEG;IACG,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAgB5C;;;OAGG;IACH,kBAAkB,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM;IAkC5C;;OAEG;IACG,UAAU,CACd,MAAM,EAAE,SAAS,EAAE,EACnB,gBAAgB,CAAC,EAAE,gBAAgB,GAClC,OAAO,CAAC,oBAAoB,CAAC;IAyDhC;;OAEG;YACW,YAAY;IAgD1B;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;OAEG;IACH,aAAa;IAIb;;OAEG;IACH,mBAAmB,IAAI,MAAM;IAI7B;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAIrC;;OAEG;IACG,aAAa;IAInB;;OAEG;IACH,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAI3C;;OAEG;IACG,WAAW,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrD;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,EAAE;IAI1C;;OAEG;IACH,iBAAiB,CACf,UAAU,EAAE,MAAM,EAClB,yBAAyB,GAAE,MAAY,GACtC,MAAM;IAQT;;OAEG;IACH,SAAS;;;;;;;CASV"}
+{"version":3,"file":"NomicEmbedder.d.ts","sourceRoot":"","sources":["../../../src/code-intelligence/embeddings/NomicEmbedder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EACL,sBAAsB,EAEtB,KAAK,oBAAoB,EAC1B,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EACL,SAAS,EAET,oBAAoB,EAEpB,gBAAgB,EAChB,UAAU,EAEX,MAAM,SAAS,CAAC;AAYjB;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,wDAAwD;IACxD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6DAA6D;IAC7D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,WAAW,CAAC;IAC3B,mDAAmD;IACnD,WAAW,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAC5C,+DAA+D;IAC/D,KAAK,CAAC,EAAE,cAAc,GAAG,sBAAsB,CAAC;CACjD;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,KAAK,CAAkB;IAC/B,OAAO,CAAC,aAAa,CAAC,CAAyB;IAC/C,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,gBAAgB,CAAkB;IAE1C;;;;;;;;;;;;;;;;;;;;;;OAsBG;gBAED,WAAW,CAAC,EAAE,mBAAmB,GAAG,MAAM,EAC1C,YAAY,CAAC,EAAE,MAAM,EACrB,SAAS,GAAE,MAAoC;IAwCjD;;;OAGG;IACG,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAYtC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAOjC;;OAEG;IACH,oBAAoB,IAAI,OAAO;IAI/B;;OAEG;IACH,mBAAmB,IAAI,MAAM;IAO7B;;OAEG;IACG,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAyB5C;;;OAGG;IACH,kBAAkB,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM;IAkC5C;;OAEG;IACG,UAAU,CACd,MAAM,EAAE,SAAS,EAAE,EACnB,gBAAgB,CAAC,EAAE,gBAAgB,GAClC,OAAO,CAAC,oBAAoB,CAAC;IA8DhC;;OAEG;YACW,YAAY;IAoD1B;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAOjC;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,UAAU,GAAG;QAAE,WAAW,CAAC,EAAE,WAAW,CAAA;KAAE,CAAC;IAQ1E;;;OAGG;IACH,mBAAmB,IAAI,MAAM;IAc7B;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAIrC;;OAEG;IACG,aAAa;IAInB;;;OAGG;IACG,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAY1D;;OAEG;IACG,WAAW,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrD;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,EAAE;IAI1C;;OAEG;IACG,iBAAiB,CACrB,UAAU,EAAE,MAAM,EAClB,yBAAyB,GAAE,MAAY,GACtC,OAAO,CAAC,MAAM,CAAC;IAQlB;;OAEG;IACH,SAAS;;;;;;;CASV"}