grepmax 0.26.69 → 0.26.70

package/.claude-plugin/marketplace.json

@@ -10,7 +10,7 @@
       "name": "grepmax",
       "source": "./plugins/grepmax",
       "description": "Semantic code search for Claude Code. Automatically indexes your project and provides intelligent search capabilities.",
-      "version": "0.26.69",
+      "version": "0.26.70",
       "author": {
         "name": "Robert Owens",
         "email": "robowens@me.com"

package/README.md

@@ -223,6 +223,16 @@ gmax surprises --experimental --exclude generated --top 10
 
 The CLI and MCP output include score, max similarity, pair count, representative symbols, directory buckets, top similarities, applied penalties, and `gmax skeleton` follow-up hints. On large monorepos, prefer `--in`/`--exclude`; the default scan is capped at 50,000 rows and user-provided `--max-rows` is capped at 100,000. If a narrow `--in` scope returns no findings, increase `--dir-depth` so subdirectories are compared inside the scope.
 
+Surprises excludes generated code, bindings, fixtures and GraphQL schema/operation output by default. Use CLI `--include-generated` or MCP `include_generated: true` to include these families; `--include-tests` / `include_tests` controls test files separately.
+
+### Analysis coverage and compact output
+
+Project overviews disclose when their language, directory, role and symbol breakdowns cover the first 200,000 chunks. CLI and MCP output label sampled chunk/file counts and show the full project chunk inventory separately. Inventory counting streams only paths in small batches with an execution deadline.
+
+Architecture audits omit unresolved same-name definitions from rankings, cycles and dead-code claims, and report the number omitted. Compact CLI audit and MCP cycle rows retain total file/edge counts and show up to eight complete paths within 1,000 characters, with an explicit omitted-file count.
+
+CLI `gmax skeleton --agent` and MCP `code_skeleton` text show at most 120 lines / 6,000 characters per file and report omitted lines and characters. CLI human output and JSON structure remain complete.
+
 ## Background Daemon
 
 A single daemon watches your projects via native OS file events (FSEvents/inotify). Changes are detected in sub-second and incrementally reindexed. All writes to LanceDB are routed through the daemon via IPC, eliminating lock contention.

package/dist/commands/audit.js

@@ -43,8 +43,11 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.audit = void 0;
+exports.formatHuman = formatHuman;
+exports.formatAgent = formatAgent;
 const commander_1 = require("commander");
 const graph_handler_1 = require("../lib/daemon/graph-handler");
+const agent_budget_1 = require("../lib/output/agent-budget");
 const vector_db_1 = require("../lib/store/vector-db");
 const exit_1 = require("../lib/utils/exit");
 const project_registry_1 = require("../lib/utils/project-registry");
@@ -67,6 +70,8 @@ function formatCycle(files) {
 function formatHuman(r) {
     const out = [];
     out.push(`${style.bold("Audit")} ${style.dim(`— ${r.scannedChunks} chunks across ${r.scannedFiles} files`)}`);
+    if (r.ambiguousSymbols)
+        out.push(`Unresolved symbol names omitted: ${r.ambiguousSymbols}`);
     out.push("");
     out.push(style.bold("God nodes") + style.dim(" (most depended-upon symbols)"));
     if (r.godNodes.length === 0) {
@@ -122,8 +127,10 @@ function formatHuman(r) {
     return out.join("\n");
 }
 function formatAgent(r) {
+    var _a;
     const lines = [];
     lines.push(`scanned\t${r.scannedChunks}\t${r.scannedFiles}`);
+    lines.push(`ambiguous_symbols_omitted\t${(_a = r.ambiguousSymbols) !== null && _a !== void 0 ? _a : 0}`);
     for (const g of r.godNodes) {
         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}`);
@@ -132,7 +139,8 @@ function formatAgent(r) {
         lines.push(`hub\t${h.file}\t${h.dependents}\t${h.defines}\t${h.fanOut}`);
     }
     for (const c of r.fileCycles) {
-        lines.push(`cycle\t${c.files.join(",")}\t${c.files.length}\t${c.edgeCount}`);
+        const shown = (0, agent_budget_1.boundedAgentList)(c.files);
+        lines.push(`cycle\t${shown.text}\t${c.files.length}\t${c.edgeCount}\tomitted_files=${shown.omitted}`);
     }
     for (const d of r.deadCandidates) {
         lines.push(`dead\t${d.symbol}\t${d.file}:${d.line + 1}`);

package/dist/commands/mcp.js

@@ -83,9 +83,11 @@ const embedding_generation_1 = require("../lib/index/embedding-generation");
 const embedding_status_1 = require("../lib/index/embedding-status");
 const index_config_1 = require("../lib/index/index-config");
 const syncer_1 = require("../lib/index/syncer");
+const agent_budget_1 = require("../lib/output/agent-budget");
 const agent_search_formatter_1 = require("../lib/output/agent-search-formatter");
 const index_state_footer_1 = require("../lib/output/index-state-footer");
 const mcp_results_1 = require("../lib/output/mcp-results");
+const project_coverage_1 = require("../lib/output/project-coverage");
 const searcher_1 = require("../lib/search/searcher");
 const annotator_1 = require("../lib/skeleton/annotator");
 const skeletonizer_1 = require("../lib/skeleton/skeletonizer");
@@ -1133,7 +1135,7 @@ exports.mcp = new commander_1.Command("mcp")
                     const annotated = sourceContent
                         ? (0, annotator_1.annotateSkeletonLines)(skeleton, sourceContent)
                         : skeleton;
-                    parts.push(`// ${t} (~${tokenEstimate} tokens)\n\n${annotated}`);
+                    parts.push(`// ${t} (~${tokenEstimate} tokens)\n\n${(0, agent_budget_1.boundedAgentText)(annotated)}`);
                 }
             }
             if (fmt === "json") {
@@ -1518,6 +1520,8 @@ exports.mcp = new commander_1.Command("mcp")
                 }
                 const lines = [];
                 lines.push(`Audit — ${audit.scannedChunks} chunks across ${audit.scannedFiles} files`);
+                if (audit.ambiguousSymbols)
+                    lines.push(`Unresolved symbol names omitted: ${audit.ambiguousSymbols}`);
                 lines.push("");
                 lines.push("God nodes (most depended-upon symbols):");
                 for (const g of audit.godNodes) {
@@ -1535,7 +1539,8 @@ exports.mcp = new commander_1.Command("mcp")
                 lines.push("");
                 lines.push("File dependency cycles (symbol-derived):");
                 for (const c of audit.fileCycles) {
-                    lines.push(`  ${c.files.join(", ")} - ${c.files.length} files, ${c.edgeCount} internal edges`);
+                    const shown = (0, agent_budget_1.boundedAgentList)(c.files);
+                    lines.push(`  ${shown.text} - ${c.files.length} files, ${c.edgeCount} internal edges; omitted_files=${shown.omitted}`);
                 }
                 if (audit.fileCycles.length === 0)
                     lines.push("  none");
@@ -1581,6 +1586,7 @@ exports.mcp = new commander_1.Command("mcp")
                 maxRows,
                 includeTests: Boolean(args.include_tests),
                 includeEval: Boolean(args.include_eval),
+                includeGenerated: Boolean(args.include_generated),
                 in: typeof args.in === "string" ? [args.in] : undefined,
                 exclude: typeof args.exclude === "string" ? [args.exclude] : undefined,
             };
@@ -1990,7 +1996,10 @@ exports.mcp = new commander_1.Command("mcp")
                 const pct = (count) => Math.round((count / overview.chunks) * 100);
                 const lines = [];
                 lines.push(`Project: ${projectName} (${root})`);
-                lines.push(`Last indexed: ${(_a = proj.lastIndexed) !== null && _a !== void 0 ? _a : "unknown"} • ${overview.chunks} chunks • ${overview.files} files`);
+                lines.push(`Last indexed: ${(_a = proj.lastIndexed) !== null && _a !== void 0 ? _a : "unknown"} • ${(0, project_coverage_1.projectCounts)(overview)}`);
+                const coverage = (0, project_coverage_1.projectCoverageNotice)(overview);
+                if (coverage)
+                    lines.push(`Coverage: ${coverage}`);
                 lines.push("");
                 lines.push(`Languages: ${overview.extEntries
                     .map(([ext, count]) => `${ext} (${pct(count)}%)`)
@@ -2976,6 +2985,10 @@ exports.mcp = new commander_1.Command("mcp")
                     .boolean()
                     .describe("Include eval/experiment/script files")
                     .optional(),
+                include_generated: zod_1.z
+                    .boolean()
+                    .describe("Include generated code, bindings and fixtures")
+                    .optional(),
             },
         }, handleSurprisingConnections);
         tool("get_neighbors", {

package/dist/commands/project.js

@@ -46,6 +46,7 @@ exports.project = void 0;
 const path = __importStar(require("node:path"));
 const commander_1 = require("commander");
 const rows_handler_1 = require("../lib/daemon/rows-handler");
+const project_coverage_1 = require("../lib/output/project-coverage");
 const daemon_client_1 = require("../lib/utils/daemon-client");
 const exit_1 = require("../lib/utils/exit");
 const project_registry_1 = require("../lib/utils/project-registry");
@@ -80,9 +81,12 @@ exports.project = new commander_1.Command("project")
         const projects = (0, project_registry_1.listProjects)();
         const proj = projects.find((p) => p.root === root);
         const { chunks, files, extEntries, dirEntries, roleEntries, topSymbols, entryPoints, } = overview;
+        const coverage = (0, project_coverage_1.projectCoverageNotice)(overview);
         if (opts.agent) {
             console.log(`name\t${projectName}`);
             console.log(`root\t${root}`);
+            if (coverage)
+                console.log(`coverage\t${coverage}`);
             console.log(`chunks\t${chunks}`);
             console.log(`files\t${files}`);
             console.log(`last_indexed\t${(_b = proj === null || proj === void 0 ? void 0 : proj.lastIndexed) !== null && _b !== void 0 ? _b : "unknown"}`);
@@ -100,7 +104,9 @@ exports.project = new commander_1.Command("project")
         }
         else {
             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"} • ${chunks} chunks • ${files} files\n`);
+            console.log(`Last indexed: ${(_c = proj === null || proj === void 0 ? void 0 : proj.lastIndexed) !== null && _c !== void 0 ? _c : "unknown"} • ${(0, project_coverage_1.projectCounts)(overview)}\n`);
+            if (coverage)
+                console.log(`Coverage: ${coverage}\n`);
             console.log(`Languages: ${extEntries.map(([ext, count]) => `${ext} (${Math.round((count / chunks) * 100)}%)`).join(", ")}\n`);
             console.log("Directory structure:");
             for (const [dir, data] of dirEntries) {

package/dist/commands/skeleton.js

@@ -1,12 +1,4 @@
 "use strict";
-/**
- * gmax skeleton - Show code skeleton (signatures without implementation)
- *
- * Usage:
- *   gmax skeleton <file>           # Skeleton of a file
- *   gmax skeleton <symbol>         # Find symbol and skeleton its file
- *   gmax skeleton "query"          # Search and skeleton top results
- */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     var desc = Object.getOwnPropertyDescriptor(m, k);
@@ -51,6 +43,15 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.skeleton = void 0;
+const agent_budget_1 = require("../lib/output/agent-budget");
+/**
+ * gmax skeleton - Show code skeleton (signatures without implementation)
+ *
+ * Usage:
+ *   gmax skeleton <file>           # Skeleton of a file
+ *   gmax skeleton <symbol>         # Find symbol and skeleton its file
+ *   gmax skeleton "query"          # Search and skeleton top results
+ */
 const fs = __importStar(require("node:fs"));
 const commander_1 = require("commander");
 const config_1 = require("../config");
@@ -392,7 +393,9 @@ Examples:
             }
             else {
                 for (const result of results) {
-                    console.log(result.skeleton);
+                    console.log(options.agent
+                        ? (0, agent_budget_1.boundedAgentText)(result.skeleton)
+                        : result.skeleton);
                     console.log(""); // Blank line between files
                 }
             }
@@ -423,6 +426,6 @@ function outputResult(result, options) {
         }, null, 2));
     }
     else {
-        console.log(result.skeleton);
+        console.log(options.agent ? (0, agent_budget_1.boundedAgentText)(result.skeleton) : result.skeleton);
     }
 }

package/dist/commands/surprises.js

@@ -132,6 +132,7 @@ exports.surprises = new commander_1.Command("surprises")
     .option("--min-sim <n>", "Minimum similarity 0-1", String(surprising_connections_1.DEFAULT_SURPRISE_OPTIONS.minSimilarity))
     .option("--max-rows <n>", `Maximum indexed rows to scan (capped at ${surprising_connections_1.MAX_SURPRISE_ROWS})`, String(surprising_connections_1.DEFAULT_SURPRISE_OPTIONS.maxRows))
     .option("--include-tests", "Include test files", false)
+    .option("--include-generated", "Include generated code, bindings and fixtures", false)
     .option("--include-eval", "Include eval/experiment/script files", false)
     .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])
@@ -180,6 +181,7 @@ exports.surprises = new commander_1.Command("surprises")
             maxRows: parseIntOption(opts.maxRows, surprising_connections_1.DEFAULT_SURPRISE_OPTIONS.maxRows, surprising_connections_1.MAX_SURPRISE_ROWS),
             includeTests: Boolean(opts.includeTests),
             includeEval: Boolean(opts.includeEval),
+            includeGenerated: Boolean(opts.includeGenerated),
             in: analysisIn,
             exclude: analysisExclude,
         };

package/dist/lib/analysis/surprising-connections.js

@@ -45,6 +45,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.SURPRISE_COLUMNS = exports.MAX_SURPRISE_ROWS = exports.DEFAULT_SURPRISE_OPTIONS = void 0;
 exports.normalizeSurpriseOptions = normalizeSurpriseOptions;
 exports.isTestPath = isTestPath;
+exports.isGeneratedPath = isGeneratedPath;
 exports.isEvalPath = isEvalPath;
 exports.relPath = relPath;
 exports.lineLabel = lineLabel;
@@ -73,6 +74,7 @@ exports.DEFAULT_SURPRISE_OPTIONS = {
     maxRows: 50000,
     includeTests: false,
     includeEval: false,
+    includeGenerated: false,
 };
 exports.MAX_SURPRISE_ROWS = 100000;
 /**
@@ -152,8 +154,8 @@ const TEST_FILE_RE = /\.(test|spec)\.[cm]?[jt]sx?$/i;
 const NATIVE_TEST_DIR_RE = /(^|\/)\w+Tests?(\/|$)/;
 const NATIVE_TEST_FILE_RE = /Tests?\.(swift|kt|java)$/;
 function normalizeSurpriseOptions(opts = {}) {
-    var _a, _b, _c, _d, _e, _f, _g;
-    return Object.assign(Object.assign(Object.assign({}, exports.DEFAULT_SURPRISE_OPTIONS), opts), { sample: Math.max(1, Math.floor((_a = opts.sample) !== null && _a !== void 0 ? _a : exports.DEFAULT_SURPRISE_OPTIONS.sample)), neighbors: Math.max(1, Math.floor((_b = opts.neighbors) !== null && _b !== void 0 ? _b : exports.DEFAULT_SURPRISE_OPTIONS.neighbors)), dirDepth: Math.max(1, Math.floor((_c = opts.dirDepth) !== null && _c !== void 0 ? _c : exports.DEFAULT_SURPRISE_OPTIONS.dirDepth)), minSimilarity: Math.max(0, (_d = opts.minSimilarity) !== null && _d !== void 0 ? _d : exports.DEFAULT_SURPRISE_OPTIONS.minSimilarity), maxRows: Math.max(1, Math.min(exports.MAX_SURPRISE_ROWS, Math.floor((_e = opts.maxRows) !== null && _e !== void 0 ? _e : exports.DEFAULT_SURPRISE_OPTIONS.maxRows))), includeTests: (_f = opts.includeTests) !== null && _f !== void 0 ? _f : exports.DEFAULT_SURPRISE_OPTIONS.includeTests, includeEval: (_g = opts.includeEval) !== null && _g !== void 0 ? _g : exports.DEFAULT_SURPRISE_OPTIONS.includeEval });
+    var _a, _b, _c, _d, _e, _f, _g, _h;
+    return Object.assign(Object.assign(Object.assign({}, exports.DEFAULT_SURPRISE_OPTIONS), opts), { sample: Math.max(1, Math.floor((_a = opts.sample) !== null && _a !== void 0 ? _a : exports.DEFAULT_SURPRISE_OPTIONS.sample)), neighbors: Math.max(1, Math.floor((_b = opts.neighbors) !== null && _b !== void 0 ? _b : exports.DEFAULT_SURPRISE_OPTIONS.neighbors)), dirDepth: Math.max(1, Math.floor((_c = opts.dirDepth) !== null && _c !== void 0 ? _c : exports.DEFAULT_SURPRISE_OPTIONS.dirDepth)), minSimilarity: Math.max(0, (_d = opts.minSimilarity) !== null && _d !== void 0 ? _d : exports.DEFAULT_SURPRISE_OPTIONS.minSimilarity), maxRows: Math.max(1, Math.min(exports.MAX_SURPRISE_ROWS, Math.floor((_e = opts.maxRows) !== null && _e !== void 0 ? _e : exports.DEFAULT_SURPRISE_OPTIONS.maxRows))), includeTests: (_f = opts.includeTests) !== null && _f !== void 0 ? _f : exports.DEFAULT_SURPRISE_OPTIONS.includeTests, includeEval: (_g = opts.includeEval) !== null && _g !== void 0 ? _g : exports.DEFAULT_SURPRISE_OPTIONS.includeEval, includeGenerated: (_h = opts.includeGenerated) !== null && _h !== void 0 ? _h : false });
 }
 function isTestPath(filePath) {
     return (TEST_DIR_RE.test(filePath) ||
@@ -161,6 +163,11 @@ function isTestPath(filePath) {
         NATIVE_TEST_DIR_RE.test(filePath) ||
         NATIVE_TEST_FILE_RE.test(filePath));
 }
+function isGeneratedPath(filePath) {
+    return (/(^|\/)(?:generated|__generated__|bindings|fixtures|__fixtures__)(\/|$)/i.test(filePath) ||
+        /\.generated\.[^.]+$/i.test(filePath) ||
+        /\/[^/]*GraphQL\/Sources\/(?:Schema|Operations)\//i.test(filePath));
+}
 function isEvalPath(filePath) {
     return (/(^|\/)src\/eval[^/]*\.ts$/i.test(filePath) ||
         /(^|\/)(benchmarks?|experiments|scripts)(\/|$)/i.test(filePath));
@@ -477,6 +484,8 @@ function filterableCodeMeta(row, opts) {
         return false;
     if (!opts.includeEval && isEvalPath(row.relPath))
         return false;
+    if (!opts.includeGenerated && isGeneratedPath(row.relPath))
+        return false;
     return row.definedSymbols.length > 0;
 }
 function hasCodeContent(content) {
@@ -633,6 +642,7 @@ function analyzeSurprisingConnections(table_1, projectRoot_1) {
             weakCode: 0,
             tests: 0,
             evalHarness: 0,
+            generated: 0,
             sameDirBucket: 0,
             graphEdge: 0,
             belowThreshold: 0,
@@ -671,6 +681,10 @@ function analyzeSurprisingConnections(table_1, projectRoot_1) {
                     filters.tests++;
                     continue;
                 }
+                if (!opts.includeGenerated && isGeneratedPath(target.relPath)) {
+                    filters.generated++;
+                    continue;
+                }
                 if (!opts.includeEval && isEvalPath(target.relPath)) {
                     filters.evalHarness++;
                     continue;

package/dist/lib/daemon/graph-handler.js

@@ -537,13 +537,15 @@ function findFileCycles(deps, prefix, top) {
  * `top` caps each list; `deadTotal` reports the full pre-cap dead count.
  */
 function computeAudit(rows, prefix, top) {
-    var _a;
-    var _b;
-    // First definition of a symbol wins (matches GraphBuilder semantics).
+    var _a, _b, _c, _d, _e, _f;
+    var _g;
+    var _h;
+    // Only a uniquely defined name can establish an architectural edge.
     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();
+    const defLocations = new Map();
     // Distinct files that reference a symbol (cross-file inbound edges).
     const inboundFiles = new Map();
     const inboundTotal = new Map();
@@ -562,9 +564,15 @@ function computeAudit(rows, prefix, top) {
             if (!defs.has(s)) {
                 defs.set(s, { file, line, exported, complexity: 0 });
             }
+            else {
+                (_h = defs.get(s)).exported || (_h.exported = exported);
+            }
             if (!defFileCounts.has(s))
                 defFileCounts.set(s, new Set());
             defFileCounts.get(s).add(file);
+            if (!defLocations.has(s))
+                defLocations.set(s, new Set());
+            defLocations.get(s).add(`${file}:${line}`);
             if (!fileDefs.has(file))
                 fileDefs.set(file, new Set());
             fileDefs.get(file).add(s);
@@ -586,7 +594,7 @@ function computeAudit(rows, prefix, top) {
             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))
+        if ((0, callsites_1.isBuiltinCallee)(symbol) || ((_a = defLocations.get(symbol)) === null || _a === void 0 ? void 0 : _a.size) !== 1)
             continue;
         const refFiles = inboundFiles.get(symbol);
         if (!refFiles)
@@ -603,7 +611,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,
+            defFiles: (_g = (_b = defFileCounts.get(symbol)) === null || _b === void 0 ? void 0 : _b.size) !== null && _g !== void 0 ? _g : 1,
         });
     }
     godNodes.sort((a, b) => b.inboundFiles - a.inboundFiles || b.totalRefs - a.totalRefs);
@@ -613,6 +621,8 @@ function computeAudit(rows, prefix, top) {
     for (const [file, syms] of fileDefs) {
         const dependents = new Set();
         for (const s of syms) {
+            if ((0, callsites_1.isBuiltinCallee)(s) || ((_c = defLocations.get(s)) === null || _c === void 0 ? void 0 : _c.size) !== 1)
+                continue;
             const refFiles = inboundFiles.get(s);
             if (!refFiles)
                 continue;
@@ -626,7 +636,9 @@ function computeAudit(rows, prefix, top) {
         const out = fileOutRefs.get(file);
         if (out)
             for (const s of out)
-                if (defs.has(s))
+                if (defs.has(s) &&
+                    !(0, callsites_1.isBuiltinCallee)(s) &&
+                    ((_d = defLocations.get(s)) === null || _d === void 0 ? void 0 : _d.size) === 1)
                     fanOut++;
         hubFiles.push({
             file: rel(file, prefix),
@@ -639,7 +651,7 @@ function computeAudit(rows, prefix, top) {
     const fileDeps = new Map();
     for (const [file, refs] of fileOutRefs) {
         for (const s of refs) {
-            if ((0, callsites_1.isBuiltinCallee)(s))
+            if ((0, callsites_1.isBuiltinCallee)(s) || ((_e = defLocations.get(s)) === null || _e === void 0 ? void 0 : _e.size) !== 1)
                 continue;
             const defFiles = defFileCounts.get(s);
             if (!defFiles || defFiles.size !== 1)
@@ -657,7 +669,9 @@ function computeAudit(rows, prefix, top) {
     // references anywhere (including their own file).
     const deadAll = [];
     for (const [symbol, info] of defs) {
-        if (info.exported)
+        if (info.exported ||
+            ((_f = defLocations.get(symbol)) === null || _f === void 0 ? void 0 : _f.size) !== 1 ||
+            (0, callsites_1.isBuiltinCallee)(symbol))
             continue;
         if ((inboundTotal.get(symbol) || 0) > 0)
             continue;
@@ -665,6 +679,7 @@ function computeAudit(rows, prefix, top) {
     }
     deadAll.sort((a, b) => a.file.localeCompare(b.file) || a.line - b.line);
     return {
+        ambiguousSymbols: [...defLocations.values()].filter((locations) => locations.size > 1).length,
         scannedChunks: rows.length,
         scannedFiles: files.size,
         godNodes: godNodes.slice(0, top),

package/dist/lib/daemon/rows-handler.js

@@ -41,8 +41,15 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         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.MAX_LOCATE_ROWS = exports.ReadVerbError = void 0;
+exports.MAX_LOCATE_ROWS = exports.MAX_PROJECT_ROWS = exports.ReadVerbError = void 0;
 exports.withLocalStore = withLocalStore;
 exports.scopeToWire = scopeToWire;
 exports.assertReadableProject = assertReadableProject;
@@ -51,6 +58,7 @@ exports.clampInt = clampInt;
 exports.asReadVerbResponse = asReadVerbResponse;
 exports.runSymbols = runSymbols;
 exports.handleRowsSymbols = handleRowsSymbols;
+exports.countProjectRows = countProjectRows;
 exports.runProject = runProject;
 exports.handleRowsProject = handleRowsProject;
 exports.runLocate = runLocate;
@@ -270,15 +278,42 @@ function handleRowsSymbols(deps, payload) {
         }));
     });
 }
+// --- rows.project -----------------------------------------------------------
+exports.MAX_PROJECT_ROWS = 200000;
+/** Count a path-only stream in bounded Arrow batches with a native deadline.
+ * The SDK's countRows API has no execution timeout. */
+function countProjectRows(query, timeoutMs) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a, e_1, _b, _c;
+        let count = 0;
+        try {
+            for (var _d = true, _e = __asyncValues((0, query_timeout_1.streamQueryRows)(query, "project inventory count", timeoutMs)), _f; _f = yield _e.next(), _a = _f.done, !_a; _d = true) {
+                _c = _f.value;
+                _d = false;
+                const _row = _c;
+                count++;
+            }
+        }
+        catch (e_1_1) { e_1 = { error: e_1_1 }; }
+        finally {
+            try {
+                if (!_d && !_a && (_b = _e.return)) yield _b.call(_e);
+            }
+            finally { if (e_1) throw e_1.error; }
+        }
+        return count;
+    });
+}
 /**
  * The `project` scan and its aggregation. Returns the finished overview rather
  * than the (up to 200 000) rows it was computed from — see the file header.
  */
 function runProject(deps, projectRoot) {
     return __awaiter(this, void 0, void 0, function* () {
+        var _a;
         const table = yield tableOf(deps);
         const prefix = projectRoot.endsWith("/") ? projectRoot : `${projectRoot}/`;
-        const rows = yield table
+        const scanned = yield table
             .query()
             .select([
             "path",
@@ -289,8 +324,15 @@ function runProject(deps, projectRoot) {
             "referenced_symbols",
         ])
             .where((0, filter_builder_1.pathStartsWith)(prefix))
-            .limit(200000)
-            .toArray(query_timeout_1.QUERY_EXECUTION_OPTIONS);
+            .limit(exports.MAX_PROJECT_ROWS + 1)
+            .toArray({
+            timeoutMs: (_a = deps.queryTimeoutMs) !== null && _a !== void 0 ? _a : query_timeout_1.QUERY_EXECUTION_OPTIONS.timeoutMs,
+        });
+        const sampled = scanned.length > exports.MAX_PROJECT_ROWS;
+        const rows = sampled ? scanned.slice(0, exports.MAX_PROJECT_ROWS) : scanned;
+        const totalChunks = sampled
+            ? yield countProjectRows(table.query().select(["path"]).where((0, filter_builder_1.pathStartsWith)(prefix)), deps.queryTimeoutMs)
+            : rows.length;
         const nodePath = yield Promise.resolve().then(() => __importStar(require("node:path")));
         const files = new Set();
         const extCounts = new Map();
@@ -343,6 +385,8 @@ function runProject(deps, projectRoot) {
             }
         }
         return {
+            sampled,
+            totalChunks,
             chunks: rows.length,
             files: files.size,
             extEntries: Array.from(extCounts.entries())

package/dist/lib/output/agent-budget.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.boundedAgentText = boundedAgentText;
+exports.boundedAgentList = boundedAgentList;
+/** A bounded source excerpt with explicit loss counts. Full/JSON output stays exact. */
+function boundedAgentText(text, maxChars = 6000, maxLines = 120) {
+    var _a;
+    const lines = text.split("\n");
+    const lineLimited = lines.slice(0, maxLines).join("\n");
+    let end = Math.min(lineLimited.length, maxChars);
+    // Do not emit half of a UTF-16 surrogate pair at the character boundary.
+    if (end > 0 &&
+        /[\uD800-\uDBFF]/.test(lineLimited[end - 1]) &&
+        /[\uDC00-\uDFFF]/.test((_a = lineLimited[end]) !== null && _a !== void 0 ? _a : ""))
+        end--;
+    const excerpt = lineLimited.slice(0, end);
+    if (excerpt.length === text.length)
+        return text;
+    const shownLines = excerpt ? excerpt.split("\n").length : 0;
+    return `${excerpt}\n… omitted ${Math.max(0, lines.length - shownLines)} lines, ${text.length - excerpt.length} characters`;
+}
+/** Preserve complete fields so loss counts describe files, not partial names. */
+function boundedAgentList(items, maxItems = 8, maxChars = 1000) {
+    const shown = [];
+    let length = 0;
+    for (const item of items.slice(0, maxItems)) {
+        const field = item
+            .replace(/\\/g, "\\\\")
+            .replace(/\t/g, "\\t")
+            .replace(/\r/g, "\\r")
+            .replace(/\n/g, "\\n");
+        const nextLength = length + field.length + (shown.length ? 1 : 0);
+        if (nextLength > maxChars)
+            break;
+        shown.push(field);
+        length = nextLength;
+    }
+    return { text: shown.join(","), omitted: items.length - shown.length };
+}

package/dist/lib/output/project-coverage.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.projectCounts = projectCounts;
+exports.projectCoverageNotice = projectCoverageNotice;
+function projectCounts(overview) {
+    const qualifier = overview.sampled ? "sampled " : "";
+    return `${overview.chunks} ${qualifier}chunks • ${overview.files} ${qualifier}files`;
+}
+function projectCoverageNotice(overview) {
+    if (!overview.sampled)
+        return null;
+    const total = overview.totalChunks === undefined
+        ? "total chunk count unavailable"
+        : `${overview.totalChunks} total chunks`;
+    return `partial: ${overview.chunks} sampled chunks, ${overview.files} sampled files; ${total}; all breakdowns below describe the sample`;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "grepmax",
-  "version": "0.26.69",
+  "version": "0.26.70",
   "author": "Robert Owens <78518764+reowens@users.noreply.github.com>",
   "homepage": "https://github.com/reowens/grepmax",
   "bugs": {

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

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