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

{katalyst_engine-3.1.0 → katalyst_engine-4.0.0}/.gitignore

@@ -103,3 +103,10 @@ stack-tests/test-results/
 # Generated artifacts (rebuild with `just generate-schemas`)
 taxonomy/src/katalyst_taxonomy/engine/generated/
 .worktrees/
+.plan-74-75-76-77.md
+.HANDOFF-scaffolding-wiring.md
+.HANDOFF-2-cicd-migration.md
+.HANDOFF-action-execution-fixes.md
+.HANDOFF-bdd-coverage.md
+.HANDOFF-*.md
+docs/superpowers/

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

@@ -10,6 +10,12 @@ workspace packages. Tags use the `engine-vX.Y.Z` prefix.
 
 ---
 
+## [4.0.0] -- 2026-06-16
+
+### Removed
+
+- **BREAKING: Removed the `scaffoldable` flag from the node-model API.** The `NodeDefinition.scaffoldable` field and the `SchemaRegistry.is_scaffoldable()` and `SchemaRegistry.scaffoldable_kinds()` methods are gone. Scaffolding is no longer an engine-level concept: any node kind may be scaffolded, and the decision is owned entirely by the scaffolding plugin/runtime in `katalyst-taxonomy`. Consumers that called `is_scaffoldable()` / `scaffoldable_kinds()` or read `NodeDefinition.scaffoldable` must drop those calls — scaffolding capability is determined by the taxonomy layer, not the engine.
+
 ## [3.1.0] -- 2026-06-11
 
 ### Added

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: katalyst-engine
-Version: 3.1.0
+Version: 4.0.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-3.1.0 → katalyst_engine-4.0.0}/pyproject.toml

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

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

@@ -120,9 +120,6 @@ class NodeDefinition(Definitive, frozen=True):
     cross_references: tuple[FieldRef, ...] = ()
     """Typed references from fields on this kind to other node kinds."""
 
-    scaffoldable: bool = False
-    """Whether instances of this kind support scaffolding (project generation)."""
-
     clonable: bool = False
     """Whether instances of this kind can be cloned."""
 

{katalyst_engine-3.1.0 → katalyst_engine-4.0.0}/src/katalyst_engine/schema/registry.py

@@ -168,24 +168,11 @@ class SchemaRegistry:
         nd = self._node_defs.get(kind)
         return nd.is_extension if nd else False
 
-    def is_scaffoldable(self, kind: str) -> bool:
-        """Whether this kind supports project scaffolding."""
-        nd = self._node_defs.get(kind)
-        return nd.scaffoldable if nd else False
-
     def is_clonable(self, kind: str) -> bool:
         """Whether this kind can be cloned."""
         nd = self._node_defs.get(kind)
         return nd.clonable if nd else False
 
-    def scaffoldable_kinds(self) -> list[str]:
-        """Return all kinds that support scaffolding, sorted by display_order."""
-        return [
-            nd.describes_kind
-            for nd in sorted(self._node_defs.values(), key=lambda d: d.display_order)
-            if nd.scaffoldable
-        ]
-
     def clonable_kinds(self) -> list[str]:
         """Return all kinds that can be cloned, sorted by display_order."""
         return [

{katalyst_engine-3.1.0 → katalyst_engine-4.0.0}/tests/bundle/test_path_loader.py

@@ -62,7 +62,6 @@ def _write_bundle(root: Path, *, deps: str = '"katalyst-engine>=3.0,<4"') -> Pat
                 is_root=True,
                 is_leaf=True,
                 is_extension=False,
-                scaffoldable=False,
                 clonable=False,
                 display_label="Demo Thing",
                 display_label_plural="Demo Things",

{katalyst_engine-3.1.0 → katalyst_engine-4.0.0}/tests/schema/test_definition.py

@@ -134,22 +134,29 @@ class TestNodeDefinition:
         assert restored.describes_kind == nd.describes_kind
         assert len(restored.fields) == len(nd.fields)
 
-    def test_scaffoldable_and_clonable_defaults(self) -> None:
+    def test_clonable_default(self) -> None:
         nd = NodeDefinition(
             identity=_id("node_definition", "system"),
             describes_kind="system",
         )
-        assert nd.scaffoldable is False
         assert nd.clonable is False
 
-    def test_scaffoldable_and_clonable_set(self) -> None:
+    def test_no_scaffoldable_field(self) -> None:
+        # Scaffolding is a plugin concern — the engine NodeDefinition must NOT
+        # carry a scaffoldable flag (regression guard for the extraction).
+        nd = NodeDefinition(
+            identity=_id("node_definition", "layer"),
+            describes_kind="layer",
+        )
+        assert not hasattr(nd, "scaffoldable")
+        assert "scaffoldable" not in type(nd).model_fields
+
+    def test_clonable_set(self) -> None:
         nd = NodeDefinition(
             identity=_id("node_definition", "layer"),
             describes_kind="layer",
-            scaffoldable=True,
             clonable=True,
         )
-        assert nd.scaffoldable is True
         assert nd.clonable is True
 
     def test_display_label_defaults(self) -> None: