grepmax 0.7.21 → 0.7.23

package/README.md

@@ -100,12 +100,15 @@ In our public benchmarks, `grepmax` can save about 20% of your LLM tokens and de
 
 | Tool | Description |
 | --- | --- |
-| `semantic_search` | Code search by meaning. Returns pointers (symbol, file:line, role, calls, summary) by default. Use `root` for cross-directory search, `detail: "code"` for snippets. |
-| `search_all` | Search ALL indexed code across every directory. Same pointer format. |
-| `code_skeleton` | Collapsed file structure (~4x fewer tokens than reading the full file) |
-| `trace_calls` | Call graph — who calls a symbol and what it calls (unscoped, crosses project boundaries) |
-| `list_symbols` | List indexed functions, classes, and types with definition locations |
-| `index_status` | Check index health: chunk counts, indexed directories, model info |
+| `semantic_search` | Code search by meaning. 16 composable params: query, limit, root, path, detail (pointer/code/full), context_lines, min_score, max_per_file, file, exclude, language, role, mode (symbol), include_imports, name_pattern. |
+| `search_all` | Search ALL indexed code. Same params + `projects`/`exclude_projects` to scope by project name. |
+| `code_skeleton` | Collapsed file structure (~4x fewer tokens). Accepts files, directories, or comma-separated paths. `format: "json"` for structured output. |
+| `trace_calls` | Call graph with importers, callers (multi-hop via `depth`), and callees with file:line locations. |
+| `list_symbols` | List indexed symbols with role (ORCH/DEF/IMPL) and export status. |
+| `summarize_project` | High-level project overview — languages, directory structure, roles, key symbols, entry points. |
+| `related_files` | Find dependencies and dependents of a file by shared symbol references. |
+| `recent_changes` | Recently modified indexed files with relative timestamps. |
+| `index_status` | Check index health: per-project chunk counts, model info, watcher status. |
 | `summarize_directory` | Generate LLM summaries for indexed chunks. Summaries appear in search results. |
 
 ## Commands
@@ -125,8 +128,17 @@ gmax "how is the database connection pooled?"
 | `-m <n>` | Max total results to return. | `5` |
 | `--per-file <n>` | Max matches to show per file. | `3` |
 | `-c`, `--content` | Show full chunk content instead of snippets. | `false` |
+| `-C <n>`, `--context <n>` | Include N lines before/after each result. | `0` |
 | `--scores` | Show relevance scores (0-1) for each result. | `false` |
 | `--min-score <n>` | Filter out results below this score threshold. | `0` |
+| `--root <dir>` | Search a different project directory. | cwd |
+| `--file <name>` | Filter to files matching this name (e.g. `syncer.ts`). | — |
+| `--exclude <prefix>` | Exclude files under this path prefix (e.g. `tests/`). | — |
+| `--lang <ext>` | Filter by file extension (e.g. `ts`, `py`). | — |
+| `--role <role>` | Filter by role: `ORCHESTRATION`, `DEFINITION`, `IMPLEMENTATION`. | — |
+| `--symbol` | Append call graph (importers, callers, callees) after results. | `false` |
+| `--imports` | Prepend file imports to each result. | `false` |
+| `--name <regex>` | Filter results by symbol name regex. | — |
 | `--compact` | Compact hits view (paths + line ranges + role/preview). | `false` |
 | `--skeleton` | Show code skeleton for matching files instead of snippets. | `false` |
 | `--plain` | Disable ANSI colors and use simpler formatting. | `false` |
@@ -136,10 +148,11 @@ gmax "how is the database connection pooled?"
 
 ```bash
 gmax "API rate limiting logic"
-gmax "error handling" --per-file 5
-gmax "user validation" --compact
-gmax "authentication" --scores --min-score 0.5
-gmax "database connection" --skeleton
+gmax "auth handler" --role ORCHESTRATION --lang ts --plain
+gmax "database" --file syncer.ts --plain
+gmax "VectorDB" --symbol --plain
+gmax "error handling" -C 5 --imports
+gmax "handler" --name "handle.*" --exclude tests/
 ```
 
 ### `gmax index`
@@ -182,18 +195,57 @@ gmax serve --background           # Background mode
 gmax serve --cpu                  # Force CPU-only embeddings
 ```
 
+### `gmax trace`
+
+Call graph — who imports a symbol, who calls it, and what it calls.
+
+```bash
+gmax trace handleAuth             # 1-hop trace
+gmax trace handleAuth -d 2        # 2-hop: callers-of-callers
+```
+
 ### `gmax skeleton`
 
-Compressed view of a file — signatures with bodies collapsed.
+Compressed view of a file — signatures with bodies collapsed. Supports files, directories, and batch.
 
 ```bash
-gmax skeleton src/lib/auth.ts
-gmax skeleton AuthService         # Find symbol, skeletonize its file
-gmax skeleton "auth logic"        # Search, skeletonize top matches
+gmax skeleton src/lib/auth.ts             # Single file
+gmax skeleton src/lib/search/             # All files in directory
+gmax skeleton src/a.ts,src/b.ts           # Batch
+gmax skeleton src/lib/auth.ts --json      # Structured JSON output
+gmax skeleton AuthService                 # Find symbol, skeletonize its file
 ```
 
 **Supported Languages:** TypeScript, JavaScript, Python, Go, Rust, Java, C#, C++, C, Ruby, PHP, Swift, Kotlin.
 
+### `gmax project`
+
+High-level project overview — languages, directory structure, role distribution, key symbols, entry points.
+
+```bash
+gmax project                     # Current project
+gmax project --root ~/workspace  # Different project
+```
+
+### `gmax related`
+
+Find files related by shared symbol references — dependencies and dependents.
+
+```bash
+gmax related src/lib/index/syncer.ts
+gmax related src/commands/mcp.ts -l 5
+```
+
+### `gmax recent`
+
+Show recently modified indexed files with relative timestamps.
+
+```bash
+gmax recent                      # Last 20 modified files
+gmax recent -l 10                # Last 10
+gmax recent --root ~/workspace   # Different project
+```
+
 ### `gmax config`
 
 View or update configuration without the full interactive setup.

package/dist/commands/project.js

@@ -0,0 +1,175 @@
+"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.project = void 0;
+const path = __importStar(require("node:path"));
+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");
+function toArr(val) {
+    if (val && typeof val.toArray === "function") {
+        return val.toArray();
+    }
+    return Array.isArray(val) ? val : [];
+}
+exports.project = new commander_1.Command("project")
+    .description("Show project overview — languages, structure, key symbols")
+    .option("--root <dir>", "Project root (defaults to current directory)")
+    .action((opts) => __awaiter(void 0, void 0, void 0, function* () {
+    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 prefix = root.endsWith("/") ? root : `${root}/`;
+        const projectName = path.basename(root);
+        const paths = (0, project_root_1.ensureProjectPaths)(root);
+        vectorDb = new vector_db_1.VectorDB(paths.lancedbDir);
+        const table = yield vectorDb.ensureTable();
+        const rows = yield table
+            .query()
+            .select([
+            "path",
+            "role",
+            "is_exported",
+            "complexity",
+            "defined_symbols",
+            "referenced_symbols",
+        ])
+            .where(`path LIKE '${(0, filter_builder_1.escapeSqlString)(prefix)}%'`)
+            .limit(200000)
+            .toArray();
+        if (rows.length === 0) {
+            console.log(`No indexed data found for ${root}. Run: gmax index --path ${root}`);
+            return;
+        }
+        const files = new Set();
+        const extCounts = new Map();
+        const dirCounts = new Map();
+        const roleCounts = new Map();
+        const symbolRefs = new Map();
+        const entryPoints = [];
+        for (const row of rows) {
+            const p = String(row.path || "");
+            const role = String(row.role || "IMPLEMENTATION");
+            const exported = Boolean(row.is_exported);
+            const complexity = Number(row.complexity || 0);
+            const defs = toArr(row.defined_symbols);
+            const refs = toArr(row.referenced_symbols);
+            files.add(p);
+            const ext = path.extname(p).toLowerCase() || path.basename(p);
+            extCounts.set(ext, (extCounts.get(ext) || 0) + 1);
+            const rel = p.startsWith(prefix) ? p.slice(prefix.length) : p;
+            const parts = rel.split("/");
+            const dir = parts.length > 2
+                ? `${parts.slice(0, 2).join("/")}/`
+                : parts.length > 1
+                    ? `${parts[0]}/`
+                    : "(root)";
+            if (!dirCounts.has(dir))
+                dirCounts.set(dir, { files: new Set(), chunks: 0 });
+            const dc = dirCounts.get(dir);
+            dc.files.add(p);
+            dc.chunks++;
+            roleCounts.set(role, (roleCounts.get(role) || 0) + 1);
+            for (const ref of refs)
+                symbolRefs.set(ref, (symbolRefs.get(ref) || 0) + 1);
+            if (exported && role === "ORCHESTRATION" && complexity >= 5 && defs.length > 0) {
+                entryPoints.push({
+                    symbol: defs[0],
+                    path: p.startsWith(prefix) ? p.slice(prefix.length) : p,
+                });
+            }
+        }
+        const projects = (0, project_registry_1.listProjects)();
+        const proj = projects.find((p) => p.root === root);
+        console.log(`Project: ${projectName} (${root})`);
+        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`);
+        const extEntries = Array.from(extCounts.entries())
+            .sort((a, b) => b[1] - a[1])
+            .slice(0, 8);
+        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())
+            .sort((a, b) => b[1].chunks - a[1].chunks)
+            .slice(0, 12)) {
+            console.log(`  ${dir.padEnd(25)} (${data.files.size} files, ${data.chunks} chunks)`);
+        }
+        const roleEntries = Array.from(roleCounts.entries()).sort((a, b) => b[1] - a[1]);
+        console.log(`\nRoles: ${roleEntries.map(([r, c]) => `${Math.round((c / rows.length) * 100)}% ${r}`).join(", ")}\n`);
+        const topSymbols = Array.from(symbolRefs.entries())
+            .sort((a, b) => b[1] - a[1])
+            .slice(0, 8);
+        if (topSymbols.length > 0) {
+            console.log("Key symbols (by reference count):");
+            for (const [sym, count] of topSymbols) {
+                console.log(`  ${sym.padEnd(25)} (referenced ${count}x)`);
+            }
+        }
+        if (entryPoints.length > 0) {
+            console.log("\nEntry points (exported orchestration):");
+            for (const ep of entryPoints.slice(0, 10)) {
+                console.log(`  ${ep.symbol.padEnd(25)} ${ep.path}`);
+            }
+        }
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : "Unknown error";
+        console.error("Project summary failed:", msg);
+        process.exitCode = 1;
+    }
+    finally {
+        if (vectorDb) {
+            try {
+                yield vectorDb.close();
+            }
+            catch (_d) { }
+        }
+        yield (0, exit_1.gracefulExit)();
+    }
+}));

package/dist/commands/recent.js

@@ -0,0 +1,131 @@
+"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 project_root_1 = require("../lib/utils/project-root");
+function formatTimeAgo(ms) {
+    const sec = Math.floor(ms / 1000);
+    if (sec < 60)
+        return `${sec}s ago`;
+    const min = Math.floor(sec / 60);
+    if (min < 60)
+        return `${min}m ago`;
+    const hr = Math.floor(min / 60);
+    if (hr < 24)
+        return `${hr}h ago`;
+    const days = Math.floor(hr / 24);
+    return `${days}d ago`;
+}
+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)")
+    .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}`);
+                return;
+            }
+            const now = Date.now();
+            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 = 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)();
+}));

package/dist/commands/related.js

@@ -0,0 +1,170 @@
+"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.related = void 0;
+const path = __importStar(require("node:path"));
+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_root_1 = require("../lib/utils/project-root");
+function toArr(val) {
+    if (val && typeof val.toArray === "function") {
+        return val.toArray();
+    }
+    return Array.isArray(val) ? val : [];
+}
+exports.related = new commander_1.Command("related")
+    .description("Find files related by shared symbol references")
+    .argument("<file>", "File path relative to project root")
+    .option("-l, --limit <n>", "Max results per direction (default 10)", "10")
+    .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 projectRoot = (_a = (0, project_root_1.findProjectRoot)(process.cwd())) !== null && _a !== void 0 ? _a : process.cwd();
+        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 fileChunks = yield table
+            .query()
+            .select(["defined_symbols", "referenced_symbols"])
+            .where(`path = '${(0, filter_builder_1.escapeSqlString)(absPath)}'`)
+            .toArray();
+        if (fileChunks.length === 0) {
+            console.log(`File not found in index: ${file}`);
+            return;
+        }
+        const definedHere = new Set();
+        const referencedHere = new Set();
+        for (const chunk of fileChunks) {
+            for (const s of toArr(chunk.defined_symbols))
+                definedHere.add(s);
+            for (const s of toArr(chunk.referenced_symbols))
+                referencedHere.add(s);
+        }
+        // Dependencies
+        const depCounts = new Map();
+        for (const sym of referencedHere) {
+            if (definedHere.has(sym))
+                continue;
+            const rows = yield table
+                .query()
+                .select(["path"])
+                .where(`array_contains(defined_symbols, '${(0, filter_builder_1.escapeSqlString)(sym)}')`)
+                .limit(3)
+                .toArray();
+            for (const row of rows) {
+                const p = String(row.path || "");
+                if (p === absPath)
+                    continue;
+                depCounts.set(p, (depCounts.get(p) || 0) + 1);
+            }
+        }
+        // Dependents
+        const revCounts = new Map();
+        for (const sym of definedHere) {
+            const rows = yield table
+                .query()
+                .select(["path"])
+                .where(`array_contains(referenced_symbols, '${(0, filter_builder_1.escapeSqlString)(sym)}')`)
+                .limit(20)
+                .toArray();
+            for (const row of rows) {
+                const p = String(row.path || "");
+                if (p === absPath)
+                    continue;
+                revCounts.set(p, (revCounts.get(p) || 0) + 1);
+            }
+        }
+        console.log(`Related files for ${file}:\n`);
+        const topDeps = Array.from(depCounts.entries())
+            .sort((a, b) => b[1] - a[1])
+            .slice(0, limit);
+        if (topDeps.length > 0) {
+            console.log("Dependencies (files this imports/calls):");
+            for (const [p, count] of topDeps) {
+                const rel = p.startsWith(`${projectRoot}/`)
+                    ? p.slice(projectRoot.length + 1)
+                    : p;
+                console.log(`  ${rel.padEnd(40)} (${count} shared symbol${count > 1 ? "s" : ""})`);
+            }
+        }
+        else {
+            console.log("Dependencies: none found");
+        }
+        console.log("");
+        const topRevs = Array.from(revCounts.entries())
+            .sort((a, b) => b[1] - a[1])
+            .slice(0, limit);
+        if (topRevs.length > 0) {
+            console.log("Dependents (files that call this):");
+            for (const [p, count] of topRevs) {
+                const rel = p.startsWith(`${projectRoot}/`)
+                    ? p.slice(projectRoot.length + 1)
+                    : p;
+                console.log(`  ${rel.padEnd(40)} (${count} shared symbol${count > 1 ? "s" : ""})`);
+            }
+        }
+        else {
+            console.log("Dependents: none found");
+        }
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : "Unknown error";
+        console.error("Related files failed:", msg);
+        process.exitCode = 1;
+    }
+    finally {
+        if (vectorDb) {
+            try {
+                yield vectorDb.close();
+            }
+            catch (_b) { }
+        }
+        yield (0, exit_1.gracefulExit)();
+    }
+}));

package/dist/index.js

@@ -45,6 +45,9 @@ const droid_1 = require("./commands/droid");
 const index_1 = require("./commands/index");
 const list_1 = require("./commands/list");
 const mcp_1 = require("./commands/mcp");
+const project_1 = require("./commands/project");
+const recent_1 = require("./commands/recent");
+const related_1 = require("./commands/related");
 const opencode_1 = require("./commands/opencode");
 const search_1 = require("./commands/search");
 const serve_1 = require("./commands/serve");
@@ -77,6 +80,9 @@ commander_1.program.addCommand(list_1.list);
 commander_1.program.addCommand(skeleton_1.skeleton);
 commander_1.program.addCommand(symbols_1.symbols);
 commander_1.program.addCommand(trace_1.trace);
+commander_1.program.addCommand(project_1.project);
+commander_1.program.addCommand(related_1.related);
+commander_1.program.addCommand(recent_1.recent);
 // Services
 commander_1.program.addCommand(serve_1.serve);
 commander_1.program.addCommand(watch_1.watch);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "grepmax",
-  "version": "0.7.21",
+  "version": "0.7.23",
   "author": "Robert Owens <robowens@me.com>",
   "homepage": "https://github.com/reowens/grepmax",
   "bugs": {

package/plugins/grepmax/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "grepmax",
-  "version": "0.7.21",
+  "version": "0.7.23",
   "description": "Semantic code search for Claude Code. Automatically indexes your project and provides intelligent search capabilities.",
   "author": {
     "name": "Robert Owens",