pr-checks

PR Checks Summary

Usage: /pr-checks or /pr-checks <pr-number>

Purpose: Comprehensive Pull Request validation summary

---

🔍 What This Command Does

Shows complete PR validation status including:

1. Required checks status (passing/failing/pending)
2. Review approval status
3. Merge conflicts status
4. PR size and complexity metrics
5. CI/CD workflow results
6. Code coverage impact

---

📊 PR Validation Workflow

Step 1: Identify Pull Request

Determine which PR to check:

# If PR number provided
if [ -n "$ARGUMENTS" ]; then
    PR_NUMBER="$ARGUMENTS"
else
    # Get PR for current branch
    PR_NUMBER=$(gh pr view --json number --jq '.number' 2>/dev/null)

    if [ -z "$PR_NUMBER" ]; then
        echo "No PR found for current branch"
        echo "Create PR with: gh pr create"
        exit 1
    fi
fi

echo "Checking PR #$PR_NUMBER"

Step 2: Fetch PR Information

Get comprehensive PR details:

# Get PR metadata
gh pr view $PR_NUMBER --json \
  number,title,state,isDraft,mergeable,reviewDecision,\
  statusCheckRollup,additions,deletions,changedFiles,\
  url,baseRefName,headRefName,author,createdAt,updatedAt

# Example output structure:
# {
#   "number": 123,
#   "title": "feat: add session management",
#   "state": "OPEN",
#   "isDraft": false,
#   "mergeable": "MERGEABLE",
#   "reviewDecision": "APPROVED",
#   "statusCheckRollup": [...]
#   "additions": 450,
#   "deletions": 120,
#   "changedFiles": 8
# }

Step 3: Check Required Status Checks

Analyze CI/CD check status:

# Parse status checks
gh pr view $PR_NUMBER --json statusCheckRollup \
  --jq '.statusCheckRollup[] | {name: .name, status: .status, conclusion: .conclusion}'

# Group by status
PASSING=$(gh pr view $PR_NUMBER --json statusCheckRollup \
  --jq '[.statusCheckRollup[] | select(.conclusion=="SUCCESS")] | length')

FAILING=$(gh pr view $PR_NUMBER --json statusCheckRollup \
  --jq '[.statusCheckRollup[] | select(.conclusion=="FAILURE")] | length')

PENDING=$(gh pr view $PR_NUMBER --json statusCheckRollup \
  --jq '[.statusCheckRollup[] | select(.status=="PENDING")] | length')

TOTAL=$(gh pr view $PR_NUMBER --json statusCheckRollup --jq '.statusCheckRollup | length')