Review PR

Review a GitHub pull request, verify CI status, and merge + tag a release if appropriate.

Workflow

1. Fetch PR details

Use gh CLI to get the PR diff, description, and CI status:

gh pr view <number> --json title,body,additions,deletions,files,reviews,statusCheckRollup,headRefName,baseRefName
gh pr diff <number>

2. Review the changes

Carefully review the diff. Pay attention to:

• Code quality and correctness
• Potential bugs or edge cases
• Whether the change matches the PR description
• Test coverage for new functionality
• Adherence to existing code style and patterns in the package

If there are issues, post a review comment via gh pr review <number> --request-changes --body "..." and stop.

3. Check CI status

All CI checks must be green before merging. Verify via the statusCheckRollup field from step 1. If CI is failing or pending, inform the user and stop.

4. Merge and release

If the review looks good and CI is green:

1. Merge the PR: gh pr merge <number> --squash --delete-branch
2. Determine the appropriate version bump by checking the latest tag: gh release list --limit 1
3. Tag a new release with the next appropriate version number

Versioning rules

• NEVER tag a major version bump without explicit user approval. Always ask first.
• Dropping support for a PHP or Laravel version is NOT a breaking change — use a minor or patch bump.
• New features: minor version bump (e.g. 1.2.0 → 1.3.0)
• Bug fixes, typos, dependency updates: patch version bump (e.g. 1.2.0 → 1.2.1)
• When in doubt about the version bump level, ask the user.

Creating the release

gh release create <tag> --title "<tag>" --generate-notes

Use --generate-notes to auto-generate release notes from the merged PR.