katalyst-forge 4.2.0__tar.gz → 5.1.0__tar.gz

katalyst_forge-5.1.0/.gitignore

@@ -0,0 +1,23 @@
+__pycache__/
+*.pyc
+.venv/
+dist/
+site/
+node_modules/
+.pytest_cache/
+.ruff_cache/
+
+# RIC-733 consistency eval run exhaust (transient, not the checked-in baseline)
+docs/consistency-results.json
+.prompt-cache/
+
+# Deterministic tooling-gate run artifacts (kata-gate.sh runtime output).
+# Real telemetry per run; regenerated on every gate invocation, not committed.
+.global/taxonomy/delivery/agent_runs/tooling/
+
+# Generated orientation packet (RIC-731): produced at install time, not source
+orientation/packet.json
+
+# Machine-local orientation fallback config (RIC-731): holds an absolute packetPath,
+# written beside the installed contract; never source, never commit.
+orientation-config.json

{katalyst_forge-4.2.0 → katalyst_forge-5.1.0}/CHANGELOG.md

@@ -16,6 +16,45 @@ PyPI package version. A breaking node-type/model change bumps `schema_version`.
 
 ---
 
+## [5.1.0] -- 2026-07-28
+
+- **Canonical ADR/NFR storage** (RIC-1358) — ADR and NFR definitions now declare flat identity-derived storage under `.global/taxonomy/design/adrs/` and `.global/taxonomy/design/nfrs/`. Forge agents, skills, templates, fixtures, and documentation use the plural directories; legacy multi-document examples are labeled explicitly.
+- Migrated the nine Forge-owned NFR artifacts from `design/nfr/` to `design/nfrs/` and added `NFR-010` to require executable storage consumers to resolve registry metadata instead of hard-coding artifact kinds or paths.
+
+## [5.0.0] -- 2026-07-22
+
+Bundle `schema_version` bumped to **5** and manifest version to **5.0** to reflect breaking relationship renames and parent-rule changes below.
+
+### Added
+
+- **`practice` node kind** in the Practices wing (RIC-1273). A bundle node that sits between `practice_area` and standards/methods/competencies/tools, enabling strict nesting: `practice_area` → `practice` → `{standard, method, competency, tool}`. Practices are assignable units that reference (do not own) standards and methods.
+- **`INCLUDES_PRACTICE` relationship** (`practice_area` → `practice`): grouping edge for the new strict nesting hierarchy.
+- **`PRESCRIBES_STANDARD` / `PRESCRIBES_METHOD` relationships** (`practice` → `standard` / `method`): practice prescribes which standards and methods it bundles.
+- **`ADHERES_TO_PRACTICE` / `ADHERES_TO_STANDARD` / `ADHERES_TO_METHOD` relationships**: assignment edges allowing consumer nodes (system, stack, layer, library, tool, organization, project, team) to declare which practices, standards, and methods they follow.
+- **Practice assignment fields** (`practices`, `standards`, `methods`) spliced into 8 consumer ("follower") node kinds via shared `_practice_refs.py` helper.
+- **`metric_definition`, `signal_source`, `threshold_profile` node kinds** in the new Metrics wing (RIC-1272). Brings the bundle to **36 node types across 8 wings**.
+
+### Changed
+
+- **BREAKING: `competency` re-parented from `practice_area` to `practice`** (RIC-1273). The `ParentRule.allowed_parent_kinds` changed from `{"practice_area"}` to `{"practice"}`. Any existing `competency` instances parented under a `practice_area` must be re-parented under a `practice` node. No known consuming taxonomies have competency instances.
+- **BREAKING: Relationship renames** (RIC-1273). The following relationship types were renamed for naming consistency (all edge families now use verb-first, actor-centric naming):
+  - `INCLUDES_METHOD` / `INCLUDES_STANDARD` → removed (replaced by `PRESCRIBES_STANDARD` / `PRESCRIBES_METHOD` on the new `practice` node)
+  - Assignment family unified: `FOLLOWS_PRACTICE` → `ADHERES_TO_PRACTICE`, `APPLIES_METHOD` → `ADHERES_TO_METHOD` (`ADHERES_TO_STANDARD` unchanged)
+- **`standard` and `method` relocated from Design wing to Practices wing** (RIC-1273). `nfr` is now a child of `standard`; `adr` is now a child of `method`. Design wing shrinks from 8 → 6 kinds; Practices wing grows from 4 → 9 kinds.
+
+### Migration
+
+Consuming taxonomies that reference the removed/renamed relationship types in cross-references or queries must update:
+
+| Old | New |
+|-----|-----|
+| `INCLUDES_METHOD` | `PRESCRIBES_METHOD` (on `practice`, not `practice_area`) |
+| `INCLUDES_STANDARD` | `PRESCRIBES_STANDARD` (on `practice`, not `practice_area`) |
+| `FOLLOWS_PRACTICE` | `ADHERES_TO_PRACTICE` |
+| `APPLIES_METHOD` | `ADHERES_TO_METHOD` |
+| `competency` parented under `practice_area` | Re-parent under `practice` |
+| `nfr` / `adr` in design wing | Now in practices wing (no YAML change needed; wing is metadata) |
+
 ## [4.2.0] -- 2026-07-06
 
 Repo split (RIC-1070). First release from the standalone

{katalyst_forge-4.2.0 → katalyst_forge-5.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: katalyst-forge
-Version: 4.2.0
+Version: 5.1.0
 Summary: Katalyst Forge: the delivery-lifecycle bundle (node kinds, wings, agents, templates, schemas)
 Author: eSimplicity
 License: Proprietary

{katalyst_forge-4.2.0 → katalyst_forge-5.1.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "katalyst-forge"
-version = "4.2.0"
+version = "5.1.0"
 description = "Katalyst Forge: the delivery-lifecycle bundle (node kinds, wings, agents, templates, schemas)"
 license = { text = "Proprietary" }
 requires-python = ">=3.12"

{katalyst_forge-4.2.0 → katalyst_forge-5.1.0}/src/katalyst_forge/__init__.py

@@ -1,6 +1,6 @@
 """katalyst-forge — The Forge bundle for katalyst-engine.
 
-Provides 33 node-type definitions across 8 wings for software delivery taxonomy.
+Provides 36 node-type definitions across 8 wings for software delivery taxonomy.
 """
 
 from __future__ import annotations

{katalyst_forge-4.2.0 → katalyst_forge-5.1.0}/src/katalyst_forge/bundle.py

@@ -1,6 +1,6 @@
 """Forge bundle — the pre-installed taxonomy for software delivery.
 
-Assembles 34 node types across 8 wings from the wing modules into
+Assembles 36 node types across 8 wings from the wing modules into
 a single ``ForgeBundle`` that implements the engine's ``Bundle``
 protocol. Discovered via the ``katalyst_engine.bundles`` entry point.
 
@@ -9,12 +9,13 @@ protocol. Discovered via the ``katalyst_engine.bundles`` entry point.
 Wing modules:
 - ``wings/system.py``    — system, environment, stack, layer, library, capability
 - ``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/practices.py``  — practice_area, practice, competency, skill, standard, nfr, method, adr, tool
+- ``wings/design.py``    — business_domain_model, user_type, user_need, design_spec, specification, assertion
 - ``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
+- ``wings/metrics.py``   — metric_definition, signal_source, threshold_profile
 """
 
 from __future__ import annotations
@@ -36,6 +37,7 @@ from katalyst_forge.relationships import ALL_RELATIONSHIP_DEFINITIONS
 from katalyst_forge.wings.agentic import AGENTIC_WING, AGENTIC_WING_NODES
 from katalyst_forge.wings.delivery import DELIVERY_WING, DELIVERY_WING_NODES
 from katalyst_forge.wings.design import DESIGN_WING, DESIGN_WING_NODES
+from katalyst_forge.wings.metrics import METRICS_WING, METRICS_WING_NODES
 from katalyst_forge.wings.org import ORG_WING, ORG_WING_NODES
 from katalyst_forge.wings.pipeline import PIPELINE_WING, PIPELINE_WING_NODES
 from katalyst_forge.wings.practices import PRACTICES_WING, PRACTICES_WING_NODES
@@ -53,6 +55,7 @@ ALL_NODE_DEFINITIONS: list[NodeDefinition] = [
     *DELIVERY_WING_NODES,
     *PIPELINE_WING_NODES,
     *AGENTIC_WING_NODES,
+    *METRICS_WING_NODES,
 ]
 
 ALL_KINDS: frozenset[str] = frozenset(nd.describes_kind for nd in ALL_NODE_DEFINITIONS)
@@ -65,6 +68,7 @@ ALL_WING_DEFINITIONS: list[WingDefinition] = [
     PRACTICES_WING,
     PIPELINE_WING,
     AGENTIC_WING,
+    METRICS_WING,
 ]
 
 ALL_WING_NAMES: frozenset[str] = frozenset(wd.identity.name for wd in ALL_WING_DEFINITIONS)
@@ -76,7 +80,7 @@ ALL_WING_NAMES: frozenset[str] = frozenset(wd.identity.name for wd in ALL_WING_D
 
 
 class ForgeBundle:
-    """The Forge bundle — 34 node types across 8 wings.
+    """The Forge bundle — 36 node types across 8 wings.
 
     This is the pre-installed taxonomy bundle that ships with
     Katalyst Taxonomy. It models software delivery organizations
@@ -89,10 +93,10 @@ class ForgeBundle:
     def manifest(self) -> BundleManifest:
         return BundleManifest(
             identity=Identity(kind="bundle", name="forge"),
-            version=Version(major=4, minor=0),
+            version=Version(major=5, minor=1),
             provided_kinds=ALL_KINDS,
             wing_names=ALL_WING_NAMES,
-            description="Forge taxonomy — 30 node types for modeling software delivery organizations",
+            description="Forge taxonomy — 36 node types for modeling software delivery organizations",
         )
 
     def node_definitions(self) -> list[NodeDefinition]:
@@ -109,7 +113,7 @@ class ForgeBundle:
             identity=Identity(kind="schema", name="forge"),
             describes_kind="taxonomy",
             api_version="v2alpha",
-            schema_version=Version(major=4),
+            schema_version=Version(major=5),
             node_definitions=tuple(nd.identity for nd in ALL_NODE_DEFINITIONS),
             wing_definitions=tuple(wd.identity for wd in ALL_WING_DEFINITIONS),
         )

{katalyst_forge-4.2.0 → katalyst_forge-5.1.0}/src/katalyst_forge/relationships.py

@@ -127,16 +127,25 @@ FILLED_BY_REL = RelationshipDefinition(
 DEVELOPS_COMPETENCY_REL = RelationshipDefinition(
     identity=_rel_id("develops_competency"),
     describes_kind="develops_competency",
-    description="Practice area develops a competency",
+    description="Practice develops a competency",
     wing="organizational",
     display_order=210,
     cardinality=Cardinality.MANY_TO_MANY,
 )
 
+INCLUDES_PRACTICE_REL = RelationshipDefinition(
+    identity=_rel_id("includes_practice"),
+    describes_kind="includes_practice",
+    description="Practice area includes a practice",
+    wing="organizational",
+    display_order=214,
+    cardinality=Cardinality.MANY_TO_MANY,
+)
+
 USES_TOOL_REL = RelationshipDefinition(
     identity=_rel_id("uses_tool"),
     describes_kind="uses_tool",
-    description="Practice area uses a tool",
+    description="Practice uses a tool",
     wing="organizational",
     display_order=220,
     cardinality=Cardinality.MANY_TO_MANY,
@@ -151,6 +160,55 @@ REQUIRES_SKILL_REL = RelationshipDefinition(
     cardinality=Cardinality.MANY_TO_MANY,
 )
 
+# ── Practice prescribing (practice → standard/method, referenced not owned) ──
+
+PRESCRIBES_STANDARD_REL = RelationshipDefinition(
+    identity=_rel_id("prescribes_standard"),
+    describes_kind="prescribes_standard",
+    description="Practice prescribes a standard",
+    wing="organizational",
+    display_order=231,
+    cardinality=Cardinality.MANY_TO_MANY,
+)
+
+PRESCRIBES_METHOD_REL = RelationshipDefinition(
+    identity=_rel_id("prescribes_method"),
+    describes_kind="prescribes_method",
+    description="Practice prescribes a method",
+    wing="organizational",
+    display_order=232,
+    cardinality=Cardinality.MANY_TO_MANY,
+)
+
+# ── Practice assignment (consumer node → practice/standard/method) ────────
+
+ADHERES_TO_PRACTICE_REL = RelationshipDefinition(
+    identity=_rel_id("adheres_to_practice"),
+    describes_kind="adheres_to_practice",
+    description="A node adheres to a practice",
+    wing="organizational",
+    display_order=233,
+    cardinality=Cardinality.MANY_TO_MANY,
+)
+
+ADHERES_TO_STANDARD_REL = RelationshipDefinition(
+    identity=_rel_id("adheres_to_standard"),
+    describes_kind="adheres_to_standard",
+    description="A node adheres to a standard",
+    wing="organizational",
+    display_order=234,
+    cardinality=Cardinality.MANY_TO_MANY,
+)
+
+ADHERES_TO_METHOD_REL = RelationshipDefinition(
+    identity=_rel_id("adheres_to_method"),
+    describes_kind="adheres_to_method",
+    description="A node adheres to a method",
+    wing="organizational",
+    display_order=235,
+    cardinality=Cardinality.MANY_TO_MANY,
+)
+
 # ── Verification wing ────────────────────────────────────────────────
 
 VERIFIED_BY_REL = RelationshipDefinition(
@@ -249,7 +307,7 @@ 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 "
+        "Work item traces to a design- or practices-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."
@@ -297,8 +355,14 @@ ALL_RELATIONSHIP_DEFINITIONS: list[RelationshipDefinition] = [
     # organizational
     FILLED_BY_REL,
     DEVELOPS_COMPETENCY_REL,
+    INCLUDES_PRACTICE_REL,
     USES_TOOL_REL,
     REQUIRES_SKILL_REL,
+    PRESCRIBES_STANDARD_REL,
+    PRESCRIBES_METHOD_REL,
+    ADHERES_TO_PRACTICE_REL,
+    ADHERES_TO_STANDARD_REL,
+    ADHERES_TO_METHOD_REL,
     # verification
     VERIFIED_BY_REL,
     TESTS_SPECIFICATION_REL,

katalyst_forge-5.1.0/src/katalyst_forge/wings/_practice_refs.py

@@ -0,0 +1,58 @@
+"""Shared practice-reference fields for consumer ("follower") node kinds.
+
+Any node that can *follow* a practice, *adhere to* a standard, or *apply* a
+method carries the same three cross-reference fields. Rather than duplicate the
+identical ``FieldSpec``/``FieldRef`` blocks across every follower kind in the
+``system``, ``org``, and ``practices`` wings, they are defined once here and
+spliced into each follower's ``fields`` / ``cross_references`` tuples.
+
+These edges are the *assignment* side of practices — semantically distinct from
+the *grouping* edges (``INCLUDES_PRACTICE`` on ``practice_area``;
+``PRESCRIBES_STANDARD`` / ``PRESCRIBES_METHOD`` on ``practice``). A follower "adheres
+to" a standard; a practice "prescribes" one; a practice_area "includes" a practice.
+"""
+
+from __future__ import annotations
+
+from katalyst_engine.schema.definition import FieldRef, FieldSpec
+
+#: Fields spliced into every follower kind's ``fields`` tuple.
+PRACTICE_REFERENCE_FIELDS: tuple[FieldSpec, ...] = (
+    FieldSpec(
+        name="practices",
+        field_type="list",
+        required=False,
+        description="Practices this node follows",
+    ),
+    FieldSpec(
+        name="standards",
+        field_type="list",
+        required=False,
+        description="Standards this node adheres to",
+    ),
+    FieldSpec(
+        name="methods",
+        field_type="list",
+        required=False,
+        description="Methods this node applies",
+    ),
+)
+
+#: Cross-references spliced into every follower kind's ``cross_references``.
+PRACTICE_REFERENCE_CROSS_REFS: tuple[FieldRef, ...] = (
+    FieldRef(
+        field_name="practices",
+        target_kind="practice",
+        rel_type="ADHERES_TO_PRACTICE",
+    ),
+    FieldRef(
+        field_name="standards",
+        target_kind="standard",
+        rel_type="ADHERES_TO_STANDARD",
+    ),
+    FieldRef(
+        field_name="methods",
+        target_kind="method",
+        rel_type="ADHERES_TO_METHOD",
+    ),
+)

{katalyst_forge-4.2.0 → katalyst_forge-5.1.0}/src/katalyst_forge/wings/design.py

@@ -1,4 +1,8 @@
-"""Design wing — business_domain_model, user_type, user_need, design_spec, adr, nfr, specification, assertion."""
+"""Design wing — business_domain_model, user_type, user_need, design_spec, specification, assertion.
+
+Note: ADR and NFR have been moved to the practices wing where they are
+subclasses of method and standard respectively.
+"""
 
 from __future__ import annotations
 
@@ -296,116 +300,6 @@ DESIGN_SPEC: NodeDefinition = NodeDefinition(
     ),
 )
 
-ADR: NodeDefinition = NodeDefinition(
-    identity=Identity(kind="node_definition", name="adr"),
-    describes_kind="adr",
-    wing="design",
-    display_order=380,
-    directory_name="adrs",
-    is_root=True,
-    is_leaf=True,
-    is_extension=False,
-    clonable=False,
-    display_label="ADR",
-    display_label_plural="ADRs",
-    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="category",
-            field_type="string",
-            required=False,
-            description="",
-        ),
-        FieldSpec(
-            name="scope",
-            field_type="string",
-            required=False,
-            description="Scope of the decision",
-        ),
-        FieldSpec(
-            name="superseded_by",
-            field_type="string",
-            required=False,
-            description="Name of the ADR that supersedes this one",
-        ),
-    ),
-    cross_references=(
-        FieldRef(
-            field_name="superseded_by",
-            target_kind="adr",
-            rel_type="SUPERSEDED_BY",
-        ),
-    ),
-)
-
-NFR: NodeDefinition = NodeDefinition(
-    identity=Identity(kind="node_definition", name="nfr"),
-    describes_kind="nfr",
-    wing="design",
-    display_order=390,
-    directory_name="nfrs",
-    is_root=True,
-    is_leaf=True,
-    is_extension=False,
-    clonable=False,
-    display_label="NFR",
-    display_label_plural="NFRs",
-    extends_kinds=(),
-    parent_rules=(),
-    fields=(
-        FieldSpec(
-            name="title",
-            field_type="string",
-            required=False,
-            description="",
-        ),
-        FieldSpec(
-            name="category",
-            field_type="string",
-            required=False,
-            description="",
-        ),
-        FieldSpec(
-            name="priority",
-            field_type="string",
-            required=False,
-            description="",
-        ),
-        FieldSpec(
-            name="status",
-            field_type="string",
-            required=False,
-            description="",
-        ),
-        FieldSpec(
-            name="threshold",
-            field_type="string",
-            required=False,
-            description="Measurable threshold (e.g., p99 < 200ms)",
-        ),
-        FieldSpec(
-            name="measurement",
-            field_type="string",
-            required=False,
-            description="How this NFR is measured",
-        ),
-    ),
-    cross_references=(),
-)
-
 SPECIFICATION: NodeDefinition = NodeDefinition(
     identity=Identity(kind="node_definition", name="specification"),
     describes_kind="specification",
@@ -545,8 +439,6 @@ DESIGN_WING: WingDefinition = WingDefinition(
         "user_type",
         "user_need",
         "design_spec",
-        "adr",
-        "nfr",
         "specification",
         "assertion",
     ),
@@ -557,8 +449,6 @@ DESIGN_WING_NODES = [
     USER_TYPE,
     USER_NEED,
     DESIGN_SPEC,
-    ADR,
-    NFR,
     SPECIFICATION,
     ASSERTION,
 ]

katalyst_forge-5.1.0/src/katalyst_forge/wings/metrics.py

@@ -0,0 +1,197 @@
+"""Metrics wing — metric_definition, signal_source, threshold_profile."""
+
+from __future__ import annotations
+
+from katalyst_engine.core.identity import Identity
+from katalyst_engine.schema.definition import (
+    FieldRef,
+    FieldSpec,
+    NodeDefinition,
+    WingDefinition,
+)
+
+METRIC_DEFINITION: NodeDefinition = NodeDefinition(
+    identity=Identity(kind="node_definition", name="metric_definition"),
+    describes_kind="metric_definition",
+    wing="metrics",
+    display_order=700,
+    directory_name="metric_definitions",
+    is_root=True,
+    is_leaf=True,
+    is_extension=False,
+    clonable=True,
+    display_label="Metric Definition",
+    display_label_plural="Metric Definitions",
+    extends_kinds=(),
+    parent_rules=(),
+    fields=(
+        FieldSpec(
+            name="title",
+            field_type="string",
+            required=False,
+            description="",
+        ),
+        FieldSpec(
+            name="description",
+            field_type="string",
+            required=False,
+            description="",
+        ),
+        FieldSpec(
+            name="category",
+            field_type="string",
+            required=False,
+            description="Metric category (throughput, stability, speed, recovery)",
+        ),
+        FieldSpec(
+            name="unit",
+            field_type="string",
+            required=False,
+            description="Measurement unit (deploys/day, hours, percentage)",
+        ),
+        FieldSpec(
+            name="direction",
+            field_type="string",
+            required=False,
+            description="Optimization direction (higher_is_better, lower_is_better)",
+        ),
+        FieldSpec(
+            name="aggregation",
+            field_type="string",
+            required=False,
+            description="Aggregation method (count_per_period, median_duration, ratio, mean_duration)",
+        ),
+        FieldSpec(
+            name="inputs",
+            field_type="list",
+            required=False,
+            description="Named inputs the metric formula requires",
+        ),
+        FieldSpec(
+            name="default_parameters",
+            field_type="map",
+            required=False,
+            description="Default configuration parameters for computation",
+        ),
+    ),
+    cross_references=(),
+)
+
+SIGNAL_SOURCE: NodeDefinition = NodeDefinition(
+    identity=Identity(kind="node_definition", name="signal_source"),
+    describes_kind="signal_source",
+    wing="metrics",
+    display_order=710,
+    directory_name="signal_sources",
+    is_root=True,
+    is_leaf=True,
+    is_extension=False,
+    clonable=True,
+    display_label="Signal Source",
+    display_label_plural="Signal Sources",
+    extends_kinds=(),
+    parent_rules=(),
+    fields=(
+        FieldSpec(
+            name="title",
+            field_type="string",
+            required=False,
+            description="",
+        ),
+        FieldSpec(
+            name="description",
+            field_type="string",
+            required=False,
+            description="",
+        ),
+        FieldSpec(
+            name="provider",
+            field_type="string",
+            required=True,
+            description="Signal provider (github, gitlab, argocd, pagerduty, custom)",
+        ),
+        FieldSpec(
+            name="signal_type",
+            field_type="string",
+            required=True,
+            description="Type of signal (deployment_event, failure_event, recovery_event, change_event)",
+        ),
+        FieldSpec(
+            name="query_config",
+            field_type="map",
+            required=False,
+            description="Provider-specific query parameters",
+        ),
+        FieldSpec(
+            name="field_mapping",
+            field_type="map",
+            required=False,
+            description="Maps provider fields to canonical metric input fields",
+        ),
+        FieldSpec(
+            name="metric_ref",
+            field_type="string",
+            required=False,
+            description="Name of the metric_definition this source feeds",
+        ),
+    ),
+    cross_references=(
+        FieldRef(
+            field_name="metric_ref",
+            target_kind="metric_definition",
+            rel_type="FEEDS_METRIC",
+        ),
+    ),
+)
+
+THRESHOLD_PROFILE: NodeDefinition = NodeDefinition(
+    identity=Identity(kind="node_definition", name="threshold_profile"),
+    describes_kind="threshold_profile",
+    wing="metrics",
+    display_order=720,
+    directory_name="threshold_profiles",
+    is_root=True,
+    is_leaf=True,
+    is_extension=False,
+    clonable=True,
+    display_label="Threshold Profile",
+    display_label_plural="Threshold Profiles",
+    extends_kinds=(),
+    parent_rules=(),
+    fields=(
+        FieldSpec(
+            name="title",
+            field_type="string",
+            required=False,
+            description="",
+        ),
+        FieldSpec(
+            name="description",
+            field_type="string",
+            required=False,
+            description="",
+        ),
+        FieldSpec(
+            name="scoped_to",
+            field_type="list",
+            required=False,
+            description="Systems or teams this profile applies to (empty = global default)",
+        ),
+        FieldSpec(
+            name="metric_thresholds",
+            field_type="list",
+            required=False,
+            description="Per-metric band definitions with operator and value",
+        ),
+    ),
+    cross_references=(),
+)
+
+METRICS_WING: WingDefinition = WingDefinition(
+    identity=Identity(kind="wing_definition", name="metrics"),
+    describes_kind="metrics",
+    display_name="Metrics",
+    member_kinds=("metric_definition", "signal_source", "threshold_profile"),
+)
+
+METRICS_WING_NODES = [METRIC_DEFINITION, SIGNAL_SOURCE, THRESHOLD_PROFILE]