@sdd-method/sdd-cli 1.20.1 → 1.22.0

package/dist/lib/catalogue/rubric-coverage-map.yaml

@@ -1,300 +1,620 @@
-# Rubric coverage map — the scoring disposition of every key the canonical
-# catalogue schema declares (enums included, so the extraction is mechanical).
-#
-# This file IS the coverage claim of catalogue-rubric-coverage.md, held against
-# the schema by the entity-scoring-coverage correspondence instance: a catalogue
-# class added to the schema without an entry here fails that instance, so
-# "no rubric" can never again be indistinguishable from "nobody asked".
-#
-# kind: entity | edge | finding | enum — declared here because the schema does
-# not carry it (68 of 69 tables share primary_key: id; the 24/45 split was
-# hand classification until this file). Consumers needing node-vs-edge kind
-# (graph projection, per-class predicates) read it from here.
-#
-# scoring: rubric | rubric-pair | predicate | scored-at-source | re-targeted
-#          | not-applicable | derived-edge | not-built
-#
-# Relationship semantics (M-ADR 0206) — a SECOND vocabulary, distinct from
-# scoring. `scoring: derived-edge` is a SCORING-ATTRIBUTION claim (where the
-# quality judgment lives); it is NOT a build-provenance or semantics claim —
-# conflating the two misdiagnosed the mirror families once already. The
-# semantics are:
-#   class: membership | dependency | realisation | lineage | traceability
-#          | xref | attribute            — what the relationship MEANS (for
-#                                          humans and review)
-#   impact_flow: toward-source | toward-target | both | none
-#          — which endpoint RECEIVES impact (the machine-read token):
-#            toward-source = a change at the target propagates to the source;
-#            toward-target = a change at the source propagates to the target.
-#            Declared PER RELATIONSHIP, not per class: declaration orientation
-#            is a per-builder historical accident (composition exists both as
-#            member->owner features.product_id and owner->member
-#            screen_component).
-#   impact_flow_by: { column: <name>, values: {...} } — the role-conditional
-#          form, mutually exclusive with impact_flow; admitted for measured
-#          need (today exactly one relationship: service_event).
-# Edge catalogues carry class + impact_flow at the top level; entity
-# catalogues carry a relationships: block keyed by FK column. `applications`
-# inherits `products`' declarations through the schema's YAML merge and is
-# deliberately not declared separately. Every parsed FK column and edge
-# catalogue MUST carry a declaration — check-relationship-classes.sh holds
-# this closed in both directions, and sdd-cli's vendored-map test mirrors it.
-
+# GENERATED — DO NOT EDIT. This file is a projection of the authored model (M-ADR 0210 §4.6, flip 2):
+#   docs/method/foundations/schemas/catalogue-schema-meta.tql — coverage-meta + relationship-meta rows carry
+#   every entry here; the relations themselves (roles, players) are in catalogue-schema.tql.
+# Regenerate:  python3 orchestration/scripts/check-catalogue-schema-roundtrip.py --write
+# Guard:       python3 orchestration/scripts/check-catalogue-schema-roundtrip.py   (any difference fails the build)
+# Vocabularies, rulings and the reading of each token live in the authored .tql header, as comments.
 coverage:
-  c4_system_kind: { kind: enum, scoring: not-applicable, reason: "closed vocabulary, not an artefact" }
-  c4_container_type: { kind: enum, scoring: not-applicable, reason: "closed vocabulary, not an artefact" }
-  service_type: { kind: enum, scoring: not-applicable, reason: "closed vocabulary, not an artefact" }
-  capability_exemption_reason: { kind: enum, scoring: not-applicable, reason: "closed vocabulary, not an artefact" }
-  service_capability_exemption_reason: { kind: enum, scoring: not-applicable, reason: "closed vocabulary, not an artefact" }
-  external_system_exemption_reason: { kind: enum, scoring: not-applicable, reason: "closed vocabulary, not an artefact" }
-  capability_service_role: { kind: enum, scoring: not-applicable, reason: "closed vocabulary, not an artefact" }
+  c4_system_kind:
+    kind: enum
+    scoring: not-applicable
+    reason: closed vocabulary, not an artefact
+  c4_container_type:
+    kind: enum
+    scoring: not-applicable
+    reason: closed vocabulary, not an artefact
+  service_type:
+    kind: enum
+    scoring: not-applicable
+    reason: closed vocabulary, not an artefact
+  capability_exemption_reason:
+    kind: enum
+    scoring: not-applicable
+    reason: closed vocabulary, not an artefact
+  service_capability_exemption_reason:
+    kind: enum
+    scoring: not-applicable
+    reason: closed vocabulary, not an artefact
+  external_system_exemption_reason:
+    kind: enum
+    scoring: not-applicable
+    reason: closed vocabulary, not an artefact
+  capability_service_role:
+    kind: enum
+    scoring: not-applicable
+    reason: closed vocabulary, not an artefact
   domains:
     kind: entity
     scoring: not-applicable
-    instrument: "directory discovery; only the README first paragraph is authored — nothing to score"
+    instrument: directory discovery; only the README first paragraph is authored — nothing to score
   products:
     kind: entity
     scoring: rubric-pair
-    instrument: "forward: rubrics/product-definition-rubric.md · reverse: reverse/rubrics/product-synthesis-quality.md"
+    instrument: 'forward: rubrics/product-definition-rubric.md · reverse: reverse/rubrics/product-synthesis-quality.md'
     relationships:
-      domain_id: { class: membership, impact_flow: toward-target }
+      domain_id:
+        class: membership
+        impact_flow: toward-target
   applications:
     kind: entity
     scoring: not-applicable
-    instrument: "YAML-anchor view of products; scored there"
+    instrument: YAML-anchor view of products; scored there
   integrations:
     kind: entity
     scoring: rubric
-    instrument: "rubrics/integration-sdd-quality-rubric.md"
+    instrument: rubrics/integration-sdd-quality-rubric.md
     relationships:
-      domain_id: { class: membership, impact_flow: toward-target }
-      parent_product_id: { class: membership, impact_flow: toward-target }
+      domain_id:
+        class: membership
+        impact_flow: toward-target
+      parent_product_id:
+        class: membership
+        impact_flow: toward-target
   integration_component:
     kind: entity
     scoring: rubric
-    instrument: "scored at the owning integration via rubrics/integration-sdd-quality-rubric.md (manifest block)"
+    instrument: scored at the owning integration via rubrics/integration-sdd-quality-rubric.md (manifest block)
     relationships:
-      integration_id: { class: membership, impact_flow: toward-target }
+      integration_id:
+        class: membership
+        impact_flow: toward-target
   adrs:
     kind: entity
     scoring: rubric-pair
-    instrument: "forward: rubrics/adr-quality-rubric.md · reverse: reverse/rubrics/reverse-adr-quality.md"
+    instrument: 'forward: rubrics/adr-quality-rubric.md · reverse: reverse/rubrics/reverse-adr-quality.md'
     relationships:
-      domain_id: { class: membership, impact_flow: toward-target }
-      superseded_by_id: { class: lineage, impact_flow: none }
+      domain_id:
+        class: membership
+        impact_flow: toward-target
+      superseded_by_id:
+        class: lineage
+        impact_flow: none
   glossary_items:
     kind: entity
     scoring: rubric-pair
-    instrument: "forward: rubrics/glossary-rubric.md · reverse: reverse/rubrics/reverse-glossary-quality.md"
+    instrument: 'forward: rubrics/glossary-rubric.md · reverse: reverse/rubrics/reverse-glossary-quality.md'
     relationships:
-      owning_domain_id: { class: membership, impact_flow: toward-target }
-      canonical_term_id: { class: xref, impact_flow: toward-source }
-  glossary_xref: { kind: edge, class: xref, impact_flow: none, scoring: derived-edge, reason: "derived from entity rows or manifest blocks scored at the owning entity" }
-  entity_glossary: { kind: edge, class: xref, impact_flow: none, scoring: derived-edge, reason: "derived from entity rows or manifest blocks scored at the owning entity" }
+      owning_domain_id:
+        class: membership
+        impact_flow: toward-target
+      canonical_term_id:
+        class: xref
+        impact_flow: toward-source
+  glossary_xref:
+    kind: edge
+    class: xref
+    impact_flow: none
+    scoring: derived-edge
+    reason: derived from entity rows or manifest blocks scored at the owning entity
+  entity_glossary:
+    kind: edge
+    class: xref
+    impact_flow: none
+    scoring: derived-edge
+    reason: derived from entity rows or manifest blocks scored at the owning entity
   services:
     kind: entity
     scoring: re-targeted
-    instrument: "deliberately no dedicated rubric: boundary scored by rubrics/domain-architecture-rubric.md B5/B9 against the declared set (repo-config, input 3); source absence by scripts/check-repo-config-coverage.sh; reverse doc form by reverse/rubrics/repo-doc-quality.md"
+    instrument: 'deliberately no dedicated rubric: boundary scored by rubrics/domain-architecture-rubric.md B5/B9 against the declared set (repo-config, input 3); source absence by scripts/check-repo-config-coverage.sh; reverse doc form by reverse/rubrics/repo-doc-quality.md'
     relationships:
-      product_id: { class: membership, impact_flow: toward-target }
-      domain_id: { class: membership, impact_flow: toward-target }
-      primary_repo_id: { class: realisation, impact_flow: both }
+      product_id:
+        class: membership
+        impact_flow: toward-target
+      domain_id:
+        class: membership
+        impact_flow: toward-target
+      primary_repo_id:
+        class: realisation
+        impact_flow: both
   capabilities:
     kind: entity
     scoring: rubric-pair
-    instrument: "forward: rubrics/intent-quality-rubric.md · reverse: reverse/rubrics/reverse-capability-spec-quality.md"
+    instrument: 'forward: rubrics/intent-quality-rubric.md · reverse: reverse/rubrics/reverse-capability-spec-quality.md'
     relationships:
-      domain_id: { class: membership, impact_flow: toward-target }
-      parent_capability_id: { class: membership, impact_flow: toward-target }
+      domain_id:
+        class: membership
+        impact_flow: toward-target
+      parent_capability_id:
+        class: membership
+        impact_flow: toward-target
   feature_groups:
     kind: entity
     scoring: scored-at-source
-    instrument: "grouping is authored inside capability/feature specs; scored there by rubrics/intent-quality-rubric.md"
+    instrument: grouping is authored inside capability/feature specs; scored there by rubrics/intent-quality-rubric.md
     relationships:
-      product_id: { class: membership, impact_flow: toward-target }
-      capability_id: { class: membership, impact_flow: toward-target }
-      parent_group_id: { class: membership, impact_flow: toward-target }
+      product_id:
+        class: membership
+        impact_flow: toward-target
+      capability_id:
+        class: membership
+        impact_flow: toward-target
+      parent_group_id:
+        class: membership
+        impact_flow: toward-target
   features:
     kind: entity
     scoring: rubric-pair
-    instrument: "forward: rubrics/intent-quality-rubric.md (feature tier) + rubrics/feature-grounding-rubric.md · reverse: reverse/rubrics/reverse-feature-grounding-quality.md"
+    instrument: 'forward: rubrics/intent-quality-rubric.md (feature tier) + rubrics/feature-grounding-rubric.md · reverse: reverse/rubrics/reverse-feature-grounding-quality.md'
     relationships:
-      product_id: { class: membership, impact_flow: toward-target }
-      capability_id: { class: membership, impact_flow: toward-target }
-      parent_group_id: { class: membership, impact_flow: toward-target }
-      parent_feature_id: { class: membership, impact_flow: toward-target }
+      product_id:
+        class: membership
+        impact_flow: toward-target
+      capability_id:
+        class: membership
+        impact_flow: toward-target
+      parent_group_id:
+        class: membership
+        impact_flow: toward-target
+      parent_feature_id:
+        class: membership
+        impact_flow: toward-target
   personas:
     kind: entity
     scoring: rubric-pair
-    instrument: "forward: rubrics/persona-rubric.md · reverse: reverse/rubrics/reverse-persona-quality.md"
+    instrument: 'forward: rubrics/persona-rubric.md · reverse: reverse/rubrics/reverse-persona-quality.md'
     relationships:
-      product_id: { class: membership, impact_flow: toward-target }
+      product_id:
+        class: membership
+        impact_flow: toward-target
   user_journeys:
     kind: entity
     scoring: rubric
-    instrument: "rubrics/user-journey-rubric.md"
+    instrument: rubrics/user-journey-rubric.md
     relationships:
-      product_id: { class: membership, impact_flow: toward-target }
+      product_id:
+        class: membership
+        impact_flow: toward-target
   contracts:
     kind: entity
     scoring: rubric-pair
-    instrument: "forward: rubrics/contract-quality-rubric.md · reverse: reverse/rubrics/reverse-contract-quality.md"
+    instrument: 'forward: rubrics/contract-quality-rubric.md · reverse: reverse/rubrics/reverse-contract-quality.md'
     relationships:
-      service_id: { class: membership, impact_flow: toward-target }
-      source_repo_id: { class: lineage, impact_flow: toward-source }
+      service_id:
+        class: membership
+        impact_flow: toward-target
+      source_repo_id:
+        class: lineage
+        impact_flow: toward-source
   events:
     kind: entity
     scoring: predicate
-    instrument: "event-catalogue + event coverage checks (sdd-cli catalogue validate --coverage) — absence class; content rides the contract rubrics where events have contracts"
+    instrument: event-catalogue + event coverage checks (sdd-cli catalogue validate --coverage) — absence class; content rides the contract rubrics where events have contracts
     relationships:
-      publisher_service_id: { class: dependency, impact_flow: toward-source }
-      domain_id: { class: membership, impact_flow: toward-target }
+      publisher_service_id:
+        class: dependency
+        impact_flow: toward-source
+      domain_id:
+        class: membership
+        impact_flow: toward-target
   c4_systems:
     kind: entity
     scoring: rubric-pair
-    instrument: "rubrics/c4-diagram-rubric.md (L1 per the level table) · reverse/rubrics/reverse-c4-quality.md"
+    instrument: rubrics/c4-diagram-rubric.md (L1 per the level table) · reverse/rubrics/reverse-c4-quality.md
     relationships:
-      product_id: { class: realisation, impact_flow: both }
+      product_id:
+        class: realisation
+        impact_flow: both
   c4_containers:
     kind: entity
     scoring: rubric-pair
-    instrument: "rubrics/c4-diagram-rubric.md (L2) · reverse/rubrics/reverse-c4-quality.md"
+    instrument: rubrics/c4-diagram-rubric.md (L2) · reverse/rubrics/reverse-c4-quality.md
     relationships:
-      system_id: { class: membership, impact_flow: toward-target }
-      domain_id: { class: membership, impact_flow: toward-target }
-      service_id: { class: realisation, impact_flow: both }
+      system_id:
+        class: membership
+        impact_flow: toward-target
+      domain_id:
+        class: membership
+        impact_flow: toward-target
+      service_id:
+        class: realisation
+        impact_flow: both
   c4_components:
     kind: entity
     scoring: rubric-pair
-    instrument: "rubrics/c4-diagram-rubric.md (L3 per the level table) · reverse/rubrics/reverse-c4-quality.md (L3 section)"
+    instrument: rubrics/c4-diagram-rubric.md (L3 per the level table) · reverse/rubrics/reverse-c4-quality.md (L3 section)
     relationships:
-      container_id: { class: membership, impact_flow: toward-target }
-      service_id: { class: realisation, impact_flow: both }
+      container_id:
+        class: membership
+        impact_flow: toward-target
+      service_id:
+        class: realisation
+        impact_flow: both
   c4_external_systems:
     kind: entity
     scoring: scored-at-source
-    instrument: "externality is scored inside the c4 rubrics (D4 / dimension 6); rows derive from System_Ext elements"
+    instrument: externality is scored inside the c4 rubrics (D4 / dimension 6); rows derive from System_Ext elements
   repositories:
     kind: entity
     scoring: predicate
-    instrument: "deliberately no rubric: repo-config is four structural fields; scripts/check-repo-config-coverage.sh covers the silent absences, builder findings own enum/orphan/divergence"
+    instrument: 'deliberately no rubric: repo-config is four structural fields; scripts/check-repo-config-coverage.sh covers the silent absences, builder findings own enum/orphan/divergence'
     relationships:
-      domain_id: { class: membership, impact_flow: toward-target }
-      product_id: { class: membership, impact_flow: toward-target }
+      domain_id:
+        class: membership
+        impact_flow: toward-target
+      product_id:
+        class: membership
+        impact_flow: toward-target
   domain_models:
     kind: entity
     scoring: rubric-pair
-    instrument: "forward: rubrics/domain-architecture-rubric.md · reverse: reverse/rubrics/reverse-data-model-quality.md"
+    instrument: 'forward: rubrics/domain-architecture-rubric.md · reverse: reverse/rubrics/reverse-data-model-quality.md'
     relationships:
-      domain_id: { class: membership, impact_flow: toward-target }
+      domain_id:
+        class: membership
+        impact_flow: toward-target
   entities:
     kind: entity
     scoring: predicate
-    instrument: "verified covered: builder reads glossary-alignment-manifest (entities-manifest builder); absence fires the glossary-xref + data-model-entities coverage checks (sdd-cli catalogue validate --coverage); authored population is 1 forward + 1 reverse — a rubric would be ceremony"
+    instrument: 'verified covered: builder reads glossary-alignment-manifest (entities-manifest builder); absence fires the glossary-xref + data-model-entities coverage checks (sdd-cli catalogue validate --coverage); authored population is 1 forward + 1 reverse — a rubric would be ceremony'
     relationships:
-      domain_id: { class: membership, impact_flow: toward-target }
-      source_domain_model_id: { class: lineage, impact_flow: toward-source }
-      glossary_term: { class: xref, impact_flow: none }
-  repo_capability: { kind: edge, class: realisation, impact_flow: both, scoring: derived-edge, reason: "derived from entity rows or manifest blocks scored at the owning entity" }
-  repo_capability_exemption: { kind: edge, class: attribute, impact_flow: none, scoring: derived-edge, reason: "derived from entity rows or manifest blocks scored at the owning entity" }
-  service_capability_exemption: { kind: edge, class: attribute, impact_flow: none, scoring: derived-edge, reason: "derived from entity rows or manifest blocks scored at the owning entity" }
-  external_system_exemption: { kind: edge, class: attribute, impact_flow: none, scoring: derived-edge, reason: "derived from entity rows or manifest blocks scored at the owning entity" }
-  repo_contract: { kind: edge, class: realisation, impact_flow: both, scoring: derived-edge, reason: "derived from entity rows or manifest blocks scored at the owning entity" }
-  product_capability: { kind: edge, class: dependency, impact_flow: toward-source, scoring: derived-edge, reason: "derived from entity rows or manifest blocks scored at the owning entity" }
-  product_service: { kind: edge, class: dependency, impact_flow: toward-source, scoring: derived-edge, reason: "derived from entity rows or manifest blocks scored at the owning entity" }
-  service_contract: { kind: edge, class: realisation, impact_flow: both, scoring: derived-edge, reason: "derived from entity rows or manifest blocks scored at the owning entity" }
+      domain_id:
+        class: membership
+        impact_flow: toward-target
+      source_domain_model_id:
+        class: lineage
+        impact_flow: toward-source
+      glossary_term:
+        class: xref
+        impact_flow: none
+  repo_capability:
+    kind: edge
+    class: realisation
+    impact_flow: both
+    scoring: derived-edge
+    reason: derived from entity rows or manifest blocks scored at the owning entity
+  repo_capability_exemption:
+    kind: annotation
+    class: attribute
+    impact_flow: none
+    scoring: derived-edge
+    reason: derived from entity rows or manifest blocks scored at the owning entity
+  service_capability_exemption:
+    kind: annotation
+    class: attribute
+    impact_flow: none
+    scoring: derived-edge
+    reason: derived from entity rows or manifest blocks scored at the owning entity
+  external_system_exemption:
+    kind: annotation
+    class: attribute
+    impact_flow: none
+    scoring: derived-edge
+    reason: derived from entity rows or manifest blocks scored at the owning entity
+  repo_contract:
+    kind: edge
+    class: realisation
+    impact_flow: both
+    scoring: derived-edge
+    reason: derived from entity rows or manifest blocks scored at the owning entity
+  product_capability:
+    kind: edge
+    class: dependency
+    impact_flow: toward-source
+    scoring: derived-edge
+    reason: derived from entity rows or manifest blocks scored at the owning entity
+  product_service:
+    kind: edge
+    class: dependency
+    impact_flow: toward-source
+    scoring: derived-edge
+    reason: derived from entity rows or manifest blocks scored at the owning entity
+  service_contract:
+    kind: edge
+    class: realisation
+    impact_flow: both
+    scoring: derived-edge
+    reason: derived from entity rows or manifest blocks scored at the owning entity
   service_event:
     kind: edge
     class: dependency
-    # role-conditional (M-ADR 0206 §4.2): the two roles flow in opposite directions
-    impact_flow_by: { column: role, values: { publishes: toward-target, consumes: toward-source } }
-    scoring: derived-edge
-    reason: "derived from entity rows or manifest blocks scored at the owning entity"
-  service_entity: { kind: edge, class: dependency, impact_flow: toward-source, scoring: derived-edge, reason: "derived from entity rows or manifest blocks scored at the owning entity" }
-  capability_feature: { kind: edge, class: traceability, impact_flow: toward-source, scoring: derived-edge, reason: "derived from entity rows or manifest blocks scored at the owning entity" }
-  capability_service: { kind: edge, class: dependency, impact_flow: toward-source, scoring: derived-edge, reason: "derived from entity rows or manifest blocks scored at the owning entity" }
-  capability_event: { kind: edge, class: dependency, impact_flow: toward-source, scoring: derived-edge, reason: "derived from entity rows or manifest blocks scored at the owning entity" }
-  capability_contract: { kind: edge, class: dependency, impact_flow: toward-source, scoring: derived-edge, reason: "derived from entity rows or manifest blocks scored at the owning entity" }
-  journey_feature: { kind: edge, class: dependency, impact_flow: toward-source, scoring: derived-edge, reason: "derived from entity rows or manifest blocks scored at the owning entity" }
-  persona_feature: { kind: edge, class: dependency, impact_flow: toward-source, scoring: derived-edge, reason: "derived from entity rows or manifest blocks scored at the owning entity" }
-  feature_service: { kind: edge, class: dependency, impact_flow: toward-source, scoring: derived-edge, reason: "derived from entity rows or manifest blocks scored at the owning entity" }
-  feature_event: { kind: edge, class: dependency, impact_flow: toward-source, scoring: derived-edge, reason: "derived from entity rows or manifest blocks scored at the owning entity" }
-  feature_repo: { kind: edge, class: realisation, impact_flow: both, scoring: derived-edge, reason: "derived from entity rows or manifest blocks scored at the owning entity" }
-  feature_contract: { kind: edge, class: dependency, impact_flow: toward-source, scoring: derived-edge, reason: "derived from entity rows or manifest blocks scored at the owning entity" }
-  feature_subscription_channels: { kind: edge, class: attribute, impact_flow: none, scoring: derived-edge, reason: "derived from entity rows or manifest blocks scored at the owning entity" }
-  capability_domain_model: { kind: edge, class: dependency, impact_flow: toward-source, scoring: derived-edge, reason: "derived from entity rows or manifest blocks scored at the owning entity" }
-  feature_domain_model: { kind: edge, class: dependency, impact_flow: toward-source, scoring: derived-edge, reason: "derived from entity rows or manifest blocks scored at the owning entity" }
-  persona_journey: { kind: edge, class: dependency, impact_flow: toward-source, scoring: derived-edge, reason: "derived from entity rows or manifest blocks scored at the owning entity" }
-  persona_screen: { kind: edge, class: dependency, impact_flow: toward-source, scoring: derived-edge, reason: "derived from entity rows or manifest blocks scored at the owning entity" }
-  persona_c4system: { kind: edge, class: dependency, impact_flow: toward-source, scoring: derived-edge, reason: "derived from entity rows or manifest blocks scored at the owning entity" }
-  persona_container: { kind: edge, class: dependency, impact_flow: toward-source, scoring: derived-edge, reason: "derived from entity rows or manifest blocks scored at the owning entity" }
-  system_external_dependency: { kind: edge, class: dependency, impact_flow: toward-source, scoring: derived-edge, reason: "derived from entity rows or manifest blocks scored at the owning entity" }
-  container_dependency: { kind: edge, class: dependency, impact_flow: toward-source, scoring: derived-edge, reason: "derived from entity rows or manifest blocks scored at the owning entity" }
-  system_system_dependency: { kind: edge, class: dependency, impact_flow: toward-source, scoring: derived-edge, reason: "derived from entity rows or manifest blocks scored at the owning entity" }
-  c4_container_entity: { kind: edge, class: dependency, impact_flow: toward-source, scoring: derived-edge, reason: "derived from entity rows or manifest blocks scored at the owning entity" }
-  c4_system_entity: { kind: edge, class: dependency, impact_flow: toward-source, scoring: derived-edge, reason: "derived from entity rows or manifest blocks scored at the owning entity" }
-  capability_adr: { kind: edge, class: dependency, impact_flow: toward-source, scoring: derived-edge, reason: "derived from entity rows or manifest blocks scored at the owning entity" }
-  adr_supersedes: { kind: edge, class: lineage, impact_flow: none, scoring: derived-edge, reason: "derived from entity rows or manifest blocks scored at the owning entity" }
-  product_platform_dependencies: { kind: edge, class: dependency, impact_flow: toward-source, scoring: derived-edge, reason: "derived from entity rows or manifest blocks scored at the owning entity" }
-  cross_sdd_platform_capability: { kind: edge, class: dependency, impact_flow: toward-source, scoring: derived-edge, reason: "derived from entity rows or manifest blocks scored at the owning entity" }
-  application_data_plane_bindings: { kind: edge, class: attribute, impact_flow: none, scoring: derived-edge, reason: "derived from entity rows or manifest blocks scored at the owning entity" }
-  application_data_plane_deviations: { kind: edge, class: attribute, impact_flow: none, scoring: derived-edge, reason: "derived from entity rows or manifest blocks scored at the owning entity" }
-  application_conformance_coverage: { kind: edge, class: attribute, impact_flow: none, scoring: derived-edge, reason: "derived from entity rows or manifest blocks scored at the owning entity" }
+    impact_flow_by:
+      column: role
+      values:
+        publishes: toward-target
+        consumes: toward-source
+    scoring: derived-edge
+    reason: derived from entity rows or manifest blocks scored at the owning entity
+  service_entity:
+    kind: edge
+    class: dependency
+    impact_flow: toward-source
+    scoring: derived-edge
+    reason: derived from entity rows or manifest blocks scored at the owning entity
+  capability_feature:
+    kind: edge
+    class: traceability
+    impact_flow: toward-source
+    scoring: derived-edge
+    reason: derived from entity rows or manifest blocks scored at the owning entity
+  capability_service:
+    kind: edge
+    class: dependency
+    impact_flow: toward-source
+    scoring: derived-edge
+    reason: derived from entity rows or manifest blocks scored at the owning entity
+  capability_event:
+    kind: edge
+    class: dependency
+    impact_flow: toward-source
+    scoring: derived-edge
+    reason: derived from entity rows or manifest blocks scored at the owning entity
+  capability_contract:
+    kind: edge
+    class: dependency
+    impact_flow: toward-source
+    scoring: derived-edge
+    reason: derived from entity rows or manifest blocks scored at the owning entity
+  journey_feature:
+    kind: edge
+    class: dependency
+    impact_flow: toward-source
+    scoring: derived-edge
+    reason: derived from entity rows or manifest blocks scored at the owning entity
+  persona_feature:
+    kind: edge
+    class: dependency
+    impact_flow: toward-source
+    scoring: derived-edge
+    reason: derived from entity rows or manifest blocks scored at the owning entity
+  feature_service:
+    kind: edge
+    class: dependency
+    impact_flow: toward-source
+    scoring: derived-edge
+    reason: derived from entity rows or manifest blocks scored at the owning entity
+  feature_event:
+    kind: edge
+    class: dependency
+    impact_flow: toward-source
+    scoring: derived-edge
+    reason: derived from entity rows or manifest blocks scored at the owning entity
+  feature_repo:
+    kind: edge
+    class: realisation
+    impact_flow: both
+    scoring: derived-edge
+    reason: derived from entity rows or manifest blocks scored at the owning entity
+  feature_contract:
+    kind: edge
+    class: dependency
+    impact_flow: toward-source
+    scoring: derived-edge
+    reason: derived from entity rows or manifest blocks scored at the owning entity
+  feature_subscription_channels:
+    kind: annotation
+    class: attribute
+    impact_flow: none
+    scoring: derived-edge
+    reason: derived from entity rows or manifest blocks scored at the owning entity
+  capability_domain_model:
+    kind: edge
+    class: dependency
+    impact_flow: toward-source
+    scoring: derived-edge
+    reason: derived from entity rows or manifest blocks scored at the owning entity
+  feature_domain_model:
+    kind: edge
+    class: dependency
+    impact_flow: toward-source
+    scoring: derived-edge
+    reason: derived from entity rows or manifest blocks scored at the owning entity
+  persona_journey:
+    kind: edge
+    class: dependency
+    impact_flow: toward-source
+    scoring: derived-edge
+    reason: derived from entity rows or manifest blocks scored at the owning entity
+  persona_screen:
+    kind: edge
+    class: dependency
+    impact_flow: toward-source
+    scoring: derived-edge
+    reason: derived from entity rows or manifest blocks scored at the owning entity
+  persona_c4system:
+    kind: edge
+    class: dependency
+    impact_flow: toward-source
+    scoring: derived-edge
+    reason: derived from entity rows or manifest blocks scored at the owning entity
+  persona_container:
+    kind: edge
+    class: dependency
+    impact_flow: toward-source
+    scoring: derived-edge
+    reason: derived from entity rows or manifest blocks scored at the owning entity
+  system_external_dependency:
+    kind: edge
+    class: dependency
+    impact_flow: toward-source
+    scoring: derived-edge
+    reason: derived from entity rows or manifest blocks scored at the owning entity
+  container_dependency:
+    kind: edge
+    class: dependency
+    impact_flow: toward-source
+    scoring: derived-edge
+    reason: derived from entity rows or manifest blocks scored at the owning entity
+  system_system_dependency:
+    kind: edge
+    class: dependency
+    impact_flow: toward-source
+    scoring: derived-edge
+    reason: derived from entity rows or manifest blocks scored at the owning entity
+  c4_container_entity:
+    kind: edge
+    class: dependency
+    impact_flow: toward-source
+    scoring: derived-edge
+    reason: derived from entity rows or manifest blocks scored at the owning entity
+  c4_system_entity:
+    kind: edge
+    class: dependency
+    impact_flow: toward-source
+    scoring: derived-edge
+    reason: derived from entity rows or manifest blocks scored at the owning entity
+  capability_adr:
+    kind: edge
+    class: dependency
+    impact_flow: toward-source
+    scoring: derived-edge
+    reason: derived from entity rows or manifest blocks scored at the owning entity
+  adr_supersedes:
+    kind: edge
+    class: lineage
+    impact_flow: none
+    scoring: derived-edge
+    reason: derived from entity rows or manifest blocks scored at the owning entity
+  product_platform_dependencies:
+    kind: edge
+    class: dependency
+    impact_flow: toward-source
+    scoring: derived-edge
+    reason: derived from entity rows or manifest blocks scored at the owning entity
+  cross_sdd_platform_capability:
+    kind: edge
+    class: dependency
+    impact_flow: toward-source
+    scoring: derived-edge
+    reason: derived from entity rows or manifest blocks scored at the owning entity
+  application_data_plane_bindings:
+    kind: annotation
+    class: attribute
+    impact_flow: none
+    scoring: derived-edge
+    reason: derived from entity rows or manifest blocks scored at the owning entity
+  application_data_plane_deviations:
+    kind: annotation
+    class: attribute
+    impact_flow: none
+    scoring: derived-edge
+    reason: derived from entity rows or manifest blocks scored at the owning entity
+  application_conformance_coverage:
+    kind: annotation
+    class: attribute
+    impact_flow: none
+    scoring: derived-edge
+    reason: derived from entity rows or manifest blocks scored at the owning entity
   screens:
     kind: entity
     scoring: rubric-pair
-    instrument: "forward: rubrics/screen-spec-rubric.md above the mechanical floor (guides/screen-spec-depth-rubric.md) · reverse: reverse/rubrics/reverse-screen-spec-quality.md"
+    instrument: 'forward: rubrics/screen-spec-rubric.md above the mechanical floor (guides/screen-spec-depth-rubric.md) · reverse: reverse/rubrics/reverse-screen-spec-quality.md'
     relationships:
-      product_id: { class: membership, impact_flow: toward-target }
+      product_id:
+        class: membership
+        impact_flow: toward-target
   ui_components:
     kind: entity
     scoring: not-applicable
-    instrument: "projected from component call-heads inside the screens builder; no authoring surface"
+    instrument: projected from component call-heads inside the screens builder; no authoring surface
     relationships:
-      product_id: { class: membership, impact_flow: toward-target }
-  screen_component: { kind: edge, class: membership, impact_flow: toward-source, scoring: derived-edge, reason: "derived from entity rows or manifest blocks scored at the owning entity" }
-  screen_feature: { kind: edge, class: dependency, impact_flow: toward-source, scoring: derived-edge, reason: "derived from entity rows or manifest blocks scored at the owning entity" }
-  screen_action: { kind: edge, class: dependency, impact_flow: toward-source, scoring: derived-edge, reason: "derived from entity rows or manifest blocks scored at the owning entity" }
-  conformance_finding: { kind: finding, scoring: not-built, reason: "not produced by catalogue build; populated by conformance tooling" }
+      product_id:
+        class: membership
+        impact_flow: toward-target
+  screen_component:
+    kind: edge
+    class: membership
+    impact_flow: toward-source
+    scoring: derived-edge
+    reason: derived from entity rows or manifest blocks scored at the owning entity
+  screen_feature:
+    kind: edge
+    class: dependency
+    impact_flow: toward-source
+    scoring: derived-edge
+    reason: derived from entity rows or manifest blocks scored at the owning entity
+  screen_action:
+    kind: edge
+    class: dependency
+    impact_flow: toward-source
+    scoring: derived-edge
+    reason: derived from entity rows or manifest blocks scored at the owning entity
+  conformance_finding:
+    kind: finding
+    scoring: not-built
+    reason: not produced by catalogue build; populated by conformance tooling
   quality_scores:
     kind: entity
     scoring: predicate
-    instrument: "the score record itself — scoring it with a rubric would be circular. Its COVERAGE is what needs governing (every eligible artefact carries a current, non-stale score), and that is the scores-coverage predicate of M-ADR 0205 §4.5, run by sdd-cli catalogue validate --coverage. The quality of each individual assessment is the rubric named in its own rubric_id."
+    instrument: the score record itself — scoring it with a rubric would be circular. Its COVERAGE is what needs governing (every eligible artefact carries a current, non-stale score), and that is the scores-coverage predicate of M-ADR 0205 §4.5, run by sdd-cli catalogue validate --coverage. The quality of each individual assessment is the rubric named in its own rubric_id.
     relationships:
-      # flow none, RULED (0206 flagged-row resolution): diagnostics do not
-      # ride change closures. A score is a record ABOUT an artefact; "is this
-      # score still current after the change" is owned, precisely, by the
-      # scores instruments (staleness_basis/corpus_ref + the coverage check),
-      # and answering it through reachability answers it worse. Measured
-      # before ruling: scores were 27-30% of both estates' contract closures.
-      sdd_id: { class: dependency, impact_flow: none }
+      sdd_id:
+        class: dependency
+        impact_flow: none
   quality_score_dimensions:
-    kind: edge
+    kind: annotation
     class: attribute
     impact_flow: none
     scoring: derived-edge
-    reason: "derived from the parent quality_scores row; the dimension keys are the rubric's own vocabulary, governed by the rubric that declares them"
-  quality_gate: { kind: enum, scoring: not-applicable, reason: "closed vocabulary, not an artefact" }
-  score_selection_method: { kind: enum, scoring: not-applicable, reason: "closed vocabulary, not an artefact" }
-  staleness_basis: { kind: enum, scoring: not-applicable, reason: "closed vocabulary, not an artefact" }
-  scoring_form: { kind: enum, scoring: not-applicable, reason: "closed vocabulary, not an artefact" }
+    reason: derived from the parent quality_scores row; the dimension keys are the rubric's own vocabulary, governed by the rubric that declares them
+  quality_gate:
+    kind: enum
+    scoring: not-applicable
+    reason: closed vocabulary, not an artefact
+  score_selection_method:
+    kind: enum
+    scoring: not-applicable
+    reason: closed vocabulary, not an artefact
+  staleness_basis:
+    kind: enum
+    scoring: not-applicable
+    reason: closed vocabulary, not an artefact
+  scoring_form:
+    kind: enum
+    scoring: not-applicable
+    reason: closed vocabulary, not an artefact
   scaffolds:
     kind: entity
     scoring: predicate
-    instrument: "the declaration record itself — scoring it with a rubric would be circular. Its GOVERNANCE is the M-ADR 0207 §4.8 delta instrument plus the scaffold-coverage predicate (every non-closed scaffold carries a current anchor and a computable delta; a closed scaffold sits at delta zero), run by sdd-cli catalogue validate --coverage."
+    instrument: the declaration record itself — scoring it with a rubric would be circular. Its GOVERNANCE is the M-ADR 0207 §4.8 delta instrument plus the scaffold-coverage predicate (every non-closed scaffold carries a current anchor and a computable delta; a closed scaffold sits at delta zero), run by sdd-cli catalogue validate --coverage.
     relationships:
-      # flow none, same ruling shape as quality_scores.sdd_id: a scaffold is a
-      # governance record ABOUT work, not a structural path of the estate —
-      # "is this declaration still current after the change" is owned by the
-      # scaffold instruments (corpus_ref staleness + the delta), and answering
-      # it through reachability answers it worse.
-      sdd_id: { class: membership, impact_flow: none }
+      sdd_id:
+        class: membership
+        impact_flow: none
   scaffold_items:
-    kind: edge
+    kind: annotation
     class: traceability
     impact_flow: none
     scoring: derived-edge
-    reason: "derived from the authored scaffold manifest (M-ADR 0207 §4.1); the polymorphic target deliberately declares no FK — resolution is conditional on state — so the row is a governance trace, not an impact path"
-  scaffold_status: { kind: enum, scoring: not-applicable, reason: "closed vocabulary, not an artefact" }
-  scaffold_item_kind: { kind: enum, scoring: not-applicable, reason: "closed vocabulary, not an artefact" }
-  scaffold_item_state: { kind: enum, scoring: not-applicable, reason: "closed vocabulary, not an artefact" }
+    reason: derived from the authored scaffold manifest (M-ADR 0207 §4.1); the polymorphic target deliberately declares no FK — resolution is conditional on state — so the row is a governance trace, not an impact path
+  scaffold_status:
+    kind: enum
+    scoring: not-applicable
+    reason: closed vocabulary, not an artefact
+  scaffold_item_kind:
+    kind: enum
+    scoring: not-applicable
+    reason: closed vocabulary, not an artefact
+  scaffold_item_state:
+    kind: enum
+    scoring: not-applicable
+    reason: closed vocabulary, not an artefact
+  interaction_pattern:
+    kind: enum
+    scoring: not-applicable
+    reason: closed vocabulary, not an artefact
+  event_participation:
+    kind: enum
+    scoring: not-applicable
+    reason: closed vocabulary, not an artefact
+  contract_participation:
+    kind: enum
+    scoring: not-applicable
+    reason: closed vocabulary, not an artefact
+  consumption_role:
+    kind: enum
+    scoring: not-applicable
+    reason: closed vocabulary, not an artefact
+  journey_participation:
+    kind: enum
+    scoring: not-applicable
+    reason: closed vocabulary, not an artefact