grepmax 0.7.12 → 0.7.14

package/dist/commands/mcp.js

@@ -226,6 +226,10 @@ const TOOLS = [
                     type: "string",
                     description: "The function, method, or class name to trace (e.g. 'handleAuth')",
                 },
+                depth: {
+                    type: "number",
+                    description: "Traversal depth for callers (default 1, max 3). depth: 2 shows callers-of-callers.",
+                },
             },
             required: ["symbol"],
         },
@@ -289,6 +293,24 @@ const TOOLS = [
             },
         },
     },
+    {
+        name: "related_files",
+        description: "Find files related to a given file by shared symbol references. Shows dependencies (what this file calls) and dependents (what calls this file).",
+        inputSchema: {
+            type: "object",
+            properties: {
+                file: {
+                    type: "string",
+                    description: "File path relative to project root (e.g. 'src/lib/index/syncer.ts')",
+                },
+                limit: {
+                    type: "number",
+                    description: "Max related files per direction (default 10)",
+                },
+            },
+            required: ["file"],
+        },
+    },
 ];
 // ---------------------------------------------------------------------------
 // Helpers
@@ -861,20 +883,29 @@ exports.mcp = new commander_1.Command("mcp")
             try {
                 const db = getVectorDb();
                 const builder = new graph_builder_1.GraphBuilder(db);
-                const graph = yield builder.buildGraph(symbol);
+                const depth = Math.min(Math.max(Number(args.depth) || 1, 1), 3);
+                const graph = yield builder.buildGraphMultiHop(symbol, depth);
                 if (!graph.center) {
                     return ok(`Symbol '${symbol}' not found in the index.`);
                 }
                 const lines = [];
                 // Center
                 lines.push(`${graph.center.symbol} [${graph.center.role}] ${graph.center.file}:${graph.center.line + 1}`);
-                // Callers
-                if (graph.callers.length > 0) {
-                    lines.push("Callers:");
-                    for (const caller of graph.callers) {
-                        lines.push(`  <- ${caller.symbol} ${caller.file}:${caller.line + 1}`);
+                // Callers (recursive tree)
+                function formatCallerTree(trees, indent) {
+                    for (const t of trees) {
+                        const rel = t.node.file.startsWith(projectRoot)
+                            ? t.node.file.slice(projectRoot.length + 1)
+                            : t.node.file;
+                        const pad = "  ".repeat(indent);
+                        lines.push(`${pad}<- ${t.node.symbol} ${rel}:${t.node.line + 1}`);
+                        formatCallerTree(t.callers, indent + 1);
                     }
                 }
+                if (graph.callerTree.length > 0) {
+                    lines.push("Callers:");
+                    formatCallerTree(graph.callerTree, 1);
+                }
                 else {
                     lines.push("Callers: none");
                 }
@@ -1197,6 +1228,107 @@ exports.mcp = new commander_1.Command("mcp")
             }
         });
     }
+    function handleRelatedFiles(args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const file = String(args.file || "");
+            if (!file)
+                return err("Missing required parameter: file");
+            const limit = Math.min(Math.max(Number(args.limit) || 10, 1), 25);
+            const absPath = path.resolve(projectRoot, file);
+            try {
+                const db = getVectorDb();
+                const table = yield db.ensureTable();
+                const fileChunks = yield table
+                    .query()
+                    .select(["defined_symbols", "referenced_symbols"])
+                    .where(`path = '${(0, filter_builder_1.escapeSqlString)(absPath)}'`)
+                    .toArray();
+                if (fileChunks.length === 0) {
+                    return ok(`File not found in index: ${file}`);
+                }
+                const definedHere = new Set();
+                const referencedHere = new Set();
+                for (const chunk of fileChunks) {
+                    for (const s of toStringArray(chunk.defined_symbols))
+                        definedHere.add(s);
+                    for (const s of toStringArray(chunk.referenced_symbols))
+                        referencedHere.add(s);
+                }
+                // Dependencies: files that DEFINE symbols this file REFERENCES
+                const depCounts = new Map();
+                for (const sym of referencedHere) {
+                    if (definedHere.has(sym))
+                        continue;
+                    const rows = yield table
+                        .query()
+                        .select(["path"])
+                        .where(`array_contains(defined_symbols, '${(0, filter_builder_1.escapeSqlString)(sym)}')`)
+                        .limit(3)
+                        .toArray();
+                    for (const row of rows) {
+                        const p = String(row.path || "");
+                        if (p === absPath)
+                            continue;
+                        depCounts.set(p, (depCounts.get(p) || 0) + 1);
+                    }
+                }
+                // Dependents: files that REFERENCE symbols this file DEFINES
+                const revCounts = new Map();
+                for (const sym of definedHere) {
+                    const rows = yield table
+                        .query()
+                        .select(["path"])
+                        .where(`array_contains(referenced_symbols, '${(0, filter_builder_1.escapeSqlString)(sym)}')`)
+                        .limit(20)
+                        .toArray();
+                    for (const row of rows) {
+                        const p = String(row.path || "");
+                        if (p === absPath)
+                            continue;
+                        revCounts.set(p, (revCounts.get(p) || 0) + 1);
+                    }
+                }
+                const lines = [];
+                lines.push(`Related files for ${file}:\n`);
+                const topDeps = Array.from(depCounts.entries())
+                    .sort((a, b) => b[1] - a[1])
+                    .slice(0, limit);
+                if (topDeps.length > 0) {
+                    lines.push("Dependencies (files this imports/calls):");
+                    for (const [p, count] of topDeps) {
+                        const rel = p.startsWith(`${projectRoot}/`)
+                            ? p.slice(projectRoot.length + 1)
+                            : p;
+                        lines.push(`  ${rel.padEnd(40)} (${count} shared symbol${count > 1 ? "s" : ""})`);
+                    }
+                }
+                else {
+                    lines.push("Dependencies: none found");
+                }
+                lines.push("");
+                const topRevs = Array.from(revCounts.entries())
+                    .sort((a, b) => b[1] - a[1])
+                    .slice(0, limit);
+                if (topRevs.length > 0) {
+                    lines.push("Dependents (files that call this):");
+                    for (const [p, count] of topRevs) {
+                        const rel = p.startsWith(`${projectRoot}/`)
+                            ? p.slice(projectRoot.length + 1)
+                            : p;
+                        lines.push(`  ${rel.padEnd(40)} (${count} shared symbol${count > 1 ? "s" : ""})`);
+                    }
+                }
+                else {
+                    lines.push("Dependents: none found");
+                }
+                return ok(lines.join("\n"));
+            }
+            catch (e) {
+                const msg = e instanceof Error ? e.message : String(e);
+                return err(`Related files failed: ${msg}`);
+            }
+        });
+    }
     // --- MCP server setup ---
     const transport = new stdio_js_1.StdioServerTransport();
     const server = new index_js_1.Server({
@@ -1232,6 +1364,8 @@ exports.mcp = new commander_1.Command("mcp")
                 return handleSummarizeDirectory(toolArgs);
             case "summarize_project":
                 return handleSummarizeProject(toolArgs);
+            case "related_files":
+                return handleRelatedFiles(toolArgs);
             default:
                 return err(`Unknown tool: ${name}`);
         }

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

@@ -105,6 +105,40 @@ class GraphBuilder {
             return { center, callers, callees: calleeNodes };
         });
     }
+    buildGraphMultiHop(symbol, depth) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const graph = yield this.buildGraph(symbol);
+            if (depth <= 1 || !graph.center) {
+                return {
+                    center: graph.center,
+                    callerTree: graph.callers.map((c) => ({ node: c, callers: [] })),
+                    callees: graph.callees,
+                };
+            }
+            const visited = new Set([symbol]);
+            const callerTree = yield this.expandCallers(graph.callers, depth - 1, visited);
+            return { center: graph.center, callerTree, callees: graph.callees };
+        });
+    }
+    expandCallers(callers, remainingDepth, visited) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const trees = [];
+            for (const caller of callers) {
+                if (visited.has(caller.symbol)) {
+                    trees.push({ node: caller, callers: [] });
+                    continue;
+                }
+                visited.add(caller.symbol);
+                let subCallers = [];
+                if (remainingDepth > 0) {
+                    const upstreamCallers = yield this.getCallers(caller.symbol);
+                    subCallers = yield this.expandCallers(upstreamCallers, remainingDepth - 1, visited);
+                }
+                trees.push({ node: caller, callers: subCallers });
+            }
+            return trees;
+        });
+    }
     mapRowToNode(row, targetSymbol, type) {
         // Helper to convert Arrow Vector to array if needed
         const toArray = (val) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "grepmax",
-  "version": "0.7.12",
+  "version": "0.7.14",
   "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.12",
+  "version": "0.7.14",
   "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

@@ -1,7 +1,7 @@
 ---
 name: grepmax
 description: Semantic code search. Use alongside grep - grep for exact strings, gmax for concepts.
-allowed-tools: "mcp__grepmax__semantic_search, mcp__grepmax__search_all, mcp__grepmax__code_skeleton, mcp__grepmax__trace_calls, mcp__grepmax__list_symbols, mcp__grepmax__index_status, mcp__grepmax__summarize_directory, mcp__grepmax__summarize_project, Bash(gmax:*), Read"
+allowed-tools: "mcp__grepmax__semantic_search, mcp__grepmax__search_all, mcp__grepmax__code_skeleton, mcp__grepmax__trace_calls, mcp__grepmax__list_symbols, mcp__grepmax__index_status, mcp__grepmax__summarize_directory, mcp__grepmax__summarize_project, mcp__grepmax__related_files, Bash(gmax:*), Read"
 ---
 
 ## What gmax does
@@ -71,6 +71,7 @@ File or directory structure — signatures with bodies collapsed (~4x fewer toke
 ### trace_calls
 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
+- `depth` (optional): Traversal depth for callers (default 1, max 3). depth: 2 shows callers-of-callers with indentation.
 
 ### list_symbols
 List indexed symbols with definition locations, role, and export status.
@@ -84,6 +85,11 @@ Output: `symbolName [ORCH] exported  src/path/file.ts:42`
 High-level project overview — languages, directory structure, role distribution, key symbols, entry points. Use when first exploring a new codebase.
 - `root` (optional): Project root path. Defaults to current project.
 
+### related_files
+Find files related to a given file by shared symbol references. Shows dependencies (what this file calls) and dependents (what calls this file).
+- `file` (required): File path relative to project root
+- `limit` (optional): Max results per direction (default 10)
+
 ### index_status
 Check centralized index health — chunks, files, indexed directories, model info, watcher status.