Skip to content

feat: workflow and lifecycle diagrams - #17

Merged
hyamero merged 14 commits into
mainfrom
feat/workflow-lifecycle
Sep 29, 2026
Merged

hyamero merged 14 commits into
mainfrom
feat/workflow-lifecycle

Conversation

@hyamero

@hyamero hyamero commented Sep 29, 2026

Copy link
Copy Markdown
Member

First of three PRs to make stackmap cover every example in the archify gallery. This one covers the three workflows and two lifecycles, and brings the architecture and dataflow examples closer.

Diagrams

  • kind: "workflow" and "lifecycle" draw as swimlanes. Nodes sit in lanes, and stackmap picks the columns from the edges: the agent still never gives coordinates, where archify makes it write lane, column and pixel positions.
  • Lifecycles use state types (start, active, waiting, decision, success, failure, neutral). A start state gets an initial marker; an end state gets a double outline.
  • phases label column spans. In architecture and dataflow diagrams they are ordered stages, laid out with ELK partitioning.
  • Edge tone (main, security, error) and kind: "return"; group tone: "security"; notes listed in the inspector.
  • Compact cards (title, subtitle, brand, tag) for the lane kinds, and via density: "compact" for architecture and dataflow.

Layout. Lanes get their own column assignment (in core, shared with validation) and an orthogonal A* router in packages/layout:

  • 5 port slots per side, so a call and its reply, or edges of different tones, never share a port.
  • Channel nudging, and labels placed clear of cards and of each other.
  • Covered by invariant tests on every gallery sample and a 150-case property test.

Validation. New kind rules: lanes, state types, compact-card sections, phase members and order (including through unphased steps), lane groups that would frame other steps, and a 200-node cap for lane kinds.

Docs. The skill, authoring contract and examples cover the new kinds.

Reviewed in a fresh context. The Critical (a phase loop through an unphased node made the column fixpoint diverge) and all Important findings are fixed, with regression tests.

@hyamero hyamero mentioned this pull request Sep 29, 2026
@hyamero
hyamero merged commit 142be33 into main Sep 29, 2026
2 checks passed
@hyamero
hyamero deleted the feat/workflow-lifecycle 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