release.yml

# Builds Dashy and drafts a GitHub release with the compiled tarball,
# along with SHA256 checksum and SLSA build-provenance attestation
#
# Triggered by:
# - Push of any major/minor (X.Y.0) git tag
# - Manual dispatch with any existing tag (any version)

name: 🚀 Release

on:
  push:
    tags: ['*.*.0']
  workflow_dispatch:
    inputs:
      tag:
        description: 'Existing git tag to release (e.g. 4.2.0)'
        required: true

concurrency:
  group: ${{ github.workflow }}-${{ inputs.tag || github.ref_name }}
  cancel-in-progress: false

permissions:
  contents: read

jobs:
  release:
    name: 🚀 Build & Draft Release
    runs-on: ubuntu-latest
    timeout-minutes: 20
    permissions:
      contents: write
      id-token: write
      attestations: write
    env:
      TAG: ${{ inputs.tag || github.ref_name }}
    steps:
      - name: 🛎️ Checkout tag
        uses: actions/checkout@v6
        with:
          ref: refs/tags/${{ env.TAG }}
          fetch-depth: 0

      - name: 🔧 Setup Node.js
        uses: actions/setup-node@v6 # zizmor: ignore[cache-poisoning]
        with:
          node-version: '20'

      - name: 📥 Install dependencies
        run: yarn install --frozen-lockfile --ignore-engines --network-timeout 300000

      - name: 🏗️ Build app
        run: NODE_OPTIONS=--openssl-legacy-provider yarn build --mode production

      - name: 📦 Package release tarball
        id: package
        run: |
          set -euo pipefail
          STAGING="dashy-release-staging"
          mkdir -p "$STAGING"
          cp -r dist         "$STAGING/"
          cp -r services     "$STAGING/"
          cp -r public       "$STAGING/"
          cp -r user-data    "$STAGING/"
          cp    server.js    "$STAGING/"
          cp    yarn.lock    "$STAGING/"
          mkdir -p "$STAGING/src/utils/config"
          cp src/utils/config/ConfigSchema.json "$STAGING/src/utils/config/"
          node -e "
            const fs = require('fs');
            const pkg = JSON.parse(fs.readFileSync('package.json', 'utf8'));
            delete pkg.devDependencies;
            fs.writeFileSync('$STAGING/package.json', JSON.stringify(pkg, null, 2));
          "
          TARBALL="dashy-${TAG}.tar.gz"
          tar -czf "$TARBALL" -C "$STAGING" .
          echo "tarball=$TARBALL" >> "$GITHUB_OUTPUT"
          echo "size=$(du -h "$TARBALL" | cut -f1)" >> "$GITHUB_OUTPUT"

      - name: 🔢 Generate SHA256 checksum
        id: checksum
        env:
          TARBALL: ${{ steps.package.outputs.tarball }}
        run: |
          set -euo pipefail
          CHECKSUM="${TARBALL}.sha256"
          sha256sum "$TARBALL" > "$CHECKSUM"
          echo "file=$CHECKSUM" >> "$GITHUB_OUTPUT"
          echo "sha256=$(cut -d' ' -f1 "$CHECKSUM")" >> "$GITHUB_OUTPUT"

      - name: 🪪 Generate build provenance attestation
        id: attest
        uses: actions/attest-build-provenance@v4
        with:
          subject-path: ${{ steps.package.outputs.tarball }}
          show-summary: false

      - name: 📤 Rename attestation bundle
        id: attest_asset
        env:
          TARBALL: ${{ steps.package.outputs.tarball }}
          BUNDLE: ${{ steps.attest.outputs.bundle-path }}
        run: |
          set -euo pipefail
          OUT="${TARBALL}.intoto.jsonl"
          cp "$BUNDLE" "$OUT"
          echo "file=$OUT" >> "$GITHUB_OUTPUT"

      - name: 🔎 Find previous release tag
        id: prev
        env:
          CURRENT_TAG: ${{ env.TAG }}
        run: |
          set -euo pipefail
          git fetch --tags --force
          PREV=$({ echo "$CURRENT_TAG"; git tag | grep -E '^[0-9]+\.[0-9]+\.0$' || true; } \
            | sort -uV \
            | awk -v cur="$CURRENT_TAG" '$0 == cur { print prev; exit } { prev = $0 }')
          echo "tag=$PREV" >> "$GITHUB_OUTPUT"

      - name: 📝 Create draft release
        id: release
        # Kept over `gh release create` for built-in generate_release_notes,
        # previous_tag selection, fail_on_unmatched_files, and multi-file upload.
        uses: softprops/action-gh-release@v3 # zizmor: ignore[superfluous-actions]
        with:
          tag_name: ${{ env.TAG }}
          name: Release ${{ env.TAG }}
          draft: true
          prerelease: false
          generate_release_notes: true
          previous_tag: ${{ steps.prev.outputs.tag }}
          fail_on_unmatched_files: true
          files: |
            ${{ steps.package.outputs.tarball }}
            ${{ steps.checksum.outputs.file }}
            ${{ steps.attest_asset.outputs.file }}
          token: ${{ secrets.BOT_GITHUB_TOKEN || secrets.GITHUB_TOKEN }}

      - name: 📋 Job summary
        if: always()
        env:
          REPO_URL: ${{ github.server_url }}/${{ github.repository }}
          PREV_TAG: ${{ steps.prev.outputs.tag }}
          RELEASE_URL: ${{ steps.release.outputs.url }}
          TARBALL: ${{ steps.package.outputs.tarball }}
          SIZE: ${{ steps.package.outputs.size }}
          SHA256: ${{ steps.checksum.outputs.sha256 }}
          ATTEST_URL: ${{ steps.attest.outputs.attestation-url }}
        run: |
          set -euo pipefail
          {
            echo "## 🚀 Dashy Release ${TAG}"
            echo ""
            echo "| Item | Value |"
            echo "|------|-------|"
            echo "| New Tag | [\`${TAG}\`](${REPO_URL}/releases/tag/${TAG}) |"
            if [ -n "$PREV_TAG" ]; then
              echo "| Previous Tag | [\`${PREV_TAG}\`](${REPO_URL}/releases/tag/${PREV_TAG}) |"
            fi
            if [ -n "$TARBALL" ]; then
              echo "| Tarball | \`${TARBALL}\` (${SIZE:-?}) |"
            fi
            if [ -n "$SHA256" ]; then
              echo "| SHA256 | \`${SHA256}\` |"
            fi
            if [ -n "$ATTEST_URL" ]; then
              echo "| Attestation | ✅ [View](${ATTEST_URL}) |"
            else
              echo "| Attestation | ❌ Failed |"
            fi
            if [ -n "$RELEASE_URL" ]; then
              echo "| Draft release | ✅ [Review and publish](${RELEASE_URL}) |"
            else
              echo "| Draft release | ❌ Failed |"
            fi
          } >> "$GITHUB_STEP_SUMMARY"