@remnic/core 9.69.101 → 9.69.103

package/dist/{chunk-UFIZRMQZ.js → chunk-E4XLFYHV.js}

@@ -1,9 +1,3 @@
-import {
-  TombstoneStore,
-  applyTombstoneResurrectionGate,
-  buildRetiredFactTombstoneInputs,
-  collectRetiredMemoriesForRebuild
-} from "./chunk-46WM6JX2.js";
 import {
   WEARABLES_DIR_NAME,
   escapeSegmentText,
@@ -15,22 +9,28 @@ import {
   unescapeSegmentText,
   unescapeSpeakerLabel
 } from "./chunk-UHVXE24Y.js";
+import {
+  TombstoneStore,
+  applyTombstoneResurrectionGate,
+  buildRetiredFactTombstoneInputs,
+  collectRetiredMemoriesForRebuild
+} from "./chunk-46WM6JX2.js";
 import {
   normalizeQmdResultPath
-} from "./chunk-3LMOJXZR.js";
+} from "./chunk-BKVCTTEN.js";
 import {
   withholdToolScopedFromSharedNamespace
 } from "./chunk-S2V7RUCL.js";
 import {
   parseOfflineSyncDigestCache
 } from "./chunk-X3724WL4.js";
+import {
+  createMemorySnapshot
+} from "./chunk-S2HLHAZ4.js";
 import {
   rewriteProjectedEntityReferences,
   rewriteProjectedMemoryEntityReference
 } from "./chunk-MRPOZBJC.js";
-import {
-  createMemorySnapshot
-} from "./chunk-S2HLHAZ4.js";
 import {
   rotateMarkdownFileToArchive
 } from "./chunk-DM2T26WE.js";
@@ -97,7 +97,7 @@ import {
 } from "./chunk-G7D6GZ5J.js";
 import {
   createVersion
-} from "./chunk-JPKK466T.js";
+} from "./chunk-W5XWHTDO.js";
 import {
   attachInFlightReader,
   beginCoalescedScan,
@@ -125,6 +125,9 @@ import {
   normalizeSupersessionKey,
   supersessionKeysForFact
 } from "./chunk-5WITETWU.js";
+import {
+  entityMentionEpoch
+} from "./chunk-7CT3AI52.js";
 import {
   parseOriginClass
 } from "./chunk-23G5P7TA.js";
@@ -3972,6 +3975,22 @@ var QmdResultResolver = class {
   }
 };
 
+// src/storage/entity-mention-frontmatter-hold.ts
+async function holdMentionNeutralFrontmatter(storage, memory, updated, write) {
+  const identities = [
+    buildCapturePathLockIdentity(memory.path),
+    buildExplicitCaptureDedupKey(memory.content, memory.frontmatter.category, memory.frontmatter.sourceConnector),
+    buildExplicitCaptureDedupKey(memory.content, updated.category, updated.sourceConnector)
+  ];
+  return storage.withTombstoneBlockedCaptureWriteLock(async () => {
+    const persisted = await storage.readMemoryByPath(memory.path);
+    if (!persisted || persisted.content !== memory.content || !entityMentionEpoch.neutral(persisted.frontmatter, updated)) {
+      return void 0;
+    }
+    return write();
+  }, identities);
+}
+
 // src/wearables/fusion/cluster.ts
 var DEFAULT_PROXIMITY_GAP_MS = 5 * 6e4;
 function maxSegmentExtent(segments) {
@@ -7484,8 +7503,9 @@ var StorageManager3 = class _StorageManager extends TombstoneBlockedCaptureIndex
    * Bump only — NOT invalidateAllForDir (that would drop the very hot
    * entry the write path just patched).
    */
-  bumpMemoryCorpusVersion() {
+  bumpMemoryCorpusVersion(opts) {
     this.bumpSharedVersion("memory-corpus", _StorageManager.memoryCorpusVersionByDir);
+    if (opts?.indexedText !== false && !entityMentionEpoch.suppressed()) entityMentionEpoch.bump(this.baseDir);
     deleteInFlightReadsForDir(this.baseDir);
   }
   getArchiveMutationVersion() {
@@ -7497,7 +7517,7 @@ var StorageManager3 = class _StorageManager extends TombstoneBlockedCaptureIndex
    * patchHotMemoriesCache refuse to re-key its locally patched corpus at a
    * version already reflecting a peer's still-unread concurrent append.
    */
-  bumpMemoryCorpusVersionExclusive() {
+  bumpMemoryCorpusVersionExclusive(opts) {
     const filePath = this.versionFilePath("memory-corpus");
     try {
       mkdirSync(this.stateDir, { recursive: true });
@@ -7510,10 +7530,12 @@ var StorageManager3 = class _StorageManager extends TombstoneBlockedCaptureIndex
       appendFileSync(filePath, "x");
       const produced = statSync2(filePath).size;
       _StorageManager.memoryCorpusVersionByDir.set(this.baseDir, produced);
+      if (opts?.indexedText !== false && !entityMentionEpoch.suppressed()) entityMentionEpoch.bump(this.baseDir);
       return { produced, exclusive: produced === before + 1 };
     } catch {
       const next = (_StorageManager.memoryCorpusVersionByDir.get(this.baseDir) ?? 0) + 1;
       _StorageManager.memoryCorpusVersionByDir.set(this.baseDir, next);
+      if (opts?.indexedText !== false && !entityMentionEpoch.suppressed()) entityMentionEpoch.bump(this.baseDir);
       return { produced: next, exclusive: true };
     }
   }
@@ -9066,8 +9088,8 @@ ${sanitized.text}
   /** Invalidate the readAllMemories() cache after writes that add/remove memories. */
   /** Public cache invalidation for callers that need authoritative disk reads
    *  (e.g. projection verify/rebuild). */
-  invalidateAllMemoriesCacheForDir() {
-    this.invalidateAllMemoriesCache();
+  invalidateAllMemoriesCacheForDir(opts) {
+    this.invalidateAllMemoriesCache(opts);
   }
   /** Invalidate only the cache layers affected by direct tier file deletes. */
   invalidateMemoryCachesForTiers(tiers) {
@@ -9090,9 +9112,9 @@ ${sanitized.text}
       this.invalidateColdMemoriesCache();
     }
   }
-  /** Clear ALL static caches. Use in tests that write files directly
-   *  (bypassing StorageManager.writeMemory) to avoid stale reads. */
+  /** Clear every static cache. Direct file writes call this so the next read is not stale. */
   static clearAllStaticCaches() {
+    entityMentionEpoch.reset();
     clearInFlightReads();
     _StorageManager.questionsCache.clear();
     _StorageManager.coldMemoriesCache.clear();
@@ -9121,9 +9143,9 @@ ${sanitized.text}
    *  exclusively by invalidateColdMemoriesCache(), which is called only when
    *  cold content actually changes (hot→cold demotions, writeMemoryFileAtomic
    *  inside cold/, archiveMemory, etc.). */
-  invalidateAllMemoriesCache() {
+  invalidateAllMemoriesCache(opts) {
     deleteInFlightReadsForDir(this.baseDir);
-    this.bumpMemoryCorpusVersion();
+    this.bumpMemoryCorpusVersion(opts);
     if (_StorageManager.scopedCacheInvalidationByDir.get(this.baseDir) ?? true) {
       invalidateForScope(this.baseDir, "memory-mutate");
     } else {
@@ -9807,10 +9829,9 @@ ${sanitized.text}
       [buildCapturePathLockIdentity(expected.path), oldIdentity, newIdentity]
     );
   }
-  /**
-   * Update frontmatter fields without changing memory content. Returns false when the memory is not found.
-   */
-  async writeMemoryFrontmatter(memory, patch, lifecycle) {
+  /** Frontmatter patch. A replaced body still moves the mention epoch. */
+  static frontmatterBody = _StorageManager.prototype.writeMemoryFrontmatter;
+  async writeMemoryFrontmatter(memory, patch, lifecycle, mentionReentry) {
     const beforeStatus = memory.frontmatter.status ?? "active";
     const resolveIds = this.currentHistoricalIds();
     const updated = canonicalizeEntityRefOption(
@@ -9819,6 +9840,10 @@ ${sanitized.text}
     );
     const refIds = typeof updated.entityRef === "string" ? resolveIds : null;
     const afterStatus = updated.status ?? "active";
+    if (!mentionReentry && entityMentionEpoch.neutral(memory.frontmatter, updated)) {
+      const held = await holdMentionNeutralFrontmatter(this, memory, updated, () => entityMentionEpoch.hold(() => _StorageManager.frontmatterBody.call(this, memory, patch, lifecycle, true)));
+      if (held !== void 0) return held;
+    }
     const fileContent = `${serializeFrontmatter(this.withOkfType(updated))}
 
 ${memory.content}
@@ -9835,6 +9860,7 @@ ${memory.content}
         onFailRestore: memory
       });
     }
+    if (mentionReentry && !entityMentionEpoch.neutral(memory.frontmatter, updated)) entityMentionEpoch.bump(this.baseDir);
     await this.patchHotMemoriesCache({ addedPath: memory.path });
     if (memory.path.includes(`${path13.sep}cold${path13.sep}`)) {
       this.invalidateColdMemoriesCache();
@@ -10701,6 +10727,7 @@ ${reflection}
     const memoryPathMap = new Map(memories.map((m) => [path13.resolve(m.path), m]));
     let updated = 0;
     const prevVersion = this.getMemoryCorpusVersion();
+    let entityRefMoved = false;
     const keyId = this.hotCacheKeyId();
     const warm = this.hotMemoriesCacheEnabled && getCachedMemories(this.baseDir, prevVersion, keyId, this.hotCacheTtlMs()) !== null;
     const appliedPatches = /* @__PURE__ */ new Map();
@@ -10730,6 +10757,7 @@ ${current.content}
               { onFailRestore: current }
             );
           }
+          if (!entityMentionEpoch.neutral(current.frontmatter, newFm)) entityRefMoved = true;
           return { current, newFm };
         });
         if (applied === null) continue;
@@ -10746,9 +10774,11 @@ ${current.content}
       }
     }
     if (updated > 0) {
-      const { produced, exclusive } = this.bumpMemoryCorpusVersionExclusive();
+      const { produced, exclusive } = this.bumpMemoryCorpusVersionExclusive({
+        indexedText: entityRefMoved ? void 0 : false
+      });
       deleteInFlightReadsForDir(this.baseDir);
-      if (warm && exclusive && produced === prevVersion + 1 && this.getMemoryCorpusVersion() === produced && this.hotCacheKeyId() === keyId) {
+      if (warm && exclusive && !entityRefMoved && produced === prevVersion + 1 && this.getMemoryCorpusVersion() === produced && this.hotCacheKeyId() === keyId) {
         const cur = getCachedMemories(this.baseDir, prevVersion, keyId);
         if (cur) {
           const reapplied = cur.map((m) => {
@@ -11056,6 +11086,7 @@ ${current.content}
       });
       if (!written) return false;
       exactReplay = written === "exact-replay";
+      const mentionBefore = { entityRef: currentBefore.frontmatter.entityRef, origin: currentBefore.frontmatter.origin };
       if (exactReplay && typeof updatedFm.entityRef === "string") {
         await this.entityRefRepair.repair(
           currentBefore.path,
@@ -11066,6 +11097,7 @@ ${current.content}
           { onFailRestore: currentBefore }
         );
       }
+      const mentionUnchanged = entityMentionEpoch.neutral(mentionBefore, updatedFm);
       const supersededAt = updatedFm.supersededAt ?? initialNow;
       const beforeState = this.summarizeLifecycleState(
         currentBefore.frontmatter,
@@ -11088,8 +11120,8 @@ ${current.content}
         readMemoryByPath: (filePath) => this.readMemoryByPath(filePath),
         isColdOrArchiveTierPath: (memoryPath) => this.isColdOrArchiveTierPath(memoryPath),
         invalidateColdMemoriesCache: () => this.invalidateColdMemoriesCache(),
-        invalidateAllMemoriesCache: () => this.invalidateAllMemoriesCache(),
-        bumpMemoryCorpusVersion: () => this.bumpMemoryCorpusVersion(),
+        invalidateAllMemoriesCache: () => this.invalidateAllMemoriesCache({ indexedText: mentionUnchanged ? false : void 0 }),
+        bumpMemoryCorpusVersion: () => this.bumpMemoryCorpusVersion({ indexedText: mentionUnchanged ? false : void 0 }),
         appendLifecycleEvent: async () => {
           let lifecycleEvents = [];
           try {
@@ -11188,7 +11220,7 @@ ${current.content}
           return true;
         });
         if (!written) continue;
-        this.bumpMemoryCorpusVersion();
+        this.bumpMemoryCorpusVersion({ indexedText: entityMentionEpoch.neutral(currentBefore.frontmatter, updatedFm) ? false : void 0 });
         await this.appendGeneratedMemoryLifecycleEventFailOpen("storage.archiveMemories", {
           memoryId: id,
           eventType: "archived",
@@ -11337,4 +11369,4 @@ export {
   isValidBufferSurpriseEvent,
   StorageManager3 as StorageManager
 };
-//# sourceMappingURL=chunk-UFIZRMQZ.js.map
+//# sourceMappingURL=chunk-E4XLFYHV.js.map