transformation registry, transformation runs, and derived artifact lineage

src/kontextual_engine/ports/repositories.py

@@ -11,6 +11,7 @@ from kontextual_engine.core import (
     AuditEvent,
     ContextEntity,
     CoreRelationship,
+    DerivedArtifactLineage,
     IdempotencyRecord,
     IngestionJob,
     IngestionJobStatus,
@@ -22,6 +23,8 @@ from kontextual_engine.core import (
     RepresentationKind,
     RetrievalFeedbackRecord,
     Sensitivity,
+    TransformationRun,
+    TransformationRunStatus,
 )
 
 
@@ -109,3 +112,22 @@ class AssetRegistryRepository(Protocol):
         *,
         status: IngestionJobStatus | None = None,
     ) -> list[IngestionJob]: ...
+
+    def save_transformation_run(self, run: TransformationRun) -> TransformationRun: ...
+    def get_transformation_run(self, run_id: str) -> TransformationRun: ...
+    def list_transformation_runs(
+        self,
+        *,
+        status: TransformationRunStatus | None = None,
+        operation_id: str | None = None,
+    ) -> list[TransformationRun]: ...
+
+    def save_derived_lineage(self, lineage: DerivedArtifactLineage) -> DerivedArtifactLineage: ...
+    def get_derived_lineage(self, lineage_id: str) -> DerivedArtifactLineage: ...
+    def list_derived_lineage(
+        self,
+        *,
+        output_asset_id: str | None = None,
+        source_asset_id: str | None = None,
+        transformation_run_id: str | None = None,
+    ) -> list[DerivedArtifactLineage]: ...