build_launcher.sh

#!/bin/bash
#
# Build the Doza Assist macOS app (.app bundle + .dmg)
# Run this from the doza-transcribe directory:
#   bash build_launcher.sh
#
# Creates "Doza Assist.app" on your Desktop and optionally a .dmg for distribution.
#

set -e

SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
APP_NAME="Doza Assist"
APP_DIR="${OUTPUT_DIR:-$HOME/Desktop}/${APP_NAME}.app"
CONTENTS_DIR="${APP_DIR}/Contents"
MACOS_DIR="${CONTENTS_DIR}/MacOS"
RESOURCES_DIR="${CONTENTS_DIR}/Resources"
APP_SRC_DIR="${RESOURCES_DIR}/app"
ICONSET_DIR="/tmp/DozaAssist.iconset"

# Clean up temp files on exit (success or failure)
trap 'rm -rf "${ICONSET_DIR}" "/tmp/DozaAssist.icns" "/tmp/DozaAssist_dmg"' EXIT

echo "Building ${APP_NAME}..."
echo "Source: ${SCRIPT_DIR}"
echo ""

# ── Step 1: Generate icon PNGs ──
echo "1. Generating icon images..."
cd "${SCRIPT_DIR}"
python3 make_icon.py

# ── Step 2: Build .icns from PNGs ──
echo ""
echo "2. Building .icns icon file..."
rm -rf "${ICONSET_DIR}"
mkdir -p "${ICONSET_DIR}"

ICON_BUILD="${SCRIPT_DIR}/icon_build"

cp "${ICON_BUILD}/icon_16x16.png"    "${ICONSET_DIR}/icon_16x16.png"
cp "${ICON_BUILD}/icon_32x32.png"    "${ICONSET_DIR}/icon_16x16@2x.png"
cp "${ICON_BUILD}/icon_32x32.png"    "${ICONSET_DIR}/icon_32x32.png"
cp "${ICON_BUILD}/icon_64x64.png"    "${ICONSET_DIR}/icon_32x32@2x.png"
cp "${ICON_BUILD}/icon_128x128.png"  "${ICONSET_DIR}/icon_128x128.png"
cp "${ICON_BUILD}/icon_256x256.png"  "${ICONSET_DIR}/icon_128x128@2x.png"
cp "${ICON_BUILD}/icon_256x256.png"  "${ICONSET_DIR}/icon_256x256.png"
cp "${ICON_BUILD}/icon_512x512.png"  "${ICONSET_DIR}/icon_256x256@2x.png"
cp "${ICON_BUILD}/icon_512x512.png"  "${ICONSET_DIR}/icon_512x512.png"
cp "${ICON_BUILD}/icon_1024x1024.png" "${ICONSET_DIR}/icon_512x512@2x.png"

iconutil -c icns "${ICONSET_DIR}" -o "/tmp/DozaAssist.icns"
echo "   Icon created."

# ── Step 3: Create .app bundle ──
echo ""
echo "3. Creating .app bundle..."

rm -rf "${APP_DIR}"
mkdir -p "${MACOS_DIR}"
mkdir -p "${RESOURCES_DIR}"
mkdir -p "${APP_SRC_DIR}"

# Copy icon
cp "/tmp/DozaAssist.icns" "${RESOURCES_DIR}/AppIcon.icns"

# ── Step 4: Bundle app source files ──
echo ""
echo "4. Bundling application files..."

# Copy the entire repo into the bundle using a denylist. Anything not
# excluded below is bundled automatically — so adding a new top-level
# Python module or package no longer requires touching this script.
# (This is what broke v2.4.0: the new exporters/ and preferences.py were
# added to the source tree but forgotten here.)
rsync -a \
    --exclude='.git' \
    --exclude='.gitignore' \
    --exclude='.claude' \
    --exclude='.DS_Store' \
    --exclude='__pycache__' \
    --exclude='*.pyc' \
    --exclude='*.pyo' \
    --exclude='venv' \
    --exclude='tests' \
    --exclude='projects' \
    --exclude='exports' \
    --include='docs/' \
    --include='docs/storytelling-foundation-oss.md' \
    --exclude='docs/*' \
    --exclude='.pytest_cache' \
    --exclude='test_hardware_tier.py' \
    --exclude='.github' \
    --exclude='scripts' \
    --exclude='icon_build' \
    --exclude='build_launcher.sh' \
    --exclude='install.sh' \
    --exclude='uninstall.sh' \
    --exclude='start.sh' \
    --exclude='launcher.sh' \
    --exclude='make_icon.py' \
    --exclude='Build Doza Assist.command' \
    --exclude='README.md' \
    --exclude='LICENSE' \
    --exclude='*.dmg' \
    --exclude='*.app' \
    --exclude='/*.png' \
    --exclude='/*.jpg' \
    --exclude='/*.jpeg' \
    --exclude='/*.xmp' \
    "${SCRIPT_DIR}/" "${APP_SRC_DIR}/"

# Sanity check: every critical package/dir must be in the bundle. If the
# rsync ever quietly drops one (a future denylist edit, a permissions
# glitch, an exotic file mode), abort here instead of shipping a DMG that
# 500s on every request — the failure mode behind issue #25.
echo ""
echo "   Verifying critical bundle contents..."
REQUIRED_PATHS=(
    "ai_providers/__init__.py"
    "ai_providers/base.py"
    "doza_assist/__init__.py"
    "doza_assist/fcpxml/__init__.py"
    "exporters/__init__.py"
    "templates"
    "static"
    "app.py"
    "ai_analysis.py"
    "preferences.py"
    "requirements.txt"
)
MISSING_FROM_BUNDLE=()
for p in "${REQUIRED_PATHS[@]}"; do
    if [ ! -e "${APP_SRC_DIR}/${p}" ]; then
        MISSING_FROM_BUNDLE+=("$p")
    fi
done
if [ "${#MISSING_FROM_BUNDLE[@]}" -gt 0 ]; then
    echo ""
    echo "   BUILD ABORTED — required paths missing from bundle:"
    for p in "${MISSING_FROM_BUNDLE[@]}"; do
        echo "     - ${p}"
    done
    echo ""
    echo "   Check the rsync denylist above for a regression."
    exit 1
fi

# Make scripts executable
chmod +x "${APP_SRC_DIR}/setup_runner.sh"
chmod +x "${APP_SRC_DIR}/dep_check.sh"

echo "   Bundled $(find "${APP_SRC_DIR}" -type f | wc -l | tr -d ' ') files."

# ── Step 5: Create Info.plist ──
# Single-source the version from doza_assist/__init__.py so the macOS-level
# CFBundleVersion never drifts from the in-app __version__ pill.
APP_VERSION="$(grep -E '^__version__' "${SCRIPT_DIR}/doza_assist/__init__.py" \
    | head -1 \
    | sed -E 's/.*"([^"]+)".*/\1/')"
if [ -z "${APP_VERSION}" ]; then
    echo "   ERROR: could not read __version__ from doza_assist/__init__.py" >&2
    exit 1
fi
echo "   App version: ${APP_VERSION}"

cat > "${CONTENTS_DIR}/Info.plist" << PLIST
<?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>CFBundleName</key>
    <string>Doza Assist</string>
    <key>CFBundleDisplayName</key>
    <string>Doza Assist</string>
    <key>CFBundleIdentifier</key>
    <string>com.dozavisuals.transcribe</string>
    <key>CFBundleVersion</key>
    <string>${APP_VERSION}</string>
    <key>CFBundleShortVersionString</key>
    <string>${APP_VERSION}</string>
    <key>CFBundlePackageType</key>
    <string>APPL</string>
    <key>CFBundleIconFile</key>
    <string>AppIcon</string>
    <key>CFBundleExecutable</key>
    <string>launch</string>
    <key>LSMinimumSystemVersion</key>
    <string>12.0</string>
    <key>LSUIElement</key>
    <false/>
    <key>NSHighResolutionCapable</key>
    <true/>
</dict>
</plist>
PLIST

# ── Step 6: Create the launch script ──
echo ""
echo "5. Creating launcher..."

cp "${SCRIPT_DIR}/launcher.sh" "${MACOS_DIR}/launch"

chmod +x "${MACOS_DIR}/launch"

# ── Step 7: Smoke test the bundle ──
# Import the bundled app.py with only the bundle directory on sys.path. This
# catches any ModuleNotFoundError before we ever create the DMG — exactly the
# class of bug that shipped in v2.4.0 (missing exporters/ and preferences.py).
# Uses the dev venv so Flask/whisper/etc. resolve (the end-user installer
# provisions these on first launch via setup_runner.sh).
echo ""
echo "6. Smoke testing bundled app..."

SMOKE_PY="${SCRIPT_DIR}/venv/bin/python3"
if [ ! -x "${SMOKE_PY}" ]; then
    echo "   Skipping smoke test — ${SMOKE_PY} not found."
    echo "   (Create the dev venv with \`python3 -m venv venv && venv/bin/pip install -r requirements.txt\` to enable this guard.)"
else
    SMOKE_LOG="$(mktemp)"
    # app.py creates projects/ and exports/ under $DOZA_DATA_DIR at import time.
    # Point it at a throwaway tempdir so the bundle source tree stays clean.
    SMOKE_DATA_DIR="$(mktemp -d)"
    if ( cd "${APP_SRC_DIR}" && PYTHONDONTWRITEBYTECODE=1 DOZA_DATA_DIR="${SMOKE_DATA_DIR}" "${SMOKE_PY}" -c "import sys; sys.path.insert(0, '.'); import app" ) >"${SMOKE_LOG}" 2>&1; then
        rm -rf "${SMOKE_DATA_DIR}" "${APP_SRC_DIR}/__pycache__"
        echo "   Bundle imports cleanly."
        rm -f "${SMOKE_LOG}"
    else
        echo ""
        echo "   BUILD ABORTED — bundled app.py failed to import."
        echo "   The .app would crash at startup if we shipped this."
        echo ""
        echo "   Error:"
        sed 's/^/     /' "${SMOKE_LOG}"
        echo ""
        echo "   Likely causes:"
        echo "     - A new source file is excluded by build_launcher.sh's rsync denylist"
        echo "     - A real import bug in the source tree"
        echo "     - A new PyPI dep was added but is not in the dev venv"
        echo ""
        echo "   Fix the above and re-run. No DMG was created."
        rm -f "${SMOKE_LOG}"
        rm -rf "${SMOKE_DATA_DIR}"
        exit 1
    fi
fi

# ── Step 8: Clean up build artifacts ──
echo ""
echo "7. Cleaning up..."
rm -rf "${ICON_BUILD}"
rm -rf "${ICONSET_DIR}"
rm -f "/tmp/DozaAssist.icns"

# ── Step 9: Create .dmg ──
echo ""
echo "8. Creating .dmg for distribution..."

DMG_NAME="${APP_NAME}"
DMG_DIR="/tmp/DozaAssist_dmg"
DMG_PATH="${OUTPUT_DIR:-$HOME/Desktop}/${DMG_NAME}.dmg"

# Clean up any previous DMG build
rm -rf "${DMG_DIR}"
rm -f "${DMG_PATH}"

mkdir -p "${DMG_DIR}"
cp -R "${APP_DIR}" "${DMG_DIR}/"

# Create a symlink to /Applications for drag-to-install
ln -s /Applications "${DMG_DIR}/Applications"

# Create the DMG
hdiutil create -volname "${DMG_NAME}" \
    -srcfolder "${DMG_DIR}" \
    -ov -format UDZO \
    "${DMG_PATH}"

rm -rf "${DMG_DIR}"

echo ""
echo "================================================"
echo "  Build complete!"
echo "================================================"
echo ""
echo "  App:  ${APP_DIR}"
echo "  DMG:  ${DMG_PATH}"
echo ""
echo "  The .app is self-contained — drag it to"
echo "  Applications or double-click to launch."
echo ""
echo "  Share the .dmg file for distribution."
echo "  On first launch, it will automatically"
echo "  install all required dependencies."
echo ""