Skip to main content

Task Breakdown: Scheduled Work Updates

Feature ID: scheduled-updates Status: Done (Retrospective) Last updated: 2026-05-01


Phase 1 — Schema & contracts

  • T1. WorkSchedule entity, repository, contracts DTO.
  • T2. Migrations: initial table, cadence enum additions, scheduledFor, providerOverrides.

Phase 2 — Service

  • T3. WorkScheduleService (CRUD + state transitions).
  • T4. WorkScheduleRepository.tryMarkDispatched — CAS claim.
  • T5. WorkScheduleDispatcherService.dispatchDue.
  • T6. Drift correction (scheduledFor anchor + resolveAnchorDate).
  • T7. Zombie recovery (recoverStuckSchedules).
  • T8. Auto-pause + notification.
  • T9. Run-now slot preservation (isManualRunAheadOfSchedule).

Phase 3 — Trigger.dev

  • T10. workScheduleDispatcherTask (schedules.task) at packages/tasks/src/tasks/trigger/work-schedule-dispatcher.task.ts.

Phase 4 — API

  • T11. Schedule controller endpoints (GET / PUT / DELETE / POST run).
  • T12. Schedule e2e tests.

Phase 5 — Web / CLI

  • T13. Schedule UI on work detail page.
  • T14. CLI work schedule commands.

Phase 6 — Docs

  • T15. User-facing doc docs/features/scheduled-updates.md.
  • T16. Architectural deep-dive docs/agent-services/work-schedule-dispatcher.md.
  • T17. Retrospective spec/plan/tasks.

Definition of Done

  • All tasks shipped, tests pass, docs present, constitution gates verified.