@equationalapplications/core-llm-wiki 7.17.2 → 7.18.0

package/dist/index.mjs

@@ -3891,6 +3891,32 @@ var RememberService = class {
   }
 };
 
+// src/utils/upgradeNotice.ts
+function upcomingDefaultsWarning(config) {
+  const strategyUnset = config?.librarian?.strategy === void 0;
+  const maintenanceUnset = config?.maintenance === void 0;
+  if (!strategyUnset && !maintenanceUnset) return null;
+  const unset = [];
+  const keep = [];
+  if (strategyUnset) {
+    unset.push("`librarian.strategy` (default becomes 'ops')");
+    keep.push("`librarian: { strategy: 'legacy' }`");
+  }
+  if (maintenanceUnset) {
+    unset.push("`maintenance` (default becomes 'deferred')");
+    keep.push("`maintenance: 'auto'`");
+  }
+  const deferredNote = maintenanceUnset ? " Under 'deferred', the auto-run thresholds stop applying and nothing runs until the host calls runPendingMaintenance()." : "";
+  return `[core-llm-wiki] 8.0.0 changes engine defaults, and this config does not set ${unset.join(" or ")}.${deferredNote} To keep today's behavior, set ${keep.join(" and ")}.`;
+}
+var warned = /* @__PURE__ */ new Set();
+function warnUpcomingDefaultsOnce(config) {
+  const message = upcomingDefaultsWarning(config);
+  if (message === null || warned.has(message)) return;
+  warned.add(message);
+  console.warn(message);
+}
+
 // src/WikiMemory.ts
 var TABLE_PREFIX_PATTERN = /^[A-Za-z][A-Za-z0-9_]{0,30}_$/;
 var SEARCH_REINIT_COOLDOWN_MS = 5e3;
@@ -3933,6 +3959,7 @@ var WikiMemory = class {
         `Invalid tablePrefix: ${JSON.stringify(this.prefix)}. Must match ${TABLE_PREFIX_PATTERN} (letter, then alphanumeric/underscore, ending in "_", max 32 chars total).`
       );
     }
+    warnUpcomingDefaultsOnce(options.config);
     this.outboxRepo = new OutboxRepository(this.db, this.prefix, !!options.config?.enableOutbox);
     this.entryRepo = new EntryRepository(this.db, this.prefix, this.outboxRepo);
     this.sourceRefIndexRepo = new SourceRefIndexRepository(this.db, this.prefix);