grepmax 0.16.0 → 0.16.2

package/dist/commands/context.js

@@ -44,13 +44,13 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.context = void 0;
 const fs = __importStar(require("node:fs"));
-const path = __importStar(require("node:path"));
 const commander_1 = require("commander");
 const searcher_1 = require("../lib/search/searcher");
 const skeleton_1 = require("../lib/skeleton");
 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");
 function estimateTokens(text) {
@@ -69,7 +69,9 @@ exports.context = new commander_1.Command("context")
     const maxResults = Number.parseInt(opts.maxResults || "10", 10) || 10;
     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);

package/dist/commands/diff.js

@@ -1,37 +1,4 @@
 "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) {
@@ -43,13 +10,13 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.diff = void 0;
-const path = __importStar(require("node:path"));
 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")
@@ -65,7 +32,9 @@ exports.diff = new commander_1.Command("diff")
     const limit = Math.min(Math.max(Number.parseInt(opts.maxCount || "10", 10), 1), 50);
     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);

package/dist/commands/extract.js

@@ -44,12 +44,13 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.extract = 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 import_extractor_1 = require("../lib/utils/import-extractor");
+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 = {
@@ -63,10 +64,9 @@ const ROLE_PRIORITY = {
     DEFINITION: 2,
     IMPLEMENTATION: 1,
 };
-function findSymbolChunks(symbol, db, projectRoot) {
+function findSymbolChunks(db, whereClause) {
     return __awaiter(this, void 0, void 0, function* () {
         const table = yield db.ensureTable();
-        const prefix = projectRoot.endsWith("/") ? projectRoot : `${projectRoot}/`;
         const rows = yield table
             .query()
             .select([
@@ -77,7 +77,7 @@ function findSymbolChunks(symbol, db, projectRoot) {
             "is_exported",
             "defined_symbols",
         ])
-            .where(`array_contains(defined_symbols, '${(0, filter_builder_1.escapeSqlString)(symbol)}') AND path LIKE '${(0, filter_builder_1.escapeSqlString)(prefix)}%'`)
+            .where(whereClause)
             .limit(10)
             .toArray();
         return rows.map((row) => ({
@@ -106,17 +106,28 @@ exports.extract = new commander_1.Command("extract")
     .description("Extract full function/class body by symbol name")
     .argument("<symbol>", "The symbol to extract")
     .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)
     .option("--imports", "Prepend file imports", 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;
     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 chunks = yield findSymbolChunks(symbol, vectorDb, 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 where = buildScopeWhere(scope, `array_contains(defined_symbols, '${(0, filter_builder_1.escapeSqlString)(symbol)}')`);
+        const chunks = yield findSymbolChunks(vectorDb, where);
         if (chunks.length === 0) {
             const lines = [
                 `Symbol not found: ${opts.agent ? symbol : style.bold(symbol)}`,
@@ -128,6 +139,25 @@ exports.extract = new commander_1.Command("extract")
             process.exitCode = 1;
             return;
         }
+        // Cross-language disambiguation: when the symbol is defined in 2+
+        // languages, refuse to silently pick one. Listing all matches with a
+        // recovery hint avoids the dogfooded failure mode where peek picked
+        // Swift but listed TS callers.
+        const byLang = (0, language_1.groupByLanguage)(chunks);
+        if (byLang.size >= 2) {
+            const rel = (p) => p.startsWith(projectRoot) ? p.slice(projectRoot.length + 1) : p;
+            const lines = [
+                `Symbol '${symbol}' is defined in multiple languages:`,
+            ];
+            for (const [lang, group] of byLang) {
+                const c = group[0];
+                lines.push(`  ${lang.padEnd(6)} ${rel(c.path)}:${c.startLine + 1}`);
+            }
+            lines.push(`Disambiguate with --root or pin to a path: gmax extract ${symbol} --root <project-root>`);
+            console.log(lines.join("\n"));
+            process.exitCode = 1;
+            return;
+        }
         const best = pickBestMatch(chunks, symbol);
         const content = fs.readFileSync(best.path, "utf-8");
         const allLines = content.split("\n");

package/dist/commands/impact.js

@@ -48,19 +48,24 @@ const commander_1 = require("commander");
 const impact_1 = require("../lib/graph/impact");
 const vector_db_1 = require("../lib/store/vector-db");
 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.impact = new commander_1.Command("impact")
     .description("Analyze change impact: dependents and affected tests")
     .argument("<target>", "Symbol name or file path")
     .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((target, 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);
     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);
@@ -77,10 +82,23 @@ exports.impact = new commander_1.Command("impact")
             ? (target.startsWith("/") ? target : path.resolve(projectRoot, target))
             : undefined;
         const excludePaths = targetPath ? new Set([targetPath]) : undefined;
+        const { resolveScope } = yield Promise.resolve().then(() => __importStar(require("../lib/utils/scope-filter")));
+        const scope = resolveScope({
+            projectRoot,
+            in: opts.in,
+            exclude: opts.exclude,
+        });
+        // Treat --in as an exclude-everything-else when set: any prefix that
+        // isn't the --in scope becomes effectively excluded. Today findDependents
+        // always queries within projectRoot; passing scope.pathPrefix when --in
+        // is set narrows it. Reuse the existing projectRoot semantic when no --in.
+        const queryRoot = opts.in && opts.in.length > 0
+            ? scope.pathPrefix.replace(/\/$/, "")
+            : projectRoot;
         // Run dependents and tests in parallel
         const [dependents, tests] = yield Promise.all([
-            (0, impact_1.findDependents)(symbols, vectorDb, projectRoot, excludePaths),
-            (0, impact_1.findTests)(symbols, vectorDb, projectRoot, depth),
+            (0, impact_1.findDependents)(symbols, vectorDb, queryRoot, excludePaths, undefined, scope.excludePrefixes),
+            (0, impact_1.findTests)(symbols, vectorDb, queryRoot, depth, scope.excludePrefixes),
         ]);
         // Separate test files from non-test dependents
         const nonTestDeps = dependents.filter((d) => !(0, impact_1.isTestPath)(d.file));

package/dist/commands/investigate.js

@@ -43,9 +43,9 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.investigateCmd = void 0;
-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.investigateCmd = new commander_1.Command("investigate")
     .description("Ask a question about the codebase using local LLM + gmax tools")
@@ -62,7 +62,9 @@ Examples:
     .action((question, 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 maxRounds = Math.min(Math.max(Number.parseInt(opts.rounds || "10", 10), 1), 20);
         // Ensure LLM server is running

package/dist/commands/peek.js

@@ -44,12 +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 = {
@@ -94,17 +95,60 @@ 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 graphBuilder = new graph_builder_1.GraphBuilder(vectorDb, 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 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 allDefs = yield tableForCheck
+                .query()
+                .select(["path", "start_line"])
+                .where(scopeWhere(`array_contains(defined_symbols, '${(0, filter_builder_1.escapeSqlString)(symbol)}')`))
+                .limit(20)
+                .toArray();
+            const chunks = allDefs.map((row) => ({
+                path: String(row.path || ""),
+                startLine: Number(row.start_line || 0),
+            }));
+            const byLang = (0, language_1.groupByLanguage)(chunks);
+            if (byLang.size >= 2) {
+                const rel = (p) => p.startsWith(projectRoot) ? p.slice(projectRoot.length + 1) : p;
+                const lines = [
+                    `Symbol '${symbol}' is defined in multiple languages:`,
+                ];
+                for (const [lang, group] of byLang) {
+                    const c = group[0];
+                    lines.push(`  ${lang.padEnd(6)} ${rel(c.path)}:${c.startLine + 1}`);
+                }
+                lines.push(`Disambiguate with --root or pin to a path: gmax peek ${symbol} --root <project-root>`);
+                console.log(lines.join("\n"));
+                process.exitCode = 1;
+                return;
+            }
+        }
+        const graphBuilder = new graph_builder_1.GraphBuilder(vectorDb, scope.pathPrefix, scope.excludePrefixes);
         const graph = yield graphBuilder.buildGraph(symbol);
         if (!graph.center) {
             const lines = [
@@ -123,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

@@ -56,6 +56,7 @@ 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")
@@ -64,20 +65,21 @@ exports.recent = new commander_1.Command("recent")
     .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;
+    var _d;
     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 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 _f = true, _g = __asyncValues(metaCache.entries()), _h; _h = yield _g.next(), _a = _h.done, !_a; _f = true) {
-                    _c = _h.value;
-                    _f = false;
+                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 });
@@ -87,7 +89,7 @@ exports.recent = new commander_1.Command("recent")
             catch (e_1_1) { e_1 = { error: e_1_1 }; }
             finally {
                 try {
-                    if (!_f && !_a && (_b = _g.return)) yield _b.call(_g);
+                    if (!_e && !_a && (_b = _f.return)) yield _b.call(_f);
                 }
                 finally { if (e_1) throw e_1.error; }
             }

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

@@ -68,12 +68,13 @@ function confirm(message) {
 }
 exports.remove = new commander_1.Command("remove")
     .description("Remove a project from the gmax index")
-    .argument("[dir]", "Directory to remove (defaults to current directory)")
+    .argument("[dir-or-name]", "Directory or registered project name (defaults to current directory)")
     .option("-f, --force", "Skip confirmation prompt", false)
     .addHelpText("after", `
 Examples:
   gmax remove                  Remove the current project
-  gmax remove ~/projects/app   Remove a specific project
+  gmax remove ~/projects/app   Remove a specific project by path
+  gmax remove my-app           Remove a registered project by name
   gmax remove --force          Skip confirmation
 `)
     .action((dir, opts) => __awaiter(void 0, void 0, void 0, function* () {
@@ -81,7 +82,23 @@ Examples:
     let vectorDb = null;
     let metaCache = null;
     try {
-        const targetDir = dir ? path.resolve(dir) : process.cwd();
+        // 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);
+            }
+            catch (err) {
+                console.error(err instanceof Error ? err.message : String(err));
+                process.exitCode = 1;
+                return;
+            }
+        }
+        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);