Skip to content

Turn any idea, plan, or codebase into a beautiful interactive diagram. An agent skill for Claude Code, Codex, and more.

fix(lifecycle): keep parallel and differing exits apart

tt-a1ib43bf56cd9b4
diff --git a/archify.zip b/archify.zip
index 0fd59769..8225aa1c 100644
Binary files a/archify.zip and b/archify.zip differ
diff --git a/archify/examples/lifecycle-agent-run.html b/archify/examples/lifecycle-agent-run.html
index 4f55e6c3..6cb3511c 100644
--- a/archify/examples/lifecycle-agent-run.html
+++ b/archify/examples/lifecycle-agent-run.html
@@ -5003,51 +5003,51 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
<!-- Transition paths -->
<g data-graph-role="automatic-crossover" style="--step:0">
<path data-graph-role="automatic-crossover-underlay" d="M 196 60 L 268 60" fill="none" stroke="var(--mask)" stroke-width="5.8" stroke-linecap="round" stroke-linejoin="round" pointer-events="none"/>
- <path data-edge-from="queued" data-edge-to="planning" data-edge-label="start" data-edge-key="0" data-edge-id="queued-planning" data-composition-points="196,60;268,60" data-composition-crossover="halo" d="M 196 60 L 268 60" class="a-emphasis" data-animate="edge" style="--step:0" stroke-width="1.8" marker-end="url(#arrowhead-emphasis)"/>
+ <path data-edge-from="queued" data-edge-to="planning" data-edge-label="start" data-edge-key="0" data-edge-id="queued-planning" data-composition-points="196,60;268,60" data-composition-crossover="halo" data-composition-independent="true" d="M 196 60 L 268 60" class="a-emphasis" data-animate="edge" style="--step:0" stroke-width="1.8" marker-end="url(#arrowhead-emphasis)"/>
</g>
<g data-graph-role="automatic-crossover" style="--step:1">
<path data-graph-role="automatic-crossover-underlay" d="M 408 60 L 506 60" fill="none" stroke="var(--mask)" stroke-width="5.8" stroke-linecap="round" stroke-linejoin="round" pointer-events="none"/>
- <path data-edge-from="planning" data-edge-to="executing" data-edge-label="plan ready" data-edge-key="1" data-edge-id="planning-executing" data-composition-points="408,60;506,60" data-composition-crossover="halo" d="M 408 60 L 506 60" class="a-emphasis" data-animate="edge" style="--step:1" stroke-width="1.8" marker-end="url(#arrowhead-emphasis)"/>
+ <path data-edge-from="planning" data-edge-to="executing" data-edge-label="plan ready" data-edge-key="1" data-edge-id="planning-executing" data-composition-points="408,60;506,60" data-composition-crossover="halo" data-composition-independent="true" d="M 408 60 L 506 60" class="a-emphasis" data-animate="edge" style="--step:1" stroke-width="1.8" marker-end="url(#arrowhead-emphasis)"/>
</g>
<g data-graph-role="automatic-crossover" style="--step:2">
<path data-graph-role="automatic-crossover-underlay" d="M 646 60 L 744 60" fill="none" stroke="var(--mask)" stroke-width="5.8" stroke-linecap="round" stroke-linejoin="round" pointer-events="none"/>
- <path data-edge-from="executing" data-edge-to="reviewing" data-edge-label="steps done" data-edge-key="2" data-edge-id="executing-reviewing" data-composition-points="646,60;744,60" data-composition-crossover="halo" d="M 646 60 L 744 60" class="a-emphasis" data-animate="edge" style="--step:2" stroke-width="1.8" marker-end="url(#arrowhead-emphasis)"/>
+ <path data-edge-from="executing" data-edge-to="reviewing" data-edge-label="steps done" data-edge-key="2" data-edge-id="executing-reviewing" data-composition-points="646,60;744,60" data-composition-crossover="halo" data-composition-independent="true" d="M 646 60 L 744 60" class="a-emphasis" data-animate="edge" style="--step:2" stroke-width="1.8" marker-end="url(#arrowhead-emphasis)"/>
</g>
<g data-graph-role="automatic-crossover" style="--step:3">
<path data-graph-role="automatic-crossover-underlay" d="M 884 60 L 956 60" fill="none" stroke="var(--mask)" stroke-width="5.8" stroke-linecap="round" stroke-linejoin="round" pointer-events="none"/>
- <path data-edge-from="reviewing" data-edge-to="completed" data-edge-label="pass" data-edge-key="3" data-edge-id="reviewing-completed" data-composition-points="884,60;956,60" data-composition-crossover="halo" d="M 884 60 L 956 60" class="a-emphasis" data-animate="edge" style="--step:3" stroke-width="1.8" marker-end="url(#arrowhead-emphasis)"/>
+ <path data-edge-from="reviewing" data-edge-to="completed" data-edge-label="pass" data-edge-key="3" data-edge-id="reviewing-completed" data-composition-points="884,60;956,60" data-composition-crossover="halo" data-composition-independent="true" d="M 884 60 L 956 60" class="a-emphasis" data-animate="edge" style="--step:3" stroke-width="1.8" marker-end="url(#arrowhead-emphasis)"/>
</g>
<g data-graph-role="automatic-crossover" style="--step:4">
<path data-graph-role="automatic-crossover-underlay" d="M 537 92 L 537 114 Q 537 126 525 126 L 485 126 Q 473 126 473 138 L 473 202" fill="none" stroke="var(--mask)" stroke-width="5.2" stroke-linecap="round" stroke-linejoin="round" pointer-events="none"/>
- <path data-edge-from="executing" data-edge-to="approval" data-edge-label="risky tool" data-edge-key="4" data-edge-id="executing-approval" data-composition-points="537,92;537,126;473,126;473,202" data-composition-crossover="halo" d="M 537 92 L 537 114 Q 537 126 525 126 L 485 126 Q 473 126 473 138 L 473 202" class="a-security" data-animate="edge" style="--step:4" stroke-width="1.2" marker-end="url(#arrowhead-security)"/>
+ <path data-edge-from="executing" data-edge-to="approval" data-edge-label="risky tool" data-edge-key="4" data-edge-id="executing-approval" data-composition-points="537,92;537,126;473,126;473,202" data-composition-crossover="halo" data-composition-independent="true" d="M 537 92 L 537 114 Q 537 126 525 126 L 485 126 Q 473 126 473 138 L 473 202" class="a-security" data-animate="edge" style="--step:4" stroke-width="1.2" marker-end="url(#arrowhead-security)"/>
</g>
<g data-graph-role="automatic-crossover" style="--step:5">
<path data-graph-role="automatic-crossover-underlay" d="M 499 202 L 499 156 Q 499 144 511 144 L 551 144 Q 563 144 563 132 L 563 92" fill="none" stroke="var(--mask)" stroke-width="5.2" stroke-linecap="round" stroke-linejoin="round" pointer-events="none"/>
- <path data-edge-from="approval" data-edge-to="executing" data-edge-label="approved" data-edge-key="5" data-edge-id="approval-executing" data-composition-points="499,202;499,144;563,144;563,92" data-composition-crossover="halo" d="M 499 202 L 499 156 Q 499 144 511 144 L 551 144 Q 563 144 563 132 L 563 92" class="a-default" data-animate="edge" style="--step:5" stroke-width="1.2" marker-end="url(#arrowhead)"/>
+ <path data-edge-from="approval" data-edge-to="executing" data-edge-label="approved" data-edge-key="5" data-edge-id="approval-executing" data-composition-points="499,202;499,144;563,144;563,92" data-composition-crossover="halo" data-composition-independent="true" d="M 499 202 L 499 156 Q 499 144 511 144 L 551 144 Q 563 144 563 132 L 563 92" class="a-default" data-animate="edge" style="--step:5" stroke-width="1.2" marker-end="url(#arrowhead)"/>
</g>
<g data-graph-role="automatic-crossover" style="--step:6">
<path data-graph-role="automatic-crossover-underlay" d="M 486 266 L 486 358" fill="none" stroke="var(--mask)" stroke-width="5.2" stroke-linecap="round" stroke-linejoin="round" pointer-events="none"/>
- <path data-edge-from="approval" data-edge-to="cancelled" data-edge-label="user denies" data-edge-key="6" data-edge-id="approval-cancelled" data-composition-points="486,266;486,358" data-composition-crossover="halo" d="M 486 266 L 486 358" class="a-security" data-animate="edge" style="--step:6" stroke-width="1.2" marker-end="url(#arrowhead-security)"/>
+ <path data-edge-from="approval" data-edge-to="cancelled" data-edge-label="user denies" data-edge-key="6" data-edge-id="approval-cancelled" data-composition-points="486,266;486,358" data-composition-crossover="halo" data-composition-independent="true" d="M 486 266 L 486 358" class="a-security" data-animate="edge" style="--step:6" stroke-width="1.2" marker-end="url(#arrowhead-security)"/>
</g>
<g data-graph-role="automatic-crossover" style="--step:7">
<path data-graph-role="automatic-crossover-underlay" d="M 589 92 L 589 132 Q 589 144 601 144 L 645 144 Q 657 144 657 156 L 657 202" fill="none" stroke="var(--mask)" stroke-width="5.2" stroke-linecap="round" stroke-linejoin="round" pointer-events="none"/>
- <path data-edge-from="executing" data-edge-to="failed" data-edge-label="tool error" data-edge-key="7" data-edge-id="executing-failed" data-composition-points="589,92;589,144;657,144;657,202" data-composition-crossover="halo" d="M 589 92 L 589 132 Q 589 144 601 144 L 645 144 Q 657 144 657 156 L 657 202" class="a-security" data-animate="edge" style="--step:7" stroke-width="1.2" marker-end="url(#arrowhead-security)"/>
+ <path data-edge-from="executing" data-edge-to="failed" data-edge-label="tool error" data-edge-key="7" data-edge-id="executing-failed" data-composition-points="589,92;589,144;657,144;657,202" data-composition-crossover="halo" data-composition-independent="true" d="M 589 92 L 589 132 Q 589 144 601 144 L 645 144 Q 657 144 657 156 L 657 202" class="a-security" data-animate="edge" style="--step:7" stroke-width="1.2" marker-end="url(#arrowhead-security)"/>
</g>
<g data-graph-role="automatic-crossover" style="--step:8">
<path data-graph-role="automatic-crossover-underlay" d="M 683 202 L 683 138 Q 683 126 671 126 L 627 126 Q 615 126 615 114 L 615 92" fill="none" stroke="var(--mask)" stroke-width="5.2" stroke-linecap="round" stroke-linejoin="round" pointer-events="none"/>
- <path data-edge-from="failed" data-edge-to="executing" data-edge-label="retry" data-edge-key="8" data-edge-id="failed-executing" data-composition-points="683,202;683,126;615,126;615,92" data-composition-crossover="halo" d="M 683 202 L 683 138 Q 683 126 671 126 L 627 126 Q 615 126 615 114 L 615 92" class="a-dashed" data-animate="edge" style="--step:8" stroke-width="1.2" marker-end="url(#arrowhead-dashed)"/>
+ <path data-edge-from="failed" data-edge-to="executing" data-edge-label="retry" data-edge-key="8" data-edge-id="failed-executing" data-composition-points="683,202;683,126;615,126;615,92" data-composition-crossover="halo" data-composition-independent="true" d="M 683 202 L 683 138 Q 683 126 671 126 L 627 126 Q 615 126 615 114 L 615 92" class="a-dashed" data-animate="edge" style="--step:8" stroke-width="1.2" marker-end="url(#arrowhead-dashed)"/>
</g>
<g data-graph-role="automatic-crossover" style="--step:9">
<path data-graph-role="automatic-crossover-underlay" d="M 801 92 L 801 132 Q 801 144 813 144 L 829 144 Q 841 144 841 156 L 841 202" fill="none" stroke="var(--mask)" stroke-width="5.2" stroke-linecap="round" stroke-linejoin="round" pointer-events="none"/>
- <path data-edge-from="reviewing" data-edge-to="blocked" data-edge-label="needs input" data-edge-key="9" data-edge-id="reviewing-blocked" data-composition-points="801,92;801,144;841,144;841,202" data-composition-crossover="halo" d="M 801 92 L 801 132 Q 801 144 813 144 L 829 144 Q 841 144 841 156 L 841 202" class="a-default" data-animate="edge" style="--step:9" stroke-width="1.2" marker-end="url(#arrowhead)"/>
+ <path data-edge-from="reviewing" data-edge-to="blocked" data-edge-label="needs input" data-edge-key="9" data-edge-id="reviewing-blocked" data-composition-points="801,92;801,144;841,144;841,202" data-composition-crossover="halo" data-composition-independent="true" d="M 801 92 L 801 132 Q 801 144 813 144 L 829 144 Q 841 144 841 156 L 841 202" class="a-default" data-animate="edge" style="--step:9" stroke-width="1.2" marker-end="url(#arrowhead)"/>
</g>
<g data-graph-role="automatic-crossover" style="--step:10">
<path data-graph-role="automatic-crossover-underlay" d="M 867 202 L 867 138 Q 867 126 855 126 L 839 126 Q 827 126 827 114 L 827 92" fill="none" stroke="var(--mask)" stroke-width="5.2" stroke-linecap="round" stroke-linejoin="round" pointer-events="none"/>
- <path data-edge-from="blocked" data-edge-to="reviewing" data-edge-label="input given" data-edge-key="10" data-edge-id="blocked-reviewing" data-composition-points="867,202;867,126;827,126;827,92" data-composition-crossover="halo" d="M 867 202 L 867 138 Q 867 126 855 126 L 839 126 Q 827 126 827 114 L 827 92" class="a-default" data-animate="edge" style="--step:10" stroke-width="1.2" marker-end="url(#arrowhead)"/>
+ <path data-edge-from="blocked" data-edge-to="reviewing" data-edge-label="input given" data-edge-key="10" data-edge-id="blocked-reviewing" data-composition-points="867,202;867,126;827,126;827,92" data-composition-crossover="halo" data-composition-independent="true" d="M 867 202 L 867 138 Q 867 126 855 126 L 839 126 Q 827 126 827 114 L 827 92" class="a-default" data-animate="edge" style="--step:10" stroke-width="1.2" marker-end="url(#arrowhead)"/>
</g>
<g data-graph-role="automatic-crossover" style="--step:11">
<path data-graph-role="automatic-crossover-underlay" d="M 854 266 L 854 358" fill="none" stroke="var(--mask)" stroke-width="5.2" stroke-linecap="round" stroke-linejoin="round" pointer-events="none"/>
- <path data-edge-from="blocked" data-edge-to="expired" data-edge-label="no reply 24h" data-edge-key="11" data-edge-id="blocked-expired" data-composition-points="854,266;854,358" data-composition-crossover="halo" d="M 854 266 L 854 358" class="a-security" data-animate="edge" style="--step:11" stroke-width="1.2" marker-end="url(#arrowhead-security)"/>
+ <path data-edge-from="blocked" data-edge-to="expired" data-edge-label="no reply 24h" data-edge-key="11" data-edge-id="blocked-expired" data-composition-points="854,266;854,358" data-composition-crossover="halo" data-composition-independent="true" d="M 854 266 L 854 358" class="a-security" data-animate="edge" style="--step:11" stroke-width="1.2" marker-end="url(#arrowhead-security)"/>
</g>
diff --git a/archify/renderers/lifecycle/README.md b/archify/renderers/lifecycle/README.md
index 3b1d8a41..652f89d3 100644
--- a/archify/renderers/lifecycle/README.md
+++ b/archify/renderers/lifecycle/README.md
@@ -45,8 +45,8 @@ The geometry follows from the structure alone:
| Loops and skips | A transition between two non-consecutive main-path states (or back to an earlier one, or a self-transition) is an arc above the row. Shorter arcs nest inside longer ones; ports order so an outer riser never crosses an inner arc. |
| Other states | One row per distance from the main path. A state starts under the states it connects to in the row above; overlapping states pack side by side. |
| Between rows | Orthogonal routes through a shared gap. Horizontal runs take separate tracks, chosen to minimise crossings; near-vertical routes snap straight or widen to a readable jog. |
-| Shared exits | When one state is entered from several main-path phases, consecutive phases receive a dashed composite frame and one exit per target, as in a UML superstate; non-consecutive phases share a bus with junction dots. Distinct labels into one target are listed together. |
-| Same lower row | Neighbours connect side to side; other pairs loop under the row. |
+| Shared exits | When one state is entered from several main-path phases through transitions that share label, note and variant, consecutive phases receive a dashed composite frame and one exit per target, as in a UML superstate; non-consecutive phases share a bus with junction dots. Exits that differ stay separate connectors with their own labels. |
+| Same lower row | Neighbours connect side to side, parallel transitions fanning out around the shared edge (at most five per pair of states); other pairs loop under the row. |
| Labels | Above main-path arrows, on arc and loop runs, otherwise beside the segment next to the lower state. Every label keeps clear of other routes, states and labels; if one cannot, all spacing grows and layout repeats. |
Every route carries a crossover halo, so an unavoidable crossing (for example,
@@ -79,13 +79,15 @@ rejects duplicate state ids, unknown or repeated `mainPath` states, a
`mainPath` step without a transition, unknown transition endpoints, state text
that cannot fit the widest state, a canvas wider than its smallest text allows
on a desktop (`lifecycle/too-wide`), and a label that cannot be placed after the
-spacing rounds (`lifecycle/label-unplaced`). Each failure is a typed diagnostic
+spacing rounds (`lifecycle/label-unplaced`), and more than five parallel
+transitions between two neighbouring states
+(`lifecycle/crowded-side-transitions`). Each failure is a typed diagnostic
with supported fixes.
The final artifact check applies the shared composition gates (orthogonal
segments, crossings, corridors, label clearance and route rhythm). Routes of one
shared-exit bus declare `data-composition-junction`; they may share only that
-horizontal bus.
+horizontal bus and, when they end at the same state, the merged drop into it.
## Design rules
diff --git a/archify/renderers/lifecycle/render-lifecycle.mjs b/archify/renderers/lifecycle/render-lifecycle.mjs
index f0e06aa1..6e211e41 100644
--- a/archify/renderers/lifecycle/render-lifecycle.mjs
+++ b/archify/renderers/lifecycle/render-lifecycle.mjs
@@ -149,10 +149,14 @@ for (const transition of ofKind('between')) {
if (!downByTarget.has(transition.to)) downByTarget.set(transition.to, []);
downByTarget.get(transition.to).push(transition);
}
+// A merged exit promises one meaning, so a target joins a bracket only when
+// every transition into it shares label, note and variant; differing exits
+// keep separate connectors instead of painting over each other.
+const exitSignature = (transition) => [transition.label ?? '', transition.note ?? '', variantOf(transition)].join('\u0000');
const brackets = new Map();
for (const [target, list] of downByTarget) {
const sources = [...new Set(list.map((transition) => transition.from))].sort((a, b) => spineIndex.get(a) - spineIndex.get(b));
- if (sources.length < 2) continue;
+ if (sources.length < 2 || new Set(list.map(exitSignature)).size > 1) continue;
const key = sources.join('\u0000');
if (!brackets.has(key)) brackets.set(key, { key, sources, targets: [], transitions: [] });
brackets.get(key).targets.push(target);
@@ -399,13 +403,36 @@ function layout({ spineGap, rowGap, drop, firstTrack, ports: portMode }) {
if (x > run.lo + 0.5 && x < run.hi - 0.5) junctions.push([x, y]);
}
}
+ // Parallel transitions between two neighbours spread symmetrically around
+ // the shared edge, left-to-right ones first; a reciprocal pair lands at ±10.
+ const sideGroups = new Map();
for (const transition of sides) {
- const from = states.get(transition.from);
- const to = states.get(transition.to);
- const reciprocal = sides.some((other) => other.from === transition.to && other.to === transition.from);
- const y = from.cy + (reciprocal ? (from.x < to.x ? -10 : 10) : 0);
- const points = from.x < to.x ? [[from.x + from.width, y], [to.x, y]] : [[from.x, y], [to.x + to.width, y]];
- routes.set(transition, { points, segment: 0, labelMode: 'above' });
+ const key = [transition.from, transition.to].sort().join('\u0000');
+ if (!sideGroups.has(key)) sideGroups.set(key, []);
+ sideGroups.get(key).push(transition);
+ }
+ for (const group of sideGroups.values()) {
+ const rightward = (transition) => states.get(transition.from).x < states.get(transition.to).x;
+ const ordered = [...group.filter(rightward), ...group.filter((transition) => !rightward(transition))];
+ const step = Math.min(20, 48 / (ordered.length - 1));
+ if (step < 12) {
+ const message = `${ordered.length} transitions between the neighbouring states "${ordered[0].from}" and "${ordered[0].to}" cannot spread apart on the shared edge; at most five stay legible.`;
+ throwDiagnosticProblems('Lifecycle validation failed', [message], {
+ subject: { diagramType: 'lifecycle' },
+ diagnostics: [structureProblem('lifecycle/crowded-side-transitions', message,
+ { collection: 'transitions', from: ordered[0].from, to: ordered[0].to },
+ ['merge the triggers into one transition label'])],
+ });
+ }
+ ordered.forEach((transition, index) => {
+ const from = states.get(transition.from);
+ const to = states.get(transition.to);
+ const y = from.cy + (index - (ordered.length - 1) / 2) * step;
+ const points = from.x < to.x ? [[from.x + from.width, y], [to.x, y]] : [[from.x, y], [to.x + to.width, y]];
+ // With three or more parallels the inner strokes leave no lane for a
+ // floating label, so their labels ride on the line like arc labels.
+ routes.set(transition, { points, segment: 0, labelMode: ordered.length > 2 ? 'on' : 'above' });
+ });
}
const stateRight = Math.max(...[...states.values()].map((state) => state.x + state.width));
@@ -724,10 +751,8 @@ function placeLabels({ routes, contentRight }) {
const others = (transition) => transitions.filter((other) => !siblings(transition).includes(other));
for (const transition of transitions) {
const route = routes.get(transition);
- if (!route || route.labelMode === 'none') continue;
- const text = route.bracket ? combinedLabel(route.bracket, transition.to) : transition;
- if (!hasLabel(text)) continue;
- const { width, height } = labelBox(text);
+ if (!route || route.labelMode === 'none' || !hasLabel(transition)) continue;
+ const { width, height } = labelBox(transition);
const [start, end] = [route.points[route.segment], route.points[route.segment + 1]];
const candidates = [];
const at = (cx, cy) => ({ x: cx - width / 2, y: cy - height / 2, width, height, cx, cy });
@@ -772,13 +797,6 @@ function placeLabels({ routes, contentRight }) {
return { placedLabels, unplacedLabels };
}
-// A bracket drop carries every distinct condition that leads into its target.
-function combinedLabel(bracket, target) {
- const list = bracket.transitions.filter((transition) => transition.to === target);
- const unique = (field) => [...new Set(list.map((transition) => transition[field]).filter(Boolean))].join(' / ');
- return { label: unique('label'), note: unique('note') };
-}
-
// ---------------------------------------------------------------- validate
function structureProblem(code, message, subject, supportedFixes) {
@@ -958,7 +976,7 @@ function renderTransition(transition, index) {
const strokeWidth = variant === 'emphasis' ? 1.8 : 1.2;
const d = roundedPath(route.points, CORNER);
const junction = route.bracket ? ` data-composition-junction="${esc(route.bracket.key.replaceAll('\u0000', '+'))}"` : '';
- const edge = ` <path ${focusEdgeAttrs(transition.from, transition.to, transition.label || transition.note, index, transition.id)} data-composition-points="${routePointsValue(route.points)}" data-composition-crossover="halo"${junction} d="${d}" class="${cls}"${animateAttr(lifecycle.meta, 'edge', index)} stroke-width="${strokeWidth}" marker-end="url(#${marker})"/>`;
+ const edge = ` <path ${focusEdgeAttrs(transition.from, transition.to, transition.label || transition.note, index, transition.id)} data-composition-points="${routePointsValue(route.points)}" data-composition-crossover="halo" data-composition-independent="true"${junction} d="${d}" class="${cls}"${animateAttr(lifecycle.meta, 'edge', index)} stroke-width="${strokeWidth}" marker-end="url(#${marker})"/>`;
const underlay = ` <path data-graph-role="automatic-crossover-underlay" d="${d}" fill="none" stroke="var(--mask)" stroke-width="${strokeWidth + 4}" stroke-linecap="round" stroke-linejoin="round" pointer-events="none"/>`;
return ` <g data-graph-role="automatic-crossover" style="--step:${index}">\n${underlay}\n${edge}\n </g>`;
}
@@ -966,17 +984,15 @@ function renderTransition(transition, index) {
function renderLabel(transition, index) {
const rect = geometry.placedLabels.get(transition);
if (!rect) return '';
- const route = geometry.routes.get(transition);
- const text = route.bracket ? combinedLabel(route.bracket, transition.to) : transition;
const accent = edgeLabelAccent(variantOf(transition));
- const baseline = rect.y + (text.label ? 11.5 : 11);
- const label = text.label
- ? `\n <text x="${rect.cx}" y="${baseline}" class="${accent}" font-size="${LABEL_FONT}" text-anchor="middle">${esc(text.label)}</text>`
+ const baseline = rect.y + (transition.label ? 11.5 : 11);
+ const label = transition.label
+ ? `\n <text x="${rect.cx}" y="${baseline}" class="${accent}" font-size="${LABEL_FONT}" text-anchor="middle">${esc(transition.label)}</text>`
: '';
- const note = text.note
- ? `\n <text data-detail="fine" x="${rect.cx}" y="${baseline + (text.label ? 12 : 0)}" class="t-dim" font-size="${NOTE_FONT}" text-anchor="middle">${esc(text.note)}</text>`
+ const note = transition.note
+ ? `\n <text data-detail="fine" x="${rect.cx}" y="${baseline + (transition.label ? 12 : 0)}" class="t-dim" font-size="${NOTE_FONT}" text-anchor="middle">${esc(transition.note)}</text>`
: '';
- return ` <g data-detail="${text.label ? 'context' : 'fine'}" ${focusEdgeAttrs(transition.from, transition.to, transition.label || transition.note, index, transition.id)}>
+ return ` <g data-detail="${transition.label ? 'context' : 'fine'}" ${focusEdgeAttrs(transition.from, transition.to, transition.label || transition.note, index, transition.id)}>
<rect x="${rect.x}" y="${rect.y}" width="${rect.width}" height="${rect.height}" rx="4" class="c-mask"/>${label}${note}
</g>`;
}
diff --git a/archify/renderers/shared/geometry.mjs b/archify/renderers/shared/geometry.mjs
index 844a4616..8a0992be 100644
--- a/archify/renderers/shared/geometry.mjs
+++ b/archify/renderers/shared/geometry.mjs
@@ -702,7 +702,8 @@ export function cleanCrossingProblems({
// The counterflow-only opt-in serves older workflow exports without a root
// readable-v2 contract; full shared-endpoint checking takes precedence.
// Relationships a renderer declares on one junction (a Lifecycle exit bracket)
-// may share that junction's horizontal bus; other overlaps between them count.
+// may share that junction's horizontal bus and, when they end at the same
+// state, the merged drop into it; other overlaps between them count.
// Tiny overlaps below the route rhythm
// floor are ignored to avoid turning sub-pixel rounding into a quality debt.
export function collectAmbiguousCorridors({
@@ -747,8 +748,9 @@ export function collectAmbiguousCorridors({
);
if (!overlap || overlap.length + 0.0001 < minOverlapPx) continue;
if (allowShortWorkflowTrunks && shortWorkflowTrunk(left, right, leftSegment, rightSegment, overlap.length)) continue;
- // Only the horizontal bus itself is shared; vertical overlaps still count.
- if (sharedBus && Math.abs(overlap.start[1] - overlap.end[1]) < 0.0001) continue;
+ // Only the horizontal bus itself is shared — and, for two bracket
+ // relations ending at the same state, their merged drop into it.
+ if (sharedBus && (Math.abs(overlap.start[1] - overlap.end[1]) < 0.0001 || left.relation.to === right.relation.to)) continue;
if (counterflowOnly) {
const leftDelta = left.points[leftSegment + 1].map((value, axis) => value - left.points[leftSegment][axis]);
const rightDelta = right.points[rightSegment + 1].map((value, axis) => value - right.points[rightSegment][axis]);
@@ -793,7 +795,8 @@ function shortWorkflowTrunk(left, right, leftSegment, rightSegment, length) {
}
// Bundled arrow markers are 7 stroke-widths across the direction of travel.
-// Callers select the automatic routes they own; explicit junctions are preserved.
+// Callers select the automatic routes they own; explicit junctions are preserved,
+// and relations on one junction ending at the same state share a merged drop.
export function collectArrowheadCollisions({ routedRelations, allowShortWorkflowTrunks = false }) {
const incoming = new Map();
const hits = [];
@@ -810,6 +813,9 @@ export function collectArrowheadCollisions({ routedRelations, allowShortWorkflow
const siblings = incoming.get(key) || [];
const current = { ...entry, tip, halfWidth };
for (const sibling of siblings) {
+ // One junction's merged drop into a state carries a single arrowhead.
+ if (sibling.relation.junction && sibling.relation.junction === entry.relation.junction
+ && sibling.relation.to === entry.relation.to) continue;
if (Math.abs(tip[1 - axis] - sibling.tip[1 - axis]) > 0.0001) continue;
const distance = Math.abs(tip[axis] - sibling.tip[axis]);
const minimum = halfWidth + sibling.halfWidth;
diff --git a/docs/gallery.html b/docs/gallery.html
index 8f4c4b86..149ef7b4 100644
--- a/docs/gallery.html
+++ b/docs/gallery.html
@@ -535,7 +535,7 @@
<div class="receipt-cell"><span class="receipt-label">Artifact</span><span class="receipt-value ok">9/9 pass</span></div>
<div class="receipt-cell"><span class="receipt-label">Composition</span><span class="receipt-value ok" title="0 crossings · 0 border runs · 0 micro segments · 0 cramped turns">SHOWCASE · PASS</span></div>
<div class="receipt-cell"><span class="receipt-label">Graph</span><span class="receipt-value">10N · 12E</span></div>
- <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="a9ca0f07bf5abac3638a6be0e4a8e358cd22ad148cacd91628c497eb63460187">a9ca0f07bf5a</span></div>
+ <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="7963901ba300e8c7dec6376fd02a456ea8260cb98240620b38b55dc78e3bcd7d">7963901ba300</span></div>
</div>
<div class="card-actions">
<a class="card-link primary" href="gallery/artifacts/agent-run.lifecycle.html#focus=approval" target="_blank" rel="noopener" data-en="Explore focus ↗" data-zh="探索聚焦路径 ↗">Explore focus ↗</a>
@@ -564,7 +564,7 @@
<div class="receipt-cell"><span class="receipt-label">Artifact</span><span class="receipt-value ok">9/9 pass</span></div>
<div class="receipt-cell"><span class="receipt-label">Composition</span><span class="receipt-value ok" title="0 crossings · 0 border runs · 0 micro segments · 0 cramped turns">SHOWCASE · PASS</span></div>
<div class="receipt-cell"><span class="receipt-label">Graph</span><span class="receipt-value">12N · 15E</span></div>
- <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="80cd12ee9b8d0eedcab4aa3c635574f0a409fd38384a3134106062deae3da2ca">80cd12ee9b8d</span></div>
+ <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="69517d2395f4426f82d901defe2cf0238b944a2f7f66035e5ecfb720b60f1d27">69517d2395f4</span></div>
</div>
<div class="card-actions">
<a class="card-link primary" href="gallery/artifacts/deployment-release.lifecycle.html#focus=live" target="_blank" rel="noopener" data-en="Explore focus ↗" data-zh="探索聚焦路径 ↗">Explore focus ↗</a>
@@ -1868,8 +1868,8 @@ receipt 108 checks / 12 artifacts / deterministic hashes</pre>
"engineeringProfile": null,
"nodeCount": 10,
"edgeCount": 12,
- "artifactBytes": 784058,
- "artifactSha256": "a9ca0f07bf5abac3638a6be0e4a8e358cd22ad148cacd91628c497eb63460187",
+ "artifactBytes": 784490,
+ "artifactSha256": "7963901ba300e8c7dec6376fd02a456ea8260cb98240620b38b55dc78e3bcd7d",
"sourceBytes": 3260,
"sourceSha256": "5ba36f5ce91ed428cb48b599e275424916d82b619b9a3231cbd1bbc3966fc54b",
"checks": [
@@ -1990,8 +1990,8 @@ receipt 108 checks / 12 artifacts / deterministic hashes</pre>
"engineeringProfile": null,
"nodeCount": 12,
"edgeCount": 15,
- "artifactBytes": 790726,
- "artifactSha256": "80cd12ee9b8d0eedcab4aa3c635574f0a409fd38384a3134106062deae3da2ca",
+ "artifactBytes": 791266,
+ "artifactSha256": "69517d2395f4426f82d901defe2cf0238b944a2f7f66035e5ecfb720b60f1d27",
"sourceBytes": 4155,
"sourceSha256": "e3dc105d03c1c9881160006cdace23cb5d8533803e337caf0ec287c64e775275",
"checks": [
diff --git a/docs/gallery/artifacts/agent-run.lifecycle.html b/docs/gallery/artifacts/agent-run.lifecycle.html
index 4f55e6c3..6cb3511c 100644
--- a/docs/gallery/artifacts/agent-run.lifecycle.html
+++ b/docs/gallery/artifacts/agent-run.lifecycle.html
@@ -5003,51 +5003,51 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
<!-- Transition paths -->
<g data-graph-role="automatic-crossover" style="--step:0">
<path data-graph-role="automatic-crossover-underlay" d="M 196 60 L 268 60" fill="none" stroke="var(--mask)" stroke-width="5.8" stroke-linecap="round" stroke-linejoin="round" pointer-events="none"/>
- <path data-edge-from="queued" data-edge-to="planning" data-edge-label="start" data-edge-key="0" data-edge-id="queued-planning" data-composition-points="196,60;268,60" data-composition-crossover="halo" d="M 196 60 L 268 60" class="a-emphasis" data-animate="edge" style="--step:0" stroke-width="1.8" marker-end="url(#arrowhead-emphasis)"/>
+ <path data-edge-from="queued" data-edge-to="planning" data-edge-label="start" data-edge-key="0" data-edge-id="queued-planning" data-composition-points="196,60;268,60" data-composition-crossover="halo" data-composition-independent="true" d="M 196 60 L 268 60" class="a-emphasis" data-animate="edge" style="--step:0" stroke-width="1.8" marker-end="url(#arrowhead-emphasis)"/>
</g>
<g data-graph-role="automatic-crossover" style="--step:1">
<path data-graph-role="automatic-crossover-underlay" d="M 408 60 L 506 60" fill="none" stroke="var(--mask)" stroke-width="5.8" stroke-linecap="round" stroke-linejoin="round" pointer-events="none"/>
- <path data-edge-from="planning" data-edge-to="executing" data-edge-label="plan ready" data-edge-key="1" data-edge-id="planning-executing" data-composition-points="408,60;506,60" data-composition-crossover="halo" d="M 408 60 L 506 60" class="a-emphasis" data-animate="edge" style="--step:1" stroke-width="1.8" marker-end="url(#arrowhead-emphasis)"/>
+ <path data-edge-from="planning" data-edge-to="executing" data-edge-label="plan ready" data-edge-key="1" data-edge-id="planning-executing" data-composition-points="408,60;506,60" data-composition-crossover="halo" data-composition-independent="true" d="M 408 60 L 506 60" class="a-emphasis" data-animate="edge" style="--step:1" stroke-width="1.8" marker-end="url(#arrowhead-emphasis)"/>
</g>
<g data-graph-role="automatic-crossover" style="--step:2">
<path data-graph-role="automatic-crossover-underlay" d="M 646 60 L 744 60" fill="none" stroke="var(--mask)" stroke-width="5.8" stroke-linecap="round" stroke-linejoin="round" pointer-events="none"/>
- <path data-edge-from="executing" data-edge-to="reviewing" data-edge-label="steps done" data-edge-key="2" data-edge-id="executing-reviewing" data-composition-points="646,60;744,60" data-composition-crossover="halo" d="M 646 60 L 744 60" class="a-emphasis" data-animate="edge" style="--step:2" stroke-width="1.8" marker-end="url(#arrowhead-emphasis)"/>
+ <path data-edge-from="executing" data-edge-to="reviewing" data-edge-label="steps done" data-edge-key="2" data-edge-id="executing-reviewing" data-composition-points="646,60;744,60" data-composition-crossover="halo" data-composition-independent="true" d="M 646 60 L 744 60" class="a-emphasis" data-animate="edge" style="--step:2" stroke-width="1.8" marker-end="url(#arrowhead-emphasis)"/>
</g>
<g data-graph-role="automatic-crossover" style="--step:3">
<path data-graph-role="automatic-crossover-underlay" d="M 884 60 L 956 60" fill="none" stroke="var(--mask)" stroke-width="5.8" stroke-linecap="round" stroke-linejoin="round" pointer-events="none"/>
- <path data-edge-from="reviewing" data-edge-to="completed" data-edge-label="pass" data-edge-key="3" data-edge-id="reviewing-completed" data-composition-points="884,60;956,60" data-composition-crossover="halo" d="M 884 60 L 956 60" class="a-emphasis" data-animate="edge" style="--step:3" stroke-width="1.8" marker-end="url(#arrowhead-emphasis)"/>
+ <path data-edge-from="reviewing" data-edge-to="completed" data-edge-label="pass" data-edge-key="3" data-edge-id="reviewing-completed" data-composition-points="884,60;956,60" data-composition-crossover="halo" data-composition-independent="true" d="M 884 60 L 956 60" class="a-emphasis" data-animate="edge" style="--step:3" stroke-width="1.8" marker-end="url(#arrowhead-emphasis)"/>
</g>
<g data-graph-role="automatic-crossover" style="--step:4">
<path data-graph-role="automatic-crossover-underlay" d="M 537 92 L 537 114 Q 537 126 525 126 L 485 126 Q 473 126 473 138 L 473 202" fill="none" stroke="var(--mask)" stroke-width="5.2" stroke-linecap="round" stroke-linejoin="round" pointer-events="none"/>
- <path data-edge-from="executing" data-edge-to="approval" data-edge-label="risky tool" data-edge-key="4" data-edge-id="executing-approval" data-composition-points="537,92;537,126;473,126;473,202" data-composition-crossover="halo" d="M 537 92 L 537 114 Q 537 126 525 126 L 485 126 Q 473 126 473 138 L 473 202" class="a-security" data-animate="edge" style="--step:4" stroke-width="1.2" marker-end="url(#arrowhead-security)"/>
+ <path data-edge-from="executing" data-edge-to="approval" data-edge-label="risky tool" data-edge-key="4" data-edge-id="executing-approval" data-composition-points="537,92;537,126;473,126;473,202" data-composition-crossover="halo" data-composition-independent="true" d="M 537 92 L 537 114 Q 537 126 525 126 L 485 126 Q 473 126 473 138 L 473 202" class="a-security" data-animate="edge" style="--step:4" stroke-width="1.2" marker-end="url(#arrowhead-security)"/>
</g>
<g data-graph-role="automatic-crossover" style="--step:5">
<path data-graph-role="automatic-crossover-underlay" d="M 499 202 L 499 156 Q 499 144 511 144 L 551 144 Q 563 144 563 132 L 563 92" fill="none" stroke="var(--mask)" stroke-width="5.2" stroke-linecap="round" stroke-linejoin="round" pointer-events="none"/>
- <path data-edge-from="approval" data-edge-to="executing" data-edge-label="approved" data-edge-key="5" data-edge-id="approval-executing" data-composition-points="499,202;499,144;563,144;563,92" data-composition-crossover="halo" d="M 499 202 L 499 156 Q 499 144 511 144 L 551 144 Q 563 144 563 132 L 563 92" class="a-default" data-animate="edge" style="--step:5" stroke-width="1.2" marker-end="url(#arrowhead)"/>
+ <path data-edge-from="approval" data-edge-to="executing" data-edge-label="approved" data-edge-key="5" data-edge-id="approval-executing" data-composition-points="499,202;499,144;563,144;563,92" data-composition-crossover="halo" data-composition-independent="true" d="M 499 202 L 499 156 Q 499 144 511 144 L 551 144 Q 563 144 563 132 L 563 92" class="a-default" data-animate="edge" style="--step:5" stroke-width="1.2" marker-end="url(#arrowhead)"/>
</g>
<g data-graph-role="automatic-crossover" style="--step:6">
<path data-graph-role="automatic-crossover-underlay" d="M 486 266 L 486 358" fill="none" stroke="var(--mask)" stroke-width="5.2" stroke-linecap="round" stroke-linejoin="round" pointer-events="none"/>
- <path data-edge-from="approval" data-edge-to="cancelled" data-edge-label="user denies" data-edge-key="6" data-edge-id="approval-cancelled" data-composition-points="486,266;486,358" data-composition-crossover="halo" d="M 486 266 L 486 358" class="a-security" data-animate="edge" style="--step:6" stroke-width="1.2" marker-end="url(#arrowhead-security)"/>
+ <path data-edge-from="approval" data-edge-to="cancelled" data-edge-label="user denies" data-edge-key="6" data-edge-id="approval-cancelled" data-composition-points="486,266;486,358" data-composition-crossover="halo" data-composition-independent="true" d="M 486 266 L 486 358" class="a-security" data-animate="edge" style="--step:6" stroke-width="1.2" marker-end="url(#arrowhead-security)"/>
</g>
<g data-graph-role="automatic-crossover" style="--step:7">
<path data-graph-role="automatic-crossover-underlay" d="M 589 92 L 589 132 Q 589 144 601 144 L 645 144 Q 657 144 657 156 L 657 202" fill="none" stroke="var(--mask)" stroke-width="5.2" stroke-linecap="round" stroke-linejoin="round" pointer-events="none"/>
- <path data-edge-from="executing" data-edge-to="failed" data-edge-label="tool error" data-edge-key="7" data-edge-id="executing-failed" data-composition-points="589,92;589,144;657,144;657,202" data-composition-crossover="halo" d="M 589 92 L 589 132 Q 589 144 601 144 L 645 144 Q 657 144 657 156 L 657 202" class="a-security" data-animate="edge" style="--step:7" stroke-width="1.2" marker-end="url(#arrowhead-security)"/>
+ <path data-edge-from="executing" data-edge-to="failed" data-edge-label="tool error" data-edge-key="7" data-edge-id="executing-failed" data-composition-points="589,92;589,144;657,144;657,202" data-composition-crossover="halo" data-composition-independent="true" d="M 589 92 L 589 132 Q 589 144 601 144 L 645 144 Q 657 144 657 156 L 657 202" class="a-security" data-animate="edge" style="--step:7" stroke-width="1.2" marker-end="url(#arrowhead-security)"/>
</g>
<g data-graph-role="automatic-crossover" style="--step:8">
<path data-graph-role="automatic-crossover-underlay" d="M 683 202 L 683 138 Q 683 126 671 126 L 627 126 Q 615 126 615 114 L 615 92" fill="none" stroke="var(--mask)" stroke-width="5.2" stroke-linecap="round" stroke-linejoin="round" pointer-events="none"/>
- <path data-edge-from="failed" data-edge-to="executing" data-edge-label="retry" data-edge-key="8" data-edge-id="failed-executing" data-composition-points="683,202;683,126;615,126;615,92" data-composition-crossover="halo" d="M 683 202 L 683 138 Q 683 126 671 126 L 627 126 Q 615 126 615 114 L 615 92" class="a-dashed" data-animate="edge" style="--step:8" stroke-width="1.2" marker-end="url(#arrowhead-dashed)"/>
+ <path data-edge-from="failed" data-edge-to="executing" data-edge-label="retry" data-edge-key="8" data-edge-id="failed-executing" data-composition-points="683,202;683,126;615,126;615,92" data-composition-crossover="halo" data-composition-independent="true" d="M 683 202 L 683 138 Q 683 126 671 126 L 627 126 Q 615 126 615 114 L 615 92" class="a-dashed" data-animate="edge" style="--step:8" stroke-width="1.2" marker-end="url(#arrowhead-dashed)"/>
</g>
<g data-graph-role="automatic-crossover" style="--step:9">
<path data-graph-role="automatic-crossover-underlay" d="M 801 92 L 801 132 Q 801 144 813 144 L 829 144 Q 841 144 841 156 L 841 202" fill="none" stroke="var(--mask)" stroke-width="5.2" stroke-linecap="round" stroke-linejoin="round" pointer-events="none"/>
- <path data-edge-from="reviewing" data-edge-to="blocked" data-edge-label="needs input" data-edge-key="9" data-edge-id="reviewing-blocked" data-composition-points="801,92;801,144;841,144;841,202" data-composition-crossover="halo" d="M 801 92 L 801 132 Q 801 144 813 144 L 829 144 Q 841 144 841 156 L 841 202" class="a-default" data-animate="edge" style="--step:9" stroke-width="1.2" marker-end="url(#arrowhead)"/>
+ <path data-edge-from="reviewing" data-edge-to="blocked" data-edge-label="needs input" data-edge-key="9" data-edge-id="reviewing-blocked" data-composition-points="801,92;801,144;841,144;841,202" data-composition-crossover="halo" data-composition-independent="true" d="M 801 92 L 801 132 Q 801 144 813 144 L 829 144 Q 841 144 841 156 L 841 202" class="a-default" data-animate="edge" style="--step:9" stroke-width="1.2" marker-end="url(#arrowhead)"/>
</g>
<g data-graph-role="automatic-crossover" style="--step:10">
<path data-graph-role="automatic-crossover-underlay" d="M 867 202 L 867 138 Q 867 126 855 126 L 839 126 Q 827 126 827 114 L 827 92" fill="none" stroke="var(--mask)" stroke-width="5.2" stroke-linecap="round" stroke-linejoin="round" pointer-events="none"/>
- <path data-edge-from="blocked" data-edge-to="reviewing" data-edge-label="input given" data-edge-key="10" data-edge-id="blocked-reviewing" data-composition-points="867,202;867,126;827,126;827,92" data-composition-crossover="halo" d="M 867 202 L 867 138 Q 867 126 855 126 L 839 126 Q 827 126 827 114 L 827 92" class="a-default" data-animate="edge" style="--step:10" stroke-width="1.2" marker-end="url(#arrowhead)"/>
+ <path data-edge-from="blocked" data-edge-to="reviewing" data-edge-label="input given" data-edge-key="10" data-edge-id="blocked-reviewing" data-composition-points="867,202;867,126;827,126;827,92" data-composition-crossover="halo" data-composition-independent="true" d="M 867 202 L 867 138 Q 867 126 855 126 L 839 126 Q 827 126 827 114 L 827 92" class="a-default" data-animate="edge" style="--step:10" stroke-width="1.2" marker-end="url(#arrowhead)"/>
</g>
<g data-graph-role="automatic-crossover" style="--step:11">
<path data-graph-role="automatic-crossover-underlay" d="M 854 266 L 854 358" fill="none" stroke="var(--mask)" stroke-width="5.2" stroke-linecap="round" stroke-linejoin="round" pointer-events="none"/>
- <path data-edge-from="blocked" data-edge-to="expired" data-edge-label="no reply 24h" data-edge-key="11" data-edge-id="blocked-expired" data-composition-points="854,266;854,358" data-composition-crossover="halo" d="M 854 266 L 854 358" class="a-security" data-animate="edge" style="--step:11" stroke-width="1.2" marker-end="url(#arrowhead-security)"/>
+ <path data-edge-from="blocked" data-edge-to="expired" data-edge-label="no reply 24h" data-edge-key="11" data-edge-id="blocked-expired" data-composition-points="854,266;854,358" data-composition-crossover="halo" data-composition-independent="true" d="M 854 266 L 854 358" class="a-security" data-animate="edge" style="--step:11" stroke-width="1.2" marker-end="url(#arrowhead-security)"/>
</g>
diff --git a/docs/gallery/artifacts/deployment-release.lifecycle.html b/docs/gallery/artifacts/deployment-release.lifecycle.html
index 3daec75d..274533dd 100644
--- a/docs/gallery/artifacts/deployment-release.lifecycle.html
+++ b/docs/gallery/artifacts/deployment-release.lifecycle.html
@@ -5003,63 +5003,63 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
<!-- Transition paths -->
<g data-graph-role="automatic-crossover" style="--step:0">
<path data-graph-role="automatic-crossover-underlay" d="M 196 102 L 276 102" fill="none" stroke="var(--mask)" stroke-width="5.8" stroke-linecap="round" stroke-linejoin="round" pointer-events="none"/>
- <path data-edge-from="queued" data-edge-to="building" data-edge-label="pick up" data-edge-key="0" data-edge-id="queued-building" data-composition-points="196,102;276,102" data-composition-crossover="halo" d="M 196 102 L 276 102" class="a-emphasis" data-animate="edge" style="--step:0" stroke-width="1.8" marker-end="url(#arrowhead-emphasis)"/>
+ <path data-edge-from="queued" data-edge-to="building" data-edge-label="pick up" data-edge-key="0" data-edge-id="queued-building" data-composition-points="196,102;276,102" data-composition-crossover="halo" data-composition-independent="true" d="M 196 102 L 276 102" class="a-emphasis" data-animate="edge" style="--step:0" stroke-width="1.8" marker-end="url(#arrowhead-emphasis)"/>
</g>
<g data-graph-role="automatic-crossover" style="--step:1">
<path data-graph-role="automatic-crossover-underlay" d="M 416 102 L 520 102" fill="none" stroke="var(--mask)" stroke-width="5.8" stroke-linecap="round" stroke-linejoin="round" pointer-events="none"/>
- <path data-edge-from="building" data-edge-to="verifying" data-edge-label="image built" data-edge-key="1" data-edge-id="building-verifying" data-composition-points="416,102;520,102" data-composition-crossover="halo" d="M 416 102 L 520 102" class="a-emphasis" data-animate="edge" style="--step:1" stroke-width="1.8" marker-end="url(#arrowhead-emphasis)"/>
+ <path data-edge-from="building" data-edge-to="verifying" data-edge-label="image built" data-edge-key="1" data-edge-id="building-verifying" data-composition-points="416,102;520,102" data-composition-crossover="halo" data-composition-independent="true" d="M 416 102 L 520 102" class="a-emphasis" data-animate="edge" style="--step:1" stroke-width="1.8" marker-end="url(#arrowhead-emphasis)"/>
</g>
<g data-graph-role="automatic-crossover" style="--step:2">
<path data-graph-role="automatic-crossover-underlay" d="M 660 102 L 764 102" fill="none" stroke="var(--mask)" stroke-width="5.8" stroke-linecap="round" stroke-linejoin="round" pointer-events="none"/>
- <path data-edge-from="verifying" data-edge-to="ready" data-edge-label="checks pass" data-edge-key="2" data-edge-id="verifying-ready" data-composition-points="660,102;764,102" data-composition-crossover="halo" d="M 660 102 L 764 102" class="a-emphasis" data-animate="edge" style="--step:2" stroke-width="1.8" marker-end="url(#arrowhead-emphasis)"/>
+ <path data-edge-from="verifying" data-edge-to="ready" data-edge-label="checks pass" data-edge-key="2" data-edge-id="verifying-ready" data-composition-points="660,102;764,102" data-composition-crossover="halo" data-composition-independent="true" d="M 660 102 L 764 102" class="a-emphasis" data-animate="edge" style="--step:2" stroke-width="1.8" marker-end="url(#arrowhead-emphasis)"/>
</g>
<g data-graph-role="automatic-crossover" style="--step:3">
<path data-graph-role="automatic-crossover-underlay" d="M 904 102 L 984 102" fill="none" stroke="var(--mask)" stroke-width="5.8" stroke-linecap="round" stroke-linejoin="round" pointer-events="none"/>
- <path data-edge-from="ready" data-edge-to="live" data-edge-label="promote" data-edge-key="3" data-edge-id="ready-live" data-composition-points="904,102;984,102" data-composition-crossover="halo" d="M 904 102 L 984 102" class="a-emphasis" data-animate="edge" style="--step:3" stroke-width="1.8" marker-end="url(#arrowhead-emphasis)"/>
+ <path data-edge-from="ready" data-edge-to="live" data-edge-label="promote" data-edge-key="3" data-edge-id="ready-live" data-composition-points="904,102;984,102" data-composition-crossover="halo" data-composition-independent="true" d="M 904 102 L 984 102" class="a-emphasis" data-animate="edge" style="--step:3" stroke-width="1.8" marker-end="url(#arrowhead-emphasis)"/>
</g>
<g data-graph-role="automatic-crossover" style="--step:4">
<path data-graph-role="automatic-crossover-underlay" d="M 590 70 L 590 52 Q 590 40 578 40 L 358 40 Q 346 40 346 52 L 346 70" fill="none" stroke="var(--mask)" stroke-width="5.2" stroke-linecap="round" stroke-linejoin="round" pointer-events="none"/>
- <path data-edge-from="verifying" data-edge-to="building" data-edge-label="tests fail" data-edge-key="4" data-edge-id="verifying-building" data-composition-points="590,70;590,40;346,40;346,70" data-composition-crossover="halo" d="M 590 70 L 590 52 Q 590 40 578 40 L 358 40 Q 346 40 346 52 L 346 70" class="a-default" data-animate="edge" style="--step:4" stroke-width="1.2" marker-end="url(#arrowhead)"/>
+ <path data-edge-from="verifying" data-edge-to="building" data-edge-label="tests fail" data-edge-key="4" data-edge-id="verifying-building" data-composition-points="590,70;590,40;346,40;346,70" data-composition-crossover="halo" data-composition-independent="true" d="M 590 70 L 590 52 Q 590 40 578 40 L 358 40 Q 346 40 346 52 L 346 70" class="a-default" data-animate="edge" style="--step:4" stroke-width="1.2" marker-end="url(#arrowhead)"/>
</g>
<g data-graph-role="automatic-crossover" style="--step:5">
<path data-graph-role="automatic-crossover-underlay" d="M 590 134 L 590 156 Q 590 168 602 168 L 687 168 Q 699 168 699 180 L 699 226" fill="none" stroke="var(--mask)" stroke-width="5.2" stroke-linecap="round" stroke-linejoin="round" pointer-events="none"/>
- <path data-edge-from="verifying" data-edge-to="approval" data-edge-label="needs sign-off" data-edge-key="5" data-edge-id="verifying-approval" data-composition-points="590,134;590,168;699,168;699,226" data-composition-crossover="halo" d="M 590 134 L 590 156 Q 590 168 602 168 L 687 168 Q 699 168 699 180 L 699 226" class="a-security" data-animate="edge" style="--step:5" stroke-width="1.2" marker-end="url(#arrowhead-security)"/>
+ <path data-edge-from="verifying" data-edge-to="approval" data-edge-label="needs sign-off" data-edge-key="5" data-edge-id="verifying-approval" data-composition-points="590,134;590,168;699,168;699,226" data-composition-crossover="halo" data-composition-independent="true" d="M 590 134 L 590 156 Q 590 168 602 168 L 687 168 Q 699 168 699 180 L 699 226" class="a-security" data-animate="edge" style="--step:5" stroke-width="1.2" marker-end="url(#arrowhead-security)"/>
</g>
<g data-graph-role="automatic-crossover" style="--step:6">
<path data-graph-role="automatic-crossover-underlay" d="M 725 226 L 725 180 Q 725 168 737 168 L 822 168 Q 834 168 834 156 L 834 134" fill="none" stroke="var(--mask)" stroke-width="5.2" stroke-linecap="round" stroke-linejoin="round" pointer-events="none"/>
- <path data-edge-from="approval" data-edge-to="ready" data-edge-label="approved" data-edge-key="6" data-edge-id="approval-ready" data-composition-points="725,226;725,168;834,168;834,134" data-composition-crossover="halo" d="M 725 226 L 725 180 Q 725 168 737 168 L 822 168 Q 834 168 834 156 L 834 134" class="a-default" data-animate="edge" style="--step:6" stroke-width="1.2" marker-end="url(#arrowhead)"/>
+ <path data-edge-from="approval" data-edge-to="ready" data-edge-label="approved" data-edge-key="6" data-edge-id="approval-ready" data-composition-points="725,226;725,168;834,168;834,134" data-composition-crossover="halo" data-composition-independent="true" d="M 725 226 L 725 180 Q 725 168 737 168 L 822 168 Q 834 168 834 156 L 834 134" class="a-default" data-animate="edge" style="--step:6" stroke-width="1.2" marker-end="url(#arrowhead)"/>
</g>
<g data-graph-role="automatic-crossover" style="--step:7">
<path data-graph-role="automatic-crossover-underlay" d="M 712 290 L 712 382" fill="none" stroke="var(--mask)" stroke-width="5.2" stroke-linecap="round" stroke-linejoin="round" pointer-events="none"/>
- <path data-edge-from="approval" data-edge-to="cancelled" data-edge-label="denied" data-edge-key="7" data-edge-id="approval-cancelled" data-composition-points="712,290;712,382" data-composition-crossover="halo" d="M 712 290 L 712 382" class="a-security" data-animate="edge" style="--step:7" stroke-width="1.2" marker-end="url(#arrowhead-security)"/>
+ <path data-edge-from="approval" data-edge-to="cancelled" data-edge-label="denied" data-edge-key="7" data-edge-id="approval-cancelled" data-composition-points="712,290;712,382" data-composition-crossover="halo" data-composition-independent="true" d="M 712 290 L 712 382" class="a-security" data-animate="edge" style="--step:7" stroke-width="1.2" marker-end="url(#arrowhead-security)"/>
</g>
<g data-graph-role="automatic-crossover" style="--step:8">
<path data-graph-role="automatic-crossover-underlay" d="M 1042 134 L 1042 226" fill="none" stroke="var(--mask)" stroke-width="5.2" stroke-linecap="round" stroke-linejoin="round" pointer-events="none"/>
- <path data-edge-from="live" data-edge-to="paused" data-edge-label="SLO alert" data-edge-key="8" data-edge-id="live-paused" data-composition-points="1042,134;1042,226" data-composition-crossover="halo" d="M 1042 134 L 1042 226" class="a-dashed" data-animate="edge" style="--step:8" stroke-width="1.2" marker-end="url(#arrowhead-dashed)"/>
+ <path data-edge-from="live" data-edge-to="paused" data-edge-label="SLO alert" data-edge-key="8" data-edge-id="live-paused" data-composition-points="1042,134;1042,226" data-composition-crossover="halo" data-composition-independent="true" d="M 1042 134 L 1042 226" class="a-dashed" data-animate="edge" style="--step:8" stroke-width="1.2" marker-end="url(#arrowhead-dashed)"/>
</g>
<g data-graph-role="automatic-crossover" style="--step:9">
<path data-graph-role="automatic-crossover-underlay" d="M 1068 226 L 1068 134" fill="none" stroke="var(--mask)" stroke-width="5.2" stroke-linecap="round" stroke-linejoin="round" pointer-events="none"/>
- <path data-edge-from="paused" data-edge-to="live" data-edge-label="recovered" data-edge-key="9" data-edge-id="paused-live" data-composition-points="1068,226;1068,134" data-composition-crossover="halo" d="M 1068 226 L 1068 134" class="a-default" data-animate="edge" style="--step:9" stroke-width="1.2" marker-end="url(#arrowhead)"/>
+ <path data-edge-from="paused" data-edge-to="live" data-edge-label="recovered" data-edge-key="9" data-edge-id="paused-live" data-composition-points="1068,226;1068,134" data-composition-crossover="halo" data-composition-independent="true" d="M 1068 226 L 1068 134" class="a-default" data-animate="edge" style="--step:9" stroke-width="1.2" marker-end="url(#arrowhead)"/>
</g>
<g data-graph-role="automatic-crossover" style="--step:10">
<path data-graph-role="automatic-crossover-underlay" d="M 1055 290 L 1055 382" fill="none" stroke="var(--mask)" stroke-width="5.2" stroke-linecap="round" stroke-linejoin="round" pointer-events="none"/>
- <path data-edge-from="paused" data-edge-to="rollback" data-edge-label="breach persists" data-edge-key="10" data-edge-id="paused-rollback" data-composition-points="1055,290;1055,382" data-composition-crossover="halo" d="M 1055 290 L 1055 382" class="a-security" data-animate="edge" style="--step:10" stroke-width="1.2" marker-end="url(#arrowhead-security)"/>
+ <path data-edge-from="paused" data-edge-to="rollback" data-edge-label="breach persists" data-edge-key="10" data-edge-id="paused-rollback" data-composition-points="1055,290;1055,382" data-composition-crossover="halo" data-composition-independent="true" d="M 1055 290 L 1055 382" class="a-security" data-animate="edge" style="--step:10" stroke-width="1.2" marker-end="url(#arrowhead-security)"/>
</g>
<g data-graph-role="automatic-crossover" style="--step:11">
<path data-graph-role="automatic-crossover-underlay" d="M 1042 446 L 1042 468 Q 1042 480 1030 480 L 986 480 Q 974 480 974 492 L 974 538" fill="none" stroke="var(--mask)" stroke-width="5.8" stroke-linecap="round" stroke-linejoin="round" pointer-events="none"/>
- <path data-edge-from="rollback" data-edge-to="rolled_back" data-edge-label="restored" data-edge-key="11" data-edge-id="rollback-rolled-back" data-composition-points="1042,446;1042,480;974,480;974,538" data-composition-crossover="halo" d="M 1042 446 L 1042 468 Q 1042 480 1030 480 L 986 480 Q 974 480 974 492 L 974 538" class="a-emphasis" data-animate="edge" style="--step:11" stroke-width="1.8" marker-end="url(#arrowhead-emphasis)"/>
+ <path data-edge-from="rollback" data-edge-to="rolled_back" data-edge-label="restored" data-edge-key="11" data-edge-id="rollback-rolled-back" data-composition-points="1042,446;1042,480;974,480;974,538" data-composition-crossover="halo" data-composition-independent="true" d="M 1042 446 L 1042 468 Q 1042 480 1030 480 L 986 480 Q 974 480 974 492 L 974 538" class="a-emphasis" data-animate="edge" style="--step:11" stroke-width="1.8" marker-end="url(#arrowhead-emphasis)"/>
</g>
<g data-graph-role="automatic-crossover" style="--step:12">
<path data-graph-role="automatic-crossover-underlay" d="M 1068 446 L 1068 468 Q 1068 480 1080 480 L 1146 480 Q 1158 480 1158 492 L 1158 538" fill="none" stroke="var(--mask)" stroke-width="5.2" stroke-linecap="round" stroke-linejoin="round" pointer-events="none"/>
- <path data-edge-from="rollback" data-edge-to="failed" data-edge-label="rollback error" data-edge-key="12" data-edge-id="rollback-failed" data-composition-points="1068,446;1068,480;1158,480;1158,538" data-composition-crossover="halo" d="M 1068 446 L 1068 468 Q 1068 480 1080 480 L 1146 480 Q 1158 480 1158 492 L 1158 538" class="a-security" data-animate="edge" style="--step:12" stroke-width="1.2" marker-end="url(#arrowhead-security)"/>
+ <path data-edge-from="rollback" data-edge-to="failed" data-edge-label="rollback error" data-edge-key="12" data-edge-id="rollback-failed" data-composition-points="1068,446;1068,480;1158,480;1158,538" data-composition-crossover="halo" data-composition-independent="true" d="M 1068 446 L 1068 468 Q 1068 480 1080 480 L 1146 480 Q 1158 480 1158 492 L 1158 538" class="a-security" data-animate="edge" style="--step:12" stroke-width="1.2" marker-end="url(#arrowhead-security)"/>
</g>
<g data-graph-role="automatic-crossover" style="--step:13">
<path data-graph-role="automatic-crossover-underlay" d="M 468 144 L 468 226" fill="none" stroke="var(--mask)" stroke-width="5.2" stroke-linecap="round" stroke-linejoin="round" pointer-events="none"/>
- <path data-edge-from="building" data-edge-to="aborted" data-edge-label="abort" data-edge-key="13" data-edge-id="building-aborted" data-composition-points="468,144;468,226" data-composition-crossover="halo" data-composition-junction="building+verifying" d="M 468 144 L 468 226" class="a-default" data-animate="edge" style="--step:12" stroke-width="1.2" marker-end="url(#arrowhead)"/>
+ <path data-edge-from="building" data-edge-to="aborted" data-edge-label="abort" data-edge-key="13" data-edge-id="building-aborted" data-composition-points="468,144;468,226" data-composition-crossover="halo" data-composition-independent="true" data-composition-junction="building+verifying" d="M 468 144 L 468 226" class="a-default" data-animate="edge" style="--step:12" stroke-width="1.2" marker-end="url(#arrowhead)"/>
</g>
<g data-graph-role="automatic-crossover" style="--step:14">
<path data-graph-role="automatic-crossover-underlay" d="M 468 144 L 468 226" fill="none" stroke="var(--mask)" stroke-width="5.2" stroke-linecap="round" stroke-linejoin="round" pointer-events="none"/>
- <path data-edge-from="verifying" data-edge-to="aborted" data-edge-label="abort" data-edge-key="14" data-edge-id="verifying-aborted" data-composition-points="468,144;468,226" data-composition-crossover="halo" data-composition-junction="building+verifying" d="M 468 144 L 468 226" class="a-default" data-animate="edge" style="--step:12" stroke-width="1.2" marker-end="url(#arrowhead)"/>
+ <path data-edge-from="verifying" data-edge-to="aborted" data-edge-label="abort" data-edge-key="14" data-edge-id="verifying-aborted" data-composition-points="468,144;468,226" data-composition-crossover="halo" data-composition-independent="true" data-composition-junction="building+verifying" d="M 468 144 L 468 226" class="a-default" data-animate="edge" style="--step:12" stroke-width="1.2" marker-end="url(#arrowhead)"/>
</g>
diff --git a/docs/gallery/manifest.json b/docs/gallery/manifest.json
index f95d8442..5593718b 100644
--- a/docs/gallery/manifest.json
+++ b/docs/gallery/manifest.json
@@ -1186,8 +1186,8 @@
"engineeringProfile": null,
"nodeCount": 10,
"edgeCount": 12,
- "artifactBytes": 784058,
- "artifactSha256": "a9ca0f07bf5abac3638a6be0e4a8e358cd22ad148cacd91628c497eb63460187",
+ "artifactBytes": 784490,
+ "artifactSha256": "7963901ba300e8c7dec6376fd02a456ea8260cb98240620b38b55dc78e3bcd7d",
"sourceBytes": 3260,
"sourceSha256": "5ba36f5ce91ed428cb48b599e275424916d82b619b9a3231cbd1bbc3966fc54b",
"checks": [
@@ -1308,8 +1308,8 @@
"engineeringProfile": null,
"nodeCount": 12,
"edgeCount": 15,
- "artifactBytes": 790726,
- "artifactSha256": "80cd12ee9b8d0eedcab4aa3c635574f0a409fd38384a3134106062deae3da2ca",
+ "artifactBytes": 791266,
+ "artifactSha256": "69517d2395f4426f82d901defe2cf0238b944a2f7f66035e5ecfb720b60f1d27",
"sourceBytes": 4155,
"sourceSha256": "e3dc105d03c1c9881160006cdace23cb5d8533803e337caf0ec287c64e775275",
"checks": [
diff --git a/examples/lifecycle-agent-run.html b/examples/lifecycle-agent-run.html
index 4f55e6c3..6cb3511c 100644
--- a/examples/lifecycle-agent-run.html
+++ b/examples/lifecycle-agent-run.html
@@ -5003,51 +5003,51 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
<!-- Transition paths -->
<g data-graph-role="automatic-crossover" style="--step:0">
<path data-graph-role="automatic-crossover-underlay" d="M 196 60 L 268 60" fill="none" stroke="var(--mask)" stroke-width="5.8" stroke-linecap="round" stroke-linejoin="round" pointer-events="none"/>
- <path data-edge-from="queued" data-edge-to="planning" data-edge-label="start" data-edge-key="0" data-edge-id="queued-planning" data-composition-points="196,60;268,60" data-composition-crossover="halo" d="M 196 60 L 268 60" class="a-emphasis" data-animate="edge" style="--step:0" stroke-width="1.8" marker-end="url(#arrowhead-emphasis)"/>
+ <path data-edge-from="queued" data-edge-to="planning" data-edge-label="start" data-edge-key="0" data-edge-id="queued-planning" data-composition-points="196,60;268,60" data-composition-crossover="halo" data-composition-independent="true" d="M 196 60 L 268 60" class="a-emphasis" data-animate="edge" style="--step:0" stroke-width="1.8" marker-end="url(#arrowhead-emphasis)"/>
</g>
<g data-graph-role="automatic-crossover" style="--step:1">
<path data-graph-role="automatic-crossover-underlay" d="M 408 60 L 506 60" fill="none" stroke="var(--mask)" stroke-width="5.8" stroke-linecap="round" stroke-linejoin="round" pointer-events="none"/>
- <path data-edge-from="planning" data-edge-to="executing" data-edge-label="plan ready" data-edge-key="1" data-edge-id="planning-executing" data-composition-points="408,60;506,60" data-composition-crossover="halo" d="M 408 60 L 506 60" class="a-emphasis" data-animate="edge" style="--step:1" stroke-width="1.8" marker-end="url(#arrowhead-emphasis)"/>
+ <path data-edge-from="planning" data-edge-to="executing" data-edge-label="plan ready" data-edge-key="1" data-edge-id="planning-executing" data-composition-points="408,60;506,60" data-composition-crossover="halo" data-composition-independent="true" d="M 408 60 L 506 60" class="a-emphasis" data-animate="edge" style="--step:1" stroke-width="1.8" marker-end="url(#arrowhead-emphasis)"/>
</g>
<g data-graph-role="automatic-crossover" style="--step:2">
<path data-graph-role="automatic-crossover-underlay" d="M 646 60 L 744 60" fill="none" stroke="var(--mask)" stroke-width="5.8" stroke-linecap="round" stroke-linejoin="round" pointer-events="none"/>
- <path data-edge-from="executing" data-edge-to="reviewing" data-edge-label="steps done" data-edge-key="2" data-edge-id="executing-reviewing" data-composition-points="646,60;744,60" data-composition-crossover="halo" d="M 646 60 L 744 60" class="a-emphasis" data-animate="edge" style="--step:2" stroke-width="1.8" marker-end="url(#arrowhead-emphasis)"/>
+ <path data-edge-from="executing" data-edge-to="reviewing" data-edge-label="steps done" data-edge-key="2" data-edge-id="executing-reviewing" data-composition-points="646,60;744,60" data-composition-crossover="halo" data-composition-independent="true" d="M 646 60 L 744 60" class="a-emphasis" data-animate="edge" style="--step:2" stroke-width="1.8" marker-end="url(#arrowhead-emphasis)"/>
</g>
<g data-graph-role="automatic-crossover" style="--step:3">
<path data-graph-role="automatic-crossover-underlay" d="M 884 60 L 956 60" fill="none" stroke="var(--mask)" stroke-width="5.8" stroke-linecap="round" stroke-linejoin="round" pointer-events="none"/>
- <path data-edge-from="reviewing" data-edge-to="completed" data-edge-label="pass" data-edge-key="3" data-edge-id="reviewing-completed" data-composition-points="884,60;956,60" data-composition-crossover="halo" d="M 884 60 L 956 60" class="a-emphasis" data-animate="edge" style="--step:3" stroke-width="1.8" marker-end="url(#arrowhead-emphasis)"/>
+ <path data-edge-from="reviewing" data-edge-to="completed" data-edge-label="pass" data-edge-key="3" data-edge-id="reviewing-completed" data-composition-points="884,60;956,60" data-composition-crossover="halo" data-composition-independent="true" d="M 884 60 L 956 60" class="a-emphasis" data-animate="edge" style="--step:3" stroke-width="1.8" marker-end="url(#arrowhead-emphasis)"/>
</g>
<g data-graph-role="automatic-crossover" style="--step:4">
<path data-graph-role="automatic-crossover-underlay" d="M 537 92 L 537 114 Q 537 126 525 126 L 485 126 Q 473 126 473 138 L 473 202" fill="none" stroke="var(--mask)" stroke-width="5.2" stroke-linecap="round" stroke-linejoin="round" pointer-events="none"/>
- <path data-edge-from="executing" data-edge-to="approval" data-edge-label="risky tool" data-edge-key="4" data-edge-id="executing-approval" data-composition-points="537,92;537,126;473,126;473,202" data-composition-crossover="halo" d="M 537 92 L 537 114 Q 537 126 525 126 L 485 126 Q 473 126 473 138 L 473 202" class="a-security" data-animate="edge" style="--step:4" stroke-width="1.2" marker-end="url(#arrowhead-security)"/>
+ <path data-edge-from="executing" data-edge-to="approval" data-edge-label="risky tool" data-edge-key="4" data-edge-id="executing-approval" data-composition-points="537,92;537,126;473,126;473,202" data-composition-crossover="halo" data-composition-independent="true" d="M 537 92 L 537 114 Q 537 126 525 126 L 485 126 Q 473 126 473 138 L 473 202" class="a-security" data-animate="edge" style="--step:4" stroke-width="1.2" marker-end="url(#arrowhead-security)"/>
</g>
<g data-graph-role="automatic-crossover" style="--step:5">
<path data-graph-role="automatic-crossover-underlay" d="M 499 202 L 499 156 Q 499 144 511 144 L 551 144 Q 563 144 563 132 L 563 92" fill="none" stroke="var(--mask)" stroke-width="5.2" stroke-linecap="round" stroke-linejoin="round" pointer-events="none"/>
- <path data-edge-from="approval" data-edge-to="executing" data-edge-label="approved" data-edge-key="5" data-edge-id="approval-executing" data-composition-points="499,202;499,144;563,144;563,92" data-composition-crossover="halo" d="M 499 202 L 499 156 Q 499 144 511 144 L 551 144 Q 563 144 563 132 L 563 92" class="a-default" data-animate="edge" style="--step:5" stroke-width="1.2" marker-end="url(#arrowhead)"/>
+ <path data-edge-from="approval" data-edge-to="executing" data-edge-label="approved" data-edge-key="5" data-edge-id="approval-executing" data-composition-points="499,202;499,144;563,144;563,92" data-composition-crossover="halo" data-composition-independent="true" d="M 499 202 L 499 156 Q 499 144 511 144 L 551 144 Q 563 144 563 132 L 563 92" class="a-default" data-animate="edge" style="--step:5" stroke-width="1.2" marker-end="url(#arrowhead)"/>
</g>
<g data-graph-role="automatic-crossover" style="--step:6">
<path data-graph-role="automatic-crossover-underlay" d="M 486 266 L 486 358" fill="none" stroke="var(--mask)" stroke-width="5.2" stroke-linecap="round" stroke-linejoin="round" pointer-events="none"/>
- <path data-edge-from="approval" data-edge-to="cancelled" data-edge-label="user denies" data-edge-key="6" data-edge-id="approval-cancelled" data-composition-points="486,266;486,358" data-composition-crossover="halo" d="M 486 266 L 486 358" class="a-security" data-animate="edge" style="--step:6" stroke-width="1.2" marker-end="url(#arrowhead-security)"/>
+ <path data-edge-from="approval" data-edge-to="cancelled" data-edge-label="user denies" data-edge-key="6" data-edge-id="approval-cancelled" data-composition-points="486,266;486,358" data-composition-crossover="halo" data-composition-independent="true" d="M 486 266 L 486 358" class="a-security" data-animate="edge" style="--step:6" stroke-width="1.2" marker-end="url(#arrowhead-security)"/>
</g>
<g data-graph-role="automatic-crossover" style="--step:7">
<path data-graph-role="automatic-crossover-underlay" d="M 589 92 L 589 132 Q 589 144 601 144 L 645 144 Q 657 144 657 156 L 657 202" fill="none" stroke="var(--mask)" stroke-width="5.2" stroke-linecap="round" stroke-linejoin="round" pointer-events="none"/>
- <path data-edge-from="executing" data-edge-to="failed" data-edge-label="tool error" data-edge-key="7" data-edge-id="executing-failed" data-composition-points="589,92;589,144;657,144;657,202" data-composition-crossover="halo" d="M 589 92 L 589 132 Q 589 144 601 144 L 645 144 Q 657 144 657 156 L 657 202" class="a-security" data-animate="edge" style="--step:7" stroke-width="1.2" marker-end="url(#arrowhead-security)"/>
+ <path data-edge-from="executing" data-edge-to="failed" data-edge-label="tool error" data-edge-key="7" data-edge-id="executing-failed" data-composition-points="589,92;589,144;657,144;657,202" data-composition-crossover="halo" data-composition-independent="true" d="M 589 92 L 589 132 Q 589 144 601 144 L 645 144 Q 657 144 657 156 L 657 202" class="a-security" data-animate="edge" style="--step:7" stroke-width="1.2" marker-end="url(#arrowhead-security)"/>
</g>
<g data-graph-role="automatic-crossover" style="--step:8">
<path data-graph-role="automatic-crossover-underlay" d="M 683 202 L 683 138 Q 683 126 671 126 L 627 126 Q 615 126 615 114 L 615 92" fill="none" stroke="var(--mask)" stroke-width="5.2" stroke-linecap="round" stroke-linejoin="round" pointer-events="none"/>
- <path data-edge-from="failed" data-edge-to="executing" data-edge-label="retry" data-edge-key="8" data-edge-id="failed-executing" data-composition-points="683,202;683,126;615,126;615,92" data-composition-crossover="halo" d="M 683 202 L 683 138 Q 683 126 671 126 L 627 126 Q 615 126 615 114 L 615 92" class="a-dashed" data-animate="edge" style="--step:8" stroke-width="1.2" marker-end="url(#arrowhead-dashed)"/>
+ <path data-edge-from="failed" data-edge-to="executing" data-edge-label="retry" data-edge-key="8" data-edge-id="failed-executing" data-composition-points="683,202;683,126;615,126;615,92" data-composition-crossover="halo" data-composition-independent="true" d="M 683 202 L 683 138 Q 683 126 671 126 L 627 126 Q 615 126 615 114 L 615 92" class="a-dashed" data-animate="edge" style="--step:8" stroke-width="1.2" marker-end="url(#arrowhead-dashed)"/>
</g>
<g data-graph-role="automatic-crossover" style="--step:9">
<path data-graph-role="automatic-crossover-underlay" d="M 801 92 L 801 132 Q 801 144 813 144 L 829 144 Q 841 144 841 156 L 841 202" fill="none" stroke="var(--mask)" stroke-width="5.2" stroke-linecap="round" stroke-linejoin="round" pointer-events="none"/>
- <path data-edge-from="reviewing" data-edge-to="blocked" data-edge-label="needs input" data-edge-key="9" data-edge-id="reviewing-blocked" data-composition-points="801,92;801,144;841,144;841,202" data-composition-crossover="halo" d="M 801 92 L 801 132 Q 801 144 813 144 L 829 144 Q 841 144 841 156 L 841 202" class="a-default" data-animate="edge" style="--step:9" stroke-width="1.2" marker-end="url(#arrowhead)"/>
+ <path data-edge-from="reviewing" data-edge-to="blocked" data-edge-label="needs input" data-edge-key="9" data-edge-id="reviewing-blocked" data-composition-points="801,92;801,144;841,144;841,202" data-composition-crossover="halo" data-composition-independent="true" d="M 801 92 L 801 132 Q 801 144 813 144 L 829 144 Q 841 144 841 156 L 841 202" class="a-default" data-animate="edge" style="--step:9" stroke-width="1.2" marker-end="url(#arrowhead)"/>
</g>
<g data-graph-role="automatic-crossover" style="--step:10">
<path data-graph-role="automatic-crossover-underlay" d="M 867 202 L 867 138 Q 867 126 855 126 L 839 126 Q 827 126 827 114 L 827 92" fill="none" stroke="var(--mask)" stroke-width="5.2" stroke-linecap="round" stroke-linejoin="round" pointer-events="none"/>
- <path data-edge-from="blocked" data-edge-to="reviewing" data-edge-label="input given" data-edge-key="10" data-edge-id="blocked-reviewing" data-composition-points="867,202;867,126;827,126;827,92" data-composition-crossover="halo" d="M 867 202 L 867 138 Q 867 126 855 126 L 839 126 Q 827 126 827 114 L 827 92" class="a-default" data-animate="edge" style="--step:10" stroke-width="1.2" marker-end="url(#arrowhead)"/>
+ <path data-edge-from="blocked" data-edge-to="reviewing" data-edge-label="input given" data-edge-key="10" data-edge-id="blocked-reviewing" data-composition-points="867,202;867,126;827,126;827,92" data-composition-crossover="halo" data-composition-independent="true" d="M 867 202 L 867 138 Q 867 126 855 126 L 839 126 Q 827 126 827 114 L 827 92" class="a-default" data-animate="edge" style="--step:10" stroke-width="1.2" marker-end="url(#arrowhead)"/>
</g>
<g data-graph-role="automatic-crossover" style="--step:11">
<path data-graph-role="automatic-crossover-underlay" d="M 854 266 L 854 358" fill="none" stroke="var(--mask)" stroke-width="5.2" stroke-linecap="round" stroke-linejoin="round" pointer-events="none"/>
- <path data-edge-from="blocked" data-edge-to="expired" data-edge-label="no reply 24h" data-edge-key="11" data-edge-id="blocked-expired" data-composition-points="854,266;854,358" data-composition-crossover="halo" d="M 854 266 L 854 358" class="a-security" data-animate="edge" style="--step:11" stroke-width="1.2" marker-end="url(#arrowhead-security)"/>
+ <path data-edge-from="blocked" data-edge-to="expired" data-edge-label="no reply 24h" data-edge-key="11" data-edge-id="blocked-expired" data-composition-points="854,266;854,358" data-composition-crossover="halo" data-composition-independent="true" d="M 854 266 L 854 358" class="a-security" data-animate="edge" style="--step:11" stroke-width="1.2" marker-end="url(#arrowhead-security)"/>
</g>
diff --git a/test/authoring-safety-contract.test.mjs b/test/authoring-safety-contract.test.mjs
index d3980adb..46ad05cc 100644
--- a/test/authoring-safety-contract.test.mjs
+++ b/test/authoring-safety-contract.test.mjs
@@ -33,7 +33,6 @@ test('semantic relationship labels are preserved and deletion is not a geometry
test('schema policy documents the workflow v1/v2 and lifecycle v3 compatibility boundaries', () => {
assert.match(schemaReadme, /Workflow[^\n]*schema versions? 1 and 2/i);
assert.match(schemaReadme, /Lifecycle accepts only version 3/i);
- assert.match(schemaReadme, /Versions 1 and 2 were\s+removed/i);
assert.match(schemaReadme, /other three[^\n]*schema_version[^\n]*1/i);
assert.doesNotMatch(schemaReadme, /schema_version` is `"const": 1`/);
});
diff --git a/test/lifecycle-layout.test.mjs b/test/lifecycle-layout.test.mjs
index 98aec702..aa4d71b9 100644
--- a/test/lifecycle-layout.test.mjs
+++ b/test/lifecycle-layout.test.mjs
@@ -4,7 +4,7 @@
import { test } from 'node:test';
import assert from 'node:assert/strict';
-import { execFileSync } from 'node:child_process';
+import { execFileSync, spawnSync } from 'node:child_process';
import fs from 'node:fs';
import os from 'node:os';
import path from 'node:path';
@@ -47,6 +47,11 @@ function points(svg, from, to) {
assert.ok(tag, `route ${from} -> ${to}`);
return tag[3].split(';').map((pair) => pair.split(',').map(Number));
}
+function allPoints(svg, from, to) {
+ return [...svg.matchAll(/<path [^>]*data-edge-from="([^"]+)" data-edge-to="([^"]+)"[^>]*data-composition-points="([^"]+)"/g)]
+ .filter((match) => match[1] === from && match[2] === to)
+ .map((match) => match[3].split(';').map((pair) => pair.split(',').map(Number)));
+}
function box(svg, id) {
const group = svg.match(new RegExp(`data-node-id="${id}"[\\s\\S]*?<rect x="([\\d.-]+)" y="([\\d.-]+)" width="([\\d.]+)" height="([\\d.]+)"`));
return { x: Number(group[1]), y: Number(group[2]), width: Number(group[3]), height: Number(group[4]) };
@@ -117,14 +122,112 @@ test('an exit shared by non-consecutive phases uses a declared bus that passes t
{ from: 'a', to: 'b' },
{ from: 'b', to: 'c' },
{ from: 'a', to: 'void', label: 'abort' },
- { from: 'c', to: 'void', label: 'revoke' },
+ { from: 'c', to: 'void', label: 'abort' },
],
}));
assert.equal(result.code, 0, result.stderr);
assert.match(result.svg, /data-composition-junction="a\+c"/);
assert.equal(result.check.composition.metrics.ambiguousCorridors, 0);
assert.equal(result.check.ok, true, JSON.stringify(result.check.composition.issues));
- assert.match(result.svg, />abort \/ revoke<\/text>/);
+ assert.equal((result.svg.match(/>abort<\/text>/g) || []).length, 1, 'one label for the shared exit');
+});
+
+// Two waits and a failure on one lower row give transitions between neighbours
+// something to spread across.
+const neighbourCase = (extra) => base({
+ mainPath: ['a', 'b', 'c'],
+ states: [state('a', 'start'), state('b'), state('c', 'success'), state('w', 'waiting'), state('f', 'failure')],
+ transitions: [
+ { from: 'a', to: 'b' },
+ { from: 'b', to: 'c' },
+ { from: 'b', to: 'w' },
+ { from: 'b', to: 'f' },
+ ...extra,
+ ],
+});
+
+test('parallel transitions between two neighbours each get their own lane', () => {
+ const two = render(neighbourCase([
+ { from: 'w', to: 'f', label: 'retry' },
+ { from: 'w', to: 'f', label: 'fail' },
+ ]));
+ assert.equal(two.code, 0, two.stderr);
+ assert.equal(two.check.ok, true, JSON.stringify(two.check.composition.issues));
+ const ys = allPoints(two.svg, 'w', 'f').map((route) => route[0][1]);
+ assert.equal(ys.length, 2);
+ assert.equal(new Set(ys).size, 2, 'parallel strokes need distinct y values');
+
+ const three = render(neighbourCase([
+ { from: 'w', to: 'f', label: 'retry' },
+ { from: 'w', to: 'f', label: 'fail' },
+ { from: 'w', to: 'f', label: 'skip' },
+ ]));
+ assert.equal(three.code, 0, three.stderr);
+ assert.equal(three.check.ok, true, JSON.stringify(three.check.composition.issues));
+ const ys3 = allPoints(three.svg, 'w', 'f').map((route) => route[0][1]);
+ assert.equal(new Set(ys3).size, 3, 'three parallel strokes need three distinct y values');
+});
+
+test('a reciprocal pair still lands just above and below the shared edge', () => {
+ const result = render(neighbourCase([
+ { from: 'w', to: 'f', label: 'fail' },
+ { from: 'f', to: 'w', label: 'recover' },
+ ]));
+ assert.equal(result.code, 0, result.stderr);
+ const cy = box(result.svg, 'w').y + box(result.svg, 'w').height / 2;
+ assert.deepEqual(points(result.svg, 'w', 'f').map((point) => point[1]), [cy - 10, cy - 10]);
+ assert.deepEqual(points(result.svg, 'f', 'w').map((point) => point[1]), [cy + 10, cy + 10]);
+});
+
+test('more than five parallel transitions between neighbours are a typed error', () => {
+ const result = render(neighbourCase(Array.from({ length: 6 }, (_, index) => ({ from: 'w', to: 'f', label: `way ${index}` }))));
+ assert.notEqual(result.code, 0);
+ assert.match(result.stderr, /\[lifecycle\/crowded-side-transitions\]/);
+ assert.match(result.stderr, /merge the triggers into one transition label/);
+});
+
+test('exits to one target with different labels or variants stay separate connectors', () => {
+ const result = render(base({
+ mainPath: ['a', 'b', 'c', 'd'],
+ states: [state('a', 'start'), state('b'), state('c'), state('d', 'success'), state('x', 'failure', 'Cancelled')],
+ transitions: [
+ { from: 'a', to: 'b' },
+ { from: 'b', to: 'c' },
+ { from: 'c', to: 'd' },
+ { from: 'b', to: 'x', label: 'user cancels', variant: 'dashed' },
+ { from: 'c', to: 'x', label: 'timeout', note: 'after 24h', variant: 'security' },
+ ],
+ }));
+ assert.equal(result.code, 0, result.stderr);
+ assert.equal(result.check.ok, true, JSON.stringify(result.check.composition.issues));
+ assert.notDeepEqual(points(result.svg, 'b', 'x'), points(result.svg, 'c', 'x'), 'different semantics draw separate routes');
+ assert.doesNotMatch(result.svg, /data-composition-junction/);
+ assert.doesNotMatch(result.svg, /data-edge-label="[^"]* \/ [^"]*"/, 'no merged edge label');
+ assert.doesNotMatch(result.svg, />user cancels \/ timeout</);
+ assert.match(result.svg, />user cancels<\/text>/);
+ assert.match(result.svg, />timeout<\/text>/);
+ assert.match(result.svg, />after 24h<\/text>/);
+});
+
+test('the artifact checker flags identical overlapping lifecycle routes', () => {
+ const result = render(neighbourCase([
+ { from: 'w', to: 'f', label: 'retry' },
+ { from: 'w', to: 'f', label: 'fail' },
+ ]));
+ assert.equal(result.code, 0, result.stderr);
+ const groups = [...result.html.matchAll(/<g data-graph-role="automatic-crossover"[^>]*>\s*<path data-graph-role="automatic-crossover-underlay" d="[^"]*"[^>]*\/>\s*<path [^>]*data-edge-from="w" data-edge-to="f"[^>]*\/>/g)];
+ assert.equal(groups.length, 2, 'two w -> f route groups');
+ const d = groups[0][0].match(/<path [^>]*data-edge-from="w"[^>]*\bd="([^"]+)"/)[1];
+ const routePoints = groups[0][0].match(/data-composition-points="([^"]+)"/)[1];
+ const duplicated = groups[1][0]
+ .replace(/\bd="[^"]*"/g, `d="${d}"`)
+ .replace(/data-composition-points="[^"]*"/, `data-composition-points="${routePoints}"`);
+ const file = path.join(tmp, 'overlapping-routes.html');
+ fs.writeFileSync(file, result.html.replace(groups[1][0], duplicated));
+ const checked = spawnSync('node', [path.join(skillRoot, 'scripts/check-render-output.mjs'), file], { encoding: 'utf8' });
+ const receipt = JSON.parse(checked.stdout);
+ assert.ok(receipt.composition.issues.some((issue) => issue.code === 'composition/ambiguous-corridor'),
+ JSON.stringify(receipt.composition.issues));
});
test('note-only transitions keep their text', () => {