@remnic/core 9.7.13 → 9.7.15

package/dist/{chunk-ZC3HG22I.js → chunk-JREB6UFH.js}

@@ -1,6 +1,6 @@
 import {
   StorageManager
-} from "./chunk-TRH533CA.js";
+} from "./chunk-K7LOWSLU.js";
 
 // src/semantic-rule-promotion.ts
 import { createHash, randomUUID } from "crypto";
@@ -535,4 +535,4 @@ export {
   setSemanticRulePromotionTestHooks,
   promoteSemanticRuleFromMemory
 };
-//# sourceMappingURL=chunk-ZC3HG22I.js.map
+//# sourceMappingURL=chunk-JREB6UFH.js.map

package/dist/{chunk-TRH533CA.js → chunk-K7LOWSLU.js}

@@ -37,7 +37,7 @@ import {
 import {
   SPECULATIVE_TTL_DAYS,
   confidenceTier
-} from "./chunk-G5PVJJRA.js";
+} from "./chunk-PBSAPHHA.js";
 import {
   inferMemoryStatus,
   isArchivedMemoryPath,
@@ -78,18 +78,20 @@ import {
 } from "./chunk-G7D6GZ5J.js";
 import {
   createVersion
-} from "./chunk-VZ5OJE4X.js";
+} from "./chunk-5VQJBH2G.js";
 import {
   clearMemoryCache,
   getCachedEntities,
   getCachedMemories,
   invalidateAllForDir,
   invalidateDerivedAndGlobalForDir,
+  invalidateForScope,
+  invalidateForScopeExceptHot,
   setCachedEntities,
   setCachedMemories,
   updateCacheOnDelete,
   updateCacheOnWrite
-} from "./chunk-X47LWMKA.js";
+} from "./chunk-XMMESCPD.js";
 import {
   clearInFlightReads,
   deleteInFlightRead,
@@ -4041,6 +4043,16 @@ var StorageManager3 = class _StorageManager {
    * dirs resolve to. All REGISTERED dirs are isolated by the per-dir maps.
    */
   static hotMemoriesCacheProcessDefaultSeeded = false;
+  /**
+   * Per-memory-directory gate for scope-aware cache invalidation (issue #1904).
+   * Registered from config by the orchestrator via
+   * setScopedCacheInvalidationDefault() so every StorageManager built over a
+   * memory dir — including ephemeral recall sub-stage instances — honors the
+   * operator's setting. Unregistered dirs default to `true` (scoped on). Set
+   * `false` to restore the pre-#1904 full-clear-per-write behavior (rollback
+   * lever). Read once per write via isScopedCacheInvalidationEnabled().
+   */
+  static scopedCacheInvalidationByDir = /* @__PURE__ */ new Map();
   // Module-level maps for readAllMemories() keyed by base directory, shared
   // across all StorageManager instances (static) so concurrent callers over
   // the same dir cooperate.
@@ -4312,6 +4324,14 @@ var StorageManager3 = class _StorageManager {
       _StorageManager.hotMemoriesCacheProcessDefaultSeeded = true;
     }
   }
+  /** Register the operator's scope-aware cache invalidation gate for a memory
+   *  dir (issue #1904). The orchestrator/access layer calls this with
+   *  the operator's scopedCacheInvalidationEnabled flag so the setting reaches every
+   *  StorageManager built over the dir, including ephemeral recall-sub-stage
+   *  instances. Only an explicit `false` disables; `undefined` leaves it on. */
+  static setScopedCacheInvalidationDefault(memoryDir, enabled) {
+    _StorageManager.scopedCacheInvalidationByDir.set(memoryDir, enabled !== false);
+  }
   /**
    * The LIVE class object of this instance (issue #1809 review of the
    * storage decomposition): extracted store modules must read/write the
@@ -5321,7 +5341,7 @@ ${sanitized.text}
     const filePath = await this.resolveCategoryWritePath(category, id, today);
     await this.snapshotBeforeWrite(filePath, "write");
     await this.writeStorageSecureFile(filePath, fileContent);
-    await this.patchHotMemoriesCache({ addedPath: filePath });
+    await this.patchHotMemoriesCache({ addedPath: filePath }, "memory-create");
     await this.appendGeneratedMemoryLifecycleEventFailOpen("storage.writeMemory", {
       memoryId: id,
       eventType: "created",
@@ -5650,6 +5670,7 @@ ${sanitized.text}
     _StorageManager.hotMemoriesCacheDefault = true;
     _StorageManager.hotMemoriesCacheTtlMs = 6e4;
     _StorageManager.hotMemoriesCacheProcessDefaultSeeded = false;
+    _StorageManager.scopedCacheInvalidationByDir.clear();
   }
   /** Cancel any in-flight concurrent read so the next readAllMemories()
    *  starts a fresh disk scan and sees the just-written data.
@@ -5666,7 +5687,11 @@ ${sanitized.text}
   invalidateAllMemoriesCache() {
     deleteInFlightReadsForDir(this.baseDir);
     this.bumpMemoryCorpusVersion();
-    invalidateAllForDir(this.baseDir);
+    if (_StorageManager.scopedCacheInvalidationByDir.get(this.baseDir) ?? true) {
+      invalidateForScope(this.baseDir, "memory-mutate");
+    } else {
+      invalidateAllForDir(this.baseDir);
+    }
     if (this.tombstoneStore) {
       this.tombstoneStore.invalidate();
       this.tombstoneStore = null;
@@ -5690,7 +5715,7 @@ ${sanitized.text}
    * coherence is preserved. Bulk/ambiguous mutations keep the wholesale
    * invalidateAllMemoriesCache() drop instead (issue #1902 Step 5).
    */
-  async patchHotMemoriesCache(opts) {
+  async patchHotMemoriesCache(opts, scope = "memory-mutate") {
     const prevVersion = this.getMemoryCorpusVersion();
     const keyId = this.hotCacheKeyId();
     const warm = this.hotMemoriesCacheEnabled && getCachedMemories(this.baseDir, prevVersion, keyId, this.hotCacheTtlMs()) !== null;
@@ -5717,7 +5742,11 @@ ${sanitized.text}
       const patched = getCachedMemories(this.baseDir, prevVersion, keyId);
       if (patched) setCachedMemories(this.baseDir, patched, produced, keyId, this.hotCacheTtlMs());
     }
-    invalidateDerivedAndGlobalForDir(this.baseDir);
+    if (scope === "memory-create" && (_StorageManager.scopedCacheInvalidationByDir.get(this.baseDir) ?? true)) {
+      invalidateForScopeExceptHot(this.baseDir, "memory-create");
+    } else {
+      invalidateDerivedAndGlobalForDir(this.baseDir);
+    }
     if (this.tombstoneStore) {
       this.tombstoneStore.invalidate();
       this.tombstoneStore = null;
@@ -7227,7 +7256,7 @@ ${sanitized.text}
 `;
     const filePath = await this.resolveCategoryWritePath(category, id, today);
     await this.writeStorageSecureFile(filePath, fileContent);
-    await this.patchHotMemoriesCache({ addedPath: filePath });
+    await this.patchHotMemoriesCache({ addedPath: filePath }, "memory-create");
     log.debug(`wrote chunk ${id} (${chunkIndex + 1}/${chunkTotal}) to ${filePath}`);
     return id;
   }
@@ -7518,4 +7547,4 @@ export {
   isValidBufferSurpriseEvent,
   StorageManager3 as StorageManager
 };
-//# sourceMappingURL=chunk-TRH533CA.js.map
+//# sourceMappingURL=chunk-K7LOWSLU.js.map