@remnic/core 9.3.660 → 9.3.662

package/dist/{chunk-B57QYSWN.js → chunk-TGOOJCGA.js}

@@ -113,7 +113,7 @@ import {
   LastRecallStore,
   TierMigrationStatusStore,
   clampGraphRecallExpandedEntries
-} from "./chunk-FWIROLS6.js";
+} from "./chunk-44VFF3BB.js";
 import {
   applyReasoningTraceBoost
 } from "./chunk-ZZTOURJI.js";
@@ -319,11 +319,11 @@ import {
 } from "./chunk-2MXEVL75.js";
 import {
   NamespaceSearchRouter
-} from "./chunk-UNLHHTKN.js";
+} from "./chunk-WOQIHC67.js";
 import {
   createConversationIndexRuntime,
   createSearchBackend
-} from "./chunk-R2EBP6CM.js";
+} from "./chunk-35HP3TGR.js";
 import {
   NoopSearchBackend
 } from "./chunk-CYEPCZN5.js";
@@ -337,7 +337,7 @@ import {
 } from "./chunk-OIF36KGD.js";
 import {
   parseQmdExplain
-} from "./chunk-7PCZGNG2.js";
+} from "./chunk-6RHNCKHG.js";
 import {
   objectiveStateStoreOverrideForNamespace,
   searchObjectiveStateSnapshots
@@ -7619,20 +7619,25 @@ ${r.snippet.trim()}
         fetchLimit,
         primarySearchOptions,
         {
-          signal: options.abortSignal
+          signal: options.abortSignal,
+          onDegradation: options.onDegradation
         }
       ) : await this.qmd.search(
         prompt,
         options.collection,
         fetchLimit,
-        primarySearchOptions
+        primarySearchOptions,
+        { onDegradation: options.onDegradation }
       ) : await this.searchAcrossNamespaces({
         query: prompt,
         namespaces: options.namespacesEnabled ? options.recallNamespaces : void 0,
         maxResults: fetchLimit,
         mode: "search",
         searchOptions: primarySearchOptions,
-        execution: { signal: options.abortSignal }
+        execution: {
+          signal: options.abortSignal,
+          onDegradation: options.onDegradation
+        }
       });
       lastPrimaryResultCount = primaryResults.length;
       lastHybridResultCount = 0;
@@ -7650,14 +7655,18 @@ ${r.snippet.trim()}
             options.collection,
             fetchLimit,
             {
-              signal: options.abortSignal
+              signal: options.abortSignal,
+              onDegradation: options.onDegradation
             }
           ) : await this.searchAcrossNamespaces({
             query: prompt,
             namespaces: options.namespacesEnabled ? options.recallNamespaces : void 0,
             maxResults: fetchLimit,
             mode: "hybrid",
-            execution: { signal: options.abortSignal }
+            execution: {
+              signal: options.abortSignal,
+              onDegradation: options.onDegradation
+            }
           });
           lastHybridResultCount = hybridResults.length;
           lastHybridTopUpUsed = hybridResults.length > 0;
@@ -8174,6 +8183,7 @@ ${r.snippet.trim()}
   }
   async recallInternal(prompt, sessionKey, options = {}) {
     const recallStart = Date.now();
+    const backendDegradations = [];
     let asOfMs;
     if (typeof options.asOf === "string" && options.asOf.length > 0) {
       const parsed = Date.parse(options.asOf);
@@ -9655,6 +9665,19 @@ ${rows.join("\n")}
       const qmdPromise = observeEnrichmentPromise(
         (async () => {
           const t0 = Date.now();
+          const phaseDegradationsStart = backendDegradations.length;
+          const replayCachedDegradations = (value) => {
+            for (const degradation of value.degradations ?? []) {
+              backendDegradations.push(degradation);
+            }
+          };
+          const reportRecallQmdUnavailable = (detail) => {
+            backendDegradations.push({
+              backend: "qmd",
+              code: "backend_unavailable",
+              detail
+            });
+          };
           if (recallResultLimit <= 0) {
             recordRecallSectionMetric({
               section: "qmd",
@@ -9703,6 +9726,7 @@ ${rows.join("\n")}
               success: true,
               timing: `${Math.max(0, Math.round(cachedQmd.ageMs))}ms-cache`
             });
+            replayCachedDegradations(cachedQmd.value);
             if (queryAwarePrefilterIsEmpty) {
               return emptyQueryAwareQmdResult;
             }
@@ -9722,6 +9746,8 @@ ${rows.join("\n")}
                   success: true,
                   timing: `stale-cache(reprobe-cooldown:${Math.max(0, Math.round(staleQmdFallback.ageMs))}ms)`
                 });
+                reportRecallQmdUnavailable("served stale recall cache (reprobe cooldown)");
+                replayCachedDegradations(staleQmdFallback.value);
                 if (queryAwarePrefilterIsEmpty) {
                   return emptyQueryAwareQmdResult;
                 }
@@ -9736,6 +9762,7 @@ ${rows.join("\n")}
                 success: true,
                 timing: "skip(reprobe-cooldown)"
               });
+              reportRecallQmdUnavailable("recall skipped QMD (reprobe cooldown)");
               return null;
             }
             this.lastQmdReprobeAtMs = now;
@@ -9751,6 +9778,8 @@ ${rows.join("\n")}
                   success: true,
                   timing: `stale-cache(reprobe-failed:${Math.max(0, Math.round(staleQmdFallback.ageMs))}ms)`
                 });
+                reportRecallQmdUnavailable("served stale recall cache (reprobe failed)");
+                replayCachedDegradations(staleQmdFallback.value);
                 if (queryAwarePrefilterIsEmpty) {
                   return emptyQueryAwareQmdResult;
                 }
@@ -9768,6 +9797,7 @@ ${rows.join("\n")}
               log.debug(
                 `Search skip (re-probe failed): ${this.qmd.debugStatus()}`
               );
+              reportRecallQmdUnavailable("recall skipped QMD (reprobe failed)");
               return null;
             }
             log.info(`QMD re-probe succeeded: ${this.qmd.debugStatus()}`);
@@ -9832,6 +9862,9 @@ ${rows.join("\n")}
                 queryAwarePrefilter,
                 searchOptions: qmdSearchOptions,
                 abortSignal: qmdEnrichmentAbort.signal,
+                onDegradation: (degradation) => {
+                  backendDegradations.push(degradation);
+                },
                 onDebugSnapshot: async (snapshot) => {
                   await this.recordLastQmdRecallSnapshot({
                     storage: profileStorage,
@@ -9871,11 +9904,15 @@ ${rows.join("\n")}
                 maxSpecializedScore = 0;
               }
             }
+            const phaseDegradations = backendDegradations.slice(
+              phaseDegradationsStart
+            );
             const result = {
               memoryResultsLists: [augmentedResults],
               globalResults: [],
               preAugmentTopScore,
-              maxSpecializedScore
+              maxSpecializedScore,
+              ...phaseDegradations.length > 0 ? { degradations: phaseDegradations } : {}
             };
             if (augmentedResults.length > 0 || result.globalResults.length > 0) {
               setCachedQmdRecall(qmdCacheKey, result, {
@@ -9902,6 +9939,8 @@ ${rows.join("\n")}
                 success: true,
                 timing: `stale-cache(${err instanceof Error ? err.message : String(err)})`
               });
+              reportRecallQmdUnavailable("served stale recall cache (qmd phase error)");
+              replayCachedDegradations(staleQmdFallback.value);
               if (queryAwarePrefilterIsEmpty) {
                 return emptyQueryAwareQmdResult;
               }
@@ -9921,7 +9960,16 @@ ${rows.join("\n")}
           );
           return null;
         }).finally(() => qmdEnrichmentAbort.dispose()),
-        () => qmdEnrichmentAbort.cancel()
+        () => {
+          if (!options.abortSignal?.aborted) {
+            backendDegradations.push({
+              backend: "qmd",
+              code: "deadline_exceeded",
+              detail: "hot qmd enrichment abandoned (enrichment deadline)"
+            });
+          }
+          qmdEnrichmentAbort.cancel();
+        }
       );
       const transcriptPromise = (async () => {
         const t0 = Date.now();
@@ -11233,6 +11281,9 @@ ${tmtNode.summary}`
                 recallMode,
                 queryAwarePrefilter,
                 abortSignal: options.abortSignal,
+                onDegradation: (degradation) => {
+                  backendDegradations.push(degradation);
+                },
                 xrayPoolSizeSink: xrayColdPoolSink,
                 deadlineAtMs: enrichmentAssemblyDeadlineAtMs,
                 asOfMs,
@@ -11401,6 +11452,9 @@ ${tmtNode.summary}`
                   recallMode,
                   queryAwarePrefilter,
                   abortSignal: options.abortSignal,
+                  onDegradation: (degradation) => {
+                    backendDegradations.push(degradation);
+                  },
                   xrayPoolSizeSink: xrayColdPoolSink,
                   deadlineAtMs: enrichmentAssemblyDeadlineAtMs,
                   asOfMs,
@@ -11497,6 +11551,9 @@ ${tmtNode.summary}`
                     recallMode,
                     queryAwarePrefilter,
                     abortSignal: options.abortSignal,
+                    onDegradation: (degradation) => {
+                      backendDegradations.push(degradation);
+                    },
                     xrayPoolSizeSink: xrayColdPoolSink,
                     deadlineAtMs: enrichmentAssemblyDeadlineAtMs,
                     asOfMs,
@@ -11538,6 +11595,9 @@ ${tmtNode.summary}`
                 recallMode,
                 queryAwarePrefilter,
                 abortSignal: options.abortSignal,
+                onDegradation: (degradation) => {
+                  backendDegradations.push(degradation);
+                },
                 xrayPoolSizeSink: xrayColdPoolSink,
                 deadlineAtMs: enrichmentAssemblyDeadlineAtMs,
                 asOfMs,
@@ -11850,7 +11910,13 @@ _Context: ${topQuestion.context}_`
             mode: identityInjectionModeUsed,
             injectedChars: identityInjectedChars,
             truncated: identityInjectionTruncated
-          }
+          },
+          // Included at record time so the published snapshot is born
+          // annotated — a post-record annotation leaves a window where
+          // readers see the snapshot without degradations, and a concurrent
+          // same-session recall could drop them entirely (codex + cursor
+          // reviews on #1544).
+          backendDegradations: backendDegradations.length > 0 ? backendDegradations : void 0
         }).catch((err) => log.debug(`last recall record failed: ${err}`));
       }
       if (sessionKey) {
@@ -16245,10 +16311,14 @@ ${lines.join("\n\n")}`;
       return [];
     }
     const deadlineRemainingMs = () => typeof options.deadlineAtMs === "number" ? Math.max(0, options.deadlineAtMs - Date.now()) : null;
-    const runColdStepWithinDeadline = async (label, fallback, task) => {
+    const runColdStepWithinDeadline = async (label, fallback, task, onDeadline) => {
       throwIfRecallAborted(options.abortSignal);
       const remainingMs = deadlineRemainingMs();
       if (remainingMs === 0) {
+        try {
+          onDeadline?.();
+        } catch {
+        }
         log.debug(`cold-tier recall ${label} skipped: shared assembly deadline expired`);
         return fallback;
       }
@@ -16268,6 +16338,10 @@ ${lines.join("\n\n")}`;
           new Promise((resolve) => {
             timeoutHandle = setTimeout(() => {
               timedOut = true;
+              try {
+                onDeadline?.();
+              } catch {
+              }
               log.debug(
                 `cold-tier recall ${label} skipped: shared assembly deadline expired`
               );
@@ -16294,6 +16368,18 @@ ${lines.join("\n\n")}`;
           false,
           0
         );
+        let coldQmdObserverActive = true;
+        const reportColdQmdDeadline = () => {
+          coldQmdObserverActive = false;
+          try {
+            options.onDegradation?.({
+              backend: "qmd",
+              code: "deadline_exceeded",
+              detail: "cold-tier qmd lookup abandoned (assembly deadline)"
+            });
+          } catch {
+          }
+        };
         longTerm = await runColdStepWithinDeadline(
           "qmd lookup",
           [],
@@ -16308,10 +16394,17 @@ ${lines.join("\n\n")}`;
               collection: coldCollection,
               queryAwarePrefilter: options.queryAwarePrefilter,
               searchOptions: this.buildConfiguredQmdSearchOptions(options.prompt),
-              abortSignal: options.abortSignal
+              abortSignal: options.abortSignal,
+              onDegradation: (degradation) => {
+                if (coldQmdObserverActive) {
+                  options.onDegradation?.(degradation);
+                }
+              }
             }
-          )
+          ),
+          reportColdQmdDeadline
         );
+        coldQmdObserverActive = false;
         if (longTerm.length > 0) {
           log.debug(
             `cold-tier recall source=cold-qmd collection=${coldCollection} hits=${longTerm.length}`
@@ -17242,4 +17335,4 @@ export {
   resolvePersistedMemoryRelativePath,
   Orchestrator
 };
-//# sourceMappingURL=chunk-B57QYSWN.js.map
+//# sourceMappingURL=chunk-TGOOJCGA.js.map