Workflows Engine

The workflow engine composes triggers, conditions, and actions into approval and automation flows.

Core Primitives

1. Trigger: when to evaluate
2. Condition: whether to proceed
3. Action: what to execute
4. Action when: action-level gate

Runtime Model

1. Hook or event determines a candidate workflow definition
2. Engine evaluates trigger and conditions
3. Actions execute in order, with approval actions introducing natural gating
4. Workflow instance state advances through events until completion/failure

Key Components

1. internal/workflows/engine for orchestration and execution
2. internal/workflows/reconciler for retries and recovery
3. internal/workflows/resolvers for dynamic target resolution
4. internal/workflows/observability for telemetry hooks

Approval Behavior

1. PRE_COMMIT: staged proposal behavior before mutation is finalized
2. POST_COMMIT: review/automation after mutation is committed

For full architecture and event lifecycle details, refer to internal/workflows/README.md in core.