@nicia-ai/typegraph 0.66.1 → 0.67.0

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # @nicia-ai/typegraph
 
+## 0.67.0
+
+### Highlights
+
+TypeGraph 0.67 adds durable graph-merge branches for workflows that outlive one process. `branchDurable()` creates a persistent working copy and a JSON-safe descriptor that can cross a queue, deployment, or machine boundary; `reopenDurableBranch()` restores the ordinary `GraphBranch` used by merge planning, and `destroyDurableBranch()` explicitly removes or archives the host allocation. The existing reviewable plan/apply lifecycle remains the source of truth for accepted graph changes.
+
+Durable strategies own host allocation and reconnection while TypeGraph validates the sealed graph, schema, branch, and base origin. Creation fences writes racing the allocation and accepts either an exact revision token or a complete semantic match when the persistent copy has its own revision namespace. Strategies can optionally attempt a proven-equivalent native merge; a mutation-free `unsupported` result returns to the complete portable apply path, while uncertain native failures never risk a second application.
+
+### Upgrade notes
+
+- Existing `branch()` and portable merge workflows require no changes. Use the durable APIs only when a working copy must survive closing its current backend or move between processes.
+- Custom durable strategies must return a non-secret, JSON-safe locator and attest the complete sealed origin on reopen and destroy. Each opened working copy must provide either sound cross-client engine fencing or an allocation-wide exclusive writer lease; closing releases access but intentionally leaves the persistent allocation available until `destroyDurableBranch()` succeeds.
+- Treat `DurableWorkingCopyStrategy.merge()` as an optional optimization. Return `unsupported` only when no merge SQL or host mutation ran. Return `applied` only after proving the complete host diff equals the approved TypeGraph write set and validating the target fence on the merged resource. Throw on failed or uncertain native outcomes; TypeGraph will not fall back after a possibly partial application. Apply callbacks and persisted provenance continue through the portable path.
+
+### Minor Changes
+
+- [#726](https://github.com/nicia-ai/typegraph/pull/726) [`595e6d9`](https://github.com/nicia-ai/typegraph/commit/595e6d9e5a68faf5ca118288bf921065b822ff61) Thanks [@pdlug](https://github.com/pdlug)! - Add durable graph-merge branches that can be serialized, reopened in a later process, and explicitly destroyed. Durable strategies attest the complete fork origin, prove the created working copy matches its stamped base, and declare either engine-level fencing or an allocation-wide exclusive writer lease. Approved plans can optionally use a strategy's proven-equivalent native database merge; unsupported native dimensions execute no host mutation and fall back to the complete portable plan application.
+
 ## 0.66.1
 
 ### Highlights

package/README.md

@@ -86,11 +86,15 @@ TypeGraph ships semantic graph merge as a dedicated subpath:
 
 ```ts
 import {
+  applyDurableMergePlan,
   applyMergePlan,
   applyMergePlanInTransaction,
   branch,
+  branchDurable,
+  destroyDurableBranch,
   merge,
   planMerge,
+  reopenDurableBranch,
 } from "@nicia-ai/typegraph/graph-merge";
 ```
 
@@ -137,6 +141,17 @@ caller-owned commit. It throws on failure and leaves rollback and whole-
 transaction retry to the caller. This path refuses persisted provenance, while
 report-only provenance remains available.
 
+Long-running workflows can use `branchDurable()` to allocate a persistent
+working copy, serialize its descriptor, close the current connection, and
+reattach from a later process with `reopenDurableBranch()`. A
+`DurableWorkingCopyStrategy` owns the database's branch lifecycle and declares
+the cross-client fencing or exclusive writer lease that keeps planning sound.
+After review, `applyDurableMergePlan()` may use a strategy's native database
+merge only when it proves the host diff is exactly the approved TypeGraph plan;
+otherwise it applies the complete portable plan. Use `destroyDurableBranch()`
+for explicit teardown. The guide documents the requirements a branch-native
+database strategy must satisfy.
+
 It lives in the core package because the primitive is defined over TypeGraph
 stores, schemas, indexes, backends, and ontology semantics rather than as a
 separate product surface.

package/dist/backend/postgres/pglite-store.cjs

@@ -7,7 +7,7 @@ require('../../chunk-7XYPLAPL.cjs');
 async function createLocalPgliteStore(graph, options = {}) {
   const impl = await chunkMUKIEXH5_cjs.loadDrizzleBackedModule(
     "./postgres/pglite",
-    () => import('../../pglite-store-impl-Z3SOOP75.cjs')
+    () => import('../../pglite-store-impl-U55HQ5ZY.cjs')
   );
   return impl.createLocalPgliteStoreImpl(graph, options);
 }

package/dist/backend/postgres/pglite-store.js

@@ -5,7 +5,7 @@ import '../../chunk-GMKPIYHY.js';
 async function createLocalPgliteStore(graph, options = {}) {
   const impl = await loadDrizzleBackedModule(
     "./postgres/pglite",
-    () => import('../../pglite-store-impl-DUJBQZS5.js')
+    () => import('../../pglite-store-impl-VAIEJZOU.js')
   );
   return impl.createLocalPgliteStoreImpl(graph, options);
 }

package/dist/backend/sqlite/local-store.cjs

@@ -8,7 +8,7 @@ require('../../chunk-7XYPLAPL.cjs');
 async function createLocalSqliteStore(graph, options = {}) {
   const impl = await chunkMUKIEXH5_cjs.loadDrizzleBackedModule(
     "./sqlite/local",
-    () => import('../../local-store-impl-OUINMCYI.cjs')
+    () => import('../../local-store-impl-7SPBIS4M.cjs')
   );
   return impl.createLocalSqliteStoreImpl(graph, options);
 }

package/dist/backend/sqlite/local-store.js

@@ -6,7 +6,7 @@ import '../../chunk-GMKPIYHY.js';
 async function createLocalSqliteStore(graph, options = {}) {
   const impl = await loadDrizzleBackedModule(
     "./sqlite/local",
-    () => import('../../local-store-impl-ERPNYOCL.js')
+    () => import('../../local-store-impl-E23EDYPV.js')
   );
   return impl.createLocalSqliteStoreImpl(graph, options);
 }

package/dist/{chunk-TR7QTODF.js → chunk-55DGFZYC.js}

@@ -6,7 +6,7 @@ import { isBundledRootAutocommitEligible } from './chunk-6ECNYQDW.js';
 import { edgeCardinalityClaimTarget, edgeCardinalityClaimRefusal, edgeCardinalityClaim, edgeCardinalityClaimMode, claimEdgeCardinality } from './chunk-CDKNGCE7.js';
 import { resolveBackendFulltext } from './chunk-N535PWMA.js';
 import { AtomicEdgeBatchEndpointRefusalError, AtomicEdgeConvergenceTombstoneRefusalError, AtomicEdgeDeleteIdentityRefusalError, AtomicEdgeBatchCardinalityRefusalError } from './chunk-UFKYMQJ5.js';
-import { loadAndMergeGraphExtensionDocument, serializeSchema, buildKindRegistry, ensureIdentitySchemaStorage, loadAndVerifyGraph, identitySchemaCommitPreflight, getSchemaChanges, requiresMigration, inspectAdoptedIdentityStorage, parseSerializedSchema, mergeGraphExtension, commitNewSchemaVersion, commitNewSchemaVersionWithPreflight, planRemovals, stripGraphExtension, applyDeprecatedKinds, identityKindCascadeNeeded, ensureSchema, loadActiveSchemaWithBootstrap, extensionKindNames, serializeSchemaProperties, buildGraphExtensionOntologyKeySet, compileTimeOntologyKey, prepareNewSchemaVersion, commitNewSchemaVersionIfKindsEmpty, serializeIndexDeclaration } from './chunk-WB55URNM.js';
+import { loadAndMergeGraphExtensionDocument, serializeSchema, buildKindRegistry, ensureIdentitySchemaStorage, loadAndVerifyGraph, identitySchemaCommitPreflight, getSchemaChanges, requiresMigration, inspectAdoptedIdentityStorage, parseSerializedSchema, mergeGraphExtension, commitNewSchemaVersion, commitNewSchemaVersionWithPreflight, planRemovals, stripGraphExtension, applyDeprecatedKinds, identityKindCascadeNeeded, ensureSchema, loadActiveSchemaWithBootstrap, extensionKindNames, serializeSchemaProperties, buildGraphExtensionOntologyKeySet, compileTimeOntologyKey, prepareNewSchemaVersion, commitNewSchemaVersionIfKindsEmpty, serializeIndexDeclaration } from './chunk-6CKSTY2D.js';
 import { countSchemaKindRows } from './chunk-RFMSZ7CF.js';
 import { getTypeName } from './chunk-Q2SPDS3B.js';
 import { loadCurrentStructuralClasses, loadAssertionsByIds, toTransferAssertion, liveNodeKindsSharingIds, createIdentityFacade, createIdentityReadFacade, validateIdentityForContext, removeIdentityKindsForContext, readIdentityAssertionsForInterchange, readIdentityAssertionPageAtTarget, lockIdentityGraph, foldIdentityForCreatedNodes, importIdentityAssertionsIntoTarget, assertAffectedIdentityClassesConsistent, applyIdentityChangesForContext, refKey, requireNodeValidityEndCompatible, detachIdentityForNode, rebuildIdentityClosureForContext, assertEdgeMatchIdentityBackendSupport } from './chunk-SYXTWPX6.js';
@@ -31191,5 +31191,5 @@ async function createVerifiedAdapterStore(graph, backend, options) {
 }
 
 export { CURRENT_ONLY_READ_NAMES, EDGE_TEMPORAL_READ_NAMES, ExecutableAggregateQuery, ExecutableProjectionQuery, ExecutableQuery, ExecutableRelationQuery, IDENTITY_READ_NAMES, MAX_EXPLICIT_RECURSIVE_DEPTH, MAX_RECURSIVE_DEPTH, NODE_TEMPORAL_READ_NAMES, PreparedQuery, QueryBuilder, RecordedStoreView, StoreAnalysisCursorStaleError, StoreSearch, StoreView, UnionableQuery, avg, composeFragments, count, countDistinct, countDistinctEdges, countEdges, createAdapterStore, createAdapterStoreWithSchema, createFragment, createQueryBuilder, createStore, createStoreWithSchema, createVerifiedAdapterStore, createVerifiedStore, defineSubgraphProject, field, having, havingEq, havingGt, havingGte, havingLt, havingLte, limitFragment, max, min, offsetFragment, orderByFragment, sum };
-//# sourceMappingURL=chunk-TR7QTODF.js.map
-//# sourceMappingURL=chunk-TR7QTODF.js.map
+//# sourceMappingURL=chunk-55DGFZYC.js.map
+//# sourceMappingURL=chunk-55DGFZYC.js.map