grepmax 0.16.2 → 0.16.4

package/dist/lib/utils/tests-footer.js

@@ -0,0 +1,78 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchTestsForFooter = fetchTestsForFooter;
+exports.renderTestsFooterAgent = renderTestsFooterAgent;
+exports.renderTestsFooterHuman = renderTestsFooterHuman;
+const impact_1 = require("../graph/impact");
+const FOOTER_TIMEOUT_MS = 1500;
+const MAX_SHOWN = 5;
+const useColors = process.stdout.isTTY && !process.env.NO_COLOR;
+const dim = (s) => (useColors ? `\x1b[2m${s}\x1b[22m` : s);
+function withTimeout(p, ms) {
+    return __awaiter(this, void 0, void 0, function* () {
+        let timer;
+        const timeout = new Promise((resolve) => {
+            timer = setTimeout(() => resolve(null), ms);
+        });
+        try {
+            return yield Promise.race([p, timeout]);
+        }
+        finally {
+            if (timer)
+                clearTimeout(timer);
+        }
+    });
+}
+function fetchTestsForFooter(symbol, vectorDb, pathPrefix, excludePrefixes) {
+    return __awaiter(this, void 0, void 0, function* () {
+        return withTimeout((0, impact_1.findTests)([symbol], vectorDb, pathPrefix, 1, excludePrefixes), FOOTER_TIMEOUT_MS);
+    });
+}
+function relPath(p, projectRoot) {
+    return p.startsWith(`${projectRoot}/`) ? p.slice(projectRoot.length + 1) : p;
+}
+function hopLabelAgent(hops) {
+    if (hops === -1)
+        return "via-import";
+    if (hops === 0)
+        return "direct";
+    return `${hops}-hop`;
+}
+function hopLabelHuman(hops) {
+    if (hops === -1)
+        return "via import";
+    if (hops === 0)
+        return "direct";
+    return `${hops} hop${hops > 1 ? "s" : ""}`;
+}
+function renderTestsFooterAgent(tests, projectRoot) {
+    const lines = [];
+    for (const t of tests.slice(0, MAX_SHOWN)) {
+        lines.push(`t: ${relPath(t.file, projectRoot)}:${t.line + 1}\t${t.symbol}\t${hopLabelAgent(t.hops)}`);
+    }
+    if (tests.length > MAX_SHOWN) {
+        lines.push(`t: ... ${tests.length - MAX_SHOWN} more`);
+    }
+    return lines;
+}
+function renderTestsFooterHuman(tests, projectRoot) {
+    const lines = [];
+    lines.push("");
+    lines.push(`tests (${tests.length}):`);
+    for (const t of tests.slice(0, MAX_SHOWN)) {
+        lines.push(`  ${t.symbol.padEnd(25)} ${dim(`${relPath(t.file, projectRoot)}:${t.line + 1}`)} ${dim(`(${hopLabelHuman(t.hops)})`)}`);
+    }
+    if (tests.length > MAX_SHOWN) {
+        lines.push(dim(`  ... and ${tests.length - MAX_SHOWN} more`));
+    }
+    return lines;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "grepmax",
-  "version": "0.16.2",
+  "version": "0.16.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.16.2",
+  "version": "0.16.4",
   "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

@@ -53,7 +53,7 @@ gmax "auth" --root ~/other/project --agent # search a different project
 gmax "auth" --imports --agent              # show file imports per file
 ```
 
-Output: `file:line symbol [ROLE] — signature_hint` (one line per result)
+Output: `file:line symbol [ROLE] — signature_hint` (one line per result). When multiple hits land in the same file, they collapse under a `path/to/file.ts (N hits):` header with indented children — saves the repeated path prefix.
 
 All search flags: `--agent --plain -m <n> --per-file <n> --min-score <n> --root <dir> --file <name> --exclude <prefix> --lang <ext> --role <role> --symbol --imports --name <regex> -C <n> --compact --content --scores --skeleton --explain --context-for-llm --budget <tokens>`
 
@@ -87,6 +87,9 @@ gmax trace handleAuth                      # 1-hop: callers + callees
 gmax trace handleAuth -d 2                 # 2-hop: callers-of-callers
 gmax trace handleAuth --root ~/project     # trace in a different project
 gmax trace handleAuth --agent              # compact: symbol\tpath:line, <- callers, -> callees
+gmax trace handleAuth --inbound --agent    # callers-only with call-site snippets (path:line\tsymbol\tsnippet)
+gmax trace handleAuth --inbound --no-snippets   # drop the snippet column
+gmax trace handleAuth --inbound --limit 20      # show up to 20 callers (default 10, max 30)
 ```
 
 ### Extract — `gmax extract <symbol>`
@@ -95,7 +98,9 @@ gmax extract handleAuth                    # full function body with line number
 gmax extract handleAuth --agent            # compact: path:start-end then raw code
 gmax extract handleAuth --imports          # prepend file imports
 gmax extract handleAuth --root ~/project   # extract from different project
+gmax extract handleAuth --no-tests         # suppress tests footer (default-on)
 ```
+Output ends with a `--- tests:` footer listing tests that exercise the symbol (default-on; opt-out with `--no-tests`).
 
 ### Peek — `gmax peek <symbol>`
 ```
@@ -103,7 +108,9 @@ gmax peek handleAuth                       # signature + callers + callees
 gmax peek handleAuth --agent               # compact TSV output
 gmax peek handleAuth -d 2                  # 2-hop callers
 gmax peek handleAuth --root ~/project      # peek in different project
+gmax peek handleAuth --no-tests            # suppress tests footer (default-on)
 ```
+Agent output ends with `t: <test-file>:line\t<test-symbol>\t<hop-label>` rows where hop-label is `direct`, `N-hop`, or `via-import`.
 
 ### Skeleton — `gmax skeleton <target>`
 ```
@@ -124,10 +131,20 @@ gmax project --root ~/other/project        # different project
 gmax related src/lib/index/syncer.ts       # dependencies + dependents
 gmax related src/lib/index/syncer.ts --root ~/project
 ```
+When both directions are empty, falls back to files mentioning the input file's basename. Generic basenames (`index`, `main`, `lib`, etc.) skip the fallback.
 
-### Recent changes — `gmax recent`
+### Commit history — `gmax log <path-or-symbol>`
 ```
-gmax recent                                # recently modified files
+gmax log src/lib/auth.ts                   # commits touching this file
+gmax log src/lib/                          # commits touching this directory
+gmax log handleAuth                        # commits across all files defining the symbol
+gmax log handleAuth --in src/              # restrict symbol resolution to a sub-path
+gmax log src/lib/auth.ts --limit 5         # last 5 commits
+gmax log src/lib/auth.ts --from main       # commits since main (range main..HEAD)
+gmax log src/lib/auth.ts --since "2 weeks ago"
+gmax log src/lib/auth.ts --author Robert
+gmax log src/lib/auth.ts --no-follow       # disable rename tracking (default: on for files)
+gmax log src/lib/auth.ts --agent           # TSV: hash\tisoDate\tauthor\tsubject\tfilesChanged\tins\tdel\ttouchedFiles
 ```
 
 ### Symbols — `gmax symbols`
@@ -137,22 +154,14 @@ gmax symbols auth -p src/ --root ~/proj    # filter by name, path, project
 gmax symbols --agent                       # compact: symbol\tpath:line\tcount
 ```
 
-### Diff — `gmax diff [ref]`
-```
-gmax diff                              # uncommitted changes
-gmax diff HEAD~5                       # last 5 commits
-gmax diff main                         # branch changes vs main
-gmax diff main --query "auth changes"  # semantic search within changed files
-gmax diff --agent                      # compact output
-```
-
 ### Test — `gmax test <symbol|file>`
 ```
-gmax test handleAuth                   # tests calling handleAuth
+gmax test handleAuth                   # tests calling handleAuth (call-graph + import-fallback)
 gmax test src/lib/auth.ts              # tests for symbols in this file
 gmax test handleAuth -d 2              # 2-hop: tests calling callers too
 gmax test handleAuth --agent           # compact output
 ```
+Hop labels: `direct` (calls the symbol), `N-hop` (calls a transitive caller), `via-import` (test references the symbol via import or mock when no call-graph match exists).
 
 ### Impact — `gmax impact <symbol|file>`
 ```