RaisinDB Workflows

A workflow is a raisin:Flow node whose workflow_data property holds the flow definition in designer format — the same format the admin console's visual designer reads and writes. The engine lowers it to runtime steps; functions, AI agents, and humans are uniform step concepts; the inbox is the human-in-the-loop primitive.

Working reference apps (read these before inventing anything):

• examples/shiftboard/package/content/functions/flows/fill-shift/.node.yaml — candidates → loop → human approval task → assign → notify (the canonical "ask people one by one until someone accepts" pattern)
• examples/workflows/event-ticketing/run.mjs — saga compensation, OR routing, approval gate, full SDK run+inbox client code

MANDATORY after editing any flow YAML: run the flow doctor before deploying — it catches the template/REL traps listed below:

npx raisindb flow doctor <path-to-package-or-flow>