Experimental Livebook-friendly DSL for sketching workflows.

This Lab DSL compiles to the stable, pipe-first Choreo.Workflow builders and returns an ordinary %Choreo.Workflow{}. It is useful for business processes, approvals, Sagas, CI/CD flows, and system-design walkthroughs where the shape of execution matters more than builder ceremony.

Examples

iex> import Choreo.Lab.DSL.Workflow
...> flow = workflow do
...>   backend = swimlane("Backend")
...>   start = begin("Request received")
...>   validate = task("Validate token", swimlane: backend, timeout_ms: 100)
...>   authorized = decision("Authorized?")
...>   accepted = finish("Return 200")
...>   rejected = finish("Return 403")
...>
...>   start ~> validate
...>   validate ~> authorized
...>   authorized ~> accepted |> condition("yes")
...>   failure authorized ~> rejected, "no"
...> end
iex> Enum.sort(Choreo.Workflow.starts(flow))
[:start]
iex> Enum.sort(Choreo.Workflow.ends(flow))
[:accepted, :rejected]

Edges can use generic, typed, or pipe-modified forms:

start ~> validate
decision ~> approved |> condition("yes")
edge task ~> retry_step, retry: "temporary failure"
failure task ~> rollback, "validation failed"
compensation rollback ~> done, "cleanup finished"