grepmax 0.17.21 → 0.17.23

package/dist/commands/add.js

@@ -47,6 +47,7 @@ const fs = __importStar(require("node:fs"));
 const os = __importStar(require("node:os"));
 const path = __importStar(require("node:path"));
 const commander_1 = require("commander");
+const config_1 = require("../config");
 const grammar_loader_1 = require("../lib/index/grammar-loader");
 const index_config_1 = require("../lib/index/index-config");
 const sync_helpers_1 = require("../lib/index/sync-helpers");
@@ -218,7 +219,7 @@ Examples:
                 if (!done.ok) {
                     throw new Error((_c = done.error) !== null && _c !== void 0 ? _c : "daemon add failed");
                 }
-                (0, project_registry_1.registerProject)(Object.assign(Object.assign({}, pendingEntry), { lastIndexed: new Date().toISOString(), chunkCount: (_d = done.indexed) !== null && _d !== void 0 ? _d : 0, status: "indexed" }));
+                (0, project_registry_1.registerProject)(Object.assign(Object.assign({}, pendingEntry), { lastIndexed: new Date().toISOString(), chunkCount: (_d = done.indexed) !== null && _d !== void 0 ? _d : 0, status: "indexed", chunkerVersion: config_1.CONFIG.CHUNKER_VERSION }));
                 const failedFiles = (_e = done.failedFiles) !== null && _e !== void 0 ? _e : 0;
                 const failedSuffix = failedFiles > 0 ? ` · ${failedFiles} failed` : "";
                 spinner.succeed(`Added ${projectName} (${done.total} files, ${done.indexed} chunks${failedSuffix})`);
@@ -239,7 +240,7 @@ Examples:
                     projectRoot,
                     onProgress,
                 });
-                (0, project_registry_1.registerProject)(Object.assign(Object.assign({}, pendingEntry), { lastIndexed: new Date().toISOString(), chunkCount: result.indexed, status: "indexed" }));
+                (0, project_registry_1.registerProject)(Object.assign(Object.assign({}, pendingEntry), { lastIndexed: new Date().toISOString(), chunkCount: result.indexed, status: "indexed", chunkerVersion: config_1.CONFIG.CHUNKER_VERSION }));
                 const failedSuffix = result.failedFiles > 0 ? ` · ${result.failedFiles} failed` : "";
                 spinner.succeed(`Added ${projectName} (${result.total} files, ${result.indexed} chunks${failedSuffix})`);
             }

package/dist/commands/audit.js

@@ -45,6 +45,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.audit = void 0;
 exports.computeAudit = computeAudit;
 const commander_1 = require("commander");
+const callsites_1 = require("../lib/graph/callsites");
 const arrow_1 = require("../lib/utils/arrow");
 const exit_1 = require("../lib/utils/exit");
 const project_registry_1 = require("../lib/utils/project-registry");
@@ -71,8 +72,12 @@ function rel(p, prefix) {
  * `top` caps each list; `deadTotal` reports the full pre-cap dead count.
  */
 function computeAudit(rows, prefix, top) {
+    var _a, _b;
     // First definition of a symbol wins (matches GraphBuilder semantics).
     const defs = new Map();
+    // Distinct files defining each name — name-based edges can't tell same-name
+    // symbols apart, so multi-file definitions get flagged in the output.
+    const defFileCounts = new Map();
     // Distinct files that reference a symbol (cross-file inbound edges).
     const inboundFiles = new Map();
     const inboundTotal = new Map();
@@ -91,6 +96,9 @@ function computeAudit(rows, prefix, top) {
             if (!defs.has(s)) {
                 defs.set(s, { file, line, exported, complexity: 0 });
             }
+            if (!defFileCounts.has(s))
+                defFileCounts.set(s, new Set());
+            defFileCounts.get(s).add(file);
             if (!fileDefs.has(file))
                 fileDefs.set(file, new Set());
             fileDefs.get(file).add(s);
@@ -110,6 +118,10 @@ function computeAudit(rows, prefix, top) {
     for (const [symbol, info] of defs) {
         if (symbol.length < MIN_GOD_NAME_LEN)
             continue;
+        // Builtin method names (get, set, push, …) leak in via prototype/member
+        // definitions and their inbound counts are meaningless name collisions.
+        if ((0, callsites_1.isBuiltinCallee)(symbol))
+            continue;
         const refFiles = inboundFiles.get(symbol);
         if (!refFiles)
             continue;
@@ -125,6 +137,7 @@ function computeAudit(rows, prefix, top) {
             line: info.line,
             inboundFiles: external,
             totalRefs: inboundTotal.get(symbol) || 0,
+            defFiles: (_b = (_a = defFileCounts.get(symbol)) === null || _a === void 0 ? void 0 : _a.size) !== null && _b !== void 0 ? _b : 1,
         });
     }
     godNodes.sort((a, b) => b.inboundFiles - a.inboundFiles || b.totalRefs - a.totalRefs);
@@ -187,7 +200,10 @@ function formatHuman(r) {
     }
     else {
         for (const g of r.godNodes) {
-            out.push(`  ${style.cyan(g.symbol.padEnd(28))} ${style.dim(`${g.inboundFiles} files`)}, ${g.totalRefs} refs  ${style.dim(`${g.file}:${g.line + 1}`)}`);
+            const ambiguous = g.defFiles > 1
+                ? style.dim(`  ~defined in ${g.defFiles} files, location is a guess`)
+                : "";
+            out.push(`  ${style.cyan(g.symbol.padEnd(28))} ${style.dim(`${g.inboundFiles} files`)}, ${g.totalRefs} refs  ${style.dim(`${g.file}:${g.line + 1}`)}${ambiguous}`);
         }
     }
     out.push("");
@@ -224,7 +240,8 @@ function formatAgent(r) {
     const lines = [];
     lines.push(`scanned\t${r.scannedChunks}\t${r.scannedFiles}`);
     for (const g of r.godNodes) {
-        lines.push(`god\t${g.symbol}\t${g.file}:${g.line + 1}\t${g.inboundFiles}\t${g.totalRefs}`);
+        const ambiguous = g.defFiles > 1 ? `\tdefs=${g.defFiles}` : "";
+        lines.push(`god\t${g.symbol}\t${g.file}:${g.line + 1}\t${g.inboundFiles}\t${g.totalRefs}${ambiguous}`);
     }
     for (const h of r.hubFiles) {
         lines.push(`hub\t${h.file}\t${h.dependents}\t${h.defines}\t${h.fanOut}`);

package/dist/commands/context.js

@@ -43,6 +43,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.context = void 0;
+exports.findEnclosingSignature = findEnclosingSignature;
 const fs = __importStar(require("node:fs"));
 const path = __importStar(require("node:path"));
 const commander_1 = require("commander");
@@ -82,6 +83,23 @@ function chunkEndLine(chunk) {
     const start = chunkStartLine(chunk);
     return Number((_d = (_b = (_a = chunk.end_line) !== null && _a !== void 0 ? _a : chunk.endLine) !== null && _b !== void 0 ? _b : (_c = chunk.generated_metadata) === null || _c === void 0 ? void 0 : _c.end_line) !== null && _d !== void 0 ? _d : start);
 }
+/**
+ * The definition line of `parentSymbol` nearest above `startLine` — used to
+ * give a mid-function sub-chunk extract its enclosing signature. Requires a
+ * definition-shaped line, not just any mention, so recursive calls or
+ * references between the definition and the chunk don't win.
+ */
+function findEnclosingSignature(lines, startLine, parentSymbol) {
+    if (!parentSymbol || !/^\w+$/.test(parentSymbol))
+        return null;
+    const defRe = new RegExp(`(?:\\b(?:class|function|interface|enum|struct|trait|impl|def|fn|type|const|let|var)\\b[^=]*\\b${parentSymbol}\\b|\\b${parentSymbol}\\b\\s*[(:=])`);
+    for (let i = Math.min(startLine, lines.length) - 1; i >= 0; i--) {
+        if (defRe.test(lines[i])) {
+            return { text: lines[i].trim(), line: i };
+        }
+    }
+    return null;
+}
 function resolveExistingPath(target, root, projectRoot) {
     const candidates = [
         path.isAbsolute(target) ? target : path.resolve(root, target),
@@ -196,7 +214,8 @@ exports.context = new commander_1.Command("context")
         for (const r of entryPoints.slice(0, 5)) {
             const p = chunkPath(r);
             const line = chunkStartLine(r);
-            const sym = (_c = (_b = (0, arrow_1.toArr)(r.defined_symbols)) === null || _b === void 0 ? void 0 : _b[0]) !== null && _c !== void 0 ? _c : "";
+            const parentSym = String(r.parent_symbol || "");
+            const sym = (_c = (_b = (0, arrow_1.toArr)(r.defined_symbols)) === null || _b === void 0 ? void 0 : _b[0]) !== null && _c !== void 0 ? _c : (parentSym ? `(in ${parentSym})` : "");
             const role = String(r.role || "IMPLEMENTATION");
             epSection.push(`${relPath(projectRoot, p)}:${line + 1} ${sym} [${role}]`);
         }
@@ -215,13 +234,26 @@ exports.context = new commander_1.Command("context")
             const startLine = chunkStartLine(r);
             const endLine = chunkEndLine(r);
             const sym = (_b = (_a = (0, arrow_1.toArr)(r.defined_symbols)) === null || _a === void 0 ? void 0 : _a[0]) !== null && _b !== void 0 ? _b : "";
+            const parentSym = String(r.parent_symbol || "");
             try {
                 const content = fs.readFileSync(absP, "utf-8");
                 const allLines = content.split("\n");
                 const body = allLines
                     .slice(startLine, Math.min(endLine + 1, allLines.length))
                     .join("\n");
-                return `\n--- ${relPath(projectRoot, absP)}:${startLine + 1} ${sym} ---\n${body}`;
+                // A sub-chunk that starts mid-function has no defined symbol of its
+                // own — prepend the enclosing definition's signature so the extract
+                // isn't headless code.
+                let enclosing = "";
+                let label = sym;
+                if (!sym && parentSym) {
+                    label = `(in ${parentSym})`;
+                    const sig = findEnclosingSignature(allLines, startLine, parentSym);
+                    if (sig) {
+                        enclosing = `${sig.text}  // :${sig.line + 1}\n// ...\n`;
+                    }
+                }
+                return `\n--- ${relPath(projectRoot, absP)}:${startLine + 1} ${label} ---\n${enclosing}${body}`;
             }
             catch (_c) {
                 return null; // File not readable — drop

package/dist/commands/doctor.js

@@ -237,6 +237,11 @@ exports.doctor = new commander_1.Command("doctor")
             diskLevel = availBytes < config_1.DISK_CRITICAL_BYTES ? "CRITICAL" : availBytes < config_1.DISK_LOW_BYTES ? "LOW" : "ok";
         }
         catch (_e) { }
+        const staleChunkerProjects = projects.filter((p) => {
+            var _a;
+            return p.status === "indexed" &&
+                ((_a = p.chunkerVersion) !== null && _a !== void 0 ? _a : 1) < config_1.CONFIG.CHUNKER_VERSION;
+        });
         if (opts.agent) {
             const fields = [
                 "index_health",
@@ -251,8 +256,14 @@ exports.doctor = new commander_1.Command("doctor")
                 `lock=${lockStatus.split(" ")[0]}`,
                 `daemon=${daemonUp ? "running" : "stopped"}`,
                 `orphaned=${orphanedProjects.length}`,
+                `stale_chunker=${staleChunkerProjects.length}`,
             ];
             console.log(fields.join("\t"));
+            if (staleChunkerProjects.length > 0) {
+                console.log(`stale_chunker_fix: run 'gmax index --reset' in: ${staleChunkerProjects
+                    .map((p) => p.name || path.basename(p.root))
+                    .join(", ")}`);
+            }
         }
         else {
             console.log("\nIndex Health\n");
@@ -296,6 +307,13 @@ exports.doctor = new commander_1.Command("doctor")
             }
             // Daemon
             console.log(`${daemonUp ? "ok" : "INFO"}  Daemon: ${daemonUp ? "running" : "not running"}`);
+            // Index built by an older chunker — graph metadata fixes need a reindex
+            if (staleChunkerProjects.length > 0) {
+                console.log(`WARN  Stale chunker: ${staleChunkerProjects.length} project(s) indexed before chunker v${config_1.CONFIG.CHUNKER_VERSION} — graph commands (peek/impact/trace) may overcount callers`);
+                for (const p of staleChunkerProjects) {
+                    console.log(`       - ${p.name || path.basename(p.root)}: run 'gmax index --reset' in ${p.root}`);
+                }
+            }
             // Projects
             if (orphanedProjects.length > 0) {
                 console.log(`WARN  Orphaned projects: ${orphanedProjects.length} (directories no longer exist)`);

package/dist/commands/impact.js

@@ -46,6 +46,7 @@ exports.impact = void 0;
 const path = __importStar(require("node:path"));
 const commander_1 = require("commander");
 const impact_1 = require("../lib/graph/impact");
+const test_hits_1 = require("../lib/graph/test-hits");
 const vector_db_1 = require("../lib/store/vector-db");
 const agent_errors_1 = require("../lib/utils/agent-errors");
 const exit_1 = require("../lib/utils/exit");
@@ -58,10 +59,13 @@ exports.impact = new commander_1.Command("impact")
     .option("--root <dir>", "Project root directory")
     .option("--in <subpath>", "Restrict to a sub-path of the project (repeatable)", (value, prev) => (prev ? [...prev, value] : [value]))
     .option("--exclude <subpath>", "Exclude a sub-path of the project (repeatable)", (value, prev) => (prev ? [...prev, value] : [value]))
+    .option("--no-tests", "Skip affected-test analysis; show production blast radius only")
     .option("--agent", "Compact output for AI agents", false)
     .action((target, opts) => __awaiter(void 0, void 0, void 0, function* () {
     var _a;
     const depth = Math.min(Math.max(Number.parseInt(opts.depth || "1", 10), 1), 3);
+    // commander maps --no-tests → opts.tests === false (defaults true).
+    const includeTests = opts.tests !== false;
     let vectorDb = null;
     try {
         const root = (0, project_registry_1.resolveRootOrExit)(opts.root);
@@ -96,21 +100,26 @@ exports.impact = new commander_1.Command("impact")
         const queryRoot = opts.in && opts.in.length > 0
             ? scope.pathPrefix.replace(/\/$/, "")
             : projectRoot;
-        // Run dependents and tests in parallel
+        // Run dependents and tests in parallel. --no-tests skips the test
+        // traversal entirely so the affected-tests section is omitted (not just
+        // empty) below.
         const [dependents, tests] = yield Promise.all([
             (0, impact_1.findDependents)(symbols, vectorDb, queryRoot, excludePaths, undefined, scope.excludePrefixes),
-            (0, impact_1.findTests)(symbols, vectorDb, queryRoot, depth, scope.excludePrefixes),
+            includeTests
+                ? (0, impact_1.findTests)(symbols, vectorDb, queryRoot, depth, scope.excludePrefixes)
+                : Promise.resolve([]),
         ]);
         // Separate test files from non-test dependents
         const nonTestDeps = dependents.filter((d) => !(0, impact_1.isTestPath)(d.file));
+        // One line per test file; caller symbols inside it become `via` detail.
+        const groupedTests = (0, test_hits_1.groupTestHitsByFile)(tests);
         const rel = (p) => p.startsWith(`${projectRoot}/`) ? p.slice(projectRoot.length + 1) : p;
         if (opts.agent) {
             for (const d of nonTestDeps) {
                 console.log(`dep: ${rel(d.file)}\t${d.sharedSymbols}`);
             }
-            for (const t of tests) {
-                const hopLabel = t.hops === 0 ? "direct" : `${t.hops}-hop`;
-                console.log(`test: ${rel(t.file)}:${t.line + 1}\t${t.symbol}\t${hopLabel}`);
+            for (const t of groupedTests) {
+                console.log(`test: ${rel(t.file)}:${t.line + 1}\t${(0, test_hits_1.hopLabelAgent)(t.hops)}${(0, test_hits_1.formatViaAgent)(t.via)}`);
             }
             if (!nonTestDeps.length && !tests.length) {
                 console.log("(no impact detected)");
@@ -127,16 +136,17 @@ exports.impact = new commander_1.Command("impact")
             else {
                 console.log("Direct dependents: none found");
             }
-            console.log("");
-            if (tests.length > 0) {
-                console.log(`Affected tests (${tests.length}):`);
-                for (const t of tests) {
-                    const hopLabel = t.hops === 0 ? "calls directly" : `${t.hops} hop${t.hops > 1 ? "s" : ""} away`;
-                    console.log(`  ${rel(t.file)}:${t.line + 1}  ${t.symbol}  (${hopLabel})`);
+            if (includeTests) {
+                console.log("");
+                if (groupedTests.length > 0) {
+                    console.log(`Affected tests (${groupedTests.length}):`);
+                    for (const t of groupedTests) {
+                        console.log(`  ${rel(t.file)}:${t.line + 1}  (${(0, test_hits_1.hopLabelHuman)(t.hops)}${(0, test_hits_1.formatViaHuman)(t.via)})`);
+                    }
+                }
+                else {
+                    console.log("Affected tests: none found");
                 }
-            }
-            else {
-                console.log("Affected tests: none found");
             }
         }
     }

package/dist/commands/index.js

@@ -45,6 +45,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.index = void 0;
 const path = __importStar(require("node:path"));
 const commander_1 = require("commander");
+const config_1 = require("../config");
 const index_config_1 = require("../lib/index/index-config");
 const grammar_loader_1 = require("../lib/index/grammar-loader");
 const sync_helpers_1 = require("../lib/index/sync-helpers");
@@ -70,7 +71,7 @@ Examples:
   gmax index --reset             Full re-index from scratch
 `)
     .action((_args, cmd) => __awaiter(void 0, void 0, void 0, function* () {
-    var _a, _b, _c, _d;
+    var _a, _b, _c, _d, _e;
     const options = cmd.optsWithGlobals();
     let vectorDb = null;
     const ac = new AbortController();
@@ -90,11 +91,18 @@ Examples:
             : process.cwd();
         const projectRoot = (_a = (0, project_root_1.findProjectRoot)(indexRoot)) !== null && _a !== void 0 ? _a : indexRoot;
         // Project must be registered before reindexing
-        if (!(0, project_registry_1.getProject)(projectRoot)) {
+        const existingEntry = (0, project_registry_1.getProject)(projectRoot);
+        if (!existingEntry) {
             console.error(`This project hasn't been added yet.\n\nRun: gmax add ${projectRoot}\n`);
             process.exitCode = 1;
             return;
         }
+        // Only a reset rechunks cached files, so only a reset may claim the
+        // current chunker version — a plain index would clear the doctor
+        // stale-chunker warning without regenerating any chunks.
+        const stampedChunkerVersion = options.reset
+            ? config_1.CONFIG.CHUNKER_VERSION
+            : ((_b = existingEntry.chunkerVersion) !== null && _b !== void 0 ? _b : 1);
         if (options.reset) {
             console.log("Resetting index...");
         }
@@ -115,7 +123,7 @@ Examples:
                     });
                 });
                 if (!done.ok) {
-                    throw new Error((_b = done.error) !== null && _b !== void 0 ? _b : "daemon index failed");
+                    throw new Error((_c = done.error) !== null && _c !== void 0 ? _c : "daemon index failed");
                 }
                 if (options.dryRun) {
                     spinner.succeed(`Dry run complete(${done.processed} / ${done.total}) • would have indexed ${done.indexed} `);
@@ -129,10 +137,11 @@ Examples:
                     modelTier: globalConfig.modelTier,
                     embedMode: globalConfig.embedMode,
                     lastIndexed: new Date().toISOString(),
-                    chunkCount: (_c = done.indexed) !== null && _c !== void 0 ? _c : 0,
+                    chunkCount: (_d = done.indexed) !== null && _d !== void 0 ? _d : 0,
                     status: "indexed",
+                    chunkerVersion: stampedChunkerVersion,
                 });
-                const failedFiles = (_d = done.failedFiles) !== null && _d !== void 0 ? _d : 0;
+                const failedFiles = (_e = done.failedFiles) !== null && _e !== void 0 ? _e : 0;
                 const failedSuffix = failedFiles > 0 ? ` • ${failedFiles} failed` : "";
                 spinner.succeed(`Indexing complete(${done.processed} / ${done.total}) • indexed ${done.indexed}${failedSuffix} `);
             }
@@ -152,7 +161,7 @@ Examples:
                 try {
                     process.kill(watcher.pid, "SIGTERM");
                 }
-                catch (_e) { }
+                catch (_f) { }
                 for (let i = 0; i < 50; i++) {
                     if (!(0, watcher_store_1.isProcessRunning)(watcher.pid))
                         break;
@@ -192,6 +201,7 @@ Examples:
                     lastIndexed: new Date().toISOString(),
                     chunkCount: result.indexed,
                     status: "indexed",
+                    chunkerVersion: stampedChunkerVersion,
                 });
                 const failedSuffix = result.failedFiles > 0 ? ` • ${result.failedFiles} failed` : "";
                 spinner.succeed(`Indexing complete(${result.processed} / ${result.total}) • indexed ${result.indexed}${failedSuffix} `);

package/dist/commands/mcp.js

@@ -623,6 +623,7 @@ function formatMcpPointerSearchResults(data, displayRoot, options = {}) {
     return (0, agent_search_formatter_1.formatAgentSearchResults)(filterMcpSearchResults(data, options), displayRoot, {
         includeImports: options.includeImports,
         getImportsForFile: options.getImportsForFile,
+        query: options.query,
     });
 }
 // ---------------------------------------------------------------------------
@@ -834,6 +835,7 @@ exports.mcp = new commander_1.Command("mcp")
                         namePattern,
                         includeImports,
                         getImportsForFile,
+                        query,
                     });
                     if ((_a = result.warnings) === null || _a === void 0 ? void 0 : _a.length) {
                         return ok(`${result.warnings.join("\n")}\n\n${output}`);

package/dist/commands/peek.js

@@ -45,6 +45,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.peek = void 0;
 const fs = __importStar(require("node:fs"));
 const commander_1 = require("commander");
+const callsites_1 = require("../lib/graph/callsites");
 const graph_builder_1 = require("../lib/graph/graph-builder");
 const vector_db_1 = require("../lib/store/vector-db");
 const agent_errors_1 = require("../lib/utils/agent-errors");
@@ -69,26 +70,45 @@ function extractSignature(filePath, startLine, endLine) {
         const lines = content.split("\n");
         const chunk = lines.slice(startLine, endLine + 1);
         const bodyLines = chunk.length;
-        // Find the signature: everything up to and including the opening brace
+        // Find the signature: everything up to and including the opening brace.
+        // Only treat `{` / `=>` as the body boundary once the parameter list's
+        // parens are balanced — object-literal param types (`cached: { … }`)
+        // contain braces mid-signature and must not end it.
         const sigLines = [];
+        let parenDepth = 0;
         for (const line of chunk) {
             sigLines.push(line);
-            if (line.includes("{") || line.includes("=>"))
+            for (const ch of line) {
+                if (ch === "(")
+                    parenDepth++;
+                else if (ch === ")")
+                    parenDepth--;
+            }
+            if (parenDepth <= 0 && (line.includes("{") || line.includes("=>"))) {
                 break;
+            }
+            if (sigLines.length >= 12)
+                break; // degenerate input — bail
         }
         // If we only got one line and it's the whole function, collapse it
         if (sigLines.length >= bodyLines) {
-            return { signature: chunk.join("\n"), bodyLines: 0 };
+            const whole = chunk.join("\n");
+            return { signature: whole, signatureOnly: whole, bodyLines: 0 };
         }
         const sig = sigLines.join("\n");
         const remaining = bodyLines - sigLines.length;
         return {
             signature: `${sig}\n    // ... (${remaining} lines)\n  }`,
+            signatureOnly: sig,
             bodyLines,
         };
     }
     catch (_a) {
-        return { signature: "(source not available)", bodyLines: 0 };
+        return {
+            signature: "(source not available)",
+            signatureOnly: "(source not available)",
+            bodyLines: 0,
+        };
     }
 }
 exports.peek = new commander_1.Command("peek")
@@ -122,6 +142,9 @@ exports.peek = new commander_1.Command("peek")
         // languages, refuse to silently pick one. The graph builder otherwise
         // picks one chunk arbitrarily and lists callers from a different
         // language — verified failure mode.
+        // Same-language multi-definition is reported as a note instead (below):
+        // the first definition still wins, but the agent learns it guessed.
+        let otherDefs = [];
         {
             const tableForCheck = yield vectorDb.ensureTable();
             const allDefs = yield tableForCheck
@@ -134,6 +157,14 @@ exports.peek = new commander_1.Command("peek")
                 path: String(row.path || ""),
                 startLine: Number(row.start_line || 0),
             }));
+            // Dedupe by file: split sub-chunks of one definition share a path,
+            // while genuine ambiguity (same name defined elsewhere) crosses files.
+            const distinct = new Map();
+            for (const c of chunks) {
+                if (!distinct.has(c.path))
+                    distinct.set(c.path, c);
+            }
+            otherDefs = [...distinct.values()];
             const byLang = (0, language_1.groupByLanguage)(chunks);
             if (byLang.size >= 2) {
                 const rel = (p) => p.startsWith(projectRoot) ? p.slice(projectRoot.length + 1) : p;
@@ -198,7 +229,30 @@ exports.peek = new commander_1.Command("peek")
                 line: c.line,
             }));
         }
-        const calleeList = graph.callees.map((c) => ({
+        // Re-anchor chunk-level caller rows to actual call sites and dedupe —
+        // getCallers() returns one row per chunk, which multiplies callers for
+        // classes split across many chunks (verified: 3 real call sites → 66).
+        const resolvedCallers = (0, callsites_1.resolveCallSites)(callerList, symbol).map((c) => {
+            var _a;
+            return ({
+                symbol: c.symbol,
+                file: c.file,
+                line: (_a = c.snippetLine) !== null && _a !== void 0 ? _a : c.line,
+            });
+        });
+        // Builtins listed as "(not indexed)" callees (trunc, now, filter, …)
+        // are noise; project symbols always resolve so they're unaffected.
+        // Dedupe by symbol — repeated references arrive once per chunk.
+        const seenCallees = new Set();
+        const calleeList = graph.callees
+            .filter((c) => c.file || !(0, callsites_1.isBuiltinCallee)(c.symbol))
+            .filter((c) => {
+            if (seenCallees.has(c.symbol))
+                return false;
+            seenCallees.add(c.symbol);
+            return true;
+        })
+            .map((c) => ({
             symbol: c.symbol,
             file: c.file,
             line: c.line,
@@ -207,16 +261,30 @@ exports.peek = new commander_1.Command("peek")
             // Compact TSV output
             const exportedStr = exported ? "exported" : "";
             console.log(`${center.symbol}\t${rel(center.file)}:${center.line + 1}\t${center.role}\t${exportedStr}`);
-            // Signature (first line only)
-            const { signature } = extractSignature(center.file, startLine, endLine);
-            const firstLine = signature.split("\n")[0].trim();
-            console.log(`sig: ${firstLine}`);
+            if (otherDefs.length > 1) {
+                const others = otherDefs
+                    .filter((d) => d.path !== center.file)
+                    .slice(0, 4)
+                    .map((d) => `${rel(d.path)}:${d.startLine + 1}`);
+                if (others.length > 0) {
+                    console.log(`also-defined: ${others.join(", ")} — showing the first; pin with --in <subpath>`);
+                }
+            }
+            // Signature — all lines up to the opening brace, collapsed to one
+            // line so parameters survive (first-line-only loses them).
+            const { signatureOnly } = extractSignature(center.file, startLine, endLine);
+            const sigOnly = signatureOnly
+                .split("\n")
+                .map((l) => l.trim())
+                .join(" ")
+                .replace(/\s+/g, " ");
+            console.log(`sig: ${sigOnly}`);
             // Callers
-            for (const c of callerList.slice(0, MAX_CALLERS)) {
+            for (const c of resolvedCallers.slice(0, MAX_CALLERS)) {
                 console.log(`<- ${c.symbol}\t${c.file ? `${rel(c.file)}:${c.line + 1}` : "(not indexed)"}`);
             }
-            if (callerList.length > MAX_CALLERS) {
-                console.log(`<- ... ${callerList.length - MAX_CALLERS} more`);
+            if (resolvedCallers.length > MAX_CALLERS) {
+                console.log(`<- ... ${resolvedCallers.length - MAX_CALLERS} more`);
             }
             // Callees
             for (const c of calleeList.slice(0, MAX_CALLEES)) {
@@ -239,6 +307,15 @@ exports.peek = new commander_1.Command("peek")
             // Rich output
             const exportedStr = exported ? ", exported" : "";
             console.log(`${style.bold(`peek: ${center.symbol}`)}  ${style.dim(`${rel(center.file)}:${center.line + 1}`)}  ${style.dim(`[${center.role}${exportedStr}]`)}`);
+            if (otherDefs.length > 1) {
+                const others = otherDefs
+                    .filter((d) => d.path !== center.file)
+                    .slice(0, 4)
+                    .map((d) => `${rel(d.path)}:${d.startLine + 1}`);
+                if (others.length > 0) {
+                    console.log(style.dim(`  also defined in: ${others.join(", ")} — showing the first; pin with --in <subpath>`));
+                }
+            }
             console.log();
             // Signature with collapsed body
             const { signature } = extractSignature(center.file, startLine, endLine);
@@ -247,9 +324,9 @@ exports.peek = new commander_1.Command("peek")
             }
             console.log();
             // Callers
-            if (callerList.length > 0) {
-                const shown = callerList.slice(0, MAX_CALLERS);
-                console.log(style.bold(`callers (${callerList.length}):`));
+            if (resolvedCallers.length > 0) {
+                const shown = resolvedCallers.slice(0, MAX_CALLERS);
+                console.log(style.bold(`callers (${resolvedCallers.length}):`));
                 for (const c of shown) {
                     if (c.file) {
                         console.log(`  ${style.blue("\u2190")} ${style.green(c.symbol.padEnd(25))} ${style.dim(`${rel(c.file)}:${c.line + 1}`)}`);
@@ -258,8 +335,8 @@ exports.peek = new commander_1.Command("peek")
                         console.log(`  ${style.blue("\u2190")} ${c.symbol.padEnd(25)} ${style.dim("(not indexed)")}`);
                     }
                 }
-                if (callerList.length > MAX_CALLERS) {
-                    console.log(style.dim(`  ... and ${callerList.length - MAX_CALLERS} more`));
+                if (resolvedCallers.length > MAX_CALLERS) {
+                    console.log(style.dim(`  ... and ${resolvedCallers.length - MAX_CALLERS} more`));
                 }
             }
             else {

package/dist/commands/project.js

@@ -45,6 +45,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.project = void 0;
 const path = __importStar(require("node:path"));
 const commander_1 = require("commander");
+const callsites_1 = require("../lib/graph/callsites");
 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");
@@ -91,7 +92,9 @@ exports.project = new commander_1.Command("project")
         const dirCounts = new Map();
         const roleCounts = new Map();
         const symbolRefs = new Map();
+        const definedInProject = new Set();
         const entryPoints = [];
+        const seenEntryPoints = new Set();
         for (const row of rows) {
             const p = String(row.path || "");
             const role = String(row.role || "IMPLEMENTATION");
@@ -115,13 +118,19 @@ exports.project = new commander_1.Command("project")
             dc.files.add(p);
             dc.chunks++;
             roleCounts.set(role, (roleCounts.get(role) || 0) + 1);
+            for (const d of defs)
+                definedInProject.add(d);
             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 epKey = `${defs[0]}:${p}`;
+                if (!seenEntryPoints.has(epKey)) {
+                    seenEntryPoints.add(epKey);
+                    entryPoints.push({
+                        symbol: defs[0],
+                        path: p.startsWith(prefix) ? p.slice(prefix.length) : p,
+                    });
+                }
             }
         }
         const projects = (0, project_registry_1.listProjects)();
@@ -129,7 +138,11 @@ exports.project = new commander_1.Command("project")
         const extEntries = Array.from(extCounts.entries())
             .sort((a, b) => b[1] - a[1])
             .slice(0, 8);
+        // Key symbols must be the project's own: raw referenced_symbols counts
+        // are dominated by JS builtins (push, slice, map, …) which say nothing
+        // about the codebase.
         const topSymbols = Array.from(symbolRefs.entries())
+            .filter(([s]) => definedInProject.has(s) && !(0, callsites_1.isBuiltinCallee)(s))
             .sort((a, b) => b[1] - a[1])
             .slice(0, 8);
         if (opts.agent) {