Module fsm 

Finite State Machines for workflow run and step lifecycles.

Instead of ad-hoc can_transition_to() checks scattered across the codebase, these FSMs provide typed events, explicit transition tables, and a history of transitions for observability.

Architecture

• RunFsm — Manages the lifecycle of a Run.
• StepFsm — Manages the lifecycle of a Step.
• RunEvent / StepEvent – Typed events that trigger transitions.
• Transition — A recorded state change with event and timestamp.

Structs

RunFsm

Finite state machine for a workflow run.

StepFsm

Finite state machine for a workflow step.

Transition

A recorded state transition.

TransitionError

Error returned when a transition is not allowed.

Enums

RunEvent

Events that drive RunFsm transitions.

StepEvent

Events that drive StepFsm transitions.