# summary

Mark a setup-agents task done.

# description

Appends a completed task state entry to `.setup-agents/state/tasks.jsonl`.

# flags.task.summary

Task id.

# flags.task.description

Task id to mark done.

# flags.role.summary

Completing role.

# flags.role.description

Alias for a setup-agents profile owner such as `developer`, stored as `setup-agents:developer`.

# flags.profile.summary

Completing setup-agents profile.

# flags.profile.description

Record the setup-agents profile completing this task.

# flags.evidence.summary

Related evidence ids.

# flags.evidence.description

Comma-separated evidence record ids to attach while completing the task.

# examples

- Mark a task done with evidence:

  <%= config.bin %> <%= command.id %> --task SA-97 --evidence setup-agents-evidence-1

# info.done

Task completed: %s (%s)

# errors.notFound

Task not found: %s

# flags.push-to.summary

Push task completion to GitHub Issue or Jira ticket.

# flags.dry-run.summary

Print the write-back payload without sending.

# flags.ticket.summary

GitHub issue number or Jira ticket ID to comment on.

# info.writeBackPushed

Pushed to %s: %s

# info.writeBackDryRun

[dry-run] Would push to %s:

# flags.risk-accept.summary

Accept lifecycle risk and complete the task.

# flags.risk-accept.description

Explicit rationale for overriding reconciliation blockers. The rationale and finding codes are appended to task history for audit. This does not create gate approvals.

# warn.noWorkflowRun

Task %s is being completed without any workflow run. The contract marks `workflow run` as mandatory — registering a task is a precondition, not the work. Run `sf setup-agents workflow run --task %s --gates phase` and execute its phases, or pass --no-workflow-check if this task is genuinely trivial.

# warn.workflowRunNoPhases

Task %s has a workflow run that never executed a phase (phases: []). `workflow run` was invoked but the PM→PO→Architect→Developer→QA→Document Review→Release phases were never driven. Resume the run and execute its phases before marking the task done.