bitwise-media-group/Fast-forward merge
Fast-forward a base branch to an approved, green pull request's head commit, preserving the original commit signature. Verifies write access, approval, passing checks, and a genuine fast-forward before moving the ref.
View on GitHubTrust Signals
- Scorecard Score
- not yet scored
- Maintenance Recency
- Stale
- License
- None
Inputs
| name | description | required | default |
|---|---|---|---|
| token | GitHub App installation token with contents:write, pull-requests:write, and administration:read, plus issues:write to auto-close linked issues (omit it and the merge still succeeds; closing is skipped with a warning). Typically minted by the calling workflow with actions/create-github-app-token. | yes | — |
| repository | The owner/repo whose base branch is fast-forwarded. | no | ${{ github.repository }} |
| pr-number | Number of the pull request to fast-forward into its base branch. | yes | — |
| actor | Login that requested the merge; checked for write access when maintainer-only is true. | no | ${{ github.actor }} |
| require-approval | Require the pull request's review decision to be APPROVED. | no | true |
| maintainer-only | Require the actor to have write or higher access. | no | true |
| require-label | If set, only fast-forward when the pull request carries a label with this exact name; otherwise skip without merging and without failing. Empty (the default) imposes no label requirement. The auto-merge flow sets it to the arming label. Needs no token scope beyond the pull-requests it already uses. | no | "" |
Outputs
| name | description |
|---|---|
| merged | "true" if the base branch was fast-forwarded to the PR head. |
| head-sha | The PR head SHA the base branch now points to. |
| base | The base branch that was fast-forwarded. |
| closed-issues | Comma-separated "owner/repo#number" of the linked issues this merge closed (the PR's closing-keyword references). Empty when there are none. |