grepmax 0.7.3 → 0.7.5

package/dist/commands/mcp.js

@@ -103,6 +103,14 @@ const TOOLS = [
                     type: "number",
                     description: "Max results per file (default: no cap). Useful to get diversity across files.",
                 },
+                file: {
+                    type: "string",
+                    description: "Filter to files matching this name (e.g. 'syncer.ts'). Matches the filename, not the full path.",
+                },
+                exclude: {
+                    type: "string",
+                    description: "Exclude files under this path prefix (e.g. 'tests/' or 'dist/').",
+                },
             },
             required: ["query"],
         },
@@ -133,6 +141,14 @@ const TOOLS = [
                     type: "number",
                     description: "Max results per file (default: no cap).",
                 },
+                file: {
+                    type: "string",
+                    description: "Filter to files matching this name (e.g. 'syncer.ts').",
+                },
+                exclude: {
+                    type: "string",
+                    description: "Exclude files under this path prefix (e.g. 'tests/').",
+                },
             },
             required: ["query"],
         },
@@ -304,10 +320,39 @@ exports.mcp = new commander_1.Command("mcp")
         });
     }
     // --- Index sync ---
+    let _indexChildPid = null;
+    function isIndexProcessRunning() {
+        if (!_indexChildPid)
+            return false;
+        try {
+            process.kill(_indexChildPid, 0);
+            return true;
+        }
+        catch (_a) {
+            return false;
+        }
+    }
     function ensureIndexReady() {
         return __awaiter(this, void 0, void 0, function* () {
+            var _a;
             if (_indexReady)
                 return;
+            // Check if a previously spawned index process finished
+            if (_indexing && !isIndexProcessRunning()) {
+                _indexing = false;
+                _indexProgress = "";
+                _indexChildPid = null;
+                // Re-check if index now exists
+                try {
+                    const db = getVectorDb();
+                    if (yield db.hasRowsForPath(projectRoot)) {
+                        _indexReady = true;
+                        console.log("[MCP] Background indexing complete.");
+                        return;
+                    }
+                }
+                catch (_b) { }
+            }
             try {
                 const db = getVectorDb();
                 const hasIndex = yield db.hasRowsForPath(projectRoot);
@@ -316,23 +361,25 @@ exports.mcp = new commander_1.Command("mcp")
                         return; // Already indexing in background
                     _indexing = true;
                     _indexProgress = "starting...";
-                    console.log("[MCP] No index found, running initial sync...");
-                    (0, syncer_1.initialSync)({
-                        projectRoot,
-                        onProgress: (info) => {
-                            _indexProgress = `${info.processed}/${info.total || "?"} files`;
-                        },
-                    })
-                        .then(() => {
-                        _indexReady = true;
-                        _indexing = false;
-                        _indexProgress = "";
-                        console.log("[MCP] Initial sync complete.");
-                    })
-                        .catch((e) => {
+                    console.log("[MCP] No index found, spawning background index...");
+                    // Spawn gmax index as a detached child process — doesn't hold
+                    // the lock inside this MCP process, so CLI `gmax index` won't conflict.
+                    const child = (0, node_child_process_1.spawn)(process.argv[0], [process.argv[1], "index", "--path", projectRoot], { detached: true, stdio: "ignore" });
+                    _indexChildPid = (_a = child.pid) !== null && _a !== void 0 ? _a : null;
+                    child.unref();
+                    _indexProgress = `PID ${_indexChildPid}`;
+                    console.log(`[MCP] Background index started (PID: ${_indexChildPid})`);
+                    child.on("exit", (code) => {
                         _indexing = false;
                         _indexProgress = "";
-                        console.error("[MCP] Index sync failed:", e);
+                        _indexChildPid = null;
+                        if (code === 0) {
+                            _indexReady = true;
+                            console.log("[MCP] Background indexing complete.");
+                        }
+                        else {
+                            console.error(`[MCP] Background indexing failed (exit code: ${code})`);
+                        }
                     });
                 }
                 else {
@@ -391,7 +438,14 @@ exports.mcp = new commander_1.Command("mcp")
                             pathPrefix += "/";
                     }
                 }
-                const result = yield searcher.search(query, limit, { rerank: true }, undefined, pathPrefix);
+                const filters = {};
+                if (typeof args.file === "string" && args.file) {
+                    filters.file = args.file;
+                }
+                if (typeof args.exclude === "string" && args.exclude) {
+                    filters.exclude = args.exclude;
+                }
+                const result = yield searcher.search(query, limit, { rerank: true }, Object.keys(filters).length > 0 ? filters : undefined, pathPrefix);
                 if (!result.data || result.data.length === 0) {
                     return ok("No matches found.");
                 }
@@ -539,11 +593,23 @@ exports.mcp = new commander_1.Command("mcp")
                 else {
                     lines.push("Callers: none");
                 }
-                // Callees (cap at 15)
+                // Callees with file paths
                 if (graph.callees.length > 0) {
-                    const capped = graph.callees.slice(0, 15);
-                    const suffix = graph.callees.length > 15 ? ` (+${graph.callees.length - 15} more)` : "";
-                    lines.push(`Calls: ${capped.join(", ")}${suffix}`);
+                    lines.push("Calls:");
+                    for (const callee of graph.callees.slice(0, 15)) {
+                        if (callee.file) {
+                            const rel = callee.file.startsWith(projectRoot)
+                                ? callee.file.slice(projectRoot.length + 1)
+                                : callee.file;
+                            lines.push(`  -> ${callee.symbol} ${rel}:${callee.line + 1}`);
+                        }
+                        else {
+                            lines.push(`  -> ${callee.symbol} (not indexed)`);
+                        }
+                    }
+                    if (graph.callees.length > 15) {
+                        lines.push(`  (+${graph.callees.length - 15} more)`);
+                    }
                 }
                 else {
                     lines.push("Calls: none");
@@ -664,7 +730,23 @@ exports.mcp = new commander_1.Command("mcp")
                     indexingLine,
                     "",
                     "Indexed directories:",
-                    ...projects.map((p) => { var _a; return `  ${p.name}\t${p.root}\t${(_a = p.lastIndexed) !== null && _a !== void 0 ? _a : "unknown"}`; }),
+                    ...(yield Promise.all(projects.map((p) => __awaiter(this, void 0, void 0, function* () {
+                        var _a, _b;
+                        const prefix = p.root.endsWith("/") ? p.root : `${p.root}/`;
+                        try {
+                            const table = yield db.ensureTable();
+                            const rows = yield table
+                                .query()
+                                .select(["id"])
+                                .where(`path LIKE '${(0, filter_builder_1.escapeSqlString)(prefix)}%'`)
+                                .limit(100000)
+                                .toArray();
+                            return `  ${p.name}\t${p.root}\t${(_a = p.lastIndexed) !== null && _a !== void 0 ? _a : "unknown"}\t(${rows.length} chunks)`;
+                        }
+                        catch (_c) {
+                            return `  ${p.name}\t${p.root}\t${(_b = p.lastIndexed) !== null && _b !== void 0 ? _b : "unknown"}`;
+                        }
+                    })))),
                 ].filter(Boolean);
                 return ok(lines.join("\n"));
             }

package/dist/lib/graph/graph-builder.js

@@ -69,9 +69,40 @@ class GraphBuilder {
                 : null;
             // 2. Get Callers
             const callers = yield this.getCallers(symbol);
-            // 3. Get Callees (from center)
-            const callees = center ? center.calls : [];
-            return { center, callers, callees };
+            // 3. Get Callees — resolve each to a GraphNode with file:line
+            const calleeNames = center ? center.calls.slice(0, 15) : [];
+            const calleeNodes = [];
+            for (const name of calleeNames) {
+                const esc = (0, filter_builder_1.escapeSqlString)(name);
+                const rows = yield table
+                    .query()
+                    .where(`array_contains(defined_symbols, '${esc}')`)
+                    .select([
+                    "path",
+                    "start_line",
+                    "defined_symbols",
+                    "referenced_symbols",
+                    "role",
+                    "parent_symbol",
+                    "complexity",
+                ])
+                    .limit(1)
+                    .toArray();
+                if (rows.length > 0) {
+                    calleeNodes.push(this.mapRowToNode(rows[0], name, "center"));
+                }
+                else {
+                    calleeNodes.push({
+                        symbol: name,
+                        file: "",
+                        line: 0,
+                        role: "",
+                        calls: [],
+                        calledBy: [],
+                    });
+                }
+            }
+            return { center, callers, callees: calleeNodes };
         });
     }
     mapRowToNode(row, targetSymbol, type) {

package/dist/lib/output/formatter.js

@@ -151,7 +151,12 @@ function formatTrace(graph) {
     if (graph.callees.length > 0) {
         lines.push(style.bold("Callees (What does this call?):"));
         graph.callees.forEach((callee) => {
-            lines.push(`  ${style.cyan("↓")} ${callee}`);
+            if (callee.file) {
+                lines.push(`  ${style.cyan("↓")} ${style.green(callee.symbol)} ${style.dim(`(${callee.file}:${callee.line})`)}`);
+            }
+            else {
+                lines.push(`  ${style.cyan("↓")} ${callee.symbol} ${style.dim("(not indexed)")}`);
+            }
         });
     }
     else {

package/dist/lib/search/searcher.js

@@ -277,6 +277,19 @@ class Searcher {
             if (pathPrefix) {
                 whereClauseParts.push(`path LIKE '${(0, filter_builder_1.escapeSqlString)((0, filter_builder_1.normalizePath)(pathPrefix))}%'`);
             }
+            // Handle file name filter
+            const fileFilter = _filters === null || _filters === void 0 ? void 0 : _filters.file;
+            if (typeof fileFilter === "string" && fileFilter) {
+                whereClauseParts.push(`path LIKE '%/${(0, filter_builder_1.escapeSqlString)(fileFilter)}'`);
+            }
+            // Handle exclude filter
+            const excludeFilter = _filters === null || _filters === void 0 ? void 0 : _filters.exclude;
+            if (typeof excludeFilter === "string" && excludeFilter) {
+                const absExclude = pathPrefix
+                    ? (0, filter_builder_1.normalizePath)(pathPrefix + excludeFilter)
+                    : excludeFilter;
+                whereClauseParts.push(`path NOT LIKE '${(0, filter_builder_1.escapeSqlString)(absExclude)}%'`);
+            }
             // Handle --def (definition) filter
             const defFilter = _filters === null || _filters === void 0 ? void 0 : _filters.def;
             if (typeof defFilter === "string" && defFilter) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "grepmax",
-  "version": "0.7.3",
+  "version": "0.7.5",
   "author": "Robert Owens <robowens@me.com>",
   "homepage": "https://github.com/reowens/grepmax",
   "bugs": {

package/plugins/grepmax/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "grepmax",
-  "version": "0.7.3",
+  "version": "0.7.5",
   "description": "Semantic code search for Claude Code. Automatically indexes your project and provides intelligent search capabilities.",
   "author": {
     "name": "Robert Owens",

package/plugins/grepmax/skills/grepmax/SKILL.md

@@ -42,6 +42,8 @@ Parameters:
 - `detail` (optional): `"pointer"` (default) or `"code"`
 - `min_score` (optional): Filter by minimum relevance score (0-1)
 - `max_per_file` (optional): Cap results per file for diversity
+- `file` (optional): Filter to files matching this name (e.g. "syncer.ts"). Matches filename, not full path.
+- `exclude` (optional): Exclude files under this path prefix (e.g. "tests/" or "dist/")
 
 **When to use which mode:**
 - `pointer` — navigation, finding locations, understanding architecture
@@ -57,7 +59,7 @@ File structure — signatures with bodies collapsed (~4x fewer tokens).
 - `target` (required): File path relative to project root
 
 ### trace_calls
-Call graph — who calls a symbol and what it calls. Unscoped — follows calls across all indexed directories.
+Call graph — who calls a symbol and what it calls. Callers and callees include file:line locations. Unscoped — follows calls across all indexed directories.
 - `symbol` (required): Function/method/class name
 
 ### list_symbols