@remnic/core 9.3.761 → 9.3.763

package/dist/chunk-DQC3ZZYM.js

@@ -0,0 +1,35 @@
+import {
+  log
+} from "./chunk-NU3CSQ4H.js";
+
+// src/storage-guards.ts
+var PROJECTION_FALLBACK_WARN_INTERVAL_MS = 5 * 6e4;
+var projectionFallbackWarnedAt = /* @__PURE__ */ new Map();
+function assertMemoryFrontmatterId(fm) {
+  if (typeof fm.id !== "string" || fm.id.trim().length === 0) {
+    const context = [
+      fm.category ? `category=${fm.category}` : null,
+      fm.created ? `created=${fm.created}` : null,
+      fm.entityRef ? `entityRef=${fm.entityRef}` : null
+    ].filter(Boolean).join(" ");
+    throw new Error(
+      `memory frontmatter id must not be blank${context ? ` (${context})` : ""}`
+    );
+  }
+}
+function warnProjectionFallback(memoryDir, consumer) {
+  const key = `${memoryDir}\0${consumer}`;
+  const now = Date.now();
+  const warnedAt = projectionFallbackWarnedAt.get(key) ?? 0;
+  if (now - warnedAt >= PROJECTION_FALLBACK_WARN_INTERVAL_MS) {
+    projectionFallbackWarnedAt.set(key, now);
+    log.warn(`storage.${consumer}: memory projection absent or empty; falling back to full corpus`);
+  }
+  return null;
+}
+
+export {
+  assertMemoryFrontmatterId,
+  warnProjectionFallback
+};
+//# sourceMappingURL=chunk-DQC3ZZYM.js.map

package/dist/chunk-DQC3ZZYM.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/storage-guards.ts"],"sourcesContent":["import { log } from \"./logger.js\";\n\nconst PROJECTION_FALLBACK_WARN_INTERVAL_MS = 5 * 60_000;\nconst projectionFallbackWarnedAt = new Map<string, number>();\n\nexport function assertMemoryFrontmatterId(\n  fm: { id: string; category?: string; created?: string; entityRef?: string },\n): void {\n  if (typeof fm.id !== \"string\" || fm.id.trim().length === 0) {\n    const context = [\n      fm.category ? `category=${fm.category}` : null,\n      fm.created ? `created=${fm.created}` : null,\n      fm.entityRef ? `entityRef=${fm.entityRef}` : null,\n    ].filter(Boolean).join(\" \");\n    throw new Error(\n      `memory frontmatter id must not be blank${context ? ` (${context})` : \"\"}`,\n    );\n  }\n}\n\nexport function warnProjectionFallback(memoryDir: string, consumer: string): null {\n  const key = `${memoryDir}\\0${consumer}`;\n  const now = Date.now();\n  const warnedAt = projectionFallbackWarnedAt.get(key) ?? 0;\n  if (now - warnedAt >= PROJECTION_FALLBACK_WARN_INTERVAL_MS) {\n    projectionFallbackWarnedAt.set(key, now);\n    log.warn(`storage.${consumer}: memory projection absent or empty; falling back to full corpus`);\n  }\n  return null;\n}\n"],"mappings":";;;;;AAEA,IAAM,uCAAuC,IAAI;AACjD,IAAM,6BAA6B,oBAAI,IAAoB;AAEpD,SAAS,0BACd,IACM;AACN,MAAI,OAAO,GAAG,OAAO,YAAY,GAAG,GAAG,KAAK,EAAE,WAAW,GAAG;AAC1D,UAAM,UAAU;AAAA,MACd,GAAG,WAAW,YAAY,GAAG,QAAQ,KAAK;AAAA,MAC1C,GAAG,UAAU,WAAW,GAAG,OAAO,KAAK;AAAA,MACvC,GAAG,YAAY,aAAa,GAAG,SAAS,KAAK;AAAA,IAC/C,EAAE,OAAO,OAAO,EAAE,KAAK,GAAG;AAC1B,UAAM,IAAI;AAAA,MACR,0CAA0C,UAAU,KAAK,OAAO,MAAM,EAAE;AAAA,IAC1E;AAAA,EACF;AACF;AAEO,SAAS,uBAAuB,WAAmB,UAAwB;AAChF,QAAM,MAAM,GAAG,SAAS,KAAK,QAAQ;AACrC,QAAM,MAAM,KAAK,IAAI;AACrB,QAAM,WAAW,2BAA2B,IAAI,GAAG,KAAK;AACxD,MAAI,MAAM,YAAY,sCAAsC;AAC1D,+BAA2B,IAAI,KAAK,GAAG;AACvC,QAAI,KAAK,WAAW,QAAQ,kEAAkE;AAAA,EAChG;AACA,SAAO;AACT;","names":[]}

package/dist/{chunk-3DAIQSVS.js → chunk-DTTVX6EO.js}

@@ -21,6 +21,10 @@ import {
   hasCitation,
   stripCitationForTemplate
 } from "./chunk-J6A3CX5N.js";
+import {
+  assertMemoryFrontmatterId,
+  warnProjectionFallback
+} from "./chunk-DQC3ZZYM.js";
 import {
   stripAttributesSuffix
 } from "./chunk-SVOZFLIQ.js";
@@ -44,11 +48,13 @@ import {
   normalizeProjectionTags
 } from "./chunk-SCU65EZI.js";
 import {
+  markProjectedMemoryPathInvalid,
   readProjectedGovernanceRecord,
   readProjectedMemoryBrowse,
   readProjectedMemoryState,
-  readProjectedMemoryTimeline
-} from "./chunk-MB5RSUW6.js";
+  readProjectedMemoryTimeline,
+  updateProjectedMemoryPath
+} from "./chunk-SXN3LCUT.js";
 import {
   rotateMarkdownFileToArchive
 } from "./chunk-DM2T26WE.js";
@@ -1389,6 +1395,7 @@ function stripCitationMarkersForHashRemoval(value, template) {
   return removed ? trimLeadingSpacesAndTabs(result) : value;
 }
 function serializeFrontmatter(fm) {
+  assertMemoryFrontmatterId(fm);
   const lines = [
     "---",
     `id: ${fm.id}`,
@@ -4617,6 +4624,7 @@ ${memory.content}
         }
       }
       this.invalidateAllMemoriesCache();
+      updateProjectedMemoryPath(this.baseDir, memory.frontmatter.id, toMemoryPathRel(this.baseDir, targetPath));
     }
   }
   async migrateMemoryToTier(memory, targetTier) {
@@ -4636,6 +4644,7 @@ ${memory.content}
           throw err;
         }
       }
+      updateProjectedMemoryPath(this.baseDir, memory.frontmatter.id, toMemoryPathRel(this.baseDir, targetPath));
       this.bumpMemoryStatusVersion();
       return { changed: false, targetPath };
     }
@@ -4674,6 +4683,7 @@ ${memory.content}
       const destPath = path4.join(destDir, path4.basename(memory.path));
       await this.writeStorageSecureFile(destPath, fileContent);
       await unlink2(memory.path);
+      markProjectedMemoryPathInvalid(this.baseDir, memory.frontmatter.id);
       this.invalidateAllMemoriesCache();
       await this.appendGeneratedMemoryLifecycleEventFailOpen(
         "storage.archiveMemory",
@@ -4755,6 +4765,7 @@ ${memory.content}
     if (!memory) return false;
     try {
       await unlink2(memory.path);
+      markProjectedMemoryPathInvalid(this.baseDir, id);
       this.invalidateAllMemoriesCache();
       this.bumpMemoryStatusVersion();
       log.debug(`invalidated memory ${id}`);
@@ -4878,6 +4889,7 @@ ${memory.content}
       if (expiresAt < now) {
         try {
           await unlink2(m.path);
+          markProjectedMemoryPathInvalid(this.baseDir, m.frontmatter.id);
           deleted.push(m);
           log.debug(`cleaned expired memory ${m.frontmatter.id} (TTL expired)`);
         } catch {
@@ -5693,6 +5705,7 @@ ${reflection}
       if (updatedAt < cutoff) {
         try {
           await unlink2(m.path);
+          markProjectedMemoryPathInvalid(this.baseDir, m.frontmatter.id);
           deleted.push(m);
           log.debug(`cleaned expired commitment ${m.frontmatter.id}`);
         } catch {
@@ -5724,11 +5737,11 @@ ${reflection}
         accessCount: entry.newCount,
         lastAccessed: entry.lastAccessed
       };
-      const fileContent = `${serializeFrontmatter(newFm)}
+      try {
+        const fileContent = `${serializeFrontmatter(newFm)}
 
 ${memory.content}
 `;
-      try {
         await this.writeStorageSecureFile(memory.path, fileContent);
         updated++;
       } catch (err) {
@@ -5773,6 +5786,7 @@ ${memory.content}
   async getProjectedMemoryState(id) {
     const projected = readProjectedMemoryState(this.baseDir, id);
     if (projected) return projected;
+    warnProjectionFallback(this.baseDir, "getProjectedMemoryState");
     const active = await this.getMemoryById(id);
     if (active) return this.toProjectedCurrentState(active, "active");
     const archived = (await this.readArchivedMemories()).find((memory) => memory.frontmatter.id === id);
@@ -5780,7 +5794,7 @@ ${memory.content}
     return this.toProjectedCurrentState(archived, "archived");
   }
   async browseProjectedMemories(options) {
-    return readProjectedMemoryBrowse(this.baseDir, options);
+    return readProjectedMemoryBrowse(this.baseDir, options) ?? warnProjectionFallback(this.baseDir, "browseProjectedMemories");
   }
   async getProjectedGovernanceRecord() {
     return readProjectedGovernanceRecord(this.baseDir);
@@ -5814,6 +5828,7 @@ ${memory.content}
     if (cappedLimit === 0) return [];
     const projected = readProjectedMemoryTimeline(this.baseDir, memoryId, cappedLimit);
     if (projected && projected.length > 0) return projected;
+    warnProjectionFallback(this.baseDir, "getMemoryTimeline");
     const events = await this.readAllMemoryLifecycleEvents();
     return events.filter((event) => event.memoryId === memoryId).slice(-cappedLimit);
   }
@@ -6000,11 +6015,11 @@ Reason: ${reason}`, {
         archivedAt: now,
         updated: now
       };
-      const fileContent = `${serializeFrontmatter(updatedFm)}
+      try {
+        const fileContent = `${serializeFrontmatter(updatedFm)}
 
 ${memory.content}
 `;
-      try {
         await this.writeStorageSecureFile(memory.path, fileContent);
         await this.appendGeneratedMemoryLifecycleEventFailOpen("storage.archiveMemories", {
           memoryId: id,
@@ -6139,4 +6154,4 @@ export {
   isValidBufferSurpriseEvent,
   StorageManager3 as StorageManager
 };
-//# sourceMappingURL=chunk-3DAIQSVS.js.map
+//# sourceMappingURL=chunk-DTTVX6EO.js.map