grepmax 0.21.3 → 0.23.0

package/.claude-plugin/marketplace.json

@@ -10,14 +10,12 @@
       "name": "grepmax",
       "source": "./plugins/grepmax",
       "description": "Semantic code search for Claude Code. Automatically indexes your project and provides intelligent search capabilities.",
-      "version": "0.21.3",
+      "version": "0.23.0",
       "author": {
         "name": "Robert Owens",
         "email": "robowens@me.com"
       },
-      "skills": [
-        "./skills/grepmax"
-      ]
+      "skills": ["./skills/grepmax"]
     }
   ]
 }

package/README.md

@@ -72,6 +72,7 @@ gmax log src/lib/auth.ts                 # Git commit history for a path or symb
 gmax test handleAuth                     # Find tests via reverse call graph
 gmax impact handleAuth                   # Dependents + affected tests
 gmax similar handleAuth                  # Find similar code patterns
+gmax audit --top 10                      # God nodes, hub files, file cycles, dead candidates
 gmax dead handleAuth                     # Unused-symbol check via call graph (DEAD / PUBLIC EXPORT / LIVE)
 gmax context "auth system" --budget 4000 # Token-budgeted topic summary
 gmax context src/lib/auth.ts --budget 4000 # Deterministic file/path context
@@ -132,7 +133,7 @@ Plugins auto-update when you run `npm install -g grepmax@latest` — no need to
 | `extract_symbol` | Complete function/class body by symbol name. |
 | `peek_symbol` | Compact overview: signature + callers + callees. |
 | `dead` | Unused-symbol check via call graph. Returns `DEAD`, `PUBLIC EXPORT`, or `LIVE` with caller count. |
-| `audit` | Graph summary: god nodes, hub files, and dead-code candidates in one call. |
+| `audit` | Graph summary: god nodes, hub files, symbol-derived file dependency cycles, and dead-code candidates. |
 | `get_neighbors` | Graph primitive: symbols reachable from a node along call edges within N hops. |
 | `find_paths` | Graph primitive: shortest call-graph path between two symbols. |
 | `subgraph_for_files` | Graph primitive: local dependency subgraph for a set of files. |

package/dist/commands/audit.js

@@ -64,6 +64,73 @@ const MIN_GOD_NAME_LEN = 3;
 function rel(p, prefix) {
     return p.startsWith(prefix) ? p.slice(prefix.length) : p;
 }
+function findFileCycles(deps, prefix, top) {
+    const indexByFile = new Map();
+    const lowlink = new Map();
+    const stack = [];
+    const onStack = new Set();
+    const components = [];
+    let index = 0;
+    const strongConnect = (file) => {
+        var _a, _b, _c, _d, _e;
+        indexByFile.set(file, index);
+        lowlink.set(file, index);
+        index++;
+        stack.push(file);
+        onStack.add(file);
+        for (const dep of (_a = deps.get(file)) !== null && _a !== void 0 ? _a : []) {
+            if (!indexByFile.has(dep)) {
+                strongConnect(dep);
+                lowlink.set(file, Math.min((_b = lowlink.get(file)) !== null && _b !== void 0 ? _b : 0, (_c = lowlink.get(dep)) !== null && _c !== void 0 ? _c : 0));
+            }
+            else if (onStack.has(dep)) {
+                lowlink.set(file, Math.min((_d = lowlink.get(file)) !== null && _d !== void 0 ? _d : 0, (_e = indexByFile.get(dep)) !== null && _e !== void 0 ? _e : 0));
+            }
+        }
+        if (lowlink.get(file) !== indexByFile.get(file))
+            return;
+        const component = [];
+        while (stack.length > 0) {
+            const dep = stack.pop();
+            onStack.delete(dep);
+            component.push(dep);
+            if (dep === file)
+                break;
+        }
+        if (component.length > 1)
+            components.push(component);
+    };
+    const files = new Set();
+    for (const [file, targets] of deps) {
+        files.add(file);
+        for (const target of targets)
+            files.add(target);
+    }
+    for (const file of [...files].sort()) {
+        if (!indexByFile.has(file))
+            strongConnect(file);
+    }
+    return components
+        .map((component) => {
+        var _a;
+        const set = new Set(component);
+        let edgeCount = 0;
+        for (const file of component) {
+            for (const dep of (_a = deps.get(file)) !== null && _a !== void 0 ? _a : []) {
+                if (set.has(dep))
+                    edgeCount++;
+            }
+        }
+        return {
+            files: component.map((f) => rel(f, prefix)).sort(),
+            edgeCount,
+        };
+    })
+        .sort((a, b) => b.files.length - a.files.length ||
+        b.edgeCount - a.edgeCount ||
+        a.files.join("\0").localeCompare(b.files.join("\0")))
+        .slice(0, top);
+}
 /**
  * Pure aggregation over chunk rows — no DB, no I/O. Builds the symbol→def map,
  * cross-file inbound edges, and per-file fan-in/out, then derives god nodes
@@ -170,6 +237,23 @@ function computeAudit(rows, prefix, top) {
         });
     }
     hubFiles.sort((a, b) => b.dependents - a.dependents || b.defines - a.defines);
+    const fileDeps = new Map();
+    for (const [file, refs] of fileOutRefs) {
+        for (const s of refs) {
+            if ((0, callsites_1.isBuiltinCallee)(s))
+                continue;
+            const defFiles = defFileCounts.get(s);
+            if (!defFiles || defFiles.size !== 1)
+                continue;
+            const [depFile] = defFiles;
+            if (!depFile || depFile === file)
+                continue;
+            if (!fileDeps.has(file))
+                fileDeps.set(file, new Set());
+            fileDeps.get(file).add(depFile);
+        }
+    }
+    const fileCycles = findFileCycles(fileDeps, prefix, top);
     // Dead candidates — non-exported in-project symbols with zero inbound
     // references anywhere (including their own file).
     const deadAll = [];
@@ -186,10 +270,17 @@ function computeAudit(rows, prefix, top) {
         scannedFiles: files.size,
         godNodes: godNodes.slice(0, top),
         hubFiles: hubFiles.filter((h) => h.dependents > 0).slice(0, top),
+        fileCycles,
         deadCandidates: deadAll.slice(0, top),
         deadTotal: deadAll.length,
     };
 }
+function formatCycle(files) {
+    const shown = files.length > 6
+        ? [...files.slice(0, 6), `... ${files.length - 6} more`]
+        : files;
+    return shown.join(", ");
+}
 function formatHuman(r) {
     const out = [];
     out.push(`${style.bold("Audit")} ${style.dim(`— ${r.scannedChunks} chunks across ${r.scannedFiles} files`)}`);
@@ -217,6 +308,17 @@ function formatHuman(r) {
         }
     }
     out.push("");
+    out.push(style.bold("File dependency cycles") +
+        style.dim(" (symbol-derived, bounded SCCs)"));
+    if (r.fileCycles.length === 0) {
+        out.push(style.dim("  none"));
+    }
+    else {
+        for (const c of r.fileCycles) {
+            out.push(`  ${formatCycle(c.files)}  ${style.dim(`${c.files.length} files, ${c.edgeCount} internal edges`)}`);
+        }
+    }
+    out.push("");
     out.push(style.bold("Dead-code candidates") +
         style.dim(` (${r.deadTotal} non-exported symbols with zero inbound refs)`));
     if (r.deadCandidates.length === 0) {
@@ -246,6 +348,9 @@ function formatAgent(r) {
     for (const h of r.hubFiles) {
         lines.push(`hub\t${h.file}\t${h.dependents}\t${h.defines}\t${h.fanOut}`);
     }
+    for (const c of r.fileCycles) {
+        lines.push(`cycle\t${c.files.join(",")}\t${c.files.length}\t${c.edgeCount}`);
+    }
     for (const d of r.deadCandidates) {
         lines.push(`dead\t${d.symbol}\t${d.file}:${d.line + 1}`);
     }
@@ -253,11 +358,12 @@ function formatAgent(r) {
     return lines.join("\n");
 }
 exports.audit = new commander_1.Command("audit")
-    .description("Graph-summary of the indexed project — god nodes (most depended-upon " +
-    "symbols), hub files (most depended-upon files), and dead-code candidates " +
-    "(non-exported symbols with zero inbound references). One pass over the " +
-    "static call graph; dynamic dispatch / reflection / eval are invisible, so " +
-    "dead candidates are hypotheses, not proof.")
+    .description("Graph-summary of the indexed project: god nodes (most depended-upon " +
+    "symbols), hub files (most depended-upon files), symbol-derived file " +
+    "dependency cycles, and dead-code candidates (non-exported symbols with " +
+    "zero inbound references). One pass over the static reference graph; " +
+    "dynamic dispatch / reflection / eval are invisible, so dead candidates " +
+    "are hypotheses, not proof.")
     .option("--root <dir>", "Project root directory")
     .option("--in <subpath>", "Restrict to a sub-path of the project (repeatable)", (value, prev) => prev ? [...prev, value] : [value])
     .option("--exclude <subpath>", "Exclude a sub-path of the project (repeatable)", (value, prev) => prev ? [...prev, value] : [value])

package/dist/commands/dead.js

@@ -44,6 +44,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.dead = void 0;
 const commander_1 = require("commander");
+const languages_1 = require("../lib/core/languages");
 const graph_builder_1 = require("../lib/graph/graph-builder");
 const vector_db_1 = require("../lib/store/vector-db");
 const agent_errors_1 = require("../lib/utils/agent-errors");
@@ -147,7 +148,7 @@ exports.dead = new commander_1.Command("dead")
         const defLine = Number(defRow.start_line || 0);
         const isExported = Boolean(defRow.is_exported);
         const builder = new graph_builder_1.GraphBuilder(vectorDb, scope.pathPrefix, scope.excludePrefixes);
-        const callers = yield builder.getCallers(symbol);
+        const callers = yield builder.getCallers(symbol, (0, languages_1.languageFamilyForPath)(defPath));
         const status = callers.length === 0 ? (isExported ? "PUBLIC_EXPORT" : "DEAD") : "LIVE";
         const topCallers = callers
             .slice(0, TOP_CALLERS)

package/dist/commands/impact.js

@@ -77,7 +77,7 @@ exports.impact = new commander_1.Command("impact")
         (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);
+        const { symbols, resolvedAsFile, symbolFamilies } = yield (0, impact_1.resolveTargetSymbols)(target, vectorDb, projectRoot);
         if (symbols.length === 0) {
             console.log(resolvedAsFile
                 ? `No symbols found in file: ${target}`
@@ -109,9 +109,9 @@ exports.impact = new commander_1.Command("impact")
         // traversal entirely so the affected-tests section is omitted (not just
         // empty) below.
         const [dependents, tests] = yield Promise.all([
-            (0, impact_1.findDependents)(symbols, vectorDb, queryRoot, excludePaths, undefined, scope.excludePrefixes),
+            (0, impact_1.findDependents)(symbols, vectorDb, queryRoot, excludePaths, undefined, scope.excludePrefixes, symbolFamilies),
             includeTests
-                ? (0, impact_1.findTests)(symbols, vectorDb, queryRoot, depth, scope.excludePrefixes)
+                ? (0, impact_1.findTests)(symbols, vectorDb, queryRoot, depth, scope.excludePrefixes, symbolFamilies)
                 : Promise.resolve([]),
         ]);
         // Separate test files from non-test dependents

package/dist/commands/mcp.js

@@ -65,6 +65,7 @@ const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
 const commander_1 = require("commander");
 const zod_1 = require("zod");
 const config_1 = require("../config");
+const languages_1 = require("../lib/core/languages");
 const graph_builder_1 = require("../lib/graph/graph-builder");
 const index_config_1 = require("../lib/index/index-config");
 const syncer_1 = require("../lib/index/syncer");
@@ -906,6 +907,7 @@ exports.mcp = new commander_1.Command("mcp")
                                 symbol: t.node.symbol,
                                 file: t.node.file,
                                 line: t.node.line,
+                                edgeKind: t.node.edgeKind,
                             });
                             walkCallers(t.callers);
                         }
@@ -933,7 +935,12 @@ exports.mcp = new commander_1.Command("mcp")
                         const loc = c.file
                             ? `${rel(c.file)}:${c.line + 1}`
                             : "(not indexed)";
-                        parts.push(`  <- ${c.symbol}  ${loc}`);
+                        // `(member)`/`(type)` flag inferred edges (receiver-unverified call
+                        // or a type-position ref) so they don't read as confirmed callers.
+                        const tag = c.edgeKind === "member" || c.edgeKind === "type"
+                            ? ` (${c.edgeKind})`
+                            : "";
+                        parts.push(`  <- ${c.symbol}  ${loc}${tag}`);
                     }
                     if (callerList.length > maxCallers) {
                         parts.push(`  ... and ${callerList.length - maxCallers} more`);
@@ -993,7 +1000,7 @@ exports.mcp = new commander_1.Command("mcp")
                 const defLine = Number(defRow.start_line || 0);
                 const isExported = Boolean(defRow.is_exported);
                 const builder = new graph_builder_1.GraphBuilder(db, root);
-                const callers = yield builder.getCallers(symbol);
+                const callers = yield builder.getCallers(symbol, (0, languages_1.languageFamilyForPath)(defPath));
                 const rel = (p) => p.startsWith(root) ? p.slice(root.length + 1) : p;
                 const defLoc = `${rel(defPath)}:${defLine + 1}`;
                 if (callers.length === 0) {
@@ -1035,6 +1042,7 @@ exports.mcp = new commander_1.Command("mcp")
                     "start_line",
                     "defined_symbols",
                     "referenced_symbols",
+                    "type_referenced_symbols",
                     "is_exported",
                 ])
                     .where((0, filter_builder_1.pathStartsWith)(prefix))
@@ -1048,7 +1056,12 @@ exports.mcp = new commander_1.Command("mcp")
                     start_line: Number(r.start_line || 0),
                     is_exported: Boolean(r.is_exported),
                     defined_symbols: toStringArray(r.defined_symbols),
-                    referenced_symbols: toStringArray(r.referenced_symbols),
+                    referenced_symbols: [
+                        ...new Set([
+                            ...toStringArray(r.referenced_symbols),
+                            ...toStringArray(r.type_referenced_symbols),
+                        ]),
+                    ],
                 })), prefix, top);
                 const lines = [];
                 lines.push(`Audit — ${audit.scannedChunks} chunks across ${audit.scannedFiles} files`);
@@ -1067,6 +1080,13 @@ exports.mcp = new commander_1.Command("mcp")
                 if (audit.hubFiles.length === 0)
                     lines.push("  none");
                 lines.push("");
+                lines.push("File dependency cycles (symbol-derived):");
+                for (const c of audit.fileCycles) {
+                    lines.push(`  ${c.files.join(", ")} - ${c.files.length} files, ${c.edgeCount} internal edges`);
+                }
+                if (audit.fileCycles.length === 0)
+                    lines.push("  none");
+                lines.push("");
                 lines.push(`Dead-code candidates (${audit.deadTotal} non-exported symbols with zero inbound refs):`);
                 for (const d of audit.deadCandidates) {
                     lines.push(`  ${d.symbol} (${d.file}:${d.line + 1})`);
@@ -1714,10 +1734,10 @@ exports.mcp = new commander_1.Command("mcp")
             try {
                 const { resolveTargetSymbols, findTests } = yield Promise.resolve().then(() => __importStar(require("../lib/graph/impact")));
                 const db = getVectorDb();
-                const { symbols } = yield resolveTargetSymbols(target, db, projectRoot);
+                const { symbols, symbolFamilies } = yield resolveTargetSymbols(target, db, projectRoot);
                 if (symbols.length === 0)
                     return ok(`No symbols found for: ${target}`);
-                const tests = yield findTests(symbols, db, projectRoot, depth);
+                const tests = yield findTests(symbols, db, projectRoot, depth, undefined, symbolFamilies);
                 if (tests.length === 0)
                     return ok(`No tests found for ${target}.`);
                 const rel = (p) => p.startsWith(`${projectRoot}/`) ? p.slice(projectRoot.length + 1) : p;
@@ -1742,7 +1762,7 @@ exports.mcp = new commander_1.Command("mcp")
             try {
                 const { resolveTargetSymbols, findTests, findDependents, isTestPath } = yield Promise.resolve().then(() => __importStar(require("../lib/graph/impact")));
                 const db = getVectorDb();
-                const { symbols, resolvedAsFile } = yield resolveTargetSymbols(target, db, projectRoot);
+                const { symbols, resolvedAsFile, symbolFamilies } = yield resolveTargetSymbols(target, db, projectRoot);
                 if (symbols.length === 0)
                     return ok(`No symbols found for: ${target}`);
                 const targetPath = resolvedAsFile
@@ -1750,8 +1770,8 @@ exports.mcp = new commander_1.Command("mcp")
                     : undefined;
                 const excludePaths = targetPath ? new Set([targetPath]) : undefined;
                 const [dependents, tests] = yield Promise.all([
-                    findDependents(symbols, db, projectRoot, excludePaths),
-                    findTests(symbols, db, projectRoot, depth),
+                    findDependents(symbols, db, projectRoot, excludePaths, undefined, undefined, symbolFamilies),
+                    findTests(symbols, db, projectRoot, depth, undefined, symbolFamilies),
                 ]);
                 const nonTestDeps = dependents.filter((d) => !isTestPath(d.file));
                 const rel = (p) => p.startsWith(`${projectRoot}/`) ? p.slice(projectRoot.length + 1) : p;
@@ -2197,7 +2217,7 @@ exports.mcp = new commander_1.Command("mcp")
         },
     }, handleDead);
     tool("audit", {
-        description: "Graph-summary of the indexed project in one call: god nodes (most depended-upon symbols), hub files (most depended-upon files), and dead-code candidates (non-exported symbols with zero inbound references). Built from the static call graph — dynamic dispatch, reflection, eval, and type-position-only references are invisible, so dead candidates are hypotheses; verify with the `dead` tool before acting.",
+        description: "Graph-summary of the indexed project in one call: god nodes (most depended-upon symbols), hub files (most depended-upon files), symbol-derived file dependency cycles, and dead-code candidates (non-exported symbols with zero inbound references). Built from the static reference graph; dynamic dispatch, reflection, and eval are invisible, so dead candidates are hypotheses; verify with the `dead` tool before acting.",
         inputSchema: {
             root: zod_1.z
                 .string()

package/dist/commands/peek.js

@@ -212,7 +212,6 @@ exports.peek = new commander_1.Command("peek")
         const endLine = metaRows.length > 0
             ? Number(metaRows[0].end_line || 0)
             : center.line;
-        // Get multi-hop callers if depth > 1
         let callerList;
         if (depth > 1) {
             const multiHop = yield graphBuilder.buildGraphMultiHop(symbol, depth);
@@ -224,6 +223,7 @@ exports.peek = new commander_1.Command("peek")
                         symbol: t.node.symbol,
                         file: t.node.file,
                         line: t.node.line,
+                        edgeKind: t.node.edgeKind,
                     });
                     walkCallers(t.callers);
                 }
@@ -236,8 +236,16 @@ exports.peek = new commander_1.Command("peek")
                 symbol: c.symbol,
                 file: c.file,
                 line: c.line,
+                edgeKind: c.edgeKind,
             }));
         }
+        // Confidence per caller symbol: getCallers sorts free calls first, so the
+        // first edgeKind seen for a symbol is its highest-confidence one.
+        const edgeKindBySym = new Map();
+        for (const c of callerList) {
+            if (!edgeKindBySym.has(c.symbol))
+                edgeKindBySym.set(c.symbol, c.edgeKind);
+        }
         // Re-anchor chunk-level caller rows to actual call sites and dedupe —
         // getCallers() returns one row per chunk, which multiplies callers for
         // classes split across many chunks (verified: 3 real call sites → 66).
@@ -247,6 +255,7 @@ exports.peek = new commander_1.Command("peek")
                 symbol: c.symbol,
                 file: c.file,
                 line: (_a = c.snippetLine) !== null && _a !== void 0 ? _a : c.line,
+                edgeKind: edgeKindBySym.get(c.symbol),
             });
         });
         // Builtins listed as "(not indexed)" callees (trunc, now, filter, …)
@@ -266,6 +275,10 @@ exports.peek = new commander_1.Command("peek")
             file: c.file,
             line: c.line,
         }));
+        // Inferred-caller marker: `member` = receiver-unverified `x.T()`, `type` =
+        // a type-position reference (not a call). Free calls render clean — the
+        // trustworthy default — so only guesses carry a tag.
+        const kindTag = (k) => k === "member" || k === "type" ? ` (${k})` : "";
         if (opts.agent) {
             // Compact TSV output
             const exportedStr = exported ? "exported" : "";
@@ -290,7 +303,7 @@ exports.peek = new commander_1.Command("peek")
             console.log(`sig: ${sigOnly}`);
             // Callers
             for (const c of resolvedCallers.slice(0, MAX_CALLERS)) {
-                console.log(`<- ${c.symbol}\t${c.file ? `${rel(c.file)}:${c.line + 1}` : "(not indexed)"}`);
+                console.log(`<- ${c.symbol}\t${c.file ? `${rel(c.file)}:${c.line + 1}` : "(not indexed)"}${kindTag(c.edgeKind)}`);
             }
             if (resolvedCallers.length > MAX_CALLERS) {
                 console.log(`<- ... ${resolvedCallers.length - MAX_CALLERS} more`);
@@ -338,10 +351,10 @@ exports.peek = new commander_1.Command("peek")
                 console.log(style.bold(`callers (${resolvedCallers.length}):`));
                 for (const c of shown) {
                     if (c.file) {
-                        console.log(`  ${style.blue("\u2190")} ${style.green(c.symbol.padEnd(25))} ${style.dim(`${rel(c.file)}:${c.line + 1}`)}`);
+                        console.log(`  ${style.blue("\u2190")} ${style.green(c.symbol.padEnd(25))} ${style.dim(`${rel(c.file)}:${c.line + 1}`)}${style.dim(kindTag(c.edgeKind))}`);
                     }
                     else {
-                        console.log(`  ${style.blue("\u2190")} ${c.symbol.padEnd(25)} ${style.dim("(not indexed)")}`);
+                        console.log(`  ${style.blue("\u2190")} ${c.symbol.padEnd(25)} ${style.dim("(not indexed)")}${style.dim(kindTag(c.edgeKind))}`);
                     }
                 }
                 if (resolvedCallers.length > MAX_CALLERS) {

package/dist/commands/plugin.js

@@ -174,33 +174,40 @@ function installAll() {
     });
 }
 // --- Subcommands ---
-const addCmd = new commander_1.Command("add")
-    .description("Install or update gmax plugins")
-    .argument("[client]", "Client to install (claude, opencode, codex, droid, all)")
-    .action((clientArg) => __awaiter(void 0, void 0, void 0, function* () {
-    const clients = getClients();
-    const onlyId = clientArg && clientArg !== "all" ? clientArg : undefined;
-    if (onlyId) {
-        const client = clients.find((c) => c.id === onlyId);
-        if (!client) {
-            console.error(`Unknown client: ${onlyId}`);
-            console.error(`Available: ${clients.map((c) => c.id).join(", ")}`);
-            yield (0, exit_1.gracefulExit)(1);
-            return;
-        }
-        if (!client.detect()) {
-            console.error(`${client.name} not found on this system`);
-            yield (0, exit_1.gracefulExit)(1);
+function installAction(clientArg) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const clients = getClients();
+        const onlyId = clientArg && clientArg !== "all" ? clientArg : undefined;
+        if (onlyId) {
+            const client = clients.find((c) => c.id === onlyId);
+            if (!client) {
+                console.error(`Unknown client: ${onlyId}`);
+                console.error(`Available: ${clients.map((c) => c.id).join(", ")}`);
+                yield (0, exit_1.gracefulExit)(1);
+                return;
+            }
+            if (!client.detect()) {
+                console.error(`${client.name} not found on this system`);
+                yield (0, exit_1.gracefulExit)(1);
+                return;
+            }
+            yield client.install();
+            yield (0, exit_1.gracefulExit)();
             return;
         }
-        yield client.install();
+        // Install all detected
+        yield installAll();
         yield (0, exit_1.gracefulExit)();
-        return;
-    }
-    // Install all detected
-    yield installAll();
-    yield (0, exit_1.gracefulExit)();
-}));
+    });
+}
+const addCmd = new commander_1.Command("add")
+    .description("Install or update gmax plugins")
+    .argument("[client]", "Client to install (claude, opencode, codex, droid, all)")
+    .action(installAction);
+const updateCmd = new commander_1.Command("update")
+    .description("Update gmax plugins")
+    .argument("[client]", "Client to update (claude, opencode, codex, droid, all)")
+    .action(installAction);
 const removeCmd = new commander_1.Command("remove")
     .description("Remove gmax plugins")
     .argument("[client]", "Client to remove (claude, opencode, codex, droid, all)")
@@ -261,6 +268,8 @@ function statusAction() {
         console.log("\nCommands:");
         console.log("  gmax plugin add               Install all detected clients");
         console.log("  gmax plugin add <client>      Install a specific client");
+        console.log("  gmax plugin update            Update all detected clients");
+        console.log("  gmax plugin update <client>   Update a specific client");
         console.log("  gmax plugin remove            Remove all installed plugins");
         console.log("  gmax plugin remove <client>   Remove a specific plugin");
         yield (0, exit_1.gracefulExit)();
@@ -270,4 +279,5 @@ exports.plugin = new commander_1.Command("plugin")
     .description("Manage gmax plugins for AI coding clients")
     .action(statusAction)
     .addCommand(addCmd)
+    .addCommand(updateCmd)
     .addCommand(removeCmd);

package/dist/commands/search-run.js

@@ -44,6 +44,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.runSearch = runSearch;
 const path = __importStar(require("node:path"));
+const config_1 = require("../config");
 const grammar_loader_1 = require("../lib/index/grammar-loader");
 const sync_helpers_1 = require("../lib/index/sync-helpers");
 const syncer_1 = require("../lib/index/syncer");
@@ -188,6 +189,7 @@ function runSearch(params) {
                             lastIndexed: new Date().toISOString(),
                             chunkCount: result.indexed,
                             status: "indexed",
+                            chunkerVersion: config_1.CONFIG.CHUNKER_VERSION,
                         });
                         const failedSuffix = result.failedFiles > 0 ? ` • ${result.failedFiles} failed` : "";
                         spinner.succeed(`${options.sync ? "Indexing" : "Initial indexing"} complete (${result.processed}/${result.total}) • indexed ${result.indexed}${failedSuffix}`);

package/dist/commands/search.js

@@ -144,7 +144,17 @@ Examples:
     // Check for running server. The per-project HTTP server can't answer
     // cross-project queries, so cross-project mode skips it and uses the
     // daemon-mediated / in-process path (both query the shared table).
-    const execPathForServer = exec_path ? path.resolve(exec_path) : root;
+    let resolvedOptionRoot;
+    if (options.root && !crossProject.active) {
+        resolvedOptionRoot = (0, project_registry_1.resolveRootOrExit)(options.root);
+        if (resolvedOptionRoot === null)
+            return;
+    }
+    const execPathForServer = resolvedOptionRoot
+        ? resolvedOptionRoot
+        : exec_path
+            ? path.resolve(exec_path)
+            : root;
     const projectRootForServer = (_a = (0, project_root_1.findProjectRoot)(execPathForServer)) !== null && _a !== void 0 ? _a : execPathForServer;
     const server = crossProject.active
         ? null
@@ -167,21 +177,21 @@ Examples:
     try {
         yield (0, setup_helpers_1.ensureSetup)();
         const searchRoot = exec_path ? path.resolve(exec_path) : root;
-        const projectRoot = (_b = (0, project_root_1.findProjectRoot)(searchRoot)) !== null && _b !== void 0 ? _b : searchRoot;
-        const paths = (0, project_root_1.ensureProjectPaths)(projectRoot);
-        // Propagate project root to worker processes
-        process.env.GMAX_PROJECT_ROOT = projectRoot;
-        // Check if project is registered
-        let checkRoot;
+        const cwdProjectRoot = (_b = (0, project_root_1.findProjectRoot)(searchRoot)) !== null && _b !== void 0 ? _b : searchRoot;
+        let checkRoot = cwdProjectRoot;
         if (options.root) {
-            const resolved = (0, project_registry_1.resolveRootOrExit)(options.root);
+            const resolved = resolvedOptionRoot !== undefined
+                ? resolvedOptionRoot
+                : (0, project_registry_1.resolveRootOrExit)(options.root);
             if (resolved === null)
                 return;
             checkRoot = (_c = (0, project_root_1.findProjectRoot)(resolved)) !== null && _c !== void 0 ? _c : resolved;
         }
-        else {
-            checkRoot = projectRoot;
-        }
+        const projectRoot = crossProject.active ? cwdProjectRoot : checkRoot;
+        const paths = (0, project_root_1.ensureProjectPaths)(projectRoot);
+        // Propagate project root to worker processes
+        process.env.GMAX_PROJECT_ROOT = projectRoot;
+        // Check if project is registered
         const project = (0, project_registry_1.getProject)(checkRoot);
         if (!project) {
             console.error(`This project hasn't been added to gmax yet.\n\nRun: gmax add ${checkRoot}\n`);

package/dist/commands/test-find.js

@@ -72,7 +72,7 @@ exports.testFind = new commander_1.Command("test")
         (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);
+        const { symbols, resolvedAsFile, symbolFamilies } = yield (0, impact_1.resolveTargetSymbols)(target, vectorDb, projectRoot);
         if (symbols.length === 0) {
             console.log(resolvedAsFile
                 ? `No symbols found in file: ${target}`
@@ -89,7 +89,7 @@ exports.testFind = new commander_1.Command("test")
         const queryRoot = opts.in && opts.in.length > 0
             ? scope.pathPrefix.replace(/\/$/, "")
             : projectRoot;
-        const tests = yield (0, impact_1.findTests)(symbols, vectorDb, queryRoot, depth, scope.excludePrefixes);
+        const tests = yield (0, impact_1.findTests)(symbols, vectorDb, queryRoot, depth, scope.excludePrefixes, symbolFamilies);
         if (tests.length === 0) {
             console.log(`No tests found for ${target}.`);
             return;