grepmax 0.17.3 → 0.17.4

package/dist/commands/search.js

@@ -49,6 +49,7 @@ const commander_1 = require("commander");
 const grammar_loader_1 = require("../lib/index/grammar-loader");
 const sync_helpers_1 = require("../lib/index/sync-helpers");
 const syncer_1 = require("../lib/index/syncer");
+const agent_search_formatter_1 = require("../lib/output/agent-search-formatter");
 const searcher_1 = require("../lib/search/searcher");
 const setup_helpers_1 = require("../lib/setup/setup-helpers");
 const skeleton_1 = require("../lib/skeleton");
@@ -346,9 +347,7 @@ function resultCountHeader(results, maxCount) {
         if (p)
             files.add(p);
     }
-    const showing = results.length < maxCount
-        ? `${results.length}`
-        : `top ${results.length}`;
+    const showing = results.length < maxCount ? `${results.length}` : `top ${results.length}`;
     return `Found ${results.length} match${results.length === 1 ? "" : "es"} (showing ${showing}) across ${files.size} file${files.size === 1 ? "" : "s"}`;
 }
 exports.search = new commander_1.Command("search")
@@ -368,8 +367,8 @@ exports.search = new commander_1.Command("search")
     .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("--in <subpath>", "Restrict to a sub-path of the project (repeatable; comma-separated also accepted)", (value, prev) => (prev ? [...prev, value] : [value]))
-    .option("--exclude <subpath>", "Exclude a sub-path of the project (repeatable; e.g. 'tests/')", (value, prev) => (prev ? [...prev, value] : [value]))
+    .option("--in <subpath>", "Restrict to a sub-path of the project (repeatable; comma-separated also accepted)", (value, prev) => prev ? [...prev, value] : [value])
+    .option("--exclude <subpath>", "Exclude a sub-path of the project (repeatable; e.g. 'tests/')", (value, prev) => prev ? [...prev, value] : [value])
     .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)
@@ -377,7 +376,7 @@ exports.search = new commander_1.Command("search")
     .option("--name <regex>", "Filter results by symbol name regex")
     .option("-C, --context <n>", "Include N lines before/after each result")
     .option("--agent", "Ultra-compact output for AI agents (one line per result)", false)
-    .argument("<pattern>", "Natural language query (e.g. \"where do we handle auth?\")")
+    .argument("<pattern>", 'Natural language query (e.g. "where do we handle auth?")')
     .argument("[path]", "Restrict search to this path prefix")
     .addHelpText("after", `
 Examples:
@@ -389,7 +388,7 @@ Examples:
   gmax "handler" --name "handle.*" --exclude tests/
 `)
     .action((pattern, exec_path, _options, cmd) => __awaiter(void 0, void 0, void 0, function* () {
-    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _0, _1, _2, _3, _4, _5, _6, _7, _8, _9;
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z;
     const options = cmd.optsWithGlobals();
     const root = process.cwd();
     const minScore = Number.isFinite(Number.parseFloat(options.minScore))
@@ -454,6 +453,24 @@ Examples:
                     process.exitCode = 1;
                     return; // EXIT
                 }
+                if (options.agent) {
+                    const importCache = new Map();
+                    const getImportsForFile = (absPath) => {
+                        var _a;
+                        if (!options.imports || !absPath)
+                            return "";
+                        if (!importCache.has(absPath)) {
+                            importCache.set(absPath, (0, import_extractor_1.extractImports)(absPath));
+                        }
+                        return (_a = importCache.get(absPath)) !== null && _a !== void 0 ? _a : "";
+                    };
+                    console.log((0, agent_search_formatter_1.formatAgentSearchResults)(filteredData, projectRootForServer, {
+                        includeImports: options.imports,
+                        getImportsForFile,
+                        explain: options.explain,
+                    }));
+                    return; // EXIT
+                }
                 const isTTY = process.stdout.isTTY;
                 const shouldBePlain = options.plain || !isTTY;
                 _searchResultCount = filteredData.length;
@@ -689,7 +706,7 @@ Examples:
                     return defs.some((d) => regex.test(d));
                 });
             }
-            catch (_10) {
+            catch (_0) {
                 // Invalid regex — skip
             }
         }
@@ -712,90 +729,11 @@ Examples:
                 process.exitCode = 1;
             }
             else {
-                // Pre-pass: group by absolute path in first-occurrence order so we
-                // can collapse same-file repeats under a one-line header. Score
-                // order is preserved globally for first-of-file; siblings cluster
-                // under their first hit's rank.
-                const groups = new Map();
-                for (const r of filteredData) {
-                    const absP = (_j = (_g = r.path) !== null && _g !== void 0 ? _g : (_h = r.metadata) === null || _h === void 0 ? void 0 : _h.path) !== null && _j !== void 0 ? _j : "";
-                    const arr = groups.get(absP);
-                    if (arr) {
-                        arr.push(r);
-                    }
-                    else {
-                        groups.set(absP, [r]);
-                    }
-                }
-                const seenImportFiles = new Set();
-                for (const [absP, members] of groups) {
-                    const relPath = absP.startsWith(effectiveRoot)
-                        ? absP.slice(effectiveRoot.length + 1)
-                        : absP;
-                    if (options.imports && absP && !seenImportFiles.has(absP)) {
-                        seenImportFiles.add(absP);
-                        const imports = getImportsForFile(absP);
-                        if (imports) {
-                            console.log(`[imports ${relPath}] ${imports.split("\n").join(" | ")}`);
-                        }
-                    }
-                    const grouped = members.length > 1;
-                    if (grouped) {
-                        console.log(`${relPath} (${members.length} hits):`);
-                    }
-                    for (const r of members) {
-                        const startLine = Math.max(1, ((_o = (_l = (_k = r.startLine) !== null && _k !== void 0 ? _k : r.start_line) !== null && _l !== void 0 ? _l : (_m = r.generated_metadata) === null || _m === void 0 ? void 0 : _m.start_line) !== null && _o !== void 0 ? _o : 0) + 1);
-                        const defs = Array.isArray(r.defined_symbols)
-                            ? r.defined_symbols
-                            : [];
-                        const symbol = defs[0] || "";
-                        const role = ((_p = r.role) !== null && _p !== void 0 ? _p : "")
-                            .slice(0, 4)
-                            .toUpperCase();
-                        let hint = "";
-                        if (r.summary) {
-                            hint = ` — ${r.summary}`;
-                        }
-                        else {
-                            // Extract first meaningful signature line from content
-                            const raw = (_r = (_q = r.content) !== null && _q !== void 0 ? _q : r.text) !== null && _r !== void 0 ? _r : "";
-                            const lines = raw.split("\n");
-                            for (const line of lines) {
-                                const trimmed = line.trim();
-                                // Skip empty, comments, imports, braces, and mid-line fragments
-                                if (!trimmed || trimmed.length < 5)
-                                    continue;
-                                if (trimmed.startsWith("//") || trimmed.startsWith("/*") || trimmed.startsWith("*"))
-                                    continue;
-                                if (trimmed.startsWith("import ") || trimmed.startsWith("#") || trimmed.startsWith("File:"))
-                                    continue;
-                                if (trimmed === "{" || trimmed === "}")
-                                    continue;
-                                // Skip lines that look like continuations (start with punctuation, closing braces, or spread)
-                                if (/^[.),;:}\]|&(+`'"!~]/.test(trimmed))
-                                    continue;
-                                if (trimmed.startsWith("} ") || trimmed.startsWith("- ") || trimmed.startsWith("..."))
-                                    continue;
-                                // Skip lines that look like mid-expression fragments (no keyword/declaration prefix)
-                                if (/^[a-z]/.test(trimmed) && !/^(export|function|class|interface|type|const|let|var|async|return|if|for|while|switch|enum|struct|pub |fn |def |impl |mod |use )/.test(trimmed))
-                                    continue;
-                                hint = ` — ${trimmed.length > 120 ? trimmed.slice(0, 117) + "..." : trimmed}`;
-                                break;
-                            }
-                        }
-                        const sym = symbol ? ` ${symbol}` : "";
-                        const rl = role ? ` [${role}]` : "";
-                        const score = r.score;
-                        const scoreCol = typeof score === "number" ? `\ts=${score.toFixed(3)}` : "";
-                        const explainSuffix = options.explain && r.scoreBreakdown
-                            ? `\texplain:rerank=${r.scoreBreakdown.rerank.toFixed(3)},fused=${r.scoreBreakdown.fused.toFixed(3)},boost=${r.scoreBreakdown.boost.toFixed(2)}x,score=${r.scoreBreakdown.normalized.toFixed(3)}`
-                            : "";
-                        const locator = grouped
-                            ? `  :${startLine}`
-                            : `${relPath}:${startLine}`;
-                        console.log(`${locator}${scoreCol}${sym}${rl}${hint}${explainSuffix}`);
-                    }
-                }
+                console.log((0, agent_search_formatter_1.formatAgentSearchResults)(filteredData, effectiveRoot, {
+                    includeImports: options.imports,
+                    getImportsForFile,
+                    explain: options.explain,
+                }));
             }
             // Agent trace (compact)
             if (options.symbol && filteredData.length > 0) {
@@ -826,7 +764,7 @@ Examples:
                         }
                     }
                 }
-                catch (_11) { }
+                catch (_1) { }
             }
             return;
         }
@@ -858,9 +796,9 @@ Examples:
             let shown = 0;
             console.log(resultCountHeader(filteredData, parseInt(options.m, 10)));
             for (const r of filteredData) {
-                const absP = (_u = (_s = r.path) !== null && _s !== void 0 ? _s : (_t = r.metadata) === null || _t === void 0 ? void 0 : _t.path) !== null && _u !== void 0 ? _u : "";
-                const startLine = (_y = (_w = (_v = r.startLine) !== null && _v !== void 0 ? _v : r.start_line) !== null && _w !== void 0 ? _w : (_x = r.generated_metadata) === null || _x === void 0 ? void 0 : _x.start_line) !== null && _y !== void 0 ? _y : 0;
-                const endLine = (_2 = (_0 = (_z = r.endLine) !== null && _z !== void 0 ? _z : r.end_line) !== null && _0 !== void 0 ? _0 : (_1 = r.generated_metadata) === null || _1 === void 0 ? void 0 : _1.end_line) !== null && _2 !== void 0 ? _2 : startLine;
+                const absP = (_j = (_g = r.path) !== null && _g !== void 0 ? _g : (_h = r.metadata) === null || _h === void 0 ? void 0 : _h.path) !== null && _j !== void 0 ? _j : "";
+                const startLine = (_o = (_l = (_k = r.startLine) !== null && _k !== void 0 ? _k : r.start_line) !== null && _l !== void 0 ? _l : (_m = r.generated_metadata) === null || _m === void 0 ? void 0 : _m.start_line) !== null && _o !== void 0 ? _o : 0;
+                const endLine = (_s = (_q = (_p = r.endLine) !== null && _p !== void 0 ? _p : r.end_line) !== null && _q !== void 0 ? _q : (_r = r.generated_metadata) === null || _r === void 0 ? void 0 : _r.end_line) !== null && _s !== void 0 ? _s : startLine;
                 const relPath = absP.startsWith(projectRoot)
                     ? absP.slice(projectRoot.length + 1)
                     : absP;
@@ -893,7 +831,7 @@ Examples:
                     tokensUsed += blobTokens;
                     shown++;
                 }
-                catch (_12) {
+                catch (_2) {
                     console.log(`\n--- ${relPath} (file not readable) ---`);
                     shown++;
                 }
@@ -910,7 +848,7 @@ Examples:
         if (options.imports) {
             const seenFiles = new Set();
             for (const r of filteredData) {
-                const absP = (_5 = (_3 = r.path) !== null && _3 !== void 0 ? _3 : (_4 = r.metadata) === null || _4 === void 0 ? void 0 : _4.path) !== null && _5 !== void 0 ? _5 : "";
+                const absP = (_v = (_t = r.path) !== null && _t !== void 0 ? _t : (_u = r.metadata) === null || _u === void 0 ? void 0 : _u.path) !== null && _v !== void 0 ? _v : "";
                 if (absP && !seenFiles.has(absP)) {
                     seenFiles.add(absP);
                     const imports = getImportsForFile(absP);
@@ -937,7 +875,7 @@ Examples:
                 for (const r of filteredData) {
                     const b = r.scoreBreakdown;
                     if (b) {
-                        const absP = (_8 = (_6 = r.path) !== null && _6 !== void 0 ? _6 : (_7 = r.metadata) === null || _7 === void 0 ? void 0 : _7.path) !== null && _8 !== void 0 ? _8 : "";
+                        const absP = (_y = (_w = r.path) !== null && _w !== void 0 ? _w : (_x = r.metadata) === null || _x === void 0 ? void 0 : _x.path) !== null && _y !== void 0 ? _y : "";
                         const relPath = absP.startsWith(projectRoot)
                             ? absP.slice(projectRoot.length + 1)
                             : absP;
@@ -999,7 +937,7 @@ Examples:
                     console.log(lines.join("\n"));
                 }
             }
-            catch (_13) {
+            catch (_3) {
                 // Trace failed — skip silently
             }
         }
@@ -1019,13 +957,13 @@ Examples:
                 source: "cli",
                 tool: "search",
                 query: pattern,
-                project: (_9 = (0, project_root_1.findProjectRoot)(root)) !== null && _9 !== void 0 ? _9 : root,
+                project: (_z = (0, project_root_1.findProjectRoot)(root)) !== null && _z !== void 0 ? _z : root,
                 results: _searchResultCount,
                 ms: Date.now() - _searchStartMs,
                 error: _searchError,
             });
         }
-        catch (_14) { }
+        catch (_4) { }
         if (vectorDb) {
             try {
                 yield vectorDb.close();

package/dist/lib/output/agent-search-formatter.js

@@ -0,0 +1,163 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatAgentSearchResults = formatAgentSearchResults;
+const path = __importStar(require("node:path"));
+function chunkPath(chunk) {
+    const metadata = chunk.metadata;
+    return String(chunk.path || (metadata === null || metadata === void 0 ? void 0 : metadata.path) || "");
+}
+function chunkStartLine(chunk) {
+    var _a, _b, _c, _d;
+    return Math.max(1, Number((_d = (_b = (_a = chunk.startLine) !== null && _a !== void 0 ? _a : chunk.start_line) !== null && _b !== void 0 ? _b : (_c = chunk.generated_metadata) === null || _c === void 0 ? void 0 : _c.start_line) !== null && _d !== void 0 ? _d : 0) + 1);
+}
+function definedSymbols(chunk) {
+    var _a;
+    const raw = (_a = chunk.defined_symbols) !== null && _a !== void 0 ? _a : chunk.definedSymbols;
+    if (Array.isArray(raw))
+        return raw.filter((v) => typeof v === "string");
+    if (raw && typeof raw.toArray === "function") {
+        try {
+            const arr = raw.toArray();
+            if (Array.isArray(arr)) {
+                return arr.filter((v) => typeof v === "string");
+            }
+        }
+        catch (_b) { }
+    }
+    return [];
+}
+function relativePath(projectRoot, absPath) {
+    if (!absPath)
+        return "";
+    return path.isAbsolute(absPath)
+        ? path.relative(projectRoot, absPath)
+        : absPath;
+}
+function firstSignatureLine(chunk) {
+    var _a, _b;
+    const raw = (_b = (_a = chunk.content) !== null && _a !== void 0 ? _a : chunk.text) !== null && _b !== void 0 ? _b : "";
+    const lines = String(raw).split("\n");
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.length < 5)
+            continue;
+        if (trimmed.startsWith("//") ||
+            trimmed.startsWith("/*") ||
+            trimmed.startsWith("*")) {
+            continue;
+        }
+        if (trimmed.startsWith("import ") ||
+            trimmed.startsWith("#") ||
+            trimmed.startsWith("File:")) {
+            continue;
+        }
+        if (trimmed === "{" || trimmed === "}")
+            continue;
+        if (/^[.),;:}\]|&(+`'"!~]/.test(trimmed))
+            continue;
+        if (trimmed.startsWith("} ") ||
+            trimmed.startsWith("- ") ||
+            trimmed.startsWith("...")) {
+            continue;
+        }
+        if (/^[a-z]/.test(trimmed) &&
+            !/^(export|function|class|interface|type|const|let|var|async|return|if|for|while|switch|enum|struct|pub |fn |def |impl |mod |use )/.test(trimmed)) {
+            continue;
+        }
+        return trimmed.length > 120 ? `${trimmed.slice(0, 117)}...` : trimmed;
+    }
+    return "";
+}
+function hintFor(chunk) {
+    if (typeof chunk.summary === "string" && chunk.summary) {
+        return chunk.summary;
+    }
+    return firstSignatureLine(chunk);
+}
+function explainSuffix(chunk, enabled) {
+    if (!enabled || !chunk.scoreBreakdown)
+        return "";
+    const b = chunk.scoreBreakdown;
+    return `\texplain:rerank=${b.rerank.toFixed(3)},fused=${b.fused.toFixed(3)},boost=${b.boost.toFixed(2)}x,score=${b.normalized.toFixed(3)}`;
+}
+function formatAgentSearchResults(results, projectRoot, options = {}) {
+    var _a, _b;
+    if (!results.length)
+        return "(none)";
+    const groups = new Map();
+    for (const result of results) {
+        const absPath = chunkPath(result);
+        const group = groups.get(absPath);
+        if (group)
+            group.push(result);
+        else
+            groups.set(absPath, [result]);
+    }
+    const lines = [];
+    const seenImportFiles = new Set();
+    for (const [absPath, members] of groups) {
+        const rel = relativePath(projectRoot, absPath);
+        if (options.includeImports &&
+            absPath &&
+            options.getImportsForFile &&
+            !seenImportFiles.has(absPath)) {
+            seenImportFiles.add(absPath);
+            const imports = options.getImportsForFile(absPath);
+            if (imports) {
+                lines.push(`[imports ${rel}] ${imports.split("\n").join(" | ")}`);
+            }
+        }
+        const grouped = members.length > 1;
+        if (grouped) {
+            lines.push(`${rel} (${members.length} hits):`);
+        }
+        for (const result of members) {
+            const symbol = (_a = definedSymbols(result)[0]) !== null && _a !== void 0 ? _a : "";
+            const role = String((_b = result.role) !== null && _b !== void 0 ? _b : "")
+                .slice(0, 4)
+                .toUpperCase();
+            const score = typeof result.score === "number"
+                ? `\ts=${result.score.toFixed(3)}`
+                : "";
+            const hint = hintFor(result);
+            const locator = grouped
+                ? `  :${chunkStartLine(result)}`
+                : `${rel}:${chunkStartLine(result)}`;
+            lines.push(`${locator}${score}${symbol ? ` ${symbol}` : ""}${role ? ` [${role}]` : ""}${hint ? ` — ${hint}` : ""}${explainSuffix(result, options.explain)}`);
+        }
+    }
+    return lines.join("\n");
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "grepmax",
-  "version": "0.17.3",
+  "version": "0.17.4",
   "author": "Robert Owens <78518764+reowens@users.noreply.github.com>",
   "homepage": "https://github.com/reowens/grepmax",
   "bugs": {

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

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