release.yml

name: Release on Tag Push

on:
  push:
    tags:
      - 'v*'

permissions:
  contents: write

jobs:
  release:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v4

      - name: Extract version from tag
        id: version
        run: echo "tag=${GITHUB_REF#refs/tags/}" >> "$GITHUB_OUTPUT"

      - name: Extract changelog for this version
        id: changelog
        run: |
          TAG="${{ steps.version.outputs.tag }}"
          # Extract the section for this tag from changelog
          # Matches from "## vX.Y.Z" (with optional suffix) to the next "## " or EOF
          BODY=$(awk -v tag="$TAG" '
            BEGIN { found=0 }
            /^## / {
              if (found) exit
              # Match the tag, allowing optional suffix after version (e.g. "- Breaking change")
              header=$2
              # Remove trailing characters after version pattern
              gsub(/[^v0-9.].*/, "", header)
              if (header == tag) { found=1; next }
            }
            found { print }
          ' docs/changelog.md)

          # Fail if no changelog found
          if [ -z "$BODY" ]; then
            echo "::warning::No changelog entry found for $TAG, using default message"
            BODY="Release $TAG"
          fi

          # Write to file to preserve multiline content
          echo "$BODY" > /tmp/release-body.md

      - name: Delete existing release if present
        run: |
          TAG="${{ steps.version.outputs.tag }}"
          if gh release view "$TAG" &>/dev/null; then
            echo "Deleting existing release for $TAG"
            gh release delete "$TAG" --yes
          fi
        env:
          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}

      - name: Create GitHub Release
        run: |
          TAG="${{ steps.version.outputs.tag }}"
          gh release create "$TAG" \
            --title "$TAG" \
            --notes-file /tmp/release-body.md
        env:
          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}