# summary

Complete a setup-agents review.

# description

Appends an updated JSON Lines review entry to `.setup-agents/state/reviews.jsonl` with the final result.

The result must be `approved`, `blocked`, or `changes`.

# flags.id.summary

Review record id.

# flags.id.description

The id of the review record to complete.

# flags.result.summary

Review outcome.

# flags.result.description

Final result of the review: `approved`, `blocked`, or `changes`.

# flags.reviewer.summary

Profile completing the review.

# flags.reviewer.description

The setup-agents profile acting as reviewer, stored as `setup-agents:<profile>`.

# flags.findings.summary

Review findings.

# flags.findings.description

Summarize what was found during the review.

# flags.recommendation.summary

Review recommendation.

# flags.recommendation.description

Describe the recommended next action after this review.

# flags.return-to.summary

Target phase for correction routing.

# flags.return-to.description

When the result is `blocked` or `changes`, specify which phase the correction should be routed to. On next `workflow run --resume`, the workflow will return to this phase automatically.

# examples

- Approve a review:

  <%= config.bin %> <%= command.id %> --id setup-agents-review-1234567-abc123 --result approved --reviewer qa --findings "All acceptance criteria met"

- Block a review with changes needed:

  <%= config.bin %> <%= command.id %> --id setup-agents-review-1234567-abc123 --result changes --reviewer security --findings "Missing input validation" --recommendation "Add gate check before status update"

# info.completed

Review completed: %s → %s (%s)