@nicia-ai/typegraph 0.46.2 → 0.48.0

package/README.md

@@ -53,7 +53,12 @@ Examples: [github.com/nicia-ai/typegraph/tree/main/packages/typegraph/examples](
 TypeGraph ships semantic graph merge as a dedicated subpath:
 
 ```ts
-import { branch, merge } from "@nicia-ai/typegraph/graph-merge";
+import {
+  applyMergePlan,
+  branch,
+  merge,
+  planMerge,
+} from "@nicia-ai/typegraph/graph-merge";
 ```
 
 `branch()` creates isolated working copies over caller-provided backends, stamped
@@ -71,6 +76,9 @@ append-only pile of duplicates. The merge pipeline can:
 - preserve branch-specific context by repointing edges to canonical nodes;
 - surface property and delete/modify conflicts (for nodes and edges) in a
   `MergeReport`, three-way merged against base so disjoint edits compose;
+- explain every entity collapse with deterministic decisive edges, complete
+  candidate-source attribution, and the actual score/threshold for scored
+  matches, with bounded accepted/rejected diagnostics available on request;
 - expose report-only provenance, with optional sidecar persistence you can query.
 
 `merge()` is a snapshot merge (all branches forked from the current base);
@@ -78,6 +86,17 @@ append-only pile of duplicates. The merge pipeline can:
 advanced, re-discovering committed entities instead of duplicating them — the
 primitive for continuous ingestion.
 
+For approval workflows, `planMerge()` and `planMergeIncremental()` produce a
+deterministically ordered, JSON-serializable `MergePlanArtifact` without
+mutating the target. Store or review that artifact, then pass it to
+`applyMergePlan()`. Apply validates its digest and checks its durable revision,
+graph, schema, and origin fence inside the write transaction; it never re-runs
+candidate generation, scoring, embeddings, or policy callbacks. Plans require a
+target with `revisionTracking: true` or `history: true`. They may contain
+sensitive application data, and their digest provides integrity/identity—not a
+signature, authentication, or authorization. `merge()` and `mergeIncremental()`
+remain one-call compatibility APIs over the same resolution and write owners.
+
 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/drizzle/indexes.cjs

@@ -1,10 +1,10 @@
 'use strict';
 
-var chunkDYPRZ53S_cjs = require('../../chunk-DYPRZ53S.cjs');
-require('../../chunk-ZIH42CRX.cjs');
-require('../../chunk-ZHOAZD7Q.cjs');
-require('../../chunk-2ZWM2RFH.cjs');
-require('../../chunk-KCH7WQA5.cjs');
+var chunkWODMN3Q2_cjs = require('../../chunk-WODMN3Q2.cjs');
+require('../../chunk-OI2GQ25X.cjs');
+require('../../chunk-L3LQNR34.cjs');
+require('../../chunk-EDN4Y4ZG.cjs');
+require('../../chunk-MRDBBHIZ.cjs');
 require('../../chunk-A7J2YDDI.cjs');
 require('../../chunk-N66HCGCY.cjs');
 
@@ -12,19 +12,19 @@ require('../../chunk-N66HCGCY.cjs');
 
 Object.defineProperty(exports, "buildPostgresEdgeIndexBuilders", {
   enumerable: true,
-  get: function () { return chunkDYPRZ53S_cjs.buildPostgresEdgeIndexBuilders; }
+  get: function () { return chunkWODMN3Q2_cjs.buildPostgresEdgeIndexBuilders; }
 });
 Object.defineProperty(exports, "buildPostgresNodeIndexBuilders", {
   enumerable: true,
-  get: function () { return chunkDYPRZ53S_cjs.buildPostgresNodeIndexBuilders; }
+  get: function () { return chunkWODMN3Q2_cjs.buildPostgresNodeIndexBuilders; }
 });
 Object.defineProperty(exports, "buildSqliteEdgeIndexBuilders", {
   enumerable: true,
-  get: function () { return chunkDYPRZ53S_cjs.buildSqliteEdgeIndexBuilders; }
+  get: function () { return chunkWODMN3Q2_cjs.buildSqliteEdgeIndexBuilders; }
 });
 Object.defineProperty(exports, "buildSqliteNodeIndexBuilders", {
   enumerable: true,
-  get: function () { return chunkDYPRZ53S_cjs.buildSqliteNodeIndexBuilders; }
+  get: function () { return chunkWODMN3Q2_cjs.buildSqliteNodeIndexBuilders; }
 });
 //# sourceMappingURL=indexes.cjs.map
 //# sourceMappingURL=indexes.cjs.map

package/dist/backend/drizzle/indexes.d.cts

@@ -1,7 +1,7 @@
 import { SQLWrapper } from 'drizzle-orm';
 import { IndexBuilder } from 'drizzle-orm/pg-core';
 import { IndexBuilder as IndexBuilder$1 } from 'drizzle-orm/sqlite-core';
-import { I as IndexDeclaration } from '../../types-Du78EvpN.cjs';
+import { I as IndexDeclaration } from '../../types-BqFZTQmV.cjs';
 import 'zod';
 
 declare function buildPostgresNodeIndexBuilders(table: NodeIndexTable, indexes: readonly IndexDeclaration[]): readonly IndexBuilder[];

package/dist/backend/drizzle/indexes.d.ts

@@ -1,7 +1,7 @@
 import { SQLWrapper } from 'drizzle-orm';
 import { IndexBuilder } from 'drizzle-orm/pg-core';
 import { IndexBuilder as IndexBuilder$1 } from 'drizzle-orm/sqlite-core';
-import { I as IndexDeclaration } from '../../types-Du78EvpN.js';
+import { I as IndexDeclaration } from '../../types-BqFZTQmV.js';
 import 'zod';
 
 declare function buildPostgresNodeIndexBuilders(table: NodeIndexTable, indexes: readonly IndexDeclaration[]): readonly IndexBuilder[];

package/dist/backend/drizzle/indexes.js

@@ -1,8 +1,8 @@
-export { buildPostgresEdgeIndexBuilders, buildPostgresNodeIndexBuilders, buildSqliteEdgeIndexBuilders, buildSqliteNodeIndexBuilders } from '../../chunk-AU3IJNNP.js';
-import '../../chunk-FSLTU57P.js';
-import '../../chunk-EAMVXR5B.js';
-import '../../chunk-QOJ2L2AD.js';
-import '../../chunk-62ZXBMSD.js';
+export { buildPostgresEdgeIndexBuilders, buildPostgresNodeIndexBuilders, buildSqliteEdgeIndexBuilders, buildSqliteNodeIndexBuilders } from '../../chunk-OMZ37BM2.js';
+import '../../chunk-SDBBMD4N.js';
+import '../../chunk-ZDKTPBGV.js';
+import '../../chunk-3DMMGT6S.js';
+import '../../chunk-ZLONH2UD.js';
 import '../../chunk-FWJKWH6U.js';
 import '../../chunk-DYATYRY4.js';
 //# sourceMappingURL=indexes.js.map

package/dist/backend/index.cjs

@@ -1,17 +1,18 @@
 'use strict';
 
-var chunkN3QTGPC7_cjs = require('../chunk-N3QTGPC7.cjs');
-require('../chunk-A7NMUYEL.cjs');
-require('../chunk-DYPRZ53S.cjs');
-require('../chunk-QU7QLJA4.cjs');
-var chunkANKOXPCC_cjs = require('../chunk-ANKOXPCC.cjs');
-require('../chunk-5PDSCELM.cjs');
-require('../chunk-ZIH42CRX.cjs');
+var chunkUMGZDVOA_cjs = require('../chunk-UMGZDVOA.cjs');
+require('../chunk-HDL2ARHX.cjs');
+require('../chunk-WODMN3Q2.cjs');
+require('../chunk-3U5ABFDW.cjs');
+var chunk5PRKMB24_cjs = require('../chunk-5PRKMB24.cjs');
+require('../chunk-2QGYQBS2.cjs');
+var chunkTQHGE7UC_cjs = require('../chunk-TQHGE7UC.cjs');
+require('../chunk-OI2GQ25X.cjs');
 require('../chunk-NAUA4PW5.cjs');
-var chunkZHOAZD7Q_cjs = require('../chunk-ZHOAZD7Q.cjs');
-var chunk2ZWM2RFH_cjs = require('../chunk-2ZWM2RFH.cjs');
+var chunkL3LQNR34_cjs = require('../chunk-L3LQNR34.cjs');
+var chunkEDN4Y4ZG_cjs = require('../chunk-EDN4Y4ZG.cjs');
 var chunkXUO3KQFO_cjs = require('../chunk-XUO3KQFO.cjs');
-require('../chunk-KCH7WQA5.cjs');
+require('../chunk-MRDBBHIZ.cjs');
 require('../chunk-A7J2YDDI.cjs');
 require('../chunk-N66HCGCY.cjs');
 
@@ -19,159 +20,167 @@ require('../chunk-N66HCGCY.cjs');
 
 Object.defineProperty(exports, "deleteLegacyRecordedAnchorMap", {
   enumerable: true,
-  get: function () { return chunkN3QTGPC7_cjs.deleteLegacyRecordedAnchorMap; }
+  get: function () { return chunkUMGZDVOA_cjs.deleteLegacyRecordedAnchorMap; }
 });
 Object.defineProperty(exports, "migrateLegacyRecordedTime", {
   enumerable: true,
-  get: function () { return chunkN3QTGPC7_cjs.migrateLegacyRecordedTime; }
+  get: function () { return chunkUMGZDVOA_cjs.migrateLegacyRecordedTime; }
 });
 Object.defineProperty(exports, "migrateRecordedAnchor", {
   enumerable: true,
-  get: function () { return chunkN3QTGPC7_cjs.migrateRecordedAnchor; }
+  get: function () { return chunkUMGZDVOA_cjs.migrateRecordedAnchor; }
+});
+Object.defineProperty(exports, "repairInvertedValidityWindows", {
+  enumerable: true,
+  get: function () { return chunkUMGZDVOA_cjs.repairInvertedValidityWindows; }
 });
 Object.defineProperty(exports, "D1_MAX_BIND_PARAMETERS", {
   enumerable: true,
-  get: function () { return chunkANKOXPCC_cjs.D1_MAX_BIND_PARAMETERS; }
+  get: function () { return chunk5PRKMB24_cjs.D1_MAX_BIND_PARAMETERS; }
 });
 Object.defineProperty(exports, "DURABLE_OBJECT_MAX_BIND_PARAMETERS", {
   enumerable: true,
-  get: function () { return chunkANKOXPCC_cjs.DURABLE_OBJECT_MAX_BIND_PARAMETERS; }
+  get: function () { return chunk5PRKMB24_cjs.DURABLE_OBJECT_MAX_BIND_PARAMETERS; }
 });
 Object.defineProperty(exports, "MODERN_SQLITE_MAX_BIND_PARAMETERS", {
   enumerable: true,
-  get: function () { return chunkANKOXPCC_cjs.MODERN_SQLITE_MAX_BIND_PARAMETERS; }
+  get: function () { return chunk5PRKMB24_cjs.MODERN_SQLITE_MAX_BIND_PARAMETERS; }
 });
 Object.defineProperty(exports, "POSTGRES_CAPABILITIES", {
   enumerable: true,
-  get: function () { return chunkANKOXPCC_cjs.POSTGRES_CAPABILITIES; }
+  get: function () { return chunk5PRKMB24_cjs.POSTGRES_CAPABILITIES; }
 });
 Object.defineProperty(exports, "POSTGRES_MAX_BIND_PARAMETERS", {
   enumerable: true,
-  get: function () { return chunkANKOXPCC_cjs.POSTGRES_MAX_BIND_PARAMETERS; }
+  get: function () { return chunk5PRKMB24_cjs.POSTGRES_MAX_BIND_PARAMETERS; }
 });
 Object.defineProperty(exports, "SQLITE_CAPABILITIES", {
   enumerable: true,
-  get: function () { return chunkANKOXPCC_cjs.SQLITE_CAPABILITIES; }
+  get: function () { return chunk5PRKMB24_cjs.SQLITE_CAPABILITIES; }
 });
 Object.defineProperty(exports, "SQLITE_MAX_BIND_PARAMETERS", {
   enumerable: true,
-  get: function () { return chunkANKOXPCC_cjs.SQLITE_MAX_BIND_PARAMETERS; }
+  get: function () { return chunk5PRKMB24_cjs.SQLITE_MAX_BIND_PARAMETERS; }
 });
 Object.defineProperty(exports, "isLiveNodeRow", {
   enumerable: true,
-  get: function () { return chunkANKOXPCC_cjs.isLiveNodeRow; }
+  get: function () { return chunk5PRKMB24_cjs.isLiveNodeRow; }
 });
 Object.defineProperty(exports, "isTombstonedNodeRow", {
   enumerable: true,
-  get: function () { return chunkANKOXPCC_cjs.isTombstonedNodeRow; }
+  get: function () { return chunk5PRKMB24_cjs.isTombstonedNodeRow; }
 });
 Object.defineProperty(exports, "normalizeGraphAnalyticsCapabilities", {
   enumerable: true,
-  get: function () { return chunkANKOXPCC_cjs.normalizeGraphAnalyticsCapabilities; }
+  get: function () { return chunk5PRKMB24_cjs.normalizeGraphAnalyticsCapabilities; }
 });
 Object.defineProperty(exports, "rowPropsToJsonText", {
   enumerable: true,
-  get: function () { return chunkANKOXPCC_cjs.rowPropsToJsonText; }
+  get: function () { return chunk5PRKMB24_cjs.rowPropsToJsonText; }
 });
 Object.defineProperty(exports, "rowPropsToObject", {
   enumerable: true,
-  get: function () { return chunkANKOXPCC_cjs.rowPropsToObject; }
+  get: function () { return chunk5PRKMB24_cjs.rowPropsToObject; }
+});
+Object.defineProperty(exports, "resolveStampedValidityLowerBound", {
+  enumerable: true,
+  get: function () { return chunkTQHGE7UC_cjs.resolveStampedValidityLowerBound; }
 });
 Object.defineProperty(exports, "ALL_FULLTEXT_MODES", {
   enumerable: true,
-  get: function () { return chunkZHOAZD7Q_cjs.ALL_FULLTEXT_MODES; }
+  get: function () { return chunkL3LQNR34_cjs.ALL_FULLTEXT_MODES; }
 });
 Object.defineProperty(exports, "BASE_CONTRIBUTION_OWNER", {
   enumerable: true,
-  get: function () { return chunkZHOAZD7Q_cjs.BASE_CONTRIBUTION_OWNER; }
+  get: function () { return chunkL3LQNR34_cjs.BASE_CONTRIBUTION_OWNER; }
 });
 Object.defineProperty(exports, "FULLTEXT_CONTRIBUTION_NAME", {
   enumerable: true,
-  get: function () { return chunkZHOAZD7Q_cjs.FULLTEXT_CONTRIBUTION_NAME; }
+  get: function () { return chunkL3LQNR34_cjs.FULLTEXT_CONTRIBUTION_NAME; }
 });
 Object.defineProperty(exports, "VECTOR_CONTRIBUTION_PREFIX", {
   enumerable: true,
-  get: function () { return chunkZHOAZD7Q_cjs.VECTOR_CONTRIBUTION_PREFIX; }
+  get: function () { return chunkL3LQNR34_cjs.VECTOR_CONTRIBUTION_PREFIX; }
 });
 Object.defineProperty(exports, "assertFiniteEmbedding", {
   enumerable: true,
-  get: function () { return chunkZHOAZD7Q_cjs.assertFiniteEmbedding; }
+  get: function () { return chunkL3LQNR34_cjs.assertFiniteEmbedding; }
 });
 Object.defineProperty(exports, "assertVectorMinScore", {
   enumerable: true,
-  get: function () { return chunkZHOAZD7Q_cjs.assertVectorMinScore; }
+  get: function () { return chunkL3LQNR34_cjs.assertVectorMinScore; }
 });
 Object.defineProperty(exports, "assertVectorSearchLimit", {
   enumerable: true,
-  get: function () { return chunkZHOAZD7Q_cjs.assertVectorSearchLimit; }
+  get: function () { return chunkL3LQNR34_cjs.assertVectorSearchLimit; }
 });
 Object.defineProperty(exports, "buildFulltextCapabilities", {
   enumerable: true,
-  get: function () { return chunkZHOAZD7Q_cjs.buildFulltextCapabilities; }
+  get: function () { return chunkL3LQNR34_cjs.buildFulltextCapabilities; }
 });
 Object.defineProperty(exports, "buildVectorCapabilities", {
   enumerable: true,
-  get: function () { return chunkZHOAZD7Q_cjs.buildVectorCapabilities; }
+  get: function () { return chunkL3LQNR34_cjs.buildVectorCapabilities; }
 });
 Object.defineProperty(exports, "fts5Strategy", {
   enumerable: true,
-  get: function () { return chunkZHOAZD7Q_cjs.fts5Strategy; }
+  get: function () { return chunkL3LQNR34_cjs.fts5Strategy; }
 });
 Object.defineProperty(exports, "quoteIdentifier", {
   enumerable: true,
-  get: function () { return chunkZHOAZD7Q_cjs.quoteIdentifier; }
+  get: function () { return chunkL3LQNR34_cjs.quoteIdentifier; }
 });
 Object.defineProperty(exports, "shortHash", {
   enumerable: true,
-  get: function () { return chunkZHOAZD7Q_cjs.shortHash; }
+  get: function () { return chunkL3LQNR34_cjs.shortHash; }
 });
 Object.defineProperty(exports, "tsvectorStrategy", {
   enumerable: true,
-  get: function () { return chunkZHOAZD7Q_cjs.tsvectorStrategy; }
+  get: function () { return chunkL3LQNR34_cjs.tsvectorStrategy; }
 });
 Object.defineProperty(exports, "vectorMinScoreCondition", {
   enumerable: true,
-  get: function () { return chunkZHOAZD7Q_cjs.vectorMinScoreCondition; }
+  get: function () { return chunkL3LQNR34_cjs.vectorMinScoreCondition; }
 });
 Object.defineProperty(exports, "vectorPhysicalName", {
   enumerable: true,
-  get: function () { return chunkZHOAZD7Q_cjs.vectorPhysicalName; }
+  get: function () { return chunkL3LQNR34_cjs.vectorPhysicalName; }
 });
 Object.defineProperty(exports, "vectorScoreExpression", {
   enumerable: true,
-  get: function () { return chunkZHOAZD7Q_cjs.vectorScoreExpression; }
+  get: function () { return chunkL3LQNR34_cjs.vectorScoreExpression; }
 });
 Object.defineProperty(exports, "Placeholder", {
   enumerable: true,
-  get: function () { return chunk2ZWM2RFH_cjs.Placeholder; }
+  get: function () { return chunkEDN4Y4ZG_cjs.Placeholder; }
 });
 Object.defineProperty(exports, "isSqlFragment", {
   enumerable: true,
-  get: function () { return chunk2ZWM2RFH_cjs.isSqlFragment; }
+  get: function () { return chunkEDN4Y4ZG_cjs.isSqlFragment; }
 });
 Object.defineProperty(exports, "isSqlPlaceholder", {
   enumerable: true,
-  get: function () { return chunk2ZWM2RFH_cjs.isSqlPlaceholder; }
+  get: function () { return chunkEDN4Y4ZG_cjs.isSqlPlaceholder; }
 });
 Object.defineProperty(exports, "renderPostgres", {
   enumerable: true,
-  get: function () { return chunk2ZWM2RFH_cjs.renderPostgres; }
+  get: function () { return chunkEDN4Y4ZG_cjs.renderPostgres; }
 });
 Object.defineProperty(exports, "renderSql", {
   enumerable: true,
-  get: function () { return chunk2ZWM2RFH_cjs.renderSql; }
+  get: function () { return chunkEDN4Y4ZG_cjs.renderSql; }
 });
 Object.defineProperty(exports, "renderSqlInline", {
   enumerable: true,
-  get: function () { return chunk2ZWM2RFH_cjs.renderSqlInline; }
+  get: function () { return chunkEDN4Y4ZG_cjs.renderSqlInline; }
 });
 Object.defineProperty(exports, "renderSqlite", {
   enumerable: true,
-  get: function () { return chunk2ZWM2RFH_cjs.renderSqlite; }
+  get: function () { return chunkEDN4Y4ZG_cjs.renderSqlite; }
 });
 Object.defineProperty(exports, "sql", {
   enumerable: true,
-  get: function () { return chunk2ZWM2RFH_cjs.sql; }
+  get: function () { return chunkEDN4Y4ZG_cjs.sql; }
 });
 Object.defineProperty(exports, "ALL_META_EDGE_NAMES", {
   enumerable: true,

package/dist/backend/index.d.cts

@@ -1,61 +1,43 @@
-import { y as GraphBackend, bN as SqlTableNames } from '../types-Du78EvpN.cjs';
-export { cO as ALL_FULLTEXT_MODES, cP as ALL_META_EDGE_NAMES, A as AdapterBackend, aj as AdapterBackendTransactions, cQ as BASE_CONTRIBUTION_OWNER, B as BackendCapabilities, am as BackendIdentity, an as BackendLifecycle, ao as BackendMaintenance, ap as BackendTransactions, ar as Cardinality, cR as CheckUniqueBatchParams, cS as CheckUniqueParams, cT as ClaimIndexMaterializationParams, as as Collation, at as CommitSchemaVersionExpected, au as CommitSchemaVersionIfKindsEmptyResult, av as CommitSchemaVersionParams, aw as CompiledRowsSql, ax as CompiledSelectSql, ay as CompiledStatementSql, cU as CompiledTemporaryStatementSql, az as ContributionCapabilities, C as ContributionDiagnostic, a as ContributionDiagnosticState, aA as ContributionMaterializationBackend, cV as ContributionMaterializationIdentity, cW as ContributionMaterializationRow, aB as ContributionProbeContribution, aC as ContributionProbeEntry, aD as ContributionProbeResult, aE as ContributionProbeState, aF as ContributionRebuildResult, aG as ContributionRebuildScope, b as ContributionRepairEntry, c as ContributionRepairResult, aH as ContributionRepopulationStats, cX as CountEdgesByKindParams, cY as CountEdgesFromParams, cZ as CountNodesByKindParams, c_ as CreateVectorIndexParams, c$ as D1_MAX_BIND_PARAMETERS, d0 as DURABLE_OBJECT_MAX_BIND_PARAMETERS, a6 as DeleteBehavior, d1 as DeleteEdgeParams, d2 as DeleteEdgesBatchParams, d3 as DeleteEmbeddingParams, aJ as DeleteFulltextBatchParams, d4 as DeleteFulltextParams, d5 as DeleteNodeParams, d6 as DeleteUniqueParams, d7 as DialectAdapter, d8 as DialectCapabilities, d9 as DialectRecursiveQueryStrategy, da as DialectStandardQueryStrategy, db as DialectVectorPredicateStrategy, dc as DropVectorIndexParams, aK as EdgeEntityReadBackend, aL as EdgeEntityWriteBackend, dd as EdgeExistsBetweenParams, E as EdgeIndexDeclaration, f as EdgeIndexDirection, cM as EdgeRow, aQ as EndpointExistence, de as ExtensionArrayItemType, df as ExtensionArrayProperty, dg as ExtensionBooleanProperty, a9 as ExtensionEdgeDef, dh as ExtensionEdgeIndex, di as ExtensionEmbeddingModifier, dj as ExtensionEnumProperty, ab as ExtensionIndex, dk as ExtensionIndexWhere, a8 as ExtensionNodeDef, dl as ExtensionNodeIndex, dm as ExtensionNumberProperty, dn as ExtensionObjectFieldProperty, dp as ExtensionObjectProperty, aa as ExtensionOntologyRelation, dq as ExtensionPropertyModifiers, dr as ExtensionPropertyType, ds as ExtensionSearchableModifier, dt as ExtensionStringProperty, du as ExtensionUniqueConstraint, dv as ExtensionUniqueWhere, dw as FULLTEXT_CONTRIBUTION_NAME, aS as FilteredApproximateSearch, aT as FilteredApproximateSearchMode, dx as FindEdgesByEndpointSetParams, aU as FindEdgesByHeterogeneousEndpointSetParams, dy as FindEdgesByKindParams, dz as FindEdgesConnectedToParams, dA as FindNodesByKindParams, aV as FulltextBatchRow, aW as FulltextCapabilities, aX as FulltextOperationBackend, aY as FulltextQueryMode, aZ as FulltextSearchParams, a_ as FulltextSearchResult, F as FulltextStrategy, b0 as GraphAnalyticsCapabilities, b2 as GraphEntityReadBackend, b3 as GraphEntityWriteBackend, b4 as GraphExtension, a7 as GraphExtensionVersion, G as GraphIdentityConfig, b5 as GraphLifecycleBackend, dB as GraphReadBackend, dC as HardDeleteEdgeParams, dD as HardDeleteNodeParams, b6 as HardDeleteUniquesByNodeIdsParams, dE as HybridSearchParams, dF as HybridSearchRow, dG as IdentityTableNames, dH as InListParameterOptions, I as IndexDeclaration, dI as IndexDeclarationBase, L as IndexEntity, b8 as IndexMaterializationBackend, dJ as IndexMaterializationRow, h as IndexOrigin, i as IndexScope, j as IndexWhereExpression, dK as IndexWhereLiteral, dL as IndexWhereOp, dM as IndexWhereOperand, ai as InferenceType, dN as InsertEdgeParams, dO as InsertNodeParams, dP as InsertSchemaParams, dQ as InsertUniqueParams, b9 as IntentSql, J as JsonPointer, X as JsonSchema, a0 as JsonValue, a3 as KindAnnotations, K as KindEntity, dR as KindRemovalRow, dS as LiveNodeRow, bg as LockSchemaVersionForWriteParams, dT as MODERN_SQLITE_MAX_BIND_PARAMETERS, dU as MetaEdgeName, bj as NodeEntityReadBackend, bk as NodeEntityWriteBackend, N as NodeIndexDeclaration, cL as NodeRow, W as NullCheckOp, dV as POSTGRES_CAPABILITIES, dW as POSTGRES_MAX_BIND_PARAMETERS, bp as Placeholder, bq as PopulatedSchemaKind, br as QueryExecutionBackend, bs as RawQueryExecutionBackend, bt as RawStatementExecutionBackend, dX as RecordContributionMaterializationParams, dY as RecordIndexMaterializationParams, dZ as RecordKindRemovalParams, R as RelationalIndexDeclaration, d_ as RelationalIndexMethod, d$ as ReleaseIndexMaterializationClaimParams, bv as RemovalMaterializationBackend, bw as RenderedSql, bz as ResolvedSqlTableNames, bA as RowProps, e0 as SQLITE_CAPABILITIES, e1 as SQLITE_MAX_BIND_PARAMETERS, bB as SchemaCommitBackend, e2 as SchemaCommitPreflightBackend, bC as SchemaKindEmptinessProbe, bD as SchemaReadBackend, x as SchemaVersionRow, bE as SchemaWriteFenceBackend, P as SerializedClosures, H as SerializedEdgeDef, M as SerializedMetaEdge, D as SerializedNodeDef, Y as SerializedOntology, O as SerializedOntologyRelation, z as SerializedSchema, Z as SerializedUniqueConstraint, bF as SetActiveVersionParams, bH as SqlChunk, e3 as SqlCompilationBackend, S as SqlDialect, bI as SqlFragment, bJ as SqlIdentifierChunk, bK as SqlIntent, bL as SqlParameterChunk, bM as SqlPlaceholderChunk, bO as SqlTag, bP as SqlTextChunk, bQ as StrategyTableContribution, o as SystemColumnName, bR as TableContribution, T as TemporalMode, e4 as TombstonedNodeRow, bS as TransactionBackend, bT as TransactionOptions, bU as TransactionReadBackend, bW as TrustedImportOptions, bX as TrustedImportSession, bZ as UniqueConstraintBackend, e5 as UniqueRow, b_ as UniquenessScope, e6 as UpdateEdgeParams, e7 as UpdateNodeParams, b$ as UpdateNodeSetParams, c0 as UpdateNodeSetResult, e8 as UpsertEmbeddingBatchParams, e9 as UpsertEmbeddingBatchRow, ea as UpsertEmbeddingParams, c1 as UpsertFulltextBatchParams, eb as UpsertFulltextParams, ec as VECTOR_CONTRIBUTION_PREFIX, cw as ValueType, c2 as VectorCapabilities, p as VectorIndexDeclaration, q as VectorIndexImplementation, r as VectorIndexMetric, s as VectorIndexParams, ed as VectorIndexType, cN as VectorMetric, c3 as VectorOperationBackend, c4 as VectorSearchFrontierTuning, ee as VectorSearchParams, ef as VectorSearchResult, t as VectorSlot, V as VectorStrategy, eg as assertFiniteEmbedding, eh as assertVectorMinScore, ei as assertVectorSearchLimit, ej as buildFulltextCapabilities, c7 as buildVectorCapabilities, ca as fts5Strategy, ek as isLiveNodeRow, ci as isSqlFragment, el as isSqlPlaceholder, em as isTombstonedNodeRow, en as normalizeGraphAnalyticsCapabilities, eo as quoteIdentifier, co as renderPostgres, cp as renderSql, cq as renderSqlInline, cr as renderSqlite, cs as rowPropsToJsonText, ct as rowPropsToObject, ep as shortHash, cu as sql, cv as tsvectorStrategy, eq as vectorMinScoreCondition, er as vectorPhysicalName, es as vectorScoreExpression } from '../types-Du78EvpN.cjs';
-import { R as RecordedInstant } from '../temporal-CXewwLTB.cjs';
+export { A as ALL_FULLTEXT_MODES, a as ALL_META_EDGE_NAMES, b as AdapterBackend, c as AdapterBackendTransactions, B as BASE_CONTRIBUTION_OWNER, d as BackendCapabilities, e as BackendIdentity, f as BackendLifecycle, g as BackendMaintenance, h as BackendTransactions, C as Cardinality, i as CheckUniqueBatchParams, j as CheckUniqueParams, k as ClaimIndexMaterializationParams, l as Collation, m as CommitSchemaVersionExpected, n as CommitSchemaVersionIfKindsEmptyResult, o as CommitSchemaVersionParams, p as CompiledRowsSql, q as CompiledSelectSql, r as CompiledStatementSql, s as CompiledTemporaryStatementSql, t as ContributionCapabilities, u as ContributionDiagnostic, v as ContributionDiagnosticState, w as ContributionMaterializationBackend, x as ContributionMaterializationIdentity, y as ContributionMaterializationRow, z as ContributionProbeContribution, D as ContributionProbeEntry, E as ContributionProbeResult, F as ContributionProbeState, G as ContributionRebuildResult, H as ContributionRebuildScope, J as ContributionRepairEntry, K as ContributionRepairResult, L as ContributionRepopulationStats, M as CountEdgesByKindParams, N as CountEdgesFromParams, O as CountNodesByKindParams, P as CreateVectorIndexParams, Q as D1_MAX_BIND_PARAMETERS, R as DURABLE_OBJECT_MAX_BIND_PARAMETERS, S as DeleteBehavior, T as DeleteEdgeParams, U as DeleteEdgesBatchParams, V as DeleteEmbeddingParams, W as DeleteFulltextBatchParams, X as DeleteFulltextParams, Y as DeleteNodeParams, Z as DeleteUniqueParams, _ as DialectAdapter, $ as DialectCapabilities, a0 as DialectRecursiveQueryStrategy, a1 as DialectStandardQueryStrategy, a2 as DialectVectorPredicateStrategy, a3 as DropVectorIndexParams, a4 as EdgeEntityReadBackend, a5 as EdgeEntityWriteBackend, a6 as EdgeExistsBetweenParams, a7 as EdgeIndexDeclaration, a8 as EdgeIndexDirection, a9 as EdgeRow, aa as EndpointExistence, ab as ExtensionArrayItemType, ac as ExtensionArrayProperty, ad as ExtensionBooleanProperty, ae as ExtensionEdgeDef, af as ExtensionEdgeIndex, ag as ExtensionEmbeddingModifier, ah as ExtensionEnumProperty, ai as ExtensionIndex, aj as ExtensionIndexWhere, ak as ExtensionNodeDef, al as ExtensionNodeIndex, am as ExtensionNumberProperty, an as ExtensionObjectFieldProperty, ao as ExtensionObjectProperty, ap as ExtensionOntologyRelation, aq as ExtensionPropertyModifiers, ar as ExtensionPropertyType, as as ExtensionSearchableModifier, at as ExtensionStringProperty, au as ExtensionUniqueConstraint, av as ExtensionUniqueWhere, aw as FULLTEXT_CONTRIBUTION_NAME, ax as FilteredApproximateSearch, ay as FilteredApproximateSearchMode, az as FindEdgesByEndpointSetParams, aA as FindEdgesByHeterogeneousEndpointSetParams, aB as FindEdgesByKindParams, aC as FindEdgesConnectedToParams, aD as FindNodesByKindParams, aE as FulltextBatchRow, aF as FulltextCapabilities, aG as FulltextOperationBackend, aH as FulltextQueryMode, aI as FulltextSearchParams, aJ as FulltextSearchResult, aK as FulltextStrategy, aL as GraphAnalyticsCapabilities, aM as GraphBackend, aN as GraphEntityReadBackend, aO as GraphEntityWriteBackend, aP as GraphExtension, aQ as GraphExtensionVersion, aR as GraphIdentityConfig, aS as GraphLifecycleBackend, aT as GraphReadBackend, aU as HardDeleteEdgeParams, aV as HardDeleteNodeParams, aW as HardDeleteUniquesByNodeIdsParams, aX as HybridSearchParams, aY as HybridSearchRow, aZ as IdentityTableNames, a_ as InListParameterOptions, I as IndexDeclaration, a$ as IndexDeclarationBase, b0 as IndexEntity, b1 as IndexMaterializationBackend, b2 as IndexMaterializationRow, b3 as IndexOrigin, b4 as IndexScope, b5 as IndexWhereExpression, b6 as IndexWhereLiteral, b7 as IndexWhereOp, b8 as IndexWhereOperand, b9 as InferenceType, ba as InsertEdgeParams, bb as InsertNodeParams, bc as InsertSchemaParams, bd as InsertUniqueParams, be as IntentSql, bf as JsonPointer, bg as JsonSchema, bh as JsonValue, bi as KindAnnotations, bj as KindEntity, bk as KindRemovalRow, bl as LiveNodeRow, bm as LockSchemaVersionForWriteParams, bn as MODERN_SQLITE_MAX_BIND_PARAMETERS, bo as MetaEdgeName, bp as NodeEntityReadBackend, bq as NodeEntityWriteBackend, br as NodeIndexDeclaration, bs as NodeRow, bt as NullCheckOp, bu as POSTGRES_CAPABILITIES, bv as POSTGRES_MAX_BIND_PARAMETERS, bw as Placeholder, bx as PopulatedSchemaKind, by as QueryExecutionBackend, bz as RawQueryExecutionBackend, bA as RawStatementExecutionBackend, bB as RecordContributionMaterializationParams, bC as RecordIndexMaterializationParams, bD as RecordKindRemovalParams, bE as RelationalIndexDeclaration, bF as RelationalIndexMethod, bG as ReleaseIndexMaterializationClaimParams, bH as RemovalMaterializationBackend, bI as RenderedSql, bJ as ResolvedSqlTableNames, bK as RowProps, bL as SQLITE_CAPABILITIES, bM as SQLITE_MAX_BIND_PARAMETERS, bN as SchemaCommitBackend, bO as SchemaCommitPreflightBackend, bP as SchemaKindEmptinessProbe, bQ as SchemaReadBackend, bR as SchemaVersionRow, bS as SchemaWriteFenceBackend, bT as SerializedClosures, bU as SerializedEdgeDef, bV as SerializedMetaEdge, bW as SerializedNodeDef, bX as SerializedOntology, bY as SerializedOntologyRelation, bZ as SerializedSchema, b_ as SerializedUniqueConstraint, b$ as SetActiveVersionParams, c0 as SqlChunk, c1 as SqlCompilationBackend, c2 as SqlDialect, c3 as SqlFragment, c4 as SqlIdentifierChunk, c5 as SqlIntent, c6 as SqlParameterChunk, c7 as SqlPlaceholderChunk, c8 as SqlTableNames, c9 as SqlTag, ca as SqlTextChunk, cb as StrategyTableContribution, cc as SystemColumnName, cd as TableContribution, ce as TemporalMode, cf as TombstonedNodeRow, cg as TransactionBackend, ch as TransactionOptions, ci as TransactionReadBackend, cj as TrustedImportOptions, ck as TrustedImportSession, cl as UniqueConstraintBackend, cm as UniqueRow, cn as UniquenessScope, co as UpdateEdgeParams, cp as UpdateNodeParams, cq as UpdateNodeSetParams, cr as UpdateNodeSetResult, cs as UpsertEmbeddingBatchParams, ct as UpsertEmbeddingBatchRow, cu as UpsertEmbeddingParams, cv as UpsertFulltextBatchParams, cw as UpsertFulltextParams, cx as VECTOR_CONTRIBUTION_PREFIX, cy as ValueType, cz as VectorCapabilities, cA as VectorIndexDeclaration, cB as VectorIndexImplementation, cC as VectorIndexMetric, cD as VectorIndexParams, cE as VectorIndexType, cF as VectorMetric, cG as VectorOperationBackend, cH as VectorSearchFrontierTuning, cI as VectorSearchParams, cJ as VectorSearchResult, cK as VectorSlot, cL as VectorStrategy, cM as assertFiniteEmbedding, cN as assertVectorMinScore, cO as assertVectorSearchLimit, cP as buildFulltextCapabilities, cQ as buildVectorCapabilities, cR as fts5Strategy, cS as isLiveNodeRow, cT as isSqlFragment, cU as isSqlPlaceholder, cV as isTombstonedNodeRow, cW as normalizeGraphAnalyticsCapabilities, cX as quoteIdentifier, cY as renderPostgres, cZ as renderSql, c_ as renderSqlInline, c$ as renderSqlite, d0 as rowPropsToJsonText, d1 as rowPropsToObject, d2 as shortHash, d3 as sql, d4 as tsvectorStrategy, d5 as vectorMinScoreCondition, d6 as vectorPhysicalName, d7 as vectorScoreExpression } from '../types-BqFZTQmV.cjs';
+export { D as DeleteLegacyRecordedAnchorMapOptions, M as MigrateLegacyRecordedTimeOptions, a as MigrateLegacyRecordedTimeResult, b as MigrateRecordedAnchorOptions, R as RepairInvertedWindowsOptions, c as RepairInvertedWindowsReport, d as RepairRelation, e as RepairRelationScope, f as deleteLegacyRecordedAnchorMap, m as migrateLegacyRecordedTime, g as migrateRecordedAnchor, r as repairInvertedValidityWindows } from '../repair-validity-windows-BFNZvd_H.cjs';
+export { R as RecordedInstant } from '../temporal-5GqpYCk2.cjs';
 import 'zod';
 
 /**
- * One-time offline migration from timestamp-only recorded relations to numeric
- * revisions. The durable remap table lets applications translate checkpoints
- * stored outside TypeGraph before deleting the migration metadata.
- */
-
-type MigrateLegacyRecordedTimeOptions = Readonly<{
-    backend: GraphBackend;
-    /** Override the backend's recorded table names. */
-    tableNames?: Partial<SqlTableNames> | undefined;
-    /** Override the durable legacy-anchor mapping table name. */
-    mappingTableName?: string | undefined;
-}>;
-type MigrateLegacyRecordedTimeResult = Readonly<{
-    /** `true` when timestamp columns were rewritten during this call. */
-    migrated: boolean;
-    /** Number of graphs represented in the legacy commit order. */
-    graphs: number;
-    /** Number of distinct legacy anchors available for remapping. */
-    anchors: number;
-    /** Physical table retaining the old-anchor → revision mapping. */
-    mappingTableName: string;
-}>;
-type MigrateRecordedAnchorOptions = Readonly<{
-    backend: Pick<GraphBackend, "dialect" | "execute" | "tableNames">;
-    graphId: string;
-    anchor: string;
-    tableNames?: Partial<SqlTableNames> | undefined;
-    mappingTableName?: string | undefined;
-}>;
-type DeleteLegacyRecordedAnchorMapOptions = Readonly<{
-    backend: Pick<GraphBackend, "dialect" | "execute" | "executeStatement" | "tableNames" | "transaction">;
-    graphId: string;
-    tableNames?: Partial<SqlTableNames> | undefined;
-    mappingTableName?: string | undefined;
-    /** Drop the mapping table when this deletion leaves it empty. */
-    dropWhenEmpty?: boolean | undefined;
-}>;
-/**
- * Rewrites timestamp-only recorded relations to numeric revisions.
+ * THE lower bound a write that STAMPS its own start stores, decided against the
+ * instant it is about to stamp. One owner for every such write, so no two of them
+ * can spell the decision differently. Three inputs, three outcomes:
  *
- * Run offline before opening a Store with the new schema. The durable mapping
- * table is retained so external checkpoint stores can call
- * {@link migrateRecordedAnchor}; delete each graph's rows after its downstream
- * checkpoints have been rewritten.
- */
-declare function migrateLegacyRecordedTime(options: MigrateLegacyRecordedTimeOptions): Promise<MigrateLegacyRecordedTimeResult>;
-/** Remaps one timestamp-only checkpoint after {@link migrateLegacyRecordedTime}. */
-declare function migrateRecordedAnchor(options: MigrateRecordedAnchorOptions): Promise<RecordedInstant>;
-/**
- * Deletes one graph's legacy remap rows after downstream checkpoints migrate.
- * Set `dropWhenEmpty` to remove the migration table after the final graph.
+ *  - a stated `null`   → no lower bound (a CONFIRMED open-left window, which is
+ *                        how interchange round-trips a row that has none);
+ *  - a stated string   → that bound, the caller's own assertion, verbatim;
+ *  - nothing stated    → the write instant, UNLESS stamping it would leave the
+ *                        window readable at no instant. A row carrying only a
+ *                        `validTo` at or before the write instant is "born already
+ *                        ended": its start is UNKNOWN, not at-or-after its end, so
+ *                        it stores no lower bound and reads back at every `asOf`
+ *                        before that end (issue #407).
+ *
+ * The comparison against `validTo` is NON-STRICT: `validTo === writeInstant`
+ * stores no bound too. A stamped `[T, T)` is a successful write no coordinate can
+ * observe, and the millisecond of skew between a caller's own `Date.now()` and the
+ * backend's sample is enough to land there — so the rule is total, and there is no
+ * input for which a stamped bound yields an empty window.
+ *
+ * The write instant is a PARAMETER, not a clock read: the caller passes the very
+ * value it binds into `created_at`/`updated_at` (or, for a resurrection, the
+ * instant its guard judged), so the decision and the stamp cannot come from two
+ * different samples (issue #413's failure mode). This function has no way to
+ * sample a clock, which is what makes that structural rather than tested.
+ *
+ * PRECONDITION: as {@link isEmptyValidityWindow}. This is called BELOW the
+ * validation boundary, on a public `GraphBackend` surface, so canonicality is
+ * established by whoever reached the backend: store paths through
+ * {@link validateOptionalCanonicalIsoDate}, interchange import through its own
+ * window validator, trusted import through its per-chunk format check. A direct
+ * `GraphBackend` caller establishes it itself — a pre-existing property of that
+ * surface, written down here rather than left implicit.
  */
-declare function deleteLegacyRecordedAnchorMap(options: DeleteLegacyRecordedAnchorMapOptions): Promise<void>;
+declare function resolveStampedValidityLowerBound(statedValidFrom: string | null | undefined, validTo: string | undefined, writeInstant: string): string | undefined;
 
-export { type DeleteLegacyRecordedAnchorMapOptions, GraphBackend, type MigrateLegacyRecordedTimeOptions, type MigrateLegacyRecordedTimeResult, type MigrateRecordedAnchorOptions, RecordedInstant, SqlTableNames, deleteLegacyRecordedAnchorMap, migrateLegacyRecordedTime, migrateRecordedAnchor };
+export { resolveStampedValidityLowerBound };

package/dist/backend/index.d.ts

@@ -1,61 +1,43 @@
-import { y as GraphBackend, bN as SqlTableNames } from '../types-Du78EvpN.js';
-export { cO as ALL_FULLTEXT_MODES, cP as ALL_META_EDGE_NAMES, A as AdapterBackend, aj as AdapterBackendTransactions, cQ as BASE_CONTRIBUTION_OWNER, B as BackendCapabilities, am as BackendIdentity, an as BackendLifecycle, ao as BackendMaintenance, ap as BackendTransactions, ar as Cardinality, cR as CheckUniqueBatchParams, cS as CheckUniqueParams, cT as ClaimIndexMaterializationParams, as as Collation, at as CommitSchemaVersionExpected, au as CommitSchemaVersionIfKindsEmptyResult, av as CommitSchemaVersionParams, aw as CompiledRowsSql, ax as CompiledSelectSql, ay as CompiledStatementSql, cU as CompiledTemporaryStatementSql, az as ContributionCapabilities, C as ContributionDiagnostic, a as ContributionDiagnosticState, aA as ContributionMaterializationBackend, cV as ContributionMaterializationIdentity, cW as ContributionMaterializationRow, aB as ContributionProbeContribution, aC as ContributionProbeEntry, aD as ContributionProbeResult, aE as ContributionProbeState, aF as ContributionRebuildResult, aG as ContributionRebuildScope, b as ContributionRepairEntry, c as ContributionRepairResult, aH as ContributionRepopulationStats, cX as CountEdgesByKindParams, cY as CountEdgesFromParams, cZ as CountNodesByKindParams, c_ as CreateVectorIndexParams, c$ as D1_MAX_BIND_PARAMETERS, d0 as DURABLE_OBJECT_MAX_BIND_PARAMETERS, a6 as DeleteBehavior, d1 as DeleteEdgeParams, d2 as DeleteEdgesBatchParams, d3 as DeleteEmbeddingParams, aJ as DeleteFulltextBatchParams, d4 as DeleteFulltextParams, d5 as DeleteNodeParams, d6 as DeleteUniqueParams, d7 as DialectAdapter, d8 as DialectCapabilities, d9 as DialectRecursiveQueryStrategy, da as DialectStandardQueryStrategy, db as DialectVectorPredicateStrategy, dc as DropVectorIndexParams, aK as EdgeEntityReadBackend, aL as EdgeEntityWriteBackend, dd as EdgeExistsBetweenParams, E as EdgeIndexDeclaration, f as EdgeIndexDirection, cM as EdgeRow, aQ as EndpointExistence, de as ExtensionArrayItemType, df as ExtensionArrayProperty, dg as ExtensionBooleanProperty, a9 as ExtensionEdgeDef, dh as ExtensionEdgeIndex, di as ExtensionEmbeddingModifier, dj as ExtensionEnumProperty, ab as ExtensionIndex, dk as ExtensionIndexWhere, a8 as ExtensionNodeDef, dl as ExtensionNodeIndex, dm as ExtensionNumberProperty, dn as ExtensionObjectFieldProperty, dp as ExtensionObjectProperty, aa as ExtensionOntologyRelation, dq as ExtensionPropertyModifiers, dr as ExtensionPropertyType, ds as ExtensionSearchableModifier, dt as ExtensionStringProperty, du as ExtensionUniqueConstraint, dv as ExtensionUniqueWhere, dw as FULLTEXT_CONTRIBUTION_NAME, aS as FilteredApproximateSearch, aT as FilteredApproximateSearchMode, dx as FindEdgesByEndpointSetParams, aU as FindEdgesByHeterogeneousEndpointSetParams, dy as FindEdgesByKindParams, dz as FindEdgesConnectedToParams, dA as FindNodesByKindParams, aV as FulltextBatchRow, aW as FulltextCapabilities, aX as FulltextOperationBackend, aY as FulltextQueryMode, aZ as FulltextSearchParams, a_ as FulltextSearchResult, F as FulltextStrategy, b0 as GraphAnalyticsCapabilities, b2 as GraphEntityReadBackend, b3 as GraphEntityWriteBackend, b4 as GraphExtension, a7 as GraphExtensionVersion, G as GraphIdentityConfig, b5 as GraphLifecycleBackend, dB as GraphReadBackend, dC as HardDeleteEdgeParams, dD as HardDeleteNodeParams, b6 as HardDeleteUniquesByNodeIdsParams, dE as HybridSearchParams, dF as HybridSearchRow, dG as IdentityTableNames, dH as InListParameterOptions, I as IndexDeclaration, dI as IndexDeclarationBase, L as IndexEntity, b8 as IndexMaterializationBackend, dJ as IndexMaterializationRow, h as IndexOrigin, i as IndexScope, j as IndexWhereExpression, dK as IndexWhereLiteral, dL as IndexWhereOp, dM as IndexWhereOperand, ai as InferenceType, dN as InsertEdgeParams, dO as InsertNodeParams, dP as InsertSchemaParams, dQ as InsertUniqueParams, b9 as IntentSql, J as JsonPointer, X as JsonSchema, a0 as JsonValue, a3 as KindAnnotations, K as KindEntity, dR as KindRemovalRow, dS as LiveNodeRow, bg as LockSchemaVersionForWriteParams, dT as MODERN_SQLITE_MAX_BIND_PARAMETERS, dU as MetaEdgeName, bj as NodeEntityReadBackend, bk as NodeEntityWriteBackend, N as NodeIndexDeclaration, cL as NodeRow, W as NullCheckOp, dV as POSTGRES_CAPABILITIES, dW as POSTGRES_MAX_BIND_PARAMETERS, bp as Placeholder, bq as PopulatedSchemaKind, br as QueryExecutionBackend, bs as RawQueryExecutionBackend, bt as RawStatementExecutionBackend, dX as RecordContributionMaterializationParams, dY as RecordIndexMaterializationParams, dZ as RecordKindRemovalParams, R as RelationalIndexDeclaration, d_ as RelationalIndexMethod, d$ as ReleaseIndexMaterializationClaimParams, bv as RemovalMaterializationBackend, bw as RenderedSql, bz as ResolvedSqlTableNames, bA as RowProps, e0 as SQLITE_CAPABILITIES, e1 as SQLITE_MAX_BIND_PARAMETERS, bB as SchemaCommitBackend, e2 as SchemaCommitPreflightBackend, bC as SchemaKindEmptinessProbe, bD as SchemaReadBackend, x as SchemaVersionRow, bE as SchemaWriteFenceBackend, P as SerializedClosures, H as SerializedEdgeDef, M as SerializedMetaEdge, D as SerializedNodeDef, Y as SerializedOntology, O as SerializedOntologyRelation, z as SerializedSchema, Z as SerializedUniqueConstraint, bF as SetActiveVersionParams, bH as SqlChunk, e3 as SqlCompilationBackend, S as SqlDialect, bI as SqlFragment, bJ as SqlIdentifierChunk, bK as SqlIntent, bL as SqlParameterChunk, bM as SqlPlaceholderChunk, bO as SqlTag, bP as SqlTextChunk, bQ as StrategyTableContribution, o as SystemColumnName, bR as TableContribution, T as TemporalMode, e4 as TombstonedNodeRow, bS as TransactionBackend, bT as TransactionOptions, bU as TransactionReadBackend, bW as TrustedImportOptions, bX as TrustedImportSession, bZ as UniqueConstraintBackend, e5 as UniqueRow, b_ as UniquenessScope, e6 as UpdateEdgeParams, e7 as UpdateNodeParams, b$ as UpdateNodeSetParams, c0 as UpdateNodeSetResult, e8 as UpsertEmbeddingBatchParams, e9 as UpsertEmbeddingBatchRow, ea as UpsertEmbeddingParams, c1 as UpsertFulltextBatchParams, eb as UpsertFulltextParams, ec as VECTOR_CONTRIBUTION_PREFIX, cw as ValueType, c2 as VectorCapabilities, p as VectorIndexDeclaration, q as VectorIndexImplementation, r as VectorIndexMetric, s as VectorIndexParams, ed as VectorIndexType, cN as VectorMetric, c3 as VectorOperationBackend, c4 as VectorSearchFrontierTuning, ee as VectorSearchParams, ef as VectorSearchResult, t as VectorSlot, V as VectorStrategy, eg as assertFiniteEmbedding, eh as assertVectorMinScore, ei as assertVectorSearchLimit, ej as buildFulltextCapabilities, c7 as buildVectorCapabilities, ca as fts5Strategy, ek as isLiveNodeRow, ci as isSqlFragment, el as isSqlPlaceholder, em as isTombstonedNodeRow, en as normalizeGraphAnalyticsCapabilities, eo as quoteIdentifier, co as renderPostgres, cp as renderSql, cq as renderSqlInline, cr as renderSqlite, cs as rowPropsToJsonText, ct as rowPropsToObject, ep as shortHash, cu as sql, cv as tsvectorStrategy, eq as vectorMinScoreCondition, er as vectorPhysicalName, es as vectorScoreExpression } from '../types-Du78EvpN.js';
-import { R as RecordedInstant } from '../temporal-DPtn0HOu.js';
+export { A as ALL_FULLTEXT_MODES, a as ALL_META_EDGE_NAMES, b as AdapterBackend, c as AdapterBackendTransactions, B as BASE_CONTRIBUTION_OWNER, d as BackendCapabilities, e as BackendIdentity, f as BackendLifecycle, g as BackendMaintenance, h as BackendTransactions, C as Cardinality, i as CheckUniqueBatchParams, j as CheckUniqueParams, k as ClaimIndexMaterializationParams, l as Collation, m as CommitSchemaVersionExpected, n as CommitSchemaVersionIfKindsEmptyResult, o as CommitSchemaVersionParams, p as CompiledRowsSql, q as CompiledSelectSql, r as CompiledStatementSql, s as CompiledTemporaryStatementSql, t as ContributionCapabilities, u as ContributionDiagnostic, v as ContributionDiagnosticState, w as ContributionMaterializationBackend, x as ContributionMaterializationIdentity, y as ContributionMaterializationRow, z as ContributionProbeContribution, D as ContributionProbeEntry, E as ContributionProbeResult, F as ContributionProbeState, G as ContributionRebuildResult, H as ContributionRebuildScope, J as ContributionRepairEntry, K as ContributionRepairResult, L as ContributionRepopulationStats, M as CountEdgesByKindParams, N as CountEdgesFromParams, O as CountNodesByKindParams, P as CreateVectorIndexParams, Q as D1_MAX_BIND_PARAMETERS, R as DURABLE_OBJECT_MAX_BIND_PARAMETERS, S as DeleteBehavior, T as DeleteEdgeParams, U as DeleteEdgesBatchParams, V as DeleteEmbeddingParams, W as DeleteFulltextBatchParams, X as DeleteFulltextParams, Y as DeleteNodeParams, Z as DeleteUniqueParams, _ as DialectAdapter, $ as DialectCapabilities, a0 as DialectRecursiveQueryStrategy, a1 as DialectStandardQueryStrategy, a2 as DialectVectorPredicateStrategy, a3 as DropVectorIndexParams, a4 as EdgeEntityReadBackend, a5 as EdgeEntityWriteBackend, a6 as EdgeExistsBetweenParams, a7 as EdgeIndexDeclaration, a8 as EdgeIndexDirection, a9 as EdgeRow, aa as EndpointExistence, ab as ExtensionArrayItemType, ac as ExtensionArrayProperty, ad as ExtensionBooleanProperty, ae as ExtensionEdgeDef, af as ExtensionEdgeIndex, ag as ExtensionEmbeddingModifier, ah as ExtensionEnumProperty, ai as ExtensionIndex, aj as ExtensionIndexWhere, ak as ExtensionNodeDef, al as ExtensionNodeIndex, am as ExtensionNumberProperty, an as ExtensionObjectFieldProperty, ao as ExtensionObjectProperty, ap as ExtensionOntologyRelation, aq as ExtensionPropertyModifiers, ar as ExtensionPropertyType, as as ExtensionSearchableModifier, at as ExtensionStringProperty, au as ExtensionUniqueConstraint, av as ExtensionUniqueWhere, aw as FULLTEXT_CONTRIBUTION_NAME, ax as FilteredApproximateSearch, ay as FilteredApproximateSearchMode, az as FindEdgesByEndpointSetParams, aA as FindEdgesByHeterogeneousEndpointSetParams, aB as FindEdgesByKindParams, aC as FindEdgesConnectedToParams, aD as FindNodesByKindParams, aE as FulltextBatchRow, aF as FulltextCapabilities, aG as FulltextOperationBackend, aH as FulltextQueryMode, aI as FulltextSearchParams, aJ as FulltextSearchResult, aK as FulltextStrategy, aL as GraphAnalyticsCapabilities, aM as GraphBackend, aN as GraphEntityReadBackend, aO as GraphEntityWriteBackend, aP as GraphExtension, aQ as GraphExtensionVersion, aR as GraphIdentityConfig, aS as GraphLifecycleBackend, aT as GraphReadBackend, aU as HardDeleteEdgeParams, aV as HardDeleteNodeParams, aW as HardDeleteUniquesByNodeIdsParams, aX as HybridSearchParams, aY as HybridSearchRow, aZ as IdentityTableNames, a_ as InListParameterOptions, I as IndexDeclaration, a$ as IndexDeclarationBase, b0 as IndexEntity, b1 as IndexMaterializationBackend, b2 as IndexMaterializationRow, b3 as IndexOrigin, b4 as IndexScope, b5 as IndexWhereExpression, b6 as IndexWhereLiteral, b7 as IndexWhereOp, b8 as IndexWhereOperand, b9 as InferenceType, ba as InsertEdgeParams, bb as InsertNodeParams, bc as InsertSchemaParams, bd as InsertUniqueParams, be as IntentSql, bf as JsonPointer, bg as JsonSchema, bh as JsonValue, bi as KindAnnotations, bj as KindEntity, bk as KindRemovalRow, bl as LiveNodeRow, bm as LockSchemaVersionForWriteParams, bn as MODERN_SQLITE_MAX_BIND_PARAMETERS, bo as MetaEdgeName, bp as NodeEntityReadBackend, bq as NodeEntityWriteBackend, br as NodeIndexDeclaration, bs as NodeRow, bt as NullCheckOp, bu as POSTGRES_CAPABILITIES, bv as POSTGRES_MAX_BIND_PARAMETERS, bw as Placeholder, bx as PopulatedSchemaKind, by as QueryExecutionBackend, bz as RawQueryExecutionBackend, bA as RawStatementExecutionBackend, bB as RecordContributionMaterializationParams, bC as RecordIndexMaterializationParams, bD as RecordKindRemovalParams, bE as RelationalIndexDeclaration, bF as RelationalIndexMethod, bG as ReleaseIndexMaterializationClaimParams, bH as RemovalMaterializationBackend, bI as RenderedSql, bJ as ResolvedSqlTableNames, bK as RowProps, bL as SQLITE_CAPABILITIES, bM as SQLITE_MAX_BIND_PARAMETERS, bN as SchemaCommitBackend, bO as SchemaCommitPreflightBackend, bP as SchemaKindEmptinessProbe, bQ as SchemaReadBackend, bR as SchemaVersionRow, bS as SchemaWriteFenceBackend, bT as SerializedClosures, bU as SerializedEdgeDef, bV as SerializedMetaEdge, bW as SerializedNodeDef, bX as SerializedOntology, bY as SerializedOntologyRelation, bZ as SerializedSchema, b_ as SerializedUniqueConstraint, b$ as SetActiveVersionParams, c0 as SqlChunk, c1 as SqlCompilationBackend, c2 as SqlDialect, c3 as SqlFragment, c4 as SqlIdentifierChunk, c5 as SqlIntent, c6 as SqlParameterChunk, c7 as SqlPlaceholderChunk, c8 as SqlTableNames, c9 as SqlTag, ca as SqlTextChunk, cb as StrategyTableContribution, cc as SystemColumnName, cd as TableContribution, ce as TemporalMode, cf as TombstonedNodeRow, cg as TransactionBackend, ch as TransactionOptions, ci as TransactionReadBackend, cj as TrustedImportOptions, ck as TrustedImportSession, cl as UniqueConstraintBackend, cm as UniqueRow, cn as UniquenessScope, co as UpdateEdgeParams, cp as UpdateNodeParams, cq as UpdateNodeSetParams, cr as UpdateNodeSetResult, cs as UpsertEmbeddingBatchParams, ct as UpsertEmbeddingBatchRow, cu as UpsertEmbeddingParams, cv as UpsertFulltextBatchParams, cw as UpsertFulltextParams, cx as VECTOR_CONTRIBUTION_PREFIX, cy as ValueType, cz as VectorCapabilities, cA as VectorIndexDeclaration, cB as VectorIndexImplementation, cC as VectorIndexMetric, cD as VectorIndexParams, cE as VectorIndexType, cF as VectorMetric, cG as VectorOperationBackend, cH as VectorSearchFrontierTuning, cI as VectorSearchParams, cJ as VectorSearchResult, cK as VectorSlot, cL as VectorStrategy, cM as assertFiniteEmbedding, cN as assertVectorMinScore, cO as assertVectorSearchLimit, cP as buildFulltextCapabilities, cQ as buildVectorCapabilities, cR as fts5Strategy, cS as isLiveNodeRow, cT as isSqlFragment, cU as isSqlPlaceholder, cV as isTombstonedNodeRow, cW as normalizeGraphAnalyticsCapabilities, cX as quoteIdentifier, cY as renderPostgres, cZ as renderSql, c_ as renderSqlInline, c$ as renderSqlite, d0 as rowPropsToJsonText, d1 as rowPropsToObject, d2 as shortHash, d3 as sql, d4 as tsvectorStrategy, d5 as vectorMinScoreCondition, d6 as vectorPhysicalName, d7 as vectorScoreExpression } from '../types-BqFZTQmV.js';
+export { D as DeleteLegacyRecordedAnchorMapOptions, M as MigrateLegacyRecordedTimeOptions, a as MigrateLegacyRecordedTimeResult, b as MigrateRecordedAnchorOptions, R as RepairInvertedWindowsOptions, c as RepairInvertedWindowsReport, d as RepairRelation, e as RepairRelationScope, f as deleteLegacyRecordedAnchorMap, m as migrateLegacyRecordedTime, g as migrateRecordedAnchor, r as repairInvertedValidityWindows } from '../repair-validity-windows-DlUSqwCg.js';
+export { R as RecordedInstant } from '../temporal-CbnLzTmM.js';
 import 'zod';
 
 /**
- * One-time offline migration from timestamp-only recorded relations to numeric
- * revisions. The durable remap table lets applications translate checkpoints
- * stored outside TypeGraph before deleting the migration metadata.
- */
-
-type MigrateLegacyRecordedTimeOptions = Readonly<{
-    backend: GraphBackend;
-    /** Override the backend's recorded table names. */
-    tableNames?: Partial<SqlTableNames> | undefined;
-    /** Override the durable legacy-anchor mapping table name. */
-    mappingTableName?: string | undefined;
-}>;
-type MigrateLegacyRecordedTimeResult = Readonly<{
-    /** `true` when timestamp columns were rewritten during this call. */
-    migrated: boolean;
-    /** Number of graphs represented in the legacy commit order. */
-    graphs: number;
-    /** Number of distinct legacy anchors available for remapping. */
-    anchors: number;
-    /** Physical table retaining the old-anchor → revision mapping. */
-    mappingTableName: string;
-}>;
-type MigrateRecordedAnchorOptions = Readonly<{
-    backend: Pick<GraphBackend, "dialect" | "execute" | "tableNames">;
-    graphId: string;
-    anchor: string;
-    tableNames?: Partial<SqlTableNames> | undefined;
-    mappingTableName?: string | undefined;
-}>;
-type DeleteLegacyRecordedAnchorMapOptions = Readonly<{
-    backend: Pick<GraphBackend, "dialect" | "execute" | "executeStatement" | "tableNames" | "transaction">;
-    graphId: string;
-    tableNames?: Partial<SqlTableNames> | undefined;
-    mappingTableName?: string | undefined;
-    /** Drop the mapping table when this deletion leaves it empty. */
-    dropWhenEmpty?: boolean | undefined;
-}>;
-/**
- * Rewrites timestamp-only recorded relations to numeric revisions.
+ * THE lower bound a write that STAMPS its own start stores, decided against the
+ * instant it is about to stamp. One owner for every such write, so no two of them
+ * can spell the decision differently. Three inputs, three outcomes:
  *
- * Run offline before opening a Store with the new schema. The durable mapping
- * table is retained so external checkpoint stores can call
- * {@link migrateRecordedAnchor}; delete each graph's rows after its downstream
- * checkpoints have been rewritten.
- */
-declare function migrateLegacyRecordedTime(options: MigrateLegacyRecordedTimeOptions): Promise<MigrateLegacyRecordedTimeResult>;
-/** Remaps one timestamp-only checkpoint after {@link migrateLegacyRecordedTime}. */
-declare function migrateRecordedAnchor(options: MigrateRecordedAnchorOptions): Promise<RecordedInstant>;
-/**
- * Deletes one graph's legacy remap rows after downstream checkpoints migrate.
- * Set `dropWhenEmpty` to remove the migration table after the final graph.
+ *  - a stated `null`   → no lower bound (a CONFIRMED open-left window, which is
+ *                        how interchange round-trips a row that has none);
+ *  - a stated string   → that bound, the caller's own assertion, verbatim;
+ *  - nothing stated    → the write instant, UNLESS stamping it would leave the
+ *                        window readable at no instant. A row carrying only a
+ *                        `validTo` at or before the write instant is "born already
+ *                        ended": its start is UNKNOWN, not at-or-after its end, so
+ *                        it stores no lower bound and reads back at every `asOf`
+ *                        before that end (issue #407).
+ *
+ * The comparison against `validTo` is NON-STRICT: `validTo === writeInstant`
+ * stores no bound too. A stamped `[T, T)` is a successful write no coordinate can
+ * observe, and the millisecond of skew between a caller's own `Date.now()` and the
+ * backend's sample is enough to land there — so the rule is total, and there is no
+ * input for which a stamped bound yields an empty window.
+ *
+ * The write instant is a PARAMETER, not a clock read: the caller passes the very
+ * value it binds into `created_at`/`updated_at` (or, for a resurrection, the
+ * instant its guard judged), so the decision and the stamp cannot come from two
+ * different samples (issue #413's failure mode). This function has no way to
+ * sample a clock, which is what makes that structural rather than tested.
+ *
+ * PRECONDITION: as {@link isEmptyValidityWindow}. This is called BELOW the
+ * validation boundary, on a public `GraphBackend` surface, so canonicality is
+ * established by whoever reached the backend: store paths through
+ * {@link validateOptionalCanonicalIsoDate}, interchange import through its own
+ * window validator, trusted import through its per-chunk format check. A direct
+ * `GraphBackend` caller establishes it itself — a pre-existing property of that
+ * surface, written down here rather than left implicit.
  */
-declare function deleteLegacyRecordedAnchorMap(options: DeleteLegacyRecordedAnchorMapOptions): Promise<void>;
+declare function resolveStampedValidityLowerBound(statedValidFrom: string | null | undefined, validTo: string | undefined, writeInstant: string): string | undefined;
 
-export { type DeleteLegacyRecordedAnchorMapOptions, GraphBackend, type MigrateLegacyRecordedTimeOptions, type MigrateLegacyRecordedTimeResult, type MigrateRecordedAnchorOptions, RecordedInstant, SqlTableNames, deleteLegacyRecordedAnchorMap, migrateLegacyRecordedTime, migrateRecordedAnchor };
+export { resolveStampedValidityLowerBound };