@nicia-ai/typegraph 0.42.1 → 0.44.0

package/dist/graph-merge/index.cjs

@@ -1,39 +1,39 @@
 'use strict';
 
-var chunk277UZV7X_cjs = require('../chunk-277UZV7X.cjs');
-require('../chunk-AQR6BHB3.cjs');
-var chunk5P6IPIT6_cjs = require('../chunk-5P6IPIT6.cjs');
-require('../chunk-K2HHCWZO.cjs');
-var chunk2SO5I5AI_cjs = require('../chunk-2SO5I5AI.cjs');
+var chunkXR4YZFKW_cjs = require('../chunk-XR4YZFKW.cjs');
+require('../chunk-HJH3RMXG.cjs');
+var chunkALFUGRYB_cjs = require('../chunk-ALFUGRYB.cjs');
+require('../chunk-NCX65HBY.cjs');
+var chunk7V2FGGI2_cjs = require('../chunk-7V2FGGI2.cjs');
 require('../chunk-ZDH3DX3C.cjs');
-require('../chunk-CVK4T34X.cjs');
-require('../chunk-ECU53PMN.cjs');
-require('../chunk-FSCJOTHF.cjs');
-var chunkV2GZBPY2_cjs = require('../chunk-V2GZBPY2.cjs');
+require('../chunk-CPEL3YIR.cjs');
+require('../chunk-3PRKZW6D.cjs');
+require('../chunk-EQ7JKLZO.cjs');
+var chunk2VLBGQBY_cjs = require('../chunk-2VLBGQBY.cjs');
 var chunkTRF4EBJT_cjs = require('../chunk-TRF4EBJT.cjs');
-var chunkDMZEVJGL_cjs = require('../chunk-DMZEVJGL.cjs');
-require('../chunk-ARN3ZODS.cjs');
+var chunkEE7N5XXQ_cjs = require('../chunk-EE7N5XXQ.cjs');
+require('../chunk-KKYELPZ2.cjs');
 var chunkACSVZPK7_cjs = require('../chunk-ACSVZPK7.cjs');
-require('../chunk-AO2WPYFZ.cjs');
-var chunkZPCKPLMX_cjs = require('../chunk-ZPCKPLMX.cjs');
-require('../chunk-ZBV4LQD2.cjs');
-require('../chunk-OM6RIOA5.cjs');
-require('../chunk-TRC646QQ.cjs');
-require('../chunk-I73ATSAH.cjs');
+require('../chunk-WBUFJ7BS.cjs');
+var chunkQB6VMOJ2_cjs = require('../chunk-QB6VMOJ2.cjs');
+require('../chunk-ZTAJL4DT.cjs');
+require('../chunk-IIT5K7SK.cjs');
+require('../chunk-GFRGG2US.cjs');
+require('../chunk-A2I2XO52.cjs');
 var chunkZY4GXIVN_cjs = require('../chunk-ZY4GXIVN.cjs');
 require('../chunk-NAUA4PW5.cjs');
-require('../chunk-UTTW2Q3M.cjs');
-require('../chunk-X2XOQZT3.cjs');
+require('../chunk-OVUUTCPJ.cjs');
+require('../chunk-U5W4LKZV.cjs');
 require('../chunk-FJMPR3OH.cjs');
 require('../chunk-SJDMVITW.cjs');
 var chunk764JHTLT_cjs = require('../chunk-764JHTLT.cjs');
 require('../chunk-HAHNRASW.cjs');
-var chunkXDMPDUKL_cjs = require('../chunk-XDMPDUKL.cjs');
+var chunkQYWINYEA_cjs = require('../chunk-QYWINYEA.cjs');
 require('../chunk-SVJ5GEXW.cjs');
-require('../chunk-F7TDKSVB.cjs');
+require('../chunk-HOHAJ2NR.cjs');
 require('../chunk-DI74SMXS.cjs');
-require('../chunk-O2GZM7UK.cjs');
-var chunkKTBTSHU6_cjs = require('../chunk-KTBTSHU6.cjs');
+require('../chunk-A4PBRX4C.cjs');
+var chunkC4F7VJ5D_cjs = require('../chunk-C4F7VJ5D.cjs');
 require('../chunk-TDXIBCGY.cjs');
 var zod = require('zod');
 
@@ -258,20 +258,20 @@ function byId(left, right) {
 }
 async function diffAgainstBase(baseStore, forkStore, captureForkState = true) {
   const graph = baseStore.graph;
-  const nodeKinds = chunkZPCKPLMX_cjs.getNodeKinds(graph);
-  const edgeKinds = chunkZPCKPLMX_cjs.getEdgeKinds(graph);
+  const nodeKinds = chunkQB6VMOJ2_cjs.getNodeKinds(graph);
+  const edgeKinds = chunkQB6VMOJ2_cjs.getEdgeKinds(graph);
   const newNodes = [];
   const modifiedNodes = [];
   const deletedNodes = [];
   const forkNodeVersions = /* @__PURE__ */ new Map();
   for (const kind of nodeKinds) {
     const baseRows = await enumerateAllNodes(
-      chunk2SO5I5AI_cjs.storeBackend(baseStore),
+      chunk7V2FGGI2_cjs.storeBackend(baseStore),
       baseStore.graphId,
       kind
     );
     const forkRows = await enumerateAllNodes(
-      chunk2SO5I5AI_cjs.storeBackend(forkStore),
+      chunk7V2FGGI2_cjs.storeBackend(forkStore),
       forkStore.graphId,
       kind
     );
@@ -297,12 +297,12 @@ async function diffAgainstBase(baseStore, forkStore, captureForkState = true) {
   const forkEdgeSignatures = /* @__PURE__ */ new Map();
   for (const kind of edgeKinds) {
     const baseRows = await enumerateAllEdges(
-      chunk2SO5I5AI_cjs.storeBackend(baseStore),
+      chunk7V2FGGI2_cjs.storeBackend(baseStore),
       baseStore.graphId,
       kind
     );
     const forkRows = await enumerateAllEdges(
-      chunk2SO5I5AI_cjs.storeBackend(forkStore),
+      chunk7V2FGGI2_cjs.storeBackend(forkStore),
       forkStore.graphId,
       kind
     );
@@ -368,10 +368,10 @@ async function readActiveSchemaVersion(backend, graphId) {
 }
 async function computeSchemaComponent(store) {
   const version = await readActiveSchemaVersion(
-    chunk2SO5I5AI_cjs.storeBackend(store),
+    chunk7V2FGGI2_cjs.storeBackend(store),
     store.graphId
   );
-  return chunkV2GZBPY2_cjs.computeSchemaHash(chunkV2GZBPY2_cjs.serializeSchema(store.graph, version));
+  return chunk2VLBGQBY_cjs.computeSchemaHash(chunk2VLBGQBY_cjs.serializeSchema(store.graph, version));
 }
 function byDigestEntry(left, right) {
   const byKind = chunkTRF4EBJT_cjs.compareStrings(left.kind, right.kind);
@@ -379,8 +379,8 @@ function byDigestEntry(left, right) {
 }
 var CONTENT_FINGERPRINT_BYTES = 16;
 async function computeContentComponent(backend, graphId, graph) {
-  const nodeKinds = chunkZPCKPLMX_cjs.getNodeKinds(graph);
-  const edgeKinds = chunkZPCKPLMX_cjs.getEdgeKinds(graph);
+  const nodeKinds = chunkQB6VMOJ2_cjs.getNodeKinds(graph);
+  const edgeKinds = chunkQB6VMOJ2_cjs.getEdgeKinds(graph);
   const nodeDigest = [];
   for (const kind of nodeKinds) {
     const rows = await enumerateAllNodes(backend, graphId, kind);
@@ -436,7 +436,7 @@ async function computeBaseVersion(store) {
   }
   const [schemaComponent, contentComponent] = await Promise.all([
     computeSchemaComponent(store),
-    computeContentComponent(chunk2SO5I5AI_cjs.storeBackend(store), store.graphId, store.graph)
+    computeContentComponent(chunk7V2FGGI2_cjs.storeBackend(store), store.graphId, store.graph)
   ]);
   return asBaseVersion(
     `${schemaComponent}${TOKEN_SEPARATOR}${contentComponent}`
@@ -487,7 +487,7 @@ function toTypeGraphErrorOptions(category, options) {
     ...options.cause === void 0 ? {} : { cause: options.cause }
   };
 }
-var MergeError = class extends chunkKTBTSHU6_cjs.TypeGraphError {
+var MergeError = class extends chunkC4F7VJ5D_cjs.TypeGraphError {
   constructor(message, options = {}) {
     super(
       message,
@@ -497,7 +497,7 @@ var MergeError = class extends chunkKTBTSHU6_cjs.TypeGraphError {
     this.name = "MergeError";
   }
 };
-var BranchError = class extends chunkKTBTSHU6_cjs.TypeGraphError {
+var BranchError = class extends chunkC4F7VJ5D_cjs.TypeGraphError {
   constructor(message, options = {}) {
     super(
       message,
@@ -542,7 +542,7 @@ function cloneWorkingCopyStrategy(makeBackend) {
     create: async (baseStore) => {
       const backend = await makeBackend();
       try {
-        const [freshStore] = await chunk277UZV7X_cjs.createStoreWithSchema(
+        const [freshStore] = await chunkXR4YZFKW_cjs.createStoreWithSchema(
           baseStore.graph,
           backend,
           {
@@ -551,9 +551,9 @@ function cloneWorkingCopyStrategy(makeBackend) {
             revisionTracking: baseStore.revisionTrackingEnabled
           }
         );
-        const result = await chunk5P6IPIT6_cjs.importGraphStream(
+        const result = await chunkALFUGRYB_cjs.importGraphStream(
           freshStore,
-          chunk5P6IPIT6_cjs.exportGraphStream(baseStore, {
+          chunkALFUGRYB_cjs.exportGraphStream(baseStore, {
             includeMeta: true,
             includeTemporal: true,
             includeDeleted: false,
@@ -588,12 +588,12 @@ function cloneWorkingCopyStrategy(makeBackend) {
 async function branch(baseStore, makeBackend, options, strategy) {
   try {
     const base = await computeBaseVersion(baseStore);
-    const id = options?.id ?? asBranchId(chunk2SO5I5AI_cjs.generateId());
+    const id = options?.id ?? asBranchId(chunk7V2FGGI2_cjs.generateId());
     const workingCopyStrategy = strategy ?? cloneWorkingCopyStrategy(makeBackend);
     const store = await workingCopyStrategy.create(baseStore);
-    return chunkXDMPDUKL_cjs.ok({ id, base, store });
+    return chunkQYWINYEA_cjs.ok({ id, base, store });
   } catch (error) {
-    return chunkXDMPDUKL_cjs.err(
+    return chunkQYWINYEA_cjs.err(
       new BranchError("Failed to create working-copy branch of base store", {
         cause: error
       })
@@ -617,7 +617,7 @@ function constraintSignature(node, constraint) {
       return void 0;
     }
   }
-  return `${constraint.name}${KEY_PART_SEPARATOR}${chunk2SO5I5AI_cjs.computeUniqueKey(
+  return `${constraint.name}${KEY_PART_SEPARATOR}${chunk7V2FGGI2_cjs.computeUniqueKey(
     props,
     constraint.fields,
     constraint.collation
@@ -1040,7 +1040,7 @@ function buildSubClassClosure(ontology) {
     relations.push([child, parent]);
   }
   return {
-    closure: chunkXDMPDUKL_cjs.computeTransitiveClosure(relations),
+    closure: chunkQYWINYEA_cjs.computeTransitiveClosure(relations),
     canonicalOf
   };
 }
@@ -1053,7 +1053,7 @@ function isReachable2(closure, from, to) {
   if (fromRep === toRep) {
     return from !== to;
   }
-  return chunkXDMPDUKL_cjs.isReachable(closure.closure, fromRep, toRep);
+  return chunkQYWINYEA_cjs.isReachable(closure.closure, fromRep, toRep);
 }
 
 // src/graph-merge/similarity.ts
@@ -1236,37 +1236,37 @@ function scorePrepared(left, right, strategy, ctx) {
   switch (strategy.kind) {
     case "custom": {
       const raw = strategy.score(left.node, right.node);
-      return chunkXDMPDUKL_cjs.ok(clampScore(raw));
+      return chunkQYWINYEA_cjs.ok(clampScore(raw));
     }
     case "fulltext": {
       if (left.text.length === 0 || right.text.length === 0) {
-        return chunkXDMPDUKL_cjs.ok(NO_EVIDENCE_SCORE);
+        return chunkQYWINYEA_cjs.ok(NO_EVIDENCE_SCORE);
       }
-      return chunkXDMPDUKL_cjs.ok(clampScore(diceFromMultisets(left.grams, right.grams)));
+      return chunkQYWINYEA_cjs.ok(clampScore(diceFromMultisets(left.grams, right.grams)));
     }
     case "vector": {
       if (ctx.embeddings === void 0) {
-        return chunkXDMPDUKL_cjs.err(embedderUnavailable("vector", ctx));
+        return chunkQYWINYEA_cjs.err(embedderUnavailable("vector", ctx));
       }
       if (left.text.length === 0 || right.text.length === 0) {
-        return chunkXDMPDUKL_cjs.ok(NO_EVIDENCE_SCORE);
+        return chunkQYWINYEA_cjs.ok(NO_EVIDENCE_SCORE);
       }
       const cosine = cosineFromLookup(ctx.embeddings, left.text, right.text);
-      return chunkXDMPDUKL_cjs.ok(clampScore(cosine));
+      return chunkQYWINYEA_cjs.ok(clampScore(cosine));
     }
     case "hybrid": {
       if (ctx.embeddings === void 0) {
-        return chunkXDMPDUKL_cjs.err(embedderUnavailable("hybrid", ctx));
+        return chunkQYWINYEA_cjs.err(embedderUnavailable("hybrid", ctx));
       }
       if (left.text.length === 0 || right.text.length === 0) {
-        return chunkXDMPDUKL_cjs.ok(NO_EVIDENCE_SCORE);
+        return chunkQYWINYEA_cjs.ok(NO_EVIDENCE_SCORE);
       }
       const vectorScore = clampScore(
         cosineFromLookup(ctx.embeddings, left.text, right.text)
       );
       const fulltextScore = diceFromMultisets(left.grams, right.grams);
       const weights = normalizeHybridWeights(strategy.weights);
-      return chunkXDMPDUKL_cjs.ok(
+      return chunkQYWINYEA_cjs.ok(
         clampScore(
           weights.vector * vectorScore + weights.fulltext * fulltextScore
         )
@@ -1324,7 +1324,7 @@ function scoreCandidates(input, resolveConfig, ctx, ceilingPolicy, maxComparison
   }
   if (maxComparisonsPerKind !== void 0 && fuzzy.length > maxComparisonsPerKind) {
     if (ceilingPolicy === "error") {
-      return chunkXDMPDUKL_cjs.err(
+      return chunkQYWINYEA_cjs.err(
         new MergeError(
           `Comparison ceiling exceeded: ${fuzzy.length} candidate pairs > maxComparisonsPerKind ${maxComparisonsPerKind}.`,
           {
@@ -1337,7 +1337,7 @@ function scoreCandidates(input, resolveConfig, ctx, ceilingPolicy, maxComparison
         )
       );
     }
-    return chunkXDMPDUKL_cjs.ok({
+    return chunkQYWINYEA_cjs.ok({
       edges: [...forced].sort(
         (left, right) => compareCandidateEdges(left, right)
       ),
@@ -1355,14 +1355,14 @@ function scoreCandidates(input, resolveConfig, ctx, ceilingPolicy, maxComparison
   const edges = [...forced];
   for (const { left, right, a, b } of fuzzy) {
     const scored = scorer(a, left, b, right);
-    if (chunkXDMPDUKL_cjs.isErr(scored)) {
-      return chunkXDMPDUKL_cjs.err(scored.error);
+    if (chunkQYWINYEA_cjs.isErr(scored)) {
+      return chunkQYWINYEA_cjs.err(scored.error);
     }
     if (scored.data >= threshold) {
       edges.push({ a, b, score: scored.data });
     }
   }
-  return chunkXDMPDUKL_cjs.ok({
+  return chunkQYWINYEA_cjs.ok({
     edges: edges.sort((left, right) => compareCandidateEdges(left, right)),
     warnings: []
   });
@@ -2170,7 +2170,7 @@ function normalizeMergeOptions(options = {}) {
     ...provenanceWeights === void 0 ? {} : { provenanceWeights }
   };
 }
-var Provenance = chunkDMZEVJGL_cjs.defineNode("Provenance", {
+var Provenance = chunkEE7N5XXQ_cjs.defineNode("Provenance", {
   schema: zod.z.object({
     targetGraphId: zod.z.string(),
     role: zod.z.enum(["node", "edge"]),
@@ -2184,15 +2184,15 @@ function provenanceGraphId(targetGraphId) {
   return `${targetGraphId}::merge-provenance`;
 }
 function buildProvenanceGraph(targetGraphId) {
-  return chunkZPCKPLMX_cjs.defineGraph({
+  return chunkQB6VMOJ2_cjs.defineGraph({
     id: provenanceGraphId(targetGraphId),
     nodes: { Provenance: { type: Provenance } },
     edges: {}
   });
 }
 async function openProvenanceStore(...args) {
-  const [backend, targetGraphId] = args.length === 1 ? [chunk2SO5I5AI_cjs.storeBackend(args[0]), args[0].graphId] : args;
-  const [store] = await chunk277UZV7X_cjs.createStoreWithSchema(
+  const [backend, targetGraphId] = args.length === 1 ? [chunk7V2FGGI2_cjs.storeBackend(args[0]), args[0].graphId] : args;
+  const [store] = await chunkXR4YZFKW_cjs.createStoreWithSchema(
     buildProvenanceGraph(targetGraphId),
     backend
   );
@@ -2874,7 +2874,7 @@ async function generateAllCandidates(target, staging, options, introspectionKind
       async ([kind, items]) => {
         const resolveConfig = options.resolve[kind];
         if (resolveConfig === void 0) {
-          return chunkXDMPDUKL_cjs.ok({ edges: [], warnings: [], baseMembers: [] });
+          return chunkQYWINYEA_cjs.ok({ edges: [], warnings: [], baseMembers: [] });
         }
         const nodes = items.map((staged) => asNode(staged));
         const uniqueConstraints = uniqueConstraintsFor(
@@ -2917,10 +2917,10 @@ async function generateAllCandidates(target, staging, options, introspectionKind
           options.onComparisonCeiling,
           options.maxComparisonsPerKind
         );
-        if (chunkXDMPDUKL_cjs.isErr(scored)) {
-          return chunkXDMPDUKL_cjs.err(scored.error);
+        if (chunkQYWINYEA_cjs.isErr(scored)) {
+          return chunkQYWINYEA_cjs.err(scored.error);
         }
-        return chunkXDMPDUKL_cjs.ok({
+        return chunkQYWINYEA_cjs.ok({
           edges: scored.data.edges,
           warnings: scored.data.warnings.map(
             (warning) => `[${kind}] ${warning.message}`
@@ -2931,14 +2931,14 @@ async function generateAllCandidates(target, staging, options, introspectionKind
     )
   );
   for (const result of perKind) {
-    if (chunkXDMPDUKL_cjs.isErr(result)) {
-      return chunkXDMPDUKL_cjs.err(result.error);
+    if (chunkQYWINYEA_cjs.isErr(result)) {
+      return chunkQYWINYEA_cjs.err(result.error);
     }
     allEdges.push(...result.data.edges);
     warnings.push(...result.data.warnings);
     baseMembers.push(...result.data.baseMembers);
   }
-  return chunkXDMPDUKL_cjs.ok({
+  return chunkQYWINYEA_cjs.ok({
     // The ONE shared `(a, b)` edge comparator (id-first `(kind, id)` order), so this
     // stage emits edges in exactly the order clustering consumes them.
     edges: allEdges.sort((left, right) => compareCandidateEdges(left, right)),
@@ -3421,7 +3421,7 @@ async function applyMergePlan(plan, nodesApi, edgesApi) {
   return { nodes: committedNodeIds.size, edges: committedEdges };
 }
 async function commitPlan(target, plan, expectedBaseVersion) {
-  if (!chunk2SO5I5AI_cjs.storeBackend(target).capabilities.transactions) {
+  if (!chunk7V2FGGI2_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" } }
@@ -3431,7 +3431,7 @@ async function commitPlan(target, plan, expectedBaseVersion) {
     () => target.transaction(async (tx) => {
       if (expectedBaseVersion !== void 0) {
         await assertTargetUnchanged(
-          chunk2SO5I5AI_cjs.transactionBackend(tx),
+          chunk7V2FGGI2_cjs.transactionBackend(tx),
           target,
           expectedBaseVersion
         );
@@ -3452,9 +3452,9 @@ function mergeCommitTransactionOptions(target) {
 }
 async function assertTargetUnchanged(txBackend, target, expectedBaseVersion) {
   if (hasRevisionAnchor(expectedBaseVersion)) {
-    await chunk2SO5I5AI_cjs.lockRecordedGraphWrite(txBackend, target.graphId);
+    await chunk7V2FGGI2_cjs.lockRecordedGraphWrite(txBackend, target.graphId);
     const expectedOrigin = revisionOriginOf(expectedBaseVersion);
-    const liveOrigin = await chunk2SO5I5AI_cjs.readRevisionOrigin(
+    const liveOrigin = await chunk7V2FGGI2_cjs.readRevisionOrigin(
       txBackend,
       target.revisionSchema,
       target.graphId
@@ -3468,7 +3468,7 @@ async function assertTargetUnchanged(txBackend, target, expectedBaseVersion) {
         }
       );
     }
-    const liveRevision = await chunk2SO5I5AI_cjs.readRecordedClock(
+    const liveRevision = await chunk7V2FGGI2_cjs.readRecordedClock(
       txBackend,
       target.revisionSchema,
       target.graphId
@@ -3526,7 +3526,7 @@ async function validateBaseVersions(target, branches) {
   const targetVersion = await computeBaseVersion(target);
   for (const branch2 of branches) {
     if (branch2.base !== targetVersion) {
-      return chunkXDMPDUKL_cjs.err(
+      return chunkQYWINYEA_cjs.err(
         new BaseVersionMismatchError(
           `Branch "${branch2.id}" forked from base@V "${branch2.base}", which does not match the merge target's current base@V "${targetVersion}".`,
           {
@@ -3540,20 +3540,20 @@ async function validateBaseVersions(target, branches) {
       );
     }
   }
-  return chunkXDMPDUKL_cjs.ok(targetVersion);
+  return chunkQYWINYEA_cjs.ok(targetVersion);
 }
 function tryNormalize(optionsInput) {
   try {
-    return chunkXDMPDUKL_cjs.ok(normalizeMergeOptions(optionsInput));
+    return chunkQYWINYEA_cjs.ok(normalizeMergeOptions(optionsInput));
   } catch (error) {
-    return chunkXDMPDUKL_cjs.err(new MergeError("Invalid merge options.", { cause: error }));
+    return chunkQYWINYEA_cjs.err(new MergeError("Invalid merge options.", { cause: error }));
   }
 }
 async function resolveMerge(store, target, branches, options, useBaseSources, incremental, expectedBaseVersion) {
   let targetBranchSeen = false;
   for (const branch2 of branches) {
     if (branch2.id === BASE_PROVENANCE_BRANCH) {
-      return chunkXDMPDUKL_cjs.err(
+      return chunkQYWINYEA_cjs.err(
         new MergeError(
           `Branch id "${BASE_PROVENANCE_BRANCH}" is reserved for committed-base provenance and cannot be used as a branch id.`,
           { details: { branchId: branch2.id } }
@@ -3562,7 +3562,7 @@ async function resolveMerge(store, target, branches, options, useBaseSources, in
     }
     if (branch2.id === COMMITTED_TARGET_BRANCH) {
       if (incremental?.targetBranchId !== COMMITTED_TARGET_BRANCH || targetBranchSeen) {
-        return chunkXDMPDUKL_cjs.err(
+        return chunkQYWINYEA_cjs.err(
           new MergeError(
             `Branch id "${COMMITTED_TARGET_BRANCH}" is reserved for the committed incremental target and cannot be used as a branch id.`,
             { details: { branchId: branch2.id } }
@@ -3595,7 +3595,7 @@ async function resolveMerge(store, target, branches, options, useBaseSources, in
       options.embedder
     );
     const ctx = {
-      backend: chunk2SO5I5AI_cjs.storeBackend(store),
+      backend: chunk7V2FGGI2_cjs.storeBackend(store),
       ...embeddings === void 0 ? {} : { embeddings }
     };
     const candidates = await generateAllCandidates(
@@ -3607,8 +3607,8 @@ async function resolveMerge(store, target, branches, options, useBaseSources, in
       useBaseSources,
       options.embedder
     );
-    if (chunkXDMPDUKL_cjs.isErr(candidates)) {
-      return chunkXDMPDUKL_cjs.err(candidates.error);
+    if (chunkQYWINYEA_cjs.isErr(candidates)) {
+      return chunkQYWINYEA_cjs.err(candidates.error);
     }
     const plan = planMerge(
       staging,
@@ -3665,12 +3665,12 @@ async function resolveMerge(store, target, branches, options, useBaseSources, in
       warnings,
       ...provenancePersisted === void 0 ? {} : { provenancePersisted }
     };
-    return chunkXDMPDUKL_cjs.ok(report);
+    return chunkQYWINYEA_cjs.ok(report);
   } catch (error) {
     if (error instanceof MergeError) {
-      return chunkXDMPDUKL_cjs.err(error);
+      return chunkQYWINYEA_cjs.err(error);
     }
-    return chunkXDMPDUKL_cjs.err(
+    return chunkQYWINYEA_cjs.err(
       new MergeError(
         `Merge failed while staging or committing: ${describeCause(error)}`,
         { cause: error }
@@ -3680,14 +3680,14 @@ async function resolveMerge(store, target, branches, options, useBaseSources, in
 }
 async function merge(store, branches, optionsInput = {}) {
   const normalized = tryNormalize(optionsInput);
-  if (chunkXDMPDUKL_cjs.isErr(normalized)) {
-    return chunkXDMPDUKL_cjs.err(normalized.error);
+  if (chunkQYWINYEA_cjs.isErr(normalized)) {
+    return chunkQYWINYEA_cjs.err(normalized.error);
   }
   const options = normalized.data;
   const target = options.target ?? store;
   const precondition = await validateBaseVersions(target, branches);
-  if (chunkXDMPDUKL_cjs.isErr(precondition)) {
-    return chunkXDMPDUKL_cjs.err(precondition.error);
+  if (chunkQYWINYEA_cjs.isErr(precondition)) {
+    return chunkQYWINYEA_cjs.err(precondition.error);
   }
   return resolveMerge(
     store,
@@ -3703,7 +3703,7 @@ async function validateForkPointVersions(forkPoint, branches) {
   const forkVersion = await computeBaseVersion(forkPoint);
   for (const branch2 of branches) {
     if (branch2.base !== forkVersion) {
-      return chunkXDMPDUKL_cjs.err(
+      return chunkQYWINYEA_cjs.err(
         new BaseVersionMismatchError(
           `Branch "${branch2.id}" forked from base@V "${branch2.base}", which does not match the fork-point's base@V "${forkVersion}". mergeIncremental() requires every branch to have forked from the supplied forkPoint.`,
           {
@@ -3717,7 +3717,7 @@ async function validateForkPointVersions(forkPoint, branches) {
       );
     }
   }
-  return chunkXDMPDUKL_cjs.ok(forkVersion);
+  return chunkQYWINYEA_cjs.ok(forkVersion);
 }
 function nodeSchemaFor(target, kind) {
   const registry = target.graph.nodes;
@@ -4151,7 +4151,7 @@ async function assertInheritedEdgesUnchanged(edgesApi, guard, plan) {
   });
 }
 async function commitIncrementalPlan(target, plan, guard) {
-  if (!chunk2SO5I5AI_cjs.storeBackend(target).capabilities.transactions) {
+  if (!chunk7V2FGGI2_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" } }
@@ -4160,7 +4160,7 @@ async function commitIncrementalPlan(target, plan, guard) {
   return withTxConflictRetry(
     () => target.transaction(async (tx) => {
       if (target.revisionTrackingEnabled) {
-        await chunk2SO5I5AI_cjs.lockRecordedGraphWrite(chunk2SO5I5AI_cjs.transactionBackend(tx), target.graphId);
+        await chunk7V2FGGI2_cjs.lockRecordedGraphWrite(chunk7V2FGGI2_cjs.transactionBackend(tx), target.graphId);
       }
       const nodesApi = tx.nodes;
       const edgesApi = tx.edges;
@@ -4175,12 +4175,12 @@ async function commitIncrementalPlan(target, plan, guard) {
 async function mergeIncremental(args) {
   const { forkPoint, target, branches } = args;
   const normalized = tryNormalize(args.options ?? {});
-  if (chunkXDMPDUKL_cjs.isErr(normalized)) {
-    return chunkXDMPDUKL_cjs.err(normalized.error);
+  if (chunkQYWINYEA_cjs.isErr(normalized)) {
+    return chunkQYWINYEA_cjs.err(normalized.error);
   }
   const options = normalized.data;
   if (options.onBasePropertyConflict !== "flag") {
-    return chunkXDMPDUKL_cjs.err(
+    return chunkQYWINYEA_cjs.err(
       new MergeError(
         'mergeIncremental() requires onBasePropertyConflict: "flag" (keep-base); a non-keep-base policy could overwrite a newer committed base value with a stale branch value.',
         { details: {} }
@@ -4188,8 +4188,8 @@ async function mergeIncremental(args) {
     );
   }
   const forkPrecondition = await validateForkPointVersions(forkPoint, branches);
-  if (chunkXDMPDUKL_cjs.isErr(forkPrecondition)) {
-    return chunkXDMPDUKL_cjs.err(forkPrecondition.error);
+  if (chunkQYWINYEA_cjs.isErr(forkPrecondition)) {
+    return chunkQYWINYEA_cjs.err(forkPrecondition.error);
   }
   const forkVersion = forkPrecondition.data;
   const [forkSchema, targetSchema] = await Promise.all([
@@ -4197,7 +4197,7 @@ async function mergeIncremental(args) {
     computeSchemaComponent(target)
   ]);
   if (forkSchema !== targetSchema) {
-    return chunkXDMPDUKL_cjs.err(
+    return chunkQYWINYEA_cjs.err(
       new MergeError(
         "mergeIncremental() requires target and forkPoint to share a schema; schema drift is not supported (the target content may differ \u2014 only the schema must match).",
         { details: {} }
@@ -4221,15 +4221,15 @@ async function mergeIncremental(args) {
 
 Object.defineProperty(exports, "isErr", {
   enumerable: true,
-  get: function () { return chunkXDMPDUKL_cjs.isErr; }
+  get: function () { return chunkQYWINYEA_cjs.isErr; }
 });
 Object.defineProperty(exports, "isOk", {
   enumerable: true,
-  get: function () { return chunkXDMPDUKL_cjs.isOk; }
+  get: function () { return chunkQYWINYEA_cjs.isOk; }
 });
 Object.defineProperty(exports, "unwrap", {
   enumerable: true,
-  get: function () { return chunkXDMPDUKL_cjs.unwrap; }
+  get: function () { return chunkQYWINYEA_cjs.unwrap; }
 });
 exports.BaseVersionMismatchError = BaseVersionMismatchError;
 exports.BranchError = BranchError;

package/dist/graph-merge/index.d.cts

@@ -1,14 +1,15 @@
-import { G as GraphDef, N as NodeKinds, c as GetNodeType } from '../define-graph-Byslw2OO.cjs';
-import { a as Store, ar as Node, bR as UniqueIntrospection } from '../store-view-CNcOG8bQ.cjs';
-import { aU as NodeId, a as NodeType, am as EdgeId, aM as JsonValue, w as GraphBackend, aN as KindAnnotations, aQ as MetaEdge, _ as EdgeType, D as DeleteBehavior, T as TemporalMode, I as IndexDeclaration, aC as GraphExtensionVersion, bV as ExtensionNodeDef, bW as ExtensionEdgeDef, bX as ExtensionOntologyRelation, bY as ExtensionIndex } from '../types-Dh-EgT-w.cjs';
-import { a1 as TypeGraphError } from '../index-DHXw7QAl.cjs';
+import { aY as NodeId, b as NodeType, ap as EdgeId, aP as JsonValue, x as GraphBackend, aQ as KindAnnotations, aU as MetaEdge, a0 as EdgeType, D as DeleteBehavior, T as TemporalMode, I as IndexDeclaration, aF as GraphExtensionVersion, c1 as ExtensionNodeDef, c2 as ExtensionEdgeDef, c3 as ExtensionOntologyRelation, c4 as ExtensionIndex } from '../types-Cjvkj0jA.cjs';
+export { C as ContributionDiagnostic, a as ContributionDiagnosticState } from '../types-Cjvkj0jA.cjs';
+import { G as GraphDef, N as NodeKinds, c as GetNodeType } from '../define-graph-DVF-oN1i.cjs';
+import { a as Store, at as Node, bT as UniqueIntrospection } from '../store-view-w-md0nQ4.cjs';
+import { a1 as TypeGraphError } from '../index-DcQ3Sxs-.cjs';
 import { R as Result } from '../result-DWo6mUVz.cjs';
 export { i as isErr, a as isOk, u as unwrap } from '../result-DWo6mUVz.cjs';
 import { z } from 'zod';
-import '../temporal-CMpigMCW.cjs';
-import '../manager-U9_zopqr.cjs';
-import '../materialize-indexes-DzMCetZe.cjs';
-import '../searchable-B4mUXZT6.cjs';
+import '../temporal-BCORwUau.cjs';
+import '../manager-Cn0NFIhN.cjs';
+import '../materialize-indexes-DVRhd5h4.cjs';
+import '../searchable-BT7j9_IK.cjs';
 
 /**
  * Core type model for the graph-merge primitive.

package/dist/graph-merge/index.d.ts

@@ -1,14 +1,15 @@
-import { G as GraphDef, N as NodeKinds, c as GetNodeType } from '../define-graph-DBFnc7u_.js';
-import { a as Store, ar as Node, bR as UniqueIntrospection } from '../store-view-6C2vTWqf.js';
-import { aU as NodeId, a as NodeType, am as EdgeId, aM as JsonValue, w as GraphBackend, aN as KindAnnotations, aQ as MetaEdge, _ as EdgeType, D as DeleteBehavior, T as TemporalMode, I as IndexDeclaration, aC as GraphExtensionVersion, bV as ExtensionNodeDef, bW as ExtensionEdgeDef, bX as ExtensionOntologyRelation, bY as ExtensionIndex } from '../types-Dh-EgT-w.js';
-import { a1 as TypeGraphError } from '../index-DQzVJBHa.js';
+import { aY as NodeId, b as NodeType, ap as EdgeId, aP as JsonValue, x as GraphBackend, aQ as KindAnnotations, aU as MetaEdge, a0 as EdgeType, D as DeleteBehavior, T as TemporalMode, I as IndexDeclaration, aF as GraphExtensionVersion, c1 as ExtensionNodeDef, c2 as ExtensionEdgeDef, c3 as ExtensionOntologyRelation, c4 as ExtensionIndex } from '../types-Cjvkj0jA.js';
+export { C as ContributionDiagnostic, a as ContributionDiagnosticState } from '../types-Cjvkj0jA.js';
+import { G as GraphDef, N as NodeKinds, c as GetNodeType } from '../define-graph-SvYXOl78.js';
+import { a as Store, at as Node, bT as UniqueIntrospection } from '../store-view-Bvdku0Ht.js';
+import { a1 as TypeGraphError } from '../index-By89Sezh.js';
 import { R as Result } from '../result-DWo6mUVz.js';
 export { i as isErr, a as isOk, u as unwrap } from '../result-DWo6mUVz.js';
 import { z } from 'zod';
-import '../temporal-BtrTYTiB.js';
-import '../manager-Dl0-er1G.js';
-import '../materialize-indexes-BM3u0aXE.js';
-import '../searchable-C7jmPNLT.js';
+import '../temporal--x9T8K4S.js';
+import '../manager-B0KjKE93.js';
+import '../materialize-indexes-BD4V3svD.js';
+import '../searchable-CnYEancP.js';
 
 /**
  * Core type model for the graph-merge primitive.