From 8f62c9007efcd012083e51c65f7738c715b448f4 Mon Sep 17 00:00:00 2001
From: Rian Stockbower <rstockbower@gmail.com>
Date: Sun, 9 Aug 2026 13:57:41 -0400
Subject: [PATCH] Add tag-triggered release workflow, ad-hoc signing, and
 Homebrew install docs

- release.yml: on v* tags, builds the Tauri app bundle on macos-latest
  (no dev-token-store feature), verifies the ad-hoc signature, packages
  a .tar.gz + sha256, and publishes a GitHub release with gh.
- tauri.conf.json: bundle.macOS.signingIdentity "-" so every build
  (local and CI) is ad-hoc signed the same way.
- build-install.sh: assert the installed bundle carries an ad-hoc
  signature after building.
- README: Homebrew cask install section with the --no-quarantine /
  not-notarized Gatekeeper caveat.
---
 .github/workflows/release.yml          | 88 ++++++++++++++++++++++++++
 README.md                              | 19 ++++++
 apps/desktop/src-tauri/tauri.conf.json |  3 +
 scripts/build-install.sh               |  6 ++
 4 files changed, 116 insertions(+)
 create mode 100644 .github/workflows/release.yml

diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
new file mode 100644
index 0000000..6ecc653
--- /dev/null
+++ b/.github/workflows/release.yml
@@ -0,0 +1,88 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*"
+
+permissions:
+  contents: write
+
+jobs:
+  release:
+    runs-on: macos-latest
+    defaults:
+      run:
+        working-directory: apps/desktop
+    steps:
+      - uses: actions/checkout@v5
+
+      - uses: dtolnay/rust-toolchain@stable
+
+      - uses: Swatinem/rust-cache@v2
+
+      - uses: actions/setup-node@v5
+        with:
+          node-version: 22
+          cache: npm
+          cache-dependency-path: apps/desktop/package-lock.json
+
+      - name: Check tag matches app version
+        run: |
+          version="$(node -p "require('./src-tauri/tauri.conf.json').version")"
+          tag="${GITHUB_REF_NAME#v}"
+          if [ "$tag" != "$version" ]; then
+            echo "Tag v$tag does not match tauri.conf.json version $version" >&2
+            exit 1
+          fi
+
+      - run: npm ci
+
+      # No --features dev-token-store here: release builds use the encrypted
+      # token store. Ad-hoc signing comes from bundle.macOS.signingIdentity
+      # ("-") in tauri.conf.json, so local and CI builds are signed identically.
+      - name: Build app bundle
+        run: npx tauri build --bundles app
+
+      - name: Verify code signature
+        run: |
+          codesign --verify --deep --strict --verbose=2 ../../target/release/bundle/macos/Retune.app
+          codesign -dv --verbose=2 ../../target/release/bundle/macos/Retune.app
+
+      - name: Package
+        id: package
+        run: |
+          version="${GITHUB_REF_NAME#v}"
+          artifact="Retune-${version}-aarch64.tar.gz"
+          tar -czf "$artifact" -C ../../target/release/bundle/macos Retune.app
+          shasum -a 256 "$artifact" > "$artifact.sha256"
+          cat "$artifact.sha256"
+          echo "artifact=$artifact" >> "$GITHUB_OUTPUT"
+
+      - name: Create GitHub release
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          artifact="${{ steps.package.outputs.artifact }}"
+          sha="$(cut -d' ' -f1 "$artifact.sha256")"
+          cat > release-notes.md <<EOF
+          macOS (Apple Silicon) app bundle, ad-hoc signed (not notarized).
+
+          SHA-256 of \`$artifact\`:
+
+          \`\`\`
+          $sha
+          \`\`\`
+
+          Because the app is not notarized, install via Homebrew
+          (\`brew install --cask --no-quarantine open-cli-collective/tap/retune\`)
+          or clear the quarantine attribute manually:
+
+          \`\`\`
+          xattr -cr /Applications/Retune.app
+          \`\`\`
+          EOF
+          gh release create "$GITHUB_REF_NAME" \
+            "$artifact" "$artifact.sha256" \
+            --title "Retune $GITHUB_REF_NAME" \
+            --notes-file release-notes.md
diff --git a/README.md b/README.md
index 4e2726b..26d12db 100644
--- a/README.md
+++ b/README.md
@@ -23,6 +23,25 @@ Retune is for people who want to maintain a music library, not just stream one.
 * Rate albums and tracks, track plays, search, and manage owned playlists.
 * Back up, restore, or merge the library as JSON or gzip.
 
+## Install with Homebrew
+
+Retune ships as a prebuilt Apple Silicon app via the
+[open-cli-collective tap](https://github.com/open-cli-collective/homebrew-tap):
+
+```sh
+brew install --cask --no-quarantine open-cli-collective/tap/retune
+```
+
+Release builds are ad-hoc signed but **not notarized** (there is no Apple
+Developer ID behind them). Without `--no-quarantine`, Gatekeeper will refuse
+to open the app with a "Retune is damaged" dialog. The cask also clears the
+quarantine attribute after install; if you downloaded the app some other way,
+clear it yourself:
+
+```sh
+xattr -cr /Applications/Retune.app
+```
+
 ## Run from source
 
 Retune currently targets macOS. Building it requires:
diff --git a/apps/desktop/src-tauri/tauri.conf.json b/apps/desktop/src-tauri/tauri.conf.json
index 1585095..f8d30ce 100644
--- a/apps/desktop/src-tauri/tauri.conf.json
+++ b/apps/desktop/src-tauri/tauri.conf.json
@@ -26,6 +26,9 @@
   "bundle": {
     "active": true,
     "targets": "all",
+    "macOS": {
+      "signingIdentity": "-"
+    },
     "icon": [
       "icons/32x32.png",
       "icons/128x128.png",
diff --git a/scripts/build-install.sh b/scripts/build-install.sh
index 3b7114c..58ddfbb 100755
--- a/scripts/build-install.sh
+++ b/scripts/build-install.sh
@@ -13,6 +13,12 @@ cd "$repo/apps/desktop"
 # and we install straight into /Applications anyway).
 npx tauri build --bundles app --features dev-token-store
 
+# Tauri ad-hoc signs the bundle (bundle.macOS.signingIdentity is "-" in
+# tauri.conf.json — same as release builds). Fail loudly if it didn't.
+codesign --verify --deep --strict "$bundle"
+codesign -dv "$bundle" 2>&1 | grep -q "Signature=adhoc" \
+  || { echo "Expected an ad-hoc signature on $bundle" >&2; exit 1; }
+
 # Quit a running copy before overwriting it, then install fresh.
 osascript -e 'quit app "Retune"' >/dev/null 2>&1 || true
 rm -rf "$app"