grepmax 0.16.1 → 0.16.3

package/dist/commands/peek.js

@@ -44,13 +44,13 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.peek = void 0;
 const fs = __importStar(require("node:fs"));
-const path = __importStar(require("node:path"));
 const commander_1 = require("commander");
 const graph_builder_1 = require("../lib/graph/graph-builder");
 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 language_1 = require("../lib/utils/language");
+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 = {
@@ -95,29 +95,37 @@ exports.peek = new commander_1.Command("peek")
     .argument("<symbol>", "The symbol to peek at")
     .option("-d, --depth <n>", "Caller traversal depth (default 1, max 3)", "1")
     .option("--root <dir>", "Project root directory")
+    .option("--in <subpath>", "Restrict to a sub-path of the project (repeatable)", (value, prev) => (prev ? [...prev, value] : [value]))
+    .option("--exclude <subpath>", "Exclude a sub-path of the project (repeatable)", (value, prev) => (prev ? [...prev, value] : [value]))
     .option("--agent", "Compact output for AI agents", false)
     .action((symbol, opts) => __awaiter(void 0, void 0, void 0, function* () {
     var _a;
     let vectorDb = null;
-    const root = opts.root ? path.resolve(opts.root) : process.cwd();
+    const root = (0, project_registry_1.resolveRootOrExit)(opts.root);
+    if (root === null)
+        return;
     const depth = Math.min(Math.max(Number.parseInt(opts.depth || "1", 10), 1), 3);
     try {
         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 { resolveScope, buildScopeWhere } = yield Promise.resolve().then(() => __importStar(require("../lib/utils/scope-filter")));
+        const scope = resolveScope({
+            projectRoot,
+            in: opts.in,
+            exclude: opts.exclude,
+        });
+        const scopeWhere = (cond) => buildScopeWhere(scope, cond);
         // Cross-language disambiguation: when the symbol is defined in 2+
         // languages, refuse to silently pick one. The graph builder otherwise
         // picks one chunk arbitrarily and lists callers from a different
         // language — verified failure mode.
         {
             const tableForCheck = yield vectorDb.ensureTable();
-            const prefixForCheck = projectRoot.endsWith("/")
-                ? projectRoot
-                : `${projectRoot}/`;
             const allDefs = yield tableForCheck
                 .query()
                 .select(["path", "start_line"])
-                .where(`array_contains(defined_symbols, '${(0, filter_builder_1.escapeSqlString)(symbol)}') AND path LIKE '${(0, filter_builder_1.escapeSqlString)(prefixForCheck)}%'`)
+                .where(scopeWhere(`array_contains(defined_symbols, '${(0, filter_builder_1.escapeSqlString)(symbol)}')`))
                 .limit(20)
                 .toArray();
             const chunks = allDefs.map((row) => ({
@@ -140,7 +148,7 @@ exports.peek = new commander_1.Command("peek")
                 return;
             }
         }
-        const graphBuilder = new graph_builder_1.GraphBuilder(vectorDb, projectRoot);
+        const graphBuilder = new graph_builder_1.GraphBuilder(vectorDb, scope.pathPrefix, scope.excludePrefixes);
         const graph = yield graphBuilder.buildGraph(symbol);
         if (!graph.center) {
             const lines = [
@@ -159,13 +167,10 @@ exports.peek = new commander_1.Command("peek")
             : p;
         // Get chunk metadata for is_exported and end_line
         const table = yield vectorDb.ensureTable();
-        const prefix = projectRoot.endsWith("/")
-            ? projectRoot
-            : `${projectRoot}/`;
         const metaRows = yield table
             .query()
             .select(["is_exported", "start_line", "end_line"])
-            .where(`array_contains(defined_symbols, '${(0, filter_builder_1.escapeSqlString)(symbol)}') AND path LIKE '${(0, filter_builder_1.escapeSqlString)(prefix)}%'`)
+            .where(scopeWhere(`array_contains(defined_symbols, '${(0, filter_builder_1.escapeSqlString)(symbol)}')`))
             .limit(1)
             .toArray();
         const exported = metaRows.length > 0 && Boolean(metaRows[0].is_exported);

package/dist/commands/project.js

@@ -56,12 +56,13 @@ exports.project = new commander_1.Command("project")
     .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, _b, _c, _d;
+    var _a, _b, _c;
     let vectorDb = null;
     try {
-        const root = opts.root
-            ? (_a = (0, project_root_1.findProjectRoot)(path.resolve(opts.root))) !== null && _a !== void 0 ? _a : path.resolve(opts.root)
-            : (_b = (0, project_root_1.findProjectRoot)(process.cwd())) !== null && _b !== void 0 ? _b : process.cwd();
+        const resolvedRoot = (0, project_registry_1.resolveRootOrExit)(opts.root);
+        if (resolvedRoot === null)
+            return;
+        const root = (_a = (0, project_root_1.findProjectRoot)(resolvedRoot)) !== null && _a !== void 0 ? _a : resolvedRoot;
         const prefix = root.endsWith("/") ? root : `${root}/`;
         const projectName = path.basename(root);
         const paths = (0, project_root_1.ensureProjectPaths)(root);
@@ -136,7 +137,7 @@ exports.project = new commander_1.Command("project")
             console.log(`root\t${root}`);
             console.log(`chunks\t${rows.length}`);
             console.log(`files\t${files.size}`);
-            console.log(`last_indexed\t${(_c = proj === null || proj === void 0 ? void 0 : proj.lastIndexed) !== null && _c !== void 0 ? _c : "unknown"}`);
+            console.log(`last_indexed\t${(_b = proj === null || proj === void 0 ? void 0 : proj.lastIndexed) !== null && _b !== void 0 ? _b : "unknown"}`);
             console.log(`languages\t${extEntries.map(([ext]) => ext).join(",")}`);
             console.log(`top_dirs\t${Array.from(dirCounts.entries()).sort((a, b) => b[1].chunks - a[1].chunks).slice(0, 8).map(([d]) => d).join(",")}`);
             if (topSymbols.length > 0) {
@@ -148,7 +149,7 @@ exports.project = new commander_1.Command("project")
         }
         else {
             console.log(`Project: ${projectName} (${root})`);
-            console.log(`Last indexed: ${(_d = proj === null || proj === void 0 ? void 0 : proj.lastIndexed) !== null && _d !== void 0 ? _d : "unknown"} • ${rows.length} chunks • ${files.size} files\n`);
+            console.log(`Last indexed: ${(_c = proj === null || proj === void 0 ? void 0 : proj.lastIndexed) !== null && _c !== void 0 ? _c : "unknown"} • ${rows.length} chunks • ${files.size} files\n`);
             console.log(`Languages: ${extEntries.map(([ext, count]) => `${ext} (${Math.round((count / rows.length) * 100)}%)`).join(", ")}\n`);
             console.log("Directory structure:");
             for (const [dir, data] of Array.from(dirCounts.entries())
@@ -182,7 +183,7 @@ exports.project = new commander_1.Command("project")
             try {
                 yield vectorDb.close();
             }
-            catch (_e) { }
+            catch (_d) { }
         }
         yield (0, exit_1.gracefulExit)();
     }

package/dist/commands/recent.js

@@ -1,132 +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_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, _e;
-    const limit = Math.min(Math.max(Number.parseInt(opts.limit || "20", 10), 1), 50);
-    try {
-        const root = opts.root
-            ? (_d = (0, project_root_1.findProjectRoot)(path.resolve(opts.root))) !== null && _d !== void 0 ? _d : path.resolve(opts.root)
-            : (_e = (0, project_root_1.findProjectRoot)(process.cwd())) !== null && _e !== void 0 ? _e : process.cwd();
-        const prefix = root.endsWith("/") ? root : `${root}/`;
-        const metaCache = new meta_cache_1.MetaCache(config_1.PATHS.lmdbPath);
-        try {
-            const files = [];
-            try {
-                for (var _f = true, _g = __asyncValues(metaCache.entries()), _h; _h = yield _g.next(), _a = _h.done, !_a; _f = true) {
-                    _c = _h.value;
-                    _f = 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 (!_f && !_a && (_b = _g.return)) yield _b.call(_g);
-                }
-                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/commands/related.js

@@ -48,6 +48,7 @@ const commander_1 = require("commander");
 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 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.related = new commander_1.Command("related")
@@ -55,19 +56,29 @@ exports.related = new commander_1.Command("related")
     .argument("<file>", "File path relative to project root")
     .option("-l, --limit <n>", "Max results per direction (default 10)", "10")
     .option("--root <dir>", "Project root directory")
+    .option("--in <subpath>", "Restrict to a sub-path of the project (repeatable)", (value, prev) => (prev ? [...prev, value] : [value]))
+    .option("--exclude <subpath>", "Exclude a sub-path of the project (repeatable)", (value, prev) => (prev ? [...prev, value] : [value]))
     .option("--agent", "Compact output for AI agents", false)
     .action((file, opts) => __awaiter(void 0, void 0, void 0, function* () {
     var _a;
     const limit = Math.min(Math.max(Number.parseInt(opts.limit || "10", 10), 1), 25);
     let vectorDb = null;
     try {
-        const root = opts.root ? path.resolve(opts.root) : process.cwd();
+        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 absPath = path.resolve(projectRoot, file);
         const table = yield vectorDb.ensureTable();
-        const pathScope = `path LIKE '${(0, filter_builder_1.escapeSqlString)(projectRoot)}/%'`;
+        const { resolveScope, buildScopeWhere } = yield Promise.resolve().then(() => __importStar(require("../lib/utils/scope-filter")));
+        const scope = resolveScope({
+            projectRoot,
+            in: opts.in,
+            exclude: opts.exclude,
+        });
+        const pathScope = buildScopeWhere(scope);
         const fileChunks = yield table
             .query()
             .select(["defined_symbols", "referenced_symbols"])

package/dist/commands/remove.js

@@ -43,7 +43,6 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.remove = void 0;
-const fs = __importStar(require("node:fs"));
 const path = __importStar(require("node:path"));
 const readline = __importStar(require("node:readline"));
 const commander_1 = require("commander");
@@ -83,41 +82,23 @@ Examples:
     let vectorDb = null;
     let metaCache = null;
     try {
-        // Resolve name → registered root when arg has no path separator and isn't a dir.
-        // Avoids the footgun where a typo'd name silently removed the cwd project.
-        let resolvedDir = dir;
-        if (dir &&
-            !dir.includes("/") &&
-            !dir.includes("\\") &&
-            !fs.existsSync(path.resolve(dir))) {
-            const matches = (0, project_registry_1.listProjects)().filter((p) => p.name === dir);
-            if (matches.length === 0) {
-                console.error(`No registered project named "${dir}".`);
-                const all = (0, project_registry_1.listProjects)();
-                if (all.length > 0) {
-                    console.error("Available projects:");
-                    for (const p of all) {
-                        console.error(`  ${p.name.padEnd(24)} ${p.root}`);
-                    }
-                }
-                else {
-                    console.error("No projects are currently registered.");
-                }
-                process.exitCode = 1;
-                return;
+        // Resolve name → registered root when arg has no path separator and
+        // isn't a dir. Avoids the footgun where a typo'd name silently removed
+        // the cwd project.
+        let targetDir;
+        if (dir) {
+            try {
+                targetDir = (0, project_registry_1.resolveProjectRoot)(dir);
             }
-            if (matches.length > 1) {
-                console.error(`Multiple registered projects named "${dir}":`);
-                for (const p of matches) {
-                    console.error(`  ${p.root}`);
-                }
-                console.error("Pass an absolute path to disambiguate.");
+            catch (err) {
+                console.error(err instanceof Error ? err.message : String(err));
                 process.exitCode = 1;
                 return;
             }
-            resolvedDir = matches[0].root;
         }
-        const targetDir = resolvedDir ? path.resolve(resolvedDir) : process.cwd();
+        else {
+            targetDir = process.cwd();
+        }
         const projectRoot = (_a = (0, project_root_1.findProjectRoot)(targetDir)) !== null && _a !== void 0 ? _a : targetDir;
         const projectName = path.basename(projectRoot);
         const project = (0, project_registry_1.getProject)(projectRoot);

package/dist/commands/review.js

@@ -48,6 +48,7 @@ const fs = __importStar(require("node:fs"));
 const path = __importStar(require("node:path"));
 const commander_1 = require("commander");
 const exit_1 = require("../lib/utils/exit");
+const project_registry_1 = require("../lib/utils/project-registry");
 const project_root_1 = require("../lib/utils/project-root");
 exports.review = new commander_1.Command("review")
     .description("Review code changes using local LLM + codebase context")
@@ -69,7 +70,9 @@ Subcommands:
     .action((opts) => __awaiter(void 0, void 0, void 0, function* () {
     var _a;
     try {
-        const root = opts.root ? path.resolve(opts.root) : process.cwd();
+        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 commitRef = opts.commit;
         if (opts.background) {
@@ -135,7 +138,9 @@ exports.review
     .action((opts) => __awaiter(void 0, void 0, void 0, function* () {
     var _a;
     try {
-        const root = opts.root ? path.resolve(opts.root) : process.cwd();
+        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 { readReport, formatReportText } = yield Promise.resolve().then(() => __importStar(require("../lib/llm/report")));
         const report = readReport(projectRoot);
@@ -166,7 +171,9 @@ exports.review
     .action((opts) => __awaiter(void 0, void 0, void 0, function* () {
     var _a;
     try {
-        const root = opts.root ? path.resolve(opts.root) : process.cwd();
+        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 { clearReport } = yield Promise.resolve().then(() => __importStar(require("../lib/llm/report")));
         clearReport(projectRoot);