grepmax 0.17.23 → 0.17.24

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,7 @@ 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 });
         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,7 +236,7 @@ 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" &&
@@ -259,10 +259,19 @@ exports.doctor = new commander_1.Command("doctor")
                 `stale_chunker=${staleChunkerProjects.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"));
             }
         }
         else {
@@ -307,11 +316,19 @@ 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}`);
                 }
             }
             // Projects
@@ -342,7 +359,7 @@ exports.doctor = new commander_1.Command("doctor")
                     }
                     yield mc.close();
                 }
-                catch (_f) { }
+                catch (_h) { }
             }
         }
         // --fix auto-remediation
@@ -372,6 +389,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,7 @@ 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 });
         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,7 @@ 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 });
         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,7 @@ 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 });
         const paths = (0, project_root_1.ensureProjectPaths)(projectRoot);
         vectorDb = new vector_db_1.VectorDB(paths.lancedbDir);
         const absPath = path.resolve(projectRoot, file);

package/dist/commands/search.js

@@ -56,6 +56,7 @@ 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_run_1 = require("./search-run");
 const search_skeletons_1 = require("./search-skeletons");
 exports.search = new commander_1.Command("search")
@@ -285,6 +286,7 @@ Examples:
         if (project.status === "pending") {
             console.warn("This project is still being indexed. Results may be incomplete.\n");
         }
+        (0, stale_hint_1.maybeWarnStaleChunker)(checkRoot, { 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.

package/dist/commands/similar.js

@@ -51,6 +51,7 @@ const filter_builder_1 = require("../lib/utils/filter-builder");
 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 stale_hint_1 = require("../lib/utils/stale-hint");
 const arrow_1 = require("../lib/utils/arrow");
 exports.similar = new commander_1.Command("similar")
     .description("Find semantically similar code to a symbol or file")
@@ -71,6 +72,7 @@ exports.similar = new commander_1.Command("similar")
         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 });
         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

@@ -50,6 +50,7 @@ const vector_db_1 = require("../lib/store/vector-db");
 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 stale_hint_1 = require("../lib/utils/stale-hint");
 exports.testFind = new commander_1.Command("test")
     .description("Find tests that exercise a symbol or file")
     .argument("<target>", "Symbol name or file path")
@@ -67,6 +68,7 @@ exports.testFind = new commander_1.Command("test")
         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 });
         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

@@ -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");
 const useColors = process.stdout.isTTY && !process.env.NO_COLOR;
 const dim = (s) => (useColors ? `\x1b[2m${s}\x1b[22m` : s);
@@ -183,6 +184,7 @@ exports.trace = new commander_1.Command("trace")
     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 });
         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

@@ -33,7 +33,8 @@ 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.CONFIG = exports.MODEL_IDS = exports.DEFAULT_MODEL_TIER = exports.MODEL_TIERS = void 0;
+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;
 const os = __importStar(require("node:os"));
 const path = __importStar(require("node:path"));
 exports.MODEL_TIERS = {
@@ -77,11 +78,51 @@ exports.CONFIG = {
     WORKER_THREADS: DEFAULT_WORKER_THREADS,
     QUERY_PREFIX: "",
     // Bump when chunk metadata semantics change in a way that requires a full
-    // reindex to take effect. v2: sub-chunk symbol lists scoped to the chunk's
-    // own content (previously every split sub-chunk inherited the parent's
-    // full defined/referenced symbol lists, fabricating graph edges).
-    CHUNKER_VERSION: 2,
+    // reindex to take effect. Must equal the latest entry's `v` in
+    // CHUNKER_VERSION_HISTORY below — see that list for per-version severity and
+    // the user-facing note rendered by `gmax doctor` and the staleness hint.
+    CHUNKER_VERSION: 3,
 };
+/**
+ * Per-version record of what changed in the chunker and how much it matters to
+ * an already-built index. `severity` drives tone: an "additive" change only
+ * adds new metadata (older indexes under-cover but aren't wrong), while a
+ * "breaking" change means older indexes carry incorrect metadata until a
+ * reindex. The `note` is shown verbatim to the user for the versions their
+ * index is missing. CONFIG.CHUNKER_VERSION must equal the highest `v` here.
+ */
+exports.CHUNKER_VERSION_HISTORY = [
+    {
+        v: 2,
+        severity: "breaking",
+        note: "sub-chunk symbol scoping; graph overcounted callers before this.",
+    },
+    {
+        v: 3,
+        severity: "additive",
+        note: "type-position edges; dead/trace miss type-only callers until reindex.",
+    },
+];
+/**
+ * Describe the gap between an index's stamped chunker version and the current
+ * one, or null when the index is already current. Shared by `gmax doctor` and
+ * the query-time staleness hint so both render the same severity + notes.
+ */
+function describeChunkerGap(indexedVersion) {
+    const fromVersion = indexedVersion !== null && indexedVersion !== void 0 ? indexedVersion : 1;
+    if (fromVersion >= exports.CONFIG.CHUNKER_VERSION)
+        return null;
+    const missed = exports.CHUNKER_VERSION_HISTORY.filter((h) => h.v > fromVersion && h.v <= exports.CONFIG.CHUNKER_VERSION);
+    const severity = missed.some((h) => h.severity === "breaking")
+        ? "breaking"
+        : "additive";
+    return {
+        fromVersion,
+        toVersion: exports.CONFIG.CHUNKER_VERSION,
+        severity,
+        notes: missed.map((h) => h.note),
+    };
+}
 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 = (() => {