pr-summary

PR Summary

Generate a pull request description from $ARGUMENTS (or the current branch if no arguments are provided).

Phase 1: PR Template Detection

Search for a PR template using two Glob patterns in parallel (both MUST be executed):

• **/*PULL_REQUEST_TEMPLATE*
• **/*pull_request_template*

From the combined results, select the first match according to this priority order:

1. Root: PULL_REQUEST_TEMPLATE.md or pull_request_template.md
2. .github/PULL_REQUEST_TEMPLATE.md or pull_request_template.md
3. docs/PULL_REQUEST_TEMPLATE.md or pull_request_template.md
4. .github/PULL_REQUEST_TEMPLATE/ directory (use the default template)

If no match is found, use the default template from refs/default-template.md.

Read the selected template. This template defines the exact sections and structure the final PR description must follow.

Phase 2: Git Information Collection

Collect all git information in a single Bash call by running the following combined command. This is critical to minimize API round-trips and avoid rate limiting:

echo "===BRANCH===" && git rev-parse --abbrev-ref HEAD && echo "===BASE===" && git remote show origin 2>/dev/null | grep 'HEAD branch' | sed 's/.*: //' || (git branch -a --format='%(refname:short)' | grep -E '^(origin/)?(main|master|develop)$' | head -1 | sed 's|origin/||') && echo "===STATUS===" && git status --porcelain && echo "===LOG===" && git log --oneline $(git remote show origin 2>/dev/null | grep 'HEAD branch' | sed 's/.*: //' || echo main)...HEAD 2>/dev/null && echo "===STAT===" && git diff --stat $(git remote show origin 2>/dev/null | grep 'HEAD branch' | sed 's/.*: //' || echo main)...HEAD 2>/dev/null && echo "===DIFF===" && git diff $(git remote show origin 2>/dev/null | grep 'HEAD branch' | sed 's/.*: //' || echo main)...HEAD 2>/dev/null

Parse the output by the ===SECTION=== delimiters to extract each piece of information.

If the base branch cannot be determined from the output, ask the user which branch to compare against.