Improve AppStore build and release process

Enhance validation and archiving workflow for Mac App Store submissions:

- Update Justfile to validate against correct build directory
- Improve error messages for missing versions or builds
- Clarify README feature descriptions
- Update release documentation with precise build commands
- Separate build directories more explicitly for DMG and pkg

Author: bartTC

Justfile

@@ -113,11 +113,13 @@ upload-appstore version="":
 validate-appstore version="":
     #!/usr/bin/env bash
     set -e
-    ver="${1:-}"
+    ver="{{version}}"
     [[ -z "$ver" && -f "{{build_dir}}/.current_version_appstore" ]] && ver=$(cat "{{build_dir}}/.current_version_appstore")
-    [[ -z "$ver" ]] && { echo "No version specified"; exit 1; }
-    pkg=$(find "{{build_dir}}/$ver/export" -name "*.pkg" -type f 2>/dev/null | head -1)
-    [[ -z "$pkg" ]] && { echo "No .pkg found for $ver"; exit 1; }
+    [[ -z "$ver" ]] && { echo "Error: No version specified"; exit 1; }
+    ver_dir="{{build_dir}}/${ver}-appstore"
+    [[ ! -d "$ver_dir" ]] && { echo "Error: App Store build not found at $ver_dir"; echo "Run 'just archive-appstore $ver' first."; exit 1; }
+    pkg=$(find "$ver_dir/export" -name "*.pkg" -type f 2>/dev/null | head -1)
+    [[ -z "$pkg" ]] && { echo "Error: No .pkg found in $ver_dir/export"; exit 1; }
     echo "Validating: $pkg"
     xcrun altool --validate-app -f "$pkg" --type macos --apple-id "$APPLE_ID" --password "$APPLE_APP_PASSWORD"
 

README.md

@@ -16,7 +16,7 @@ After downloading, unzip and move the app to your Applications folder. On first
 
 ## Features
 
-- **Toolbar Badge** — Color-coded cache status (HIT/MISS) visible at a glance
+- **Toolbar Badge** — Cache status (HIT/MISS) visible at a glance
 - **Detailed Popup** — View all cache-related HTTP headers
 - **Edge Location Mapping** — Translates CDN POP codes (e.g., `FRA56`) to city names (e.g., `Frankfurt, DE`)
 - **Multi-CDN Support** — Works with Cloudflare, CloudFront, Fastly, Akamai, Bunny CDN, Varnish, and more
@@ -146,7 +146,7 @@ Justfile                                # Build commands
 2. **Header Capture** — `webRequest.onHeadersReceived` captures response headers for the main document only
 3. **CDN Detection** — Headers are analyzed to identify the CDN provider
 4. **Status Parsing** — Cache status is extracted from CDN-specific headers
-5. **Badge Update** — Toolbar badge is updated with color-coded status
+5. **Badge Update** — Toolbar badge is updated with status text
 6. **Popup Display** — Clicking the icon shows detailed header information
 
 ## License

RELEASE.md

@@ -148,14 +148,15 @@ You can build both versions for the same release:
 ```bash
 # Direct distribution (for GitHub)
 just release v0.0.6
+just dmg v0.0.6
 
 # App Store (for Mac App Store)
 just release-appstore v0.0.6
 ```
 
 They don't conflict — outputs go to separate directories:
-- `build/v0.0.6/` — Developer ID build
-- `build/v0.0.6-appstore/` — App Store build
+- `build/v0.0.6/` — Developer ID build (`.zip` and `.dmg`)
+- `build/v0.0.6-appstore/` — App Store build (`.pkg`)
 
 ---