katalyst-engine 4.0.0__tar.gz → 4.1.0__tar.gz

{katalyst_engine-4.0.0 → katalyst_engine-4.1.0}/CHANGELOG.md

@@ -10,6 +10,12 @@ workspace packages. Tags use the `engine-vX.Y.Z` prefix.
 
 ---
 
+## [4.1.0] -- 2026-06-26
+
+### Added
+
+- **`FieldSpec.allowed_values`** -- a generic, taxonomy-agnostic field-constraint mechanism. When non-empty, it declares the permitted values for a field; empty (the default `()`) means unconstrained. Consumers (e.g. the taxonomy v2 linter) project it to a JSON Schema `enum`. The engine holds only the mechanism; domain-specific values (such as the `work_item` lifecycle) live in the forge consumer, keeping the engine taxonomy-agnostic. Additive and backward-compatible. (#143, #138)
+
 ## [4.0.0] -- 2026-06-16
 
 ### Removed

{katalyst_engine-4.0.0 → katalyst_engine-4.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: katalyst-engine
-Version: 4.0.0
+Version: 4.1.0
 Summary: A distributed declaration framework — primitives for schema-aware, multi-source, evolvable artifact graphs
 Project-URL: Repository, https://github.com/esimplicityinc/katalyst-taxonomy
 Author: eSimplicity

{katalyst_engine-4.0.0 → katalyst_engine-4.1.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "katalyst-engine"
-version = "4.0.0"
+version = "4.1.0"
 description = "A distributed declaration framework — primitives for schema-aware, multi-source, evolvable artifact graphs"
 readme = "README.md"
 license = { text = "Proprietary" }

{katalyst_engine-4.0.0 → katalyst_engine-4.1.0}/src/katalyst_engine/schema/definition.py

@@ -44,6 +44,11 @@ class FieldSpec(BaseModel, frozen=True):
     ref_target_kind: str = ""
     """If field_type is 'ref', the kind of Evolvable it references."""
 
+    allowed_values: tuple[str, ...] = ()
+    """If non-empty, the permitted values for this field, projected to a JSON
+    Schema ``enum`` by consumers. Empty means unconstrained. The engine holds
+    only the mechanism; domain-specific values are supplied by consumers."""
+
 
 class ParentRule(BaseModel, frozen=True):
     """Declares what kinds are allowed as parents of a node kind.

katalyst_engine-4.1.0/tests/schema/test_engine_boundary_guard.py

@@ -0,0 +1,49 @@
+"""Engine boundary guard: engine must stay taxonomy-agnostic.
+
+The engine holds the field-constraint MECHANISM (FieldSpec.allowed_values) but
+never taxonomy-specific VALUES (e.g. the work_item lifecycle). Those live in the
+forge consumer. This guard fails if lifecycle status literals or forge/taxonomy
+imports leak into engine/src.
+"""
+
+from __future__ import annotations
+
+import re
+from pathlib import Path
+
+ENGINE_SRC = Path(__file__).resolve().parents[2] / "src" / "katalyst_engine"
+LIFECYCLE_TOKENS = (
+    "idea",
+    "proposed",
+    "accepted",
+    "planned",
+    "in_progress",
+    "blocked",
+    "delivered",
+    "validated",
+    "released",
+    "retired",
+)
+
+
+def _engine_files() -> list[Path]:
+    return list(ENGINE_SRC.rglob("*.py"))
+
+
+def test_no_lifecycle_status_literals_in_engine() -> None:
+    offenders: list[str] = []
+    for path in _engine_files():
+        text = path.read_text(encoding="utf-8")
+        present = [t for t in LIFECYCLE_TOKENS if t in text]
+        if len(present) >= 2:
+            offenders.append(f"{path.name}: {present}")
+    assert not offenders, f"Lifecycle values leaked into engine: {offenders}"
+
+
+def test_engine_does_not_import_consumers() -> None:
+    import_re = re.compile(r"^\s*(?:import|from)\s+katalyst_(?:forge|taxonomy)\b", re.MULTILINE)
+    offenders: list[str] = []
+    for path in _engine_files():
+        if import_re.search(path.read_text(encoding="utf-8")):
+            offenders.append(path.name)
+    assert not offenders, f"Engine imports consumer packages: {offenders}"

katalyst_engine-4.1.0/tests/schema/test_fieldspec_allowed_values.py

@@ -0,0 +1,23 @@
+"""WP-3 (#3 mechanism): FieldSpec.allowed_values generic constraint."""
+
+from __future__ import annotations
+
+from katalyst_engine.schema.definition import FieldSpec
+
+
+def test_allowed_values_default_empty() -> None:
+    assert FieldSpec(name="status").allowed_values == ()
+
+
+def test_allowed_values_set() -> None:
+    f = FieldSpec(name="status", allowed_values=("a", "b"))
+    assert f.allowed_values == ("a", "b")
+
+
+def test_allowed_values_frozen() -> None:
+    f = FieldSpec(name="status", allowed_values=("a",))
+    try:
+        f.allowed_values = ("c",)  # type: ignore[misc]
+        raise AssertionError("Expected frozen")  # noqa: TRY301
+    except Exception:
+        pass