You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
This repository was archived by the owner on Aug 11, 2026. It is now read-only.
Parent epic: #738
Depends on: #739
Related completed foundations: existing workflow module, #681, #697
Context
The current workflow approval foundation supports reusable approval behavior, but enterprise-derived applications need managed versioned definitions, conditional and parallel routing, delegation/substitution, escalation/timeouts, quorum rules, and a consolidated approval inbox. These capabilities must remain generic and must not introduce a heavy external BPMN engine into the base.
Objective
Evolve the existing workflow module into a safe enterprise workflow minimum while preserving immutable active definitions, deterministic instance history, default-deny authorization, and module-owned domain decisions.
Scope
Add managed workflow-definition CRUD with draft, validate, publish/activate, retire, and version history.
Define generic nodes/transitions for:
sequential approval;
conditional routing based on validated bounded facts;
parallel branches;
quorum/any/all approval rules;
notification/manual task nodes where already supported by capability ports.
Ensure each workflow instance is pinned to the definition version used at start.
Add delegation/substitute assignments with effective dates, scope, reason, and audit.
Add escalation and timeout policies processed by shared jobs with bounded batches, locks, and idempotency.
Add reassignment/cancellation/administrative recovery rules with explicit permissions and immutable history.
Add a consolidated admin/operator approval inbox with pagination, filters, due/overdue state, safe search, and action history.
Define a workflow context contract that references domain resources without writing their tables or embedding arbitrary expressions/code.
Allow module-contributed condition resolvers/actions through static capability ports and schema-validated facts.
Parent epic: #738
Depends on: #739
Related completed foundations: existing
workflowmodule, #681, #697Context
The current workflow approval foundation supports reusable approval behavior, but enterprise-derived applications need managed versioned definitions, conditional and parallel routing, delegation/substitution, escalation/timeouts, quorum rules, and a consolidated approval inbox. These capabilities must remain generic and must not introduce a heavy external BPMN engine into the base.
Objective
Evolve the existing workflow module into a safe enterprise workflow minimum while preserving immutable active definitions, deterministic instance history, default-deny authorization, and module-owned domain decisions.
Scope
Security and integrity requirements
Out of scope
Acceptance criteria
bun run api:spec:check,bun run security:readiness,bun run test, UI/E2E checks, andbun run checkpass.