@optave/codegraph 3.2.0 → 3.3.1

package/dist/domain/search/search/semantic.js

@@ -0,0 +1,129 @@
+import { loadConfig } from '../../../infrastructure/config.js';
+import { warn } from '../../../infrastructure/logger.js';
+import { normalizeSymbol } from '../../queries.js';
+import { embed } from '../models.js';
+import { cosineSim } from '../stores/sqlite-blob.js';
+import { prepareSearch } from './prepare.js';
+/**
+ * Single-query semantic search — returns data instead of printing.
+ * Returns { results: [{ name, kind, file, line, similarity }] } or null on failure.
+ */
+export async function searchData(query, customDbPath, opts = {}) {
+    const config = opts.config || loadConfig();
+    const searchCfg = config.search || {};
+    const limit = opts.limit ?? searchCfg.topK ?? 15;
+    const minScore = opts.minScore ?? searchCfg.defaultMinScore ?? 0.2;
+    const prepared = prepareSearch(customDbPath, opts);
+    if (!prepared)
+        return null;
+    const { db, rows, modelKey, storedDim } = prepared;
+    try {
+        const { vectors: [queryVec], dim, } = await embed([query], modelKey);
+        if (storedDim && dim !== storedDim) {
+            console.log(`Warning: query model dimension (${dim}) doesn't match stored embeddings (${storedDim}).`);
+            console.log(`  Re-run \`codegraph embed\` with the same model, or use --model to match.`);
+            return null;
+        }
+        const hc = new Map();
+        const results = [];
+        for (const row of rows) {
+            const vec = new Float32Array(new Uint8Array(row.vector).buffer);
+            const sim = cosineSim(queryVec, vec);
+            if (sim >= minScore) {
+                results.push({
+                    ...normalizeSymbol(row, db, hc),
+                    similarity: sim,
+                });
+            }
+        }
+        results.sort((a, b) => b.similarity - a.similarity);
+        return { results: results.slice(0, limit) };
+    }
+    finally {
+        db.close();
+    }
+}
+/**
+ * Multi-query semantic search with Reciprocal Rank Fusion (RRF).
+ * Returns { results: [{ name, kind, file, line, rrf, queryScores }] } or null on failure.
+ */
+export async function multiSearchData(queries, customDbPath, opts = {}) {
+    const config = opts.config || loadConfig();
+    const searchCfg = config.search || {};
+    const limit = opts.limit ?? searchCfg.topK ?? 15;
+    const minScore = opts.minScore ?? searchCfg.defaultMinScore ?? 0.2;
+    const k = opts.rrfK ?? searchCfg.rrfK ?? 60;
+    const prepared = prepareSearch(customDbPath, opts);
+    if (!prepared)
+        return null;
+    const { db, rows, modelKey, storedDim } = prepared;
+    try {
+        const { vectors: queryVecs, dim } = await embed(queries, modelKey);
+        // Warn about similar queries that may bias RRF results
+        const SIMILARITY_WARN_THRESHOLD = searchCfg.similarityWarnThreshold ?? 0.85;
+        for (let i = 0; i < queryVecs.length; i++) {
+            for (let j = i + 1; j < queryVecs.length; j++) {
+                const sim = cosineSim(queryVecs[i], queryVecs[j]);
+                if (sim >= SIMILARITY_WARN_THRESHOLD) {
+                    warn(`Queries "${queries[i]}" and "${queries[j]}" are very similar ` +
+                        `(${(sim * 100).toFixed(0)}% cosine similarity). ` +
+                        `This may bias RRF results toward their shared matches. ` +
+                        `Consider using more distinct queries.`);
+                }
+            }
+        }
+        if (storedDim && dim !== storedDim) {
+            console.log(`Warning: query model dimension (${dim}) doesn't match stored embeddings (${storedDim}).`);
+            console.log(`  Re-run \`codegraph embed\` with the same model, or use --model to match.`);
+            return null;
+        }
+        // Parse row vectors once
+        const rowVecs = rows.map((row) => new Float32Array(new Uint8Array(row.vector).buffer));
+        // For each query: compute similarities, filter by minScore, rank
+        const perQueryRanked = queries.map((_query, qi) => {
+            const scored = [];
+            for (let ri = 0; ri < rows.length; ri++) {
+                const sim = cosineSim(queryVecs[qi], rowVecs[ri]);
+                if (sim >= minScore) {
+                    scored.push({ rowIndex: ri, similarity: sim });
+                }
+            }
+            scored.sort((a, b) => b.similarity - a.similarity);
+            // Assign 1-indexed ranks
+            return scored.map((item, rank) => ({ ...item, rank: rank + 1 }));
+        });
+        // Fuse results using RRF: for each unique row, sum 1/(k + rank_i) across queries
+        const fusionMap = new Map(); // rowIndex -> { rrfScore, queryScores[] }
+        for (let qi = 0; qi < queries.length; qi++) {
+            for (const item of perQueryRanked[qi]) {
+                if (!fusionMap.has(item.rowIndex)) {
+                    fusionMap.set(item.rowIndex, { rrfScore: 0, queryScores: [] });
+                }
+                const entry = fusionMap.get(item.rowIndex);
+                entry.rrfScore += 1 / (k + item.rank);
+                entry.queryScores.push({
+                    query: queries[qi],
+                    similarity: item.similarity,
+                    rank: item.rank,
+                });
+            }
+        }
+        // Build results sorted by RRF score
+        const hc = new Map();
+        const results = [];
+        for (const [rowIndex, entry] of fusionMap) {
+            const row = rows[rowIndex];
+            results.push({
+                ...normalizeSymbol(row, db, hc),
+                rrf: entry.rrfScore,
+                queryScores: entry.queryScores,
+            });
+        }
+        results.sort((a, b) => b.rrf - a.rrf);
+        return { results: results.slice(0, limit) };
+    }
+    finally {
+        db.close();
+    }
+}
+//# sourceMappingURL=semantic.js.map

package/dist/domain/search/search/semantic.js.map

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

package/dist/domain/search/stores/fts5.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Sanitize a user query for FTS5 MATCH syntax.
+ * Wraps each token as an implicit OR and escapes special FTS5 characters.
+ */
+export function sanitizeFtsQuery(query: any): any;
+/**
+ * Check if the FTS5 index exists in the database.
+ * Returns true if fts_index table exists and has rows, false otherwise.
+ */
+export function hasFtsIndex(db: any): boolean;
+//# sourceMappingURL=fts5.d.ts.map

package/dist/domain/search/stores/fts5.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fts5.d.ts","sourceRoot":"","sources":["../../../../src/domain/search/stores/fts5.js"],"names":[],"mappings":"AAAA;;;GAGG;AACH,kDASC;AAED;;;GAGG;AACH,8CAOC"}

package/dist/domain/search/stores/fts5.js

@@ -0,0 +1,31 @@
+/**
+ * Sanitize a user query for FTS5 MATCH syntax.
+ * Wraps each token as an implicit OR and escapes special FTS5 characters.
+ */
+export function sanitizeFtsQuery(query) {
+    // Remove FTS5 special chars that could cause syntax errors
+    const cleaned = query.replace(/[*"():^{}~<>]/g, ' ').trim();
+    if (!cleaned)
+        return null;
+    // Split into tokens, wrap with OR for multi-token queries
+    const tokens = cleaned.split(/\s+/).filter((t) => t.length > 0);
+    if (tokens.length === 0)
+        return null;
+    if (tokens.length === 1)
+        return `"${tokens[0]}"`;
+    return tokens.map((t) => `"${t}"`).join(' OR ');
+}
+/**
+ * Check if the FTS5 index exists in the database.
+ * Returns true if fts_index table exists and has rows, false otherwise.
+ */
+export function hasFtsIndex(db) {
+    try {
+        const row = db.prepare('SELECT COUNT(*) as c FROM fts_index').get();
+        return row.c > 0;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=fts5.js.map

package/dist/domain/search/stores/fts5.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fts5.js","sourceRoot":"","sources":["../../../../src/domain/search/stores/fts5.js"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAK;IACpC,2DAA2D;IAC3D,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAC5D,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC1B,0DAA0D;IAC1D,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAChE,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACrC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC;IACjD,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAClD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,EAAE;IAC5B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,qCAAqC,CAAC,CAAC,GAAG,EAAE,CAAC;QACpE,OAAO,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;IACnB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/domain/search/stores/sqlite-blob.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @typedef {object} VectorStore
+ * @property {(queryVec: Float32Array, rows: Array<{vector: Buffer}>) => Array<{index: number, score: number}>} search
+ *   Score every row against a query vector and return scored indices.
+ *
+ * Future implementations (e.g. HNSW via `hnsw.js`) implement this same shape
+ * for approximate nearest-neighbor search.
+ */
+/**
+ * Cosine similarity between two Float32Arrays.
+ */
+export function cosineSim(a: any, b: any): number;
+export type VectorStore = {
+    /**
+     *   Score every row against a query vector and return scored indices.
+     *
+     * Future implementations (e.g. HNSW via `hnsw.js`) implement this same shape
+     * for approximate nearest-neighbor search.
+     */
+    search: (queryVec: Float32Array, rows: Array<{
+        vector: Buffer;
+    }>) => Array<{
+        index: number;
+        score: number;
+    }>;
+};
+//# sourceMappingURL=sqlite-blob.d.ts.map

package/dist/domain/search/stores/sqlite-blob.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-blob.d.ts","sourceRoot":"","sources":["../../../../src/domain/search/stores/sqlite-blob.js"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,kDAWC;;;;;;;;YArBa,CAAC,QAAQ,EAAE,YAAY,EAAE,IAAI,EAAE,KAAK,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAC,CAAC,KAAK,KAAK,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAC,CAAC"}

package/dist/domain/search/stores/sqlite-blob.js

@@ -0,0 +1,22 @@
+/**
+ * @typedef {object} VectorStore
+ * @property {(queryVec: Float32Array, rows: Array<{vector: Buffer}>) => Array<{index: number, score: number}>} search
+ *   Score every row against a query vector and return scored indices.
+ *
+ * Future implementations (e.g. HNSW via `hnsw.js`) implement this same shape
+ * for approximate nearest-neighbor search.
+ */
+/**
+ * Cosine similarity between two Float32Arrays.
+ */
+export function cosineSim(a, b) {
+    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;
+}
+//# sourceMappingURL=sqlite-blob.js.map

package/dist/domain/search/stores/sqlite-blob.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-blob.js","sourceRoot":"","sources":["../../../../src/domain/search/stores/sqlite-blob.js"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,CAAC,EAAE,CAAC;IAC5B,IAAI,GAAG,GAAG,CAAC,EACT,KAAK,GAAG,CAAC,EACT,KAAK,GAAG,CAAC,CAAC;IACZ,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"}

package/dist/domain/search/strategies/source.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Build raw source-code text for a symbol (original strategy).
+ */
+export function buildSourceText(node: any, file: any, lines: any): string;
+//# sourceMappingURL=source.d.ts.map

package/dist/domain/search/strategies/source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../../../../src/domain/search/strategies/source.js"],"names":[],"mappings":"AAEA;;GAEG;AACH,0EAQC"}

package/dist/domain/search/strategies/source.js

@@ -0,0 +1,14 @@
+import { splitIdentifier } from './text-utils.js';
+/**
+ * Build raw source-code text for a symbol (original strategy).
+ */
+export function buildSourceText(node, file, lines) {
+    const startLine = Math.max(0, node.line - 1);
+    const endLine = node.end_line
+        ? Math.min(lines.length, node.end_line)
+        : Math.min(lines.length, startLine + 15);
+    const context = lines.slice(startLine, endLine).join('\n');
+    const readable = splitIdentifier(node.name);
+    return `${node.kind} ${node.name} (${readable}) in ${file}\n${context}`;
+}
+//# sourceMappingURL=source.js.map

package/dist/domain/search/strategies/source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.js","sourceRoot":"","sources":["../../../../src/domain/search/strategies/source.js"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK;IAC/C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC;IAC7C,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ;QAC3B,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC;QACvC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,SAAS,GAAG,EAAE,CAAC,CAAC;IAC3C,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3D,MAAM,QAAQ,GAAG,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5C,OAAO,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,QAAQ,IAAI,KAAK,OAAO,EAAE,CAAC;AAC1E,CAAC"}

package/dist/domain/search/strategies/structured.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Build graph-enriched text for a symbol using dependency context.
+ * Produces compact, semantic text (~100 tokens) instead of full source code.
+ */
+export function buildStructuredText(node: any, file: any, lines: any, db: any): string;
+//# sourceMappingURL=structured.d.ts.map

package/dist/domain/search/strategies/structured.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structured.d.ts","sourceRoot":"","sources":["../../../../src/domain/search/strategies/structured.js"],"names":[],"mappings":"AAGA;;;GAGG;AACH,uFAmCC"}

package/dist/domain/search/strategies/structured.js

@@ -0,0 +1,40 @@
+import { findCalleeNames, findCallerNames } from '../../../db/index.js';
+import { extractLeadingComment, splitIdentifier } from './text-utils.js';
+/**
+ * Build graph-enriched text for a symbol using dependency context.
+ * Produces compact, semantic text (~100 tokens) instead of full source code.
+ */
+export function buildStructuredText(node, file, lines, db) {
+    const readable = splitIdentifier(node.name);
+    const parts = [`${node.kind} ${node.name} (${readable}) in ${file}`];
+    const startLine = Math.max(0, node.line - 1);
+    // Extract parameters from signature (best-effort, single-line)
+    const sigLine = lines[startLine] || '';
+    const paramMatch = sigLine.match(/\(([^)]*)\)/);
+    if (paramMatch?.[1]?.trim()) {
+        parts.push(`Parameters: ${paramMatch[1].trim()}`);
+    }
+    // Graph context: callees (capped at 10)
+    const callees = findCalleeNames(db, node.id);
+    if (callees.length > 0) {
+        parts.push(`Calls: ${callees.slice(0, 10).join(', ')}`);
+    }
+    // Graph context: callers (capped at 10)
+    const callers = findCallerNames(db, node.id);
+    if (callers.length > 0) {
+        parts.push(`Called by: ${callers.slice(0, 10).join(', ')}`);
+    }
+    // Leading comment (high semantic value) or first few lines of code
+    const comment = extractLeadingComment(lines, startLine);
+    if (comment) {
+        parts.push(comment);
+    }
+    else {
+        const endLine = Math.min(lines.length, startLine + 4);
+        const snippet = lines.slice(startLine, endLine).join('\n').trim();
+        if (snippet)
+            parts.push(snippet);
+    }
+    return parts.join('\n');
+}
+//# sourceMappingURL=structured.js.map

package/dist/domain/search/strategies/structured.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"structured.js","sourceRoot":"","sources":["../../../../src/domain/search/strategies/structured.js"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEzE;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;IACvD,MAAM,QAAQ,GAAG,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5C,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,QAAQ,IAAI,EAAE,CAAC,CAAC;IACrE,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC;IAE7C,+DAA+D;IAC/D,MAAM,OAAO,GAAG,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;IACvC,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IAChD,IAAI,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC;QAC5B,KAAK,CAAC,IAAI,CAAC,eAAe,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACpD,CAAC;IAED,wCAAwC;IACxC,MAAM,OAAO,GAAG,eAAe,CAAC,EAAE,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;IAC7C,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,UAAU,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,wCAAwC;IACxC,MAAM,OAAO,GAAG,eAAe,CAAC,EAAE,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;IAC7C,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,cAAc,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED,mEAAmE;IACnE,MAAM,OAAO,GAAG,qBAAqB,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IACxD,IAAI,OAAO,EAAE,CAAC;QACZ,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACtB,CAAC;SAAM,CAAC;QACN,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,SAAS,GAAG,CAAC,CAAC,CAAC;QACtD,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;QAClE,IAAI,OAAO;YAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/domain/search/strategies/text-utils.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Split an identifier into readable words.
+ * camelCase/PascalCase -> "camel Case", snake_case -> "snake case", kebab-case -> "kebab case"
+ */
+export function splitIdentifier(name: any): any;
+/**
+ * Extract leading comment text (JSDoc, //, #, etc.) above a function line.
+ * Returns the cleaned comment text or null if none found.
+ */
+export function extractLeadingComment(lines: any, fnLineIndex: any): string | null;
+//# sourceMappingURL=text-utils.d.ts.map

package/dist/domain/search/strategies/text-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-utils.d.ts","sourceRoot":"","sources":["../../../../src/domain/search/strategies/text-utils.js"],"names":[],"mappings":"AAAA;;;GAGG;AACH,gDAMC;AAED;;;GAGG;AACH,mFA0BC"}

package/dist/domain/search/strategies/text-utils.js

@@ -0,0 +1,47 @@
+/**
+ * Split an identifier into readable words.
+ * camelCase/PascalCase -> "camel Case", snake_case -> "snake case", kebab-case -> "kebab case"
+ */
+export function splitIdentifier(name) {
+    return name
+        .replace(/([a-z])([A-Z])/g, '$1 $2')
+        .replace(/([A-Z]+)([A-Z][a-z])/g, '$1 $2')
+        .replace(/[_-]+/g, ' ')
+        .trim();
+}
+/**
+ * Extract leading comment text (JSDoc, //, #, etc.) above a function line.
+ * Returns the cleaned comment text or null if none found.
+ */
+export function extractLeadingComment(lines, fnLineIndex) {
+    if (fnLineIndex > lines.length)
+        return null;
+    const raw = [];
+    for (let i = fnLineIndex - 1; i >= Math.max(0, fnLineIndex - 15); i--) {
+        if (i >= lines.length)
+            continue;
+        const trimmed = lines[i].trim();
+        if (/^(\/\/|\/\*|\*\/|\*|#|\/\/\/)/.test(trimmed)) {
+            raw.unshift(trimmed);
+        }
+        else if (trimmed === '') {
+            if (raw.length > 0)
+                break;
+        }
+        else {
+            break;
+        }
+    }
+    if (raw.length === 0)
+        return null;
+    return raw
+        .map((line) => line
+        .replace(/^\/\*\*?\s?|\*\/$/g, '') // opening /** or /* and closing */
+        .replace(/^\*\s?/, '') // middle * lines
+        .replace(/^\/\/\/?\s?/, '') // // or ///
+        .replace(/^#\s?/, '') // # (Python/Ruby)
+        .trim())
+        .filter((l) => l.length > 0)
+        .join(' ');
+}
+//# sourceMappingURL=text-utils.js.map

package/dist/domain/search/strategies/text-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-utils.js","sourceRoot":"","sources":["../../../../src/domain/search/strategies/text-utils.js"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,IAAI;IAClC,OAAO,IAAI;SACR,OAAO,CAAC,iBAAiB,EAAE,OAAO,CAAC;SACnC,OAAO,CAAC,uBAAuB,EAAE,OAAO,CAAC;SACzC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;SACtB,IAAI,EAAE,CAAC;AACZ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAK,EAAE,WAAW;IACtD,IAAI,WAAW,GAAG,KAAK,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAC5C,MAAM,GAAG,GAAG,EAAE,CAAC;IACf,KAAK,IAAI,CAAC,GAAG,WAAW,GAAG,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QACtE,IAAI,CAAC,IAAI,KAAK,CAAC,MAAM;YAAE,SAAS;QAChC,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAChC,IAAI,+BAA+B,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YAClD,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACvB,CAAC;aAAM,IAAI,OAAO,KAAK,EAAE,EAAE,CAAC;YAC1B,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC;gBAAE,MAAM;QAC5B,CAAC;aAAM,CAAC;YACN,MAAM;QACR,CAAC;IACH,CAAC;IACD,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAClC,OAAO,GAAG;SACP,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CACZ,IAAI;SACD,OAAO,CAAC,oBAAoB,EAAE,EAAE,CAAC,CAAC,mCAAmC;SACrE,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,iBAAiB;SACvC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC,YAAY;SACvC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,kBAAkB;SACvC,IAAI,EAAE,CACV;SACA,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;SAC3B,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC"}

package/dist/extractors/csharp.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Extract symbols from C# files.
+ */
+export function extractCSharpSymbols(tree: any, _filePath: any): {
+    definitions: never[];
+    calls: never[];
+    imports: never[];
+    classes: never[];
+    exports: never[];
+    typeMap: Map<any, any>;
+};
+//# sourceMappingURL=csharp.d.ts.map

package/dist/extractors/csharp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"csharp.d.ts","sourceRoot":"","sources":["../../src/extractors/csharp.js"],"names":[],"mappings":"AAEA;;GAEG;AACH;;;;;;;EAaC"}