grepmax 0.7.11 → 0.7.13

package/dist/commands/mcp.js

@@ -128,6 +128,10 @@ const TOOLS = [
                     type: "string",
                     description: "Search mode: 'default' (semantic only) or 'symbol' (semantic + call graph trace appended). Use 'symbol' when query is a function/class name.",
                 },
+                include_imports: {
+                    type: "boolean",
+                    description: "Prepend the file's import/require statements to each result. Deduped per file.",
+                },
             },
             required: ["query"],
         },
@@ -186,6 +190,10 @@ const TOOLS = [
                     type: "number",
                     description: "Include N lines before/after chunk. Only with detail 'code' or 'full'. Max 20.",
                 },
+                include_imports: {
+                    type: "boolean",
+                    description: "Prepend file's import statements to each result.",
+                },
             },
             required: ["query"],
         },
@@ -218,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"],
         },
@@ -457,6 +469,49 @@ exports.mcp = new commander_1.Command("mcp")
         child.unref();
         console.log(`[MCP] Started background watcher for ${projectRoot}`);
     }
+    // --- Utilities ---
+    function extractImports(filePath) {
+        try {
+            const content = fs.readFileSync(filePath, "utf-8");
+            const lines = content.split("\n");
+            const importLines = [];
+            let inMultiLine = false;
+            for (const line of lines) {
+                const trimmed = line.trim();
+                if (inMultiLine) {
+                    importLines.push(line);
+                    if (trimmed === ")" || trimmed === ");")
+                        inMultiLine = false;
+                    continue;
+                }
+                if (!trimmed ||
+                    trimmed.startsWith("//") ||
+                    trimmed.startsWith("#") ||
+                    trimmed.startsWith("*") ||
+                    trimmed.startsWith("/*")) {
+                    continue;
+                }
+                if (trimmed.startsWith("import ") ||
+                    trimmed.startsWith("from ") ||
+                    (trimmed.startsWith("const ") && trimmed.includes("require(")) ||
+                    trimmed.startsWith("require(") ||
+                    trimmed.startsWith("use ") ||
+                    trimmed.startsWith("using ") ||
+                    trimmed.startsWith("package ")) {
+                    importLines.push(line);
+                    if (trimmed.includes("(") && !trimmed.includes(")")) {
+                        inMultiLine = true;
+                    }
+                    continue;
+                }
+                break;
+            }
+            return importLines.length > 0 ? importLines.join("\n") : "";
+        }
+        catch (_a) {
+            return "";
+        }
+    }
     // --- Tool handlers ---
     function handleSemanticSearch(args_1) {
         return __awaiter(this, arguments, void 0, function* (args, searchAll = false) {
@@ -538,6 +593,8 @@ exports.mcp = new commander_1.Command("mcp")
                 const minScore = typeof args.min_score === "number" ? args.min_score : 0;
                 const maxPerFile = typeof args.max_per_file === "number" ? args.max_per_file : 0;
                 const detail = typeof args.detail === "string" ? args.detail : "pointer";
+                const includeImports = Boolean(args.include_imports);
+                const importCache = new Map();
                 let results = result.data.map((r) => {
                     var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m;
                     const absPath = (_c = (_a = r.path) !== null && _a !== void 0 ? _a : (_b = r.metadata) === null || _b === void 0 ? void 0 : _b.path) !== null && _c !== void 0 ? _c : "";
@@ -603,10 +660,19 @@ exports.mcp = new commander_1.Command("mcp")
                                         .join("\n");
                         }
                     }
-                    const text = line1 +
+                    let text = line1 +
                         (summaryStr ? `\n${summaryStr}` : "") +
                         (line2 ? `\n${line2}` : "") +
                         snippet;
+                    if (includeImports && absPath) {
+                        if (!importCache.has(absPath)) {
+                            importCache.set(absPath, extractImports(absPath));
+                        }
+                        const imports = importCache.get(absPath);
+                        if (imports) {
+                            text = `imports:\n${imports}\n\n${text}`;
+                        }
+                    }
                     return {
                         absPath,
                         text,
@@ -799,20 +865,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");
                 }

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.11",
+  "version": "0.7.13",
   "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.11",
+  "version": "0.7.13",
   "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

@@ -48,6 +48,7 @@ Parameters:
 - `language` (optional): Filter by file extension (e.g. "ts", "py", "go"). Omit the dot.
 - `role` (optional): Filter by chunk role: "ORCHESTRATION" (logic/flow), "DEFINITION" (types), or "IMPLEMENTATION"
 - `mode` (optional): `"default"` (semantic only) or `"symbol"` (semantic + call graph appended). Use "symbol" when query is a function or class name — gets search results + callers/callees in one call.
+- `include_imports` (optional): Prepend file's import/require statements to each result. Deduped per file — see dependencies at a glance.
 
 **When to use which mode:**
 - `pointer` — navigation, finding locations, understanding architecture
@@ -70,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.