Skip to content

feat: sequence diagrams - #18

Merged
hyamero merged 12 commits into
mainfrom
feat/sequence
Sep 29, 2026
Merged

hyamero merged 12 commits into
mainfrom
feat/sequence

Conversation

@hyamero

@hyamero hyamero commented Sep 29, 2026

Copy link
Copy Markdown
Member

Second of three PRs toward the archify gallery. This one covers the two sequence examples, Cache miss request and Async job roundtrip. It is stacked on #17: merge #17 first, then retarget this PR to main before merging.

The model. kind: "sequence" reuses the one diagram shape:

  • Nodes are the participants.
  • Edges are the messages, in array order: kind sync, async or return, plus tone.
  • phases[].edges are time bands.

The agent gives only order. archify makes it author a pixel y for every message and every activation bar.

Layout (packages/layout/src/sequence.ts):

  • Lifeline spacing comes from the labels, and each message gets its own row.
  • Activation bars come from a per-participant stack:
    • a call opens a bar; a callback to a participant waiting on its own call nests one;
    • a reply closes the bar opened by the call it answers;
    • an unanswered bar ends where its participant was last busy.
  • 2000 messages lay out in about 20ms.

Validation. Warnings for a reply that answers no call and for a band that covers messages it doesn't list. Overlapping bands are an error.

Viewer:

  • Lifelines, activation bars, time bands and text labels.
  • The intro plays in time order.
  • Fit and export frames include edge labels.

Docs. The skill teaches sequences, including a Mermaid sequenceDiagram mapping.

Reviewed in a fresh context together with the next PR. The findings for this part (callback bars, a clipped self-call label, band gaps, docs) are fixed with tests.

@hyamero
hyamero changed the base branch from feat/workflow-lifecycle to main September 29, 2026 18:15
@hyamero
hyamero merged commit dfa0958 into main Sep 29, 2026
2 checks passed
@hyamero
hyamero deleted the feat/sequence branch September 30, 2026 03:31
@github-actions

github-actions Bot commented Oct 2, 2026

Copy link
Copy Markdown
Contributor

🎉 This PR is included in version 0.1.0-rc.1 🎉

The release is available on:

Your semantic-release bot 📦🚀

@github-actions

github-actions Bot commented Oct 2, 2026

Copy link
Copy Markdown
Contributor

🎉 This PR is included in version 0.1.0 🎉

The release is available on:

Your semantic-release bot 📦🚀

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant