@nicia-ai/typegraph 0.41.0 → 0.42.1

package/dist/{chunk-JP5EICR6.cjs → chunk-V2GZBPY2.cjs}

@@ -1,24 +1,25 @@
 'use strict';
 
-var chunkRW24SAHI_cjs = require('./chunk-RW24SAHI.cjs');
+var chunkTRF4EBJT_cjs = require('./chunk-TRF4EBJT.cjs');
+var chunkDMZEVJGL_cjs = require('./chunk-DMZEVJGL.cjs');
 var chunkACSVZPK7_cjs = require('./chunk-ACSVZPK7.cjs');
-var chunkHP6LWBLB_cjs = require('./chunk-HP6LWBLB.cjs');
-var chunkNT6ILURI_cjs = require('./chunk-NT6ILURI.cjs');
-var chunkMNURF4RF_cjs = require('./chunk-MNURF4RF.cjs');
-var chunkCKFBZ4LV_cjs = require('./chunk-CKFBZ4LV.cjs');
+var chunkAO2WPYFZ_cjs = require('./chunk-AO2WPYFZ.cjs');
+var chunkZPCKPLMX_cjs = require('./chunk-ZPCKPLMX.cjs');
+var chunkZBV4LQD2_cjs = require('./chunk-ZBV4LQD2.cjs');
+var chunkI73ATSAH_cjs = require('./chunk-I73ATSAH.cjs');
 var chunkZY4GXIVN_cjs = require('./chunk-ZY4GXIVN.cjs');
 var chunk764JHTLT_cjs = require('./chunk-764JHTLT.cjs');
 var chunkHAHNRASW_cjs = require('./chunk-HAHNRASW.cjs');
-var chunkN2V3HJFV_cjs = require('./chunk-N2V3HJFV.cjs');
+var chunkXDMPDUKL_cjs = require('./chunk-XDMPDUKL.cjs');
 var chunkSVJ5GEXW_cjs = require('./chunk-SVJ5GEXW.cjs');
 var chunkDI74SMXS_cjs = require('./chunk-DI74SMXS.cjs');
-var chunkSAFZ6JTI_cjs = require('./chunk-SAFZ6JTI.cjs');
+var chunkKTBTSHU6_cjs = require('./chunk-KTBTSHU6.cjs');
 var zod = require('zod');
 
 // src/ontology/core-meta-edges.ts
 function createMetaEdge(name, properties) {
   return Object.freeze({
-    [chunkRW24SAHI_cjs.META_EDGE_BRAND]: true,
+    [chunkDMZEVJGL_cjs.META_EDGE_BRAND]: true,
     name,
     properties: {
       transitive: properties.transitive ?? false,
@@ -289,9 +290,96 @@ function diffNodes(before, after) {
   }
   return changes;
 }
+var SET_VALUED_KEYWORDS = /* @__PURE__ */ new Set(["required", "enum"]);
+var SCHEMA_VALUED_KEYWORDS = /* @__PURE__ */ new Set([
+  "additionalProperties",
+  "allOf",
+  "anyOf",
+  "contains",
+  "contentSchema",
+  "else",
+  "if",
+  "items",
+  "not",
+  "oneOf",
+  "prefixItems",
+  "propertyNames",
+  "then",
+  "unevaluatedItems",
+  "unevaluatedProperties"
+]);
+var SUBSCHEMA_MAP_KEYWORDS = /* @__PURE__ */ new Set([
+  "properties",
+  "patternProperties",
+  "dependentSchemas",
+  "$defs",
+  "definitions"
+]);
+var DEPENDENT_REQUIRED_KEYWORD = "dependentRequired";
+function canonicalKey(value) {
+  return JSON.stringify(value, chunkACSVZPK7_cjs.sortedReplacer);
+}
+function sortedByCanonicalForm(items) {
+  return items.toSorted(
+    (left, right) => chunkTRF4EBJT_cjs.compareStrings(canonicalKey(left), canonicalKey(right))
+  );
+}
+function orderNormalizedSchema(value) {
+  if (Array.isArray(value)) {
+    return value.map((item) => orderNormalizedSchema(item));
+  }
+  if (value !== null && typeof value === "object") {
+    const normalized = {};
+    for (const [key, entry] of Object.entries(value)) {
+      normalized[key] = normalizedKeywordValue(key, entry);
+    }
+    return normalized;
+  }
+  return value;
+}
+function normalizedKeywordValue(key, value) {
+  if (SET_VALUED_KEYWORDS.has(key) && Array.isArray(value)) {
+    return sortedByCanonicalForm(value);
+  }
+  if (SUBSCHEMA_MAP_KEYWORDS.has(key)) return normalizedSubschemaMap(value);
+  if (key === DEPENDENT_REQUIRED_KEYWORD) {
+    return normalizedDependentRequired(value);
+  }
+  if (SCHEMA_VALUED_KEYWORDS.has(key)) return orderNormalizedSchema(value);
+  return value;
+}
+function normalizedDependentRequired(value) {
+  if (value === null || typeof value !== "object" || Array.isArray(value)) {
+    return value;
+  }
+  const normalized = {};
+  for (const [name, required] of Object.entries(value)) {
+    normalized[name] = Array.isArray(required) ? sortedByCanonicalForm(required) : required;
+  }
+  return normalized;
+}
+function normalizedSubschemaMap(value) {
+  if (value === null || typeof value !== "object" || Array.isArray(value)) {
+    return orderNormalizedSchema(value);
+  }
+  const normalized = {};
+  for (const [name, subschema] of Object.entries(value)) {
+    normalized[name] = orderNormalizedSchema(subschema);
+  }
+  return normalized;
+}
+function propertySchemasEqual(before, after) {
+  return chunkACSVZPK7_cjs.canonicalEqual(
+    orderNormalizedSchema(before),
+    orderNormalizedSchema(after)
+  );
+}
+function endpointKindsEqual(before, after) {
+  return chunkACSVZPK7_cjs.canonicalEqual(before?.toSorted(), after?.toSorted());
+}
 function diffNodeDef(name, before, after) {
   const changes = [];
-  if (!chunkACSVZPK7_cjs.canonicalEqual(before.properties, after.properties)) {
+  if (!propertySchemasEqual(before.properties, after.properties)) {
     const { severity, details } = classifyPropertyChanges(
       name,
       before.properties,
@@ -364,7 +452,10 @@ function isObjectSchema(schema) {
   return schema.type === "object" || schema.properties !== void 0;
 }
 function isBreakingPropertyChange(before, after) {
-  if (chunkACSVZPK7_cjs.canonicalEqual(stripSchemaMetadata(before), stripSchemaMetadata(after))) {
+  if (propertySchemasEqual(
+    stripSchemaMetadata(before),
+    stripSchemaMetadata(after)
+  )) {
     return false;
   }
   if (propertyTypeSignature(before) !== propertyTypeSignature(after)) {
@@ -474,7 +565,7 @@ function diffEdges(before, after) {
 }
 function diffEdgeDef(name, before, after) {
   const changes = [];
-  if (!chunkACSVZPK7_cjs.canonicalEqual(before.fromKinds, after.fromKinds)) {
+  if (!endpointKindsEqual(before.fromKinds, after.fromKinds)) {
     changes.push({
       type: "modified",
       kind: name,
@@ -484,7 +575,7 @@ function diffEdgeDef(name, before, after) {
       after
     });
   }
-  if (!chunkACSVZPK7_cjs.canonicalEqual(before.toKinds, after.toKinds)) {
+  if (!endpointKindsEqual(before.toKinds, after.toKinds)) {
     changes.push({
       type: "modified",
       kind: name,
@@ -504,7 +595,7 @@ function diffEdgeDef(name, before, after) {
       after
     });
   }
-  if (!chunkACSVZPK7_cjs.canonicalEqual(before.properties, after.properties)) {
+  if (!propertySchemasEqual(before.properties, after.properties)) {
     const { severity, details } = classifyPropertyChanges(
       name,
       before.properties,
@@ -748,6 +839,10 @@ function generateSummary(nodeChanges, edgeChanges, ontologyChanges, indexChanges
 function isBackwardsCompatible(diff) {
   return !diff.hasBreakingChanges;
 }
+function classifySchemaChanges(diff) {
+  if (!diff.hasChanges) return "identical";
+  return diff.hasBreakingChanges ? "incompatible" : "additive";
+}
 function getMigrationActions(diff) {
   const actions = [];
   for (const change of diff.nodes) {
@@ -815,7 +910,7 @@ var KindRegistry = class {
    * Checks if child is a subclass of parent (directly or transitively).
    */
   isSubClassOf(child, parent) {
-    return chunkN2V3HJFV_cjs.isReachable(this.subClassAncestors, child, parent);
+    return chunkXDMPDUKL_cjs.isReachable(this.subClassAncestors, child, parent);
   }
   /**
    * Expands a kind to include all its subclasses.
@@ -842,13 +937,13 @@ var KindRegistry = class {
    * Checks if narrowerConcept is narrower than broaderConcept.
    */
   isNarrowerThan(narrowerConcept, broaderConcept) {
-    return chunkN2V3HJFV_cjs.isReachable(this.broaderClosure, narrowerConcept, broaderConcept);
+    return chunkXDMPDUKL_cjs.isReachable(this.broaderClosure, narrowerConcept, broaderConcept);
   }
   /**
    * Checks if broaderConcept is broader than narrowerConcept.
    */
   isBroaderThan(broaderConcept, narrowerConcept) {
-    return chunkN2V3HJFV_cjs.isReachable(this.narrowerClosure, broaderConcept, narrowerConcept);
+    return chunkXDMPDUKL_cjs.isReachable(this.narrowerClosure, broaderConcept, narrowerConcept);
   }
   /**
    * Expands to include all narrower concepts.
@@ -912,7 +1007,7 @@ var KindRegistry = class {
    * Checks if part is part of whole (directly or transitively).
    */
   isPartOf(part, whole) {
-    return chunkN2V3HJFV_cjs.isReachable(this.partOfClosure, part, whole);
+    return chunkXDMPDUKL_cjs.isReachable(this.partOfClosure, part, whole);
   }
   /**
    * Gets all wholes that contain this part.
@@ -1073,18 +1168,18 @@ function computeClosuresFromOntology(ontology) {
       }
     }
   }
-  const subClassAncestors = chunkN2V3HJFV_cjs.computeTransitiveClosure(subClassRelations);
-  const subClassDescendants = chunkN2V3HJFV_cjs.invertClosure(subClassAncestors);
-  const broaderClosure = chunkN2V3HJFV_cjs.computeTransitiveClosure(broaderRelations);
-  const narrowerClosure = chunkN2V3HJFV_cjs.invertClosure(broaderClosure);
+  const subClassAncestors = chunkXDMPDUKL_cjs.computeTransitiveClosure(subClassRelations);
+  const subClassDescendants = chunkXDMPDUKL_cjs.invertClosure(subClassAncestors);
+  const broaderClosure = chunkXDMPDUKL_cjs.computeTransitiveClosure(broaderRelations);
+  const narrowerClosure = chunkXDMPDUKL_cjs.invertClosure(broaderClosure);
   const equivalenceSets = computeEquivalenceSets(equivalentRelations);
   const iriToKind = computeIriMapping(equivalentRelations);
   const disjointPairs = computeDisjointPairs(disjointRelations);
-  const partOfClosure = chunkN2V3HJFV_cjs.computeTransitiveClosure(partOfRelations);
-  const hasPartClosure = chunkN2V3HJFV_cjs.invertClosure(partOfClosure);
+  const partOfClosure = chunkXDMPDUKL_cjs.computeTransitiveClosure(partOfRelations);
+  const hasPartClosure = chunkXDMPDUKL_cjs.invertClosure(partOfClosure);
   const edgeInverses = computeEdgeInverses(inverseOfRelations);
-  const edgeImplicationsClosure = chunkN2V3HJFV_cjs.computeTransitiveClosure(impliesRelations);
-  const edgeImplyingClosure = chunkN2V3HJFV_cjs.invertClosure(edgeImplicationsClosure);
+  const edgeImplicationsClosure = chunkXDMPDUKL_cjs.computeTransitiveClosure(impliesRelations);
+  const edgeImplyingClosure = chunkXDMPDUKL_cjs.invertClosure(edgeImplicationsClosure);
   return {
     subClassAncestors,
     subClassDescendants,
@@ -1188,7 +1283,7 @@ function serializeSchema(graph, version) {
   return {
     graphId: graph.id,
     version,
-    generatedAt: chunkMNURF4RF_cjs.nowIso(),
+    generatedAt: chunkZBV4LQD2_cjs.nowIso(),
     nodes,
     edges,
     ontology,
@@ -1219,7 +1314,7 @@ function serializeDeprecatedKinds(set) {
 function canonicalExtension(document) {
   if (document === void 0) return void 0;
   if (document.version === void 0) return document;
-  if (document.version !== chunkN2V3HJFV_cjs.LEGACY_GRAPH_EXTENSION_VERSION) return document;
+  if (document.version !== chunkXDMPDUKL_cjs.LEGACY_GRAPH_EXTENSION_VERSION) return document;
   const { version: _omit, ...rest } = document;
   return rest;
 }
@@ -1305,7 +1400,7 @@ function serializeEdgeIndexDeclaration(declaration) {
 }
 function serializeNodes(graph) {
   const result = {};
-  for (const kindName of chunkNT6ILURI_cjs.getNodeKinds(graph)) {
+  for (const kindName of chunkZPCKPLMX_cjs.getNodeKinds(graph)) {
     const registration = graph.nodes[kindName];
     if (registration === void 0) continue;
     result[kindName] = serializeNodeDef(registration);
@@ -1373,7 +1468,7 @@ function deserializeWherePredicate(serialized) {
 }
 function serializeEdges(graph) {
   const result = {};
-  for (const kindName of chunkNT6ILURI_cjs.getEdgeKinds(graph)) {
+  for (const kindName of chunkZPCKPLMX_cjs.getEdgeKinds(graph)) {
     const registration = graph.edges[kindName];
     if (registration === void 0) continue;
     result[kindName] = serializeEdgeDef(registration);
@@ -1430,8 +1525,8 @@ function serializeMetaEdge(metaEdge) {
 function serializeOntologyRelation(relation) {
   return {
     metaEdge: relation.metaEdge.name,
-    from: chunkRW24SAHI_cjs.getTypeName(relation.from),
-    to: chunkRW24SAHI_cjs.getTypeName(relation.to)
+    from: chunkDMZEVJGL_cjs.getTypeName(relation.from),
+    to: chunkDMZEVJGL_cjs.getTypeName(relation.to)
   };
 }
 function serializeClosures(relations) {
@@ -1564,7 +1659,7 @@ function compileNodeCached(kindName, document) {
 }
 function compileNode(kindName, document) {
   const schema = buildObjectSchema(document.properties);
-  const type = chunkRW24SAHI_cjs.defineNode(
+  const type = chunkDMZEVJGL_cjs.defineNode(
     kindName,
     chunkDI74SMXS_cjs.compactUndefined({
       schema,
@@ -1742,7 +1837,7 @@ function graphExtensionOntologyKey(entry) {
   return `${entry.metaEdge}|${entry.from}|${entry.to}`;
 }
 function compileTimeOntologyKey(relation) {
-  return `${relation.metaEdge.name}|${chunkRW24SAHI_cjs.getTypeName(relation.from)}|${chunkRW24SAHI_cjs.getTypeName(relation.to)}`;
+  return `${relation.metaEdge.name}|${chunkDMZEVJGL_cjs.getTypeName(relation.from)}|${chunkDMZEVJGL_cjs.getTypeName(relation.to)}`;
 }
 function buildGraphExtensionOntologyKeySet(document) {
   return new Set(
@@ -1763,7 +1858,7 @@ function mergeGraphExtension(graph, document) {
   if (graph.extension !== void 0 && chunkACSVZPK7_cjs.canonicalEqual(unionDocument, existingDocument)) {
     return graph;
   }
-  const validatedUnion = chunkN2V3HJFV_cjs.unwrap(chunkN2V3HJFV_cjs.validateGraphExtension(unionDocument));
+  const validatedUnion = chunkXDMPDUKL_cjs.unwrap(chunkXDMPDUKL_cjs.validateGraphExtension(unionDocument));
   const compiled = compileGraphExtension(validatedUnion);
   const { nodes: runtimeNodeNames, edges: runtimeEdgeNames } = extensionKindNames(existingDocument);
   const nodeKinds = /* @__PURE__ */ new Map();
@@ -1813,7 +1908,7 @@ function mergeGraphExtension(graph, document) {
       edgeKind: edge.kindName,
       side: "to"
     });
-    const type = chunkRW24SAHI_cjs.defineEdge(
+    const type = chunkDMZEVJGL_cjs.defineEdge(
       edge.kindName,
       chunkDI74SMXS_cjs.compactUndefined({
         schema: edge.schema,
@@ -1865,7 +1960,7 @@ function deriveGraphExtensionVectorIndexes(compiledNodes) {
       ...compiled.unique.length === 0 ? {} : { unique: [...compiled.unique] }
     };
   }
-  return chunkNT6ILURI_cjs.autoDeriveVectorIndexes(registrations).map(
+  return chunkZPCKPLMX_cjs.autoDeriveVectorIndexes(registrations).map(
     (index) => Object.freeze({ ...index, origin: "runtime" })
   );
 }
@@ -1883,7 +1978,7 @@ function mergeIndexesWithGraphExtension(existing, runtimeIndexes, graphId) {
   const runtimeRelational = runtimeIndexes.filter(
     (index) => index.entity !== "vector"
   );
-  const vectorMerged = chunkNT6ILURI_cjs.mergeVectorIndexes(compileTimeIndexes, runtimeVectors);
+  const vectorMerged = chunkZPCKPLMX_cjs.mergeVectorIndexes(compileTimeIndexes, runtimeVectors);
   const merged = [...vectorMerged, ...runtimeRelational];
   assertUniqueIndexNames(merged, graphId);
   return merged;
@@ -1895,7 +1990,7 @@ function assertUniqueIndexNames(indexes, graphId) {
       seen.add(index.name);
       continue;
     }
-    throw new chunkSAFZ6JTI_cjs.ConfigurationError(
+    throw new chunkKTBTSHU6_cjs.ConfigurationError(
       `Duplicate index name "${index.name}" after merging graph extension into graph "${graphId}". Index names must be unique within a graph.`,
       { graphId, indexName: index.name, code: "DUPLICATE_INDEX_NAME" },
       {
@@ -1911,12 +2006,12 @@ function compileGraphExtensionRelationalIndexes(documents, nodeKinds, mergedEdge
     if (document.entity === "node") {
       const node = nodeKinds.get(document.kind);
       if (node === void 0) {
-        throw new chunkSAFZ6JTI_cjs.KindNotFoundError(document.kind, "node", {
+        throw new chunkKTBTSHU6_cjs.KindNotFoundError(document.kind, "node", {
           graphId,
           suggestion: "Declare the kind under `nodes` in this graph extension, or remove the index from `indexes`."
         });
       }
-      const declaration2 = chunkCKFBZ4LV_cjs.defineNodeIndex(
+      const declaration2 = chunkI73ATSAH_cjs.defineNodeIndex(
         node,
         toNodeIndexConfig(document)
       );
@@ -1925,12 +2020,12 @@ function compileGraphExtensionRelationalIndexes(documents, nodeKinds, mergedEdge
     }
     const edgeRegistration = mergedEdges[document.kind];
     if (edgeRegistration === void 0) {
-      throw new chunkSAFZ6JTI_cjs.KindNotFoundError(document.kind, "edge", {
+      throw new chunkKTBTSHU6_cjs.KindNotFoundError(document.kind, "edge", {
         graphId,
         suggestion: "Declare the edge under `edges` in this graph extension, or remove the index from `indexes`."
       });
     }
-    const declaration = chunkCKFBZ4LV_cjs.defineEdgeIndex(
+    const declaration = chunkI73ATSAH_cjs.defineEdgeIndex(
       edgeRegistration.type,
       toEdgeIndexConfig(document)
     );
@@ -1942,7 +2037,7 @@ function buildWhereCallback(where) {
   return (props) => {
     const builder = props[where.field];
     if (builder === void 0) {
-      throw new chunkSAFZ6JTI_cjs.ConfigurationError(
+      throw new chunkKTBTSHU6_cjs.ConfigurationError(
         `Graph-extension index \`where\` references unknown field "${where.field}".`,
         { field: where.field, code: "EXTENSION_INDEX_WHERE_UNKNOWN_FIELD" }
       );
@@ -2017,14 +2112,14 @@ function isEmptyExtension(extension) {
 }
 function assertNoCollision(kindName, entity, collides, graphId) {
   if (!collides) return;
-  throw new chunkN2V3HJFV_cjs.KindCollisionError(kindName, entity, graphId);
+  throw new chunkXDMPDUKL_cjs.KindCollisionError(kindName, entity, graphId);
 }
 function resolveEndpoints(entries, nodeKinds, context) {
   return entries.map((entry) => {
     if (typeof entry !== "string") return entry;
     const resolved = nodeKinds.get(entry);
     if (resolved === void 0) {
-      throw new chunkN2V3HJFV_cjs.GraphExtensionUnresolvedEndpointError(
+      throw new chunkXDMPDUKL_cjs.GraphExtensionUnresolvedEndpointError(
         context.edgeKind,
         context.side,
         entry,
@@ -2073,7 +2168,7 @@ function assertEndpointCompatible(side, implyingEdgeKind, implyingKinds, implied
     (kind) => !registry.isAssignableToAny(kind, impliedKinds)
   );
   if (incompatibleKinds.length === 0) return;
-  throw new chunkSAFZ6JTI_cjs.ConfigurationError(
+  throw new chunkKTBTSHU6_cjs.ConfigurationError(
     `implies("${implyingEdgeKind}", "${impliedEdgeKind}") is endpoint-incompatible: ${side} kind(s) [${incompatibleKinds.join(", ")}] declared on "${implyingEdgeKind}" cannot be assigned to any of "${impliedEdgeKind}"'s ${side} kind(s) [${impliedKinds.join(", ")}].`,
     {
       metaEdge: chunkSVJ5GEXW_cjs.META_EDGE_IMPLIES,
@@ -2113,7 +2208,7 @@ function buildEdgeEndpointKinds(edges) {
 }
 function extractNodeTypes(graph) {
   const result = /* @__PURE__ */ new Map();
-  for (const typeName of chunkNT6ILURI_cjs.getNodeKinds(graph)) {
+  for (const typeName of chunkZPCKPLMX_cjs.getNodeKinds(graph)) {
     const registration = graph.nodes[typeName];
     result.set(typeName, registration.type);
   }
@@ -2121,7 +2216,7 @@ function extractNodeTypes(graph) {
 }
 function extractEdgeTypes(graph) {
   const result = /* @__PURE__ */ new Map();
-  for (const typeName of chunkNT6ILURI_cjs.getEdgeKinds(graph)) {
+  for (const typeName of chunkZPCKPLMX_cjs.getEdgeKinds(graph)) {
     const registration = graph.edges[typeName];
     result.set(typeName, registration.type);
   }
@@ -2469,7 +2564,7 @@ function parseSerializedSchema(json) {
   try {
     parsed = JSON.parse(json);
   } catch {
-    throw new chunkSAFZ6JTI_cjs.DatabaseOperationError(
+    throw new chunkKTBTSHU6_cjs.DatabaseOperationError(
       "Stored schema document is not valid JSON",
       { operation: "select", entity: "schema" }
     );
@@ -2477,7 +2572,7 @@ function parseSerializedSchema(json) {
   const result = serializedSchemaZod.safeParse(parsed);
   if (!result.success) {
     const issues = result.error.issues.map((issue) => `${issue.path.join(".")}: ${issue.message}`).join("; ");
-    throw new chunkSAFZ6JTI_cjs.DatabaseOperationError(
+    throw new chunkKTBTSHU6_cjs.DatabaseOperationError(
       `Stored schema document is malformed: ${issues}`,
       { operation: "select", entity: "schema" }
     );
@@ -2494,7 +2589,7 @@ async function loadActiveSchemaWithBootstrap(backend, graphId) {
   try {
     return await backend.getActiveSchema(graphId);
   } catch (error) {
-    if (backend.bootstrapTables && chunkHP6LWBLB_cjs.isMissingTableError(error)) {
+    if (backend.bootstrapTables && chunkAO2WPYFZ_cjs.isMissingTableError(error)) {
       await backend.bootstrapTables();
       return await backend.getActiveSchema(graphId);
     }
@@ -2588,12 +2683,14 @@ async function ensureSchema(backend, graph, options) {
   }
   const actions = getMigrationActions(diff);
   if (throwOnBreaking) {
-    throw new chunkSAFZ6JTI_cjs.MigrationError(
+    throw new chunkKTBTSHU6_cjs.MigrationError(
       `Schema migration required: ${diff.summary}. ${actions.length} migration action(s) needed. Use getSchemaChanges() to review, then migrateSchema() to apply.`,
       {
         graphId: graph.id,
         fromVersion: activeSchema.version,
-        toVersion: activeSchema.version + 1
+        toVersion: activeSchema.version + 1,
+        reason: "breaking-change",
+        diff
       }
     );
   }
@@ -2639,12 +2736,14 @@ async function assertVectorContributionsInitialized(backend, graph) {
 function schemaBehindError(graphId, fromVersion, diff) {
   const actions = getMigrationActions(diff);
   const qualifier = isBackwardsCompatible(diff) ? "safe auto-migration" : "breaking change";
-  return new chunkSAFZ6JTI_cjs.MigrationError(
+  return new chunkKTBTSHU6_cjs.MigrationError(
     `Schema verification failed for graph "${graphId}": ${diff.summary} (${qualifier}). ${actions.length} migration action(s) needed. The least-privilege runtime cannot migrate \u2014 run createStoreWithSchema(graph, adminBackend) under a privileged role (after any generated migration SQL, if you manage DDL externally) before attaching with createStore() / createVerifiedStore().`,
     {
       graphId,
       fromVersion,
-      toVersion: fromVersion + 1
+      toVersion: fromVersion + 1,
+      reason: "schema-behind",
+      diff
     }
   );
 }
@@ -2657,7 +2756,7 @@ async function readActiveSchemaPure(backend, graphId) {
   try {
     activeRow = await backend.getActiveSchema(graphId);
   } catch (error) {
-    if (chunkHP6LWBLB_cjs.isMissingTableError(error)) {
+    if (chunkAO2WPYFZ_cjs.isMissingTableError(error)) {
       throw schemaNotInitializedError(graphId, error);
     }
     throw error;
@@ -2668,7 +2767,7 @@ async function readActiveSchemaPure(backend, graphId) {
   return activeRow;
 }
 function schemaNotInitializedError(graphId, cause) {
-  return new chunkSAFZ6JTI_cjs.ConfigurationError(
+  return new chunkKTBTSHU6_cjs.ConfigurationError(
     `Cannot verify graph "${graphId}": no schema has been initialized. Run createStoreWithSchema(graph, adminBackend) once under a privileged role (which commits the schema_versions row and materializes contribution markers) before attaching with createStore() / createVerifiedStore(). Generated migration SQL creates the tables but does not initialize the schema row.`,
     { graphId },
     {
@@ -2713,9 +2812,14 @@ async function commitNewSchemaVersion(backend, graph, currentVersion) {
 async function rollbackSchema(backend, graphId, targetVersion) {
   const activeRow = await backend.getActiveSchema(graphId);
   if (activeRow === void 0) {
-    throw new chunkSAFZ6JTI_cjs.MigrationError(
+    throw new chunkKTBTSHU6_cjs.MigrationError(
       `Cannot rollback graph "${graphId}": no active schema version exists.`,
-      { graphId, fromVersion: 0, toVersion: targetVersion }
+      {
+        graphId,
+        fromVersion: 0,
+        toVersion: targetVersion,
+        reason: "no-active-version"
+      }
     );
   }
   await backend.setActiveVersion({
@@ -2734,12 +2838,20 @@ async function isSchemaInitialized(backend, graphId) {
   return row !== void 0;
 }
 async function getSchemaChanges(backend, graph) {
-  const activeSchema = await backend.getActiveSchema(graph.id);
-  if (activeSchema === void 0) return void 0;
-  const storedSchema = parseSerializedSchema(activeSchema.schema_doc);
-  const currentSchema = serializeSchema(graph, activeSchema.version + 1);
+  const activeRow = await backend.getActiveSchema(graph.id);
+  if (activeRow === void 0) return void 0;
+  const { graph: merged, storedSchema } = mergeStoredGraphExtension(
+    graph,
+    activeRow
+  );
+  const currentSchema = serializeSchema(merged, activeRow.version + 1);
   return computeSchemaDiff(storedSchema, currentSchema);
 }
+async function requiresMigration(backend, graph) {
+  const diff = await getSchemaChanges(backend, graph);
+  if (diff === void 0) return true;
+  return diff.hasChanges;
+}
 async function getCommittedSchemaVersion(backend, graphId) {
   const row = await backend.getActiveSchema(graphId);
   return row?.version;
@@ -2751,6 +2863,7 @@ exports.assertSchemaCurrent = assertSchemaCurrent;
 exports.broader = broader;
 exports.buildGraphExtensionOntologyKeySet = buildGraphExtensionOntologyKeySet;
 exports.buildKindRegistry = buildKindRegistry;
+exports.classifySchemaChanges = classifySchemaChanges;
 exports.commitNewSchemaVersion = commitNewSchemaVersion;
 exports.compileTimeOntologyKey = compileTimeOntologyKey;
 exports.computeSchemaDiff = computeSchemaDiff;
@@ -2781,6 +2894,7 @@ exports.narrower = narrower;
 exports.parseSerializedSchema = parseSerializedSchema;
 exports.partOf = partOf;
 exports.relatedTo = relatedTo;
+exports.requiresMigration = requiresMigration;
 exports.rollbackSchema = rollbackSchema;
 exports.sameAs = sameAs;
 exports.serializeIndexDeclaration = serializeIndexDeclaration;
@@ -2788,5 +2902,5 @@ exports.serializeSchema = serializeSchema;
 exports.serializeSchemaProperties = serializeSchemaProperties;
 exports.subClassOf = subClassOf;
 exports.validateImpliesEndpointCompatibility = validateImpliesEndpointCompatibility;
-//# sourceMappingURL=chunk-JP5EICR6.cjs.map
-//# sourceMappingURL=chunk-JP5EICR6.cjs.map
+//# sourceMappingURL=chunk-V2GZBPY2.cjs.map
+//# sourceMappingURL=chunk-V2GZBPY2.cjs.map