grepmax 0.7.18 → 0.7.20

package/dist/commands/mcp.js

@@ -140,6 +140,10 @@ const TOOLS = [
                     type: "boolean",
                     description: "Prepend the file's import/require statements to each result. Deduped per file.",
                 },
+                name_pattern: {
+                    type: "string",
+                    description: "Regex to filter by symbol name (e.g. 'handle.*Auth'). Case-insensitive. Applied after search.",
+                },
             },
             required: ["query"],
         },
@@ -202,6 +206,10 @@ const TOOLS = [
                     type: "boolean",
                     description: "Prepend file's import statements to each result.",
                 },
+                name_pattern: {
+                    type: "string",
+                    description: "Regex to filter by symbol name (e.g. 'handle.*Auth').",
+                },
             },
             required: ["query"],
         },
@@ -724,6 +732,7 @@ exports.mcp = new commander_1.Command("mcp")
                         absPath,
                         text,
                         score: typeof r.score === "number" ? r.score : 0,
+                        symbols: defs,
                     };
                 });
                 if (minScore > 0) {
@@ -739,6 +748,18 @@ exports.mcp = new commander_1.Command("mcp")
                         return true;
                     });
                 }
+                const namePattern = typeof args.name_pattern === "string"
+                    ? args.name_pattern
+                    : "";
+                if (namePattern) {
+                    try {
+                        const regex = new RegExp(namePattern, "i");
+                        results = results.filter((r) => r.symbols.some((s) => regex.test(s)));
+                    }
+                    catch (_b) {
+                        // Invalid regex — skip filter
+                    }
+                }
                 let output = results.map((r) => r.text).join("\n\n");
                 // Symbol mode: append call graph
                 const mode = typeof args.mode === "string" ? args.mode : "default";
@@ -779,7 +800,7 @@ exports.mcp = new commander_1.Command("mcp")
                             output += `\n${traceLines.join("\n")}`;
                         }
                     }
-                    catch (_b) {
+                    catch (_c) {
                         // Trace failed — return search results without trace
                     }
                 }

package/dist/commands/search.js

@@ -336,17 +336,28 @@ exports.search = new commander_1.Command("search")
     .option("-s, --sync", "Syncs the local files to the store before searching", false)
     .option("-d, --dry-run", "Show what would be indexed without actually indexing", false)
     .option("--skeleton", "Show code skeleton for matching files instead of snippets", false)
+    .option("--root <dir>", "Search a different project directory")
+    .option("--file <name>", "Filter to files matching this name (e.g. 'syncer.ts')")
+    .option("--exclude <prefix>", "Exclude files under this path prefix (e.g. 'tests/')")
+    .option("--lang <ext>", "Filter by file extension (e.g. 'ts', 'py')")
+    .option("--role <role>", "Filter by role: ORCHESTRATION, DEFINITION, IMPLEMENTATION")
+    .option("--symbol", "Append call graph after search results", false)
+    .option("--imports", "Prepend file imports to each result", false)
+    .option("--name <regex>", "Filter results by symbol name regex")
+    .option("-C, --context <n>", "Include N lines before/after each result")
     .argument("<pattern>", "Natural language query (e.g. \"where do we handle auth?\")")
     .argument("[path]", "Restrict search to this path prefix")
     .addHelpText("after", `
 Examples:
   gmax "where do we handle authentication?"
-  gmax "database connection pooling" -m 10
-  gmax "error handling" --compact --min-score 0.5
-  gmax "validation logic" --skeleton
+  gmax "auth handler" --role ORCHESTRATION --lang ts --plain
+  gmax "database" --file syncer.ts --plain
+  gmax "VectorDB" --symbol --plain
+  gmax "error handling" -C 5 --imports --plain
+  gmax "handler" --name "handle.*" --exclude tests/
 `)
     .action((pattern, exec_path, _options, cmd) => __awaiter(void 0, void 0, void 0, function* () {
-    var _a, _b, _c;
+    var _a, _b, _c, _d;
     const options = cmd.optsWithGlobals();
     const root = process.cwd();
     const minScore = Number.isFinite(Number.parseFloat(options.minScore))
@@ -487,20 +498,48 @@ Examples:
             }
         }
         const searcher = new searcher_1.Searcher(vectorDb);
-        // Use absolute path prefix for filtering
+        // Use --root or fall back to project root
+        const effectiveRoot = options.root
+            ? (_c = (0, project_root_1.findProjectRoot)(path.resolve(options.root))) !== null && _c !== void 0 ? _c : path.resolve(options.root)
+            : projectRoot;
         const searchPathPrefix = exec_path
             ? path.resolve(exec_path)
-            : projectRoot;
+            : effectiveRoot;
         const pathFilter = searchPathPrefix.endsWith("/")
             ? searchPathPrefix
             : `${searchPathPrefix}/`;
-        const searchResult = yield searcher.search(pattern, parseInt(options.m, 10), { rerank: true }, undefined, pathFilter);
-        if ((_c = searchResult.warnings) === null || _c === void 0 ? void 0 : _c.length) {
+        // Build filters from CLI options
+        const searchFilters = {};
+        if (options.file)
+            searchFilters.file = options.file;
+        if (options.exclude)
+            searchFilters.exclude = options.exclude;
+        if (options.lang)
+            searchFilters.language = options.lang;
+        if (options.role)
+            searchFilters.role = options.role;
+        const searchResult = yield searcher.search(pattern, parseInt(options.m, 10), { rerank: true }, Object.keys(searchFilters).length > 0 ? searchFilters : undefined, pathFilter);
+        if ((_d = searchResult.warnings) === null || _d === void 0 ? void 0 : _d.length) {
             for (const w of searchResult.warnings) {
                 console.warn(`Warning: ${w}`);
             }
         }
-        const filteredData = searchResult.data.filter((r) => typeof r.score !== "number" || r.score >= minScore);
+        let filteredData = searchResult.data.filter((r) => typeof r.score !== "number" || r.score >= minScore);
+        // Post-filter by symbol name regex
+        if (options.name) {
+            try {
+                const regex = new RegExp(options.name, "i");
+                filteredData = filteredData.filter((r) => {
+                    const defs = Array.isArray(r.defined_symbols)
+                        ? r.defined_symbols
+                        : [];
+                    return defs.some((d) => regex.test(d));
+                });
+            }
+            catch (_e) {
+                // Invalid regex — skip
+            }
+        }
         if (options.skeleton) {
             yield outputSkeletons(filteredData, projectRoot, parseInt(options.m, 10), vectorDb);
             return;
@@ -543,6 +582,49 @@ Examples:
             });
             console.log(output);
         }
+        // Symbol mode: append call graph
+        if (options.symbol && vectorDb) {
+            try {
+                const { GraphBuilder } = yield Promise.resolve().then(() => __importStar(require("../lib/graph/graph-builder")));
+                const builder = new GraphBuilder(vectorDb);
+                const graph = yield builder.buildGraphMultiHop(pattern, 1);
+                if (graph.center) {
+                    const lines = ["\n--- Call graph ---"];
+                    const centerRel = path.relative(effectiveRoot, graph.center.file);
+                    lines.push(`${graph.center.symbol} [${graph.center.role}] ${centerRel}:${graph.center.line + 1}`);
+                    if (graph.importers.length > 0) {
+                        const filtered = graph.importers.filter((p) => p !== graph.center.file);
+                        if (filtered.length > 0) {
+                            lines.push("Imported by:");
+                            for (const imp of filtered.slice(0, 10)) {
+                                lines.push(`  ${path.relative(effectiveRoot, imp)}`);
+                            }
+                        }
+                    }
+                    if (graph.callerTree.length > 0) {
+                        lines.push("Callers:");
+                        for (const t of graph.callerTree) {
+                            lines.push(`  <- ${t.node.symbol} ${path.relative(effectiveRoot, t.node.file)}:${t.node.line + 1}`);
+                        }
+                    }
+                    if (graph.callees.length > 0) {
+                        lines.push("Calls:");
+                        for (const c of graph.callees.slice(0, 15)) {
+                            if (c.file) {
+                                lines.push(`  -> ${c.symbol} ${path.relative(effectiveRoot, c.file)}:${c.line + 1}`);
+                            }
+                            else {
+                                lines.push(`  -> ${c.symbol} (not indexed)`);
+                            }
+                        }
+                    }
+                    console.log(lines.join("\n"));
+                }
+            }
+            catch (_f) {
+                // Trace failed — skip silently
+            }
+        }
     }
     catch (error) {
         const message = error instanceof Error ? error.message : "Unknown error";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "grepmax",
-  "version": "0.7.18",
+  "version": "0.7.20",
   "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.18",
+  "version": "0.7.20",
   "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

@@ -49,6 +49,7 @@ Parameters:
 - `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.
+- `name_pattern` (optional): Regex to filter by symbol name (e.g. "handle.*Auth"). Case-insensitive. Applied after search.
 
 **When to use which mode:**
 - `pointer` — navigation, finding locations, understanding architecture
@@ -108,11 +109,13 @@ Generate LLM summaries for indexed code in a directory. Summaries are stored and
 
 ## Workflow
 
-1. **Search** — `semantic_search` to find relevant code (pointers by default)
-2. **Read** — `Read file:line` for the specific ranges you need
-3. **Compare** — `semantic_search` with `detail: "code"` when comparing implementations
-4. **Trace** — `trace_calls` to understand call flow across files
-5. **Skeleton** — `code_skeleton` before reading large files
+1. **Explore** — `summarize_project` for high-level overview of a new codebase
+2. **Search** — `semantic_search` to find relevant code (pointers by default). Use `mode: "symbol"` for function/class names.
+3. **Read** — `Read file:line` for the specific ranges you need
+4. **Skeleton** — `code_skeleton` before reading large files or directories
+5. **Trace** — `trace_calls` to understand call flow, imports, and callers (use `depth: 2` for full chains)
+6. **Context** — `related_files` to see what else you need to look at when editing
+7. **Changes** — `recent_changes` after pulls to see what's been modified
 
 ## If results seem stale