grepmax 0.17.23 → 0.18.0

package/dist/commands/audit.js

@@ -46,11 +46,11 @@ exports.audit = void 0;
 exports.computeAudit = computeAudit;
 const commander_1 = require("commander");
 const callsites_1 = require("../lib/graph/callsites");
+const vector_db_1 = require("../lib/store/vector-db");
 const arrow_1 = require("../lib/utils/arrow");
 const exit_1 = require("../lib/utils/exit");
 const project_registry_1 = require("../lib/utils/project-registry");
 const project_root_1 = require("../lib/utils/project-root");
-const vector_db_1 = require("../lib/store/vector-db");
 const useColors = process.stdout.isTTY && !process.env.NO_COLOR;
 const style = {
     bold: (s) => (useColors ? `\x1b[1m${s}\x1b[22m` : s),
@@ -291,6 +291,7 @@ exports.audit = new commander_1.Command("audit")
             "start_line",
             "defined_symbols",
             "referenced_symbols",
+            "type_referenced_symbols",
             "is_exported",
         ])
             .where(buildScopeWhere(scope))
@@ -308,7 +309,14 @@ exports.audit = new commander_1.Command("audit")
             start_line: Number(r.start_line || 0),
             is_exported: Boolean(r.is_exported),
             defined_symbols: (0, arrow_1.toArr)(r.defined_symbols),
-            referenced_symbols: (0, arrow_1.toArr)(r.referenced_symbols),
+            // Union call-position + type-position edges so god-node ranking and
+            // dead-candidate detection see references made purely in type position.
+            referenced_symbols: [
+                ...new Set([
+                    ...(0, arrow_1.toArr)(r.referenced_symbols),
+                    ...(0, arrow_1.toArr)(r.type_referenced_symbols),
+                ]),
+            ],
         })), prefix, top);
         console.log(opts.agent ? formatAgent(result) : formatHuman(result));
     }

package/dist/commands/dead.js

@@ -50,6 +50,7 @@ const agent_errors_1 = require("../lib/utils/agent-errors");
 const exit_1 = require("../lib/utils/exit");
 const filter_builder_1 = require("../lib/utils/filter-builder");
 const project_registry_1 = require("../lib/utils/project-registry");
+const stale_hint_1 = require("../lib/utils/stale-hint");
 const project_root_1 = require("../lib/utils/project-root");
 const useColors = process.stdout.isTTY && !process.env.NO_COLOR;
 const style = {
@@ -118,6 +119,8 @@ exports.dead = new commander_1.Command("dead")
     let vectorDb = null;
     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, buildScopeWhere } = yield Promise.resolve().then(() => __importStar(require("../lib/utils/scope-filter")));

package/dist/commands/doctor.js

@@ -85,7 +85,7 @@ exports.doctor = new commander_1.Command("doctor")
     .option("--fix", "Auto-fix detected issues (compact, prune, remove stale locks)", false)
     .option("--agent", "Compact output for AI agents", false)
     .action((opts) => __awaiter(void 0, void 0, void 0, function* () {
-    var _a, _b, _c, _d;
+    var _a, _b, _c, _d, _e, _f;
     if (!opts.agent)
         console.log("gmax Doctor\n");
     const root = config_1.PATHS.globalRoot;
@@ -236,12 +236,18 @@ exports.doctor = new commander_1.Command("doctor")
             availBytes = diskStats.bavail * diskStats.bsize;
             diskLevel = availBytes < config_1.DISK_CRITICAL_BYTES ? "CRITICAL" : availBytes < config_1.DISK_LOW_BYTES ? "LOW" : "ok";
         }
-        catch (_e) { }
+        catch (_g) { }
         const staleChunkerProjects = projects.filter((p) => {
             var _a;
             return p.status === "indexed" &&
                 ((_a = p.chunkerVersion) !== null && _a !== void 0 ? _a : 1) < config_1.CONFIG.CHUNKER_VERSION;
         });
+        // Projects whose stored embedding model/dim no longer matches the global
+        // config. Visibility only — recovery is a manual `gmax index --reset`
+        // (a dim change can't be auto-fixed in the shared fixed-dim table; that's
+        // the deferred Phase 1B re-embed work).
+        const staleEmbeddingProjects = projects.filter((p) => p.status === "indexed" &&
+            (0, config_1.describeEmbeddingGap)({ modelTier: p.modelTier, vectorDim: p.vectorDim }, { modelTier: globalConfig.modelTier, vectorDim: globalConfig.vectorDim }) !== null);
         if (opts.agent) {
             const fields = [
                 "index_health",
@@ -257,12 +263,38 @@ exports.doctor = new commander_1.Command("doctor")
                 `daemon=${daemonUp ? "running" : "stopped"}`,
                 `orphaned=${orphanedProjects.length}`,
                 `stale_chunker=${staleChunkerProjects.length}`,
+                `stale_embedding=${staleEmbeddingProjects.length}`,
             ];
             console.log(fields.join("\t"));
-            if (staleChunkerProjects.length > 0) {
-                console.log(`stale_chunker_fix: run 'gmax index --reset' in: ${staleChunkerProjects
-                    .map((p) => p.name || path.basename(p.root))
-                    .join(", ")}`);
+            for (const p of staleChunkerProjects) {
+                const gap = (0, config_1.describeChunkerGap)(p.chunkerVersion);
+                if (!gap)
+                    continue;
+                console.log([
+                    "stale_chunker_project",
+                    `name=${p.name || path.basename(p.root)}`,
+                    `indexed_v=${gap.fromVersion}`,
+                    `current_v=${gap.toVersion}`,
+                    `severity=${gap.severity}`,
+                    `note=${gap.notes.join("; ")}`,
+                    `fix=gmax index --reset (in ${p.root})`,
+                ].join("\t"));
+            }
+            for (const p of staleEmbeddingProjects) {
+                const gap = (0, config_1.describeEmbeddingGap)({ modelTier: p.modelTier, vectorDim: p.vectorDim }, { modelTier: globalConfig.modelTier, vectorDim: globalConfig.vectorDim });
+                if (!gap)
+                    continue;
+                console.log([
+                    "stale_embedding_project",
+                    `name=${p.name || path.basename(p.root)}`,
+                    `indexed_model=${gap.fromModel}`,
+                    `current_model=${gap.toModel}`,
+                    `indexed_dim=${gap.fromDim}`,
+                    `current_dim=${gap.toDim}`,
+                    `dim_changed=${gap.dimChanged}`,
+                    `severity=${gap.severity}`,
+                    `fix=gmax index --reset (in ${p.root})`,
+                ].join("\t"));
             }
         }
         else {
@@ -307,13 +339,42 @@ exports.doctor = new commander_1.Command("doctor")
             }
             // Daemon
             console.log(`${daemonUp ? "ok" : "INFO"}  Daemon: ${daemonUp ? "running" : "not running"}`);
-            // Index built by an older chunker — graph metadata fixes need a reindex
+            // Index built by an older chunker — graph metadata fixes need a reindex.
+            // Severity (and the WARN/INFO label) is driven by CHUNKER_VERSION_HISTORY:
+            // a breaking gap means stale metadata is wrong, an additive gap only
+            // means newer edges are missing.
             if (staleChunkerProjects.length > 0) {
-                console.log(`WARN  Stale chunker: ${staleChunkerProjects.length} project(s) indexed before chunker v${config_1.CONFIG.CHUNKER_VERSION} — graph commands (peek/impact/trace) may overcount callers`);
+                const anyBreaking = staleChunkerProjects.some((p) => { var _a; return ((_a = (0, config_1.describeChunkerGap)(p.chunkerVersion)) === null || _a === void 0 ? void 0 : _a.severity) === "breaking"; });
+                console.log(`${anyBreaking ? "WARN" : "INFO"}  Stale chunker: ${staleChunkerProjects.length} project(s) indexed before chunker v${config_1.CONFIG.CHUNKER_VERSION} — run 'gmax doctor --fix' to reindex`);
                 for (const p of staleChunkerProjects) {
-                    console.log(`       - ${p.name || path.basename(p.root)}: run 'gmax index --reset' in ${p.root}`);
+                    const gap = (0, config_1.describeChunkerGap)(p.chunkerVersion);
+                    if (!gap)
+                        continue;
+                    console.log(`       - ${p.name || path.basename(p.root)} (v${gap.fromVersion}→v${gap.toVersion}, ${gap.severity}): ${gap.notes.join(" ")}`);
+                    console.log(`         run 'gmax index --reset' in ${p.root}`);
                 }
             }
+            // Index built with a different embedding model/dim than the current
+            // config. A dim change is breaking (search scores are invalid until a
+            // re-embed); a same-dim model swap is additive. Unlike the stale-chunker
+            // case this is NOT auto-fixed by `--fix`: a dim change can't coexist in
+            // the shared fixed-dim table (deferred Phase 1B), so we point at the
+            // manual reset instead.
+            if (staleEmbeddingProjects.length > 0) {
+                const gaps = staleEmbeddingProjects.map((p) => (0, config_1.describeEmbeddingGap)({ modelTier: p.modelTier, vectorDim: p.vectorDim }, { modelTier: globalConfig.modelTier, vectorDim: globalConfig.vectorDim }));
+                const anyBreaking = gaps.some((g) => (g === null || g === void 0 ? void 0 : g.severity) === "breaking");
+                console.log(`${anyBreaking ? "WARN" : "INFO"}  Stale embedding: ${staleEmbeddingProjects.length} project(s) indexed with a different embedding model/dim — run 'gmax index --reset' per project`);
+                staleEmbeddingProjects.forEach((p, i) => {
+                    const gap = gaps[i];
+                    if (!gap)
+                        return;
+                    const change = gap.dimChanged
+                        ? `${gap.fromDim}d→${gap.toDim}d`
+                        : `model ${gap.fromModel}→${gap.toModel}`;
+                    console.log(`       - ${p.name || path.basename(p.root)} (${change}, ${gap.severity})`);
+                    console.log(`         run 'gmax index --reset' in ${p.root}`);
+                });
+            }
             // Projects
             if (orphanedProjects.length > 0) {
                 console.log(`WARN  Orphaned projects: ${orphanedProjects.length} (directories no longer exist)`);
@@ -342,7 +403,7 @@ exports.doctor = new commander_1.Command("doctor")
                     }
                     yield mc.close();
                 }
-                catch (_f) { }
+                catch (_h) { }
             }
         }
         // --fix auto-remediation
@@ -372,6 +433,38 @@ exports.doctor = new commander_1.Command("doctor")
                     console.log(`ok  Removed ${orphanedProjects.length} orphaned project(s) from registry`);
                 fixed++;
             }
+            // Reindex projects whose index predates the current chunker. This is a
+            // full `--reset` reindex per project (routed through the daemon), so it
+            // can be slow on large repos — unlike the cheap fixes above.
+            if (staleChunkerProjects.length > 0) {
+                const { ensureDaemonRunning, sendStreamingCommand } = yield Promise.resolve().then(() => __importStar(require("../lib/utils/daemon-client")));
+                if (!(yield ensureDaemonRunning())) {
+                    if (!opts.agent)
+                        console.log("WARN  Stale chunker: daemon not running — start it (gmax watch --daemon -b) or run 'gmax index --reset' per project");
+                }
+                else {
+                    for (const p of staleChunkerProjects) {
+                        const name = p.name || path.basename(p.root);
+                        if (!opts.agent)
+                            console.log(`...  Reindexing ${name} (--reset)...`);
+                        const done = yield sendStreamingCommand({ cmd: "index", root: p.root, reset: true }, () => { }).catch((e) => ({ ok: false, error: String(e) }));
+                        if (done.ok) {
+                            (0, project_registry_1.registerProject)(Object.assign(Object.assign({}, p), { status: "indexed", chunkerVersion: config_1.CONFIG.CHUNKER_VERSION, lastIndexed: new Date().toISOString(), chunkCount: (_e = done.indexed) !== null && _e !== void 0 ? _e : p.chunkCount }));
+                            const chunks = (_f = done.indexed) !== null && _f !== void 0 ? _f : 0;
+                            if (opts.agent) {
+                                console.log(`stale_chunker_reindexed\tname=${name}\tchunks=${chunks}`);
+                            }
+                            else {
+                                console.log(`ok  ${name} reindexed (${chunks} chunks)`);
+                            }
+                            fixed++;
+                        }
+                        else if (!opts.agent) {
+                            console.log(`FAIL  ${name}: reindex failed (${done.error})`);
+                        }
+                    }
+                }
+            }
             if (fixed === 0) {
                 if (!opts.agent)
                     console.log("ok  Nothing to fix");

package/dist/commands/impact.js

@@ -51,6 +51,7 @@ const vector_db_1 = require("../lib/store/vector-db");
 const agent_errors_1 = require("../lib/utils/agent-errors");
 const exit_1 = require("../lib/utils/exit");
 const project_registry_1 = require("../lib/utils/project-registry");
+const stale_hint_1 = require("../lib/utils/stale-hint");
 const project_root_1 = require("../lib/utils/project-root");
 exports.impact = new commander_1.Command("impact")
     .description("Analyze change impact: dependents and affected tests")
@@ -72,6 +73,8 @@ exports.impact = new commander_1.Command("impact")
         if (root === null)
             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/peek.js

@@ -53,6 +53,7 @@ const exit_1 = require("../lib/utils/exit");
 const filter_builder_1 = require("../lib/utils/filter-builder");
 const language_1 = require("../lib/utils/language");
 const project_registry_1 = require("../lib/utils/project-registry");
+const stale_hint_1 = require("../lib/utils/stale-hint");
 const project_root_1 = require("../lib/utils/project-root");
 const useColors = process.stdout.isTTY && !process.env.NO_COLOR;
 const style = {
@@ -129,6 +130,8 @@ exports.peek = new commander_1.Command("peek")
     const depth = Math.min(Math.max(Number.parseInt(opts.depth || "1", 10), 1), 3);
     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, buildScopeWhere } = yield Promise.resolve().then(() => __importStar(require("../lib/utils/scope-filter")));

package/dist/commands/related.js

@@ -52,6 +52,7 @@ const exit_1 = require("../lib/utils/exit");
 const project_registry_1 = require("../lib/utils/project-registry");
 const project_root_1 = require("../lib/utils/project-root");
 const query_timeout_1 = require("../lib/utils/query-timeout");
+const stale_hint_1 = require("../lib/utils/stale-hint");
 const arrow_1 = require("../lib/utils/arrow");
 exports.related = new commander_1.Command("related")
     .description("Find files related by shared symbol references")
@@ -70,6 +71,8 @@ exports.related = new commander_1.Command("related")
         if (root === null)
             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 absPath = path.resolve(projectRoot, file);