npm - @afokapu/atdd-bun - Versions diffs - 0.10.32 → 0.10.34 - Mend

@afokapu/atdd-bun 0.10.32 → 0.10.34

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (29) hide show

package/README.md +14 -10
package/conventions/_profiles/architecture.yaml +190 -0
package/conventions/_profiles/coder.yaml +804 -0
package/conventions/_profiles/design.yaml +219 -0
package/conventions/_profiles/docs.yaml +136 -0
package/conventions/_profiles/htmx.yaml +436 -0
package/conventions/_profiles/interlocking.yaml +248 -0
package/conventions/_profiles/metrics.yaml +80 -0
package/conventions/_profiles/planner.yaml +789 -0
package/conventions/_profiles/runtime.yaml +62 -0
package/conventions/_profiles/security.yaml +70 -0
package/conventions/_profiles/telemetry.yaml +196 -0
package/conventions/_profiles/tester.yaml +734 -0
package/conventions/_profiles/topology.yaml +192 -0
package/conventions/_profiles/traceability.yaml +94 -0
package/conventions/_profiles/workflow.yaml +7 -0
package/conventions/atdd-bun.profiles/atdd-bun.profiles.presets.convention.yaml +24 -2
package/integrity.json +27 -12
package/package.json +2 -1
package/src/agent.ts +15 -15
package/src/cli.ts +7 -0
package/src/enforce.ts +23 -10
package/src/hooks.ts +3 -3
package/src/index.ts +1 -0
package/src/integrity.ts +0 -2
package/src/profile-registry.ts +78 -0
package/src/setup.ts +4 -4
package/templates/agents/AGENTS.block.md +4 -6
package/templates/agents/atdd/SKILL.md +0 -20

package/conventions/_profiles/planner.yaml ADDED Viewed

@@ -0,0 +1,789 @@
+schema_version: "1.0.0"
+profile: "planner"
+implementations:
+  - "atdd_topology"
+  - "planner_plan_integrity"
+  - "planner_schema_validation"
+  - "planner_static_validators"
+conventions:
+  - rule_id: "atdd-bun.planner.acceptance-identity"
+    path: "conventions/atdd-bun.planner/atdd-bun.planner.acceptance-identity.convention.yaml"
+  - rule_id: "atdd-bun.planner.identity-required"
+    path: "conventions/atdd-bun.planner/atdd-bun.planner.identity-required.convention.yaml"
+  - rule_id: "atdd-bun.planner.identity-unique"
+    path: "conventions/atdd-bun.planner/atdd-bun.planner.identity-unique.convention.yaml"
+  - rule_id: "atdd-bun.planner.interlocking-participant-resolves"
+    path: "conventions/atdd-bun.planner/atdd-bun.planner.interlocking-participant-resolves.convention.yaml"
+  - rule_id: "atdd-bun.planner.parse"
+    path: "conventions/atdd-bun.planner/atdd-bun.planner.parse.convention.yaml"
+  - rule_id: "atdd-bun.planner.reference-resolves"
+    path: "conventions/atdd-bun.planner/atdd-bun.planner.reference-resolves.convention.yaml"
+  - rule_id: "atdd-bun.planner.schema"
+    path: "conventions/atdd-bun.planner/atdd-bun.planner.schema.convention.yaml"
+  - rule_id: "atdd-bun.planner.train-wagon-resolves"
+    path: "conventions/atdd-bun.planner/atdd-bun.planner.train-wagon-resolves.convention.yaml"
+  - rule_id: "atdd-bun.topology.e2e-location"
+    path: "conventions/atdd-bun.topology/atdd-bun.topology.e2e-location.convention.yaml"
+  - rule_id: "atdd-bun.topology.feature-source-coverage"
+    path: "conventions/atdd-bun.topology/atdd-bun.topology.feature-source-coverage.convention.yaml"
+  - rule_id: "atdd-bun.topology.feature-test-coverage"
+    path: "conventions/atdd-bun.topology/atdd-bun.topology.feature-test-coverage.convention.yaml"
+  - rule_id: "atdd-bun.topology.plan-location"
+    path: "conventions/atdd-bun.topology/atdd-bun.topology.plan-location.convention.yaml"
+  - rule_id: "atdd-bun.topology.source-location"
+    path: "conventions/atdd-bun.topology/atdd-bun.topology.source-location.convention.yaml"
+  - rule_id: "atdd-bun.topology.test-location"
+    path: "conventions/atdd-bun.topology/atdd-bun.topology.test-location.convention.yaml"
+  - rule_id: "planner.artifact-naming.theme-first-identity"
+    path: "planner-nodes/nodes/planner.artifact-naming.theme-first-identity.convention.yaml"
+  - rule_id: "planner.contract.registry-coherence"
+    path: "planner-nodes/nodes/planner.contract.registry-coherence.convention.yaml"
+  - rule_id: "planner.feature.wagon-link"
+    path: "planner-nodes/nodes/planner.feature.wagon-link.convention.yaml"
+  - rule_id: "planner.journey.continuation-closure"
+    path: "planner-nodes/nodes/planner.journey.continuation-closure.convention.yaml"
+  - rule_id: "planner.journey.interlocking-composed"
+    path: "planner-nodes/nodes/planner.journey.interlocking-composed.convention.yaml"
+  - rule_id: "planner.theme.must-be-canonical"
+    path: "planner-nodes/nodes/planner.theme.must-be-canonical.convention.yaml"
+  - rule_id: "planner.theme.theme-zero-mandatory"
+    path: "planner-nodes/nodes/planner.theme.theme-zero-mandatory.convention.yaml"
+  - rule_id: "planner.theme.urn-namespace-matches"
+    path: "planner-nodes/nodes/planner.theme.urn-namespace-matches.convention.yaml"
+  - rule_id: "planner.train.naming"
+    path: "planner-nodes/nodes/planner.train.naming.convention.yaml"
+  - rule_id: "planner.train.registry-coherence"
+    path: "planner-nodes/nodes/planner.train.registry-coherence.convention.yaml"
+  - rule_id: "planner.wagon.features"
+    path: "planner-nodes/nodes/planner.wagon.features.convention.yaml"
+  - rule_id: "planner.wagon.no-consume-cycle"
+    path: "planner-nodes/nodes/planner.wagon.no-consume-cycle.convention.yaml"
+  - rule_id: "planner.wagon.produce-consume-artifacts"
+    path: "planner-nodes/nodes/planner.wagon.produce-consume-artifacts.convention.yaml"
+  - rule_id: "planner.wagon.telemetry-filesystem"
+    path: "planner-nodes/nodes/planner.wagon.telemetry-filesystem.convention.yaml"
+  - rule_id: "planner.wagon.urn"
+    path: "planner-nodes/nodes/planner.wagon.urn.convention.yaml"
+  - rule_id: "planner.wagon.urn-naming"
+    path: "planner-nodes/nodes/planner.wagon.urn-naming.convention.yaml"
+relationships:
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "finish_to_start"
+    origin: "@afokapu/atdd-bun"
+    reason: "a test can bind an acceptance only through the acc: identity the WMBT gives it"
+    source_ref: "atdd-bun.planner.acceptance-identity"
+    strength: "critical"
+    target_ref: "traceability.test.binding-resolves"
+    type: "enables"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "finish_to_start"
+    origin: "@afokapu/atdd-bun"
+    reason: "identities can only be compared once every artifact carries one"
+    source_ref: "atdd-bun.planner.identity-required"
+    strength: "critical"
+    target_ref: "atdd-bun.planner.identity-unique"
+    type: "enables"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "finish_to_start"
+    origin: "@afokapu/atdd-bun"
+    reason: "a reference resolves to exactly one target only when identities are unique"
+    source_ref: "atdd-bun.planner.identity-unique"
+    strength: "critical"
+    target_ref: "atdd-bun.planner.reference-resolves"
+    type: "enables"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "start_to_start"
+    origin: "@afokapu/atdd-bun"
+    reason: "interlocking participants are the interlocking-specific case of reference resolution"
+    source_ref: "atdd-bun.planner.interlocking-participant-resolves"
+    strength: "important"
+    target_ref: "atdd-bun.planner.reference-resolves"
+    type: "runs_alongside"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "finish_to_start"
+    origin: "@afokapu/atdd-bun"
+    reason: "an artifact is read for its identity only once it parses"
+    source_ref: "atdd-bun.planner.parse"
+    strength: "critical"
+    target_ref: "atdd-bun.planner.identity-required"
+    type: "enables"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "finish_to_start"
+    origin: "@afokapu/atdd-bun"
+    reason: "an artifact is only identified once it parses"
+    source_ref: "atdd-bun.planner.parse"
+    strength: "critical"
+    target_ref: "atdd-bun.planner.identity-unique"
+    type: "enables"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "finish_to_start"
+    origin: "@afokapu/atdd-bun"
+    reason: "a document is validated against its schema only after it parses"
+    source_ref: "atdd-bun.planner.schema"
+    strength: "critical"
+    target_ref: "atdd-bun.planner.parse"
+    type: "requires"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "start_to_start"
+    origin: "@afokapu/atdd-bun"
+    reason: "the schema catch-all beside the canonical rules its violations are routed to"
+    source_ref: "atdd-bun.planner.schema"
+    strength: "important"
+    target_ref: "planner.train.naming"
+    type: "runs_alongside"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "start_to_start"
+    origin: "@afokapu/atdd-bun"
+    reason: "wagon membership of a train is the train-specific case of reference resolution"
+    source_ref: "atdd-bun.planner.train-wagon-resolves"
+    strength: "important"
+    target_ref: "atdd-bun.planner.reference-resolves"
+    type: "runs_alongside"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "finish_to_start"
+    origin: "@afokapu/atdd-bun"
+    reason: "journey E2E paths are derived from the journeys the plan declares"
+    source_ref: "atdd-bun.topology.e2e-location"
+    strength: "critical"
+    target_ref: "planner.journey.definition"
+    type: "requires"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "start_to_start"
+    origin: "@afokapu/atdd-bun"
+    reason: "every route has an end-to-end proof: at its canonical path, and exercising the production runner"
+    source_ref: "atdd-bun.topology.e2e-location"
+    strength: "important"
+    target_ref: "tester.bun.interlocking-route-coverage"
+    type: "runs_alongside"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "start_to_start"
+    origin: "@afokapu/atdd-bun"
+    reason: "on a frontend journey a browser spec is the route's end-to-end proof"
+    source_ref: "atdd-bun.topology.e2e-location"
+    strength: "important"
+    target_ref: "tester.htmx.train-e2e-coverage"
+    type: "runs_alongside"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "finish_to_start"
+    origin: "@afokapu/atdd-bun"
+    reason: "coverage counts only source placed beneath its feature"
+    source_ref: "atdd-bun.topology.feature-source-coverage"
+    strength: "critical"
+    target_ref: "atdd-bun.topology.source-location"
+    type: "requires"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "start_to_start"
+    origin: "@afokapu/atdd-bun"
+    reason: "a feature with WMBTs is implemented and tested"
+    source_ref: "atdd-bun.topology.feature-test-coverage"
+    strength: "important"
+    target_ref: "atdd-bun.topology.feature-source-coverage"
+    type: "runs_alongside"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "finish_to_start"
+    origin: "@afokapu/atdd-bun"
+    reason: "coverage counts only tests placed beneath their feature and bound to its acceptances"
+    source_ref: "atdd-bun.topology.feature-test-coverage"
+    strength: "critical"
+    target_ref: "atdd-bun.topology.test-location"
+    type: "requires"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "start_to_start"
+    origin: "@afokapu/atdd-bun"
+    reason: "where a feature lives and which wagon owns it: the same ownership, by path and by link"
+    source_ref: "atdd-bun.topology.plan-location"
+    strength: "important"
+    target_ref: "planner.feature.wagon-link"
+    type: "runs_alongside"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "finish_to_start"
+    origin: "@afokapu/atdd-bun"
+    reason: "features are placed by path once the wagon's feature decomposition is declared"
+    source_ref: "atdd-bun.topology.plan-location"
+    strength: "critical"
+    target_ref: "planner.wagon.features"
+    type: "requires"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "finish_to_start"
+    origin: "@afokapu/atdd-bun"
+    reason: "source is placed beneath a feature the plan declares at its canonical path"
+    source_ref: "atdd-bun.topology.source-location"
+    strength: "critical"
+    target_ref: "atdd-bun.topology.plan-location"
+    type: "requires"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "start_to_start"
+    origin: "@afokapu/atdd-bun"
+    reason: "the same component URN, read for its grammar and for where the file must live"
+    source_ref: "atdd-bun.topology.source-location"
+    strength: "important"
+    target_ref: "coder.bun.green-urn-pattern"
+    type: "runs_alongside"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "finish_to_start"
+    origin: "@afokapu/atdd-bun"
+    reason: "tests are placed beneath a feature the plan declares"
+    source_ref: "atdd-bun.topology.test-location"
+    strength: "critical"
+    target_ref: "atdd-bun.topology.plan-location"
+    type: "requires"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "start_to_start"
+    origin: "@afokapu/atdd-bun"
+    reason: "the acceptance a test binds, read for presence and for whether a WMBT declares it"
+    source_ref: "atdd-bun.topology.test-location"
+    strength: "important"
+    target_ref: "tester.bun.acceptance-binding-declared"
+    type: "runs_alongside"
+  - confidence: 1
+    constraint: "discretionary"
+    control: "external"
+    foundation: "start_to_start"
+    origin: "atdd@36ce055a:src/atdd/coach/graph/relationships.yaml"
+    reason: "acceptance telemetry signals and wagon telemetry URNs share naming"
+    source_ref: "planner.acceptance.signal-telemetry-naming"
+    strength: "minor"
+    target_ref: "planner.wagon.telemetry-filesystem"
+    type: "runs_alongside"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "finish_to_start"
+    origin: "atdd@36ce055a:src/atdd/coach/graph/relationships.yaml"
+    reason: "a contract path can only mirror an identity that is a valid theme-first identity"
+    source_ref: "planner.artifact-naming.path-mirrors-identity"
+    strength: "important"
+    target_ref: "planner.artifact-naming.theme-first-identity"
+    type: "requires"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "start_to_start"
+    origin: "atdd@36ce055a:src/atdd/coach/graph/relationships.yaml"
+    reason: "the theme-first identity rule resolves its allowed themes from the same canonical theme map"
+    source_ref: "planner.artifact-naming.theme-first-identity"
+    strength: "important"
+    target_ref: "planner.theme.must-be-canonical"
+    type: "requires"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "finish_to_start"
+    origin: "atdd@36ce055a:src/atdd/coach/graph/relationships.yaml"
+    reason: "the {wagon} URN segment must resolve to a real wagon"
+    source_ref: "planner.component.urn"
+    strength: "critical"
+    target_ref: "planner.wagon.urn"
+    type: "requires"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "finish_to_start"
+    origin: "atdd@36ce055a:src/atdd/coach/graph/relationships.yaml"
+    reason: "contract coherence is checked over the produce/consume artifact shape it constrains (#1332)"
+    source_ref: "planner.contract.registry-coherence"
+    strength: "important"
+    target_ref: "planner.wagon.produce-consume-artifacts"
+    type: "requires"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "external"
+    foundation: "finish_to_start"
+    origin: "atdd@36ce055a:src/atdd/coach/graph/relationships.yaml"
+    reason: "wagon-feature coverage reads the wagon features manifest"
+    source_ref: "planner.coverage.bidirectional-coverage-between-wagons"
+    strength: "important"
+    target_ref: "planner.wagon.features"
+    type: "requires"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "finish_to_finish"
+    origin: "atdd@36ce055a:src/atdd/coach/graph/relationships.yaml"
+    reason: "a feature belongs to exactly one wagon"
+    source_ref: "planner.feature.definition"
+    strength: "critical"
+    target_ref: "planner.feature.wagon-link"
+    type: "requires"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "external"
+    foundation: "finish_to_start"
+    origin: "atdd@36ce055a:src/atdd/coach/graph/relationships.yaml"
+    reason: "a feature URN embeds its parent wagon slug"
+    source_ref: "planner.feature.urn-naming"
+    strength: "important"
+    target_ref: "planner.wagon.urn-naming"
+    type: "requires"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "external"
+    foundation: "finish_to_start"
+    origin: "atdd@36ce055a:src/atdd/coach/graph/relationships.yaml"
+    reason: "a feature is registered in its wagon _features.yaml"
+    source_ref: "planner.feature.wagon-link"
+    strength: "important"
+    target_ref: "planner.wagon.features"
+    type: "requires"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "finish_to_start"
+    origin: "@afokapu/atdd-bun"
+    reason: "continuation closure validates the journey topology the definition describes"
+    source_ref: "planner.journey.continuation-closure"
+    strength: "critical"
+    target_ref: "planner.journey.definition"
+    type: "requires"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "start_to_start"
+    origin: "@afokapu/atdd-bun"
+    reason: "two halves of journey closure: continuation closure checks the journeys a plan declares, composition checks that no interlocking is left outside every journey, which closure alone passes vacuously"
+    source_ref: "planner.journey.interlocking-composed"
+    strength: "critical"
+    target_ref: "planner.journey.continuation-closure"
+    type: "runs_alongside"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "finish_to_start"
+    origin: "@afokapu/atdd-bun"
+    reason: "an interlocking is judged composed against what a journey is: its entrypoint and its continuations"
+    source_ref: "planner.journey.interlocking-composed"
+    strength: "critical"
+    target_ref: "planner.journey.definition"
+    type: "requires"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "finish_to_start"
+    origin: "atdd@36ce055a:src/atdd/coach/graph/relationships.yaml"
+    reason: "a spec is validated against the schema of the artifact its kind authors, so the plan layer keeps the by-construction promise the author layer already makes"
+    source_ref: "planner.plan.spec-is-schema-valid"
+    strength: "critical"
+    target_ref: "planner.wagon.urn-naming"
+    type: "requires"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "finish_to_start"
+    origin: "@afokapu/atdd-bun"
+    reason: "wagon produce[] telemetry entries are the ownership declarations items resolve against"
+    source_ref: "planner.telemetry.logical-ownership"
+    strength: "important"
+    target_ref: "planner.wagon.produce-consume-artifacts"
+    type: "requires"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "finish_to_start"
+    origin: "@afokapu/atdd-bun"
+    reason: "the tracking-plan tree is the versioned realization of the telemetry URN-to-filesystem mapping"
+    source_ref: "planner.telemetry.tracking-plan-schema"
+    strength: "important"
+    target_ref: "planner.wagon.telemetry-filesystem"
+    type: "requires"
+  - confidence: 1
+    constraint: "discretionary"
+    control: "internal"
+    foundation: "finish_to_start"
+    origin: "atdd@36ce055a:src/atdd/coach/graph/relationships.yaml"
+    reason: "plan/test/code archetype alignment presupposes a canonical theme"
+    source_ref: "planner.theme.archetype-alignment"
+    strength: "minor"
+    target_ref: "planner.theme.must-be-canonical"
+    type: "follows"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "finish_to_start"
+    origin: "atdd@36ce055a:src/atdd/coach/graph/relationships.yaml"
+    reason: "the commons/coach import boundary is only checkable once a theme resolves to canonical"
+    source_ref: "planner.theme.commons-coach-boundary"
+    strength: "important"
+    target_ref: "planner.theme.must-be-canonical"
+    type: "follows"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "finish_to_finish"
+    origin: "atdd@36ce055a:src/atdd/coach/graph/relationships.yaml"
+    reason: "non-canonical themes are rejected"
+    source_ref: "planner.theme.definition"
+    strength: "critical"
+    target_ref: "planner.theme.must-be-canonical"
+    type: "requires"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "finish_to_finish"
+    origin: "atdd@36ce055a:src/atdd/coach/graph/relationships.yaml"
+    reason: "digit 0 commons is the mandatory locked floor"
+    source_ref: "planner.theme.definition"
+    strength: "critical"
+    target_ref: "planner.theme.theme-zero-mandatory"
+    type: "requires"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "finish_to_finish"
+    origin: "atdd@36ce055a:src/atdd/coach/graph/relationships.yaml"
+    reason: "the theme token namespaces the artifact URN"
+    source_ref: "planner.theme.definition"
+    strength: "important"
+    target_ref: "planner.theme.urn-namespace-matches"
+    type: "requires"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "finish_to_start"
+    origin: "atdd@36ce055a:src/atdd/coach/graph/relationships.yaml"
+    reason: "the canonical set is defined by the taxonomy"
+    source_ref: "planner.theme.must-be-canonical"
+    strength: "critical"
+    target_ref: "planner.theme.canonical-taxonomy"
+    type: "requires"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "finish_to_start"
+    origin: "atdd@36ce055a:src/atdd/coach/graph/relationships.yaml"
+    reason: "a canonical theme set must include the non-removable commons@0 floor"
+    source_ref: "planner.theme.must-be-canonical"
+    strength: "critical"
+    target_ref: "planner.theme.theme-zero-mandatory"
+    type: "requires"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "finish_to_start"
+    origin: "atdd@36ce055a:src/atdd/coach/graph/relationships.yaml"
+    reason: "digit 0 = commons is fixed by the taxonomy's theme_zero token"
+    source_ref: "planner.theme.theme-zero-mandatory"
+    strength: "critical"
+    target_ref: "planner.theme.canonical-taxonomy"
+    type: "requires"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "finish_to_start"
+    origin: "atdd@36ce055a:src/atdd/coach/graph/relationships.yaml"
+    reason: "the theme-prefix must be a canonical theme"
+    source_ref: "planner.theme.urn-namespace-matches"
+    strength: "important"
+    target_ref: "planner.theme.canonical-taxonomy"
+    type: "requires"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "finish_to_start"
+    origin: "atdd@36ce055a:src/atdd/coach/graph/relationships.yaml"
+    reason: "matching a produced-URN theme-prefix to the wagon theme presupposes a canonical theme"
+    source_ref: "planner.theme.urn-namespace-matches"
+    strength: "important"
+    target_ref: "planner.theme.must-be-canonical"
+    type: "follows"
+  - confidence: 1
+    constraint: "discretionary"
+    control: "external"
+    foundation: "finish_to_start"
+    origin: "atdd@36ce055a:src/atdd/coach/graph/relationships.yaml"
+    reason: "train data-flow dependencies follow wagon produce/consume artifacts"
+    source_ref: "planner.train.dependencies"
+    strength: "minor"
+    target_ref: "planner.wagon.produce-consume-artifacts"
+    type: "requires"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "finish_to_start"
+    origin: "atdd@36ce055a:src/atdd/coach/graph/relationships.yaml"
+    reason: "the row path and the document path it is compared against both derive from the train_id, so a naming disagreement would read as an incoherence"
+    source_ref: "planner.train.registry-coherence"
+    strength: "important"
+    target_ref: "planner.train.naming"
+    type: "requires"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "finish_to_start"
+    origin: "atdd@36ce055a:src/atdd/coach/graph/relationships.yaml"
+    reason: "existence coherence is checked over the two-file registry+spec pattern that node defines (#1942)"
+    source_ref: "planner.train.registry-coherence"
+    strength: "critical"
+    target_ref: "planner.train.registry"
+    type: "requires"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "finish_to_start"
+    origin: "atdd@36ce055a:src/atdd/coach/graph/relationships.yaml"
+    reason: "registry + spec paths derive from the train_id"
+    source_ref: "planner.train.registry"
+    strength: "important"
+    target_ref: "planner.train.naming"
+    type: "requires"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "external"
+    foundation: "finish_to_start"
+    origin: "atdd@36ce055a:src/atdd/coach/graph/relationships.yaml"
+    reason: "a train's participants are wagons"
+    source_ref: "planner.train.scope"
+    strength: "important"
+    target_ref: "planner.wagon.urn-naming"
+    type: "requires"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "finish_to_start"
+    origin: "atdd@36ce055a:src/atdd/coach/graph/relationships.yaml"
+    reason: "a train sequences 3-7 wagons referenced by wagon URN"
+    source_ref: "planner.train.scope"
+    strength: "important"
+    target_ref: "planner.wagon.urn"
+    type: "requires"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "external"
+    foundation: "finish_to_start"
+    origin: "atdd@36ce055a:src/atdd/coach/graph/relationships.yaml"
+    reason: "a train theme-digit must resolve to one of the five canonical themes"
+    source_ref: "planner.train.theme-alignment"
+    strength: "important"
+    target_ref: "planner.theme.must-be-canonical"
+    type: "requires"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "finish_to_start"
+    origin: "atdd@36ce055a:src/atdd/coach/graph/relationships.yaml"
+    reason: "the telemetry URN grammar is what the filesystem mapping resolves"
+    source_ref: "planner.wagon.artifact-contracts"
+    strength: "important"
+    target_ref: "planner.wagon.telemetry-filesystem"
+    type: "enables"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "finish_to_finish"
+    origin: "atdd@36ce055a:src/atdd/coach/graph/relationships.yaml"
+    reason: "a wagon groups the features that decompose it"
+    source_ref: "planner.wagon.definition"
+    strength: "minor"
+    target_ref: "planner.wagon.features"
+    type: "requires"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "finish_to_finish"
+    origin: "atdd@36ce055a:src/atdd/coach/graph/relationships.yaml"
+    reason: "wagons must not form a produce-consume cycle"
+    source_ref: "planner.wagon.definition"
+    strength: "critical"
+    target_ref: "planner.wagon.no-consume-cycle"
+    type: "requires"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "finish_to_finish"
+    origin: "atdd@36ce055a:src/atdd/coach/graph/relationships.yaml"
+    reason: "a wagon consumes and produces declared artifacts"
+    source_ref: "planner.wagon.definition"
+    strength: "important"
+    target_ref: "planner.wagon.produce-consume-artifacts"
+    type: "requires"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "start_to_start"
+    origin: "atdd@36ce055a:src/atdd/coach/graph/relationships.yaml"
+    reason: "the features-manifest rule uses the urn-array features format"
+    source_ref: "planner.wagon.features-format"
+    strength: "important"
+    target_ref: "planner.wagon.features"
+    type: "runs_alongside"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "finish_to_start"
+    origin: "atdd@36ce055a:src/atdd/coach/graph/relationships.yaml"
+    reason: "kebab/snake conversion underpins the wagon URN + plan/<slug>/ layout"
+    source_ref: "planner.wagon.logical-vs-filesystem-naming"
+    strength: "important"
+    target_ref: "planner.wagon.urn"
+    type: "enables"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "finish_to_start"
+    origin: "atdd@36ce055a:src/atdd/coach/graph/relationships.yaml"
+    reason: "the strict no-consume-cycle invariant is the exact (acyclicity) case of the complexity model"
+    source_ref: "planner.wagon.no-consume-cycle"
+    strength: "important"
+    target_ref: "planner.wagon.complexity-model"
+    type: "requires"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "external"
+    foundation: "finish_to_start"
+    origin: "atdd@36ce055a:src/atdd/coach/graph/relationships.yaml"
+    reason: "produce/consume artifact names follow the naming pattern"
+    source_ref: "planner.wagon.produce-consume-artifacts"
+    strength: "important"
+    target_ref: "planner.artifact-naming.naming-pattern"
+    type: "requires"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "finish_to_start"
+    origin: "atdd@36ce055a:src/atdd/coach/graph/relationships.yaml"
+    reason: "produce/consume entries carry contract + telemetry URNs"
+    source_ref: "planner.wagon.produce-consume-artifacts"
+    strength: "important"
+    target_ref: "planner.wagon.artifact-contracts"
+    type: "requires"
+  - confidence: 1
+    constraint: "discretionary"
+    control: "internal"
+    foundation: "start_to_start"
+    origin: "atdd@36ce055a:src/atdd/coach/graph/relationships.yaml"
+    reason: "produced artifacts' telemetry URNs materialize on the filesystem"
+    source_ref: "planner.wagon.produce-consume-artifacts"
+    strength: "minor"
+    target_ref: "planner.wagon.telemetry-filesystem"
+    type: "runs_alongside"
+  - confidence: 1
+    constraint: "discretionary"
+    control: "external"
+    foundation: "start_to_start"
+    origin: "atdd@36ce055a:src/atdd/coach/graph/relationships.yaml"
+    reason: "a wagon produced-URN theme must match its theme"
+    source_ref: "planner.wagon.semantic-coherence"
+    strength: "minor"
+    target_ref: "planner.theme.urn-namespace-matches"
+    type: "runs_alongside"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "finish_to_start"
+    origin: "atdd@36ce055a:src/atdd/coach/graph/relationships.yaml"
+    reason: "coherence checks produce-owned / consume-foreign / external-scope rules"
+    source_ref: "planner.wagon.semantic-coherence"
+    strength: "important"
+    target_ref: "planner.wagon.produce-consume-artifacts"
+    type: "requires"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "external"
+    foundation: "finish_to_start"
+    origin: "atdd@36ce055a:src/atdd/coach/graph/relationships.yaml"
+    reason: "telemetry URNs follow the artifact-naming grammar"
+    source_ref: "planner.wagon.telemetry-filesystem"
+    strength: "important"
+    target_ref: "planner.artifact-naming.naming-pattern"
+    type: "requires"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "finish_to_start"
+    origin: "atdd@36ce055a:src/atdd/coach/graph/relationships.yaml"
+    reason: "the telemetry filesystem maps the telemetry URN form"
+    source_ref: "planner.wagon.telemetry-filesystem"
+    strength: "important"
+    target_ref: "planner.wagon.artifact-contracts"
+    type: "requires"
+  - confidence: 1
+    constraint: "discretionary"
+    control: "external"
+    foundation: "start_to_start"
+    origin: "atdd@36ce055a:src/atdd/coach/graph/relationships.yaml"
+    reason: "wagon and artifact names share the kebab grammar"
+    source_ref: "planner.wagon.urn-naming"
+    strength: "minor"
+    target_ref: "planner.artifact-naming.naming-pattern"
+    type: "runs_alongside"
+  - confidence: 1
+    constraint: "discretionary"
+    control: "internal"
+    foundation: "start_to_start"
+    origin: "atdd@36ce055a:src/atdd/coach/graph/relationships.yaml"
+    reason: "the slug derives from the wagon name"
+    source_ref: "planner.wagon.urn-naming"
+    strength: "minor"
+    target_ref: "planner.wagon.slug-dirname-conversion"
+    type: "runs_alongside"
+  - confidence: 1
+    constraint: "discretionary"
+    control: "internal"
+    foundation: "start_to_start"
+    origin: "atdd@36ce055a:src/atdd/coach/graph/relationships.yaml"
+    reason: "a wagon's stable URN is an instance of the stable-naming rule for planner artifacts"
+    source_ref: "planner.wagon.urn"
+    strength: "minor"
+    target_ref: "planner.artifact-naming.planner-artifacts-use-stable"
+    type: "runs_alongside"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "finish_to_start"
+    origin: "atdd@36ce055a:src/atdd/coach/graph/relationships.yaml"
+    reason: "the plan/<slug>/ layout follows the logical-vs-filesystem split"
+    source_ref: "planner.wagon.urn"
+    strength: "important"
+    target_ref: "planner.wagon.logical-vs-filesystem-naming"
+    type: "requires"
+  - confidence: 1
+    constraint: "mandatory"
+    control: "internal"
+    foundation: "finish_to_start"
+    origin: "atdd@36ce055a:src/atdd/coach/graph/relationships.yaml"
+    reason: "the wagon urn rule presupposes the urn naming grammar"
+    source_ref: "planner.wagon.urn"
+    strength: "important"
+    target_ref: "planner.wagon.urn-naming"
+    type: "requires"