optave-codegraph 3.13.0

package/dist/domain/search/models.js

@@ -0,0 +1,303 @@
+import { execFileSync } from 'node:child_process';
+import { createRequire } from 'node:module';
+import path from 'node:path';
+import { createInterface } from 'node:readline';
+import { setTimeout } from 'node:timers/promises';
+import { info } from '../../infrastructure/logger.js';
+import { ConfigError, EngineError } from '../../shared/errors.js';
+const _require = createRequire(import.meta.url);
+/**
+ * Resolve the directory where `npm install` should run so the installed
+ * package ends up reachable by `await import(pkg)` from inside this module.
+ *
+ * Without a `cwd`, `execFileSync('npm', ['install', ...])` operates on
+ * `process.cwd()` — when the user runs codegraph against a repo that is *not*
+ * the directory where codegraph itself is installed, npm installs into the
+ * wrong `node_modules`, the dynamic import still fails, and the user gets
+ * `ENGINE_UNAVAILABLE: ... installed but failed to load`.
+ *
+ * Pin cwd to the directory that contains @optave/codegraph's `node_modules`
+ * so the install lands where Node's resolution algorithm will find it.
+ *
+ * @internal Exported for unit tests; not part of the public barrel.
+ */
+export function resolveNpmInstallCwd() {
+    try {
+        const pkgJsonPath = _require.resolve('optave-codegraph/package.json');
+        // pkgJsonPath = <host>/node_modules/optave-codegraph/package.json
+        // dirname x4: package.json → codegraph → @optave → node_modules → <host>
+        return path.dirname(path.dirname(path.dirname(path.dirname(pkgJsonPath))));
+    }
+    catch {
+        // Source-of-truth checkout (no @optave/codegraph in node_modules) — fall back
+        // to process.cwd() so legacy behavior survives in tests.
+        return undefined;
+    }
+}
+// Lazy-load transformers (heavy, optional module)
+let pipeline = null;
+let extractor = null;
+let activeModel = null;
+export const MODELS = {
+    minilm: {
+        name: 'Xenova/all-MiniLM-L6-v2',
+        dim: 384,
+        contextWindow: 256,
+        desc: 'Smallest, fastest (~23MB). General text.',
+        quantized: true,
+    },
+    'jina-small': {
+        name: 'Xenova/jina-embeddings-v2-small-en',
+        dim: 512,
+        contextWindow: 8192,
+        desc: 'Small, good quality (~33MB). General text.',
+        quantized: false,
+    },
+    'jina-base': {
+        name: 'Xenova/jina-embeddings-v2-base-en',
+        dim: 768,
+        contextWindow: 8192,
+        desc: 'Good quality (~137MB). General text, 8192 token context.',
+        quantized: false,
+    },
+    'jina-code': {
+        name: 'jinaai/jina-embeddings-v2-base-code',
+        dim: 768,
+        contextWindow: 8192,
+        desc: 'Code-aware (~137MB). Trained on code+text, best for code search.',
+        quantized: false,
+    },
+    nomic: {
+        name: 'Xenova/nomic-embed-text-v1',
+        dim: 768,
+        contextWindow: 8192,
+        desc: 'Good local quality (~137MB). 8192 context.',
+        quantized: false,
+    },
+    'nomic-v1.5': {
+        name: 'nomic-ai/nomic-embed-text-v1.5',
+        dim: 768,
+        contextWindow: 8192,
+        desc: 'Matryoshka MRL trained (~137MB). 8192 context. Codegraph stores full 768d (no truncation); v1 scores higher on our benchmark.',
+        quantized: false,
+    },
+    'bge-large': {
+        name: 'Xenova/bge-large-en-v1.5',
+        dim: 1024,
+        contextWindow: 512,
+        desc: 'Best general retrieval (~335MB). Top MTEB scores.',
+        quantized: false,
+    },
+    'mxbai-xsmall': {
+        name: 'mixedbread-ai/mxbai-embed-xsmall-v1',
+        dim: 384,
+        contextWindow: 4096,
+        desc: 'Tiny model with long context (~50MB). 4096 ctx.',
+        quantized: false,
+        pooling: 'cls',
+    },
+    'mxbai-large': {
+        name: 'mixedbread-ai/mxbai-embed-large-v1',
+        dim: 1024,
+        contextWindow: 512,
+        desc: 'Top MTEB BERT-large, Matryoshka dimensions (~400MB). 512 ctx.',
+        quantized: false,
+        pooling: 'cls',
+    },
+    'bge-m3': {
+        name: 'Xenova/bge-m3',
+        dim: 1024,
+        contextWindow: 8192,
+        desc: 'Multilingual, multi-task (~600MB). 100+ languages, 8192 context.',
+        quantized: false,
+    },
+    modernbert: {
+        name: 'nomic-ai/modernbert-embed-base',
+        dim: 768,
+        contextWindow: 8192,
+        desc: 'ModernBERT base (~150MB). Newer architecture, 8192 ctx, English.',
+        quantized: false,
+    },
+};
+export const EMBEDDING_STRATEGIES = ['structured', 'source'];
+export const DEFAULT_MODEL = 'nomic';
+const NPM_BIN = process.platform === 'win32' ? 'npm.cmd' : 'npm';
+const BATCH_SIZE_MAP = {
+    minilm: 32,
+    'jina-small': 16,
+    'jina-base': 8,
+    'jina-code': 8,
+    nomic: 8,
+    'nomic-v1.5': 8,
+    'bge-large': 4,
+    'mxbai-xsmall': 32,
+    'mxbai-large': 4,
+    'bge-m3': 4,
+    modernbert: 8,
+};
+const DEFAULT_BATCH_SIZE = 32;
+/** @internal Used by generator.js — not part of the public barrel. */
+export function getModelConfig(modelKey) {
+    const key = modelKey || DEFAULT_MODEL;
+    const config = MODELS[key];
+    if (!config) {
+        throw new ConfigError(`Unknown model: ${key}. Available: ${Object.keys(MODELS).join(', ')}`);
+    }
+    return config;
+}
+/**
+ * Attempt to install a missing package.
+ * In TTY environments, prompts the user for confirmation first.
+ * In non-TTY environments (CI, piped stdin), installs automatically with a log message.
+ * Returns true if the package was installed, false otherwise.
+ * @internal Not part of the public barrel.
+ */
+export function promptInstall(packageName) {
+    const installCwd = resolveNpmInstallCwd();
+    if (!process.stdin.isTTY) {
+        info(`Installing ${packageName} (optional dependency for semantic search)…`);
+        try {
+            execFileSync(NPM_BIN, ['install', '--no-save', packageName], {
+                stdio: 'inherit',
+                timeout: 300_000,
+                cwd: installCwd,
+            });
+            return Promise.resolve(true);
+        }
+        catch (err) {
+            info(`Auto-install of ${packageName} failed (${err instanceof Error ? err.message : String(err)}). Install it manually with:\n  npm install ${packageName}`);
+            return Promise.resolve(false);
+        }
+    }
+    return new Promise((resolve) => {
+        const rl = createInterface({ input: process.stdin, output: process.stderr });
+        rl.question(`Semantic search requires ${packageName}. Install it now? [y/N] `, (answer) => {
+            rl.close();
+            if (answer.trim().toLowerCase() !== 'y')
+                return resolve(false);
+            try {
+                execFileSync(NPM_BIN, ['install', '--no-save', packageName], {
+                    stdio: 'inherit',
+                    timeout: 300_000,
+                    cwd: installCwd,
+                });
+                resolve(true);
+            }
+            catch (err) {
+                info(`Install of ${packageName} failed (${err instanceof Error ? err.message : String(err)}). Install it manually with:\n  npm install ${packageName}`);
+                resolve(false);
+            }
+        });
+    });
+}
+/**
+ * Lazy-load @huggingface/transformers.
+ * If the package is missing, prompts the user to install it interactively.
+ * In non-TTY environments, attempts automatic installation.
+ * @internal Not part of the public barrel.
+ */
+export async function loadTransformers() {
+    try {
+        return await import('@huggingface/transformers');
+    }
+    catch {
+        const pkg = '@huggingface/transformers';
+        const installed = await promptInstall(pkg);
+        if (installed) {
+            try {
+                return await import(pkg);
+            }
+            catch (loadErr) {
+                throw new EngineError(`${pkg} was installed but failed to load. Please check your environment.`, { cause: loadErr instanceof Error ? loadErr : undefined });
+            }
+        }
+        throw new EngineError(`Semantic search requires ${pkg}.\nInstall it with: npm install ${pkg}`);
+    }
+}
+/**
+ * Dispose the current ONNX session and free memory.
+ * Safe to call when no model is loaded (no-op).
+ */
+export async function disposeModel() {
+    if (extractor) {
+        await extractor.dispose();
+        extractor = null;
+    }
+    activeModel = null;
+}
+async function loadModel(modelKey) {
+    const config = getModelConfig(modelKey);
+    if (extractor && activeModel === config.name)
+        return { extractor, config };
+    // Dispose previous model before loading a different one
+    await disposeModel();
+    const transformers = (await loadTransformers());
+    pipeline = transformers.pipeline;
+    info(`Loading embedding model: ${config.name} (${config.dim}d)...`);
+    const pipelineOpts = config.quantized ? { dtype: 'q8' } : {};
+    try {
+        extractor =
+            await // biome-ignore lint/complexity/noBannedTypes: dynamically loaded transformers pipeline is untyped
+             pipeline('feature-extraction', config.name, pipelineOpts);
+    }
+    catch (err) {
+        const cause = err instanceof Error ? err : undefined;
+        const msg = cause?.message || String(err);
+        if (msg.includes('Unauthorized') || msg.includes('401') || msg.includes('gated')) {
+            throw new EngineError(`Model "${config.name}" requires authentication.\n` +
+                `This model is gated on HuggingFace and needs an access token.\n\n` +
+                `Options:\n` +
+                `  1. Set HF_TOKEN env var: export HF_TOKEN=hf_...\n` +
+                `  2. Use a public model instead: codegraph embed --model minilm`, { cause });
+        }
+        throw new EngineError(`Failed to load model "${config.name}": ${msg}\n` +
+            `Try a different model: codegraph embed --model minilm`, { cause });
+    }
+    activeModel = config.name;
+    info('Model loaded.');
+    return { extractor, config };
+}
+/**
+ * Generate embeddings for an array of texts.
+ */
+export async function embed(texts, modelKey, options = {}) {
+    const { extractor: ext, config } = await loadModel(modelKey);
+    const dim = config.dim;
+    const results = [];
+    const batchSize = (() => {
+        if (options.batchSize) {
+            return options.batchSize;
+        }
+        else {
+            return BATCH_SIZE_MAP[modelKey || DEFAULT_MODEL] ?? DEFAULT_BATCH_SIZE;
+        }
+    })();
+    for (let i = 0; i < texts.length; i += batchSize) {
+        const batch = texts.slice(i, i + batchSize);
+        const output = (await // biome-ignore lint/complexity/noBannedTypes: dynamically loaded extractor is untyped
+         ext(batch, { pooling: config.pooling ?? 'mean', normalize: true }));
+        for (let j = 0; j < batch.length; j++) {
+            const start = j * dim;
+            const vec = new Float32Array(dim);
+            for (let k = 0; k < dim; k++) {
+                vec[k] = output.data[start + k] ?? 0;
+            }
+            results.push(vec);
+        }
+        if (texts.length > batchSize) {
+            if (global.gc) {
+                global.gc();
+            }
+            const embedded = Math.min(i + batchSize, texts.length);
+            process.stderr.write(`  Embedded ${embedded}/${texts.length}\r`);
+            if (options.onBatchComplete) {
+                options.onBatchComplete(batchSize, embedded, texts.length);
+            }
+            if (options.throttlePerBatchInMs) {
+                await setTimeout(options.throttlePerBatchInMs);
+            }
+        }
+    }
+    return { vectors: results, dim };
+}
+//# sourceMappingURL=models.js.map

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

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

package/dist/domain/search/search/cli-formatter.d.ts

@@ -0,0 +1,10 @@
+import type { SemanticSearchOpts } from './semantic.js';
+interface SearchOpts extends SemanticSearchOpts {
+    mode?: 'hybrid' | 'semantic' | 'keyword';
+    json?: boolean;
+    ndjson?: boolean;
+    offset?: number;
+}
+export declare function search(query: string, customDbPath: string | undefined, opts?: SearchOpts): Promise<void>;
+export {};
+//# sourceMappingURL=cli-formatter.d.ts.map

package/dist/domain/search/search/cli-formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-formatter.d.ts","sourceRoot":"","sources":["../../../../src/domain/search/search/cli-formatter.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAGxD,UAAU,UAAW,SAAQ,kBAAkB;IAC7C,IAAI,CAAC,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;IACzC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AA+HD,wBAAsB,MAAM,CAC1B,KAAK,EAAE,MAAM,EACb,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,IAAI,GAAE,UAAe,GACpB,OAAO,CAAC,IAAI,CAAC,CAoCf"}

package/dist/domain/search/search/cli-formatter.js

@@ -0,0 +1,134 @@
+import { warn } from '../../../infrastructure/logger.js';
+import { hybridSearchData } from './hybrid.js';
+import { ftsSearchData } from './keyword.js';
+import { multiSearchData, searchData } from './semantic.js';
+const kindIcon = (kind) => kind === 'function' ? 'f' : kind === 'class' ? '*' : 'o';
+function formatKeywordResults(singleQuery, customDbPath, opts) {
+    const data = ftsSearchData(singleQuery, customDbPath, opts);
+    if (!data) {
+        console.log('No FTS5 index found. Run `codegraph embed` to build the keyword index.');
+        return;
+    }
+    if (opts.json) {
+        console.log(JSON.stringify(data, null, 2));
+        return;
+    }
+    console.log(`\nKeyword search: "${singleQuery}" (BM25)\n`);
+    if (data.results.length === 0) {
+        console.log('  No results found.');
+    }
+    else {
+        for (const r of data.results) {
+            console.log(`  BM25 ${r.bm25Score.toFixed(2)}  ${kindIcon(r.kind)} ${r.name} -- ${r.file}:${r.line}`);
+        }
+    }
+    console.log(`\n  ${data.results.length} results shown\n`);
+}
+async function formatSemanticSingle(singleQuery, customDbPath, opts) {
+    const data = await searchData(singleQuery, customDbPath, opts);
+    if (!data)
+        return;
+    if (opts.json) {
+        console.log(JSON.stringify(data, null, 2));
+        return;
+    }
+    console.log(`\nSemantic search: "${singleQuery}"\n`);
+    if (data.results.length === 0) {
+        console.log('  No results above threshold.');
+    }
+    else {
+        for (const r of data.results) {
+            const bar = '#'.repeat(Math.round(r.similarity * 20));
+            console.log(`  ${(r.similarity * 100).toFixed(1)}% ${bar}`);
+            console.log(`    ${kindIcon(r.kind)} ${r.name} -- ${r.file}:${r.line}`);
+        }
+    }
+    console.log(`\n  ${data.results.length} results shown\n`);
+}
+async function formatSemanticMulti(queries, customDbPath, opts) {
+    const data = await multiSearchData(queries, customDbPath, opts);
+    if (!data)
+        return;
+    if (opts.json) {
+        console.log(JSON.stringify(data, null, 2));
+        return;
+    }
+    console.log(`\nMulti-query semantic search (RRF, k=${opts.rrfK || 60}):`);
+    for (let i = 0; i < queries.length; i++)
+        console.log(`  [${i + 1}] "${queries[i]}"`);
+    console.log();
+    if (data.results.length === 0) {
+        console.log('  No results above threshold.');
+    }
+    else {
+        for (const r of data.results) {
+            console.log(`  RRF ${r.rrf.toFixed(4)}  ${kindIcon(r.kind)} ${r.name} -- ${r.file}:${r.line}`);
+            for (const qs of r.queryScores) {
+                const bar = '#'.repeat(Math.round(qs.similarity * 20));
+                console.log(`    [${queries.indexOf(qs.query) + 1}] ${(qs.similarity * 100).toFixed(1)}% ${bar} (rank ${qs.rank})`);
+            }
+        }
+    }
+    console.log(`\n  ${data.results.length} results shown\n`);
+}
+function formatHybridResults(queries, query, data, opts) {
+    const rrfK = opts.rrfK || 60;
+    if (queries.length <= 1) {
+        const singleQuery = queries[0] || query;
+        console.log(`\nHybrid search: "${singleQuery}" (BM25 + semantic, RRF k=${rrfK})\n`);
+    }
+    else {
+        console.log(`\nHybrid multi-query search (BM25 + semantic, RRF k=${rrfK}):`);
+        for (let i = 0; i < queries.length; i++)
+            console.log(`  [${i + 1}] "${queries[i]}"`);
+        console.log();
+    }
+    if (data.results.length === 0) {
+        console.log('  No results found.');
+    }
+    else {
+        for (const r of data.results) {
+            console.log(`  RRF ${r.rrf.toFixed(4)}  ${kindIcon(r.kind)} ${r.name} -- ${r.file}:${r.line}`);
+            const parts = [];
+            if (r.bm25Rank != null) {
+                parts.push(`BM25: rank ${r.bm25Rank} (score ${r.bm25Score.toFixed(2)})`);
+            }
+            if (r.semanticRank != null) {
+                parts.push(`Semantic: rank ${r.semanticRank} (${(r.similarity * 100).toFixed(1)}%)`);
+            }
+            if (parts.length > 0) {
+                console.log(`    ${parts.join('  |  ')}`);
+            }
+        }
+    }
+    console.log(`\n  ${data.results.length} results shown\n`);
+}
+export async function search(query, customDbPath, opts = {}) {
+    const mode = opts.mode || 'hybrid';
+    const queries = query
+        .split(';')
+        .map((q) => q.trim())
+        .filter((q) => q.length > 0);
+    if (mode === 'keyword') {
+        const singleQuery = queries.length === 1 ? queries[0] : query;
+        return formatKeywordResults(singleQuery, customDbPath, opts);
+    }
+    if (mode === 'semantic') {
+        if (queries.length <= 1) {
+            return formatSemanticSingle(queries[0] || query, customDbPath, opts);
+        }
+        return formatSemanticMulti(queries, customDbPath, opts);
+    }
+    // Hybrid mode (default)
+    const data = await hybridSearchData(query, customDbPath, opts);
+    if (!data) {
+        warn('FTS5 index not found — using semantic search only. Re-run `codegraph embed` to enable hybrid mode.');
+        return search(query, customDbPath, { ...opts, mode: 'semantic' });
+    }
+    if (opts.json) {
+        console.log(JSON.stringify(data, null, 2));
+        return;
+    }
+    formatHybridResults(queries, query, data, opts);
+}
+//# sourceMappingURL=cli-formatter.js.map

package/dist/domain/search/search/cli-formatter.js.map

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

package/dist/domain/search/search/filters.d.ts

@@ -0,0 +1,9 @@
+export declare function globMatch(filePath: string, pattern: string): boolean;
+export interface FilterOpts {
+    filePattern?: string | string[];
+    noTests?: boolean;
+}
+export declare function applyFilters<T extends {
+    file: string;
+}>(rows: T[], opts?: FilterOpts): T[];
+//# sourceMappingURL=filters.d.ts.map

package/dist/domain/search/search/filters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filters.d.ts","sourceRoot":"","sources":["../../../../src/domain/search/search/filters.ts"],"names":[],"mappings":"AAAA,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAYpE;AAID,MAAM,WAAW,UAAU;IACzB,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAChC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,wBAAgB,YAAY,CAAC,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,IAAI,GAAE,UAAe,GAAG,CAAC,EAAE,CAgB9F"}

package/dist/domain/search/search/filters.js

@@ -0,0 +1,31 @@
+export function globMatch(filePath, pattern) {
+    const normalized = filePath.replace(/\\/g, '/');
+    let regex = pattern.replace(/\\/g, '/').replace(/[.+^${}()|[\]\\]/g, '\\$&');
+    regex = regex.replace(/\*\*/g, '\0');
+    regex = regex.replace(/\*/g, '[^/]*');
+    regex = regex.replace(/\0/g, '.*');
+    regex = regex.replace(/\?/g, '[^/]');
+    try {
+        return new RegExp(`^${regex}$`).test(normalized);
+    }
+    catch {
+        return normalized.includes(pattern);
+    }
+}
+const TEST_PATTERN = /\.(test|spec)\.|__test__|__tests__|\.stories\./;
+export function applyFilters(rows, opts = {}) {
+    let filtered = rows;
+    const fp = opts.filePattern;
+    const fpArr = Array.isArray(fp) ? fp : fp ? [fp] : [];
+    if (fpArr.length > 0) {
+        filtered = filtered.filter((row) => fpArr.some((p) => {
+            const patternIsGlob = /[*?[\]]/.test(p);
+            return patternIsGlob ? globMatch(row.file, p) : row.file.includes(p);
+        }));
+    }
+    if (opts.noTests) {
+        filtered = filtered.filter((row) => !TEST_PATTERN.test(row.file));
+    }
+    return filtered;
+}
+//# sourceMappingURL=filters.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"filters.js","sourceRoot":"","sources":["../../../../src/domain/search/search/filters.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,SAAS,CAAC,QAAgB,EAAE,OAAe;IACzD,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAChD,IAAI,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAC;IAC7E,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACrC,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACtC,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACnC,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACrC,IAAI,CAAC;QACH,OAAO,IAAI,MAAM,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACnD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACtC,CAAC;AACH,CAAC;AAED,MAAM,YAAY,GAAG,gDAAgD,CAAC;AAOtE,MAAM,UAAU,YAAY,CAA6B,IAAS,EAAE,OAAmB,EAAE;IACvF,IAAI,QAAQ,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,GAAG,IAAI,CAAC,WAAW,CAAC;IAC5B,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACtD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CACjC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE;YACf,MAAM,aAAa,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACxC,OAAO,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QACvE,CAAC,CAAC,CACH,CAAC;IACJ,CAAC;IACD,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/domain/search/search/hybrid.d.ts

@@ -0,0 +1,21 @@
+import type { SemanticSearchOpts } from './semantic.js';
+interface HybridResult {
+    name: string;
+    kind: string;
+    file: string;
+    line: number;
+    endLine: number | null;
+    role: string | null;
+    fileHash: string | null;
+    rrf: number;
+    bm25Score: number | null;
+    bm25Rank: number | null;
+    similarity: number | null;
+    semanticRank: number | null;
+}
+export interface HybridSearchResult {
+    results: HybridResult[];
+}
+export declare function hybridSearchData(query: string, customDbPath: string | undefined, opts?: SemanticSearchOpts): Promise<HybridSearchResult | null>;
+export {};
+//# sourceMappingURL=hybrid.d.ts.map

package/dist/domain/search/search/hybrid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hybrid.d.ts","sourceRoot":"","sources":["../../../../src/domain/search/search/hybrid.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAGxD,UAAU,YAAY;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,YAAY,EAAE,CAAC;CACzB;AAsJD,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,MAAM,EACb,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,IAAI,GAAE,kBAAuB,GAC5B,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAiBpC"}