grepmax 0.15.6 → 0.16.1

package/dist/commands/extract.js

@@ -50,6 +50,7 @@ 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_root_1 = require("../lib/utils/project-root");
 const useColors = process.stdout.isTTY && !process.env.NO_COLOR;
 const style = {
@@ -128,6 +129,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/peek.js

@@ -50,6 +50,7 @@ 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_root_1 = require("../lib/utils/project-root");
 const useColors = process.stdout.isTTY && !process.env.NO_COLOR;
 const style = {
@@ -104,6 +105,41 @@ exports.peek = new commander_1.Command("peek")
         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);
+        // Cross-language disambiguation: when the symbol is defined in 2+
+        // languages, refuse to silently pick one. The graph builder otherwise
+        // picks one chunk arbitrarily and lists callers from a different
+        // language — verified failure mode.
+        {
+            const tableForCheck = yield vectorDb.ensureTable();
+            const prefixForCheck = projectRoot.endsWith("/")
+                ? projectRoot
+                : `${projectRoot}/`;
+            const allDefs = yield tableForCheck
+                .query()
+                .select(["path", "start_line"])
+                .where(`array_contains(defined_symbols, '${(0, filter_builder_1.escapeSqlString)(symbol)}') AND path LIKE '${(0, filter_builder_1.escapeSqlString)(prefixForCheck)}%'`)
+                .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, projectRoot);
         const graph = yield graphBuilder.buildGraph(symbol);
         if (!graph.center) {

package/dist/commands/remove.js

@@ -43,6 +43,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.remove = void 0;
+const fs = __importStar(require("node:fs"));
 const path = __importStar(require("node:path"));
 const readline = __importStar(require("node:readline"));
 const commander_1 = require("commander");
@@ -68,12 +69,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 +83,41 @@ 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 resolvedDir = dir;
+        if (dir &&
+            !dir.includes("/") &&
+            !dir.includes("\\") &&
+            !fs.existsSync(path.resolve(dir))) {
+            const matches = (0, project_registry_1.listProjects)().filter((p) => p.name === dir);
+            if (matches.length === 0) {
+                console.error(`No registered project named "${dir}".`);
+                const all = (0, project_registry_1.listProjects)();
+                if (all.length > 0) {
+                    console.error("Available projects:");
+                    for (const p of all) {
+                        console.error(`  ${p.name.padEnd(24)} ${p.root}`);
+                    }
+                }
+                else {
+                    console.error("No projects are currently registered.");
+                }
+                process.exitCode = 1;
+                return;
+            }
+            if (matches.length > 1) {
+                console.error(`Multiple registered projects named "${dir}":`);
+                for (const p of matches) {
+                    console.error(`  ${p.root}`);
+                }
+                console.error("Pass an absolute path to disambiguate.");
+                process.exitCode = 1;
+                return;
+            }
+            resolvedDir = matches[0].root;
+        }
+        const targetDir = resolvedDir ? path.resolve(resolvedDir) : 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/search.js

@@ -256,9 +256,9 @@ function formatCompactTable(hits, projectRoot, query, opts) {
 }
 // Reuse Skeletonizer instance
 let globalSkeletonizer = null;
-function outputSkeletons(results, projectRoot, limit, db) {
+function outputSkeletons(results, projectRoot, limit, db, precomputed) {
     return __awaiter(this, void 0, void 0, function* () {
-        var _a;
+        var _a, _b;
         const seenPaths = new Set();
         const filesToProcess = [];
         for (const result of results) {
@@ -288,6 +288,16 @@ function outputSkeletons(results, projectRoot, limit, db) {
             const absPath = path.isAbsolute(filePath)
                 ? filePath
                 : path.resolve(projectRoot, filePath);
+            // 0. Daemon-supplied (preferred — already-warm DB lookup, no cold open)
+            const fromDaemon = (_b = precomputed === null || precomputed === void 0 ? void 0 : precomputed[absPath]) !== null && _b !== void 0 ? _b : precomputed === null || precomputed === void 0 ? void 0 : precomputed[filePath];
+            if (fromDaemon) {
+                skeletonResults.push({
+                    file: filePath,
+                    skeleton: fromDaemon,
+                    tokens: Math.ceil(fromDaemon.length / 4),
+                });
+                continue;
+            }
             // 1. Try DB cache
             if (db) {
                 const cached = yield (0, retriever_1.getStoredSkeleton)(db, absPath);
@@ -378,7 +388,7 @@ Examples:
   gmax "handler" --name "handle.*" --exclude tests/
 `)
     .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, _0, _1, _2, _3, _4, _5, _6, _7, _8, _9;
+    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, _1, _2, _3, _4, _5, _6, _7, _8, _9, _10;
     const options = cmd.optsWithGlobals();
     const root = process.cwd();
     const minScore = Number.isFinite(Number.parseFloat(options.minScore))
@@ -498,79 +508,10 @@ Examples:
         if (project.status === "pending") {
             console.warn("This project is still being indexed. Results may be incomplete.\n");
         }
-        vectorDb = new vector_db_1.VectorDB(paths.lancedbDir);
-        // Check for active indexing lock and warn if present
-        if (!options.agent && (0, lock_1.isLocked)(paths.dataDir)) {
-            console.warn("⚠️  Warning: Indexing in progress... search results may be incomplete.");
-        }
-        const hasRows = yield vectorDb.hasAnyRows();
-        const needsSync = options.sync || !hasRows;
-        if (needsSync) {
-            const isTTY = process.stdout.isTTY;
-            let abortController;
-            let signal;
-            if (!isTTY) {
-                abortController = new AbortController();
-                signal = abortController.signal;
-                setTimeout(() => {
-                    abortController === null || abortController === void 0 ? void 0 : abortController.abort();
-                }, 60000); // 60 seconds timeout for non-TTY auto-indexing
-            }
-            const { spinner, onProgress } = (0, sync_helpers_1.createIndexingSpinner)(projectRoot, options.sync ? "Indexing..." : "Indexing repository (first run)...");
-            try {
-                yield (0, grammar_loader_1.ensureGrammars)(console.log, { silent: true });
-                const result = yield (0, syncer_1.initialSync)({
-                    projectRoot,
-                    dryRun: options.dryRun,
-                    onProgress,
-                    signal,
-                });
-                if (signal === null || signal === void 0 ? void 0 : signal.aborted) {
-                    spinner.warn(`Indexing timed out (${result.processed}/${result.total}). Results may be partial.`);
-                }
-                if (options.dryRun) {
-                    spinner.succeed(`Dry run complete (${result.processed}/${result.total}) • would have indexed ${result.indexed}`);
-                    console.log((0, sync_helpers_1.formatDryRunSummary)(result, {
-                        actionDescription: "would have indexed",
-                        includeTotal: true,
-                    }));
-                    return;
-                }
-                yield vectorDb.createFTSIndex();
-                // Update registry after sync
-                const { readGlobalConfig } = yield Promise.resolve().then(() => __importStar(require("../lib/index/index-config")));
-                const { registerProject } = yield Promise.resolve().then(() => __importStar(require("../lib/utils/project-registry")));
-                const gc = readGlobalConfig();
-                registerProject({
-                    root: projectRoot,
-                    name: path.basename(projectRoot),
-                    vectorDim: gc.vectorDim,
-                    modelTier: gc.modelTier,
-                    embedMode: gc.embedMode,
-                    lastIndexed: new Date().toISOString(),
-                    chunkCount: result.indexed,
-                    status: "indexed",
-                });
-                const failedSuffix = result.failedFiles > 0 ? ` • ${result.failedFiles} failed` : "";
-                spinner.succeed(`${options.sync ? "Indexing" : "Initial indexing"} complete (${result.processed}/${result.total}) • indexed ${result.indexed}${failedSuffix}`);
-            }
-            catch (e) {
-                spinner.fail("Indexing failed");
-                throw e;
-            }
-        }
-        // Ensure a watcher is running for live reindexing
-        if (!process.env.VITEST && !((_d = process.env.NODE_ENV) === null || _d === void 0 ? void 0 : _d.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") {
-                console.warn(`[search] ${launched.message}`);
-            }
-        }
-        const searcher = new searcher_1.Searcher(vectorDb);
-        // Use --root or fall back to project root
+        // Compute effective paths + filters early — both the daemon-mediated
+        // and in-process search paths need them.
         const effectiveRoot = options.root
-            ? (_e = (0, project_root_1.findProjectRoot)(path.resolve(options.root))) !== null && _e !== void 0 ? _e : path.resolve(options.root)
+            ? (_d = (0, project_root_1.findProjectRoot)(path.resolve(options.root))) !== null && _d !== void 0 ? _d : path.resolve(options.root)
             : projectRoot;
         const searchPathPrefix = exec_path
             ? path.resolve(exec_path)
@@ -578,7 +519,6 @@ Examples:
         const pathFilter = searchPathPrefix.endsWith("/")
             ? searchPathPrefix
             : `${searchPathPrefix}/`;
-        // Build filters from CLI options
         const searchFilters = {};
         if (options.file)
             searchFilters.file = options.file;
@@ -588,8 +528,126 @@ Examples:
             searchFilters.language = options.lang;
         if (options.role)
             searchFilters.role = options.role;
-        const searchResult = yield searcher.search(pattern, parseInt(options.m, 10), { rerank: true, explain: options.explain }, Object.keys(searchFilters).length > 0 ? searchFilters : undefined, pathFilter);
-        if (!options.agent && ((_f = searchResult.warnings) === null || _f === void 0 ? void 0 : _f.length)) {
+        // Daemon-mediated search: ships query+args over IPC, daemon runs the
+        // hybrid+rerank against its already-warm VectorDB and worker pool.
+        // Drops cold-start cost (~17s wall, 6GB RAM in the CLI) to <1s. Falls
+        // back to in-process on any failure.
+        let searchResult = null;
+        let precomputedSkeletons;
+        let precomputedGraph;
+        if (!options.sync && !options.dryRun) {
+            try {
+                const { isDaemonRunning, sendDaemonCommand } = yield Promise.resolve().then(() => __importStar(require("../lib/utils/daemon-client")));
+                if (yield isDaemonRunning()) {
+                    const resp = yield sendDaemonCommand({
+                        cmd: "search",
+                        projectRoot: effectiveRoot,
+                        query: pattern,
+                        limit: parseInt(options.m, 10),
+                        filters: Object.keys(searchFilters).length > 0
+                            ? searchFilters
+                            : undefined,
+                        pathPrefix: pathFilter,
+                        rerank: true,
+                        explain: options.explain,
+                        includeSkeletons: options.skeleton,
+                        includeGraph: options.symbol,
+                    }, { timeoutMs: 60000 });
+                    if (resp.ok) {
+                        searchResult = {
+                            data: resp.data,
+                            warnings: resp.warnings,
+                        };
+                        precomputedSkeletons = resp.skeletons;
+                        precomputedGraph = resp.graph;
+                    }
+                    else if (process.env.GMAX_DEBUG === "1") {
+                        console.error(`[search] daemon path unavailable: ${(_e = resp.error) !== null && _e !== void 0 ? _e : "unknown"}`);
+                    }
+                }
+            }
+            catch (err) {
+                if (process.env.GMAX_DEBUG === "1") {
+                    console.error("[search] daemon attempt threw:", err);
+                }
+            }
+        }
+        // In-process fallback: open VectorDB, ensure index, run Searcher.
+        // Only entered when the daemon path didn't produce results.
+        if (!searchResult) {
+            vectorDb = new vector_db_1.VectorDB(paths.lancedbDir);
+            // Check for active indexing lock and warn if present
+            if (!options.agent && (0, lock_1.isLocked)(paths.dataDir)) {
+                console.warn("⚠️  Warning: Indexing in progress... search results may be incomplete.");
+            }
+            const hasRows = yield vectorDb.hasAnyRows();
+            const needsSync = options.sync || !hasRows;
+            if (needsSync) {
+                const isTTY = process.stdout.isTTY;
+                let abortController;
+                let signal;
+                if (!isTTY) {
+                    abortController = new AbortController();
+                    signal = abortController.signal;
+                    setTimeout(() => {
+                        abortController === null || abortController === void 0 ? void 0 : abortController.abort();
+                    }, 60000); // 60 seconds timeout for non-TTY auto-indexing
+                }
+                const { spinner, onProgress } = (0, sync_helpers_1.createIndexingSpinner)(projectRoot, options.sync ? "Indexing..." : "Indexing repository (first run)...");
+                try {
+                    yield (0, grammar_loader_1.ensureGrammars)(console.log, { silent: true });
+                    const result = yield (0, syncer_1.initialSync)({
+                        projectRoot,
+                        dryRun: options.dryRun,
+                        onProgress,
+                        signal,
+                    });
+                    if (signal === null || signal === void 0 ? void 0 : signal.aborted) {
+                        spinner.warn(`Indexing timed out (${result.processed}/${result.total}). Results may be partial.`);
+                    }
+                    if (options.dryRun) {
+                        spinner.succeed(`Dry run complete (${result.processed}/${result.total}) • would have indexed ${result.indexed}`);
+                        console.log((0, sync_helpers_1.formatDryRunSummary)(result, {
+                            actionDescription: "would have indexed",
+                            includeTotal: true,
+                        }));
+                        return;
+                    }
+                    yield vectorDb.createFTSIndex();
+                    // Update registry after sync
+                    const { readGlobalConfig } = yield Promise.resolve().then(() => __importStar(require("../lib/index/index-config")));
+                    const { registerProject } = yield Promise.resolve().then(() => __importStar(require("../lib/utils/project-registry")));
+                    const gc = readGlobalConfig();
+                    registerProject({
+                        root: projectRoot,
+                        name: path.basename(projectRoot),
+                        vectorDim: gc.vectorDim,
+                        modelTier: gc.modelTier,
+                        embedMode: gc.embedMode,
+                        lastIndexed: new Date().toISOString(),
+                        chunkCount: result.indexed,
+                        status: "indexed",
+                    });
+                    const failedSuffix = result.failedFiles > 0 ? ` • ${result.failedFiles} failed` : "";
+                    spinner.succeed(`${options.sync ? "Indexing" : "Initial indexing"} complete (${result.processed}/${result.total}) • indexed ${result.indexed}${failedSuffix}`);
+                }
+                catch (e) {
+                    spinner.fail("Indexing failed");
+                    throw e;
+                }
+            }
+            // Ensure a watcher is running for live reindexing
+            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") {
+                    console.warn(`[search] ${launched.message}`);
+                }
+            }
+            const searcher = new searcher_1.Searcher(vectorDb);
+            searchResult = yield searcher.search(pattern, parseInt(options.m, 10), { rerank: true, explain: options.explain }, Object.keys(searchFilters).length > 0 ? searchFilters : undefined, pathFilter);
+        } // end if (!searchResult) — in-process fallback
+        if (!options.agent && ((_g = searchResult.warnings) === null || _g === void 0 ? void 0 : _g.length)) {
             for (const w of searchResult.warnings) {
                 console.warn(`Warning: ${w}`);
             }
@@ -606,7 +664,7 @@ Examples:
                     return defs.some((d) => regex.test(d));
                 });
             }
-            catch (_10) {
+            catch (_11) {
                 // Invalid regex — skip
             }
         }
@@ -632,16 +690,16 @@ Examples:
                 // In agent mode, print imports header per file
                 const seenImportFiles = new Set();
                 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 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 relPath = absP.startsWith(effectiveRoot)
                         ? absP.slice(effectiveRoot.length + 1)
                         : absP;
-                    const startLine = Math.max(1, ((_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) + 1);
+                    const startLine = Math.max(1, ((_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) + 1);
                     const defs = Array.isArray(r.defined_symbols)
                         ? r.defined_symbols
                         : [];
                     const symbol = defs[0] || "";
-                    const role = ((_p = r.role) !== null && _p !== void 0 ? _p : "")
+                    const role = ((_q = r.role) !== null && _q !== void 0 ? _q : "")
                         .slice(0, 4)
                         .toUpperCase();
                     let hint = "";
@@ -650,7 +708,7 @@ Examples:
                     }
                     else {
                         // Extract first meaningful signature line from content
-                        const raw = (_r = (_q = r.content) !== null && _q !== void 0 ? _q : r.text) !== null && _r !== void 0 ? _r : "";
+                        const raw = (_s = (_r = r.content) !== null && _r !== void 0 ? _r : r.text) !== null && _s !== void 0 ? _s : "";
                         const lines = raw.split("\n");
                         for (const line of lines) {
                             const trimmed = line.trim();
@@ -685,19 +743,26 @@ Examples:
                     }
                     const sym = symbol ? ` ${symbol}` : "";
                     const rl = role ? ` [${role}]` : "";
+                    const score = r.score;
+                    const scoreCol = typeof score === "number" ? `\ts=${score.toFixed(3)}` : "";
                     const explainSuffix = options.explain && r.scoreBreakdown
                         ? `\texplain:rerank=${r.scoreBreakdown.rerank.toFixed(3)},fused=${r.scoreBreakdown.fused.toFixed(3)},boost=${r.scoreBreakdown.boost.toFixed(2)}x,score=${r.scoreBreakdown.normalized.toFixed(3)}`
                         : "";
-                    console.log(`${relPath}:${startLine}${sym}${rl}${hint}${explainSuffix}`);
+                    console.log(`${relPath}:${startLine}${scoreCol}${sym}${rl}${hint}${explainSuffix}`);
                 }
             }
             // Agent trace (compact)
-            if (options.symbol && vectorDb && filteredData.length > 0) {
+            if (options.symbol && filteredData.length > 0) {
                 try {
-                    const { GraphBuilder } = yield Promise.resolve().then(() => __importStar(require("../lib/graph/graph-builder")));
-                    const builder = new GraphBuilder(vectorDb, effectiveRoot);
-                    const graph = yield builder.buildGraphMultiHop(pattern, 1);
-                    if (graph.center) {
+                    let graph = precomputedGraph;
+                    if (!graph) {
+                        if (!vectorDb)
+                            throw new Error("no graph source");
+                        const { GraphBuilder } = yield Promise.resolve().then(() => __importStar(require("../lib/graph/graph-builder")));
+                        const builder = new GraphBuilder(vectorDb, effectiveRoot);
+                        graph = yield builder.buildGraphMultiHop(pattern, 1);
+                    }
+                    if (graph === null || graph === void 0 ? void 0 : graph.center) {
                         console.log("---");
                         for (const t of graph.callerTree) {
                             const rel = t.node.file.startsWith(effectiveRoot)
@@ -715,12 +780,12 @@ Examples:
                         }
                     }
                 }
-                catch (_11) { }
+                catch (_12) { }
             }
             return;
         }
         if (options.skeleton) {
-            yield outputSkeletons(filteredData, projectRoot, parseInt(options.m, 10), vectorDb);
+            yield outputSkeletons(filteredData, projectRoot, parseInt(options.m, 10), vectorDb, precomputedSkeletons);
             return;
         }
         if (!filteredData.length) {
@@ -747,9 +812,9 @@ Examples:
             let shown = 0;
             console.log(resultCountHeader(filteredData, parseInt(options.m, 10)));
             for (const r of filteredData) {
-                const absP = (_u = (_s = r.path) !== null && _s !== void 0 ? _s : (_t = r.metadata) === null || _t === void 0 ? void 0 : _t.path) !== null && _u !== void 0 ? _u : "";
-                const startLine = (_y = (_w = (_v = r.startLine) !== null && _v !== void 0 ? _v : r.start_line) !== null && _w !== void 0 ? _w : (_x = r.generated_metadata) === null || _x === void 0 ? void 0 : _x.start_line) !== null && _y !== void 0 ? _y : 0;
-                const endLine = (_2 = (_0 = (_z = r.endLine) !== null && _z !== void 0 ? _z : r.end_line) !== null && _0 !== void 0 ? _0 : (_1 = r.generated_metadata) === null || _1 === void 0 ? void 0 : _1.end_line) !== null && _2 !== void 0 ? _2 : startLine;
+                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 startLine = (_z = (_x = (_w = r.startLine) !== null && _w !== void 0 ? _w : r.start_line) !== null && _x !== void 0 ? _x : (_y = r.generated_metadata) === null || _y === void 0 ? void 0 : _y.start_line) !== null && _z !== void 0 ? _z : 0;
+                const endLine = (_3 = (_1 = (_0 = r.endLine) !== null && _0 !== void 0 ? _0 : r.end_line) !== null && _1 !== void 0 ? _1 : (_2 = r.generated_metadata) === null || _2 === void 0 ? void 0 : _2.end_line) !== null && _3 !== void 0 ? _3 : startLine;
                 const relPath = absP.startsWith(projectRoot)
                     ? absP.slice(projectRoot.length + 1)
                     : absP;
@@ -782,7 +847,7 @@ Examples:
                     tokensUsed += blobTokens;
                     shown++;
                 }
-                catch (_12) {
+                catch (_13) {
                     console.log(`\n--- ${relPath} (file not readable) ---`);
                     shown++;
                 }
@@ -799,7 +864,7 @@ Examples:
         if (options.imports) {
             const seenFiles = new Set();
             for (const r of filteredData) {
-                const absP = (_5 = (_3 = r.path) !== null && _3 !== void 0 ? _3 : (_4 = r.metadata) === null || _4 === void 0 ? void 0 : _4.path) !== null && _5 !== void 0 ? _5 : "";
+                const absP = (_6 = (_4 = r.path) !== null && _4 !== void 0 ? _4 : (_5 = r.metadata) === null || _5 === void 0 ? void 0 : _5.path) !== null && _6 !== void 0 ? _6 : "";
                 if (absP && !seenFiles.has(absP)) {
                     seenFiles.add(absP);
                     const imports = getImportsForFile(absP);
@@ -826,7 +891,7 @@ Examples:
                 for (const r of filteredData) {
                     const b = r.scoreBreakdown;
                     if (b) {
-                        const absP = (_8 = (_6 = r.path) !== null && _6 !== void 0 ? _6 : (_7 = r.metadata) === null || _7 === void 0 ? void 0 : _7.path) !== null && _8 !== void 0 ? _8 : "";
+                        const absP = (_9 = (_7 = r.path) !== null && _7 !== void 0 ? _7 : (_8 = r.metadata) === null || _8 === void 0 ? void 0 : _8.path) !== null && _9 !== void 0 ? _9 : "";
                         const relPath = absP.startsWith(projectRoot)
                             ? absP.slice(projectRoot.length + 1)
                             : absP;
@@ -845,12 +910,17 @@ Examples:
             console.log(output);
         }
         // Symbol mode: append call graph
-        if (options.symbol && vectorDb) {
+        if (options.symbol) {
             try {
-                const { GraphBuilder } = yield Promise.resolve().then(() => __importStar(require("../lib/graph/graph-builder")));
-                const builder = new GraphBuilder(vectorDb, effectiveRoot);
-                const graph = yield builder.buildGraphMultiHop(pattern, 1);
-                if (graph.center) {
+                let graph = precomputedGraph;
+                if (!graph) {
+                    if (!vectorDb)
+                        throw new Error("no graph source");
+                    const { GraphBuilder } = yield Promise.resolve().then(() => __importStar(require("../lib/graph/graph-builder")));
+                    const builder = new GraphBuilder(vectorDb, effectiveRoot);
+                    graph = yield builder.buildGraphMultiHop(pattern, 1);
+                }
+                if (graph === null || graph === void 0 ? void 0 : graph.center) {
                     const lines = ["\n--- Call graph ---"];
                     const centerRel = path.relative(effectiveRoot, graph.center.file);
                     lines.push(`${graph.center.symbol} [${graph.center.role}] ${centerRel}:${graph.center.line + 1}`);
@@ -883,7 +953,7 @@ Examples:
                     console.log(lines.join("\n"));
                 }
             }
-            catch (_13) {
+            catch (_14) {
                 // Trace failed — skip silently
             }
         }
@@ -903,13 +973,13 @@ Examples:
                 source: "cli",
                 tool: "search",
                 query: pattern,
-                project: (_9 = (0, project_root_1.findProjectRoot)(root)) !== null && _9 !== void 0 ? _9 : root,
+                project: (_10 = (0, project_root_1.findProjectRoot)(root)) !== null && _10 !== void 0 ? _10 : root,
                 results: _searchResultCount,
                 ms: Date.now() - _searchStartMs,
                 error: _searchError,
             });
         }
-        catch (_14) { }
+        catch (_15) { }
         if (vectorDb) {
             try {
                 yield vectorDb.close();

package/dist/commands/skeleton.js

@@ -61,7 +61,6 @@ 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_registry_1 = require("../lib/utils/project-registry");
 const project_root_1 = require("../lib/utils/project-root");
@@ -156,27 +155,18 @@ Examples:
         };
         // Determine mode based on target
         const resolvedTarget = path.resolve(target);
-        // Directory mode
+        // Directory mode is unsupported. Auto-picking files from a directory
+        // was confusingly magical (and on '.' it fell through to the resolver
+        // path and skeletonized .gitignore). Refuse and point at the file form.
         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);
-            }
+            console.error([
+                "skeleton expects a file or symbol, not a directory.",
+                "Try:",
+                "  gmax skeleton src/foo.ts        # one file's structure",
+                '  gmax search "<topic>" --agent   # find relevant files first',
+            ].join("\n"));
+            process.exitCode = 1;
             return;
         }
         // Batch mode (comma-separated)