@remnic/core 9.69.86 → 9.69.88

package/dist/{chunk-B47OHVFT.js → chunk-5E6RYRYW.js}

@@ -1,6 +1,6 @@
 import {
   runGraphEdgeDecayMaintenanceAcrossNamespaces
-} from "./chunk-2UPTRDGM.js";
+} from "./chunk-SCXURCVT.js";
 import {
   normalizeDreamsStatusWindowHours
 } from "./chunk-EQWEIIKQ.js";
@@ -8,7 +8,7 @@ import {
   executeResolution,
   isValidResolutionVerb,
   runPreferenceDriftScan
-} from "./chunk-VTPASHTO.js";
+} from "./chunk-R3X2T2LP.js";
 import {
   getRecallTimingStatus,
   isRecallTimingsOperator
@@ -21,13 +21,13 @@ import {
   defineOperation,
   parseNamespacePreflightWriteOp,
   resolveAuthorizedNamespaceWritablePreflight
-} from "./chunk-SVZWVZ7E.js";
+} from "./chunk-QB57WIS6.js";
 import {
   parseSharedWriteOutputControls
 } from "./chunk-IFBSZGW3.js";
 import {
   validateBriefingFormat
-} from "./chunk-7UUKRS3J.js";
+} from "./chunk-JVPWRNHA.js";
 import {
   parseDeepRecallMaxSteps
 } from "./chunk-A7AISUJI.js";
@@ -36,14 +36,14 @@ import {
   recallRequestSchema,
   retainedCategoryAlias,
   suggestionSubmitRequestSchema
-} from "./chunk-IBGEHKQ6.js";
+} from "./chunk-LW3HKRL7.js";
 import {
   enforceNamespaceAllowList,
   tokenCapabilityStore
 } from "./chunk-IG747LRN.js";
 import {
   runContradictionScan
-} from "./chunk-DINRT75P.js";
+} from "./chunk-YSBL7VPO.js";
 import {
   isDefaultReviewNamespace,
   listPairs,
@@ -603,4 +603,4 @@ defineOperation({ name: "graph_events", description: "SSE graph events.", schema
 defineOperation({ name: "chat_message", description: "Chat message.", schema: strictSchema({ message: S.str, chatSessionId: S.str }), handler: async (_i, _ctx) => ({ result: { ok: true } }) });
 defineOperation({ name: "chat_events", description: "SSE chat events.", schema: strictSchema({}), handler: async (_i, _ctx) => ({ result: { stream: "sse" } }) });
 defineOperation({ name: "adapters_status", description: "Adapter registry metadata (issue #1850 round 5). Marker op: the HTTP transport builds the response from its own adapterRegistry, but the op still must be registered so it appears in listRegisteredOperations and enforceTokenOp can gate it for scoped tokens.", schema: strictSchema({}), handler: async (_i, _ctx) => ({ result: { ok: true } }) });
-//# sourceMappingURL=chunk-B47OHVFT.js.map
+//# sourceMappingURL=chunk-5E6RYRYW.js.map

package/dist/{chunk-2U3R3DDH.js → chunk-5FAGCOZD.js}

@@ -1,22 +1,22 @@
-import {
-  ActivationPathTracker,
-  compareActivationPathCandidates,
-  reconstructActivationPath
-} from "./chunk-LXY5VVGM.js";
 import {
   assertGraphLockHeld,
   withGraphWriteLock,
   yieldForLockHeartbeat
 } from "./chunk-EUT2WCWS.js";
-import {
-  GraphEdgeAppendError
-} from "./chunk-GKCXTSFF.js";
 import {
   readEdgeConfidence
 } from "./chunk-2LSZVONP.js";
 import {
   emitGraphEvent
 } from "./chunk-DEUNUKTD.js";
+import {
+  ActivationPathTracker,
+  compareActivationPathCandidates,
+  reconstructActivationPath
+} from "./chunk-LXY5VVGM.js";
+import {
+  GraphEdgeAppendError
+} from "./chunk-GKCXTSFF.js";
 import {
   isErrnoCode
 } from "./chunk-KNA3BXXL.js";
@@ -758,4 +758,4 @@ export {
   applyPageRankRefinement,
   applyLateralInhibition
 };
-//# sourceMappingURL=chunk-2U3R3DDH.js.map
+//# sourceMappingURL=chunk-5FAGCOZD.js.map

package/dist/{chunk-CRKWSSS4.js → chunk-5MNUBT7T.js}

@@ -1,6 +1,6 @@
 import {
   listNamespaces
-} from "./chunk-DGAWEJVI.js";
+} from "./chunk-2DLWLNO4.js";
 import {
   capabilityAllowsNamespace
 } from "./chunk-IG747LRN.js";
@@ -282,4 +282,4 @@ export {
   computeServiceCorpusWatermarks,
   computeServiceCorpusCensus
 };
-//# sourceMappingURL=chunk-CRKWSSS4.js.map
+//# sourceMappingURL=chunk-5MNUBT7T.js.map

package/dist/{chunk-CK5KOVHW.js → chunk-5R627MYY.js}

@@ -50,7 +50,8 @@ async function respondOfflineSnapshotStream(response, snapshot, requestId) {
     createdAt: snapshot.createdAt,
     sourceId: snapshot.sourceId,
     includeTranscripts: snapshot.includeTranscripts,
-    deletions: snapshot.deletions
+    deletions: snapshot.deletions,
+    ...snapshot.omittedEmbeddingGenerationDirs ? { omittedEmbeddingGenerationDirs: snapshot.omittedEmbeddingGenerationDirs } : {}
   }, snapshot.files, requestId);
 }
 async function respondOfflineManifestStream(response, manifest, requestId) {
@@ -66,4 +67,4 @@ export {
   respondOfflineSnapshotStream,
   respondOfflineManifestStream
 };
-//# sourceMappingURL=chunk-CK5KOVHW.js.map
+//# sourceMappingURL=chunk-5R627MYY.js.map

package/dist/{chunk-CK5KOVHW.js.map → chunk-5R627MYY.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/access-http-offline-stream.ts"],"sourcesContent":["import type { ServerResponse } from \"node:http\";\nimport type { OfflineSyncManifestStreamResponse } from \"./access-offline-manifest.js\";\nimport type { EngramAccessOfflineSyncSnapshotStreamResponse } from \"./access-service.js\";\n\nasync function respondOfflineNdjsonStream(\n  response: ServerResponse,\n  header: unknown,\n  files: AsyncIterable<unknown>,\n  requestId?: string,\n): Promise<void> {\n  response.statusCode = 200;\n  response.setHeader(\"content-type\", \"application/x-ndjson; charset=utf-8\");\n  response.setHeader(\"cache-control\", \"no-store\");\n  if (requestId) response.setHeader(\"x-request-id\", requestId);\n  const waitForDrainOrClose = async (): Promise<boolean> => {\n    const { promise, resolve, reject } = Promise.withResolvers<boolean>();\n    const cleanup = () => {\n      response.off(\"drain\", onDrain);\n      response.off(\"close\", onClose);\n      response.off(\"error\", onError);\n    };\n    const onDrain = () => {\n      cleanup();\n      resolve(true);\n    };\n    const onClose = () => {\n      cleanup();\n      resolve(false);\n    };\n    const onError = (error: Error) => {\n      cleanup();\n      reject(error);\n    };\n    response.once(\"drain\", onDrain);\n    response.once(\"close\", onClose);\n    response.once(\"error\", onError);\n    return promise;\n  };\n  const writeLine = async (payload: unknown): Promise<boolean> => {\n    if (response.destroyed || response.writableEnded) return false;\n    if (response.write(`${JSON.stringify(payload)}\\n`)) return true;\n    if (response.destroyed || response.writableEnded) return false;\n    return waitForDrainOrClose();\n  };\n  if (!await writeLine(header)) return;\n  for await (const file of files) {\n    if (!await writeLine({ type: \"file\", file })) return;\n  }\n  if (!response.destroyed && !response.writableEnded) response.end();\n}\n\nexport async function respondOfflineSnapshotStream(\n  response: ServerResponse,\n  snapshot: EngramAccessOfflineSyncSnapshotStreamResponse,\n  requestId?: string,\n): Promise<void> {\n  await respondOfflineNdjsonStream(response, {\n    type: \"snapshot\",\n    namespace: snapshot.namespace,\n    format: snapshot.format,\n    schemaVersion: snapshot.schemaVersion,\n    createdAt: snapshot.createdAt,\n    sourceId: snapshot.sourceId,\n    includeTranscripts: snapshot.includeTranscripts,\n    deletions: snapshot.deletions,\n  }, snapshot.files, requestId);\n}\n\nexport async function respondOfflineManifestStream(\n  response: ServerResponse,\n  manifest: OfflineSyncManifestStreamResponse,\n  requestId?: string,\n): Promise<void> {\n  await respondOfflineNdjsonStream(response, {\n    type: \"manifest\",\n    namespace: manifest.namespace,\n    format: manifest.format,\n    schemaVersion: manifest.schemaVersion,\n  }, manifest.files, requestId);\n}\n"],"mappings":";AAIA,eAAe,2BACb,UACA,QACA,OACA,WACe;AACf,WAAS,aAAa;AACtB,WAAS,UAAU,gBAAgB,qCAAqC;AACxE,WAAS,UAAU,iBAAiB,UAAU;AAC9C,MAAI,UAAW,UAAS,UAAU,gBAAgB,SAAS;AAC3D,QAAM,sBAAsB,YAA8B;AACxD,UAAM,EAAE,SAAS,SAAS,OAAO,IAAI,QAAQ,cAAuB;AACpE,UAAM,UAAU,MAAM;AACpB,eAAS,IAAI,SAAS,OAAO;AAC7B,eAAS,IAAI,SAAS,OAAO;AAC7B,eAAS,IAAI,SAAS,OAAO;AAAA,IAC/B;AACA,UAAM,UAAU,MAAM;AACpB,cAAQ;AACR,cAAQ,IAAI;AAAA,IACd;AACA,UAAM,UAAU,MAAM;AACpB,cAAQ;AACR,cAAQ,KAAK;AAAA,IACf;AACA,UAAM,UAAU,CAAC,UAAiB;AAChC,cAAQ;AACR,aAAO,KAAK;AAAA,IACd;AACA,aAAS,KAAK,SAAS,OAAO;AAC9B,aAAS,KAAK,SAAS,OAAO;AAC9B,aAAS,KAAK,SAAS,OAAO;AAC9B,WAAO;AAAA,EACT;AACA,QAAM,YAAY,OAAO,YAAuC;AAC9D,QAAI,SAAS,aAAa,SAAS,cAAe,QAAO;AACzD,QAAI,SAAS,MAAM,GAAG,KAAK,UAAU,OAAO,CAAC;AAAA,CAAI,EAAG,QAAO;AAC3D,QAAI,SAAS,aAAa,SAAS,cAAe,QAAO;AACzD,WAAO,oBAAoB;AAAA,EAC7B;AACA,MAAI,CAAC,MAAM,UAAU,MAAM,EAAG;AAC9B,mBAAiB,QAAQ,OAAO;AAC9B,QAAI,CAAC,MAAM,UAAU,EAAE,MAAM,QAAQ,KAAK,CAAC,EAAG;AAAA,EAChD;AACA,MAAI,CAAC,SAAS,aAAa,CAAC,SAAS,cAAe,UAAS,IAAI;AACnE;AAEA,eAAsB,6BACpB,UACA,UACA,WACe;AACf,QAAM,2BAA2B,UAAU;AAAA,IACzC,MAAM;AAAA,IACN,WAAW,SAAS;AAAA,IACpB,QAAQ,SAAS;AAAA,IACjB,eAAe,SAAS;AAAA,IACxB,WAAW,SAAS;AAAA,IACpB,UAAU,SAAS;AAAA,IACnB,oBAAoB,SAAS;AAAA,IAC7B,WAAW,SAAS;AAAA,EACtB,GAAG,SAAS,OAAO,SAAS;AAC9B;AAEA,eAAsB,6BACpB,UACA,UACA,WACe;AACf,QAAM,2BAA2B,UAAU;AAAA,IACzC,MAAM;AAAA,IACN,WAAW,SAAS;AAAA,IACpB,QAAQ,SAAS;AAAA,IACjB,eAAe,SAAS;AAAA,EAC1B,GAAG,SAAS,OAAO,SAAS;AAC9B;","names":[]}
+{"version":3,"sources":["../src/access-http-offline-stream.ts"],"sourcesContent":["import type { ServerResponse } from \"node:http\";\nimport type { OfflineSyncManifestStreamResponse } from \"./access-offline-manifest.js\";\nimport type { EngramAccessOfflineSyncSnapshotStreamResponse } from \"./access-service.js\";\n\nasync function respondOfflineNdjsonStream(\n  response: ServerResponse,\n  header: unknown,\n  files: AsyncIterable<unknown>,\n  requestId?: string,\n): Promise<void> {\n  response.statusCode = 200;\n  response.setHeader(\"content-type\", \"application/x-ndjson; charset=utf-8\");\n  response.setHeader(\"cache-control\", \"no-store\");\n  if (requestId) response.setHeader(\"x-request-id\", requestId);\n  const waitForDrainOrClose = async (): Promise<boolean> => {\n    const { promise, resolve, reject } = Promise.withResolvers<boolean>();\n    const cleanup = () => {\n      response.off(\"drain\", onDrain);\n      response.off(\"close\", onClose);\n      response.off(\"error\", onError);\n    };\n    const onDrain = () => {\n      cleanup();\n      resolve(true);\n    };\n    const onClose = () => {\n      cleanup();\n      resolve(false);\n    };\n    const onError = (error: Error) => {\n      cleanup();\n      reject(error);\n    };\n    response.once(\"drain\", onDrain);\n    response.once(\"close\", onClose);\n    response.once(\"error\", onError);\n    return promise;\n  };\n  const writeLine = async (payload: unknown): Promise<boolean> => {\n    if (response.destroyed || response.writableEnded) return false;\n    if (response.write(`${JSON.stringify(payload)}\\n`)) return true;\n    if (response.destroyed || response.writableEnded) return false;\n    return waitForDrainOrClose();\n  };\n  if (!await writeLine(header)) return;\n  for await (const file of files) {\n    if (!await writeLine({ type: \"file\", file })) return;\n  }\n  if (!response.destroyed && !response.writableEnded) response.end();\n}\n\nexport async function respondOfflineSnapshotStream(\n  response: ServerResponse,\n  snapshot: EngramAccessOfflineSyncSnapshotStreamResponse,\n  requestId?: string,\n): Promise<void> {\n  await respondOfflineNdjsonStream(response, {\n    type: \"snapshot\",\n    namespace: snapshot.namespace,\n    format: snapshot.format,\n    schemaVersion: snapshot.schemaVersion,\n    createdAt: snapshot.createdAt,\n    sourceId: snapshot.sourceId,\n    includeTranscripts: snapshot.includeTranscripts,\n    deletions: snapshot.deletions,\n    ...(snapshot.omittedEmbeddingGenerationDirs\n      ? { omittedEmbeddingGenerationDirs: snapshot.omittedEmbeddingGenerationDirs }\n      : {}),\n  }, snapshot.files, requestId);\n}\n\nexport async function respondOfflineManifestStream(\n  response: ServerResponse,\n  manifest: OfflineSyncManifestStreamResponse,\n  requestId?: string,\n): Promise<void> {\n  await respondOfflineNdjsonStream(response, {\n    type: \"manifest\",\n    namespace: manifest.namespace,\n    format: manifest.format,\n    schemaVersion: manifest.schemaVersion,\n  }, manifest.files, requestId);\n}\n"],"mappings":";AAIA,eAAe,2BACb,UACA,QACA,OACA,WACe;AACf,WAAS,aAAa;AACtB,WAAS,UAAU,gBAAgB,qCAAqC;AACxE,WAAS,UAAU,iBAAiB,UAAU;AAC9C,MAAI,UAAW,UAAS,UAAU,gBAAgB,SAAS;AAC3D,QAAM,sBAAsB,YAA8B;AACxD,UAAM,EAAE,SAAS,SAAS,OAAO,IAAI,QAAQ,cAAuB;AACpE,UAAM,UAAU,MAAM;AACpB,eAAS,IAAI,SAAS,OAAO;AAC7B,eAAS,IAAI,SAAS,OAAO;AAC7B,eAAS,IAAI,SAAS,OAAO;AAAA,IAC/B;AACA,UAAM,UAAU,MAAM;AACpB,cAAQ;AACR,cAAQ,IAAI;AAAA,IACd;AACA,UAAM,UAAU,MAAM;AACpB,cAAQ;AACR,cAAQ,KAAK;AAAA,IACf;AACA,UAAM,UAAU,CAAC,UAAiB;AAChC,cAAQ;AACR,aAAO,KAAK;AAAA,IACd;AACA,aAAS,KAAK,SAAS,OAAO;AAC9B,aAAS,KAAK,SAAS,OAAO;AAC9B,aAAS,KAAK,SAAS,OAAO;AAC9B,WAAO;AAAA,EACT;AACA,QAAM,YAAY,OAAO,YAAuC;AAC9D,QAAI,SAAS,aAAa,SAAS,cAAe,QAAO;AACzD,QAAI,SAAS,MAAM,GAAG,KAAK,UAAU,OAAO,CAAC;AAAA,CAAI,EAAG,QAAO;AAC3D,QAAI,SAAS,aAAa,SAAS,cAAe,QAAO;AACzD,WAAO,oBAAoB;AAAA,EAC7B;AACA,MAAI,CAAC,MAAM,UAAU,MAAM,EAAG;AAC9B,mBAAiB,QAAQ,OAAO;AAC9B,QAAI,CAAC,MAAM,UAAU,EAAE,MAAM,QAAQ,KAAK,CAAC,EAAG;AAAA,EAChD;AACA,MAAI,CAAC,SAAS,aAAa,CAAC,SAAS,cAAe,UAAS,IAAI;AACnE;AAEA,eAAsB,6BACpB,UACA,UACA,WACe;AACf,QAAM,2BAA2B,UAAU;AAAA,IACzC,MAAM;AAAA,IACN,WAAW,SAAS;AAAA,IACpB,QAAQ,SAAS;AAAA,IACjB,eAAe,SAAS;AAAA,IACxB,WAAW,SAAS;AAAA,IACpB,UAAU,SAAS;AAAA,IACnB,oBAAoB,SAAS;AAAA,IAC7B,WAAW,SAAS;AAAA,IACpB,GAAI,SAAS,iCACT,EAAE,gCAAgC,SAAS,+BAA+B,IAC1E,CAAC;AAAA,EACP,GAAG,SAAS,OAAO,SAAS;AAC9B;AAEA,eAAsB,6BACpB,UACA,UACA,WACe;AACf,QAAM,2BAA2B,UAAU;AAAA,IACzC,MAAM;AAAA,IACN,WAAW,SAAS;AAAA,IACpB,QAAQ,SAAS;AAAA,IACjB,eAAe,SAAS;AAAA,EAC1B,GAAG,SAAS,OAAO,SAAS;AAC9B;","names":[]}

package/dist/chunk-5X4MXNEU.js

@@ -0,0 +1,64 @@
+import {
+  OFFLINE_SYNC_SNAPSHOT_FORMAT,
+  filterOfflineSyncDeletionRevisions,
+  iterateOfflineSyncSnapshotFileRecords
+} from "./chunk-OCFXVDBZ.js";
+import {
+  computeOmittedEmbeddingGenerationPaths,
+  embeddingGenerationMembership
+} from "./chunk-K6T33R4Q.js";
+import {
+  matchesOfflineSyncDefaultExclude
+} from "./chunk-4NSLQ7EU.js";
+
+// src/offline-sync-snapshot-stream.ts
+import { createHash } from "crypto";
+async function buildEmbeddingAwareSnapshotStream(options) {
+  const storageHash = createHash("sha256").update(options.root).digest("hex").slice(0, 16);
+  const deletions = await filterOfflineSyncDeletionRevisions({
+    root: options.root,
+    deletions: options.deletions,
+    includeTranscripts: options.includeTranscripts,
+    userExcludeRegexps: options.userExcludeRegexps,
+    excludeFile: options.excludeFile
+  });
+  const omission = await computeOmittedEmbeddingGenerationPaths({
+    rootAbs: options.root,
+    userExcludeRegexps: options.userExcludeRegexps,
+    excludeFile: options.excludeFile,
+    // RAW pre-filter tombstones (see resolvePushEmbeddingGenerationState).
+    tombstonedPaths: options.deletions.map((deletion) => deletion.path),
+    isExcludedRelPath: (relPath) => matchesOfflineSyncDefaultExclude(relPath) || Boolean(options.userExcludeRegexps?.some((re) => re.test(relPath)))
+  });
+  const omittedDirs = new Set(omission.omittedDirs);
+  const deletionsAfterGenerationSuppression = deletions.filter((deletion) => {
+    const membership = embeddingGenerationMembership(deletion.path);
+    return !(membership && omittedDirs.has(membership.shardDir));
+  });
+  return {
+    namespace: options.namespace,
+    format: OFFLINE_SYNC_SNAPSHOT_FORMAT,
+    schemaVersion: 1,
+    createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+    sourceId: `remnic:${options.namespace}:${storageHash}`,
+    includeTranscripts: options.includeTranscripts,
+    deletions: deletionsAfterGenerationSuppression,
+    ...omission.omittedDirs.length > 0 ? { omittedEmbeddingGenerationDirs: omission.omittedDirs } : {},
+    files: iterateOfflineSyncSnapshotFileRecords({
+      root: options.root,
+      includeContent: options.includeContent,
+      includeTranscripts: options.includeTranscripts,
+      readFile: options.readFile,
+      readFileDigest: options.readFileDigest,
+      signal: options.signal,
+      userExcludeRegexps: options.userExcludeRegexps,
+      excludeFile: options.excludeFile,
+      skipEmbeddingGenerationPaths: omission.omittedPaths
+    })
+  };
+}
+
+export {
+  buildEmbeddingAwareSnapshotStream
+};
+//# sourceMappingURL=chunk-5X4MXNEU.js.map

package/dist/chunk-5X4MXNEU.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/offline-sync-snapshot-stream.ts"],"sourcesContent":["// Streaming offline-sync snapshot builder (PR #3148 round 5). Extracted from\n// access-service.ts so the god-file line-count ratchet does not grow: the\n// stream carries whole-generation omission metadata alongside the file walk,\n// so a filtered embedding generation is announced instead of looking deleted.\nimport { createHash } from \"node:crypto\";\nimport type {\n  OfflineSyncDeletionRevision,\n  OfflineSyncFileRecord,\n  OfflineSyncSnapshot,\n} from \"./offline-sync.js\";\nimport {\n  filterOfflineSyncDeletionRevisions,\n  OFFLINE_SYNC_SNAPSHOT_FORMAT,\n  iterateOfflineSyncSnapshotFileRecords,\n} from \"./offline-sync.js\";\nimport {\n  computeOmittedEmbeddingGenerationPaths,\n  embeddingGenerationMembership,\n} from \"./offline-sync-embedding-generation.js\";\nimport type { OfflineSyncExcludeFile, OfflineSyncFileTarget } from \"./offline-sync-file-io.js\";\nimport { matchesOfflineSyncDefaultExclude } from \"./offline-sync-exclude-globs.js\";\nimport type { OfflineSyncFileDigest } from \"./offline-sync.js\";\n\nexport interface OfflineSyncSnapshotStreamBuildOptions {\n  root: string;\n  namespace: string;\n  includeContent: boolean;\n  includeTranscripts: boolean;\n  userExcludeRegexps?: readonly RegExp[];\n  excludeFile: OfflineSyncExcludeFile;\n  readFile: (target: OfflineSyncFileTarget) => Promise<Buffer>;\n  readFileDigest: (target: OfflineSyncFileTarget) => Promise<OfflineSyncFileDigest>;\n  deletions: readonly OfflineSyncDeletionRevision[];\n  signal?: AbortSignal;\n}\n\nexport type OfflineSyncSnapshotStreamBuild = Omit<OfflineSyncSnapshot, \"files\"> & {\n  namespace: string;\n  files: AsyncIterable<OfflineSyncFileRecord>;\n};\n\n/**\n * Build the streamed snapshot response: whole-generation omission computed\n * with the SAME filters the walk uses and announced in the header, so the\n * receiver never interprets a filtered generation as deleted.\n */\nexport async function buildEmbeddingAwareSnapshotStream(\n  options: OfflineSyncSnapshotStreamBuildOptions,\n): Promise<OfflineSyncSnapshotStreamBuild> {\n  const storageHash = createHash(\"sha256\").update(options.root).digest(\"hex\").slice(0, 16);\n  // Deletions: the canonical filter (exclusions + stale-tombstone exists\n  // check) FIRST, then whole-generation suppression so a filtered generation\n  // is never announced as deleted (PR #3148 round 6).\n  const deletions = await filterOfflineSyncDeletionRevisions({\n    root: options.root,\n    deletions: options.deletions,\n    includeTranscripts: options.includeTranscripts,\n    userExcludeRegexps: options.userExcludeRegexps,\n    excludeFile: options.excludeFile,\n  });\n  const omission = await computeOmittedEmbeddingGenerationPaths({\n    rootAbs: options.root,\n    userExcludeRegexps: options.userExcludeRegexps,\n    excludeFile: options.excludeFile,\n    // RAW pre-filter tombstones (see resolvePushEmbeddingGenerationState).\n    tombstonedPaths: options.deletions.map((deletion) => deletion.path),\n    isExcludedRelPath: (relPath) =>\n      matchesOfflineSyncDefaultExclude(relPath) ||\n      Boolean(options.userExcludeRegexps?.some((re) => re.test(relPath))),\n  });\n  const omittedDirs = new Set(omission.omittedDirs);\n  const deletionsAfterGenerationSuppression = deletions.filter((deletion) => {\n    const membership = embeddingGenerationMembership(deletion.path);\n    return !(membership && omittedDirs.has(membership.shardDir));\n  });\n  return {\n    namespace: options.namespace,\n    format: OFFLINE_SYNC_SNAPSHOT_FORMAT,\n    schemaVersion: 1,\n    createdAt: new Date().toISOString(),\n    sourceId: `remnic:${options.namespace}:${storageHash}`,\n    includeTranscripts: options.includeTranscripts,\n    deletions: deletionsAfterGenerationSuppression,\n    ...(omission.omittedDirs.length > 0\n      ? { omittedEmbeddingGenerationDirs: omission.omittedDirs }\n      : {}),\n    files: iterateOfflineSyncSnapshotFileRecords({\n      root: options.root,\n      includeContent: options.includeContent,\n      includeTranscripts: options.includeTranscripts,\n      readFile: options.readFile,\n      readFileDigest: options.readFileDigest,\n      signal: options.signal,\n      userExcludeRegexps: options.userExcludeRegexps,\n      excludeFile: options.excludeFile,\n      skipEmbeddingGenerationPaths: omission.omittedPaths,\n    }),\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;AAIA,SAAS,kBAAkB;AA0C3B,eAAsB,kCACpB,SACyC;AACzC,QAAM,cAAc,WAAW,QAAQ,EAAE,OAAO,QAAQ,IAAI,EAAE,OAAO,KAAK,EAAE,MAAM,GAAG,EAAE;AAIvF,QAAM,YAAY,MAAM,mCAAmC;AAAA,IACzD,MAAM,QAAQ;AAAA,IACd,WAAW,QAAQ;AAAA,IACnB,oBAAoB,QAAQ;AAAA,IAC5B,oBAAoB,QAAQ;AAAA,IAC5B,aAAa,QAAQ;AAAA,EACvB,CAAC;AACD,QAAM,WAAW,MAAM,uCAAuC;AAAA,IAC5D,SAAS,QAAQ;AAAA,IACjB,oBAAoB,QAAQ;AAAA,IAC5B,aAAa,QAAQ;AAAA;AAAA,IAErB,iBAAiB,QAAQ,UAAU,IAAI,CAAC,aAAa,SAAS,IAAI;AAAA,IAClE,mBAAmB,CAAC,YAClB,iCAAiC,OAAO,KACxC,QAAQ,QAAQ,oBAAoB,KAAK,CAAC,OAAO,GAAG,KAAK,OAAO,CAAC,CAAC;AAAA,EACtE,CAAC;AACD,QAAM,cAAc,IAAI,IAAI,SAAS,WAAW;AAChD,QAAM,sCAAsC,UAAU,OAAO,CAAC,aAAa;AACzE,UAAM,aAAa,8BAA8B,SAAS,IAAI;AAC9D,WAAO,EAAE,cAAc,YAAY,IAAI,WAAW,QAAQ;AAAA,EAC5D,CAAC;AACD,SAAO;AAAA,IACL,WAAW,QAAQ;AAAA,IACnB,QAAQ;AAAA,IACR,eAAe;AAAA,IACf,YAAW,oBAAI,KAAK,GAAE,YAAY;AAAA,IAClC,UAAU,UAAU,QAAQ,SAAS,IAAI,WAAW;AAAA,IACpD,oBAAoB,QAAQ;AAAA,IAC5B,WAAW;AAAA,IACX,GAAI,SAAS,YAAY,SAAS,IAC9B,EAAE,gCAAgC,SAAS,YAAY,IACvD,CAAC;AAAA,IACL,OAAO,sCAAsC;AAAA,MAC3C,MAAM,QAAQ;AAAA,MACd,gBAAgB,QAAQ;AAAA,MACxB,oBAAoB,QAAQ;AAAA,MAC5B,UAAU,QAAQ;AAAA,MAClB,gBAAgB,QAAQ;AAAA,MACxB,QAAQ,QAAQ;AAAA,MAChB,oBAAoB,QAAQ;AAAA,MAC5B,aAAa,QAAQ;AAAA,MACrB,8BAA8B,SAAS;AAAA,IACzC,CAAC;AAAA,EACH;AACF;","names":[]}

package/dist/{chunk-52II7PB6.js → chunk-645WOU5I.js}

@@ -1,12 +1,12 @@
+import {
+  shouldRecallEventOrderEvidence
+} from "./chunk-BUYVPUEM.js";
 import {
   unifiedDedupeAndRank
 } from "./chunk-LUPVCGYK.js";
 import {
   buildEvidencePack
 } from "./chunk-DGFU5MSX.js";
-import {
-  shouldRecallEventOrderEvidence
-} from "./chunk-BUYVPUEM.js";
 import {
   lcmEvidenceIdentity
 } from "./chunk-C37ZRXX7.js";
@@ -2236,4 +2236,4 @@ var NUMBER_WORD_VALUES = {
 export {
   buildEventOrderRecallSection
 };
-//# sourceMappingURL=chunk-52II7PB6.js.map
+//# sourceMappingURL=chunk-645WOU5I.js.map

package/dist/{chunk-7G6WUOLB.js → chunk-66DKTOBY.js}

@@ -3,7 +3,7 @@ import {
   isArtifactMemoryPath,
   isLocationDayPath,
   isMeetingRecordPath
-} from "./chunk-I4G4UWQA.js";
+} from "./chunk-QI2E6ISQ.js";
 import {
   isExternalWikiCollectionName
 } from "./chunk-JV3C2MNQ.js";
@@ -211,4 +211,4 @@ export {
   isGenericRecallExcludedPath,
   filterRecallCandidates
 };
-//# sourceMappingURL=chunk-7G6WUOLB.js.map
+//# sourceMappingURL=chunk-66DKTOBY.js.map

package/dist/{chunk-AZ2X5LNA.js → chunk-6LYAEM54.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-DBB5JPSL.js";
 import {
   isGenericRecallExcludedPath
-} from "./chunk-7G6WUOLB.js";
+} from "./chunk-66DKTOBY.js";
 import {
   isChangeOrientedQuery
 } from "./chunk-EH3HNCAM.js";
@@ -69,4 +69,4 @@ export {
   filterRecentScanMemoriesForStateView,
   indexStateViewAnnotatedResults
 };
-//# sourceMappingURL=chunk-AZ2X5LNA.js.map
+//# sourceMappingURL=chunk-6LYAEM54.js.map

package/dist/{chunk-DUJYRVUD.js → chunk-6O2VUWV6.js}

@@ -12,7 +12,7 @@ import {
 import {
   CONTENT_HASH_INDEX_RETRY_MAX_DELAY_MS,
   ContentHashIndex
-} from "./chunk-NB3LRY4T.js";
+} from "./chunk-N4PYB235.js";
 import {
   withHeldFileLock
 } from "./chunk-FFAZ2XFU.js";
@@ -22,7 +22,7 @@ import {
 import {
   readMaybeEncryptedFileFromChunks,
   writeMaybeEncryptedFileFromChunks
-} from "./chunk-JN72EPOE.js";
+} from "./chunk-MAAL6OZV.js";
 import {
   RECALL_FALLBACK_DIRS
 } from "./chunk-VS2IYZRU.js";
@@ -2509,4 +2509,4 @@ export {
   parseTombstoneBlockedOfflineSyncMemory,
   TombstoneBlockedCaptureIndexHost
 };
-//# sourceMappingURL=chunk-DUJYRVUD.js.map
+//# sourceMappingURL=chunk-6O2VUWV6.js.map

package/dist/{chunk-IMAP236M.js → chunk-6UQFJULG.js}

@@ -1,6 +1,6 @@
 import {
   parseEntityFile
-} from "./chunk-S55WTPFJ.js";
+} from "./chunk-STEOT4DI.js";
 import {
   inferMemoryStatus
 } from "./chunk-7RJUVTVF.js";
@@ -253,4 +253,4 @@ export {
   WHO_KNOWS_MCP_TOOLS,
   handleWhoKnowsHttpQuery
 };
-//# sourceMappingURL=chunk-IMAP236M.js.map
+//# sourceMappingURL=chunk-6UQFJULG.js.map

package/dist/chunk-75PT4N7Q.js

@@ -0,0 +1,75 @@
+import {
+  serializeMutations,
+  withHeldFileLock
+} from "./chunk-FFAZ2XFU.js";
+
+// src/embedding-generation-lock.ts
+import path from "path";
+var LOCK_STALE_MS = 3e4;
+var LOCK_MAX_WAIT_MS = 1e4;
+var EmbeddingGenerationLockLostError = class extends Error {
+  constructor(lockPath) {
+    super(
+      `embedding generation: the mutation lock for ${lockPath} was lost mid-section \u2014 a peer stale-broke and replaced it; aborting instead of clobbering the peer's write`
+    );
+    this.name = "EmbeddingGenerationLockLostError";
+  }
+};
+var EmbeddingGenerationLockUnavailableError = class extends Error {
+  constructor(lockPath, reason) {
+    super(`embedding generation: could not acquire the mutation lock for ${lockPath} (${reason})`);
+    this.name = "EmbeddingGenerationLockUnavailableError";
+  }
+};
+function embeddingGenerationLockPath(absoluteStateDir) {
+  const stateDir = path.resolve(absoluteStateDir);
+  return path.join(stateDir, ".offline-sync", "locks", "embedding-generation.lock");
+}
+async function assertEmbeddingGenerationLockHeld(lockPath, section) {
+  if (!await section.refresh()) throw new EmbeddingGenerationLockLostError(lockPath);
+}
+function withEmbeddingGenerationLock(absoluteStateDir, fn) {
+  const lockPath = embeddingGenerationLockPath(absoluteStateDir);
+  return serializeMutations(
+    lockPath,
+    () => withHeldFileLock(lockPath, { staleMs: LOCK_STALE_MS, maxWaitMs: LOCK_MAX_WAIT_MS }, (acquired, lock) => {
+      if (!acquired) {
+        throw new EmbeddingGenerationLockUnavailableError(lockPath, lock.failure ?? "error");
+      }
+      return fn(lock);
+    })
+  );
+}
+async function* withEmbeddingGenerationLockIter(absoluteStateDir, make, includeContent, verify) {
+  const lockPath = embeddingGenerationLockPath(absoluteStateDir);
+  const baseline = await withEmbeddingGenerationLock(absoluteStateDir, async (section) => {
+    await verify?.();
+    const records = [];
+    for await (const record of make(false)) {
+      await assertEmbeddingGenerationLockHeld(lockPath, section);
+      records.push({ path: record.path, sha256: record.sha256, bytes: record.bytes });
+    }
+    return records;
+  });
+  let count = 0;
+  for await (const record of make(includeContent)) {
+    const expected = baseline[count++];
+    if (!expected || expected.path !== record.path || expected.sha256 !== record.sha256 || expected.bytes !== record.bytes) {
+      throw new Error(`embedding generation changed while streaming ${absoluteStateDir}; retry the snapshot`);
+    }
+    yield record;
+  }
+  if (count !== baseline.length) {
+    throw new Error(`embedding generation changed while streaming ${absoluteStateDir}; retry the snapshot`);
+  }
+}
+
+export {
+  EmbeddingGenerationLockLostError,
+  EmbeddingGenerationLockUnavailableError,
+  embeddingGenerationLockPath,
+  assertEmbeddingGenerationLockHeld,
+  withEmbeddingGenerationLock,
+  withEmbeddingGenerationLockIter
+};
+//# sourceMappingURL=chunk-75PT4N7Q.js.map

package/dist/chunk-75PT4N7Q.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/embedding-generation-lock.ts"],"sourcesContent":["// Cross-process embedding-generation mutation lock (issue #3148, Codex P1).\n//\n// Two processes legitimately mutate the SAME embedding generation: the\n// daemon's EmbeddingFallback index mutations (load → modify → persist) and\n// the offline-sync apply transaction (census → stage → swap) — plus the\n// snapshot walkers that must capture one COMPLETE generation. All of them\n// enumerate or replace `state/embeddings/` (or the legacy marker), so an\n// unsynchronized writer's bytes are silently discarded by the other side's\n// wholesale directory swap.\n//\n// Built directly on the existing utilities: `serializeMutations` (in-process\n// keyed chain, rejection-recovering — gotcha #40) around `withHeldFileLock`\n// (cross-process held advisory lock, replacement-safe stale breaking,\n// ownership-checked release). A lock that cannot be acquired within the\n// bounded wait FAILS CLOSED — proceeding unsynchronized would reintroduce\n// the lost-write race this lock exists to prevent.\n//\n// The lock is keyed by the PHYSICAL state directory (dirname of the\n// generation's shard dir / of the legacy marker), so every caller\n// convention — memory-root-relative (`namespaces/<ns>/state`) or\n// namespace-scoped roots (`<ns>/state`) — contends on the SAME lock file\n// for the same generation. The lock file lives under that state dir's\n// `.offline-sync/` (sync-internal, excluded from every offline-sync\n// snapshot by the default excludes).\nimport path from \"node:path\";\nimport { type HeldFileLockController, serializeMutations, withHeldFileLock } from \"./utils/serialize-mutations.js\";\n\n/** Stale-lock window for a crashed holder (mirrors the graph lock). */\nconst LOCK_STALE_MS = 30_000;\n/** Bounded acquisition wait; a busy lock FAILS the operation (strict). */\nconst LOCK_MAX_WAIT_MS = 10_000;\n\n/** Control surface handed to a held embedding-generation lock section. */\nexport type EmbeddingGenerationLockSection = HeldFileLockController;\n\n/**\n * A fence the store calls immediately before a destructive write: reasserts\n * lock ownership so a peer that stale-broke and replaced the lock aborts\n * this write instead of clobbering the peer's.\n */\nexport type EmbeddingGenerationFence = () => Promise<void>;\n\n/**\n * A held embedding-generation lock section was lost mid-critical-section —\n * a peer stale-broke and replaced it. Abort; never publish.\n */\nexport class EmbeddingGenerationLockLostError extends Error {\n  constructor(lockPath: string) {\n    super(\n      `embedding generation: the mutation lock for ${lockPath} was lost mid-section — a peer stale-broke and replaced it; aborting instead of clobbering the peer's write`\n    );\n    this.name = \"EmbeddingGenerationLockLostError\";\n  }\n}\n\n/** The generation lock could not be acquired; callers fail closed and report it. */\nexport class EmbeddingGenerationLockUnavailableError extends Error {\n  constructor(lockPath: string, reason: \"timeout\" | \"error\") {\n    super(`embedding generation: could not acquire the mutation lock for ${lockPath} (${reason})`);\n    this.name = \"EmbeddingGenerationLockUnavailableError\";\n  }\n}\n\n/**\n * The lock file path for the generation whose canonical state dir is\n * `absoluteStateDir` (physical path; e.g. `<memoryRoot>/state` or\n * `<memoryRoot>/namespaces/<ns>/state`). Keyed by the physical directory so\n * every root convention contends on one lock file per generation.\n */\nexport function embeddingGenerationLockPath(absoluteStateDir: string): string {\n  const stateDir = path.resolve(absoluteStateDir);\n  return path.join(stateDir, \".offline-sync\", \"locks\", \"embedding-generation.lock\");\n}\n\n/**\n * Revalidate lock ownership immediately before a destructive publish.\n * Throws {@link EmbeddingGenerationLockLostError} when the lock was\n * broken/replaced, so the caller aborts and leaves the peer's write intact.\n */\nexport async function assertEmbeddingGenerationLockHeld(\n  lockPath: string,\n  section: EmbeddingGenerationLockSection\n): Promise<void> {\n  if (!(await section.refresh())) throw new EmbeddingGenerationLockLostError(lockPath);\n}\n\n/**\n * Run `fn` while holding the embedding-generation mutation lock for the\n * generation whose state dir is `absoluteStateDir`, handing it the section\n * controller. `serializeMutations` provides the in-process keyed chain\n * INSIDE the cross-process advisory lock, so peers serialize against every\n * section this process runs, one at a time. Times out fail-closed.\n */\nexport function withEmbeddingGenerationLock<T>(\n  absoluteStateDir: string,\n  fn: (lock: EmbeddingGenerationLockSection) => Promise<T>\n): Promise<T> {\n  const lockPath = embeddingGenerationLockPath(absoluteStateDir);\n  return serializeMutations(lockPath, () =>\n    withHeldFileLock(lockPath, { staleMs: LOCK_STALE_MS, maxWaitMs: LOCK_MAX_WAIT_MS }, (acquired, lock) => {\n      if (!acquired) {\n        throw new EmbeddingGenerationLockUnavailableError(lockPath, lock.failure ?? \"error\");\n      }\n      return fn(lock);\n    })\n  );\n}\n\n/** Capture a complete bounded digest census under lock, then stream outside\n * the lock. If any member changes, throw rather than emit a complete subset. */\nexport async function* withEmbeddingGenerationLockIter<T extends { path: string; sha256: string; bytes: number }>(\n  absoluteStateDir: string,\n  make: (includeContent: boolean) => AsyncIterable<T>,\n  includeContent: boolean,\n  verify?: () => Promise<void>\n): AsyncIterable<T> {\n  const lockPath = embeddingGenerationLockPath(absoluteStateDir);\n  // Capture only bounded metadata under the lock, never large content or\n  // network backpressure. Every emitted record must match this complete\n  // generation census; a concurrent swap/dirty write aborts the stream.\n  const baseline = await withEmbeddingGenerationLock(absoluteStateDir, async (section) => {\n    await verify?.();\n    const records: Array<{ path: string; sha256: string; bytes: number }> = [];\n    for await (const record of make(false)) {\n      await assertEmbeddingGenerationLockHeld(lockPath, section);\n      records.push({ path: record.path, sha256: record.sha256, bytes: record.bytes });\n    }\n    return records;\n  });\n  let count = 0;\n  for await (const record of make(includeContent)) {\n    const expected = baseline[count++];\n    if (!expected || expected.path !== record.path || expected.sha256 !== record.sha256 || expected.bytes !== record.bytes) {\n      throw new Error(`embedding generation changed while streaming ${absoluteStateDir}; retry the snapshot`);\n    }\n    yield record;\n  }\n  if (count !== baseline.length) {\n    throw new Error(`embedding generation changed while streaming ${absoluteStateDir}; retry the snapshot`);\n  }\n}\n"],"mappings":";;;;;;AAwBA,OAAO,UAAU;AAIjB,IAAM,gBAAgB;AAEtB,IAAM,mBAAmB;AAgBlB,IAAM,mCAAN,cAA+C,MAAM;AAAA,EAC1D,YAAY,UAAkB;AAC5B;AAAA,MACE,+CAA+C,QAAQ;AAAA,IACzD;AACA,SAAK,OAAO;AAAA,EACd;AACF;AAGO,IAAM,0CAAN,cAAsD,MAAM;AAAA,EACjE,YAAY,UAAkB,QAA6B;AACzD,UAAM,iEAAiE,QAAQ,KAAK,MAAM,GAAG;AAC7F,SAAK,OAAO;AAAA,EACd;AACF;AAQO,SAAS,4BAA4B,kBAAkC;AAC5E,QAAM,WAAW,KAAK,QAAQ,gBAAgB;AAC9C,SAAO,KAAK,KAAK,UAAU,iBAAiB,SAAS,2BAA2B;AAClF;AAOA,eAAsB,kCACpB,UACA,SACe;AACf,MAAI,CAAE,MAAM,QAAQ,QAAQ,EAAI,OAAM,IAAI,iCAAiC,QAAQ;AACrF;AASO,SAAS,4BACd,kBACA,IACY;AACZ,QAAM,WAAW,4BAA4B,gBAAgB;AAC7D,SAAO;AAAA,IAAmB;AAAA,IAAU,MAClC,iBAAiB,UAAU,EAAE,SAAS,eAAe,WAAW,iBAAiB,GAAG,CAAC,UAAU,SAAS;AACtG,UAAI,CAAC,UAAU;AACb,cAAM,IAAI,wCAAwC,UAAU,KAAK,WAAW,OAAO;AAAA,MACrF;AACA,aAAO,GAAG,IAAI;AAAA,IAChB,CAAC;AAAA,EACH;AACF;AAIA,gBAAuB,gCACrB,kBACA,MACA,gBACA,QACkB;AAClB,QAAM,WAAW,4BAA4B,gBAAgB;AAI7D,QAAM,WAAW,MAAM,4BAA4B,kBAAkB,OAAO,YAAY;AACtF,UAAM,SAAS;AACf,UAAM,UAAkE,CAAC;AACzE,qBAAiB,UAAU,KAAK,KAAK,GAAG;AACtC,YAAM,kCAAkC,UAAU,OAAO;AACzD,cAAQ,KAAK,EAAE,MAAM,OAAO,MAAM,QAAQ,OAAO,QAAQ,OAAO,OAAO,MAAM,CAAC;AAAA,IAChF;AACA,WAAO;AAAA,EACT,CAAC;AACD,MAAI,QAAQ;AACZ,mBAAiB,UAAU,KAAK,cAAc,GAAG;AAC/C,UAAM,WAAW,SAAS,OAAO;AACjC,QAAI,CAAC,YAAY,SAAS,SAAS,OAAO,QAAQ,SAAS,WAAW,OAAO,UAAU,SAAS,UAAU,OAAO,OAAO;AACtH,YAAM,IAAI,MAAM,gDAAgD,gBAAgB,sBAAsB;AAAA,IACxG;AACA,UAAM;AAAA,EACR;AACA,MAAI,UAAU,SAAS,QAAQ;AAC7B,UAAM,IAAI,MAAM,gDAAgD,gBAAgB,sBAAsB;AAAA,EACxG;AACF;","names":[]}

package/dist/{chunk-2I6VHX6Q.js → chunk-76M5OK7V.js}

@@ -10,7 +10,7 @@ import {
 } from "./chunk-AERXJCOG.js";
 import {
   deriveSourceConnector
-} from "./chunk-6DTJBTHL.js";
+} from "./chunk-BUQKSQXL.js";
 import {
   resolvePipelineProcessingCapabilities
 } from "./chunk-BMXEBWBT.js";
@@ -112,4 +112,4 @@ export {
   renderExtractionConversation,
   applyGroundingWithConnector
 };
-//# sourceMappingURL=chunk-2I6VHX6Q.js.map
+//# sourceMappingURL=chunk-76M5OK7V.js.map

package/dist/{chunk-OEBLZZKK.js → chunk-7XG7KMIW.js}

@@ -1,6 +1,6 @@
 import {
   parseExtractionLivenessConfig
-} from "./chunk-3SG4FGDV.js";
+} from "./chunk-AWD36R4D.js";
 
 // src/extraction-span-config.ts
 import { z } from "zod";
@@ -50,4 +50,4 @@ export {
   parseExtractionFields,
   parseExtractionSpanConfig
 };
-//# sourceMappingURL=chunk-OEBLZZKK.js.map
+//# sourceMappingURL=chunk-7XG7KMIW.js.map

package/dist/{chunk-FYAU4S6E.js → chunk-A4VSOUCB.js}

@@ -1,9 +1,9 @@
 import {
   hasMemoryData
-} from "./chunk-WB2I2EQK.js";
+} from "./chunk-P2ODTYOF.js";
 import {
   resolveNamespaceStorageRoot
-} from "./chunk-N3MNDVJO.js";
+} from "./chunk-SWBC3UER.js";
 import {
   getConfiguredNamespaces
 } from "./chunk-OWYHHW67.js";
@@ -724,4 +724,4 @@ export {
   runNamespaceMaintenancePlan,
   runNamespaceMaintenanceBatchPlan
 };
-//# sourceMappingURL=chunk-FYAU4S6E.js.map
+//# sourceMappingURL=chunk-A4VSOUCB.js.map

package/dist/{chunk-GEX5NI36.js → chunk-AE5U5NMS.js}

@@ -1,7 +1,7 @@
 import {
   SupportPassportCreateGrantRequestSchema,
   defineOperation
-} from "./chunk-SVZWVZ7E.js";
+} from "./chunk-QB57WIS6.js";
 import {
   SupportPassportCardCategorySchema,
   SupportPassportMemoryIdSchema,
@@ -220,4 +220,4 @@ var supportPassportGrantAskOperation = defineOperation({
     result: await ctx.service.supportPassportAskGrant(grantId, secret, question, ctx.abortSignal)
   })
 });
-//# sourceMappingURL=chunk-GEX5NI36.js.map
+//# sourceMappingURL=chunk-AE5U5NMS.js.map

package/dist/{chunk-UNJOB4DY.js → chunk-AEHVZY3X.js}

@@ -1,6 +1,6 @@
 import {
   parseFrontmatter
-} from "./chunk-S55WTPFJ.js";
+} from "./chunk-STEOT4DI.js";
 import {
   activityDigestPath,
   isValidActivityDate
@@ -199,4 +199,4 @@ export {
   buildStandup,
   standupHelp
 };
-//# sourceMappingURL=chunk-UNJOB4DY.js.map
+//# sourceMappingURL=chunk-AEHVZY3X.js.map

package/dist/{chunk-ML2MVAEZ.js → chunk-AEU4EQGV.js}

@@ -318,4 +318,4 @@ export {
   readProjectedHarmonicGraph,
   searchHarmonicRetrieval
 };
-//# sourceMappingURL=chunk-ML2MVAEZ.js.map
+//# sourceMappingURL=chunk-AEU4EQGV.js.map

package/dist/{chunk-3SG4FGDV.js → chunk-AWD36R4D.js}

@@ -1,3 +1,6 @@
+import {
+  getExtractionLlmHealth
+} from "./chunk-ZJP66Q4I.js";
 import {
   coerceBool,
   coerceNumber
@@ -166,7 +169,7 @@ async function computeExtractionLivenessStatus(orchestrator, watermark, throttle
     nowMs
   });
   throttle?.maybeWarn(status, config.staleWindowMs, nowMs);
-  return status;
+  return { ...status, ...getExtractionLlmHealth() };
 }
 async function summarizeExtractionLiveness(config, watermark, buffer, nowMs = Date.now()) {
   const livenessConfig = resolveExtractionLivenessConfig(config.extractionLiveness);
@@ -222,4 +225,4 @@ export {
   summarizeExtractionLiveness,
   renderExtractionLivenessStats
 };
-//# sourceMappingURL=chunk-3SG4FGDV.js.map
+//# sourceMappingURL=chunk-AWD36R4D.js.map

package/dist/chunk-AWD36R4D.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/extraction-liveness.ts"],"sourcesContent":["/**\n * Extraction-pipeline liveness (issue #2151).\n *\n * A daemon's implicit extraction can fail continuously for months while\n * `/health` stays green and recall keeps serving: every individual failure is\n * logged (timeouts, fallback-no-parsed-output), but nothing aggregates them\n * into a checkable status. This module surfaces a liveness *watermark* — the\n * last successful extraction plus the current buffer backlog — and decides when\n * that watermark is stale enough to call the pipeline degraded.\n *\n * The §22 error-vs-empty principle applies at the pipeline level: \"no\n * extraction succeeded for 90 days\" (a non-empty buffer with a stale/absent\n * watermark) must be distinguishable from \"nothing to extract\" (an empty\n * buffer). Degradation therefore requires a NON-EMPTY buffer — an idle daemon\n * with nothing buffered is healthy, not degraded.\n *\n * The core decision (`evaluateExtractionLiveness`) is a pure function shared by\n * every surface (authenticated `/health`, `remnic doctor`, `remnic stats`) so\n * the verdict never diverges across code paths.\n */\nimport { coerceBool, coerceNumber } from \"./connectors/coerce.js\";\nimport { getExtractionLlmHealth } from \"./extraction-llm-health.js\";\nimport { log } from \"./logger.js\";\nimport type { OperatorDoctorCheck } from \"./operator-doctor-types.js\";\nimport type { PluginConfig } from \"./types.js\";\n\n/** Default staleness window: 24h. A watermark older than this with a non-empty buffer is degraded. */\nconst DEFAULT_STALE_WINDOW_MS = 86_400_000;\n\nexport interface ExtractionLivenessConfig {\n  /** Master gate. When false, liveness is never reported degraded. Default true. */\n  enabled: boolean;\n  /**\n   * How stale the last-successful-extraction watermark may get (ms) before a\n   * non-empty buffer flags the pipeline degraded. Default 24h.\n   */\n  staleWindowMs: number;\n}\n\n/**\n * A read-only snapshot of buffered, not-yet-extracted work. Structurally\n * satisfied by `SmartBuffer.getBufferSnapshot()` so callers can pass the live\n * buffer without this module depending on the buffer implementation.\n */\nexport interface ExtractionBufferSnapshot {\n  bufferedSessionCount: number;\n  pendingTurnCount: number;\n  oldestTurnTimestamp: string | null;\n  /**\n   * Set by the liveness reader (never by `SmartBuffer`) when the buffer exists\n   * but its snapshot read threw. An unreadable buffer is a pipeline fault, not\n   * an empty queue (§22): it degrades the pipeline with a distinct reason\n   * instead of masquerading as a zero-backlog (healthy) snapshot.\n   */\n  readFailed?: boolean;\n  /** Read-failure detail, surfaced in the degraded reason when `readFailed`. */\n  readError?: string;\n}\n\nexport interface ExtractionBufferSource {\n  getBufferSnapshot(): Promise<ExtractionBufferSnapshot>;\n}\n\nexport interface ExtractionRootStats {\n  extractionCount?: number;\n  lastConsolidationAt?: string | null;\n}\n\nexport interface ExtractionWatermarkRead {\n  lastExtractionAt: string | null;\n  readFailed: boolean;\n  readError?: string;\n  pending?: boolean;\n  rootStats?: ExtractionRootStats;\n}\n\nexport type ExtractionWatermarkOrStorage =\n  | ExtractionWatermarkRead\n  | { readMetadata(): Promise<{ lastExtractionAt?: string | null } | null> }\n  | { loadMeta(): Promise<{ lastExtractionAt?: string | null }> };\n\nexport async function coerceExtractionWatermark(\n  watermark: ExtractionWatermarkOrStorage,\n): Promise<ExtractionWatermarkRead> {\n  if (watermark && \"readFailed\" in watermark && typeof watermark.readFailed === \"boolean\") {\n    return watermark as ExtractionWatermarkRead;\n  }\n  try {\n    let lastExtractionAt: string | null = null;\n    if (\"loadMeta\" in watermark && typeof watermark.loadMeta === \"function\") {\n      const meta = await watermark.loadMeta();\n      lastExtractionAt = meta?.lastExtractionAt ?? null;\n    } else if (\"readMetadata\" in watermark && typeof watermark.readMetadata === \"function\") {\n      const meta = await watermark.readMetadata();\n      lastExtractionAt = meta?.lastExtractionAt ?? null;\n    }\n    return {\n      lastExtractionAt,\n      readFailed: true,\n      readError: \"aggregate watermark unavailable from legacy root-store-only storage argument\",\n    };\n  } catch (error) {\n    return {\n      lastExtractionAt: null,\n      readFailed: true,\n      readError: error instanceof Error ? error.message : String(error),\n    };\n  }\n}\n\n/**\n * The daemon-scoped liveness payload surfaced on `/health.extraction` and in\n * doctor/stats details. Its watermark is the maximum successful extraction\n * across every distinct namespace store, matching the daemon-wide buffer scope.\n */\nexport interface ExtractionLivenessStatus {\n  lastExtractionAt: string | null;\n  bufferedSessionCount: number;\n  pendingTurnCount: number;\n  oldestBufferedTurnAgeMs: number | null;\n  degraded: boolean;\n  degradedReason: string | null;\n  watermarkPending?: boolean;\n  watermarkScope: \"aggregate\";\n  /**\n   * Extraction-LLM availability (issue #3140): outcome of the last extraction\n   * attempt. `lastFailureReason` is non-null exactly while `llmReachable` is\n   * false. Populated by the daemon-wide status readers (`/health`, doctor,\n   * stats), not by the pure evaluators below.\n   */\n  llmReachable?: boolean;\n  lastFailureReason?: string | null;\n  lastFailureAt?: string | null;\n}\n\ninterface ExtractionLivenessOrchestratorLike {\n  config: Pick<PluginConfig, \"extractionLiveness\">;\n  buffer?: ExtractionBufferSource;\n}\n\n/**\n * Parse the `extractionLiveness` config block. Follows the nested-block shape\n * validation used elsewhere in `config.ts` and coerces string booleans (§24:\n * CLI/JSON deliver `\"false\"`/`\"0\"` as strings, which must read as falsy).\n */\nexport function parseExtractionLivenessConfig(\n  cfg: Record<string, unknown>,\n): ExtractionLivenessConfig {\n  const raw = cfg.extractionLiveness;\n  if (raw !== undefined && (raw === null || typeof raw !== \"object\" || Array.isArray(raw))) {\n    throw new Error(`extractionLiveness must be a plain object (got ${JSON.stringify(raw)})`);\n  }\n  const block = (raw ?? {}) as Record<string, unknown>;\n  return {\n    // `?? true` keeps the default on when the key is absent while honoring\n    // explicit \"false\"/\"0\"/false opt-outs (coerceBool handles the string forms).\n    enabled: coerceBool(block.enabled) ?? true,\n    staleWindowMs: parseStaleWindowMs(block.staleWindowMs),\n  };\n}\n\n/**\n * Parse `extractionLiveness.staleWindowMs`. Absent (`undefined`) → the 24h\n * default; any PRESENT value (including an explicit `null`) must coerce to a\n * positive INTEGER of milliseconds, else THROW. A fractional or non-positive\n * value (\"0.5\" would floor to 0, making every backlog instantly stale; 1.9 would\n * floor to 1) is rejected, never floored/reinterpreted (§1/§17/§39). Mirrors\n * config.ts's `parseIntegerInClosedRange` (round 9 finding 1): only an absent key\n * falls back; an explicit `null` is invalid input, not \"use the default\".\n * Inlined rather than imported because config.ts already imports this module\n * (importing back would be circular), the same reason `recall-concurrency-config.ts`\n * inlines its numeric validation.\n */\nfunction parseStaleWindowMs(value: unknown): number {\n  // Only an absent key (undefined) falls back to the default; an explicit `null`\n  // is invalid input and proceeds to validation → throw (mirrors\n  // parseIntegerInClosedRange, round 9 finding 1).\n  if (value === undefined) return DEFAULT_STALE_WINDOW_MS;\n  const coerced = coerceNumber(value);\n  if (coerced === undefined || !Number.isFinite(coerced) || !Number.isInteger(coerced) || coerced < 1) {\n    throw new Error(\n      `extractionLiveness.staleWindowMs must be an integer greater than or equal to 1; got ${JSON.stringify(value)}`,\n    );\n  }\n  return coerced;\n}\n\n/** Milliseconds between `timestamp` and `nowMs`, clamped at 0; null when unparsable/absent. */\nfunction ageMsFrom(timestamp: string | null, nowMs: number): number | null {\n  if (typeof timestamp !== \"string\") return null;\n  const parsed = Date.parse(timestamp);\n  if (!Number.isFinite(parsed)) return null;\n  return Math.max(0, nowMs - parsed);\n}\n\n/** Compact human-readable duration (\"3d\", \"5h\", \"12m\", \"45s\") for logs and CLI output. */\nexport function formatAgeMs(ms: number): string {\n  const s = Math.max(0, Math.floor(ms / 1000));\n  if (s >= 86_400) return `${Math.floor(s / 86_400)}d`;\n  if (s >= 3_600) return `${Math.floor(s / 3_600)}h`;\n  if (s >= 60) return `${Math.floor(s / 60)}m`;\n  return `${s}s`;\n}\n\n/**\n * Pure liveness verdict. Degraded when the feature is enabled AND any of: the\n * last-extraction watermark could not be READ (a storage fault, §22), the buffer\n * read failed (a pipeline fault, §22), or the buffer is non-empty and the\n * watermark is absent or stale. Each cause yields a DISTINCT reason so an\n * operator can tell a meta-read failure from a buffer-read failure from a\n * pipeline that has genuinely never extracted.\n *\n * Staleness uses a half-open freshness window (§23): an extraction is fresh\n * while its age is in `[0, staleWindowMs)`, so an age of EXACTLY `staleWindowMs`\n * is stale (the upper bound on \"fresh\" is exclusive). A null/unparsable watermark\n * means \"never succeeded\" and is treated as stale — as is a FUTURE watermark (a\n * clock-skewed or corrupt timestamp ahead of now must not read as a fresh\n * extraction and hide a real backlog stall).\n */\nexport function evaluateExtractionLiveness(input: {\n  config: ExtractionLivenessConfig;\n  lastExtractionAt: string | null;\n  snapshot: ExtractionBufferSnapshot;\n  nowMs: number;\n  metaReadFailed?: boolean;\n  metaReadError?: string;\n  watermarkPending?: boolean;\n}): ExtractionLivenessStatus {\n  const { config, lastExtractionAt, snapshot, nowMs } = input;\n  const lastMs = lastExtractionAt !== null ? Date.parse(lastExtractionAt) : Number.NaN;\n  const hasWatermark = Number.isFinite(lastMs);\n  const ageMs = nowMs - lastMs;\n  // A future watermark (negative age) is clock-skewed or corrupt data, not a\n  // fresh extraction: treat it as stale so a real backlog stall is not hidden.\n  const stale = !hasWatermark || ageMs < 0 || ageMs >= config.staleWindowMs;\n  const hasBacklog = snapshot.bufferedSessionCount > 0;\n  // A watermark or buffer that cannot be READ is a fault, not an empty queue\n  // (§22): a storage/pipeline outage must not read as healthy, and must stay\n  // distinct from a pipeline that has genuinely never extracted.\n  const metaReadFailed = input.metaReadFailed === true;\n  const watermarkPending = input.watermarkPending === true;\n  const readFailed = snapshot.readFailed === true;\n  const degraded =\n    config.enabled && (metaReadFailed || readFailed || (!watermarkPending && hasBacklog && stale));\n\n  let degradedReason: string | null = null;\n  if (degraded) {\n    if (metaReadFailed) {\n      degradedReason = `extraction watermark unreadable: ${input.metaReadError ?? \"meta read failed\"}`;\n    } else if (readFailed) {\n      degradedReason = `extraction buffer unreadable: ${snapshot.readError ?? \"buffer snapshot read failed\"}`;\n    } else {\n      const watermark = hasWatermark\n        ? `last succeeded ${formatAgeMs(nowMs - lastMs)} ago`\n        : \"no successful extraction on record\";\n      degradedReason =\n        `${watermark}; ${snapshot.bufferedSessionCount} buffered session(s), ` +\n        `${snapshot.pendingTurnCount} turn(s) pending extraction`;\n    }\n  }\n\n  return {\n    lastExtractionAt,\n    bufferedSessionCount: snapshot.bufferedSessionCount,\n    pendingTurnCount: snapshot.pendingTurnCount,\n    oldestBufferedTurnAgeMs: ageMsFrom(snapshot.oldestTurnTimestamp, nowMs),\n    degraded,\n    degradedReason,\n    ...(watermarkPending ? { watermarkPending: true } : {}),\n    watermarkScope: \"aggregate\",\n  };\n}\n\nconst EMPTY_SNAPSHOT: ExtractionBufferSnapshot = {\n  bufferedSessionCount: 0,\n  pendingTurnCount: 0,\n  oldestTurnTimestamp: null,\n};\n\n/**\n * Read a buffer snapshot without throwing. An ABSENT buffer degrades to an empty\n * (healthy) snapshot — some service constructions have no orchestrator buffer. A\n * buffer that EXISTS but whose read throws yields a `readFailed` snapshot so the\n * verdict can distinguish a pipeline fault from an empty queue (§22).\n */\nasync function readBufferSnapshot(\n  buffer: ExtractionBufferSource | undefined,\n): Promise<ExtractionBufferSnapshot> {\n  if (!buffer || typeof buffer.getBufferSnapshot !== \"function\") return EMPTY_SNAPSHOT;\n  try {\n    return await buffer.getBufferSnapshot();\n  } catch (err) {\n    return {\n      ...EMPTY_SNAPSHOT,\n      readFailed: true,\n      readError: err instanceof Error ? err.message : String(err),\n    };\n  }\n}\n\n/**\n * Gather the liveness status from an aggregate watermark read and an optional\n * buffer. A read failure on either side is surfaced as a degraded status with a\n * distinct reason rather than swallowed into a healthy-looking verdict.\n */\nexport async function gatherExtractionLivenessStatus(input: {\n  config: ExtractionLivenessConfig;\n  watermark: ExtractionWatermarkOrStorage;\n  buffer: ExtractionBufferSource | undefined;\n  nowMs: number;\n}): Promise<ExtractionLivenessStatus> {\n  const { config, buffer, nowMs } = input;\n  const watermarkRead = await coerceExtractionWatermark(input.watermark);\n  const snapshot = await readBufferSnapshot(buffer);\n  return evaluateExtractionLiveness({\n    config,\n    lastExtractionAt: watermarkRead.lastExtractionAt,\n    snapshot,\n    nowMs,\n    metaReadFailed: watermarkRead.readFailed,\n    metaReadError: watermarkRead.readError,\n    watermarkPending: watermarkRead.pending,\n  });\n}\n\n/**\n * Aggregated-WARN throttle (issue #2151): emit at most ONE warning per\n * staleness window while degraded — not one line per failed extraction attempt.\n * State is instance-scoped (held by the owning service), never a module global\n * (§5), so multiple service instances throttle independently.\n */\nexport class ExtractionLivenessWarnThrottle {\n  private lastWarnAtMs: number | null = null;\n\n  /** Warn if degraded and outside the throttle window; returns whether a WARN was emitted. */\n  maybeWarn(status: ExtractionLivenessStatus, staleWindowMs: number, nowMs: number): boolean {\n    if (!status.degraded) {\n      // Recovered (or never degraded): reset so a fresh episode warns at once.\n      this.lastWarnAtMs = null;\n      return false;\n    }\n    if (this.lastWarnAtMs !== null && nowMs - this.lastWarnAtMs < staleWindowMs) return false;\n    this.lastWarnAtMs = nowMs;\n    log.warn(\n      `extraction pipeline liveness degraded: ${status.degradedReason ?? \"buffered turns are not being extracted\"}`,\n    );\n    return true;\n  }\n}\n\n/**\n * Normalize the `extractionLiveness` block at the read boundary. `parseConfig`\n * always populates it, but a host adapter, an older persisted config, or a\n * hand-built `PluginConfig` can hand us an absent, partial, or loosely-typed\n * block - and every liveness surface (/health, doctor, stats) must degrade to\n * the documented default (enabled, 24h window) rather than throw. Both fields\n * are coerced with the same rules as `parseExtractionLivenessConfig` (§24:\n * `\"false\"`/`\"0\"` read as falsy; a numeric string like `\"5000\"` parses), except a\n * present but non-integer or non-positive `staleWindowMs` falls back to the\n * default here rather than throwing.\n */\nexport function resolveExtractionLivenessConfig(\n  block: { enabled?: unknown; staleWindowMs?: unknown } | undefined,\n): ExtractionLivenessConfig {\n  const staleWindowMs = coerceNumber(block?.staleWindowMs);\n  return {\n    enabled: coerceBool(block?.enabled) ?? true,\n    staleWindowMs:\n      staleWindowMs !== undefined && Number.isInteger(staleWindowMs) && staleWindowMs >= 1\n        ? staleWindowMs\n        : DEFAULT_STALE_WINDOW_MS,\n  };\n}\n\n/**\n * Compute the daemon-wide liveness status for the authenticated `/health`\n * payload and emit the throttled aggregate warning.\n */\nexport async function computeExtractionLivenessStatus(\n  orchestrator: ExtractionLivenessOrchestratorLike,\n  watermark: ExtractionWatermarkOrStorage,\n  throttle?: ExtractionLivenessWarnThrottle,\n  nowMs: number = Date.now(),\n): Promise<ExtractionLivenessStatus> {\n  const config = resolveExtractionLivenessConfig(orchestrator.config.extractionLiveness);\n  const status = await gatherExtractionLivenessStatus({\n    config,\n    watermark,\n    buffer: orchestrator.buffer,\n    nowMs,\n  });\n  throttle?.maybeWarn(status, config.staleWindowMs, nowMs);\n  // Extraction-LLM availability (#3140): a silent no_models / LLM-unreachable\n  // outage must be visible on /health (and doctor/stats) without debug logs.\n  return { ...status, ...getExtractionLlmHealth() };\n}\n\n/**\n * `remnic doctor` check for extraction-pipeline liveness. Status `warn` when\n * degraded (with a remediation hint), `ok` otherwise.\n */\nexport async function summarizeExtractionLiveness(\n  config: Pick<PluginConfig, \"extractionLiveness\">,\n  watermark: ExtractionWatermarkOrStorage,\n  buffer?: ExtractionBufferSource,\n  nowMs: number = Date.now(),\n): Promise<OperatorDoctorCheck> {\n  const livenessConfig = resolveExtractionLivenessConfig(config.extractionLiveness);\n  const status = await gatherExtractionLivenessStatus({\n    config: livenessConfig,\n    watermark,\n    buffer,\n    nowMs,\n  });\n  const scopeNote = ` Watermark scope: ${status.watermarkScope}.`;\n  const summary =\n    (status.degraded\n      ? `Extraction pipeline degraded: ${status.degradedReason}.`\n      : `Extraction pipeline healthy: last extraction ${status.lastExtractionAt ?? \"never\"}, ` +\n        `${status.bufferedSessionCount} buffered session(s), ${status.pendingTurnCount} turn(s) pending` +\n        `${livenessConfig.enabled ? \"\" : \" (liveness check disabled)\"}.`) + scopeNote;\n  return {\n    key: \"extraction_liveness\",\n    status: status.degraded ? \"warn\" : \"ok\",\n    summary,\n    remediation: status.degraded\n      ? \"Extraction has stalled while turns are buffered. Inspect daemon logs for extraction \" +\n        \"timeouts or fallback-no-parsed-output errors, verify the extraction model/provider is \" +\n        \"reachable, then force a flush (e.g. `remnic flush`).\"\n      : undefined,\n    details: { ...status, staleWindowMs: livenessConfig.staleWindowMs, enabled: livenessConfig.enabled },\n  };\n}\n\n/**\n * Lines for `remnic stats`: the aggregate extraction watermark, root metadata\n * counters, buffer backlog, and liveness verdict. Root counter failures render\n * those counters unavailable; the injected aggregate read alone determines\n * watermark liveness so stats cannot diverge from health and doctor.\n */\nexport async function renderExtractionLivenessStats(\n  orchestrator: ExtractionLivenessOrchestratorLike,\n  watermark: ExtractionWatermarkRead,\n  nowMs: number = Date.now(),\n): Promise<string[]> {\n  const status = evaluateExtractionLiveness({\n    config: resolveExtractionLivenessConfig(orchestrator.config.extractionLiveness),\n    lastExtractionAt: watermark.lastExtractionAt,\n    snapshot: await readBufferSnapshot(orchestrator.buffer),\n    nowMs,\n    metaReadFailed: watermark.readFailed,\n    metaReadError: watermark.readError,\n    watermarkPending: watermark.pending,\n  });\n  const oldestAge =\n    status.oldestBufferedTurnAgeMs !== null ? formatAgeMs(status.oldestBufferedTurnAgeMs) : \"n/a\";\n  const rootStats = watermark.rootStats;\n  const watermarkDisplay = watermark.readFailed\n    ? \"unavailable\"\n    : watermark.pending\n      ? \"pending\"\n      : status.lastExtractionAt ?? \"never\";\n  return [\n    `Extractions: ${rootStats?.extractionCount ?? \"unavailable\"}`,\n    `Last extraction: ${watermarkDisplay}`,\n    `Last consolidation: ${rootStats ? rootStats.lastConsolidationAt ?? \"never\" : \"unavailable\"}`,\n    `Buffered sessions: ${status.bufferedSessionCount} (${status.pendingTurnCount} turns pending)`,\n    `Oldest buffered turn age: ${oldestAge}`,\n    `Extraction watermark scope: ${status.watermarkScope}`,\n    `Extraction liveness: ${status.degraded ? `DEGRADED — ${status.degradedReason}` : \"ok\"}`,\n  ];\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-JVY556FW.js → chunk-AWG3TIAY.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-TBBDFYXW.js";
 import {
   StorageManager
-} from "./chunk-S55WTPFJ.js";
+} from "./chunk-STEOT4DI.js";
 import {
   bumpMemoryCorpusVersionForDir
 } from "./chunk-XCB6QDL6.js";
@@ -765,4 +765,4 @@ export {
   listMemoryGovernanceRuns,
   readMemoryGovernanceRunArtifact
 };
-//# sourceMappingURL=chunk-JVY556FW.js.map
+//# sourceMappingURL=chunk-AWG3TIAY.js.map

package/dist/{chunk-JX6USXZR.js → chunk-AXC4WSF3.js}

@@ -1,6 +1,6 @@
 import {
   getVerdictKind
-} from "./chunk-DQISIT63.js";
+} from "./chunk-DZ42MDZE.js";
 import {
   scoreImportance
 } from "./chunk-UOBPK2OS.js";
@@ -37,10 +37,10 @@ import {
 } from "./chunk-YCVB7X56.js";
 import {
   fillWearableConversationLocations
-} from "./chunk-BMYZTZ5D.js";
+} from "./chunk-MY7B3HYC.js";
 import {
   composeMemoryEnvelope
-} from "./chunk-GDYU6VF4.js";
+} from "./chunk-5AYUHSAU.js";
 import {
   log
 } from "./chunk-3WCASNQZ.js";
@@ -1329,4 +1329,4 @@ export {
   syncWearableSource,
   defaultTimezone
 };
-//# sourceMappingURL=chunk-JX6USXZR.js.map
+//# sourceMappingURL=chunk-AXC4WSF3.js.map

package/dist/{chunk-BOUFVFV2.js → chunk-AZSGSRIM.js}

@@ -1,6 +1,6 @@
 import {
   RecallWhyInputError
-} from "./chunk-Q3THVX75.js";
+} from "./chunk-4RL3JOB3.js";
 import {
   isRecallDisclosure
 } from "./chunk-PWF4JXKD.js";
@@ -165,4 +165,4 @@ export {
   handleRecallWhyHttpQuery,
   handleRecallXrayHttpQuery
 };
-//# sourceMappingURL=chunk-BOUFVFV2.js.map
+//# sourceMappingURL=chunk-AZSGSRIM.js.map