grepmax 0.17.19 → 0.17.20

package/README.md

@@ -163,6 +163,9 @@ gmax "query" [options]
 | `--explain` | Show scoring breakdown per result. | `false` |
 | `-C <n>` | Context lines before/after. | `0` |
 | `--root <dir>` | Search a different project. | cwd |
+| `--all-projects` | Search every indexed project; results grouped by project. | `false` |
+| `--projects <list>` | Search only these projects (comma-separated names). | — |
+| `--exclude-projects <list>` | With `--all-projects`, skip these projects. | — |
 | `--min-score <n>` | Minimum relevance score. | `0` |
 
 ## Background Daemon

package/dist/commands/search.js

@@ -56,6 +56,7 @@ const setup_helpers_1 = require("../lib/setup/setup-helpers");
 const skeleton_1 = require("../lib/skeleton");
 const retriever_1 = require("../lib/skeleton/retriever");
 const vector_db_1 = require("../lib/store/vector-db");
+const cross_project_1 = require("../lib/utils/cross-project");
 const exit_1 = require("../lib/utils/exit");
 const formatter_1 = require("../lib/utils/formatter");
 const import_extractor_1 = require("../lib/utils/import-extractor");
@@ -370,6 +371,9 @@ exports.search = new commander_1.Command("search")
     .option("--file <name>", "Filter to files matching this name (e.g. 'syncer.ts')")
     .option("--in <subpath>", "Restrict to a sub-path of the project (repeatable; comma-separated also accepted)", (value, prev) => prev ? [...prev, value] : [value])
     .option("--exclude <subpath>", "Exclude a sub-path of the project (repeatable; e.g. 'tests/')", (value, prev) => prev ? [...prev, value] : [value])
+    .option("--all-projects", "Search across every indexed project, not just the current one", false)
+    .option("--projects <list>", "Search only these indexed projects (comma-separated names)")
+    .option("--exclude-projects <list>", "With --all-projects, skip these projects (comma-separated names)")
     .option("--lang <ext>", "Filter by file extension (e.g. 'ts', 'py')")
     .option("--role <role>", "Filter by role: ORCHESTRATION, DEFINITION, IMPLEMENTATION")
     .option("--symbol", "Append call graph after search results", false)
@@ -389,9 +393,11 @@ Examples:
   gmax "VectorDB" --symbol --plain
   gmax "error handling" -C 5 --imports --plain
   gmax "handler" --name "handle.*" --exclude tests/
+  gmax "rate limiter" --all-projects --agent
+  gmax "auth middleware" --projects api,gateway --plain
 `)
     .action((pattern, exec_path, _options, cmd) => __awaiter(void 0, void 0, void 0, function* () {
-    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z;
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _0;
     const options = cmd.optsWithGlobals();
     const root = process.cwd();
     const minScore = Number.isFinite(Number.parseFloat(options.minScore))
@@ -401,10 +407,46 @@ Examples:
     const _searchStartMs = Date.now();
     let _searchResultCount = 0;
     let _searchError;
-    // Check for running server
+    // Cross-project scope (Phase 6): --all-projects / --projects / --exclude-projects.
+    // When active, single-project path scoping is dropped in favor of the
+    // project_roots filter clauses, and results are grouped by owning project.
+    const crossProject = (0, cross_project_1.resolveCrossProjectScope)({
+        allProjects: options.allProjects,
+        projects: options.projects,
+        excludeProjects: options.excludeProjects,
+    });
+    if (crossProject.active) {
+        // These modifiers are inherently single-project (one skeleton root, one
+        // call-graph center, one budget rollup). Reject the combination up front
+        // rather than emit confusing cross-root output.
+        const conflict = options.skeleton
+            ? "--skeleton"
+            : options.contextForLlm
+                ? "--context-for-llm"
+                : options.symbol
+                    ? "--symbol"
+                    : null;
+        if (conflict) {
+            console.error(`${conflict} is single-project; drop --all-projects/--projects or ${conflict}.`);
+            process.exitCode = 1;
+            return;
+        }
+        for (const w of crossProject.warnings)
+            console.warn(`Warning: ${w}`);
+        if (!crossProject.roots.length) {
+            console.error("No matching indexed projects. Run `gmax status` to list them.");
+            process.exitCode = 1;
+            return;
+        }
+    }
+    // Check for running server. The per-project HTTP server can't answer
+    // cross-project queries, so cross-project mode skips it and uses the
+    // daemon-mediated / in-process path (both query the shared table).
     const execPathForServer = exec_path ? path.resolve(exec_path) : root;
     const projectRootForServer = (_a = (0, project_root_1.findProjectRoot)(execPathForServer)) !== null && _a !== void 0 ? _a : execPathForServer;
-    const server = (0, server_registry_1.getServerForProject)(projectRootForServer);
+    const server = crossProject.active
+        ? null
+        : (0, server_registry_1.getServerForProject)(projectRootForServer);
     if (server) {
         try {
             const response = yield fetch(`http://localhost:${server.port}/search`, {
@@ -552,14 +594,22 @@ Examples:
             in: options.in,
             exclude: options.exclude,
         });
-        const pathFilter = options.in && options.in.length > 0
-            ? scope.pathPrefix
-            : exec_path
-                ? (() => {
-                    const p = path.resolve(exec_path);
-                    return p.endsWith("/") ? p : `${p}/`;
-                })()
-                : scope.pathPrefix;
+        // Cross-project mode drops the single-project path prefix (and any
+        // --in/[path] sub-scoping, which is meaningless across roots) in favor of
+        // the project_roots filter clauses computed below.
+        if (crossProject.active && (exec_path || ((_d = options.in) === null || _d === void 0 ? void 0 : _d.length))) {
+            console.warn("Warning: --in / [path] are single-project; ignored under --all-projects/--projects.");
+        }
+        const pathFilter = crossProject.active
+            ? undefined
+            : options.in && options.in.length > 0
+                ? scope.pathPrefix
+                : exec_path
+                    ? (() => {
+                        const p = path.resolve(exec_path);
+                        return p.endsWith("/") ? p : `${p}/`;
+                    })()
+                    : scope.pathPrefix;
         const searchFilters = {};
         if (options.file)
             searchFilters.file = options.file;
@@ -567,10 +617,19 @@ Examples:
             searchFilters.language = options.lang;
         if (options.role)
             searchFilters.role = options.role;
-        if (scope.inPrefixes.length > 0)
-            searchFilters.inPrefixes = scope.inPrefixes;
-        if (scope.excludePrefixes.length > 0)
-            searchFilters.excludePrefixes = scope.excludePrefixes;
+        if (crossProject.active) {
+            if (crossProject.projectRootsCsv)
+                searchFilters.project_roots = crossProject.projectRootsCsv;
+            if (crossProject.excludeProjectRootsCsv)
+                searchFilters.exclude_project_roots =
+                    crossProject.excludeProjectRootsCsv;
+        }
+        else {
+            if (scope.inPrefixes.length > 0)
+                searchFilters.inPrefixes = scope.inPrefixes;
+            if (scope.excludePrefixes.length > 0)
+                searchFilters.excludePrefixes = scope.excludePrefixes;
+        }
         // Aider-style seeding: --seed-file / --seed-symbol (repeatable, also
         // comma-separated) bias candidate generation toward the caller's working
         // context. Absent → undefined → inert.
@@ -621,7 +680,7 @@ Examples:
                         indexState = resp.indexState;
                     }
                     else if (process.env.GMAX_DEBUG === "1") {
-                        console.error(`[search] daemon path unavailable: ${(_d = resp.error) !== null && _d !== void 0 ? _d : "unknown"}`);
+                        console.error(`[search] daemon path unavailable: ${(_e = resp.error) !== null && _e !== void 0 ? _e : "unknown"}`);
                     }
                 }
             }
@@ -703,7 +762,7 @@ Examples:
                 }
             }
             // Ensure a watcher is running for live reindexing
-            if (!process.env.VITEST && !((_e = process.env.NODE_ENV) === null || _e === void 0 ? void 0 : _e.includes("test"))) {
+            if (!process.env.VITEST && !((_f = process.env.NODE_ENV) === null || _f === void 0 ? void 0 : _f.includes("test"))) {
                 const { launchWatcher } = yield Promise.resolve().then(() => __importStar(require("../lib/utils/watcher-launcher")));
                 const launched = yield launchWatcher(projectRoot);
                 if (!launched.ok && launched.reason === "spawn-failed") {
@@ -715,7 +774,7 @@ Examples:
                 ? searchFilters
                 : undefined, pathFilter);
         } // end if (!searchResult) — in-process fallback
-        if (!options.agent && ((_f = searchResult.warnings) === null || _f === void 0 ? void 0 : _f.length)) {
+        if (!options.agent && ((_g = searchResult.warnings) === null || _g === void 0 ? void 0 : _g.length)) {
             for (const w of searchResult.warnings) {
                 console.warn(`Warning: ${w}`);
             }
@@ -740,7 +799,7 @@ Examples:
                     return defs.some((d) => regex.test(d));
                 });
             }
-            catch (_0) {
+            catch (_1) {
                 // Invalid regex — skip
             }
         }
@@ -757,6 +816,76 @@ Examples:
         };
         // Agent mode: ultra-compact one-line-per-result output
         _searchResultCount = filteredData.length;
+        // Cross-project (Phase 6): render grouped by owning project so idioms
+        // from different stacks don't blur into one flat list. Only the
+        // string-formatter modes reach here — skeleton/context-for-llm/symbol
+        // were rejected up front.
+        if (crossProject.active) {
+            const emitFooter = () => {
+                const footer = (0, index_state_footer_1.formatIndexStateFooter)(indexState, {
+                    agent: !!options.agent,
+                });
+                if (footer) {
+                    if (options.agent)
+                        console.log(footer);
+                    else
+                        console.warn(footer);
+                }
+            };
+            if (!filteredData.length) {
+                console.log(options.agent ? "(none)" : "No matches found.");
+                process.exitCode = 1;
+                emitFooter();
+                return;
+            }
+            const getPath = (r) => {
+                var _a, _b, _c;
+                return String((_c = (_a = r.path) !== null && _a !== void 0 ? _a : (_b = r.metadata) === null || _b === void 0 ? void 0 : _b.path) !== null && _c !== void 0 ? _c : "");
+            };
+            const groups = (0, cross_project_1.groupResultsByProject)(filteredData, crossProject.roots, getPath);
+            const isTTY = process.stdout.isTTY;
+            const shouldBePlain = options.plain || !isTTY;
+            const blocks = [];
+            for (const g of groups) {
+                let body;
+                if (options.agent) {
+                    body = (0, agent_search_formatter_1.formatAgentSearchResults)(g.items, g.root, {
+                        includeImports: options.imports,
+                        getImportsForFile,
+                        explain: options.explain,
+                    });
+                }
+                else if (options.compact) {
+                    body = formatCompactTable(toCompactHits(g.items), g.root, pattern, {
+                        isTTY: !!isTTY,
+                        plain: !!options.plain,
+                    });
+                }
+                else if (shouldBePlain) {
+                    body = (0, formatter_1.formatTextResults)(toTextResults(g.items), pattern, g.root, {
+                        isPlain: true,
+                        compact: options.compact,
+                        content: options.content,
+                        perFile: parseInt(options.perFile, 10),
+                        showScores: options.scores,
+                    });
+                }
+                else {
+                    const { formatResults } = yield Promise.resolve().then(() => __importStar(require("../lib/output/formatter")));
+                    body = formatResults(g.items, g.root, {
+                        content: options.content,
+                        explain: options.explain,
+                    });
+                }
+                const header = options.agent
+                    ? `## ${g.name} (${g.items.length})`
+                    : `=== ${g.name} (${g.items.length}) ===`;
+                blocks.push(`${header}\n${body}`);
+            }
+            console.log(blocks.join("\n\n"));
+            emitFooter();
+            return;
+        }
         if (options.agent) {
             if (!filteredData.length) {
                 console.log("(none)");
@@ -798,7 +927,7 @@ Examples:
                         }
                     }
                 }
-                catch (_1) { }
+                catch (_2) { }
             }
             // Partial-index footer last, so it's the final line the agent reads —
             // and emitted even on "(none)", where an empty result may just mean the
@@ -836,9 +965,9 @@ Examples:
             let shown = 0;
             console.log(resultCountHeader(filteredData, parseInt(options.m, 10)));
             for (const r of filteredData) {
-                const absP = (_j = (_g = r.path) !== null && _g !== void 0 ? _g : (_h = r.metadata) === null || _h === void 0 ? void 0 : _h.path) !== null && _j !== void 0 ? _j : "";
-                const startLine = (_o = (_l = (_k = r.startLine) !== null && _k !== void 0 ? _k : r.start_line) !== null && _l !== void 0 ? _l : (_m = r.generated_metadata) === null || _m === void 0 ? void 0 : _m.start_line) !== null && _o !== void 0 ? _o : 0;
-                const endLine = (_s = (_q = (_p = r.endLine) !== null && _p !== void 0 ? _p : r.end_line) !== null && _q !== void 0 ? _q : (_r = r.generated_metadata) === null || _r === void 0 ? void 0 : _r.end_line) !== null && _s !== void 0 ? _s : startLine;
+                const absP = (_k = (_h = r.path) !== null && _h !== void 0 ? _h : (_j = r.metadata) === null || _j === void 0 ? void 0 : _j.path) !== null && _k !== void 0 ? _k : "";
+                const startLine = (_p = (_m = (_l = r.startLine) !== null && _l !== void 0 ? _l : r.start_line) !== null && _m !== void 0 ? _m : (_o = r.generated_metadata) === null || _o === void 0 ? void 0 : _o.start_line) !== null && _p !== void 0 ? _p : 0;
+                const endLine = (_t = (_r = (_q = r.endLine) !== null && _q !== void 0 ? _q : r.end_line) !== null && _r !== void 0 ? _r : (_s = r.generated_metadata) === null || _s === void 0 ? void 0 : _s.end_line) !== null && _t !== void 0 ? _t : startLine;
                 const relPath = absP.startsWith(projectRoot)
                     ? absP.slice(projectRoot.length + 1)
                     : absP;
@@ -871,7 +1000,7 @@ Examples:
                     tokensUsed += blobTokens;
                     shown++;
                 }
-                catch (_2) {
+                catch (_3) {
                     console.log(`\n--- ${relPath} (file not readable) ---`);
                     shown++;
                 }
@@ -888,7 +1017,7 @@ Examples:
         if (options.imports) {
             const seenFiles = new Set();
             for (const r of filteredData) {
-                const absP = (_v = (_t = r.path) !== null && _t !== void 0 ? _t : (_u = r.metadata) === null || _u === void 0 ? void 0 : _u.path) !== null && _v !== void 0 ? _v : "";
+                const absP = (_w = (_u = r.path) !== null && _u !== void 0 ? _u : (_v = r.metadata) === null || _v === void 0 ? void 0 : _v.path) !== null && _w !== void 0 ? _w : "";
                 if (absP && !seenFiles.has(absP)) {
                     seenFiles.add(absP);
                     const imports = getImportsForFile(absP);
@@ -915,7 +1044,7 @@ Examples:
                 for (const r of filteredData) {
                     const b = r.scoreBreakdown;
                     if (b) {
-                        const absP = (_y = (_w = r.path) !== null && _w !== void 0 ? _w : (_x = r.metadata) === null || _x === void 0 ? void 0 : _x.path) !== null && _y !== void 0 ? _y : "";
+                        const absP = (_z = (_x = r.path) !== null && _x !== void 0 ? _x : (_y = r.metadata) === null || _y === void 0 ? void 0 : _y.path) !== null && _z !== void 0 ? _z : "";
                         const relPath = absP.startsWith(projectRoot)
                             ? absP.slice(projectRoot.length + 1)
                             : absP;
@@ -977,7 +1106,7 @@ Examples:
                     console.log(lines.join("\n"));
                 }
             }
-            catch (_3) {
+            catch (_4) {
                 // Trace failed — skip silently
             }
         }
@@ -997,13 +1126,13 @@ Examples:
                 source: "cli",
                 tool: "search",
                 query: pattern,
-                project: (_z = (0, project_root_1.findProjectRoot)(root)) !== null && _z !== void 0 ? _z : root,
+                project: (_0 = (0, project_root_1.findProjectRoot)(root)) !== null && _0 !== void 0 ? _0 : root,
                 results: _searchResultCount,
                 ms: Date.now() - _searchStartMs,
                 error: _searchError,
             });
         }
-        catch (_4) { }
+        catch (_5) { }
         if (vectorDb) {
             try {
                 yield vectorDb.close();

package/dist/lib/utils/cross-project.js

@@ -0,0 +1,115 @@
+"use strict";
+/**
+ * Cross-project search scoping (Phase 6).
+ *
+ * The shared LanceDB table holds chunks from every indexed project, scoped by
+ * absolute-path prefix. Single-project search pins a `pathPrefix`; cross-project
+ * search drops the prefix and instead scopes with the `project_roots` /
+ * `exclude_project_roots` filter clauses (an OR-group of `path LIKE` prefixes —
+ * see buildWhereClause in searcher.ts). This module resolves the CLI flags
+ * (`--all-projects` / `--projects` / `--exclude-projects`) to those filter
+ * values and groups results back by owning project for display.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveCrossProjectScope = resolveCrossProjectScope;
+exports.projectForPath = projectForPath;
+exports.groupResultsByProject = groupResultsByProject;
+const project_registry_1 = require("./project-registry");
+function resolveCrossProjectScope(opts) {
+    const active = !!(opts.allProjects || opts.projects);
+    if (!active) {
+        return { active: false, roots: [], warnings: [] };
+    }
+    // Ignore "error"-status projects: the daemon won't search them anyway.
+    const all = (0, project_registry_1.listProjects)().filter((p) => p.status !== "error");
+    const byName = new Map(all.map((p) => [p.name, p]));
+    const warnings = [];
+    const resolveNames = (csv) => {
+        const names = (csv !== null && csv !== void 0 ? csv : "")
+            .split(",")
+            .map((s) => s.trim())
+            .filter(Boolean);
+        const found = [];
+        const missing = [];
+        for (const n of names) {
+            const p = byName.get(n);
+            if (p)
+                found.push(p);
+            else
+                missing.push(n);
+        }
+        return { found, missing };
+    };
+    const excluded = resolveNames(opts.excludeProjects);
+    const excludedRoots = new Set(excluded.found.map((p) => p.root));
+    if (excluded.missing.length) {
+        warnings.push(`Unknown --exclude-projects: ${excluded.missing.join(", ")}`);
+    }
+    let included;
+    let projectRootsCsv;
+    let excludeProjectRootsCsv;
+    if (opts.projects) {
+        const r = resolveNames(opts.projects);
+        if (r.missing.length) {
+            warnings.push(`Unknown --projects: ${r.missing.join(", ")}. Available: ${all
+                .map((p) => p.name)
+                .join(", ")}`);
+        }
+        included = r.found.filter((p) => !excludedRoots.has(p.root));
+        // Narrowed to an explicit subset → scope with project_roots.
+        projectRootsCsv = included.length
+            ? included.map((p) => p.root).join(",")
+            : undefined;
+    }
+    else {
+        // --all-projects: search the whole shared table. No project_roots clause
+        // (its absence IS "everything"); only carve out --exclude-projects.
+        included = all.filter((p) => !excludedRoots.has(p.root));
+        if (excludedRoots.size) {
+            excludeProjectRootsCsv = [...excludedRoots].join(",");
+        }
+    }
+    return {
+        active: true,
+        roots: included.map((p) => ({ root: p.root, name: p.name })),
+        projectRootsCsv,
+        excludeProjectRootsCsv,
+        warnings,
+    };
+}
+/** Longest-prefix match of an absolute path against the in-scope project roots. */
+function projectForPath(absPath, roots) {
+    let best = null;
+    let bestLen = -1;
+    for (const r of roots) {
+        const prefix = r.root.endsWith("/") ? r.root : `${r.root}/`;
+        if (absPath === r.root || absPath.startsWith(prefix)) {
+            if (prefix.length > bestLen) {
+                best = r;
+                bestLen = prefix.length;
+            }
+        }
+    }
+    return best;
+}
+/**
+ * Bucket ranked results by owning project, preserving rank order: groups appear
+ * in order of their best-ranked member, items keep their original order.
+ */
+function groupResultsByProject(results, roots, getPath) {
+    var _a, _b, _c;
+    const order = [];
+    const buckets = new Map();
+    for (const r of results) {
+        const owner = projectForPath(getPath(r), roots);
+        const key = (_a = owner === null || owner === void 0 ? void 0 : owner.root) !== null && _a !== void 0 ? _a : "(unknown)";
+        let bucket = buckets.get(key);
+        if (!bucket) {
+            bucket = { name: (_b = owner === null || owner === void 0 ? void 0 : owner.name) !== null && _b !== void 0 ? _b : "(unknown)", root: (_c = owner === null || owner === void 0 ? void 0 : owner.root) !== null && _c !== void 0 ? _c : "", items: [] };
+            buckets.set(key, bucket);
+            order.push(key);
+        }
+        bucket.items.push(r);
+    }
+    return order.map((k) => buckets.get(k));
+}

package/package.json

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