@remnic/core 9.69.16 → 9.69.18

package/dist/{chunk-CTCGHNWN.js → chunk-J2R275FN.js}

@@ -13,13 +13,13 @@ import {
   requestEntityCanonicalIdReconcile,
   withRawEntityPageMutation
 } from "./chunk-NNZFPYYX.js";
+import {
+  parseExportBundle
+} from "./chunk-WEHSQBFR.js";
 import {
   decryptCapsuleFileInMemory,
   isEncryptedCapsuleFile
 } from "./chunk-X7Y7WX73.js";
-import {
-  parseExportBundle
-} from "./chunk-WEHSQBFR.js";
 import {
   assertIsDirectoryNotSymlink,
   assertRealpathInsideRoot,
@@ -294,4 +294,4 @@ function mintForkId(capsuleId, originalId, now) {
 export {
   importCapsule
 };
-//# sourceMappingURL=chunk-CTCGHNWN.js.map
+//# sourceMappingURL=chunk-J2R275FN.js.map

package/dist/{chunk-XJJYSX6F.js → chunk-JCUG7AXZ.js}

@@ -7,15 +7,15 @@ import {
   sha256Bytes,
   validateArchiveRelativePath
 } from "./chunk-GCGJW34D.js";
-import {
-  DEFAULT_OFFLINE_SYNC_EXCLUDE_GLOBS
-} from "./chunk-AREGMX2J.js";
 import {
   isEncryptedOfflineSyncFile,
   readPlainOfflineSyncFileChunk,
   sha256OfflineSyncFile,
   shouldExcludeOfflineSyncFile
 } from "./chunk-NBP4EX5N.js";
+import {
+  DEFAULT_OFFLINE_SYNC_EXCLUDE_GLOBS
+} from "./chunk-AREGMX2J.js";
 import {
   CENSUS_MAX_MTIME_MS,
   isCensusMtimeMs,
@@ -1894,4 +1894,4 @@ export {
   normalizeOfflineSyncState,
   fileStatesFromSnapshot
 };
-//# sourceMappingURL=chunk-XJJYSX6F.js.map
+//# sourceMappingURL=chunk-JCUG7AXZ.js.map

package/dist/{chunk-ZRUEP4IK.js → chunk-JIM4BIOC.js}

@@ -1,7 +1,7 @@
 import {
   CONVERGE_CONFLICT_POLICIES,
   DEFAULT_CONVERGE_CONFLICT_POLICY
-} from "./chunk-HBVPYRDW.js";
+} from "./chunk-6MINUTGJ.js";
 import {
   validateArchiveRelativePath
 } from "./chunk-GCGJW34D.js";
@@ -21,7 +21,7 @@ var ReconcilePlanInputError = class extends Error {
     this.name = "ReconcilePlanInputError";
   }
 };
-function assertCensusRecord(file, side, namespace) {
+function assertCensusRecord(file, side, namespace, platforms) {
   const path = file?.path;
   if (typeof path !== "string" || path.length === 0) {
     throw new ReconcilePlanInputError(
@@ -33,7 +33,7 @@ function assertCensusRecord(file, side, namespace) {
   } catch (err) {
     throw new ReconcilePlanInputError(err instanceof Error ? err.message : String(err));
   }
-  assertPortablePathSegments(path, side, namespace);
+  assertPortablePathSegments(path, side, namespace, platforms);
   return {
     ...file,
     path,
@@ -51,9 +51,7 @@ function assertMtimeMs(value, context) {
 }
 function assertDigest(value, context) {
   if (!isSha256Hex(value)) {
-    throw new ReconcilePlanInputError(
-      `reconcile: ${context} must carry a 64-character sha256 hex digest`
-    );
+    throw new ReconcilePlanInputError(`reconcile: ${context} must carry a 64-character sha256 hex digest`);
   }
   return value.toLowerCase();
 }
@@ -87,10 +85,11 @@ function assertIterable(value, side, namespace) {
 var WIN32_INVALID_CHARS = /[<>:"|?*\u0000-\u001f]/;
 var LONE_SURROGATE = /[\ud800-\udbff](?![\udc00-\udfff])|(?<![\ud800-\udbff])[\udc00-\udfff]/;
 var WIN32_RESERVED_NAMES = /^(con|prn|aux|nul|(com|lpt)[1-9\u00b9\u00b2\u00b3])$/i;
-function assertPortablePathSegments(path, side, namespace) {
+function assertPortablePathSegments(path, side, namespace, platforms) {
+  const isWindows = platforms.some((candidate) => candidate === "win32");
   for (const segment of path.split("/")) {
     if (segment.length === 0) continue;
-    if (segment.endsWith(".") || segment.endsWith(" ")) {
+    if (isWindows && (segment.endsWith(".") || segment.endsWith(" "))) {
       throw new ReconcilePlanInputError(
         `reconcile: ${side} census for namespace ${namespace} path ${path} has a segment ending in a dot or space; Windows strips those and would alias it onto another file`
       );
@@ -100,12 +99,12 @@ function assertPortablePathSegments(path, side, namespace) {
         `reconcile: ${side} census for namespace ${namespace} path ${path} contains an unpaired surrogate`
       );
     }
-    if (WIN32_INVALID_CHARS.test(segment)) {
+    if (isWindows && WIN32_INVALID_CHARS.test(segment)) {
       throw new ReconcilePlanInputError(
         `reconcile: ${side} census for namespace ${namespace} path ${path} contains a character Windows cannot store`
       );
     }
-    if (WIN32_RESERVED_NAMES.test(segment.split(".")[0] ?? "")) {
+    if (isWindows && WIN32_RESERVED_NAMES.test(segment.split(".")[0] ?? "")) {
       throw new ReconcilePlanInputError(
         `reconcile: ${side} census for namespace ${namespace} path ${path} uses a reserved Windows device name`
       );
@@ -136,10 +135,10 @@ function rejectConflictingDuplicate(existing, incoming, path, side, namespace) {
   }
   return true;
 }
-function indexByPath(files, side, namespace) {
+function indexByPath(files, side, namespace, platforms) {
   const index = /* @__PURE__ */ new Map();
   for (const raw of files) {
-    const file = assertCensusRecord(raw, side, namespace);
+    const file = assertCensusRecord(raw, side, namespace, platforms);
     if (rejectConflictingDuplicate(index.get(file.path), file, file.path, side, namespace)) continue;
     index.set(file.path, file);
   }
@@ -163,10 +162,10 @@ function parseTombstonedDigests(value, namespace, field = "tombstonedFileSha256"
   }
   return digests;
 }
-function indexDigestsByPath(files, side, namespace) {
+function indexDigestsByPath(files, side, namespace, platforms) {
   const index = /* @__PURE__ */ new Map();
   for (const raw of files) {
-    const file = assertCensusRecord(raw, side, namespace);
+    const file = assertCensusRecord(raw, side, namespace, platforms);
     const existing = index.get(file.path);
     if (existing !== void 0) {
       if (existing !== file.sha256) {
@@ -204,12 +203,10 @@ function resolveConflict(policy, localMtimeMs, peerMtimeMs, missingTimestampReso
   }
   return localMtimeMs > peerMtimeMs ? "local-wins" : "peer-wins";
 }
-function parseDeletionMtimes(value, side, namespace) {
+function parseDeletionMtimes(value, side, namespace, platforms) {
   if (value === void 0) return /* @__PURE__ */ new Map();
   if (!(value instanceof Map)) {
-    throw new ReconcilePlanInputError(
-      `reconcile: ${side} deletion mtimes for namespace ${namespace} must be a Map`
-    );
+    throw new ReconcilePlanInputError(`reconcile: ${side} deletion mtimes for namespace ${namespace} must be a Map`);
   }
   const parsed = /* @__PURE__ */ new Map();
   for (const [path, mtimeMs] of value) {
@@ -218,7 +215,7 @@ function parseDeletionMtimes(value, side, namespace) {
     } catch (err) {
       throw new ReconcilePlanInputError(err instanceof Error ? err.message : String(err));
     }
-    assertPortablePathSegments(path, side, namespace);
+    assertPortablePathSegments(path, side, namespace, platforms);
     parsed.set(path, assertMtimeMs(mtimeMs, `${side} deletion for namespace ${namespace} entry ${path}`));
   }
   return parsed;
@@ -234,21 +231,18 @@ function planNamespaceReconciliation(input, options = {}) {
   const policy = assertConflictPolicy(options.conflictPolicy);
   const localCensus = assertIterable(input.local, "local", namespace);
   const caseFold = /* @__PURE__ */ new Map();
-  const peer = indexByPath(assertIterable(input.peer, "peer", namespace), "peer", namespace);
-  const base = input.base === void 0 ? null : indexDigestsByPath(assertIterable(input.base, "base", namespace), "base", namespace);
+  const effectivePlatforms = [options.localPlatform ?? process.platform, options.peerPlatform];
+  const peer = indexByPath(assertIterable(input.peer, "peer", namespace), "peer", namespace, effectivePlatforms);
+  const base = input.base === void 0 ? null : indexDigestsByPath(assertIterable(input.base, "base", namespace), "base", namespace, effectivePlatforms);
   const tombstoned = parseTombstonedDigests(input.tombstonedFileSha256, namespace);
-  const peerTombstoned = parseTombstonedDigests(
-    input.peerTombstonedFileSha256,
-    namespace,
-    "peerTombstonedFileSha256"
-  );
-  const localDeletionMtimeMs = parseDeletionMtimes(input.localDeletionMtimeMs, "local", namespace);
-  const peerDeletionMtimeMs = parseDeletionMtimes(input.peerDeletionMtimeMs, "peer", namespace);
+  const peerTombstoned = parseTombstonedDigests(input.peerTombstonedFileSha256, namespace, "peerTombstonedFileSha256");
+  const localDeletionMtimeMs = parseDeletionMtimes(input.localDeletionMtimeMs, "local", namespace, effectivePlatforms);
+  const peerDeletionMtimeMs = parseDeletionMtimes(input.peerDeletionMtimeMs, "peer", namespace, effectivePlatforms);
   const entries = [];
   if (base) for (const basePath of base.keys()) assertNoPathAlias(caseFold, basePath, namespace);
   const seenLocal = /* @__PURE__ */ new Map();
   for (const rawLocal of localCensus) {
-    const localFile = assertCensusRecord(rawLocal, "local", namespace);
+    const localFile = assertCensusRecord(rawLocal, "local", namespace, effectivePlatforms);
     const path = localFile.path;
     assertNoPathAlias(caseFold, path, namespace);
     const seen = seenLocal.get(path);
@@ -277,12 +271,7 @@ function planNamespaceReconciliation(input, options = {}) {
     if (!peerFile) {
       if (baseSha256 !== void 0) {
         const peerDeletionMtime = peerDeletionMtimeMs.get(path);
-        const resolution2 = baseSha256 === localFile.sha256 ? "unresolved" : resolveConflict(
-          policy,
-          localFile.mtimeMs,
-          peerDeletionMtime,
-          "unresolved"
-        );
+        const resolution2 = baseSha256 === localFile.sha256 ? "unresolved" : resolveConflict(policy, localFile.mtimeMs, peerDeletionMtime, "unresolved");
         entries.push({
           path,
           namespace,
@@ -340,12 +329,7 @@ function planNamespaceReconciliation(input, options = {}) {
       });
       continue;
     }
-    const resolution = resolveConflict(
-      policy,
-      localFile.mtimeMs,
-      peerFile.mtimeMs,
-      "supersede-link"
-    );
+    const resolution = resolveConflict(policy, localFile.mtimeMs, peerFile.mtimeMs, "supersede-link");
     entries.push({
       path,
       namespace,
@@ -374,12 +358,7 @@ function planNamespaceReconciliation(input, options = {}) {
     }
     if (baseSha256 !== void 0) {
       const localDeletionMtime = localDeletionMtimeMs.get(path);
-      const resolution = baseSha256 === peerFile.sha256 ? "unresolved" : resolveConflict(
-        policy,
-        localDeletionMtime,
-        peerFile.mtimeMs,
-        "unresolved"
-      );
+      const resolution = baseSha256 === peerFile.sha256 ? "unresolved" : resolveConflict(policy, localDeletionMtime, peerFile.mtimeMs, "unresolved");
       entries.push({
         path,
         namespace,
@@ -414,7 +393,9 @@ function summarizeReconcilePlan(entries) {
     const needsOperator = entry.resolution === "unresolved" || entry.resolution === "supersede-link";
     if (entry.action === "conflict" && needsOperator) report.unresolved += 1;
   }
-  return [...byNamespace.values()].sort((a, b) => a.namespace === b.namespace ? 0 : a.namespace < b.namespace ? -1 : 1);
+  return [...byNamespace.values()].sort(
+    (a, b) => a.namespace === b.namespace ? 0 : a.namespace < b.namespace ? -1 : 1
+  );
 }
 function planReconciliation(namespaces, options = {}) {
   if (!Array.isArray(namespaces)) {
@@ -452,4 +433,4 @@ export {
   summarizeReconcilePlan,
   planReconciliation
 };
-//# sourceMappingURL=chunk-ZRUEP4IK.js.map
+//# sourceMappingURL=chunk-JIM4BIOC.js.map

package/dist/chunk-JIM4BIOC.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/reconcile/plan.ts"],"sourcesContent":["import { CENSUS_MAX_MTIME_MS, isCensusMtimeMs, isSha256Hex } from \"../census-validation.js\";\nimport { normalizeNamespaceIdentity } from \"../namespaces/identity.js\";\nimport { validateArchiveRelativePath } from \"../transfer/fs-utils.js\";\nimport type { OfflineSyncFileState } from \"../offline-sync.js\";\nimport { CONVERGE_CONFLICT_POLICIES, DEFAULT_CONVERGE_CONFLICT_POLICY } from \"../converge-config.js\";\nimport type { ConvergeConflictPolicy } from \"../types.js\";\nexport type ReconcileConflictPolicy = ConvergeConflictPolicy;\n\n/**\n * Bootstrap reconciliation planner for two peer daemons whose corpora have\n * already diverged (issue #2150).\n *\n * The offline-sync protocol assumes a satellite that shares a common base with\n * one daemon: every path it does not know about is a pull, and a conflict is\n * rare. Two long-lived daemons are the opposite case — each side holds months\n * of history the other never saw, both sides are authoritative, and there is\n * NO common base on the first run. That is a different decision problem, so it\n * gets its own planner rather than another mode flag inside `applyOfflineSync*`.\n *\n * This module is deliberately pure: it takes two file censuses and returns what\n * to do. No I/O, no transport, no clock. Everything that makes reconciliation\n * risky — which side wins, what counts as converged, what is reported — is\n * decided here where it can be exhaustively tested, and the transport layer is\n * left to carry out an already-settled plan.\n */\n\n/** Which way a path must move for the two corpora to agree. */\nexport type ReconcileAction = \"pull\" | \"push\" | \"identical\" | \"conflict\" | \"suppress\";\n\n/**\n * What the planner decided for a conflicting path.\n * `supersede-link` records that both revisions need durable preservation when\n * timestamps cannot safely select a winner. Apply must stop until transport\n * can assign distinct durable identities to both revisions.\n */\nexport type ReconcileResolution = \"local-wins\" | \"peer-wins\" | \"supersede-link\" | \"unresolved\";\n\nexport interface ReconcileSemanticFileState {\n  path: string;\n  sha256: string;\n}\n\nexport interface ReconcileSemanticAgreement {\n  local: ReconcileSemanticFileState;\n  peer: ReconcileSemanticFileState;\n}\n\nexport type ReconcileSemanticChange = \"unchanged\" | \"local_changed\" | \"peer_changed\" | \"both_modified\";\n\nexport interface ReconcilePlanEntry {\n  path: string;\n  namespace: string;\n  action: ReconcileAction;\n  /** Stable machine-readable cause, safe to assert on and to aggregate. */\n  reason: ReconcileReason;\n  localSha256?: string;\n  peerSha256?: string;\n  /** Present only when a prior converged run left a cursor covering this path. */\n  baseSha256?: string;\n  /** Set only when `action` is `conflict`. */\n  resolution?: ReconcileResolution;\n  /** Original revision time when conflict resolution propagates a deletion. */\n  deletionMtimeMs?: number;\n  /**\n   * Which side holds the retracted revision. Set only when `action` is\n   * `suppress`: with different digests on each side and only one retracted,\n   * the entry would otherwise be identical either way and transport could\n   * delete the live copy instead of the retracted one.\n   */\n  suppressSide?: \"local\" | \"peer\" | \"both\";\n  /**\n   * Real per-side identities for a cross-path semantic agreement. Synthetic\n   * rows omit the top-level side digests because `path` cannot name both files.\n   */\n  semanticAgreement?: ReconcileSemanticAgreement;\n  /** Each side's current digest compared with its own prior semantic digest. */\n  semanticChange?: ReconcileSemanticChange;\n}\n\nexport type ReconcileReason =\n  | \"peer_only\"\n  | \"local_only\"\n  /** Cursor showed only that side moved since agreement; both still hold the path. */\n  | \"peer_changed\"\n  | \"local_changed\"\n  | \"same_content\"\n  | \"semantic_duplicate\"\n  | \"both_modified\"\n  | \"peer_deleted\"\n  | \"local_deleted\"\n  /** Peer deleted it while this side edited it — the offline-sync delete/modify pair. */\n  | \"local_modified_peer_deleted\"\n  | \"local_deleted_peer_modified\"\n  | \"tombstoned\";\n\nexport interface ReconcileNamespaceReport {\n  namespace: string;\n  pull: number;\n  push: number;\n  identical: number;\n  conflict: number;\n  /** Local retractions the peer must be told about before the pair agrees. */\n  suppress: number;\n  /**\n   * Conflicts still needing an operator: those the policy declined to settle,\n   * plus supersede links whose direction could not be determined.\n   */\n  unresolved: number;\n}\n\nexport interface ReconcilePlan {\n  entries: ReconcilePlanEntry[];\n  byNamespace: ReconcileNamespaceReport[];\n  /**\n   * True when the two corpora already agree — every shared path matches and\n   * neither side holds a path the other lacks.\n   *\n   * This is the idempotency contract from #2150: running reconciliation against\n   * an already-converged peer must be a no-op, and a caller can skip the whole\n   * transfer phase on this flag alone.\n   */\n  converged: boolean;\n}\n\n/** Minimal shape the planner needs; `OfflineSyncFileState` satisfies it. */\nexport type ReconcileFileState = Pick<OfflineSyncFileState, \"path\" | \"sha256\"> &\n  Partial<Pick<OfflineSyncFileState, \"mtimeMs\" | \"bytes\">>;\n\nexport interface ReconcileNamespaceInput {\n  namespace: string;\n  local: Iterable<ReconcileFileState>;\n  peer: Iterable<ReconcileFileState>;\n  /**\n   * File states agreed at the end of the last converged run with THIS peer.\n   * Absent on a bootstrap merge, which is why a path missing from one side is\n   * read as \"never seen\" rather than \"deleted\".\n   */\n  base?: Iterable<ReconcileFileState>;\n  /**\n   * Revision timestamps for paths deleted locally since the base cursor.\n   * A deletion is a revision and must carry a comparable time for\n   * `newest-wins`; absence alone has no timestamp.\n   */\n  localDeletionMtimeMs?: ReadonlyMap<string, number>;\n  /** Revision timestamps for paths deleted by the peer since the base cursor. */\n  peerDeletionMtimeMs?: ReadonlyMap<string, number>;\n  /**\n   * Digests of FILES this side has retracted, in the same form as\n   * `ReconcileFileState.sha256` — a hash of the serialized file.\n   *\n   * Deliberately NOT `TombstoneEntry.contentHash`, which hashes the canonical\n   * raw fact text and therefore never equals a file digest (§13: one content\n   * form, everywhere). Mapping retracted fact hashes onto the file digests that\n   * carry them is the caller's job, because only the caller can read its own\n   * corpus; handing this the wrong form would silently plan `pull` and\n   * resurrect every retracted fact, so the parameter name states the form.\n   */\n  tombstonedFileSha256?: Iterable<string>;\n  /**\n   * Digests the PEER has retracted, same form.\n   *\n   * Without this a bootstrap merge cannot tell \"the peer never had it\" from\n   * \"the peer deliberately retracted it\": the peer census simply omits both,\n   * so a file we still hold is planned `push` and the peer's retraction is\n   * undone. Reconciliation is symmetric, so retraction has to be too.\n   *\n   * SCOPE: these sets decide what happens to files that still EXIST on one\n   * side. Sharing the retraction records themselves is not modelled here -\n   * tombstones are corpus files (`state/tombstones.jsonl`), so they reconcile\n   * as ordinary paths through this same plan. A digest both censuses have\n   * already dropped therefore produces no entry, by design: there is no file\n   * left to act on, and synthesizing a path-less entry would hand transport\n   * something it cannot apply.\n   */\n  peerTombstonedFileSha256?: Iterable<string>;\n}\n\nexport interface ReconcileOptions {\n  conflictPolicy?: ConvergeConflictPolicy;\n  /**\n   * Platform whose filesystem constraints the portability gates enforce\n   * (trailing dot/space, Windows-invalid characters, reserved device names).\n   * Defaults to the local platform: a POSIX planner may reason about\n   * POSIX-origin paths that carry characters Windows cannot store, because\n   * that plan will never be applied on a Windows participant. Injectable so\n   * the Windows branches stay testable from any platform.\n   */\n  localPlatform?: NodeJS.Platform;\n  /**\n   * Platform of the PEER participant when known (advertised via the\n   * offline-sync capabilities route). Push entries materialize on the peer,\n   * so Windows path hazards apply when EITHER participant is win32.\n   */\n  peerPlatform?: string;\n}\n\n/**\n * A census the planner refuses to reason about.\n *\n * Dropping a malformed or contradictory record would let the planner return\n * `converged: true` for a corpus it could not actually read, and transport is\n * invited to skip everything on that flag — so bad input fails loudly instead\n * (§1/§39).\n */\nexport class ReconcilePlanInputError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = \"ReconcilePlanInputError\";\n  }\n}\n\n/** Shared with offline-sync's census validation (issue #2477): one acceptance set. */\n\n/**\n * Validate a census record's identity fields.\n *\n * The digest matters as much as the path: two records that both omit `sha256`\n * compare `undefined === undefined` and plan as `identical`, converging a\n * corpus the planner never actually read.\n */\nfunction assertCensusRecord(\n  file: ReconcileFileState | undefined,\n  side: string,\n  namespace: string,\n  platforms: readonly (string | undefined)[]\n): ReconcileFileState {\n  const path = file?.path;\n  if (typeof path !== \"string\" || path.length === 0) {\n    throw new ReconcilePlanInputError(\n      `reconcile: ${side} census for namespace ${namespace} contains a record with no path`\n    );\n  }\n  // Same boundary offline-sync applies to this field: a peer census is\n  // untrusted input, and an absolute or traversal path would otherwise become\n  // a transfer instruction pointing outside the corpus root.\n  try {\n    validateArchiveRelativePath(path, `reconcile: ${side} census for namespace ${namespace}`);\n  } catch (err) {\n    throw new ReconcilePlanInputError(err instanceof Error ? err.message : String(err));\n  }\n  assertPortablePathSegments(path, side, namespace, platforms);\n  return {\n    ...file,\n    path,\n    sha256: assertDigest(file?.sha256, `${side} census for namespace ${namespace} entry ${path}`),\n    ...(file?.mtimeMs === undefined\n      ? {}\n      : { mtimeMs: assertMtimeMs(file.mtimeMs, `${side} census for namespace ${namespace} entry ${path}`) }),\n  };\n}\n\n/**\n * `newest-wins` decides which corpus keeps its history from this number, so a\n * NaN, an Infinity or a value past the Date range must not pick the winner.\n *\n * Fractional values ARE valid: `fs.stat()` reports sub-millisecond mtimes on\n * common filesystems and offline-sync forwards them unrounded, so this matches\n * its `assertOfflineSyncMtimeMs` — non-negative finite within Date range — and\n * deliberately does not require an integer.\n */\nfunction assertMtimeMs(value: unknown, context: string): number {\n  if (!isCensusMtimeMs(value)) {\n    throw new ReconcilePlanInputError(\n      `reconcile: ${context} has an out-of-range mtimeMs; expected a finite value between 0 and ${CENSUS_MAX_MTIME_MS}`\n    );\n  }\n  return value;\n}\n\n/**\n * Digests are canonicalized to lowercase, exactly as offline-sync's\n * `assertSha256` does. Keeping the caller's spelling would make two forms of\n * one digest compare unequal, so identical files would plan `both_modified`\n * and tombstone lookups would silently miss.\n */\nfunction assertDigest(value: unknown, context: string): string {\n  if (!isSha256Hex(value)) {\n    throw new ReconcilePlanInputError(`reconcile: ${context} must carry a 64-character sha256 hex digest`);\n  }\n  return value.toLowerCase();\n}\n\nfunction isPlainObject(value: unknown): boolean {\n  if (value === null || typeof value !== \"object\" || Array.isArray(value)) return false;\n  const proto: unknown = Object.getPrototypeOf(value);\n  return proto === Object.prototype || proto === null;\n}\n\nfunction assertNamespace(namespace: unknown): string {\n  if (typeof namespace !== \"string\" || namespace.length === 0) {\n    throw new ReconcilePlanInputError(\"reconcile: every namespace input needs a non-empty namespace\");\n  }\n  // `team` and ` team ` are one namespace to the rest of core, so accepting\n  // both here would slip two inputs past the duplicate check and let them plan\n  // contradictory actions for the same path. Rejected rather than silently\n  // rewritten, so the namespace on every entry is the caller's own string.\n  if (LONE_SURROGATE.test(namespace)) {\n    // `namespaceIdentityToken()` encodes through TextEncoder, so a lone\n    // surrogate and a literal U+FFFD collapse to ONE storage identity while\n    // comparing as two here - slipping both past the duplicate-namespace guard.\n    throw new ReconcilePlanInputError(\n      \"reconcile: namespace contains an unpaired surrogate; it would collide with another namespace on disk\"\n    );\n  }\n  if (normalizeNamespaceIdentity(namespace) !== namespace) {\n    throw new ReconcilePlanInputError(\n      `reconcile: namespace ${JSON.stringify(namespace)} is not canonical; pass ${JSON.stringify(normalizeNamespaceIdentity(namespace))}`\n    );\n  }\n  return namespace;\n}\n\nfunction assertIterable(value: unknown, side: string, namespace: string): Iterable<ReconcileFileState> {\n  if (\n    value === null ||\n    typeof value !== \"object\" ||\n    typeof (value as Iterable<ReconcileFileState>)[Symbol.iterator] !== \"function\"\n  ) {\n    throw new ReconcilePlanInputError(`reconcile: ${side} census for namespace ${namespace} must be iterable`);\n  }\n  return value as Iterable<ReconcileFileState>;\n}\n\n/**\n * Two paths that a participant's filesystem resolves to ONE file must not draw\n * separate push/pull work, or application order decides which revision\n * survives. Remnic is explicitly multi-platform, so all three aliasing rules\n * are folded together and a collision is rejected rather than raced:\n * case (macOS, Windows), Unicode normalization (macOS stores decomposed and\n * compares canonically), and Win32 trailing dots/spaces, which the Windows API\n * strips before touching disk.\n */\n// eslint-disable-next-line no-control-regex -- control characters are exactly what this rejects\nconst WIN32_INVALID_CHARS = /[<>:\"|?*\\u0000-\\u001f]/;\n// Windows treats the superscripts as their digits in COM/LPT device names.\nconst LONE_SURROGATE = /[\\ud800-\\udbff](?![\\udc00-\\udfff])|(?<![\\ud800-\\udbff])[\\udc00-\\udfff]/;\nconst WIN32_RESERVED_NAMES = /^(con|prn|aux|nul|(com|lpt)[1-9\\u00b9\\u00b2\\u00b3])$/i;\n\nfunction assertPortablePathSegments(\n  path: string,\n  side: string,\n  namespace: string,\n  platforms: readonly (string | undefined)[]\n): void {\n  // Windows-only hazards (trailing dot/space stripping, invalid characters\n  // like `:`, reserved device names) only constrain a plan whose LOCAL\n  // participant would materialize those paths on Windows. POSIX-origin\n  // corpora legitimately contain `:` (e.g. sqlite sidecar names), so the\n  // gates are skipped for non-win32 planners. The lone-surrogate check is\n  // UNCONDITIONAL: Node mangles unpaired surrogates identically everywhere,\n  // which corrupts cross-platform path comparison itself.\n  const isWindows = platforms.some((candidate) => candidate === \"win32\");\n  for (const segment of path.split(\"/\")) {\n    if (segment.length === 0) continue;\n    if (isWindows && (segment.endsWith(\".\") || segment.endsWith(\" \"))) {\n      throw new ReconcilePlanInputError(\n        `reconcile: ${side} census for namespace ${namespace} path ${path} has a segment ending in a dot or space; ` +\n          \"Windows strips those and would alias it onto another file\"\n      );\n    }\n    // `:` opens an alternate data stream, the rest cannot be created at all,\n    // and a reserved device name resolves to hardware. A plan containing any of\n    // them cannot be applied on a Windows participant.\n    if (LONE_SURROGATE.test(segment)) {\n      // Node encodes an unpaired surrogate as U+FFFD, so this path and a\n      // literal U+FFFD path are one file on disk while comparing as distinct.\n      throw new ReconcilePlanInputError(\n        `reconcile: ${side} census for namespace ${namespace} path ${path} contains an unpaired surrogate`\n      );\n    }\n    if (isWindows && WIN32_INVALID_CHARS.test(segment)) {\n      throw new ReconcilePlanInputError(\n        `reconcile: ${side} census for namespace ${namespace} path ${path} contains a character Windows cannot store`\n      );\n    }\n    if (isWindows && WIN32_RESERVED_NAMES.test(segment.split(\".\")[0] ?? \"\")) {\n      throw new ReconcilePlanInputError(\n        `reconcile: ${side} census for namespace ${namespace} path ${path} uses a reserved Windows device name`\n      );\n    }\n  }\n}\n\nfunction assertNoPathAlias(seen: Map<string, string>, path: string, namespace: string): void {\n  // NFC first: macOS stores decomposed names and compares canonically, so\n  // `é` (U+00E9) and `é` (e + U+0301) are ONE file there. Then a FULL caseless\n  // fold - upper-then-lower, which collapses forms a bare toLowerCase() keeps\n  // apart, such as final sigma `ς` against `σ`. Lowercasing alone would leave\n  // those distinct and the planner would emit both a push and a pull.\n  // `ß` upper-folds to `ss` while `ẞ` folds to `ß`, so one more pass equalizes\n  // the pair that a single upper-then-lower still leaves apart.\n  const folded = path\n    .normalize(\"NFC\")\n    .toUpperCase()\n    .toLowerCase()\n    .replace(/\\u00df/g, \"ss\");\n  const existing = seen.get(folded);\n  if (existing !== undefined && existing !== path) {\n    throw new ReconcilePlanInputError(\n      `reconcile: namespace ${namespace} has aliasing paths (${existing}, ${path}); ` +\n        \"they resolve to one file on a case-insensitive or Unicode-normalizing peer\"\n    );\n  }\n  seen.set(folded, path);\n}\n\n/**\n * Duplicate paths are accepted only when they agree. Two digests for one path\n * make the plan depend on which record arrived last, which would break the\n * byte-stable ordering the convergence report relies on.\n */\nfunction rejectConflictingDuplicate(\n  existing: { sha256: string; mtimeMs?: number } | undefined,\n  incoming: { sha256: string; mtimeMs?: number },\n  path: string,\n  side: string,\n  namespace: string\n): boolean {\n  if (!existing) return false;\n  if (existing.sha256 !== incoming.sha256) {\n    throw new ReconcilePlanInputError(\n      `reconcile: ${side} census for namespace ${namespace} lists ${path} twice with different digests`\n    );\n  }\n  // Same bytes but a different mtime is still ambiguous: `newest-wins` reads\n  // that timestamp, so accepting the first arrival would let input order decide\n  // the winner.\n  if (existing.mtimeMs !== incoming.mtimeMs) {\n    throw new ReconcilePlanInputError(\n      `reconcile: ${side} census for namespace ${namespace} lists ${path} twice with different mtimeMs`\n    );\n  }\n  return true;\n}\n\nfunction indexByPath(\n  files: Iterable<ReconcileFileState>,\n  side: string,\n  namespace: string,\n  platforms: readonly (string | undefined)[]\n): Map<string, ReconcileFileState> {\n  const index = new Map<string, ReconcileFileState>();\n  for (const raw of files) {\n    const file = assertCensusRecord(raw, side, namespace, platforms);\n    if (rejectConflictingDuplicate(index.get(file.path), file, file.path, side, namespace)) continue;\n    index.set(file.path, file);\n  }\n  return index;\n}\n\n/**\n * A bare string satisfies `Iterable<string>`, and `new Set(\"abc…\")` would split\n * it into 64 one-character members — every membership test then misses and each\n * retracted file is planned as `pull` and resurrected. Reject the scalar and\n * canonicalize every member.\n */\nfunction parseTombstonedDigests(\n  value: Iterable<string> | undefined,\n  namespace: string,\n  field = \"tombstonedFileSha256\"\n): Set<string> {\n  if (value === undefined) return new Set();\n  if (typeof value === \"string\") {\n    throw new ReconcilePlanInputError(\n      `reconcile: ${field} for namespace ${namespace} must be a collection of digests, not a single string`\n    );\n  }\n  if (value === null || typeof value !== \"object\" || typeof value[Symbol.iterator] !== \"function\") {\n    // Otherwise the for...of below throws a raw TypeError and a caller handling\n    // ReconcilePlanInputError cannot tell a bad request from a planner bug.\n    throw new ReconcilePlanInputError(\n      `reconcile: ${field} for namespace ${namespace} must be an iterable collection of digests`\n    );\n  }\n  const digests = new Set<string>();\n  for (const entry of value) {\n    digests.add(assertDigest(entry, `${field} for namespace ${namespace}`));\n  }\n  return digests;\n}\n\n/**\n * Validate a census while keeping ONLY path -> digest.\n *\n * The base cursor is read for digests alone, so indexing full records and\n * compacting afterwards would hold a corpus-sized record map and its copy at\n * once - the peak this avoids.\n */\nfunction indexDigestsByPath(\n  files: Iterable<ReconcileFileState>,\n  side: string,\n  namespace: string,\n  platforms: readonly (string | undefined)[]\n): Map<string, string> {\n  const index = new Map<string, string>();\n  for (const raw of files) {\n    const file = assertCensusRecord(raw, side, namespace, platforms);\n    const existing = index.get(file.path);\n    // One map, not a parallel `seen`: the base's own mtimeMs is never a\n    // decision input (only the local and peer timestamps order a conflict), so\n    // a duplicate that agrees on the digest is unambiguous here regardless of\n    // its timestamp, and the digest alone is enough to detect a real clash.\n    if (existing !== undefined) {\n      if (existing !== file.sha256) {\n        throw new ReconcilePlanInputError(\n          `reconcile: ${side} census for namespace ${namespace} lists ${file.path} twice with different digests`\n        );\n      }\n      continue;\n    }\n    index.set(file.path, file.sha256);\n  }\n  return index;\n}\n\nfunction assertConflictPolicy(value: ConvergeConflictPolicy | undefined): ConvergeConflictPolicy {\n  if (value === undefined) return DEFAULT_CONVERGE_CONFLICT_POLICY;\n  if (!CONVERGE_CONFLICT_POLICIES.includes(value)) {\n    throw new ReconcilePlanInputError(\n      `reconcile: unknown conflictPolicy ${JSON.stringify(value)}; expected one of ${CONVERGE_CONFLICT_POLICIES.join(\", \")}`\n    );\n  }\n  return value;\n}\n\n/**\n * Total ordering for plan entries (§12): namespace, then path. Both are unique\n * per entry, so equal keys are impossible and the comparator never has to\n * return 0 for distinct rows — the output is byte-identical across runs, which\n * is what makes a convergence report diffable. Cursor and manifest sort with\n * this same export; a local copy on either side is how ordering drifts (§2477).\n */\nexport function compareReconcilePlanEntries(a: ReconcilePlanEntry, b: ReconcilePlanEntry): number {\n  if (a.namespace !== b.namespace) return a.namespace < b.namespace ? -1 : 1;\n  if (a.path !== b.path) return a.path < b.path ? -1 : 1;\n  return 0;\n}\n\n/**\n * Identity of a semantic-duplicate pair: the ordered (local, peer) path pair.\n * Cursor derivation and manifest collapse must key prior agreements with this\n * same export or a stored cursor stops matching the plan that wrote it.\n */\nexport function semanticAgreementKey(agreement: ReconcileSemanticAgreement): string {\n  return `${agreement.local.path}\\0${agreement.peer.path}`;\n}\n\nfunction resolveConflict(\n  policy: ConvergeConflictPolicy,\n  localMtimeMs: number | undefined,\n  peerMtimeMs: number | undefined,\n  missingTimestampResolution: ReconcileResolution\n): ReconcileResolution {\n  if (policy !== \"newest-wins\") return \"unresolved\";\n  if (localMtimeMs === undefined || peerMtimeMs === undefined || localMtimeMs === peerMtimeMs) {\n    return missingTimestampResolution;\n  }\n  return localMtimeMs > peerMtimeMs ? \"local-wins\" : \"peer-wins\";\n}\n\nfunction parseDeletionMtimes(\n  value: ReadonlyMap<string, number> | undefined,\n  side: string,\n  namespace: string,\n  platforms: readonly (string | undefined)[]\n): ReadonlyMap<string, number> {\n  if (value === undefined) return new Map();\n  if (!(value instanceof Map)) {\n    throw new ReconcilePlanInputError(`reconcile: ${side} deletion mtimes for namespace ${namespace} must be a Map`);\n  }\n  const parsed = new Map<string, number>();\n  for (const [path, mtimeMs] of value) {\n    try {\n      validateArchiveRelativePath(path, `reconcile: ${side} deletion mtimes for namespace ${namespace}`);\n    } catch (err) {\n      throw new ReconcilePlanInputError(err instanceof Error ? err.message : String(err));\n    }\n    assertPortablePathSegments(path, side, namespace, platforms);\n    parsed.set(path, assertMtimeMs(mtimeMs, `${side} deletion for namespace ${namespace} entry ${path}`));\n  }\n  return parsed;\n}\n\n/**\n * Plan one namespace. Exposed for callers that stream namespaces one at a time.\n *\n * Residency is one peer index + a set of local paths + the entry list. The\n * local census is consumed as a stream and never materialized, so a 100k-file\n * corpus does not hold two full censuses at once — but this is NOT constant\n * memory, and a caller holding its own census arrays adds to that.\n */\nexport function planNamespaceReconciliation(\n  input: ReconcileNamespaceInput,\n  options: ReconcileOptions = {}\n): ReconcilePlanEntry[] {\n  if (!isPlainObject(input)) {\n    throw new ReconcilePlanInputError(\"reconcile: namespace input must be a plain object\");\n  }\n  if (!isPlainObject(options)) {\n    // A Date, Map or RegExp passes a bare typeof check, exposes no\n    // `conflictPolicy`, and would silently take the default policy - hiding a\n    // malformed request behind `manual`.\n    throw new ReconcilePlanInputError(\"reconcile: options must be a plain object\");\n  }\n  const namespace = assertNamespace(input.namespace);\n  const policy = assertConflictPolicy(options.conflictPolicy);\n  const localCensus = assertIterable(input.local, \"local\", namespace);\n  const caseFold = new Map<string, string>();\n  // Index the peer census only, then stream the local one against it, removing\n  // each match as it is consumed. Peak residency is one index plus the entry\n  // list rather than two full censuses (round 2, codex P2).\n  const effectivePlatforms = [options.localPlatform ?? process.platform, options.peerPlatform];\n  const peer = indexByPath(assertIterable(input.peer, \"peer\", namespace), \"peer\", namespace, effectivePlatforms);\n  // Only `base.sha256` is ever read, so the base is compacted to path -> digest\n  // instead of a second full record index (round 7, codex P2).\n  // Only an ABSENT base means bootstrap. A null/invalid cursor silently read as\n  // \"no prior agreement\" would turn a peer-side deletion into a push and\n  // resurrect it.\n  const base =\n    input.base === undefined\n      ? null\n      : indexDigestsByPath(assertIterable(input.base, \"base\", namespace), \"base\", namespace, effectivePlatforms);\n  const tombstoned = parseTombstonedDigests(input.tombstonedFileSha256, namespace);\n  const peerTombstoned = parseTombstonedDigests(input.peerTombstonedFileSha256, namespace, \"peerTombstonedFileSha256\");\n  const localDeletionMtimeMs = parseDeletionMtimes(input.localDeletionMtimeMs, \"local\", namespace, effectivePlatforms);\n  const peerDeletionMtimeMs = parseDeletionMtimes(input.peerDeletionMtimeMs, \"peer\", namespace, effectivePlatforms);\n  const entries: ReconcilePlanEntry[] = [];\n\n  // Path -> digest only, never the file objects: enough to make the stream\n  // idempotent and to catch contradictory duplicates without materializing the\n  // second census.\n  // Base paths participate in the collision check: a base `Facts/A.md` against\n  // a local `facts/a.md` is the same delete/change ambiguity on a\n  // case-insensitive participant.\n  if (base) for (const basePath of base.keys()) assertNoPathAlias(caseFold, basePath, namespace);\n  // Path -> decision-relevant fields only, never the whole record: enough to\n  // make the stream idempotent and to catch contradictory duplicates without\n  // materializing the second census.\n  const seenLocal = new Map<string, { sha256: string; mtimeMs?: number }>();\n  for (const rawLocal of localCensus) {\n    const localFile = assertCensusRecord(rawLocal, \"local\", namespace, effectivePlatforms);\n    const path = localFile.path;\n    assertNoPathAlias(caseFold, path, namespace);\n    const seen = seenLocal.get(path);\n    if (seen !== undefined) {\n      // Same rule the indexed censuses get: mtimeMs is decision-relevant under\n      // `newest-wins`, so a duplicate that disagrees on it is ambiguous too.\n      if (rejectConflictingDuplicate(seen, localFile, path, \"local\", namespace)) continue;\n    }\n    seenLocal.set(path, { sha256: localFile.sha256, mtimeMs: localFile.mtimeMs });\n    const peerFile = peer.get(path);\n    // Consumed: whatever remains in the index afterwards is peer-only.\n    peer.delete(path);\n    const baseSha256 = base?.get(path);\n    // Retraction outranks every other decision for this path, on EITHER side.\n    // Checked before hash comparison and conflict resolution: a retracted peer\n    // revision reaching the conflict ladder can win under `newest-wins`, and a\n    // retracted LOCAL revision would otherwise be pushed - which is also how a\n    // suppression undoes itself on the next run, since the local copy survives\n    // the peer-side delete (round 4).\n    // Either side's retraction removes the copy that carries the digest, so a\n    // peer retraction of something we still hold suppresses OUR copy rather\n    // than pushing it back.\n    const localRetracted = tombstoned.has(localFile.sha256) || peerTombstoned.has(localFile.sha256);\n    const peerRetracted =\n      peerFile !== undefined && (tombstoned.has(peerFile.sha256) || peerTombstoned.has(peerFile.sha256));\n    if (localRetracted || peerRetracted) {\n      entries.push({\n        path,\n        namespace,\n        action: \"suppress\",\n        reason: \"tombstoned\",\n        localSha256: localFile.sha256,\n        ...(peerFile ? { peerSha256: peerFile.sha256 } : {}),\n        ...(baseSha256 === undefined ? {} : { baseSha256 }),\n        suppressSide: localRetracted && peerRetracted ? \"both\" : localRetracted ? \"local\" : \"peer\",\n      });\n      continue;\n    }\n    if (!peerFile) {\n      // Base PRESENCE is what proves a deletion, not equality with whatever the\n      // surviving side now holds. If we also edited since the base, this is\n      // delete-versus-modify: still a conflict, and pushing it would resurrect\n      // a deliberate deletion. Without a base the peer simply never saw the\n      // path, and a bootstrap merge must push — both sides hold unique data.\n      if (baseSha256 !== undefined) {\n        const peerDeletionMtime = peerDeletionMtimeMs.get(path);\n        const resolution =\n          baseSha256 === localFile.sha256\n            ? \"unresolved\"\n            : resolveConflict(policy, localFile.mtimeMs, peerDeletionMtime, \"unresolved\");\n        entries.push({\n          path,\n          namespace,\n          action: \"conflict\",\n          reason: baseSha256 === localFile.sha256 ? \"peer_deleted\" : \"local_modified_peer_deleted\",\n          localSha256: localFile.sha256,\n          baseSha256,\n          resolution,\n          ...(resolution === \"peer-wins\" && peerDeletionMtime !== undefined\n            ? { deletionMtimeMs: peerDeletionMtime }\n            : {}),\n        });\n        continue;\n      }\n      entries.push({\n        path,\n        namespace,\n        action: \"push\",\n        reason: \"local_only\",\n        localSha256: localFile.sha256,\n      });\n      continue;\n    }\n    if (peerFile.sha256 === localFile.sha256) {\n      entries.push({\n        path,\n        namespace,\n        action: \"identical\",\n        reason: \"same_content\",\n        localSha256: localFile.sha256,\n        peerSha256: peerFile.sha256,\n        ...(baseSha256 === undefined ? {} : { baseSha256 }),\n      });\n      continue;\n    }\n    // A base that matches one side turns a \"conflict\" into an ordinary\n    // one-sided change: that side is the only one that moved since agreement.\n    if (baseSha256 !== undefined && baseSha256 === localFile.sha256) {\n      entries.push({\n        path,\n        namespace,\n        action: \"pull\",\n        reason: \"peer_changed\",\n        localSha256: localFile.sha256,\n        peerSha256: peerFile.sha256,\n        baseSha256,\n      });\n      continue;\n    }\n    if (baseSha256 !== undefined && baseSha256 === peerFile.sha256) {\n      entries.push({\n        path,\n        namespace,\n        action: \"push\",\n        reason: \"local_changed\",\n        localSha256: localFile.sha256,\n        peerSha256: peerFile.sha256,\n        baseSha256,\n      });\n      continue;\n    }\n    const resolution = resolveConflict(policy, localFile.mtimeMs, peerFile.mtimeMs, \"supersede-link\");\n    entries.push({\n      path,\n      namespace,\n      action: \"conflict\",\n      reason: \"both_modified\",\n      localSha256: localFile.sha256,\n      peerSha256: peerFile.sha256,\n      ...(baseSha256 === undefined ? {} : { baseSha256 }),\n      resolution,\n    });\n  }\n\n  for (const [path, peerFile] of peer) {\n    assertNoPathAlias(caseFold, path, namespace);\n    const baseSha256 = base?.get(path);\n    if (tombstoned.has(peerFile.sha256) || peerTombstoned.has(peerFile.sha256)) {\n      // Retracted here on purpose, and the peer still serves it. Pulling it\n      // back would undo the retraction; calling it `identical` would be worse,\n      // because a converged plan lets transport skip everything and the peer\n      // keeps serving the retracted fact forever. It is work: propagate the\n      // tombstone.\n      entries.push({\n        path,\n        namespace,\n        action: \"suppress\",\n        reason: \"tombstoned\",\n        peerSha256: peerFile.sha256,\n        ...(baseSha256 === undefined ? {} : { baseSha256 }),\n        suppressSide: \"peer\",\n      });\n      continue;\n    }\n    if (baseSha256 !== undefined) {\n      const localDeletionMtime = localDeletionMtimeMs.get(path);\n      const resolution =\n        baseSha256 === peerFile.sha256\n          ? \"unresolved\"\n          : resolveConflict(policy, localDeletionMtime, peerFile.mtimeMs, \"unresolved\");\n      entries.push({\n        path,\n        namespace,\n        action: \"conflict\",\n        reason: baseSha256 === peerFile.sha256 ? \"local_deleted\" : \"local_deleted_peer_modified\",\n        peerSha256: peerFile.sha256,\n        baseSha256,\n        resolution,\n        ...(resolution === \"local-wins\" && localDeletionMtime !== undefined\n          ? { deletionMtimeMs: localDeletionMtime }\n          : {}),\n      });\n      continue;\n    }\n    entries.push({\n      path,\n      namespace,\n      action: \"pull\",\n      reason: \"peer_only\",\n      peerSha256: peerFile.sha256,\n    });\n  }\n\n  return entries.sort(compareReconcilePlanEntries);\n}\n\n/** Aggregate entries into the per-namespace convergence report (#2150). */\nexport function summarizeReconcilePlan(entries: readonly ReconcilePlanEntry[]): ReconcileNamespaceReport[] {\n  const byNamespace = new Map<string, ReconcileNamespaceReport>();\n  for (const entry of entries) {\n    let report = byNamespace.get(entry.namespace);\n    if (!report) {\n      report = { namespace: entry.namespace, pull: 0, push: 0, identical: 0, conflict: 0, suppress: 0, unresolved: 0 };\n      byNamespace.set(entry.namespace, report);\n    }\n    report[entry.action] += 1;\n    const needsOperator = entry.resolution === \"unresolved\" || entry.resolution === \"supersede-link\";\n    if (entry.action === \"conflict\" && needsOperator) report.unresolved += 1;\n  }\n  return [...byNamespace.values()].sort((a, b) =>\n    a.namespace === b.namespace ? 0 : a.namespace < b.namespace ? -1 : 1\n  );\n}\n\n/**\n * Plan a full reconciliation across namespaces.\n *\n * `converged` is an affirmative claim that nothing needs to move, so it is\n * derived from the entries rather than tracked alongside them: any action other\n * than `identical` disproves it.\n */\nexport function planReconciliation(\n  namespaces: readonly ReconcileNamespaceInput[],\n  options: ReconcileOptions = {}\n): ReconcilePlan {\n  if (!Array.isArray(namespaces)) {\n    throw new ReconcilePlanInputError(\"reconcile: planReconciliation expects an array of namespace inputs\");\n  }\n  // Validated here too: with an empty array the per-namespace path never runs,\n  // and a malformed options envelope would return `converged` instead of\n  // raising - the same call failing or succeeding based on list length.\n  if (!isPlainObject(options)) {\n    throw new ReconcilePlanInputError(\"reconcile: options must be a plain object\");\n  }\n  assertConflictPolicy(options.conflictPolicy);\n  const entries: ReconcilePlanEntry[] = [];\n  // Two inputs for one namespace are planned independently, so the same\n  // (namespace, path) can draw contradictory actions - and because those\n  // entries also sort equal, batch order would decide which revision survives.\n  const seenNamespaces = new Set<string>();\n  for (const namespace of namespaces) {\n    const name = assertNamespace(namespace?.namespace);\n    if (seenNamespaces.has(name)) {\n      throw new ReconcilePlanInputError(\n        `reconcile: namespace ${name} appears twice; merge its censuses before planning`\n      );\n    }\n    seenNamespaces.add(name);\n    entries.push(...planNamespaceReconciliation(namespace, options));\n  }\n  entries.sort(compareReconcilePlanEntries);\n  return {\n    entries,\n    byNamespace: summarizeReconcilePlan(entries),\n    converged: entries.every((entry) => entry.action === \"identical\"),\n  };\n}\n"],"mappings":"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","names":["resolution"]}

package/dist/{chunk-BX6GW4KC.js → chunk-JMAG7WZ7.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-B7RWBZXW.js";
 import {
   resolveCausalTrajectoryStoreDir
-} from "./chunk-P6GKRT2H.js";
+} from "./chunk-2Z3DG5CQ.js";
 import {
   normalizeRecallTokens
 } from "./chunk-YCVB7X56.js";
@@ -339,4 +339,4 @@ export {
   scoreStitchCandidate,
   stitchCausalChain
 };
-//# sourceMappingURL=chunk-BX6GW4KC.js.map
+//# sourceMappingURL=chunk-JMAG7WZ7.js.map

package/dist/{chunk-NF3NMAG7.js → chunk-JOYC4RYC.js}

@@ -1,6 +1,6 @@
 import {
   isRecallDisclosure
-} from "./chunk-OYV6RKPM.js";
+} from "./chunk-XOQGUGJL.js";
 import {
   estimateTokenCount
 } from "./chunk-TOTT6S2V.js";
@@ -304,4 +304,4 @@ export {
   RecallXrayBuilder,
   summarizeDisclosureTokens
 };
-//# sourceMappingURL=chunk-NF3NMAG7.js.map
+//# sourceMappingURL=chunk-JOYC4RYC.js.map

package/dist/{chunk-5JQV4T5Q.js → chunk-JZ6EYAVP.js}

@@ -1,7 +1,7 @@
 import {
   SupportPassportError,
   getOperation
-} from "./chunk-MSDIETFC.js";
+} from "./chunk-IZZ7Q2RJ.js";
 import {
   abortError,
   isAbortError
@@ -499,4 +499,4 @@ export {
   buildSupportPassportPublicRequestHandler,
   composeSupportPassportExternalRequestHandlers
 };
-//# sourceMappingURL=chunk-5JQV4T5Q.js.map
+//# sourceMappingURL=chunk-JZ6EYAVP.js.map

package/dist/{chunk-QRDSXR3V.js → chunk-KA2HZCMG.js}

@@ -1,6 +1,6 @@
 import {
   rebuildMemoryProjection
-} from "./chunk-BEXFNGQ3.js";
+} from "./chunk-DK6GMO6D.js";
 
 // src/convergence-refresh.ts
 async function refreshConvergedNamespaces(namespaces, namespaceSearchRouter, getStorage, searchEnabled) {
@@ -32,4 +32,4 @@ async function refreshConvergedNamespaces(namespaces, namespaceSearchRouter, get
 export {
   refreshConvergedNamespaces
 };
-//# sourceMappingURL=chunk-QRDSXR3V.js.map
+//# sourceMappingURL=chunk-KA2HZCMG.js.map

package/dist/{chunk-7LCGFUMB.js → chunk-KQAFEZQX.js}

@@ -1,12 +1,12 @@
-import {
-  encryptCapsuleFile
-} from "./chunk-X7Y7WX73.js";
 import {
   CAPSULE_ID_PATTERN,
   CapsuleBlockSchema,
   ExportBundleV2Schema,
   ExportManifestV2Schema
 } from "./chunk-WEHSQBFR.js";
+import {
+  encryptCapsuleFile
+} from "./chunk-X7Y7WX73.js";
 import {
   CAPSULE_SCHEMA_VERSION,
   EXPORT_FORMAT
@@ -261,4 +261,4 @@ export {
   exportCapsule,
   isValidCapsuleSince
 };
-//# sourceMappingURL=chunk-7LCGFUMB.js.map
+//# sourceMappingURL=chunk-KQAFEZQX.js.map

package/dist/{chunk-ETZ7KKOS.js → chunk-KTVSPFCQ.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-SOBJ6NEY.js";
 import {
   summarizeDisclosureTokens
-} from "./chunk-NF3NMAG7.js";
+} from "./chunk-JOYC4RYC.js";
 import {
   summarizeRetrievedMemoryProvenance
 } from "./chunk-I4WBNM3M.js";
@@ -606,4 +606,4 @@ export {
   renderRecallExplain,
   parseRecallExplainFormat
 };
-//# sourceMappingURL=chunk-ETZ7KKOS.js.map
+//# sourceMappingURL=chunk-KTVSPFCQ.js.map

package/dist/{chunk-PAWIY5OQ.js → chunk-L74A6NTI.js}

@@ -1,7 +1,7 @@
 import {
   buildStandup,
   parseStandupDate
-} from "./chunk-VAMZYOOV.js";
+} from "./chunk-HOUST5UX.js";
 import {
   backfillMemoryStorage,
   runLocationBackfill,
@@ -9,20 +9,20 @@ import {
   runLocationDay,
   runLocationStatus,
   runLocationSync
-} from "./chunk-5H2G5X4R.js";
+} from "./chunk-ZJWDWPX6.js";
 import {
   externalWikiSearchOperation
-} from "./chunk-C25N5HWX.js";
+} from "./chunk-B2AGUKSS.js";
 import {
   memoryStoreRequestSchema
-} from "./chunk-NHLEFBE2.js";
+} from "./chunk-I4Y6TBD7.js";
 import {
   CorrectionContractError,
   DECISION_SUBCOMMANDS,
   DELTA_SUBCOMMANDS,
   defineOperation,
   isCodegraphToolName
-} from "./chunk-MSDIETFC.js";
+} from "./chunk-IZZ7Q2RJ.js";
 import {
   serializeMutations,
   withHeldFileLock
@@ -1909,4 +1909,4 @@ export {
   codegraphIngestTracesOperation,
   REGISTERED_OPERATIONS
 };
-//# sourceMappingURL=chunk-PAWIY5OQ.js.map
+//# sourceMappingURL=chunk-L74A6NTI.js.map

package/dist/{chunk-2XJDAEAM.js → chunk-LFK623SF.js}

@@ -1,15 +1,15 @@
 import {
   StorageManager
-} from "./chunk-VYD63IFH.js";
+} from "./chunk-OGTKQ5MJ.js";
 import {
   normalizeEntityName
 } from "./chunk-YXZG5TVN.js";
-import {
-  extractJsonCandidates
-} from "./chunk-RGMVMVMF.js";
 import {
   safeReadMemories
 } from "./chunk-UBCBDJOB.js";
+import {
+  extractJsonCandidates
+} from "./chunk-RGMVMVMF.js";
 import {
   excludeSupportPassportPrivateMemories
 } from "./chunk-EEOUMG3J.js";
@@ -957,4 +957,4 @@ export {
   resolveBriefingSaveDir,
   briefingFilename
 };
-//# sourceMappingURL=chunk-2XJDAEAM.js.map
+//# sourceMappingURL=chunk-LFK623SF.js.map

package/dist/chunk-LVE64P5Y.js

@@ -0,0 +1,80 @@
+import {
+  lcmSessionKeyForNamespace
+} from "./chunk-QBC33MPY.js";
+import {
+  log
+} from "./chunk-3WCASNQZ.js";
+
+// src/access-observe-transcript.ts
+import { createHash, randomUUID } from "crypto";
+var OBSERVE_TRANSCRIPT_DEDUPE_MAX_ENTRIES = 8192;
+var OBSERVE_TRANSCRIPT_MIN_CONTENT_CHARS = 10;
+var OBSERVE_TRANSCRIPT_DEDUPE_TTL_MS = 10 * 60 * 1e3;
+function observeTranscriptSessionKey(sessionKey, writeNamespace, config) {
+  return lcmSessionKeyForNamespace(writeNamespace, sessionKey, config.defaultNamespace) ?? sessionKey;
+}
+var ObserveTranscriptPersister = class {
+  seenFingerprintsAt = /* @__PURE__ */ new Map();
+  /** In-flight appends by fingerprint: an overlapping identical observe waits for the first append instead of double-writing. */
+  inflightAppends = /* @__PURE__ */ new Map();
+  /**
+   * Append every eligible message of an observe payload to the per-session
+   * transcript store. Best-effort: a failing append logs and does not fail
+   * the observe. Returns true when at least one turn was appended.
+   */
+  async persist(orchestrator, sessionKey, messages, rawSessionKey) {
+    let persisted = false;
+    const { channelType } = orchestrator.transcript.getTranscriptPath(rawSessionKey ?? sessionKey);
+    if (orchestrator.config.transcriptSkipChannelTypes.includes(channelType)) {
+      return false;
+    }
+    for (const message of messages) {
+      if (message.content.length < OBSERVE_TRANSCRIPT_MIN_CONTENT_CHARS) continue;
+      const fingerprint = createHash("sha256").update(`${sessionKey}\0${message.role}\0${message.content}`).digest("hex");
+      for (let attempt = 0; attempt < 2; attempt++) {
+        const seenAt = this.seenFingerprintsAt.get(fingerprint);
+        if (seenAt !== void 0 && Date.now() - seenAt < OBSERVE_TRANSCRIPT_DEDUPE_TTL_MS) {
+          break;
+        }
+        const inflight = this.inflightAppends.get(fingerprint);
+        if (inflight) {
+          await inflight;
+          continue;
+        }
+        const entry = {
+          timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+          role: message.role,
+          content: message.content,
+          sessionKey,
+          turnId: randomUUID()
+        };
+        const appendPromise = orchestrator.transcript.append(entry).then(() => {
+          this.remember(fingerprint);
+          persisted = true;
+        }).catch((err) => {
+          log.error(`access-observe transcript append failed: ${err}`);
+        }).finally(() => {
+          this.inflightAppends.delete(fingerprint);
+        });
+        this.inflightAppends.set(fingerprint, appendPromise);
+        await appendPromise;
+        break;
+      }
+    }
+    return persisted;
+  }
+  remember(fingerprint) {
+    this.seenFingerprintsAt.delete(fingerprint);
+    this.seenFingerprintsAt.set(fingerprint, Date.now());
+    if (this.seenFingerprintsAt.size > OBSERVE_TRANSCRIPT_DEDUPE_MAX_ENTRIES) {
+      const oldest = this.seenFingerprintsAt.keys().next().value;
+      if (typeof oldest === "string") this.seenFingerprintsAt.delete(oldest);
+    }
+  }
+};
+
+export {
+  observeTranscriptSessionKey,
+  ObserveTranscriptPersister
+};
+//# sourceMappingURL=chunk-LVE64P5Y.js.map

package/dist/chunk-LVE64P5Y.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/access-observe-transcript.ts"],"sourcesContent":["/**\n * Observe-derived transcript persistence (issue #2783).\n *\n * Delegate-mode gateways POST every turn to `/observe`; without a transcript\n * append in the daemon's observe path the transcript store never grows and\n * the hourly summarizer starves silently while every run reports ok. This\n * module is that append: it mirrors the embedded runtime's `agent_end`\n * handler (src/index.ts) — same `TranscriptManager`, same entry shape, same\n * `transcriptEnabled` presentation gate, same 10-char noise floor.\n *\n * Turns are deduped against a bounded process-lifetime (session, role,\n * content) fingerprint — the daemon-side equivalent of the embedded\n * runtime's `observedInboundContentFingerprints`, extended to both roles\n * because an un-keyed client re-POST always carries the whole turn — so a\n * retry cannot double-write it.\n */\n\nimport { createHash, randomUUID } from \"node:crypto\";\nimport { lcmSessionKeyForNamespace } from \"./coding/coding-namespace.js\";\nimport type { PluginConfig } from \"./types.js\";\nimport { log } from \"./logger.js\";\nimport type { Orchestrator } from \"./orchestrator.js\";\nimport type { TranscriptEntry } from \"./types.js\";\n\nconst OBSERVE_TRANSCRIPT_DEDUPE_MAX_ENTRIES = 8192;\nconst OBSERVE_TRANSCRIPT_MIN_CONTENT_CHARS = 10;\n/**\n * A fingerprint only suppresses re-POSTs inside this window. A client retry\n * lands seconds later; a session LEGITIMATELY repeating the same >10-char\n * turn usually does so minutes or hours later, and that repeat is a real\n * conversation event the transcripts must keep (review: preserve legitimate\n * repeated turns).\n */\nconst OBSERVE_TRANSCRIPT_DEDUPE_TTL_MS = 10 * 60 * 1000;\n\n/**\n * The transcript-side session identity for an observe payload (issue #2783\n * review: namespace scoping). Two authenticated principals can submit the\n * same client-controlled sessionKey while resolving to different effective\n * write namespaces; persisting through the raw key would let one\n * principal's transcript-derived summaries surface under the other's\n * session. Mirror the LCM archive's answer (rule 42 parity): prefix the\n * key with the effective write namespace whenever it diverges from the\n * default store. The summarizer lists sessions from the store itself, so\n * reads self-consistently follow the same prefixed keys.\n */\nexport function observeTranscriptSessionKey(\n  sessionKey: string,\n  writeNamespace: string,\n  config: Pick<PluginConfig, \"defaultNamespace\">\n): string {\n  return lcmSessionKeyForNamespace(writeNamespace, sessionKey, config.defaultNamespace) ?? sessionKey;\n}\n\n/** Bounded FIFO of seen fingerprints; insertion order is the eviction order. */\nexport class ObserveTranscriptPersister {\n  private readonly seenFingerprintsAt = new Map<string, number>();\n  /** In-flight appends by fingerprint: an overlapping identical observe waits for the first append instead of double-writing. */\n  private readonly inflightAppends = new Map<string, Promise<void>>();\n\n  /**\n   * Append every eligible message of an observe payload to the per-session\n   * transcript store. Best-effort: a failing append logs and does not fail\n   * the observe. Returns true when at least one turn was appended.\n   */\n  async persist(\n    orchestrator: Orchestrator,\n    sessionKey: string,\n    messages: ReadonlyArray<{ role: string; content: string }>,\n    rawSessionKey?: string\n  ): Promise<boolean> {\n    let persisted = false;\n    // TranscriptManager.append silently no-ops for skip-listed channel types\n    // (cron by default) — check BEFORE appending so the response's\n    // transcriptPersisted stays truthful (review: report skipped appends).\n    // The channel identity must derive from the RAW session key: the legacy\n    // parser requires the key to start with \"agent:\", so a namespace-prefixed\n    // transcript identity would always classify as \"session\" and the skip\n    // list would silently not apply to namespaced cron sessions (review r4).\n    const { channelType } = orchestrator.transcript.getTranscriptPath(rawSessionKey ?? sessionKey);\n    if (orchestrator.config.transcriptSkipChannelTypes.includes(channelType)) {\n      return false;\n    }\n    for (const message of messages) {\n      if (message.content.length < OBSERVE_TRANSCRIPT_MIN_CONTENT_CHARS) continue;\n      // Fixed-size digest, never the raw content: 8192 retained entries of\n      // full turn text is an avoidable heap-exhaustion surface on a daemon\n      // that accepts arbitrary observe payloads (review round 2).\n      const fingerprint = createHash(\"sha256\")\n        .update(`${sessionKey}\\0${message.role}\\0${message.content}`)\n        .digest(\"hex\");\n      // Two identical observes can overlap before either records its\n      // fingerprint; both would then append and the transcript would carry\n      // the turn twice. The attempt loop serializes per fingerprint: a caller\n      // that finds an in-flight append awaits it and RE-RUNS BOTH checks — on\n      // success the completed-set check skips the message; on failure (no\n      // fingerprint recorded) exactly ONE waiter proceeds to retry, because\n      // the check-then-register sequence has no await between its steps and\n      // is therefore atomic on the event loop (review r4).\n      for (let attempt = 0; attempt < 2; attempt++) {\n        const seenAt = this.seenFingerprintsAt.get(fingerprint);\n        if (seenAt !== undefined && Date.now() - seenAt < OBSERVE_TRANSCRIPT_DEDUPE_TTL_MS) {\n          break; // duplicate within the retry window — skip the message\n        }\n        const inflight = this.inflightAppends.get(fingerprint);\n        if (inflight) {\n          await inflight;\n          continue; // re-run both checks with the append's outcome visible\n        }\n        const entry: TranscriptEntry = {\n          timestamp: new Date().toISOString(),\n          role: message.role as TranscriptEntry[\"role\"],\n          content: message.content,\n          sessionKey,\n          turnId: randomUUID(),\n        };\n        const appendPromise = orchestrator.transcript\n          .append(entry)\n          .then(() => {\n            // Remember only after a successful append: a transient failure\n            // must not permanently swallow the turn — the client's retry has\n            // to be able to re-append it (review round 2).\n            this.remember(fingerprint);\n            persisted = true;\n          })\n          .catch((err) => {\n            // Same policy as the LCM enqueue in the observe path: transcript\n            // persistence must never fail the observe itself.\n            log.error(`access-observe transcript append failed: ${err}`);\n          })\n          .finally(() => {\n            this.inflightAppends.delete(fingerprint);\n          });\n        this.inflightAppends.set(fingerprint, appendPromise);\n        await appendPromise;\n        break;\n      }\n    }\n    return persisted;\n  }\n\n  private remember(fingerprint: string): void {\n    // Map.set keeps an existing key at its ORIGINAL insertion position, so a\n    // TTL-refreshed fingerprint could still be the FIFO-oldest and get\n    // evicted immediately — delete first to move it to the end (review r4).\n    this.seenFingerprintsAt.delete(fingerprint);\n    this.seenFingerprintsAt.set(fingerprint, Date.now());\n    if (this.seenFingerprintsAt.size > OBSERVE_TRANSCRIPT_DEDUPE_MAX_ENTRIES) {\n      const oldest = this.seenFingerprintsAt.keys().next().value;\n      if (typeof oldest === \"string\") this.seenFingerprintsAt.delete(oldest);\n    }\n  }\n}\n"],"mappings":";;;;;;;;AAiBA,SAAS,YAAY,kBAAkB;AAOvC,IAAM,wCAAwC;AAC9C,IAAM,uCAAuC;AAQ7C,IAAM,mCAAmC,KAAK,KAAK;AAa5C,SAAS,4BACd,YACA,gBACA,QACQ;AACR,SAAO,0BAA0B,gBAAgB,YAAY,OAAO,gBAAgB,KAAK;AAC3F;AAGO,IAAM,6BAAN,MAAiC;AAAA,EACrB,qBAAqB,oBAAI,IAAoB;AAAA;AAAA,EAE7C,kBAAkB,oBAAI,IAA2B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOlE,MAAM,QACJ,cACA,YACA,UACA,eACkB;AAClB,QAAI,YAAY;AAQhB,UAAM,EAAE,YAAY,IAAI,aAAa,WAAW,kBAAkB,iBAAiB,UAAU;AAC7F,QAAI,aAAa,OAAO,2BAA2B,SAAS,WAAW,GAAG;AACxE,aAAO;AAAA,IACT;AACA,eAAW,WAAW,UAAU;AAC9B,UAAI,QAAQ,QAAQ,SAAS,qCAAsC;AAInE,YAAM,cAAc,WAAW,QAAQ,EACpC,OAAO,GAAG,UAAU,KAAK,QAAQ,IAAI,KAAK,QAAQ,OAAO,EAAE,EAC3D,OAAO,KAAK;AASf,eAAS,UAAU,GAAG,UAAU,GAAG,WAAW;AAC5C,cAAM,SAAS,KAAK,mBAAmB,IAAI,WAAW;AACtD,YAAI,WAAW,UAAa,KAAK,IAAI,IAAI,SAAS,kCAAkC;AAClF;AAAA,QACF;AACA,cAAM,WAAW,KAAK,gBAAgB,IAAI,WAAW;AACrD,YAAI,UAAU;AACZ,gBAAM;AACN;AAAA,QACF;AACA,cAAM,QAAyB;AAAA,UAC7B,YAAW,oBAAI,KAAK,GAAE,YAAY;AAAA,UAClC,MAAM,QAAQ;AAAA,UACd,SAAS,QAAQ;AAAA,UACjB;AAAA,UACA,QAAQ,WAAW;AAAA,QACrB;AACA,cAAM,gBAAgB,aAAa,WAChC,OAAO,KAAK,EACZ,KAAK,MAAM;AAIV,eAAK,SAAS,WAAW;AACzB,sBAAY;AAAA,QACd,CAAC,EACA,MAAM,CAAC,QAAQ;AAGd,cAAI,MAAM,4CAA4C,GAAG,EAAE;AAAA,QAC7D,CAAC,EACA,QAAQ,MAAM;AACb,eAAK,gBAAgB,OAAO,WAAW;AAAA,QACzC,CAAC;AACH,aAAK,gBAAgB,IAAI,aAAa,aAAa;AACnD,cAAM;AACN;AAAA,MACF;AAAA,IACF;AACA,WAAO;AAAA,EACT;AAAA,EAEQ,SAAS,aAA2B;AAI1C,SAAK,mBAAmB,OAAO,WAAW;AAC1C,SAAK,mBAAmB,IAAI,aAAa,KAAK,IAAI,CAAC;AACnD,QAAI,KAAK,mBAAmB,OAAO,uCAAuC;AACxE,YAAM,SAAS,KAAK,mBAAmB,KAAK,EAAE,KAAK,EAAE;AACrD,UAAI,OAAO,WAAW,SAAU,MAAK,mBAAmB,OAAO,MAAM;AAAA,IACvE;AAAA,EACF;AACF;","names":[]}