agentic-qe 2.5.9 → 2.6.0

package/dist/code-intelligence/search/VectorSearch.js

@@ -0,0 +1,301 @@
+"use strict";
+/**
+ * Vector Search
+ *
+ * Provides semantic vector search using embeddings.
+ * Delegates to CodeChunkStore for RuVector-backed persistence,
+ * with in-memory fallback for testing.
+ *
+ * @module code-intelligence/search/VectorSearch
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VectorSearch = exports.DEFAULT_VECTOR_SEARCH_CONFIG = void 0;
+const CodeChunkStore_js_1 = require("../storage/CodeChunkStore.js");
+exports.DEFAULT_VECTOR_SEARCH_CONFIG = {
+    dimensions: 768, // nomic-embed-text
+    metric: 'cosine',
+    indexType: 'hnsw',
+    hnswM: 16,
+    hnswEfConstruction: 64,
+    hnswEfSearch: 40,
+};
+/**
+ * VectorSearch - Unified interface for vector search
+ *
+ * Uses CodeChunkStore (RuVector PostgreSQL) when database is configured,
+ * otherwise falls back to in-memory storage for testing.
+ */
+class VectorSearch {
+    constructor(config = {}) {
+        this.documents = new Map();
+        this.chunkStore = null;
+        this.config = { ...exports.DEFAULT_VECTOR_SEARCH_CONFIG, ...config };
+        this.useDatabase = !!config.database;
+        if (config.database) {
+            this.chunkStore = new CodeChunkStore_js_1.CodeChunkStore({
+                ...config.database,
+                embeddingDimension: this.config.dimensions,
+            });
+        }
+    }
+    /**
+     * Initialize the vector search (connect to database if configured).
+     */
+    async initialize() {
+        if (this.chunkStore) {
+            await this.chunkStore.initialize();
+        }
+    }
+    /**
+     * Add a document with its embedding.
+     */
+    async addDocument(doc) {
+        if (doc.embedding.length !== this.config.dimensions) {
+            throw new Error(`Expected ${this.config.dimensions} dimensions, got ${doc.embedding.length}`);
+        }
+        if (this.chunkStore) {
+            await this.chunkStore.storeChunk({
+                id: doc.id,
+                filePath: doc.metadata.filePath,
+                content: doc.metadata.content,
+                embedding: doc.embedding,
+                chunkType: doc.metadata.entityType,
+                name: doc.metadata.entityName,
+                startLine: doc.metadata.startLine,
+                endLine: doc.metadata.endLine,
+            });
+        }
+        else {
+            this.documents.set(doc.id, doc);
+        }
+    }
+    /**
+     * Add multiple documents.
+     */
+    async addDocuments(docs) {
+        if (this.chunkStore) {
+            await this.chunkStore.storeChunks(docs.map((doc) => ({
+                id: doc.id,
+                filePath: doc.metadata.filePath,
+                content: doc.metadata.content,
+                embedding: doc.embedding,
+                chunkType: doc.metadata.entityType,
+                name: doc.metadata.entityName,
+                startLine: doc.metadata.startLine,
+                endLine: doc.metadata.endLine,
+            })));
+        }
+        else {
+            for (const doc of docs) {
+                this.documents.set(doc.id, doc);
+            }
+        }
+    }
+    /**
+     * Remove a document.
+     */
+    async removeDocument(docId) {
+        if (this.chunkStore) {
+            // For database, we need to get the file path first
+            // This is a limitation - we'd need to store doc ID -> file path mapping
+            // For now, return false as we can't delete by ID alone
+            return false;
+        }
+        return this.documents.delete(docId);
+    }
+    /**
+     * Search for similar documents.
+     */
+    async search(queryEmbedding, topK = 10, filter) {
+        if (queryEmbedding.length !== this.config.dimensions) {
+            throw new Error(`Expected ${this.config.dimensions} dimensions, got ${queryEmbedding.length}`);
+        }
+        if (this.chunkStore) {
+            const results = await this.chunkStore.search(queryEmbedding, {
+                topK,
+                language: filter?.language,
+                filePattern: filter?.filePattern,
+                entityType: filter?.entityType,
+            });
+            return results.map((r) => ({
+                id: r.id,
+                filePath: r.filePath,
+                content: r.content,
+                startLine: r.startLine,
+                endLine: r.endLine,
+                score: r.score,
+                vectorScore: r.score,
+                entityType: r.chunkType,
+                entityName: r.name,
+            }));
+        }
+        return this.searchInMemory(queryEmbedding, topK, filter);
+    }
+    /**
+     * Get a document by ID.
+     */
+    async getDocument(docId) {
+        if (this.chunkStore) {
+            // Database doesn't support single doc retrieval by ID efficiently
+            // Would need to add a method to CodeChunkStore
+            return null;
+        }
+        return this.documents.get(docId) || null;
+    }
+    /**
+     * Get all document IDs.
+     */
+    getDocumentIds() {
+        return Array.from(this.documents.keys());
+    }
+    /**
+     * Get document count.
+     */
+    getDocumentCount() {
+        return this.documents.size;
+    }
+    /**
+     * Clear all documents.
+     */
+    async clear() {
+        if (this.chunkStore) {
+            await this.chunkStore.clear();
+        }
+        else {
+            this.documents.clear();
+        }
+    }
+    /**
+     * Get configuration.
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+    /**
+     * Close database connection.
+     */
+    async close() {
+        if (this.chunkStore) {
+            await this.chunkStore.close();
+            this.chunkStore = null;
+        }
+    }
+    /**
+     * Check if using database storage.
+     */
+    isUsingDatabase() {
+        return this.useDatabase && this.chunkStore !== null;
+    }
+    /**
+     * Get the underlying CodeChunkStore (for advanced operations).
+     */
+    getChunkStore() {
+        return this.chunkStore;
+    }
+    /**
+     * Health check
+     */
+    async healthCheck() {
+        if (this.chunkStore) {
+            const health = await this.chunkStore.healthCheck();
+            return {
+                healthy: health.healthy,
+                mode: 'database',
+                documentCount: health.chunkCount,
+                error: health.error,
+            };
+        }
+        return {
+            healthy: true,
+            mode: 'memory',
+            documentCount: this.documents.size,
+        };
+    }
+    // === In-Memory Search Implementation ===
+    /**
+     * Search in memory using brute force.
+     */
+    searchInMemory(queryEmbedding, topK, filter) {
+        const scores = [];
+        for (const doc of this.documents.values()) {
+            // Apply filters
+            if (filter) {
+                if (filter.entityType && doc.metadata.entityType !== filter.entityType) {
+                    continue;
+                }
+                if (filter.filePattern && !doc.metadata.filePath.includes(filter.filePattern)) {
+                    continue;
+                }
+            }
+            const score = this.calculateSimilarity(queryEmbedding, doc.embedding);
+            scores.push({ doc, score });
+        }
+        // Sort by score descending
+        scores.sort((a, b) => b.score - a.score);
+        // Return top K
+        return scores.slice(0, topK).map(({ doc, score }) => ({
+            id: doc.id,
+            filePath: doc.metadata.filePath,
+            content: doc.metadata.content,
+            startLine: doc.metadata.startLine,
+            endLine: doc.metadata.endLine,
+            score,
+            vectorScore: score,
+            entityType: doc.metadata.entityType,
+            entityName: doc.metadata.entityName,
+        }));
+    }
+    /**
+     * Calculate similarity between two vectors.
+     */
+    calculateSimilarity(a, b) {
+        switch (this.config.metric) {
+            case 'cosine':
+                return this.cosineSimilarity(a, b);
+            case 'euclidean':
+                return 1 / (1 + this.euclideanDistance(a, b));
+            case 'dot':
+                return this.dotProduct(a, b);
+            default:
+                return this.cosineSimilarity(a, b);
+        }
+    }
+    /**
+     * Cosine similarity.
+     */
+    cosineSimilarity(a, b) {
+        let dotProduct = 0;
+        let normA = 0;
+        let normB = 0;
+        for (let i = 0; i < a.length; i++) {
+            dotProduct += a[i] * b[i];
+            normA += a[i] * a[i];
+            normB += b[i] * b[i];
+        }
+        const magnitude = Math.sqrt(normA) * Math.sqrt(normB);
+        return magnitude === 0 ? 0 : dotProduct / magnitude;
+    }
+    /**
+     * Euclidean distance.
+     */
+    euclideanDistance(a, b) {
+        let sum = 0;
+        for (let i = 0; i < a.length; i++) {
+            const diff = a[i] - b[i];
+            sum += diff * diff;
+        }
+        return Math.sqrt(sum);
+    }
+    /**
+     * Dot product.
+     */
+    dotProduct(a, b) {
+        let sum = 0;
+        for (let i = 0; i < a.length; i++) {
+            sum += a[i] * b[i];
+        }
+        return sum;
+    }
+}
+exports.VectorSearch = VectorSearch;
+//# sourceMappingURL=VectorSearch.js.map

package/dist/code-intelligence/search/VectorSearch.js.map

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

package/dist/code-intelligence/search/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Hybrid Search Module
+ *
+ * Combines BM25 keyword search with vector similarity
+ * using Reciprocal Rank Fusion.
+ */
+export { HybridSearchEngine } from './HybridSearchEngine.js';
+export type { VectorSearchProvider } from './HybridSearchEngine.js';
+export { BM25Search } from './BM25Search.js';
+export { RRFFusion } from './RRFFusion.js';
+export { VectorSearch } from './VectorSearch.js';
+export type { VectorDocument, VectorSearchConfig as VectorSearchImplConfig } from './VectorSearch.js';
+export { SearchResult, SearchResponse, SearchStats, HybridSearchConfig, BM25Config, BM25Index, BM25Document, VectorSearchConfig, RRFConfig, RRFRanking, DEFAULT_HYBRID_SEARCH_CONFIG, DEFAULT_BM25_CONFIG, DEFAULT_VECTOR_SEARCH_CONFIG, DEFAULT_RRF_CONFIG, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/code-intelligence/search/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/code-intelligence/search/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,YAAY,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EAAE,cAAc,EAAE,kBAAkB,IAAI,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AACtG,OAAO,EACL,YAAY,EACZ,cAAc,EACd,WAAW,EACX,kBAAkB,EAClB,UAAU,EACV,SAAS,EACT,YAAY,EACZ,kBAAkB,EAClB,SAAS,EACT,UAAU,EACV,4BAA4B,EAC5B,mBAAmB,EACnB,4BAA4B,EAC5B,kBAAkB,GACnB,MAAM,YAAY,CAAC"}

package/dist/code-intelligence/search/index.js

@@ -0,0 +1,23 @@
+"use strict";
+/**
+ * Hybrid Search Module
+ *
+ * Combines BM25 keyword search with vector similarity
+ * using Reciprocal Rank Fusion.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_RRF_CONFIG = exports.DEFAULT_VECTOR_SEARCH_CONFIG = exports.DEFAULT_BM25_CONFIG = exports.DEFAULT_HYBRID_SEARCH_CONFIG = exports.VectorSearch = exports.RRFFusion = exports.BM25Search = exports.HybridSearchEngine = void 0;
+var HybridSearchEngine_js_1 = require("./HybridSearchEngine.js");
+Object.defineProperty(exports, "HybridSearchEngine", { enumerable: true, get: function () { return HybridSearchEngine_js_1.HybridSearchEngine; } });
+var BM25Search_js_1 = require("./BM25Search.js");
+Object.defineProperty(exports, "BM25Search", { enumerable: true, get: function () { return BM25Search_js_1.BM25Search; } });
+var RRFFusion_js_1 = require("./RRFFusion.js");
+Object.defineProperty(exports, "RRFFusion", { enumerable: true, get: function () { return RRFFusion_js_1.RRFFusion; } });
+var VectorSearch_js_1 = require("./VectorSearch.js");
+Object.defineProperty(exports, "VectorSearch", { enumerable: true, get: function () { return VectorSearch_js_1.VectorSearch; } });
+var types_js_1 = require("./types.js");
+Object.defineProperty(exports, "DEFAULT_HYBRID_SEARCH_CONFIG", { enumerable: true, get: function () { return types_js_1.DEFAULT_HYBRID_SEARCH_CONFIG; } });
+Object.defineProperty(exports, "DEFAULT_BM25_CONFIG", { enumerable: true, get: function () { return types_js_1.DEFAULT_BM25_CONFIG; } });
+Object.defineProperty(exports, "DEFAULT_VECTOR_SEARCH_CONFIG", { enumerable: true, get: function () { return types_js_1.DEFAULT_VECTOR_SEARCH_CONFIG; } });
+Object.defineProperty(exports, "DEFAULT_RRF_CONFIG", { enumerable: true, get: function () { return types_js_1.DEFAULT_RRF_CONFIG; } });
+//# sourceMappingURL=index.js.map

package/dist/code-intelligence/search/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/code-intelligence/search/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,iEAA6D;AAApD,2HAAA,kBAAkB,OAAA;AAE3B,iDAA6C;AAApC,2GAAA,UAAU,OAAA;AACnB,+CAA2C;AAAlC,yGAAA,SAAS,OAAA;AAClB,qDAAiD;AAAxC,+GAAA,YAAY,OAAA;AAErB,uCAeoB;AAJlB,wHAAA,4BAA4B,OAAA;AAC5B,+GAAA,mBAAmB,OAAA;AACnB,wHAAA,4BAA4B,OAAA;AAC5B,8GAAA,kBAAkB,OAAA"}

package/dist/code-intelligence/search/types.d.ts

@@ -0,0 +1,201 @@
+/**
+ * Types for Hybrid Search System
+ *
+ * Combines BM25 keyword search with vector similarity
+ * using Reciprocal Rank Fusion (RRF) for optimal results.
+ */
+export interface SearchResult {
+    /** Chunk or document ID */
+    id: string;
+    /** File path */
+    filePath: string;
+    /** Content snippet */
+    content: string;
+    /** Start line */
+    startLine: number;
+    /** End line */
+    endLine: number;
+    /** Final combined score */
+    score: number;
+    /** BM25 score component */
+    bm25Score?: number;
+    /** Vector similarity score component */
+    vectorScore?: number;
+    /** Entity type if applicable */
+    entityType?: string;
+    /** Entity name if applicable */
+    entityName?: string;
+    /** Highlighted matches for display */
+    highlights?: string[];
+}
+export interface SearchResponse {
+    /** Search results ordered by relevance */
+    results: SearchResult[];
+    /** Original query */
+    query: string;
+    /** Total matches found */
+    totalMatches: number;
+    /** Search execution time (ms) */
+    searchTimeMs: number;
+    /** Search statistics */
+    stats: SearchStats;
+}
+export interface SearchStats {
+    /** BM25 candidates evaluated */
+    bm25Candidates: number;
+    /** Vector candidates evaluated */
+    vectorCandidates: number;
+    /** Final results after fusion */
+    fusedResults: number;
+    /** BM25 search time (ms) */
+    bm25TimeMs: number;
+    /** Vector search time (ms) */
+    vectorTimeMs: number;
+    /** Fusion time (ms) */
+    fusionTimeMs: number;
+}
+export interface HybridSearchConfig {
+    /**
+     * Number of results to return.
+     * Default: 10
+     */
+    topK: number;
+    /**
+     * Weight for BM25 scores (0-1).
+     * Default: 0.5
+     */
+    bm25Weight: number;
+    /**
+     * Weight for vector scores (0-1).
+     * Default: 0.5
+     */
+    vectorWeight: number;
+    /**
+     * RRF constant k for rank fusion.
+     * Higher = more weight to lower ranks.
+     * Default: 60
+     */
+    rrfK: number;
+    /**
+     * Minimum score threshold.
+     * Default: 0.1
+     */
+    minScore: number;
+    /**
+     * Whether to use RRF or weighted sum.
+     * Default: true (use RRF)
+     */
+    useRRF: boolean;
+    /**
+     * Number of candidates to fetch from each method.
+     * Default: 50
+     */
+    candidateMultiplier: number;
+    /**
+     * Whether to include highlights.
+     * Default: true
+     */
+    includeHighlights: boolean;
+}
+export interface BM25Config {
+    /**
+     * Term frequency saturation parameter.
+     * Higher = diminishing returns for term frequency.
+     * Default: 1.2
+     */
+    k1: number;
+    /**
+     * Length normalization parameter.
+     * 0 = no normalization, 1 = full normalization.
+     * Default: 0.75
+     */
+    b: number;
+    /**
+     * Minimum document frequency for term inclusion.
+     * Default: 1
+     */
+    minDocFreq: number;
+    /**
+     * Maximum document frequency ratio for term exclusion.
+     * Terms in more than this ratio of docs are excluded.
+     * Default: 0.9
+     */
+    maxDocFreqRatio: number;
+}
+export interface BM25Index {
+    /** Document count */
+    docCount: number;
+    /** Average document length */
+    avgDocLength: number;
+    /** Term -> document frequency */
+    documentFrequency: Map<string, number>;
+    /** Document ID -> term frequencies */
+    termFrequencies: Map<string, Map<string, number>>;
+    /** Document ID -> document length */
+    documentLengths: Map<string, number>;
+    /** Document ID -> original content */
+    documents: Map<string, BM25Document>;
+}
+export interface BM25Document {
+    /** Document ID */
+    id: string;
+    /** File path */
+    filePath: string;
+    /** Original content */
+    content: string;
+    /** Start line */
+    startLine: number;
+    /** End line */
+    endLine: number;
+    /** Tokenized terms */
+    terms: string[];
+    /** Entity type */
+    entityType?: string;
+    /** Entity name */
+    entityName?: string;
+}
+export interface VectorSearchConfig {
+    /**
+     * Similarity metric.
+     * Default: 'cosine'
+     */
+    metric: 'cosine' | 'euclidean' | 'dot';
+    /**
+     * Minimum similarity threshold.
+     * Default: 0.5
+     */
+    minSimilarity: number;
+    /**
+     * Whether to normalize vectors.
+     * Default: true
+     */
+    normalize: boolean;
+}
+export interface RRFConfig {
+    /**
+     * RRF constant k.
+     * Lower = more weight to top ranks.
+     * Default: 60
+     */
+    k: number;
+    /**
+     * Minimum number of sources agreeing on result.
+     * Default: 1
+     */
+    minSourceAgreement: number;
+}
+export interface RRFRanking {
+    /** Document ID */
+    id: string;
+    /** Ranks from each source [bm25Rank, vectorRank] */
+    ranks: number[];
+    /** RRF score */
+    rrfScore: number;
+    /** Original scores [bm25Score, vectorScore] */
+    originalScores: number[];
+}
+export declare const DEFAULT_HYBRID_SEARCH_CONFIG: HybridSearchConfig;
+export declare const DEFAULT_BM25_CONFIG: BM25Config;
+export declare const DEFAULT_VECTOR_SEARCH_CONFIG: VectorSearchConfig;
+export declare const DEFAULT_RRF_CONFIG: RRFConfig;
+//# sourceMappingURL=types.d.ts.map

package/dist/code-intelligence/search/types.d.ts.map

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

package/dist/code-intelligence/search/types.js

@@ -0,0 +1,35 @@
+"use strict";
+/**
+ * Types for Hybrid Search System
+ *
+ * Combines BM25 keyword search with vector similarity
+ * using Reciprocal Rank Fusion (RRF) for optimal results.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_RRF_CONFIG = exports.DEFAULT_VECTOR_SEARCH_CONFIG = exports.DEFAULT_BM25_CONFIG = exports.DEFAULT_HYBRID_SEARCH_CONFIG = void 0;
+exports.DEFAULT_HYBRID_SEARCH_CONFIG = {
+    topK: 10,
+    bm25Weight: 0.5,
+    vectorWeight: 0.5,
+    rrfK: 60,
+    minScore: 0.1,
+    useRRF: true,
+    candidateMultiplier: 5,
+    includeHighlights: true,
+};
+exports.DEFAULT_BM25_CONFIG = {
+    k1: 1.2,
+    b: 0.75,
+    minDocFreq: 1,
+    maxDocFreqRatio: 0.9,
+};
+exports.DEFAULT_VECTOR_SEARCH_CONFIG = {
+    metric: 'cosine',
+    minSimilarity: 0.5,
+    normalize: true,
+};
+exports.DEFAULT_RRF_CONFIG = {
+    k: 60,
+    minSourceAgreement: 1,
+};
+//# sourceMappingURL=types.js.map

package/dist/code-intelligence/search/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/code-intelligence/search/types.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAyPU,QAAA,4BAA4B,GAAuB;IAC9D,IAAI,EAAE,EAAE;IACR,UAAU,EAAE,GAAG;IACf,YAAY,EAAE,GAAG;IACjB,IAAI,EAAE,EAAE;IACR,QAAQ,EAAE,GAAG;IACb,MAAM,EAAE,IAAI;IACZ,mBAAmB,EAAE,CAAC;IACtB,iBAAiB,EAAE,IAAI;CACxB,CAAC;AAEW,QAAA,mBAAmB,GAAe;IAC7C,EAAE,EAAE,GAAG;IACP,CAAC,EAAE,IAAI;IACP,UAAU,EAAE,CAAC;IACb,eAAe,EAAE,GAAG;CACrB,CAAC;AAEW,QAAA,4BAA4B,GAAuB;IAC9D,MAAM,EAAE,QAAQ;IAChB,aAAa,EAAE,GAAG;IAClB,SAAS,EAAE,IAAI;CAChB,CAAC;AAEW,QAAA,kBAAkB,GAAc;IAC3C,CAAC,EAAE,EAAE;IACL,kBAAkB,EAAE,CAAC;CACtB,CAAC"}