@remnic/core 9.3.690 → 9.3.692

package/dist/{chunk-CE6CBRCV.js → chunk-W4MICQIZ.js}

@@ -4,19 +4,13 @@ import {
   loadSyncState,
   syncWearableSource,
   wearableSourceLabel
-} from "./chunk-AGJH5ISO.js";
+} from "./chunk-5KBNNUXS.js";
+import {
+  MaintenanceScheduler
+} from "./chunk-6C2BMUZA.js";
 import {
   migrateFromEngram
 } from "./chunk-7HYPN2GC.js";
-import {
-  ensureContradictionScanCron,
-  ensureDaySummaryCron,
-  ensureGraphEdgeDecayCron,
-  ensureNightlyGovernanceCron,
-  ensurePatternReinforcementCron,
-  ensureProceduralMiningCron,
-  graphEdgeDecayCadenceToCronExpr
-} from "./chunk-666A3MOW.js";
 import {
   LcmEngine
 } from "./chunk-X5J3JZR3.js";
@@ -29,7 +23,7 @@ import {
 import {
   CompoundingEngine,
   defaultTierMigrationCycleBudget
-} from "./chunk-BKAMHZYR.js";
+} from "./chunk-UOCLRM74.js";
 import {
   SharedContextManager
 } from "./chunk-UFS7OXGL.js";
@@ -38,6 +32,15 @@ import {
   applyUtilityRankingRuntimeDelta,
   loadUtilityRuntimeValues
 } from "./chunk-LXOM6IQU.js";
+import {
+  applyTemporalSupersession,
+  normalizeSupersessionKey,
+  shouldFilterSupersededFromRecall
+} from "./chunk-MRFVMSTR.js";
+import {
+  isValidAsOf,
+  isValidityExpiredNow
+} from "./chunk-IREVVFTM.js";
 import {
   TierMigrationExecutor
 } from "./chunk-VOUOLGIP.js";
@@ -52,19 +55,11 @@ import {
 } from "./chunk-UHGBNIOS.js";
 import {
   HourlySummarizer
-} from "./chunk-A4HH2EWA.js";
+} from "./chunk-QVG4LAQO.js";
 import {
   buildTargetedFactRecallSection,
   shouldRecallTargetedFactEvidence
 } from "./chunk-R5DB26G6.js";
-import {
-  applyTemporalSupersession,
-  normalizeSupersessionKey,
-  shouldFilterSupersededFromRecall
-} from "./chunk-3FC6LW6T.js";
-import {
-  isValidAsOf
-} from "./chunk-MDYG7VI7.js";
 import {
   SessionObserverState
 } from "./chunk-DKTSR7EK.js";
@@ -140,6 +135,18 @@ import {
 import {
   classifyMemoryKind
 } from "./chunk-YAZNBMNF.js";
+import {
+  ExtractionEngine
+} from "./chunk-MXZWKOOR.js";
+import {
+  parseMemoryActionEligibilityContext
+} from "./chunk-ROZJACKP.js";
+import {
+  ModelRegistry
+} from "./chunk-PWFWCGOO.js";
+import {
+  LocalLlmClient
+} from "./chunk-UPTZYUYJ.js";
 import {
   buildFocusedListRecallSection,
   shouldRecallFocusedListEvidence
@@ -160,19 +167,7 @@ import {
   getVerdictKind,
   judgeFactDurability,
   validateProcedureExtraction
-} from "./chunk-OBXTMFZQ.js";
-import {
-  ExtractionEngine
-} from "./chunk-WDXCNJSF.js";
-import {
-  parseMemoryActionEligibilityContext
-} from "./chunk-ROZJACKP.js";
-import {
-  ModelRegistry
-} from "./chunk-PWFWCGOO.js";
-import {
-  LocalLlmClient
-} from "./chunk-UPTZYUYJ.js";
+} from "./chunk-ECZPWSB5.js";
 import {
   tryDirectAnswer
 } from "./chunk-OQH5XUH3.js";
@@ -183,27 +178,27 @@ import {
   buildEntityRecallSection,
   entityRecentTranscriptLookbackHours,
   readRecentEntityTranscriptEntries
-} from "./chunk-2N6UNJSX.js";
+} from "./chunk-U2OBZSGG.js";
 import {
   formatDaySummaryMemories
 } from "./chunk-EO5QWINU.js";
-import {
-  RoutingRulesStore
-} from "./chunk-WIWPSQYU.js";
 import {
   normalizeReplaySessionKey
 } from "./chunk-2PRQG7PV.js";
+import {
+  RoutingRulesStore
+} from "./chunk-WIWPSQYU.js";
 import {
   compareVerifiedEpisodeResults,
   searchVerifiedEpisodes
-} from "./chunk-RTFAZOIR.js";
+} from "./chunk-3VVH6ZQW.js";
 import {
   ThreadingManager
 } from "./chunk-QRDOSYOR.js";
 import {
   compareVerifiedSemanticRuleResults,
   searchVerifiedSemanticRules
-} from "./chunk-67MMWC74.js";
+} from "./chunk-ZLXGFAML.js";
 import {
   searchWorkProductLedgerEntries
 } from "./chunk-ZRWB5D4H.js";
@@ -214,15 +209,16 @@ import {
   PolicyRuntimeManager
 } from "./chunk-33JBK2XP.js";
 import {
-  NamespaceCatalog,
-  planNamespaceMaintenance,
-  runNamespaceMaintenanceBatchPlan,
   runNamespaceMaintenanceFanout,
   summarizeNamespaceMaintenanceHealth
-} from "./chunk-ZU7N3S6V.js";
+} from "./chunk-HXNMDPHN.js";
+import {
+  NamespaceCatalog,
+  planNamespaceMaintenance
+} from "./chunk-4IQNAOP3.js";
 import {
   NamespaceStorageRouter
-} from "./chunk-UD5OKH4J.js";
+} from "./chunk-W4ELOUNX.js";
 import {
   isAboveImportanceThreshold,
   scoreImportance
@@ -267,7 +263,7 @@ import {
   materializeAfterSemanticConsolidation,
   parseConsolidationResponse,
   parseOperatorAwareConsolidationResponse
-} from "./chunk-PHZKALOE.js";
+} from "./chunk-QFG23CRE.js";
 import {
   buildBehaviorSignalsForMemory,
   dedupeBehaviorSignalsByMemoryAndHash
@@ -294,7 +290,7 @@ import {
   FallbackLlmClient,
   fallbackLlmRuntimeContextFromConfig,
   gatewayTaskChainOptions
-} from "./chunk-FIVDN2SM.js";
+} from "./chunk-4RGWCRIJ.js";
 import {
   compileCorrectionRule,
   correctionsFilePath,
@@ -325,18 +321,18 @@ import {
 } from "./chunk-FF4KLI5W.js";
 import {
   buildXraySnapshot
-} from "./chunk-LLONI6PY.js";
+} from "./chunk-AFWEUTMS.js";
 import {
   objectiveStateStoreOverrideForNamespace,
   searchObjectiveStateSnapshots
 } from "./chunk-6HMYUWXR.js";
 import {
   NamespaceSearchRouter
-} from "./chunk-LXIEXSHU.js";
+} from "./chunk-E6BOD3UJ.js";
 import {
   createConversationIndexRuntime,
   createSearchBackend
-} from "./chunk-TYF3D4MS.js";
+} from "./chunk-6ZNIUGXB.js";
 import {
   NoopSearchBackend
 } from "./chunk-CYEPCZN5.js";
@@ -351,12 +347,12 @@ import {
 import {
   parseQmdExplain
 } from "./chunk-K43PI6DQ.js";
-import {
-  shouldSkipImplicitExtraction
-} from "./chunk-U33LWTQQ.js";
 import {
   ProfilingCollector
 } from "./chunk-PNLCEFE4.js";
+import {
+  shouldSkipImplicitExtraction
+} from "./chunk-U33LWTQQ.js";
 import {
   buildProcedurePersistBody
 } from "./chunk-QDW3E4RD.js";
@@ -368,7 +364,7 @@ import {
 } from "./chunk-YN4ZT4CW.js";
 import {
   buildChainFollowupGenerator
-} from "./chunk-X7RLU5CR.js";
+} from "./chunk-66HROLW5.js";
 import {
   ContentHashIndex,
   StorageManager,
@@ -376,7 +372,7 @@ import {
   fingerprintEntityStructuredFacts,
   normalizeAttributePairs,
   parseEntityFile
-} from "./chunk-CUNTLEJP.js";
+} from "./chunk-VFVG4NS2.js";
 import {
   isValidTranscriptDate,
   loadSpeakerRegistry,
@@ -397,7 +393,7 @@ import {
 } from "./chunk-J6A3CX5N.js";
 import {
   confidenceTier
-} from "./chunk-NGFEWFNK.js";
+} from "./chunk-DQHZA7Y3.js";
 import {
   buildQmdRecallCacheKey,
   getCachedQmdRecall,
@@ -441,9 +437,6 @@ import {
   isSafeRouteNamespace,
   selectRouteRule
 } from "./chunk-U3PN77QT.js";
-import {
-  resolveHomeDir
-} from "./chunk-JUC24CTX.js";
 import {
   log
 } from "./chunk-NU3CSQ4H.js";
@@ -2392,10 +2385,6 @@ function resolvePersistedMemoryRelativePath(options) {
   }
   return path2.join(subtree, `${options.memoryId}.md`);
 }
-function qmdMaintenanceSkipReasonForError(error) {
-  const message = error instanceof Error ? error.message : String(error);
-  return /^QMD (?:update|embed) skipped by .*min-interval gate$/.test(message) ? "throttled" : null;
-}
 var Orchestrator = class _Orchestrator {
   storage;
   storageRouter;
@@ -2405,6 +2394,12 @@ var Orchestrator = class _Orchestrator {
   namespaceStorageDirHintsLoaded = false;
   namespaceSearchRouter;
   qmd;
+  /**
+   * Maintenance scheduler (issue #1526 PR1). Owns cron auto-registration,
+   * debounced QMD index maintenance, and consolidation scheduling. Job
+   * runners (consolidation/pattern-reinforcement/governance) stay here.
+   */
+  maintenanceScheduler;
   conversationQmd;
   conversationFaiss;
   conversationIndexBackend;
@@ -2513,17 +2508,9 @@ var Orchestrator = class _Orchestrator {
   queueProcessing = false;
   heartbeatObserverChains = /* @__PURE__ */ new Map();
   recentExtractionFingerprints = /* @__PURE__ */ new Map();
-  nonZeroExtractionsSinceConsolidation = 0;
-  lastConsolidationRunAtMs = 0;
-  consolidationInFlight = false;
   consolidationObservers = /* @__PURE__ */ new Set();
-  qmdMaintenanceTimer = null;
   wearablesServiceInstance = null;
   wearablesAutoSyncHandle = null;
-  qmdMaintenancePending = false;
-  qmdMaintenanceInFlight = false;
-  lastQmdEmbedAtMs = 0;
-  lastQmdEmbedAtMsByNamespace = /* @__PURE__ */ new Map();
   lastQmdReprobeAtMs = 0;
   tierMigrationInFlight = false;
   lastTierMigrationRunAtMs = 0;
@@ -2599,11 +2586,7 @@ var Orchestrator = class _Orchestrator {
       await this.wearablesAutoSyncHandle.stop();
       this.wearablesAutoSyncHandle = null;
     }
-    if (this.qmdMaintenanceTimer) {
-      clearTimeout(this.qmdMaintenanceTimer);
-      this.qmdMaintenanceTimer = null;
-    }
-    this.qmdMaintenancePending = false;
+    this.maintenanceScheduler.dispose();
     await this.namespaceSearchRouter.dispose();
     await this.disposeSearchBackendIfNeeded();
     if (this.conversationQmd && this.conversationQmd !== this.qmd) {
@@ -2931,21 +2914,6 @@ var Orchestrator = class _Orchestrator {
       this.rememberNamespaceStorageDirHint(record.namespace, record.storageDir);
     }
   }
-  /**
-   * Shared namespace maintenance planner (issue #1500). This extends the
-   * #1499 catalog-union QMD helper into a reusable contract: configured
-   * namespaces are always considered, dynamic catalog namespaces are admitted
-   * only when their live router root still matches real memory data, and branch
-   * namespaces are opt-in. Recurring jobs use the per-cycle budget; startup and
-   * recovery discovery paths use the same safety filters without that cycle
-   * budget so every live namespace is ensured/synced.
-   */
-  async namespaceMaintenancePlan(jobName) {
-    return planNamespaceMaintenance(this.config, {
-      jobName,
-      catalog: this.namespaceCatalog
-    });
-  }
   async maintenanceNamespaces(jobName = "qmd", budgetMode = "unbounded") {
     const plan = await planNamespaceMaintenance(this.config, {
       jobName,
@@ -3147,6 +3115,16 @@ var Orchestrator = class _Orchestrator {
       }
     }
     this.qmd = createSearchBackend(config);
+    this.maintenanceScheduler = new MaintenanceScheduler({
+      config,
+      // Live accessor: the orchestrator reassigns this.qmd to NoopSearchBackend
+      // after construction when the collection is missing (initialize /
+      // startupSearchSync); the scheduler must read the current backend so
+      // debounced maintenance never runs against a stale/disposed one.
+      getQmd: () => this.qmd,
+      namespaceSearchRouter: this.namespaceSearchRouter,
+      namespaceCatalog: this.namespaceCatalog
+    });
     const conversationIndexRuntime = createConversationIndexRuntime(config, {
       getQmd: () => this.conversationQmd,
       getFaiss: () => this.conversationFaiss
@@ -3707,48 +3685,7 @@ var Orchestrator = class _Orchestrator {
       }
     }
     if (signal.aborted) return;
-    if (this.config.daySummaryEnabled) {
-      try {
-        await this.autoRegisterDaySummaryCron();
-      } catch (err) {
-        log.debug(`day-summary cron auto-register failed (non-fatal): ${err}`);
-      }
-    }
-    if (this.config.nightlyGovernanceCronAutoRegister) {
-      try {
-        await this.autoRegisterNightlyGovernanceCron();
-      } catch (err) {
-        log.debug(`nightly governance cron auto-register failed (non-fatal): ${err}`);
-      }
-    }
-    if (this.config.procedural?.proceduralMiningCronAutoRegister) {
-      try {
-        await this.autoRegisterProceduralMiningCron();
-      } catch (err) {
-        log.debug(`procedural mining cron auto-register failed (non-fatal): ${err}`);
-      }
-    }
-    if (this.config.contradictionScan?.enabled) {
-      try {
-        await this.autoRegisterContradictionScanCron();
-      } catch (err) {
-        log.debug(`contradiction scan cron auto-register failed (non-fatal): ${err}`);
-      }
-    }
-    if (this.config.patternReinforcementEnabled) {
-      try {
-        await this.autoRegisterPatternReinforcementCron();
-      } catch (err) {
-        log.debug(`pattern reinforcement cron auto-register failed (non-fatal): ${err}`);
-      }
-    }
-    if (this.config.graphEdgeDecayEnabled) {
-      try {
-        await this.autoRegisterGraphEdgeDecayCron();
-      } catch (err) {
-        log.debug(`graph edge decay cron auto-register failed (non-fatal): ${err}`);
-      }
-    }
+    await this.maintenanceScheduler.autoRegisterCrons(signal);
     if (signal.aborted) return;
     if (this.config.lifecyclePolicyEnabled && this.config.qmdTierMigrationEnabled) {
       try {
@@ -3775,7 +3712,7 @@ var Orchestrator = class _Orchestrator {
     if (signal.aborted) return;
     if (!this.wearablesAutoSyncHandle && this.config.wearables.enabled && this.config.wearables.autoSyncEnabled && Object.values(this.config.wearables.sources).some((source) => source.enabled)) {
       try {
-        const { startWearablesAutoSync } = await import("./auto-sync-NUQWSFQD.js");
+        const { startWearablesAutoSync } = await import("./auto-sync-RWXT6P5M.js");
         if (signal.aborted) return;
         this.wearablesAutoSyncHandle = startWearablesAutoSync(
           {
@@ -3903,147 +3840,6 @@ var Orchestrator = class _Orchestrator {
     }
     return true;
   }
-  /**
-   * Auto-register the engram-day-summary cron job in OpenClaw.
-   * Reconciles model and timezone on every startup so config changes propagate.
-   * Fire-and-forget — never blocks init or crashes on failure.
-   * Issues #1474, #1475.
-   */
-  async autoRegisterDaySummaryCron() {
-    const home = resolveHomeDir();
-    const jobsPath = path2.join(home, ".openclaw", "cron", "jobs.json");
-    try {
-      if (!existsSync(jobsPath)) {
-        log.debug(
-          "day-summary cron: jobs.json not found, skipping auto-register"
-        );
-        return;
-      }
-      const rawSummaryModel = this.config.summaryModel;
-      const taskPrimary = this.config.taskModelChain?.primary;
-      const isGateway = this.config.modelSource === "gateway";
-      const model = isGateway ? rawSummaryModel || taskPrimary || void 0 : void 0;
-      const fallbacks = [];
-      if (model && taskPrimary && model === taskPrimary) {
-        const seen = new Set(model ? [model] : []);
-        const addUnique = (value) => {
-          if (typeof value !== "string") return;
-          const trimmed = value.trim();
-          if (trimmed.length > 0 && !seen.has(trimmed)) {
-            seen.add(trimmed);
-            fallbacks.push(trimmed);
-          }
-        };
-        for (const fb of this.config.taskModelChain?.fallbacks ?? []) addUnique(fb);
-        const gwDefaults = this.config.gatewayConfig?.agents?.defaults?.model;
-        addUnique(gwDefaults?.primary);
-        if (Array.isArray(gwDefaults?.fallbacks)) {
-          for (const fb of gwDefaults.fallbacks) addUnique(fb);
-        }
-      }
-      const timezone = this.config.daySummaryTimezone || Intl.DateTimeFormat().resolvedOptions().timeZone;
-      const result = await ensureDaySummaryCron(jobsPath, {
-        timezone,
-        ...model ? { model } : {},
-        ...fallbacks.length > 0 ? { fallbacks } : {}
-      });
-      if (result.created) {
-        log.info(
-          `day-summary cron auto-registered (${result.jobId}, 23:47 ${timezone}${model ? `, model: ${model}` : ""})`
-        );
-      } else if (result.updated) {
-        log.info(
-          `day-summary cron reconciled (${result.jobId}, timezone: ${timezone}${model ? `, model: ${model}` : ""})`
-        );
-      } else {
-        log.debug("day-summary cron already up to date");
-      }
-    } catch (err) {
-      log.debug(`day-summary cron auto-register error: ${err}`);
-    }
-  }
-  async autoRegisterNightlyGovernanceCron() {
-    const home = resolveHomeDir();
-    const jobsPath = path2.join(home, ".openclaw", "cron", "jobs.json");
-    try {
-      if (!existsSync(jobsPath)) {
-        log.debug("nightly governance cron: jobs.json not found, skipping auto-register");
-        return;
-      }
-      const created = await ensureNightlyGovernanceCron(jobsPath, {
-        timezone: Intl.DateTimeFormat().resolvedOptions().timeZone
-      });
-      if (created.created) {
-        log.info(
-          `nightly governance cron auto-registered (${created.jobId}, 02:23 ${Intl.DateTimeFormat().resolvedOptions().timeZone})`
-        );
-      } else {
-        log.debug("nightly governance cron already exists, skipping auto-register");
-      }
-    } catch (err) {
-      log.debug(`nightly governance cron auto-register error: ${err}`);
-    }
-  }
-  async autoRegisterProceduralMiningCron() {
-    const home = resolveHomeDir();
-    const jobsPath = path2.join(home, ".openclaw", "cron", "jobs.json");
-    try {
-      if (!existsSync(jobsPath)) {
-        log.debug("procedural mining cron: jobs.json not found, skipping auto-register");
-        return;
-      }
-      const created = await ensureProceduralMiningCron(jobsPath, {
-        timezone: Intl.DateTimeFormat().resolvedOptions().timeZone
-      });
-      if (created.created) {
-        log.info(`procedural mining cron auto-registered (${created.jobId})`);
-      } else {
-        log.debug("procedural mining cron already exists, skipping auto-register");
-      }
-    } catch (err) {
-      log.debug(`procedural mining cron auto-register error: ${err}`);
-    }
-  }
-  async autoRegisterContradictionScanCron() {
-    const home = resolveHomeDir();
-    const jobsPath = path2.join(home, ".openclaw", "cron", "jobs.json");
-    try {
-      if (!existsSync(jobsPath)) {
-        log.debug("contradiction scan cron: jobs.json not found, skipping auto-register");
-        return;
-      }
-      const created = await ensureContradictionScanCron(jobsPath, {
-        timezone: Intl.DateTimeFormat().resolvedOptions().timeZone
-      });
-      if (created.created) {
-        log.info(`contradiction scan cron auto-registered (${created.jobId})`);
-      } else {
-        log.debug("contradiction scan cron already exists, skipping auto-register");
-      }
-    } catch (err) {
-      log.debug(`contradiction scan cron auto-register error: ${err}`);
-    }
-  }
-  async autoRegisterPatternReinforcementCron() {
-    const home = resolveHomeDir();
-    const jobsPath = path2.join(home, ".openclaw", "cron", "jobs.json");
-    try {
-      if (!existsSync(jobsPath)) {
-        log.debug("pattern reinforcement cron: jobs.json not found, skipping auto-register");
-        return;
-      }
-      const created = await ensurePatternReinforcementCron(jobsPath, {
-        timezone: Intl.DateTimeFormat().resolvedOptions().timeZone
-      });
-      if (created.created) {
-        log.info(`pattern reinforcement cron auto-registered (${created.jobId})`);
-      } else {
-        log.debug("pattern reinforcement cron already exists, skipping auto-register");
-      }
-    } catch (err) {
-      log.debug(`pattern reinforcement cron auto-register error: ${err}`);
-    }
-  }
   /**
    * Run the pattern-reinforcement maintenance job (issue #687 PR 2/4).
    *
@@ -4169,28 +3965,6 @@ var Orchestrator = class _Orchestrator {
       { enabled: this.config.dreamsPhases.deepSleep.enabled }
     );
   }
-  async autoRegisterGraphEdgeDecayCron() {
-    const home = resolveHomeDir();
-    const jobsPath = path2.join(home, ".openclaw", "cron", "jobs.json");
-    try {
-      if (!existsSync(jobsPath)) {
-        log.debug("graph edge decay cron: jobs.json not found, skipping auto-register");
-        return;
-      }
-      const scheduleExpr = graphEdgeDecayCadenceToCronExpr(this.config.graphEdgeDecayCadenceMs);
-      const created = await ensureGraphEdgeDecayCron(jobsPath, {
-        timezone: Intl.DateTimeFormat().resolvedOptions().timeZone,
-        scheduleExpr
-      });
-      if (created.created) {
-        log.info(`graph edge decay cron auto-registered (${created.jobId}, ${scheduleExpr})`);
-      } else {
-        log.debug("graph edge decay cron already exists, skipping auto-register");
-      }
-    } catch (err) {
-      log.debug(`graph edge decay cron auto-register error: ${err}`);
-    }
-  }
   async runLiveConnectors(options = {}) {
     return runLiveConnectorsOnce({
       memoryDir: this.config.memoryDir,
@@ -4570,7 +4344,7 @@ ${doc.content}` : doc.content,
   }
   async waitForConsolidationIdle(timeoutMs = 6e4) {
     const started = Date.now();
-    while (this.consolidationInFlight) {
+    while (this.maintenanceScheduler.isConsolidationInFlight()) {
       if (Date.now() - started > timeoutMs) {
         log.warn(`waitForConsolidationIdle timed out after ${timeoutMs}ms`);
         return false;
@@ -11148,7 +10922,6 @@ ${normalized}`).digest("hex");
     }
     const nonZeroExtraction = durableOutputCount > 0;
     try {
-      if (nonZeroExtraction) this.nonZeroExtractionsSinceConsolidation += 1;
       this.maybeScheduleConsolidation(nonZeroExtraction);
     } catch (err) {
       log.warn(
@@ -11366,121 +11139,20 @@ ${normalized}`).digest("hex");
     });
   }
   maybeScheduleConsolidation(nonZeroExtraction) {
-    if (this.config.consolidationRequireNonZeroExtraction && !nonZeroExtraction)
-      return;
-    if (this.nonZeroExtractionsSinceConsolidation < this.config.consolidateEveryN)
-      return;
-    const now = Date.now();
-    if (now - this.lastConsolidationRunAtMs < this.config.consolidationMinIntervalMs)
-      return;
-    if (this.consolidationInFlight) return;
-    this.consolidationInFlight = true;
-    this.lastConsolidationRunAtMs = now;
-    this.nonZeroExtractionsSinceConsolidation = 0;
-    this.runConsolidation().catch((err) => log.error("background consolidation failed", err)).finally(() => {
-      this.consolidationInFlight = false;
-    });
+    this.maintenanceScheduler.maybeScheduleConsolidation(
+      nonZeroExtraction,
+      () => this.runConsolidation()
+    );
   }
   requestQmdMaintenance() {
-    if (!this.qmd.isAvailable()) return;
-    if (!this.config.qmdMaintenanceEnabled) return;
-    this.qmdMaintenancePending = true;
-    if (this.qmdMaintenanceTimer) return;
-    this.qmdMaintenanceTimer = setTimeout(() => {
-      this.qmdMaintenanceTimer = null;
-      this.runQmdMaintenance().catch(
-        (err) => log.debug(`background qmd maintenance failed: ${err}`)
-      );
-    }, this.config.qmdMaintenanceDebounceMs);
+    this.maintenanceScheduler.requestQmdMaintenanceForTool("__internal__");
   }
   /**
    * Public entrypoint for tool-driven QMD maintenance requests.
-   * Routes through existing debounced/singleflight maintenance controls.
+   * Delegates to the maintenance scheduler (issue #1526 PR1).
    */
   requestQmdMaintenanceForTool(reason) {
-    try {
-      this.requestQmdMaintenance();
-    } catch (err) {
-      const msg = err instanceof Error ? err.message : String(err);
-      log.warn(`qmd maintenance request failed (${reason}): ${msg}`);
-    }
-  }
-  async runQmdMaintenance() {
-    if (this.qmdMaintenanceInFlight) return;
-    if (!this.qmdMaintenancePending) return;
-    this.qmdMaintenanceInFlight = true;
-    this.qmdMaintenancePending = false;
-    try {
-      if (this.config.namespacesEnabled) {
-        const plan = await this.namespaceMaintenancePlan("qmd");
-        const now = Date.now();
-        const lastEmbedAtByNamespace = this.lastQmdEmbedAtMsByNamespace ?? (this.lastQmdEmbedAtMsByNamespace = /* @__PURE__ */ new Map());
-        const dueEmbedNamespaces = (namespaces) => {
-          if (!this.config.qmdAutoEmbedEnabled) return [];
-          return namespaces.filter(
-            (namespace) => now - (lastEmbedAtByNamespace.get(namespace) ?? 0) >= this.config.qmdEmbedMinIntervalMs
-          );
-        };
-        const markEmbedded = (namespaces) => {
-          if (namespaces.length === 0) return;
-          for (const namespace of namespaces) {
-            lastEmbedAtByNamespace.set(namespace, now);
-          }
-          this.lastQmdEmbedAtMs = now;
-        };
-        await runNamespaceMaintenanceBatchPlan(
-          this.config,
-          plan,
-          async (candidates) => {
-            const namespaces = candidates.map((candidate) => candidate.namespace);
-            const embedNamespaces = dueEmbedNamespaces(namespaces);
-            let result;
-            try {
-              result = await this.namespaceSearchRouter.updateNamespacesDetailed(
-                namespaces,
-                void 0,
-                { strict: true }
-              );
-            } catch (error) {
-              if (embedNamespaces.length > 0 && qmdMaintenanceSkipReasonForError(error) === "throttled") {
-                await this.namespaceSearchRouter.embedNamespaces(embedNamespaces, { strict: true });
-                markEmbedded(embedNamespaces);
-              }
-              throw error;
-            }
-            if (result.backendCount <= 0) {
-              throw new Error("no eligible QMD backend for selected namespaces");
-            }
-            if (result.eligibleNamespaces.length !== namespaces.length) {
-              const eligible = new Set(result.eligibleNamespaces);
-              const missing = namespaces.filter((namespace) => !eligible.has(namespace));
-              throw new Error(`QMD backend ineligible for selected namespaces (${missing.length})`);
-            }
-            if (embedNamespaces.length > 0) {
-              await this.namespaceSearchRouter.embedNamespaces(embedNamespaces, { strict: true });
-              markEmbedded(embedNamespaces);
-            }
-            return { itemCount: result.backendCount };
-          },
-          this.namespaceCatalog,
-          {
-            skipReasonForError: qmdMaintenanceSkipReasonForError
-          }
-        );
-      } else {
-        await this.qmd.update();
-        const now = Date.now();
-        if (this.config.qmdAutoEmbedEnabled && now - this.lastQmdEmbedAtMs >= this.config.qmdEmbedMinIntervalMs) {
-          await this.qmd.embed();
-          this.lastQmdEmbedAtMs = now;
-        }
-      }
-    } finally {
-      this.qmdMaintenanceInFlight = false;
-      if (this.qmdMaintenancePending) {
-        this.requestQmdMaintenance();
-      }
-    }
+    this.maintenanceScheduler.requestQmdMaintenanceForTool(reason);
   }
   async persistExtraction(result, storage, threadIdForExtraction, sourceContext, baseNamespace, scopeProfileWritePlan, graphCaps = resolveGraphConstructionCapabilities(this.config)) {
     const citationEnabled = this.config.inlineSourceAttributionEnabled === true;
@@ -15000,6 +14672,7 @@ ${lines.join("\n\n")}`;
   filterSearchResultsByRecallSafety(results, memoryByPath, options) {
     let lifecycleFilteredCount = 0;
     let temporalSupersededFilteredCount = 0;
+    let biTemporalExpiredFilteredCount = 0;
     let dedicatedSurfaceFilteredCount = 0;
     let forgottenFilteredCount = 0;
     let blockedPathFilteredCount = 0;
@@ -15047,6 +14720,10 @@ ${lines.join("\n\n")}`;
           temporalSupersededFilteredCount += 1;
           continue;
         }
+        if (!asOfActive && this.config.temporalBiTemporal && !this.config.temporalExpiredInInjection && isValidityExpiredNow(memory.frontmatter, Date.now())) {
+          biTemporalExpiredFilteredCount += 1;
+          continue;
+        }
         if (options?.allowDedicatedSurface !== true && (memory.frontmatter.memoryKind === "dream" || memory.frontmatter.memoryKind === "procedural")) {
           dedicatedSurfaceFilteredCount += 1;
           continue;
@@ -15064,6 +14741,11 @@ ${lines.join("\n\n")}`;
         `temporal supersession filter removed ${temporalSupersededFilteredCount} superseded candidates`
       );
     }
+    if (biTemporalExpiredFilteredCount > 0) {
+      log.debug(
+        `bi-temporal validity filter removed ${biTemporalExpiredFilteredCount} expired-validity candidates from injection (temporal.biTemporal on)`
+      );
+    }
     if (dedicatedSurfaceFilteredCount > 0) {
       log.debug(
         `dedicated surface filter removed ${dedicatedSurfaceFilteredCount} dream/procedural candidates from generic recall`
@@ -15566,4 +15248,4 @@ export {
   resolvePersistedMemoryRelativePath,
   Orchestrator
 };
-//# sourceMappingURL=chunk-CE6CBRCV.js.map
+//# sourceMappingURL=chunk-W4MICQIZ.js.map