@remnic/core 9.35.1 → 9.35.3

package/dist/transfer/types.d.ts

@@ -20,26 +20,26 @@ declare const ExportManifestV1Schema: z.ZodObject<{
         bytes: number;
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
-    schemaVersion: 1;
+    format: "openclaw-engram-export";
     createdAt: string;
+    pluginVersion: string;
     files: {
         path: string;
         sha256: string;
         bytes: number;
     }[];
-    format: "openclaw-engram-export";
-    pluginVersion: string;
+    schemaVersion: 1;
     includesTranscripts: boolean;
 }, {
-    schemaVersion: 1;
+    format: "openclaw-engram-export";
     createdAt: string;
+    pluginVersion: string;
     files: {
         path: string;
         sha256: string;
         bytes: number;
     }[];
-    format: "openclaw-engram-export";
-    pluginVersion: string;
+    schemaVersion: 1;
     includesTranscripts: boolean;
 }>;
 type ExportManifestV1 = z.infer<typeof ExportManifestV1Schema>;
@@ -75,26 +75,26 @@ declare const ExportBundleV1Schema: z.ZodObject<{
             bytes: number;
         }>, "many">;
     }, "strip", z.ZodTypeAny, {
-        schemaVersion: 1;
+        format: "openclaw-engram-export";
         createdAt: string;
+        pluginVersion: string;
         files: {
             path: string;
             sha256: string;
             bytes: number;
         }[];
-        format: "openclaw-engram-export";
-        pluginVersion: string;
+        schemaVersion: 1;
         includesTranscripts: boolean;
     }, {
-        schemaVersion: 1;
+        format: "openclaw-engram-export";
         createdAt: string;
+        pluginVersion: string;
         files: {
             path: string;
             sha256: string;
             bytes: number;
         }[];
-        format: "openclaw-engram-export";
-        pluginVersion: string;
+        schemaVersion: 1;
         includesTranscripts: boolean;
     }>;
     records: z.ZodArray<z.ZodObject<{
@@ -109,15 +109,15 @@ declare const ExportBundleV1Schema: z.ZodObject<{
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
     manifest: {
-        schemaVersion: 1;
+        format: "openclaw-engram-export";
         createdAt: string;
+        pluginVersion: string;
         files: {
             path: string;
             sha256: string;
             bytes: number;
         }[];
-        format: "openclaw-engram-export";
-        pluginVersion: string;
+        schemaVersion: 1;
         includesTranscripts: boolean;
     };
     records: {
@@ -126,15 +126,15 @@ declare const ExportBundleV1Schema: z.ZodObject<{
     }[];
 }, {
     manifest: {
-        schemaVersion: 1;
+        format: "openclaw-engram-export";
         createdAt: string;
+        pluginVersion: string;
         files: {
             path: string;
             sha256: string;
             bytes: number;
         }[];
-        format: "openclaw-engram-export";
-        pluginVersion: string;
+        schemaVersion: 1;
         includesTranscripts: boolean;
     };
     records: {
@@ -313,16 +313,16 @@ declare const CapsuleBlockSchema: z.ZodObject<{
         peerProfiles: boolean;
     }>;
 }, "strip", z.ZodTypeAny, {
-    schemaVersion: string;
     includes: {
         procedural: boolean;
         taxonomy: boolean;
         identityAnchors: boolean;
         peerProfiles: boolean;
     };
+    description: string;
     id: string;
+    schemaVersion: string;
     version: string;
-    description: string;
     parentCapsule: string | null;
     parent: {
         version: string;
@@ -334,16 +334,16 @@ declare const CapsuleBlockSchema: z.ZodObject<{
         directAnswerEnabled: boolean;
     };
 }, {
-    schemaVersion: string;
     includes: {
         procedural: boolean;
         taxonomy: boolean;
         identityAnchors: boolean;
         peerProfiles: boolean;
     };
+    description: string;
     id: string;
+    schemaVersion: string;
     version: string;
-    description: string;
     parentCapsule: string | null;
     retrievalPolicy: {
         tierWeights: Record<string, number>;
@@ -464,16 +464,16 @@ declare const ExportManifestV2Schema: z.ZodObject<{
             peerProfiles: boolean;
         }>;
     }, "strip", z.ZodTypeAny, {
-        schemaVersion: string;
         includes: {
             procedural: boolean;
             taxonomy: boolean;
             identityAnchors: boolean;
             peerProfiles: boolean;
         };
+        description: string;
         id: string;
+        schemaVersion: string;
         version: string;
-        description: string;
         parentCapsule: string | null;
         parent: {
             version: string;
@@ -485,16 +485,16 @@ declare const ExportManifestV2Schema: z.ZodObject<{
             directAnswerEnabled: boolean;
         };
     }, {
-        schemaVersion: string;
         includes: {
             procedural: boolean;
             taxonomy: boolean;
             identityAnchors: boolean;
             peerProfiles: boolean;
         };
+        description: string;
         id: string;
+        schemaVersion: string;
         version: string;
-        description: string;
         parentCapsule: string | null;
         retrievalPolicy: {
             tierWeights: Record<string, number>;
@@ -507,27 +507,25 @@ declare const ExportManifestV2Schema: z.ZodObject<{
         } | null | undefined;
     }>;
 }, "strip", z.ZodTypeAny, {
-    schemaVersion: 2;
+    format: "openclaw-engram-export";
     createdAt: string;
+    pluginVersion: string;
     files: {
         path: string;
         sha256: string;
         bytes: number;
     }[];
-    format: "openclaw-engram-export";
-    pluginVersion: string;
-    includesTranscripts: boolean;
     capsule: {
-        schemaVersion: string;
         includes: {
             procedural: boolean;
             taxonomy: boolean;
             identityAnchors: boolean;
             peerProfiles: boolean;
         };
+        description: string;
         id: string;
+        schemaVersion: string;
         version: string;
-        description: string;
         parentCapsule: string | null;
         parent: {
             version: string;
@@ -539,28 +537,28 @@ declare const ExportManifestV2Schema: z.ZodObject<{
             directAnswerEnabled: boolean;
         };
     };
-}, {
     schemaVersion: 2;
+    includesTranscripts: boolean;
+}, {
+    format: "openclaw-engram-export";
     createdAt: string;
+    pluginVersion: string;
     files: {
         path: string;
         sha256: string;
         bytes: number;
     }[];
-    format: "openclaw-engram-export";
-    pluginVersion: string;
-    includesTranscripts: boolean;
     capsule: {
-        schemaVersion: string;
         includes: {
             procedural: boolean;
             taxonomy: boolean;
             identityAnchors: boolean;
             peerProfiles: boolean;
         };
+        description: string;
         id: string;
+        schemaVersion: string;
         version: string;
-        description: string;
         parentCapsule: string | null;
         retrievalPolicy: {
             tierWeights: Record<string, number>;
@@ -572,6 +570,8 @@ declare const ExportManifestV2Schema: z.ZodObject<{
             forkRoot: string;
         } | null | undefined;
     };
+    schemaVersion: 2;
+    includesTranscripts: boolean;
 }>;
 type ExportManifestV2 = z.infer<typeof ExportManifestV2Schema>;
 declare const ExportBundleV2Schema: z.ZodObject<{
@@ -683,16 +683,16 @@ declare const ExportBundleV2Schema: z.ZodObject<{
                 peerProfiles: boolean;
             }>;
         }, "strip", z.ZodTypeAny, {
-            schemaVersion: string;
             includes: {
                 procedural: boolean;
                 taxonomy: boolean;
                 identityAnchors: boolean;
                 peerProfiles: boolean;
             };
+            description: string;
             id: string;
+            schemaVersion: string;
             version: string;
-            description: string;
             parentCapsule: string | null;
             parent: {
                 version: string;
@@ -704,16 +704,16 @@ declare const ExportBundleV2Schema: z.ZodObject<{
                 directAnswerEnabled: boolean;
             };
         }, {
-            schemaVersion: string;
             includes: {
                 procedural: boolean;
                 taxonomy: boolean;
                 identityAnchors: boolean;
                 peerProfiles: boolean;
             };
+            description: string;
             id: string;
+            schemaVersion: string;
             version: string;
-            description: string;
             parentCapsule: string | null;
             retrievalPolicy: {
                 tierWeights: Record<string, number>;
@@ -726,27 +726,25 @@ declare const ExportBundleV2Schema: z.ZodObject<{
             } | null | undefined;
         }>;
     }, "strip", z.ZodTypeAny, {
-        schemaVersion: 2;
+        format: "openclaw-engram-export";
         createdAt: string;
+        pluginVersion: string;
         files: {
             path: string;
             sha256: string;
             bytes: number;
         }[];
-        format: "openclaw-engram-export";
-        pluginVersion: string;
-        includesTranscripts: boolean;
         capsule: {
-            schemaVersion: string;
             includes: {
                 procedural: boolean;
                 taxonomy: boolean;
                 identityAnchors: boolean;
                 peerProfiles: boolean;
             };
+            description: string;
             id: string;
+            schemaVersion: string;
             version: string;
-            description: string;
             parentCapsule: string | null;
             parent: {
                 version: string;
@@ -758,28 +756,28 @@ declare const ExportBundleV2Schema: z.ZodObject<{
                 directAnswerEnabled: boolean;
             };
         };
-    }, {
         schemaVersion: 2;
+        includesTranscripts: boolean;
+    }, {
+        format: "openclaw-engram-export";
         createdAt: string;
+        pluginVersion: string;
         files: {
             path: string;
             sha256: string;
             bytes: number;
         }[];
-        format: "openclaw-engram-export";
-        pluginVersion: string;
-        includesTranscripts: boolean;
         capsule: {
-            schemaVersion: string;
             includes: {
                 procedural: boolean;
                 taxonomy: boolean;
                 identityAnchors: boolean;
                 peerProfiles: boolean;
             };
+            description: string;
             id: string;
+            schemaVersion: string;
             version: string;
-            description: string;
             parentCapsule: string | null;
             retrievalPolicy: {
                 tierWeights: Record<string, number>;
@@ -791,6 +789,8 @@ declare const ExportBundleV2Schema: z.ZodObject<{
                 forkRoot: string;
             } | null | undefined;
         };
+        schemaVersion: 2;
+        includesTranscripts: boolean;
     }>;
     records: z.ZodArray<z.ZodObject<{
         path: z.ZodString;
@@ -804,27 +804,25 @@ declare const ExportBundleV2Schema: z.ZodObject<{
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
     manifest: {
-        schemaVersion: 2;
+        format: "openclaw-engram-export";
         createdAt: string;
+        pluginVersion: string;
         files: {
             path: string;
             sha256: string;
             bytes: number;
         }[];
-        format: "openclaw-engram-export";
-        pluginVersion: string;
-        includesTranscripts: boolean;
         capsule: {
-            schemaVersion: string;
             includes: {
                 procedural: boolean;
                 taxonomy: boolean;
                 identityAnchors: boolean;
                 peerProfiles: boolean;
             };
+            description: string;
             id: string;
+            schemaVersion: string;
             version: string;
-            description: string;
             parentCapsule: string | null;
             parent: {
                 version: string;
@@ -836,6 +834,8 @@ declare const ExportBundleV2Schema: z.ZodObject<{
                 directAnswerEnabled: boolean;
             };
         };
+        schemaVersion: 2;
+        includesTranscripts: boolean;
     };
     records: {
         content: string;
@@ -843,27 +843,25 @@ declare const ExportBundleV2Schema: z.ZodObject<{
     }[];
 }, {
     manifest: {
-        schemaVersion: 2;
+        format: "openclaw-engram-export";
         createdAt: string;
+        pluginVersion: string;
         files: {
             path: string;
             sha256: string;
             bytes: number;
         }[];
-        format: "openclaw-engram-export";
-        pluginVersion: string;
-        includesTranscripts: boolean;
         capsule: {
-            schemaVersion: string;
             includes: {
                 procedural: boolean;
                 taxonomy: boolean;
                 identityAnchors: boolean;
                 peerProfiles: boolean;
             };
+            description: string;
             id: string;
+            schemaVersion: string;
             version: string;
-            description: string;
             parentCapsule: string | null;
             retrievalPolicy: {
                 tierWeights: Record<string, number>;
@@ -875,6 +873,8 @@ declare const ExportBundleV2Schema: z.ZodObject<{
                 forkRoot: string;
             } | null | undefined;
         };
+        schemaVersion: 2;
+        includesTranscripts: boolean;
     };
     records: {
         content: string;

package/dist/verified-recall.js

@@ -1,18 +1,16 @@
 import {
   compareVerifiedEpisodeResults,
   searchVerifiedEpisodes
-} from "./chunk-EO7X2LDK.js";
+} from "./chunk-4TAD3B56.js";
 import "./chunk-B7RWBZXW.js";
-import "./chunk-4TGZCYHH.js";
+import "./chunk-Q3CVY7LV.js";
 import "./chunk-UHVXE24Y.js";
-import "./chunk-QNWXCJ76.js";
+import "./chunk-ENTCVTQR.js";
 import "./chunk-WIPEXG6R.js";
-import "./chunk-DNHVPZOD.js";
-import "./chunk-6CIAGZ6X.js";
 import "./chunk-HKF5VASQ.js";
 import "./chunk-J6A3CX5N.js";
 import "./chunk-HXDWZFNP.js";
-import "./chunk-7VUAG236.js";
+import "./chunk-T3FVAHM7.js";
 import "./chunk-EGGE52UU.js";
 import "./chunk-ILGC6JH6.js";
 import "./chunk-SCU65EZI.js";
@@ -20,20 +18,23 @@ import "./chunk-WRJVB3C2.js";
 import "./chunk-GCASGYIO.js";
 import "./chunk-DM2T26WE.js";
 import "./chunk-LDXUBPMO.js";
-import "./chunk-FBUE6PD3.js";
+import "./chunk-BEQOZOYZ.js";
 import "./chunk-CGASUJVP.js";
 import "./chunk-R3DJVOSM.js";
 import "./chunk-BT7NVCML.js";
-import "./chunk-FFAZ2XFU.js";
 import "./chunk-3CSX3ETE.js";
 import "./chunk-RL6NEVXT.js";
 import "./chunk-JYIJNNN3.js";
 import "./chunk-AAD2ZS6P.js";
 import "./chunk-YXZG5TVN.js";
 import "./chunk-G7D6GZ5J.js";
-import "./chunk-6TAUHL33.js";
+import "./chunk-DLVPUX7U.js";
 import "./chunk-IJ7HK452.js";
 import "./chunk-PDJTHRAW.js";
+import "./chunk-4J7G5SY4.js";
+import "./chunk-DNHVPZOD.js";
+import "./chunk-6CIAGZ6X.js";
+import "./chunk-FFAZ2XFU.js";
 import "./chunk-W5H6ZRPT.js";
 import "./chunk-XMMESCPD.js";
 import "./chunk-42JKGUFJ.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@remnic/core",
-  "version": "9.35.1",
+  "version": "9.35.3",
   "description": "Framework-agnostic Remnic memory engine — orchestrator, storage, extraction, search, trust zones",
   "type": "module",
   "main": "dist/index.js",
@@ -3086,7 +3086,7 @@
     "core"
   ],
   "peerDependencies": {
-    "@remnic/coding-graph": "^9.35.1"
+    "@remnic/coding-graph": "^9.35.3"
   },
   "peerDependenciesMeta": {
     "@remnic/coding-graph": {

package/src/binary-lifecycle/pipeline.ts

@@ -20,6 +20,16 @@ import { readManifest, writeManifest } from "./manifest.js";
 import { scanForBinaries } from "./scanner.js";
 import { bumpMemoryCorpusVersionForDir } from "../memory-corpus-version.js";
 import { RECALL_FALLBACK_DIRS } from "../utils/category-dir.js";
+import {
+  HistoricalEntityCanonicalIdCache,
+  canonicalizeEntityRefFrontmatter,
+  classifyEntityRefWritePath,
+  repairContentAfterJournalMove,
+  requestEntityCanonicalIdReconcile,
+} from "../storage/entity-canonical-id-references.js";
+
+// Write-boundary journal cache for redirect rewrites (issue #2213).
+const historicalIdCache = new HistoricalEntityCanonicalIdCache();
 
 /**
  * True when `mdPath` is an active recall-corpus memory file under `memoryDir`
@@ -319,7 +329,48 @@ async function stageRedirect(
     let writeFailCount = 0;
     for (const update of updates) {
       try {
-        await writeMarkdownFile(update.mdPath, update.content);
+        // Whole-record rewrite of bytes read earlier (issue #2213): for
+        // memory-tier records, resolve the frontmatter entityRef through the
+        // CURRENT journal at the write and REPAIR afterwards — writing back
+        // the as-read bytes could revert a rewrite a peer migration performed
+        // since the read. findMarkdownFiles also surfaces transcripts,
+        // profiles, and other Markdown outside the migration's scope: those
+        // keep their bytes (plus the redirect) untouched, and entities/ pages
+        // get the bounded reconcile marker instead — their migrated surface
+        // is relationship targets, not an entityRef frontmatter field.
+        const stateDir = path.join(memoryDir, "state");
+        const kind = classifyEntityRefWritePath(memoryDir, update.mdPath);
+        if (kind === "memory") {
+          const idsAtWrite = historicalIdCache.get(stateDir);
+          const written = canonicalizeEntityRefFrontmatter(update.content, idsAtWrite);
+          // Snapshot the ORIGINAL bytes: if repair fails after the write, the
+          // catch below reports a failed redirect, so the file must return to
+          // its pre-redirect state — a retry needs the original reference,
+          // and the skipped corpus bump means a warm cache would otherwise
+          // keep serving bytes that no longer match disk (AGENTS.md §14).
+          const originalBytes = await readMarkdownFile(update.mdPath).catch(() => null);
+          await writeMarkdownFile(update.mdPath, written);
+          try {
+            await repairContentAfterJournalMove({
+              stateDir,
+              cache: historicalIdCache,
+              idsAtWrite,
+              rawContent: update.content,
+              lastWritten: written,
+              rewrite: (next) => writeMarkdownFile(update.mdPath, next),
+            });
+          } catch (err) {
+            if (originalBytes !== null) {
+              await writeMarkdownFile(update.mdPath, originalBytes).catch(() => undefined);
+            }
+            throw err;
+          }
+        } else {
+          await writeMarkdownFile(update.mdPath, update.content);
+          if (kind === "entity") {
+            await requestEntityCanonicalIdReconcile(stateDir);
+          }
+        }
         // The redirect rewrote an on-disk memory file out-of-band (not through a
         // StorageManager mutation). Bump the corpus sentinel per write so a warm
         // hot-memories cache rescans — mid-batch too, never serving pre-redirect

package/src/consolidation-undo.ts

@@ -26,6 +26,7 @@ import { constants as fsConstants } from "node:fs";
 import type { StorageManager } from "./storage.js";
 import type { VersioningConfig } from "./page-versioning.js";
 import { bumpMemoryCorpusVersionForDir } from "./memory-corpus-version.js";
+import { requestEntityCanonicalIdReconcile } from "./storage/entity-canonical-id-references.js";
 import { getVersion } from "./page-versioning.js";
 
 /**
@@ -654,6 +655,9 @@ export async function runConsolidationUndo(options: {
         // restores would stay invisible to recall until an unrelated mutation or
         // restart (esp. with hotMemoriesCacheTtlMs: 0). Issue #1902, Codex Medium.
         bumpMemoryCorpusVersionForDir(memoryDir);
+        // Restored bytes predate the current migration journal and can carry
+        // legacy entity references (issue #2213) — request one reconcile pass.
+        await requestEntityCanonicalIdReconcile(path.join(memoryDir, "state"));
         result.restores.push({
           entry: p.entry,
           sourcePath: p.sourcePath,

package/src/curation/index.ts

@@ -10,6 +10,11 @@ import path from "node:path";
 import crypto from "node:crypto";
 import { getCategoryDir, ALL_CATEGORY_DIRS } from "../utils/category-dir.js";
 import { bumpMemoryCorpusVersionForDir } from "../memory-corpus-version.js";
+import {
+  HistoricalEntityCanonicalIdCache,
+  canonicalizeEntityRefFrontmatter,
+  repairContentAfterJournalMoveSync,
+} from "../storage/entity-canonical-id-references.js";
 
 // ── Types ────────────────────────────────────────────────────────────────────
 
@@ -444,6 +449,10 @@ function loadExistingMemories(memoryDir: string): Map<string, ExistingMemory> {
 
 // ── Writing ──────────────────────────────────────────────────────────────────
 
+// Curation writes raw frontmatter directly, so it is a write boundary for
+// entity references too (issue #2213): resolve through the target's journal.
+const historicalIdCache = new HistoricalEntityCanonicalIdCache();
+
 function writeStatement(stmt: CuratedStatement, memoryDir: string): string {
   const now = new Date();
   const dateDir = now.toISOString().split("T")[0];
@@ -454,8 +463,12 @@ function writeStatement(stmt: CuratedStatement, memoryDir: string): string {
 
   const fileName = `${stmt.category}-${Date.now()}-${stmt.id.slice(0, 8)}.md`;
   const filePath = path.join(dir, fileName);
+  const historicalIds = historicalIdCache.get(path.join(memoryDir, "state"));
 
-  const frontmatter = [
+  // Keep the caller's ORIGINAL ref in the raw form: repair-after-write must
+  // re-resolve from it, including the direction where a mapping was parked
+  // and the resolution falls back to the legacy claimant (issue #2213).
+  const rawBody = `${[
     "---",
     `id: ${stmt.id}`,
     `category: ${stmt.category}`,
@@ -471,14 +484,37 @@ function writeStatement(stmt: CuratedStatement, memoryDir: string): string {
     "---",
   ]
     .filter(Boolean)
-    .join("\n");
-
-  const body = `${frontmatter}\n\n${stmt.content}\n`;
+    .join("\n")}\n\n${stmt.content}\n`;
+  const body = canonicalizeEntityRefFrontmatter(rawBody, historicalIds);
 
   fs.writeFileSync(filePath, body);
+  // Post-write REPAIR (issue #2213): a peer process publishing the journal
+  // across this write would otherwise strand the reference — the corpus bump
+  // below no longer re-triggers the migration, and a parked mapping cannot be
+  // fixed after the fact by the reconcile pass. On repair exhaustion, remove
+  // the just-created file so the retryable error leaves no untracked partial
+  // statement (a retry would otherwise duplicate it).
+  try {
+    repairContentAfterJournalMoveSync({
+      stateDir: path.join(memoryDir, "state"),
+      cache: historicalIdCache,
+      idsAtWrite: historicalIds,
+      rawContent: rawBody,
+      lastWritten: body,
+      rewrite: (next) => fs.writeFileSync(filePath, next),
+    });
+  } catch (err) {
+    try {
+      fs.unlinkSync(filePath);
+    } catch {
+      // Best effort — the retryable repair error is the primary signal.
+    }
+    throw err;
+  }
   // Bump the corpus sentinel per write (out-of-band create) so a concurrent
   // same-process readAllMemories rescans and sees this statement immediately,
-  // never a stale/partial corpus mid-batch (Cursor Medium, #1902).
+  // never a stale/partial corpus mid-batch (Cursor Medium, #1902). AFTER the
+  // repair, so a rescan never captures pre-repair bytes.
   bumpMemoryCorpusVersionForDir(memoryDir);
   return filePath;
 }