@remnic/core 9.3.691 → 9.3.693

package/dist/{chunk-TJ5IIQIR.js → chunk-F7BVJ3IE.js}

@@ -6,14 +6,8 @@ import {
   wearableSourceLabel
 } from "./chunk-5KBNNUXS.js";
 import {
-  ensureContradictionScanCron,
-  ensureDaySummaryCron,
-  ensureGraphEdgeDecayCron,
-  ensureNightlyGovernanceCron,
-  ensurePatternReinforcementCron,
-  ensureProceduralMiningCron,
-  graphEdgeDecayCadenceToCronExpr
-} from "./chunk-666A3MOW.js";
+  MaintenanceScheduler
+} from "./chunk-6C2BMUZA.js";
 import {
   migrateFromEngram
 } from "./chunk-7HYPN2GC.js";
@@ -188,12 +182,12 @@ import {
 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
@@ -215,12 +209,13 @@ import {
   PolicyRuntimeManager
 } from "./chunk-33JBK2XP.js";
 import {
-  NamespaceCatalog,
-  planNamespaceMaintenance,
-  runNamespaceMaintenanceBatchPlan,
   runNamespaceMaintenanceFanout,
   summarizeNamespaceMaintenanceHealth
-} from "./chunk-QNG35H27.js";
+} from "./chunk-HXNMDPHN.js";
+import {
+  NamespaceCatalog,
+  planNamespaceMaintenance
+} from "./chunk-4IQNAOP3.js";
 import {
   NamespaceStorageRouter
 } from "./chunk-W4ELOUNX.js";
@@ -316,7 +311,7 @@ import {
   lcmReadSessionIdsForNamespaces,
   resolveCodingNamespaceOverlay,
   resolveScopeProfilePlan
-} from "./chunk-7MOTEVAA.js";
+} from "./chunk-HRUULBBV.js";
 import {
   listTrustZoneRecords,
   searchTrustZoneRecords
@@ -333,11 +328,11 @@ import {
 } from "./chunk-6HMYUWXR.js";
 import {
   NamespaceSearchRouter
-} from "./chunk-IPJD7WJH.js";
+} from "./chunk-E6BOD3UJ.js";
 import {
   createConversationIndexRuntime,
   createSearchBackend
-} from "./chunk-UUMYB3FR.js";
+} from "./chunk-6ZNIUGXB.js";
 import {
   NoopSearchBackend
 } from "./chunk-CYEPCZN5.js";
@@ -442,9 +437,6 @@ import {
   isSafeRouteNamespace,
   selectRouteRule
 } from "./chunk-U3PN77QT.js";
-import {
-  resolveHomeDir
-} from "./chunk-JUC24CTX.js";
 import {
   log
 } from "./chunk-NU3CSQ4H.js";
@@ -2393,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;
@@ -2406,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;
@@ -2514,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;
@@ -2600,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) {
@@ -2932,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,
@@ -3148,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
@@ -3708,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 {
@@ -3904,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).
    *
@@ -4170,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,
@@ -4571,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;
@@ -11149,7 +10922,6 @@ ${normalized}`).digest("hex");
     }
     const nonZeroExtraction = durableOutputCount > 0;
     try {
-      if (nonZeroExtraction) this.nonZeroExtractionsSinceConsolidation += 1;
       this.maybeScheduleConsolidation(nonZeroExtraction);
     } catch (err) {
       log.warn(
@@ -11367,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;
@@ -15577,4 +15248,4 @@ export {
   resolvePersistedMemoryRelativePath,
   Orchestrator
 };
-//# sourceMappingURL=chunk-TJ5IIQIR.js.map
+//# sourceMappingURL=chunk-F7BVJ3IE.js.map