@remnic/core 9.3.660 → 9.3.662

package/dist/{chunk-OYXVENIS.js → chunk-4KDLCMLK.js}

@@ -6,10 +6,10 @@ import {
 } from "./chunk-7WV3F5DQ.js";
 import {
   EngramMcpServer
-} from "./chunk-7H7J3ZWN.js";
+} from "./chunk-2KDQI363.js";
 import {
   EngramAccessInputError
-} from "./chunk-RP2U54GG.js";
+} from "./chunk-DFAXGZKI.js";
 import {
   projectTagProjectId
 } from "./chunk-GYSYLGNE.js";
@@ -2030,4 +2030,4 @@ function positiveIntQueryParam(value, label) {
 export {
   EngramAccessHttpServer
 };
-//# sourceMappingURL=chunk-OYXVENIS.js.map
+//# sourceMappingURL=chunk-4KDLCMLK.js.map

package/dist/{chunk-MO77TWPS.js → chunk-5AYAZN45.js}

@@ -1,6 +1,6 @@
 import {
   listNamespaces
-} from "./chunk-256W7AXC.js";
+} from "./chunk-YYQRVNSV.js";
 import {
   runConsolidationProvenanceCheck
 } from "./chunk-AL4RAJL5.js";
@@ -1336,4 +1336,4 @@ export {
   runBenchmarkRecall,
   runOperatorRepair
 };
-//# sourceMappingURL=chunk-MO77TWPS.js.map
+//# sourceMappingURL=chunk-5AYAZN45.js.map

package/dist/{chunk-7PCZGNG2.js → chunk-6RHNCKHG.js}

@@ -1,6 +1,6 @@
 import {
   resolveEnsureCollectionArgs
-} from "./chunk-M3VYPE2H.js";
+} from "./chunk-YNQ6DFSV.js";
 import {
   launchProcess
 } from "./chunk-O75CRYGF.js";
@@ -832,6 +832,7 @@ async function releaseSharedDaemonSession(session) {
     return;
   }
 }
+var sharedDaemonSessionCountForTest = () => SHARED_DAEMON_SESSIONS.size;
 var QmdClient = class _QmdClient {
   constructor(collection, maxResults, opts) {
     this.collection = collection;
@@ -1421,7 +1422,10 @@ var QmdClient = class _QmdClient {
     const trimmed = query.trim();
     if (!trimmed) return [];
     await this.maybeProbeDaemon();
-    if (!this.isAvailable()) return [];
+    if (!this.isAvailable()) {
+      this.notifyDegradation(execution?.onDegradation, "backend_unavailable");
+      return [];
+    }
     const col = collection ?? this.collection;
     const n = maxResults ?? this.maxResults;
     const searchOptions = this.resolveSearchOptions(options);
@@ -1450,22 +1454,40 @@ var QmdClient = class _QmdClient {
         setCachedQmdSearch(cacheKey, results);
         return results;
       }
-      log.debug("QMD daemon search timed out/failed; skipping subprocess (daemon-only mode)");
+      log.warn("QMD daemon search timed out/failed; skipping subprocess (daemon-only mode)");
+      this.notifyDegradation(execution?.onDegradation, "daemon_timeout");
       return [];
     }
     if (this.daemonSession?.isLoading()) {
       log.debug("QMD search: daemon loading, skipping subprocess");
+      this.notifyDegradation(execution?.onDegradation, "daemon_loading");
       return [];
     }
-    const subprocessResults = await this.searchViaSubprocess(trimmed, col, n, searchOptions, execution?.signal);
-    setCachedQmdSearch(cacheKey, subprocessResults);
+    let subprocessDegraded = false;
+    const subprocessResults = await this.searchViaSubprocess(
+      trimmed,
+      col,
+      n,
+      searchOptions,
+      execution?.signal,
+      (degradation) => {
+        subprocessDegraded = true;
+        this.notifyDegradation(execution?.onDegradation, degradation.code, degradation.detail);
+      }
+    );
+    if (!subprocessDegraded) {
+      setCachedQmdSearch(cacheKey, subprocessResults);
+    }
     return subprocessResults;
   }
   async searchGlobal(query, maxResults, execution) {
     const trimmed = query.trim();
     if (!trimmed) return [];
     await this.maybeProbeDaemon();
-    if (!this.isAvailable()) return [];
+    if (!this.isAvailable()) {
+      this.notifyDegradation(execution?.onDegradation, "backend_unavailable");
+      return [];
+    }
     const n = maxResults ?? 6;
     const searchOptions = this.resolveSearchOptions();
     if (this.daemonAvailable) {
@@ -1484,14 +1506,22 @@ var QmdClient = class _QmdClient {
         }
         return results;
       }
-      log.debug("QMD daemon global search timed out/failed; skipping subprocess (daemon-only mode)");
+      log.warn("QMD daemon global search timed out/failed; skipping subprocess (daemon-only mode)");
+      this.notifyDegradation(execution?.onDegradation, "daemon_timeout");
       return [];
     }
     if (this.daemonSession?.isLoading()) {
       log.debug("QMD searchGlobal: daemon loading, skipping subprocess");
+      this.notifyDegradation(execution?.onDegradation, "daemon_loading");
       return [];
     }
-    return this.searchGlobalViaSubprocess(trimmed, n, searchOptions, execution?.signal);
+    return this.searchGlobalViaSubprocess(
+      trimmed,
+      n,
+      searchOptions,
+      execution?.signal,
+      execution?.onDegradation
+    );
   }
   /**
    * BM25 keyword search (fast, ~0.3s). Uses `qmd search`.
@@ -1500,7 +1530,10 @@ var QmdClient = class _QmdClient {
     const trimmed = query.trim();
     if (!trimmed) return [];
     await this.maybeProbeDaemon();
-    if (!this.isAvailable()) return [];
+    if (!this.isAvailable()) {
+      this.notifyDegradation(execution?.onDegradation, "backend_unavailable");
+      return [];
+    }
     const col = collection ?? this.collection;
     const n = maxResults ?? this.maxResults;
     if (this.daemonAvailable && this.daemonSession) {
@@ -1519,14 +1552,16 @@ var QmdClient = class _QmdClient {
         }
         return results;
       }
-      log.debug("QMD daemon bm25 timed out/failed; skipping subprocess (daemon-only mode)");
+      log.warn("QMD daemon bm25 timed out/failed; skipping subprocess (daemon-only mode)");
+      this.notifyDegradation(execution?.onDegradation, "daemon_timeout");
       return [];
     }
     if (this.daemonSession?.isLoading()) {
       log.debug("QMD bm25: daemon loading, skipping subprocess");
+      this.notifyDegradation(execution?.onDegradation, "daemon_loading");
       return [];
     }
-    return this.bm25SearchViaSubprocess(trimmed, col, n, execution?.signal);
+    return this.bm25SearchViaSubprocess(trimmed, col, n, execution?.signal, execution?.onDegradation);
   }
   /**
    * Vector similarity search (~3-4s). Uses `qmd vsearch`.
@@ -1535,7 +1570,10 @@ var QmdClient = class _QmdClient {
     const trimmed = query.trim();
     if (!trimmed) return [];
     await this.maybeProbeDaemon();
-    if (!this.isAvailable()) return [];
+    if (!this.isAvailable()) {
+      this.notifyDegradation(execution?.onDegradation, "backend_unavailable");
+      return [];
+    }
     const col = collection ?? this.collection;
     const n = maxResults ?? this.maxResults;
     if (this.daemonAvailable && this.daemonSession) {
@@ -1554,14 +1592,16 @@ var QmdClient = class _QmdClient {
         }
         return results;
       }
-      log.debug("QMD daemon vsearch timed out/failed; skipping subprocess (daemon-only mode)");
+      log.warn("QMD daemon vsearch timed out/failed; skipping subprocess (daemon-only mode)");
+      this.notifyDegradation(execution?.onDegradation, "daemon_timeout");
       return [];
     }
     if (this.daemonSession?.isLoading()) {
       log.debug("QMD vsearch: daemon loading, skipping subprocess");
+      this.notifyDegradation(execution?.onDegradation, "daemon_loading");
       return [];
     }
-    return this.vsearchViaSubprocess(trimmed, col, n, execution?.signal);
+    return this.vsearchViaSubprocess(trimmed, col, n, execution?.signal, execution?.onDegradation);
   }
   /**
    * Hybrid search: runs BM25 + vector in parallel, merges/dedupes by path
@@ -1721,10 +1761,48 @@ var QmdClient = class _QmdClient {
       return null;
     }
   }
-  async searchViaSubprocess(query, collection, maxResults, options, signal) {
+  /**
+   * Report a backend degradation to the caller's observer (#1536): an empty
+   * result caused by unavailability/loading/timeout is otherwise
+   * indistinguishable from "no matches" (CLAUDE.md rule 34). Observer
+   * failures are swallowed — observability must never break search.
+   */
+  notifyDegradation(onDegradation, code, detail) {
+    if (!onDegradation) return;
+    try {
+      onDegradation({ backend: "qmd", code, ...detail !== void 0 ? { detail } : {} });
+    } catch (err) {
+      log.debug(`QMD degradation observer threw: ${err}`);
+    }
+  }
+  /**
+   * Condense an error into a degradation `detail` string that is safe to
+   * serialize on LastRecallSnapshot and expose via last-recall MCP/HTTP
+   * surfaces (cursor review on #1544): first line only, path-like tokens
+   * redacted (absolute, home-rooted, and Windows drive paths can leak
+   * usernames and filesystem layout), capped at 160 chars. The unredacted
+   * error still reaches operators via the warn log at the failure site.
+   */
+  degradationDetail(err, sensitive) {
+    let message = String(err instanceof Error ? err.message : err);
+    for (const value of sensitive ?? []) {
+      if (typeof value !== "string" || value.length === 0) continue;
+      message = message.split(value).join("<query>");
+      for (const fragment of value.split("\n")) {
+        const trimmed = fragment.trim();
+        if (trimmed.length >= 4) {
+          message = message.split(trimmed).join("<query>");
+        }
+      }
+    }
+    const firstLine = message.split("\n")[0] ?? "";
+    const redacted = firstLine.replace(/(?:~|\/|[A-Za-z]:\\)[^\s'"`]+/g, "<path>");
+    return redacted.length > 160 ? `${redacted.slice(0, 159)}\u2026` : redacted;
+  }
+  async searchViaSubprocess(query, collection, maxResults, options, signal, onDegradation) {
     if (this.available === false) return [];
     if (this.qmdSubprocessStrategy === "search") {
-      return this.bm25SearchViaSubprocess(query, collection, maxResults, signal);
+      return this.bm25SearchViaSubprocess(query, collection, maxResults, signal, onDegradation);
     }
     const startedAtMs = Date.now();
     try {
@@ -1744,11 +1822,13 @@ var QmdClient = class _QmdClient {
       if (isCallerCancellation(err, signal)) {
         throw isAbortError(err) ? err : abortError("QMD subprocess search aborted");
       }
-      log.debug(`QMD search failed: ${err}`);
+      const detail = this.degradationDetail(err, [query]);
+      log.warn(`QMD subprocess search failed (returning empty): ${detail}`);
+      this.notifyDegradation(onDegradation, "subprocess_error", detail);
       return [];
     }
   }
-  async bm25SearchViaSubprocess(query, collection, maxResults, signal) {
+  async bm25SearchViaSubprocess(query, collection, maxResults, signal, onDegradation) {
     if (this.available === false) return [];
     const startedAtMs = Date.now();
     try {
@@ -1762,11 +1842,13 @@ var QmdClient = class _QmdClient {
       if (isCallerCancellation(err, signal)) {
         throw isAbortError(err) ? err : abortError("QMD subprocess bm25 aborted");
       }
-      log.debug(`QMD bm25 search failed: ${err}`);
+      const detail = this.degradationDetail(err, [query]);
+      log.warn(`QMD bm25 subprocess search failed (returning empty): ${detail}`);
+      this.notifyDegradation(onDegradation, "subprocess_error", detail);
       return [];
     }
   }
-  async vsearchViaSubprocess(query, collection, maxResults, signal) {
+  async vsearchViaSubprocess(query, collection, maxResults, signal, onDegradation) {
     if (this.available === false) return [];
     const startedAtMs = Date.now();
     try {
@@ -1781,11 +1863,13 @@ var QmdClient = class _QmdClient {
       if (isCallerCancellation(err, signal)) {
         throw isAbortError(err) ? err : abortError("QMD subprocess vsearch aborted");
       }
-      log.debug(`QMD vsearch failed: ${err}`);
+      const detail = this.degradationDetail(err, [query]);
+      log.warn(`QMD vsearch subprocess failed (returning empty): ${detail}`);
+      this.notifyDegradation(onDegradation, "subprocess_error", detail);
       return [];
     }
   }
-  async searchGlobalViaSubprocess(query, maxResults, options, signal) {
+  async searchGlobalViaSubprocess(query, maxResults, options, signal, onDegradation) {
     if (this.available === false) return [];
     const startedAtMs = Date.now();
     try {
@@ -1808,7 +1892,9 @@ var QmdClient = class _QmdClient {
       if (isCallerCancellation(err, signal)) {
         throw isAbortError(err) ? err : abortError("QMD subprocess global search aborted");
       }
-      log.debug(`QMD global search failed: ${err}`);
+      const detail = this.degradationDetail(err, [query]);
+      log.warn(`QMD global subprocess search failed (returning empty): ${detail}`);
+      this.notifyDegradation(onDegradation, "subprocess_error", detail);
       return [];
     }
   }
@@ -2134,6 +2220,9 @@ export {
   buildDefaultStructuredSearches,
   parseQmdExplain,
   getQmdCommandName,
+  retainSharedDaemonSession,
+  releaseSharedDaemonSession,
+  sharedDaemonSessionCountForTest,
   QmdClient
 };
-//# sourceMappingURL=chunk-7PCZGNG2.js.map
+//# sourceMappingURL=chunk-6RHNCKHG.js.map