qbz/.github/workflows/release-linux.yml

# Linux x86_64 release — Slint binary (crates/ workspace).
#
# Rewritten 2026-07-02 for the Tauri -> Slint migration (v2.0). Pattern:
# build once, package many. The build job produces the binary with the
# proven public-runner recipe from build-slint.yml (16 GB RAM + 18 GB extra
# swap covers the ~30 GB qbz_ui rustc peak, MIN memory tier, mold, pinned
# nightly); the package job turns it into deb/rpm (nfpm), AppImage, and the
# AUR/Gentoo/APT tarball, then creates the GitHub Release.
#
# CONTRACT (do not break): the release must keep publishing
#   qbz_${VERSION}_amd64.tar.gz   (dir qbz_${VERSION}_amd64/{qbz, qbz.desktop, icons/hicolor/...})
#   QBZ_${VERSION}_amd64.deb / QBZ-${VERSION}-1.x86_64.rpm / QBZ_${VERSION}_amd64.AppImage
# — release-aur.yml, release-gentoo.yml, qbz-apt and the website consume
# these names.
#
# Triggers: version tags (cut from main — enforced by the ancestry guard)
# + manual dispatch (guard skipped, for testing on any branch).

name: release-linux

on:
  workflow_dispatch:
    inputs:
      tag:
        description: "Optional release tag to build (e.g. v2.0.0). Empty = build HEAD with the Cargo.toml version, no Release publish."
        required: false
        type: string
  push:
    tags:
      - "v*"

concurrency:
  group: release-linux-${{ github.ref }}
  cancel-in-progress: false

jobs:
  build:
    runs-on: ubuntu-24.04
    timeout-minutes: 300
    outputs:
      version: ${{ steps.release.outputs.version }}
      prerelease: ${{ steps.release.outputs.prerelease }}
    steps:
      - name: Checkout
        uses: actions/checkout@v7
        with:
          fetch-depth: 0

      - name: Resolve release version
        id: release
        run: |
          VERSION=""
          if [[ "${GITHUB_REF}" == refs/tags/v* ]]; then
            VERSION="${GITHUB_REF#refs/tags/v}"
          elif [[ -n "${{ inputs.tag }}" ]]; then
            VERSION="${{ inputs.tag }}"
            VERSION="${VERSION#v}"
          else
            # Manual dispatch without a tag: test build at the Cargo.toml version.
            VERSION="$(grep -m1 '^version = ' crates/Cargo.toml | sed 's/version = \"\(.*\)\"/\1/')"
          fi
          PRERELEASE=false
          if [[ "$VERSION" =~ -(rc|beta|alpha|pre) ]]; then
            PRERELEASE=true
          fi
          echo "version=$VERSION" >> "$GITHUB_OUTPUT"
          echo "prerelease=$PRERELEASE" >> "$GITHUB_OUTPUT"
          echo "Building version $VERSION (prerelease=$PRERELEASE)"

      # Release tags must be cut from main. A tag on any other commit fires
      # this workflow too (tags are not branch-scoped in Actions), so verify
      # ancestry instead of trusting convention. Manual dispatch skips this
      # (that is the testing path).
      - name: Verify tag is on main
        if: startsWith(github.ref, 'refs/tags/')
        run: |
          git fetch origin main
          if ! git merge-base --is-ancestor "$GITHUB_SHA" origin/main; then
            echo "::error::Tag ${GITHUB_REF#refs/tags/} points to a commit that is NOT on main. Releases are cut from main only."
            exit 1
          fi

      # Fail fast if the version bump was forgotten: the binary embeds the
      # workspace version (About dialog, diagnostics), so a mismatched tag
      # would ship a binary that reports the wrong version.
      - name: Assert Cargo.toml version matches tag
        if: startsWith(github.ref, 'refs/tags/')
        env:
          VERSION: ${{ steps.release.outputs.version }}
        run: |
          CARGO_VERSION="$(grep -m1 '^version = ' crates/Cargo.toml | sed 's/version = \"\(.*\)\"/\1/')"
          if [[ "$CARGO_VERSION" != "$VERSION" ]]; then
            echo "::error::crates/Cargo.toml workspace version ($CARGO_VERSION) != tag version ($VERSION). Bump it before tagging (see RELEASE_CHECKLIST)."
            exit 1
          fi

      # The qbz_ui rustc needs ~30 GB (RSS+swap). Public runner: 16 GB RAM
      # + ~4 GB stock swap; free disk by dropping preinstalled toolchains,
      # then add 18 GB swap -> ~38 GB total. Same recipe as build-slint.yml.
      - name: Free disk space and add swap
        run: |
          sudo rm -rf /usr/share/dotnet /opt/ghc /usr/local/lib/android \
            /opt/hostedtoolcache /usr/local/share/boost /usr/share/swift \
            /usr/local/lib/node_modules || true
          sudo docker system prune -af || true
          if sudo fallocate -l 18G /swap_extra; then
            sudo chmod 600 /swap_extra
            sudo mkswap /swap_extra
            sudo swapon /swap_extra
          else
            echo "::warning::could not allocate extra swap; build may OOM"
          fi
          free -h

      - name: Install system dependencies
        run: |
          sudo apt-get update
          sudo apt-get install -y \
            mold nasm \
            libasound2-dev libjack-jackd2-dev \
            libfontconfig1-dev libfreetype-dev \
            libxkbcommon-dev libwayland-dev libxcb1-dev \
            libgl1-mesa-dev libegl1-mesa-dev \
            libdbus-1-dev libssl-dev \
            libharfbuzz-dev libjbig2dec0-dev libopenjp2-7-dev \
            libjpeg-dev zlib1g-dev libgumbo-dev

      # Pinned nightly: matches build-slint.yml (same measured memory
      # behavior, -Z threads support). Bump both files together.
      - name: Setup Rust
        uses: dtolnay/rust-toolchain@master
        with:
          toolchain: nightly-2026-06-23

      - name: Rust cache
        uses: Swatinem/rust-cache@v2
        with:
          workspaces: crates -> target
          shared-key: slint-linux
          cache-on-failure: true
          # Own the amd64 `slint-linux` cache: save on main so pre-flights warm
          # it and tag/PR runs restore it. build-slint.yml no longer runs, so
          # deferring to it (save-if: false) left the amd64 dep cache EMPTY and
          # every release/snap amd64 build fully cold. Mirrors release-linux-aarch64.
          save-if: ${{ github.ref == 'refs/heads/main' }}

      - name: Build (release, MIN memory tier)
        env:
          CARGO_INCREMENTAL: "0"
          CARGO_BUILD_JOBS: "1"
          CARGO_PROFILE_RELEASE_CODEGEN_UNITS: "256"
          CARGO_PROFILE_RELEASE_OPT_LEVEL: "2"
          # Keep symbols in this build: the unstripped binary is archived for
          # crash symbolication, then stripped for every shipped artifact.
          CARGO_PROFILE_RELEASE_STRIP: "none"
          RUSTFLAGS: "-C link-arg=-fuse-ld=mold -Z threads=1"
        run: |
          cargo build --release --manifest-path crates/Cargo.toml -p qbz
          cp crates/target/release/qbz qbz-unstripped
          strip -o qbz crates/target/release/qbz
          ls -la qbz qbz-unstripped

      - name: Upload binary
        uses: actions/upload-artifact@v7
        with:
          name: qbz-linux-x86_64
          path: qbz
          if-no-files-found: error

      # Symbolication artifact: panic backtraces in shipped binaries are
      # address-only (profile strips symbols); this copy resolves them.
      - name: Upload unstripped binary (symbolication)
        uses: actions/upload-artifact@v7
        with:
          name: qbz-linux-x86_64-unstripped
          path: qbz-unstripped
          retention-days: 90

  # T15: qbzd is minutes-class (no qbz_ui compilation unit), so none of the
  # desktop build's swap/tier ceremony applies. Runs on ubuntu-22.04 (not
  # 24.04 like the desktop `build` job above) so the shipped binary's glibc
  # floor stays <= Pi OS bookworm's 2.36 (D13, the honest-Pi-story gate) —
  # the objdump step below verifies that empirically rather than trusting
  # the runner's advertised glibc version.
  build-qbzd:
    runs-on: ubuntu-22.04
    timeout-minutes: 30
    steps:
      - uses: actions/checkout@v7
      - uses: dtolnay/rust-toolchain@stable
      - name: system deps
        run: sudo apt-get update && sudo apt-get install -y libasound2-dev libjack-jackd2-dev libdbus-1-dev libssl-dev
      - name: slint-free dep-graph gate
        run: |
          set -euo pipefail
          hits=$(cargo tree --manifest-path crates/Cargo.toml -p qbzd -e normal \
                 | grep -E '\b(slint|qbz-ui|qbz-slint-common|qbz-dac-wizard) v' || true)
          [ -z "$hits" ] || { echo "::error::qbzd graph resolves Slint:"; echo "$hits"; exit 1; }
      - name: build
        run: cargo build --release --manifest-path crates/Cargo.toml -p qbzd
      - name: glibc floor gate (objdump — the empirical-verification rule)
        run: |
          set -euo pipefail
          floor=$(objdump -T crates/target/release/qbzd \
                  | grep -oE 'GLIBC_[0-9]+\.[0-9]+' | sort -Vu | tail -1)
          echo "glibc floor: $floor"
          highest=$(printf '%s\n' "$floor" "GLIBC_2.35" | sort -V | tail -1)
          [ "$highest" = "GLIBC_2.35" ] || { echo "::error::floor $floor exceeds 2.35"; exit 1; }
      # NOTE: the T15 brief's literal YAML names this artifact
      # `qbzd-linux-amd64`, but T14 (39eb12fc, already merged into this
      # branch) wired the package job's Download-qbzd step below to expect
      # `qbzd-linux-x86_64` — matching what already landed wins over the
      # brief text (see task-15-report.md for the full note).
      - uses: actions/upload-artifact@v7
        with: { name: qbzd-linux-x86_64, path: crates/target/release/qbzd }

  package:
    needs: [build, build-qbzd]
    runs-on: ubuntu-24.04
    permissions:
      contents: write
    env:
      VERSION: ${{ needs.build.outputs.version }}
    steps:
      - name: Checkout
        uses: actions/checkout@v7

      - name: Download binary
        uses: actions/download-artifact@v8
        with:
          name: qbz-linux-x86_64

      # T14: the slint-free qbzd binary, produced by T15's build-qbzd job
      # (a separate ubuntu-22.04 job, not an extension of `build` above —
      # see that job for the glibc-floor rationale). This ONE artifact is
      # consumed for deb/rpm (nfpm), the main AUR/Gentoo tarball below, AND
      # the standalone qbzd tarball (T15 Step 2b) further down — all three
      # ship the same 2.35-glibc-floor binary.
      - name: Download qbzd binary
        uses: actions/download-artifact@v8
        with:
          name: qbzd-linux-x86_64

      - name: Install nfpm
        run: |
          echo 'deb [trusted=yes] https://repo.goreleaser.com/apt/ /' | \
            sudo tee /etc/apt/sources.list.d/goreleaser.list
          sudo apt-get update
          sudo apt-get install -y nfpm
          nfpm --version

      - name: Build deb + rpm (nfpm)
        env:
          QBZ_VERSION: ${{ env.VERSION }}
          QBZ_ARCH: amd64
          QBZ_BINARY: ./qbz
        run: |
          chmod +x qbz
          chmod +x qbzd
          mkdir -p dist
          nfpm package -f packaging/nfpm/nfpm.yaml -p deb \
            -t "dist/QBZ_${VERSION}_amd64.deb"
          nfpm package -f packaging/nfpm/nfpm.yaml -p rpm \
            -t "dist/QBZ-${VERSION}-1.x86_64.rpm"
          # Standalone qbzd packages (daemon-only — the independent deb/rpm
          # the owner asked for; rides the same staged ./qbzd).
          nfpm package -f packaging/nfpm/nfpm-qbzd.yaml -p deb \
            -t "dist/qbzd_${VERSION}_amd64.deb"
          nfpm package -f packaging/nfpm/nfpm-qbzd.yaml -p rpm \
            -t "dist/qbzd-${VERSION}-1.x86_64.rpm"

      - name: Build AppImage
        run: |
          # Minimal AppDir: the measured runtime deps (alsa/fontconfig/
          # freetype/png/bz2/expat/zlib) are base-system libraries on every
          # target distro, so nothing is bundled beyond the binary.
          APPDIR="QBZ.AppDir"
          mkdir -p "$APPDIR/usr/bin"
          cp qbz "$APPDIR/usr/bin/qbz"
          cp packaging/linux/qbz.desktop "$APPDIR/qbz.desktop"
          cp packaging/icons/256x256.png "$APPDIR/qbz.png"
          cp packaging/icons/256x256.png "$APPDIR/.DirIcon"
          ln -s usr/bin/qbz "$APPDIR/AppRun"

          curl -fsSL -o appimagetool \
            https://github.com/AppImage/appimagetool/releases/download/continuous/appimagetool-x86_64.AppImage
          chmod +x appimagetool
          ARCH=x86_64 ./appimagetool --appimage-extract-and-run "$APPDIR" \
            "dist/QBZ_${VERSION}_amd64.AppImage"

      # Tauri-updater bridge: v1.2.x AppImage installs poll latest.json and
      # verify artifacts with the Tauri minisign pubkey baked into the old
      # binaries. Signing the Slint AppImage with the SAME private key lets
      # them auto-update straight into v2 (the updater just swaps the
      # AppImage file). release-updater-manifest.yml collects the .sig into
      # latest.json. The Slint app itself has no auto-updater — this exists
      # only to migrate old installs.
      - name: Sign AppImage (Tauri-updater bridge)
        if: startsWith(github.ref, 'refs/tags/')
        env:
          TAURI_SIGNING_PRIVATE_KEY: ${{ secrets.TAURI_SIGNING_PRIVATE_KEY }}
          TAURI_SIGNING_PRIVATE_KEY_PASSWORD: ${{ secrets.TAURI_SIGNING_PRIVATE_KEY_PASSWORD }}
        run: |
          npx --yes @tauri-apps/cli@^2 signer sign \
            --private-key "$TAURI_SIGNING_PRIVATE_KEY" \
            --password "$TAURI_SIGNING_PRIVATE_KEY_PASSWORD" \
            "dist/QBZ_${VERSION}_amd64.AppImage"
          ls -la dist

      - name: Build AUR/Gentoo tarball
        run: |
          # CONTRACT: release-aur.yml, the Gentoo binary ebuild, qbz-apt and
          # the website hard-code this name and internal layout.
          TARBALL_DIR="qbz_${VERSION}_amd64"
          mkdir -p "tarball-staging/${TARBALL_DIR}/icons/hicolor"/{32x32,48x48,64x64,128x128,256x256}/apps
          cp qbz "tarball-staging/${TARBALL_DIR}/qbz"
          chmod +x "tarball-staging/${TARBALL_DIR}/qbz"
          cp packaging/icons/32x32.png   "tarball-staging/${TARBALL_DIR}/icons/hicolor/32x32/apps/qbz.png"
          cp packaging/icons/48x48.png   "tarball-staging/${TARBALL_DIR}/icons/hicolor/48x48/apps/qbz.png"
          cp packaging/icons/64x64.png   "tarball-staging/${TARBALL_DIR}/icons/hicolor/64x64/apps/qbz.png"
          cp packaging/icons/128x128.png "tarball-staging/${TARBALL_DIR}/icons/hicolor/128x128/apps/qbz.png"
          cp packaging/icons/256x256.png "tarball-staging/${TARBALL_DIR}/icons/hicolor/256x256/apps/qbz.png"
          cp packaging/linux/qbz.desktop "tarball-staging/${TARBALL_DIR}/qbz.desktop"
          # Additive (T14): qbzd + its user unit + shell completions. Every
          # entry above is untouched — the layout contract (header lines
          # 10-14) forbids renaming/moving existing entries. AUR/Gentoo/flake
          # install-line updates to pick these up are P1 (T22, per D13); the
          # files are inert there until then.
          cp qbzd "tarball-staging/${TARBALL_DIR}/qbzd"
          chmod +x "tarball-staging/${TARBALL_DIR}/qbzd"
          cp crates/qbzd/service/qbzd.service "tarball-staging/${TARBALL_DIR}/qbzd.service"
          mkdir -p "tarball-staging/${TARBALL_DIR}/completions"
          ./qbzd completions bash > "tarball-staging/${TARBALL_DIR}/completions/qbzd.bash"
          ./qbzd completions zsh  > "tarball-staging/${TARBALL_DIR}/completions/qbzd.zsh"
          ./qbzd completions fish > "tarball-staging/${TARBALL_DIR}/completions/qbzd.fish"
          tar -czvf "dist/qbz_${VERSION}_amd64.tar.gz" -C tarball-staging "${TARBALL_DIR}"
          ls -la dist

      # T15 Step 2b (OD3, G0): the standalone qbzd tarball — the independent
      # daemon download the owner asked for, separate from the main qbz
      # tarball above. Never touches snap/Flathub/AppImage/dmg (owner
      # constraint) — this only adds one more file into dist/, which the
      # existing Upload-artifacts and Publish-Release-Assets steps below
      # already pick up unmodified via their dist/* globs.
      - name: qbzd-tarball
        run: |
          QBZD_DIR="qbzd-${VERSION}-linux-amd64"
          mkdir -p "qbzd-tarball-staging/${QBZD_DIR}/completions"
          cp qbzd "qbzd-tarball-staging/${QBZD_DIR}/qbzd"
          chmod +x "qbzd-tarball-staging/${QBZD_DIR}/qbzd"
          cp crates/qbzd/service/qbzd.service "qbzd-tarball-staging/${QBZD_DIR}/qbzd.service"
          ./qbzd completions bash > "qbzd-tarball-staging/${QBZD_DIR}/completions/qbzd.bash"
          ./qbzd completions zsh  > "qbzd-tarball-staging/${QBZD_DIR}/completions/qbzd.zsh"
          ./qbzd completions fish > "qbzd-tarball-staging/${QBZD_DIR}/completions/qbzd.fish"
          cp packaging/linux/qbzd-standalone-README.md "qbzd-tarball-staging/${QBZD_DIR}/README.md"
          tar -czvf "dist/qbzd-${VERSION}-linux-amd64.tar.gz" -C qbzd-tarball-staging "${QBZD_DIR}"
          ls -la dist

      - name: Upload artifacts
        uses: actions/upload-artifact@v7
        with:
          name: qbz-linux-packages
          path: dist/*

      - name: Publish GitHub Release Assets
        if: startsWith(github.ref, 'refs/tags/')
        uses: softprops/action-gh-release@v3
        with:
          files: dist/*
          prerelease: ${{ needs.build.outputs.prerelease }}
          make_latest: ${{ needs.build.outputs.prerelease == 'true' && 'false' || 'true' }}

      - name: Trigger APT repo update
        if: startsWith(github.ref, 'refs/tags/')
        uses: peter-evans/repository-dispatch@v4
        with:
          token: ${{ secrets.APT_REPO_TOKEN }}
          repository: vicrodh/qbz-apt
          event-type: new-release
          client-payload: '{"tag": "${{ github.ref_name }}"}'

      # Our own RPM repo (qbz-rpm — mirrors qbz-apt's flow with createrepo).
      # continue-on-error until the token scope covers the new repo (the PAT
      # was minted for qbz-apt only).
      - name: Trigger RPM repo update
        if: startsWith(github.ref, 'refs/tags/')
        continue-on-error: true
        uses: peter-evans/repository-dispatch@v4
        with:
          token: ${{ secrets.APT_REPO_TOKEN }}
          repository: vicrodh/qbz-rpm
          event-type: new-release
          client-payload: '{"tag": "${{ github.ref_name }}"}'