@sriinnu/runic 1.0.0

package/appcast.xml

@@ -0,0 +1,105 @@
+<?xml version="1.0" encoding="utf-8" standalone="yes"?>
+<rss xmlns:sparkle="http://www.andymatuschak.org/xml-namespaces/sparkle" version="2.0">
+    <channel>
+        <title>Runic</title>
+        <item>
+            <title>0.16.0</title>
+            <pubDate>Mon, 29 Dec 2025 19:03:57 +0100</pubDate>
+            <link>https://raw.githubusercontent.com/sriinnu/Runic/main/appcast.xml</link>
+            <sparkle:version>46</sparkle:version>
+            <sparkle:shortVersionString>0.16.0</sparkle:shortVersionString>
+            <sparkle:minimumSystemVersion>14.0</sparkle:minimumSystemVersion>
+            <description><![CDATA[<h2>Runic 0.16.0</h2>
+<ul>
+<li>Menu bar: optional “percent mode” (provider brand icons + percentage labels) via Advanced toggle.</li>
+<li>CLI: add <code>runic cost</code> to print local cost usage (text/JSON) for Codex + Claude.</li>
+<li>Cost: align local cost scanner with ccusage; stabilize parsing/decoding and handle large JSONL lines.</li>
+<li>Claude: skip pricing for unknown models (tokens still tracked) to avoid hard-coded legacy prices.</li>
+<li>Performance: reduce menu bar CPU usage by caching morph icons, skipping redundant status-item updates, and caching provider enablement/order during animations.</li>
+<li>Menu: improve provider switcher hover contrast in light mode.</li>
+<li>Icons: refresh Droid + Claude brand assets to better match menu sizing.</li>
+<li>CI: avoid interactive login-shell probes to reduce noisy “CLI missing” errors.</li>
+</ul>
+<p><a href="https://github.com/sriinnu/Runic/blob/main/CHANGELOG.md">View full changelog</a></p>
+]]></description>
+            <enclosure url="https://github.com/sriinnu/Runic/releases/download/v0.16.0/Runic-0.16.0.zip" length="7607740" type="application/octet-stream" sparkle:edSignature="D/d9z4+8/gqpeoXBKkmEkzpPrzs9pp1DQeCETkndA2kyi1wKTAjPyw6Hj6V1Pe3T5ge66E0N5De88ilUp6WmBw=="/>
+        </item>
+        <item>
+            <title>0.15.3</title>
+            <pubDate>Sun, 28 Dec 2025 20:18:41 +0100</pubDate>
+            <link>https://raw.githubusercontent.com/sriinnu/Runic/main/appcast.xml</link>
+            <sparkle:version>45</sparkle:version>
+            <sparkle:shortVersionString>0.15.3</sparkle:shortVersionString>
+            <sparkle:minimumSystemVersion>14.0</sparkle:minimumSystemVersion>
+            <description><![CDATA[<h2>Runic 0.15.3</h2>
+<ul>
+<li>Codex: default to OAuth usage API (ChatGPT backend) with CLI-only override in Debug.</li>
+<li>Codex: map OAuth credits balance directly, avoiding web fallback for credits.</li>
+<li>Preferences: add optional “Access OpenAI via web” toggle and show blended source labels when web extras are active.</li>
+<li>Copilot: replace blocking auth wait dialog with a non-modal sheet to avoid stuck login.</li>
+</ul>
+<ul>
+<li>CI: stabilize Claude CLI version detection test.</li>
+</ul>
+<p><a href="https://github.com/sriinnu/Runic/blob/main/CHANGELOG.md">View full changelog</a></p>
+]]></description>
+            <enclosure url="https://github.com/sriinnu/Runic/releases/download/v0.15.3/Runic-0.15.3.zip" length="7549248" type="application/octet-stream" sparkle:edSignature="3xoy09WoQnTuskCqIPRHriFPmmTJCVZ4BIgufRNLqfNhszmE1MSf2pWQVYzgt0SBVDrY+12/0dCie9TG0RqTBg=="/>
+        </item>
+        <item>
+            <title>0.15.2</title>
+            <pubDate>Sun, 28 Dec 2025 18:51:01 +0100</pubDate>
+            <link>https://raw.githubusercontent.com/sriinnu/Runic/main/appcast.xml</link>
+            <sparkle:version>44</sparkle:version>
+            <sparkle:shortVersionString>0.15.2</sparkle:shortVersionString>
+            <sparkle:minimumSystemVersion>14.0</sparkle:minimumSystemVersion>
+            <description><![CDATA[<h2>Runic 0.15.2</h2>
+<ul>
+<li>Copilot: fix device-flow waiting modal to close reliably after auth (and avoid stuck waits).</li>
+<li>Packaging: include the KeyboardShortcuts resource bundle to prevent Settings → Keyboard shortcut crashes in packaged builds.</li>
+</ul>
+<p><a href="https://github.com/sriinnu/Runic/blob/main/CHANGELOG.md">View full changelog</a></p>
+]]></description>
+            <enclosure url="https://github.com/sriinnu/Runic/releases/download/v0.15.2/Runic-0.15.2.zip" length="7413967" type="application/octet-stream" sparkle:edSignature="vv7kPaGk0vzAj1AJ5EEbRE0kXtE4iIscrkhxsjU8X+BDT5HQkwJTully+OivJFCksjuUyaZIV74tfi1kWlSWDQ=="/>
+        </item>
+        <item>
+            <title>0.14.0</title>
+            <pubDate>Thu, 25 Dec 2025 03:56:15 +0100</pubDate>
+            <link>https://raw.githubusercontent.com/sriinnu/Runic/main/appcast.xml</link>
+            <sparkle:version>41</sparkle:version>
+            <sparkle:shortVersionString>0.14.0</sparkle:shortVersionString>
+            <sparkle:minimumSystemVersion>15.0</sparkle:minimumSystemVersion>
+            <description><![CDATA[<h2>Runic 0.14.0</h2>
+<ul>
+<li>Antigravity: new local provider for the Antigravity language server (Claude + Gemini quotas) with an experimental toggle; improved plan display + debug output; clearer not-running/port errors; hide account switch.</li>
+<li>Status: poll Google Workspace incidents for Gemini + Antigravity; Status Page opens the Workspace status page.</li>
+            <li>Settings: add Providers tab; move cost usage + status toggles to General; keep display controls in Advanced.</li>
+<li>Menu/UI: widen the menu for four providers; cards/charts adapt to menu width; tighten provider switcher/toggle spacing; keep menus refreshed while open.</li>
+<li>Gemini: hide the dashboard action when unsupported.</li>
+<li>Claude: fix Extra usage spend/limit units (cents); improve CLI probe stability; surface web session info in Debug.</li>
+<li>OpenAI web: fix dashboard ghost overlay on desktop (WebKit keepalive window).</li>
+<li>Debug: add a debug-lldb build mode for troubleshooting.</li>
+</ul>
+<p><a href="https://github.com/sriinnu/Runic/blob/main/CHANGELOG.md">View full changelog</a></p>
+]]></description>
+            <enclosure url="https://github.com/sriinnu/Runic/releases/download/v0.14.0/Runic-0.14.0.zip" length="5382347" type="application/octet-stream" sparkle:edSignature="qhj8jnqH/eOXEP2plbZyTb8w1x0Afcpix0kC+pzMh5jX9Lkf3Yg2Bvd6/vsKdhOObEwJjQZRb/RKiSBx55J3DA=="/>
+        </item>
+        <item>
+            <title>0.13.0</title>
+            <pubDate>Wed, 24 Dec 2025 01:53:35 +0100</pubDate>
+            <link>https://raw.githubusercontent.com/sriinnu/Runic/main/appcast.xml</link>
+            <sparkle:version>40</sparkle:version>
+            <sparkle:shortVersionString>0.13.0</sparkle:shortVersionString>
+            <sparkle:minimumSystemVersion>15.0</sparkle:minimumSystemVersion>
+            <enclosure url="https://github.com/sriinnu/Runic/releases/download/v0.13.0/Runic-0.13.0.zip" length="5099083" type="application/octet-stream" sparkle:edSignature="EmhEmcTFQEpuQG6vZ288l9j278VjnpQdQcmZnU1JDvzERVTtnIg+8RDlsHV9niwejaOBPX6mvXST3vNJHpwADA=="/>
+        </item>
+        <item>
+            <title>0.12.0</title>
+            <pubDate>Tue, 23 Dec 2025 04:39:05 +0100</pubDate>
+            <link>https://raw.githubusercontent.com/sriinnu/Runic/main/appcast.xml</link>
+            <sparkle:version>39</sparkle:version>
+            <sparkle:shortVersionString>0.12.0</sparkle:shortVersionString>
+            <sparkle:minimumSystemVersion>15.0</sparkle:minimumSystemVersion>
+            <enclosure url="https://github.com/sriinnu/Runic/releases/download/v0.12.0/Runic-0.12.0.zip" length="4888386" type="application/octet-stream" sparkle:edSignature="tQMHO/RNAbvwRHXYnLAkNV2ksiV722qR8fEYzcbipgetacfPnwnLJ0Pe/lAiZ03PBmj3BkisHb74GosUlSV+DQ=="/>
+        </item>
+    </channel>
+</rss>

package/assets/logo-concept-stack.svg

@@ -0,0 +1,24 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="76 100 360 360" fill="none">
+  <!-- Chip 1 (Bottom) -->
+  <ellipse cx="256" cy="380" rx="100" ry="40" fill="#1D4ED8" />
+  <path d="M156 380 V 400 C 156 422, 200 440, 256 440 C 312 440, 356 422, 356 400 V 380" fill="#1E3A8A" />
+  
+  <!-- Chip 2 -->
+  <ellipse cx="256" cy="340" rx="100" ry="40" fill="#2563EB" />
+  <path d="M156 340 V 360 C 156 382, 200 400, 256 400 C 312 400, 356 382, 356 360 V 340" fill="#1D4ED8" />
+
+  <!-- Chip 3 -->
+  <ellipse cx="256" cy="300" rx="100" ry="40" fill="#3B82F6" />
+  <path d="M156 300 V 320 C 156 342, 200 360, 256 360 C 312 360, 356 342, 356 320 V 300" fill="#2563EB" />
+
+  <!-- Chip 4 (Top - Glowing) -->
+  <ellipse cx="256" cy="260" rx="100" ry="40" fill="#60A5FA" />
+  <path d="M156 260 V 280 C 156 302, 200 320, 256 320 C 312 320, 356 302, 356 280 V 260" fill="#3B82F6" />
+  
+  <!-- Top Surface Glow -->
+  <ellipse cx="256" cy="260" rx="80" ry="30" fill="#93C5FD" opacity="0.5" />
+
+  <!-- Floating "Spent" Token (Ghost) -->
+  <ellipse cx="256" cy="160" rx="100" ry="40" stroke="#60A5FA" stroke-width="2" stroke-dasharray="8 8" fill="none" opacity="0.3" />
+
+</svg>

package/assets/logo-minimal-bars.svg

@@ -0,0 +1,15 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 256 256" fill="none">
+  <!-- clean two-bar meter - exactly what the menu bar shows -->
+  
+  <!-- session bar (thick, 70% filled) -->
+  <rect x="64" y="88" width="128" height="32" rx="16" fill="#14B8A6" opacity="0.25"/>
+  <rect x="64" y="88" width="90" height="32" rx="16" fill="#14B8A6"/>
+  
+  <!-- weekly bar (thin, 55% filled) -->
+  <rect x="64" y="136" width="128" height="16" rx="8" fill="#2DD4BF" opacity="0.25"/>
+  <rect x="64" y="136" width="70" height="16" rx="8" fill="#2DD4BF"/>
+  
+  <!-- simple reset indicators -->
+  <circle cx="194" cy="104" r="4" fill="#0D9488"/>
+  <circle cx="194" cy="144" r="3" fill="#0D9488"/>
+</svg>

package/assets/logo.svg

@@ -0,0 +1,20 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 256 256" fill="none">
+  <!-- session window (thick) -->
+  <path d="M64 96
+           C64 64 104 64 128 96
+           C152 128 192 128 192 96
+           C192 64 152 64 128 96
+           C104 128 64 128 64 96"
+        stroke="#14B8A6" stroke-width="18"
+        stroke-linecap="round" stroke-linejoin="round"/>
+
+  <!-- telemetry knot (center accent) -->
+  <rect x="112" y="80" width="32" height="32" rx="16" fill="#2DD4BF"/>
+
+  <!-- usage bars (darker teal) -->
+  <g fill="#0F766E">
+    <rect x="114" y="90" width="8" height="22" rx="4"/>
+    <rect x="124" y="86" width="8" height="26" rx="4"/>
+    <rect x="134" y="92" width="8" height="20" rx="4"/>
+  </g>
+</svg>

package/assets/logo2.svg

@@ -0,0 +1,43 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 256 256" fill="none">
+  <!-- dual-ring meter - emphasizes two separate tracking windows -->
+  
+  <!-- outer ring (weekly window - 60% arc) -->
+  <circle cx="128" cy="128" r="96" 
+          stroke="#2DD4BF" 
+          stroke-width="16" 
+          opacity="0.2"
+          stroke-dasharray="602 602"/>
+  <circle cx="128" cy="128" r="96" 
+          stroke="#2DD4BF" 
+          stroke-width="16" 
+          stroke-dasharray="361 241"
+          stroke-linecap="round"
+          transform="rotate(-90 128 128)"/>
+  
+  <!-- inner ring (session window - 75% arc) -->
+  <circle cx="128" cy="128" r="64" 
+          stroke="#14B8A6" 
+          stroke-width="20" 
+          opacity="0.2"
+          stroke-dasharray="402 402"/>
+  <circle cx="128" cy="128" r="64" 
+          stroke="#14B8A6" 
+          stroke-width="20" 
+          stroke-dasharray="301 101"
+          stroke-linecap="round"
+          transform="rotate(-90 128 128)"/>
+  
+  <!-- center usage indicator -->
+  <circle cx="128" cy="128" r="28" fill="#0F766E"/>
+  
+  <!-- micro bars -->
+  <g fill="#14B8A6">
+    <rect x="118" y="120" width="6" height="16" rx="3"/>
+    <rect x="128" y="116" width="6" height="24" rx="3"/>
+    <rect x="138" y="122" width="6" height="12" rx="3"/>
+  </g>
+  
+  <!-- reset markers -->
+  <circle cx="128" cy="24" r="6" fill="#2DD4BF"/>
+  <circle cx="128" cy="20" r="6" fill="#14B8A6"/>
+</svg>

package/bin/docs-list

@@ -0,0 +1,5 @@
+#!/usr/bin/env bash
+set -euo pipefail
+SCRIPT_DIR=$(cd "$(dirname "$0")" && pwd)
+PROJECT_ROOT=$(cd "$SCRIPT_DIR/.." && pwd)
+node "$PROJECT_ROOT/Scripts/docs-list.mjs" "$@"

package/bin/install-runic-cli.sh

@@ -0,0 +1,32 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+APP="/Applications/Runic.app"
+HELPER="$APP/Contents/Helpers/RunicCLI"
+TARGETS=("/usr/local/bin/runic" "/opt/homebrew/bin/runic")
+
+if [[ ! -x "$HELPER" ]]; then
+  echo "RunicCLI helper not found at $HELPER. Please reinstall Runic." >&2
+  exit 1
+fi
+
+install_script=$(mktemp)
+cat > "$install_script" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+HELPER="__HELPER__"
+TARGETS=("/usr/local/bin/runic" "/opt/homebrew/bin/runic")
+
+for t in "${TARGETS[@]}"; do
+  mkdir -p "$(dirname "$t")"
+  ln -sf "$HELPER" "$t"
+  echo "Linked $t -> $HELPER"
+done
+EOF
+
+perl -pi -e "s#__HELPER__#$HELPER#g" "$install_script"
+
+osascript -e "do shell script \"bash '$install_script'\" with administrator privileges"
+rm -f "$install_script"
+
+echo "Runic CLI installed. Try: runic usage"

package/build-and-run.sh

@@ -0,0 +1,369 @@
+#!/usr/bin/env bash
+
+################################################################################
+# build-and-run.sh
+#
+# Purpose: Quick build and run script for Runic
+#
+# Description:
+#   - Builds Runic with swift build -c release
+#   - Copies executable to app bundle
+#   - Copies frameworks (Sparkle) to app bundle
+#   - Sets up proper directory structure
+#   - Optionally opens the app after building
+#
+# Usage:
+#   ./build-and-run.sh [OPTIONS]
+#
+# Options:
+#   --no-build          Skip building, just copy frameworks
+#   --no-run            Build but don't open the app
+#   --debug             Build in debug mode instead of release
+#   --clean             Clean before building
+#   --verbose           Show verbose output
+#   --help              Show this help message
+#
+# Requirements:
+#   - macOS 14.0+
+#   - Swift 6.0+
+#
+# Author: Runic Team
+# Version: 1.0.0
+################################################################################
+
+set -e  # Exit on error
+set -u  # Exit on undefined variable
+
+# Script configuration
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$SCRIPT_DIR"
+
+DO_BUILD=true
+DO_RUN=true
+CONFIGURATION="release"
+DO_CLEAN=false
+VERBOSE=false
+
+# Color output
+if [[ -t 1 ]]; then
+    GREEN='\033[0;32m'
+    YELLOW='\033[1;33m'
+    RED='\033[0;31m'
+    BLUE='\033[0;34m'
+    CYAN='\033[0;36m'
+    BOLD='\033[1m'
+    RESET='\033[0m'
+else
+    GREEN=''
+    YELLOW=''
+    RED=''
+    BLUE=''
+    CYAN=''
+    BOLD=''
+    RESET=''
+fi
+
+################################################################################
+# Helper Functions
+################################################################################
+
+log_info() {
+    echo -e "${BLUE}[INFO]${RESET} $*"
+}
+
+log_success() {
+    echo -e "${GREEN}[SUCCESS]${RESET} $*"
+}
+
+log_warning() {
+    echo -e "${YELLOW}[WARNING]${RESET} $*"
+}
+
+log_error() {
+    echo -e "${RED}[ERROR]${RESET} $*" >&2
+}
+
+log_step() {
+    echo -e "\n${CYAN}${BOLD}==>${RESET} ${BOLD}$*${RESET}\n"
+}
+
+show_help() {
+    sed -n '/^# Purpose:/,/^################################################################################$/p' "$0" | sed 's/^# \?//'
+}
+
+################################################################################
+# Build Functions
+################################################################################
+
+clean_build() {
+    if [[ "$DO_CLEAN" == false ]]; then
+        return 0
+    fi
+
+    log_step "Cleaning Build Directory"
+
+    cd "$PROJECT_ROOT"
+
+    if [[ -d ".build" ]]; then
+        log_info "Removing .build directory..."
+        rm -rf .build
+        log_success "Build directory cleaned"
+    else
+        log_info "No build directory to clean"
+    fi
+}
+
+build_executable() {
+    if [[ "$DO_BUILD" == false ]]; then
+        log_info "Skipping build (--no-build)"
+        return 0
+    fi
+
+    log_step "Building Runic Executable"
+
+    cd "$PROJECT_ROOT"
+
+    local build_cmd="swift build -c $CONFIGURATION"
+
+    if [[ "$VERBOSE" == true ]]; then
+        build_cmd="$build_cmd --verbose"
+    fi
+
+    log_info "Running: $build_cmd"
+
+    if $build_cmd; then
+        log_success "Build completed successfully"
+    else
+        log_error "Build failed"
+        return 1
+    fi
+}
+
+create_app_bundle() {
+    log_step "Creating Application Bundle"
+
+    cd "$PROJECT_ROOT"
+
+    local app_dir="builds/macos/Runic.app"
+
+    # Create app bundle structure
+    log_info "Creating app bundle structure at $app_dir"
+    mkdir -p "$app_dir/Contents/MacOS"
+    mkdir -p "$app_dir/Contents/Resources"
+    mkdir -p "$app_dir/Contents/Frameworks"
+
+    # Determine build directory based on configuration
+    local build_dir
+    if [[ "$CONFIGURATION" == "release" ]]; then
+        build_dir=".build/release"
+    else
+        build_dir=".build/debug"
+    fi
+
+    # Copy executable
+    local executable="$build_dir/Runic"
+    if [[ ! -f "$executable" ]]; then
+        log_error "Executable not found at $executable"
+        log_error "Please run swift build first"
+        return 1
+    fi
+
+    log_info "Copying executable..."
+    cp "$executable" "$app_dir/Contents/MacOS/Runic"
+    chmod +x "$app_dir/Contents/MacOS/Runic"
+    log_success "Executable copied"
+
+    # Copy Sparkle framework
+    local sparkle_source=".build/arm64-apple-macosx/$CONFIGURATION/Sparkle.framework"
+
+    if [[ -d "$sparkle_source" ]]; then
+        log_info "Copying Sparkle.framework..."
+        cp -R "$sparkle_source" "$app_dir/Contents/Frameworks/"
+        log_success "Sparkle.framework copied"
+
+        # Add rpath to executable
+        log_info "Adding framework rpath..."
+        install_name_tool -add_rpath @loader_path/../Frameworks "$app_dir/Contents/MacOS/Runic" 2>&1 | grep -v "warning: changes being made" || true
+        log_success "Framework rpath added"
+    else
+        log_warning "Sparkle.framework not found at $sparkle_source"
+    fi
+
+    # Copy resources
+    if [[ -d "Sources/Runic/Resources" ]]; then
+        log_info "Copying resources..."
+        cp -R Sources/Runic/Resources/* "$app_dir/Contents/Resources/" 2>/dev/null || true
+        log_success "Resources copied"
+    fi
+
+    # Copy icon if exists
+    if [[ -f "Icon.icns" ]]; then
+        cp "Icon.icns" "$app_dir/Contents/Resources/"
+        log_info "Icon copied"
+    fi
+
+    # Create Info.plist
+    local version="1.0.0"
+    if [[ -f "version.env" ]]; then
+        source "version.env"
+        version="${VERSION:-$version}"
+    fi
+
+    log_info "Creating Info.plist (version: $version)..."
+    cat > "$app_dir/Contents/Info.plist" << EOF
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>CFBundleDevelopmentRegion</key>
+    <string>en</string>
+    <key>CFBundleExecutable</key>
+    <string>Runic</string>
+    <key>CFBundleIconFile</key>
+    <string>Icon</string>
+    <key>CFBundleIdentifier</key>
+    <string>com.sriinnu.athena.Runic</string>
+    <key>CFBundleInfoDictionaryVersion</key>
+    <string>6.0</string>
+    <key>CFBundleName</key>
+    <string>Runic</string>
+    <key>CFBundlePackageType</key>
+    <string>APPL</string>
+    <key>CFBundleShortVersionString</key>
+    <string>$version</string>
+    <key>CFBundleVersion</key>
+    <string>$version</string>
+    <key>LSMinimumSystemVersion</key>
+    <string>14.0</string>
+    <key>NSPrincipalClass</key>
+    <string>NSApplication</string>
+    <key>NSHighResolutionCapable</key>
+    <true/>
+    <key>LSUIElement</key>
+    <true/>
+    <key>NSUserNotificationAlertStyle</key>
+    <string>alert</string>
+    <key>NSSupportsAutomaticTermination</key>
+    <true/>
+    <key>NSSupportsSuddenTermination</key>
+    <true/>
+</dict>
+</plist>
+EOF
+
+    # Sign the entire app bundle after all contents are in place.
+    # Signing must happen last — install_name_tool and Info.plist creation
+    # invalidate any earlier signature.
+    log_info "Signing app bundle..."
+
+    local cert_name=""
+    local cert_type=""
+
+    if [[ "$CONFIGURATION" == "release" ]]; then
+        cert_type="Developer ID Application"
+        cert_name=$(security find-identity -v -p codesigning | grep "Developer ID Application" | head -n 1 | awk -F'"' '{print $2}')
+    else
+        cert_type="Apple Development"
+        cert_name=$(security find-identity -v -p codesigning | grep "Apple Development" | head -n 1 | awk -F'"' '{print $2}')
+    fi
+
+    if [[ -n "$cert_name" ]]; then
+        codesign --deep --force --sign "$cert_name" --options runtime "$app_dir" 2>&1 | grep -v "replacing existing signature" || true
+        log_success "Signed with $cert_type: $cert_name"
+    else
+        log_warning "No $cert_type certificate found - using ad-hoc signing"
+        codesign --deep --force --sign "-" "$app_dir" 2>&1 | grep -v "replacing existing signature" || true
+    fi
+
+    # Verify signature
+    if codesign --verify --deep --strict "$app_dir" 2>/dev/null; then
+        log_success "Signature verification passed"
+    else
+        log_warning "Signature verification failed — app may not launch"
+    fi
+
+    log_success "App bundle created at $app_dir"
+}
+
+run_app() {
+    if [[ "$DO_RUN" == false ]]; then
+        log_info "Skipping app launch (--no-run)"
+        return 0
+    fi
+
+    log_step "Launching Application"
+
+    local app_path="builds/macos/Runic.app"
+
+    if [[ ! -d "$app_path" ]]; then
+        log_error "App bundle not found at $app_path"
+        return 1
+    fi
+
+    log_info "Opening $app_path..."
+    open "$app_path"
+    log_success "Application launched"
+}
+
+################################################################################
+# Main Script
+################################################################################
+
+main() {
+    # Parse arguments
+    while [[ $# -gt 0 ]]; do
+        case $1 in
+            --no-build)
+                DO_BUILD=false
+                shift
+                ;;
+            --no-run)
+                DO_RUN=false
+                shift
+                ;;
+            --debug)
+                CONFIGURATION="debug"
+                shift
+                ;;
+            --clean)
+                DO_CLEAN=true
+                shift
+                ;;
+            --verbose)
+                VERBOSE=true
+                shift
+                ;;
+            --help|-h)
+                show_help
+                exit 0
+                ;;
+            *)
+                log_error "Unknown option: $1"
+                log_info "Use --help for usage information"
+                exit 1
+                ;;
+        esac
+    done
+
+    local start_time=$(date +%s)
+
+    log_step "Building and Running Runic"
+
+    clean_build
+    build_executable || exit 1
+    create_app_bundle || exit 1
+    run_app
+
+    local end_time=$(date +%s)
+    local duration=$((end_time - start_time))
+
+    echo ""
+    log_success "Completed in ${duration}s"
+
+    if [[ "$DO_RUN" == false ]]; then
+        echo ""
+        log_info "To run the app: open builds/macos/Runic.app"
+    fi
+}
+
+main "$@"

package/docs/.nojekyll

@@ -0,0 +1 @@
+

package/docs/CNAME

@@ -0,0 +1 @@
+runic.app