@remnic/core 9.3.727 → 9.3.729

package/dist/{chunk-XPHVAOBT.js → chunk-HEDZUSCS.js}

@@ -154,7 +154,7 @@ import {
 } from "./chunk-LTHVM4XN.js";
 import {
   ExtractionEngine
-} from "./chunk-CSRXQ6NB.js";
+} from "./chunk-I5REUWLH.js";
 import {
   parseMemoryActionEligibilityContext
 } from "./chunk-5GSUBCZM.js";
@@ -187,7 +187,7 @@ import {
 } from "./chunk-Q6IP2ARR.js";
 import {
   EmbeddingFallback
-} from "./chunk-ZA2S2VLL.js";
+} from "./chunk-C2PG7IEH.js";
 import {
   buildEntityRecallSection,
   entityRecentTranscriptLookbackHours,
@@ -333,11 +333,11 @@ import {
 } from "./chunk-J6BH2OBA.js";
 import {
   NamespaceSearchRouter
-} from "./chunk-CTOQEZSN.js";
+} from "./chunk-V4GNSDFH.js";
 import {
   createConversationIndexRuntime,
   createSearchBackend
-} from "./chunk-2KAYTPPT.js";
+} from "./chunk-UTHQPSRC.js";
 import {
   NoopSearchBackend
 } from "./chunk-CYEPCZN5.js";
@@ -363,8 +363,9 @@ import {
 } from "./chunk-EH5ED3C6.js";
 import {
   resolveCapabilities,
-  resolveGraphConstructionCapabilities
-} from "./chunk-DVRHLN2O.js";
+  resolveGraphConstructionCapabilities,
+  resolveMemoryLifecycleCapabilities
+} from "./chunk-3RCBIOOJ.js";
 import {
   searchCausalTrajectories
 } from "./chunk-SQNED75R.js";
@@ -745,6 +746,130 @@ var TierMigrationCoordinator = class {
   }
 };
 
+// src/orchestration/extraction-queue-coordinator.ts
+var ExtractionQueueCoordinator = class {
+  /**
+   * Background serial queue for extractions (agent_end optimization).
+   * Queue stores tasks that resolve when extraction should run.
+   */
+  queue = [];
+  /** Whether the serial drain loop is currently running. */
+  processing = false;
+  /** Current queue depth (idle-wait + test seam). */
+  get length() {
+    return this.queue.length;
+  }
+  /** Whether the serial drain loop is currently running (idle-wait + test seam). */
+  get isProcessing() {
+    return this.processing;
+  }
+  /**
+   * Enqueue a task and start the serial processor if it is idle. This is
+   * the production entry point — the orchestrator's `queueBufferedExtraction`
+   * builds each task closure and hands it here.
+   */
+  enqueue(task) {
+    this.queue.push(task);
+    if (!this.processing) {
+      this.processing = true;
+      this.processQueue().catch((err) => {
+        this.logExtractionQueueFailure(err, "processor");
+        this.processing = false;
+      });
+    }
+  }
+  /**
+   * Background serial queue processor.
+   * Processes extractions one at a time to avoid race conditions.
+   * Called automatically when items are queued via `enqueue`; also exposed
+   * for the characterization tests that push raw tasks and assert drain
+   * semantics directly.
+   */
+  async processQueue() {
+    while (this.queue.length > 0) {
+      const task = this.queue.shift();
+      if (task) {
+        try {
+          await task();
+        } catch (err) {
+          this.logExtractionQueueFailure(err, "task");
+        }
+      }
+    }
+    this.processing = false;
+  }
+  /**
+   * Classify + log a failure from either the per-task catch inside
+   * `processQueue()` or the outer `processQueue().catch(...)` in
+   * `enqueue()`.  Issue #549: `throwIfRecallAborted`
+   * (used throughout `runExtraction`) raises an Error whose `name` is
+   * `"AbortError"`.  That path fires when `before_reset` aborts a
+   * queued task to avoid duplicate extraction — it is intentional
+   * cancellation, not a failure.  Downgrading the log to debug
+   * prevents spurious `error`-level lines that routinely appear
+   * right next to a successful `persisted: N facts, M entities` log
+   * and that confuse operators into thinking extraction is broken.
+   * Genuine extraction failures (network, parse, I/O) still log at
+   * `error`.
+   *
+   * Source differentiates the two call sites so the log message
+   * names the right layer (`task` vs `processor`).
+   */
+  logExtractionQueueFailure(err, source) {
+    const aborted = source === "task" ? "background extraction task aborted (session transition)" : "background extraction queue processor aborted (session transition)";
+    const failed = source === "task" ? "background extraction task failed" : "background extraction queue processor failed";
+    if (isAbortError(err)) {
+      log.debug(aborted);
+    } else {
+      log.error(failed, err);
+    }
+  }
+  /**
+   * Wait until the extraction queue is fully drained (no tasks queued, no
+   * drain in flight) or `timeoutMs` elapses. Used by bootstrap (after a
+   * dry-run import) and by tests that need to assert extraction settled.
+   * Returns false on timeout, true once idle.
+   */
+  async waitForIdle(timeoutMs = 6e4) {
+    const started = Date.now();
+    while (this.processing || this.queue.length > 0) {
+      if (Date.now() - started > timeoutMs) {
+        log.warn(`waitForExtractionIdle timed out after ${timeoutMs}ms`);
+        return false;
+      }
+      const { promise, resolve } = Promise.withResolvers();
+      setTimeout(resolve, 50);
+      await promise;
+    }
+    return true;
+  }
+  // ── Test seams ─────────────────────────────────────────────────────────
+  // Mirror the pre-extraction `orchestrator.extractionQueue` /
+  // `orchestrator.queueProcessing` direct-field access the characterization
+  // and flush deadline tests relied on. Each is a thin, well-named handle
+  // onto the coordinator's private state — no behavior change.
+  /**
+   * Push a raw task WITHOUT auto-starting the processor, matching the
+   * pre-extraction `this.extractionQueue.push(...)` used by the
+   * characterization tests that drive the drain manually via `processQueue`.
+   */
+  pushRaw(task) {
+    this.queue.push(task);
+  }
+  /** Remove + return the front task (test seam for the flush deadline tests). */
+  shift() {
+    return this.queue.shift();
+  }
+  /**
+   * Force the processor-busy flag so `enqueue` does not auto-start the
+   * drain — used by the flush deadline test to simulate a busy queue and
+   * assert a queued task's deadline expires while it waits.
+   */
+  setProcessingForTest(value) {
+    this.processing = value;
+  }
+};
+
 // src/maintenance/pattern-reinforcement.ts
 function patternReinforcementKey(content) {
   return content.trim().toLowerCase().replace(/\s+/g, " ").slice(0, 200);
@@ -2997,10 +3122,14 @@ var Orchestrator = class _Orchestrator {
   passiveCorrectionDedup = /* @__PURE__ */ new Set();
   _passiveCorrectionService = null;
   passiveCorrectionTelemetry = { detected: 0, queued: 0, autoApplied: 0, suppressedReasonCounts: {} };
-  // Background serial queue for extractions (agent_end optimization)
-  // Queue stores promises that resolve when extraction should run
-  extractionQueue = [];
-  queueProcessing = false;
+  /**
+   * Background serial extraction queue coordinator (issue #1526 — moved
+   * from inline `extractionQueue`/`queueProcessing` fields). Owns queue
+   * state + scheduling + the serial drain + failure classification; the
+   * orchestrator builds each task closure in `queueBufferedExtraction` and
+   * hands it to `enqueue`.
+   */
+  extractionQueueCoordinator;
   heartbeatObserverChains = /* @__PURE__ */ new Map();
   recentExtractionFingerprints = /* @__PURE__ */ new Map();
   consolidationObservers = /* @__PURE__ */ new Set();
@@ -3705,6 +3834,7 @@ var Orchestrator = class _Orchestrator {
       namespaceSearchRouter: this.namespaceSearchRouter,
       namespaceCatalog: this.namespaceCatalog
     });
+    this.extractionQueueCoordinator = new ExtractionQueueCoordinator();
     const conversationIndexRuntime = createConversationIndexRuntime(config, {
       getQmd: () => this.conversationQmd,
       getFaiss: () => this.conversationFaiss
@@ -3787,8 +3917,9 @@ var Orchestrator = class _Orchestrator {
       path3.join(config.memoryDir, "threads"),
       config.threadingGapMinutes
     );
+    const lifecycleCaps = resolveMemoryLifecycleCapabilities(config);
     this.tmtBuilder = new TmtBuilder(config.memoryDir, {
-      temporalMemoryTreeEnabled: config.temporalMemoryTreeEnabled,
+      temporalMemoryTreeEnabled: lifecycleCaps.temporalMemoryTree,
       tmtHourlyMinMemories: config.tmtHourlyMinMemories,
       tmtSummaryMaxTokens: config.tmtSummaryMaxTokens
     });
@@ -4182,6 +4313,7 @@ var Orchestrator = class _Orchestrator {
     }
   }
   async deferredInitialize(signal) {
+    const lifecycleCaps = resolveMemoryLifecycleCapabilities(this.config);
     if (this.qmd.isAvailable() && this.config.qmdMaintenanceEnabled) {
       try {
         log.info("QMD startup sync: updating index to match current disk state");
@@ -4215,7 +4347,7 @@ var Orchestrator = class _Orchestrator {
         })
       );
     }
-    if (this.config.embeddingFallbackEnabled) {
+    if (resolveMemoryLifecycleCapabilities(this.config).embeddingFallback) {
       warmupPromises.push(
         this.embeddingFallback.isAvailable().then((ok) => {
           log.info(
@@ -4279,9 +4411,9 @@ var Orchestrator = class _Orchestrator {
     if (signal.aborted) return;
     await this.maintenanceScheduler.autoRegisterCrons(signal);
     if (signal.aborted) return;
-    if (this.config.lifecyclePolicyEnabled && this.config.qmdTierMigrationEnabled) {
+    if (lifecycleCaps.lifecyclePolicy && this.config.qmdTierMigrationEnabled) {
       try {
-        const { runFirstStartMigration } = await import("./first-start-migration-PG5HBC3K.js");
+        const { runFirstStartMigration } = await import("./first-start-migration-22LPFHD5.js");
         const result = await runFirstStartMigration({
           storage: this.storage,
           config: this.config,
@@ -4506,6 +4638,7 @@ var Orchestrator = class _Orchestrator {
    * default storage.
    */
   async runLifecyclePolicyFanout() {
+    const lifecycleCaps = resolveMemoryLifecycleCapabilities(this.config);
     return this.runNamespaceMaintenanceFanoutForJob(
       "lifecycle",
       async (ctx) => {
@@ -4514,7 +4647,7 @@ var Orchestrator = class _Orchestrator {
         const assessed = await this.runLifecyclePolicyPass(corpus, storage);
         return { itemCount: assessed };
       },
-      { enabled: this.config.lifecyclePolicyEnabled }
+      { enabled: lifecycleCaps.lifecyclePolicy }
     );
   }
   /**
@@ -4924,15 +5057,7 @@ ${doc.content}` : doc.content,
     return result;
   }
   async waitForExtractionIdle(timeoutMs = 6e4) {
-    const started = Date.now();
-    while (this.queueProcessing || this.extractionQueue.length > 0) {
-      if (Date.now() - started > timeoutMs) {
-        log.warn(`waitForExtractionIdle timed out after ${timeoutMs}ms`);
-        return false;
-      }
-      await new Promise((resolve) => setTimeout(resolve, 50));
-    }
-    return true;
+    return this.extractionQueueCoordinator.waitForIdle(timeoutMs);
   }
   async waitForConsolidationIdle(timeoutMs = 6e4) {
     const started = Date.now();
@@ -6832,7 +6957,7 @@ ${r.snippet.trim()}
   recallAssemblyClockMs() {
     return Date.now();
   }
-  async recallInternal(prompt, sessionKey, options = {}, caps = resolveCapabilities(this.config), graphCaps = resolveGraphConstructionCapabilities(this.config)) {
+  async recallInternal(prompt, sessionKey, options = {}, caps = resolveCapabilities(this.config), graphCaps = resolveGraphConstructionCapabilities(this.config), lifecycleCaps = resolveMemoryLifecycleCapabilities(this.config)) {
     const recallStart = Date.now();
     const backendDegradations = [];
     let asOfMs;
@@ -9409,8 +9534,8 @@ ${boxLines.join("\n")}`
       }
       if (this.isRecallSectionEnabled(
         "temporal-memory-tree",
-        this.config.temporalMemoryTreeEnabled === true
-      ) && this.config.temporalMemoryTreeEnabled && recallMode !== "minimal" && recallMode !== "no_recall") {
+        lifecycleCaps.temporalMemoryTree
+      ) && lifecycleCaps.temporalMemoryTree && recallMode !== "minimal" && recallMode !== "no_recall") {
         const tmtNode = await this.tmtBuilder.getMostRelevantNode();
         if (tmtNode) {
           const levelLabel = tmtNode.level.charAt(0).toUpperCase() + tmtNode.level.slice(1);
@@ -10073,7 +10198,7 @@ ${tmtNode.summary}`
             );
             if (memories.length > 0) {
               const supersessionOptions = {
-                enabled: this.config.temporalSupersessionEnabled,
+                enabled: lifecycleCaps.temporalSupersession,
                 includeInRecall: this.config.temporalSupersessionIncludeInRecall
               };
               const asOfActive = typeof asOfMs === "number" && Number.isFinite(asOfMs);
@@ -11157,7 +11282,7 @@ _Context: ${topQuestion.context}_`
         settleTask(new Error("replay extraction deadline exceeded (queue_wait)"));
       }, remainingMs);
     }
-    this.extractionQueue.push(async () => {
+    this.extractionQueueCoordinator.enqueue(async () => {
       if (settled) return;
       if (typeof extractionDeadlineMs === "number" && extractionDeadlineMs <= Date.now()) {
         settleTask(new Error("replay extraction deadline exceeded (queue_wait)"));
@@ -11183,13 +11308,6 @@ _Context: ${topQuestion.context}_`
         }
       }
     });
-    if (!this.queueProcessing) {
-      this.queueProcessing = true;
-      this.processQueue().catch((err) => {
-        this.logExtractionQueueFailure(err, "processor");
-        this.queueProcessing = false;
-      });
-    }
     log.debug(`queued extraction from ${reason}`);
   }
   normalizeExtractionFingerprintTurns(turns) {
@@ -11208,7 +11326,8 @@ _Context: ${topQuestion.context}_`
 ${normalized}`).digest("hex");
   }
   shouldQueueExtraction(turns, options = {}) {
-    if (!this.config.extractionDedupeEnabled) return true;
+    const lifecycleCaps = resolveMemoryLifecycleCapabilities(this.config);
+    if (!lifecycleCaps.extractionDedupe) return true;
     if (!Array.isArray(turns) || turns.length === 0) return false;
     const bufferKey = options.bufferKey ?? turns[0]?.sessionKey ?? "default";
     const fingerprint = this.buildExtractionFingerprint(turns, bufferKey);
@@ -11232,50 +11351,6 @@ ${normalized}`).digest("hex");
     }
     return true;
   }
-  /**
-   * Background serial queue processor.
-   * Processes extractions one at a time to avoid race conditions.
-   * Called automatically when items are queued.
-   */
-  async processQueue() {
-    while (this.extractionQueue.length > 0) {
-      const task = this.extractionQueue.shift();
-      if (task) {
-        try {
-          await task();
-        } catch (err) {
-          this.logExtractionQueueFailure(err, "task");
-        }
-      }
-    }
-    this.queueProcessing = false;
-  }
-  /**
-   * Classify + log a failure from either the per-task catch inside
-   * `processQueue()` or the outer `processQueue().catch(...)` in
-   * `queueBufferedExtraction()`.  Issue #549: `throwIfRecallAborted`
-   * (used throughout `runExtraction`) raises an Error whose `name` is
-   * `"AbortError"`.  That path fires when `before_reset` aborts a
-   * queued task to avoid duplicate extraction — it is intentional
-   * cancellation, not a failure.  Downgrading the log to debug
-   * prevents spurious `error`-level lines that routinely appear
-   * right next to a successful `persisted: N facts, M entities` log
-   * and that confuse operators into thinking extraction is broken.
-   * Genuine extraction failures (network, parse, I/O) still log at
-   * `error`.
-   *
-   * Source differentiates the two call sites so the log message
-   * names the right layer (`task` vs `processor`).
-   */
-  logExtractionQueueFailure(err, source) {
-    const aborted = source === "task" ? "background extraction task aborted (session transition)" : "background extraction queue processor aborted (session transition)";
-    const failed = source === "task" ? "background extraction task failed" : "background extraction queue processor failed";
-    if (isAbortError(err)) {
-      log.debug(aborted);
-    } else {
-      log.error(failed, err);
-    }
-  }
   /**
    * Passive correction capture (issue #1581) — detects corrections expressed
    * passively in conversation turns and routes them to the Correction Contract
@@ -11809,7 +11884,7 @@ ${normalized}`).digest("hex");
   requestQmdMaintenanceForTool(reason) {
     this.maintenanceScheduler.requestQmdMaintenanceForTool(reason);
   }
-  async persistExtraction(result, storage, threadIdForExtraction, sourceContext, baseNamespace, scopeProfileWritePlan, sourceText, graphCaps = resolveGraphConstructionCapabilities(this.config)) {
+  async persistExtraction(result, storage, threadIdForExtraction, sourceContext, baseNamespace, scopeProfileWritePlan, sourceText, graphCaps = resolveGraphConstructionCapabilities(this.config), lifecycleCaps = resolveMemoryLifecycleCapabilities(this.config)) {
     const citationEnabled = this.config.inlineSourceAttributionEnabled === true;
     const citationTemplate = this.config.inlineSourceAttributionFormat;
     const citationContextBase = citationEnabled ? {
@@ -11984,7 +12059,7 @@ ${normalized}`).digest("hex");
               ...options.provenance ? { provenance: options.provenance } : {}
             }
           );
-          if (this.config.temporalSupersessionEnabled && options.category === "fact" && options.entityRef && options.structuredAttributes && Object.keys(options.structuredAttributes).length > 0) {
+          if (lifecycleCaps.temporalSupersession && options.category === "fact" && options.entityRef && options.structuredAttributes && Object.keys(options.structuredAttributes).length > 0) {
             try {
               await applyTemporalSupersession({
                 storage: targetStorage,
@@ -12052,7 +12127,7 @@ ${normalized}`).digest("hex");
               options.entityRef
             );
           }
-          if (this.config.temporalSupersessionEnabled && options.entityRef && options.structuredAttributes && Object.keys(options.structuredAttributes).length > 0) {
+          if (lifecycleCaps.temporalSupersession && options.entityRef && options.structuredAttributes && Object.keys(options.structuredAttributes).length > 0) {
             let hashDedupMatchingFact;
             let hashDedupLookupComplete = false;
             try {
@@ -12131,7 +12206,7 @@ ${normalized}`).digest("hex");
             ...options.provenance ? { provenance: options.provenance } : {}
           }
         );
-        if (this.config.temporalSupersessionEnabled && options.entityRef && options.structuredAttributes && Object.keys(options.structuredAttributes).length > 0) {
+        if (lifecycleCaps.temporalSupersession && options.entityRef && options.structuredAttributes && Object.keys(options.structuredAttributes).length > 0) {
           try {
             await applyTemporalSupersession({
               storage: sharedStorage,
@@ -12309,7 +12384,7 @@ ${normalized}`).digest("hex");
     let judgeVerdictsByFactIndex = null;
     let judgeGatedCount = 0;
     this.lastPersistExtractionDeferredCount = 0;
-    if (this.config.extractionJudgeEnabled) {
+    if (lifecycleCaps.extractionJudge) {
       let preJudgeRedactionRules = [];
       try {
         preJudgeRedactionRules = await redactionRulesFor(storage.dir);
@@ -12353,7 +12428,7 @@ ${normalized}`).digest("hex");
           candidateToFactIndex.push(fi);
         }
         const judgeTelemetryOpts = {
-          enabled: this.config.extractionJudgeTelemetryEnabled === true,
+          enabled: lifecycleCaps.extractionJudgeTelemetry,
           memoryDir: this.config.memoryDir
         };
         const judgeTrainingOpts = {
@@ -12478,7 +12553,7 @@ ${normalized}`).digest("hex");
           );
         }
       }
-      if (this.config.extractionScopeClassificationEnabled && this.config.namespacesEnabled && fact.scope === "global" && !routedNamespaceExplicit) {
+      if (lifecycleCaps.extractionScopeClassification && this.config.namespacesEnabled && fact.scope === "global" && !routedNamespaceExplicit) {
         const currentNs = this.storageDirNamespace(targetStorage.dir);
         if (currentNs !== this.config.sharedNamespace && profileAllowsSharedWrites) {
           try {
@@ -12840,7 +12915,7 @@ ${normalized}`).digest("hex");
                 // #1578 r3: an extracted end-only bound (validFrom absent) is
                 // historical, not a new authoritative state — never let it
                 // supersede a later active fact (codex P1 on :15534).
-                enabled: this.config.temporalSupersessionEnabled && !(biTemporal && !biTemporal.validFrom)
+                enabled: lifecycleCaps.temporalSupersession && !(biTemporal && !biTemporal.validFrom)
               });
             } catch (err) {
               log.warn(`temporal-supersession (chunked): unexpected error: ${err}`);
@@ -13003,7 +13078,7 @@ ${normalized}`).digest("hex");
             entityRef: supersessionEntityRef,
             structuredAttributes: fact.structuredAttributes,
             createdAt: supersessionOrderingAt(biTemporal?.validFrom ?? sourceContext?.validAt),
-            enabled: this.config.temporalSupersessionEnabled && !(biTemporal && !biTemporal.validFrom)
+            enabled: lifecycleCaps.temporalSupersession && !(biTemporal && !biTemporal.validFrom)
           });
         } catch (err) {
           log.warn(`temporal-supersession: unexpected error: ${err}`);
@@ -13257,7 +13332,7 @@ ${normalized}`).digest("hex");
     }
   }
   async indexPersistedMemory(storage, memoryId) {
-    if (!this.config.embeddingFallbackEnabled) return;
+    if (!resolveMemoryLifecycleCapabilities(this.config).embeddingFallback) return;
     if (!await this.embeddingFallback.isAvailable()) return;
     const memory = await storage.getMemoryById(memoryId);
     if (!memory) return;
@@ -13385,6 +13460,7 @@ ${normalized}`).digest("hex");
   /** IDs of facts persisted in the last extraction */
   lastPersistedIds = [];
   async runConsolidation() {
+    const lifecycleCaps = resolveMemoryLifecycleCapabilities(this.config);
     log.info("running consolidation pass");
     let merged = 0;
     let invalidated = 0;
@@ -13549,7 +13625,7 @@ ${normalized}`).digest("hex");
         }
       }
     }
-    if (this.config.lifecyclePolicyEnabled) {
+    if (lifecycleCaps.lifecyclePolicy) {
       try {
         const lightSleepStartedAt = (/* @__PURE__ */ new Date()).toISOString();
         const lifecycleCorpus = await this.storage.readAllMemories();
@@ -13699,7 +13775,7 @@ ${normalized}`).digest("hex");
     const meta = await this.storage.loadMeta();
     meta.lastConsolidationAt = (/* @__PURE__ */ new Date()).toISOString();
     await this.storage.saveMeta(meta);
-    if (this.config.temporalMemoryTreeEnabled) {
+    if (lifecycleCaps.temporalMemoryTree) {
       try {
         const tmtEntries = allMemories.filter(
           (m) => m.frontmatter.status !== "superseded" && m.frontmatter.status !== "archived" && m.frontmatter.status !== "forgotten" && m.frontmatter.status !== "pending_review"
@@ -14095,6 +14171,7 @@ ${texts.map((t, i) => `[${i + 1}] ${t}`).join("\n\n")}`;
     let updatedCount = 0;
     let disputedCount = 0;
     let evaluatedCount = 0;
+    const lifecycleCaps = resolveMemoryLifecycleCapabilities(this.config);
     const thresholds = this.effectiveLifecycleThresholds();
     const policy = {
       promoteHeatThreshold: thresholds.promoteHeatThreshold,
@@ -14134,7 +14211,7 @@ ${texts.map((t, i) => `[${i + 1}] ${t}`).join("\n\n")}`;
       });
       if (wrote) updatedCount += 1;
     }
-    if (!this.config.lifecycleMetricsEnabled) return updatedCount;
+    if (!lifecycleCaps.lifecycleMetrics) return updatedCount;
     const total = evaluatedCount;
     const metrics = {
       generatedAt: nowIso,
@@ -15137,7 +15214,7 @@ ${lines.join("\n\n")}`;
    * `memoryDir` root, an exclusion list for `namespaces/*`).
    */
   async semanticDedupLookup(content, limit, targetStorage) {
-    if (!this.config.embeddingFallbackEnabled) {
+    if (!resolveMemoryLifecycleCapabilities(this.config).embeddingFallback) {
       throw new Error("semantic dedup: embedding backend not configured");
     }
     if (!await this.embeddingFallback.isAvailable()) {
@@ -15187,7 +15264,7 @@ ${lines.join("\n\n")}`;
     return { pathPrefix: rel };
   }
   async searchEmbeddingFallback(query, limit) {
-    if (!this.config.embeddingFallbackEnabled) return [];
+    if (!resolveMemoryLifecycleCapabilities(this.config).embeddingFallback) return [];
     if (!await this.embeddingFallback.isAvailable()) return [];
     const hits = await this.embeddingFallback.search(query, limit);
     if (hits.length === 0) return [];
@@ -15710,6 +15787,7 @@ ${lines.join("\n\n")}`;
     return { memoryByPath, checkedPaths, unreadablePaths, completed: true };
   }
   filterSearchResultsByRecallSafety(results, memoryByPath, options) {
+    const lifecycleCaps = resolveMemoryLifecycleCapabilities(this.config);
     let lifecycleFilteredCount = 0;
     let temporalSupersededFilteredCount = 0;
     let biTemporalExpiredFilteredCount = 0;
@@ -15730,8 +15808,8 @@ ${lines.join("\n\n")}`;
           continue;
         }
         if (options?.allowLifecycleFiltered !== true && shouldFilterLifecycleRecallCandidate(memory.frontmatter, {
-          lifecyclePolicyEnabled: this.config.lifecyclePolicyEnabled,
-          lifecycleFilterStaleEnabled: this.config.lifecycleFilterStaleEnabled
+          lifecyclePolicyEnabled: lifecycleCaps.lifecyclePolicy,
+          lifecycleFilterStaleEnabled: lifecycleCaps.lifecycleFilterStale
         })) {
           lifecycleFilteredCount += 1;
           continue;
@@ -15754,7 +15832,7 @@ ${lines.join("\n\n")}`;
           // half-open `[valid_at, invalid_at)` evaluation in isValidAsOf
           // is the authoritative gate for historical recall.
           shouldFilterSupersededFromRecall(memory.frontmatter, {
-            enabled: this.config.temporalSupersessionEnabled,
+            enabled: lifecycleCaps.temporalSupersession,
             includeInRecall: this.config.temporalSupersessionIncludeInRecall
           })
         ) {
@@ -15844,6 +15922,7 @@ ${lines.join("\n\n")}`;
    * Returns re-ranked results.
    */
   async boostSearchResults(results, _recallNamespaces, prompt, preloadedMemoryMap, options) {
+    const lifecycleCaps = resolveMemoryLifecycleCapabilities(this.config);
     if (results.length === 0) return results;
     const safety = await this.filterSearchResultsForRecall(
       results,
@@ -15977,7 +16056,7 @@ ${lines.join("\n\n")}`;
         const lifecycleDelta = lifecycleRecallScoreAdjustment(
           memory.frontmatter,
           {
-            lifecyclePolicyEnabled: this.config.lifecyclePolicyEnabled
+            lifecyclePolicyEnabled: lifecycleCaps.lifecyclePolicy
           }
         );
         score += applyUtilityRankingRuntimeDelta(
@@ -16313,4 +16392,4 @@ export {
   resolvePersistedMemoryRelativePath,
   Orchestrator
 };
-//# sourceMappingURL=chunk-XPHVAOBT.js.map
+//# sourceMappingURL=chunk-HEDZUSCS.js.map