Validation errors
Programs are validated at load time before execution. Common errors:
| Error | Cause |
|---|---|
invalid_initial | program.initial names a state that does not exist |
invalid_transition | on: target names an undefined state |
missing_node_ref | Active state without node: |
undefined_node | Active state references unknown node ID |
no_final_state | No state with type: final |
unreachable_final | No final state reachable from initial |
Fixing validation errors
- Read the error message — it includes state names and paths.
- Ensure every
on:target exists instates:. - Ensure active states have valid
node:references. - Add at least one
finalstate on a reachable path.
Missing program fields
Loader errors when program lacks id, version, or initial.
Try it: Intentionally break example.yml (bad transition target) and run definitively run to see the error format.