feat: Implement Homebrew cask migration with dual distribution

- Update GoReleaser config with both formula (deprecated) and cask
- Add conflicts_with directive to prevent formula/cask conflicts
- Create comprehensive Homebrew build validation script
- Add GitHub Actions workflow for automated testing
- Move acceptance tests to test-scripts/ directory
The migration provides a transition period where both formula and cask
work, with clear deprecation warnings guiding users to migrate from
formula to cask distribution.

Following GoReleaser best practices for distributing pre-built binaries.

Author: leggetter

.github/workflows/acceptance-test.yml .github/workflows/test-acceptance.yml.github/workflows/acceptance-test.yml renamed to .github/workflows/test-acceptance.yml

@@ -17,10 +17,10 @@ jobs:
       - name: Set up Go
         uses: actions/setup-go@v3
         with:
-          go-version: '1.18'
+          go-version: "1.18"
 
       - name: Make script executable
-        run: chmod +x scripts/acceptance-test.sh
+        run: chmod +x test-scripts/test-acceptance.sh
 
       - name: Run acceptance tests
-        run: ./scripts/acceptance-test.sh
+        run: ./test-scripts/test-acceptance.sh

.github/workflows/test-homebrew-build.yml

@@ -0,0 +1,63 @@
+name: Homebrew Build Validation
+
+on:
+  pull_request:
+    branches:
+      - main
+    paths:
+      - ".goreleaser/**"
+      - "scripts/completions.sh"
+      - "test-scripts/test-homebrew-build.sh"
+      - ".github/workflows/test-homebrew-build.yml"
+
+  workflow_dispatch:
+    inputs:
+      run_install_tests:
+        description: "Run installation tests"
+        required: false
+        default: "false"
+        type: choice
+        options:
+          - "false"
+          - "true"
+
+jobs:
+  test-homebrew-build:
+    runs-on: macos-latest
+
+    steps:
+      - name: Check out code
+        uses: actions/checkout@v4
+
+      - name: Set up Go
+        uses: actions/setup-go@v5
+        with:
+          go-version-file: "go.mod"
+
+      - name: Verify Homebrew is installed
+        run: |
+          echo "Homebrew version:"
+          brew --version
+
+      - name: Install GoReleaser
+        run: brew install goreleaser
+
+      - name: Make test script executable
+        run: chmod +x test-scripts/test-homebrew-build.sh
+
+      - name: Run build validation
+        run: ./test-scripts/test-homebrew-build.sh
+
+      - name: Run installation tests
+        if: github.event.inputs.run_install_tests == 'true'
+        run: ./test-scripts/test-homebrew-build.sh --install
+
+      - name: Upload generated Homebrew files
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: homebrew-files
+          path: |
+            dist/homebrew/Formula/hookdeck.rb
+            dist/homebrew/Casks/hookdeck.rb
+          retention-days: 7

.goreleaser/mac.yml

@@ -87,6 +87,11 @@ homebrew_casks:
       bash: "completions/hookdeck.bash"
       zsh: "completions/_hookdeck"
 
+    # Prevent installation alongside the deprecated formula
+    # Note: The deprecated 'conflicts' field no longer works, so we use custom_block
+    custom_block: |
+      conflicts_with formula: "hookdeck"
+    
     caveats: |
       Thanks for installing the Hookdeck CLI!