@remnic/core 9.3.700 → 9.3.701

package/dist/{catalog-DN1PzThs.d.ts → catalog-DBIghceA.d.ts}

@@ -94,8 +94,7 @@ declare class NamespaceCatalog {
     private readonly stateDir;
     private readonly catalogPath;
     private readonly rebuildLockPath;
-    private readonly lockOwnerId;
-    private writeChain;
+    private readonly criticalSection;
     protected onTouchCriticalSectionForTest?: () => Promise<void>;
     protected onRebuildBeforeRenameForTest?: () => Promise<void>;
     protected onRebuildAfterScanForTest?: () => Promise<void>;
@@ -354,24 +353,23 @@ declare class NamespaceCatalog {
      * their respective critical sections — closing the check-then-append gap where a
      * polled-only touch could append into a rebuild's load→rename window.
      *
-     * Acquisition is atomic via `open(..., "wx")`. A lock older than
-     * `REBUILD_LOCK_STALE_MS` is treated as a crashed holder and broken. After
-     * `REBUILD_LOCK_MAX_WAIT_MS` of contention we proceed best-effort WITHOUT the
-     * lock rather than block forever. The lock is always released in `finally`.
+     * Issue #1524 adoption: this is now a thin delegation to the shared
+     * `withHeldFileLock` utility. The acquire loop, mtime heartbeat, stale-break
+     * (NG7Bg replacement-safe), and ownership-checked release (NCzT6) all live in
+     * ONE place — the util — so this module no longer re-implements them. The
+     * catalog's `REBUILD_LOCK_*` constants and the `onBeforeBreakStaleUnlinkForTest`
+     * seam flow straight through. The util generates a per-CALL owner uuid, which
+     * is stricter than the previous per-instance `lockOwnerId` (two calls on the
+     * same instance get different ids, so neither mistakes the other's lock as
+     * self-held — the NBsGP invariant, preserved and tightened).
      *
      * IN-PROCESS SAFETY: every caller invokes this from inside (or wrapping) the
      * per-process `queueCritical` chain, which serializes all catalog mutations in
-     * THIS process. So within one process only one logical holder attempts OS-lock
-     * acquisition at a time — the file lock is never self-contended in-process, and
-     * the lock is acquired and released within a single in-process turn. The file
-     * lock adds only the missing CROSS-process exclusion.
-     *
-     * HEARTBEAT (round 5, cursor/codex Medium/P2): while WE hold the lock a timer
-     * refreshes its mtime every `REBUILD_LOCK_HEARTBEAT_MS`, so a legitimately long
-     * holder (> `REBUILD_LOCK_STALE_MS`) is not treated as a crashed holder and
-     * unlinked by another process — which would let overlapping windows lose
-     * appends. Heartbeat failures are swallowed; the timer is always cleared in
-     * `finally`.
+     * THIS process (now via `MutationSerializer`). So within one process only one
+     * logical holder attempts OS-lock acquisition at a time — the file lock is never
+     * self-contended in-process, and the lock is acquired and released within a
+     * single in-process turn. The file lock adds only the missing CROSS-process
+     * exclusion.
      *
      * ACQUISITION RESULT (round 6, codex P2 — NBPmY): `fn` receives whether WE
      * actually hold the lock. When acquisition TIMED OUT (another holder is active),
@@ -381,35 +379,6 @@ declare class NamespaceCatalog {
      * (touch) when unlocked.
      */
     private withHeldCatalogLock;
-    /** Try to acquire the rebuild lock; returns true if WE created it. */
-    private acquireRebuildLock;
-    /**
-     * Remove the lock file if its mtime is older than the stale threshold.
-     *
-     * REPLACEMENT-SAFE (NG7Bg, codex P2): a plain `stat` → `unlink` has a TOCTOU
-     * window — two processes can both observe the SAME stale lock; one removes it and
-     * creates a FRESH lock, and the other's later `unlink` then deletes that fresh
-     * holder's ACTIVE lock based on the stale identity it read earlier, leaving the
-     * fresh holder running its critical section with no visible lock and reopening the
-     * lost-update race the mutex prevents. We therefore capture the lock's IDENTITY
-     * (its full content line: `<pid> <owner-uuid> <iso>`) when we judge it stale, then
-     * RE-READ immediately before unlinking and only remove it when the content is
-     * byte-identical AND still stale. A replacement lock has a different owner id /
-     * timestamp, so its content differs and we leave it untouched. We never unlink a
-     * lock whose mtime is now fresh (a heartbeat refreshed it) or whose identity
-     * changed (a replacement was created). This is best-effort: any mismatch/vanish
-     * simply skips the break and the caller polls again.
-     */
-    private breakStaleRebuildLock;
-    /**
-     * Whether the rebuild lock file was written by THIS instance (round 6, codex
-     * P2 — NBsGP). Matches the per-instance owner id, NOT just `process.pid`: two
-     * NamespaceCatalog instances in the same process share a PID, so a PID-only
-     * check would wrongly treat instance A's lock as self-held by instance B and
-     * let B's touch skip the wait and append into A's rebuild window. Falls back to
-     * the legacy PID-only form for lock files written before owner ids existed.
-     */
-    private rebuildLockHeldBySelf;
     /**
      * Merge a prior record's preserved metadata (timestamps, principal hints)
      * onto a freshly-discovered record. Disk-derived fields (storageDir, kind)
@@ -427,12 +396,17 @@ declare class NamespaceCatalog {
     private loadCompacted;
     /**
      * Serialize an arbitrary read-modify-write critical section through the single
-     * write chain. Every catalog mutation (touch read+merge+append, full rewrite)
-     * runs through this so they are mutually exclusive: a touch always reads the
-     * latest persisted state before appending, and a rebuild rewrite cannot
-     * interleave with a touch's append. The chain recovers from rejection
-     * (CLAUDE.md rule #40) — one failed section never poisons subsequent ones —
-     * while still surfacing the error to that section's awaited promise.
+     * per-instance chain. Every catalog mutation (touch read+merge+append, full
+     * rewrite) runs through this so they are mutually exclusive: a touch always
+     * reads the latest persisted state before appending, and a rebuild rewrite
+     * cannot interleave with a touch's append.
+     *
+     * Issue #1524 adoption: delegates to the shared `MutationSerializer` (stored
+     * as `criticalSection`). The util owns the rejection-recovery invariant
+     * (CLAUDE.md rule #40 — one failed section never poisons subsequent ones, but
+     * the failing section's error still surfaces to ITS awaited promise) and the
+     * no-unbounded-growth cleanup. The key is constant: the catalog has ONE
+     * logical mutation queue (touches and rebuilds mutually exclude in-process).
      */
     private queueCritical;
     /**

package/dist/causal-consolidation.js

@@ -4,10 +4,10 @@ import {
 } from "./chunk-4NFVPDIL.js";
 import {
   buildExtensionsBlockForConsolidation
-} from "./chunk-2NWHLAXX.js";
+} from "./chunk-JO3E5VGS.js";
 import {
   runPostConsolidationMaterialize
-} from "./chunk-SMIVW7XC.js";
+} from "./chunk-ISLJ5WIM.js";
 import "./chunk-UUH4YQOF.js";
 import "./chunk-JLNBQWZ2.js";
 import "./chunk-3UXOZBHV.js";
@@ -15,15 +15,15 @@ import "./chunk-7FL4CNPV.js";
 import {
   resolveCausalTrajectoryStoreDir
 } from "./chunk-YN4ZT4CW.js";
-import "./chunk-X74FJSW7.js";
-import "./chunk-PCZR32VL.js";
+import "./chunk-SFMRLXIV.js";
+import "./chunk-3JJWNZTT.js";
 import "./chunk-M7XQSUBB.js";
-import "./chunk-YPR7DOPD.js";
 import "./chunk-5UZXUTVO.js";
 import "./chunk-5GPPACXK.js";
 import "./chunk-OMNTQPZO.js";
 import "./chunk-IREVVFTM.js";
 import "./chunk-SVOZFLIQ.js";
+import "./chunk-LTJAMRGI.js";
 import "./chunk-J6A3CX5N.js";
 import "./chunk-IKNQAGBV.js";
 import "./chunk-SCU65EZI.js";

package/dist/{chunk-GYVVQYA3.js → chunk-27LQPUMZ.js}

@@ -10,10 +10,10 @@ import {
 import {
   listMemoryGovernanceRuns,
   readMemoryGovernanceRunArtifact
-} from "./chunk-RJ2THZ4H.js";
+} from "./chunk-TFVVONWD.js";
 import {
   StorageManager
-} from "./chunk-X74FJSW7.js";
+} from "./chunk-SFMRLXIV.js";
 import {
   normalizeProjectionPreview,
   normalizeProjectionTags
@@ -929,4 +929,4 @@ export {
   verifyMemoryProjection,
   repairMemoryProjection
 };
-//# sourceMappingURL=chunk-GYVVQYA3.js.map
+//# sourceMappingURL=chunk-27LQPUMZ.js.map

package/dist/{chunk-XJNBEDFE.js → chunk-3FAMU5TX.js}

@@ -2,17 +2,13 @@ import {
   encodeStoragePathSegment,
   resolvePathInsideStorageRoot
 } from "./chunk-FF4KLI5W.js";
+import {
+  serializeMutations,
+  withHeldFileLock
+} from "./chunk-LTJAMRGI.js";
 
 // src/summary-snapshot.ts
-import {
-  mkdir,
-  open,
-  readFile,
-  stat,
-  unlink,
-  utimes,
-  writeFile
-} from "fs/promises";
+import { mkdir, readFile, writeFile } from "fs/promises";
 import path from "path";
 import { z } from "zod";
 var summarySnapshotSchemaVersion = 1;
@@ -29,7 +25,6 @@ var SummarySnapshotSchema = z.object({
   generatedAt: z.string().datetime({ offset: true }),
   summaries: z.array(SummarySnapshotItemSchema)
 });
-var summarySnapshotUpserts = /* @__PURE__ */ new Map();
 var summarySnapshotLockTimeoutMs = 5e3;
 var summarySnapshotLockStaleMs = 3e4;
 var summarySnapshotLockHeartbeatMs = Math.max(
@@ -101,25 +96,31 @@ async function writeSummarySnapshot(memoryDir, sessionKey, summaries) {
   await writeFile(filePath, JSON.stringify(payload, null, 2), "utf-8");
 }
 async function withSummarySnapshotLock(memoryDir, sessionKey, work) {
-  const previous = summarySnapshotUpserts.get(sessionKey) ?? Promise.resolve();
-  let release;
-  const current = new Promise((resolve) => {
-    release = resolve;
-  });
-  const chained = previous.then(() => current);
-  summarySnapshotUpserts.set(sessionKey, chained);
-  await previous;
-  try {
-    return await withExclusiveSummarySnapshotFileLock(
-      summarySnapshotLockPath(memoryDir, sessionKey),
-      work
-    );
-  } finally {
-    release();
-    if (summarySnapshotUpserts.get(sessionKey) === chained) {
-      summarySnapshotUpserts.delete(sessionKey);
-    }
-  }
+  return serializeMutations(
+    `summary-snapshot:${sessionKey}`,
+    () => (
+      // Cross-process mutex via the shared utility. The lock path, stale
+      // threshold, bounded wait, and heartbeat cadence all flow through; the
+      // utility's replacement-safe stale break (NG7Bg) and ownership-checked
+      // release are stronger than the bare `unlink` this module used before.
+      withHeldFileLock(
+        summarySnapshotLockPath(memoryDir, sessionKey),
+        {
+          staleMs: summarySnapshotLockStaleMs,
+          maxWaitMs: summarySnapshotLockTimeoutMs,
+          heartbeatMs: summarySnapshotLockHeartbeatMs
+        },
+        async (acquired) => {
+          if (!acquired) {
+            throw new Error(
+              "could not acquire summary snapshot lock (contention timeout or filesystem error)"
+            );
+          }
+          return work();
+        }
+      )
+    )
+  );
 }
 async function upsertSummarySnapshot(memoryDir, summary) {
   await withSummarySnapshotLock(memoryDir, summary.sessionKey, async () => {
@@ -139,50 +140,6 @@ async function upsertSummarySnapshot(memoryDir, summary) {
     await writeSummarySnapshot(memoryDir, summary.sessionKey, next);
   });
 }
-async function withExclusiveSummarySnapshotFileLock(lockPath, callback) {
-  await mkdir(path.dirname(lockPath), { recursive: true });
-  const startedAt = Date.now();
-  while (true) {
-    try {
-      const handle = await open(lockPath, "wx");
-      let heartbeat = null;
-      if (summarySnapshotLockHeartbeatMs > 0) {
-        heartbeat = setInterval(() => {
-          void utimes(lockPath, /* @__PURE__ */ new Date(), /* @__PURE__ */ new Date()).catch(() => void 0);
-        }, summarySnapshotLockHeartbeatMs);
-        heartbeat.unref?.();
-      }
-      try {
-        return await callback();
-      } finally {
-        if (heartbeat) clearInterval(heartbeat);
-        await handle.close().catch(() => void 0);
-        await unlink(lockPath).catch(() => void 0);
-      }
-    } catch (error) {
-      if (!isAlreadyExistsError(error)) throw error;
-      try {
-        const lockStat = await stat(lockPath);
-        if (Date.now() - lockStat.mtimeMs > summarySnapshotLockStaleMs) {
-          await unlink(lockPath).catch(() => void 0);
-          continue;
-        }
-      } catch {
-        continue;
-      }
-      if (Date.now() - startedAt > summarySnapshotLockTimeoutMs) {
-        throw new Error("timed out acquiring summary snapshot lock");
-      }
-      await sleep(10);
-    }
-  }
-}
-function isAlreadyExistsError(error) {
-  return typeof error === "object" && error !== null && "code" in error && error.code === "EEXIST";
-}
-function sleep(ms) {
-  return new Promise((resolve) => setTimeout(resolve, ms));
-}
 
 export {
   summarySnapshotPath,
@@ -190,4 +147,4 @@ export {
   writeSummarySnapshot,
   upsertSummarySnapshot
 };
-//# sourceMappingURL=chunk-XJNBEDFE.js.map
+//# sourceMappingURL=chunk-3FAMU5TX.js.map

package/dist/chunk-3FAMU5TX.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/summary-snapshot.ts"],"sourcesContent":["import { mkdir, readFile, writeFile } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { z } from \"zod\";\nimport {\n  encodeStoragePathSegment,\n  resolvePathInsideStorageRoot,\n} from \"./storage-paths.js\";\nimport {\n  serializeMutations,\n  withHeldFileLock,\n} from \"./utils/serialize-mutations.js\";\nimport type { HourlySummary } from \"./types.js\";\n\nconst summarySnapshotSchemaVersion = 1;\n\nconst SummarySnapshotItemSchema = z.object({\n  hour: z.string(),\n  sessionKey: z.string(),\n  bullets: z.array(z.string()),\n  turnCount: z.number().int().nonnegative(),\n  generatedAt: z.string(),\n});\n\nconst SummarySnapshotSchema = z.object({\n  schemaVersion: z.number().default(summarySnapshotSchemaVersion),\n  sessionKey: z.string(),\n  generatedAt: z.string().datetime({ offset: true }),\n  summaries: z.array(SummarySnapshotItemSchema),\n});\n\ntype SummarySnapshot = z.infer<typeof SummarySnapshotSchema>;\n\n// Lock timings for the cross-process summary-snapshot file lock. These are\n// passed straight through to the shared `withHeldFileLock` utility (issue\n// #1524 adoption); the previous bespoke lock used the same numbers.\nconst summarySnapshotLockTimeoutMs = 5_000;\nconst summarySnapshotLockStaleMs = 30_000;\nconst summarySnapshotLockHeartbeatMs = Math.max(\n  1_000,\n  Math.floor(summarySnapshotLockStaleMs / 3),\n);\n\nexport function summarySnapshotPath(\n  memoryDir: string,\n  sessionKey: string,\n): string {\n  return resolveSummarySnapshotPath(memoryDir, sessionKey, \"json\");\n}\n\nfunction summarySnapshotLockPath(memoryDir: string, sessionKey: string): string {\n  return resolveSummarySnapshotPath(memoryDir, sessionKey, \"lock\");\n}\n\nfunction summarySnapshotRoot(memoryDir: string): string {\n  return resolvePathInsideStorageRoot(memoryDir, \"state\", \"summaries\");\n}\n\nfunction resolveSummarySnapshotPath(\n  memoryDir: string,\n  sessionKey: string,\n  extension: \"json\" | \"lock\",\n): string {\n  const safeSessionKey = encodeStoragePathSegment(sessionKey, \"session\");\n  return resolvePathInsideStorageRoot(\n    summarySnapshotRoot(memoryDir),\n    `${safeSessionKey}.${extension}`,\n  );\n}\n\nfunction legacySummarySnapshotPath(\n  memoryDir: string,\n  sessionKey: string,\n): string | null {\n  if (sessionKey.includes(\"\\0\")) {\n    return null;\n  }\n  try {\n    return resolvePathInsideStorageRoot(\n      summarySnapshotRoot(memoryDir),\n      `${sessionKey}.json`,\n    );\n  } catch {\n    return null;\n  }\n}\n\nexport async function readSummarySnapshot(\n  memoryDir: string,\n  sessionKey: string,\n): Promise<HourlySummary[] | null> {\n  const filePath = summarySnapshotPath(memoryDir, sessionKey);\n  const snapshot = await readSummarySnapshotFile(filePath, sessionKey);\n  if (snapshot !== null) return snapshot;\n\n  const legacyPath = legacySummarySnapshotPath(memoryDir, sessionKey);\n  if (legacyPath === null || legacyPath === filePath) return null;\n  return readSummarySnapshotFile(legacyPath, sessionKey);\n}\n\nasync function readSummarySnapshotFile(\n  filePath: string,\n  sessionKey: string,\n): Promise<HourlySummary[] | null> {\n  try {\n    const raw = await readFile(filePath, \"utf-8\");\n    const data = SummarySnapshotSchema.parse(JSON.parse(raw));\n    if (data.sessionKey !== sessionKey) return null;\n    return data.summaries;\n  } catch {\n    return null;\n  }\n}\n\nexport async function writeSummarySnapshot(\n  memoryDir: string,\n  sessionKey: string,\n  summaries: HourlySummary[],\n): Promise<void> {\n  const filePath = summarySnapshotPath(memoryDir, sessionKey);\n  await mkdir(path.dirname(filePath), { recursive: true });\n  const payload: SummarySnapshot = {\n    schemaVersion: summarySnapshotSchemaVersion,\n    sessionKey,\n    generatedAt: new Date().toISOString(),\n    summaries: summaries\n      .map((summary) => ({\n        hour: summary.hour,\n        sessionKey: summary.sessionKey,\n        bullets: summary.bullets,\n        turnCount: summary.turnCount,\n        generatedAt: summary.generatedAt,\n      }))\n      .sort((a, b) => new Date(b.hour).getTime() - new Date(a.hour).getTime()),\n  };\n  await writeFile(filePath, JSON.stringify(payload, null, 2), \"utf-8\");\n}\n\n// ── Concurrency primitives (issue #1524 adoption) ─────────────────────────\n//\n// Summary-snapshot upserts were previously guarded by TWO bespoke serializers:\n//   1. an in-process `summarySnapshotUpserts` map keyed by sessionKey that\n//      chained each upsert off the prior one's release (mirroring\n//      `serializeMutations`), and\n//   2. an on-disk `withExclusiveSummarySnapshotFileLock` that re-implemented\n//      `open(path, \"wx\")` acquire, mtime heartbeat, stale-break, and\n//      ownership-checked release.\n// Both now delegate to the shared utility so there is ONE home for each\n// primitive (`serializeMutations` for in-process, `withHeldFileLock` for\n// cross-process). The behavior contract is preserved:\n//   - in-process upserts for the SAME sessionKey are strictly serialized\n//     (read-merge-write cannot interleave);\n//   - a cross-process holder blocks up to `summarySnapshotLockTimeoutMs`, then\n//     the upsert FAILS (a snapshot is advisory; we never race a read-merge-write\n//     unlocked). To preserve this strictness on top of a best-effort utility,\n//     the work callback throws when `acquired === false`.\n\nasync function withSummarySnapshotLock<T>(\n  memoryDir: string,\n  sessionKey: string,\n  work: () => Promise<T>,\n): Promise<T> {\n  // In-process serialization (one upsert per sessionKey at a time). The\n  // serializer recovers from rejection, so a failed upsert never poisons the\n  // next one — matching the previous chain's `.then(noop, noop)` recovery.\n  return serializeMutations(`summary-snapshot:${sessionKey}`, () =>\n    // Cross-process mutex via the shared utility. The lock path, stale\n    // threshold, bounded wait, and heartbeat cadence all flow through; the\n    // utility's replacement-safe stale break (NG7Bg) and ownership-checked\n    // release are stronger than the bare `unlink` this module used before.\n    withHeldFileLock(\n      summarySnapshotLockPath(memoryDir, sessionKey),\n      {\n        staleMs: summarySnapshotLockStaleMs,\n        maxWaitMs: summarySnapshotLockTimeoutMs,\n        heartbeatMs: summarySnapshotLockHeartbeatMs,\n      },\n      async (acquired) => {\n        // Strict-fail when the lock could not be acquired: the upsert is a\n        // read-merge-write, so a best-effort unlocked run would clobber a\n        // concurrent writer. The utility's `acquired === false` covers BOTH a\n        // genuine contention timeout AND a filesystem acquire failure (lock-dir\n        // mkdir/open/permission errors — the advisory lock is best-effort, so\n        // the util degrades rather than throwing). The bespoke lock this\n        // replaced propagated fs errors verbatim and reserved the timeout\n        // message for contention; we no longer claim \"timed out\" for an fs\n        // failure (cursor Low 25143f4f) — the message names both causes so\n        // upstream fail-open (runHourly) is unchanged but debugging is honest.\n        if (!acquired) {\n          throw new Error(\n            \"could not acquire summary snapshot lock (contention timeout or filesystem error)\",\n          );\n        }\n        return work();\n      },\n    ),\n  );\n}\n\nexport async function upsertSummarySnapshot(\n  memoryDir: string,\n  summary: HourlySummary,\n): Promise<void> {\n  await withSummarySnapshotLock(memoryDir, summary.sessionKey, async () => {\n    const existing = await readSummarySnapshot(memoryDir, summary.sessionKey);\n    const byHour = new Map<string, HourlySummary>();\n    for (const item of existing ?? []) {\n      byHour.set(item.hour, {\n        ...item,\n        generatedAt: item.generatedAt || new Date().toISOString(),\n        sessionKey: summary.sessionKey,\n      });\n    }\n    byHour.set(summary.hour, summary);\n    const next = Array.from(byHour.values()).sort(\n      (a, b) => new Date(b.hour).getTime() - new Date(a.hour).getTime(),\n    );\n    await writeSummarySnapshot(memoryDir, summary.sessionKey, next);\n  });\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-PCZR32VL.js → chunk-3JJWNZTT.js}

@@ -1,6 +1,6 @@
 import {
   serializeMutations
-} from "./chunk-YPR7DOPD.js";
+} from "./chunk-LTJAMRGI.js";
 
 // src/lifecycle/tombstones.ts
 var TOMBSTONE_PREFIX = "tomb";
@@ -443,4 +443,4 @@ export {
   collectRetiredMemoriesForRebuild,
   buildRetiredFactTombstoneInputs
 };
-//# sourceMappingURL=chunk-PCZR32VL.js.map
+//# sourceMappingURL=chunk-3JJWNZTT.js.map

package/dist/{chunk-GA5A6MJH.js → chunk-4HIAWLA2.js}

@@ -10,7 +10,7 @@ import {
 } from "./chunk-7HYPN2GC.js";
 import {
   MaintenanceScheduler
-} from "./chunk-YXIFA36P.js";
+} from "./chunk-ZT7B64BE.js";
 import {
   LcmEngine
 } from "./chunk-X5J3JZR3.js";
@@ -20,7 +20,7 @@ import {
 import {
   CompoundingEngine,
   defaultTierMigrationCycleBudget
-} from "./chunk-ZDK2IW5F.js";
+} from "./chunk-MNU5G4TK.js";
 import {
   SharedContextManager
 } from "./chunk-UFS7OXGL.js";
@@ -49,7 +49,7 @@ import {
 } from "./chunk-ECZU5BJH.js";
 import {
   HourlySummarizer
-} from "./chunk-RC3CNIPK.js";
+} from "./chunk-IO5NQEGZ.js";
 import {
   buildTargetedFactRecallSection,
   shouldRecallTargetedFactEvidence
@@ -168,7 +168,7 @@ import {
   buildEntityRecallSection,
   entityRecentTranscriptLookbackHours,
   readRecentEntityTranscriptEntries
-} from "./chunk-CHM274U6.js";
+} from "./chunk-7TAQEPLE.js";
 import {
   buildEventOrderRecallSection,
   shouldRecallEventOrderEvidence
@@ -185,14 +185,14 @@ import {
 import {
   compareVerifiedEpisodeResults,
   searchVerifiedEpisodes
-} from "./chunk-O54DY26V.js";
+} from "./chunk-XTIRCSIH.js";
 import {
   ThreadingManager
 } from "./chunk-QRDOSYOR.js";
 import {
   compareVerifiedSemanticRuleResults,
   searchVerifiedSemanticRules
-} from "./chunk-JKW5XSWC.js";
+} from "./chunk-QP37KL5H.js";
 import {
   searchWorkProductLedgerEntries
 } from "./chunk-ZRWB5D4H.js";
@@ -205,14 +205,14 @@ import {
 import {
   runNamespaceMaintenanceFanout,
   summarizeNamespaceMaintenanceHealth
-} from "./chunk-XY4WJTEX.js";
+} from "./chunk-WFEZUGU5.js";
 import {
   NamespaceCatalog,
   planNamespaceMaintenance
-} from "./chunk-DR2JTSLZ.js";
+} from "./chunk-JKOKX3PS.js";
 import {
   NamespaceStorageRouter
-} from "./chunk-PQG4T5V3.js";
+} from "./chunk-ODTWHSY2.js";
 import {
   isAboveImportanceThreshold,
   scoreImportance
@@ -254,7 +254,7 @@ import {
   materializeAfterSemanticConsolidation,
   parseConsolidationResponse,
   parseOperatorAwareConsolidationResponse
-} from "./chunk-2NWHLAXX.js";
+} from "./chunk-JO3E5VGS.js";
 import {
   buildBehaviorSignalsForMemory,
   dedupeBehaviorSignalsByMemoryAndHash
@@ -350,7 +350,7 @@ import {
 } from "./chunk-YN4ZT4CW.js";
 import {
   buildChainFollowupGenerator
-} from "./chunk-6JDGADXK.js";
+} from "./chunk-HF4N43Q7.js";
 import {
   ContentHashIndex,
   StorageManager,
@@ -358,10 +358,10 @@ import {
   fingerprintEntityStructuredFacts,
   normalizeAttributePairs,
   parseEntityFile
-} from "./chunk-X74FJSW7.js";
+} from "./chunk-SFMRLXIV.js";
 import {
   buildRetiredFactTombstoneInputs
-} from "./chunk-PCZR32VL.js";
+} from "./chunk-3JJWNZTT.js";
 import {
   isValidTranscriptDate,
   loadSpeakerRegistry,
@@ -15345,4 +15345,4 @@ export {
   resolvePersistedMemoryRelativePath,
   Orchestrator
 };
-//# sourceMappingURL=chunk-GA5A6MJH.js.map
+//# sourceMappingURL=chunk-4HIAWLA2.js.map

package/dist/{chunk-SEWF2O74.js → chunk-6W2D6FGG.js}

@@ -6,7 +6,7 @@ import {
 } from "./chunk-SFQ6QNL7.js";
 import {
   StorageManager
-} from "./chunk-X74FJSW7.js";
+} from "./chunk-SFMRLXIV.js";
 import {
   buildLifecycleEventsForMemory,
   sortMemoryLifecycleEvents
@@ -74,4 +74,4 @@ export {
   backupExistingLedger,
   rebuildMemoryLifecycleLedger
 };
-//# sourceMappingURL=chunk-SEWF2O74.js.map
+//# sourceMappingURL=chunk-6W2D6FGG.js.map

package/dist/{chunk-CHM274U6.js → chunk-7TAQEPLE.js}

@@ -4,7 +4,7 @@ import {
 import {
   compareEntityTimestamps,
   normalizeEntityName
-} from "./chunk-X74FJSW7.js";
+} from "./chunk-SFMRLXIV.js";
 import {
   sanitizeMemoryContent
 } from "./chunk-FVQJYWH7.js";
@@ -679,4 +679,4 @@ export {
   entityIndexVersion,
   entityRecentTranscriptLookbackHours
 };
-//# sourceMappingURL=chunk-CHM274U6.js.map
+//# sourceMappingURL=chunk-7TAQEPLE.js.map

package/dist/{chunk-G5PKTQ5J.js → chunk-DEDQXIDL.js}

@@ -1,6 +1,6 @@
 import {
   NamespaceStorageRouter
-} from "./chunk-PQG4T5V3.js";
+} from "./chunk-ODTWHSY2.js";
 import {
   namespaceCollectionName
 } from "./chunk-VPAFWWCL.js";
@@ -204,4 +204,4 @@ export {
   verifyNamespaces,
   runNamespaceMigration
 };
-//# sourceMappingURL=chunk-G5PKTQ5J.js.map
+//# sourceMappingURL=chunk-DEDQXIDL.js.map

package/dist/{chunk-3E5WRQNQ.js → chunk-FUCJAZ25.js}

@@ -60,7 +60,7 @@ import {
   listMemoryGovernanceRuns,
   readMemoryGovernanceRunArtifact,
   runMemoryGovernance
-} from "./chunk-RJ2THZ4H.js";
+} from "./chunk-TFVVONWD.js";
 import {
   namespaceCollectionName
 } from "./chunk-VPAFWWCL.js";
@@ -103,10 +103,10 @@ import {
   buildBriefing,
   parseBriefingFocus,
   parseBriefingWindow
-} from "./chunk-6JDGADXK.js";
+} from "./chunk-HF4N43Q7.js";
 import {
   parseEntityFile
-} from "./chunk-X74FJSW7.js";
+} from "./chunk-SFMRLXIV.js";
 import {
   stripAttributesSuffix
 } from "./chunk-SVOZFLIQ.js";
@@ -7743,4 +7743,4 @@ export {
   shapeMemorySummary,
   EngramAccessService
 };
-//# sourceMappingURL=chunk-3E5WRQNQ.js.map
+//# sourceMappingURL=chunk-FUCJAZ25.js.map

package/dist/{chunk-6JDGADXK.js → chunk-HF4N43Q7.js}

@@ -1,7 +1,7 @@
 import {
   StorageManager,
   normalizeEntityName
-} from "./chunk-X74FJSW7.js";
+} from "./chunk-SFMRLXIV.js";
 import {
   extractJsonCandidates
 } from "./chunk-RGMVMVMF.js";
@@ -870,4 +870,4 @@ export {
   resolveBriefingSaveDir,
   briefingFilename
 };
-//# sourceMappingURL=chunk-6JDGADXK.js.map
+//# sourceMappingURL=chunk-HF4N43Q7.js.map

package/dist/{chunk-NHBEO3F3.js → chunk-HXHKLVAS.js}

@@ -47,12 +47,12 @@ import {
 } from "./chunk-D6RIFG4O.js";
 import {
   rebuildMemoryLifecycleLedger
-} from "./chunk-SEWF2O74.js";
+} from "./chunk-6W2D6FGG.js";
 import {
   rebuildMemoryProjection,
   repairMemoryProjection,
   verifyMemoryProjection
-} from "./chunk-GYVVQYA3.js";
+} from "./chunk-27LQPUMZ.js";
 import {
   rebuildObservations
 } from "./chunk-LZZNTPLR.js";
@@ -74,7 +74,7 @@ import {
 } from "./chunk-IQ7WCZRW.js";
 import {
   promoteSemanticRuleFromMemory
-} from "./chunk-HDLC75NX.js";
+} from "./chunk-IYOPIG3E.js";
 import {
   resolveAgentAccessAuthToken
 } from "./chunk-TGQ2NTWH.js";
@@ -102,12 +102,12 @@ import {
   runOperatorInventory,
   runOperatorRepair,
   runOperatorSetup
-} from "./chunk-33L6XHU2.js";
+} from "./chunk-ZYNMX6IU.js";
 import {
   listNamespaces,
   runNamespaceMigration,
   verifyNamespaces
-} from "./chunk-G5PKTQ5J.js";
+} from "./chunk-DEDQXIDL.js";
 import {
   GraphDashboardServer
 } from "./chunk-YNDLCWXS.js";
@@ -120,7 +120,7 @@ import {
 } from "./chunk-WIWPSQYU.js";
 import {
   searchVerifiedEpisodes
-} from "./chunk-O54DY26V.js";
+} from "./chunk-XTIRCSIH.js";
 import {
   getUtilityLearningStatus,
   learnUtilityPromotionWeights
@@ -134,7 +134,7 @@ import {
 } from "./chunk-QRDOSYOR.js";
 import {
   searchVerifiedSemanticRules
-} from "./chunk-JKW5XSWC.js";
+} from "./chunk-QP37KL5H.js";
 import {
   getWorkProductLedgerStatus,
   recordWorkProductLedgerEntry,
@@ -149,7 +149,7 @@ import {
 } from "./chunk-33JBK2XP.js";
 import {
   formatNamespaceMaintenanceHealthText
-} from "./chunk-XY4WJTEX.js";
+} from "./chunk-WFEZUGU5.js";
 import {
   analyzeSessionIntegrity,
   applySessionRepair,
@@ -219,16 +219,16 @@ import {
 } from "./chunk-OADWQ5CR.js";
 import {
   EngramAccessHttpServer
-} from "./chunk-CCOXIDRM.js";
+} from "./chunk-KF4TXW7Z.js";
 import {
   WearablesInputError
 } from "./chunk-7WV3F5DQ.js";
 import {
   EngramMcpServer
-} from "./chunk-YMTGXDN6.js";
+} from "./chunk-OLOYQZFB.js";
 import {
   EngramAccessService
-} from "./chunk-3E5WRQNQ.js";
+} from "./chunk-FUCJAZ25.js";
 import {
   WorkStorage
 } from "./chunk-GDB4J2H3.js";
@@ -250,7 +250,7 @@ import {
   readMemoryGovernanceRunArtifact,
   restoreMemoryGovernanceRun,
   runMemoryGovernance
-} from "./chunk-RJ2THZ4H.js";
+} from "./chunk-TFVVONWD.js";
 import {
   analyzeGraphHealth
 } from "./chunk-KF74X62T.js";
@@ -3077,7 +3077,7 @@ function registerCli(api, orchestrator, registerOptions = {}) {
         const idArg = typeof args[0] === "string" ? args[0] : "";
         const options = args[1] ?? {};
         const reason = typeof options.reason === "string" && options.reason.trim().length > 0 ? options.reason.trim() : void 0;
-        const { forgetMemory } = await import("./forget-BEXG5PQC.js");
+        const { forgetMemory } = await import("./forget-6SOIPUMQ.js");
         try {
           const result = await forgetMemory(orchestrator.storage, {
             id: idArg,
@@ -7328,4 +7328,4 @@ export {
   listMemoryMarkdownFilePaths,
   registerCli
 };
-//# sourceMappingURL=chunk-NHBEO3F3.js.map
+//# sourceMappingURL=chunk-HXHKLVAS.js.map

package/dist/{chunk-RC3CNIPK.js → chunk-IO5NQEGZ.js}

@@ -2,7 +2,7 @@ import {
   readSummarySnapshot,
   upsertSummarySnapshot,
   writeSummarySnapshot
-} from "./chunk-XJNBEDFE.js";
+} from "./chunk-3FAMU5TX.js";
 import {
   ModelRegistry
 } from "./chunk-PWFWCGOO.js";
@@ -686,4 +686,4 @@ ${truncatedConversation}`;
 export {
   HourlySummarizer
 };
-//# sourceMappingURL=chunk-RC3CNIPK.js.map
+//# sourceMappingURL=chunk-IO5NQEGZ.js.map