@remnic/core 9.3.553 → 9.3.555

package/dist/access-cli.js

@@ -1,6 +1,6 @@
 import {
   Orchestrator
-} from "./chunk-NYV435HC.js";
+} from "./chunk-RLPIT4YI.js";
 import "./chunk-5RIRL3XL.js";
 import "./chunk-BFBF3XEF.js";
 import "./chunk-KVEVLBKC.js";
@@ -32,12 +32,12 @@ import "./chunk-USYGGIJZ.js";
 import "./chunk-V3RXWQIE.js";
 import "./chunk-5IZL4DCV.js";
 import "./chunk-X7XN6YU4.js";
-import "./chunk-XEKAG3FM.js";
+import "./chunk-452WDNFO.js";
 import "./chunk-TDKQGLJW.js";
 import "./chunk-OZKZ2TRP.js";
 import "./chunk-YDBIWGNI.js";
 import "./chunk-7DHTMOND.js";
-import "./chunk-MGVIEM2O.js";
+import "./chunk-2IT7WFYE.js";
 import "./chunk-YCN4BVDK.js";
 import "./chunk-ZZTOURJI.js";
 import "./chunk-XKXKSQU7.js";
@@ -81,7 +81,7 @@ import "./chunk-FADZBOR4.js";
 import "./chunk-XPXEJRUB.js";
 import "./chunk-A6D7A2FW.js";
 import "./chunk-FF4KLI5W.js";
-import "./chunk-4426WSWL.js";
+import "./chunk-SFQ6QNL7.js";
 import "./chunk-A2Z6UCWT.js";
 import "./chunk-KXULCVOC.js";
 import "./chunk-SML26KED.js";

package/dist/{chunk-MGVIEM2O.js → chunk-2IT7WFYE.js}

@@ -1,6 +1,6 @@
 import {
   writeFileAtomically
-} from "./chunk-4426WSWL.js";
+} from "./chunk-SFQ6QNL7.js";
 import {
   log
 } from "./chunk-2ODBA7MQ.js";
@@ -257,4 +257,4 @@ export {
   LastRecallStore,
   TierMigrationStatusStore
 };
-//# sourceMappingURL=chunk-MGVIEM2O.js.map
+//# sourceMappingURL=chunk-2IT7WFYE.js.map

package/dist/{chunk-XEKAG3FM.js → chunk-452WDNFO.js}

@@ -1,6 +1,6 @@
 import {
   writeFileAtomically
-} from "./chunk-4426WSWL.js";
+} from "./chunk-SFQ6QNL7.js";
 import {
   log
 } from "./chunk-2ODBA7MQ.js";
@@ -75,4 +75,4 @@ var RelevanceStore = class {
 export {
   RelevanceStore
 };
-//# sourceMappingURL=chunk-XEKAG3FM.js.map
+//# sourceMappingURL=chunk-452WDNFO.js.map

package/dist/{chunk-2NM43EWN.js → chunk-D6RIFG4O.js}

@@ -1,7 +1,7 @@
 import {
   backupAndWriteRebuiltObservations,
   toHourBucketIso
-} from "./chunk-RUZOJKNF.js";
+} from "./chunk-JCK7V6SN.js";
 
 // src/maintenance/migrate-observations.ts
 import path from "path";
@@ -156,4 +156,4 @@ async function migrateObservations(options) {
 export {
   migrateObservations
 };
-//# sourceMappingURL=chunk-2NM43EWN.js.map
+//# sourceMappingURL=chunk-D6RIFG4O.js.map

package/dist/{chunk-GEL3F3RV.js → chunk-I2K6KCVC.js}

@@ -44,21 +44,21 @@ import {
 } from "./chunk-HOJZMQ4J.js";
 import {
   migrateObservations
-} from "./chunk-2NM43EWN.js";
+} from "./chunk-D6RIFG4O.js";
 import {
   rebuildMemoryLifecycleLedger
-} from "./chunk-M3BAMVAE.js";
+} from "./chunk-O4M4WH6V.js";
 import {
   rebuildMemoryProjection,
   repairMemoryProjection,
   verifyMemoryProjection
-} from "./chunk-Y4YATXHL.js";
+} from "./chunk-ILJXM3FV.js";
 import {
   rebuildObservations
-} from "./chunk-XR6DNK4U.js";
+} from "./chunk-LZZNTPLR.js";
 import {
   archiveObservations
-} from "./chunk-S7WU3Y3D.js";
+} from "./chunk-WMWVO45V.js";
 import {
   getBulkImportSource,
   listBulkImportSources,
@@ -6616,4 +6616,4 @@ export {
   resolveMemoryDirForNamespace,
   registerCli
 };
-//# sourceMappingURL=chunk-GEL3F3RV.js.map
+//# sourceMappingURL=chunk-I2K6KCVC.js.map

package/dist/{chunk-Y4YATXHL.js → chunk-ILJXM3FV.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-KJTKLXTH.js";
 import {
   commitPreparedFileAtomically
-} from "./chunk-4426WSWL.js";
+} from "./chunk-SFQ6QNL7.js";
 import {
   loadPersistedNativeKnowledgeChunks
 } from "./chunk-BEUDU7Y4.js";
@@ -929,4 +929,4 @@ export {
   verifyMemoryProjection,
   repairMemoryProjection
 };
-//# sourceMappingURL=chunk-Y4YATXHL.js.map
+//# sourceMappingURL=chunk-ILJXM3FV.js.map

package/dist/{chunk-RUZOJKNF.js → chunk-JCK7V6SN.js}

@@ -1,6 +1,6 @@
 import {
   writeFileAtomically
-} from "./chunk-4426WSWL.js";
+} from "./chunk-SFQ6QNL7.js";
 
 // src/maintenance/observation-ledger-utils.ts
 import path from "path";
@@ -50,4 +50,4 @@ export {
   toHourBucketIso,
   backupAndWriteRebuiltObservations
 };
-//# sourceMappingURL=chunk-RUZOJKNF.js.map
+//# sourceMappingURL=chunk-JCK7V6SN.js.map

package/dist/{chunk-XR6DNK4U.js → chunk-LZZNTPLR.js}

@@ -1,7 +1,7 @@
 import {
   backupAndWriteRebuiltObservations,
   toHourBucketIso
-} from "./chunk-RUZOJKNF.js";
+} from "./chunk-JCK7V6SN.js";
 
 // src/maintenance/rebuild-observations.ts
 import path from "path";
@@ -124,4 +124,4 @@ async function rebuildObservations(options) {
 export {
   rebuildObservations
 };
-//# sourceMappingURL=chunk-XR6DNK4U.js.map
+//# sourceMappingURL=chunk-LZZNTPLR.js.map

package/dist/{chunk-M3BAMVAE.js → chunk-O4M4WH6V.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-KJTKLXTH.js";
 import {
   writeFileAtomically
-} from "./chunk-4426WSWL.js";
+} from "./chunk-SFQ6QNL7.js";
 import {
   StorageManager
 } from "./chunk-TVZ6LKKS.js";
@@ -74,4 +74,4 @@ export {
   backupExistingLedger,
   rebuildMemoryLifecycleLedger
 };
-//# sourceMappingURL=chunk-M3BAMVAE.js.map
+//# sourceMappingURL=chunk-O4M4WH6V.js.map

package/dist/{chunk-NYV435HC.js → chunk-RLPIT4YI.js}

@@ -87,7 +87,7 @@ import {
 } from "./chunk-X7XN6YU4.js";
 import {
   RelevanceStore
-} from "./chunk-XEKAG3FM.js";
+} from "./chunk-452WDNFO.js";
 import {
   RerankCache,
   rerankLocalOrNoop
@@ -106,7 +106,7 @@ import {
   LastRecallStore,
   TierMigrationStatusStore,
   clampGraphRecallExpandedEntries
-} from "./chunk-MGVIEM2O.js";
+} from "./chunk-2IT7WFYE.js";
 import {
   buildQmdRecallCacheKey,
   getCachedQmdRecall,
@@ -12405,4 +12405,4 @@ export {
   resolvePersistedMemoryRelativePath,
   Orchestrator
 };
-//# sourceMappingURL=chunk-NYV435HC.js.map
+//# sourceMappingURL=chunk-RLPIT4YI.js.map

package/dist/{chunk-4426WSWL.js → chunk-SFQ6QNL7.js}

@@ -34,7 +34,11 @@ async function writeFileAtomically(outputPath, content, backupPath) {
   let resolvedBackupPath;
   try {
     handle = await open(tempPath, "w");
-    await handle.writeFile(content, "utf-8");
+    if (typeof content === "string") {
+      await handle.writeFile(content, "utf-8");
+    } else {
+      await handle.writeFile(content);
+    }
     await handle.sync();
     await handle.close();
     handle = void 0;
@@ -70,4 +74,4 @@ export {
   writeFileAtomically,
   commitPreparedFileAtomically
 };
-//# sourceMappingURL=chunk-4426WSWL.js.map
+//# sourceMappingURL=chunk-SFQ6QNL7.js.map

package/dist/chunk-SFQ6QNL7.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/maintenance/atomic-file.ts"],"sourcesContent":["import path from \"node:path\";\nimport { copyFile, mkdir, open, rename, rm, stat } from \"node:fs/promises\";\n\nasync function syncDirectory(dir: string): Promise<void> {\n  let handle: Awaited<ReturnType<typeof open>> | undefined;\n  try {\n    handle = await open(dir, \"r\");\n    await handle.sync();\n  } catch {\n    // Directory fsync is best-effort across platforms and filesystems.\n  } finally {\n    await handle?.close().catch(() => undefined);\n  }\n}\n\nfunction tempPathFor(outputPath: string): string {\n  const suffix = `${process.pid}.${Date.now()}.${Math.random().toString(36).slice(2)}`;\n  return path.join(path.dirname(outputPath), `.${path.basename(outputPath)}.${suffix}.tmp`);\n}\n\nexport async function copyExistingFileToBackup(\n  sourcePath: string,\n  backupPath: string,\n): Promise<string | undefined> {\n  try {\n    await stat(sourcePath);\n  } catch (err) {\n    if ((err as NodeJS.ErrnoException).code === \"ENOENT\") return undefined;\n    throw err;\n  }\n\n  await mkdir(path.dirname(backupPath), { recursive: true });\n  await copyFile(sourcePath, backupPath);\n  return backupPath;\n}\n\nexport async function writeFileAtomically(\n  outputPath: string,\n  content: string | Uint8Array,\n  backupPath?: string,\n): Promise<string | undefined> {\n  const dir = path.dirname(outputPath);\n  await mkdir(dir, { recursive: true });\n  const tempPath = tempPathFor(outputPath);\n  let handle: Awaited<ReturnType<typeof open>> | undefined;\n  let resolvedBackupPath: string | undefined;\n  try {\n    handle = await open(tempPath, \"w\");\n    if (typeof content === \"string\") {\n      await handle.writeFile(content, \"utf-8\");\n    } else {\n      await handle.writeFile(content);\n    }\n    await handle.sync();\n    await handle.close();\n    handle = undefined;\n\n    if (backupPath) {\n      resolvedBackupPath = await copyExistingFileToBackup(outputPath, backupPath);\n    }\n    await rename(tempPath, outputPath);\n    await syncDirectory(dir);\n    return resolvedBackupPath;\n  } catch (err) {\n    await handle?.close().catch(() => undefined);\n    await rm(tempPath, { force: true }).catch(() => undefined);\n    throw err;\n  }\n}\n\nexport async function commitPreparedFileAtomically(\n  tempPath: string,\n  outputPath: string,\n  backupPath?: string,\n): Promise<string | undefined> {\n  const dir = path.dirname(outputPath);\n  let resolvedBackupPath: string | undefined;\n  try {\n    if (backupPath) {\n      resolvedBackupPath = await copyExistingFileToBackup(outputPath, backupPath);\n    }\n    await rename(tempPath, outputPath);\n    await syncDirectory(dir);\n    return resolvedBackupPath;\n  } catch (err) {\n    await rm(tempPath, { force: true }).catch(() => undefined);\n    throw err;\n  }\n}\n"],"mappings":";AAAA,OAAO,UAAU;AACjB,SAAS,UAAU,OAAO,MAAM,QAAQ,IAAI,YAAY;AAExD,eAAe,cAAc,KAA4B;AACvD,MAAI;AACJ,MAAI;AACF,aAAS,MAAM,KAAK,KAAK,GAAG;AAC5B,UAAM,OAAO,KAAK;AAAA,EACpB,QAAQ;AAAA,EAER,UAAE;AACA,UAAM,QAAQ,MAAM,EAAE,MAAM,MAAM,MAAS;AAAA,EAC7C;AACF;AAEA,SAAS,YAAY,YAA4B;AAC/C,QAAM,SAAS,GAAG,QAAQ,GAAG,IAAI,KAAK,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,SAAS,EAAE,EAAE,MAAM,CAAC,CAAC;AAClF,SAAO,KAAK,KAAK,KAAK,QAAQ,UAAU,GAAG,IAAI,KAAK,SAAS,UAAU,CAAC,IAAI,MAAM,MAAM;AAC1F;AAEA,eAAsB,yBACpB,YACA,YAC6B;AAC7B,MAAI;AACF,UAAM,KAAK,UAAU;AAAA,EACvB,SAAS,KAAK;AACZ,QAAK,IAA8B,SAAS,SAAU,QAAO;AAC7D,UAAM;AAAA,EACR;AAEA,QAAM,MAAM,KAAK,QAAQ,UAAU,GAAG,EAAE,WAAW,KAAK,CAAC;AACzD,QAAM,SAAS,YAAY,UAAU;AACrC,SAAO;AACT;AAEA,eAAsB,oBACpB,YACA,SACA,YAC6B;AAC7B,QAAM,MAAM,KAAK,QAAQ,UAAU;AACnC,QAAM,MAAM,KAAK,EAAE,WAAW,KAAK,CAAC;AACpC,QAAM,WAAW,YAAY,UAAU;AACvC,MAAI;AACJ,MAAI;AACJ,MAAI;AACF,aAAS,MAAM,KAAK,UAAU,GAAG;AACjC,QAAI,OAAO,YAAY,UAAU;AAC/B,YAAM,OAAO,UAAU,SAAS,OAAO;AAAA,IACzC,OAAO;AACL,YAAM,OAAO,UAAU,OAAO;AAAA,IAChC;AACA,UAAM,OAAO,KAAK;AAClB,UAAM,OAAO,MAAM;AACnB,aAAS;AAET,QAAI,YAAY;AACd,2BAAqB,MAAM,yBAAyB,YAAY,UAAU;AAAA,IAC5E;AACA,UAAM,OAAO,UAAU,UAAU;AACjC,UAAM,cAAc,GAAG;AACvB,WAAO;AAAA,EACT,SAAS,KAAK;AACZ,UAAM,QAAQ,MAAM,EAAE,MAAM,MAAM,MAAS;AAC3C,UAAM,GAAG,UAAU,EAAE,OAAO,KAAK,CAAC,EAAE,MAAM,MAAM,MAAS;AACzD,UAAM;AAAA,EACR;AACF;AAEA,eAAsB,6BACpB,UACA,YACA,YAC6B;AAC7B,QAAM,MAAM,KAAK,QAAQ,UAAU;AACnC,MAAI;AACJ,MAAI;AACF,QAAI,YAAY;AACd,2BAAqB,MAAM,yBAAyB,YAAY,UAAU;AAAA,IAC5E;AACA,UAAM,OAAO,UAAU,UAAU;AACjC,UAAM,cAAc,GAAG;AACvB,WAAO;AAAA,EACT,SAAS,KAAK;AACZ,UAAM,GAAG,UAAU,EAAE,OAAO,KAAK,CAAC,EAAE,MAAM,MAAM,MAAS;AACzD,UAAM;AAAA,EACR;AACF;","names":[]}

package/dist/{chunk-S7WU3Y3D.js → chunk-WMWVO45V.js}

@@ -1,6 +1,10 @@
+import {
+  writeFileAtomically
+} from "./chunk-SFQ6QNL7.js";
+
 // src/maintenance/archive-observations.ts
 import path from "path";
-import { lstat, mkdir, readdir, readFile, realpath, unlink, writeFile } from "fs/promises";
+import { lstat, mkdir, readdir, readFile, realpath, unlink } from "fs/promises";
 var DATE_FILE_PATTERN = /^(\d{4})-(\d{2})-(\d{2})\.(jsonl|md)$/;
 function normalizeRetentionDays(value) {
   if (!Number.isFinite(value)) return 30;
@@ -17,6 +21,9 @@ function extractDateFromFilename(name) {
 function startOfUtcDay(value) {
   return Date.UTC(value.getUTCFullYear(), value.getUTCMonth(), value.getUTCDate());
 }
+async function writeArchiveFileAtomically(archivePath, content) {
+  await writeFileAtomically(archivePath, content);
+}
 async function listFilesRecursive(root, relPrefix = "") {
   const out = [];
   let entries;
@@ -80,6 +87,7 @@ async function archiveObservations(options) {
   );
   const stamp = now.toISOString().replace(/[-:]/g, "").replace(/\.\d{3}Z$/, "Z");
   const archiveRoot = path.join(options.memoryDir, "archive", "observations", stamp);
+  const archiveFileWriter = options.archiveFileWriter ?? writeArchiveFileAtomically;
   const candidates = retentionDays === 0 ? [] : await collectArchiveCandidates(
     options.memoryDir,
     cutoffDayStartUtc
@@ -96,7 +104,11 @@ async function archiveObservations(options) {
       const candidateInfo = await lstat(candidate.absolutePath).catch(() => null);
       if (!candidateInfo?.isFile() || candidateInfo.isSymbolicLink()) continue;
       const raw = await readFile(candidate.absolutePath);
-      await writeFile(archivePath, raw);
+      await archiveFileWriter(archivePath, raw);
+      const archivedRaw = await readFile(archivePath);
+      if (!archivedRaw.equals(raw)) {
+        throw new Error(`Archive copy verification failed for ${candidate.relativePath}`);
+      }
       await unlink(candidate.absolutePath);
       archivedFiles += 1;
       archivedBytes += raw.byteLength;
@@ -119,4 +131,4 @@ async function archiveObservations(options) {
 export {
   archiveObservations
 };
-//# sourceMappingURL=chunk-S7WU3Y3D.js.map
+//# sourceMappingURL=chunk-WMWVO45V.js.map

package/dist/chunk-WMWVO45V.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/maintenance/archive-observations.ts"],"sourcesContent":["import path from \"node:path\";\nimport { lstat, mkdir, readdir, readFile, realpath, unlink } from \"node:fs/promises\";\nimport { writeFileAtomically } from \"./atomic-file.js\";\n\nconst DATE_FILE_PATTERN = /^(\\d{4})-(\\d{2})-(\\d{2})\\.(jsonl|md)$/;\n\ntype ArchiveFileWriter = (archivePath: string, content: Uint8Array) => Promise<void>;\n\nexport interface ArchiveObservationsOptions {\n  memoryDir: string;\n  retentionDays?: number;\n  dryRun?: boolean;\n  now?: Date;\n  archiveFileWriter?: ArchiveFileWriter;\n}\n\nexport interface ArchiveObservationsResult {\n  dryRun: boolean;\n  retentionDays: number;\n  scannedFiles: number;\n  archivedFiles: number;\n  archivedBytes: number;\n  archiveRoot: string;\n  archivedRelativePaths: string[];\n}\n\ninterface CandidateFile {\n  absolutePath: string;\n  relativePath: string;\n}\n\nfunction normalizeRetentionDays(value: number | undefined): number {\n  if (!Number.isFinite(value as number)) return 30;\n  return Math.max(0, Math.floor(value as number));\n}\n\nfunction extractDateFromFilename(name: string): Date | null {\n  const match = DATE_FILE_PATTERN.exec(name);\n  if (!match) return null;\n  const iso = `${match[1]}-${match[2]}-${match[3]}T00:00:00.000Z`;\n  const parsed = new Date(iso);\n  if (Number.isNaN(parsed.getTime())) return null;\n  return parsed;\n}\n\nfunction startOfUtcDay(value: Date): number {\n  return Date.UTC(value.getUTCFullYear(), value.getUTCMonth(), value.getUTCDate());\n}\n\nasync function writeArchiveFileAtomically(archivePath: string, content: Uint8Array): Promise<void> {\n  await writeFileAtomically(archivePath, content);\n}\n\nasync function listFilesRecursive(root: string, relPrefix = \"\"): Promise<string[]> {\n  const out: string[] = [];\n  let entries: Array<{ name: string; isDirectory(): boolean; isFile(): boolean }>;\n  try {\n    entries = (await readdir(root, { withFileTypes: true })) as Array<{\n      name: string;\n      isDirectory(): boolean;\n      isFile(): boolean;\n    }>;\n  } catch {\n    return out;\n  }\n\n  for (const entry of entries) {\n    const rel = relPrefix ? path.join(relPrefix, entry.name) : entry.name;\n    const full = path.join(root, entry.name);\n    if (entry.isDirectory()) {\n      out.push(...(await listFilesRecursive(full, rel)));\n      continue;\n    }\n    if (entry.isFile()) out.push(rel);\n  }\n\n  return out;\n}\n\nasync function collectArchiveCandidates(\n  memoryDir: string,\n  cutoffTimeMs: number,\n): Promise<CandidateFile[]> {\n  const roots = [\"transcripts\", path.join(\"state\", \"tool-usage\"), path.join(\"summaries\", \"hourly\")];\n  const out: CandidateFile[] = [];\n  const memoryRoot = path.resolve(memoryDir);\n  const memoryRealRoot = await realpath(memoryRoot).catch(() => memoryRoot);\n\n  for (const relRoot of roots) {\n    const absRoot = path.resolve(memoryRoot, relRoot);\n    const rootInfo = await lstat(absRoot).catch(() => null);\n    if (!rootInfo?.isDirectory() || rootInfo.isSymbolicLink()) continue;\n    const absRootReal = await realpath(absRoot).catch(() => null);\n    if (absRootReal === null) continue;\n    const rootRelative = path.relative(memoryRealRoot, absRootReal);\n    if (rootRelative === \"..\" || rootRelative.startsWith(`..${path.sep}`) || path.isAbsolute(rootRelative)) {\n      continue;\n    }\n    const files = await listFilesRecursive(absRoot);\n    for (const fileRel of files) {\n      const filename = path.basename(fileRel);\n      const parsedDate = extractDateFromFilename(filename);\n      if (!parsedDate) continue;\n      if (parsedDate.getTime() >= cutoffTimeMs) continue;\n      const absolutePath = path.resolve(absRoot, fileRel);\n      const relativeToMemory = path.relative(memoryRoot, absolutePath);\n      if (\n        relativeToMemory === \"..\" ||\n        relativeToMemory.startsWith(`..${path.sep}`) ||\n        path.isAbsolute(relativeToMemory)\n      ) {\n        continue;\n      }\n      out.push({\n        absolutePath,\n        relativePath: path.join(relRoot, fileRel),\n      });\n    }\n  }\n\n  out.sort((a, b) => a.relativePath.localeCompare(b.relativePath));\n  return out;\n}\n\nexport async function archiveObservations(\n  options: ArchiveObservationsOptions,\n): Promise<ArchiveObservationsResult> {\n  const retentionDays = normalizeRetentionDays(options.retentionDays);\n  const dryRun = options.dryRun !== false;\n  const now = options.now ?? new Date();\n  const cutoffDayStartUtc = startOfUtcDay(\n    new Date(now.getTime() - retentionDays * 24 * 60 * 60 * 1000),\n  );\n  const stamp = now.toISOString().replace(/[-:]/g, \"\").replace(/\\.\\d{3}Z$/, \"Z\");\n  const archiveRoot = path.join(options.memoryDir, \"archive\", \"observations\", stamp);\n  const archiveFileWriter = options.archiveFileWriter ?? writeArchiveFileAtomically;\n  const candidates =\n    retentionDays === 0\n      ? []\n      : await collectArchiveCandidates(\n        options.memoryDir,\n        cutoffDayStartUtc,\n      );\n\n  let archivedFiles = 0;\n  let archivedBytes = 0;\n  const archivedRelativePaths: string[] = [];\n\n  if (!dryRun && candidates.length > 0) {\n    await mkdir(archiveRoot, { recursive: true });\n    for (const candidate of candidates) {\n      const archivePath = path.join(archiveRoot, candidate.relativePath);\n      const archiveDir = path.dirname(archivePath);\n      await mkdir(archiveDir, { recursive: true });\n      const candidateInfo = await lstat(candidate.absolutePath).catch(() => null);\n      if (!candidateInfo?.isFile() || candidateInfo.isSymbolicLink()) continue;\n      const raw = await readFile(candidate.absolutePath);\n      await archiveFileWriter(archivePath, raw);\n      const archivedRaw = await readFile(archivePath);\n      if (!archivedRaw.equals(raw)) {\n        throw new Error(`Archive copy verification failed for ${candidate.relativePath}`);\n      }\n      await unlink(candidate.absolutePath);\n      archivedFiles += 1;\n      archivedBytes += raw.byteLength;\n      archivedRelativePaths.push(candidate.relativePath);\n    }\n  } else {\n    archivedRelativePaths.push(...candidates.map((c) => c.relativePath));\n  }\n\n  return {\n    dryRun,\n    retentionDays,\n    scannedFiles: candidates.length,\n    archivedFiles,\n    archivedBytes,\n    archiveRoot,\n    archivedRelativePaths,\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/cli.js

@@ -89,7 +89,7 @@ import {
   runWorkProductStatusCliCommand,
   runWorkProjectCliCommand,
   runWorkTaskCliCommand
-} from "./chunk-GEL3F3RV.js";
+} from "./chunk-I2K6KCVC.js";
 import "./chunk-7F7Z6MOS.js";
 import "./chunk-MC4FJXPA.js";
 import "./chunk-LQHDIS7L.js";
@@ -107,12 +107,12 @@ import "./chunk-765K3SAT.js";
 import "./chunk-TKWGAOLV.js";
 import "./chunk-UWY7GIVS.js";
 import "./chunk-HOJZMQ4J.js";
-import "./chunk-2NM43EWN.js";
-import "./chunk-M3BAMVAE.js";
-import "./chunk-Y4YATXHL.js";
-import "./chunk-XR6DNK4U.js";
-import "./chunk-RUZOJKNF.js";
-import "./chunk-S7WU3Y3D.js";
+import "./chunk-D6RIFG4O.js";
+import "./chunk-O4M4WH6V.js";
+import "./chunk-ILJXM3FV.js";
+import "./chunk-LZZNTPLR.js";
+import "./chunk-JCK7V6SN.js";
+import "./chunk-WMWVO45V.js";
 import "./chunk-KJTKLXTH.js";
 import "./chunk-H2NCNXMS.js";
 import "./chunk-PU44GBL4.js";
@@ -141,7 +141,7 @@ import "./chunk-FADZBOR4.js";
 import "./chunk-XPXEJRUB.js";
 import "./chunk-A6D7A2FW.js";
 import "./chunk-FF4KLI5W.js";
-import "./chunk-4426WSWL.js";
+import "./chunk-SFQ6QNL7.js";
 import "./chunk-A2Z6UCWT.js";
 import "./chunk-KXULCVOC.js";
 import "./chunk-SML26KED.js";

package/dist/index.js

@@ -93,7 +93,7 @@ import {
   listTrainingExportAdapters,
   registerTrainingExportAdapter,
   runBulkImportCliCommand
-} from "./chunk-GEL3F3RV.js";
+} from "./chunk-I2K6KCVC.js";
 import "./chunk-7F7Z6MOS.js";
 import "./chunk-MC4FJXPA.js";
 import "./chunk-LQHDIS7L.js";
@@ -111,12 +111,12 @@ import "./chunk-765K3SAT.js";
 import "./chunk-TKWGAOLV.js";
 import "./chunk-UWY7GIVS.js";
 import "./chunk-HOJZMQ4J.js";
-import "./chunk-2NM43EWN.js";
-import "./chunk-M3BAMVAE.js";
-import "./chunk-Y4YATXHL.js";
-import "./chunk-XR6DNK4U.js";
-import "./chunk-RUZOJKNF.js";
-import "./chunk-S7WU3Y3D.js";
+import "./chunk-D6RIFG4O.js";
+import "./chunk-O4M4WH6V.js";
+import "./chunk-ILJXM3FV.js";
+import "./chunk-LZZNTPLR.js";
+import "./chunk-JCK7V6SN.js";
+import "./chunk-WMWVO45V.js";
 import "./chunk-KJTKLXTH.js";
 import {
   clearBulkImportSources,
@@ -182,7 +182,7 @@ import {
   saveTaxonomy,
   validateSlug,
   validateTaxonomy
-} from "./chunk-NYV435HC.js";
+} from "./chunk-RLPIT4YI.js";
 import "./chunk-5RIRL3XL.js";
 import "./chunk-BFBF3XEF.js";
 import {
@@ -227,7 +227,7 @@ import "./chunk-USYGGIJZ.js";
 import "./chunk-V3RXWQIE.js";
 import "./chunk-5IZL4DCV.js";
 import "./chunk-X7XN6YU4.js";
-import "./chunk-XEKAG3FM.js";
+import "./chunk-452WDNFO.js";
 import "./chunk-TDKQGLJW.js";
 import {
   buildResponseGuidanceRecallSection,
@@ -235,7 +235,7 @@ import {
 } from "./chunk-OZKZ2TRP.js";
 import "./chunk-YDBIWGNI.js";
 import "./chunk-7DHTMOND.js";
-import "./chunk-MGVIEM2O.js";
+import "./chunk-2IT7WFYE.js";
 import "./chunk-YCN4BVDK.js";
 import {
   DEFAULT_REASONING_TRACE_BOOST,
@@ -360,7 +360,7 @@ import "./chunk-FADZBOR4.js";
 import "./chunk-XPXEJRUB.js";
 import "./chunk-A6D7A2FW.js";
 import "./chunk-FF4KLI5W.js";
-import "./chunk-4426WSWL.js";
+import "./chunk-SFQ6QNL7.js";
 import "./chunk-A2Z6UCWT.js";
 import "./chunk-KXULCVOC.js";
 import "./chunk-SML26KED.js";

package/dist/maintenance/archive-observations.d.ts

@@ -1,8 +1,10 @@
+type ArchiveFileWriter = (archivePath: string, content: Uint8Array) => Promise<void>;
 interface ArchiveObservationsOptions {
     memoryDir: string;
     retentionDays?: number;
     dryRun?: boolean;
     now?: Date;
+    archiveFileWriter?: ArchiveFileWriter;
 }
 interface ArchiveObservationsResult {
     dryRun: boolean;

package/dist/maintenance/archive-observations.js

@@ -1,6 +1,7 @@
 import {
   archiveObservations
-} from "../chunk-S7WU3Y3D.js";
+} from "../chunk-WMWVO45V.js";
+import "../chunk-SFQ6QNL7.js";
 import "../chunk-PZ5AY32C.js";
 export {
   archiveObservations

package/dist/maintenance/migrate-observations.js

@@ -1,8 +1,8 @@
 import {
   migrateObservations
-} from "../chunk-2NM43EWN.js";
-import "../chunk-RUZOJKNF.js";
-import "../chunk-4426WSWL.js";
+} from "../chunk-D6RIFG4O.js";
+import "../chunk-JCK7V6SN.js";
+import "../chunk-SFQ6QNL7.js";
 import "../chunk-PZ5AY32C.js";
 export {
   migrateObservations

package/dist/maintenance/observation-ledger-utils.d.ts

@@ -1,4 +1,4 @@
-declare function writeFileAtomically(outputPath: string, content: string, backupPath?: string): Promise<string | undefined>;
+declare function writeFileAtomically(outputPath: string, content: string | Uint8Array, backupPath?: string): Promise<string | undefined>;
 
 interface LedgerWriteOptions<T extends object> {
     memoryDir: string;

package/dist/maintenance/observation-ledger-utils.js

@@ -1,8 +1,8 @@
 import {
   backupAndWriteRebuiltObservations,
   toHourBucketIso
-} from "../chunk-RUZOJKNF.js";
-import "../chunk-4426WSWL.js";
+} from "../chunk-JCK7V6SN.js";
+import "../chunk-SFQ6QNL7.js";
 import "../chunk-PZ5AY32C.js";
 export {
   backupAndWriteRebuiltObservations,

package/dist/maintenance/rebuild-memory-lifecycle-ledger.js

@@ -1,9 +1,9 @@
 import {
   backupExistingLedger,
   rebuildMemoryLifecycleLedger
-} from "../chunk-M3BAMVAE.js";
+} from "../chunk-O4M4WH6V.js";
 import "../chunk-KJTKLXTH.js";
-import "../chunk-4426WSWL.js";
+import "../chunk-SFQ6QNL7.js";
 import "../chunk-TVZ6LKKS.js";
 import "../chunk-5UZXUTVO.js";
 import "../chunk-4H5ZJHEN.js";

package/dist/maintenance/rebuild-memory-projection.js

@@ -3,9 +3,9 @@ import {
   rebuildMemoryProjection,
   repairMemoryProjection,
   verifyMemoryProjection
-} from "../chunk-Y4YATXHL.js";
+} from "../chunk-ILJXM3FV.js";
 import "../chunk-KJTKLXTH.js";
-import "../chunk-4426WSWL.js";
+import "../chunk-SFQ6QNL7.js";
 import "../chunk-BEUDU7Y4.js";
 import "../chunk-E5OECWZ5.js";
 import "../chunk-TVZ6LKKS.js";

package/dist/maintenance/rebuild-observations.js

@@ -1,8 +1,8 @@
 import {
   rebuildObservations
-} from "../chunk-XR6DNK4U.js";
-import "../chunk-RUZOJKNF.js";
-import "../chunk-4426WSWL.js";
+} from "../chunk-LZZNTPLR.js";
+import "../chunk-JCK7V6SN.js";
+import "../chunk-SFQ6QNL7.js";
 import "../chunk-PZ5AY32C.js";
 export {
   rebuildObservations

package/dist/orchestrator.js

@@ -26,7 +26,7 @@ import {
   sanitizeSessionKeyForFilename,
   shouldFilterLifecycleRecallCandidate,
   summarizeGraphShadowComparison
-} from "./chunk-NYV435HC.js";
+} from "./chunk-RLPIT4YI.js";
 import "./chunk-5RIRL3XL.js";
 import "./chunk-BFBF3XEF.js";
 import "./chunk-KVEVLBKC.js";
@@ -58,12 +58,12 @@ import "./chunk-USYGGIJZ.js";
 import "./chunk-V3RXWQIE.js";
 import "./chunk-5IZL4DCV.js";
 import "./chunk-X7XN6YU4.js";
-import "./chunk-XEKAG3FM.js";
+import "./chunk-452WDNFO.js";
 import "./chunk-TDKQGLJW.js";
 import "./chunk-OZKZ2TRP.js";
 import "./chunk-YDBIWGNI.js";
 import "./chunk-7DHTMOND.js";
-import "./chunk-MGVIEM2O.js";
+import "./chunk-2IT7WFYE.js";
 import "./chunk-YCN4BVDK.js";
 import "./chunk-ZZTOURJI.js";
 import "./chunk-XKXKSQU7.js";
@@ -107,7 +107,7 @@ import "./chunk-FADZBOR4.js";
 import "./chunk-XPXEJRUB.js";
 import "./chunk-A6D7A2FW.js";
 import "./chunk-FF4KLI5W.js";
-import "./chunk-4426WSWL.js";
+import "./chunk-SFQ6QNL7.js";
 import "./chunk-A2Z6UCWT.js";
 import "./chunk-KXULCVOC.js";
 import "./chunk-SML26KED.js";

package/dist/recall-state.js

@@ -2,8 +2,8 @@ import {
   LastRecallStore,
   TierMigrationStatusStore,
   clampGraphRecallExpandedEntries
-} from "./chunk-MGVIEM2O.js";
-import "./chunk-4426WSWL.js";
+} from "./chunk-2IT7WFYE.js";
+import "./chunk-SFQ6QNL7.js";
 import "./chunk-2ODBA7MQ.js";
 import "./chunk-PZ5AY32C.js";
 export {

package/dist/relevance.js

@@ -1,7 +1,7 @@
 import {
   RelevanceStore
-} from "./chunk-XEKAG3FM.js";
-import "./chunk-4426WSWL.js";
+} from "./chunk-452WDNFO.js";
+import "./chunk-SFQ6QNL7.js";
 import "./chunk-2ODBA7MQ.js";
 import "./chunk-PZ5AY32C.js";
 export {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@remnic/core",
-  "version": "9.3.553",
+  "version": "9.3.555",
   "description": "Framework-agnostic Remnic memory engine — orchestrator, storage, extraction, search, trust zones",
   "type": "module",
   "main": "dist/index.js",

package/src/maintenance/archive-observations.ts

@@ -1,13 +1,17 @@
 import path from "node:path";
-import { lstat, mkdir, readdir, readFile, realpath, unlink, writeFile } from "node:fs/promises";
+import { lstat, mkdir, readdir, readFile, realpath, unlink } from "node:fs/promises";
+import { writeFileAtomically } from "./atomic-file.js";
 
 const DATE_FILE_PATTERN = /^(\d{4})-(\d{2})-(\d{2})\.(jsonl|md)$/;
 
+type ArchiveFileWriter = (archivePath: string, content: Uint8Array) => Promise<void>;
+
 export interface ArchiveObservationsOptions {
   memoryDir: string;
   retentionDays?: number;
   dryRun?: boolean;
   now?: Date;
+  archiveFileWriter?: ArchiveFileWriter;
 }
 
 export interface ArchiveObservationsResult {
@@ -43,6 +47,10 @@ function startOfUtcDay(value: Date): number {
   return Date.UTC(value.getUTCFullYear(), value.getUTCMonth(), value.getUTCDate());
 }
 
+async function writeArchiveFileAtomically(archivePath: string, content: Uint8Array): Promise<void> {
+  await writeFileAtomically(archivePath, content);
+}
+
 async function listFilesRecursive(root: string, relPrefix = ""): Promise<string[]> {
   const out: string[] = [];
   let entries: Array<{ name: string; isDirectory(): boolean; isFile(): boolean }>;
@@ -125,6 +133,7 @@ export async function archiveObservations(
   );
   const stamp = now.toISOString().replace(/[-:]/g, "").replace(/\.\d{3}Z$/, "Z");
   const archiveRoot = path.join(options.memoryDir, "archive", "observations", stamp);
+  const archiveFileWriter = options.archiveFileWriter ?? writeArchiveFileAtomically;
   const candidates =
     retentionDays === 0
       ? []
@@ -146,7 +155,11 @@ export async function archiveObservations(
       const candidateInfo = await lstat(candidate.absolutePath).catch(() => null);
       if (!candidateInfo?.isFile() || candidateInfo.isSymbolicLink()) continue;
       const raw = await readFile(candidate.absolutePath);
-      await writeFile(archivePath, raw);
+      await archiveFileWriter(archivePath, raw);
+      const archivedRaw = await readFile(archivePath);
+      if (!archivedRaw.equals(raw)) {
+        throw new Error(`Archive copy verification failed for ${candidate.relativePath}`);
+      }
       await unlink(candidate.absolutePath);
       archivedFiles += 1;
       archivedBytes += raw.byteLength;

package/src/maintenance/atomic-file.ts

@@ -36,7 +36,7 @@ export async function copyExistingFileToBackup(
 
 export async function writeFileAtomically(
   outputPath: string,
-  content: string,
+  content: string | Uint8Array,
   backupPath?: string,
 ): Promise<string | undefined> {
   const dir = path.dirname(outputPath);
@@ -46,7 +46,11 @@ export async function writeFileAtomically(
   let resolvedBackupPath: string | undefined;
   try {
     handle = await open(tempPath, "w");
-    await handle.writeFile(content, "utf-8");
+    if (typeof content === "string") {
+      await handle.writeFile(content, "utf-8");
+    } else {
+      await handle.writeFile(content);
+    }
     await handle.sync();
     await handle.close();
     handle = undefined;

package/dist/chunk-4426WSWL.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/maintenance/atomic-file.ts"],"sourcesContent":["import path from \"node:path\";\nimport { copyFile, mkdir, open, rename, rm, stat } from \"node:fs/promises\";\n\nasync function syncDirectory(dir: string): Promise<void> {\n  let handle: Awaited<ReturnType<typeof open>> | undefined;\n  try {\n    handle = await open(dir, \"r\");\n    await handle.sync();\n  } catch {\n    // Directory fsync is best-effort across platforms and filesystems.\n  } finally {\n    await handle?.close().catch(() => undefined);\n  }\n}\n\nfunction tempPathFor(outputPath: string): string {\n  const suffix = `${process.pid}.${Date.now()}.${Math.random().toString(36).slice(2)}`;\n  return path.join(path.dirname(outputPath), `.${path.basename(outputPath)}.${suffix}.tmp`);\n}\n\nexport async function copyExistingFileToBackup(\n  sourcePath: string,\n  backupPath: string,\n): Promise<string | undefined> {\n  try {\n    await stat(sourcePath);\n  } catch (err) {\n    if ((err as NodeJS.ErrnoException).code === \"ENOENT\") return undefined;\n    throw err;\n  }\n\n  await mkdir(path.dirname(backupPath), { recursive: true });\n  await copyFile(sourcePath, backupPath);\n  return backupPath;\n}\n\nexport async function writeFileAtomically(\n  outputPath: string,\n  content: string,\n  backupPath?: string,\n): Promise<string | undefined> {\n  const dir = path.dirname(outputPath);\n  await mkdir(dir, { recursive: true });\n  const tempPath = tempPathFor(outputPath);\n  let handle: Awaited<ReturnType<typeof open>> | undefined;\n  let resolvedBackupPath: string | undefined;\n  try {\n    handle = await open(tempPath, \"w\");\n    await handle.writeFile(content, \"utf-8\");\n    await handle.sync();\n    await handle.close();\n    handle = undefined;\n\n    if (backupPath) {\n      resolvedBackupPath = await copyExistingFileToBackup(outputPath, backupPath);\n    }\n    await rename(tempPath, outputPath);\n    await syncDirectory(dir);\n    return resolvedBackupPath;\n  } catch (err) {\n    await handle?.close().catch(() => undefined);\n    await rm(tempPath, { force: true }).catch(() => undefined);\n    throw err;\n  }\n}\n\nexport async function commitPreparedFileAtomically(\n  tempPath: string,\n  outputPath: string,\n  backupPath?: string,\n): Promise<string | undefined> {\n  const dir = path.dirname(outputPath);\n  let resolvedBackupPath: string | undefined;\n  try {\n    if (backupPath) {\n      resolvedBackupPath = await copyExistingFileToBackup(outputPath, backupPath);\n    }\n    await rename(tempPath, outputPath);\n    await syncDirectory(dir);\n    return resolvedBackupPath;\n  } catch (err) {\n    await rm(tempPath, { force: true }).catch(() => undefined);\n    throw err;\n  }\n}\n"],"mappings":";AAAA,OAAO,UAAU;AACjB,SAAS,UAAU,OAAO,MAAM,QAAQ,IAAI,YAAY;AAExD,eAAe,cAAc,KAA4B;AACvD,MAAI;AACJ,MAAI;AACF,aAAS,MAAM,KAAK,KAAK,GAAG;AAC5B,UAAM,OAAO,KAAK;AAAA,EACpB,QAAQ;AAAA,EAER,UAAE;AACA,UAAM,QAAQ,MAAM,EAAE,MAAM,MAAM,MAAS;AAAA,EAC7C;AACF;AAEA,SAAS,YAAY,YAA4B;AAC/C,QAAM,SAAS,GAAG,QAAQ,GAAG,IAAI,KAAK,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,SAAS,EAAE,EAAE,MAAM,CAAC,CAAC;AAClF,SAAO,KAAK,KAAK,KAAK,QAAQ,UAAU,GAAG,IAAI,KAAK,SAAS,UAAU,CAAC,IAAI,MAAM,MAAM;AAC1F;AAEA,eAAsB,yBACpB,YACA,YAC6B;AAC7B,MAAI;AACF,UAAM,KAAK,UAAU;AAAA,EACvB,SAAS,KAAK;AACZ,QAAK,IAA8B,SAAS,SAAU,QAAO;AAC7D,UAAM;AAAA,EACR;AAEA,QAAM,MAAM,KAAK,QAAQ,UAAU,GAAG,EAAE,WAAW,KAAK,CAAC;AACzD,QAAM,SAAS,YAAY,UAAU;AACrC,SAAO;AACT;AAEA,eAAsB,oBACpB,YACA,SACA,YAC6B;AAC7B,QAAM,MAAM,KAAK,QAAQ,UAAU;AACnC,QAAM,MAAM,KAAK,EAAE,WAAW,KAAK,CAAC;AACpC,QAAM,WAAW,YAAY,UAAU;AACvC,MAAI;AACJ,MAAI;AACJ,MAAI;AACF,aAAS,MAAM,KAAK,UAAU,GAAG;AACjC,UAAM,OAAO,UAAU,SAAS,OAAO;AACvC,UAAM,OAAO,KAAK;AAClB,UAAM,OAAO,MAAM;AACnB,aAAS;AAET,QAAI,YAAY;AACd,2BAAqB,MAAM,yBAAyB,YAAY,UAAU;AAAA,IAC5E;AACA,UAAM,OAAO,UAAU,UAAU;AACjC,UAAM,cAAc,GAAG;AACvB,WAAO;AAAA,EACT,SAAS,KAAK;AACZ,UAAM,QAAQ,MAAM,EAAE,MAAM,MAAM,MAAS;AAC3C,UAAM,GAAG,UAAU,EAAE,OAAO,KAAK,CAAC,EAAE,MAAM,MAAM,MAAS;AACzD,UAAM;AAAA,EACR;AACF;AAEA,eAAsB,6BACpB,UACA,YACA,YAC6B;AAC7B,QAAM,MAAM,KAAK,QAAQ,UAAU;AACnC,MAAI;AACJ,MAAI;AACF,QAAI,YAAY;AACd,2BAAqB,MAAM,yBAAyB,YAAY,UAAU;AAAA,IAC5E;AACA,UAAM,OAAO,UAAU,UAAU;AACjC,UAAM,cAAc,GAAG;AACvB,WAAO;AAAA,EACT,SAAS,KAAK;AACZ,UAAM,GAAG,UAAU,EAAE,OAAO,KAAK,CAAC,EAAE,MAAM,MAAM,MAAS;AACzD,UAAM;AAAA,EACR;AACF;","names":[]}

package/dist/chunk-S7WU3Y3D.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/maintenance/archive-observations.ts"],"sourcesContent":["import path from \"node:path\";\nimport { lstat, mkdir, readdir, readFile, realpath, unlink, writeFile } from \"node:fs/promises\";\n\nconst DATE_FILE_PATTERN = /^(\\d{4})-(\\d{2})-(\\d{2})\\.(jsonl|md)$/;\n\nexport interface ArchiveObservationsOptions {\n  memoryDir: string;\n  retentionDays?: number;\n  dryRun?: boolean;\n  now?: Date;\n}\n\nexport interface ArchiveObservationsResult {\n  dryRun: boolean;\n  retentionDays: number;\n  scannedFiles: number;\n  archivedFiles: number;\n  archivedBytes: number;\n  archiveRoot: string;\n  archivedRelativePaths: string[];\n}\n\ninterface CandidateFile {\n  absolutePath: string;\n  relativePath: string;\n}\n\nfunction normalizeRetentionDays(value: number | undefined): number {\n  if (!Number.isFinite(value as number)) return 30;\n  return Math.max(0, Math.floor(value as number));\n}\n\nfunction extractDateFromFilename(name: string): Date | null {\n  const match = DATE_FILE_PATTERN.exec(name);\n  if (!match) return null;\n  const iso = `${match[1]}-${match[2]}-${match[3]}T00:00:00.000Z`;\n  const parsed = new Date(iso);\n  if (Number.isNaN(parsed.getTime())) return null;\n  return parsed;\n}\n\nfunction startOfUtcDay(value: Date): number {\n  return Date.UTC(value.getUTCFullYear(), value.getUTCMonth(), value.getUTCDate());\n}\n\nasync function listFilesRecursive(root: string, relPrefix = \"\"): Promise<string[]> {\n  const out: string[] = [];\n  let entries: Array<{ name: string; isDirectory(): boolean; isFile(): boolean }>;\n  try {\n    entries = (await readdir(root, { withFileTypes: true })) as Array<{\n      name: string;\n      isDirectory(): boolean;\n      isFile(): boolean;\n    }>;\n  } catch {\n    return out;\n  }\n\n  for (const entry of entries) {\n    const rel = relPrefix ? path.join(relPrefix, entry.name) : entry.name;\n    const full = path.join(root, entry.name);\n    if (entry.isDirectory()) {\n      out.push(...(await listFilesRecursive(full, rel)));\n      continue;\n    }\n    if (entry.isFile()) out.push(rel);\n  }\n\n  return out;\n}\n\nasync function collectArchiveCandidates(\n  memoryDir: string,\n  cutoffTimeMs: number,\n): Promise<CandidateFile[]> {\n  const roots = [\"transcripts\", path.join(\"state\", \"tool-usage\"), path.join(\"summaries\", \"hourly\")];\n  const out: CandidateFile[] = [];\n  const memoryRoot = path.resolve(memoryDir);\n  const memoryRealRoot = await realpath(memoryRoot).catch(() => memoryRoot);\n\n  for (const relRoot of roots) {\n    const absRoot = path.resolve(memoryRoot, relRoot);\n    const rootInfo = await lstat(absRoot).catch(() => null);\n    if (!rootInfo?.isDirectory() || rootInfo.isSymbolicLink()) continue;\n    const absRootReal = await realpath(absRoot).catch(() => null);\n    if (absRootReal === null) continue;\n    const rootRelative = path.relative(memoryRealRoot, absRootReal);\n    if (rootRelative === \"..\" || rootRelative.startsWith(`..${path.sep}`) || path.isAbsolute(rootRelative)) {\n      continue;\n    }\n    const files = await listFilesRecursive(absRoot);\n    for (const fileRel of files) {\n      const filename = path.basename(fileRel);\n      const parsedDate = extractDateFromFilename(filename);\n      if (!parsedDate) continue;\n      if (parsedDate.getTime() >= cutoffTimeMs) continue;\n      const absolutePath = path.resolve(absRoot, fileRel);\n      const relativeToMemory = path.relative(memoryRoot, absolutePath);\n      if (\n        relativeToMemory === \"..\" ||\n        relativeToMemory.startsWith(`..${path.sep}`) ||\n        path.isAbsolute(relativeToMemory)\n      ) {\n        continue;\n      }\n      out.push({\n        absolutePath,\n        relativePath: path.join(relRoot, fileRel),\n      });\n    }\n  }\n\n  out.sort((a, b) => a.relativePath.localeCompare(b.relativePath));\n  return out;\n}\n\nexport async function archiveObservations(\n  options: ArchiveObservationsOptions,\n): Promise<ArchiveObservationsResult> {\n  const retentionDays = normalizeRetentionDays(options.retentionDays);\n  const dryRun = options.dryRun !== false;\n  const now = options.now ?? new Date();\n  const cutoffDayStartUtc = startOfUtcDay(\n    new Date(now.getTime() - retentionDays * 24 * 60 * 60 * 1000),\n  );\n  const stamp = now.toISOString().replace(/[-:]/g, \"\").replace(/\\.\\d{3}Z$/, \"Z\");\n  const archiveRoot = path.join(options.memoryDir, \"archive\", \"observations\", stamp);\n  const candidates =\n    retentionDays === 0\n      ? []\n      : await collectArchiveCandidates(\n        options.memoryDir,\n        cutoffDayStartUtc,\n      );\n\n  let archivedFiles = 0;\n  let archivedBytes = 0;\n  const archivedRelativePaths: string[] = [];\n\n  if (!dryRun && candidates.length > 0) {\n    await mkdir(archiveRoot, { recursive: true });\n    for (const candidate of candidates) {\n      const archivePath = path.join(archiveRoot, candidate.relativePath);\n      const archiveDir = path.dirname(archivePath);\n      await mkdir(archiveDir, { recursive: true });\n      const candidateInfo = await lstat(candidate.absolutePath).catch(() => null);\n      if (!candidateInfo?.isFile() || candidateInfo.isSymbolicLink()) continue;\n      const raw = await readFile(candidate.absolutePath);\n      await writeFile(archivePath, raw);\n      await unlink(candidate.absolutePath);\n      archivedFiles += 1;\n      archivedBytes += raw.byteLength;\n      archivedRelativePaths.push(candidate.relativePath);\n    }\n  } else {\n    archivedRelativePaths.push(...candidates.map((c) => c.relativePath));\n  }\n\n  return {\n    dryRun,\n    retentionDays,\n    scannedFiles: candidates.length,\n    archivedFiles,\n    archivedBytes,\n    archiveRoot,\n    archivedRelativePaths,\n  };\n}\n"],"mappings":"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","names":[]}