pr

Context (auto-detected from HEAD)

• Current branch: !git branch --show-current
• Remote status: !git status -sb | head -1

PR Template

Read .github/PULL_REQUEST_TEMPLATE.md and fill every section. The template is mandatory. Do not free-form the PR body.

Rules

• PR title: type(scope): description (conventional commit format, under 70 chars)
• Target branch: first positional arg from $ARGUMENTS if provided, otherwise dev
• Source branch: if --branch <name> is in $ARGUMENTS, use that branch for diff/log commands instead of HEAD. This is needed when the PR branch lives in a different worktree or the main repo checkout.
• Push with -u if needed
• Use gh pr create with --body "$(cat <<'EOF' ... EOF)" for correct formatting
• LOC check: if diff exceeds 200 changed lines (excluding generated files), warn the user and suggest splitting into stacked PRs

Reviewer Resolution

Before filling the Reviewers section, resolve ownership from CODEOWNERS and git history.

Step 1: CODEOWNERS lookup

Run this to find owners for every changed file:

git diff --name-only upstream/dev..<source-branch> | while read -r file; do
  owner=""
  while IFS= read -r line; do
    line="${line%%#*}"                      # strip comments
    [ -z "$(echo "$line" | tr -d '[:space:]')" ] && continue
    pattern=$(echo "$line" | awk '{print $1}')
    owners=$(echo "$line" | awk '{$1=""; print $0}' | xargs)
    # convert CODEOWNERS glob to regex: /foo/ matches foo/anything, *.rs matches *.rs
    case "$file" in
      ${pattern#/}*) owner="$owners" ;;
    esac
  done < .github/CODEOWNERS
  echo "$owner"
done | tr ' ' '\n' | grep '^@' | sort | uniq -c | sort -rn

The top results are the CODEOWNERS-designated reviewers.

Step 2: blame-based context reviewers

Run this to find who recently touched the changed files (excluding the PR author):

author=$(git config user.name)
git diff --name-only upstream/dev..<source-branch> | head -20 | while read -r file; do
  [ -f "$file" ] && git log --format='%aN' --since='3 months' -- "$file"
done | sort | uniq -c | sort -rn | grep -v "$author" | head -5