feat: auto-generate and install shell completions via Homebrew

- Add completions.sh script to generate shell completions during build
- Include completion files in release archives
- Configure homebrew_casks to install completions automatically
- Completions installed to standard Homebrew locations
- Users get completions automatically, no manual setup needed

Author: jackspirou

.gitignore

@@ -191,3 +191,4 @@ extract_data.js
 # Temporary test files
 test_output/
 tmp/
+completions/

.goreleaser.yaml

@@ -4,6 +4,7 @@ before:
   hooks:
     - go mod tidy
     - go test ./...
+    - ./scripts/completions.sh
 
 builds:
   - id: tokenizer
@@ -65,6 +66,7 @@ archives:
     files:
       - LICENSE
       - README.md
+      - completions/*
 
 checksum:
   name_template: 'checksums.txt'
@@ -200,20 +202,11 @@ homebrew_casks:
             system_command "/usr/bin/xattr", args: ["-dr", "com.apple.quarantine", "#{staged_path}/tokenizer"], sudo: false
           end
     
-    # Shell completions
+    # Shell completions (files included in the archive)
     completions:
-      bash: 
-        completion: |
-          output = Utils.safe_popen_read("#{staged_path}/tokenizer", "completion", "bash")
-          (bash_completion/"tokenizer").write output
-      zsh:
-        completion: |
-          output = Utils.safe_popen_read("#{staged_path}/tokenizer", "completion", "zsh")
-          (zsh_completion/"_tokenizer").write output
-      fish:
-        completion: |
-          output = Utils.safe_popen_read("#{staged_path}/tokenizer", "completion", "fish")
-          (fish_completion/"tokenizer.fish").write output
+      bash: completions/tokenizer.bash
+      zsh: completions/tokenizer.zsh
+      fish: completions/tokenizer.fish
 
     # Custom caveats
     caveats: |

scripts/completions.sh

@@ -0,0 +1,28 @@
+#!/bin/bash
+set -e
+
+echo "Generating shell completions..."
+
+# Build the binary first if it doesn't exist
+if [ ! -f ./tokenizer ]; then
+    echo "Building tokenizer binary..."
+    go build -o tokenizer ./cmd/tokenizer
+fi
+
+# Create completions directory
+mkdir -p completions
+
+# Generate completions for each shell
+echo "Generating bash completion..."
+./tokenizer completion bash > completions/tokenizer.bash
+
+echo "Generating zsh completion..."
+./tokenizer completion zsh > completions/tokenizer.zsh
+
+echo "Generating fish completion..."
+./tokenizer completion fish > completions/tokenizer.fish
+
+echo "Completions generated successfully!"
+
+# Clean up temporary binary
+rm -f ./tokenizer