Ciclo de vida de workflows

Papel no sistema

Esta página explica o caminho de um run desde o trigger até o estado terminal. apps/workflows é o único dono dos bindings de Cloudflare Workflows.

Onde fica o código

O ciclo ao vivo está em apps/workflows/src/service.ts; a execução persistida fica em packages/workflow-core/src/run.ts; os eventos ficam em packages/workflow-core/src/instrument.ts; e a UI de operação fica em apps/monitor/src/routes/_app/workflows.

Como se conecta com o resto

apps/api e apps/monitor chamam apps/workflows por service binding RPC para ações ao vivo. Leituras históricas baratas usam D1 diretamente. Cada run grava estado em workflow_runs; cada step instrumentado grava timeline em workflow_run_events; settings de schedule ficam em workflow_schedule_settings.

Como verificar

Dispare um workflow pelo monitor, abra o detalhe do run e confirme status e eventos. Para regressões automatizadas, rode pnpm --filter workflows test, pnpm --filter @repo/workflow-core test e os testes de monitor relacionados a workflows.