vemora 0.1.0-alpha.8

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

@@ -0,0 +1 @@
+{"version":3,"file":"rerank.d.ts","sourceRoot":"","sources":["../../src/search/rerank.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAqClD;;;;;;;;;;;GAWG;AACH,wBAAsB,aAAa,CACjC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,YAAY,EAAE,EACvB,IAAI,GAAE,MAAW,GAChB,OAAO,CAAC,YAAY,EAAE,CAAC,CAuCzB"}

package/dist/search/rerank.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.rerankResults = rerankResults;
+// biome-ignore lint/suspicious/noExplicitAny: @xenova/transformers has no exported TS types
+let model = null;
+// biome-ignore lint/suspicious/noExplicitAny: @xenova/transformers has no exported TS types
+let tokenizer = null;
+/**
+ * Initializes the reranker model and tokenizer if not already loaded.
+ * Model: Xenova/ms-marco-MiniLM-L-6-v2
+ *
+ * Requires the optional peer dependency `@xenova/transformers`:
+ *   npm install @xenova/transformers
+ */
+async function initReranker() {
+    if (!model) {
+        // biome-ignore lint/suspicious/noExplicitAny: dynamic optional dependency
+        let transformers;
+        try {
+            transformers = require("@xenova/transformers");
+        }
+        catch {
+            throw new Error("The --rerank flag requires @xenova/transformers.\n" +
+                "Install it with: npm install @xenova/transformers");
+        }
+        const { AutoModelForSequenceClassification, AutoTokenizer } = transformers;
+        model = await AutoModelForSequenceClassification.from_pretrained("Xenova/ms-marco-MiniLM-L-6-v2", { quantized: false });
+        tokenizer = await AutoTokenizer.from_pretrained("Xenova/ms-marco-MiniLM-L-6-v2");
+    }
+}
+/**
+ * Re-scores search results using a Cross-Encoder model.
+ *
+ * A cross-encoder processes the (query, chunk) pair together,
+ * capturing deep semantic interactions that cosine similarity
+ * (bi-encoder) might miss.
+ *
+ * @param query The user's natural language query
+ * @param results Initial search results (from vector or keyword search)
+ * @param topK Number of results to return after reranking
+ * @returns Re-scored and sorted search results
+ */
+async function rerankResults(query, results, topK = 10) {
+    if (results.length === 0)
+        return [];
+    await initReranker();
+    const reranked = [];
+    // We only rerank the first 25 results to keep it fast
+    const candidates = results.slice(0, 25);
+    for (const res of candidates) {
+        try {
+            // Tokenize the pair
+            const inputs = await tokenizer(query, {
+                text_pair: res.chunk.content,
+                truncation: true,
+                padding: true,
+            });
+            // Get the raw logits
+            const { logits } = await model(inputs);
+            // For this model, the logit at index 0 is the relevance score
+            const score = logits.data[0];
+            reranked.push({
+                ...res,
+                score: score,
+            });
+        }
+        catch (err) {
+            console.warn(`Failed to rerank chunk ${res.chunk.id}:`, err);
+            reranked.push(res);
+        }
+    }
+    // Sort by the new cross-encoder logit (higher is more relevant)
+    reranked.sort((a, b) => b.score - a.score);
+    return reranked.slice(0, topK);
+}
+//# sourceMappingURL=rerank.js.map

package/dist/search/rerank.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rerank.js","sourceRoot":"","sources":["../../src/search/rerank.ts"],"names":[],"mappings":";;AAiDA,sCA2CC;AA1FD,4FAA4F;AAC5F,IAAI,KAAK,GAAQ,IAAI,CAAC;AACtB,4FAA4F;AAC5F,IAAI,SAAS,GAAQ,IAAI,CAAC;AAE1B;;;;;;GAMG;AACH,KAAK,UAAU,YAAY;IACzB,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,0EAA0E;QAC1E,IAAI,YAAiB,CAAC;QACtB,IAAI,CAAC;YACH,YAAY,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;QACjD,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,KAAK,CACb,oDAAoD;gBAClD,mDAAmD,CACtD,CAAC;QACJ,CAAC;QACD,MAAM,EAAE,kCAAkC,EAAE,aAAa,EAAE,GAAG,YAAY,CAAC;QAC3E,KAAK,GAAG,MAAM,kCAAkC,CAAC,eAAe,CAC9D,+BAA+B,EAC/B,EAAE,SAAS,EAAE,KAAK,EAAE,CACrB,CAAC;QACF,SAAS,GAAG,MAAM,aAAa,CAAC,eAAe,CAC7C,+BAA+B,CAChC,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;;;;;;GAWG;AACI,KAAK,UAAU,aAAa,CACjC,KAAa,EACb,OAAuB,EACvB,OAAe,EAAE;IAEjB,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEpC,MAAM,YAAY,EAAE,CAAC;IAErB,MAAM,QAAQ,GAAmB,EAAE,CAAC;IAEpC,sDAAsD;IACtD,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAExC,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC7B,IAAI,CAAC;YACH,oBAAoB;YACpB,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,KAAK,EAAE;gBACpC,SAAS,EAAE,GAAG,CAAC,KAAK,CAAC,OAAO;gBAC5B,UAAU,EAAE,IAAI;gBAChB,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;YAEH,qBAAqB;YACrB,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,CAAC;YAEvC,8DAA8D;YAC9D,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAE7B,QAAQ,CAAC,IAAI,CAAC;gBACZ,GAAG,GAAG;gBACN,KAAK,EAAE,KAAK;aACb,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,IAAI,CAAC,0BAA0B,GAAG,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;YAC7D,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IAED,gEAAgE;IAChE,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IAE3C,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;AACjC,CAAC"}

package/dist/search/signature.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Signature extraction for code chunks.
+ *
+ * Given the raw content of a chunk, returns the declaration signature —
+ * the part that describes *what* exists without the implementation body.
+ * This is used in the query output for medium-relevance results.
+ *
+ * Design philosophy:
+ *   - Interfaces and type aliases ARE their signature → show them in full (compact)
+ *   - Functions and classes → extract up to the opening brace, replace body with { … }
+ *   - Arrow functions with expression bodies → show up to =>
+ *   - Everything else → show first meaningful lines
+ */
+/**
+ * Extracts the declaration signature from a chunk's content.
+ *
+ * Examples:
+ *
+ *   Input:  "export async function connect(\n  host: string,\n): Promise<void> {\n  ..."
+ *   Output: "export async function connect(\n  host: string,\n): Promise<void> { … }"
+ *
+ *   Input:  "export interface ImapConfig {\n  host: string;\n}"
+ *   Output: (same — interfaces are returned as-is, they are compact)
+ *
+ *   Input:  "export const send = async (msg: Email): Promise<void> =>\n  smtp.send(msg);"
+ *   Output: "export const send = async (msg: Email): Promise<void> => …"
+ */
+export declare function extractSignature(content: string): string;
+export type DisplayTier = "high" | "med" | "low";
+/**
+ * Determines how much of a chunk to show based on its rank in results.
+ *
+ *   high (rank 1-3)  → full code block (capped at MAX_HIGH_LINES automatically)
+ *   med  (rank 4-7)  → signature only (declaration without body)
+ *   low  (rank 8+)   → file + symbol + score only (no code)
+ *
+ * The --show-code flag overrides all tiers to show full code.
+ */
+export declare function getDisplayTier(rank: number): DisplayTier;
+/** Lines shown automatically for high-tier results (without --show-code) */
+export declare const HIGH_CODE_LINES = 30;
+//# sourceMappingURL=signature.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"signature.d.ts","sourceRoot":"","sources":["../../src/search/signature.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAmExD;AAID,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,CAAC;AAEjD;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAIxD;AAED,4EAA4E;AAC5E,eAAO,MAAM,eAAe,KAAK,CAAC"}

package/dist/search/signature.js

@@ -0,0 +1,112 @@
+"use strict";
+/**
+ * Signature extraction for code chunks.
+ *
+ * Given the raw content of a chunk, returns the declaration signature —
+ * the part that describes *what* exists without the implementation body.
+ * This is used in the query output for medium-relevance results.
+ *
+ * Design philosophy:
+ *   - Interfaces and type aliases ARE their signature → show them in full (compact)
+ *   - Functions and classes → extract up to the opening brace, replace body with { … }
+ *   - Arrow functions with expression bodies → show up to =>
+ *   - Everything else → show first meaningful lines
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HIGH_CODE_LINES = void 0;
+exports.extractSignature = extractSignature;
+exports.getDisplayTier = getDisplayTier;
+const MAX_SIG_LINES = 10;
+// ─── Public API ───────────────────────────────────────────────────────────────
+/**
+ * Extracts the declaration signature from a chunk's content.
+ *
+ * Examples:
+ *
+ *   Input:  "export async function connect(\n  host: string,\n): Promise<void> {\n  ..."
+ *   Output: "export async function connect(\n  host: string,\n): Promise<void> { … }"
+ *
+ *   Input:  "export interface ImapConfig {\n  host: string;\n}"
+ *   Output: (same — interfaces are returned as-is, they are compact)
+ *
+ *   Input:  "export const send = async (msg: Email): Promise<void> =>\n  smtp.send(msg);"
+ *   Output: "export const send = async (msg: Email): Promise<void> => …"
+ */
+function extractSignature(content) {
+    const lines = content.split("\n");
+    const firstMeaningful = lines.find((l) => l.trim().length > 0) ?? "";
+    // ── Interfaces and type aliases ──────────────────────────────────────────
+    // These are inherently compact — the full declaration IS the signature.
+    // Show up to 20 lines (rare for them to be longer).
+    if (/^\s*(export\s+)?(type\s+\w|interface\s+\w)/.test(firstMeaningful)) {
+        const slice = lines.slice(0, 20);
+        if (lines.length > 20)
+            slice.push("  …");
+        return slice.join("\n").trim();
+    }
+    // ── File header / import blocks ──────────────────────────────────────────
+    // Chunks that are just import statements — show first 5 lines.
+    if (/^\s*import\s/.test(firstMeaningful)) {
+        const slice = lines.slice(0, 5);
+        if (lines.length > 5)
+            slice.push(`  … (${lines.length - 5} more lines)`);
+        return slice.join("\n").trim();
+    }
+    // ── Function / class / method declarations ───────────────────────────────
+    const result = [];
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const trimmed = line.trimEnd();
+        // Line ends with opening brace → body starts here.
+        // Captures patterns like:
+        //   ): Promise<void> {
+        //   export class Foo extends Bar {
+        //   } catch (e) {          (skip mid-function braces — result.length guard)
+        if (/\{\s*(\/\/[^\n]*)?\s*$/.test(trimmed)) {
+            // Strip the brace (and any trailing comment) and append { … }
+            const withoutBrace = trimmed
+                .replace(/\s*\{\s*(\/\/[^\n]*)?\s*$/, "")
+                .trimEnd();
+            result.push((withoutBrace !== ""
+                ? withoutBrace
+                : trimmed.replace(/\{.*$/, "").trim()) + " { … }");
+            break;
+        }
+        // Arrow function with expression body:
+        //   const f = (x: number) =>
+        //     x * 2
+        if (trimmed.endsWith("=>") && !trimmed.endsWith("=>>")) {
+            result.push(trimmed + " …");
+            break;
+        }
+        result.push(line);
+        // Single-line declarations ending with `;` (e.g. `declare function f(): void;`)
+        if (result.length === 1 && trimmed.endsWith(";"))
+            break;
+        // Safety cap
+        if (result.length >= MAX_SIG_LINES) {
+            result.push("  …");
+            break;
+        }
+    }
+    return result.join("\n").trim();
+}
+/**
+ * Determines how much of a chunk to show based on its rank in results.
+ *
+ *   high (rank 1-3)  → full code block (capped at MAX_HIGH_LINES automatically)
+ *   med  (rank 4-7)  → signature only (declaration without body)
+ *   low  (rank 8+)   → file + symbol + score only (no code)
+ *
+ * The --show-code flag overrides all tiers to show full code.
+ */
+function getDisplayTier(rank) {
+    if (rank <= 3)
+        return "high";
+    if (rank <= 7)
+        return "med";
+    return "low";
+}
+/** Lines shown automatically for high-tier results (without --show-code) */
+exports.HIGH_CODE_LINES = 30;
+//# sourceMappingURL=signature.js.map

package/dist/search/signature.js.map

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

package/dist/search/vector.d.ts

@@ -0,0 +1,41 @@
+import type { Chunk, EmbeddingCache, SearchResult, SymbolIndex } from "../core/types";
+/**
+ * Computes cosine similarity between two vectors.
+ * Returns a value in [-1, 1]. For normalized embeddings (OpenAI, Ollama)
+ * this is effectively in [0, 1] for semantically related pairs.
+ */
+export declare function cosineSimilarity(a: number[], b: number[]): number;
+/**
+ * Fast cosine similarity between a number[] and a Float32Array slice.
+ */
+export declare function cosineSimilarityBinary(query: number[], vectors: Float32Array, offset: number, dims: number): number;
+/**
+ * Performs an exhaustive nearest-neighbor search over all cached embeddings.
+ *
+ * Uses HNSW (O(log N)) when the index is available in the cache.
+ * Falls back to exhaustive O(n * d) cosine search on the contiguous
+ * Float32Array buffer if the HNSW index is missing or fails to load.
+ */
+export declare function vectorSearch(queryEmbedding: number[], chunks: Chunk[], cache: EmbeddingCache, symbols: SymbolIndex, topK?: number): SearchResult[];
+/**
+ * Direct symbol lookup — bypasses embedding when the query matches a known
+ * symbol name. Returns chunks for matched symbols scored by match quality.
+ *
+ * Match tiers (in order of precedence):
+ *   1.0 — exact match: query === symbolName (case-insensitive)
+ *   0.95 — single-word match: one word in query === symbolName
+ *   0.80 — prefix match: symbolName starts with a query word (or vice versa)
+ *
+ * Returns [] if no symbol matches (caller should fall through to vector/BM25).
+ * Only activates for narrow queries (≤5 matches) to avoid false positives on
+ * generic names like "connect" or "init".
+ */
+export declare function symbolLookup(query: string, chunks: Chunk[], symbols: SymbolIndex): SearchResult[];
+/**
+ * TF-based keyword search — used as fallback when embeddings are not available.
+ *
+ * Scores each chunk by term frequency normalized by content length.
+ * Not as powerful as semantic search but requires no embedding service.
+ */
+export declare function keywordSearch(query: string, chunks: Chunk[], symbols: SymbolIndex, topK?: number): SearchResult[];
+//# sourceMappingURL=vector.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"vector.d.ts","sourceRoot":"","sources":["../../src/search/vector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,KAAK,EACL,cAAc,EACd,YAAY,EACZ,WAAW,EACZ,MAAM,eAAe,CAAC;AAIvB;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAejE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,EAAE,EACf,OAAO,EAAE,YAAY,EACrB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,GACX,MAAM,CAcR;AAID;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,cAAc,EAAE,MAAM,EAAE,EACxB,MAAM,EAAE,KAAK,EAAE,EACf,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,WAAW,EACpB,IAAI,SAAK,GACR,YAAY,EAAE,CA4DhB;AAID;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,KAAK,EAAE,EACf,OAAO,EAAE,WAAW,GACnB,YAAY,EAAE,CA+BhB;AAID;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,KAAK,EAAE,EACf,OAAO,EAAE,WAAW,EACpB,IAAI,SAAK,GACR,YAAY,EAAE,CAyChB"}

package/dist/search/vector.js

@@ -0,0 +1,185 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cosineSimilarity = cosineSimilarity;
+exports.cosineSimilarityBinary = cosineSimilarityBinary;
+exports.vectorSearch = vectorSearch;
+exports.symbolLookup = symbolLookup;
+exports.keywordSearch = keywordSearch;
+// ─── Cosine Similarity ────────────────────────────────────────────────────────
+/**
+ * Computes cosine similarity between two vectors.
+ * Returns a value in [-1, 1]. For normalized embeddings (OpenAI, Ollama)
+ * this is effectively in [0, 1] for semantically related pairs.
+ */
+function cosineSimilarity(a, b) {
+    if (a.length === 0 || a.length !== b.length)
+        return 0;
+    let dot = 0;
+    let normA = 0;
+    let 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;
+}
+/**
+ * Fast cosine similarity between a number[] and a Float32Array slice.
+ */
+function cosineSimilarityBinary(query, vectors, offset, dims) {
+    let dot = 0;
+    let normA = 0;
+    let normB = 0;
+    for (let i = 0; i < dims; i++) {
+        const valB = vectors[offset + i];
+        dot += query[i] * valB;
+        normA += query[i] * query[i];
+        normB += valB * valB;
+    }
+    const denom = Math.sqrt(normA) * Math.sqrt(normB);
+    return denom === 0 ? 0 : dot / denom;
+}
+// ─── Vector Search ────────────────────────────────────────────────────────────
+/**
+ * Performs an exhaustive nearest-neighbor search over all cached embeddings.
+ *
+ * Uses HNSW (O(log N)) when the index is available in the cache.
+ * Falls back to exhaustive O(n * d) cosine search on the contiguous
+ * Float32Array buffer if the HNSW index is missing or fails to load.
+ */
+function vectorSearch(queryEmbedding, chunks, cache, symbols, topK = 10) {
+    if (queryEmbedding.length === 0)
+        return [];
+    const scored = [];
+    const { vectors, chunkIds, dimensions, hnswIndex } = cache;
+    if (!vectors || !chunkIds) {
+        return [];
+    }
+    if (hnswIndex) {
+        try {
+            const { HNSW } = require("hnsw");
+            const index = HNSW.fromJSON(hnswIndex);
+            // Increased efSearch for better accuracy
+            const hnswResults = index.searchKNN(queryEmbedding, Math.max(topK * 2, 20), { efSearch: 64 });
+            const chunkById = new Map(chunks.map(c => [c.id, c]));
+            const chunkResults = [];
+            for (const res of hnswResults) {
+                const chunkId = chunkIds[res.id];
+                const chunk = chunkById.get(chunkId);
+                if (chunk) {
+                    const symbol = chunk.symbol ? symbols[chunk.symbol] : undefined;
+                    chunkResults.push({ chunk, score: res.score, symbol });
+                }
+            }
+            chunkResults.sort((a, b) => b.score - a.score);
+            return chunkResults.slice(0, topK);
+        }
+        catch (e) {
+            console.warn("HNSW search failed, falling back to exhaustive search:", e);
+        }
+    }
+    // Fallback: Optimized path: binary search over contiguous buffer
+    // Map chunkId to index for fast lookup
+    const idToIndex = new Map();
+    chunkIds.forEach((id, i) => idToIndex.set(id, i));
+    for (const chunk of chunks) {
+        const idx = idToIndex.get(chunk.id);
+        if (idx === undefined)
+            continue;
+        const score = cosineSimilarityBinary(queryEmbedding, vectors, idx * dimensions, dimensions);
+        const symbol = chunk.symbol ? symbols[chunk.symbol] : undefined;
+        scored.push({ chunk, score, symbol });
+    }
+    scored.sort((a, b) => b.score - a.score);
+    return scored.slice(0, topK);
+}
+// ─── Symbol Lookup ────────────────────────────────────────────────────────────
+/**
+ * Direct symbol lookup — bypasses embedding when the query matches a known
+ * symbol name. Returns chunks for matched symbols scored by match quality.
+ *
+ * Match tiers (in order of precedence):
+ *   1.0 — exact match: query === symbolName (case-insensitive)
+ *   0.95 — single-word match: one word in query === symbolName
+ *   0.80 — prefix match: symbolName starts with a query word (or vice versa)
+ *
+ * Returns [] if no symbol matches (caller should fall through to vector/BM25).
+ * Only activates for narrow queries (≤5 matches) to avoid false positives on
+ * generic names like "connect" or "init".
+ */
+function symbolLookup(query, chunks, symbols) {
+    const q = query.trim().toLowerCase();
+    const words = q.split(/[\s\W]+/).filter((w) => w.length >= 2);
+    const candidates = [];
+    for (const name of Object.keys(symbols)) {
+        const lower = name.toLowerCase();
+        if (lower === q) {
+            candidates.push({ name, score: 1.0 });
+        }
+        else if (words.some((w) => lower === w)) {
+            candidates.push({ name, score: 0.95 });
+        }
+        else if (words.some((w) => lower.startsWith(w) || w.startsWith(lower))) {
+            candidates.push({ name, score: 0.8 });
+        }
+    }
+    if (candidates.length === 0 || candidates.length > 5)
+        return [];
+    candidates.sort((a, b) => b.score - a.score);
+    const results = [];
+    for (const { name, score } of candidates) {
+        const sym = symbols[name];
+        const chunk = chunks.find((c) => c.symbol === name && c.file === sym.file);
+        if (chunk) {
+            results.push({ chunk, score, symbol: sym });
+        }
+    }
+    return results;
+}
+// ─── Keyword Search ───────────────────────────────────────────────────────────
+/**
+ * TF-based keyword search — used as fallback when embeddings are not available.
+ *
+ * Scores each chunk by term frequency normalized by content length.
+ * Not as powerful as semantic search but requires no embedding service.
+ */
+function keywordSearch(query, chunks, symbols, topK = 10) {
+    // Split query into meaningful terms (skip stop words shorter than 3 chars)
+    const terms = query
+        .toLowerCase()
+        .split(/[\s\W]+/)
+        .filter((t) => t.length >= 3);
+    if (terms.length === 0)
+        return [];
+    const scored = chunks.map((chunk) => {
+        const content = chunk.content.toLowerCase();
+        let score = 0;
+        for (const term of terms) {
+            // Count occurrences
+            let pos = 0;
+            let count = 0;
+            while ((pos = content.indexOf(term, pos)) !== -1) {
+                count++;
+                pos += term.length;
+            }
+            if (count > 0) {
+                // TF normalized by content length (log-scaled to dampen large files)
+                score += count / Math.log(content.length + 2);
+            }
+        }
+        // Bonus: symbol name matches the query terms
+        if (chunk.symbol) {
+            const symLower = chunk.symbol.toLowerCase();
+            if (terms.some((t) => symLower.includes(t))) {
+                score *= 2;
+            }
+        }
+        const symbol = chunk.symbol ? symbols[chunk.symbol] : undefined;
+        return { chunk, score, symbol };
+    });
+    scored.sort((a, b) => b.score - a.score);
+    return scored.filter((r) => r.score > 0).slice(0, topK);
+}
+//# sourceMappingURL=vector.js.map

package/dist/search/vector.js.map

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

package/dist/storage/cache.d.ts

@@ -0,0 +1,30 @@
+import type { EmbeddingCache } from "../core/types";
+/**
+ * Manages the local per-developer embedding cache.
+ *
+ * Stored in ~/.vemora-cache/<projectId>/ — never in the repo.
+ * Each developer builds their own cache after running `vemora index`.
+ *
+ * Design choice: dual-file storage per project.
+ * Metadata and chunk IDs are stored in JSON (inspectable).
+ * Vectors are stored as a contiguous Float32Array binary buffer (fast I/O).
+ * The HNSW index is serialized to a separate JSON file for O(log N) search.
+ */
+export declare class EmbeddingCacheStorage {
+    private cacheDir;
+    private cachePath;
+    private binPath;
+    private hnswPath;
+    constructor(projectId: string);
+    load(): EmbeddingCache | null;
+    save(cache: EmbeddingCache): void;
+    private writeAtomic;
+    update(newEmbeddings: Record<string, number[]>, cache: EmbeddingCache): EmbeddingCache;
+    prune(validChunkIds: Set<string>, cache: EmbeddingCache): EmbeddingCache;
+    /**
+     * Helper to always get a Map, regardless of storage format
+     */
+    private getEmbeddingsMap;
+    getCacheDir(): string;
+}
+//# sourceMappingURL=cache.d.ts.map

package/dist/storage/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/storage/cache.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAKpD;;;;;;;;;;GAUG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAS;gBAEb,SAAS,EAAE,MAAM;IAO7B,IAAI,IAAI,cAAc,GAAG,IAAI;IAoD7B,IAAI,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IA0CjC,OAAO,CAAC,WAAW;IAMnB,MAAM,CACJ,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EACvC,KAAK,EAAE,cAAc,GACpB,cAAc;IAYjB,KAAK,CAAC,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,cAAc,GAAG,cAAc;IAwBxE;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAaxB,WAAW,IAAI,MAAM;CAGtB"}