install.sh

#!/usr/bin/env bash
# Install voice-prompt: hold a hotkey to record a voice prompt, transcribe
# it locally with whisper, and drop straight into an opencode TUI session.
#
# Idempotent. Safe to re-run.

set -euo pipefail

REPO_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
HAMMERSPOON_SRC="$REPO_DIR/hammerspoon"
SHARE_SRC="$REPO_DIR/share"

HAMMERSPOON_DIR="$HOME/.hammerspoon"
SHARE_DIR="$HOME/.local/share/voice-prompt"
WHISPER_DIR="$HOME/.local/share/whisper-cpp"
WORK_DIR="$HOME/voice-prompts"

WHISPER_MODEL_DEFAULT="ggml-large-v3-turbo-q5_0.bin"
WHISPER_MODEL_URL="https://huggingface.co/ggerganov/whisper.cpp/resolve/main/$WHISPER_MODEL_DEFAULT"

# --------------------------------------------------------------------
say()  { printf '\033[1;36m==>\033[0m %s\n' "$*"; }
warn() { printf '\033[1;33m!!\033[0m  %s\n' "$*" >&2; }
fail() { printf '\033[1;31mxx\033[0m  %s\n' "$*" >&2; exit 1; }

# --------------------------------------------------------------------
# 0. preflight: opencode and brew must be present
# --------------------------------------------------------------------
DEFAULT_OPENCODE_BIN="$HOME/.opencode/bin/opencode"
if ! command -v opencode >/dev/null && [[ ! -x "$DEFAULT_OPENCODE_BIN" ]]; then
  cat <<EOF >&2
opencode is not installed. Install it first:

    curl -fsSL https://opencode.ai/install | bash

Then authenticate:

    opencode auth login

Then re-run this installer.
EOF
  exit 1
fi

# --------------------------------------------------------------------
# 1. brew dependencies
# --------------------------------------------------------------------
say "Checking Homebrew dependencies"

command -v brew >/dev/null || fail "Homebrew is required. Install from https://brew.sh"

brew_install_if_missing() {
  local kind="$1" name="$2"
  if [[ "$kind" == "cask" ]]; then
    if brew list --cask --versions "$name" >/dev/null 2>&1; then
      echo "    $name (cask) already installed"
    else
      say "Installing $name (cask)"
      brew install --cask "$name"
    fi
  else
    if brew list --versions "$name" >/dev/null 2>&1; then
      echo "    $name already installed"
    else
      say "Installing $name"
      brew install "$name"
    fi
  fi
}

brew_install_if_missing cask hammerspoon
brew_install_if_missing formula whisper-cpp
brew_install_if_missing formula sox
brew_install_if_missing formula jq

# --------------------------------------------------------------------
# 2. whisper model
# --------------------------------------------------------------------
say "Checking whisper model"
mkdir -p "$WHISPER_DIR"
if [[ -f "$WHISPER_DIR/$WHISPER_MODEL_DEFAULT" ]]; then
  echo "    $WHISPER_MODEL_DEFAULT already downloaded"
else
  say "Downloading $WHISPER_MODEL_DEFAULT (~570MB, one time)"
  curl -L --progress-bar -o "$WHISPER_DIR/$WHISPER_MODEL_DEFAULT" "$WHISPER_MODEL_URL"
fi

# --------------------------------------------------------------------
# 3. symlink share/ files into ~/.local/share/voice-prompt/
# --------------------------------------------------------------------
say "Linking share files"
mkdir -p "$SHARE_DIR"

link_into_share() {
  local src="$1" name="$2"
  local dst="$SHARE_DIR/$name"
  if [[ -L "$dst" && "$(readlink "$dst")" == "$src" ]]; then
    echo "    $name already linked"
    return
  fi
  if [[ -e "$dst" ]]; then
    local backup="$dst.backup.$(date +%Y%m%d_%H%M%S)"
    warn "Existing $name found; backing up to $(basename "$backup")"
    mv "$dst" "$backup"
  fi
  ln -s "$src" "$dst"
  echo "    linked $name"
}

link_into_share "$SHARE_SRC/pipeline.sh"        pipeline.sh
link_into_share "$SHARE_SRC/run-in-terminal.sh" run-in-terminal.sh
link_into_share "$SHARE_SRC/stt-prompt.md"      stt-prompt.md

chmod +x "$SHARE_SRC/pipeline.sh" "$SHARE_SRC/run-in-terminal.sh"

# --------------------------------------------------------------------
# 4. hammerspoon files
# --------------------------------------------------------------------
say "Linking Hammerspoon files"
mkdir -p "$HAMMERSPOON_DIR"

# voice-prompt.lua: symlink from repo (so updates flow automatically).
link_into_hs() {
  local src="$1" name="$2"
  local dst="$HAMMERSPOON_DIR/$name"
  if [[ -L "$dst" && "$(readlink "$dst")" == "$src" ]]; then
    echo "    $name already linked"
    return
  fi
  if [[ -e "$dst" ]]; then
    local backup="$dst.backup.$(date +%Y%m%d_%H%M%S)"
    warn "Existing $name found; backing up to $(basename "$backup")"
    mv "$dst" "$backup"
  fi
  ln -s "$src" "$dst"
  echo "    linked $name"
}
link_into_hs "$HAMMERSPOON_SRC/voice-prompt.lua" voice-prompt.lua

# voice-prompt-env.lua: copy the example only if no env file exists. Users edit
# the live copy with their own paths/preferences; we never overwrite it.
ENV_DST="$HAMMERSPOON_DIR/voice-prompt-env.lua"
if [[ -f "$ENV_DST" ]]; then
  echo "    voice-prompt-env.lua already exists (keeping local edits)"
else
  cp "$HAMMERSPOON_SRC/voice-prompt-env.lua.example" "$ENV_DST"
  echo "    seeded voice-prompt-env.lua from example"
fi

# --------------------------------------------------------------------
# 5. init.lua wiring
# --------------------------------------------------------------------
INIT="$HAMMERSPOON_DIR/init.lua"
INIT_MARKER="BEGIN opencode-voice block"

read -r -d '' INIT_BLOCK <<'LUA' || true
-- BEGIN opencode-voice block (managed by opencode-voice/install.sh)
require("hs.ipc")  -- enables `hs -c "..."` from the shell
local vp = require("voice-prompt")
vp.setEnv(require("voice-prompt-env"))
vp.startHoldMode()  -- hold right-Option to record. swap for vp.startToggleMode() for cmd+shift+space toggle
-- END opencode-voice block
LUA

if [[ ! -f "$INIT" ]]; then
  say "Creating ~/.hammerspoon/init.lua"
  printf '%s\n' "$INIT_BLOCK" > "$INIT"
elif grep -F -q -- "$INIT_MARKER" "$INIT"; then
  echo "    init.lua already wired (block present)"
elif grep -F -q -- 'require("voice-prompt")' "$INIT" || grep -F -q -- "require('voice-prompt')" "$INIT"; then
  warn "init.lua already calls require(\"voice-prompt\") outside the managed block."
  warn "Skipping append to avoid double-loading. Remove the manual block to let the installer manage it."
else
  say "Appending voice-prompt block to existing init.lua"
  printf '\n%s\n' "$INIT_BLOCK" >> "$INIT"
fi

# --------------------------------------------------------------------
# 6. work dir
# --------------------------------------------------------------------
mkdir -p "$WORK_DIR"

# --------------------------------------------------------------------
# 7. reload Hammerspoon if running
# --------------------------------------------------------------------
if pgrep -x Hammerspoon >/dev/null; then
  say "Reloading Hammerspoon"
  # `hs.reload()` invalidates the message port mid-call, so the exit code is
  # always nonzero. Suppress and trust the reload happened (verified below).
  hs -c "hs.reload()" >/dev/null 2>&1 || true
  sleep 1
  if hs -c 'print("ok")' >/dev/null 2>&1; then
    echo "    Hammerspoon reloaded"
  else
    warn "Hammerspoon CLI unreachable after reload. Reload manually from the menu bar if voice-prompt isn't responding."
  fi
else
  say "Launching Hammerspoon"
  open -a Hammerspoon
fi

# --------------------------------------------------------------------
# 8. final notes
# --------------------------------------------------------------------
cat <<'EOF'

Done. One-time macOS permissions remain:

  1. Accessibility (for the global hotkey)
     System Settings → Privacy & Security → Accessibility → enable Hammerspoon

  2. Microphone (for sox)
     macOS will prompt the first time you record. Click Allow.

  3. Automation (for the new-Terminal popup)
     macOS will prompt the first time the pipeline runs. Click OK.

Usage: hold right-Option, speak, release. A new Terminal window opens straight
into the opencode TUI with your prompt as the first message.

Edit ~/.hammerspoon/voice-prompt-env.lua to change the working dir or pin a model.
EOF