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

{katalyst_forge-4.0.0 → katalyst_forge-4.1.0}/.gitignore

@@ -95,6 +95,11 @@ Thumbs.db
 # Browser/Playwright state files
 browser-state-*.json
 
+# Agent harness scratch (run exhaust, never the design bundle)
+.opencode/sessions/
+.opencode/analysis/
+.opencode/package-lock.json
+
 # Build artifacts
 site/
 stack-tests/cucumber-report/

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

@@ -1,8 +1,8 @@
 Metadata-Version: 2.4
 Name: katalyst-forge
-Version: 4.0.0
+Version: 4.1.0
 Summary: The Forge bundle — 31 node-type definitions for software delivery taxonomy
 Author: eSimplicity
 License: Proprietary
 Requires-Python: >=3.12
-Requires-Dist: katalyst-engine<5,>=4.0
+Requires-Dist: katalyst-engine<5,>=4.1

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

@@ -1,6 +1,6 @@
 [project]
 name = "katalyst-forge"
-version = "4.0.0"
+version = "4.1.0"
 description = "The Forge bundle — 31 node-type definitions for software delivery taxonomy"
 license = { text = "Proprietary" }
 requires-python = ">=3.12"
@@ -8,7 +8,7 @@ authors = [
     { name = "eSimplicity" }
 ]
 dependencies = [
-    "katalyst-engine>=4.0,<5",
+    "katalyst-engine>=4.1,<5",
 ]
 
 [project.entry-points."katalyst_engine.bundles"]

{katalyst_forge-4.0.0 → katalyst_forge-4.1.0}/src/katalyst_forge/bundle.py

@@ -11,7 +11,7 @@ Wing modules:
 - ``wings/org.py``       — organization, program, project, team, team_member, role
 - ``wings/practices.py`` — practice_area, competency, skill, tool
 - ``wings/design.py``    — business_domain_model, user_type, user_need, design_spec, adr, nfr, specification, assertion
-- ``wings/delivery.py``  — work_item, change_entry
+- ``wings/delivery.py``  — work_item, change_entry, agent_run
 - ``wings/pipeline.py``  — cicd_stage
 - ``wings/pipeline.py``  — cicd_stage, cicd_job_template, cicd_workflow_template
 - ``wings/agentic.py``   — agent, agent_skill
@@ -92,7 +92,7 @@ class ForgeBundle:
             version=Version(major=4, minor=0),
             provided_kinds=ALL_KINDS,
             wing_names=ALL_WING_NAMES,
-            description="Forge taxonomy — 29 node types for modeling software delivery organizations",
+            description="Forge taxonomy — 30 node types for modeling software delivery organizations",
         )
 
     def node_definitions(self) -> list[NodeDefinition]:

{katalyst_forge-4.0.0 → katalyst_forge-4.1.0}/src/katalyst_forge/relationships.py

@@ -236,6 +236,29 @@ REFERENCES_ROAD_ITEM_REL = RelationshipDefinition(
     cardinality=Cardinality.MANY_TO_ONE,
 )
 
+REFERENCES_WORK_ITEM_REL = RelationshipDefinition(
+    identity=_rel_id("references_work_item"),
+    describes_kind="references_work_item",
+    description="Change entry references a work item",
+    wing="workflow",
+    display_order=440,
+    cardinality=Cardinality.MANY_TO_ONE,
+)
+
+TRACES_TO_REL = RelationshipDefinition(
+    identity=_rel_id("traces_to"),
+    describes_kind="traces_to",
+    description=(
+        "Work item traces to a design-wing artifact it implements, addresses, or "
+        "satisfies (capability, user_need, nfr, adr, design_spec, specification). "
+        "The target kind is carried by the source field reference, so adding a new "
+        "traceable target kind is a one-line field addition, not a new edge type."
+    ),
+    wing="workflow",
+    display_order=450,
+    cardinality=Cardinality.MANY_TO_MANY,
+)
+
 # ── Pipeline wing ────────────────────────────────────────────────────
 
 STAGE_DEPENDS_ON_REL = RelationshipDefinition(
@@ -287,6 +310,8 @@ ALL_RELATIONSHIP_DEFINITIONS: list[RelationshipDefinition] = [
     BLOCKED_BY_REL,
     SUPERSEDED_BY_REL,
     REFERENCES_ROAD_ITEM_REL,
+    REFERENCES_WORK_ITEM_REL,
+    TRACES_TO_REL,
     # pipeline
     STAGE_DEPENDS_ON_REL,
     BELONGS_TO_STAGE_REL,

katalyst_forge-4.1.0/src/katalyst_forge/wings/delivery.py

@@ -0,0 +1,310 @@
+"""Delivery wing — work_item, change_entry."""
+
+from __future__ import annotations
+
+from katalyst_engine.core.identity import Identity
+from katalyst_engine.schema.definition import (
+    FieldRef,
+    FieldSpec,
+    NodeDefinition,
+    ParentRule,
+    WingDefinition,
+)
+
+WORK_ITEM: NodeDefinition = NodeDefinition(
+    identity=Identity(kind="node_definition", name="work_item"),
+    describes_kind="work_item",
+    wing="delivery",
+    display_order=370,
+    directory_name="work_items",
+    is_root=True,
+    is_leaf=False,
+    is_extension=False,
+    clonable=False,
+    display_label="Work Item",
+    display_label_plural="Work Items",
+    extends_kinds=(),
+    parent_rules=(),
+    fields=(
+        FieldSpec(
+            name="title",
+            field_type="string",
+            required=False,
+            description="",
+        ),
+        FieldSpec(
+            name="status",
+            field_type="string",
+            required=False,
+            description="",
+            allowed_values=(
+                "idea",
+                "proposed",
+                "accepted",
+                "planned",
+                "in_progress",
+                "blocked",
+                "delivered",
+                "validated",
+                "released",
+                "retired",
+            ),
+        ),
+        FieldSpec(
+            name="phase",
+            field_type="integer",
+            required=False,
+            description="Implementation phase (0-3)",
+        ),
+        FieldSpec(
+            name="priority",
+            field_type="string",
+            required=False,
+            description="",
+        ),
+        FieldSpec(
+            name="started",
+            field_type="string",
+            required=False,
+            description="ISO 8601 start date",
+        ),
+        FieldSpec(
+            name="completed",
+            field_type="string",
+            required=False,
+            description="ISO 8601 completion date",
+        ),
+        FieldSpec(
+            name="blocked_by",
+            field_type="list",
+            required=False,
+            description="",
+        ),
+        FieldSpec(
+            name="blocks",
+            field_type="list",
+            required=False,
+            description="",
+        ),
+        FieldSpec(
+            name="capabilities",
+            field_type="list",
+            required=False,
+            description="Capabilities this work item implements",
+        ),
+        FieldSpec(
+            name="user_needs",
+            field_type="list",
+            required=False,
+            description="User needs this work item addresses",
+        ),
+        FieldSpec(
+            name="nfrs",
+            field_type="list",
+            required=False,
+            description="NFRs this work item satisfies",
+        ),
+        FieldSpec(
+            name="adrs",
+            field_type="list",
+            required=False,
+            description="ADRs this work item implements",
+        ),
+        FieldSpec(
+            name="design_specs",
+            field_type="list",
+            required=False,
+            description="Design specs this work item realizes",
+        ),
+        FieldSpec(
+            name="specifications",
+            field_type="list",
+            required=False,
+            description="Specifications this work item fulfills",
+        ),
+    ),
+    cross_references=(
+        FieldRef(
+            field_name="blocked_by",
+            target_kind="work_item",
+            rel_type="BLOCKED_BY",
+        ),
+        FieldRef(
+            field_name="blocks",
+            target_kind="work_item",
+            rel_type="BLOCKS",
+        ),
+        FieldRef(
+            field_name="capabilities",
+            target_kind="capability",
+            rel_type="TRACES_TO",
+        ),
+        FieldRef(
+            field_name="user_needs",
+            target_kind="user_need",
+            rel_type="TRACES_TO",
+        ),
+        FieldRef(
+            field_name="nfrs",
+            target_kind="nfr",
+            rel_type="TRACES_TO",
+        ),
+        FieldRef(
+            field_name="adrs",
+            target_kind="adr",
+            rel_type="TRACES_TO",
+        ),
+        FieldRef(
+            field_name="design_specs",
+            target_kind="design_spec",
+            rel_type="TRACES_TO",
+        ),
+        FieldRef(
+            field_name="specifications",
+            target_kind="specification",
+            rel_type="TRACES_TO",
+        ),
+    ),
+)
+
+CHANGE_ENTRY: NodeDefinition = NodeDefinition(
+    identity=Identity(kind="node_definition", name="change_entry"),
+    describes_kind="change_entry",
+    wing="delivery",
+    display_order=395,
+    directory_name="change_entries",
+    is_root=False,
+    is_leaf=True,
+    is_extension=False,
+    clonable=False,
+    display_label="Change Entry",
+    display_label_plural="Change Entries",
+    extends_kinds=(),
+    parent_rules=(
+        ParentRule(
+            child_kind="change_entry",
+            allowed_parent_kinds=frozenset({"work_item"}),
+            required=False,
+        ),
+    ),
+    fields=(
+        FieldSpec(
+            name="title",
+            field_type="string",
+            required=False,
+            description="",
+        ),
+        FieldSpec(
+            name="work_item_id",
+            field_type="string",
+            required=False,
+            description="Reference to the parent work item",
+        ),
+        FieldSpec(
+            name="road_id",
+            field_type="string",
+            required=False,
+            description="DEPRECATED alias of work_item_id",
+        ),
+        FieldSpec(
+            name="date",
+            field_type="string",
+            required=False,
+            description="ISO 8601 date",
+        ),
+        FieldSpec(
+            name="version",
+            field_type="string",
+            required=False,
+            description="",
+        ),
+        FieldSpec(
+            name="categories",
+            field_type="list",
+            required=False,
+            description="",
+        ),
+    ),
+    cross_references=(
+        FieldRef(
+            field_name="work_item_id",
+            target_kind="work_item",
+            rel_type="REFERENCES_WORK_ITEM",
+        ),
+        FieldRef(
+            field_name="road_id",
+            target_kind="work_item",
+            rel_type="REFERENCES_ROAD_ITEM",
+        ),
+    ),
+)
+
+AGENT_RUN: NodeDefinition = NodeDefinition(
+    identity=Identity(kind="node_definition", name="agent_run"),
+    describes_kind="agent_run",
+    wing="delivery",
+    display_order=398,
+    directory_name="agent_runs",
+    is_root=False,
+    is_leaf=True,
+    is_extension=False,
+    clonable=False,
+    display_label="Agent Run",
+    display_label_plural="Agent Runs",
+    extends_kinds=(),
+    parent_rules=(
+        ParentRule(
+            child_kind="agent_run",
+            allowed_parent_kinds=frozenset({"work_item"}),
+            required=False,
+        ),
+    ),
+    fields=(
+        FieldSpec(
+            name="stages",
+            field_type="list",
+            required=False,
+            description="Ordered per-stage telemetry: stage, agent, gate, started, ended, model, tokens, retries (identifiers and counts only)",
+        ),
+        FieldSpec(
+            name="totals",
+            field_type="list",
+            required=False,
+            description="Run-level totals (e.g. total tokens, total retries)",
+        ),
+        FieldSpec(
+            name="entered_status",
+            field_type="string",
+            required=False,
+            description="work_item status when the run started",
+        ),
+        FieldSpec(
+            name="exited_status",
+            field_type="string",
+            required=False,
+            description="work_item status when the run ended",
+        ),
+        FieldSpec(
+            name="started",
+            field_type="string",
+            required=False,
+            description="ISO 8601 run start timestamp",
+        ),
+        FieldSpec(
+            name="ended",
+            field_type="string",
+            required=False,
+            description="ISO 8601 run end timestamp",
+        ),
+    ),
+    cross_references=(),
+)
+
+DELIVERY_WING: WingDefinition = WingDefinition(
+    identity=Identity(kind="wing_definition", name="delivery"),
+    describes_kind="delivery",
+    display_name="Delivery",
+    member_kinds=("work_item", "change_entry", "agent_run"),
+)
+
+DELIVERY_WING_NODES = [WORK_ITEM, CHANGE_ENTRY, AGENT_RUN]

katalyst_forge-4.0.0/src/katalyst_forge/wings/delivery.py

@@ -1,160 +0,0 @@
-"""Delivery wing — work_item, change_entry."""
-
-from __future__ import annotations
-
-from katalyst_engine.core.identity import Identity
-from katalyst_engine.schema.definition import (
-    FieldRef,
-    FieldSpec,
-    NodeDefinition,
-    ParentRule,
-    WingDefinition,
-)
-
-WORK_ITEM: NodeDefinition = NodeDefinition(
-    identity=Identity(kind="node_definition", name="work_item"),
-    describes_kind="work_item",
-    wing="delivery",
-    display_order=370,
-    directory_name="work_items",
-    is_root=True,
-    is_leaf=False,
-    is_extension=False,
-    clonable=False,
-    display_label="Work Item",
-    display_label_plural="Work Items",
-    extends_kinds=(),
-    parent_rules=(),
-    fields=(
-        FieldSpec(
-            name="title",
-            field_type="string",
-            required=False,
-            description="",
-        ),
-        FieldSpec(
-            name="status",
-            field_type="string",
-            required=False,
-            description="",
-        ),
-        FieldSpec(
-            name="phase",
-            field_type="integer",
-            required=False,
-            description="Implementation phase (0-3)",
-        ),
-        FieldSpec(
-            name="priority",
-            field_type="string",
-            required=False,
-            description="",
-        ),
-        FieldSpec(
-            name="started",
-            field_type="string",
-            required=False,
-            description="ISO 8601 start date",
-        ),
-        FieldSpec(
-            name="completed",
-            field_type="string",
-            required=False,
-            description="ISO 8601 completion date",
-        ),
-        FieldSpec(
-            name="blocked_by",
-            field_type="list",
-            required=False,
-            description="",
-        ),
-        FieldSpec(
-            name="blocks",
-            field_type="list",
-            required=False,
-            description="",
-        ),
-    ),
-    cross_references=(
-        FieldRef(
-            field_name="blocked_by",
-            target_kind="work_item",
-            rel_type="BLOCKED_BY",
-        ),
-        FieldRef(
-            field_name="blocks",
-            target_kind="work_item",
-            rel_type="BLOCKS",
-        ),
-    ),
-)
-
-CHANGE_ENTRY: NodeDefinition = NodeDefinition(
-    identity=Identity(kind="node_definition", name="change_entry"),
-    describes_kind="change_entry",
-    wing="delivery",
-    display_order=395,
-    directory_name="change_entries",
-    is_root=False,
-    is_leaf=True,
-    is_extension=False,
-    clonable=False,
-    display_label="Change Entry",
-    display_label_plural="Change Entries",
-    extends_kinds=(),
-    parent_rules=(
-        ParentRule(
-            child_kind="change_entry",
-            allowed_parent_kinds=frozenset({"road_item"}),
-            required=False,
-        ),
-    ),
-    fields=(
-        FieldSpec(
-            name="title",
-            field_type="string",
-            required=False,
-            description="",
-        ),
-        FieldSpec(
-            name="road_id",
-            field_type="string",
-            required=False,
-            description="Reference to the parent road item",
-        ),
-        FieldSpec(
-            name="date",
-            field_type="string",
-            required=False,
-            description="ISO 8601 date",
-        ),
-        FieldSpec(
-            name="version",
-            field_type="string",
-            required=False,
-            description="",
-        ),
-        FieldSpec(
-            name="categories",
-            field_type="list",
-            required=False,
-            description="",
-        ),
-    ),
-    cross_references=(
-        FieldRef(
-            field_name="road_id",
-            target_kind="road_item",
-            rel_type="REFERENCES_ROAD_ITEM",
-        ),
-    ),
-)
-
-DELIVERY_WING: WingDefinition = WingDefinition(
-    identity=Identity(kind="wing_definition", name="delivery"),
-    describes_kind="delivery",
-    display_name="Delivery",
-    member_kinds=("work_item", "change_entry"),
-)
-
-DELIVERY_WING_NODES = [WORK_ITEM, CHANGE_ENTRY]