cks-runtime 0.4.3__tar.gz → 0.4.5__tar.gz

{cks_runtime-0.4.3 → cks_runtime-0.4.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cks-runtime
-Version: 0.4.3
+Version: 0.4.5
 Summary: Canonical Runtime for the Canonical Knowledge Structure ecosystem
 Author: Vladyslav Hruznov
 License: MIT
@@ -17,7 +17,7 @@ Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
 Requires-Python: >=3.12
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: cks-core>=1.2.0
+Requires-Dist: cks-core>=1.3.0
 Provides-Extra: dev
 Requires-Dist: pytest>=8.0; extra == "dev"
 Requires-Dist: mypy>=1.0; extra == "dev"
@@ -29,7 +29,7 @@ Dynamic: license-file
 
 ![Python](https://img.shields.io/badge/python-3.11%2B-blue)
 ![License](https://img.shields.io/badge/license-MIT-green)
-![Tests](https://img.shields.io/badge/tests-156%20passing-brightgreen)
+![Tests](https://img.shields.io/badge/tests-158%20passing-brightgreen)
 ![Status](https://img.shields.io/badge/status-beta-blue)
 
 CKS Runtime is the canonical execution environment for

{cks_runtime-0.4.3 → cks_runtime-0.4.5}/README.md

@@ -4,7 +4,7 @@
 
 ![Python](https://img.shields.io/badge/python-3.11%2B-blue)
 ![License](https://img.shields.io/badge/license-MIT-green)
-![Tests](https://img.shields.io/badge/tests-156%20passing-brightgreen)
+![Tests](https://img.shields.io/badge/tests-158%20passing-brightgreen)
 ![Status](https://img.shields.io/badge/status-beta-blue)
 
 CKS Runtime is the canonical execution environment for

{cks_runtime-0.4.3 → cks_runtime-0.4.5}/cks_runtime/config.py

@@ -28,7 +28,7 @@ def _runtime_version() -> str:
     try:
         return version("cks-runtime")
     except PackageNotFoundError:
-        return "0.4.3"
+        return "0.4.5"
 
 
 @dataclass(slots=True)

{cks_runtime-0.4.3 → cks_runtime-0.4.5}/cks_runtime/operations/operation_types.py

@@ -32,13 +32,17 @@ class ValidateOperation(Operation):
         executor,
     ) -> ExecutionResult:
         result = executor.core.validate(self.knowledge_structure)
-        error = None if result.valid else RuntimeError("Validation failed")
+        # Determining that a Knowledge Structure is invalid is a
+        # successful outcome of *running* validation, not an
+        # operation failure -- it must be reported as diagnostics,
+        # never as a raised exception. Only unexpected execution
+        # errors (caught by OperationExecutor) are OperationStatus.FAILED.
         return ExecutionResult(
             operation_id=self.operation_id,
-            status=OperationStatus.COMPLETED if result.valid else OperationStatus.FAILED,
+            status=OperationStatus.COMPLETED,
             payload=result,
             diagnostics=result.diagnostics,
-            error=error,
+            error=None,
         )
 
 

{cks_runtime-0.4.3 → cks_runtime-0.4.5}/cks_runtime/pipeline/execution_pipeline.py

@@ -15,7 +15,7 @@ from cks_runtime.core_api.validation_result import RuntimeValidationResult
 from cks_runtime.transaction.transaction import RuntimeTransaction
 from cks_runtime.versioning.version import RuntimeVersion
 from cks_runtime.execution.operation_executor import OperationStatus
-from cks_runtime.operations.operation_types import ValidateOperation
+from cks_runtime.operations.operation_types import ValidateOperation, EvolveOperation
 from cks_runtime.execution.execution_context import ExecutionContext
 
 
@@ -192,6 +192,7 @@ class ExecutionPipeline:
         for op in transaction.operations:
             result = executor.execute(op, session)
             self._handle_result(result, op.operation_id, transaction)
+            self._apply_state_mutation(op, result, session)
 
         # 2. DispatchRequest (новый путь)
         if dispatcher is not None and transaction.requests:
@@ -205,4 +206,25 @@ class ExecutionPipeline:
             self.rollback(transaction)
             raise RuntimeError(f"Operation {operation_id} failed: {result.error}")
         if result.diagnostics:
-            self._runtime.diagnostics.extend(result.diagnostics)
+            self._runtime.diagnostics.extend(result.diagnostics)
+
+    def _apply_state_mutation(self, operation, result, session) -> None:
+        """
+        Write operation results that change the canonical Knowledge
+        Structure back onto the owning session.
+
+        Most operations (Validate, Serialize, Explain) are read-only
+        with respect to session state. EvolveOperation is the
+        exception: it produces a *new* KnowledgeStructure via
+        CKS Core's Genesis/Decay operators, and that result must
+        become the session's tracked state before a RuntimeVersion
+        snapshot is taken — otherwise the committed version silently
+        reflects the pre-evolution structure instead of the outcome
+        of the transaction.
+        """
+
+        if (
+            isinstance(operation, EvolveOperation)
+            and result.status == OperationStatus.COMPLETED
+        ):
+            session.knowledge_structure = result.payload

{cks_runtime-0.4.3 → cks_runtime-0.4.5}/cks_runtime.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cks-runtime
-Version: 0.4.3
+Version: 0.4.5
 Summary: Canonical Runtime for the Canonical Knowledge Structure ecosystem
 Author: Vladyslav Hruznov
 License: MIT
@@ -17,7 +17,7 @@ Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
 Requires-Python: >=3.12
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: cks-core>=1.2.0
+Requires-Dist: cks-core>=1.3.0
 Provides-Extra: dev
 Requires-Dist: pytest>=8.0; extra == "dev"
 Requires-Dist: mypy>=1.0; extra == "dev"
@@ -29,7 +29,7 @@ Dynamic: license-file
 
 ![Python](https://img.shields.io/badge/python-3.11%2B-blue)
 ![License](https://img.shields.io/badge/license-MIT-green)
-![Tests](https://img.shields.io/badge/tests-156%20passing-brightgreen)
+![Tests](https://img.shields.io/badge/tests-158%20passing-brightgreen)
 ![Status](https://img.shields.io/badge/status-beta-blue)
 
 CKS Runtime is the canonical execution environment for

{cks_runtime-0.4.3 → cks_runtime-0.4.5}/cks_runtime.egg-info/requires.txt

@@ -1,4 +1,4 @@
-cks-core>=1.2.0
+cks-core>=1.3.0
 
 [dev]
 pytest>=8.0

{cks_runtime-0.4.3 → cks_runtime-0.4.5}/cks_runtime_plugins/cks_core/adapter.py

@@ -13,6 +13,7 @@ from __future__ import annotations
 from typing import Any
 
 import cks
+from cks.diagnostics import DiagnosticSeverity as CoreSeverity
 from cks.evolution import compose
 from cks.interface import inspect as cks_inspect
 
@@ -20,6 +21,42 @@ from cks_runtime.core_api.interfaces import CoreInterface
 from cks_runtime.core_api.validation_result import (
     RuntimeValidationResult,
 )
+from cks_runtime.diagnostics.diagnostic import (
+    Diagnostic as RuntimeDiagnostic,
+    DiagnosticSeverity as RuntimeSeverity,
+    DiagnosticSource,
+)
+
+_SEVERITY_MAP = {
+    CoreSeverity.INFORMATION: RuntimeSeverity.INFO,
+    CoreSeverity.WARNING: RuntimeSeverity.WARNING,
+    CoreSeverity.ERROR: RuntimeSeverity.ERROR,
+}
+
+
+def _translate_diagnostic(diagnostic: Any) -> RuntimeDiagnostic:
+    """
+    Translate a cks-core Diagnostic into a Runtime-native Diagnostic.
+
+    cks-core diagnostics freeze ``metadata`` into a MappingProxyType,
+    which the stdlib ``copy`` module cannot deepcopy. Runtime persists
+    Diagnostics via deepcopy (see InMemoryStorage), so foreign
+    cks-core Diagnostic instances must never be stored as-is -- they
+    are always translated into the Runtime's own, deepcopy-safe
+    Diagnostic type at this boundary.
+    """
+
+    metadata = dict(diagnostic.metadata)
+    if diagnostic.location is not None:
+        metadata.setdefault("location", diagnostic.location)
+
+    return RuntimeDiagnostic(
+        message=diagnostic.message,
+        source=DiagnosticSource.CORE,
+        severity=_SEVERITY_MAP[diagnostic.severity],
+        code=diagnostic.identity,
+        metadata=metadata,
+    )
 
 
 class CksCoreAdapter(CoreInterface):
@@ -46,7 +83,7 @@ class CksCoreAdapter(CoreInterface):
         return RuntimeValidationResult(
             valid=result.is_valid,
             diagnostics=tuple(
-                result.diagnostics,
+                _translate_diagnostic(d) for d in result.diagnostics
             ),
             metadata=dict(
                 result.metadata,

{cks_runtime-0.4.3 → cks_runtime-0.4.5}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "cks-runtime"
-version = "0.4.3"
+version = "0.4.5"
 
 description = "Canonical Runtime for the Canonical Knowledge Structure ecosystem"
 
@@ -19,7 +19,7 @@ license = { text = "MIT" }
 requires-python = ">=3.12"
 
 dependencies = [
-    "cks-core>=1.2.0",
+    "cks-core>=1.3.0",
 ]
 
 keywords = [