grepmax 0.18.0 → 0.18.1

package/dist/commands/search.js

@@ -63,7 +63,7 @@ exports.search = new commander_1.Command("search")
     .option("--explain", "Show scoring breakdown per result", false)
     .option("--context-for-llm", "Return full function body + imports per result", false)
     .option("--budget <tokens>", "Max tokens for --context-for-llm output (default 8000)", "8000")
-    .option("--min-score <score>", "Minimum relevance score (0-1) to include in results", "0")
+    .option("--min-score <score>", "Minimum relevance score to include. Scores are per-query-normalized (top hit = 1.0), so this is relative to the best match in THIS query, not an absolute confidence threshold.", "0")
     .option("--compact", "Compact hits view (paths + line ranges + role/preview)", false)
     .option("--plain", "Disable ANSI colors and use simpler formatting", false)
     .option("-s, --sync", "Syncs the local files to the store before searching", false)

package/dist/commands/trace.js

@@ -56,16 +56,50 @@ const project_root_1 = require("../lib/utils/project-root");
 const useColors = process.stdout.isTTY && !process.env.NO_COLOR;
 const dim = (s) => (useColors ? `\x1b[2m${s}\x1b[22m` : s);
 const bold = (s) => (useColors ? `\x1b[1m${s}\x1b[22m` : s);
-function formatTraceAgent(graph, projectRoot) {
+function formatTraceAgent(graph, projectRoot, raw = false) {
     if (!graph.center)
         return "(not found)";
+    const center = graph.center;
     const rel = (p) => p.startsWith(projectRoot) ? p.slice(projectRoot.length + 1) : p;
     const lines = [];
-    lines.push(`${graph.center.symbol}\t${rel(graph.center.file)}:${graph.center.line}\t${graph.center.role}`);
+    lines.push(`${center.symbol}\t${rel(center.file)}:${center.line}\t${center.role}`);
+    // A "self edge" is the traced symbol referencing itself (recursion) or its own
+    // definition chunk surfacing as a caller — noise in nearly every trace. Hidden
+    // by default; --raw brings them back.
+    const isSelfEdge = (n) => n.symbol === center.symbol ||
+        (n.file === center.file && n.line === center.line);
     function walkCallers(tree, depth) {
+        if (raw) {
+            for (const t of tree) {
+                lines.push(`${"  ".repeat(depth)}<- ${t.node.symbol}\t${rel(t.node.file)}:${t.node.line}`);
+                walkCallers(t.callers, depth + 1);
+            }
+            return;
+        }
+        // Collapse repeated callers: the common flood is ONE caller symbol matched at
+        // many call-sites (e.g. `mcp` ×9). Group by (symbol, file), merge their lines
+        // onto a single row, and recurse into the union of their sub-callers.
+        const groups = new Map();
+        const order = [];
         for (const t of tree) {
-            lines.push(`${"  ".repeat(depth)}<- ${t.node.symbol}\t${rel(t.node.file)}:${t.node.line}`);
-            walkCallers(t.callers, depth + 1);
+            if (isSelfEdge(t.node))
+                continue;
+            const key = `${t.node.symbol}\t${t.node.file}`;
+            let g = groups.get(key);
+            if (!g) {
+                g = { symbol: t.node.symbol, file: t.node.file, lineSet: new Set(), sub: [] };
+                groups.set(key, g);
+                order.push(key);
+            }
+            g.lineSet.add(t.node.line);
+            g.sub.push(...t.callers);
+        }
+        for (const key of order) {
+            const g = groups.get(key);
+            const locs = [...g.lineSet].sort((a, b) => a - b).join(",");
+            const loc = g.file ? `${rel(g.file)}:${locs}` : "(not indexed)";
+            lines.push(`${"  ".repeat(depth)}<- ${g.symbol}\t${loc}`);
+            walkCallers(g.sub, depth + 1);
         }
     }
     walkCallers(graph.callerTree, 0);
@@ -174,6 +208,7 @@ exports.trace = new commander_1.Command("trace")
     .option("--inbound", "Show only callers, with call-site snippets", false)
     .option("--no-snippets", "Suppress call-site snippets in --inbound output")
     .option("--limit <n>", "Max callers shown per node in --inbound (default 10)", "10")
+    .option("--raw", "In --agent mode, list every call-site without collapsing repeated callers or hiding self-edges", false)
     .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);
@@ -214,7 +249,7 @@ exports.trace = new commander_1.Command("trace")
             }
         }
         else if (opts.agent) {
-            console.log(formatTraceAgent(graph, projectRoot));
+            console.log(formatTraceAgent(graph, projectRoot, opts.raw));
             if (!graph.center)
                 process.exitCode = 1;
         }

package/dist/lib/help/agent-cheatsheet.js

@@ -37,7 +37,7 @@ Survey:
 
 Scope flags: --root <name|path>, --in <subpath>, --exclude <subpath>.
 Roles in results: [DEFI] [ORCH] [IMPL] [DOCS].
-Notation: s=/d= score/distance (higher s / lower d = better) · C:n complexity ·
+Notation: s=/d= score/distance (higher s / lower d = better; s is per-query-normalized — top hit ≈1.0, relative to this query, not absolute confidence) · C:n complexity ·
   <- caller / -> callee · dep:/rev: outbound/inbound file deps (count = shared symbols) ·
   test hops: direct = calls it, N-hop = N calls away, via-import = imports but call unseen ·
   test via=X,Y: caller symbols inside the test file (often helpers, not the tests) ·

package/package.json

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