grepmax 0.7.19 → 0.7.21

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/dist/commands/skeleton.js

@@ -61,6 +61,7 @@ const setup_helpers_1 = require("../lib/setup/setup-helpers");
 const retriever_1 = require("../lib/skeleton/retriever");
 const skeletonizer_1 = require("../lib/skeleton/skeletonizer");
 const vector_db_1 = require("../lib/store/vector-db");
+const file_utils_1 = require("../lib/utils/file-utils");
 const exit_1 = require("../lib/utils/exit");
 const project_root_1 = require("../lib/utils/project-root");
 /**
@@ -140,6 +141,48 @@ Examples:
             includeSummary: !options.noSummary,
         };
         // Determine mode based on target
+        const resolvedTarget = path.resolve(target);
+        // Directory mode
+        if (fs.existsSync(resolvedTarget) &&
+            fs.statSync(resolvedTarget).isDirectory()) {
+            const entries = fs.readdirSync(resolvedTarget, {
+                withFileTypes: true,
+            });
+            const files = entries
+                .filter((e) => e.isFile() &&
+                (0, file_utils_1.isIndexableFile)(path.join(resolvedTarget, e.name)))
+                .map((e) => path.join(resolvedTarget, e.name))
+                .slice(0, Number.parseInt(options.limit, 10));
+            if (files.length === 0) {
+                console.error(`No indexable files in ${target}`);
+                process.exitCode = 1;
+                return;
+            }
+            for (const filePath of files) {
+                const content = fs.readFileSync(filePath, "utf-8");
+                const result = yield skeletonizer.skeletonizeFile(filePath, content, skeletonOpts);
+                outputResult(result, options);
+            }
+            return;
+        }
+        // Batch mode (comma-separated)
+        if (target.includes(",")) {
+            const targets = target
+                .split(",")
+                .map((t) => t.trim())
+                .filter(Boolean);
+            for (const t of targets) {
+                const filePath = path.resolve(t);
+                if (!fs.existsSync(filePath)) {
+                    console.error(`Not found: ${t}`);
+                    continue;
+                }
+                const content = fs.readFileSync(filePath, "utf-8");
+                const result = yield skeletonizer.skeletonizeFile(filePath, content, skeletonOpts);
+                outputResult(result, options);
+            }
+            return;
+        }
         if (isFilePath(target)) {
             // === FILE MODE ===
             const filePath = path.resolve(target);

package/dist/commands/trace.js

@@ -19,8 +19,10 @@ const project_root_1 = require("../lib/utils/project-root");
 exports.trace = new commander_1.Command("trace")
     .description("Trace the call graph for a symbol")
     .argument("<symbol>", "The symbol to trace")
-    .action((symbol) => __awaiter(void 0, void 0, void 0, function* () {
+    .option("-d, --depth <n>", "Caller traversal depth (default 1, max 3)", "1")
+    .action((symbol, opts) => __awaiter(void 0, void 0, void 0, function* () {
     var _a;
+    const depth = Math.min(Math.max(Number.parseInt(opts.depth || "1", 10), 1), 3);
     const root = process.cwd();
     let vectorDb = null;
     try {
@@ -28,7 +30,7 @@ exports.trace = new commander_1.Command("trace")
         const paths = (0, project_root_1.ensureProjectPaths)(projectRoot);
         vectorDb = new vector_db_1.VectorDB(paths.lancedbDir);
         const graphBuilder = new graph_builder_1.GraphBuilder(vectorDb);
-        const graph = yield graphBuilder.buildGraph(symbol);
+        const graph = yield graphBuilder.buildGraphMultiHop(symbol, depth);
         console.log((0, formatter_1.formatTrace)(graph));
     }
     catch (error) {

package/dist/lib/output/formatter.js

@@ -130,24 +130,40 @@ function formatTrace(graph) {
         return style.dim("Symbol not found.");
     }
     const lines = [];
-    // 1. Callers (Upstream)
-    if (graph.callers.length > 0) {
+    // 1. Importers
+    if (graph.importers.length > 0) {
+        const filtered = graph.importers.filter((p) => p !== graph.center.file);
+        if (filtered.length > 0) {
+            lines.push(style.bold("Imported by:"));
+            for (const imp of filtered.slice(0, 10)) {
+                lines.push(`  ${style.dim(imp)}`);
+            }
+            lines.push("");
+        }
+    }
+    // 2. Callers (Upstream, recursive tree)
+    function renderCallerTree(trees, depth) {
+        for (const t of trees) {
+            const pad = "  ".repeat(depth);
+            lines.push(`${pad}${style.blue("↑")} ${style.green(t.node.symbol)} ${style.dim(`(${t.node.file}:${t.node.line})`)}`);
+            renderCallerTree(t.callers, depth + 1);
+        }
+    }
+    if (graph.callerTree.length > 0) {
         lines.push(style.bold("Callers (Who calls this?):"));
-        graph.callers.forEach((caller) => {
-            lines.push(`  ${style.blue("↑")} ${style.green(caller.symbol)} ${style.dim(`(${caller.file}:${caller.line})`)}`);
-        });
+        renderCallerTree(graph.callerTree, 1);
         lines.push("");
     }
     else {
         lines.push(style.dim("No known callers."));
         lines.push("");
     }
-    // 2. Center (The Symbol)
+    // 3. Center (The Symbol)
     lines.push(style.bold(`▶ ${graph.center.symbol}`));
     lines.push(`  ${style.dim(`Defined in ${graph.center.file}:${graph.center.line}`)}`);
     lines.push(`  ${style.dim(`Role: ${graph.center.role}`)}`);
     lines.push("");
-    // 3. Callees (Downstream)
+    // 4. Callees (Downstream)
     if (graph.callees.length > 0) {
         lines.push(style.bold("Callees (What does this call?):"));
         graph.callees.forEach((callee) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "grepmax",
-  "version": "0.7.19",
+  "version": "0.7.21",
   "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.19",
+  "version": "0.7.21",
   "description": "Semantic code search for Claude Code. Automatically indexes your project and provides intelligent search capabilities.",
   "author": {
     "name": "Robert Owens",