opencode-skills-antigravity 1.0.13 → 1.0.15

package/bundled-skills/github/SKILL.md

@@ -0,0 +1,76 @@
+---
+name: github
+description: "Use the `gh` CLI for issues, pull requests, Actions runs, and GitHub API queries."
+risk: safe
+source: "Dimillian/Skills (MIT)"
+date_added: "2026-03-25"
+---
+
+# GitHub Skill
+
+Use the `gh` CLI to interact with GitHub. Always specify `--repo owner/repo` when not in a git directory, or use URLs directly.
+
+## When to Use
+
+- When the user asks about GitHub issues, pull requests, workflow runs, or CI failures.
+- When you need `gh issue`, `gh pr`, `gh run`, or `gh api` from the command line.
+
+## Pull Requests
+
+Check CI status on a PR:
+```bash
+gh pr checks 55 --repo owner/repo
+```
+
+List recent workflow runs:
+```bash
+gh run list --repo owner/repo --limit 10
+```
+
+View a run and see which steps failed:
+```bash
+gh run view <run-id> --repo owner/repo
+```
+
+View logs for failed steps only:
+```bash
+gh run view <run-id> --repo owner/repo --log-failed
+```
+
+### Debugging a CI Failure
+
+Follow this sequence to investigate a failing CI run:
+
+1. **Check PR status** — identify which checks are failing:
+   ```bash
+   gh pr checks 55 --repo owner/repo
+   ```
+2. **List recent runs** — find the relevant run ID:
+   ```bash
+   gh run list --repo owner/repo --limit 10
+   ```
+3. **View the failed run** — see which jobs and steps failed:
+   ```bash
+   gh run view <run-id> --repo owner/repo
+   ```
+4. **Fetch failure logs** — get the detailed output for failed steps:
+   ```bash
+   gh run view <run-id> --repo owner/repo --log-failed
+   ```
+
+## API for Advanced Queries
+
+The `gh api` command is useful for accessing data not available through other subcommands.
+
+Get PR with specific fields:
+```bash
+gh api repos/owner/repo/pulls/55 --jq '.title, .state, .user.login'
+```
+
+## JSON Output
+
+Most commands support `--json` for structured output.  You can use `--jq` to filter:
+
+```bash
+gh issue list --repo owner/repo --json number,title --jq '.[] | "\(.number): \(.title)"'
+```

package/bundled-skills/github/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "GitHub"
+  short_description: "Use gh for GitHub workflows"
+  default_prompt: "Use $github to inspect this repository's pull requests, issues, runs, or API data."

package/bundled-skills/ios-debugger-agent/SKILL.md

@@ -0,0 +1,59 @@
+---
+name: ios-debugger-agent
+description: Debug the current iOS project on a booted simulator with XcodeBuildMCP.
+risk: safe
+source: "Dimillian/Skills (MIT)"
+date_added: "2026-03-25"
+---
+
+# iOS Debugger Agent
+
+## Overview
+Use XcodeBuildMCP to build and run the current project scheme on a booted iOS simulator, interact with the UI, and capture logs. Prefer the MCP tools for simulator control, logs, and view inspection.
+
+## When to Use
+
+- When the user asks to run, debug, or inspect an iOS app on a simulator.
+- When you need simulator UI interaction, screenshots, or runtime logs via XcodeBuildMCP.
+
+## Core Workflow
+Follow this sequence unless the user asks for a narrower action.
+
+### 1) Discover the booted simulator
+- Call `mcp__XcodeBuildMCP__list_sims` and select the simulator with state `Booted`.
+- If none are booted, ask the user to boot one (do not boot automatically unless asked).
+
+### 2) Set session defaults
+- Call `mcp__XcodeBuildMCP__session-set-defaults` with:
+  - `projectPath` or `workspacePath` (whichever the repo uses)
+  - `scheme` for the current app
+  - `simulatorId` from the booted device
+  - Optional: `configuration: "Debug"`, `useLatestOS: true`
+
+### 3) Build + run (when requested)
+- Call `mcp__XcodeBuildMCP__build_run_sim`.
+- **If the build fails**, check the error output and retry (optionally with `preferXcodebuild: true`) or escalate to the user before attempting any UI interaction.
+- **After a successful build**, verify the app launched by calling `mcp__XcodeBuildMCP__describe_ui` or `mcp__XcodeBuildMCP__screenshot` before proceeding to UI interaction.
+- If the app is already built and only launch is requested, use `mcp__XcodeBuildMCP__launch_app_sim`.
+- If bundle id is unknown:
+  1) `mcp__XcodeBuildMCP__get_sim_app_path`
+  2) `mcp__XcodeBuildMCP__get_app_bundle_id`
+
+## UI Interaction & Debugging
+Use these when asked to inspect or interact with the running app.
+
+- **Describe UI**: `mcp__XcodeBuildMCP__describe_ui` before tapping or swiping.
+- **Tap**: `mcp__XcodeBuildMCP__tap` (prefer `id` or `label`; use coordinates only if needed).
+- **Type**: `mcp__XcodeBuildMCP__type_text` after focusing a field.
+- **Gestures**: `mcp__XcodeBuildMCP__gesture` for common scrolls and edge swipes.
+- **Screenshot**: `mcp__XcodeBuildMCP__screenshot` for visual confirmation.
+
+## Logs & Console Output
+- Start logs: `mcp__XcodeBuildMCP__start_sim_log_cap` with the app bundle id.
+- Stop logs: `mcp__XcodeBuildMCP__stop_sim_log_cap` and summarize important lines.
+- For console output, set `captureConsole: true` and relaunch if required.
+
+## Troubleshooting
+- If build fails, ask whether to retry with `preferXcodebuild: true`.
+- If the wrong app launches, confirm the scheme and bundle id.
+- If UI elements are not hittable, re-run `describe_ui` after layout changes.

package/bundled-skills/ios-debugger-agent/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "iOS Debugger Agent"
+  short_description: "Debug iOS apps on Simulator"
+  default_prompt: "Use $ios-debugger-agent to build, launch, and inspect the current iOS app on the booted simulator."

package/bundled-skills/macos-menubar-tuist-app/SKILL.md

@@ -0,0 +1,109 @@
+---
+name: macos-menubar-tuist-app
+description: Build, refactor, or review SwiftUI macOS menubar apps that use Tuist.
+risk: safe
+source: "Dimillian/Skills (MIT)"
+date_added: "2026-03-25"
+---
+
+# macos-menubar-tuist-app
+
+Build and maintain macOS menubar apps with a Tuist-first workflow and stable launch scripts. Preserve strict architecture boundaries so networking, state, and UI remain testable and predictable.
+
+## When to Use
+
+- When working on LSUIElement menubar utilities built with Tuist and SwiftUI.
+- When you need Tuist manifests, launch scripts, or architecture guidance for a menubar app.
+
+## Core Rules
+
+- Keep the app menubar-only unless explicitly told otherwise. Use `LSUIElement = true` by default.
+- Keep transport and decoding logic outside views. Do not call networking from SwiftUI view bodies.
+- Keep state transitions in a store layer (`@Observable` or equivalent), not in row/view presentation code.
+- Keep model decoding resilient to API drift: optional fields, safe fallbacks, and defensive parsing.
+- Treat Tuist manifests as the source of truth. Do not rely on hand-edited generated Xcode artifacts.
+- Prefer script-based launch for local iteration when `tuist run` is unreliable for macOS target/device resolution.
+- Prefer `tuist xcodebuild build` over raw `xcodebuild` in local run scripts when building generated projects.
+
+## Expected File Shape
+
+Use this placement by default:
+
+- `Project.swift`: app target, settings, resources, `Info.plist` keys
+- `Sources/*Model*.swift`: API/domain models and decoding
+- `Sources/*Client*.swift`: requests, response mapping, transport concerns
+- `Sources/*Store*.swift`: observable state, refresh policy, filtering, caching
+- `Sources/*Menu*View*.swift`: menu composition and top-level UI state
+- `Sources/*Row*View*.swift`: row rendering and lightweight interactions
+- `run-menubar.sh`: canonical local restart/build/launch path
+- `stop-menubar.sh`: explicit stop helper when needed
+
+## Workflow
+
+1. Confirm Tuist ownership
+- Verify `Tuist.swift` and `Project.swift` (or workspace manifests) exist.
+- Read existing run scripts before changing launch behavior.
+
+2. Probe backend behavior before coding assumptions
+- Use `curl` to verify endpoint shape, auth requirements, and pagination behavior.
+- If endpoint ignores `limit/page`, implement full-list handling with local trimming in the store.
+
+3. Implement layers from bottom to top
+- Define/adjust models first.
+- Add or update client request/decoding logic.
+- Update store refresh, filtering, and cache policy.
+- Wire views last.
+
+4. Keep app wiring minimal
+- Keep app entry focused on scene/menu wiring and dependency injection.
+- Avoid embedding business logic in `App` or menu scene declarations.
+
+5. Standardize launch ergonomics
+- Ensure run script restarts an existing instance before relaunching.
+- Ensure run script does not open Xcode as a side effect.
+- Use `tuist generate --no-open` when generation is required.
+- When the run script builds the generated project, prefer `TUIST_SKIP_UPDATE_CHECK=1 tuist xcodebuild build ...` instead of invoking raw `xcodebuild` directly.
+
+## Validation Matrix
+
+Run validations after edits:
+
+```bash
+TUIST_SKIP_UPDATE_CHECK=1 tuist xcodebuild build -scheme <TargetName> -configuration Debug
+```
+
+If launch workflow changed:
+
+```bash
+./run-menubar.sh
+```
+
+If shell scripts changed:
+
+```bash
+bash -n run-menubar.sh
+bash -n stop-menubar.sh
+./run-menubar.sh
+```
+
+## Failure Patterns and Fix Direction
+
+- `tuist run` cannot resolve the macOS destination:
+Use run/stop scripts as canonical local run path.
+
+- Menu UI is laggy or inconsistent after refresh:
+Move derived state and filtering into the store; keep views render-only.
+
+- API payload changes break decode:
+Relax model decoding with optional fields and defaults, then surface missing data safely in UI.
+
+- Feature asks for quick UI patch:
+Trace root cause in model/client/store before changing row/menu presentation.
+
+## Completion Checklist
+
+- Preserve menubar-only behavior unless explicitly changed.
+- Keep network and state logic out of SwiftUI view bodies.
+- Keep Tuist manifests and run scripts aligned with actual build/run flow.
+- Run the validation matrix for touched areas.
+- Report concrete commands run and outcomes.

package/bundled-skills/macos-menubar-tuist-app/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "macOS Menubar Tuist App"
+  short_description: "Tuist-first macOS menubar app build and maintenance"
+  default_prompt: "Use $macos-menubar-tuist-app to scaffold or refactor a menubar-only macOS app with Tuist, layered state architecture, and script-based run validation."

package/bundled-skills/macos-spm-app-packaging/SKILL.md

@@ -0,0 +1,105 @@
+---
+name: macos-spm-app-packaging
+description: Scaffold, build, sign, and package SwiftPM macOS apps without Xcode projects.
+risk: safe
+source: "Dimillian/Skills (MIT)"
+date_added: "2026-03-25"
+---
+
+# macOS SwiftPM App Packaging (No Xcode)
+
+## Overview
+Bootstrap a complete SwiftPM macOS app folder, then build, package, and run it without Xcode. Use `assets/templates/bootstrap/` for the starter layout and `references/packaging.md` + `references/release.md` for packaging and release details.
+
+## When to Use
+
+- When the user needs a SwiftPM-based macOS app without relying on an Xcode project.
+- When you need packaging, signing, notarization, or appcast guidance for a SwiftPM app.
+
+## Two-Step Workflow
+1) Bootstrap the project folder
+   - Copy `assets/templates/bootstrap/` into a new repo.
+   - Rename `MyApp` in `Package.swift`, `Sources/MyApp/`, and `version.env`.
+   - Customize `APP_NAME`, `BUNDLE_ID`, and versions.
+
+2) Build, package, and run the bootstrapped app
+   - Copy scripts from `assets/templates/` into your repo (for example, `Scripts/`).
+   - Build/tests: `swift build` and `swift test`.
+   - Package: `Scripts/package_app.sh`.
+   - Run: `Scripts/compile_and_run.sh` (preferred) or `Scripts/launch.sh`.
+   - Release (optional): `Scripts/sign-and-notarize.sh` and `Scripts/make_appcast.sh`.
+   - Tag + GitHub release (optional): create a git tag, upload the zip/appcast to the GitHub release, and publish.
+
+## Minimum End-to-End Example
+Shortest path from bootstrap to a running app:
+```bash
+# 1. Copy and rename the skeleton
+cp -R assets/templates/bootstrap/ ~/Projects/MyApp
+cd ~/Projects/MyApp
+sed -i '' 's/MyApp/HelloApp/g' Package.swift version.env
+
+# 2. Copy scripts
+cp assets/templates/package_app.sh Scripts/
+cp assets/templates/compile_and_run.sh Scripts/
+chmod +x Scripts/*.sh
+
+# 3. Build and launch
+swift build
+Scripts/compile_and_run.sh
+```
+
+## Validation Checkpoints
+Run these after key steps to catch failures early before proceeding to the next stage.
+
+**After packaging (`Scripts/package_app.sh`):**
+```bash
+# Confirm .app bundle structure is intact
+ls -R build/HelloApp.app/Contents
+
+# Check that the binary is present and executable
+file build/HelloApp.app/Contents/MacOS/HelloApp
+```
+
+**After signing (`Scripts/sign-and-notarize.sh` or ad-hoc dev signing):**
+```bash
+# Inspect signature and entitlements
+codesign -dv --verbose=4 build/HelloApp.app
+
+# Verify the bundle passes Gatekeeper checks locally
+spctl --assess --type execute --verbose build/HelloApp.app
+```
+
+**After notarization and stapling:**
+```bash
+# Confirm the staple ticket is attached
+stapler validate build/HelloApp.app
+
+# Re-run Gatekeeper to confirm notarization is recognised
+spctl --assess --type execute --verbose build/HelloApp.app
+```
+
+## Common Notarization Failures
+| Symptom | Likely Cause | Recovery |
+|---|---|---|
+| `The software asset has already been uploaded` | Duplicate submission for same version | Bump `BUILD_NUMBER` in `version.env` and repackage. |
+| `Package Invalid: Invalid Code Signing Entitlements` | Entitlements in `.entitlements` file don't match provisioning | Audit entitlements against Apple's allowed set; remove unsupported keys. |
+| `The executable does not have the hardened runtime enabled` | Missing `--options runtime` flag in `codesign` invocation | Edit `sign-and-notarize.sh` to add `--options runtime` to all `codesign` calls. |
+| Notarization hangs / no status email | `xcrun notarytool` network or credential issue | Run `xcrun notarytool history` to check status; re-export App Store Connect API key if expired. |
+| `stapler validate` fails after successful notarization | Ticket not yet propagated | Wait ~60 s, then re-run `xcrun stapler staple`. |
+
+## Templates
+- `assets/templates/package_app.sh`: Build binaries, create the .app bundle, copy resources, sign.
+- `assets/templates/compile_and_run.sh`: Dev loop to kill running app, package, launch.
+- `assets/templates/build_icon.sh`: Generate .icns from an Icon Composer file (requires Xcode install).
+- `assets/templates/sign-and-notarize.sh`: Notarize, staple, and zip a release build.
+- `assets/templates/make_appcast.sh`: Generate Sparkle appcast entries for updates.
+- `assets/templates/setup_dev_signing.sh`: Create a stable dev code-signing identity.
+- `assets/templates/launch.sh`: Simple launcher for a packaged .app.
+- `assets/templates/version.env`: Example version file consumed by packaging scripts.
+- `assets/templates/bootstrap/`: Minimal SwiftPM macOS app skeleton (Package.swift, Sources/, version.env).
+
+## Notes
+- Keep entitlements and signing configuration explicit; edit the template scripts instead of reimplementing.
+- Remove Sparkle steps if you do not use Sparkle for updates.
+- Sparkle relies on the bundle build number (`CFBundleVersion`), so `BUILD_NUMBER` in `version.env` must increase for each update.
+- For menu bar apps, set `MENU_BAR_APP=1` when packaging to emit `LSUIElement` in Info.plist.

package/bundled-skills/macos-spm-app-packaging/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "macOS SwiftPM Packaging"
+  short_description: "Package SwiftPM macOS apps"
+  default_prompt: "Use $macos-spm-app-packaging to scaffold or package a SwiftPM-based macOS app without Xcode."

package/bundled-skills/macos-spm-app-packaging/assets/templates/bootstrap/Package.swift

@@ -0,0 +1,17 @@
+// swift-tools-version: 6.2
+import PackageDescription
+
+let package = Package(
+    name: "MyApp",
+    platforms: [
+        .macOS(.v14),
+    ],
+    targets: [
+        .executableTarget(
+            name: "MyApp",
+            path: "Sources/MyApp",
+            resources: [
+                .process("Resources"),
+            ])
+    ]
+)

package/bundled-skills/macos-spm-app-packaging/assets/templates/bootstrap/Sources/MyApp/main.swift

@@ -0,0 +1,11 @@
+import SwiftUI
+
+@main
+struct MyApp: App {
+    var body: some Scene {
+        WindowGroup {
+            Text("Hello from MyApp")
+                .padding()
+        }
+    }
+}

package/bundled-skills/macos-spm-app-packaging/assets/templates/bootstrap/version.env

@@ -0,0 +1,2 @@
+MARKETING_VERSION=0.1.0
+BUILD_NUMBER=1

package/bundled-skills/macos-spm-app-packaging/assets/templates/build_icon.sh

@@ -0,0 +1,49 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+ICON_FILE=${1:-Icon.icon}
+BASENAME=${2:-Icon}
+OUT_ROOT=${3:-build/icon}
+XCODE_APP=${XCODE_APP:-/Applications/Xcode.app}
+
+ICTOOL="$XCODE_APP/Contents/Applications/Icon Composer.app/Contents/Executables/ictool"
+if [[ ! -x "$ICTOOL" ]]; then
+  ICTOOL="$XCODE_APP/Contents/Applications/Icon Composer.app/Contents/Executables/icontool"
+fi
+if [[ ! -x "$ICTOOL" ]]; then
+  echo "ictool/icontool not found. Set XCODE_APP if Xcode is elsewhere." >&2
+  exit 1
+fi
+
+ICONSET_DIR="$OUT_ROOT/${BASENAME}.iconset"
+TMP_DIR="$OUT_ROOT/tmp"
+mkdir -p "$ICONSET_DIR" "$TMP_DIR"
+
+MASTER_ART="$TMP_DIR/icon_art_824.png"
+MASTER_1024="$TMP_DIR/icon_1024.png"
+
+# Render inner art (no margin) with macOS Default appearance.
+"$ICTOOL" "$ICON_FILE" \
+  --export-preview macOS Default 824 824 1 -45 "$MASTER_ART"
+
+# Pad to 1024x1024 with transparent border.
+sips --padToHeightWidth 1024 1024 "$MASTER_ART" --out "$MASTER_1024" >/dev/null
+
+# Generate required sizes.
+sizes=(16 32 64 128 256 512 1024)
+for sz in "${sizes[@]}"; do
+  out="$ICONSET_DIR/icon_${sz}x${sz}.png"
+  sips -z "$sz" "$sz" "$MASTER_1024" --out "$out" >/dev/null
+  if [[ "$sz" -ne 1024 ]]; then
+    dbl=$((sz*2))
+    out2="$ICONSET_DIR/icon_${sz}x${sz}@2x.png"
+    sips -z "$dbl" "$dbl" "$MASTER_1024" --out "$out2" >/dev/null
+  fi
+done
+
+# 512x512@2x already covered by 1024; ensure it exists.
+cp "$MASTER_1024" "$ICONSET_DIR/icon_512x512@2x.png"
+
+iconutil -c icns "$ICONSET_DIR" -o Icon.icns
+
+echo "Icon.icns generated at $(pwd)/Icon.icns"

package/bundled-skills/macos-spm-app-packaging/assets/templates/compile_and_run.sh

@@ -0,0 +1,63 @@
+#!/usr/bin/env bash
+# Kill running instances, package, relaunch, verify.
+set -euo pipefail
+
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+APP_NAME=${APP_NAME:-MyApp}
+APP_BUNDLE="${ROOT_DIR}/${APP_NAME}.app"
+APP_PROCESS_PATTERN="${APP_NAME}.app/Contents/MacOS/${APP_NAME}"
+DEBUG_PROCESS_PATTERN="${ROOT_DIR}/.build/debug/${APP_NAME}"
+RELEASE_PROCESS_PATTERN="${ROOT_DIR}/.build/release/${APP_NAME}"
+RUN_TESTS=0
+RELEASE_ARCHES=""
+
+log() { printf '%s\n' "$*"; }
+fail() { printf 'ERROR: %s\n' "$*" >&2; exit 1; }
+
+for arg in "$@"; do
+  case "${arg}" in
+    --test|-t) RUN_TESTS=1 ;;
+    --release-universal) RELEASE_ARCHES="arm64 x86_64" ;;
+    --release-arches=*) RELEASE_ARCHES="${arg#*=}" ;;
+    --help|-h)
+      log "Usage: $(basename "$0") [--test] [--release-universal] [--release-arches=\"arm64 x86_64\"]"
+      exit 0
+      ;;
+  esac
+done
+
+log "==> Killing existing ${APP_NAME} instances"
+pkill -f "${APP_PROCESS_PATTERN}" 2>/dev/null || true
+pkill -f "${DEBUG_PROCESS_PATTERN}" 2>/dev/null || true
+pkill -f "${RELEASE_PROCESS_PATTERN}" 2>/dev/null || true
+pkill -x "${APP_NAME}" 2>/dev/null || true
+
+if [[ "${RUN_TESTS}" == "1" ]]; then
+  log "==> swift test"
+  swift test -q
+fi
+
+HOST_ARCH="$(uname -m)"
+ARCHES_VALUE="${HOST_ARCH}"
+if [[ -n "${RELEASE_ARCHES}" ]]; then
+  ARCHES_VALUE="${RELEASE_ARCHES}"
+fi
+
+log "==> package app"
+SIGNING_MODE=adhoc ARCHES="${ARCHES_VALUE}" "${ROOT_DIR}/Scripts/package_app.sh" release
+
+log "==> launch app"
+if ! open "${APP_BUNDLE}"; then
+  log "WARN: open failed; launching binary directly."
+  "${APP_BUNDLE}/Contents/MacOS/${APP_NAME}" >/dev/null 2>&1 &
+  disown
+fi
+
+for _ in {1..10}; do
+  if pgrep -f "${APP_PROCESS_PATTERN}" >/dev/null 2>&1; then
+    log "OK: ${APP_NAME} is running."
+    exit 0
+  fi
+  sleep 0.4
+done
+fail "App exited immediately. Check crash logs in Console.app (User Reports)."

package/bundled-skills/macos-spm-app-packaging/assets/templates/launch.sh

@@ -0,0 +1,28 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+APP_NAME=${APP_NAME:-MyApp}
+APP_PATH="$PROJECT_ROOT/${APP_NAME}.app"
+
+echo "==> Killing existing ${APP_NAME} instances"
+pkill -x "$APP_NAME" || pkill -f "${APP_NAME}.app" || true
+sleep 0.5
+
+if [[ ! -d "$APP_PATH" ]]; then
+    echo "ERROR: ${APP_NAME}.app not found at $APP_PATH"
+    echo "Run ./Scripts/package_app.sh first to build the app"
+    exit 1
+fi
+
+echo "==> Launching ${APP_NAME} from $APP_PATH"
+open -n "$APP_PATH"
+
+sleep 1
+if pgrep -x "$APP_NAME" > /dev/null; then
+    echo "OK: ${APP_NAME} is running."
+else
+    echo "ERROR: App exited immediately. Check crash logs in Console.app (User Reports)."
+    exit 1
+fi

package/bundled-skills/macos-spm-app-packaging/assets/templates/make_appcast.sh

@@ -0,0 +1,82 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+ROOT=$(cd "$(dirname "$0")/.." && pwd)
+ZIP=${1:?
+"Usage: $0 MyApp-<ver>.zip"}
+FEED_URL=${2:-"https://example.com/appcast.xml"}
+PRIVATE_KEY_FILE=${SPARKLE_PRIVATE_KEY_FILE:-}
+if [[ -z "$PRIVATE_KEY_FILE" ]]; then
+  echo "Set SPARKLE_PRIVATE_KEY_FILE to your ed25519 private key (Sparkle)." >&2
+  exit 1
+fi
+if [[ ! -f "$ZIP" ]]; then
+  echo "Zip not found: $ZIP" >&2
+  exit 1
+fi
+
+ZIP_DIR=$(cd "$(dirname "$ZIP")" && pwd)
+ZIP_NAME=$(basename "$ZIP")
+ZIP_BASE="${ZIP_NAME%.zip}"
+VERSION=${SPARKLE_RELEASE_VERSION:-}
+if [[ -z "$VERSION" ]]; then
+  if [[ "$ZIP_NAME" =~ ^[^-]+-([0-9]+(\.[0-9]+){1,2}([-.][^.]*)?)\.zip$ ]]; then
+    VERSION="${BASH_REMATCH[1]}"
+  else
+    echo "Could not infer version from $ZIP_NAME; set SPARKLE_RELEASE_VERSION." >&2
+    exit 1
+  fi
+fi
+
+NOTES_HTML="${ZIP_DIR}/${ZIP_BASE}.html"
+KEEP_NOTES=${KEEP_SPARKLE_NOTES:-0}
+if [[ -x "$ROOT/Scripts/changelog-to-html.sh" ]]; then
+  "$ROOT/Scripts/changelog-to-html.sh" "$VERSION" >"$NOTES_HTML"
+else
+  cat >"$NOTES_HTML" <<HTML
+<!doctype html>
+<html lang="en">
+<meta charset="utf-8">
+<title>${ZIP_BASE}</title>
+<body>
+<h2>${ZIP_BASE}</h2>
+<p>Release notes not provided.</p>
+</body>
+</html>
+HTML
+fi
+cleanup() {
+  if [[ -n "${WORK_DIR:-}" ]]; then
+    rm -rf "$WORK_DIR"
+  fi
+  if [[ "$KEEP_NOTES" != "1" ]]; then
+    rm -f "$NOTES_HTML"
+  fi
+}
+trap cleanup EXIT
+
+DOWNLOAD_URL_PREFIX=${SPARKLE_DOWNLOAD_URL_PREFIX:-"https://example.com/downloads/v${VERSION}/"}
+
+if ! command -v generate_appcast >/dev/null; then
+  echo "generate_appcast not found in PATH. Install Sparkle tools." >&2
+  exit 1
+fi
+
+WORK_DIR=$(mktemp -d /tmp/appcast.XXXXXX)
+
+cp "$ROOT/appcast.xml" "$WORK_DIR/appcast.xml"
+cp "$ZIP" "$WORK_DIR/$ZIP_NAME"
+cp "$NOTES_HTML" "$WORK_DIR/$ZIP_BASE.html"
+
+pushd "$WORK_DIR" >/dev/null
+generate_appcast \
+  --ed-key-file "$PRIVATE_KEY_FILE" \
+  --download-url-prefix "$DOWNLOAD_URL_PREFIX" \
+  --embed-release-notes \
+  --link "$FEED_URL" \
+  "$WORK_DIR"
+popd >/dev/null
+
+cp "$WORK_DIR/appcast.xml" "$ROOT/appcast.xml"
+
+echo "Appcast generated (appcast.xml). Upload alongside $ZIP at $FEED_URL"