release.yml

name: Release

on:
  push:
    branches: [main]

jobs:
  release:
    name: Tag & Publish
    runs-on: ubuntu-latest
    permissions:
      contents: write
    outputs:
      tag: ${{ steps.version.outputs.tag }}
      version: ${{ steps.version.outputs.version }}
      created: ${{ steps.check.outputs.exists == 'false' }}
    steps:
      - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4
        with:
          fetch-depth: 0

      - name: Get version from Cargo.toml
        id: version
        run: |
          VERSION=$(grep '^version' Cargo.toml | head -1 | sed 's/.*"\(.*\)".*/\1/')
          echo "version=$VERSION" >> "$GITHUB_OUTPUT"
          echo "tag=v$VERSION" >> "$GITHUB_OUTPUT"

      - name: Check if tag already exists
        id: check
        run: |
          if git rev-parse "v${{ steps.version.outputs.version }}" >/dev/null 2>&1; then
            echo "exists=true" >> "$GITHUB_OUTPUT"
          else
            echo "exists=false" >> "$GITHUB_OUTPUT"
          fi

      - name: Create git tag
        if: steps.check.outputs.exists == 'false'
        run: |
          git tag "${{ steps.version.outputs.tag }}"
          git push origin "${{ steps.version.outputs.tag }}"

      - uses: dtolnay/rust-toolchain@29eef336d9b2848a0b548edc03f92a220660cdb8 # stable
        if: steps.check.outputs.exists == 'false'

      - name: Publish to crates.io
        if: steps.check.outputs.exists == 'false'
        env:
          CARGO_REGISTRY_TOKEN: ${{ secrets.CARGO_REGISTRY_TOKEN }}
        run: cargo publish || echo "::warning::crates.io publish skipped (version may already exist)"

      - name: Create GitHub Release
        if: steps.check.outputs.exists == 'false'
        env:
          GH_TOKEN: ${{ github.token }}
        run: |
          gh release create "${{ steps.version.outputs.tag }}" \
            --title "${{ steps.version.outputs.tag }}" \
            --generate-notes

  build-binaries:
    name: Build (${{ matrix.target }})
    needs: release
    if: needs.release.outputs.created == 'true'
    runs-on: ${{ matrix.os }}
    permissions:
      contents: write
    strategy:
      fail-fast: false
      matrix:
        include:
          - target: x86_64-unknown-linux-gnu
            os: ubuntu-latest
            archive: tar.gz
          - target: x86_64-apple-darwin
            os: macos-latest
            archive: tar.gz
          - target: aarch64-apple-darwin
            os: macos-latest
            archive: tar.gz
          - target: x86_64-pc-windows-msvc
            os: windows-latest
            archive: zip
    steps:
      - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4

      - uses: dtolnay/rust-toolchain@29eef336d9b2848a0b548edc03f92a220660cdb8 # stable
        with:
          targets: ${{ matrix.target }}

      - name: Build release binary
        run: cargo build --release --target ${{ matrix.target }}

      - name: Package (unix)
        if: matrix.archive == 'tar.gz'
        run: |
          cd target/${{ matrix.target }}/release
          tar czf ../../../parsec-${{ needs.release.outputs.version }}-${{ matrix.target }}.tar.gz parsec
          cd ../../..

      - name: Package (windows)
        if: matrix.archive == 'zip'
        shell: pwsh
        run: |
          Compress-Archive -Path "target/${{ matrix.target }}/release/parsec.exe" -DestinationPath "parsec-${{ needs.release.outputs.version }}-${{ matrix.target }}.zip"

      - name: Upload to GitHub Release
        shell: bash
        env:
          GH_TOKEN: ${{ github.token }}
        run: |
          gh release upload "${{ needs.release.outputs.tag }}" \
            parsec-${{ needs.release.outputs.version }}-${{ matrix.target }}.${{ matrix.archive }} \
            --clobber

  snapshot-docs:
    name: Snapshot Versioned Docs
    needs: release
    if: needs.release.outputs.created == 'true'
    runs-on: ubuntu-latest
    permissions:
      contents: write
      pull-requests: write
    steps:
      - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4
        with:
          ref: main

      - name: Create versioned docs snapshot
        env:
          VERSION: ${{ needs.release.outputs.version }}
        run: |
          mkdir -p "docs/v/${VERSION}/guide" "docs/v/${VERSION}/reference"

          for file in index.html guide/index.html reference/index.html; do
            sed \
              -e 's/data-doc-version="latest"/data-doc-version="'"${VERSION}"'"/' \
              -e 's|<meta charset="UTF-8">|<meta charset="UTF-8">\n  <meta name="robots" content="noindex, follow">|' \
              -e 's|href="/git-parsec/"|href="/git-parsec/v/'"${VERSION}"'/"|g' \
              -e 's|href="/git-parsec/#|href="/git-parsec/v/'"${VERSION}"'/#|g' \
              -e 's|href="/git-parsec/reference/|href="/git-parsec/v/'"${VERSION}"'/reference/|g' \
              -e 's|href="/git-parsec/guide/|href="/git-parsec/v/'"${VERSION}"'/guide/|g' \
              -e 's|src="demo.gif"|src="/git-parsec/demo.gif"|' \
              "docs/${file}" > "docs/v/${VERSION}/${file}"
          done

      - name: Update versions.json
        env:
          VERSION: ${{ needs.release.outputs.version }}
        run: |
          DATE=$(date -u +%Y-%m-%d)
          jq --arg ver "$VERSION" --arg date "$DATE" \
            '.latest = $ver | .versions = [{"version": $ver, "date": $date, "path": ("/git-parsec/v/" + $ver + "/")}] + .versions' \
            docs/versions.json > docs/versions.json.tmp
          mv docs/versions.json.tmp docs/versions.json

      - name: Update sitemap.xml
        env:
          VERSION: ${{ needs.release.outputs.version }}
        run: |
          DATE=$(date -u +%Y-%m-%d)
          sed -i '/<\/urlset>/i \
            <url>\n    <loc>https://erishforg.github.io/git-parsec/v/'"${VERSION}"'/</loc>\n    <lastmod>'"${DATE}"'</lastmod>\n    <changefreq>never</changefreq>\n    <priority>0.3</priority>\n  </url>\n  <url>\n    <loc>https://erishforg.github.io/git-parsec/v/'"${VERSION}"'/guide/</loc>\n    <lastmod>'"${DATE}"'</lastmod>\n    <changefreq>never</changefreq>\n    <priority>0.3</priority>\n  </url>\n  <url>\n    <loc>https://erishforg.github.io/git-parsec/v/'"${VERSION}"'/reference/</loc>\n    <lastmod>'"${DATE}"'</lastmod>\n    <changefreq>never</changefreq>\n    <priority>0.3</priority>\n  </url>' docs/sitemap.xml

      - name: Open snapshot PR (main is protected — push direct is blocked)
        uses: peter-evans/create-pull-request@271a8d0340265f705b14b6d32b9829c1cb33d45e # v7.0.8
        with:
          base: main
          branch: docs/snapshot-v${{ needs.release.outputs.version }}
          commit-message: "docs: snapshot versioned docs for v${{ needs.release.outputs.version }}"
          title: "docs: snapshot versioned docs for v${{ needs.release.outputs.version }}"
          body: |
            Automated docs snapshot for **v${{ needs.release.outputs.version }}** (release run #${{ github.run_id }}).

            Produced by `.github/workflows/release.yml` → `snapshot-docs` job.

            ## Files
            - `docs/v/${{ needs.release.outputs.version }}/{index,guide/index,reference/index}.html` — versioned docs (with `noindex` meta)
            - `docs/versions.json` — `latest` bump + history entry
            - `docs/sitemap.xml` — versioned URLs added

            Safe to merge. No code change, only doc data.
          labels: |
            release
            auto-snapshot
          author: "github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>"
          committer: "github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>"
          delete-branch: true