@nicia-ai/typegraph 0.47.0 → 0.49.0

package/dist/graph-merge/index.cjs

@@ -1,22 +1,22 @@
 'use strict';
 
-var chunkBR7SHKGM_cjs = require('../chunk-BR7SHKGM.cjs');
-require('../chunk-AMMWA76F.cjs');
-var chunkU5EDAVOJ_cjs = require('../chunk-U5EDAVOJ.cjs');
-require('../chunk-WGX7JH7E.cjs');
-var chunkMFZR4QKM_cjs = require('../chunk-MFZR4QKM.cjs');
-var chunk6JVZSOHQ_cjs = require('../chunk-6JVZSOHQ.cjs');
+var chunkSR725PWF_cjs = require('../chunk-SR725PWF.cjs');
+require('../chunk-FA2AFWLP.cjs');
+var chunk3G5W2U2L_cjs = require('../chunk-3G5W2U2L.cjs');
+require('../chunk-JB6T4GLL.cjs');
+var chunk3KOY4FH3_cjs = require('../chunk-3KOY4FH3.cjs');
+var chunk3FPR224C_cjs = require('../chunk-3FPR224C.cjs');
 var chunk26YKDNUD_cjs = require('../chunk-26YKDNUD.cjs');
-var chunkMX4DHSQP_cjs = require('../chunk-MX4DHSQP.cjs');
-var chunkOIFSOPSR_cjs = require('../chunk-OIFSOPSR.cjs');
+var chunkJFRT7S3B_cjs = require('../chunk-JFRT7S3B.cjs');
+var chunkEZEEWCFJ_cjs = require('../chunk-EZEEWCFJ.cjs');
 var chunkPWLJ77UV_cjs = require('../chunk-PWLJ77UV.cjs');
-require('../chunk-JR6SX5RH.cjs');
+var chunkSIT26LAZ_cjs = require('../chunk-SIT26LAZ.cjs');
 var chunk3U5ABFDW_cjs = require('../chunk-3U5ABFDW.cjs');
-var chunk3HGRTCDU_cjs = require('../chunk-3HGRTCDU.cjs');
+require('../chunk-5PRKMB24.cjs');
 var chunkBFUOME67_cjs = require('../chunk-BFUOME67.cjs');
 var chunkFQPEMEWX_cjs = require('../chunk-FQPEMEWX.cjs');
-require('../chunk-6KFLYYOC.cjs');
-var chunk425IZOQ5_cjs = require('../chunk-425IZOQ5.cjs');
+require('../chunk-2QGYQBS2.cjs');
+var chunkTQHGE7UC_cjs = require('../chunk-TQHGE7UC.cjs');
 require('../chunk-AOSSQDVO.cjs');
 require('../chunk-OI2GQ25X.cjs');
 require('../chunk-LRQKXRXO.cjs');
@@ -716,10 +716,10 @@ function endpointTuple(assertion) {
   return [assertion.a.kind, assertion.a.id, assertion.b.kind, assertion.b.id];
 }
 function identityEndpointKey(assertion) {
-  return chunkMX4DHSQP_cjs.encodeTupleKey(endpointTuple(assertion));
+  return chunkEZEEWCFJ_cjs.encodeTupleKey(endpointTuple(assertion));
 }
 function identitySemanticKey(assertion) {
-  return chunkMX4DHSQP_cjs.identityAssertionSemanticKey(
+  return chunkJFRT7S3B_cjs.identityAssertionSemanticKey(
     assertion.relation,
     assertion.a,
     assertion.b
@@ -728,11 +728,11 @@ function identitySemanticKey(assertion) {
 function identityDedupeKey(assertion) {
   const semantic = identitySemanticKey(assertion);
   if (assertion.validTo === void 0) return semantic;
-  return chunkMX4DHSQP_cjs.encodeTupleKey([semantic, assertion.validFrom, assertion.validTo]);
+  return chunkEZEEWCFJ_cjs.encodeTupleKey([semantic, assertion.validFrom, assertion.validTo]);
 }
 function compareIdentitySurvivors(left, right) {
-  const byValidity = chunkOIFSOPSR_cjs.compareCodePoints(left.validFrom, right.validFrom);
-  return byValidity === 0 ? chunkOIFSOPSR_cjs.compareCodePoints(left.id, right.id) : byValidity;
+  const byValidity = chunkEZEEWCFJ_cjs.compareCodePoints(left.validFrom, right.validFrom);
+  return byValidity === 0 ? chunkEZEEWCFJ_cjs.compareCodePoints(left.id, right.id) : byValidity;
 }
 var DUPLICATE_IDENTITY_ASSERTION_DROP_REASON = "identity:duplicate-assertion";
 var REDUNDANT_IDENTITY_ASSERTION_DROP_REASON = "identity:endpoints-collapsed";
@@ -763,7 +763,7 @@ function dedupeIdentityAssertions(assertions, committedIds) {
   }
   return {
     survivors: [...survivorBySemantic.values()].toSorted(
-      (left, right) => chunkOIFSOPSR_cjs.compareCodePoints(identityDedupeKey(left), identityDedupeKey(right))
+      (left, right) => chunkEZEEWCFJ_cjs.compareCodePoints(identityDedupeKey(left), identityDedupeKey(right))
     ),
     dropped
   };
@@ -783,7 +783,7 @@ function assertNoOpposingIdentityRelations(assertions) {
     );
     for (const sameAssertion of same) {
       for (const differentAssertion of different) {
-        if (!chunkMX4DHSQP_cjs.identityValidityWindowsOverlap(sameAssertion, differentAssertion)) {
+        if (!chunkJFRT7S3B_cjs.identityValidityWindowsOverlap(sameAssertion, differentAssertion)) {
           continue;
         }
         throw new IdentityMergeConflictError(
@@ -900,7 +900,7 @@ function planIdentityChanges(staging, storedIdentityRowsById) {
   return {
     assertions: deduped.survivors,
     retractions: retractions.toSorted(
-      (left, right) => chunkOIFSOPSR_cjs.compareCodePoints(left.id, right.id)
+      (left, right) => chunkEZEEWCFJ_cjs.compareCodePoints(left.id, right.id)
     ),
     dropped: [...deduped.dropped, ...retractionDropped]
   };
@@ -943,7 +943,7 @@ function remapIdentityAssertionEndpoints(assertions, canonicalOf, retypeMap, sto
       );
       continue;
     }
-    const [a, b] = chunkMX4DHSQP_cjs.normalizeIdentityPair(remappedA, remappedB);
+    const [a, b] = chunkJFRT7S3B_cjs.normalizeIdentityPair(remappedA, remappedB);
     const endpointWindowA = endpointWindows.get(mergeKeyOf(a));
     const endpointWindowB = endpointWindows.get(mergeKeyOf(b));
     const validFrom = [
@@ -951,17 +951,17 @@ function remapIdentityAssertionEndpoints(assertions, canonicalOf, retypeMap, sto
       endpointWindowA?.validFrom,
       endpointWindowB?.validFrom
     ].filter((bound) => bound !== void 0).reduce(
-      (latest, bound) => chunkOIFSOPSR_cjs.compareCodePoints(latest, bound) < 0 ? bound : latest
+      (latest, bound) => chunkEZEEWCFJ_cjs.compareCodePoints(latest, bound) < 0 ? bound : latest
     );
     const validTo = [
       assertion.validTo,
       endpointWindowA?.validTo,
       endpointWindowB?.validTo
     ].filter((bound) => bound !== void 0).reduce(
-      (earliest, bound) => earliest === void 0 || chunkOIFSOPSR_cjs.compareCodePoints(bound, earliest) < 0 ? bound : earliest,
+      (earliest, bound) => earliest === void 0 || chunkEZEEWCFJ_cjs.compareCodePoints(bound, earliest) < 0 ? bound : earliest,
       void 0
     );
-    if (validTo !== void 0 && chunkOIFSOPSR_cjs.compareCodePoints(validFrom, validTo) >= 0) {
+    if (validTo !== void 0 && chunkEZEEWCFJ_cjs.compareCodePoints(validFrom, validTo) >= 0) {
       dropped.push(
         droppedIdentityAssertion(
           assertion,
@@ -1098,7 +1098,7 @@ async function buildIdentityPeerProbe(target, probedIds, targetPeers, plan, prof
       (group) => group.map((member) => mergeKey(member.kind, member.id))
     )
   ]);
-  const ledger = (await relevantLedgerAssertions(target, memberKeys, chunkMFZR4QKM_cjs.storeBackend(target))).filter(
+  const ledger = (await relevantLedgerAssertions(target, memberKeys, chunk3KOY4FH3_cjs.storeBackend(target))).filter(
     (assertion) => !plannedDeletions.has(mergeKey(assertion.a.kind, assertion.a.id)) && !plannedDeletions.has(mergeKey(assertion.b.kind, assertion.b.id))
   );
   return {
@@ -1119,7 +1119,7 @@ async function buildIdentityPeerProbe(target, probedIds, targetPeers, plan, prof
   };
 }
 async function snapshotIdentityClasses(target, seeds, liveKeys, plannedDeletions, txBackend) {
-  const classes = await chunkMFZR4QKM_cjs.storeRuntime(target).structuralIdentityClasses(
+  const classes = await chunk3KOY4FH3_cjs.storeRuntime(target).structuralIdentityClasses(
     seeds,
     txBackend
   );
@@ -1127,7 +1127,7 @@ async function snapshotIdentityClasses(target, seeds, liveKeys, plannedDeletions
   const groups = [];
   for (const seed of seeds) {
     const key = mergeKey(seed.kind, seed.id);
-    const members = (classes.get(chunkMX4DHSQP_cjs.identityReferenceKey(seed)) ?? [seed]).filter(
+    const members = (classes.get(chunkJFRT7S3B_cjs.identityReferenceKey(seed)) ?? [seed]).filter(
       (member) => !plannedDeletions.has(mergeKey(member.kind, member.id))
     );
     groups.push(members);
@@ -1136,7 +1136,7 @@ async function snapshotIdentityClasses(target, seeds, liveKeys, plannedDeletions
   return { fingerprints, groups };
 }
 async function relevantLedgerAssertions(target, memberKeys, backend) {
-  const current = await chunkMFZR4QKM_cjs.storeRuntime(target).identityAssertionsAtTarget(
+  const current = await chunk3KOY4FH3_cjs.storeRuntime(target).identityAssertionsAtTarget(
     backend,
     "state"
   );
@@ -1147,7 +1147,7 @@ async function relevantLedgerAssertions(target, memberKeys, backend) {
 function differentLedgerFingerprint(assertions) {
   return JSON.stringify(
     assertions.filter((assertion) => assertion.relation === "different").map((assertion) => [assertion.id, ...endpointTuple(assertion)]).toSorted(
-      (left, right) => chunkOIFSOPSR_cjs.compareStrings(chunkMX4DHSQP_cjs.encodeTupleKey(left), chunkMX4DHSQP_cjs.encodeTupleKey(right))
+      (left, right) => chunkEZEEWCFJ_cjs.compareStrings(chunkEZEEWCFJ_cjs.encodeTupleKey(left), chunkEZEEWCFJ_cjs.encodeTupleKey(right))
     )
   );
 }
@@ -1209,7 +1209,7 @@ async function assertPlannedIdentityIdsFresh(target, txBackend, plan) {
     ...plan.identityRetractions.map((retraction) => retraction.id)
   ];
   if (plannedIds.length === 0) return;
-  const storedById = await chunkMFZR4QKM_cjs.storeRuntime(target).identityAssertionRowsByIds(
+  const storedById = await chunk3KOY4FH3_cjs.storeRuntime(target).identityAssertionRowsByIds(
     plannedIds,
     txBackend
   );
@@ -1262,7 +1262,7 @@ function affectedIdentityClassSeeds(plan, profile) {
   return [...seedsByKey.values()];
 }
 async function assertMergedIdentityClassesConsistent(target, txBackend, plan) {
-  await chunkMFZR4QKM_cjs.storeRuntime(target).assertIdentityClassesConsistentAtTarget(
+  await chunk3KOY4FH3_cjs.storeRuntime(target).assertIdentityClassesConsistentAtTarget(
     txBackend,
     affectedIdentityClassSeeds(plan, target.graph.identity?.sameIdAcrossKinds)
   );
@@ -1316,7 +1316,7 @@ function translateIdentityCommitError(error) {
 }
 async function assertIdentityPeersStable(target, txBackend, probe, plan) {
   if (probe === void 0) return;
-  const live = (await chunkMFZR4QKM_cjs.storeRuntime(target).liveNodesSharingIds(probe.ids, txBackend)).filter((peer) => !probe.plannedDeletions.has(mergeKey(peer.kind, peer.id)));
+  const live = (await chunk3KOY4FH3_cjs.storeRuntime(target).liveNodesSharingIds(probe.ids, txBackend)).filter((peer) => !probe.plannedDeletions.has(mergeKey(peer.kind, peer.id)));
   const seedKindsById = /* @__PURE__ */ new Map();
   for (const seed of probe.seeds) {
     const kinds = seedKindsById.get(seed.id) ?? /* @__PURE__ */ new Set();
@@ -1341,7 +1341,7 @@ async function assertIdentityPeersStable(target, txBackend, probe, plan) {
     probe.plannedDeletions,
     txBackend
   );
-  const drifted = [...probe.classFingerprints].filter(([key, fingerprint]) => liveFingerprints.get(key) !== fingerprint).map(([key]) => key).sort((left, right) => chunkOIFSOPSR_cjs.compareStrings(left, right));
+  const drifted = [...probe.classFingerprints].filter(([key, fingerprint]) => liveFingerprints.get(key) !== fingerprint).map(([key]) => key).sort((left, right) => chunkEZEEWCFJ_cjs.compareStrings(left, right));
   if (drifted.length > 0) {
     throw new BaseVersionMismatchError(
       `mergeIncremental() validated identity against the classes visible at planning, but the identity class of ${drifted.length} node(s) the plan folds on changed before the commit transaction. Committing the plan could contradict identity truth it never validated.`,
@@ -1385,8 +1385,8 @@ var ENUMERATION_PAGE_SIZE = 1e3;
 var EXPLICIT_RETRACTION = { kind: "explicit" };
 function validWindowOf(row) {
   return {
-    validFrom: chunk425IZOQ5_cjs.canonicalizeDatabaseTimestamp(row.valid_from),
-    validTo: chunk425IZOQ5_cjs.canonicalizeDatabaseTimestamp(row.valid_to)
+    validFrom: chunkTQHGE7UC_cjs.canonicalizeDatabaseTimestamp(row.valid_from),
+    validTo: chunkTQHGE7UC_cjs.canonicalizeDatabaseTimestamp(row.valid_to)
   };
 }
 function windowsDiffer(left, right) {
@@ -1498,7 +1498,7 @@ function diffNodeKind(kind, baseRows, forkRows) {
       deleted.push({
         id: baseRow.id,
         kind,
-        deletedAt: forkRow === void 0 ? void 0 : chunk425IZOQ5_cjs.canonicalizeDatabaseTimestamp(forkRow.deleted_at)
+        deletedAt: forkRow === void 0 ? void 0 : chunkTQHGE7UC_cjs.canonicalizeDatabaseTimestamp(forkRow.deleted_at)
       });
     }
   }
@@ -1609,15 +1609,15 @@ function classifyRetractions(retracted, deletedNodes, forkRowsById) {
   });
 }
 function byId(left, right) {
-  return chunkOIFSOPSR_cjs.compareStrings(left.id, right.id);
+  return chunkEZEEWCFJ_cjs.compareStrings(left.id, right.id);
 }
 async function diffAgainstBase(baseStore, forkStore, captureForkState = true) {
   const graph = baseStore.graph;
   const nodeKinds = chunkBFUOME67_cjs.getNodeKinds(graph);
   const edgeKinds = chunkBFUOME67_cjs.getEdgeKinds(graph);
   const [baseIdentity, forkIdentity] = await Promise.all([
-    chunkMFZR4QKM_cjs.storeRuntime(baseStore).readCurrentIdentityAssertions("archival"),
-    chunkMFZR4QKM_cjs.storeRuntime(forkStore).readCurrentIdentityAssertions("archival")
+    chunk3KOY4FH3_cjs.storeRuntime(baseStore).readCurrentIdentityAssertions("archival"),
+    chunk3KOY4FH3_cjs.storeRuntime(forkStore).readCurrentIdentityAssertions("archival")
   ]);
   const baseIdentityById = new Map(
     baseIdentity.map((assertion) => [assertion.id, assertion])
@@ -1632,12 +1632,12 @@ async function diffAgainstBase(baseStore, forkStore, captureForkState = true) {
   const forkNodeVersions = /* @__PURE__ */ new Map();
   for (const kind of nodeKinds) {
     const baseRows = await enumerateAllNodes(
-      chunkMFZR4QKM_cjs.storeBackend(baseStore),
+      chunk3KOY4FH3_cjs.storeBackend(baseStore),
       baseStore.graphId,
       kind
     );
     const forkRows = await enumerateAllNodes(
-      chunkMFZR4QKM_cjs.storeBackend(forkStore),
+      chunk3KOY4FH3_cjs.storeBackend(forkStore),
       forkStore.graphId,
       kind
     );
@@ -1667,12 +1667,12 @@ async function diffAgainstBase(baseStore, forkStore, captureForkState = true) {
   const forkEdgeSignatures = /* @__PURE__ */ new Map();
   for (const kind of edgeKinds) {
     const baseRows = await enumerateAllEdges(
-      chunkMFZR4QKM_cjs.storeBackend(baseStore),
+      chunk3KOY4FH3_cjs.storeBackend(baseStore),
       baseStore.graphId,
       kind
     );
     const forkRows = await enumerateAllEdges(
-      chunkMFZR4QKM_cjs.storeBackend(forkStore),
+      chunk3KOY4FH3_cjs.storeBackend(forkStore),
       forkStore.graphId,
       kind
     );
@@ -1708,7 +1708,7 @@ async function diffAgainstBase(baseStore, forkStore, captureForkState = true) {
   const retractedAssertions = baseIdentity.filter((assertion) => {
     const fork = forkIdentityById.get(assertion.id);
     return fork === void 0 || assertionTruthKey(fork) !== assertionTruthKey(assertion);
-  }).toSorted((left, right) => chunkOIFSOPSR_cjs.compareStrings(left.id, right.id));
+  }).toSorted((left, right) => chunkEZEEWCFJ_cjs.compareStrings(left.id, right.id));
   const classifiedRetractions = classifyRetractions(
     retractedAssertions,
     deletedNodes,
@@ -1739,7 +1739,7 @@ async function diffAgainstBase(baseStore, forkStore, captureForkState = true) {
       new: forkIdentity.filter((assertion) => {
         const base = baseIdentityById.get(assertion.id);
         return base === void 0 || assertionIdentityKey(base) !== assertionIdentityKey(assertion) && assertionTruthKey(base) !== assertionTruthKey(assertion);
-      }).toSorted((left, right) => chunkOIFSOPSR_cjs.compareStrings(left.id, right.id)),
+      }).toSorted((left, right) => chunkEZEEWCFJ_cjs.compareStrings(left.id, right.id)),
       retracted: classifiedRetractions
     },
     forkNodeVersions,
@@ -1769,14 +1769,14 @@ async function readActiveSchemaVersion(backend, graphId) {
 }
 async function computeSchemaComponent(store) {
   const version = await readActiveSchemaVersion(
-    chunkMFZR4QKM_cjs.storeBackend(store),
+    chunk3KOY4FH3_cjs.storeBackend(store),
     store.graphId
   );
-  return chunk6JVZSOHQ_cjs.computeSchemaHash(chunk6JVZSOHQ_cjs.serializeSchema(store.graph, version));
+  return chunk3FPR224C_cjs.computeSchemaHash(chunk3FPR224C_cjs.serializeSchema(store.graph, version));
 }
 function byDigestEntry(left, right) {
-  const byKind = chunkOIFSOPSR_cjs.compareStrings(left.kind, right.kind);
-  return byKind === 0 ? chunkOIFSOPSR_cjs.compareStrings(left.id, right.id) : byKind;
+  const byKind = chunkEZEEWCFJ_cjs.compareStrings(left.kind, right.kind);
+  return byKind === 0 ? chunkEZEEWCFJ_cjs.compareStrings(left.id, right.id) : byKind;
 }
 var CONTENT_FINGERPRINT_BYTES = 16;
 async function computeContentComponent(backend, graphId, graph, identityAssertions) {
@@ -1831,7 +1831,7 @@ async function computeBaseVersion(store) {
       computeSchemaComponent(store),
       store.revisionOriginNow(),
       store.revisionNow(),
-      readActiveSchemaVersion(chunkMFZR4QKM_cjs.storeBackend(store), store.graphId)
+      readActiveSchemaVersion(chunk3KOY4FH3_cjs.storeBackend(store), store.graphId)
     ]);
     return asBaseVersion(
       `${schemaComponent2}${SCHEMA_VERSION_TAG}${activeVersion}${TOKEN_SEPARATOR}${revisionComponent(origin, revision)}`
@@ -1846,9 +1846,9 @@ async function computeBaseVersion(store) {
   );
 }
 async function computeStoreContentComponent(store) {
-  const identityAssertions = await chunkMFZR4QKM_cjs.storeRuntime(store).readCurrentIdentityAssertions("state");
+  const identityAssertions = await chunk3KOY4FH3_cjs.storeRuntime(store).readCurrentIdentityAssertions("state");
   return computeContentComponent(
-    chunkMFZR4QKM_cjs.storeBackend(store),
+    chunk3KOY4FH3_cjs.storeBackend(store),
     store.graphId,
     store.graph,
     identityAssertions
@@ -1886,12 +1886,24 @@ function contentComponentOf(version) {
 // src/graph-merge/working-copy.ts
 var CLONE_IMPORT_BATCH_SIZE = 1e3;
 function cloneWorkingCopyStrategy(makeBackend) {
+  return cloneWorkingCopyWithGraphStrategy(
+    makeBackend,
+    (baseStore) => baseStore.graph
+  );
+}
+function cloneIngestionWorkingCopyStrategy(makeBackend) {
+  return cloneWorkingCopyWithGraphStrategy(
+    makeBackend,
+    (baseStore) => graphWithoutNodeUniqueness(baseStore.graph)
+  );
+}
+function cloneWorkingCopyWithGraphStrategy(makeBackend, graphForClone) {
   return {
     create: async (baseStore) => {
       const backend = await makeBackend();
       try {
-        const [freshStore] = await chunkBR7SHKGM_cjs.createStoreWithSchema(
-          baseStore.graph,
+        const [freshStore] = await chunkSR725PWF_cjs.createStoreWithSchema(
+          graphForClone(baseStore),
           backend,
           {
             // Keep descendants branchable with the same O(1) anchor contract,
@@ -1911,16 +1923,16 @@ function cloneWorkingCopyStrategy(makeBackend) {
           validateReferences: true,
           batchSize: CLONE_IMPORT_BATCH_SIZE
         };
-        const result = chunk3HGRTCDU_cjs.snapshotExportContention(
-          chunkMFZR4QKM_cjs.storeBackend(baseStore),
-          chunkMFZR4QKM_cjs.storeBackend(freshStore)
-        ) === void 0 ? await chunkU5EDAVOJ_cjs.importGraphStream(
+        const result = chunkSIT26LAZ_cjs.snapshotExportContention(
+          chunk3KOY4FH3_cjs.storeBackend(baseStore),
+          chunk3KOY4FH3_cjs.storeBackend(freshStore)
+        ) === void 0 ? await chunk3G5W2U2L_cjs.importGraphStream(
           freshStore,
-          chunkU5EDAVOJ_cjs.exportGraphStream(baseStore, exportOptions),
+          chunk3G5W2U2L_cjs.exportGraphStream(baseStore, exportOptions),
           importOptions
-        ) : await chunkU5EDAVOJ_cjs.importGraph(
+        ) : await chunk3G5W2U2L_cjs.importGraph(
           freshStore,
-          await chunkU5EDAVOJ_cjs.exportGraph(baseStore, exportOptions),
+          await chunk3G5W2U2L_cjs.exportGraph(baseStore, exportOptions),
           importOptions
         );
         if (!result.success) {
@@ -1940,15 +1952,39 @@ function cloneWorkingCopyStrategy(makeBackend) {
     }
   };
 }
+function graphWithoutNodeUniqueness(graph) {
+  const nodes = Object.fromEntries(
+    Object.entries(graph.nodes).map(([name, registration]) => {
+      const { unique: _omitted, ...withoutUnique } = registration;
+      return [name, Object.freeze(withoutUnique)];
+    })
+  );
+  const extension = graph.extension?.nodes === void 0 ? graph.extension : Object.freeze({
+    ...graph.extension,
+    nodes: Object.freeze(
+      Object.fromEntries(
+        Object.entries(graph.extension.nodes).map(([name, node]) => {
+          const { unique: _omitted, ...withoutUnique } = node;
+          return [name, Object.freeze(withoutUnique)];
+        })
+      )
+    )
+  });
+  return Object.freeze({
+    ...graph,
+    nodes: Object.freeze(nodes),
+    extension
+  });
+}
 
 // src/graph-merge/branch.ts
 async function branch(baseStore, makeBackend, options, strategy) {
   try {
     const base = await computeBaseVersion(baseStore);
-    const id = options?.id ?? asBranchId(chunkOIFSOPSR_cjs.generateId());
+    const id = options?.id ?? asBranchId(chunkEZEEWCFJ_cjs.generateId());
     const workingCopyStrategy = strategy ?? cloneWorkingCopyStrategy(makeBackend);
     const store = await workingCopyStrategy.create(baseStore);
-    const schemaAnchor = await readSchemaAnchor(store);
+    const schemaAnchor = await captureBranchSchemaAnchor(store);
     return chunkGYEG3ZLZ_cjs.ok({
       id,
       base,
@@ -1963,19 +1999,89 @@ async function branch(baseStore, makeBackend, options, strategy) {
     );
   }
 }
-async function readSchemaAnchor(store) {
+async function captureBranchSchemaAnchor(store) {
   try {
-    const schemaRow = await chunkMFZR4QKM_cjs.storeBackend(store).getActiveSchema(store.graphId);
+    const schemaRow = await chunk3KOY4FH3_cjs.storeBackend(store).getActiveSchema(store.graphId);
     return schemaRow === void 0 ? void 0 : { version: schemaRow.version, hash: schemaRow.schema_hash };
   } catch (error) {
     try {
-      await chunkMFZR4QKM_cjs.storeBackend(store).close();
+      await chunk3KOY4FH3_cjs.storeBackend(store).close();
     } catch {
     }
     throw error;
   }
 }
 
+// src/graph-merge/ingestion-branch.ts
+var PRIVATE_BRANCHES = /* @__PURE__ */ new WeakMap();
+function createIngestionIdentityFacade(identity) {
+  return Object.freeze({
+    assertSame(a, b, window) {
+      return identity.assertSame(a, b, window);
+    },
+    assertDifferent(a, b, window) {
+      return identity.assertDifferent(a, b, window);
+    },
+    bulkAssertSame(pairs) {
+      return identity.bulkAssertSame(pairs);
+    },
+    bulkAssertDifferent(pairs) {
+      return identity.bulkAssertDifferent(pairs);
+    }
+  });
+}
+async function ingestionBranch(baseStore, makeBackend, options) {
+  try {
+    const created = await branch(
+      baseStore,
+      makeBackend,
+      options,
+      cloneIngestionWorkingCopyStrategy(makeBackend)
+    );
+    if (chunkGYEG3ZLZ_cjs.isErr(created)) {
+      return chunkGYEG3ZLZ_cjs.err(
+        new BranchError("Failed to create constraint-aware ingestion branch", {
+          cause: created.error
+        })
+      );
+    }
+    const privateBranch = created.data;
+    const { base, id, store } = privateBranch;
+    const identityAccess = store.graph.identity === void 0 ? {} : {
+      identity: createIngestionIdentityFacade(
+        store.identity
+      )
+    };
+    const handle = Object.freeze({
+      id,
+      base,
+      nodes: store.nodes,
+      edges: store.edges,
+      ...identityAccess,
+      close: async () => chunk3KOY4FH3_cjs.storeBackend(store).close()
+    });
+    PRIVATE_BRANCHES.set(handle, privateBranch);
+    chunk3G5W2U2L_cjs.registerIngestionImportTarget(handle, store);
+    return chunkGYEG3ZLZ_cjs.ok(handle);
+  } catch (error) {
+    return chunkGYEG3ZLZ_cjs.err(
+      new BranchError("Failed to create constraint-aware ingestion branch", {
+        cause: error
+      })
+    );
+  }
+}
+function unwrapMergeBranch(input) {
+  const privateBranch = PRIVATE_BRANCHES.get(input);
+  if (privateBranch !== void 0) {
+    return privateBranch;
+  }
+  return input;
+}
+function unwrapMergeBranches(inputs) {
+  return inputs.map((input) => unwrapMergeBranch(input));
+}
+
 // src/graph-merge/blocking.ts
 var UNBLOCKED_BUCKET_KEY = "unblocked";
 var KEY_PART_SEPARATOR = "\0";
@@ -2037,12 +2143,12 @@ function blockNodes(newNodes, resolveConfig, uniqueConstraints = []) {
     }
   }
   const sortedKeys = [...buckets.keys()].sort(
-    (left, right) => chunkOIFSOPSR_cjs.compareStrings(left, right)
+    (left, right) => chunkEZEEWCFJ_cjs.compareStrings(left, right)
   );
   const ordered = /* @__PURE__ */ new Map();
   for (const key of sortedKeys) {
     const members = [...chunkN66HCGCY_cjs.requireDefined(buckets.get(key))].sort(
-      (left, right) => chunkOIFSOPSR_cjs.compareStrings(left.id, right.id)
+      (left, right) => chunkEZEEWCFJ_cjs.compareStrings(left.id, right.id)
     );
     ordered.set(key, members);
   }
@@ -2059,7 +2165,7 @@ function buildBranchRank(branchOrder, allBranchIds) {
       next += 1;
     }
   }
-  const remaining = allBranchIds.filter((branchId) => !rank.has(branchId)).sort((left, right) => chunkOIFSOPSR_cjs.compareStrings(left, right));
+  const remaining = allBranchIds.filter((branchId) => !rank.has(branchId)).sort((left, right) => chunkEZEEWCFJ_cjs.compareStrings(left, right));
   for (const branchId of remaining) {
     if (!rank.has(branchId)) {
       rank.set(branchId, next);
@@ -2131,8 +2237,8 @@ function collectConflictingValues(property, contributions) {
     values.push({ branchId, value });
   }
   return [...values].sort((left, right) => {
-    const byBranch = chunkOIFSOPSR_cjs.compareStrings(left.branchId, right.branchId);
-    return byBranch === 0 ? chunkOIFSOPSR_cjs.compareStrings(
+    const byBranch = chunkEZEEWCFJ_cjs.compareStrings(left.branchId, right.branchId);
+    return byBranch === 0 ? chunkEZEEWCFJ_cjs.compareStrings(
       canonicalValueKey(left.value),
       canonicalValueKey(right.value)
     ) : byBranch;
@@ -2262,7 +2368,7 @@ function unionProperties(canonicalMember, members, context, baseContext, branchR
   const props = chunkN66HCGCY_cjs.createDataKeyedBag();
   const conflicts = [];
   for (const property of [...propertyNames].sort(
-    (left, right) => chunkOIFSOPSR_cjs.compareStrings(left, right)
+    (left, right) => chunkEZEEWCFJ_cjs.compareStrings(left, right)
   )) {
     const values = collectConflictingValues(property, members);
     if (values.length === 0) {
@@ -2327,14 +2433,14 @@ function canonicalizeCluster(cluster, members, policy, branchRank, weights, cano
   );
   const memberIds = [
     ...new Set(cluster.members.map((member) => idOf(member)))
-  ].sort((left, right) => chunkOIFSOPSR_cjs.compareStrings(left, right));
+  ].sort((left, right) => chunkEZEEWCFJ_cjs.compareStrings(left, right));
   const branchOrigins = [
     ...new Set(
       members.map((member) => member.branchId).filter(
         (branchId) => branchId !== BASE_PROVENANCE_BRANCH && branchId !== preferredBranchId
       )
     )
-  ].sort((left, right) => chunkOIFSOPSR_cjs.compareStrings(left, right));
+  ].sort((left, right) => chunkEZEEWCFJ_cjs.compareStrings(left, right));
   const resolution = {
     canonicalId,
     memberIds,
@@ -2414,7 +2520,7 @@ var EQUIVALENCE_META_EDGES = /* @__PURE__ */ new Set([
   chunkXUO3KQFO_cjs.META_EDGE_SAME_AS
 ]);
 function buildSubClassClosure(ontology) {
-  const unionFind = new UnionFind(chunkOIFSOPSR_cjs.compareStrings);
+  const unionFind = new UnionFind(chunkEZEEWCFJ_cjs.compareStrings);
   for (const relation of ontology) {
     unionFind.add(relation.from);
     unionFind.add(relation.to);
@@ -2510,7 +2616,7 @@ function sourceKey(source) {
   }
 }
 function compareMatchSources(left, right) {
-  return chunkOIFSOPSR_cjs.compareStrings(sourceKey(left), sourceKey(right));
+  return chunkEZEEWCFJ_cjs.compareStrings(sourceKey(left), sourceKey(right));
 }
 function compareEntityRefs(left, right) {
   return compareMergeKeys(
@@ -3252,7 +3358,7 @@ function pickHighestPriorityBranch(branchIds, branchRank) {
   let chosenRank = branchRank.get(chosen) ?? Number.MAX_SAFE_INTEGER;
   for (const candidate of branchIds.slice(1)) {
     const candidateRank = branchRank.get(candidate) ?? Number.MAX_SAFE_INTEGER;
-    if (candidateRank < chosenRank || candidateRank === chosenRank && chunkOIFSOPSR_cjs.compareStrings(candidate, chosen) < 0) {
+    if (candidateRank < chosenRank || candidateRank === chosenRank && chunkEZEEWCFJ_cjs.compareStrings(candidate, chosen) < 0) {
       chosen = candidate;
       chosenRank = candidateRank;
     }
@@ -3345,20 +3451,20 @@ function resolveDeleteModifyOver(modified, deleted, modifiedEntity, deletedEntit
   }
   return {
     survivingModifications: [...survivingModifications].sort((left, right) => {
-      const byId2 = chunkOIFSOPSR_cjs.compareStrings(
+      const byId2 = chunkEZEEWCFJ_cjs.compareStrings(
         modifiedEntity(left).id,
         modifiedEntity(right).id
       );
-      return byId2 === 0 ? chunkOIFSOPSR_cjs.compareStrings(left.branchId, right.branchId) : byId2;
+      return byId2 === 0 ? chunkEZEEWCFJ_cjs.compareStrings(left.branchId, right.branchId) : byId2;
     }),
     deletions: [...deletions].sort(
-      (left, right) => chunkOIFSOPSR_cjs.compareStrings(left.id, right.id)
+      (left, right) => chunkEZEEWCFJ_cjs.compareStrings(left.id, right.id)
     ),
     conflicts: [...conflicts].sort(
-      (left, right) => chunkOIFSOPSR_cjs.compareStrings(left.entityId, right.entityId)
+      (left, right) => chunkEZEEWCFJ_cjs.compareStrings(left.entityId, right.entityId)
     ),
     dropped: [...dropped].sort(
-      (left, right) => chunkOIFSOPSR_cjs.compareStrings(left.id, right.id)
+      (left, right) => chunkEZEEWCFJ_cjs.compareStrings(left.id, right.id)
     )
   };
 }
@@ -3402,11 +3508,11 @@ function reconcileOver(survivingModifications, entityOf, rebuild, policy, branch
   }
   return {
     survivingModifications: [...out].sort((left, right) => {
-      const byId2 = chunkOIFSOPSR_cjs.compareStrings(entityOf(left).id, entityOf(right).id);
-      return byId2 === 0 ? chunkOIFSOPSR_cjs.compareStrings(left.branchId, right.branchId) : byId2;
+      const byId2 = chunkEZEEWCFJ_cjs.compareStrings(entityOf(left).id, entityOf(right).id);
+      return byId2 === 0 ? chunkEZEEWCFJ_cjs.compareStrings(left.branchId, right.branchId) : byId2;
     }),
     conflicts: conflicts.sort(
-      (left, right) => chunkOIFSOPSR_cjs.compareStrings(
+      (left, right) => chunkEZEEWCFJ_cjs.compareStrings(
         `${left.entityId}|${left.property}`,
         `${right.entityId}|${right.property}`
       )
@@ -3440,7 +3546,7 @@ function threeWayMergeProps(entityId, kind, baseProps, contributions, context, b
       propertyNames.add(name);
     }
   }
-  for (const property of [...propertyNames].sort(chunkOIFSOPSR_cjs.compareStrings)) {
+  for (const property of [...propertyNames].sort(chunkEZEEWCFJ_cjs.compareStrings)) {
     const baseHas = chunkN66HCGCY_cjs.hasOwnKey(baseProps, property);
     const baseKey = baseHas ? canonicalValueKey(chunkN66HCGCY_cjs.requireDefined(baseProps[property])) : void 0;
     const changed = contributions.filter((contribution) => {
@@ -3540,7 +3646,7 @@ function earliestEnd(claims) {
   let earliest;
   for (const claim of claims) {
     if (claim.change.kind !== "set") continue;
-    if (earliest === void 0 || chunkOIFSOPSR_cjs.compareStrings(claim.change.validTo, earliest) < 0) {
+    if (earliest === void 0 || chunkEZEEWCFJ_cjs.compareStrings(claim.change.validTo, earliest) < 0) {
       earliest = claim.change.validTo;
     }
   }
@@ -3556,7 +3662,7 @@ function resolveEndClaims(claims, preferredBranchId) {
 }
 function claimingBranches(claims) {
   return [...new Set(claims.map((claim) => claim.branchId))].sort(
-    (left, right) => chunkOIFSOPSR_cjs.compareStrings(left, right)
+    (left, right) => chunkEZEEWCFJ_cjs.compareStrings(left, right)
   );
 }
 function sameValidToChange(left, right) {
@@ -3653,7 +3759,7 @@ function resolvePopulation(entity, deltas, deletions, preferredBranchId, dropIte
         mergeKey(right.kind, right.id)
       )
     ),
-    dropped: dropped.sort((left, right) => chunkOIFSOPSR_cjs.compareStrings(left.id, right.id))
+    dropped: dropped.sort((left, right) => chunkEZEEWCFJ_cjs.compareStrings(left.id, right.id))
   };
 }
 function resolveValidWindows(staging, nodeDeletions, edgeDeletions, preferredBranchId) {
@@ -3742,7 +3848,7 @@ function rowsById(groupEdges) {
 function sourcePairByRow(rows) {
   const pairs = /* @__PURE__ */ new Map();
   for (const [id, members] of rows) {
-    const sorted = members.map((member) => member.sourcePair).sort((left, right) => chunkOIFSOPSR_cjs.compareStrings(left, right));
+    const sorted = members.map((member) => member.sourcePair).sort((left, right) => chunkEZEEWCFJ_cjs.compareStrings(left, right));
     pairs.set(id, chunkN66HCGCY_cjs.requireDefined(sorted[0]));
   }
   return pairs;
@@ -3753,14 +3859,14 @@ function foldSets(groupEdges) {
   const representatives = /* @__PURE__ */ new Map();
   for (const [id, pair] of sourcePairs) {
     const representative = representatives.get(pair);
-    if (representative === void 0 || chunkOIFSOPSR_cjs.compareStrings(id, representative) < 0) {
+    if (representative === void 0 || chunkEZEEWCFJ_cjs.compareStrings(id, representative) < 0) {
       representatives.set(pair, id);
     }
   }
   const collapsed = [];
   const parallel = [];
   for (const id of [...rows.keys()].sort(
-    (left, right) => chunkOIFSOPSR_cjs.compareStrings(left, right)
+    (left, right) => chunkEZEEWCFJ_cjs.compareStrings(left, right)
   )) {
     const members = chunkN66HCGCY_cjs.requireDefined(rows.get(id));
     const pair = chunkN66HCGCY_cjs.requireDefined(sourcePairs.get(id));
@@ -3773,7 +3879,7 @@ function foldSets(groupEdges) {
   return [collapsed, ...parallel];
 }
 function compareMembers(left, right, preferredBranchId) {
-  const byId2 = chunkOIFSOPSR_cjs.compareStrings(left.staged.id, right.staged.id);
+  const byId2 = chunkEZEEWCFJ_cjs.compareStrings(left.staged.id, right.staged.id);
   if (byId2 !== 0) {
     return byId2;
   }
@@ -3782,7 +3888,7 @@ function compareMembers(left, right, preferredBranchId) {
   if (leftPreferred !== rightPreferred) {
     return leftPreferred ? -1 : 1;
   }
-  return chunkOIFSOPSR_cjs.compareStrings(left.staged.branchId, right.staged.branchId);
+  return chunkEZEEWCFJ_cjs.compareStrings(left.staged.branchId, right.staged.branchId);
 }
 function pickSurvivor(edges, preferredBranchId) {
   const inherited = edges.filter(
@@ -3808,8 +3914,8 @@ function authoredProperty(edge, property) {
 }
 function unauthoredValue(property, edges) {
   const carriers = edges.filter((edge) => chunkN66HCGCY_cjs.hasOwnKey(edge.staged.props, property)).sort((left, right) => {
-    const byId2 = chunkOIFSOPSR_cjs.compareStrings(left.staged.id, right.staged.id);
-    return byId2 === 0 ? chunkOIFSOPSR_cjs.compareStrings(
+    const byId2 = chunkEZEEWCFJ_cjs.compareStrings(left.staged.id, right.staged.id);
+    return byId2 === 0 ? chunkEZEEWCFJ_cjs.compareStrings(
       canonicalValueKey(left.staged.props[property]),
       canonicalValueKey(right.staged.props[property])
     ) : byId2;
@@ -3826,7 +3932,7 @@ function unionEdgeProps(survivorId, kind, survivor, edges, context, branchRank,
   const props = chunkN66HCGCY_cjs.createDataKeyedBag();
   const conflicts = [];
   for (const property of [...propertyNames].sort(
-    (left, right) => chunkOIFSOPSR_cjs.compareStrings(left, right)
+    (left, right) => chunkEZEEWCFJ_cjs.compareStrings(left, right)
   )) {
     const claimants = edges.filter((edge) => authoredProperty(edge, property)).map((edge) => edge.staged);
     const values = collectConflictingValues(property, claimants);
@@ -3859,7 +3965,7 @@ function unionEdgeProps(survivorId, kind, survivor, edges, context, branchRank,
 function foldEdgeSet(foldSet, context, branchRank, preferredBranchId) {
   const survivor = pickSurvivor(foldSet, preferredBranchId);
   const survivorId = survivor.staged.id;
-  const mergedIds = foldSet.map((edge) => edge.staged.id).sort((left, right) => chunkOIFSOPSR_cjs.compareStrings(left, right));
+  const mergedIds = foldSet.map((edge) => edge.staged.id).sort((left, right) => chunkEZEEWCFJ_cjs.compareStrings(left, right));
   const fromId = idOf(survivor.fromKey);
   const fromKind = kindOf(survivor.fromKey);
   const toId = idOf(survivor.toKey);
@@ -3957,7 +4063,7 @@ function repointEdges(stagedEdges, canonicalOf, deletedNodeIds, policy, branchRa
   const merged = [];
   const conflicts = [];
   const sortedGroups = [...liveByGroup.keys()].sort(
-    (left, right) => chunkOIFSOPSR_cjs.compareStrings(left, right)
+    (left, right) => chunkEZEEWCFJ_cjs.compareStrings(left, right)
   );
   for (const group of sortedGroups) {
     const groupEdges = chunkN66HCGCY_cjs.requireDefined(liveByGroup.get(group));
@@ -3985,12 +4091,12 @@ function repointEdges(stagedEdges, canonicalOf, deletedNodeIds, policy, branchRa
       ),
       edge.id
     ])
-  })).sort((left, right) => chunkOIFSOPSR_cjs.compareStrings(left.sortKey, right.sortKey)).map(({ edge }) => edge);
+  })).sort((left, right) => chunkEZEEWCFJ_cjs.compareStrings(left.sortKey, right.sortKey)).map(({ edge }) => edge);
   return {
     edges: sortedEdges,
-    dropped: dropped.sort((left, right) => chunkOIFSOPSR_cjs.compareStrings(left.id, right.id)),
+    dropped: dropped.sort((left, right) => chunkEZEEWCFJ_cjs.compareStrings(left.id, right.id)),
     conflicts: conflicts.sort(
-      (left, right) => chunkOIFSOPSR_cjs.compareStrings(
+      (left, right) => chunkEZEEWCFJ_cjs.compareStrings(
         `${left.entityId}|${left.property}`,
         `${right.entityId}|${right.property}`
       )
@@ -4781,7 +4887,7 @@ function buildProvenanceGraph(targetGraphId) {
   });
 }
 async function openProvenanceStore(...args) {
-  const [backend, targetGraphId] = args.length === 1 ? [chunkMFZR4QKM_cjs.storeBackend(args[0]), args[0].graphId] : args;
+  const [backend, targetGraphId] = args.length === 1 ? [chunk3KOY4FH3_cjs.storeBackend(args[0]), args[0].graphId] : args;
   const graph = buildOwnedProvenanceGraph(targetGraphId);
   const preflight = await inspectSidecarGraphId(backend, graph, targetGraphId);
   if (preflight.state === "refuse") {
@@ -4793,7 +4899,7 @@ async function openProvenanceStore(...args) {
       throw provenanceGraphIdCollision(graph.id, targetGraphId, claim.reason);
     }
   }
-  const [store] = await chunkBR7SHKGM_cjs.createStoreWithSchema(graph, backend);
+  const [store] = await chunkSR725PWF_cjs.createStoreWithSchema(graph, backend);
   return store;
 }
 async function claimSidecarOwnership(backend, graph, targetGraphId) {
@@ -4842,14 +4948,14 @@ async function inspectSidecarGraphId(port, graph, targetGraphId) {
   if (activeSchema === void 0) {
     return { state: "refuse", reason: "application-graph" };
   }
-  const ownedHash = await chunk6JVZSOHQ_cjs.computeSchemaHash(
-    chunk6JVZSOHQ_cjs.serializeSchema(graph, activeSchema.version)
+  const ownedHash = await chunk3FPR224C_cjs.computeSchemaHash(
+    chunk3FPR224C_cjs.serializeSchema(graph, activeSchema.version)
   );
   if (activeSchema.schema_hash === ownedHash) {
     return { state: "refuse", reason: "unowned-exact-schema-graph" };
   }
-  const legacyHash = await chunk6JVZSOHQ_cjs.computeSchemaHash(
-    chunk6JVZSOHQ_cjs.serializeSchema(buildProvenanceGraph(targetGraphId), activeSchema.version)
+  const legacyHash = await chunk3FPR224C_cjs.computeSchemaHash(
+    chunk3FPR224C_cjs.serializeSchema(buildProvenanceGraph(targetGraphId), activeSchema.version)
   );
   if (activeSchema.schema_hash !== legacyHash) {
     return { state: "refuse", reason: "application-graph" };
@@ -5041,7 +5147,7 @@ function contributionKey(record) {
   ]);
 }
 function encodeProvenanceTuple(values) {
-  return values.some((value) => value.includes(ID_SEPARATOR)) ? chunkMX4DHSQP_cjs.encodeTupleKey(values) : values.join(ID_SEPARATOR);
+  return values.some((value) => value.includes(ID_SEPARATOR)) ? chunkEZEEWCFJ_cjs.encodeTupleKey(values) : values.join(ID_SEPARATOR);
 }
 async function provenanceNodeId(targetGraphId, record) {
   const tuple = encodeProvenanceTuple([
@@ -5084,7 +5190,7 @@ async function readProvenance(store, query = {}) {
   const all = await store.nodes.Provenance.find();
   return all.filter(
     (node) => (query.branchId === void 0 || node.branchId === query.branchId) && (query.canonicalId === void 0 || node.canonicalId === query.canonicalId) && (query.role === void 0 || node.role === query.role)
-  ).sort((left, right) => chunkOIFSOPSR_cjs.compareStrings(left.id, right.id));
+  ).sort((left, right) => chunkEZEEWCFJ_cjs.compareStrings(left.id, right.id));
 }
 
 // src/graph-merge/sources.ts
@@ -5094,10 +5200,10 @@ function orderEndpoints(left, right, sources) {
   return compareMergeKeys(leftKey, rightKey) <= 0 ? { a: leftKey, b: rightKey, left, right, sources } : { a: rightKey, b: leftKey, left: right, right: left, sources };
 }
 function sortMembersById(members) {
-  return [...members].sort((left, right) => chunkOIFSOPSR_cjs.compareStrings(left.id, right.id));
+  return [...members].sort((left, right) => chunkEZEEWCFJ_cjs.compareStrings(left.id, right.id));
 }
 function sortedBucketKeys(blocks) {
-  return [...blocks.keys()].sort((left, right) => chunkOIFSOPSR_cjs.compareStrings(left, right));
+  return [...blocks.keys()].sort((left, right) => chunkEZEEWCFJ_cjs.compareStrings(left, right));
 }
 var NODE_SYSTEM_FIELDS = /* @__PURE__ */ new Set(["id", "kind", "meta"]);
 function nodeProps(node) {
@@ -5125,7 +5231,7 @@ function windowedPairs(members, config) {
     key: fieldText(node, config.sortFields)
   }));
   keyed.sort(
-    (left, right) => left.key === right.key ? chunkOIFSOPSR_cjs.compareStrings(left.node.id, right.node.id) : chunkOIFSOPSR_cjs.compareStrings(left.key, right.key)
+    (left, right) => left.key === right.key ? chunkEZEEWCFJ_cjs.compareStrings(left.node.id, right.node.id) : chunkEZEEWCFJ_cjs.compareStrings(left.key, right.key)
   );
   const pairs = [];
   for (let index = 0; index < keyed.length; index += 1) {
@@ -5236,7 +5342,7 @@ function ontologyRetypeEdges(stagedIdentities, isRetypeCompatible) {
     }
   }
   const edges = [];
-  for (const id of [...identitiesById.keys()].sort(chunkOIFSOPSR_cjs.compareStrings)) {
+  for (const id of [...identitiesById.keys()].sort(chunkEZEEWCFJ_cjs.compareStrings)) {
     const identities = [...new Set(identitiesById.get(id))].sort(
       compareMergeKeys
     );
@@ -5344,7 +5450,7 @@ var baseUniqueSource = {
     const forcedEdges = [];
     const baseMembers = /* @__PURE__ */ new Map();
     const constraints = [...uniqueConstraints].sort(
-      (left, right) => chunkOIFSOPSR_cjs.compareStrings(left.name, right.name)
+      (left, right) => chunkEZEEWCFJ_cjs.compareStrings(left.name, right.name)
     );
     const items = nodes.map((node) => ({ props: nodeProps(node) }));
     const matchesByConstraint = await Promise.all(
@@ -5414,7 +5520,7 @@ var baseUniqueSource = {
       pairs: [],
       forcedEdges,
       baseMembers: [...baseMembers.values()].sort(
-        (left, right) => chunkOIFSOPSR_cjs.compareStrings(left.id, right.id)
+        (left, right) => chunkEZEEWCFJ_cjs.compareStrings(left.id, right.id)
       )
     };
   }
@@ -5492,7 +5598,7 @@ var baseKeySource = {
       pairs,
       forcedEdges: [],
       baseMembers: [...baseMembers.values()].sort(
-        (left, right) => chunkOIFSOPSR_cjs.compareStrings(left.id, right.id)
+        (left, right) => chunkEZEEWCFJ_cjs.compareStrings(left.id, right.id)
       )
     };
   }
@@ -5504,16 +5610,16 @@ var CANDIDATE_SOURCES = [
 
 // src/graph-merge/staging.ts
 function compareByIdThenBranch(left, right) {
-  const byId2 = chunkOIFSOPSR_cjs.compareStrings(left.id, right.id);
-  return byId2 === 0 ? chunkOIFSOPSR_cjs.compareStrings(left.branchId, right.branchId) : byId2;
+  const byId2 = chunkEZEEWCFJ_cjs.compareStrings(left.id, right.id);
+  return byId2 === 0 ? chunkEZEEWCFJ_cjs.compareStrings(left.branchId, right.branchId) : byId2;
 }
 function compareByKindIdBranch(left, right) {
-  const byKind = chunkOIFSOPSR_cjs.compareStrings(left.kind, right.kind);
+  const byKind = chunkEZEEWCFJ_cjs.compareStrings(left.kind, right.kind);
   if (byKind !== 0) {
     return byKind;
   }
-  const byId2 = chunkOIFSOPSR_cjs.compareStrings(left.id, right.id);
-  return byId2 === 0 ? chunkOIFSOPSR_cjs.compareStrings(left.branchId, right.branchId) : byId2;
+  const byId2 = chunkEZEEWCFJ_cjs.compareStrings(left.id, right.id);
+  return byId2 === 0 ? chunkEZEEWCFJ_cjs.compareStrings(left.branchId, right.branchId) : byId2;
 }
 function groupByKind(items) {
   const buckets = /* @__PURE__ */ new Map();
@@ -5527,7 +5633,7 @@ function groupByKind(items) {
   }
   const ordered = /* @__PURE__ */ new Map();
   for (const kind of [...buckets.keys()].sort(
-    (left, right) => chunkOIFSOPSR_cjs.compareStrings(left, right)
+    (left, right) => chunkEZEEWCFJ_cjs.compareStrings(left, right)
   )) {
     ordered.set(
       kind,
@@ -5549,7 +5655,7 @@ async function stageBranches(baseStore, branches, captureTargetStateFor) {
   const windowedEdges = [];
   const newIdentityAssertions = [];
   const retractedIdentityAssertions = [];
-  const baseIdentityAssertions = await chunkMFZR4QKM_cjs.storeRuntime(baseStore).readCurrentIdentityAssertions("state");
+  const baseIdentityAssertions = await chunk3KOY4FH3_cjs.storeRuntime(baseStore).readCurrentIdentityAssertions("state");
   let targetNodeVersions = /* @__PURE__ */ new Map();
   let targetEdgeSignatures = /* @__PURE__ */ new Map();
   for (const branch2 of branches) {
@@ -5620,17 +5726,17 @@ async function stageBranches(baseStore, branches, captureTargetStateFor) {
       (left, right) => compareByKindIdBranch(left, right)
     ),
     newIdentityAssertions: newIdentityAssertions.toSorted((left, right) => {
-      const byId2 = chunkOIFSOPSR_cjs.compareStrings(left.assertion.id, right.assertion.id);
-      return byId2 === 0 ? chunkOIFSOPSR_cjs.compareStrings(left.branchId, right.branchId) : byId2;
+      const byId2 = chunkEZEEWCFJ_cjs.compareStrings(left.assertion.id, right.assertion.id);
+      return byId2 === 0 ? chunkEZEEWCFJ_cjs.compareStrings(left.branchId, right.branchId) : byId2;
     }),
     retractedIdentityAssertions: retractedIdentityAssertions.toSorted(
       (left, right) => {
-        const byId2 = chunkOIFSOPSR_cjs.compareStrings(left.assertion.id, right.assertion.id);
-        return byId2 === 0 ? chunkOIFSOPSR_cjs.compareStrings(left.branchId, right.branchId) : byId2;
+        const byId2 = chunkEZEEWCFJ_cjs.compareStrings(left.assertion.id, right.assertion.id);
+        return byId2 === 0 ? chunkEZEEWCFJ_cjs.compareStrings(left.branchId, right.branchId) : byId2;
       }
     ),
     baseIdentityAssertions: baseIdentityAssertions.toSorted(
-      (left, right) => chunkOIFSOPSR_cjs.compareStrings(left.id, right.id)
+      (left, right) => chunkEZEEWCFJ_cjs.compareStrings(left.id, right.id)
     ),
     targetNodeVersions,
     targetEdgeSignatures
@@ -5682,7 +5788,7 @@ async function withTxConflictRetry(commit) {
 // src/graph-merge/type-reconcile.ts
 var INCOMPATIBLE_TYPES_FLAG_REASON = "type-reconcile:incompatible-kinds";
 function distinctKinds(kinds) {
-  return [...new Set(kinds)].sort((left, right) => chunkOIFSOPSR_cjs.compareStrings(left, right));
+  return [...new Set(kinds)].sort((left, right) => chunkEZEEWCFJ_cjs.compareStrings(left, right));
 }
 function areEquivalent(closure, left, right) {
   return left !== right && isReachable2(closure, left, right) && isReachable2(closure, right, left);
@@ -5701,7 +5807,7 @@ function mostSpecificCommonKind(closure, kinds) {
     return void 0;
   }
   return chunkN66HCGCY_cjs.requireDefined(
-    [...qualifiers].sort((left, right) => chunkOIFSOPSR_cjs.compareStrings(left, right))[0]
+    [...qualifiers].sort((left, right) => chunkEZEEWCFJ_cjs.compareStrings(left, right))[0]
   );
 }
 function reconcileTypes(clusters, closure, mode) {
@@ -5739,10 +5845,10 @@ function reconcileTypes(clusters, closure, mode) {
   }
   return {
     reconciliations: reconciliations.sort(
-      (left, right) => chunkOIFSOPSR_cjs.compareStrings(left.entityId, right.entityId)
+      (left, right) => chunkEZEEWCFJ_cjs.compareStrings(left.entityId, right.entityId)
     ),
     retypeMap,
-    dropped: dropped.sort((left, right) => chunkOIFSOPSR_cjs.compareStrings(left.id, right.id))
+    dropped: dropped.sort((left, right) => chunkEZEEWCFJ_cjs.compareStrings(left.id, right.id))
   };
 }
 
@@ -5760,8 +5866,8 @@ function newNodesByKind(staging) {
     ordered.set(
       kind,
       [...items].sort((left, right) => {
-        const byId2 = chunkOIFSOPSR_cjs.compareStrings(left.node.id, right.node.id);
-        return byId2 === 0 ? chunkOIFSOPSR_cjs.compareStrings(left.branchId, right.branchId) : byId2;
+        const byId2 = chunkEZEEWCFJ_cjs.compareStrings(left.node.id, right.node.id);
+        return byId2 === 0 ? chunkEZEEWCFJ_cjs.compareStrings(left.branchId, right.branchId) : byId2;
       })
     );
   }
@@ -5795,7 +5901,7 @@ async function precomputeEmbeddings(byKind, resolve, embedder) {
 }
 async function embedSortedTexts(texts, embedder) {
   const orderedTexts = [...texts].sort(
-    (left, right) => chunkOIFSOPSR_cjs.compareStrings(left, right)
+    (left, right) => chunkEZEEWCFJ_cjs.compareStrings(left, right)
   );
   const vectors = await embedder(orderedTexts);
   if (vectors.length !== orderedTexts.length) {
@@ -6070,9 +6176,9 @@ function buildProvenanceIndex(records) {
   for (const [branchId, sets] of byBranch) {
     frozen.set(branchId, {
       nodeIds: [...sets.nodeIds].sort(
-        (left, right) => chunkOIFSOPSR_cjs.compareStrings(left, right)
+        (left, right) => chunkEZEEWCFJ_cjs.compareStrings(left, right)
       ),
-      edgeIds: [...sets.edgeIds].sort((left, right) => chunkOIFSOPSR_cjs.compareStrings(left, right)).map((id) => id)
+      edgeIds: [...sets.edgeIds].sort((left, right) => chunkEZEEWCFJ_cjs.compareStrings(left, right)).map((id) => id)
     });
   }
   return {
@@ -6472,7 +6578,7 @@ function buildInternalMergePlan(staging, candidateEdges, candidateWarnings, cand
     ...identityRemap.dropped,
     ...validWindows.dropped
   ].sort(
-    (left, right) => chunkOIFSOPSR_cjs.compareStrings(`${left.kind}|${left.id}`, `${right.kind}|${right.id}`)
+    (left, right) => chunkEZEEWCFJ_cjs.compareStrings(`${left.kind}|${left.id}`, `${right.kind}|${right.id}`)
   );
   return {
     canonicalEntities,
@@ -6509,7 +6615,7 @@ function buildInternalMergePlan(staging, candidateEdges, candidateWarnings, cand
           mergeKey(left.kind, left.entityId),
           mergeKey(right.kind, right.entityId)
         );
-        return byEntity === 0 ? chunkOIFSOPSR_cjs.compareStrings(left.property, right.property) : byEntity;
+        return byEntity === 0 ? chunkEZEEWCFJ_cjs.compareStrings(left.property, right.property) : byEntity;
       }
     ),
     deleteModifyConflicts: [
@@ -6659,20 +6765,67 @@ function nodeWriteWindowOptions(write) {
     ...write.validTo === void 0 ? {} : { validTo: write.validTo }
   };
 }
-async function applyNodeRows(nodesApi, deletions, upserts) {
-  for (const deletion of deletions) {
-    await nodeCollection(nodesApi, deletion.kind).delete(deletion.id);
-  }
-  const committed = /* @__PURE__ */ new Set();
+async function applyNodeRows(target, txBackend, nodesApi, deletions, upserts) {
+  const afterImages = /* @__PURE__ */ new Map();
+  const upsertsByKind = /* @__PURE__ */ new Map();
   for (const upsert of upserts) {
-    await nodeCollection(nodesApi, upsert.kind).upsertByIdFromRecord(
-      upsert.id,
-      upsert.props,
-      nodeWriteWindowOptions(upsert)
+    const items = upsertsByKind.get(upsert.kind);
+    if (items === void 0) upsertsByKind.set(upsert.kind, [upsert]);
+    else items.push(upsert);
+  }
+  for (const [kind, items] of upsertsByKind) {
+    const currentRows = await nodeCollection(nodesApi, kind).getByIds(
+      items.map((item) => item.id),
+      INCLUDE_TOMBSTONES
     );
-    committed.add(mergeKey(upsert.kind, upsert.id));
+    const currentById = /* @__PURE__ */ new Map();
+    for (const node of currentRows) {
+      if (node !== void 0) currentById.set(node.id, nodeProps2(node));
+    }
+    for (const item of items) {
+      const props = chunkN66HCGCY_cjs.createDataKeyedBag();
+      const unset = new Set(
+        Object.entries(item.props).filter(([, value]) => value === void 0).map(([key]) => key)
+      );
+      for (const [key, value] of Object.entries(
+        currentById.get(item.id) ?? {}
+      )) {
+        if (!unset.has(key)) props[key] = value;
+      }
+      for (const [key, value] of Object.entries(item.props)) {
+        if (value !== void 0) props[key] = value;
+      }
+      afterImages.set(mergeKey(kind, item.id), props);
+    }
   }
-  return committed.size;
+  return chunk3KOY4FH3_cjs.storeRuntime(target).applyResolvedNodeUniqueness(
+    txBackend,
+    {
+      upserts: upserts.map((upsert) => ({
+        kind: upsert.kind,
+        id: upsert.id,
+        props: chunkN66HCGCY_cjs.requireDefined(
+          afterImages.get(mergeKey(upsert.kind, upsert.id))
+        )
+      })),
+      releases: deletions
+    },
+    async () => {
+      for (const deletion of deletions) {
+        await nodeCollection(nodesApi, deletion.kind).delete(deletion.id);
+      }
+      const committed = /* @__PURE__ */ new Set();
+      for (const upsert of upserts) {
+        await nodeCollection(nodesApi, upsert.kind).upsertByIdFromRecord(
+          upsert.id,
+          upsert.props,
+          nodeWriteWindowOptions(upsert)
+        );
+        committed.add(mergeKey(upsert.kind, upsert.id));
+      }
+      return committed.size;
+    }
+  );
 }
 async function applyEdgeRows(edgesApi, deletions, upserts) {
   for (const deletion of deletions) {
@@ -6693,7 +6846,7 @@ async function applyEdgeRows(edgesApi, deletions, upserts) {
 }
 async function applyIdentityRows(target, txBackend, assertions, retractions, assertConsistent) {
   try {
-    const applied = await chunkMFZR4QKM_cjs.storeRuntime(target).applyIdentityMergeAtTarget(
+    const applied = await chunk3KOY4FH3_cjs.storeRuntime(target).applyIdentityMergeAtTarget(
       txBackend,
       retractions,
       assertions
@@ -6733,7 +6886,13 @@ async function applyInternalMergePlan(plan, nodesApi, edgesApi, target, txBacken
   );
   let committedNodes;
   try {
-    committedNodes = await applyNodeRows(nodesApi, nodeDeletions, nodeUpserts);
+    committedNodes = await applyNodeRows(
+      target,
+      txBackend,
+      nodesApi,
+      nodeDeletions,
+      nodeUpserts
+    );
   } catch (error) {
     throw error instanceof chunkMRDBBHIZ_cjs.IdentityEndpointValidityError ? translateIdentityCommitError(error) : error;
   }
@@ -6785,7 +6944,7 @@ async function applyInternalMergePlan(plan, nodesApi, edgesApi, target, txBacken
   };
 }
 async function commitPlan(target, plan, expectedBaseVersion) {
-  if (!chunkMFZR4QKM_cjs.storeBackend(target).capabilities.transactions) {
+  if (!chunk3KOY4FH3_cjs.storeBackend(target).capabilities.transactions) {
     throw new MergeError(
       "merge() requires a transaction-capable target backend. The merged plan (canonical upserts, soft-deletes, edge upserts) must commit atomically; a non-transactional fallback would leave a partially-merged graph on a mid-commit failure. (mergeIncremental() enforces the same requirement.)",
       { details: { capability: "transactions" } }
@@ -6796,14 +6955,14 @@ async function commitPlan(target, plan, expectedBaseVersion) {
       () => target.transaction(async (tx) => {
         if (expectedBaseVersion !== void 0) {
           await assertTargetUnchanged(
-            chunkMFZR4QKM_cjs.transactionBackend(tx),
+            chunk3KOY4FH3_cjs.transactionBackend(tx),
             target,
             expectedBaseVersion
           );
         }
         await assertPlannedIdentityIdsFresh(
           target,
-          chunkMFZR4QKM_cjs.transactionBackend(tx),
+          chunk3KOY4FH3_cjs.transactionBackend(tx),
           plan
         );
         return applyInternalMergePlan(
@@ -6811,7 +6970,7 @@ async function commitPlan(target, plan, expectedBaseVersion) {
           tx.nodes,
           tx.edges,
           target,
-          chunkMFZR4QKM_cjs.transactionBackend(tx)
+          chunk3KOY4FH3_cjs.transactionBackend(tx)
         );
       }, mergeCommitTransactionOptions(target))
     )
@@ -6832,9 +6991,9 @@ function mergeCommitTransactionOptions(target) {
 }
 async function assertTargetUnchanged(txBackend, target, expectedBaseVersion) {
   if (hasRevisionAnchor(expectedBaseVersion)) {
-    await chunkOIFSOPSR_cjs.lockRecordedGraphWrite(txBackend, target.graphId);
+    await chunkEZEEWCFJ_cjs.lockRecordedGraphWrite(txBackend, target.graphId);
     const expectedOrigin = revisionOriginOf(expectedBaseVersion);
-    const liveOrigin = await chunkOIFSOPSR_cjs.readRevisionOrigin(
+    const liveOrigin = await chunkEZEEWCFJ_cjs.readRevisionOrigin(
       txBackend,
       target.revisionSchema,
       target.graphId
@@ -6848,7 +7007,7 @@ async function assertTargetUnchanged(txBackend, target, expectedBaseVersion) {
         }
       );
     }
-    const liveRevision = await chunkOIFSOPSR_cjs.readRecordedClock(
+    const liveRevision = await chunkEZEEWCFJ_cjs.readRecordedClock(
       txBackend,
       target.revisionSchema,
       target.graphId
@@ -6869,7 +7028,7 @@ async function assertTargetUnchanged(txBackend, target, expectedBaseVersion) {
     txBackend,
     target.graphId,
     target.graph,
-    await chunkMFZR4QKM_cjs.storeRuntime(target).identityAssertionsAtTarget(txBackend, "state")
+    await chunk3KOY4FH3_cjs.storeRuntime(target).identityAssertionsAtTarget(txBackend, "state")
   );
   const expectedContent = contentComponentOf(expectedBaseVersion);
   if (liveContent !== expectedContent) {
@@ -6961,7 +7120,7 @@ async function tryOpenProvenanceStore(target) {
   }
 }
 function assertPublicPlanCapability(target) {
-  if (!chunkMFZR4QKM_cjs.storeBackend(target).capabilities.transactions) {
+  if (!chunk3KOY4FH3_cjs.storeBackend(target).capabilities.transactions) {
     throw new MergePlanCapabilityError(
       "Public merge plans require a transaction-capable target backend.",
       { details: { capability: "transactions" } }
@@ -6980,7 +7139,7 @@ function assertPublicPlanCapability(target) {
 async function captureMergePlanTargetFence(target) {
   assertPublicPlanCapability(target);
   const [activeSchema, schemaHash, origin, revision] = await Promise.all([
-    chunkMFZR4QKM_cjs.storeBackend(target).getActiveSchema(target.graphId),
+    chunk3KOY4FH3_cjs.storeBackend(target).getActiveSchema(target.graphId),
     computeSchemaComponent(target),
     target.revisionOriginNow(),
     target.revisionNow()
@@ -7009,7 +7168,7 @@ async function assertPlanningFenceUnchanged(target, startingFence) {
 function splitWireProps(props) {
   const setProps = chunkN66HCGCY_cjs.createDataKeyedBag();
   const unsetProps = [];
-  for (const key of Object.keys(props).sort(chunkOIFSOPSR_cjs.compareStrings)) {
+  for (const key of Object.keys(props).sort(chunkEZEEWCFJ_cjs.compareStrings)) {
     const value = props[key];
     if (value === void 0) {
       unsetProps.push(key);
@@ -7146,7 +7305,7 @@ async function resolveMerge(store, target, branches, options, useBaseSources, in
     }
   }
   for (const branch2 of branches) {
-    const branchSchemaRow = await chunkMFZR4QKM_cjs.storeBackend(branch2.store).getActiveSchema(
+    const branchSchemaRow = await chunk3KOY4FH3_cjs.storeBackend(branch2.store).getActiveSchema(
       branch2.store.graphId
     );
     let drifted;
@@ -7154,7 +7313,7 @@ async function resolveMerge(store, target, branches, options, useBaseSources, in
       const anchor = branch2.schemaAnchor;
       drifted = anchor === void 0 ? branchSchemaRow !== void 0 : branchSchemaRow?.version !== anchor.version || branchSchemaRow.schema_hash !== anchor.hash;
     } else {
-      const sourceSchemaRow = await chunkMFZR4QKM_cjs.storeBackend(store).getActiveSchema(
+      const sourceSchemaRow = await chunk3KOY4FH3_cjs.storeBackend(store).getActiveSchema(
         store.graphId
       );
       drifted = branchSchemaRow?.schema_hash !== sourceSchemaRow?.schema_hash;
@@ -7199,7 +7358,7 @@ async function resolveMerge(store, target, branches, options, useBaseSources, in
       options.embedder
     );
     const ctx = {
-      backend: chunkMFZR4QKM_cjs.storeBackend(store),
+      backend: chunk3KOY4FH3_cjs.storeBackend(store),
       ...embeddings === void 0 ? {} : { embeddings }
     };
     const candidates = await generateAllCandidates(
@@ -7227,7 +7386,7 @@ async function resolveMerge(store, target, branches, options, useBaseSources, in
         ])
       ])
     ];
-    const targetPeers = identityProbeIds === void 0 ? [] : await chunkMFZR4QKM_cjs.storeRuntime(target).liveNodesSharingIds(identityProbeIds);
+    const targetPeers = identityProbeIds === void 0 ? [] : await chunk3KOY4FH3_cjs.storeRuntime(target).liveNodesSharingIds(identityProbeIds);
     const stagedIdentityIds = [
       .../* @__PURE__ */ new Set([
         ...staging.newIdentityAssertions.map((staged) => staged.assertion.id),
@@ -7236,7 +7395,7 @@ async function resolveMerge(store, target, branches, options, useBaseSources, in
         )
       ])
     ];
-    const storedIdentityRowsById = stagedIdentityIds.length === 0 || target.graph.identity === void 0 ? NO_STORED_ASSERTIONS : await chunkMFZR4QKM_cjs.storeRuntime(target).identityAssertionRowsByIds(
+    const storedIdentityRowsById = stagedIdentityIds.length === 0 || target.graph.identity === void 0 ? NO_STORED_ASSERTIONS : await chunk3KOY4FH3_cjs.storeRuntime(target).identityAssertionRowsByIds(
       stagedIdentityIds
     );
     const identityContext = {
@@ -7261,14 +7420,14 @@ async function resolveMerge(store, target, branches, options, useBaseSources, in
     if (plan.identityAssertions.length > 0) {
       assertOneIdOneTruth(
         plan.identityAssertions,
-        await chunkMFZR4QKM_cjs.storeRuntime(target).identityAssertionRowsByIds(
+        await chunk3KOY4FH3_cjs.storeRuntime(target).identityAssertionRowsByIds(
           plan.identityAssertions.map((assertion) => assertion.id)
         )
       );
     }
     let identityGuard;
     if (identityProbeIds !== void 0 && incremental !== void 0) {
-      const freshPeers = await chunkMFZR4QKM_cjs.storeRuntime(target).liveNodesSharingIds(identityProbeIds);
+      const freshPeers = await chunk3KOY4FH3_cjs.storeRuntime(target).liveNodesSharingIds(identityProbeIds);
       const built = await buildIdentityPeerProbe(
         target,
         identityProbeIds,
@@ -7397,7 +7556,8 @@ function incrementalSchemaError() {
     { details: {} }
   );
 }
-async function planMerge(store, branches, optionsInput = {}) {
+async function planMerge(store, branchInputs, optionsInput = {}) {
+  const branches = unwrapMergeBranches(branchInputs);
   const normalized = tryNormalize(optionsInput);
   if (chunkGYEG3ZLZ_cjs.isErr(normalized)) return chunkGYEG3ZLZ_cjs.err(normalized.error);
   const options = normalized.data;
@@ -7418,7 +7578,7 @@ async function planMerge(store, branches, optionsInput = {}) {
   const anchors = {
     kind: "snapshot",
     base: { graphId: store.graphId, baseVersion: precondition.data },
-    branches: [...branches].sort((left, right) => chunkOIFSOPSR_cjs.compareStrings(left.id, right.id)).map((branch2) => ({
+    branches: [...branches].sort((left, right) => chunkEZEEWCFJ_cjs.compareStrings(left.id, right.id)).map((branch2) => ({
       branchId: branch2.id,
       baseVersion: branch2.base
     }))
@@ -7438,7 +7598,8 @@ async function planMerge(store, branches, optionsInput = {}) {
   );
 }
 async function planMergeIncremental(args) {
-  const { forkPoint, target, branches } = args;
+  const { forkPoint, target } = args;
+  const branches = unwrapMergeBranches(args.branches);
   const normalized = tryNormalize(args.options ?? {}, ["target"]);
   if (chunkGYEG3ZLZ_cjs.isErr(normalized)) return chunkGYEG3ZLZ_cjs.err(normalized.error);
   const options = normalized.data;
@@ -7464,7 +7625,7 @@ async function planMergeIncremental(args) {
     computeSchemaComponent(target)
   ]);
   if (forkSchema !== targetSchema) return chunkGYEG3ZLZ_cjs.err(incrementalSchemaError());
-  const forkActiveSchema = await chunkMFZR4QKM_cjs.storeBackend(forkPoint).getActiveSchema(
+  const forkActiveSchema = await chunk3KOY4FH3_cjs.storeBackend(forkPoint).getActiveSchema(
     forkPoint.graphId
   );
   const targetBranch = {
@@ -7483,7 +7644,7 @@ async function planMergeIncremental(args) {
         hash: forkActiveSchema?.schema_hash ?? forkSchema
       }
     },
-    branches: [...branches].sort((left, right) => chunkOIFSOPSR_cjs.compareStrings(left.id, right.id)).map((branch2) => ({
+    branches: [...branches].sort((left, right) => chunkEZEEWCFJ_cjs.compareStrings(left.id, right.id)).map((branch2) => ({
       branchId: branch2.id,
       baseVersion: branch2.base
     }))
@@ -7808,7 +7969,7 @@ async function preflightWireMergeWrites(target, nodesApi, edgesApi, artifact) {
   }
 }
 async function assertMergePlanFenceInsideTransaction(target, txBackend, artifact) {
-  await chunkOIFSOPSR_cjs.lockRecordedGraphWrite(txBackend, target.graphId);
+  await chunkEZEEWCFJ_cjs.lockRecordedGraphWrite(txBackend, target.graphId);
   const activeSchema = await txBackend.getActiveSchema(target.graphId);
   const liveSchema = {
     managed: activeSchema !== void 0,
@@ -7821,7 +7982,7 @@ async function assertMergePlanFenceInsideTransaction(target, txBackend, artifact
       { details: { expected: artifact.target.schema, live: liveSchema } }
     );
   }
-  const liveOrigin = await chunkOIFSOPSR_cjs.readRevisionOrigin(
+  const liveOrigin = await chunkEZEEWCFJ_cjs.readRevisionOrigin(
     txBackend,
     target.revisionSchema,
     target.graphId
@@ -7837,7 +7998,7 @@ async function assertMergePlanFenceInsideTransaction(target, txBackend, artifact
       }
     );
   }
-  const liveRevision = await chunkOIFSOPSR_cjs.readRecordedClock(
+  const liveRevision = await chunkEZEEWCFJ_cjs.readRecordedClock(
     txBackend,
     target.revisionSchema,
     target.graphId
@@ -7879,6 +8040,8 @@ function identityConsistencySeeds(artifact, profile) {
 }
 async function applyWireMergeWrites(target, nodesApi, edgesApi, txBackend, artifact) {
   const committedNodes = await applyNodeRows(
+    target,
+    txBackend,
     nodesApi,
     artifact.writes.nodeDeletes,
     artifact.writes.nodeUpserts.map((upsert) => ({
@@ -7911,7 +8074,7 @@ async function applyWireMergeWrites(target, nodesApi, edgesApi, txBackend, artif
     txBackend,
     identityAssertions,
     identityRetractions,
-    () => chunkMFZR4QKM_cjs.storeRuntime(target).assertIdentityClassesConsistentAtTarget(
+    () => chunk3KOY4FH3_cjs.storeRuntime(target).assertIdentityClassesConsistentAtTarget(
       txBackend,
       identityConsistencySeeds(
         artifact,
@@ -7919,8 +8082,8 @@ async function applyWireMergeWrites(target, nodesApi, edgesApi, txBackend, artif
       )
     )
   );
-  if (!chunkOIFSOPSR_cjs.forceRecordedGraphRevision(txBackend, target.graphId) && !chunkMX4DHSQP_cjs.forceWriteTransactionRevision(txBackend)) {
-    await chunkOIFSOPSR_cjs.advanceRevisionClock(
+  if (!chunkEZEEWCFJ_cjs.forceRecordedGraphRevision(txBackend, target.graphId) && !chunkJFRT7S3B_cjs.forceWriteTransactionRevision(txBackend)) {
+    await chunkEZEEWCFJ_cjs.advanceRevisionClock(
       txBackend,
       target.revisionSchema,
       target.graphId,
@@ -7991,7 +8154,7 @@ async function applyMergePlan(target, input) {
     }
     const merged = await withTxConflictRetry(
       () => target.transaction(async (tx) => {
-        const txBackend = chunkMFZR4QKM_cjs.transactionBackend(tx);
+        const txBackend = chunk3KOY4FH3_cjs.transactionBackend(tx);
         await assertMergePlanFenceInsideTransaction(
           target,
           txBackend,
@@ -8051,7 +8214,8 @@ async function applyMergePlan(target, input) {
     );
   }
 }
-async function merge(store, branches, optionsInput = {}) {
+async function merge(store, branchInputs, optionsInput = {}) {
+  const branches = unwrapMergeBranches(branchInputs);
   const normalized = tryNormalize(optionsInput);
   if (chunkGYEG3ZLZ_cjs.isErr(normalized)) {
     return chunkGYEG3ZLZ_cjs.err(normalized.error);
@@ -8246,7 +8410,7 @@ async function validateIncrementalEdgeWrites(target, edgesApi, plan) {
       }
     }
   }
-  const notFound = [...plannedKindById.keys()].filter((id) => !existingById.has(id)).sort((left, right) => chunkOIFSOPSR_cjs.compareStrings(left, right));
+  const notFound = [...plannedKindById.keys()].filter((id) => !existingById.has(id)).sort((left, right) => chunkEZEEWCFJ_cjs.compareStrings(left, right));
   if (notFound.length > 0) {
     const crossKindById = /* @__PURE__ */ new Map();
     for (const kind of Object.keys(target.graph.edges)) {
@@ -8483,7 +8647,7 @@ async function assertForkPointUnchanged(precondition) {
   );
 }
 async function commitIncrementalPlan(target, plan, guard) {
-  if (!chunkMFZR4QKM_cjs.storeBackend(target).capabilities.transactions) {
+  if (!chunk3KOY4FH3_cjs.storeBackend(target).capabilities.transactions) {
     throw new MergeError(
       "mergeIncremental() requires a transaction-capable target backend. Incremental writes must preflight existing rows and commit atomically; non-transactional fallback would allow partial graph writes.",
       { details: { capability: "transactions" } }
@@ -8493,7 +8657,7 @@ async function commitIncrementalPlan(target, plan, guard) {
     () => withTxConflictRetry(
       () => target.transaction(async (tx) => {
         if (target.revisionTrackingEnabled) {
-          await chunkOIFSOPSR_cjs.lockRecordedGraphWrite(chunkMFZR4QKM_cjs.transactionBackend(tx), target.graphId);
+          await chunkEZEEWCFJ_cjs.lockRecordedGraphWrite(chunk3KOY4FH3_cjs.transactionBackend(tx), target.graphId);
         }
         await assertForkPointUnchanged(guard.forkPoint);
         const nodesApi = tx.nodes;
@@ -8504,12 +8668,12 @@ async function commitIncrementalPlan(target, plan, guard) {
         );
         await assertPlannedIdentityIdsFresh(
           target,
-          chunkMFZR4QKM_cjs.transactionBackend(tx),
+          chunk3KOY4FH3_cjs.transactionBackend(tx),
           plan
         );
         await assertIdentityPeersStable(
           target,
-          chunkMFZR4QKM_cjs.transactionBackend(tx),
+          chunk3KOY4FH3_cjs.transactionBackend(tx),
           guard.identityPeerProbe,
           plan
         );
@@ -8521,14 +8685,15 @@ async function commitIncrementalPlan(target, plan, guard) {
           nodesApi,
           edgesApi,
           target,
-          chunkMFZR4QKM_cjs.transactionBackend(tx)
+          chunk3KOY4FH3_cjs.transactionBackend(tx)
         );
       }, mergeCommitTransactionOptions(target))
     )
   );
 }
 async function mergeIncremental(args) {
-  const { forkPoint, target, branches } = args;
+  const { forkPoint, target } = args;
+  const branches = unwrapMergeBranches(args.branches);
   const normalized = tryNormalize(args.options ?? {}, ["target"]);
   if (chunkGYEG3ZLZ_cjs.isErr(normalized)) {
     return chunkGYEG3ZLZ_cjs.err(normalized.error);
@@ -8614,6 +8779,7 @@ exports.asBranchId = asBranchId;
 exports.branch = branch;
 exports.cloneWorkingCopyStrategy = cloneWorkingCopyStrategy;
 exports.computeBaseVersion = computeBaseVersion;
+exports.ingestionBranch = ingestionBranch;
 exports.merge = merge;
 exports.mergeIncremental = mergeIncremental;
 exports.normalizeMergeOptions = normalizeMergeOptions;