grepmax 0.26.68 → 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.68",
+      "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.
@@ -240,7 +250,7 @@ gmax status                   # See all projects + watcher status
 
 Adding or indexing a project can start the daemon automatically. MCP acquires primary-project watch leases lazily when an index-reading tool is used; discovery and catalog listing start no background work. It shuts down after 4 hours of inactivity, and hands off to a fresh daemon after 24 hours or once its memory footprint passes 2.5 GB. File-change batches are processed on up to four worker processes by default, added only when work backs up, with one kept free for searches; full-table compaction and new FTS/ANN index builds are disabled by containment. Existing indexes remain readable. Host safety stops persist across restart and block heavy operations.
 
-`gmax watch status` reports failed files, native watcher recovery or polling, dropped-event counts, and the last complete filesystem reconciliation. FSEvents dropped-event warnings keep the native stream attached and preserve the accompanying events. A reconciliation covers the gap; repeated warnings coalesce into one later scan, with a 30-second scan interval. Recovery stays visible until a complete scan covers the latest gap. Other backend errors still trigger subscription recovery; repeated terminal failures fall back to five-minute polling, where recent edits can lag. Search and MCP responses retain health warnings even after the file queue drains. Live edit batches can run during reconciliation instead of waiting for the full filesystem walk. Whole-project reindex and removal still quiesce the watcher and drain its work before changing the project. A complete reconciliation means the filesystem scan completed; queued embedding work can still be pending.
+`gmax watch status` reports failed files, native watcher recovery or polling, dropped-event counts, and the last complete filesystem reconciliation. FSEvents dropped-event warnings keep the native stream attached and preserve the accompanying events. A reconciliation covers the gap; repeated warnings coalesce into one later scan, with a 30-second scan interval. Recovery stays visible until a complete scan covers the latest gap. Other backend errors still trigger subscription recovery; repeated terminal failures fall back to five-minute polling, where recent edits can lag. Search and MCP responses retain health warnings even after the file queue drains. On macOS, gmax also forwards up to eight existing policy-excluded directories to the native event stream, prioritizing dependency, build and development output. Discovery is bounded; remaining paths retain glob filtering and file-policy checks. Policy edits refresh exclusions, and a policy change during subscription setup is checked before keeping a directory exclusion. Live edit batches can run during reconciliation instead of waiting for the full filesystem walk. Whole-project reindex and removal still quiesce the watcher and drain its work before changing the project. A complete reconciliation means the filesystem scan completed; queued embedding work can still be pending.
 
 Live filesystem edits take priority over background catchup and cleanup. Background batches dispatch one file at a time, with at most four catchup files or 50 cleanup paths. They yield between files when a live edit arrives or the two-second dispatch window is reached; an active file or store commit finishes before yielding. Catchup and cleanup alternate, and one background file is admitted after three consecutive live batches so cleanup continues during sustained editing. Existing retry backoff and worker limits remain in effect.
 

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/daemon/watcher-manager.js

@@ -51,7 +51,6 @@ var __asyncValues = (this && this.__asyncValues) || function (o) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.WatcherManager = void 0;
 const path = __importStar(require("node:path"));
-const watcher = __importStar(require("@parcel/watcher"));
 const batch_processor_1 = require("../index/batch-processor");
 const cache_coherence_1 = require("../index/cache-coherence");
 const file_policy_1 = require("../index/file-policy");
@@ -327,7 +326,7 @@ class WatcherManager {
                 catch (_c) { }
                 this.deps.subscriptions.delete(root);
             }
-            const sub = yield watcher.subscribe(root, (err, events) => {
+            const { subscription: sub } = yield (0, watcher_ignore_1.subscribeWithNativeExclusions)(root, (err, events) => {
                 var _a, _b;
                 var _c, _d;
                 if (this.deps.processors.get(root) !== processor ||
@@ -360,12 +359,7 @@ class WatcherManager {
                     processor.handleFileEvent(event.type === "delete" ? "unlink" : "change", event.path);
                 }
                 this.deps.touchActivity();
-            }, {
-                ignore: [
-                    ...watcher_1.WATCHER_IGNORE_GLOBS,
-                    ...(yield (0, watcher_ignore_1.readProjectWatcherIgnores)(root)),
-                ],
-            });
+            }, watcher_1.WATCHER_IGNORE_GLOBS);
             if (this.deps.processors.get(root) !== processor ||
                 this.watcherGenerations.get(root) !== generation) {
                 yield sub.unsubscribe();

package/dist/lib/index/watcher-ignore.js

@@ -41,15 +41,27 @@ 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); }
+};
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.nativeProjectIgnoreGlobs = nativeProjectIgnoreGlobs;
 exports.readProjectWatcherIgnores = readProjectWatcherIgnores;
+exports.readNativeWatcherIgnores = readNativeWatcherIgnores;
+exports.watcherIgnoreIdentity = watcherIgnoreIdentity;
+exports.subscribeWithNativeExclusions = subscribeWithNativeExclusions;
 const fs = __importStar(require("node:fs/promises"));
 const path = __importStar(require("node:path"));
+const watcher = __importStar(require("@parcel/watcher"));
 const ignore_1 = __importDefault(require("ignore"));
+const file_policy_1 = require("./file-policy");
 /** Only the common positive gitignore/glob subset is safe to push into Parcel.
  * Negations, escapes and unsupported syntax stay with ProjectFilePolicy, so a
  * native ignore can never hide a file that an explicit re-inclusion needs. */
@@ -102,3 +114,174 @@ function readProjectWatcherIgnores(root) {
         }
     });
 }
+const NATIVE_EXCLUSION_LIMIT = 8;
+const DISCOVERY_DIRECTORY_LIMIT = 512;
+const DISCOVERY_ENTRY_LIMIT = 16384;
+const DISCOVERY_DEPTH_LIMIT = 4;
+const DISCOVERY_TIME_MS = 1000;
+/** FSEvents only receives Parcel's literal paths, not its glob filters. Select
+ * bounded, existing directories that file policy already excludes. Never hide
+ * a source ancestor merely because some descendants are ignored. */
+function readNativeWatcherIgnores(root, baseGlobs) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a, e_1, _b, _c;
+        const policy = new file_policy_1.ProjectFilePolicy(root);
+        const candidates = [];
+        const discoveryPriority = (directory, depth) => {
+            const parts = path.relative(root, directory).split(path.sep);
+            // Package containers often hold nested build roots. Inspect those before
+            // descending authored source trees, which can exhaust the entry budget.
+            const container = parts.some((part) => ["packages", "apps", "services", "ios", "android", "macos"].includes(part));
+            const source = parts.some((part) => ["src", "source", "Sources", "tests", "test", "Tests"].includes(part));
+            return (container ? 1000 : 0) - (source ? 2000 : 0) - depth;
+        };
+        const pending = [{ directory: root, depth: 0 }];
+        const deadline = performance.now() + DISCOVERY_TIME_MS;
+        let entries = 0;
+        let visited = 0;
+        for (let cursor = 0; cursor < pending.length; cursor++) {
+            if (visited++ >= DISCOVERY_DIRECTORY_LIMIT || performance.now() > deadline)
+                break;
+            let next = cursor;
+            for (let i = cursor + 1; i < pending.length; i++) {
+                if (discoveryPriority(pending[i].directory, pending[i].depth) >
+                    discoveryPriority(pending[next].directory, pending[next].depth))
+                    next = i;
+            }
+            [pending[cursor], pending[next]] = [pending[next], pending[cursor]];
+            const { directory, depth } = pending[cursor];
+            try {
+                const dir = yield fs.opendir(directory);
+                try {
+                    for (var _d = true, dir_1 = (e_1 = void 0, __asyncValues(dir)), dir_1_1; dir_1_1 = yield dir_1.next(), _a = dir_1_1.done, !_a; _d = true) {
+                        _c = dir_1_1.value;
+                        _d = false;
+                        const entry = _c;
+                        if (++entries > DISCOVERY_ENTRY_LIMIT || performance.now() > deadline)
+                            break;
+                        if (!entry.isDirectory() || entry.isSymbolicLink())
+                            continue;
+                        const absolute = path.join(directory, entry.name);
+                        const classified = yield policy.classifyDirectory(absolute);
+                        if (classified.status === "excluded") {
+                            if (!["default ignore policy", "project ignore policy"].includes(classified.reason))
+                                continue;
+                            const relative = path
+                                .relative(root, absolute)
+                                .split(path.sep)
+                                .join("/");
+                            // Public Parcel options distinguish literals from globs. Skip names
+                            // it could interpret as a pattern; existing glob filtering remains.
+                            if (!/^[A-Za-z0-9_. /-]+$/.test(relative))
+                                continue;
+                            const priority = entry.name === ".git" || entry.name === "node_modules"
+                                ? depth === 0
+                                    ? 1000
+                                    : 500
+                                : entry.name === ".dev"
+                                    ? depth === 0
+                                        ? 950
+                                        : 550
+                                    : entry.name === ".build" || entry.name === "DerivedData"
+                                        ? 800
+                                        : entry.name === ".next"
+                                            ? 700
+                                            : depth === 0
+                                                ? 600
+                                                : 200;
+                            candidates.push({ relative, score: priority - depth * 10 });
+                        }
+                        else if (classified.status === "traverse" &&
+                            depth < DISCOVERY_DEPTH_LIMIT &&
+                            pending.length < DISCOVERY_DIRECTORY_LIMIT) {
+                            pending.push({ directory: absolute, depth: depth + 1 });
+                        }
+                    }
+                }
+                catch (e_1_1) { e_1 = { error: e_1_1 }; }
+                finally {
+                    try {
+                        if (!_d && !_a && (_b = dir_1.return)) yield _b.call(dir_1);
+                    }
+                    finally { if (e_1) throw e_1.error; }
+                }
+            }
+            catch (_e) {
+                // Failed/partial discovery only loses an optimization. Existing glob
+                // delivery and authoritative file-policy classification remain in force.
+            }
+            if (entries >= DISCOVERY_ENTRY_LIMIT)
+                break;
+        }
+        candidates.sort((a, b) => b.score - a.score || a.relative.localeCompare(b.relative));
+        const literalPaths = candidates
+            .slice(0, NATIVE_EXCLUSION_LIMIT)
+            .map((c) => c.relative);
+        return [...literalPaths, ...(yield nativeWatcherFilters(root, baseGlobs))];
+    });
+}
+function nativeWatcherFilters(root, baseGlobs) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const projectGlobs = yield readProjectWatcherIgnores(root);
+        return [...baseGlobs, ...projectGlobs].map((pattern) => {
+            if (pattern.includes("*"))
+                return pattern;
+            // Keep file exclusions and excess directory literals out of ignorePaths:
+            // passing more than eight silently defeats macOS stream exclusion.
+            const escaped = pattern.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+            return new RegExp(`^${escaped}(?:/|$)`);
+        });
+    });
+}
+function verifyNativeWatcherIgnores(root, baseGlobs, ignores) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const policy = new file_policy_1.ProjectFilePolicy(root);
+        const literals = [];
+        // Recheck the selected paths, rather than repeating timed discovery. A
+        // different partial scan must not cause subscription churn or disable the
+        // exclusions we already proved safe. New candidates can wait for refresh.
+        for (const pattern of ignores) {
+            if (typeof pattern !== "string" || pattern.includes("*"))
+                continue;
+            const classified = yield policy.classifyDirectory(path.join(root, pattern));
+            if (classified.status === "excluded" &&
+                ["default ignore policy", "project ignore policy"].includes(classified.reason))
+                literals.push(pattern);
+        }
+        return [...literals, ...(yield nativeWatcherFilters(root, baseGlobs))];
+    });
+}
+function watcherIgnoreIdentity(ignores) {
+    return JSON.stringify(ignores.map((pattern) => String(pattern)));
+}
+/** A policy edit during subscribe has no event listener yet. Check again after
+ * attaching so an old directory exclusion cannot permanently hide newly
+ * re-included source. Sustained policy churn falls back to immutable globs. */
+function subscribeWithNativeExclusions(root, callback, baseGlobs, initialIgnores) {
+    return __awaiter(this, void 0, void 0, function* () {
+        let ignores = initialIgnores !== null && initialIgnores !== void 0 ? initialIgnores : (yield readNativeWatcherIgnores(root, baseGlobs));
+        for (let attempt = 0; attempt < 2; attempt++) {
+            const subscription = yield watcher.subscribe(root, callback, {
+                ignore: ignores,
+            });
+            let verified;
+            try {
+                verified = yield verifyNativeWatcherIgnores(root, baseGlobs, ignores);
+            }
+            catch (error) {
+                yield subscription.unsubscribe();
+                throw error;
+            }
+            const policy = watcherIgnoreIdentity(ignores);
+            if (policy === watcherIgnoreIdentity(verified))
+                return { subscription, policy };
+            yield subscription.unsubscribe();
+            ignores = verified;
+        }
+        const fallback = [...baseGlobs];
+        return {
+            subscription: yield watcher.subscribe(root, callback, { ignore: fallback }),
+            policy: watcherIgnoreIdentity(fallback),
+        };
+    });
+}

package/dist/lib/index/watcher.js

@@ -52,7 +52,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.WATCHER_IGNORE_GLOBS = void 0;
 exports.startWatcher = startWatcher;
 const path = __importStar(require("node:path"));
-const watcher = __importStar(require("@parcel/watcher"));
 const batch_processor_1 = require("./batch-processor");
 const cache_coherence_1 = require("./cache-coherence");
 const file_policy_1 = require("./file-policy");
@@ -135,11 +134,8 @@ function startWatcher(opts) {
             const update = subscriptionUpdate
                 .catch(() => { })
                 .then(() => __awaiter(this, void 0, void 0, function* () {
-                const ignores = [
-                    ...exports.WATCHER_IGNORE_GLOBS,
-                    ...(yield (0, watcher_ignore_1.readProjectWatcherIgnores)(projectRoot)),
-                ];
-                const policy = JSON.stringify(ignores);
+                const ignores = yield (0, watcher_ignore_1.readNativeWatcherIgnores)(projectRoot, exports.WATCHER_IGNORE_GLOBS);
+                const policy = (0, watcher_ignore_1.watcherIgnoreIdentity)(ignores);
                 if (closing ||
                     (subscription && !subscriptionFailed && subscriptionPolicy === policy))
                     return;
@@ -149,7 +145,7 @@ function startWatcher(opts) {
                 subscription = null;
                 if (closing)
                     return;
-                const next = yield watcher.subscribe(projectRoot, (err, events) => {
+                const { subscription: next, policy: attachedPolicy } = yield (0, watcher_ignore_1.subscribeWithNativeExclusions)(projectRoot, (err, events) => {
                     var _a;
                     if (closing || generation !== subscriptionGeneration)
                         return;
@@ -168,13 +164,13 @@ function startWatcher(opts) {
                     }
                     for (const event of events)
                         processor.handleFileEvent(event.type === "delete" ? "unlink" : "change", event.path);
-                }, { ignore: ignores });
+                }, exports.WATCHER_IGNORE_GLOBS, ignores);
                 if (closing) {
                     yield next.unsubscribe();
                     return;
                 }
                 subscription = next;
-                subscriptionPolicy = policy;
+                subscriptionPolicy = attachedPolicy;
             }));
             subscriptionUpdate = update;
             return update;

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.68",
+  "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.68",
+  "version": "0.26.70",
   "description": "Semantic code search for Claude Code. Automatically indexes your project and provides intelligent search capabilities.",
   "author": {
     "name": "Robert Owens",