ci: switch release flow to PR-based tagging

Author: bntvllnt

.github/workflows/release-tag.yml

@@ -1,4 +1,4 @@
-name: Release Tag
+name: Release PR
 
 on:
   workflow_dispatch:
@@ -15,13 +15,15 @@ on:
 
 permissions:
   contents: write
+  pull-requests: write
 
 jobs:
   release:
     runs-on: ubuntu-latest
     steps:
       - name: Ensure main branch
         run: test "${{ github.ref_name }}" = "main"
+
       - name: Checkout
         uses: actions/checkout@v4
         with:
@@ -53,14 +55,31 @@ jobs:
           git config user.name "github-actions[bot]"
           git config user.email "github-actions[bot]@users.noreply.github.com"
 
-      - name: Bump version and create tag
+      - name: Bump version
         id: bump
         run: |
-          NEW_VERSION=$(npm version ${{ github.event.inputs.bump }} -m "chore(release): %s [skip ci]")
-          echo "version=$NEW_VERSION" >> "$GITHUB_OUTPUT"
+          npm version ${{ github.event.inputs.bump }} --no-git-tag-version
+          VERSION="v$(node -p \"require('./package.json').version\")"
+          BRANCH="release/${VERSION}"
+          echo "version=$VERSION" >> "$GITHUB_OUTPUT"
+          echo "branch=$BRANCH" >> "$GITHUB_OUTPUT"
+
+      - name: Commit version bump
+        run: |
+          git checkout -b "${{ steps.bump.outputs.branch }}"
+          git add package.json
+          git commit -m "chore(release): ${{ steps.bump.outputs.version }} [skip ci]"
 
-      - name: Push release commit and tag
-        run: git push origin HEAD:${{ github.ref_name }} --follow-tags
+      - name: Push release branch
+        run: git push -u origin "${{ steps.bump.outputs.branch }}"
 
-      - name: Release summary
-        run: echo "Created and pushed ${{ steps.bump.outputs.version }}"
+      - name: Create release pull request
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          gh pr create \
+            --base main \
+            --head "${{ steps.bump.outputs.branch }}" \
+            --title "chore(release): ${{ steps.bump.outputs.version }}" \
+            --body "Automated release bump for ${{ steps.bump.outputs.version }}.\n\n- Verification passed (lint, typecheck, build, test)\n- Merge this PR to create and publish tag automatically" \
+            --assignee "${{ github.actor }}"

.github/workflows/tag-release.yml

@@ -0,0 +1,31 @@
+name: Tag Release
+
+on:
+  push:
+    branches:
+      - main
+
+permissions:
+  contents: write
+
+jobs:
+  tag:
+    runs-on: ubuntu-latest
+    if: startsWith(github.event.head_commit.message, 'chore(release): v')
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Create and push tag
+        run: |
+          VERSION="v$(node -p \"require('./package.json').version\")"
+          if git ls-remote --tags origin | grep -q "refs/tags/${VERSION}$"; then
+            echo "Tag ${VERSION} already exists; skipping"
+            exit 0
+          fi
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git tag "${VERSION}" -m "Release ${VERSION}"
+          git push origin "${VERSION}"

README.md

@@ -241,18 +241,19 @@ Publishing is automated and **only happens on `v*` tags**.
 - `CI` workflow runs on every PR and push to `main`:
   - lint → typecheck → build → test
 
-### Create a release (auto bump + auto tag)
+### Create a release (auto bump + PR + auto tag)
 
-1. Open GitHub Actions → `Release Tag`.
+1. Open GitHub Actions → `Release PR`.
 2. Click **Run workflow** on `main`.
 3. Select bump type: `patch` | `minor` | `major`.
+4. Merge the generated release PR.
 
-`Release Tag` will:
+`Release PR` will:
 - run lint → typecheck → build → test
 - bump `package.json` version
-- create and push `vX.Y.Z` tag
+- open a release PR assigned to the workflow runner
 
-Pushing that tag triggers `Publish to npm`, which runs checks again and publishes.
+After merge, `Tag Release` creates and pushes `vX.Y.Z`, which triggers `Publish to npm`.
 
 ## Contributing