cks-core 1.2.0__tar.gz → 1.2.2__tar.gz

{cks_core-1.2.0 → cks_core-1.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cks-core
-Version: 1.2.0
+Version: 1.2.2
 Summary: Canonical Knowledge Structure — Reference Implementation
 Author: Vladyslav Hruznov
 License: MIT

{cks_core-1.2.0 → cks_core-1.2.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "cks-core"
-version = "1.2.0"
+version = "1.2.2"
 description = "Canonical Knowledge Structure — Reference Implementation"
 readme = "README.md"
 authors = [{name = "Vladyslav Hruznov"}]

{cks_core-1.2.0 → cks_core-1.2.2}/src/cks/__init__.py

@@ -71,7 +71,7 @@ from .interface import (
 
 _EXTERNAL_COUNT = load_external_constraints()
 
-__version__ = "1.2.0"
+__version__ = "1.2.2"
 
 VERSION = tuple(
     int(part)

{cks_core-1.2.0 → cks_core-1.2.2}/src/cks/engine.py

@@ -44,7 +44,7 @@ class ReferenceEngine:
         • implementation-independent
     """
 
-    VERSION: str = "1.2.0"
+    VERSION: str = "1.2.2"
 
     # ------------------------------------------------------------------
     # Construction & Serialization

{cks_core-1.2.0 → cks_core-1.2.2}/src/cks/evolution.py

@@ -193,6 +193,89 @@ class RemoveRelation(StructuralOperator):
         )
 
 
+# ---------------------------------------------------------------------------
+# JSON Deserialization of Operators
+# ---------------------------------------------------------------------------
+#
+# Consumers (the CLI, cks-mcp, and any other adapter) receive evolution
+# requests as plain JSON — a list of dicts such as
+# ``{"type": "add_object", "identity": {...}, "structure": {...}}``.
+# This is the single canonical place that turns that wire format into
+# concrete StructuralOperator instances, so every adapter shares the
+# same admissible operation set and the same error messages.
+
+def parse_operations(ops_data: Iterable[dict]) -> list[StructuralOperator]:
+    """
+    Parse a JSON-compatible list of operation descriptors into
+    StructuralOperators.
+
+    Parameters
+    ----------
+    ops_data
+        A sequence of dicts, each with a ``"type"`` field of
+        ``"add_object" | "add_relation" | "remove_object" | "remove_relation"``
+        and the fields required by that operation.
+
+    Raises
+    ------
+    ValueError
+        If an operation descriptor is missing required fields or has an
+        unknown ``"type"``.
+    """
+    from .core import ObjectIdentity
+
+    operators: list[StructuralOperator] = []
+
+    for i, op in enumerate(ops_data):
+        op_type = op.get("type")
+        if op_type is None:
+            raise ValueError(f"Operation #{i}: missing 'type' field")
+
+        if op_type == "add_object":
+            identity_data = op.get("identity")
+            if identity_data is None:
+                raise ValueError(f"Operation #{i}: missing 'identity' field")
+            identity = ObjectIdentity(**identity_data)
+            obj = KnowledgeObject(identity=identity, structure=op.get("structure", {}))
+            operators.append(AddObject(obj))
+
+        elif op_type == "add_relation":
+            identity_data = op.get("identity")
+            if identity_data is None:
+                raise ValueError(f"Operation #{i}: missing 'identity' field")
+            identity = ObjectIdentity(**identity_data)
+            participants = op.get("participants")
+            if participants is None:
+                raise ValueError(f"Operation #{i}: missing 'participants' field")
+            relation_type = op.get("relation_type")
+            if relation_type is None:
+                raise ValueError(f"Operation #{i}: missing 'relation_type' field")
+            relation = CanonicalRelation(
+                identity=identity,
+                participants=participants,
+                relation_type=relation_type,
+                structure=op.get("structure", {}),
+            )
+            operators.append(AddRelation(relation))
+
+        elif op_type == "remove_object":
+            object_id = op.get("object_id")
+            if object_id is None:
+                raise ValueError(f"Operation #{i}: missing 'object_id' field")
+            operators.append(RemoveObject(object_id))
+
+        elif op_type == "remove_relation":
+            relation_id = op.get("relation_id")
+            if relation_id is None:
+                raise ValueError(f"Operation #{i}: missing 'relation_id' field")
+            operators.append(RemoveRelation(relation_id))
+
+        else:
+            raise ValueError(f"Operation #{i}: unknown operation type '{op_type}'")
+
+    return operators
+
+
 # ---------------------------------------------------------------------------
 # Composition
 # ---------------------------------------------------------------------------
@@ -219,4 +302,5 @@ __all__ = [
     "RemoveObject",
     "RemoveRelation",
     "compose",
+    "parse_operations",
 ]

{cks_core-1.2.0 → cks_core-1.2.2}/src/cks/validator.py

@@ -82,7 +82,7 @@ class ReferenceValidator:
     # ------------------------------------------------------------------
 
     def constraint_validate(self, structure: KnowledgeStructure) -> list[Diagnostic]:
-        return self._registry.evaluate(structure)
+        return self._registry.evaluate(structure, stage=ValidationStage.CONSTRAINTS)
 
     # ------------------------------------------------------------------
     # Pipeline

{cks_core-1.2.0 → cks_core-1.2.2}/src/cks_core.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cks-core
-Version: 1.2.0
+Version: 1.2.2
 Summary: Canonical Knowledge Structure — Reference Implementation
 Author: Vladyslav Hruznov
 License: MIT