grepmax 0.17.24 → 0.18.0

package/dist/commands/search.js

@@ -45,20 +45,15 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.search = void 0;
 const path = __importStar(require("node:path"));
 const commander_1 = require("commander");
-const agent_search_formatter_1 = require("../lib/output/agent-search-formatter");
-const compact_results_1 = require("../lib/output/compact-results");
-const index_state_footer_1 = require("../lib/output/index-state-footer");
 const setup_helpers_1 = require("../lib/setup/setup-helpers");
 const cross_project_1 = require("../lib/utils/cross-project");
 const exit_1 = require("../lib/utils/exit");
-const formatter_1 = require("../lib/utils/formatter");
-const import_extractor_1 = require("../lib/utils/import-extractor");
 const project_registry_1 = require("../lib/utils/project-registry");
 const project_root_1 = require("../lib/utils/project-root");
 const server_registry_1 = require("../lib/utils/server-registry");
 const stale_hint_1 = require("../lib/utils/stale-hint");
+const search_output_1 = require("./search-output");
 const search_run_1 = require("./search-run");
-const search_skeletons_1 = require("./search-skeletons");
 exports.search = new commander_1.Command("search")
     .description("Search code by meaning (default command)")
     .option("-m <max_count>, --max-count <max_count>", "The maximum number of results to return (total)", "5")
@@ -88,8 +83,8 @@ exports.search = new commander_1.Command("search")
     .option("--name <regex>", "Filter results by symbol name regex")
     .option("-C, --context <n>", "Include N lines before/after each result")
     .option("--agent", "Ultra-compact output for AI agents (one line per result)", false)
-    .option("--seed-file <path>", "Bias results toward your working context (repeatable; comma-separated also accepted)", (value, prev) => (prev ? [...prev, value] : [value]))
-    .option("--seed-symbol <name>", "Bias results toward an identifier you're working with (repeatable; comma-separated also accepted)", (value, prev) => (prev ? [...prev, value] : [value]))
+    .option("--seed-file <path>", "Bias results toward your working context (repeatable; comma-separated also accepted)", (value, prev) => prev ? [...prev, value] : [value])
+    .option("--seed-symbol <name>", "Bias results toward an identifier you're working with (repeatable; comma-separated also accepted)", (value, prev) => prev ? [...prev, value] : [value])
     .argument("<pattern>", 'Natural language query (e.g. "where do we handle auth?")')
     .argument("[path]", "Restrict search to this path prefix")
     .addHelpText("after", `
@@ -104,7 +99,7 @@ Examples:
   gmax "auth middleware" --projects api,gateway --plain
 `)
     .action((pattern, exec_path, _options, cmd) => __awaiter(void 0, void 0, void 0, function* () {
-    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m;
+    var _a, _b, _c, _d, _e;
     const options = cmd.optsWithGlobals();
     const root = process.cwd();
     const minScore = Number.isFinite(Number.parseFloat(options.minScore))
@@ -154,110 +149,20 @@ Examples:
     const server = crossProject.active
         ? null
         : (0, server_registry_1.getServerForProject)(projectRootForServer);
+    // The standalone HTTP-server path lives OUTSIDE the main try/finally below:
+    // a handled server search returns here, intentionally skipping query
+    // logging and gracefulExit (unchanged from before the extraction).
     if (server) {
-        try {
-            const response = yield fetch(`http://localhost:${server.port}/search`, {
-                method: "POST",
-                headers: { "Content-Type": "application/json" },
-                body: JSON.stringify({
-                    query: pattern,
-                    limit: parseInt(options.m, 10),
-                    path: exec_path
-                        ? path.relative(projectRootForServer, path.resolve(exec_path))
-                        : undefined,
-                }),
-            });
-            if (response.ok) {
-                const body = (yield response.json());
-                const searchResult = { data: body.results };
-                const filteredData = searchResult.data.filter((r) => typeof r.score !== "number" || r.score >= minScore);
-                if (options.skeleton) {
-                    yield (0, search_skeletons_1.outputSkeletons)(filteredData, projectRootForServer, parseInt(options.m, 10), 
-                    // Server doesn't easily expose DB instance here in HTTP client mode,
-                    // but we are in client. Wait, this text implies "Server Search" block.
-                    // Client talks to server. The server returns JSON.
-                    // We don't have DB access here.
-                    // So we pass null, and it will fallback to generating local skeleton (if file exists locally).
-                    // This is acceptable for Phase 3.
-                    null);
-                    return;
-                }
-                const compactHits = options.compact
-                    ? (0, compact_results_1.toCompactHits)(filteredData)
-                    : [];
-                if (options.compact) {
-                    if (!compactHits.length) {
-                        console.log("No matches found.");
-                        console.log("\nTry: broaden your query, use fewer keywords, or check `gmax status` to verify the project is indexed.");
-                        process.exitCode = 1;
-                    }
-                    else {
-                        console.log((0, compact_results_1.formatCompactTable)(compactHits, projectRootForServer, pattern, {
-                            isTTY: !!process.stdout.isTTY,
-                            plain: !!options.plain,
-                        }));
-                    }
-                    return; // EXIT
-                }
-                if (!filteredData.length) {
-                    console.log("No matches found.");
-                    console.log("\nTry: broaden your query, use fewer keywords, or check `gmax status` to verify the project is indexed.");
-                    process.exitCode = 1;
-                    return; // EXIT
-                }
-                if (options.agent) {
-                    const importCache = new Map();
-                    const getImportsForFile = (absPath) => {
-                        var _a;
-                        if (!options.imports || !absPath)
-                            return "";
-                        if (!importCache.has(absPath)) {
-                            importCache.set(absPath, (0, import_extractor_1.extractImports)(absPath));
-                        }
-                        return (_a = importCache.get(absPath)) !== null && _a !== void 0 ? _a : "";
-                    };
-                    console.log((0, agent_search_formatter_1.formatAgentSearchResults)(filteredData, projectRootForServer, {
-                        includeImports: options.imports,
-                        query: pattern,
-                        getImportsForFile,
-                        explain: options.explain,
-                    }));
-                    return; // EXIT
-                }
-                const isTTY = process.stdout.isTTY;
-                const shouldBePlain = options.plain || !isTTY;
-                _searchResultCount = filteredData.length;
-                if (!options.agent && !options.compact) {
-                    console.log((0, compact_results_1.resultCountHeader)(filteredData, parseInt(options.m, 10)));
-                    console.log();
-                }
-                if (shouldBePlain) {
-                    const mappedResults = (0, compact_results_1.toTextResults)(filteredData);
-                    const output = (0, formatter_1.formatTextResults)(mappedResults, pattern, projectRootForServer, {
-                        isPlain: true,
-                        compact: options.compact,
-                        content: options.content,
-                        perFile: parseInt(options.perFile, 10),
-                        showScores: options.scores,
-                    });
-                    console.log(output);
-                }
-                else {
-                    const { formatResults } = yield Promise.resolve().then(() => __importStar(require("../lib/output/formatter")));
-                    const output = formatResults(filteredData, projectRootForServer, {
-                        content: options.content,
-                        explain: options.explain,
-                    });
-                    console.log(output);
-                }
-                return; // EXIT successful server search
-            }
-        }
-        catch (e) {
-            if (process.env.DEBUG) {
-                console.error("[search] server request failed, falling back to local:", e);
-            }
-        }
+        const handled = yield (0, search_output_1.executeServerSearch)({
+            server,
+            pattern,
+            exec_path,
+            projectRootForServer,
+            options,
+            minScore,
+        });
+        if (handled)
+            return;
     }
     try {
         yield (0, setup_helpers_1.ensureSetup)();
@@ -287,6 +192,10 @@ Examples:
             console.warn("This project is still being indexed. Results may be incomplete.\n");
         }
         (0, stale_hint_1.maybeWarnStaleChunker)(checkRoot, { agent: options.agent });
+        (0, stale_hint_1.maybeWarnStaleEmbedding)(checkRoot, { agent: options.agent });
+        if (crossProject.active) {
+            (0, stale_hint_1.maybeWarnCrossProjectDim)(crossProject.roots, { agent: options.agent });
+        }
         // Compute effective paths + filters early — both the daemon-mediated
         // and in-process search paths need them. Reuse the resolved checkRoot
         // so --root <name> only resolves once per invocation.
@@ -351,7 +260,9 @@ Examples:
         };
         const seedFiles = splitSeeds(options.seedFile);
         const seedSymbols = splitSeeds(options.seedSymbol);
-        const seeds = seedFiles || seedSymbols ? { files: seedFiles, symbols: seedSymbols } : undefined;
+        const seeds = seedFiles || seedSymbols
+            ? { files: seedFiles, symbols: seedSymbols }
+            : undefined;
         // Acquire results: daemon-mediated first, in-process fallback otherwise.
         // The render stage below is shared across both. `runSearch` reports the
         // VectorDB it opens via the callback so the `finally` can close it.
@@ -369,353 +280,24 @@ Examples:
         vectorDb = acquired.vectorDb;
         if (acquired.kind === "dry-run")
             return;
-        const { searchResult, precomputedSkeletons, precomputedGraph, indexState } = acquired;
-        if (!options.agent && ((_e = searchResult.warnings) === null || _e === void 0 ? void 0 : _e.length)) {
-            for (const w of searchResult.warnings) {
-                console.warn(`Warning: ${w}`);
-            }
-        }
-        // Partial-index signal (Phase 6): when the index is mid-catchup, results
-        // may be incomplete. Non-agent renders it now as a warning; agent mode
-        // appends a machine-readable footer after the results below.
-        if (!options.agent) {
-            const footer = (0, index_state_footer_1.formatIndexStateFooter)(indexState, { agent: false });
-            if (footer)
-                console.warn(footer);
-        }
-        let filteredData = searchResult.data.filter((r) => typeof r.score !== "number" || r.score >= minScore);
-        // Post-filter by symbol name regex
-        if (options.name) {
-            try {
-                const regex = new RegExp(options.name, "i");
-                filteredData = filteredData.filter((r) => {
-                    const defs = Array.isArray(r.defined_symbols)
-                        ? r.defined_symbols
-                        : [];
-                    return defs.some((d) => regex.test(d));
-                });
-            }
-            catch (_o) {
-                // Invalid regex — skip
-            }
-        }
-        // Build import cache when --imports is requested
-        const importCache = new Map();
-        const getImportsForFile = (absPath) => {
-            var _a;
-            if (!options.imports || !absPath)
-                return "";
-            if (!importCache.has(absPath)) {
-                importCache.set(absPath, (0, import_extractor_1.extractImports)(absPath));
-            }
-            return (_a = importCache.get(absPath)) !== null && _a !== void 0 ? _a : "";
-        };
-        // Agent mode: ultra-compact one-line-per-result output
-        _searchResultCount = filteredData.length;
-        // Cross-project (Phase 6): render grouped by owning project so idioms
-        // from different stacks don't blur into one flat list. Only the
-        // string-formatter modes reach here — skeleton/context-for-llm/symbol
-        // were rejected up front.
-        if (crossProject.active) {
-            const emitFooter = () => {
-                const footer = (0, index_state_footer_1.formatIndexStateFooter)(indexState, {
-                    agent: !!options.agent,
-                });
-                if (footer) {
-                    if (options.agent)
-                        console.log(footer);
-                    else
-                        console.warn(footer);
-                }
-            };
-            if (!filteredData.length) {
-                console.log(options.agent ? "(none)" : "No matches found.");
-                process.exitCode = 1;
-                emitFooter();
-                return;
-            }
-            const getPath = (r) => {
-                var _a, _b, _c;
-                return String((_c = (_a = r.path) !== null && _a !== void 0 ? _a : (_b = r.metadata) === null || _b === void 0 ? void 0 : _b.path) !== null && _c !== void 0 ? _c : "");
-            };
-            const groups = (0, cross_project_1.groupResultsByProject)(filteredData, crossProject.roots, getPath);
-            const isTTY = process.stdout.isTTY;
-            const shouldBePlain = options.plain || !isTTY;
-            const blocks = [];
-            for (const g of groups) {
-                let body;
-                if (options.agent) {
-                    body = (0, agent_search_formatter_1.formatAgentSearchResults)(g.items, g.root, {
-                        includeImports: options.imports,
-                        query: pattern,
-                        getImportsForFile,
-                        explain: options.explain,
-                    });
-                }
-                else if (options.compact) {
-                    body = (0, compact_results_1.formatCompactTable)((0, compact_results_1.toCompactHits)(g.items), g.root, pattern, {
-                        isTTY: !!isTTY,
-                        plain: !!options.plain,
-                    });
-                }
-                else if (shouldBePlain) {
-                    body = (0, formatter_1.formatTextResults)((0, compact_results_1.toTextResults)(g.items), pattern, g.root, {
-                        isPlain: true,
-                        compact: options.compact,
-                        content: options.content,
-                        perFile: parseInt(options.perFile, 10),
-                        showScores: options.scores,
-                    });
-                }
-                else {
-                    const { formatResults } = yield Promise.resolve().then(() => __importStar(require("../lib/output/formatter")));
-                    body = formatResults(g.items, g.root, {
-                        content: options.content,
-                        explain: options.explain,
-                    });
-                }
-                const header = options.agent
-                    ? `## ${g.name} (${g.items.length})`
-                    : `=== ${g.name} (${g.items.length}) ===`;
-                blocks.push(`${header}\n${body}`);
-            }
-            console.log(blocks.join("\n\n"));
-            emitFooter();
-            return;
-        }
-        if (options.agent) {
-            if (!filteredData.length) {
-                console.log("(none)");
-                process.exitCode = 1;
-            }
-            else {
-                console.log((0, agent_search_formatter_1.formatAgentSearchResults)(filteredData, effectiveRoot, {
-                    includeImports: options.imports,
-                    query: pattern,
-                    getImportsForFile,
-                    explain: options.explain,
-                }));
-            }
-            // Agent trace (compact)
-            if (options.symbol && filteredData.length > 0) {
-                try {
-                    let graph = precomputedGraph;
-                    if (!graph) {
-                        if (!vectorDb)
-                            throw new Error("no graph source");
-                        const { GraphBuilder } = yield Promise.resolve().then(() => __importStar(require("../lib/graph/graph-builder")));
-                        const builder = new GraphBuilder(vectorDb, effectiveRoot);
-                        graph = yield builder.buildGraphMultiHop(pattern, 1);
-                    }
-                    if (graph === null || graph === void 0 ? void 0 : graph.center) {
-                        console.log("---");
-                        for (const t of graph.callerTree) {
-                            const rel = t.node.file.startsWith(effectiveRoot)
-                                ? t.node.file.slice(effectiveRoot.length + 1)
-                                : t.node.file;
-                            console.log(`<- ${t.node.symbol} ${rel}:${t.node.line + 1}`);
-                        }
-                        for (const c of graph.callees.slice(0, 10)) {
-                            if (c.file) {
-                                const rel = c.file.startsWith(effectiveRoot)
-                                    ? c.file.slice(effectiveRoot.length + 1)
-                                    : c.file;
-                                console.log(`-> ${c.symbol} ${rel}:${c.line + 1}`);
-                            }
-                        }
-                    }
-                }
-                catch (_p) { }
-            }
-            // Partial-index footer last, so it's the final line the agent reads —
-            // and emitted even on "(none)", where an empty result may just mean the
-            // relevant files aren't indexed yet.
-            const footer = (0, index_state_footer_1.formatIndexStateFooter)(indexState, { agent: true });
-            if (footer)
-                console.log(footer);
-            return;
-        }
-        if (options.skeleton) {
-            yield (0, search_skeletons_1.outputSkeletons)(filteredData, projectRoot, parseInt(options.m, 10), vectorDb, precomputedSkeletons);
-            return;
-        }
-        if (!filteredData.length) {
-            console.log("No matches found.");
-            console.log("\nTry: broaden your query, use fewer keywords, or check `gmax status` to verify the project is indexed.");
-            process.exitCode = 1;
-            return;
-        }
-        if (options.compact) {
-            const compactHits = (0, compact_results_1.toCompactHits)(filteredData);
-            console.log((0, compact_results_1.formatCompactTable)(compactHits, projectRoot, pattern, {
-                isTTY: !!process.stdout.isTTY,
-                plain: !!options.plain,
-            }));
-            return;
-        }
-        _searchResultCount = filteredData.length;
-        // Context-for-LLM mode: full function body + imports per result
-        if (options.contextForLlm) {
-            const fs = yield Promise.resolve().then(() => __importStar(require("node:fs")));
-            const { extractImportsFromContent } = yield Promise.resolve().then(() => __importStar(require("../lib/utils/import-extractor")));
-            const { packByBudget } = yield Promise.resolve().then(() => __importStar(require("../lib/utils/budget-pack")));
-            const budget = parseInt(options.budget, 10) || 8000;
-            console.log((0, compact_results_1.resultCountHeader)(filteredData, parseInt(options.m, 10)));
-            // Build every candidate blob up front (token cost needs the rendered
-            // text), then pack to budget. Token-aware packing skips an oversized
-            // chunk and keeps filling with smaller, still-relevant ones rather than
-            // aborting the loop — recovering budget the old greedy `break` wasted.
-            const candidates = filteredData.map((r, idx) => {
-                var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l;
-                const absP = (_c = (_a = r.path) !== null && _a !== void 0 ? _a : (_b = r.metadata) === null || _b === void 0 ? void 0 : _b.path) !== null && _c !== void 0 ? _c : "";
-                const startLine = (_g = (_e = (_d = r.startLine) !== null && _d !== void 0 ? _d : r.start_line) !== null && _e !== void 0 ? _e : (_f = r.generated_metadata) === null || _f === void 0 ? void 0 : _f.start_line) !== null && _g !== void 0 ? _g : 0;
-                const endLine = (_l = (_j = (_h = r.endLine) !== null && _h !== void 0 ? _h : r.end_line) !== null && _j !== void 0 ? _j : (_k = r.generated_metadata) === null || _k === void 0 ? void 0 : _k.end_line) !== null && _l !== void 0 ? _l : startLine;
-                const relPath = absP.startsWith(projectRoot)
-                    ? absP.slice(projectRoot.length + 1)
-                    : absP;
-                const role = r.role || "IMPLEMENTATION";
-                const symbol = Array.isArray(r.defined_symbols) &&
-                    r.defined_symbols.length > 0
-                    ? r.defined_symbols[0]
-                    : "";
-                let blobText;
-                try {
-                    const content = fs.readFileSync(absP, "utf-8");
-                    const allLines = content.split("\n");
-                    const body = allLines
-                        .slice(startLine, Math.min(endLine + 1, allLines.length))
-                        .join("\n");
-                    const imports = extractImportsFromContent(content);
-                    const blob = [
-                        `--- ${relPath}:${startLine + 1}${symbol ? ` ${symbol}` : ""} [${role}] ---`,
-                    ];
-                    if (imports)
-                        blob.push("[imports]", imports, "");
-                    blob.push("[body]", body);
-                    blobText = blob.join("\n");
-                }
-                catch (_m) {
-                    blobText = `--- ${relPath} (file not readable) ---`;
-                }
-                // Preserve relevance order when scores are absent (rank-derived
-                // fallback) so the density tiebreaker never reshuffles arbitrarily.
-                const score = typeof r.score === "number"
-                    ? r.score
-                    : (filteredData.length - idx) / filteredData.length;
-                return { blobText, tokens: Math.ceil(blobText.length / 4), score };
-            });
-            const pack = packByBudget(candidates.map((c) => ({ tokens: c.tokens, score: c.score })), budget);
-            for (const i of pack.selected) {
-                console.log(`\n${candidates[i].blobText}`);
-            }
-            if (pack.dropped > 0) {
-                console.log(`\n(budget: ~${pack.tokensUsed}/${budget} tokens, ${pack.dropped} lower-density result${pack.dropped > 1 ? "s" : ""} not shown)`);
-            }
-            return;
-        }
-        const isTTY = process.stdout.isTTY;
-        const shouldBePlain = options.plain || !isTTY;
-        if (!options.agent && !options.compact) {
-            console.log((0, compact_results_1.resultCountHeader)(filteredData, parseInt(options.m, 10)));
-            console.log();
-        }
-        // Print imports per unique file before results when --imports is used
-        if (options.imports) {
-            const seenFiles = new Set();
-            for (const r of filteredData) {
-                const absP = (_h = (_f = r.path) !== null && _f !== void 0 ? _f : (_g = r.metadata) === null || _g === void 0 ? void 0 : _g.path) !== null && _h !== void 0 ? _h : "";
-                if (absP && !seenFiles.has(absP)) {
-                    seenFiles.add(absP);
-                    const imports = getImportsForFile(absP);
-                    if (imports) {
-                        const relP = absP.startsWith(effectiveRoot)
-                            ? absP.slice(effectiveRoot.length + 1)
-                            : absP;
-                        console.log(`--- imports: ${relP} ---\n${imports}\n`);
-                    }
-                }
-            }
-        }
-        if (shouldBePlain) {
-            const mappedResults = (0, compact_results_1.toTextResults)(filteredData);
-            const output = (0, formatter_1.formatTextResults)(mappedResults, pattern, projectRoot, {
-                isPlain: true,
-                compact: options.compact,
-                content: options.content,
-                perFile: parseInt(options.perFile, 10),
-                showScores: options.scores,
-            });
-            console.log(output);
-            if (options.explain) {
-                for (const r of filteredData) {
-                    const b = r.scoreBreakdown;
-                    if (b) {
-                        const absP = (_l = (_j = r.path) !== null && _j !== void 0 ? _j : (_k = r.metadata) === null || _k === void 0 ? void 0 : _k.path) !== null && _l !== void 0 ? _l : "";
-                        const relPath = absP.startsWith(projectRoot)
-                            ? absP.slice(projectRoot.length + 1)
-                            : absP;
-                        console.log(`  [explain ${relPath}] rerank=${b.rerank.toFixed(3)}  fused=${b.fused.toFixed(3)}  boost=${b.boost.toFixed(2)}x  final=${b.normalized.toFixed(3)}`);
-                    }
-                }
-            }
-        }
-        else {
-            // Use new holographic formatter for TTY
-            const { formatResults } = yield Promise.resolve().then(() => __importStar(require("../lib/output/formatter")));
-            const output = formatResults(filteredData, projectRoot, {
-                content: options.content,
-                explain: options.explain,
-            });
-            console.log(output);
-        }
-        // Symbol mode: append call graph
-        if (options.symbol) {
-            try {
-                let graph = precomputedGraph;
-                if (!graph) {
-                    if (!vectorDb)
-                        throw new Error("no graph source");
-                    const { GraphBuilder } = yield Promise.resolve().then(() => __importStar(require("../lib/graph/graph-builder")));
-                    const builder = new GraphBuilder(vectorDb, effectiveRoot);
-                    graph = yield builder.buildGraphMultiHop(pattern, 1);
-                }
-                if (graph === null || graph === void 0 ? void 0 : graph.center) {
-                    const lines = ["\n--- Call graph ---"];
-                    const centerRel = path.relative(effectiveRoot, graph.center.file);
-                    lines.push(`${graph.center.symbol} [${graph.center.role}] ${centerRel}:${graph.center.line + 1}`);
-                    if (graph.importers.length > 0) {
-                        const filtered = graph.importers.filter((p) => p !== graph.center.file);
-                        if (filtered.length > 0) {
-                            lines.push("Imported by:");
-                            for (const imp of filtered.slice(0, 10)) {
-                                lines.push(`  ${path.relative(effectiveRoot, imp)}`);
-                            }
-                        }
-                    }
-                    if (graph.callerTree.length > 0) {
-                        lines.push("Callers:");
-                        for (const t of graph.callerTree) {
-                            lines.push(`  <- ${t.node.symbol} ${path.relative(effectiveRoot, t.node.file)}:${t.node.line + 1}`);
-                        }
-                    }
-                    if (graph.callees.length > 0) {
-                        lines.push("Calls:");
-                        for (const c of graph.callees.slice(0, 15)) {
-                            if (c.file) {
-                                lines.push(`  -> ${c.symbol} ${path.relative(effectiveRoot, c.file)}:${c.line + 1}`);
-                            }
-                            else {
-                                lines.push(`  -> ${c.symbol} (not indexed)`);
-                            }
-                        }
-                    }
-                    console.log(lines.join("\n"));
-                }
-            }
-            catch (_q) {
-                // Trace failed — skip silently
-            }
-        }
+        const { searchResult, precomputedSkeletons, precomputedGraph, indexState, } = acquired;
+        // Presentation stage (shared by daemon-mediated + in-process paths):
+        // min-score/name post-filters + the 7-mode render switch live in
+        // renderSearchOutput; it returns the post-filter count for query logging.
+        const { resultCount } = yield (0, search_output_1.renderSearchOutput)({
+            searchResult,
+            options,
+            minScore,
+            crossProject,
+            pattern,
+            effectiveRoot,
+            projectRoot,
+            vectorDb,
+            precomputedSkeletons,
+            precomputedGraph,
+            indexState,
+        });
+        _searchResultCount = resultCount;
     }
     catch (error) {
         const message = error instanceof Error ? error.message : "Unknown error";
@@ -732,13 +314,13 @@ Examples:
                 source: "cli",
                 tool: "search",
                 query: pattern,
-                project: (_m = (0, project_root_1.findProjectRoot)(root)) !== null && _m !== void 0 ? _m : root,
+                project: (_e = (0, project_root_1.findProjectRoot)(root)) !== null && _e !== void 0 ? _e : root,
                 results: _searchResultCount,
                 ms: Date.now() - _searchStartMs,
                 error: _searchError,
             });
         }
-        catch (_r) { }
+        catch (_f) { }
         if (vectorDb) {
             try {
                 yield vectorDb.close();

package/dist/commands/similar.js

@@ -73,6 +73,7 @@ exports.similar = new commander_1.Command("similar")
             return;
         const projectRoot = (_a = (0, project_root_1.findProjectRoot)(root)) !== null && _a !== void 0 ? _a : root;
         (0, stale_hint_1.maybeWarnStaleChunker)(projectRoot, { agent: opts.agent });
+        (0, stale_hint_1.maybeWarnStaleEmbedding)(projectRoot, { agent: opts.agent });
         const paths = (0, project_root_1.ensureProjectPaths)(projectRoot);
         vectorDb = new vector_db_1.VectorDB(paths.lancedbDir);
         const table = yield vectorDb.ensureTable();

package/dist/commands/test-find.js

@@ -69,6 +69,7 @@ exports.testFind = new commander_1.Command("test")
             return;
         const projectRoot = (_a = (0, project_root_1.findProjectRoot)(root)) !== null && _a !== void 0 ? _a : root;
         (0, stale_hint_1.maybeWarnStaleChunker)(projectRoot, { agent: opts.agent });
+        (0, stale_hint_1.maybeWarnStaleEmbedding)(projectRoot, { agent: opts.agent });
         const paths = (0, project_root_1.ensureProjectPaths)(projectRoot);
         vectorDb = new vector_db_1.VectorDB(paths.lancedbDir);
         const { symbols, resolvedAsFile } = yield (0, impact_1.resolveTargetSymbols)(target, vectorDb, projectRoot);

package/dist/commands/trace.js

@@ -185,6 +185,7 @@ exports.trace = new commander_1.Command("trace")
     try {
         const projectRoot = (_a = (0, project_root_1.findProjectRoot)(root)) !== null && _a !== void 0 ? _a : root;
         (0, stale_hint_1.maybeWarnStaleChunker)(projectRoot, { agent: opts.agent });
+        (0, stale_hint_1.maybeWarnStaleEmbedding)(projectRoot, { agent: opts.agent });
         const paths = (0, project_root_1.ensureProjectPaths)(projectRoot);
         vectorDb = new vector_db_1.VectorDB(paths.lancedbDir);
         const { resolveScope } = yield Promise.resolve().then(() => __importStar(require("../lib/utils/scope-filter")));

package/dist/config.js

@@ -35,6 +35,7 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.INDEXABLE_EXTENSIONS = exports.FRAGMENT_COMPACT_THRESHOLD = exports.DISK_LOW_BYTES = exports.DISK_CRITICAL_BYTES = exports.MAX_FILE_SIZE_BYTES = exports.PATHS = exports.MAX_WORKER_MEMORY_MB = exports.WORKER_BOOT_TIMEOUT_MS = exports.WORKER_TIMEOUT_MS = exports.CHUNKER_VERSION_HISTORY = exports.CONFIG = exports.MODEL_IDS = exports.DEFAULT_MODEL_TIER = exports.MODEL_TIERS = void 0;
 exports.describeChunkerGap = describeChunkerGap;
+exports.describeEmbeddingGap = describeEmbeddingGap;
 const os = __importStar(require("node:os"));
 const path = __importStar(require("node:path"));
 exports.MODEL_TIERS = {
@@ -123,6 +124,39 @@ function describeChunkerGap(indexedVersion) {
         notes: missed.map((h) => h.note),
     };
 }
+/**
+ * Describe the gap between an index's stored embedding identity (model tier +
+ * vector dim) and the current global config, or null when they already agree.
+ *
+ * A dimension change is `breaking`: vectors of differing widths cannot be
+ * compared, and the single fixed-dim `chunks` table silently pads/truncates a
+ * mismatched query embedding, yielding meaningless scores. A same-width model
+ * swap is `additive`: the stored vectors are a different model's output but the
+ * same width, so search keeps working with mixed-model quality until a re-embed.
+ *
+ * Mirrors describeChunkerGap so `gmax doctor` and the query-time hint render the
+ * same severity. Pure over MODEL_TIERS — callers pass the current identity (read
+ * from the global config) so this module stays free of config I/O.
+ */
+function describeEmbeddingGap(stored, current) {
+    var _a, _b, _c, _d, _e, _f, _g, _h;
+    const fromModel = (_a = stored.modelTier) !== null && _a !== void 0 ? _a : exports.DEFAULT_MODEL_TIER;
+    const toModel = (_b = current.modelTier) !== null && _b !== void 0 ? _b : exports.DEFAULT_MODEL_TIER;
+    const fromDim = (_e = (_c = stored.vectorDim) !== null && _c !== void 0 ? _c : (_d = exports.MODEL_TIERS[fromModel]) === null || _d === void 0 ? void 0 : _d.vectorDim) !== null && _e !== void 0 ? _e : exports.CONFIG.VECTOR_DIM;
+    const toDim = (_h = (_f = current.vectorDim) !== null && _f !== void 0 ? _f : (_g = exports.MODEL_TIERS[toModel]) === null || _g === void 0 ? void 0 : _g.vectorDim) !== null && _h !== void 0 ? _h : exports.CONFIG.VECTOR_DIM;
+    const dimChanged = fromDim !== toDim;
+    const modelChanged = fromModel !== toModel;
+    if (!dimChanged && !modelChanged)
+        return null;
+    return {
+        fromModel,
+        toModel,
+        fromDim,
+        toDim,
+        dimChanged,
+        severity: dimChanged ? "breaking" : "additive",
+    };
+}
 exports.WORKER_TIMEOUT_MS = Number.parseInt(process.env.GMAX_WORKER_TIMEOUT_MS || "60000", 10);
 exports.WORKER_BOOT_TIMEOUT_MS = Number.parseInt(process.env.GMAX_WORKER_BOOT_TIMEOUT_MS || "300000", 10);
 exports.MAX_WORKER_MEMORY_MB = (() => {