relationship persistence, context entities, idempotent asset creation, audit/version handling for relationship changes

src/kontextual_engine/__init__.py

@@ -26,6 +26,8 @@ from .core import (
     ContextEntityType,
     CoreRelationship,
     DerivedArtifactLineage,
+    IdempotencyRecord,
+    IdempotencyStatus,
     KnowledgeAsset,
     LifecycleState,
     MetadataRecord,
@@ -51,7 +53,7 @@ from .ingestion import IngestionRequest, IngestionResult, IngestionService
 from .ports import AllowAllPolicyGateway, AssetRegistryRepository, PolicyGateway
 from .query import QueryEngine, QueryResult
 from .relationships import RelationshipGraph
-from .services import AssetChangeResult, AssetRegistryService
+from .services import AssetChangeResult, AssetRegistryService, RelationshipChangeResult
 from .storage import InMemoryKnowledgeRepository
 from .workflows import (
     InputBundle,
@@ -97,6 +99,8 @@ __all__ = [
     "IngestionResult",
     "IngestionService",
     "InputBundle",
+    "IdempotencyRecord",
+    "IdempotencyStatus",
     "KnowledgeAsset",
     "KontextualError",
     "LifecycleState",
@@ -111,6 +115,7 @@ __all__ = [
     "QueryEngine",
     "QueryResult",
     "Relationship",
+    "RelationshipChangeResult",
     "RelationshipGraph",
     "RelationshipTargetKind",
     "RelationshipType",