@afokapu/atdd-bun 0.3.2 → 0.4.0

package/detectors/planner_docs_capability/fixtures/clean/docs/purpose/journeys/svg/train-orders-ship-order.svg

@@ -0,0 +1,35 @@
+<svg xmlns="http://www.w3.org/2000/svg" class="atdd-diagram" width="586" height="229" viewBox="0 0 586 229" role="img" aria-labelledby="t-seq-orders-ship-order d-seq-orders-ship-order">
+<title id="t-seq-orders-ship-order">Ship the order</title><desc id="d-seq-orders-ship-order">1. checkout to fulfilment, orders:paid: Hand the paid order to fulfilment 2. fulfilment to carrier, orders:shipment: Book the shipment with the carrier 3. fulfilment to buyer, orders:tracking: Send tracking to the buyer</desc>
+<defs><marker id="seq-orders-ship-order-wagon" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="6" markerHeight="6" orient="auto"><path d="M0,0 L10,5 L0,10 z" style="fill: var(--atdd-ink-3, #64748b)"/></marker><marker id="seq-orders-ship-order-person" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="6" markerHeight="6" orient="auto"><path d="M0,0 L10,5 L0,10 z" style="fill: var(--atdd-person, #b45309)"/></marker><marker id="seq-orders-ship-order-system" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="6" markerHeight="6" orient="auto"><path d="M0,0 L10,5 L0,10 z" style="fill: var(--atdd-system, #7c3aed)"/></marker></defs>
+<line x1="100" y1="54" x2="100" y2="223" style="stroke: var(--atdd-line, #cbd5e1); stroke-width: 1.4; stroke-dasharray: 3 4"/>
+<rect x="41" y="10" width="118" height="44" rx="8" style="fill: var(--atdd-paper, #ffffff); stroke: var(--atdd-wagon, #2563eb); stroke-width: 1.8"/>
+<text x="100" y="32" text-anchor="middle" style="font-family: var(--atdd-sans, system-ui, sans-serif); font-size: 10.5px; font-weight: 600; fill: var(--atdd-ink, #1f2937)">checkout</text>
+<text x="100" y="47" text-anchor="middle" style="font-family: var(--atdd-mono, ui-monospace, monospace); font-size: 8px; letter-spacing: .1em; fill: var(--atdd-ink-3, #64748b)">WAGON</text>
+<line x1="232" y1="54" x2="232" y2="223" style="stroke: var(--atdd-line, #cbd5e1); stroke-width: 1.4; stroke-dasharray: 3 4"/>
+<rect x="173" y="10" width="118" height="44" rx="8" style="fill: var(--atdd-paper, #ffffff); stroke: var(--atdd-wagon, #2563eb); stroke-width: 1.8"/>
+<text x="232" y="32" text-anchor="middle" style="font-family: var(--atdd-sans, system-ui, sans-serif); font-size: 10.5px; font-weight: 600; fill: var(--atdd-ink, #1f2937)">fulfilment</text>
+<text x="232" y="47" text-anchor="middle" style="font-family: var(--atdd-mono, ui-monospace, monospace); font-size: 8px; letter-spacing: .1em; fill: var(--atdd-ink-3, #64748b)">WAGON</text>
+<line x1="364" y1="54" x2="364" y2="223" style="stroke: var(--atdd-line, #cbd5e1); stroke-width: 1.4; stroke-dasharray: 3 4"/>
+<rect x="305" y="10" width="118" height="44" rx="8" style="fill: var(--atdd-paper, #ffffff); stroke: var(--atdd-system, #7c3aed); stroke-width: 1.8"/>
+<text x="364" y="32" text-anchor="middle" style="font-family: var(--atdd-sans, system-ui, sans-serif); font-size: 10.5px; font-weight: 600; fill: var(--atdd-ink, #1f2937)">carrier</text>
+<text x="364" y="47" text-anchor="middle" style="font-family: var(--atdd-mono, ui-monospace, monospace); font-size: 8px; letter-spacing: .1em; fill: var(--atdd-ink-3, #64748b)">SYSTEM</text>
+<line x1="496" y1="54" x2="496" y2="223" style="stroke: var(--atdd-line, #cbd5e1); stroke-width: 1.4; stroke-dasharray: 3 4"/>
+<rect x="437" y="10" width="118" height="44" rx="8" style="fill: var(--atdd-paper, #ffffff); stroke: var(--atdd-person, #b45309); stroke-width: 1.8"/>
+<text x="496" y="32" text-anchor="middle" style="font-family: var(--atdd-sans, system-ui, sans-serif); font-size: 10.5px; font-weight: 600; fill: var(--atdd-ink, #1f2937)">buyer</text>
+<text x="496" y="47" text-anchor="middle" style="font-family: var(--atdd-mono, ui-monospace, monospace); font-size: 8px; letter-spacing: .1em; fill: var(--atdd-ink-3, #64748b)">PERSON</text>
+<text x="20" y="111" text-anchor="middle" style="font-family: var(--atdd-mono, ui-monospace, monospace); font-size: 9.5px; fill: var(--atdd-ink-3, #64748b)">1</text>
+<text x="96" y="84" text-anchor="start" style="font-family: var(--atdd-sans, system-ui, sans-serif); font-size: 11px; fill: var(--atdd-ink-2, #475569)">Hand the paid order to fulfilment</text>
+<text x="96" y="97" text-anchor="start" style="font-family: var(--atdd-mono, ui-monospace, monospace); font-size: 9px; fill: var(--atdd-accent, #0f766e)">orders:paid</text>
+<circle cx="100" cy="107" r="3" style="fill: var(--atdd-ink-3, #64748b)"/>
+<line x1="103" y1="107" x2="227" y2="107" style="stroke: var(--atdd-ink-3, #64748b); stroke-width: 1.7" marker-end="url(#seq-orders-ship-order-wagon)"/>
+<text x="20" y="160" text-anchor="middle" style="font-family: var(--atdd-mono, ui-monospace, monospace); font-size: 9.5px; fill: var(--atdd-ink-3, #64748b)">2</text>
+<text x="228" y="133" text-anchor="start" style="font-family: var(--atdd-sans, system-ui, sans-serif); font-size: 11px; fill: var(--atdd-ink-2, #475569)">Book the shipment with the carrier</text>
+<text x="228" y="146" text-anchor="start" style="font-family: var(--atdd-mono, ui-monospace, monospace); font-size: 9px; fill: var(--atdd-accent, #0f766e)">orders:shipment</text>
+<circle cx="232" cy="156" r="3" style="fill: var(--atdd-system, #7c3aed)"/>
+<line x1="235" y1="156" x2="359" y2="156" style="stroke: var(--atdd-system, #7c3aed); stroke-width: 1.7" marker-end="url(#seq-orders-ship-order-system)"/>
+<text x="20" y="209" text-anchor="middle" style="font-family: var(--atdd-mono, ui-monospace, monospace); font-size: 9.5px; fill: var(--atdd-ink-3, #64748b)">3</text>
+<text x="228" y="182" text-anchor="start" style="font-family: var(--atdd-sans, system-ui, sans-serif); font-size: 11px; fill: var(--atdd-ink-2, #475569)">Send tracking to the buyer</text>
+<text x="228" y="195" text-anchor="start" style="font-family: var(--atdd-mono, ui-monospace, monospace); font-size: 9px; fill: var(--atdd-accent, #0f766e)">orders:tracking</text>
+<circle cx="232" cy="205" r="3" style="fill: var(--atdd-person, #b45309)"/>
+<line x1="235" y1="205" x2="491" y2="205" style="stroke: var(--atdd-person, #b45309); stroke-width: 1.7" marker-end="url(#seq-orders-ship-order-person)"/>
+</svg>

package/detectors/planner_docs_capability/fixtures/clean/docs/purpose/journeys/svg/train-orders-take-payment.svg

@@ -0,0 +1,27 @@
+<svg xmlns="http://www.w3.org/2000/svg" class="atdd-diagram" width="360" height="247" viewBox="0 0 360 247" role="img" aria-labelledby="t-seq-orders-take-payment d-seq-orders-take-payment">
+<title id="t-seq-orders-take-payment">Take payment</title><desc id="d-seq-orders-take-payment">1. checkout to payment-gateway, orders:charge: Request the charge from the payment gateway 2. payment-gateway to checkout, orders:charge-result: Report whether the charge succeeded 3. checkout to checkout, orders:paid: Record the order as paid</desc>
+<defs><marker id="seq-orders-take-payment-wagon" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="6" markerHeight="6" orient="auto"><path d="M0,0 L10,5 L0,10 z" style="fill: var(--atdd-ink-3, #64748b)"/></marker><marker id="seq-orders-take-payment-person" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="6" markerHeight="6" orient="auto"><path d="M0,0 L10,5 L0,10 z" style="fill: var(--atdd-person, #b45309)"/></marker><marker id="seq-orders-take-payment-system" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="6" markerHeight="6" orient="auto"><path d="M0,0 L10,5 L0,10 z" style="fill: var(--atdd-system, #7c3aed)"/></marker></defs>
+<line x1="100" y1="54" x2="100" y2="241" style="stroke: var(--atdd-line, #cbd5e1); stroke-width: 1.4; stroke-dasharray: 3 4"/>
+<rect x="41" y="10" width="118" height="44" rx="8" style="fill: var(--atdd-paper, #ffffff); stroke: var(--atdd-wagon, #2563eb); stroke-width: 1.8"/>
+<text x="100" y="32" text-anchor="middle" style="font-family: var(--atdd-sans, system-ui, sans-serif); font-size: 10.5px; font-weight: 600; fill: var(--atdd-ink, #1f2937)">checkout</text>
+<text x="100" y="47" text-anchor="middle" style="font-family: var(--atdd-mono, ui-monospace, monospace); font-size: 8px; letter-spacing: .1em; fill: var(--atdd-ink-3, #64748b)">WAGON</text>
+<line x1="232" y1="54" x2="232" y2="241" style="stroke: var(--atdd-line, #cbd5e1); stroke-width: 1.4; stroke-dasharray: 3 4"/>
+<rect x="173" y="10" width="118" height="44" rx="8" style="fill: var(--atdd-paper, #ffffff); stroke: var(--atdd-system, #7c3aed); stroke-width: 1.8"/>
+<text x="232" y="32" text-anchor="middle" style="font-family: var(--atdd-sans, system-ui, sans-serif); font-size: 10.5px; font-weight: 600; fill: var(--atdd-ink, #1f2937)">payment-gateway</text>
+<text x="232" y="47" text-anchor="middle" style="font-family: var(--atdd-mono, ui-monospace, monospace); font-size: 8px; letter-spacing: .1em; fill: var(--atdd-ink-3, #64748b)">SYSTEM</text>
+<text x="20" y="111" text-anchor="middle" style="font-family: var(--atdd-mono, ui-monospace, monospace); font-size: 9.5px; fill: var(--atdd-ink-3, #64748b)">1</text>
+<text x="96" y="84" text-anchor="start" style="font-family: var(--atdd-sans, system-ui, sans-serif); font-size: 11px; fill: var(--atdd-ink-2, #475569)">Request the charge from the payment gateway</text>
+<text x="96" y="97" text-anchor="start" style="font-family: var(--atdd-mono, ui-monospace, monospace); font-size: 9px; fill: var(--atdd-accent, #0f766e)">orders:charge</text>
+<circle cx="100" cy="107" r="3" style="fill: var(--atdd-system, #7c3aed)"/>
+<line x1="103" y1="107" x2="227" y2="107" style="stroke: var(--atdd-system, #7c3aed); stroke-width: 1.7" marker-end="url(#seq-orders-take-payment-system)"/>
+<text x="20" y="160" text-anchor="middle" style="font-family: var(--atdd-mono, ui-monospace, monospace); font-size: 9.5px; fill: var(--atdd-ink-3, #64748b)">2</text>
+<text x="96" y="133" text-anchor="start" style="font-family: var(--atdd-sans, system-ui, sans-serif); font-size: 11px; fill: var(--atdd-ink-2, #475569)">Report whether the charge succeeded</text>
+<text x="96" y="146" text-anchor="start" style="font-family: var(--atdd-mono, ui-monospace, monospace); font-size: 9px; fill: var(--atdd-accent, #0f766e)">orders:charge-result</text>
+<circle cx="232" cy="156" r="3" style="fill: var(--atdd-system, #7c3aed)"/>
+<line x1="229" y1="156" x2="105" y2="156" style="stroke: var(--atdd-system, #7c3aed); stroke-width: 1.7" marker-end="url(#seq-orders-take-payment-system)"/>
+<text x="20" y="209" text-anchor="middle" style="font-family: var(--atdd-mono, ui-monospace, monospace); font-size: 9.5px; fill: var(--atdd-ink-3, #64748b)">3</text>
+<text x="96" y="182" text-anchor="start" style="font-family: var(--atdd-sans, system-ui, sans-serif); font-size: 11px; fill: var(--atdd-ink-2, #475569)">Record the order as paid</text>
+<text x="96" y="195" text-anchor="start" style="font-family: var(--atdd-mono, ui-monospace, monospace); font-size: 9px; fill: var(--atdd-accent, #0f766e)">orders:paid</text>
+<circle cx="100" cy="205" r="3" style="fill: var(--atdd-ink-3, #64748b)"/>
+<path d="M 100 205 h 32 v 18 h -26" style="fill: none; stroke: var(--atdd-ink-3, #64748b); stroke-width: 1.7" marker-end="url(#seq-orders-take-payment-wagon)"/>
+</svg>

package/detectors/planner_docs_capability/fixtures/clean/plan/_journeys/buy.yaml

@@ -0,0 +1,24 @@
+schema_version: 1.0.0
+journey_id: journey:buy
+title: Buy a product
+status: checked
+entrypoint:
+  interlocking_id: interlocking:checkout
+  exposed: true
+  actions: [place-order]
+  reason: null
+  surfaces: [frontend]
+continuations:
+  - from: { interlocking_id: interlocking:checkout, route_id: nominal }
+    artifact: orders:quote
+    to: { interlocking_id: interlocking:payment }
+  - from: { interlocking_id: interlocking:payment, route_id: charged }
+    artifact: orders:paid
+    to: { interlocking_id: interlocking:fulfilment }
+terminals:
+  - from: { interlocking_id: interlocking:checkout, route_id: empty-cart }
+    outcome: rejected
+  - from: { interlocking_id: interlocking:payment, route_id: declined }
+    outcome: declined
+  - from: { interlocking_id: interlocking:fulfilment, route_id: ship }
+    outcome: shipped

package/detectors/planner_docs_capability/fixtures/clean/plan/_themes.yaml

@@ -0,0 +1,3 @@
+themes:
+  "0": commons
+  "1": orders

package/detectors/planner_docs_capability/fixtures/clean/plan/_trains/_interlockings/checkout.yaml

@@ -0,0 +1,43 @@
+schema_version: 1.0.0
+interlocking_id: interlocking:checkout
+title: Checkout decision
+theme: orders
+status: checked
+source:
+  path: plan/_trains/_interlockings/checkout.yaml
+  content_digest: fixture
+entrypoint:
+  exposed: true
+  actions: [place-order]
+  reason: null
+  surfaces: [frontend]
+route_resolution:
+  strategy: fail_on_multiple_match
+lifelines:
+  - ref: wagon:checkout
+messages: []
+fragments:
+  - id: fragment:checkout
+    kind: alt
+    guards:
+      - id: guard:nominal
+        expression: cart.items > 0
+      - id: guard:empty-cart
+        expression: cart.items == 0
+routes:
+  - route_id: nominal
+    category: nominal
+    priority: 1
+    guard_ref: guard:nominal
+    train_id: train:orders:place-order
+    train_path: plan/_trains/orders/place-order.yaml
+    projection:
+      expected_sequence_digest: fixture
+  - route_id: empty-cart
+    category: error
+    priority: 2
+    guard_ref: guard:empty-cart
+    train_id: train:orders:reject-empty-cart
+    train_path: plan/_trains/orders/reject-empty-cart.yaml
+    projection:
+      expected_sequence_digest: fixture

package/detectors/planner_docs_capability/fixtures/clean/plan/_trains/_interlockings/fulfilment.yaml

@@ -0,0 +1,33 @@
+schema_version: 1.0.0
+interlocking_id: interlocking:fulfilment
+title: Fulfilment decision
+theme: orders
+status: checked
+source:
+  path: plan/_trains/_interlockings/fulfilment.yaml
+  content_digest: fixture
+entrypoint:
+  exposed: false
+  actions: []
+  reason: internal-transition-only
+  surfaces: [backend]
+route_resolution:
+  strategy: fail_on_multiple_match
+lifelines:
+  - ref: wagon:checkout
+messages: []
+fragments:
+  - id: fragment:fulfilment
+    kind: alt
+    guards:
+      - id: guard:ship
+        expression: order.paid
+routes:
+  - route_id: ship
+    category: nominal
+    priority: 1
+    guard_ref: guard:ship
+    train_id: train:orders:ship-order
+    train_path: plan/_trains/orders/ship-order.yaml
+    projection:
+      expected_sequence_digest: fixture

package/detectors/planner_docs_capability/fixtures/clean/plan/_trains/_interlockings/payment.yaml

@@ -0,0 +1,43 @@
+schema_version: 1.0.0
+interlocking_id: interlocking:payment
+title: Payment decision
+theme: orders
+status: checked
+source:
+  path: plan/_trains/_interlockings/payment.yaml
+  content_digest: fixture
+entrypoint:
+  exposed: false
+  actions: []
+  reason: internal-transition-only
+  surfaces: [backend]
+route_resolution:
+  strategy: fail_on_multiple_match
+lifelines:
+  - ref: wagon:checkout
+messages: []
+fragments:
+  - id: fragment:payment
+    kind: alt
+    guards:
+      - id: guard:charged
+        expression: quote.accepted and card.valid
+      - id: guard:declined
+        expression: card.declined
+routes:
+  - route_id: charged
+    category: nominal
+    priority: 1
+    guard_ref: guard:charged
+    train_id: train:orders:take-payment
+    train_path: plan/_trains/orders/take-payment.yaml
+    projection:
+      expected_sequence_digest: fixture
+  - route_id: declined
+    category: alternate
+    priority: 2
+    guard_ref: guard:declined
+    train_id: train:orders:retry-payment
+    train_path: plan/_trains/orders/retry-payment.yaml
+    projection:
+      expected_sequence_digest: fixture

package/detectors/planner_docs_capability/fixtures/clean/plan/_trains/_interlockings/returns.yaml

@@ -0,0 +1,33 @@
+schema_version: 1.0.0
+interlocking_id: interlocking:returns
+title: Returns decision
+theme: orders
+status: checked
+source:
+  path: plan/_trains/_interlockings/returns.yaml
+  content_digest: fixture
+entrypoint:
+  exposed: false
+  actions: []
+  reason: internal-transition-only
+  surfaces: [backend]
+route_resolution:
+  strategy: fail_on_multiple_match
+lifelines:
+  - ref: wagon:checkout
+messages: []
+fragments:
+  - id: fragment:returns
+    kind: alt
+    guards:
+      - id: guard:archive
+        expression: order.cancelled
+routes:
+  - route_id: archive
+    category: nominal
+    priority: 1
+    guard_ref: guard:archive
+    train_id: train:orders:archive-order
+    train_path: plan/_trains/orders/archive-order.yaml
+    projection:
+      expected_sequence_digest: fixture

package/detectors/planner_docs_capability/fixtures/clean/plan/_trains/orders/archive-order.yaml

@@ -0,0 +1,11 @@
+train_id: train:orders:archive-order
+title: Archive a cancelled order
+description: Archive a cancelled order.
+themes: [orders]
+participants: [wagon:checkout]
+sequence:
+  - step: 1
+    intent: Archive the cancelled order
+    from: wagon:checkout
+    to: wagon:checkout
+    artifact: orders:archived

package/detectors/planner_docs_capability/fixtures/clean/plan/_trains/orders/place-order.yaml

@@ -0,0 +1,21 @@
+train_id: train:orders:place-order
+title: Place an order
+description: Place an order.
+themes: [orders]
+participants: [user:buyer, wagon:checkout, wagon:pricing]
+sequence:
+  - step: 1
+    intent: Submit the cart for checkout
+    from: user:buyer
+    to: wagon:checkout
+    artifact: orders:cart
+  - step: 2
+    intent: Price the cart with current promotions
+    from: wagon:checkout
+    to: wagon:pricing
+    artifact: orders:priced-cart
+  - step: 3
+    intent: Return the priced quote
+    from: wagon:pricing
+    to: wagon:checkout
+    artifact: orders:quote

package/detectors/planner_docs_capability/fixtures/clean/plan/_trains/orders/reject-empty-cart.yaml

@@ -0,0 +1,16 @@
+train_id: train:orders:reject-empty-cart
+title: Reject an empty cart
+description: Reject an empty cart.
+themes: [orders]
+participants: [user:buyer, wagon:checkout]
+sequence:
+  - step: 1
+    intent: Submit an empty cart
+    from: user:buyer
+    to: wagon:checkout
+    artifact: orders:cart
+  - step: 2
+    intent: Refuse the empty cart and say why
+    from: wagon:checkout
+    to: user:buyer
+    artifact: orders:rejection

package/detectors/planner_docs_capability/fixtures/clean/plan/_trains/orders/retry-payment.yaml

@@ -0,0 +1,16 @@
+train_id: train:orders:retry-payment
+title: Retry a declined payment
+description: Retry a declined payment.
+themes: [orders]
+participants: [user:buyer, wagon:checkout]
+sequence:
+  - step: 1
+    intent: Ask the buyer for another payment method
+    from: wagon:checkout
+    to: user:buyer
+    artifact: orders:decline
+  - step: 2
+    intent: Provide a new payment method
+    from: user:buyer
+    to: wagon:checkout
+    artifact: orders:payment-method

package/detectors/planner_docs_capability/fixtures/clean/plan/_trains/orders/ship-order.yaml

@@ -0,0 +1,21 @@
+train_id: train:orders:ship-order
+title: Ship the order
+description: Ship the order.
+themes: [orders]
+participants: [system:carrier, user:buyer, wagon:checkout, wagon:fulfilment]
+sequence:
+  - step: 1
+    intent: Hand the paid order to fulfilment
+    from: wagon:checkout
+    to: wagon:fulfilment
+    artifact: orders:paid
+  - step: 2
+    intent: Book the shipment with the carrier
+    from: wagon:fulfilment
+    to: system:carrier
+    artifact: orders:shipment
+  - step: 3
+    intent: Send tracking to the buyer
+    from: wagon:fulfilment
+    to: user:buyer
+    artifact: orders:tracking

package/detectors/planner_docs_capability/fixtures/clean/plan/_trains/orders/take-payment.yaml

@@ -0,0 +1,21 @@
+train_id: train:orders:take-payment
+title: Take payment
+description: Take payment.
+themes: [orders]
+participants: [system:payment-gateway, wagon:checkout]
+sequence:
+  - step: 1
+    intent: Request the charge from the payment gateway
+    from: wagon:checkout
+    to: system:payment-gateway
+    artifact: orders:charge
+  - step: 2
+    intent: Report whether the charge succeeded
+    from: system:payment-gateway
+    to: wagon:checkout
+    artifact: orders:charge-result
+  - step: 3
+    intent: Record the order as paid
+    from: wagon:checkout
+    to: wagon:checkout
+    artifact: orders:paid

package/detectors/planner_docs_capability/fixtures/clean/plan/_trains/orders/unrouted-refund.yaml

@@ -0,0 +1,11 @@
+train_id: train:orders:unrouted-refund
+title: Refund an order
+description: Refund an order.
+themes: [orders]
+participants: [user:buyer, wagon:checkout]
+sequence:
+  - step: 1
+    intent: Ask for a refund
+    from: user:buyer
+    to: wagon:checkout
+    artifact: orders:refund-request

package/detectors/planner_docs_capability/fixtures/dirty_journey_view/docs/index.adoc

@@ -0,0 +1,3 @@
+= Docs
+:doc-id: root
+:status: current

package/detectors/planner_docs_capability/fixtures/dirty_journey_view/plan/_trains/_interlockings/fulfilment.yaml

@@ -0,0 +1,33 @@
+schema_version: 1.0.0
+interlocking_id: interlocking:fulfilment
+title: Fulfilment decision
+theme: orders
+status: checked
+source:
+  path: plan/_trains/_interlockings/fulfilment.yaml
+  content_digest: fixture
+entrypoint:
+  exposed: false
+  actions: []
+  reason: internal-transition-only
+  surfaces: [backend]
+route_resolution:
+  strategy: fail_on_multiple_match
+lifelines:
+  - ref: wagon:checkout
+messages: []
+fragments:
+  - id: fragment:fulfilment
+    kind: alt
+    guards:
+      - id: guard:ship
+        expression: order.paid
+routes:
+  - route_id: ship
+    category: nominal
+    priority: 1
+    guard_ref: guard:ship
+    train_id: train:orders:ship-order
+    train_path: plan/_trains/orders/ship-order.yaml
+    projection:
+      expected_sequence_digest: fixture

package/detectors/planner_static_validators/atdd.implementation.yaml

@@ -18,6 +18,7 @@ emits_rule_ids:
   - planner.wagon.telemetry-filesystem
   - planner.train.registry-coherence
   - planner.journey.continuation-closure
+  - planner.journey.interlocking-composed
 realizes_convention:
   - planner.wagon.urn
   - planner.wagon.urn-naming
@@ -32,5 +33,6 @@ realizes_convention:
   - planner.wagon.telemetry-filesystem
   - planner.train.registry-coherence
   - planner.journey.continuation-closure
+  - planner.journey.interlocking-composed
 entrypoint: detect.mjs
 report: detect.mjs

package/detectors/planner_static_validators/fixtures/dirty/plan/_trains/_interlockings/uncomposed.yaml

@@ -0,0 +1,4 @@
+interlocking_id: interlocking:uncomposed
+routes:
+  - route_id: nominal
+    train_id: train:journey:a

package/integrity.json

@@ -1,9 +1,9 @@
 {
-  "version": "0.3.2",
+  "version": "0.4.0",
   "files": {
     "HOOK_AUDIT.md": "5329d840db37671b1918f688ead26865473b87db73dbc75f7c8b2a8bbe8d6d43",
-    "PLANNER_PORT.md": "54ba452eb39cb5afb7c225363fddfd1bf9272ca1c12e7cbf6815a1dd464ff2b3",
-    "README.md": "506272551a4ad748537a2ade2a66219429eebba6e38fcd74c88e602bd94e0dbd",
+    "PLANNER_PORT.md": "fb5935bac8b7ac18994de21e43ace3a5ef8cd55f85b0e3349fca261280054f11",
+    "README.md": "2586b8a08916cc343f565f9986cffaff7f4a255460ad2f5a1f60538eaced707b",
     "bunfig.toml": "b9fc65eca9014c5179380259d70e76385a6a80788fa9a2df5fb3eaa5554fd2fe",
     "conventions/coder.bun/coder.bun.boundaries-http-client.convention.yaml": "b846bb6ced2c4c967466520d52b00ff1ca802dafcdbb2ec2adbd0ce19e752a28",
     "conventions/coder.bun/coder.bun.commons-application-no-integration.convention.yaml": "f63e7f6442bcdf5cf79f58a091547a1a990d0ee7c006b797fd5187d6f8bf8712",
@@ -76,6 +76,7 @@
     "conventions/planner.docs/planner.docs.doc-id-unique.convention.yaml": "eedfd745ff591591b2d50eabc65452f2a66759980c70a20690e208bd91f87c22",
     "conventions/planner.docs/planner.docs.graph-target-resolves.convention.yaml": "c7922b5c23a2e794a53a3ebebc5eeea9b54d8a0fe4bd2c418ac5a1758defaedc",
     "conventions/planner.docs/planner.docs.identity-required.convention.yaml": "d3826a9bc43187749627a97d679356e96b444163de6a3c6a3452b220f267d86e",
+    "conventions/planner.docs/planner.docs.journey-view-current.convention.yaml": "5892d4213d72342dc568c37f13942139bbdce4c0d5716075de579dc8060fc969",
     "conventions/planner.docs/planner.docs.reference-integrity.convention.yaml": "e3eb6e76807165a539d3fe1caa9c6f1cd0867a1cd13f44d986eb9f96cd26eff7",
     "conventions/planner.docs/planner.docs.undeclared-change.convention.yaml": "b3bfb9a738303567d295d5623d55289586bcca1926f923dcc0238cdb5cce1dae",
     "conventions/tester.bun/tester.bun.acceptance-binding-declared.convention.yaml": "aeaf824793b3a66db4d7fa7736f0bfb0d0f3dcb4ebce33d07a254d06d989ff1e",
@@ -555,7 +556,7 @@
     "detectors/htmx_tester_detector/fixtures/dirty/statusonly.test.ts": "a2daf2874bf68c6221374ac05619642a42d56b5d1f76e30fa3d2a1826adaf51b",
     "detectors/htmx_tester_detector/test_header.mjs": "a22221fe9ef6d10297ec777c5d0c6e7b84010ccf41e90db30c036206790ea198",
     "detectors/planner_docs_capability/README.md": "1e1f8ee258242c05293447fcde124543447ba375306e8a7e5f665881b038bcd1",
-    "detectors/planner_docs_capability/atdd.implementation.yaml": "d080cd4c80cf327c530d5ba724023c22c76f874831ab0b94af6589f5a3984588",
+    "detectors/planner_docs_capability/atdd.implementation.yaml": "7e88a43ee43f5131d25debcc8f02f7381c3b356b6d8ea14357a89ead8e83342e",
     "detectors/planner_docs_capability/detect.mjs": "d10773fa5b2d8f65ce351804694171a6eb75e05eb4c80fa1edce4a5d56b72c5d",
     "detectors/planner_docs_capability/fixtures/clean/docs/architecture/decisions/adr-20260906-001-shared-control-root.adoc": "6d30e5545e7b051c80605c3dbee50286f71e344ab2e71a987db945941de42523",
     "detectors/planner_docs_capability/fixtures/clean/docs/architecture/decisions/index.adoc": "4a6cb87e249d587c85bb6389ff5fecae7a96194af8677b588eed0c791099123b",
@@ -568,7 +569,29 @@
     "detectors/planner_docs_capability/fixtures/clean/docs/dist/index.md": "eac4d8fe653f45c959731cc08218d898e5123d685a1017191c4cffb626777f13",
     "detectors/planner_docs_capability/fixtures/clean/docs/index.adoc": "8aabcd7a4ecfc6ef565a604c1172364f761bef7d3fc4f2c96c07dce4e0ebe19b",
     "detectors/planner_docs_capability/fixtures/clean/docs/purpose/index.adoc": "e10193ea48f3c77b67ca8ed7221c53f23ce699e63f651cc340cea9ef6b44cffb",
+    "detectors/planner_docs_capability/fixtures/clean/docs/purpose/journeys/index.adoc": "9fcb12b48c936fe3f09fbacd7580d436c4919624aa0765cf7edfdc0ce1c77a9c",
+    "detectors/planner_docs_capability/fixtures/clean/docs/purpose/journeys/svg/journey-buy.svg": "ee965093b5691093548b0b5f33a329fc294140a14a032561fb010b27e2f849d6",
+    "detectors/planner_docs_capability/fixtures/clean/docs/purpose/journeys/svg/path-buy-nominal.svg": "f745c3d2713399f34326a6f75bce548d77d28c8453953611cd10db0c23e0b6a9",
+    "detectors/planner_docs_capability/fixtures/clean/docs/purpose/journeys/svg/train-orders-archive-order.svg": "149034cbed4598361aaf1a19dbc7964b728faf7fa1adc8419bbcf6aa7ff188d4",
+    "detectors/planner_docs_capability/fixtures/clean/docs/purpose/journeys/svg/train-orders-place-order.svg": "6bc482fa2c0d811b707ff5d166f0bb308eeac2a8b022d89e203d19b286843d59",
+    "detectors/planner_docs_capability/fixtures/clean/docs/purpose/journeys/svg/train-orders-reject-empty-cart.svg": "3129aaf3ea62f3643d095a3d4f653c849e8ee4473e655edd6d949e47df9c300b",
+    "detectors/planner_docs_capability/fixtures/clean/docs/purpose/journeys/svg/train-orders-retry-payment.svg": "6c936c4e0e7ede6bb2e7bb447b7782f7ed9db87c921293f43a3954bfae6d693e",
+    "detectors/planner_docs_capability/fixtures/clean/docs/purpose/journeys/svg/train-orders-ship-order.svg": "bf0b1e3a7cd40f66b9bc9ad91ae6302472f4bbdfb46c36cce84008ef493d6ce4",
+    "detectors/planner_docs_capability/fixtures/clean/docs/purpose/journeys/svg/train-orders-take-payment.svg": "8b6f705055c4b24e9e3070447073923f46cd968bc6fd2e1eca239f21d2499d3a",
     "detectors/planner_docs_capability/fixtures/clean/docs/purpose/worktrees.adoc": "de957bd8aec411c930fa9785d793c3345c82f5d7cb7f28f40f73f1c53a436440",
+    "detectors/planner_docs_capability/fixtures/clean/plan/_journeys/buy.yaml": "37a4e56cd44f1a7e33b7d3794ab2f178d5a6290574d5ead13ebd524356b5166c",
+    "detectors/planner_docs_capability/fixtures/clean/plan/_themes.yaml": "a8a4848d0df8c21eaad5563800e368330a0857593b9113db6a9608b08a7aa932",
+    "detectors/planner_docs_capability/fixtures/clean/plan/_trains/_interlockings/checkout.yaml": "ceb4414f8603b2357a4492d99132252e6024ff98d60b353c297b1ad421c9393e",
+    "detectors/planner_docs_capability/fixtures/clean/plan/_trains/_interlockings/fulfilment.yaml": "cbcb39a663952b583ba8b54bfd713a3faf68f86c9964d4bd45b60305d4416754",
+    "detectors/planner_docs_capability/fixtures/clean/plan/_trains/_interlockings/payment.yaml": "011fc6b445db43b71c06593ba15266dcb714ce557fa33391a736efb762816c8a",
+    "detectors/planner_docs_capability/fixtures/clean/plan/_trains/_interlockings/returns.yaml": "649fba5d83818342eecb7aa3cfb28494f631fc6239260359b7da665a4ccc0010",
+    "detectors/planner_docs_capability/fixtures/clean/plan/_trains/orders/archive-order.yaml": "951239c3492d668f46c9582032308b95fe5bd44b59f187c5f33f431e9f15e649",
+    "detectors/planner_docs_capability/fixtures/clean/plan/_trains/orders/place-order.yaml": "5563e0cd12856673c516c097597251c2d4e106f0de6727d3dad8aac45ec9bde6",
+    "detectors/planner_docs_capability/fixtures/clean/plan/_trains/orders/reject-empty-cart.yaml": "915d319db67d786c3c88a0d53d406e67cfdae343ae2e0529d5519c6649f33ace",
+    "detectors/planner_docs_capability/fixtures/clean/plan/_trains/orders/retry-payment.yaml": "2499a2706f9c8401f301997c86c6ce1b021050d78c050ce487b8d43ae555f855",
+    "detectors/planner_docs_capability/fixtures/clean/plan/_trains/orders/ship-order.yaml": "9f96d421caa225d2c62985b5a56e36dc5819369b222f6a7207c06e54e6f9866d",
+    "detectors/planner_docs_capability/fixtures/clean/plan/_trains/orders/take-payment.yaml": "4f3ef2cbb81e460032e48e11a9afb408c2aa8ab5c387c3c9a75a031136294ec2",
+    "detectors/planner_docs_capability/fixtures/clean/plan/_trains/orders/unrouted-refund.yaml": "e4f3094fe78e94cb2f40f4351a65e2bd12f56cc09fdf32af76b80a12c2530049",
     "detectors/planner_docs_capability/fixtures/dirty/docs/architecture/decisions/adr-20260906-001-shared-control-root.adoc": "6d30e5545e7b051c80605c3dbee50286f71e344ab2e71a987db945941de42523",
     "detectors/planner_docs_capability/fixtures/dirty/docs/architecture/decisions/index.adoc": "4a6cb87e249d587c85bb6389ff5fecae7a96194af8677b588eed0c791099123b",
     "detectors/planner_docs_capability/fixtures/dirty/docs/architecture/index.adoc": "d411bfc5e54c3a252c7f9549a2c62dd539e64f961f58b73b07c76b86708dc798",
@@ -621,6 +644,8 @@
     "detectors/planner_docs_capability/fixtures/dirty_identity/docs/index.adoc": "8aabcd7a4ecfc6ef565a604c1172364f761bef7d3fc4f2c96c07dce4e0ebe19b",
     "detectors/planner_docs_capability/fixtures/dirty_identity/docs/purpose/index.adoc": "e10193ea48f3c77b67ca8ed7221c53f23ce699e63f651cc340cea9ef6b44cffb",
     "detectors/planner_docs_capability/fixtures/dirty_identity/docs/purpose/worktrees.adoc": "de957bd8aec411c930fa9785d793c3345c82f5d7cb7f28f40f73f1c53a436440",
+    "detectors/planner_docs_capability/fixtures/dirty_journey_view/docs/index.adoc": "67b2010dc8b87ff55e500873dfb8ffad39e923c730adab0c92cb512b6d703edf",
+    "detectors/planner_docs_capability/fixtures/dirty_journey_view/plan/_trains/_interlockings/fulfilment.yaml": "cbcb39a663952b583ba8b54bfd713a3faf68f86c9964d4bd45b60305d4416754",
     "detectors/planner_docs_capability/fixtures/dirty_markdown/docs/architecture/decisions/adr-20260906-001-shared-control-root.adoc": "6d30e5545e7b051c80605c3dbee50286f71e344ab2e71a987db945941de42523",
     "detectors/planner_docs_capability/fixtures/dirty_markdown/docs/architecture/decisions/index.adoc": "4a6cb87e249d587c85bb6389ff5fecae7a96194af8677b588eed0c791099123b",
     "detectors/planner_docs_capability/fixtures/dirty_markdown/docs/architecture/index.adoc": "d411bfc5e54c3a252c7f9549a2c62dd539e64f961f58b73b07c76b86708dc798",
@@ -672,7 +697,7 @@
     "detectors/planner_schema_validation/fixtures/dirty/contracts/_contracts.yaml": "6460d5b8c73bb5f91ae356b29935c0a377cfef2d79ad6180e8cbb8a31fe2e882",
     "detectors/planner_schema_validation/fixtures/dirty/plan/_themes.yaml": "c3e8fb1939d83fdde56405ddfee68e266a16c4a7ed8439b6f7906d47372df473",
     "detectors/planner_schema_validation/fixtures/dirty/plan/_trains/orders.yaml": "ae2fdb750fd5a78c0baddd54fada48522671ae2a9a6538c50ab41ca32a90f682",
-    "detectors/planner_static_validators/atdd.implementation.yaml": "32a2069b412adc76c256090f74ee36d31e4aac15e93a388c601203f75fa5e68b",
+    "detectors/planner_static_validators/atdd.implementation.yaml": "030d9999473bd488590a608b6f60f97f2b2c484a183574581edaa262a2e24a10",
     "detectors/planner_static_validators/detect.mjs": "efbff2e8cd3f1b7d8e3240f132e90f09cc081b9352511f3ade67ec6fe06d124b",
     "detectors/planner_static_validators/fixtures/clean/contracts/_contracts.yaml": "967f4f0aac0be000cb6107dc735ca21b73a3a21870e9ada1396df445584cad41",
     "detectors/planner_static_validators/fixtures/clean/contracts/orders/placed.schema.json": "0b6380fb315749dc14f178b7320acfc2a6f025ee6acd118d7a99c3d190890816",
@@ -684,6 +709,7 @@
     "detectors/planner_static_validators/fixtures/dirty/plan/_themes.yaml": "0bbebb0019c7b9e161916d1690eaf334712cf889d91339204f90aab1cf57f434",
     "detectors/planner_static_validators/fixtures/dirty/plan/_trains.yaml": "13227735d3ac236794bf0b3c908bae1f017cffb6c172c384b402a3740c4519db",
     "detectors/planner_static_validators/fixtures/dirty/plan/_trains/_interlockings/journey-a.yaml": "be82f5e215a68661b2bdccb472c388afaa0a28a28e4bd9131617a2c600eb1254",
+    "detectors/planner_static_validators/fixtures/dirty/plan/_trains/_interlockings/uncomposed.yaml": "087f2f510a7eb51acb0ac69079f6e2406adab0119339e14ed0ff0e798d2b1354",
     "detectors/planner_static_validators/fixtures/dirty/plan/_trains/journey-a.yaml": "9d2d941030f0cce37ed6c5064c1511047e14bf1b22f68aba5c1c9dc96fe8adf0",
     "detectors/planner_static_validators/fixtures/dirty/plan/_trains/probe/legacy.yaml": "a75bbc5075dd705b3dc4900dc7d724b877ad12a97062ac5598365b1ce4f06657",
     "detectors/planner_static_validators/fixtures/dirty/plan/_trains/probe/orphan.yaml": "2f11ecabc73d4fe4a18cd732376f653291d6ba8aacd4678e191949a2583c3e96",
@@ -693,7 +719,7 @@
     "detectors/planner_static_validators/fixtures/dirty/plan/dup/features/bad.yaml": "2a78ee5d50e119e2b1ab400ac5606a6625c0ebab60391f51a7bc294d8649d3ec",
     "lib/imports.mjs": "3db4979269488fa26f6e7aefded6ece9c646be6587a10e249821a5a208109962",
     "lib/scan.mjs": "8e090f131baca95cda6ad4ca4ff6e836fda9c9673547ad1d5b971ec0e7d89abf",
-    "planner-nodes/ENFORCEMENT_SCOPE.yaml": "8b7748438343220ac37a422471faf60888e811fe1ec5192adad14e6e0d2543e0",
+    "planner-nodes/ENFORCEMENT_SCOPE.yaml": "1a77eea0ec17bc937ce538ab5d3eb31a87c420752d4657e57969048dd4fb60a2",
     "planner-nodes/nodes/planner.acceptance.abstract-fields-required.convention.yaml": "bd565693f0ae861f0561ad2f7a91a8c55f9a209c3acd59c5750cfcffd96a85d8",
     "planner-nodes/nodes/planner.acceptance.authoring-guidelines.convention.yaml": "16348dceed5868041b832bde766e9c8d4a950d4032f1f3066b357644081a3b17",
     "planner-nodes/nodes/planner.acceptance.boundary-kind-vocabulary.convention.yaml": "c5645225399568c2d4fe632442f9c597b2c59e4f4239880df7db2cbdc0353c9c",
@@ -800,6 +826,7 @@
     "planner-nodes/nodes/planner.issue-body.graph-context-required.convention.yaml": "6292ab37efda9fbdd1e028283bed7c594baa4e070266795180a3bcded2760621",
     "planner-nodes/nodes/planner.journey.continuation-closure.convention.yaml": "56c447b05cfe98804ea53bdde68ad940138093a4341620872e9b5c61be08869c",
     "planner-nodes/nodes/planner.journey.definition.convention.yaml": "a163bb9d5140d17a0dac996d84a8efc9f833592407dbebaec94db25006e88e28",
+    "planner-nodes/nodes/planner.journey.interlocking-composed.convention.yaml": "91d3f1a9061a1fccaeeb52a07f1459f93f665d310dc453fecbd5db23c603a7ec",
     "planner-nodes/nodes/planner.plan.confirm-before-author.convention.yaml": "23116f68ce81ff78ab57d362cf7195c4bf637781d74df4aece4d61eafbf0a49b",
     "planner-nodes/nodes/planner.plan.confirm-binds-an-issue.convention.yaml": "27de0e84fb7181a6768c65c30865fecdf94a3beddc3a47a4d6de226aaf014767",
     "planner-nodes/nodes/planner.plan.confirm-requires-interlocking-sanity.convention.yaml": "7ae7d9c6c70d0f4d3e50ae81f1d9f18ee1f70f348bee33147ee99d2d3d4a4de4",
@@ -910,17 +937,19 @@
     "planner-schemas/train.schema.json": "d6fbac9067c1bffeb84eb79a71228441055af6e6e7ba141dd4e0bcb079345ec0",
     "planner-schemas/wagon.schema.json": "57b98f1ade998d745538eb3d72fb3014a50042006870f90bce47028eea336eb4",
     "planner-schemas/wmbt.schema.json": "7a3a5693bfcf01340667c2be4a3c48e74f34b1af7e8dc13372c0de06b7f4fe12",
+    "relationships.yaml": "6e1888d37b56cc6a092137c0e0949bddf3a47560945ad09b20d30580dfb318e8",
     "src/agent.ts": "38a14f0f2ccce357efb1b2927e59bf55c20ff0050374367f15da36db20c46e77",
     "src/ci.ts": "899125ec76d14f7d0126a5db2249913e373e3a325cbc98d7f053e1351bdf47af",
-    "src/cli.ts": "326ecd3b29ee08078df39982214909322cc96ca7d7e4739523152d0baf4bb535",
-    "src/docs-capability.ts": "5e24ac316e7543782ccc8d8ec6e23f01161295aeb4e874a9c5ff0a8181f79475",
+    "src/cli.ts": "bb2047cee60f48bfe3eaee4c1b3dcd3538a0e1edc170cf58e87686117bea07a7",
+    "src/docs-capability.ts": "65ef91658664b41b78184b395e57e5d28bda16128caa9e314f26e63568abc6cd",
     "src/enforce.ts": "b7c7eae54c6aa2ba58ecf9dfa7c751c64328263b7241ac6c1a68210e2b7df313",
     "src/hooks.ts": "88f78d9aa7b8182a3d7080cb94dab2a17a934c7437b5dd861dd428694908e72c",
-    "src/index.ts": "5b93f3df3cce6366c7f3975969f8dc69b3fe43bc2898257f8781f789f83687e7",
+    "src/index.ts": "67ea1a791b3a625882d3ff6b981092f3764b694e660194736ecf53dac0890563",
     "src/integrity.ts": "48d7adce486ece1885a95aac6867d286bb972d7a97bdbc32222fd6d75c2e2b49",
+    "src/journey-docs.ts": "994d229376244c84212cff951032823068a76565dd2fd427b9d44e341bd14853",
     "src/planner-kernel.ts": "b201fe5a76e5298a3a3fcd11adbf0f47bfd8a565246c84d23db5d4d7bf0a3356",
     "src/planner-schema-validator.ts": "881ee4eb39db13471684854f9d1a667a5ef4451b104af2f6574ff0c237922217",
-    "src/planner-validators.ts": "e584486617c5f7d799c2d9d1be8356157ea0a80c72de2fa714f5689cee001d9e",
+    "src/planner-validators.ts": "882c12c7ce4f8bf98eda71cd33c23ac8c224c28703e10ebef63288c1017757d5",
     "src/register.ts": "6a2f1c6b8df0dc9c8f45df8ec9fac2be29044e048b08c8ffe423410e94dadedd",
     "src/release.ts": "7b0fe444ee81f476f53b9c21b6c347ef588ee616c60211419cf984132be768ba",
     "src/setup.ts": "0a6f1a9aeff31dcf17f6bd036168b909c1841c11bbbb452105d8debf64a6bc78",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@afokapu/atdd-bun",
-  "version": "0.3.2",
+  "version": "0.4.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/afokapu/atdd-bun.git"
@@ -24,7 +24,8 @@
     "PLANNER_PORT.md",
     "HOOK_AUDIT.md",
     "templates",
-    "integrity.json"
+    "integrity.json",
+    "relationships.yaml"
   ],
   "scripts": {
     "test": "bun test",

package/planner-nodes/ENFORCEMENT_SCOPE.yaml

@@ -2,7 +2,7 @@ schema_version: "1.0.0"
 package: "@afokapu/atdd-bun"
 node_corpus:
   source: "src/atdd/planner/conventions/nodes/"
-  count: 195
+  count: 196
   policy: >-
     Every node is shipped as canonical planner reference material. A node is not
     represented as enforced merely because it is present in this corpus.
@@ -31,6 +31,12 @@ canonical_bun_enforcement:
       - continuation artifacts occur in the selected train sequence
       - continuation destinations resolve to interlockings
       - disconnected continuation or terminal sources are rejected
+  - rule_id: planner.journey.interlocking-composed
+    origin: bun-custom-validator
+    coverage: complete
+    predicates:
+      - a plan that declares interlockings declares at least one journey
+      - every interlocking is a journey entrypoint or the destination of a continuation reachable from one
   - rule_id: planner.wagon.no-consume-cycle
     origin: core-validator-port
     coverage: partial