@remnic/core 9.69.38 → 9.69.40

package/dist/{chunk-7S53BPTU.js → chunk-MVG3KXON.js}

@@ -1,3 +1,9 @@
+import {
+  TombstoneStore,
+  applyTombstoneResurrectionGate,
+  buildRetiredFactTombstoneInputs,
+  collectRetiredMemoriesForRebuild
+} from "./chunk-46WM6JX2.js";
 import {
   WEARABLES_DIR_NAME,
   escapeSegmentText,
@@ -9,15 +15,9 @@ import {
   unescapeSegmentText,
   unescapeSpeakerLabel
 } from "./chunk-UHVXE24Y.js";
-import {
-  TombstoneStore,
-  applyTombstoneResurrectionGate,
-  buildRetiredFactTombstoneInputs,
-  collectRetiredMemoriesForRebuild
-} from "./chunk-46WM6JX2.js";
 import {
   normalizeQmdResultPath
-} from "./chunk-BJEJUOGM.js";
+} from "./chunk-TZ44E732.js";
 import {
   withholdToolScopedFromSharedNamespace
 } from "./chunk-S2V7RUCL.js";
@@ -30,7 +30,7 @@ import {
 import {
   SPECULATIVE_TTL_DAYS,
   confidenceTier
-} from "./chunk-IYKZJVL5.js";
+} from "./chunk-MDIEES23.js";
 import {
   normalizeProjectionPreview,
   normalizeProjectionTags
@@ -57,7 +57,7 @@ import {
 import {
   parseFaithfulnessField,
   serializeFaithfulnessFields
-} from "./chunk-3N3PBBEH.js";
+} from "./chunk-3XPN7AVY.js";
 import {
   DeletionRevisionStore,
   TombstoneBlockedCaptureIndexHost,
@@ -2353,6 +2353,15 @@ ${rows.join("\n")}
 import { createHash, randomUUID } from "crypto";
 import { mkdir, open, readFile, rename, unlink as unlink2 } from "fs/promises";
 import path6 from "path";
+var ACCESS_TELEMETRY_FRONTMATTER_KEY = /^(?:accessCount|lastAccessed):/;
+function canonicalSemanticFileText(raw) {
+  const lines = raw.split("\n");
+  if (lines[0] !== "---") return raw;
+  const closing = lines.indexOf("---", 1);
+  if (closing === -1) return raw;
+  const frontmatter = lines.slice(1, closing).filter((line) => !ACCESS_TELEMETRY_FRONTMATTER_KEY.test(line));
+  return [...lines.slice(0, 1), ...frontmatter, ...lines.slice(closing)].join("\n");
+}
 var CAS_REVISION_LOCK_STALE_MS = 6e4;
 var CAS_REVISION_LOCK_MAX_WAIT_MS = 12e4;
 var SHA256_HEX = /^[0-9a-f]{64}$/;
@@ -2447,6 +2456,7 @@ var CasRevisionStore = class {
       }
       const foreign = root.path !== relativePath;
       const committedDigest = typeof root.committedDigest === "string" ? root.committedDigest : void 0;
+      const committedSemanticFingerprint = typeof root.committedSemanticFingerprint === "string" ? root.committedSemanticFingerprint : void 0;
       return root.state === "pending" ? {
         kind: "pending",
         revision: root.revision,
@@ -2455,17 +2465,30 @@ var CasRevisionStore = class {
         baselineDigest: root.baselineDigest,
         expectedDigest: root.expectedDigest,
         ...typeof root.writeLanded === "boolean" ? { writeLanded: root.writeLanded } : {}
-      } : { kind: "committed", revision: root.revision, committedDigest, foreign };
+      } : {
+        kind: "committed",
+        revision: root.revision,
+        committedDigest,
+        committedSemanticFingerprint,
+        foreign
+      };
     }
     if (root.version === 1 && root.path === relativePath && typeof root.revision === "string" && root.revision.length > 0) {
       const committedDigest = typeof root.committedDigest === "string" ? root.committedDigest : void 0;
-      return { kind: "committed", revision: root.revision, committedDigest, foreign: false };
+      const committedSemanticFingerprint = typeof root.committedSemanticFingerprint === "string" ? root.committedSemanticFingerprint : void 0;
+      return {
+        kind: "committed",
+        revision: root.revision,
+        committedDigest,
+        committedSemanticFingerprint,
+        foreign: false
+      };
     }
     return { kind: "foreign" };
   }
   async readStandingRevision(relativePath) {
     try {
-      return (await this.readStandingRevisionStrict(relativePath))?.revision;
+      return await this.readStandingRevisionStrict(relativePath);
     } catch (error) {
       log.warn(`CasRevisionStore failed to read standing revision for ${relativePath}: ${error}`);
       return void 0;
@@ -2489,7 +2512,11 @@ var CasRevisionStore = class {
       );
     }
     if (view.kind === "committed" && !view.foreign) {
-      return { revision: view.revision, committedDigest: view.committedDigest };
+      return {
+        revision: view.revision,
+        committedDigest: view.committedDigest,
+        committedSemanticFingerprint: view.committedSemanticFingerprint
+      };
     }
     const legacyMap = await this.readLegacyMetadata();
     const legacyRev = legacyMap.get(relativePath);
@@ -2502,6 +2529,9 @@ var CasRevisionStore = class {
       if (evidence?.committedDigest !== void 0) {
         payload.committedDigest = evidence.committedDigest;
       }
+      if (evidence?.committedSemanticFingerprint !== void 0) {
+        payload.committedSemanticFingerprint = evidence.committedSemanticFingerprint;
+      }
     } else {
       payload = { version: 1, path: relativePath, revision, state };
       if (previous !== void 0) payload.previous = previous;
@@ -2563,7 +2593,7 @@ var CasRevisionStore = class {
   async readRevision(filePath) {
     try {
       const relativePath = await this.resolveRelativePath(filePath);
-      return await this.readStandingRevision(relativePath);
+      return (await this.readStandingRevision(relativePath))?.revision;
     } catch (error) {
       log.warn(`CasRevisionStore.readRevision failed for ${filePath}: ${error}`);
       return void 0;
@@ -2582,7 +2612,8 @@ var CasRevisionStore = class {
       return standing === void 0 ? { status: "absent" } : {
         status: "present",
         revision: standing.revision,
-        ...standing.committedDigest !== void 0 ? { committedDigest: standing.committedDigest } : {}
+        ...standing.committedDigest !== void 0 ? { committedDigest: standing.committedDigest } : {},
+        ...standing.committedSemanticFingerprint !== void 0 ? { committedSemanticFingerprint: standing.committedSemanticFingerprint } : {}
       };
     } catch (error) {
       return { status: "unavailable", reason: error instanceof Error ? error.message : String(error) };
@@ -2627,19 +2658,29 @@ var CasRevisionStore = class {
     return createHash("sha256").update(bytes).digest("hex");
   }
   async digestDurableFile(filePath) {
+    const bytes = await this.readDurableBytes(filePath);
+    return bytes === null ? null : createHash("sha256").update(bytes).digest("hex");
+  }
+  /** #2870: canonical SEMANTIC fingerprint of the durable file — its text
+   * with the access-telemetry frontmatter keys stripped
+   * ({@link canonicalSemanticFileText}), hashed. Null means the file was
+   * absent. A fingerprint, never memory content. */
+  async semanticFingerprintDurableFile(filePath) {
+    const bytes = await this.readDurableBytes(filePath);
+    return bytes === null ? null : createHash("sha256").update(canonicalSemanticFileText(bytes.toString("utf8"))).digest("hex");
+  }
+  async readDurableBytes(filePath) {
     const relativePath = await this.resolveRelativePath(filePath);
     const baseDir = path6.resolve(this.baseDir);
     const target = await resolveSafeStoragePath(baseDir, relativePath);
-    let bytes;
     try {
-      bytes = await readFile(target);
+      return await readFile(target);
     } catch (error) {
       if (isErrnoCode(error, "ENOENT")) return null;
       throw new Error(
         `CAS revision evidence: durable memory file ${relativePath} is unreadable: ${error instanceof Error ? error.message : String(error)}`
       );
     }
-    return createHash("sha256").update(bytes).digest("hex");
   }
   /** #2807: mark the reserved write as landed. Verifies a pre-recorded
    * expected digest against the durable file, or records the file digest
@@ -2674,8 +2715,10 @@ var CasRevisionStore = class {
       if (view.kind === "pending" && !view.foreign && view.revision === token) {
         if (outcome === "commit") {
           const committedDigest = view.expectedDigest ?? await this.digestDurableFile(relativePath);
+          const committedSemanticFingerprint = await this.semanticFingerprintDurableFile(relativePath);
           await this.writeShard(shardPath, relativePath, token, lock, "committed", void 0, {
-            committedDigest
+            committedDigest,
+            committedSemanticFingerprint
           });
         } else if (view.previous !== void 0) {
           await this.writeShard(shardPath, relativePath, view.previous, lock, "committed");
@@ -2715,8 +2758,10 @@ var CasRevisionStore = class {
       }
       if (fileWriteLanded) {
         const committedDigest = view.expectedDigest ?? await this.digestDurableFile(relativePath);
+        const committedSemanticFingerprint = await this.semanticFingerprintDurableFile(relativePath);
         await this.writeShard(shardPath, relativePath, view.revision, lock, "committed", void 0, {
-          committedDigest
+          committedDigest,
+          committedSemanticFingerprint
         });
       } else if (view.previous !== void 0) {
         await this.writeShard(shardPath, relativePath, view.previous, lock, "committed");
@@ -2756,7 +2801,8 @@ var CasRevisionStore = class {
       }
       if (view.expectedDigest !== void 0 && currentDigest === view.expectedDigest) {
         await this.writeShard(shardPath, relativePath, view.revision, lock, "committed", void 0, {
-          committedDigest: view.expectedDigest
+          committedDigest: view.expectedDigest,
+          committedSemanticFingerprint: await this.semanticFingerprintDurableFile(relativePath)
         });
         return "committed";
       }
@@ -11787,6 +11833,7 @@ export {
   serializeDriftProvenance,
   parseDriftProvenance,
   selfDeps,
+  canonicalSemanticFileText,
   qmdCollectionPathParts,
   qmdResultPathCandidates,
   QmdResultResolver,
@@ -11827,4 +11874,4 @@ export {
   isValidBufferSurpriseEvent,
   StorageManager3 as StorageManager
 };
-//# sourceMappingURL=chunk-7S53BPTU.js.map
+//# sourceMappingURL=chunk-MVG3KXON.js.map