fix: Add debugging to build script and update README

BUILD SCRIPT IMPROVEMENTS:
- Added debug output to show current directory and project files
- Added check for actual AudioKeeper.app in build output
- Added fallback to find any .app files if AudioKeeper.app not found
- Better error handling for missing build output

README UPDATES:
- Added Known Issues section explaining Homebrew problem
- Updated Homebrew section to warn users about broken installation
- Recommended manual installation until issue is resolved

This should help identify why GitHub Actions is creating test app instead of real app.

Author: rekruizer

README.md

@@ -28,11 +28,14 @@ A professional macOS menu bar application that automatically maintains your pref
 
 [![Download Latest](https://img.shields.io/badge/Download-Latest%20Release-blue?style=for-the-badge&logo=github)](https://github.com/rekruizer/AudioKeeper/releases/latest)
 
-### Homebrew Cask (Coming Soon)
+### Homebrew Cask (⚠️ Currently Broken)
 
 ```bash
-# Install via Homebrew (when available)
-brew install --cask audiokeeper
+# ⚠️ WARNING: Homebrew installation is currently broken
+# The DMG contains a test app instead of the real application
+# Please use manual installation below until this is fixed
+
+# brew install --cask audiokeeper  # DON'T USE YET
 ```
 
 #### ⚠️ Installation without Developer Certificate
@@ -92,6 +95,17 @@ AudioKeeper/
 └── LICENSE               # MIT License
 ```
 
+## ⚠️ Known Issues
+
+### Homebrew Cask Installation
+- **Problem**: DMG files contain test application instead of real app
+- **Status**: GitHub Actions build is failing to create proper app
+- **Workaround**: Use manual installation from GitHub Releases
+- **Fix**: Working on resolving Xcode build issues in CI/CD
+
+### Manual Installation Recommended
+Until the Homebrew issue is resolved, please use the manual installation method above.
+
 ## 🛠️ Development
 
 ### Requirements

Scripts/build_release.sh

@@ -16,6 +16,11 @@ rm -rf AudioKeeper.app
 rm -rf *.dmg
 
 # Build release version with explicit destination
+echo "📁 Current directory: $(pwd)"
+echo "📁 Project files:"
+ls -la AudioKeeper.xcodeproj/
+
+echo "🔨 Building with xcodebuild..."
 xcodebuild -project AudioKeeper.xcodeproj \
            -scheme AudioKeeper \
            -configuration Release \
@@ -34,8 +39,20 @@ xcodebuild -project AudioKeeper.xcodeproj \
 if [ $? -eq 0 ]; then
     echo "✅ Build successful!"
 
+    # Check what was built
+    echo "📁 Build output:"
+    ls -la build/Build/Products/Release/
+    
     # Copy app to current directory
-    cp -R build/Build/Products/Release/AudioKeeper.app ./
+    if [ -d "build/Build/Products/Release/AudioKeeper.app" ]; then
+        echo "📦 Copying real app..."
+        cp -R build/Build/Products/Release/AudioKeeper.app ./
+    else
+        echo "❌ No AudioKeeper.app found in build output!"
+        echo "📁 Available files:"
+        find build/ -name "*.app" -type d
+        exit 1
+    fi
 
     # Code sign the app (if certificates are available)
     if [ -n "$APPLE_CERTIFICATE" ] && [ -n "$APPLE_CERTIFICATE_PASSWORD" ]; then