aidex-graphra 1.0.0

package/dist/search.js

@@ -0,0 +1,252 @@
+"use strict";
+/**
+ * Hybrid Search Engine — combines:
+ *   1. Neural embeddings (TransformersJS all-MiniLM-L6-v2) for semantic search
+ *   2. BM25 full-text search for exact keyword matching
+ *   3. PageRank importance scores from the dependency graph
+ *
+ * All 100% local, zero API keys.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.computePageRank = computePageRank;
+exports.getGitRecencyScores = getGitRecencyScores;
+exports.hybridSearch = hybridSearch;
+const storage_1 = require("./storage");
+// ============================================
+// BM25 Full-Text Search
+// ============================================
+const STOP_WORDS = new Set([
+    "a", "an", "the", "is", "are", "was", "were", "be", "been", "being",
+    "have", "has", "had", "do", "does", "did", "will", "would", "could",
+    "should", "may", "might", "shall", "can", "need", "to", "of", "in",
+    "for", "on", "with", "at", "by", "from", "as", "into", "through",
+    "during", "before", "after", "between", "out", "off", "over", "under",
+    "again", "then", "once", "here", "there", "when", "where", "why", "how",
+    "all", "each", "every", "both", "few", "more", "most", "other", "some",
+    "no", "nor", "not", "only", "so", "than", "too", "very", "just",
+    "because", "but", "and", "or", "if", "while", "that", "this", "it",
+    "its", "which", "what", "who", "whom", "these", "those",
+]);
+/** Tokenize text for BM25 — split camelCase, lowercase, remove stopwords */
+function tokenize(text) {
+    return text
+        .replace(/([a-z])([A-Z])/g, "$1 $2")
+        .replace(/([A-Z]+)([A-Z][a-z])/g, "$1 $2")
+        .toLowerCase()
+        .replace(/[^a-z0-9]/g, " ")
+        .split(/\s+/)
+        .filter((t) => t.length > 1 && !STOP_WORDS.has(t));
+}
+/** BM25 scoring parameters */
+const BM25_K1 = 1.2;
+const BM25_B = 0.75;
+/** Compute BM25 scores for a query against a set of documents */
+function bm25Search(queryTokens, docs, topK) {
+    const N = docs.length;
+    const avgDl = docs.reduce((sum, d) => sum + d.length, 0) / (N || 1);
+    // Document frequency for each term
+    const df = new Map();
+    for (const doc of docs) {
+        const uniqueTerms = new Set(doc.tokens);
+        for (const term of uniqueTerms) {
+            df.set(term, (df.get(term) ?? 0) + 1);
+        }
+    }
+    // Score each document
+    const scores = new Map();
+    for (const doc of docs) {
+        let score = 0;
+        const termFreq = new Map();
+        for (const t of doc.tokens) {
+            termFreq.set(t, (termFreq.get(t) ?? 0) + 1);
+        }
+        for (const qt of queryTokens) {
+            const tf = termFreq.get(qt) ?? 0;
+            if (tf === 0)
+                continue;
+            const docFreq = df.get(qt) ?? 0;
+            const idf = Math.log((N - docFreq + 0.5) / (docFreq + 0.5) + 1);
+            const tfNorm = (tf * (BM25_K1 + 1)) / (tf + BM25_K1 * (1 - BM25_B + BM25_B * (doc.length / avgDl)));
+            score += idf * tfNorm;
+        }
+        if (score > 0) {
+            scores.set(doc.id, score);
+        }
+    }
+    return scores;
+}
+// ============================================
+// PageRank Importance
+// ============================================
+/**
+ * Compute PageRank scores for files in the dependency graph.
+ * Files that are imported by many other files get higher scores.
+ */
+function computePageRank(graph, damping = 0.85, iterations = 20) {
+    const files = new Set();
+    for (const [src, targets] of Object.entries(graph)) {
+        files.add(src);
+        for (const t of targets)
+            files.add(t);
+    }
+    const N = files.size;
+    if (N === 0)
+        return new Map();
+    // Initialize scores
+    const scores = new Map();
+    for (const f of files)
+        scores.set(f, 1 / N);
+    // Build reverse graph (who imports this file?)
+    const reverseGraph = new Map();
+    for (const f of files)
+        reverseGraph.set(f, []);
+    for (const [src, targets] of Object.entries(graph)) {
+        for (const t of targets) {
+            reverseGraph.get(t)?.push(src);
+        }
+    }
+    // Outgoing link count
+    const outCount = new Map();
+    for (const [src, targets] of Object.entries(graph)) {
+        outCount.set(src, targets.length);
+    }
+    // Iterate
+    for (let i = 0; i < iterations; i++) {
+        const newScores = new Map();
+        for (const f of files) {
+            let sum = 0;
+            for (const src of reverseGraph.get(f) ?? []) {
+                sum += (scores.get(src) ?? 0) / (outCount.get(src) ?? 1);
+            }
+            newScores.set(f, (1 - damping) / N + damping * sum);
+        }
+        for (const [f, s] of newScores)
+            scores.set(f, s);
+    }
+    return scores;
+}
+// ============================================
+// Cosine Similarity
+// ============================================
+function cosineSimilarity(a, b) {
+    if (a.length !== b.length || a.length === 0)
+        return 0;
+    let dot = 0, normA = 0, normB = 0;
+    for (let i = 0; i < a.length; i++) {
+        dot += a[i] * b[i];
+        normA += a[i] * a[i];
+        normB += b[i] * b[i];
+    }
+    const denom = Math.sqrt(normA) * Math.sqrt(normB);
+    return denom === 0 ? 0 : dot / denom;
+}
+// ============================================
+// Git Recency Scoring
+// ============================================
+/**
+ * Get git recency scores for files — recently modified files rank higher.
+ * Uses `git log` to get last commit timestamp per file.
+ */
+function getGitRecencyScores(files) {
+    const scores = new Map();
+    try {
+        const { execSync } = require("child_process");
+        // Get last commit time for each tracked file
+        const output = execSync('git log --format="%at %H" --name-only --diff-filter=ACMR -n 200', { encoding: "utf-8", timeout: 5000, stdio: ["pipe", "pipe", "pipe"] });
+        const now = Date.now() / 1000;
+        const lines = output.split("\n");
+        let currentTimestamp = 0;
+        for (const line of lines) {
+            const tsMatch = line.match(/^(\d+)\s+[a-f0-9]+$/);
+            if (tsMatch) {
+                currentTimestamp = parseInt(tsMatch[1]);
+                continue;
+            }
+            const filePath = line.trim();
+            if (filePath && currentTimestamp && !scores.has(filePath)) {
+                // Decay: files modified recently get higher scores
+                // Score = 1.0 for today, ~0.5 for 7 days ago, ~0.1 for 30 days ago
+                const ageInDays = (now - currentTimestamp) / 86400;
+                const recency = Math.exp(-ageInDays / 10); // exponential decay, half-life ~7 days
+                scores.set(filePath, recency);
+            }
+        }
+    }
+    catch {
+        // Git not available or not a git repo — skip recency
+    }
+    return scores;
+}
+/**
+ * Hybrid search combining BM25 + neural embeddings + PageRank.
+ *
+ * @param query - The search query
+ * @param queryEmbedding - Pre-computed embedding for the query (or null to skip)
+ * @param graph - Dependency graph for PageRank
+ * @param options - Tuning parameters
+ */
+function hybridSearch(query, queryEmbedding, graph, options = {}) {
+    const { topK = 10, bm25Weight = 0.30, embeddingWeight = 0.40, pageRankWeight = 0.10, nameBoost = 0.10, gitRecencyWeight = 0.10, } = options;
+    const chunks = (0, storage_1.getAllChunks)();
+    if (chunks.length === 0)
+        return [];
+    const embeddings = (0, storage_1.getAllEmbeddings)();
+    const pageRankScores = computePageRank(graph);
+    const gitScores = getGitRecencyScores(chunks.map((c) => c.file));
+    // --- BM25 ---
+    const queryTokens = tokenize(query);
+    const bm25Docs = chunks.map((c) => {
+        const text = `${c.name} ${c.signature} ${c.summary}`;
+        const tokens = tokenize(text);
+        return { id: c.id, tokens, length: tokens.length };
+    });
+    const bm25Scores = bm25Search(queryTokens, bm25Docs, topK * 3);
+    // Normalize BM25 scores to 0-1
+    const maxBm25 = Math.max(...Array.from(bm25Scores.values()), 0.001);
+    // --- Combine scores ---
+    const finalScores = [];
+    for (const chunk of chunks) {
+        let score = 0;
+        // BM25 component
+        const bm25 = (bm25Scores.get(chunk.id) ?? 0) / maxBm25;
+        score += bm25 * bm25Weight;
+        // Embedding component
+        if (queryEmbedding && embeddings.has(chunk.id)) {
+            const chunkEmb = embeddings.get(chunk.id);
+            const sim = cosineSimilarity(queryEmbedding, chunkEmb);
+            score += sim * embeddingWeight;
+        }
+        // PageRank component (file-level importance)
+        const fileRank = pageRankScores.get(chunk.file) ?? 0;
+        const maxRank = Math.max(...Array.from(pageRankScores.values()), 0.001);
+        score += (fileRank / maxRank) * pageRankWeight;
+        // Git recency component
+        // Try matching by relative path fragments
+        const fileShort = chunk.file.replace(/\\/g, "/");
+        let gitRecency = 0;
+        for (const [gitFile, recency] of gitScores) {
+            if (fileShort.endsWith(gitFile) || gitFile.endsWith(fileShort.split("/").slice(-2).join("/"))) {
+                gitRecency = recency;
+                break;
+            }
+        }
+        score += gitRecency * gitRecencyWeight;
+        // Name match boost
+        const nameParts = chunk.name
+            .replace(/([a-z])([A-Z])/g, "$1 $2")
+            .replace(/\./g, " ")
+            .toLowerCase()
+            .split(/\s+/);
+        for (const qt of queryTokens) {
+            if (nameParts.some((np) => np === qt || np.includes(qt))) {
+                score += nameBoost;
+            }
+        }
+        if (score > 0) {
+            finalScores.push({ chunk: chunk, score });
+        }
+    }
+    finalScores.sort((a, b) => b.score - a.score);
+    return finalScores.slice(0, topK);
+}
+//# sourceMappingURL=search.js.map

package/dist/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../src/search.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;AAiGH,0CA+CC;AAuCD,kDAiCC;AAUD,oCAuFC;AAtTD,uCAAkE;AAElE,+CAA+C;AAC/C,wBAAwB;AACxB,+CAA+C;AAE/C,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC;IACzB,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO;IACnE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO;IACnE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;IAClE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS;IAChE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO;IACrE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK;IACvE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;IACtE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM;IAC/D,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI;IAClE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO;CACxD,CAAC,CAAC;AAEH,4EAA4E;AAC5E,SAAS,QAAQ,CAAC,IAAY;IAC5B,OAAO,IAAI;SACR,OAAO,CAAC,iBAAiB,EAAE,OAAO,CAAC;SACnC,OAAO,CAAC,uBAAuB,EAAE,OAAO,CAAC;SACzC,WAAW,EAAE;SACb,OAAO,CAAC,YAAY,EAAE,GAAG,CAAC;SAC1B,KAAK,CAAC,KAAK,CAAC;SACZ,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AACvD,CAAC;AAED,8BAA8B;AAC9B,MAAM,OAAO,GAAG,GAAG,CAAC;AACpB,MAAM,MAAM,GAAG,IAAI,CAAC;AAQpB,iEAAiE;AACjE,SAAS,UAAU,CACjB,WAAqB,EACrB,IAAe,EACf,IAAY;IAEZ,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;IACtB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAEpE,mCAAmC;IACnC,MAAM,EAAE,GAAG,IAAI,GAAG,EAAkB,CAAC;IACrC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACxC,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;YAC/B,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;IAED,sBAAsB;IACtB,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACzC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;QAC3C,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;YAC3B,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAC9C,CAAC;QAED,KAAK,MAAM,EAAE,IAAI,WAAW,EAAE,CAAC;YAC7B,MAAM,EAAE,GAAG,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;YACjC,IAAI,EAAE,KAAK,CAAC;gBAAE,SAAS;YAEvB,MAAM,OAAO,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;YAChC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,OAAO,GAAG,GAAG,CAAC,GAAG,CAAC,OAAO,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;YAChE,MAAM,MAAM,GAAG,CAAC,EAAE,GAAG,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,GAAG,OAAO,GAAG,CAAC,CAAC,GAAG,MAAM,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YAEpG,KAAK,IAAI,GAAG,GAAG,MAAM,CAAC;QACxB,CAAC;QAED,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACd,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,+CAA+C;AAC/C,sBAAsB;AACtB,+CAA+C;AAE/C;;;GAGG;AACH,SAAgB,eAAe,CAC7B,KAAsB,EACtB,UAAkB,IAAI,EACtB,aAAqB,EAAE;IAEvB,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,KAAK,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACnD,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACf,KAAK,MAAM,CAAC,IAAI,OAAO;YAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACxC,CAAC;IAED,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC;IACrB,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,GAAG,EAAE,CAAC;IAE9B,oBAAoB;IACpB,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACzC,KAAK,MAAM,CAAC,IAAI,KAAK;QAAE,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAE5C,+CAA+C;IAC/C,MAAM,YAAY,GAAG,IAAI,GAAG,EAAoB,CAAC;IACjD,KAAK,MAAM,CAAC,IAAI,KAAK;QAAE,YAAY,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC/C,KAAK,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACnD,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IAED,sBAAsB;IACtB,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC3C,KAAK,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACnD,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC;IAED,UAAU;IACV,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,EAAE,CAAC,EAAE,EAAE,CAAC;QACpC,MAAM,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;QAC5C,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,IAAI,GAAG,GAAG,CAAC,CAAC;YACZ,KAAK,MAAM,GAAG,IAAI,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;gBAC5C,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;YAC3D,CAAC;YACD,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,OAAO,GAAG,GAAG,CAAC,CAAC;QACtD,CAAC;QACD,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,SAAS;YAAE,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACnD,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,+CAA+C;AAC/C,oBAAoB;AACpB,+CAA+C;AAE/C,SAAS,gBAAgB,CAAC,CAAW,EAAE,CAAW;IAChD,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACtD,IAAI,GAAG,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC;IAClC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACnB,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACrB,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACvB,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClD,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,KAAK,CAAC;AACvC,CAAC;AAeD,+CAA+C;AAC/C,sBAAsB;AACtB,+CAA+C;AAE/C;;;GAGG;AACH,SAAgB,mBAAmB,CAAC,KAAe;IACjD,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACzC,IAAI,CAAC;QACH,MAAM,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;QAC9C,6CAA6C;QAC7C,MAAM,MAAM,GAAG,QAAQ,CACrB,iEAAiE,EACjE,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CACtE,CAAC;QAEF,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;QAC9B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,gBAAgB,GAAG,CAAC,CAAC;QAEzB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;YAClD,IAAI,OAAO,EAAE,CAAC;gBACZ,gBAAgB,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;gBACxC,SAAS;YACX,CAAC;YACD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;YAC7B,IAAI,QAAQ,IAAI,gBAAgB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC1D,mDAAmD;gBACnD,mEAAmE;gBACnE,MAAM,SAAS,GAAG,CAAC,GAAG,GAAG,gBAAgB,CAAC,GAAG,KAAK,CAAC;gBACnD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,SAAS,GAAG,EAAE,CAAC,CAAC,CAAC,uCAAuC;gBAClF,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YAChC,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,qDAAqD;IACvD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,YAAY,CAC1B,KAAa,EACb,cAA+B,EAC/B,KAAsB,EACtB,UAA+B,EAAE;IAEjC,MAAM,EACJ,IAAI,GAAG,EAAE,EACT,UAAU,GAAG,IAAI,EACjB,eAAe,GAAG,IAAI,EACtB,cAAc,GAAG,IAAI,EACrB,SAAS,GAAG,IAAI,EAChB,gBAAgB,GAAG,IAAI,GACxB,GAAG,OAAO,CAAC;IAEZ,MAAM,MAAM,GAAG,IAAA,sBAAY,GAAE,CAAC;IAC9B,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEnC,MAAM,UAAU,GAAG,IAAA,0BAAgB,GAAE,CAAC;IACtC,MAAM,cAAc,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IAC9C,MAAM,SAAS,GAAG,mBAAmB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAEjE,eAAe;IACf,MAAM,WAAW,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IACpC,MAAM,QAAQ,GAAc,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QAC3C,MAAM,IAAI,GAAG,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;QACrD,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC9B,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;IACrD,CAAC,CAAC,CAAC;IACH,MAAM,UAAU,GAAG,UAAU,CAAC,WAAW,EAAE,QAAQ,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC;IAE/D,+BAA+B;IAC/B,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC;IAEpE,yBAAyB;IACzB,MAAM,WAAW,GAAsC,EAAE,CAAC;IAE1D,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,KAAK,GAAG,CAAC,CAAC;QAEd,iBAAiB;QACjB,MAAM,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,OAAO,CAAC;QACvD,KAAK,IAAI,IAAI,GAAG,UAAU,CAAC;QAE3B,sBAAsB;QACtB,IAAI,cAAc,IAAI,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;YAC/C,MAAM,QAAQ,GAAG,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAE,CAAC;YAC3C,MAAM,GAAG,GAAG,gBAAgB,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;YACvD,KAAK,IAAI,GAAG,GAAG,eAAe,CAAC;QACjC,CAAC;QAED,6CAA6C;QAC7C,MAAM,QAAQ,GAAG,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC;QACxE,KAAK,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,GAAG,cAAc,CAAC;QAE/C,wBAAwB;QACxB,0CAA0C;QAC1C,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACjD,IAAI,UAAU,GAAG,CAAC,CAAC;QACnB,KAAK,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,SAAS,EAAE,CAAC;YAC3C,IAAI,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;gBAC9F,UAAU,GAAG,OAAO,CAAC;gBACrB,MAAM;YACR,CAAC;QACH,CAAC;QACD,KAAK,IAAI,UAAU,GAAG,gBAAgB,CAAC;QAEvC,mBAAmB;QACnB,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI;aACzB,OAAO,CAAC,iBAAiB,EAAE,OAAO,CAAC;aACnC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;aACnB,WAAW,EAAE;aACb,KAAK,CAAC,KAAK,CAAC,CAAC;QAChB,KAAK,MAAM,EAAE,IAAI,WAAW,EAAE,CAAC;YAC7B,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;gBACzD,KAAK,IAAI,SAAS,CAAC;YACrB,CAAC;QACH,CAAC;QAED,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACd,WAAW,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAc,EAAE,KAAK,EAAE,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;IAED,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IAC9C,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;AACpC,CAAC"}

package/dist/signatureExtractor.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Signature Extractor — Aider-style approach.
+ *
+ * Instead of generating text summaries, we extract the ACTUAL code signature
+ * (function declaration line, class declaration, interface shape, etc.)
+ * This is what gets stored and shown to the AI — real code, not lossy summaries.
+ */
+import { Chunk } from "./types";
+/**
+ * Extract the signature (declaration line) from a chunk's code.
+ * Returns the actual code line(s) that define the function/class/interface.
+ *
+ * Examples:
+ *   "export async function ssoLogin(accessToken, newUser, session, sessionDetails, keepSessionActive) {"
+ *   "class CronJobScheduler {"
+ *   "interface ScanConfig { include: string[]; ignore: string[]; }"
+ */
+export declare function extractSignature(chunk: Chunk): string;
+/**
+ * Build a compact text representation for embedding/search.
+ * Combines: file path + name + signature + JSDoc (if any) + body keywords.
+ * This is what gets embedded — NOT the full code.
+ */
+export declare function buildSearchableText(chunk: Chunk, signature: string): string;
+//# sourceMappingURL=signatureExtractor.d.ts.map

package/dist/signatureExtractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signatureExtractor.d.ts","sourceRoot":"","sources":["../src/signatureExtractor.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAuBrD;AAmID;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CA8B3E"}

package/dist/signatureExtractor.js

@@ -0,0 +1,173 @@
+"use strict";
+/**
+ * Signature Extractor — Aider-style approach.
+ *
+ * Instead of generating text summaries, we extract the ACTUAL code signature
+ * (function declaration line, class declaration, interface shape, etc.)
+ * This is what gets stored and shown to the AI — real code, not lossy summaries.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractSignature = extractSignature;
+exports.buildSearchableText = buildSearchableText;
+/**
+ * Extract the signature (declaration line) from a chunk's code.
+ * Returns the actual code line(s) that define the function/class/interface.
+ *
+ * Examples:
+ *   "export async function ssoLogin(accessToken, newUser, session, sessionDetails, keepSessionActive) {"
+ *   "class CronJobScheduler {"
+ *   "interface ScanConfig { include: string[]; ignore: string[]; }"
+ */
+function extractSignature(chunk) {
+    const code = chunk.code;
+    const lines = code.split("\n");
+    switch (chunk.type) {
+        case "interface":
+        case "type-alias":
+            return extractInterfaceSignature(lines, chunk.name);
+        case "class":
+            return extractClassSignature(lines, chunk.name);
+        case "function":
+        case "method":
+        case "arrow-function":
+            return extractFunctionSignature(lines, chunk.name);
+        case "constant":
+            return extractConstantSignature(lines, chunk.name);
+        default:
+            return lines[0]?.trim() ?? chunk.name;
+    }
+}
+/** Extract function/method signature up to the opening brace */
+function extractFunctionSignature(lines, name) {
+    // Skip JSDoc/comments
+    let start = 0;
+    while (start < lines.length &&
+        (lines[start].trim().startsWith("*") ||
+            lines[start].trim().startsWith("/**") ||
+            lines[start].trim().startsWith("//") ||
+            lines[start].trim().startsWith("/*") ||
+            lines[start].trim() === "")) {
+        start++;
+    }
+    // Collect lines until we hit the opening brace
+    let sig = "";
+    for (let i = start; i < lines.length && i < start + 10; i++) {
+        const line = lines[i].trim();
+        sig += (sig ? " " : "") + line;
+        if (line.includes("{")) {
+            // Remove everything after the opening brace
+            sig = sig.replace(/\s*\{[\s\S]*$/, "").trim();
+            break;
+        }
+        if (line.includes("=>")) {
+            // Arrow function — keep up to =>
+            sig = sig.replace(/\s*=>[\s\S]*$/, " =>").trim();
+            break;
+        }
+    }
+    return sig || name;
+}
+/** Extract class signature (class name + constructor params if present) */
+function extractClassSignature(lines, name) {
+    // Get the class declaration line
+    const classLine = lines.find((l) => /^\s*(?:export\s+)?class\s/.test(l));
+    if (!classLine)
+        return `class ${name}`;
+    let sig = classLine.trim();
+    if (sig.includes("{")) {
+        sig = sig.replace(/\s*\{.*$/, "").trim();
+    }
+    // Also extract method names for a compact overview
+    const methods = [];
+    for (const line of lines) {
+        // Match method declarations: "  methodName(" or "  async methodName("
+        const methodMatch = line.match(/^\s+(?:async\s+)?(\w+)\s*\(/);
+        if (methodMatch && methodMatch[1] !== "constructor") {
+            methods.push(methodMatch[1]);
+        }
+    }
+    if (methods.length > 0) {
+        sig += ` { ${methods.join(", ")} }`;
+    }
+    return sig;
+}
+/** Extract interface/type signature with member names */
+function extractInterfaceSignature(lines, name) {
+    // Get the declaration line
+    const declLine = lines.find((l) => /^\s*(?:export\s+)?(?:interface|type)\s/.test(l));
+    if (!declLine)
+        return `interface ${name}`;
+    // For short interfaces, return the whole thing (up to 200 chars)
+    const fullCode = lines.join("\n").trim();
+    if (fullCode.length <= 200) {
+        return fullCode;
+    }
+    // For longer ones, extract member names
+    const members = [];
+    for (const line of lines) {
+        const memberMatch = line.match(/^\s+(\w+)\s*[?]?\s*:/);
+        if (memberMatch) {
+            members.push(memberMatch[1]);
+        }
+    }
+    let sig = declLine.trim();
+    if (sig.includes("{")) {
+        sig = sig.replace(/\s*\{.*$/, "").trim();
+    }
+    if (members.length > 0) {
+        sig += ` { ${members.join(", ")} }`;
+    }
+    return sig;
+}
+/** Extract constant signature */
+function extractConstantSignature(lines, name) {
+    // Skip comments
+    let start = 0;
+    while (start < lines.length &&
+        (lines[start].trim().startsWith("*") ||
+            lines[start].trim().startsWith("/**") ||
+            lines[start].trim().startsWith("//") ||
+            lines[start].trim().startsWith("/*") ||
+            lines[start].trim() === "")) {
+        start++;
+    }
+    const line = lines[start]?.trim() ?? `const ${name}`;
+    // If it's a short one-liner, return it
+    if (line.length <= 150)
+        return line;
+    // Otherwise truncate
+    return line.slice(0, 150) + "...";
+}
+/**
+ * Build a compact text representation for embedding/search.
+ * Combines: file path + name + signature + JSDoc (if any) + body keywords.
+ * This is what gets embedded — NOT the full code.
+ */
+function buildSearchableText(chunk, signature) {
+    const parts = [];
+    // File context (just the filename, not full path)
+    const fileName = chunk.file.split(/[/\\]/).pop() ?? "";
+    parts.push(fileName);
+    // Humanized name
+    const humanName = chunk.name
+        .replace(/([a-z])([A-Z])/g, "$1 $2")
+        .replace(/([A-Z]+)([A-Z][a-z])/g, "$1 $2")
+        .replace(/\./g, " ")
+        .toLowerCase();
+    parts.push(humanName);
+    // Signature
+    parts.push(signature);
+    // JSDoc if present
+    const jsdocMatch = chunk.code.match(/\/\*\*([\s\S]*?)\*\//);
+    if (jsdocMatch) {
+        const jsdocText = jsdocMatch[1]
+            .split("\n")
+            .map((l) => l.replace(/^\s*\*\s?/, "").trim())
+            .filter((l) => l && !l.startsWith("@"))
+            .join(" ");
+        if (jsdocText)
+            parts.push(jsdocText);
+    }
+    return parts.join(" ");
+}
+//# sourceMappingURL=signatureExtractor.js.map

package/dist/signatureExtractor.js.map

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

package/dist/storage.d.ts

@@ -0,0 +1,59 @@
+import Database from "better-sqlite3";
+import { Chunk, DependencyGraph } from "./types";
+/** Get or create the database connection */
+export declare function getDb(): Database.Database;
+/** Close the database */
+export declare function closeDb(): void;
+/** Upsert a chunk into the database */
+export declare function upsertChunk(chunk: Chunk & {
+    signature: string;
+}): void;
+/** Batch upsert chunks (much faster) */
+export declare function upsertChunks(chunks: (Chunk & {
+    signature: string;
+})[]): void;
+/** Get a chunk by ID */
+export declare function getChunk(id: string): (Chunk & {
+    signature: string;
+}) | null;
+/** Get all chunks */
+export declare function getAllChunks(): (Chunk & {
+    signature: string;
+})[];
+/** Get chunk hash for cache checking */
+export declare function getChunkHash(id: string): string | null;
+/** Get chunk count */
+export declare function getChunkCount(): number;
+/** Store an embedding vector as a binary blob */
+export declare function upsertEmbedding(chunkId: string, vector: number[]): void;
+/** Batch upsert embeddings */
+export declare function upsertEmbeddings(items: {
+    chunkId: string;
+    vector: number[];
+}[]): void;
+/** Get an embedding vector */
+export declare function getEmbedding(chunkId: string): number[] | null;
+/** Get all embeddings as a map */
+export declare function getAllEmbeddings(): Map<string, number[]>;
+/** Save the dependency graph */
+export declare function saveGraph(graph: DependencyGraph): void;
+/** Load the dependency graph */
+export declare function loadGraph(): DependencyGraph;
+export declare function setMeta(key: string, value: string): void;
+export declare function getMeta(key: string): string | null;
+/** Get stored mtime for a file */
+export declare function getFileMtime(filePath: string): number | null;
+/** Upsert file tracking info */
+export declare function upsertFile(filePath: string, mtime: number, hash: string): void;
+/** Get all tracked file paths */
+export declare function getTrackedFiles(): string[];
+/** Remove a file and all its chunks/embeddings */
+export declare function removeFile(filePath: string): void;
+/** Remove chunks for a file (before re-inserting updated ones).
+ *  Uses LIKE matching to handle both relative and absolute paths. */
+export declare function removeChunksForFile(filePath: string): void;
+/** Get chunk IDs that have no embedding yet */
+export declare function getChunksWithoutEmbeddings(): string[];
+/** Clear all data (for full regeneration) */
+export declare function clearAll(): void;
+//# sourceMappingURL=storage.d.ts.map

package/dist/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAGtC,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAkBjD,4CAA4C;AAC5C,wBAAgB,KAAK,IAAI,QAAQ,CAAC,QAAQ,CAsDzC;AAED,yBAAyB;AACzB,wBAAgB,OAAO,IAAI,IAAI,CAK9B;AAMD,uCAAuC;AACvC,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAetE;AAED,wCAAwC;AACxC,wBAAgB,YAAY,CAAC,MAAM,EAAE,CAAC,KAAK,GAAG;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,EAAE,GAAG,IAAI,CAc5E;AAED,wBAAwB;AACxB,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,CAAC,KAAK,GAAG;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,IAAI,CAG3E;AAED,qBAAqB;AACrB,wBAAgB,YAAY,IAAI,CAAC,KAAK,GAAG;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,EAAE,CAGhE;AAED,wCAAwC;AACxC,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAItD;AAED,sBAAsB;AACtB,wBAAgB,aAAa,IAAI,MAAM,CAGtC;AAMD,iDAAiD;AACjD,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAIvE;AAED,8BAA8B;AAC9B,wBAAgB,gBAAgB,CAAC,KAAK,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,EAAE,GAAG,IAAI,CAYrF;AAED,8BAA8B;AAC9B,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CAK7D;AAED,kCAAkC;AAClC,wBAAgB,gBAAgB,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAUxD;AAMD,gCAAgC;AAChC,wBAAgB,SAAS,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,CActD;AAED,gCAAgC;AAChC,wBAAgB,SAAS,IAAI,eAAe,CAS3C;AAMD,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAGxD;AAED,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAIlD;AAMD,kCAAkC;AAClC,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAI5D;AAED,gCAAgC;AAChC,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAG9E;AAED,iCAAiC;AACjC,wBAAgB,eAAe,IAAI,MAAM,EAAE,CAG1C;AAED,kDAAkD;AAClD,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAajD;AAED;qEACqE;AACrE,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAW1D;AAED,+CAA+C;AAC/C,wBAAgB,0BAA0B,IAAI,MAAM,EAAE,CAKrD;AAED,6CAA6C;AAC7C,wBAAgB,QAAQ,IAAI,IAAI,CAG/B"}