grepmax 0.16.2 → 0.16.3

package/dist/commands/diff.js

@@ -1,145 +1,13 @@
 "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.diff = void 0;
 const commander_1 = require("commander");
-const searcher_1 = require("../lib/search/searcher");
-const vector_db_1 = require("../lib/store/vector-db");
-const filter_builder_1 = require("../lib/utils/filter-builder");
-const exit_1 = require("../lib/utils/exit");
-const git_1 = require("../lib/utils/git");
-const project_registry_1 = require("../lib/utils/project-registry");
-const project_root_1 = require("../lib/utils/project-root");
-const arrow_1 = require("../lib/utils/arrow");
 exports.diff = new commander_1.Command("diff")
-    .description("Search code scoped to git changes")
-    .argument("[ref]", "Git ref to diff against (e.g. main, HEAD~5)")
-    .option("-q, --query <query>", "Semantic search within changed files")
-    .option("-m, --max-count <n>", "Max results (default 10)", "10")
-    .option("--role <role>", "Filter by role: ORCHESTRATION, DEFINITION, IMPLEMENTATION")
-    .option("--root <dir>", "Project root directory")
-    .option("--agent", "Compact output for AI agents", false)
-    .action((ref, opts) => __awaiter(void 0, void 0, void 0, function* () {
-    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p;
-    const limit = Math.min(Math.max(Number.parseInt(opts.maxCount || "10", 10), 1), 50);
-    let vectorDb = null;
-    try {
-        const root = (0, project_registry_1.resolveRootOrExit)(opts.root);
-        if (root === null)
-            return;
-        const projectRoot = (_a = (0, project_root_1.findProjectRoot)(root)) !== null && _a !== void 0 ? _a : root;
-        const paths = (0, project_root_1.ensureProjectPaths)(projectRoot);
-        vectorDb = new vector_db_1.VectorDB(paths.lancedbDir);
-        const changedFiles = (0, git_1.getChangedFiles)(ref, projectRoot);
-        if (changedFiles.length === 0) {
-            console.log(ref ? `No changes found relative to ${ref}.` : "No uncommitted changes found.");
-            return;
-        }
-        const rel = (p) => p.startsWith(`${projectRoot}/`) ? p.slice(projectRoot.length + 1) : p;
-        if (opts.query) {
-            // Semantic search scoped to changed files
-            const searcher = new searcher_1.Searcher(vectorDb);
-            const response = yield searcher.search(opts.query, limit, { rerank: true }, Object.assign({}, (opts.role ? { role: opts.role } : {})), projectRoot);
-            // Filter results to only changed files
-            const changedSet = new Set(changedFiles);
-            const filtered = response.data.filter((r) => {
-                var _a;
-                const p = ((_a = r.metadata) === null || _a === void 0 ? void 0 : _a.path) || r.path || "";
-                return changedSet.has(p);
-            });
-            if (filtered.length === 0) {
-                console.log("No indexed results found in changed files for that query.");
-                return;
-            }
-            if (opts.agent) {
-                for (const r of filtered.slice(0, limit)) {
-                    const p = String(r.path || ((_b = r.metadata) === null || _b === void 0 ? void 0 : _b.path) || "");
-                    const line = Number((_c = r.start_line) !== null && _c !== void 0 ? _c : 0);
-                    const sym = (_e = (_d = (0, arrow_1.toArr)(r.defined_symbols)) === null || _d === void 0 ? void 0 : _d[0]) !== null && _e !== void 0 ? _e : "";
-                    const role = String(r.role || "IMPL");
-                    console.log(`${rel(p)}:${line + 1} ${sym} [${role}]`);
-                }
-            }
-            else {
-                console.log(`Changed files matching "${opts.query}":\n`);
-                for (const r of filtered.slice(0, limit)) {
-                    const p = String(r.path || ((_f = r.metadata) === null || _f === void 0 ? void 0 : _f.path) || "");
-                    const line = Number((_g = r.start_line) !== null && _g !== void 0 ? _g : 0);
-                    const sym = (_j = (_h = (0, arrow_1.toArr)(r.defined_symbols)) === null || _h === void 0 ? void 0 : _h[0]) !== null && _j !== void 0 ? _j : "";
-                    const role = String(r.role || "IMPLEMENTATION");
-                    const score = (_l = (_k = r.score) === null || _k === void 0 ? void 0 : _k.toFixed(3)) !== null && _l !== void 0 ? _l : "?";
-                    console.log(`  ${rel(p)}:${line + 1}  ${sym}  [${role}]  (${score})`);
-                }
-            }
-        }
-        else {
-            // No query — list changed files with their indexed symbols
-            const table = yield vectorDb.ensureTable();
-            if (opts.agent) {
-                for (const file of changedFiles) {
-                    const chunks = yield table
-                        .query()
-                        .select(["path", "start_line", "defined_symbols", "role"])
-                        .where(`path = '${(0, filter_builder_1.escapeSqlString)(file)}'`)
-                        .limit(50)
-                        .toArray();
-                    if (chunks.length === 0) {
-                        console.log(`${rel(file)}\t(not indexed)`);
-                    }
-                    else {
-                        for (const chunk of chunks) {
-                            const sym = (_o = (_m = (0, arrow_1.toArr)(chunk.defined_symbols)) === null || _m === void 0 ? void 0 : _m[0]) !== null && _o !== void 0 ? _o : "";
-                            const line = (_p = chunk.start_line) !== null && _p !== void 0 ? _p : 0;
-                            const role = (chunk.role || "IMPL").slice(0, 4);
-                            if (sym) {
-                                console.log(`${rel(file)}:${line + 1}\t${sym}\t[${role}]`);
-                            }
-                        }
-                    }
-                }
-            }
-            else {
-                console.log(`${changedFiles.length} changed file${changedFiles.length === 1 ? "" : "s"}${ref ? ` (vs ${ref})` : ""}:\n`);
-                for (const file of changedFiles) {
-                    const chunks = yield table
-                        .query()
-                        .select(["defined_symbols", "role"])
-                        .where(`path = '${(0, filter_builder_1.escapeSqlString)(file)}'`)
-                        .limit(50)
-                        .toArray();
-                    const symbols = chunks
-                        .flatMap((c) => (0, arrow_1.toArr)(c.defined_symbols))
-                        .filter(Boolean);
-                    if (symbols.length > 0) {
-                        console.log(`  ${rel(file)}  (${symbols.length} symbol${symbols.length === 1 ? "" : "s"}: ${symbols.slice(0, 5).join(", ")}${symbols.length > 5 ? "..." : ""})`);
-                    }
-                    else {
-                        console.log(`  ${rel(file)}`);
-                    }
-                }
-            }
-        }
-    }
-    catch (error) {
-        const msg = error instanceof Error ? error.message : "Unknown error";
-        console.error("Diff failed:", msg);
-        process.exitCode = 1;
-    }
-    finally {
-        if (vectorDb) {
-            try {
-                yield vectorDb.close();
-            }
-            catch (_q) { }
-        }
-        yield (0, exit_1.gracefulExit)();
-    }
-}));
+    .description("[deprecated] Use 'gmax log' instead")
+    .argument("[ref]", "(ignored — diff is deprecated)")
+    .allowUnknownOption(true)
+    .allowExcessArguments(true)
+    .action(() => {
+    console.error("gmax diff is deprecated; use 'gmax log <path-or-symbol>' instead");
+    process.exitCode = 1;
+});

package/dist/commands/log.js

@@ -0,0 +1,231 @@
+"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;
+    };
+})();
+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.log = void 0;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const commander_1 = require("commander");
+const vector_db_1 = require("../lib/store/vector-db");
+const exit_1 = require("../lib/utils/exit");
+const filter_builder_1 = require("../lib/utils/filter-builder");
+const git_1 = require("../lib/utils/git");
+const project_registry_1 = require("../lib/utils/project-registry");
+const project_root_1 = require("../lib/utils/project-root");
+const useColors = process.stdout.isTTY && !process.env.NO_COLOR;
+const style = {
+    bold: (s) => (useColors ? `\x1b[1m${s}\x1b[22m` : s),
+    dim: (s) => (useColors ? `\x1b[2m${s}\x1b[22m` : s),
+    cyan: (s) => (useColors ? `\x1b[36m${s}\x1b[39m` : s),
+    yellow: (s) => (useColors ? `\x1b[33m${s}\x1b[39m` : s),
+};
+function relativize(p, projectRoot) {
+    const prefix = projectRoot.endsWith("/") ? projectRoot : `${projectRoot}/`;
+    return p.startsWith(prefix) ? p.slice(prefix.length) : p;
+}
+function resolveSymbolPaths(vectorDb, symbol, projectRoot, inOpt, excludeOpt) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const { resolveScope, buildScopeWhere } = yield Promise.resolve().then(() => __importStar(require("../lib/utils/scope-filter")));
+        const scope = resolveScope({
+            projectRoot,
+            in: inOpt,
+            exclude: excludeOpt,
+        });
+        const where = buildScopeWhere(scope, `array_contains(defined_symbols, '${(0, filter_builder_1.escapeSqlString)(symbol)}')`);
+        const table = yield vectorDb.ensureTable();
+        const rows = yield table
+            .query()
+            .select(["path"])
+            .where(where)
+            .limit(50)
+            .toArray();
+        const paths = new Set();
+        for (const row of rows) {
+            const p = String(row.path || "");
+            if (p)
+                paths.add(p);
+        }
+        return [...paths];
+    });
+}
+function printHuman(commits, projectRoot, targetPaths) {
+    for (const c of commits) {
+        const header = `${style.yellow(c.shortHash)}  ${c.author}  ${style.dim(c.relDate)}  ${style.bold(c.subject)}`;
+        console.log(header);
+        const stat = `${c.filesChanged} file${c.filesChanged === 1 ? "" : "s"} changed, +${c.insertions} / -${c.deletions}`;
+        console.log(`  ${style.dim(stat)}`);
+        if (targetPaths && targetPaths.length > 1) {
+            const targetSet = new Set(targetPaths);
+            const touched = c.numstatLines
+                .filter((n) => targetSet.has(n.path) || targetSet.has(path.resolve(projectRoot, n.path)))
+                .map((n) => relativize(n.path, projectRoot));
+            if (touched.length > 0) {
+                console.log(`  ${style.dim(`via: ${touched.join(", ")}`)}`);
+            }
+        }
+        console.log();
+    }
+}
+function printAgent(commits, projectRoot, targetPaths) {
+    const targetSet = targetPaths && targetPaths.length > 0 ? new Set(targetPaths) : null;
+    for (const c of commits) {
+        let touched = "";
+        if (targetSet) {
+            const touchedPaths = c.numstatLines
+                .filter((n) => targetSet.has(n.path) || targetSet.has(path.resolve(projectRoot, n.path)))
+                .map((n) => relativize(n.path, projectRoot));
+            touched = touchedPaths.join(",");
+        }
+        const subject = c.subject.replace(/\t/g, " ");
+        console.log(`${c.shortHash}\t${c.isoDate}\t${c.author}\t${subject}\t${c.filesChanged}\t${c.insertions}\t${c.deletions}\t${touched}`);
+    }
+}
+exports.log = new commander_1.Command("log")
+    .description("Show git commit history for a path or symbol")
+    .argument("<path-or-symbol>", "File/dir path or symbol name")
+    .option("-l, --limit <n>", "Max commits (default 20)", "20")
+    .option("--since <date>", "Filter by date (e.g. '2 weeks ago', '2025-01-01')")
+    .option("--from <ref>", "Show commits since git ref (translates to <ref>..HEAD)")
+    .option("--author <name>", "Filter by author")
+    .option("--root <dir>", "Project root directory")
+    .option("--in <subpath>", "Restrict symbol resolution to a sub-path (repeatable; symbol mode only)", (value, prev) => prev ? [...prev, value] : [value])
+    .option("--exclude <subpath>", "Exclude a sub-path from symbol resolution (repeatable; symbol mode only)", (value, prev) => prev ? [...prev, value] : [value])
+    .option("--no-follow", "Disable rename tracking (default: enabled for single files in path mode)")
+    .option("--agent", "Compact TSV output for AI agents", false)
+    .action((arg, opts) => __awaiter(void 0, void 0, void 0, function* () {
+    var _a;
+    const limit = Math.min(Math.max(Number.parseInt(opts.limit || "20", 10), 1), 200);
+    const root = (0, project_registry_1.resolveRootOrExit)(opts.root);
+    if (root === null)
+        return;
+    const projectRoot = (_a = (0, project_root_1.findProjectRoot)(root)) !== null && _a !== void 0 ? _a : root;
+    let vectorDb = null;
+    try {
+        // 1. Try arg as path (relative to projectRoot, then cwd).
+        const candidates = [
+            path.resolve(projectRoot, arg),
+            path.resolve(process.cwd(), arg),
+        ];
+        let resolvedPath = null;
+        for (const c of candidates) {
+            if (fs.existsSync(c)) {
+                resolvedPath = c;
+                break;
+            }
+        }
+        if (resolvedPath) {
+            const isDir = fs.statSync(resolvedPath).isDirectory();
+            const commits = (0, git_1.getCommitHistory)({
+                paths: [resolvedPath],
+                limit,
+                since: opts.since,
+                from: opts.from,
+                author: opts.author,
+                follow: !isDir && opts.follow !== false,
+                cwd: projectRoot,
+            });
+            if (commits.length === 0) {
+                console.log(opts.agent
+                    ? ""
+                    : `No commits found for ${relativize(resolvedPath, projectRoot)}.`);
+                return;
+            }
+            if (opts.agent)
+                printAgent(commits, projectRoot, null);
+            else
+                printHuman(commits, projectRoot, null);
+            return;
+        }
+        // 2. Try arg as symbol via index lookup.
+        const paths = (0, project_root_1.ensureProjectPaths)(projectRoot);
+        vectorDb = new vector_db_1.VectorDB(paths.lancedbDir);
+        const symbolPaths = yield resolveSymbolPaths(vectorDb, arg, projectRoot, opts.in, opts.exclude);
+        if (symbolPaths.length === 0) {
+            console.error(`gmax log: no file or symbol matched '${arg}'`);
+            if (!opts.agent) {
+                console.error("");
+                console.error("Try `gmax search <term>` to find a symbol, or pass a file path.");
+            }
+            process.exitCode = 1;
+            return;
+        }
+        const commits = (0, git_1.getCommitHistory)({
+            paths: symbolPaths,
+            limit,
+            since: opts.since,
+            from: opts.from,
+            author: opts.author,
+            follow: false,
+            cwd: projectRoot,
+        });
+        if (commits.length === 0) {
+            console.log(opts.agent
+                ? ""
+                : `No commits found touching defining files for symbol '${arg}'.`);
+            return;
+        }
+        if (opts.agent)
+            printAgent(commits, projectRoot, symbolPaths);
+        else {
+            if (symbolPaths.length > 1) {
+                console.log(style.dim(`// '${arg}' defined in ${symbolPaths.length} files; commits merged by hash.`));
+                console.log();
+            }
+            printHuman(commits, projectRoot, symbolPaths);
+        }
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : "Unknown error";
+        console.error("Log failed:", msg);
+        process.exitCode = 1;
+    }
+    finally {
+        if (vectorDb) {
+            try {
+                yield vectorDb.close();
+            }
+            catch (_b) { }
+        }
+        yield (0, exit_1.gracefulExit)();
+    }
+}));

package/dist/commands/recent.js

@@ -1,134 +1,12 @@
 "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;
-    };
-})();
-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());
-    });
-};
-var __asyncValues = (this && this.__asyncValues) || function (o) {
-    if (!Symbol.asyncIterator) throw new TypeError("Symbol.asyncIterator is not defined.");
-    var m = o[Symbol.asyncIterator], i;
-    return m ? m.call(o) : (o = typeof __values === "function" ? __values(o) : o[Symbol.iterator](), i = {}, verb("next"), verb("throw"), verb("return"), i[Symbol.asyncIterator] = function () { return this; }, i);
-    function verb(n) { i[n] = o[n] && function (v) { return new Promise(function (resolve, reject) { v = o[n](v), settle(resolve, reject, v.done, v.value); }); }; }
-    function settle(resolve, reject, d, v) { Promise.resolve(v).then(function(v) { resolve({ value: v, done: d }); }, reject); }
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.recent = void 0;
-const path = __importStar(require("node:path"));
 const commander_1 = require("commander");
-const config_1 = require("../config");
-const meta_cache_1 = require("../lib/store/meta-cache");
-const exit_1 = require("../lib/utils/exit");
-const format_helpers_1 = require("../lib/utils/format-helpers");
-const project_registry_1 = require("../lib/utils/project-registry");
-const project_root_1 = require("../lib/utils/project-root");
 exports.recent = new commander_1.Command("recent")
-    .description("Show recently modified indexed files")
-    .option("-l, --limit <n>", "Max files (default 20)", "20")
-    .option("--root <dir>", "Project root (defaults to current directory)")
-    .option("--agent", "Compact output for AI agents", false)
-    .action((opts) => __awaiter(void 0, void 0, void 0, function* () {
-    var _a, e_1, _b, _c;
-    var _d;
-    const limit = Math.min(Math.max(Number.parseInt(opts.limit || "20", 10), 1), 50);
-    try {
-        const resolvedRoot = (0, project_registry_1.resolveRootOrExit)(opts.root);
-        if (resolvedRoot === null)
-            return;
-        const root = (_d = (0, project_root_1.findProjectRoot)(resolvedRoot)) !== null && _d !== void 0 ? _d : resolvedRoot;
-        const prefix = root.endsWith("/") ? root : `${root}/`;
-        const metaCache = new meta_cache_1.MetaCache(config_1.PATHS.lmdbPath);
-        try {
-            const files = [];
-            try {
-                for (var _e = true, _f = __asyncValues(metaCache.entries()), _g; _g = yield _f.next(), _a = _g.done, !_a; _e = true) {
-                    _c = _g.value;
-                    _e = false;
-                    const { path: p, entry } = _c;
-                    if (p.startsWith(prefix)) {
-                        files.push({ path: p, mtimeMs: entry.mtimeMs });
-                    }
-                }
-            }
-            catch (e_1_1) { e_1 = { error: e_1_1 }; }
-            finally {
-                try {
-                    if (!_e && !_a && (_b = _f.return)) yield _b.call(_f);
-                }
-                finally { if (e_1) throw e_1.error; }
-            }
-            files.sort((a, b) => b.mtimeMs - a.mtimeMs);
-            const top = files.slice(0, limit);
-            if (top.length === 0) {
-                console.log(`No indexed files found for ${root}`);
-                console.log("\nTry: `gmax add` to register and index this project, or `gmax status` to see what's indexed.");
-                process.exitCode = 1;
-                return;
-            }
-            const now = Date.now();
-            if (opts.agent) {
-                for (const f of top) {
-                    const rel = f.path.startsWith(prefix)
-                        ? f.path.slice(prefix.length)
-                        : f.path;
-                    console.log(`${rel}\t${(0, format_helpers_1.formatTimeAgo)(now - f.mtimeMs)}`);
-                }
-            }
-            else {
-                console.log(`Recent changes in ${path.basename(root)} (${top.length} most recent):\n`);
-                for (const f of top) {
-                    const rel = f.path.startsWith(prefix)
-                        ? f.path.slice(prefix.length)
-                        : f.path;
-                    const ago = (0, format_helpers_1.formatTimeAgo)(now - f.mtimeMs);
-                    console.log(`  ${ago.padEnd(10)} ${rel}`);
-                }
-            }
-        }
-        finally {
-            yield metaCache.close();
-        }
-    }
-    catch (error) {
-        const msg = error instanceof Error ? error.message : "Unknown error";
-        console.error("Recent changes failed:", msg);
-        process.exitCode = 1;
-    }
-    yield (0, exit_1.gracefulExit)();
-}));
+    .description("[deprecated] Use 'gmax log' instead")
+    .allowUnknownOption(true)
+    .allowExcessArguments(true)
+    .action(() => {
+    console.error("gmax recent is deprecated; use 'gmax log <path-or-symbol>' instead");
+    process.exitCode = 1;
+});

package/dist/index.js

@@ -52,6 +52,7 @@ const index_1 = require("./commands/index");
 const investigate_1 = require("./commands/investigate");
 const list_1 = require("./commands/list");
 const llm_1 = require("./commands/llm");
+const log_1 = require("./commands/log");
 const mcp_1 = require("./commands/mcp");
 const peek_1 = require("./commands/peek");
 const project_1 = require("./commands/project");
@@ -115,6 +116,7 @@ commander_1.program.addCommand(extract_1.extract);
 commander_1.program.addCommand(peek_1.peek);
 commander_1.program.addCommand(project_1.project);
 commander_1.program.addCommand(related_1.related);
+commander_1.program.addCommand(log_1.log);
 commander_1.program.addCommand(recent_1.recent);
 commander_1.program.addCommand(diff_1.diff);
 commander_1.program.addCommand(test_find_1.testFind);

package/dist/lib/utils/git.js

@@ -37,6 +37,7 @@ exports.isWorktree = isWorktree;
 exports.getGitCommonDir = getGitCommonDir;
 exports.getMainRepoRoot = getMainRepoRoot;
 exports.getChangedFiles = getChangedFiles;
+exports.getCommitHistory = getCommitHistory;
 exports.getUntrackedFiles = getUntrackedFiles;
 const node_child_process_1 = require("node:child_process");
 const fs = __importStar(require("node:fs"));
@@ -115,6 +116,95 @@ function getChangedFiles(ref, cwd) {
         return [];
     }
 }
+/**
+ * Get commit history for one or more paths. When paths.length > 1 (symbol
+ * fan-out), git natively dedupes commits across paths. --follow only works
+ * with a single path; auto-disabled otherwise.
+ */
+function getCommitHistory(opts) {
+    var _a;
+    if (opts.paths.length === 0)
+        return [];
+    const args = [
+        "log",
+        "--pretty=format:%x1e%H%x1f%aN%x1f%aI%x1f%ar%x1f%s",
+        "--numstat",
+    ];
+    if (opts.follow && opts.paths.length === 1)
+        args.push("--follow");
+    if (opts.limit > 0)
+        args.push(`-n${opts.limit}`);
+    if (opts.since)
+        args.push(`--since=${opts.since}`);
+    if (opts.author)
+        args.push(`--author=${opts.author}`);
+    if (opts.from)
+        args.push(`${opts.from}..HEAD`);
+    args.push("--");
+    for (const p of opts.paths)
+        args.push(p);
+    const execOpts = {
+        cwd: (_a = opts.cwd) !== null && _a !== void 0 ? _a : process.cwd(),
+        encoding: "utf-8",
+        timeout: 10000,
+        maxBuffer: 16 * 1024 * 1024,
+    };
+    let output;
+    try {
+        output = (0, node_child_process_1.execFileSync)("git", args, execOpts);
+    }
+    catch (_b) {
+        return [];
+    }
+    const records = output.split("\x1e").filter((r) => r.length > 0);
+    const commits = [];
+    for (const record of records) {
+        const lines = record.split("\n");
+        if (lines.length === 0)
+            continue;
+        const headerFields = lines[0].split("\x1f");
+        if (headerFields.length < 5)
+            continue;
+        const [hash, author, isoDate, relDate, subject] = headerFields;
+        const numstatLines = [];
+        let insertions = 0;
+        let deletions = 0;
+        for (let i = 1; i < lines.length; i++) {
+            const line = lines[i].trim();
+            if (!line)
+                continue;
+            const parts = line.split("\t");
+            if (parts.length < 3)
+                continue;
+            // Binary diffs report '-' for added/removed; treat as 0.
+            const added = parts[0] === "-" ? 0 : Number.parseInt(parts[0], 10);
+            const removed = parts[1] === "-" ? 0 : Number.parseInt(parts[1], 10);
+            const path = parts.slice(2).join("\t");
+            if (Number.isFinite(added))
+                insertions += added;
+            if (Number.isFinite(removed))
+                deletions += removed;
+            numstatLines.push({
+                added: Number.isFinite(added) ? added : 0,
+                removed: Number.isFinite(removed) ? removed : 0,
+                path,
+            });
+        }
+        commits.push({
+            hash,
+            shortHash: hash.slice(0, 7),
+            author,
+            isoDate,
+            relDate,
+            subject,
+            filesChanged: numstatLines.length,
+            insertions,
+            deletions,
+            numstatLines,
+        });
+    }
+    return commits;
+}
 /**
  * Get untracked files (not yet added to git).
  * Returns absolute paths.

package/package.json

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

@@ -125,9 +125,18 @@ gmax related src/lib/index/syncer.ts       # dependencies + dependents
 gmax related src/lib/index/syncer.ts --root ~/project
 ```
 
-### 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,15 +146,6 @@ 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