@remnic/core 9.3.755 → 9.3.757

package/dist/search/index.js

@@ -2,7 +2,10 @@ import {
   createConversationIndexRuntime,
   createConversationSearchBackend,
   createSearchBackend
-} from "../chunk-TJATYB3F.js";
+} from "../chunk-IZP62CEF.js";
+import {
+  OramaBackend
+} from "../chunk-LQ6JI4VH.js";
 import {
   RemoteSearchBackend
 } from "../chunk-SANZHXY2.js";
@@ -11,32 +14,29 @@ import {
 } from "../chunk-HM6UJPPO.js";
 import {
   LanceDbBackend
-} from "../chunk-TAPSNIMA.js";
+} from "../chunk-5CEJH5ZN.js";
 import {
   MeilisearchBackend
-} from "../chunk-YQGHW5ML.js";
-import {
-  NoopSearchBackend
-} from "../chunk-CYEPCZN5.js";
-import {
-  OramaBackend
-} from "../chunk-LD53WPMU.js";
-import "../chunk-CINZGPSJ.js";
+} from "../chunk-WRFKZEO6.js";
 import {
   scanMemoryDir
 } from "../chunk-AER6MT24.js";
-import "../chunk-T422SYM6.js";
-import "../chunk-SJHM6I4J.js";
+import "../chunk-CINZGPSJ.js";
+import {
+  NoopSearchBackend
+} from "../chunk-CYEPCZN5.js";
+import "../chunk-DCWIQFNA.js";
 import "../chunk-XBZQRZ6G.js";
 import "../chunk-KCQA46NR.js";
+import "../chunk-SJHM6I4J.js";
 import "../chunk-K43PI6DQ.js";
 import "../chunk-YNQ6DFSV.js";
 import "../chunk-O75CRYGF.js";
 import "../chunk-3ONXXHQO.js";
-import "../chunk-VSF7AAGE.js";
 import "../chunk-5GPPACXK.js";
 import "../chunk-AWJ2FHCF.js";
 import "../chunk-42JKGUFJ.js";
+import "../chunk-VSF7AAGE.js";
 import "../chunk-JUC24CTX.js";
 import "../chunk-NU3CSQ4H.js";
 import "../chunk-VS2IYZRU.js";

package/dist/search/lancedb-backend.js

@@ -1,8 +1,8 @@
 import {
   LanceDbBackend
-} from "../chunk-TAPSNIMA.js";
-import "../chunk-CINZGPSJ.js";
+} from "../chunk-5CEJH5ZN.js";
 import "../chunk-AER6MT24.js";
+import "../chunk-CINZGPSJ.js";
 import "../chunk-YNQ6DFSV.js";
 import "../chunk-5GPPACXK.js";
 import "../chunk-NU3CSQ4H.js";

package/dist/search/meilisearch-backend.js

@@ -1,8 +1,8 @@
 import {
   MeilisearchBackend
-} from "../chunk-YQGHW5ML.js";
-import "../chunk-CINZGPSJ.js";
+} from "../chunk-WRFKZEO6.js";
 import "../chunk-AER6MT24.js";
+import "../chunk-CINZGPSJ.js";
 import "../chunk-YNQ6DFSV.js";
 import "../chunk-5GPPACXK.js";
 import "../chunk-NU3CSQ4H.js";

package/dist/search/orama-backend.js

@@ -1,9 +1,9 @@
 import {
   OramaBackend,
   resolveOramaCollectionDbFilePath
-} from "../chunk-LD53WPMU.js";
-import "../chunk-CINZGPSJ.js";
+} from "../chunk-LQ6JI4VH.js";
 import "../chunk-AER6MT24.js";
+import "../chunk-CINZGPSJ.js";
 import "../chunk-YNQ6DFSV.js";
 import "../chunk-5GPPACXK.js";
 import "../chunk-NU3CSQ4H.js";

package/dist/semantic-consolidation.js

@@ -7,59 +7,59 @@ import {
   materializeAfterSemanticConsolidation,
   parseConsolidationResponse,
   parseOperatorAwareConsolidationResponse
-} from "./chunk-PJ7DIEFC.js";
-import "./chunk-LFKEFIJA.js";
+} from "./chunk-7HJ3XBMD.js";
+import "./chunk-I65IQD7Y.js";
 import "./chunk-UUH4YQOF.js";
 import {
   resolveExtensionsRoot
 } from "./chunk-JLNBQWZ2.js";
 import "./chunk-3UXOZBHV.js";
-import "./chunk-U3PN77QT.js";
-import "./chunk-VSF7AAGE.js";
-import "./chunk-ZBJMUXZH.js";
-import "./chunk-XBM5DG4O.js";
+import "./chunk-5PHPNUZN.js";
 import "./chunk-M7XQSUBB.js";
 import "./chunk-L2B3EE7B.js";
 import "./chunk-5UZXUTVO.js";
 import "./chunk-5GPPACXK.js";
 import "./chunk-TKZ3AL5V.js";
 import "./chunk-6CIAGZ6X.js";
+import "./chunk-J6A3CX5N.js";
 import "./chunk-SVOZFLIQ.js";
 import "./chunk-LTJAMRGI.js";
-import "./chunk-J6A3CX5N.js";
 import "./chunk-JS2HKKOK.js";
-import "./chunk-SCU65EZI.js";
-import "./chunk-MB5RSUW6.js";
-import "./chunk-6KYMPV2O.js";
 import "./chunk-AWJ2FHCF.js";
 import "./chunk-42JKGUFJ.js";
 import "./chunk-RULE4VG5.js";
+import "./chunk-SCU65EZI.js";
+import "./chunk-MB5RSUW6.js";
+import "./chunk-6KYMPV2O.js";
 import "./chunk-DM2T26WE.js";
 import "./chunk-LDXUBPMO.js";
-import "./chunk-2OZ2JEUP.js";
+import "./chunk-YTU7WKYN.js";
 import "./chunk-AAD2ZS6P.js";
+import "./chunk-W5H6ZRPT.js";
+import "./chunk-VF4XKTX3.js";
 import {
   CONSOLIDATION_OPERATORS,
   isConsolidationOperator,
   isSemanticConsolidationLlmOperator,
   isValidDerivedFromEntry
 } from "./chunk-G7D6GZ5J.js";
-import "./chunk-VF4XKTX3.js";
-import "./chunk-W5H6ZRPT.js";
-import "./chunk-5J4OL7TJ.js";
+import "./chunk-VUA4S7P6.js";
 import "./chunk-IQVQJJL7.js";
-import "./chunk-VL7DP3OW.js";
 import "./chunk-L2EXJQJP.js";
+import "./chunk-VL7DP3OW.js";
 import "./chunk-RGMVMVMF.js";
 import "./chunk-N7RWREIQ.js";
+import "./chunk-U3PN77QT.js";
+import "./chunk-VSF7AAGE.js";
 import "./chunk-OEHCMALU.js";
 import "./chunk-PHK3HARR.js";
-import "./chunk-4DJQYKMN.js";
 import "./chunk-5GKPFL3S.js";
+import "./chunk-4DJQYKMN.js";
 import "./chunk-EYIEWJNI.js";
 import "./chunk-JUC24CTX.js";
 import "./chunk-6MKAMLQL.js";
 import "./chunk-JAKIDQB2.js";
+import "./chunk-ZBJMUXZH.js";
 import "./chunk-NU3CSQ4H.js";
 import "./chunk-J2HSAU72.js";
 import "./chunk-A6XUJE5D.js";

package/dist/semantic-rule-promotion.js

@@ -1,41 +1,41 @@
 import {
   promoteSemanticRuleFromMemory,
   setSemanticRulePromotionTestHooks
-} from "./chunk-NCNOYM6F.js";
-import "./chunk-XBM5DG4O.js";
+} from "./chunk-LVMVYLNB.js";
+import "./chunk-5PHPNUZN.js";
 import "./chunk-M7XQSUBB.js";
 import "./chunk-L2B3EE7B.js";
 import "./chunk-5UZXUTVO.js";
 import "./chunk-5GPPACXK.js";
 import "./chunk-TKZ3AL5V.js";
 import "./chunk-6CIAGZ6X.js";
+import "./chunk-J6A3CX5N.js";
 import "./chunk-SVOZFLIQ.js";
 import "./chunk-LTJAMRGI.js";
-import "./chunk-J6A3CX5N.js";
 import "./chunk-JS2HKKOK.js";
-import "./chunk-SCU65EZI.js";
-import "./chunk-MB5RSUW6.js";
-import "./chunk-6KYMPV2O.js";
 import "./chunk-AWJ2FHCF.js";
 import "./chunk-42JKGUFJ.js";
 import "./chunk-RULE4VG5.js";
+import "./chunk-SCU65EZI.js";
+import "./chunk-MB5RSUW6.js";
+import "./chunk-6KYMPV2O.js";
 import "./chunk-DM2T26WE.js";
 import "./chunk-LDXUBPMO.js";
-import "./chunk-2OZ2JEUP.js";
+import "./chunk-YTU7WKYN.js";
 import "./chunk-AAD2ZS6P.js";
-import "./chunk-G7D6GZ5J.js";
-import "./chunk-VF4XKTX3.js";
 import "./chunk-W5H6ZRPT.js";
-import "./chunk-5J4OL7TJ.js";
+import "./chunk-VF4XKTX3.js";
+import "./chunk-G7D6GZ5J.js";
+import "./chunk-VUA4S7P6.js";
 import "./chunk-IQVQJJL7.js";
-import "./chunk-VL7DP3OW.js";
 import "./chunk-L2EXJQJP.js";
+import "./chunk-VL7DP3OW.js";
 import "./chunk-RGMVMVMF.js";
 import "./chunk-N7RWREIQ.js";
 import "./chunk-OEHCMALU.js";
 import "./chunk-PHK3HARR.js";
-import "./chunk-4DJQYKMN.js";
 import "./chunk-5GKPFL3S.js";
+import "./chunk-4DJQYKMN.js";
 import "./chunk-EYIEWJNI.js";
 import "./chunk-JUC24CTX.js";
 import "./chunk-6MKAMLQL.js";

package/dist/semantic-rule-verifier.js

@@ -1,46 +1,46 @@
 import {
   compareVerifiedSemanticRuleResults,
   searchVerifiedSemanticRules
-} from "./chunk-XCXN3D2U.js";
-import "./chunk-ZBJMUXZH.js";
-import "./chunk-XBM5DG4O.js";
+} from "./chunk-L5DU7THE.js";
+import "./chunk-5PHPNUZN.js";
 import "./chunk-M7XQSUBB.js";
 import "./chunk-L2B3EE7B.js";
 import "./chunk-5UZXUTVO.js";
 import "./chunk-5GPPACXK.js";
 import "./chunk-TKZ3AL5V.js";
 import "./chunk-6CIAGZ6X.js";
+import "./chunk-J6A3CX5N.js";
 import "./chunk-SVOZFLIQ.js";
 import "./chunk-LTJAMRGI.js";
-import "./chunk-J6A3CX5N.js";
 import "./chunk-JS2HKKOK.js";
-import "./chunk-SCU65EZI.js";
-import "./chunk-MB5RSUW6.js";
-import "./chunk-6KYMPV2O.js";
 import "./chunk-AWJ2FHCF.js";
 import "./chunk-42JKGUFJ.js";
 import "./chunk-RULE4VG5.js";
+import "./chunk-SCU65EZI.js";
+import "./chunk-MB5RSUW6.js";
+import "./chunk-6KYMPV2O.js";
 import "./chunk-DM2T26WE.js";
 import "./chunk-LDXUBPMO.js";
-import "./chunk-2OZ2JEUP.js";
+import "./chunk-YTU7WKYN.js";
 import "./chunk-AAD2ZS6P.js";
-import "./chunk-G7D6GZ5J.js";
-import "./chunk-VF4XKTX3.js";
 import "./chunk-W5H6ZRPT.js";
-import "./chunk-5J4OL7TJ.js";
+import "./chunk-VF4XKTX3.js";
+import "./chunk-G7D6GZ5J.js";
+import "./chunk-VUA4S7P6.js";
 import "./chunk-IQVQJJL7.js";
-import "./chunk-VL7DP3OW.js";
 import "./chunk-L2EXJQJP.js";
+import "./chunk-VL7DP3OW.js";
 import "./chunk-RGMVMVMF.js";
 import "./chunk-N7RWREIQ.js";
 import "./chunk-OEHCMALU.js";
 import "./chunk-PHK3HARR.js";
-import "./chunk-4DJQYKMN.js";
 import "./chunk-5GKPFL3S.js";
+import "./chunk-4DJQYKMN.js";
 import "./chunk-EYIEWJNI.js";
 import "./chunk-JUC24CTX.js";
 import "./chunk-6MKAMLQL.js";
 import "./chunk-JAKIDQB2.js";
+import "./chunk-ZBJMUXZH.js";
 import "./chunk-NU3CSQ4H.js";
 import "./chunk-J2HSAU72.js";
 import "./chunk-A6XUJE5D.js";

package/dist/shared-context/manager.d.ts

@@ -18,28 +18,28 @@ declare const SharedFeedbackEntrySchema: z.ZodObject<{
     evidenceWindowEnd: z.ZodOptional<z.ZodString>;
     refs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
 }, "strip", z.ZodTypeAny, {
-    decision: "rejected" | "approved" | "approved_with_feedback";
     reason: string;
+    decision: "rejected" | "approved" | "approved_with_feedback";
     date: string;
     agent: string;
-    workflow?: string | undefined;
-    tags?: string[] | undefined;
+    severity?: "low" | "medium" | "high" | undefined;
     confidence?: number | undefined;
-    severity?: "high" | "low" | "medium" | undefined;
+    tags?: string[] | undefined;
+    workflow?: string | undefined;
     outcome?: string | undefined;
     refs?: string[] | undefined;
     learning?: string | undefined;
     evidenceWindowStart?: string | undefined;
     evidenceWindowEnd?: string | undefined;
 }, {
-    decision: "rejected" | "approved" | "approved_with_feedback";
     reason: string;
+    decision: "rejected" | "approved" | "approved_with_feedback";
     date: string;
     agent: string;
-    workflow?: string | undefined;
-    tags?: string[] | undefined;
+    severity?: "low" | "medium" | "high" | undefined;
     confidence?: number | undefined;
-    severity?: "high" | "low" | "medium" | undefined;
+    tags?: string[] | undefined;
+    workflow?: string | undefined;
     outcome?: string | undefined;
     refs?: string[] | undefined;
     learning?: string | undefined;

package/dist/storage.d.ts

@@ -1,4 +1,4 @@
-import { P as PluginConfig, u as MemoryStatus, h as MemoryCategory, ae as ImportanceScore, ar as MemoryLink, q as MemoryFrontmatter, F as FaithfulnessFrontmatter, J as ProvenanceSource, M as MemoryFile, a7 as EntityStructuredSection, as as BufferState, at as MetaState, a2 as MemoryActionEvent, w as MemoryLifecycleEvent, X as BufferSurpriseEvent, B as BehaviorSignalEvent, a3 as CompressionGuidelineOptimizerState, aa as ContinuityIncidentOpenInput, a8 as ContinuityIncidentRecord, a9 as ContinuityIncidentCloseInput, ab as ContinuityImprovementLoop, ad as ContinuityLoopUpsertInput, ac as ContinuityLoopReviewInput, au as FileHygieneConfig, av as EntityRelationship, aw as EntityActivityEntry, E as EntityFile, ax as AccessTrackingEntry, v as MemoryProjectionCurrentState, ay as MemorySummary, aq as TopicScore, az as EntityTimelineEntry } from './types-D1iBqhJA.js';
+import { M as MemoryFile, P as PluginConfig, u as MemoryStatus, h as MemoryCategory, ae as ImportanceScore, ar as MemoryLink, q as MemoryFrontmatter, F as FaithfulnessFrontmatter, J as ProvenanceSource, a7 as EntityStructuredSection, as as BufferState, at as MetaState, a2 as MemoryActionEvent, w as MemoryLifecycleEvent, X as BufferSurpriseEvent, B as BehaviorSignalEvent, a3 as CompressionGuidelineOptimizerState, aa as ContinuityIncidentOpenInput, a8 as ContinuityIncidentRecord, a9 as ContinuityIncidentCloseInput, ab as ContinuityImprovementLoop, ad as ContinuityLoopUpsertInput, ac as ContinuityLoopReviewInput, au as FileHygieneConfig, av as EntityRelationship, aw as EntityActivityEntry, E as EntityFile, ax as AccessTrackingEntry, v as MemoryProjectionCurrentState, ay as MemorySummary, aq as TopicScore, az as EntityTimelineEntry } from './types-D1iBqhJA.js';
 import { VersioningConfig } from './page-versioning.js';
 import { ConsolidationOperator } from './consolidation-operator.js';
 import { ProjectedMemoryBrowseOptions, ProjectedMemoryBrowsePage, readProjectedGovernanceRecord } from './memory-projection-store.js';
@@ -294,6 +294,12 @@ interface MemoryLifecycleEventWriteOptions {
     relatedMemoryIds?: string[];
     correlationId?: string;
 }
+declare function parseFrontmatterStringValue(rawValue: string | undefined): string | undefined;
+declare function parseFrontmatter(raw: string): {
+    frontmatter: MemoryFrontmatter;
+    content: string;
+} | null;
+declare function normalizeFrontmatterForPath(frontmatter: MemoryFrontmatter, pathRel: string, content?: string): MemoryFrontmatter;
 /**
  * Normalize an entity name to a canonical form.
  * Strips non-alphanumeric chars, collapses hyphens, removes type prefix duplication.
@@ -376,6 +382,20 @@ declare function parseEntityFile(content: string, entitySchemas?: PluginConfig["
  */
 declare function serializeEntityFile(entity: EntityFile, entitySchemas?: PluginConfig["entitySchemas"]): string;
 declare function buildEntitySchemaCacheKey(entitySchemas?: PluginConfig["entitySchemas"]): string;
+/**
+ * Full-schema type guard for a `BUFFER_SURPRISE` telemetry row
+ * (issue #563 PR 3).
+ *
+ * The reader applies `limit` over the count of VALID rows, so
+ * applying only a partial check (e.g. "has a finite surpriseScore")
+ * and then deferring the rest of validation to
+ * `reportBufferSurpriseDistribution` would silently count
+ * schema-incomplete rows toward the limit, pushing genuinely-valid
+ * earlier rows out of the report window. Validate everything the
+ * downstream report requires at read time so the limit semantics and
+ * the distribution semantics stay consistent.
+ */
+declare function isValidBufferSurpriseEvent(value: unknown): value is BufferSurpriseEvent;
 /** Result of {@link StorageManager.writeMemory} (issue #1645). Carries the
  * persisted id PLUS the non-resurrection tombstone-block outcome (#1579) so
  * post-write callers can observe it — NEVER a silent no-op (rule 34). */
@@ -395,17 +415,37 @@ declare class StorageManager {
     private artifactIndexCache;
     /** Read by storage/entity-store.ts (decomposition), hence not `private`. */
     static readonly KNOWLEDGE_INDEX_CACHE_TTL_MS = 600000;
-    private static readonly ARTIFACT_INDEX_CACHE_TTL_MS;
+    /** Read by storage/memory-read-store.ts (decomposition). */
+    static readonly ARTIFACT_INDEX_CACHE_TTL_MS = 60000;
     private static readonly artifactWriteVersionByDir;
     private static readonly memoryStatusVersionByDir;
     private static readonly secureStoreEntityCacheKeyIds;
     private static nextSecureStoreEntityCacheKeyId;
     private static readonly coldWriteVersionByDir;
     private static readonly allMemoriesInFlight;
-    private static readonly COLD_SCAN_CACHE_TTL_MS;
-    private static readonly coldMemoriesCache;
-    private static readonly QUESTIONS_CACHE_TTL_MS;
-    private static readonly questionsCache;
+    /** Read by storage/memory-read-store.ts (decomposition). */
+    static readonly COLD_SCAN_CACHE_TTL_MS = 30000;
+    /** Read by storage/memory-read-store.ts (decomposition). */
+    static readonly coldMemoriesCache: Map<string, {
+        memories: MemoryFile[];
+        loadedAt: number;
+        coldVersion: number;
+    }>;
+    /** Read by storage/memory-read-store.ts (decomposition). */
+    static readonly QUESTIONS_CACHE_TTL_MS = 60000;
+    /** Read by storage/memory-read-store.ts (decomposition). */
+    static readonly questionsCache: Map<string, {
+        questions: Array<{
+            id: string;
+            question: string;
+            context: string;
+            priority: number;
+            resolved: boolean;
+            created: string;
+            filePath: string;
+        }>;
+        loadedAt: number;
+    }>;
     private factHashIndex;
     private factHashIndexLoadPromise;
     private factHashIndexAuthoritative;
@@ -503,7 +543,20 @@ declare class StorageManager {
      */
     snapshotForProvenance(filePath: string): Promise<string | null>;
     constructor(baseDir: string, entitySchemas?: PluginConfig["entitySchemas"]);
+    /**
+     * The LIVE class object of this instance (issue #1809 review of the
+     * storage decomposition): extracted store modules must read/write the
+     * shared static caches (questionsCache, coldMemoriesCache, ...) through
+     * the SAME class binding the host methods use. Referencing the imported
+     * `StorageManager` symbol from a split bundle chunk can yield a second
+     * class copy with its own statics, split-braining the caches
+     * (resolveQuestion clears copy A while readQuestions reads copy B).
+     */
+    get storageManagerClass(): typeof StorageManager;
     /** The root directory of this storage instance. */
+    /** MemoryReadStore (storage.ts decomposition). Lazy; selfDeps live wiring. */
+    private _memoryReadStore;
+    private get memoryReadStore();
     /** EntityStore (storage.ts decomposition). Lazy; selfDeps live wiring. */
     private _entityStore;
     private get entityStore();
@@ -526,10 +579,6 @@ declare class StorageManager {
     writeWearableDayTranscript(sourceId: string, date: string, serialized: string): Promise<void>;
     /** Read a stored day transcript; null when the day has no file. */
     readWearableDayTranscript(sourceId: string, date: string): Promise<string | null>;
-    /**
-     * List stored transcript days, newest first, optionally scoped to one
-     * source. Non-transcript files in the tree are ignored.
-     */
     listWearableTranscriptDays(sourceId?: string): Promise<Array<{
         source: string;
         date: string;
@@ -901,39 +950,12 @@ declare class StorageManager {
         filePaths: string[];
     }>;
     private _readAllMemoriesFromDisk;
-    /**
-     * Read all memories from the cold tier by scanning the entire cold/ root
-     * tree.  Previously this only scanned cold/facts/ and cold/corrections/, but
-     * structuredAttributes can appear on any MemoryCategory (preference, decision,
-     * entity, etc.).  buildTierMemoryPath now routes each category to its own
-     * cold/<dir>/ subtree via the shared categoryDirName() chokepoint (issue
-     * #1546), so cold decisions/preferences/... live outside cold/facts/.
-     * Scanning the full coldRoot covers every category dir and guards against
-     * files placed in unexpected subdirectories during manual operations or future
-     * refactors.
-     *
-     * Broadened in PR #402 round-6 (Finding UTsP): scanning only facts/ and
-     * corrections/ was a narrower-than-necessary subset of the cold directory
-     * tree.  Correctness trumps the minor performance difference — cold scans
-     * already happen at most once per supersession write.
-     *
-     * Used by applyTemporalSupersession so that memories already demoted to
-     * cold/ can still be marked superseded when a newer hot fact arrives.
-     *
-     * Cached with a TTL (Finding UOGi, PR #402 round-6): back-to-back
-     * structured-attribute writes in the same burst reuse the cached result
-     * instead of re-scanning the cold tree on every call.  The cache is
-     * invalidated whenever a write calls invalidateAllMemoriesCache() (which
-     * covers any hot→cold demotion that changes cold-tier contents) and
-     * expires after COLD_SCAN_CACHE_TTL_MS as a safety net.
-     */
     readAllColdMemories(): Promise<MemoryFile[]>;
     /**
      * Read archived memory markdown files under archive/.
      * Used by long-term recall fallback when hot recall has no hits.
      */
     readArchivedMemories(): Promise<MemoryFile[]>;
-    /** Read a single memory file by its absolute path. Returns null if unreadable. */
     readMemoryByPath(filePath: string): Promise<MemoryFile | null>;
     private resolveTierRootDir;
     private resolveMemoryDateDir;
@@ -990,47 +1012,7 @@ declare class StorageManager {
     saveMeta(state: MetaState): Promise<void>;
     appendMemoryActionEvents(events: MemoryActionEvent[]): Promise<number>;
     appendMemoryLifecycleEvents(events: MemoryLifecycleEvent[]): Promise<number>;
-    /**
-     * Append a batch of `BUFFER_SURPRISE` telemetry events (issue #563 PR 3).
-     *
-     * Each event records a single buffer flush decision driven by the
-     * surprise gate. The ledger is consumed by
-     * `reportBufferSurpriseDistribution` (Doctor report) and by downstream
-     * benchmark analysis. This method is fire-and-forget by contract:
-     * callers log but do not fail the hot path if the append throws.
-     */
     appendBufferSurpriseEvents(events: BufferSurpriseEvent[]): Promise<number>;
-    /**
-     * Read the buffer-surprise ledger, most recent rows last.
-     *
-     * `limit` bounds the number of **valid rows** returned (not the
-     * number of raw lines parsed). We parse every row, discard malformed
-     * ones, then take the tail — so a partial/truncated trailing line
-     * (the common failure mode after an interrupted append) cannot hide
-     * otherwise-valid recent data above it.
-     *
-     * Non-positive / non-integer / non-finite limits return `[]` rather
-     * than the entire file, matching the other ledger readers in this
-     * class and protecting against `slice(-0.5)` → `slice(-0)` silently
-     * devolving into an unbounded parse.
-     *
-     * # Performance note
-     *
-     * For very large ledgers (issue #563 follow-up), a tail-first reader
-     * would avoid parsing the full file when only a recent window is
-     * needed. We keep the full-scan implementation here because:
-     *
-     *   - the ledger is opt-in (flag off by default), so early deployments
-     *     accumulate rows slowly;
-     *   - telemetry rows are small (~200 bytes), so even 100k rows parse
-     *     in well under a second;
-     *   - the governance archive/cleanup flow can trim the ledger when
-     *     size becomes a concern, reusing the existing maintenance hooks.
-     *
-     * Swap to a chunked tail-reader if production logs show this is a
-     * hot path — leaving that work for a follow-up keeps this PR scoped
-     * to correctness, not optimization.
-     */
     readBufferSurpriseEvents(options?: {
         limit?: number;
     }): Promise<BufferSurpriseEvent[]>;
@@ -1261,4 +1243,4 @@ declare class StorageManager {
     private appendGeneratedMemoryLifecycleEventFailOpen;
 }
 
-export { ContentHashIndex, type MemoryLifecycleEventWriteOptions, type MemoryWriteResult, type ReextractJobRequest, StorageManager, buildEntitySchemaCacheKey, compareEntityTimestamps, compileEntityFacts, countEntityStructuredFacts, fingerprintEntityStructuredFacts, isEntitySynthesisStale, normalizeAttributePairs, normalizeEntityName, normalizeStructuredSectionFacts, parseEntityFile, serializeEntityFile };
+export { ContentHashIndex, type MemoryLifecycleEventWriteOptions, type MemoryWriteResult, type ReextractJobRequest, StorageManager, buildEntitySchemaCacheKey, compareEntityTimestamps, compileEntityFacts, countEntityStructuredFacts, fingerprintEntityStructuredFacts, isEntitySynthesisStale, isValidBufferSurpriseEvent, normalizeAttributePairs, normalizeEntityName, normalizeFrontmatterForPath, normalizeStructuredSectionFacts, parseEntityFile, parseFrontmatter, parseFrontmatterStringValue, serializeEntityFile };

package/dist/storage.js

@@ -7,47 +7,51 @@ import {
   countEntityStructuredFacts,
   fingerprintEntityStructuredFacts,
   isEntitySynthesisStale,
+  isValidBufferSurpriseEvent,
   normalizeAttributePairs,
   normalizeEntityName,
+  normalizeFrontmatterForPath,
   normalizeStructuredSectionFacts,
   parseEntityFile,
+  parseFrontmatter,
+  parseFrontmatterStringValue,
   serializeEntityFile
-} from "./chunk-XBM5DG4O.js";
+} from "./chunk-5PHPNUZN.js";
 import "./chunk-M7XQSUBB.js";
 import "./chunk-L2B3EE7B.js";
 import "./chunk-5UZXUTVO.js";
 import "./chunk-5GPPACXK.js";
 import "./chunk-TKZ3AL5V.js";
 import "./chunk-6CIAGZ6X.js";
+import "./chunk-J6A3CX5N.js";
 import {
   stripAttributesSuffix
 } from "./chunk-SVOZFLIQ.js";
 import "./chunk-LTJAMRGI.js";
-import "./chunk-J6A3CX5N.js";
 import "./chunk-JS2HKKOK.js";
-import "./chunk-SCU65EZI.js";
-import "./chunk-MB5RSUW6.js";
-import "./chunk-6KYMPV2O.js";
 import "./chunk-AWJ2FHCF.js";
 import "./chunk-42JKGUFJ.js";
 import "./chunk-RULE4VG5.js";
+import "./chunk-SCU65EZI.js";
+import "./chunk-MB5RSUW6.js";
+import "./chunk-6KYMPV2O.js";
 import "./chunk-DM2T26WE.js";
 import "./chunk-LDXUBPMO.js";
-import "./chunk-2OZ2JEUP.js";
+import "./chunk-YTU7WKYN.js";
 import "./chunk-AAD2ZS6P.js";
-import "./chunk-G7D6GZ5J.js";
-import "./chunk-VF4XKTX3.js";
 import "./chunk-W5H6ZRPT.js";
-import "./chunk-5J4OL7TJ.js";
+import "./chunk-VF4XKTX3.js";
+import "./chunk-G7D6GZ5J.js";
+import "./chunk-VUA4S7P6.js";
 import "./chunk-IQVQJJL7.js";
-import "./chunk-VL7DP3OW.js";
 import "./chunk-L2EXJQJP.js";
+import "./chunk-VL7DP3OW.js";
 import "./chunk-RGMVMVMF.js";
 import "./chunk-N7RWREIQ.js";
 import "./chunk-OEHCMALU.js";
 import "./chunk-PHK3HARR.js";
-import "./chunk-4DJQYKMN.js";
 import "./chunk-5GKPFL3S.js";
+import "./chunk-4DJQYKMN.js";
 import "./chunk-EYIEWJNI.js";
 import "./chunk-JUC24CTX.js";
 import "./chunk-6MKAMLQL.js";
@@ -67,10 +71,14 @@ export {
   countEntityStructuredFacts,
   fingerprintEntityStructuredFacts,
   isEntitySynthesisStale,
+  isValidBufferSurpriseEvent,
   normalizeAttributePairs,
   normalizeEntityName,
+  normalizeFrontmatterForPath,
   normalizeStructuredSectionFacts,
   parseEntityFile,
+  parseFrontmatter,
+  parseFrontmatterStringValue,
   serializeEntityFile,
   stripAttributesSuffix
 };

package/dist/summarizer.js

@@ -1,20 +1,20 @@
 import {
   HourlySummarizer
-} from "./chunk-PJQMISPD.js";
+} from "./chunk-NNL4LJAD.js";
 import "./chunk-3FAMU5TX.js";
 import "./chunk-PWFWCGOO.js";
 import "./chunk-DBSMLRTO.js";
 import "./chunk-S4DDLTPX.js";
 import "./chunk-FF4KLI5W.js";
 import "./chunk-O75CRYGF.js";
-import "./chunk-VSF7AAGE.js";
 import "./chunk-LTJAMRGI.js";
-import "./chunk-5J4OL7TJ.js";
+import "./chunk-VUA4S7P6.js";
 import "./chunk-IQVQJJL7.js";
-import "./chunk-VL7DP3OW.js";
 import "./chunk-L2EXJQJP.js";
+import "./chunk-VL7DP3OW.js";
 import "./chunk-RGMVMVMF.js";
 import "./chunk-N7RWREIQ.js";
+import "./chunk-VSF7AAGE.js";
 import "./chunk-EYIEWJNI.js";
 import "./chunk-JUC24CTX.js";
 import "./chunk-NU3CSQ4H.js";

package/dist/transfer/backup.js

@@ -1,8 +1,8 @@
 import {
   backupMemoryDir
-} from "../chunk-2BFLDH5F.js";
+} from "../chunk-EEIROWEG.js";
 import "../chunk-765K3SAT.js";
-import "../chunk-437S3G37.js";
+import "../chunk-LNQUAJNC.js";
 import "../chunk-GWTFLF2P.js";
 import "../chunk-UKJAGEXH.js";
 import "../chunk-FP2373TW.js";

package/dist/transfer/capsule-export.js

@@ -1,12 +1,12 @@
 import {
   exportCapsule,
   isValidCapsuleSince
-} from "../chunk-FLVL4L3L.js";
-import "../chunk-WEHSQBFR.js";
-import "../chunk-437S3G37.js";
+} from "../chunk-KTULX4YO.js";
+import "../chunk-LNQUAJNC.js";
 import "../chunk-GWTFLF2P.js";
 import "../chunk-UKJAGEXH.js";
 import "../chunk-FP2373TW.js";
+import "../chunk-WEHSQBFR.js";
 import "../chunk-J4EB7DNW.js";
 import "../chunk-UI3NYK34.js";
 import "../chunk-GCGJW34D.js";