roark

Search documentation

Search across all Roark documentation pages.

Type to search across the docs.

docs/pr-reviews.md

PR reviews

Review an existing PR without changing it.

Last updated

View Markdown
bash
roark review-pr 123 --repo owner/repo

review-pr runs separate correctness and maintainability reviews against the full PR diff. It does not edit files, commit, push, or invoke revise-pr.

#Flow

  1. Fetch the PR, its comments and review threads, and the base and head commit IDs.
  2. Prepare a managed workspace at the pinned PR head.
  3. Run the configured verification command once.
  4. Run the correctness and maintainability reviews with editing disabled.
  5. Save both reviews as Markdown.
  6. Check that the PR head has not changed, then post the reviews as two comments.

Use --no-comment to keep the review local. Roark also skips posting if the PR state, base, or head changes during the run. If posting fails, it returns an error but keeps the local result. Each rerun posts two new comments.

Run roark revise-pr 123 separately to implement existing feedback and push a revision.