grepmax 0.26.40 → 0.26.41

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

@@ -44,6 +44,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.handleDaemonSearch = handleDaemonSearch;
 const embedding_generation_1 = require("../index/embedding-generation");
+const index_state_footer_1 = require("../output/index-state-footer");
 const searcher_1 = require("../search/searcher");
 const retriever_1 = require("../skeleton/retriever");
 const project_registry_1 = require("../utils/project-registry");
@@ -55,7 +56,7 @@ const project_registry_1 = require("../utils/project-registry");
 function handleDaemonSearch(deps, payload, signal) {
     return __awaiter(this, void 0, void 0, function* () {
         var _a, _b, _c, _d;
-        var _e, _f;
+        var _e, _f, _g;
         const { vectorDb, workerPool } = deps;
         if (!vectorDb || !workerPool) {
             return { ok: false, error: "daemon not ready" };
@@ -116,11 +117,20 @@ function handleDaemonSearch(deps, payload, signal) {
         if ((_c = result.warnings) === null || _c === void 0 ? void 0 : _c.length)
             response.warnings = result.warnings;
         // Annotate partial results when the index is still catching up, so an
-        // agent can caveat or retry. Only attached when actually indexing (the
-        // formatter suppresses the settled case anyway).
+        // agent can caveat or retry. Settled failures remain visible too.
         const idx = deps.getIndexState(root);
-        if (idx.indexing)
-            response.indexState = idx;
+        response.indexState = idx;
+        for (const candidateRoot of roots) {
+            if (candidateRoot === root)
+                continue;
+            const health = (0, index_state_footer_1.formatIndexStateFooter)(deps.getIndexState(candidateRoot), {
+                agent: true,
+            });
+            if (health) {
+                (_f = response.warnings) !== null && _f !== void 0 ? _f : (response.warnings = []);
+                response.warnings.push(`${candidateRoot}: ${health}`);
+            }
+        }
         // --skeleton support: fetch per-file skeletons inline so the CLI doesn't
         // have to open its own VectorDB. getStoredSkeleton is a single LIMIT-1
         // lookup; cheap enough to call for the top N distinct paths.
@@ -131,7 +141,7 @@ function handleDaemonSearch(deps, payload, signal) {
             const seen = new Set();
             const skeletons = {};
             for (const chunk of result.data) {
-                const p = (_f = chunk.path) !== null && _f !== void 0 ? _f : (_d = chunk.metadata) === null || _d === void 0 ? void 0 : _d.path;
+                const p = (_g = chunk.path) !== null && _g !== void 0 ? _g : (_d = chunk.metadata) === null || _d === void 0 ? void 0 : _d.path;
                 if (!p || seen.has(p))
                     continue;
                 seen.add(p);
@@ -142,7 +152,7 @@ function handleDaemonSearch(deps, payload, signal) {
                     if (sk)
                         skeletons[p] = sk;
                 }
-                catch (_g) {
+                catch (_h) {
                     // best-effort — drop the entry, keep the search result
                 }
             }
@@ -157,7 +167,7 @@ function handleDaemonSearch(deps, payload, signal) {
                 const builder = new GraphBuilder(vectorDb, root);
                 response.graph = yield builder.buildGraphMultiHop(payload.query, 1);
             }
-            catch (_h) {
+            catch (_j) {
                 // best-effort — drop graph, keep results
             }
         }

package/dist/lib/daemon/watcher-manager.js

@@ -104,6 +104,10 @@ class WatcherManager {
         this.pollRecoveryTimers = new Map();
         this.recoveryTimeouts = new Map();
         this.lastOverflowMs = new Map();
+        this.lastWatcherErrorLogMs = new Map();
+        this.overflowCounts = new Map();
+        this.reconciledAt = new Map();
+        this.catchupDurations = new Map();
         this.lastCatchupEndMs = new Map();
         this.deferredCatchups = new Map();
         this.catchups = new Map();
@@ -111,6 +115,24 @@ class WatcherManager {
         this.terminalFailures = new Map();
         this.watchLifecycles = new Map();
     }
+    health(root) {
+        var _a;
+        var _b, _c;
+        return {
+            failedFiles: (_b = (_a = this.terminalFailures.get(root)) === null || _a === void 0 ? void 0 : _a.size) !== null && _b !== void 0 ? _b : 0,
+            degraded: this.isRootDegraded(root),
+            watcherMode: this.pollIntervals.has(root)
+                ? "polling"
+                : this.pendingOps.has(`recover:${root}`) ||
+                    this.deferredCatchups.has(root)
+                    ? "recovering"
+                    : "native",
+            catchupRunning: this.catchups.has(root),
+            lastReconciledAt: this.reconciledAt.get(root),
+            overflowCount: (_c = this.overflowCounts.get(root)) !== null && _c !== void 0 ? _c : 0,
+            catchupMs: this.catchupDurations.get(root),
+        };
+    }
     watchProject(root_1) {
         return __awaiter(this, arguments, void 0, function* (root, options = {}) {
             var _a, _b;
@@ -268,14 +290,20 @@ class WatcherManager {
                 this.deps.subscriptions.delete(root);
             }
             const sub = yield watcher.subscribe(root, (err, events) => {
-                var _a;
+                var _a, _b;
                 if (err) {
-                    console.error(`[daemon:${name}] Watcher error:`, err);
+                    this.overflowCounts.set(root, ((_a = this.overflowCounts.get(root)) !== null && _a !== void 0 ? _a : 0) + 1);
+                    const now = Date.now();
+                    if (!this.lastWatcherErrorLogMs.has(root) ||
+                        now - this.lastWatcherErrorLogMs.get(root) >= 60000) {
+                        this.lastWatcherErrorLogMs.set(root, now);
+                        console.error(`[daemon:${name}] Watcher error (total=${this.overflowCounts.get(root)}):`, err);
+                    }
                     this.recoverWatcher(root, processor);
                     return;
                 }
                 // Only reset fail counter after sustained health (5min since last overflow)
-                const lastOverflow = (_a = this.lastOverflowMs.get(root)) !== null && _a !== void 0 ? _a : 0;
+                const lastOverflow = (_b = this.lastOverflowMs.get(root)) !== null && _b !== void 0 ? _b : 0;
                 if (Date.now() - lastOverflow > 5 * 60 * 1000) {
                     this.watcherFailCount.delete(root);
                 }
@@ -490,6 +518,7 @@ class WatcherManager {
             var _a, e_1, _b, _c;
             var _d;
             var _e;
+            const scanStart = Date.now();
             const { isFileCached } = yield Promise.resolve().then(() => __importStar(require("../utils/cache-check")));
             const metaCache = this.deps.getMetaCache();
             const vectorDb = this.deps.getVectorDb();
@@ -641,7 +670,11 @@ class WatcherManager {
                     parts.push(`${purged} deleted`);
                 console.log(`[daemon:${path.basename(root)}] Catchup: ${parts.join(", ")} file(s) while offline`);
             }
-            this.lastCatchupEndMs.set(root, Date.now());
+            const ended = Date.now();
+            this.lastCatchupEndMs.set(root, ended);
+            this.catchupDurations.set(root, ended - scanStart);
+            if (complete)
+                this.reconciledAt.set(root, ended);
             return complete;
         });
     }

package/dist/lib/graph/graph-builder.js

@@ -11,6 +11,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.GraphBuilder = void 0;
 const languages_1 = require("../core/languages");
+const arrow_1 = require("../utils/arrow");
 const filter_builder_1 = require("../utils/filter-builder");
 const query_timeout_1 = require("../utils/query-timeout");
 const callsites_1 = require("./callsites");
@@ -118,19 +119,43 @@ class GraphBuilder {
      */
     getCallees(symbol) {
         return __awaiter(this, void 0, void 0, function* () {
+            var _a;
             const table = yield this.db.ensureTable();
             const escaped = (0, filter_builder_1.escapeSqlString)(symbol);
             // Find the definition of the symbol
             const rows = yield table
                 .query()
-                .select(["referenced_symbols"])
+                .select([
+                "path",
+                "referenced_symbols",
+                "member_referenced_symbols",
+                "content",
+            ])
                 .where(this.scopeWhere(`array_contains(defined_symbols, '${escaped}')`))
                 .limit(1)
                 .toArray();
             if (rows.length === 0)
                 return [];
             const record = rows[0];
-            return record.referenced_symbols || [];
+            const memberNames = (0, arrow_1.toArr)(record.member_referenced_symbols);
+            const content = String((_a = record.content) !== null && _a !== void 0 ? _a : "");
+            let localDefinitions = [];
+            if (record.path && memberNames.some(callsites_1.isBuiltinCallee)) {
+                const localRows = yield table
+                    .query()
+                    .select(["defined_symbols"])
+                    .where(this.scopeWhere(`path = '${(0, filter_builder_1.escapeSqlString)(String(record.path))}'`))
+                    .toArray();
+                localDefinitions = localRows.flatMap((row) => (0, arrow_1.toArr)(row.defined_symbols));
+            }
+            return (0, arrow_1.toArr)(record.referenced_symbols).filter((name) => {
+                if (!(0, callsites_1.isBuiltinCallee)(name) ||
+                    !memberNames.includes(name) ||
+                    localDefinitions.includes(name))
+                    return true;
+                const escapedName = name.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+                return new RegExp(`(?<![\\w.$])${escapedName}\\s*\\(`).test(content);
+            });
         });
     }
     /**
@@ -138,7 +163,8 @@ class GraphBuilder {
      */
     buildGraph(symbol) {
         return __awaiter(this, void 0, void 0, function* () {
-            var _a;
+            var _a, _b;
+            var _c, _d;
             const table = yield this.db.ensureTable();
             const escaped = (0, filter_builder_1.escapeSqlString)(symbol);
             // 1. Get Center (Definition)
@@ -149,6 +175,8 @@ class GraphBuilder {
                 "start_line",
                 "defined_symbols",
                 "referenced_symbols",
+                "member_referenced_symbols",
+                "content",
                 "role",
                 "parent_symbol",
                 "complexity",
@@ -187,6 +215,26 @@ class GraphBuilder {
                 ])
                     .limit(25)
                     .toArray();
+                const memberNames = (0, arrow_1.toArr)((_a = centerRows[0]) === null || _a === void 0 ? void 0 : _a.member_referenced_symbols);
+                const content = String((_c = (_b = centerRows[0]) === null || _b === void 0 ? void 0 : _b.content) !== null && _c !== void 0 ? _c : "");
+                const bareCall = new RegExp(`(?<![\\w.$])${name.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}\\s*\\(`).test(content);
+                const selfDefinition = rows.find((r) => { var _a; return String((_a = r.path) !== null && _a !== void 0 ? _a : "") === centerFile; });
+                if ((0, callsites_1.isBuiltinCallee)(name) &&
+                    memberNames.includes(name) &&
+                    !bareCall &&
+                    !selfDefinition) {
+                    calleeNodes.push({
+                        symbol: name,
+                        file: "",
+                        line: 0,
+                        role: "",
+                        calls: [],
+                        calledBy: [],
+                        resolution: "ambiguous-member",
+                        confidence: "INFERRED",
+                    });
+                    continue;
+                }
                 if (rows.length > 0) {
                     // Prefer-self-file, then same-language-family. Only fall back to the
                     // first row when no candidate shares the center's file or family.
@@ -195,7 +243,7 @@ class GraphBuilder {
                         ? rows.find((r) => { var _a; return (0, languages_1.languageFamilyForPath)(String((_a = r.path) !== null && _a !== void 0 ? _a : "")) ===
                             centerFamily; })
                         : undefined;
-                    calleeNodes.push(this.mapRowToNode(((_a = selfRow !== null && selfRow !== void 0 ? selfRow : familyRow) !== null && _a !== void 0 ? _a : rows[0]), name, "center"));
+                    calleeNodes.push(this.mapRowToNode(((_d = selfRow !== null && selfRow !== void 0 ? selfRow : familyRow) !== null && _d !== void 0 ? _d : rows[0]), name, "center"));
                 }
                 else if (!(0, callsites_1.isBuiltinCallee)(name)) {
                     // Unresolved + a known builtin (.map/.get/forEach) → suppress the

package/dist/lib/graph/impact-rollup.js

@@ -151,7 +151,7 @@ function formatImpactRollupHuman(rollup, opts) {
         }
         else {
             for (const test of rollup.topTests) {
-                lines.push(`  ${relativeToProject(opts.projectRoot, test.file)}:${test.line + 1}  (${(0, test_hits_1.hopLabelHuman)(test.hops)}${(0, test_hits_1.formatViaHuman)(test.via)})`);
+                lines.push(`  ${relativeToProject(opts.projectRoot, test.file)}:${test.line + 1}  (${(0, test_hits_1.hopLabelHuman)(test.hops, test.evidence)}${(0, test_hits_1.formatViaHuman)(test.via)})`);
             }
         }
     }
@@ -191,7 +191,7 @@ function formatImpactRollupAgent(rollup, opts) {
             lines.push([
                 "test",
                 `${relativeToProject(opts.projectRoot, test.file)}:${test.line + 1}`,
-                (0, test_hits_1.hopLabelAgent)(test.hops),
+                (0, test_hits_1.hopLabelAgent)(test.hops, test.evidence),
                 (0, test_hits_1.formatViaAgent)(test.via).trim(),
             ]
                 .filter(Boolean)

package/dist/lib/graph/impact.js

@@ -157,10 +157,20 @@ function findTests(symbols_1, vectorDb_1, projectRoot_1) {
         const expanded = yield expandFileSymbols(symbols, vectorDb, projectRoot, excludePrefixes);
         const families = yield resolveSymbolFamilies(expanded, vectorDb, projectRoot, excludePrefixes, symbolFamilies);
         for (const symbol of expanded) {
-            yield walkCallers(symbol, graphBuilder, testHits, 0, depth, new Set(), (_a = families.get(symbol)) !== null && _a !== void 0 ? _a : null);
+            const candidates = new Map();
+            yield walkCallers(symbol, graphBuilder, candidates, 0, depth, new Set(), (_a = families.get(symbol)) !== null && _a !== void 0 ? _a : null);
+            for (const [key, hit] of candidates) {
+                if (!symbols.includes(symbol))
+                    hit.evidence = "file-candidate";
+                const previous = testHits.get(key);
+                if (!previous ||
+                    (previous.evidence && !hit.evidence) ||
+                    (previous.evidence === hit.evidence && hit.hops < previous.hops))
+                    testHits.set(key, hit);
+            }
         }
-        if (testHits.size === 0) {
-            const importFiles = yield findImportFallbackTests(expanded, symbols, vectorDb, projectRoot, excludePrefixes, families);
+        if (![...testHits.values()].some((hit) => !hit.evidence)) {
+            const importFiles = yield findImportFallbackTests(symbols, vectorDb, projectRoot, excludePrefixes, families);
             for (const file of importFiles) {
                 testHits.set(`${file}:(referenced)`, {
                     file,
@@ -170,17 +180,19 @@ function findTests(symbols_1, vectorDb_1, projectRoot_1) {
                 });
             }
         }
-        return [...testHits.values()].sort((a, b) => a.hops - b.hops || a.file.localeCompare(b.file));
+        return [...testHits.values()].sort((a, b) => Number(!!a.evidence) - Number(!!b.evidence) ||
+            a.hops - b.hops ||
+            a.file.localeCompare(b.file));
     });
 }
-function findImportFallbackTests(expandedSymbols, originalSymbols, vectorDb, projectRoot, excludePrefixes, symbolFamilies) {
+function findImportFallbackTests(originalSymbols, vectorDb, projectRoot, excludePrefixes, symbolFamilies) {
     return __awaiter(this, void 0, void 0, function* () {
         var _a;
         const files = new Set();
         // Signal 1: referenced_symbols match (precise; works when the chunker
-        // captured call references in test bodies). Uses the expanded set so tests
-        // that call a method of the target class still match.
-        const dependents = yield findDependents(expandedSymbols, vectorDb, projectRoot, undefined, 50, excludePrefixes, symbolFamilies);
+        // captured call references in test bodies). Co-defined symbols are already
+        // exposed as file candidates and must not become target coverage here.
+        const dependents = yield findDependents(originalSymbols, vectorDb, projectRoot, undefined, 50, excludePrefixes, symbolFamilies);
         for (const d of dependents) {
             if (isTestPath(d.file))
                 files.add(d.file);

package/dist/lib/graph/test-hits.js

@@ -9,20 +9,22 @@ function groupTestHitsByFile(hits) {
     const byFile = new Map();
     // Sort by hops so the first hit per file carries the best line/hops and
     // `via` lists closest callers first ((referenced) fallback hits sort last).
-    const ordered = [...hits].sort((a, b) => (a.hops === -1 ? Number.MAX_SAFE_INTEGER : a.hops) -
-        (b.hops === -1 ? Number.MAX_SAFE_INTEGER : b.hops));
+    const ordered = [...hits].sort((a, b) => Number(!!a.evidence) - Number(!!b.evidence) ||
+        (a.hops === -1 ? Number.MAX_SAFE_INTEGER : a.hops) -
+            (b.hops === -1 ? Number.MAX_SAFE_INTEGER : b.hops));
     for (const h of ordered) {
         let g = byFile.get(h.file);
         if (!g) {
-            g = { file: h.file, line: h.line, hops: h.hops, via: [] };
+            g = Object.assign({ file: h.file, line: h.line, hops: h.hops, via: [] }, (h.evidence ? { evidence: h.evidence } : {}));
             byFile.set(h.file, g);
         }
         if (h.symbol && h.symbol !== "(referenced)" && !g.via.includes(h.symbol)) {
             g.via.push(h.symbol);
         }
     }
-    return [...byFile.values()].sort((a, b) => (a.hops === -1 ? Number.MAX_SAFE_INTEGER : a.hops) -
-        (b.hops === -1 ? Number.MAX_SAFE_INTEGER : b.hops) ||
+    return [...byFile.values()].sort((a, b) => Number(!!a.evidence) - Number(!!b.evidence) ||
+        (a.hops === -1 ? Number.MAX_SAFE_INTEGER : a.hops) -
+            (b.hops === -1 ? Number.MAX_SAFE_INTEGER : b.hops) ||
         a.file.localeCompare(b.file));
 }
 const MAX_VIA = 3;
@@ -42,10 +44,14 @@ function formatViaHuman(via) {
     const more = via.length > MAX_VIA ? ` (+${via.length - MAX_VIA} more)` : "";
     return `, via ${shown}${more}`;
 }
-function hopLabelAgent(hops) {
+function hopLabelAgent(hops, evidence) {
+    if (evidence)
+        return "file-candidate";
     return hops === -1 ? "via-import" : hops === 0 ? "direct" : `${hops}-hop`;
 }
-function hopLabelHuman(hops) {
+function hopLabelHuman(hops, evidence) {
+    if (evidence)
+        return "same-file candidate";
     return hops === -1
         ? "via import"
         : hops === 0

package/dist/lib/index/batch-processor.js

@@ -50,6 +50,7 @@ const vector_db_1 = require("../store/vector-db");
 const cache_check_1 = require("../utils/cache-check");
 const file_utils_1 = require("../utils/file-utils");
 const logger_1 = require("../utils/logger");
+const embedding_error_1 = require("../workers/embedding-error");
 const pool_1 = require("../workers/pool");
 const cache_coherence_1 = require("./cache-coherence");
 const file_policy_1 = require("./file-policy");
@@ -81,6 +82,8 @@ class ProjectBatchProcessor {
         this.closed = false;
         this.currentBatchAc = null;
         this.lastCorruptionLogMs = 0;
+        this.backendFailures = 0;
+        this.backendRetryAt = 0;
         this.policyChangedDuringBatch = false;
         /** Rolling window of recent batch outcomes — see `progress`. */
         this.recentBatches = [];
@@ -201,8 +204,11 @@ class ProjectBatchProcessor {
         });
     }
     scheduleBatch(delayMs = DEBOUNCE_MS) {
+        delayMs = Math.max(delayMs, this.backendRetryAt - Date.now());
         const dueMs = Date.now() + Math.max(0, delayMs);
-        if (this.debounceTimer && this.debounceDueMs <= dueMs)
+        if (this.debounceTimer &&
+            this.debounceDueMs <= dueMs &&
+            this.debounceDueMs >= this.backendRetryAt)
             return;
         if (this.debounceTimer)
             clearTimeout(this.debounceTimer);
@@ -234,7 +240,10 @@ class ProjectBatchProcessor {
         const run = (this.runOperation
             ? this.runOperation(execute)
             : execute(new AbortController().signal)).catch((err) => {
-            console.error(`[${this.wtag}] Batch processing failed:`, err);
+            if ((err === null || err === void 0 ? void 0 : err.name) === "AbortError")
+                (0, logger_1.log)(this.wtag, "Batch cancelled during shutdown");
+            else
+                console.error(`[${this.wtag}] Batch processing failed:`, err);
         });
         this.activeBatch = run;
         void run.finally(() => {
@@ -303,6 +312,7 @@ class ProjectBatchProcessor {
                 const metaDeletes = [];
                 const completed = new Set();
                 const retryFailures = new Set();
+                let backendUnavailable = false;
                 const requeuePath = (absPath, event, failed) => {
                     var _a;
                     var _b;
@@ -434,6 +444,11 @@ class ProjectBatchProcessor {
                         if (batchAc.signal.aborted)
                             return;
                         const code = err === null || err === void 0 ? void 0 : err.code;
+                        if ((0, embedding_error_1.isEmbeddingBackendUnavailable)(err)) {
+                            backendUnavailable = true;
+                            stopDispatch = true;
+                            return;
+                        }
                         if (code === "ENOENT") {
                             deletes.push(absPath);
                             metaDeletes.push(absPath);
@@ -479,6 +494,16 @@ class ProjectBatchProcessor {
                     yield schedule(() => processOne(absPath, event));
                 }
                 yield Promise.allSettled(activeTasks);
+                if (backendUnavailable) {
+                    this.backendFailures++;
+                    const backoffMs = Math.min(60000, 5000 * Math.pow(2, Math.min(this.backendFailures - 1, 4)));
+                    this.backendRetryAt = Date.now() + backoffMs;
+                    (0, logger_1.log)(this.wtag, `Embedding backend unavailable — preserving file retry budgets; retry in ${backoffMs / 1000}s`);
+                }
+                else {
+                    this.backendFailures = 0;
+                    this.backendRetryAt = 0;
+                }
                 const pureDeleteCandidates = new Set(metaDeletes);
                 const authoritativeMetaDeletes = new Set();
                 for (const absPath of pureDeleteCandidates) {

package/dist/lib/index/grammar-loader.js

@@ -56,15 +56,24 @@ for (const lang of languages_1.LANGUAGES) {
     }
 }
 const downloadFile = (url, dest) => __awaiter(void 0, void 0, void 0, function* () {
-    const response = yield fetch(url, {
-        headers: {
-            "User-Agent": "gmax",
-        },
-    });
-    if (!response.ok)
-        throw new Error(`Failed to download ${url}`);
-    const arrayBuffer = yield response.arrayBuffer();
-    fs.writeFileSync(dest, Buffer.from(arrayBuffer));
+    for (let attempt = 1; attempt <= 3; attempt++) {
+        try {
+            const response = yield fetch(url, {
+                headers: { "User-Agent": "gmax" },
+                signal: AbortSignal.timeout(30000),
+            });
+            if (!response.ok)
+                throw new Error(`Failed to download ${url}: HTTP ${response.status}`);
+            const arrayBuffer = yield response.arrayBuffer();
+            fs.writeFileSync(dest, Buffer.from(arrayBuffer));
+            return;
+        }
+        catch (error) {
+            if (attempt === 3)
+                throw error;
+            yield new Promise((resolve) => setTimeout(resolve, attempt * 500));
+        }
+    }
 });
 function ensureGrammars() {
     return __awaiter(this, arguments, void 0, function* (log = console.log, options) {
@@ -73,6 +82,7 @@ function ensureGrammars() {
             fs.mkdirSync(exports.GRAMMARS_DIR, { recursive: true });
         }
         const silent = (_a = options === null || options === void 0 ? void 0 : options.silent) !== null && _a !== void 0 ? _a : false;
+        const failed = [];
         for (const [lang, url] of Object.entries(GRAMMAR_URLS)) {
             const dest = path.join(exports.GRAMMARS_DIR, `tree-sitter-${lang}.wasm`);
             if (fs.existsSync(dest)) {
@@ -99,6 +109,7 @@ function ensureGrammars() {
                     }
                 }
                 catch (err) {
+                    failed.push(lang);
                     if (log === console.log) {
                         console.log("Failed");
                     }
@@ -106,5 +117,7 @@ function ensureGrammars() {
                 }
             }
         }
+        if ((options === null || options === void 0 ? void 0 : options.strict) && failed.length)
+            throw new Error(`Required grammars could not be downloaded: ${failed.join(", ")}`);
     });
 }

package/dist/lib/output/formatter.js

@@ -191,7 +191,7 @@ function formatTrace(graph, options) {
                 lines.push(`  ${style.cyan("↓")} ${style.green(callee.symbol)} ${style.dim(`(${callee.file}:${callee.line})`)}`);
             }
             else {
-                lines.push(`  ${style.cyan("↓")} ${callee.symbol} ${style.dim("(not indexed)")}`);
+                lines.push(`  ${style.cyan("↓")} ${callee.symbol} ${style.dim(callee.resolution === "ambiguous-member" ? "(receiver unresolved)" : "(not indexed)")}`);
             }
         });
     }

package/dist/lib/output/index-state-footer.js

@@ -14,17 +14,37 @@ exports.formatIndexStateFooter = formatIndexStateFooter;
  * while results may actually be incomplete.
  */
 function formatIndexStateFooter(state, opts) {
-    if (!(state === null || state === void 0 ? void 0 : state.indexing))
+    if (!state)
         return null;
-    // Re-verification is not incompleteness. Saying "results may be incomplete"
-    // while a catchup re-checks thousands of unchanged files trains agents to
-    // distrust and retry correct answers, which is worse than saying nothing.
+    const issues = [];
+    if (state.failedFiles)
+        issues.push(`${state.failedFiles} files failed`);
+    if (state.degraded && !state.failedFiles)
+        issues.push("reconciliation incomplete");
+    if (state.watcherMode === "polling")
+        issues.push("polling; changes may lag up to 5min");
+    if (state.watcherMode === "recovering")
+        issues.push("watcher recovering");
+    if (state.catchupRunning)
+        issues.push("reconciling filesystem changes");
+    if (issues.length) {
+        const next = state.failedFiles || state.degraded
+            ? "inspect gmax watch status; retry after recovery"
+            : "retry after reconciliation";
+        return opts.agent
+            ? `[index: ${issues.join(" · ")} · results may be incomplete · ${next}]`
+            : `Index: ${issues.join("; ")} — results may be incomplete; ${next}.`;
+    }
+    if (!state.indexing)
+        return null;
+    // Cache-hit samples suggest verification, but do not prove the remaining
+    // files are unchanged. Keep that distinction without claiming full coverage.
     if (state.verifying) {
         const n = state.pendingFiles;
         if (opts.agent) {
-            return `[index: verifying ~${n} unchanged files · results current]`;
+            return `[index: verifying ~${n} files · coverage not yet verified]`;
         }
-        return `Index verifying ${n} unchanged file${n === 1 ? "" : "s"} — results are current.`;
+        return `Index verifying ${n} file${n === 1 ? "" : "s"} — coverage is not yet verified.`;
     }
     const count = state.pendingFiles > 0 ? `~${state.pendingFiles} files pending` : null;
     if (opts.agent) {

package/dist/lib/utils/resource-snapshot.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildResourceSnapshot = buildResourceSnapshot;
+function buildResourceSnapshot(counters, memory = process.memoryUsage(), at = Date.now()) {
+    const mb = (bytes) => Math.round(bytes / 1024 / 1024);
+    return {
+        at,
+        reason: counters.reason,
+        footprintMb: counters.footprintMb,
+        rssMb: mb(memory.rss),
+        heapUsedMb: mb(memory.heapUsed),
+        externalMb: mb(memory.external),
+        arrayBuffersMb: mb(memory.arrayBuffers),
+        lanceCacheMb: counters.lanceCacheBytes === null ? null : mb(counters.lanceCacheBytes),
+        workers: counters.workers,
+        pendingFiles: counters.pendingFiles,
+        operations: counters.operations,
+        maintenance: counters.maintenance,
+    };
+}

package/dist/lib/utils/tests-footer.js

@@ -15,6 +15,7 @@ exports.fetchTestsForFooter = fetchTestsForFooter;
 exports.renderTestsFooterAgent = renderTestsFooterAgent;
 exports.renderTestsFooterHuman = renderTestsFooterHuman;
 const impact_1 = require("../graph/impact");
+const test_hits_1 = require("../graph/test-hits");
 /**
  * The footer is a courtesy line under a body the user asked for; it must never
  * make the command feel slow. Past this budget the lookup is abandoned and the
@@ -57,24 +58,10 @@ function fetchTestsForFooter(symbol, vectorDb, pathPrefix, excludePrefixes) {
 function relPath(p, projectRoot) {
     return p.startsWith(`${projectRoot}/`) ? p.slice(projectRoot.length + 1) : p;
 }
-function hopLabelAgent(hops) {
-    if (hops === -1)
-        return "via-import";
-    if (hops === 0)
-        return "direct";
-    return `${hops}-hop`;
-}
-function hopLabelHuman(hops) {
-    if (hops === -1)
-        return "via import";
-    if (hops === 0)
-        return "direct";
-    return `${hops} hop${hops > 1 ? "s" : ""}`;
-}
 function renderTestsFooterAgent(tests, projectRoot) {
     const lines = [];
     for (const t of tests.slice(0, MAX_SHOWN)) {
-        lines.push(`t: ${relPath(t.file, projectRoot)}:${t.line + 1}\t${t.symbol}\t${hopLabelAgent(t.hops)}`);
+        lines.push(`t: ${relPath(t.file, projectRoot)}:${t.line + 1}\t${t.symbol}\t${(0, test_hits_1.hopLabelAgent)(t.hops, t.evidence)}`);
     }
     if (tests.length > MAX_SHOWN) {
         lines.push(`t: ... ${tests.length - MAX_SHOWN} more`);
@@ -86,7 +73,12 @@ function renderTestsFooterHuman(tests, projectRoot) {
     lines.push("");
     lines.push(`tests (${tests.length}):`);
     for (const t of tests.slice(0, MAX_SHOWN)) {
-        lines.push(`  ${t.symbol.padEnd(25)} ${dim(`${relPath(t.file, projectRoot)}:${t.line + 1}`)} ${dim(`(${hopLabelHuman(t.hops)})`)}`);
+        const label = t.evidence
+            ? "same-file candidate"
+            : t.hops === -1
+                ? "via import"
+                : (0, test_hits_1.hopLabelAgent)(t.hops);
+        lines.push(`  ${t.symbol.padEnd(25)} ${dim(`${relPath(t.file, projectRoot)}:${t.line + 1}`)} ${dim(`(${label})`)}`);
     }
     if (tests.length > MAX_SHOWN) {
         lines.push(dim(`  ... and ${tests.length - MAX_SHOWN} more`));

package/dist/lib/workers/embedding-error.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EmbeddingBackendUnavailableError = void 0;
+exports.isEmbeddingBackendUnavailable = isEmbeddingBackendUnavailable;
+/** Shared backend outages are retryable; malformed inputs/protocols are not. */
+class EmbeddingBackendUnavailableError extends Error {
+    constructor(message) {
+        super(message);
+        this.code = "EMBED_BACKEND_UNAVAILABLE";
+        this.name = "EmbeddingBackendUnavailableError";
+    }
+}
+exports.EmbeddingBackendUnavailableError = EmbeddingBackendUnavailableError;
+function isEmbeddingBackendUnavailable(error) {
+    return ((error === null || error === void 0 ? void 0 : error.code) === "EMBED_BACKEND_UNAVAILABLE");
+}