@afokapu/atdd-bun 0.3.2 → 0.4.0

package/PLANNER_PORT.md

@@ -5,7 +5,7 @@ to port ATDD's full planner yet.
 
 ## Portable planner kernel
 
-The package ships 195 canonical convention nodes in `planner-nodes/` and
+The package ships 196 canonical convention nodes in `planner-nodes/` and
 21 schemas in `planner-schemas/`. It does not ship Python validator files:
 they are executable Python/pytest code, not portable package assets. Port each
 selected validator into Bun/TypeScript before enabling it in a `planner` profile.

package/README.md

@@ -98,7 +98,7 @@ name.
 |---|---|
 | `traceability` | plan acceptance, Bun test, and implementation closure |
 | `planner` | plan parsing/graph integrity plus the explicitly scoped planner rules |
-| `docs` | the optional documentation capability and its declared artifacts |
+| `docs` | the optional documentation capability and its declared artifacts, including the generated journey view |
 | `coder`, `tester`, `security`, `architecture`, `metrics`, `runtime` | Bun source and test conventions for that concern |
 | `interlocking` | declared train/interlocking binding, infrastructure, and coverage |
 | `htmx` | htmx-specific source and test conventions |
@@ -146,6 +146,50 @@ every exported component has a consumer. Defining a custom property
 (`--accent: #0ea5e9`) is defining a token and is allowed anywhere. A repository
 without a design directory is not judged by these rules.
 
+### Journey documentation
+
+A plan describes behaviour on three levels. A journey (`plan/_journeys/`) enters
+at one interlocking and continues, through an artifact the selected train
+produces, into the next one. An interlocking chooses one route by its guards.
+A route runs one train, a linear sequence of handovers. Generate the view of all
+three from `plan/`:
+
+```sh
+bun run atdd-bun docs journeys          # writes docs/purpose/journeys/
+bun run atdd-bun docs journeys --check  # fails when the committed view differs from plan/
+```
+
+It writes `docs/purpose/journeys/index.adoc` and one SVG for each of:
+
+- **journey map:** the entry action, each interlocking, the routes it chooses
+  and their guards, the trains they run, continuations (labelled with the
+  artifact that carries control) and terminal outcomes;
+- **nominal path, end to end:** the journey's trains across all its
+  interlockings, joined into one sequence diagram;
+- **train:** each routed train as its own sequence diagram, under its
+  interlocking's route table.
+
+The page also tables every path with how it ends, and every **gap**: unreached
+interlockings, routes with no continuation or outcome, unrouted trains,
+unresolved guards. Participants are coloured by what they are (wagon, person,
+outside system) and arrows by the boundary they cross. Diagrams are inlined
+(`opts=inline`) and coloured with `var(--atdd-*, fallback)`, so a doc site can
+theme them by defining `--atdd-ink`, `--atdd-paper`, `--atdd-wagon`,
+`--atdd-person`, `--atdd-system`, `--atdd-nominal`, `--atdd-alternate`,
+`--atdd-error`, `--atdd-exception`, and the like. The output carries no
+timestamp and no package version, so it changes only when the plan does.
+
+The planner requires the journey level itself: `planner.journey.interlocking-composed`
+fails when a plan declares interlockings and no journey, or when an interlocking
+is neither a journey's entrypoint nor reached by one of its continuations.
+`planner.journey.continuation-closure` then checks each declared journey closes.
+
+**Required.** In a repository with `docs/` whose plan has journeys or
+interlockings, the `docs` profile's `planner.docs.journey-view-current` rule
+fails when any generated file is missing, stale, hand-edited, or extra. The
+generator refuses to overwrite a hand-written `index.adoc` unless you pass
+`--force`; use `--out <dir>` to preview elsewhere.
+
 ### Theme and contract registry
 
 Theme vocabulary belongs to the repository, not the package. When a plan uses
@@ -391,6 +435,17 @@ It creates no tag, makes no network request, and does not publish anything.
 The separate optional release workflow is where a repository may create a tag or
 publish using its own credentials and registry configuration.
 
+## Convention relationships
+
+`relationships.yaml` relates every convention the package ships (`planner-nodes/`
+and `conventions/`) to at least one other, as
+`planner.relationship.no-orphan-nodes` requires. Edges that touch a shipped
+convention are imported from the upstream ATDD graphs with their `origin`; the
+package adds its own for the conventions it introduces. A test fails when any
+shipped convention has no edge, when the node list drifts from the shipped
+conventions, or when an edge breaks `relationship.schema.json`, so a new
+convention cannot land without its relationships.
+
 ## Verification of this package
 
 `bun test` runs the package’s real-Git fixtures and detector clean/dirty corpora.

package/conventions/planner.docs/planner.docs.journey-view-current.convention.yaml

@@ -0,0 +1,53 @@
+schema_version: 1.1.0
+rule_id: planner.docs.journey-view-current
+kind: rule
+status: active
+name: The journey documentation is generated from plan/ and matches it
+statement: >-
+  When a repository documents itself (`docs/` exists) and its plan declares journeys or interlockings,
+  `docs/purpose/journeys/` MUST contain exactly what `atdd-bun docs journeys` generates from `plan/`:
+  `index.adoc` and one SVG per journey map, per journey's nominal path, and per routed train. A missing,
+  stale, hand-edited, or extra file is a violation.
+terms:
+- term_id: journey_view
+  text: >-
+    the generated page, top down: each journey as a map (entry action, interlockings, the routes they
+    choose, the trains they run, continuations and terminal outcomes); the journey's nominal path walked
+    end to end as one sequence across its interlockings; every path as a table; each interlocking's
+    routes with their guards; each train as a sequence diagram; and a table of what the plan leaves
+    unconnected.
+- term_id: generated
+  text: >-
+    byte-for-byte what the installed package renders from the current `plan/`. The output carries no
+    timestamp and no package version, so it changes only when the plan (or the renderer) does.
+content:
+  summary: >-
+    A journey page drawn by hand drifts from the plan it describes the moment either changes. Generating
+    it, and failing when the committed copy differs, keeps the documented journeys the planned journeys,
+    and keeps the plan's gaps (unreached interlockings, open routes, unrouted trains) visible.
+  normative_text: |
+    The view renders planned behaviour, not acceptance evidence. It is generated so that reviewing a
+    decomposition does not require reading interlocking YAML: who hands what to whom, which guard
+    selects which route, and where each path ends.
+
+    The gaps table is part of the contract. A plan with interlockings but no journey still gets a page;
+    it shows every interlocking as unreached, which is the truthful state of the decomposition.
+  fix_hint: |
+    Regenerate and commit:
+
+      bun run atdd-bun docs journeys
+
+    If `docs/purpose/journeys/index.adoc` is a hand-written page, move its content elsewhere (the
+    generator refuses to overwrite it without --force). Change the plan, never the generated files.
+  exceptions:
+  - A repository with no `docs/` directory is not in scope.
+  - A plan with no journey and no interlocking is not in scope.
+metadata:
+  aliases:
+  - DOCS-JOURNEY-VIEW-001
+  severity: 3
+  disposition: strict
+  introduced_in: 0.4.0
+implementation:
+  type: validator
+  ref: docs_capability

package/detectors/planner_docs_capability/atdd.implementation.yaml

@@ -21,6 +21,7 @@ realizes_convention:
   - planner.docs.artifact-path-shape
   - planner.docs.undeclared-change
   - planner.docs.reference-integrity
+  - planner.docs.journey-view-current
 
 # The filesystem report emits the six corpus-observable rules. The Bun capability
 # API additionally evaluates declaration-only rules and reference integrity.
@@ -31,6 +32,7 @@ emits_rule_ids:
   - planner.docs.graph-target-resolves  # disposition: advisory (edge names an undeclared id)
   - planner.docs.area-index-required    # disposition: advisory (area exists, no index.adoc)
   - planner.docs.adr-registry-derived   # disposition: advisory (registry drifted from :decides:)
+  - planner.docs.journey-view-current  # disposition: strict (generated journey view differs from plan/)
 
 # TWO SURFACES, ONE DETECTOR.
 #

package/detectors/planner_docs_capability/fixtures/clean/docs/purpose/journeys/index.adoc

@@ -0,0 +1,170 @@
+= Journeys
+:doc-id: purpose.journeys
+:status: generated
+:toc: left
+:toclevels: 2
+:sectanchors:
+
+// Generated by @afokapu/atdd-bun from plan/. Do not edit; run `atdd-bun docs journeys`.
+
+[.headline]
+The journeys this plan declares, the interlockings they pass through, and the trains those run, drawn from `plan/`. These are planned behaviour, not acceptance evidence.
+
+== Coverage
+
+[cols="1,1,1,1,1",options="header"]
+|===
+| Journeys | Interlockings reached | Routes | Trains | Gaps
+
+| 1
+| 3 of 4
+| 6
+| 7
+| 2
+|===
+
+== Gaps
+
+What the plan leaves unconnected. Each row is a decision still to be made in `plan/`.
+
+[cols="1,2,3",options="header"]
+|===
+| Gap | Subject | Detail
+
+| unreached interlocking
+| `+interlocking:returns+`
+| no journey enters or continues into it
+
+| unrouted train
+| `+train:orders:unrouted-refund+`
+| no interlocking route selects it
+
+|===
+
+== Buy a product
+
+`+journey:buy+` · checked · enters at `+interlocking:checkout+` · exposed through `+place-order+` · source `+plan/_journeys/buy.yaml+`
+
+image::svg/journey-buy.svg[Buy a product journey map,opts=inline]
+
+=== Nominal path, end to end
+
+Checkout decision → nominal ⇒ Payment decision → charged ⇒ Fulfilment decision → ship ⇒ *shipped*
+
+image::svg/path-buy-nominal.svg[Buy a product nominal path,opts=inline]
+
+=== Every path
+
+[cols="1,6,2",options="header"]
+|===
+| # | Interlocking → route, in order | Ends
+
+| 1
+| Checkout decision → nominal ⇒ Payment decision → charged ⇒ Fulfilment decision → ship
+| shipped
+
+| 2
+| Checkout decision → nominal ⇒ Payment decision → declined
+| declined
+
+| 3
+| Checkout decision → empty-cart
+| rejected
+
+|===
+
+== Interlockings and their trains
+
+=== Checkout decision
+
+`+interlocking:checkout+` · exposed through `+place-order+` · source `+plan/_trains/_interlockings/checkout.yaml+`
+
+[cols="1,1,3,3",options="header"]
+|===
+| Priority | Category | Taken when | Runs
+
+| 1
+| nominal
+| `+cart.items > 0+`
+| `+train:orders:place-order+`
+
+| 2
+| error
+| `+cart.items == 0+`
+| `+train:orders:reject-empty-cart+`
+
+|===
+
+==== nominal (nominal): Place an order
+
+image::svg/train-orders-place-order.svg[Place an order,opts=inline]
+
+==== empty-cart (error): Reject an empty cart
+
+image::svg/train-orders-reject-empty-cart.svg[Reject an empty cart,opts=inline]
+
+=== Fulfilment decision
+
+`+interlocking:fulfilment+` · internal · source `+plan/_trains/_interlockings/fulfilment.yaml+`
+
+[cols="1,1,3,3",options="header"]
+|===
+| Priority | Category | Taken when | Runs
+
+| 1
+| nominal
+| `+order.paid+`
+| `+train:orders:ship-order+`
+
+|===
+
+==== ship (nominal): Ship the order
+
+image::svg/train-orders-ship-order.svg[Ship the order,opts=inline]
+
+=== Payment decision
+
+`+interlocking:payment+` · internal · source `+plan/_trains/_interlockings/payment.yaml+`
+
+[cols="1,1,3,3",options="header"]
+|===
+| Priority | Category | Taken when | Runs
+
+| 1
+| nominal
+| `+quote.accepted and card.valid+`
+| `+train:orders:take-payment+`
+
+| 2
+| alternate
+| `+card.declined+`
+| `+train:orders:retry-payment+`
+
+|===
+
+==== charged (nominal): Take payment
+
+image::svg/train-orders-take-payment.svg[Take payment,opts=inline]
+
+==== declined (alternate): Retry a declined payment
+
+image::svg/train-orders-retry-payment.svg[Retry a declined payment,opts=inline]
+
+=== Returns decision
+
+`+interlocking:returns+` · internal · source `+plan/_trains/_interlockings/returns.yaml+`
+
+[cols="1,1,3,3",options="header"]
+|===
+| Priority | Category | Taken when | Runs
+
+| 1
+| nominal
+| `+order.cancelled+`
+| `+train:orders:archive-order+`
+
+|===
+
+==== archive (nominal): Archive a cancelled order
+
+image::svg/train-orders-archive-order.svg[Archive a cancelled order,opts=inline]

package/detectors/planner_docs_capability/fixtures/clean/docs/purpose/journeys/svg/journey-buy.svg

@@ -0,0 +1,61 @@
+<svg xmlns="http://www.w3.org/2000/svg" class="atdd-diagram" width="504" height="966" viewBox="0 0 504 966" role="img" aria-labelledby="t-map-buy d-map-buy">
+<title id="t-map-buy">Buy a product — journey map</title><desc id="d-map-buy">Journey Buy a product: enters at interlocking:checkout; 2 continuation(s), 3 terminal outcome(s).</desc>
+<defs><marker id="map-buy-arrow" 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></defs>
+<path d="M 252 88 C 252 132, 252 116, 252 158" style="fill: none; stroke: var(--atdd-ink-3, #64748b); stroke-width: 1.6" marker-end="url(#map-buy-arrow)"/>
+<path d="M 252 210 C 252 254, 138 238, 138 280" style="fill: none; stroke: var(--atdd-nominal, #15803d); stroke-width: 1.6" marker-end="url(#map-buy-arrow)"/>
+<path d="M 138 332 C 138 376, 138 360, 138 402" style="fill: none; stroke: var(--atdd-accent, #0f766e); stroke-width: 1.6" marker-end="url(#map-buy-arrow)"/>
+<path d="M 252 210 C 252 254, 366 238, 366 280" style="fill: none; stroke: var(--atdd-error, #b91c1c); stroke-width: 1.6" marker-end="url(#map-buy-arrow)"/>
+<path d="M 366 332 C 366 376, 366 360, 366 402" style="fill: none; stroke: var(--atdd-terminal, #334155); stroke-width: 1.6" marker-end="url(#map-buy-arrow)"/>
+<path d="M 138 454 C 138 498, 138 482, 138 524" style="fill: none; stroke: var(--atdd-nominal, #15803d); stroke-width: 1.6" marker-end="url(#map-buy-arrow)"/>
+<path d="M 138 576 C 138 620, 138 604, 138 646" style="fill: none; stroke: var(--atdd-accent, #0f766e); stroke-width: 1.6" marker-end="url(#map-buy-arrow)"/>
+<path d="M 138 454 C 138 498, 366 482, 366 524" style="fill: none; stroke: var(--atdd-alternate, #2563eb); stroke-width: 1.6" marker-end="url(#map-buy-arrow)"/>
+<path d="M 366 576 C 366 620, 366 604, 366 646" style="fill: none; stroke: var(--atdd-terminal, #334155); stroke-width: 1.6" marker-end="url(#map-buy-arrow)"/>
+<path d="M 138 698 C 138 742, 252 726, 252 768" style="fill: none; stroke: var(--atdd-nominal, #15803d); stroke-width: 1.6" marker-end="url(#map-buy-arrow)"/>
+<path d="M 252 820 C 252 864, 252 848, 252 890" style="fill: none; stroke: var(--atdd-terminal, #334155); stroke-width: 1.6" marker-end="url(#map-buy-arrow)"/>
+<rect x="152" y="38" width="200" height="50" rx="25" style="fill: var(--atdd-paper, #ffffff); stroke: var(--atdd-ink-2, #475569); stroke-width: 1.6"/>
+<text x="252" y="61" text-anchor="middle" style="font-family: var(--atdd-sans, system-ui, sans-serif); font-size: 11px; font-weight: 600; fill: var(--atdd-ink, #1f2937)">place-order</text>
+<text x="252" y="80" text-anchor="middle" style="font-family: var(--atdd-mono, ui-monospace, monospace); font-size: 8px; letter-spacing: .08em; fill: var(--atdd-ink-2, #475569)">STATION MASTER ACTION</text>
+<rect x="152" y="160" width="200" height="50" rx="6" style="fill: var(--atdd-paper, #ffffff); stroke: var(--atdd-ink, #1f2937); stroke-width: 2.2"/>
+<path d="M 166 185 l 7 -7 l 7 7 l -7 7 z" style="fill: var(--atdd-ink, #1f2937)"/>
+<text x="262" y="183" text-anchor="middle" style="font-family: var(--atdd-sans, system-ui, sans-serif); font-size: 11px; font-weight: 600; fill: var(--atdd-ink, #1f2937)">Checkout decision</text>
+<text x="262" y="202" text-anchor="middle" style="font-family: var(--atdd-mono, ui-monospace, monospace); font-size: 8px; letter-spacing: .08em; fill: var(--atdd-ink, #1f2937)">INTERLOCKING · 2 ROUTES</text>
+<rect x="38" y="282" width="200" height="50" rx="6" style="fill: var(--atdd-paper, #ffffff); stroke: var(--atdd-nominal, #15803d); stroke-width: 1.6"/>
+<text x="138" y="305" text-anchor="middle" style="font-family: var(--atdd-sans, system-ui, sans-serif); font-size: 11px; font-weight: 600; fill: var(--atdd-ink, #1f2937)">Place an order</text>
+<text x="138" y="324" text-anchor="middle" style="font-family: var(--atdd-mono, ui-monospace, monospace); font-size: 8px; letter-spacing: .08em; fill: var(--atdd-nominal, #15803d)">NOMINAL · 3 STEPS</text>
+<rect x="266" y="282" width="200" height="50" rx="6" style="fill: var(--atdd-paper, #ffffff); stroke: var(--atdd-error, #b91c1c); stroke-width: 1.6"/>
+<text x="366" y="305" text-anchor="middle" style="font-family: var(--atdd-sans, system-ui, sans-serif); font-size: 11px; font-weight: 600; fill: var(--atdd-ink, #1f2937)">Reject an empty cart</text>
+<text x="366" y="324" text-anchor="middle" style="font-family: var(--atdd-mono, ui-monospace, monospace); font-size: 8px; letter-spacing: .08em; fill: var(--atdd-error, #b91c1c)">ERROR · 2 STEPS</text>
+<rect x="266" y="404" width="200" height="50" rx="25" style="fill: var(--atdd-paper, #ffffff); stroke: var(--atdd-terminal, #334155); stroke-width: 1.6"/>
+<text x="366" y="427" text-anchor="middle" style="font-family: var(--atdd-sans, system-ui, sans-serif); font-size: 11px; font-weight: 600; fill: var(--atdd-ink, #1f2937)">rejected</text>
+<text x="366" y="446" text-anchor="middle" style="font-family: var(--atdd-mono, ui-monospace, monospace); font-size: 8px; letter-spacing: .08em; fill: var(--atdd-terminal, #334155)">OUTCOME</text>
+<rect x="38" y="404" width="200" height="50" rx="6" style="fill: var(--atdd-paper, #ffffff); stroke: var(--atdd-ink, #1f2937); stroke-width: 2.2"/>
+<path d="M 52 429 l 7 -7 l 7 7 l -7 7 z" style="fill: var(--atdd-ink, #1f2937)"/>
+<text x="148" y="427" text-anchor="middle" style="font-family: var(--atdd-sans, system-ui, sans-serif); font-size: 11px; font-weight: 600; fill: var(--atdd-ink, #1f2937)">Payment decision</text>
+<text x="148" y="446" text-anchor="middle" style="font-family: var(--atdd-mono, ui-monospace, monospace); font-size: 8px; letter-spacing: .08em; fill: var(--atdd-ink, #1f2937)">INTERLOCKING · 2 ROUTES</text>
+<rect x="38" y="526" width="200" height="50" rx="6" style="fill: var(--atdd-paper, #ffffff); stroke: var(--atdd-nominal, #15803d); stroke-width: 1.6"/>
+<text x="138" y="549" text-anchor="middle" style="font-family: var(--atdd-sans, system-ui, sans-serif); font-size: 11px; font-weight: 600; fill: var(--atdd-ink, #1f2937)">Take payment</text>
+<text x="138" y="568" text-anchor="middle" style="font-family: var(--atdd-mono, ui-monospace, monospace); font-size: 8px; letter-spacing: .08em; fill: var(--atdd-nominal, #15803d)">NOMINAL · 3 STEPS</text>
+<rect x="266" y="526" width="200" height="50" rx="6" style="fill: var(--atdd-paper, #ffffff); stroke: var(--atdd-alternate, #2563eb); stroke-width: 1.6"/>
+<text x="366" y="549" text-anchor="middle" style="font-family: var(--atdd-sans, system-ui, sans-serif); font-size: 11px; font-weight: 600; fill: var(--atdd-ink, #1f2937)">Retry a declined payment</text>
+<text x="366" y="568" text-anchor="middle" style="font-family: var(--atdd-mono, ui-monospace, monospace); font-size: 8px; letter-spacing: .08em; fill: var(--atdd-alternate, #2563eb)">ALTERNATE · 2 STEPS</text>
+<rect x="266" y="648" width="200" height="50" rx="25" style="fill: var(--atdd-paper, #ffffff); stroke: var(--atdd-terminal, #334155); stroke-width: 1.6"/>
+<text x="366" y="671" text-anchor="middle" style="font-family: var(--atdd-sans, system-ui, sans-serif); font-size: 11px; font-weight: 600; fill: var(--atdd-ink, #1f2937)">declined</text>
+<text x="366" y="690" text-anchor="middle" style="font-family: var(--atdd-mono, ui-monospace, monospace); font-size: 8px; letter-spacing: .08em; fill: var(--atdd-terminal, #334155)">OUTCOME</text>
+<rect x="38" y="648" width="200" height="50" rx="6" style="fill: var(--atdd-paper, #ffffff); stroke: var(--atdd-ink, #1f2937); stroke-width: 2.2"/>
+<path d="M 52 673 l 7 -7 l 7 7 l -7 7 z" style="fill: var(--atdd-ink, #1f2937)"/>
+<text x="148" y="671" text-anchor="middle" style="font-family: var(--atdd-sans, system-ui, sans-serif); font-size: 11px; font-weight: 600; fill: var(--atdd-ink, #1f2937)">Fulfilment decision</text>
+<text x="148" y="690" text-anchor="middle" style="font-family: var(--atdd-mono, ui-monospace, monospace); font-size: 8px; letter-spacing: .08em; fill: var(--atdd-ink, #1f2937)">INTERLOCKING · 1 ROUTE</text>
+<rect x="152" y="770" width="200" height="50" rx="6" style="fill: var(--atdd-paper, #ffffff); stroke: var(--atdd-nominal, #15803d); stroke-width: 1.6"/>
+<text x="252" y="793" text-anchor="middle" style="font-family: var(--atdd-sans, system-ui, sans-serif); font-size: 11px; font-weight: 600; fill: var(--atdd-ink, #1f2937)">Ship the order</text>
+<text x="252" y="812" text-anchor="middle" style="font-family: var(--atdd-mono, ui-monospace, monospace); font-size: 8px; letter-spacing: .08em; fill: var(--atdd-nominal, #15803d)">NOMINAL · 3 STEPS</text>
+<rect x="152" y="892" width="200" height="50" rx="25" style="fill: var(--atdd-paper, #ffffff); stroke: var(--atdd-terminal, #334155); stroke-width: 1.6"/>
+<text x="252" y="915" text-anchor="middle" style="font-family: var(--atdd-sans, system-ui, sans-serif); font-size: 11px; font-weight: 600; fill: var(--atdd-ink, #1f2937)">shipped</text>
+<text x="252" y="934" text-anchor="middle" style="font-family: var(--atdd-mono, ui-monospace, monospace); font-size: 8px; letter-spacing: .08em; fill: var(--atdd-terminal, #334155)">OUTCOME</text>
+<text x="145" y="273" text-anchor="start" style="font-family: var(--atdd-mono, ui-monospace, monospace); font-size: 9px; fill: var(--atdd-nominal, #15803d)">nominal: cart.items &gt; 0</text>
+<text x="145" y="395" text-anchor="start" style="font-family: var(--atdd-mono, ui-monospace, monospace); font-size: 9px; fill: var(--atdd-accent, #0f766e)">orders:quote</text>
+<text x="373" y="273" text-anchor="start" style="font-family: var(--atdd-mono, ui-monospace, monospace); font-size: 9px; fill: var(--atdd-error, #b91c1c)">empty-cart: cart.items == 0</text>
+<text x="145" y="517" text-anchor="start" style="font-family: var(--atdd-mono, ui-monospace, monospace); font-size: 9px; fill: var(--atdd-nominal, #15803d)">charged: quote.accepted and card.valid</text>
+<text x="145" y="639" text-anchor="start" style="font-family: var(--atdd-mono, ui-monospace, monospace); font-size: 9px; fill: var(--atdd-accent, #0f766e)">orders:paid</text>
+<text x="373" y="517" text-anchor="start" style="font-family: var(--atdd-mono, ui-monospace, monospace); font-size: 9px; fill: var(--atdd-alternate, #2563eb)">declined: card.declined</text>
+<text x="259" y="761" text-anchor="start" style="font-family: var(--atdd-mono, ui-monospace, monospace); font-size: 9px; fill: var(--atdd-nominal, #15803d)">ship: order.paid</text>
+</svg>

package/detectors/planner_docs_capability/fixtures/clean/docs/purpose/journeys/svg/path-buy-nominal.svg

@@ -0,0 +1,81 @@
+<svg xmlns="http://www.w3.org/2000/svg" class="atdd-diagram" width="850" height="685" viewBox="0 0 850 685" role="img" aria-labelledby="t-walk-buy d-walk-buy">
+<title id="t-walk-buy">Buy a product — nominal path</title><desc id="d-walk-buy">◇ Checkout decision → nominal (nominal) → Place an order 1.1. buyer to checkout, orders:cart: Submit the cart for checkout 1.2. checkout to pricing, orders:priced-cart: Price the cart with current promotions 1.3. pricing to checkout, orders:quote: Return the priced quote ◇ Payment decision → charged (nominal) → Take payment 2.1. checkout to payment-gateway, orders:charge: Request the charge from the payment gateway 2.2. payment-gateway to checkout, orders:charge-result: Report whether the charge succeeded 2.3. checkout to checkout, orders:paid: Record the order as paid ◇ Fulfilment decision → ship (nominal) → Ship the order 3.1. checkout to fulfilment, orders:paid: Hand the paid order to fulfilment 3.2. fulfilment to carrier, orders:shipment: Book the shipment with the carrier 3.3. fulfilment to buyer, orders:tracking: Send tracking to the buyer ■ outcome: shipped</desc>
+<defs><marker id="walk-buy-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="walk-buy-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="walk-buy-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="679" 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-person, #b45309); 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)">buyer</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)">PERSON</text>
+<line x1="232" y1="54" x2="232" y2="679" 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)">checkout</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="679" 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-wagon, #2563eb); 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)">pricing</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)">WAGON</text>
+<line x1="496" y1="54" x2="496" y2="679" 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-system, #7c3aed); 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)">payment-gateway</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)">SYSTEM</text>
+<line x1="628" y1="54" x2="628" y2="679" style="stroke: var(--atdd-line, #cbd5e1); stroke-width: 1.4; stroke-dasharray: 3 4"/>
+<rect x="569" 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="628" 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="628" 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="760" y1="54" x2="760" y2="679" style="stroke: var(--atdd-line, #cbd5e1); stroke-width: 1.4; stroke-dasharray: 3 4"/>
+<rect x="701" 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="760" 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="760" 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>
+<rect x="4" y="74" width="842" height="22" rx="4" style="fill: var(--atdd-paper, #ffffff); stroke: var(--atdd-nominal, #15803d); stroke-width: 1.2"/>
+<text x="14" y="89" text-anchor="start" style="font-family: var(--atdd-mono, ui-monospace, monospace); font-size: 10px; fill: var(--atdd-nominal, #15803d)">◇ Checkout decision → nominal (nominal) → Place an order</text>
+<text x="20" y="147" text-anchor="middle" style="font-family: var(--atdd-mono, ui-monospace, monospace); font-size: 9.5px; fill: var(--atdd-ink-3, #64748b)">1.1</text>
+<text x="96" y="120" text-anchor="start" style="font-family: var(--atdd-sans, system-ui, sans-serif); font-size: 11px; fill: var(--atdd-ink-2, #475569)">Submit the cart for checkout</text>
+<text x="96" y="133" text-anchor="start" style="font-family: var(--atdd-mono, ui-monospace, monospace); font-size: 9px; fill: var(--atdd-accent, #0f766e)">orders:cart</text>
+<circle cx="100" cy="143" r="3" style="fill: var(--atdd-person, #b45309)"/>
+<line x1="103" y1="143" x2="227" y2="143" style="stroke: var(--atdd-person, #b45309); stroke-width: 1.7" marker-end="url(#walk-buy-person)"/>
+<text x="20" y="196" text-anchor="middle" style="font-family: var(--atdd-mono, ui-monospace, monospace); font-size: 9.5px; fill: var(--atdd-ink-3, #64748b)">1.2</text>
+<text x="228" y="169" text-anchor="start" style="font-family: var(--atdd-sans, system-ui, sans-serif); font-size: 11px; fill: var(--atdd-ink-2, #475569)">Price the cart with current promotions</text>
+<text x="228" y="182" text-anchor="start" style="font-family: var(--atdd-mono, ui-monospace, monospace); font-size: 9px; fill: var(--atdd-accent, #0f766e)">orders:priced-cart</text>
+<circle cx="232" cy="192" r="3" style="fill: var(--atdd-ink-3, #64748b)"/>
+<line x1="235" y1="192" x2="359" y2="192" style="stroke: var(--atdd-ink-3, #64748b); stroke-width: 1.7" marker-end="url(#walk-buy-wagon)"/>
+<text x="20" y="245" text-anchor="middle" style="font-family: var(--atdd-mono, ui-monospace, monospace); font-size: 9.5px; fill: var(--atdd-ink-3, #64748b)">1.3</text>
+<text x="228" y="218" text-anchor="start" style="font-family: var(--atdd-sans, system-ui, sans-serif); font-size: 11px; fill: var(--atdd-ink-2, #475569)">Return the priced quote</text>
+<text x="228" y="231" text-anchor="start" style="font-family: var(--atdd-mono, ui-monospace, monospace); font-size: 9px; fill: var(--atdd-accent, #0f766e)">orders:quote</text>
+<circle cx="364" cy="241" r="3" style="fill: var(--atdd-ink-3, #64748b)"/>
+<line x1="361" y1="241" x2="237" y2="241" style="stroke: var(--atdd-ink-3, #64748b); stroke-width: 1.7" marker-end="url(#walk-buy-wagon)"/>
+<rect x="4" y="257" width="842" height="22" rx="4" style="fill: var(--atdd-paper, #ffffff); stroke: var(--atdd-nominal, #15803d); stroke-width: 1.2"/>
+<text x="14" y="272" text-anchor="start" style="font-family: var(--atdd-mono, ui-monospace, monospace); font-size: 10px; fill: var(--atdd-nominal, #15803d)">◇ Payment decision → charged (nominal) → Take payment</text>
+<text x="20" y="330" text-anchor="middle" style="font-family: var(--atdd-mono, ui-monospace, monospace); font-size: 9.5px; fill: var(--atdd-ink-3, #64748b)">2.1</text>
+<text x="228" y="303" 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="228" y="316" 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="232" cy="326" r="3" style="fill: var(--atdd-system, #7c3aed)"/>
+<line x1="235" y1="326" x2="491" y2="326" style="stroke: var(--atdd-system, #7c3aed); stroke-width: 1.7" marker-end="url(#walk-buy-system)"/>
+<text x="20" y="379" text-anchor="middle" style="font-family: var(--atdd-mono, ui-monospace, monospace); font-size: 9.5px; fill: var(--atdd-ink-3, #64748b)">2.2</text>
+<text x="228" y="352" 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="228" y="365" 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="496" cy="375" r="3" style="fill: var(--atdd-system, #7c3aed)"/>
+<line x1="493" y1="375" x2="237" y2="375" style="stroke: var(--atdd-system, #7c3aed); stroke-width: 1.7" marker-end="url(#walk-buy-system)"/>
+<text x="20" y="428" text-anchor="middle" style="font-family: var(--atdd-mono, ui-monospace, monospace); font-size: 9.5px; fill: var(--atdd-ink-3, #64748b)">2.3</text>
+<text x="228" y="401" 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="228" y="414" 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="232" cy="424" r="3" style="fill: var(--atdd-ink-3, #64748b)"/>
+<path d="M 232 424 h 32 v 18 h -26" style="fill: none; stroke: var(--atdd-ink-3, #64748b); stroke-width: 1.7" marker-end="url(#walk-buy-wagon)"/>
+<rect x="4" y="458" width="842" height="22" rx="4" style="fill: var(--atdd-paper, #ffffff); stroke: var(--atdd-nominal, #15803d); stroke-width: 1.2"/>
+<text x="14" y="473" text-anchor="start" style="font-family: var(--atdd-mono, ui-monospace, monospace); font-size: 10px; fill: var(--atdd-nominal, #15803d)">◇ Fulfilment decision → ship (nominal) → Ship the order</text>
+<text x="20" y="531" text-anchor="middle" style="font-family: var(--atdd-mono, ui-monospace, monospace); font-size: 9.5px; fill: var(--atdd-ink-3, #64748b)">3.1</text>
+<text x="228" y="504" 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="228" y="517" 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="232" cy="527" r="3" style="fill: var(--atdd-ink-3, #64748b)"/>
+<line x1="235" y1="527" x2="623" y2="527" style="stroke: var(--atdd-ink-3, #64748b); stroke-width: 1.7" marker-end="url(#walk-buy-wagon)"/>
+<text x="20" y="580" text-anchor="middle" style="font-family: var(--atdd-mono, ui-monospace, monospace); font-size: 9.5px; fill: var(--atdd-ink-3, #64748b)">3.2</text>
+<text x="624" y="553" 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="624" y="566" 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="628" cy="576" r="3" style="fill: var(--atdd-system, #7c3aed)"/>
+<line x1="631" y1="576" x2="755" y2="576" style="stroke: var(--atdd-system, #7c3aed); stroke-width: 1.7" marker-end="url(#walk-buy-system)"/>
+<text x="20" y="629" text-anchor="middle" style="font-family: var(--atdd-mono, ui-monospace, monospace); font-size: 9.5px; fill: var(--atdd-ink-3, #64748b)">3.3</text>
+<text x="96" y="602" 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="96" y="615" 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="628" cy="625" r="3" style="fill: var(--atdd-person, #b45309)"/>
+<line x1="625" y1="625" x2="105" y2="625" style="stroke: var(--atdd-person, #b45309); stroke-width: 1.7" marker-end="url(#walk-buy-person)"/>
+<rect x="4" y="641" width="842" height="22" rx="4" style="fill: var(--atdd-paper, #ffffff); stroke: var(--atdd-terminal, #334155); stroke-width: 1.2"/>
+<text x="14" y="656" text-anchor="start" style="font-family: var(--atdd-mono, ui-monospace, monospace); font-size: 10px; fill: var(--atdd-terminal, #334155)">■ outcome: shipped</text>
+</svg>

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

@@ -0,0 +1,13 @@
+<svg xmlns="http://www.w3.org/2000/svg" class="atdd-diagram" width="360" height="149" viewBox="0 0 360 149" role="img" aria-labelledby="t-seq-orders-archive-order d-seq-orders-archive-order">
+<title id="t-seq-orders-archive-order">Archive a cancelled order</title><desc id="d-seq-orders-archive-order">1. checkout to checkout, orders:archived: Archive the cancelled order</desc>
+<defs><marker id="seq-orders-archive-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-archive-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-archive-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="143" 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>
+<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)">Archive the cancelled order</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:archived</text>
+<circle cx="100" cy="107" r="3" style="fill: var(--atdd-ink-3, #64748b)"/>
+<path d="M 100 107 h 32 v 18 h -26" style="fill: none; stroke: var(--atdd-ink-3, #64748b); stroke-width: 1.7" marker-end="url(#seq-orders-archive-order-wagon)"/>
+</svg>

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

@@ -0,0 +1,31 @@
+<svg xmlns="http://www.w3.org/2000/svg" class="atdd-diagram" width="454" height="229" viewBox="0 0 454 229" role="img" aria-labelledby="t-seq-orders-place-order d-seq-orders-place-order">
+<title id="t-seq-orders-place-order">Place an order</title><desc id="d-seq-orders-place-order">1. buyer to checkout, orders:cart: Submit the cart for checkout 2. checkout to pricing, orders:priced-cart: Price the cart with current promotions 3. pricing to checkout, orders:quote: Return the priced quote</desc>
+<defs><marker id="seq-orders-place-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-place-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-place-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-person, #b45309); 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)">buyer</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)">PERSON</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)">checkout</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-wagon, #2563eb); 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)">pricing</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)">WAGON</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)">Submit the cart for checkout</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:cart</text>
+<circle cx="100" cy="107" r="3" style="fill: var(--atdd-person, #b45309)"/>
+<line x1="103" y1="107" x2="227" y2="107" style="stroke: var(--atdd-person, #b45309); stroke-width: 1.7" marker-end="url(#seq-orders-place-order-person)"/>
+<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)">Price the cart with current promotions</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:priced-cart</text>
+<circle cx="232" cy="156" r="3" style="fill: var(--atdd-ink-3, #64748b)"/>
+<line x1="235" y1="156" x2="359" y2="156" style="stroke: var(--atdd-ink-3, #64748b); stroke-width: 1.7" marker-end="url(#seq-orders-place-order-wagon)"/>
+<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)">Return the priced quote</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:quote</text>
+<circle cx="364" cy="205" r="3" style="fill: var(--atdd-ink-3, #64748b)"/>
+<line x1="361" y1="205" x2="237" y2="205" style="stroke: var(--atdd-ink-3, #64748b); stroke-width: 1.7" marker-end="url(#seq-orders-place-order-wagon)"/>
+</svg>

package/detectors/planner_docs_capability/fixtures/clean/docs/purpose/journeys/svg/train-orders-reject-empty-cart.svg

@@ -0,0 +1,22 @@
+<svg xmlns="http://www.w3.org/2000/svg" class="atdd-diagram" width="360" height="180" viewBox="0 0 360 180" role="img" aria-labelledby="t-seq-orders-reject-empty-cart d-seq-orders-reject-empty-cart">
+<title id="t-seq-orders-reject-empty-cart">Reject an empty cart</title><desc id="d-seq-orders-reject-empty-cart">1. buyer to checkout, orders:cart: Submit an empty cart 2. checkout to buyer, orders:rejection: Refuse the empty cart and say why</desc>
+<defs><marker id="seq-orders-reject-empty-cart-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-reject-empty-cart-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-reject-empty-cart-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="174" 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-person, #b45309); 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)">buyer</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)">PERSON</text>
+<line x1="232" y1="54" x2="232" y2="174" 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)">checkout</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>
+<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)">Submit an empty cart</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:cart</text>
+<circle cx="100" cy="107" r="3" style="fill: var(--atdd-person, #b45309)"/>
+<line x1="103" y1="107" x2="227" y2="107" style="stroke: var(--atdd-person, #b45309); stroke-width: 1.7" marker-end="url(#seq-orders-reject-empty-cart-person)"/>
+<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)">Refuse the empty cart and say why</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:rejection</text>
+<circle cx="232" cy="156" r="3" style="fill: var(--atdd-person, #b45309)"/>
+<line x1="229" y1="156" x2="105" y2="156" style="stroke: var(--atdd-person, #b45309); stroke-width: 1.7" marker-end="url(#seq-orders-reject-empty-cart-person)"/>
+</svg>

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

@@ -0,0 +1,22 @@
+<svg xmlns="http://www.w3.org/2000/svg" class="atdd-diagram" width="360" height="180" viewBox="0 0 360 180" role="img" aria-labelledby="t-seq-orders-retry-payment d-seq-orders-retry-payment">
+<title id="t-seq-orders-retry-payment">Retry a declined payment</title><desc id="d-seq-orders-retry-payment">1. checkout to buyer, orders:decline: Ask the buyer for another payment method 2. buyer to checkout, orders:payment-method: Provide a new payment method</desc>
+<defs><marker id="seq-orders-retry-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-retry-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-retry-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="174" 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="174" 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-person, #b45309); 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)">buyer</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)">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)">Ask the buyer for another payment method</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:decline</text>
+<circle cx="100" cy="107" r="3" style="fill: var(--atdd-person, #b45309)"/>
+<line x1="103" y1="107" x2="227" y2="107" style="stroke: var(--atdd-person, #b45309); stroke-width: 1.7" marker-end="url(#seq-orders-retry-payment-person)"/>
+<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)">Provide a new payment method</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:payment-method</text>
+<circle cx="232" cy="156" r="3" style="fill: var(--atdd-person, #b45309)"/>
+<line x1="229" y1="156" x2="105" y2="156" style="stroke: var(--atdd-person, #b45309); stroke-width: 1.7" marker-end="url(#seq-orders-retry-payment-person)"/>
+</svg>