grepmax 0.7.20 → 0.7.22

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/commands/skeleton.js

@@ -61,6 +61,7 @@ const setup_helpers_1 = require("../lib/setup/setup-helpers");
 const retriever_1 = require("../lib/skeleton/retriever");
 const skeletonizer_1 = require("../lib/skeleton/skeletonizer");
 const vector_db_1 = require("../lib/store/vector-db");
+const file_utils_1 = require("../lib/utils/file-utils");
 const exit_1 = require("../lib/utils/exit");
 const project_root_1 = require("../lib/utils/project-root");
 /**
@@ -140,6 +141,48 @@ Examples:
             includeSummary: !options.noSummary,
         };
         // Determine mode based on target
+        const resolvedTarget = path.resolve(target);
+        // Directory mode
+        if (fs.existsSync(resolvedTarget) &&
+            fs.statSync(resolvedTarget).isDirectory()) {
+            const entries = fs.readdirSync(resolvedTarget, {
+                withFileTypes: true,
+            });
+            const files = entries
+                .filter((e) => e.isFile() &&
+                (0, file_utils_1.isIndexableFile)(path.join(resolvedTarget, e.name)))
+                .map((e) => path.join(resolvedTarget, e.name))
+                .slice(0, Number.parseInt(options.limit, 10));
+            if (files.length === 0) {
+                console.error(`No indexable files in ${target}`);
+                process.exitCode = 1;
+                return;
+            }
+            for (const filePath of files) {
+                const content = fs.readFileSync(filePath, "utf-8");
+                const result = yield skeletonizer.skeletonizeFile(filePath, content, skeletonOpts);
+                outputResult(result, options);
+            }
+            return;
+        }
+        // Batch mode (comma-separated)
+        if (target.includes(",")) {
+            const targets = target
+                .split(",")
+                .map((t) => t.trim())
+                .filter(Boolean);
+            for (const t of targets) {
+                const filePath = path.resolve(t);
+                if (!fs.existsSync(filePath)) {
+                    console.error(`Not found: ${t}`);
+                    continue;
+                }
+                const content = fs.readFileSync(filePath, "utf-8");
+                const result = yield skeletonizer.skeletonizeFile(filePath, content, skeletonOpts);
+                outputResult(result, options);
+            }
+            return;
+        }
         if (isFilePath(target)) {
             // === FILE MODE ===
             const filePath = path.resolve(target);

package/dist/commands/trace.js

@@ -19,8 +19,10 @@ const project_root_1 = require("../lib/utils/project-root");
 exports.trace = new commander_1.Command("trace")
     .description("Trace the call graph for a symbol")
     .argument("<symbol>", "The symbol to trace")
-    .action((symbol) => __awaiter(void 0, void 0, void 0, function* () {
+    .option("-d, --depth <n>", "Caller traversal depth (default 1, max 3)", "1")
+    .action((symbol, 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);
     const root = process.cwd();
     let vectorDb = null;
     try {
@@ -28,7 +30,7 @@ exports.trace = new commander_1.Command("trace")
         const paths = (0, project_root_1.ensureProjectPaths)(projectRoot);
         vectorDb = new vector_db_1.VectorDB(paths.lancedbDir);
         const graphBuilder = new graph_builder_1.GraphBuilder(vectorDb);
-        const graph = yield graphBuilder.buildGraph(symbol);
+        const graph = yield graphBuilder.buildGraphMultiHop(symbol, depth);
         console.log((0, formatter_1.formatTrace)(graph));
     }
     catch (error) {

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/dist/lib/output/formatter.js

@@ -130,24 +130,40 @@ function formatTrace(graph) {
         return style.dim("Symbol not found.");
     }
     const lines = [];
-    // 1. Callers (Upstream)
-    if (graph.callers.length > 0) {
+    // 1. Importers
+    if (graph.importers.length > 0) {
+        const filtered = graph.importers.filter((p) => p !== graph.center.file);
+        if (filtered.length > 0) {
+            lines.push(style.bold("Imported by:"));
+            for (const imp of filtered.slice(0, 10)) {
+                lines.push(`  ${style.dim(imp)}`);
+            }
+            lines.push("");
+        }
+    }
+    // 2. Callers (Upstream, recursive tree)
+    function renderCallerTree(trees, depth) {
+        for (const t of trees) {
+            const pad = "  ".repeat(depth);
+            lines.push(`${pad}${style.blue("↑")} ${style.green(t.node.symbol)} ${style.dim(`(${t.node.file}:${t.node.line})`)}`);
+            renderCallerTree(t.callers, depth + 1);
+        }
+    }
+    if (graph.callerTree.length > 0) {
         lines.push(style.bold("Callers (Who calls this?):"));
-        graph.callers.forEach((caller) => {
-            lines.push(`  ${style.blue("↑")} ${style.green(caller.symbol)} ${style.dim(`(${caller.file}:${caller.line})`)}`);
-        });
+        renderCallerTree(graph.callerTree, 1);
         lines.push("");
     }
     else {
         lines.push(style.dim("No known callers."));
         lines.push("");
     }
-    // 2. Center (The Symbol)
+    // 3. Center (The Symbol)
     lines.push(style.bold(`▶ ${graph.center.symbol}`));
     lines.push(`  ${style.dim(`Defined in ${graph.center.file}:${graph.center.line}`)}`);
     lines.push(`  ${style.dim(`Role: ${graph.center.role}`)}`);
     lines.push("");
-    // 3. Callees (Downstream)
+    // 4. Callees (Downstream)
     if (graph.callees.length > 0) {
         lines.push(style.bold("Callees (What does this call?):"));
         graph.callees.forEach((callee) => {

package/package.json

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