Skip to main content
← Back to list
01Issue
FeatureShippedSwamp CLI
Assigneesstack72

Relationships

↔ sibling #369

#469 Document manual_approval workflow step type and suspend/approve/resume flow

Opened by stack72 · 5/28/2026· Shipped 5/28/2026

Follow-up from #369 (manual_approval steps).

The manual_approval step type adds a significant new workflow capability that needs documentation across multiple pages in the manual.

New CLI commands to document

  • swamp workflow approve <workflow> <step> — approve a suspended step
  • swamp workflow reject <workflow> <step> — reject a suspended step
  • swamp workflow resume <workflow> — resume a suspended workflow after approval
  • swamp workflow approvals — list all workflows awaiting approval

Reference docs (content/manual/reference/)

workflows.md needs:

  • New manual_approval task type with prompt and timeout fields
  • New workflow run status: suspended
  • New step run status: waiting_approval
  • The approvalDecision field on step run records (approved, reason, decidedBy, decidedAt)
  • The suspend/approve/resume lifecycle

How-to guides (content/manual/how-to/)

A new how-to guide for multi-phase rollouts with operator gates:

  • Setting up a workflow with manual_approval steps
  • The full operator flow: run → verify out-of-band → approve → resume
  • Using timeout to auto-expire stale approvals
  • Checking pending approvals with swamp workflow approvals
  • Multi-user approval (another operator approves, original operator resumes)

Explanation (content/manual/explanation/)

Update the workflow execution model explanation to cover:

  • How suspend persists state to disk
  • How resume reconstructs execution context and skips completed steps
  • The separation of approve (lightweight write) vs resume (heavyweight execution)
  • Comparison with industry equivalents (Argo suspend, Step Functions wait-for-token, Jenkins input)
02Bog Flow
OPENTRIAGEDIN PROGRESSSHIPPED+ 1 MOREASSIGNED+ 5 MOREREVIEW+ 3 MOREPR_MERGED+ 1 MORENOTIFICATION_SKIPPED

Shipped

5/28/2026, 6:58:54 PM

Click a lifecycle step above to view its details.

03Sludge Pulse
stack72 assigned stack725/28/2026, 6:23:49 PM
stack72 linked related to #3695/28/2026, 5:19:30 PM

Sign in to post a ripple.