@remnic/core 9.69.102 → 9.69.103

package/dist/chunk-XCB6QDL6.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/memory-corpus-version.ts"],"sourcesContent":["import { appendFileSync, mkdirSync } from \"node:fs\";\nimport path from \"node:path\";\nimport { deleteInFlightReadsForDir } from \"./in-flight-reads.js\";\nimport { invalidateDerivedAndGlobalForDir } from \"./memory-cache.js\";\n\n/**\n * Filename of the memory-corpus version sentinel (issue #1902). MUST stay in\n * sync with `StorageManager.versionFilePath(\"memory-corpus\")` in storage.ts —\n * the byte size of this append-only file IS the corpus version, and the\n * version-keyed hot-memories result cache keys on it.\n */\nexport const MEMORY_CORPUS_VERSION_SENTINEL = \".memory-corpus-version.log\";\n\n/**\n * Out-of-band corpus-version bump (issue #1902) for code paths that write or\n * modify memory files WITHOUT going through a StorageManager mutation method\n * — review approval, governance restore, migration. Appends one byte to the\n * on-disk sentinel so any process's version-keyed hot-memories cache rescans\n * on its next read (StorageManager.readSharedVersion reads the file size, so\n * the growth is observed immediately). Fail-open: a bump failure must never\n * crash the caller — a stale-cache window self-heals on the next real write.\n */\nexport function bumpMemoryCorpusVersionForDir(memoryDir: string): void {\n  try {\n    const stateDir = path.join(memoryDir, \"state\");\n    mkdirSync(stateDir, { recursive: true });\n    appendFileSync(path.join(stateDir, MEMORY_CORPUS_VERSION_SENTINEL), \"x\");\n  } catch {\n    /* fail-open: never let a cache-coherence bump crash the primary operation */\n  }\n  // Drop any in-flight readAllMemories scan for this dir (Cursor Medium, #1902):\n  // after the sentinel advances, a concurrent read that missed the version-keyed\n  // hot entry must not attach to a scan that began BEFORE this out-of-band write\n  // and receive a pre-write corpus. Clearing forces a fresh scan of disk truth.\n  deleteInFlightReadsForDir(memoryDir);\n  // Also evict the TTL-keyed derived (episode/rule) and global (QMD search/recall)\n  // caches for this dir (issue #1902, Codex Medium). The sentinel bump self-heals\n  // the version-keyed hot cache, but the QMD caches are TTL-keyed, NOT\n  // corpus-version-keyed — without this, an out-of-band writer (capsule\n  // import/merge, review, spaces, governance restore, page revert, binary\n  // redirect) would leave a warm process serving pre-write recall/search results\n  // for the remainder of the QMD cache TTL. Route the bump through the same\n  // invalidation chokepoint the in-process mutation paths use.\n  invalidateDerivedAndGlobalForDir(memoryDir);\n}\n"],"mappings":";;;;;;;;AAAA,SAAS,gBAAgB,iBAAiB;AAC1C,OAAO,UAAU;AAUV,IAAM,iCAAiC;AAWvC,SAAS,8BAA8B,WAAyB;AACrE,MAAI;AACF,UAAM,WAAW,KAAK,KAAK,WAAW,OAAO;AAC7C,cAAU,UAAU,EAAE,WAAW,KAAK,CAAC;AACvC,mBAAe,KAAK,KAAK,UAAU,8BAA8B,GAAG,GAAG;AAAA,EACzE,QAAQ;AAAA,EAER;AAKA,4BAA0B,SAAS;AASnC,mCAAiC,SAAS;AAC5C;","names":[]}