Update workflows: publish on tag push, auto-create releases

Author: kwent

.github/workflows/publish.yml

@@ -1,8 +1,9 @@
 name: Publish to Maven Central and GitHub Packages
 
 on:
-  release:
-    types: [created]
+  push:
+    tags:
+      - 'v*'
 
 jobs:
   publish:

.github/workflows/release.yml

@@ -0,0 +1,61 @@
+name: Create GitHub Release
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+
+      - name: Extract version from tag
+        id: version
+        run: echo "version=${GITHUB_REF#refs/tags/v}" >> $GITHUB_OUTPUT
+
+      - name: Extract changelog for version
+        id: changelog
+        run: |
+          # Extract the section for this version from CHANGELOG.md
+          VERSION="${{ steps.version.outputs.version }}"
+
+          # Get changelog content between version headers
+          CHANGELOG=$(awk "/## \[$VERSION\]/,/## \[/" CHANGELOG.md | sed '1d;$d' | sed '/^$/d')
+
+          # If changelog extraction failed, use a default message
+          if [ -z "$CHANGELOG" ]; then
+            CHANGELOG="Release version $VERSION
+
+          See [CHANGELOG.md](https://github.com/${{ github.repository }}/blob/master/CHANGELOG.md) for details."
+          fi
+
+          # Save to output using heredoc to handle multiline content
+          {
+            echo 'notes<<EOF'
+            echo "$CHANGELOG"
+            echo EOF
+          } >> $GITHUB_OUTPUT
+
+      - name: Create GitHub Release
+        uses: actions/github-script@v7
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          script: |
+            const tag = context.ref.replace('refs/tags/', '');
+            const version = tag.replace('v', '');
+
+            await github.rest.repos.createRelease({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              tag_name: tag,
+              name: `Release ${version}`,
+              body: `${{ steps.changelog.outputs.notes }}`,
+              draft: false,
+              prerelease: version.includes('-') || version.includes('alpha') || version.includes('beta') || version.includes('rc')
+            });

CLAUDE.md

@@ -160,7 +160,8 @@ The project uses **Spotless** with **Google Java Format (AOSP style)**:
 GitHub Actions workflows:
 - **test.yml** - Runs tests on all branches using JDK 17
 - **maven.yml** - Maven-based build pipeline
-- **publish.yml** - Publishes artifacts to Maven Central and GitHub Packages (triggered on releases)
+- **publish.yml** - Publishes artifacts to Maven Central and GitHub Packages (triggered on tag push)
+- **release.yml** - Creates GitHub releases with changelog notes (triggered on tag push)
 
 ## Publishing & Releases
 
@@ -179,37 +180,34 @@ make bump-patch   # 0.0.1 -> 0.0.2
 make bump-minor   # 0.0.1 -> 0.1.0
 make bump-major   # 0.0.1 -> 1.0.0
 
-# Push the tag to trigger release workflow
+# Push the tag to trigger automated workflows
 make push-tag
-
-# Create GitHub release (triggers publish.yml workflow)
-gh release create v0.0.2 --title "Release 0.0.2" --notes "Release notes here"
 ```
 
-**Automated workflow:**
-1. `make bump-patch` (or minor/major) - Updates version in both pom.xml and build.gradle, commits, and creates tag
-2. `make push-tag` - Pushes the tag to GitHub
-3. `gh release create` - Creates GitHub release which automatically triggers the publish workflow
-4. The workflow publishes to both Maven Central and GitHub Packages
+**Automated workflow (triggered by `make push-tag`):**
+1. `make bump-patch` (or minor/major) - Updates version in both pom.xml and build.gradle, commits, and creates tag locally
+2. `make push-tag` - Pushes the tag to GitHub, which automatically triggers:
+   - **publish.yml** - Runs tests, signs artifacts, publishes to Maven Central and GitHub Packages
+   - **release.yml** - Creates GitHub release with changelog notes
 
 **One-command releases:**
 ```bash
-# These combine bump + push-tag
-make release-patch   # Bump patch and push tag
-make release-minor   # Bump minor and push tag
-make release-major   # Bump major and push tag
-
-# Then create the GitHub release
-gh release create v0.0.2
+# These combine bump + push-tag (fully automated!)
+make release-patch   # Bump patch and push tag → triggers publish + release
+make release-minor   # Bump minor and push tag → triggers publish + release
+make release-major   # Bump major and push tag → triggers publish + release
 ```
 
-**What happens during publish:**
+**What happens automatically:**
 - Runs all tests
 - Signs artifacts with GPG
 - Deploys to Maven Central Portal (auto-publishes)
 - Deploys to GitHub Packages
+- Creates GitHub release with changelog notes from CHANGELOG.md
 - Available in Maven Central within 30 minutes
 
+**No manual steps needed!** Just run `make release-patch` and everything is automated.
+
 ### Version Management
 
 Version is tracked in two files (automatically updated by Makefile):

PUBLISHING.md

@@ -83,54 +83,51 @@ rm gpg-key.txt
 
 ## Publishing Process
 
-The publish workflow runs automatically when you create a GitHub release.
+The publish workflow runs automatically when you push a version tag.
 
-### Step 1: Update Version
+### Step 1: Update Version and Create Tag
 
 ```bash
 # Using Makefile (recommended)
 make bump-patch   # 0.0.1 -> 0.0.2
 make bump-minor   # 0.0.1 -> 0.1.0
 make bump-major   # 0.0.1 -> 1.0.0
 
-# Manual update
-sed -i '' 's/<version>0.0.1<\/version>/<version>0.0.2<\/version>/' pom.xml
-sed -i '' "s/version = '0.0.1'/version = '0.0.2'/" build.gradle
-git add pom.xml build.gradle
-git commit -m "Bump version to 0.0.2"
+# This updates pom.xml and build.gradle, commits, and creates a tag locally
 ```
 
-### Step 2: Push Changes
+### Step 2: Push Tag (Triggers Everything)
 
 ```bash
-git push origin master
+make push-tag
 ```
 
-### Step 3: Create a GitHub Release
-
-```bash
-# Using GitHub CLI (recommended)
-gh release create v0.0.2 \
-  --title "Release 0.0.2" \
-  --notes "Release notes here"
-
-# Or via GitHub UI:
-# Go to https://github.com/rootlyhq/rootly-java/releases/new
-```
-
-### Step 4: Monitor the Workflow
-
-The publish workflow will automatically:
-
+**This single command automatically triggers:**
 1. ✅ Run all tests
 2. ✅ Sign artifacts with GPG
 3. ✅ Deploy to Maven Central Portal
 4. ✅ Auto-publish to Maven Central (no manual UI steps needed!)
 5. ✅ Deploy to GitHub Packages
+6. ✅ Create GitHub release with changelog notes
+
+### One-Command Release (Recommended)
+
+```bash
+# Combines bump + push (fully automated!)
+make release-patch   # 0.0.1 -> 0.0.2
+make release-minor   # 0.0.1 -> 0.1.0
+make release-major   # 0.0.1 -> 1.0.0
+```
+
+### Step 3: Monitor the Workflows
+
+Two workflows run automatically on tag push:
+- **publish.yml** - Publishes to Maven Central and GitHub Packages
+- **release.yml** - Creates GitHub release with changelog
 
 Check the Actions tab: https://github.com/rootlyhq/rootly-java/actions
 
-### Step 5: Verify Publication
+### Step 4: Verify Publication
 
 **Maven Central** (available within 30 minutes):
 - Search: https://central.sonatype.com/artifact/com.rootly.client/rootly