happy-stacks 0.1.0 → 0.2.0

package/extras/swiftbar/happy-stacks.5s.sh

@@ -17,7 +17,46 @@
 # Configuration
 # ============================================================================
 
-HAPPY_STACKS_HOME_DIR="${HAPPY_STACKS_HOME_DIR:-$HOME/.happy-stacks}"
+# SwiftBar runs with a minimal environment, so users often won't have
+# HAPPY_STACKS_HOME_DIR / HAPPY_STACKS_WORKSPACE_DIR exported.
+# Treat <canonicalHomeDir>/.env as the canonical pointer file (written by `happys init`).
+# Default: ~/.happy-stacks/.env
+CANONICAL_HOME_DIR="${HAPPY_STACKS_CANONICAL_HOME_DIR:-${HAPPY_LOCAL_CANONICAL_HOME_DIR:-$HOME/.happy-stacks}}"
+CANONICAL_ENV_FILE="$CANONICAL_HOME_DIR/.env"
+
+_dotenv_get_quick() {
+  # Usage: _dotenv_get_quick /path/to/env KEY
+  local file="$1"
+  local key="$2"
+  [[ -n "$file" && -n "$key" && -f "$file" ]] || return 0
+  local line
+  line="$(grep -E "^${key}=" "$file" 2>/dev/null | head -n 1 || true)"
+  [[ -n "$line" ]] || return 0
+  local v="${line#*=}"
+  v="${v%$'\r'}"
+  # Strip simple surrounding quotes.
+  if [[ "$v" == \"*\" && "$v" == *\" ]]; then v="${v#\"}"; v="${v%\"}"; fi
+  if [[ "$v" == \'*\' && "$v" == *\' ]]; then v="${v#\'}"; v="${v%\'}"; fi
+  echo "$v"
+}
+
+_expand_home_quick() {
+  local p="$1"
+  if [[ "$p" == "~/"* ]]; then
+    echo "$HOME/${p#~/}"
+  else
+    echo "$p"
+  fi
+}
+
+_home_from_canonical=""
+if [[ -f "$CANONICAL_ENV_FILE" ]]; then
+  _home_from_canonical="$(_dotenv_get_quick "$CANONICAL_ENV_FILE" "HAPPY_STACKS_HOME_DIR")"
+  [[ -z "$_home_from_canonical" ]] && _home_from_canonical="$(_dotenv_get_quick "$CANONICAL_ENV_FILE" "HAPPY_LOCAL_HOME_DIR")"
+fi
+_home_from_canonical="$(_expand_home_quick "${_home_from_canonical:-}")"
+
+HAPPY_STACKS_HOME_DIR="${HAPPY_STACKS_HOME_DIR:-${_home_from_canonical:-$CANONICAL_HOME_DIR}}"
 HAPPY_LOCAL_DIR="${HAPPY_LOCAL_DIR:-$HAPPY_STACKS_HOME_DIR}"
 HAPPY_LOCAL_PORT="${HAPPY_LOCAL_PORT:-3005}"
 
@@ -26,17 +65,6 @@ if [[ -n "${HAPPY_STACKS_WT_TERMINAL:-}" && -z "${HAPPY_LOCAL_WT_TERMINAL:-}" ]]
 if [[ -n "${HAPPY_STACKS_WT_SHELL:-}" && -z "${HAPPY_LOCAL_WT_SHELL:-}" ]]; then HAPPY_LOCAL_WT_SHELL="$HAPPY_STACKS_WT_SHELL"; fi
 if [[ -n "${HAPPY_STACKS_SWIFTBAR_ICON_PATH:-}" && -z "${HAPPY_LOCAL_SWIFTBAR_ICON_PATH:-}" ]]; then HAPPY_LOCAL_SWIFTBAR_ICON_PATH="$HAPPY_STACKS_SWIFTBAR_ICON_PATH"; fi
 
-# Storage root migrated from ~/.happy/local -> ~/.happy/stacks/main.
-if [[ -z "${HAPPY_HOME_DIR:-}" ]]; then
-  if [[ -d "$HOME/.happy/stacks/main" ]] || [[ ! -d "$HOME/.happy/local" ]]; then
-    HAPPY_HOME_DIR="$HOME/.happy/stacks/main"
-  else
-    HAPPY_HOME_DIR="$HOME/.happy/local"
-  fi
-fi
-CLI_HOME_DIR="$HAPPY_HOME_DIR/cli"
-LOGS_DIR="$HAPPY_HOME_DIR/logs"
-
 # Colors
 GREEN="#34C759"
 RED="#FF3B30"
@@ -78,11 +106,24 @@ PNPM_BIN="$(resolve_pnpm_bin)"
 MAIN_PORT="$(resolve_main_port)"
 MAIN_SERVER_COMPONENT="$(resolve_main_server_component)"
 TAILSCALE_URL="$(get_tailscale_url)"
+if swiftbar_is_sandboxed; then
+  # Never probe Tailscale (global machine state) when sandboxing.
+  TAILSCALE_URL=""
+fi
 MAIN_ENV_FILE="$(resolve_main_env_file)"
+MENUBAR_MODE="$(resolve_menubar_mode)"
 
 ensure_launchctl_cache
 
-MAIN_COLLECT="$(collect_stack_status "$MAIN_PORT" "$CLI_HOME_DIR" "com.happy.stacks" "$HAPPY_HOME_DIR")"
+if [[ -z "$MAIN_ENV_FILE" ]]; then
+  MAIN_ENV_FILE="$(resolve_stack_env_file main)"
+fi
+HAPPY_HOME_DIR="$(resolve_stack_base_dir main "$MAIN_ENV_FILE")"
+CLI_HOME_DIR="$(resolve_stack_cli_home_dir main "$MAIN_ENV_FILE")"
+LOGS_DIR="$HAPPY_HOME_DIR/logs"
+MAIN_LABEL="$(resolve_stack_label main)"
+
+MAIN_COLLECT="$(collect_stack_status "$MAIN_PORT" "$CLI_HOME_DIR" "$MAIN_LABEL" "$HAPPY_HOME_DIR")"
 IFS=$'\t' read -r MAIN_LEVEL MAIN_SERVER_STATUS MAIN_SERVER_PID MAIN_SERVER_METRICS MAIN_DAEMON_STATUS MAIN_DAEMON_PID MAIN_DAEMON_METRICS MAIN_DAEMON_UPTIME MAIN_LAST_HEARTBEAT MAIN_LAUNCHAGENT_STATUS MAIN_AUTOSTART_PID MAIN_AUTOSTART_METRICS <<<"$MAIN_COLLECT"
 for v in MAIN_SERVER_PID MAIN_SERVER_METRICS MAIN_DAEMON_PID MAIN_DAEMON_METRICS MAIN_DAEMON_UPTIME MAIN_LAST_HEARTBEAT MAIN_AUTOSTART_PID MAIN_AUTOSTART_METRICS; do
   if [[ "${!v}" == "-" ]]; then
@@ -108,95 +149,144 @@ echo "---"
 echo "Happy Stacks | size=14 font=SF Pro Display"
 echo "---"
 
+# Mode (selfhost vs dev)
+if [[ "$MENUBAR_MODE" == "selfhost" ]]; then
+  echo "Mode: Selfhost | sfimage=house"
+else
+  echo "Mode: Dev | sfimage=hammer"
+fi
+if [[ -n "$PNPM_BIN" ]]; then
+  if [[ "$MENUBAR_MODE" == "selfhost" ]]; then
+    echo "--Switch to Dev mode | bash=$PNPM_BIN param1=menubar param2=mode param3=dev dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
+  else
+    echo "--Switch to Selfhost mode | bash=$PNPM_BIN param1=menubar param2=mode param3=selfhost dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
+  fi
+fi
+echo "---"
+
 # Main stack (inline)
 echo "Main stack"
 echo "---"
 export MAIN_LEVEL="$MAIN_LEVEL"
-render_stack_info "" "main" "$MAIN_PORT" "$MAIN_SERVER_COMPONENT" "$HAPPY_HOME_DIR" "$CLI_HOME_DIR" "com.happy.stacks" "$MAIN_ENV_FILE" "$TAILSCALE_URL"
-render_component_server "" "main" "$MAIN_PORT" "$MAIN_SERVER_COMPONENT" "$MAIN_SERVER_STATUS" "$MAIN_SERVER_PID" "$MAIN_SERVER_METRICS" "$TAILSCALE_URL" "com.happy.stacks"
+render_stack_info "" "main" "$MAIN_PORT" "$MAIN_SERVER_COMPONENT" "$HAPPY_HOME_DIR" "$CLI_HOME_DIR" "$MAIN_LABEL" "$MAIN_ENV_FILE" "$TAILSCALE_URL"
+render_component_server "" "main" "$MAIN_PORT" "$MAIN_SERVER_COMPONENT" "$MAIN_SERVER_STATUS" "$MAIN_SERVER_PID" "$MAIN_SERVER_METRICS" "$TAILSCALE_URL" "$MAIN_LABEL"
 render_component_daemon "" "$MAIN_DAEMON_STATUS" "$MAIN_DAEMON_PID" "$MAIN_DAEMON_METRICS" "$MAIN_DAEMON_UPTIME" "$MAIN_LAST_HEARTBEAT" "$CLI_HOME_DIR/daemon.state.json" "main"
-render_component_autostart "" "main" "com.happy.stacks" "$MAIN_LAUNCHAGENT_STATUS" "$MAIN_AUTOSTART_PID" "$MAIN_AUTOSTART_METRICS" "$LOGS_DIR"
+render_component_autostart "" "main" "$MAIN_LABEL" "$MAIN_LAUNCHAGENT_STATUS" "$MAIN_AUTOSTART_PID" "$MAIN_AUTOSTART_METRICS" "$LOGS_DIR"
 render_component_tailscale "" "main" "$TAILSCALE_URL"
 
 echo "---"
-echo "Stacks"
-echo "---"
+if [[ "$MENUBAR_MODE" == "selfhost" ]]; then
+  echo "Maintenance | sfimage=wrench.and.screwdriver"
+  if [[ -n "$PNPM_BIN" ]]; then
+    UPDATE_JSON="${HAPPY_LOCAL_DIR}/cache/update.json"
+    update_available=""
+    latest=""
+    current=""
+    if [[ -f "$UPDATE_JSON" ]]; then
+      update_available="$(grep -oE '\"updateAvailable\"[[:space:]]*:[[:space:]]*(true|false)' "$UPDATE_JSON" 2>/dev/null | head -1 | grep -oE '(true|false)' || true)"
+      latest="$(grep -oE '\"latest\"[[:space:]]*:[[:space:]]*\"[^\"]+\"' "$UPDATE_JSON" 2>/dev/null | head -1 | sed -E 's/.*\"latest\"[[:space:]]*:[[:space:]]*\"([^\"]+)\".*/\\1/' || true)"
+      current="$(grep -oE '\"current\"[[:space:]]*:[[:space:]]*\"[^\"]+\"' "$UPDATE_JSON" 2>/dev/null | head -1 | sed -E 's/.*\"current\"[[:space:]]*:[[:space:]]*\"([^\"]+)\".*/\\1/' || true)"
+    fi
+    if [[ "$update_available" == "true" && -n "$latest" ]]; then
+      echo "--Update available: ${current:-current} → ${latest} | color=$YELLOW"
+    else
+      echo "--Updates: up to date | color=$GRAY"
+    fi
+    echo "--Check for updates | bash=$PNPM_BIN param1=self param2=check dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
+    echo "--Update happy-stacks runtime | bash=$PNPM_BIN param1=self param2=update dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
+    echo "--Doctor | bash=$PNPM_BIN param1=doctor dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
+  else
+    echo "--⚠️ happys not found (run: npx happy-stacks setup)" 
+  fi
+else
+  echo "Stacks | sfimage=server.rack"
+  STACKS_PREFIX="--"
 
-if [[ -n "$PNPM_BIN" ]]; then
-  PNPM_TERM="$HAPPY_LOCAL_DIR/extras/swiftbar/pnpm-term.sh"
-  echo "New stack (interactive) | bash=$PNPM_TERM param1=stack param2=new param3=--interactive dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
-  echo "List stacks | bash=$PNPM_TERM param1=stack param2=list dir=$HAPPY_LOCAL_DIR terminal=false"
-  echo "---"
-fi
+  if [[ -n "$PNPM_BIN" ]]; then
+    HAPPYS_TERM="$HAPPY_LOCAL_DIR/extras/swiftbar/happys-term.sh"
+    echo "${STACKS_PREFIX}New stack (interactive) | bash=$HAPPYS_TERM param1=stack param2=new param3=--interactive dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
+    echo "${STACKS_PREFIX}List stacks | bash=$HAPPYS_TERM param1=stack param2=list dir=$HAPPY_LOCAL_DIR terminal=false"
+    print_sep "$STACKS_PREFIX"
+  fi
 
-STACKS_DIR="$HOME/.happy/stacks"
-if [[ -d "$STACKS_DIR" ]]; then
-  STACK_NAMES="$(ls -1 "$STACKS_DIR" 2>/dev/null || true)"
-  if [[ -z "$STACK_NAMES" ]]; then
-    echo "No stacks found | color=$GRAY"
+  STACKS_DIR="$(resolve_stacks_storage_root)"
+  LEGACY_STACKS_DIR="$HOME/.happy/local/stacks"
+  if swiftbar_is_sandboxed; then
+    LEGACY_STACKS_DIR=""
   fi
-  for s in $STACK_NAMES; do
-    env_file="$STACKS_DIR/$s/env"
-    [[ -f "$env_file" ]] || continue
+  if [[ -d "$STACKS_DIR" ]] || [[ -n "$LEGACY_STACKS_DIR" && -d "$LEGACY_STACKS_DIR" ]]; then
+    STACK_NAMES="$(
+      {
+        ls -1 "$STACKS_DIR" 2>/dev/null || true
+        [[ -n "$LEGACY_STACKS_DIR" ]] && ls -1 "$LEGACY_STACKS_DIR" 2>/dev/null || true
+      } | sort -u
+    )"
+    if [[ -z "$STACK_NAMES" ]]; then
+      echo "${STACKS_PREFIX}No stacks found | color=$GRAY"
+    fi
+    for s in $STACK_NAMES; do
+      env_file="$(resolve_stack_env_file "$s")"
+      [[ -f "$env_file" ]] || continue
 
-    port="$(dotenv_get "$env_file" "HAPPY_LOCAL_SERVER_PORT")"
-    [[ -n "$port" ]] || continue
+      # Ports may be ephemeral (runtime-only). Do not skip stacks if the env file does not pin a port.
+      port="$(resolve_stack_server_port "$s" "$env_file")"
 
-    server_component="$(dotenv_get "$env_file" "HAPPY_LOCAL_SERVER_COMPONENT")"
-    [[ -n "$server_component" ]] || server_component="happy-server-light"
+      server_component="$(dotenv_get "$env_file" "HAPPY_STACKS_SERVER_COMPONENT")"
+      [[ -z "$server_component" ]] && server_component="$(dotenv_get "$env_file" "HAPPY_LOCAL_SERVER_COMPONENT")"
+      [[ -n "$server_component" ]] || server_component="happy-server-light"
 
-    cli_home_dir="$(dotenv_get "$env_file" "HAPPY_LOCAL_CLI_HOME_DIR")"
-    [[ -n "$cli_home_dir" ]] || cli_home_dir="$STACKS_DIR/$s/cli"
+      base_dir="$(resolve_stack_base_dir "$s" "$env_file")"
+      cli_home_dir="$(resolve_stack_cli_home_dir "$s" "$env_file")"
+      label="$(resolve_stack_label "$s")"
 
-    base_dir="$STACKS_DIR/$s"
-    label="com.happy.stacks.$s"
+      COLLECT="$(collect_stack_status "$port" "$cli_home_dir" "$label" "$base_dir")"
+      IFS=$'\t' read -r LEVEL SERVER_STATUS SERVER_PID SERVER_METRICS DAEMON_STATUS DAEMON_PID DAEMON_METRICS DAEMON_UPTIME LAST_HEARTBEAT LAUNCHAGENT_STATUS AUTOSTART_PID AUTOSTART_METRICS <<<"$COLLECT"
+      for v in SERVER_PID SERVER_METRICS DAEMON_PID DAEMON_METRICS DAEMON_UPTIME LAST_HEARTBEAT AUTOSTART_PID AUTOSTART_METRICS; do
+        if [[ "${!v}" == "-" ]]; then
+          printf -v "$v" '%s' ""
+        fi
+      done
 
-    COLLECT="$(collect_stack_status "$port" "$cli_home_dir" "$label" "$base_dir")"
-    IFS=$'\t' read -r LEVEL SERVER_STATUS SERVER_PID SERVER_METRICS DAEMON_STATUS DAEMON_PID DAEMON_METRICS DAEMON_UPTIME LAST_HEARTBEAT LAUNCHAGENT_STATUS AUTOSTART_PID AUTOSTART_METRICS <<<"$COLLECT"
-    for v in SERVER_PID SERVER_METRICS DAEMON_PID DAEMON_METRICS DAEMON_UPTIME LAST_HEARTBEAT AUTOSTART_PID AUTOSTART_METRICS; do
-      if [[ "${!v}" == "-" ]]; then
-        printf -v "$v" '%s' ""
-      fi
+      render_stack_overview_item "Stack: $s" "$LEVEL" "$STACKS_PREFIX"
+      export STACK_LEVEL="$LEVEL"
+      render_stack_info "${STACKS_PREFIX}--" "$s" "$port" "$server_component" "$base_dir" "$cli_home_dir" "$label" "$env_file" ""
+      render_component_server "${STACKS_PREFIX}--" "$s" "$port" "$server_component" "$SERVER_STATUS" "$SERVER_PID" "$SERVER_METRICS" "" "$label"
+      render_component_daemon "${STACKS_PREFIX}--" "$DAEMON_STATUS" "$DAEMON_PID" "$DAEMON_METRICS" "$DAEMON_UPTIME" "$LAST_HEARTBEAT" "$cli_home_dir/daemon.state.json" "$s"
+      render_component_autostart "${STACKS_PREFIX}--" "$s" "$label" "$LAUNCHAGENT_STATUS" "$AUTOSTART_PID" "$AUTOSTART_METRICS" "$base_dir/logs"
+      render_component_tailscale "${STACKS_PREFIX}--" "$s" ""
+      render_components_menu "${STACKS_PREFIX}--" "stack" "$s" "$env_file"
     done
+  else
+    echo "${STACKS_PREFIX}No stacks dir found at: $(shorten_path "$STACKS_DIR" 52) | color=$GRAY"
+  fi
 
-    render_stack_overview_item "Stack: $s" "$LEVEL" ""
-    export STACK_LEVEL="$LEVEL"
-    render_stack_info "--" "$s" "$port" "$server_component" "$base_dir" "$cli_home_dir" "$label" "$env_file" ""
-    render_component_server "--" "$s" "$port" "$server_component" "$SERVER_STATUS" "$SERVER_PID" "$SERVER_METRICS" "" "$label"
-    render_component_daemon "--" "$DAEMON_STATUS" "$DAEMON_PID" "$DAEMON_METRICS" "$DAEMON_UPTIME" "$LAST_HEARTBEAT" "$cli_home_dir/daemon.state.json" "$s"
-    render_component_autostart "--" "$s" "$label" "$LAUNCHAGENT_STATUS" "$AUTOSTART_PID" "$AUTOSTART_METRICS" "$base_dir/logs"
-    render_component_tailscale "--" "$s" ""
-    render_components_menu "--" "stack" "$s" "$env_file"
-  done
-else
-  echo "No stacks dir found at ~/.happy/stacks | color=$GRAY"
-fi
-
-echo "---"
-render_components_menu "" "main" "main" ""
+  echo "---"
+  render_components_menu "" "main" "main" "$MAIN_ENV_FILE"
 
-echo "Worktrees | sfimage=arrow.triangle.branch"
-if [[ -z "$PNPM_BIN" ]]; then
-  echo "--⚠️ happys not found (run: npx happy-stacks init, or install happy-stacks globally)"
-else
-  PNPM_TERM="$HAPPY_LOCAL_DIR/extras/swiftbar/pnpm-term.sh"
-  echo "--Use (interactive) | bash=$PNPM_TERM param1=wt param2=use param3=--interactive dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
-  echo "--New (interactive) | bash=$PNPM_TERM param1=wt param2=new param3=--interactive dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
-  echo "--PR worktree (prompt) | bash=$HAPPY_LOCAL_DIR/extras/swiftbar/wt-pr.sh dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
-  echo "--Sync mirrors (all) | bash=$PNPM_BIN param1=wt param2=sync-all dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
-  echo "--Update all (dry-run) | bash=$PNPM_TERM param1=wt param2=update-all param3=--dry-run dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
-  echo "--Update all (apply) | bash=$PNPM_BIN param1=wt param2=update-all dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
-fi
+  echo "Worktrees | sfimage=arrow.triangle.branch"
+  if [[ -z "$PNPM_BIN" ]]; then
+    echo "--⚠️ happys not found (run: npx happy-stacks setup)"
+  else
+    HAPPYS_TERM="$HAPPY_LOCAL_DIR/extras/swiftbar/happys-term.sh"
+    echo "--Use (interactive) | bash=$HAPPYS_TERM param1=wt param2=use param3=--interactive dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
+    echo "--New (interactive) | bash=$HAPPYS_TERM param1=wt param2=new param3=--interactive dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
+    echo "--PR worktree (prompt) | bash=$HAPPY_LOCAL_DIR/extras/swiftbar/wt-pr.sh dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
+    echo "--Sync mirrors (all) | bash=$PNPM_BIN param1=wt param2=sync-all dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
+    echo "--Update all (dry-run) | bash=$HAPPYS_TERM param1=wt param2=update-all param3=--dry-run dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
+    echo "--Update all (apply) | bash=$PNPM_BIN param1=wt param2=update-all dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
+  fi
 
-echo "---"
-echo "Setup / Tools"
-if [[ -z "$PNPM_BIN" ]]; then
-  echo "--⚠️ happys not found (run: npx happy-stacks init, or install happy-stacks globally)"
-else
-  PNPM_TERM="$HAPPY_LOCAL_DIR/extras/swiftbar/pnpm-term.sh"
-  echo "--Bootstrap (clone/install) | bash=$PNPM_TERM param1=bootstrap dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
-  echo "--CLI link (install happy wrapper) | bash=$PNPM_TERM param1=cli:link dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
-  echo "--Mobile dev helper | bash=$PNPM_TERM param1=mobile dir=$HAPPY_LOCAL_DIR terminal=false"
+  echo "---"
+  echo "Setup / Tools"
+  if [[ -z "$PNPM_BIN" ]]; then
+    echo "--⚠️ happys not found (run: npx happy-stacks setup)"
+  else
+    HAPPYS_TERM="$HAPPY_LOCAL_DIR/extras/swiftbar/happys-term.sh"
+    echo "--Setup (guided) | bash=$HAPPYS_TERM param1=setup dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
+    echo "--Bootstrap (clone/install) | bash=$HAPPYS_TERM param1=bootstrap dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
+    echo "--CLI link (install happy wrapper) | bash=$HAPPYS_TERM param1=cli:link dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
+    echo "--Mobile dev helper | bash=$HAPPYS_TERM param1=mobile dir=$HAPPY_LOCAL_DIR terminal=false"
+  fi
 fi
 
 echo "---"
@@ -215,4 +305,6 @@ echo "--1h | bash=$SET_INTERVAL param1=1h dir=$HAPPY_LOCAL_DIR terminal=false re
 echo "--2h | bash=$SET_INTERVAL param1=2h dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
 echo "--6h | bash=$SET_INTERVAL param1=6h dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
 echo "--12h | bash=$SET_INTERVAL param1=12h dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
-echo "--1d | bash=$SET_INTERVAL param1=1d dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"exit 0
+echo "--1d | bash=$SET_INTERVAL param1=1d dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
+
+exit 0

package/extras/swiftbar/happys-term.sh

@@ -0,0 +1,128 @@
+#!/bin/bash
+set -euo pipefail
+
+# Open preferred terminal and run a happys command.
+#
+# Preference order follows wt shell semantics:
+# - HAPPY_LOCAL_WT_TERMINAL=ghostty|iterm|terminal|current
+#   (also accepts "auto" which tries ghostty->iterm->terminal->current)
+#
+# Notes:
+# - iTerm / Terminal: we run the command automatically via AppleScript.
+# - Ghostty: best-effort; if we can't run the command, we open Ghostty in the dir and copy the command to clipboard.
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+DEFAULT_HOME_DIR="$(cd "$SCRIPT_DIR/../.." && pwd)"
+
+# Prefer explicit env vars, but default to the install location inferred from this script path.
+CANONICAL_HOME_DIR="${HAPPY_STACKS_CANONICAL_HOME_DIR:-${HAPPY_LOCAL_CANONICAL_HOME_DIR:-$DEFAULT_HOME_DIR}}"
+HAPPY_LOCAL_DIR="${HAPPY_LOCAL_DIR:-${HAPPY_STACKS_HOME_DIR:-$CANONICAL_HOME_DIR}}"
+HAPPY_STACKS_HOME_DIR="${HAPPY_STACKS_HOME_DIR:-$HAPPY_LOCAL_DIR}"
+
+# Use shared resolver for workspace dir (respects HAPPY_STACKS_WORKSPACE_DIR and canonical pointer env).
+LIB_DIR="$HAPPY_LOCAL_DIR/extras/swiftbar/lib"
+if [[ -f "$LIB_DIR/utils.sh" ]]; then
+  # shellcheck source=/dev/null
+  source "$LIB_DIR/utils.sh"
+fi
+
+WORKDIR="${HAPPY_STACKS_WORKSPACE_DIR:-$(resolve_workspace_dir 2>/dev/null || true)}"
+[[ -z "$WORKDIR" ]] && WORKDIR="$HAPPY_STACKS_HOME_DIR/workspace"
+if [[ ! -d "$WORKDIR" ]]; then
+  WORKDIR="$HOME"
+fi
+
+HAPPYS_SH="$HAPPY_LOCAL_DIR/extras/swiftbar/happys.sh"
+if [[ ! -x "$HAPPYS_SH" ]]; then
+  echo "missing happys wrapper: $HAPPYS_SH" >&2
+  exit 1
+fi
+
+pref_raw="$(echo "${HAPPY_STACKS_WT_TERMINAL:-${HAPPY_LOCAL_WT_TERMINAL:-auto}}" | tr '[:upper:]' '[:lower:]')"
+pref="$pref_raw"
+if [[ "$pref" == "" ]]; then pref="auto"; fi
+
+cmd=( "$HAPPYS_SH" "$@" )
+
+escape_for_osascript_string() {
+  local s="$1"
+  s="${s//\\/\\\\}"
+  s="${s//\"/\\\"}"
+  echo "$s"
+}
+
+shell_cmd() {
+  local joined=""
+  local q
+  joined="cd \"${WORKDIR//\"/\\\"}\"; "
+  for q in "${cmd[@]}"; do
+    local escaped
+    escaped="$(printf "%s" "$q" | sed "s/'/'\\\\''/g")"
+    joined+="'${escaped}' "
+  done
+  joined+="; echo; echo \"[happy-stacks] done\"; exec /bin/zsh -i"
+  echo "$joined"
+}
+
+run_iterm() {
+  if ! command -v osascript >/dev/null 2>&1; then
+    return 1
+  fi
+  local s
+  s="$(shell_cmd)"
+  s="$(escape_for_osascript_string "$s")"
+  osascript \
+    -e 'tell application "iTerm" to activate' \
+    -e 'tell application "iTerm" to create window with default profile' \
+    -e "tell application \"iTerm\" to tell current session of current window to write text \"${s}\"" >/dev/null
+}
+
+run_terminal_app() {
+  if ! command -v osascript >/dev/null 2>&1; then
+    return 1
+  fi
+  local s
+  s="$(shell_cmd)"
+  s="$(escape_for_osascript_string "$s")"
+  osascript \
+    -e 'tell application "Terminal" to activate' \
+    -e "tell application \"Terminal\" to do script \"${s}\"" >/dev/null
+}
+
+run_ghostty() {
+  if ! command -v ghostty >/dev/null 2>&1; then
+    return 1
+  fi
+
+  local s
+  s="$(shell_cmd)"
+  if ghostty --working-directory "$WORKDIR" -e /bin/zsh -lc "$s" >/dev/null 2>&1; then
+    return 0
+  fi
+
+  echo -n "$s" | pbcopy 2>/dev/null || true
+  ghostty --working-directory "$WORKDIR" >/dev/null 2>&1 || true
+  return 0
+}
+
+try_one() {
+  local t="$1"
+  case "$t" in
+    ghostty) run_ghostty ;;
+    iterm) run_iterm ;;
+    terminal) run_terminal_app ;;
+    current) ( cd "$WORKDIR"; exec "${cmd[@]}" ) ;;
+    *) return 1 ;;
+  esac
+}
+
+if [[ "$pref" == "auto" ]]; then
+  for t in ghostty iterm terminal current; do
+    if try_one "$t"; then
+      exit 0
+    fi
+  done
+  exit 1
+fi
+
+try_one "$pref"

package/extras/swiftbar/happys.sh

@@ -0,0 +1,35 @@
+#!/bin/bash
+set -euo pipefail
+
+# SwiftBar menu action wrapper.
+# Runs `happys` using the stable shim installed under <homeDir>/bin.
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+DEFAULT_HOME_DIR="$(cd "$SCRIPT_DIR/../.." && pwd)"
+
+# Treat presence of HAPPY_STACKS_SANDBOX_DIR as sandbox mode.
+is_sandboxed() {
+  [[ -n "${HAPPY_STACKS_SANDBOX_DIR:-}" ]]
+}
+
+# Prefer explicit env vars, but default to the install location inferred from this script path.
+CANONICAL_HOME_DIR="${HAPPY_STACKS_CANONICAL_HOME_DIR:-${HAPPY_LOCAL_CANONICAL_HOME_DIR:-$DEFAULT_HOME_DIR}}"
+HAPPY_LOCAL_DIR="${HAPPY_LOCAL_DIR:-${HAPPY_STACKS_HOME_DIR:-$CANONICAL_HOME_DIR}}"
+HAPPY_STACKS_HOME_DIR="${HAPPY_STACKS_HOME_DIR:-$HAPPY_LOCAL_DIR}"
+
+HAPPYS_BIN="$HAPPY_LOCAL_DIR/bin/happys"
+if [[ ! -x "$HAPPYS_BIN" ]]; then
+  if is_sandboxed; then
+    echo "happys not found in sandbox home: $HAPPYS_BIN" >&2
+    echo "Tip: re-run: happys init (inside the sandbox) then re-install the menubar plugin." >&2
+    exit 1
+  fi
+  HAPPYS_BIN="$(command -v happys 2>/dev/null || true)"
+fi
+
+if [[ -z "${HAPPYS_BIN:-}" ]]; then
+  echo "happys not found (run: npx happy-stacks init, or npm i -g happy-stacks)" >&2
+  exit 1
+fi
+
+exec "$HAPPYS_BIN" "$@"

package/extras/swiftbar/install.sh

@@ -13,7 +13,19 @@ PLUGIN_SOURCE="$SCRIPT_DIR/happy-stacks.5s.sh"
 # You can override:
 #   HAPPY_LOCAL_SWIFTBAR_INTERVAL=30s ./install.sh
 PLUGIN_INTERVAL="${HAPPY_STACKS_SWIFTBAR_INTERVAL:-${HAPPY_LOCAL_SWIFTBAR_INTERVAL:-5m}}"
-PLUGIN_FILE="happy-stacks.${PLUGIN_INTERVAL}.sh"
+PLUGIN_BASENAME="${HAPPY_STACKS_SWIFTBAR_PLUGIN_BASENAME:-happy-stacks}"
+PLUGIN_FILE="${PLUGIN_BASENAME}.${PLUGIN_INTERVAL}.sh"
+
+# Optional: install a wrapper plugin instead of copying the source.
+# This is useful for sandbox/test installs so the plugin can be pinned to a specific home/canonical dir
+# even under SwiftBar's minimal environment.
+WRAPPER="${HAPPY_STACKS_SWIFTBAR_PLUGIN_WRAPPER:-0}"
+
+escape_single_quotes() {
+  # Escape a string so it can be safely embedded inside single quotes in a bash script.
+  # e.g. abc'def -> abc'"'"'def
+  printf "%s" "$1" | sed "s/'/'\"'\"'/g"
+}
 
 FORCE=0
 for arg in "$@"; do
@@ -128,33 +140,107 @@ echo -e "${YELLOW}Step 3: Installing Happy Stacks plugin...${NC}"
 
 PLUGIN_DEST="$PLUGINS_DIR/$PLUGIN_FILE"
 
-# Remove any legacy happy-local plugins to avoid duplicates.
-rm -f "$PLUGINS_DIR"/happy-local.*.sh 2>/dev/null || true
+# Remove any legacy happy-local plugins to avoid duplicates *only* for the primary plugin.
+# For sandbox installs (separate basenames), never delete other plugins.
+if [[ "$PLUGIN_BASENAME" == "happy-stacks" ]]; then
+    rm -f "$PLUGINS_DIR"/happy-local.*.sh 2>/dev/null || true
+fi
 
+EXISTED=0
 if [[ -f "$PLUGIN_DEST" ]]; then
+    EXISTED=1
+fi
+
+SHOULD_INSTALL=1
+if [[ "$EXISTED" == "1" ]]; then
     echo "Plugin already exists at $PLUGIN_DEST"
     if [[ "$FORCE" == "1" ]] || [[ ! -t 0 ]]; then
-        cp "$PLUGIN_SOURCE" "$PLUGIN_DEST"
-        chmod +x "$PLUGIN_DEST"
-        echo -e "${GREEN}✓ Plugin updated${NC}"
+        SHOULD_INSTALL=1
     else
         echo "Would you like to overwrite it? (y/n)"
         read -r OVERWRITE_CHOICE
-        
         if [[ "$OVERWRITE_CHOICE" != "y" ]] && [[ "$OVERWRITE_CHOICE" != "Y" ]]; then
+            SHOULD_INSTALL=0
             echo "Skipping plugin installation."
+        fi
+    fi
+fi
+
+if [[ "$SHOULD_INSTALL" == "1" ]]; then
+    if [[ "$WRAPPER" == "1" ]]; then
+        # Generate a wrapper plugin that pins env vars and executes the real plugin source.
+        HOME_DIR_VAL="${HAPPY_STACKS_HOME_DIR:-${HAPPY_LOCAL_DIR:-$HOME/.happy-stacks}}"
+        CANONICAL_DIR_VAL="${HAPPY_STACKS_CANONICAL_HOME_DIR:-${HAPPY_LOCAL_CANONICAL_HOME_DIR:-$HOME/.happy-stacks}}"
+        SANDBOX_DIR_VAL="${HAPPY_STACKS_SANDBOX_DIR:-}"
+        WORKSPACE_DIR_VAL="${HAPPY_STACKS_WORKSPACE_DIR:-}"
+        RUNTIME_DIR_VAL="${HAPPY_STACKS_RUNTIME_DIR:-}"
+        STORAGE_DIR_VAL="${HAPPY_STACKS_STORAGE_DIR:-}"
+
+        if [[ -n "$SANDBOX_DIR_VAL" ]]; then
+          [[ -z "$WORKSPACE_DIR_VAL" ]] && WORKSPACE_DIR_VAL="${SANDBOX_DIR_VAL%/}/workspace"
+          [[ -z "$RUNTIME_DIR_VAL" ]] && RUNTIME_DIR_VAL="${SANDBOX_DIR_VAL%/}/runtime"
+          [[ -z "$STORAGE_DIR_VAL" ]] && STORAGE_DIR_VAL="${SANDBOX_DIR_VAL%/}/storage"
+        fi
+        HOME_DIR_ESC="$(escape_single_quotes "$HOME_DIR_VAL")"
+        CANONICAL_DIR_ESC="$(escape_single_quotes "$CANONICAL_DIR_VAL")"
+        SANDBOX_DIR_ESC="$(escape_single_quotes "$SANDBOX_DIR_VAL")"
+        WORKSPACE_DIR_ESC="$(escape_single_quotes "$WORKSPACE_DIR_VAL")"
+        RUNTIME_DIR_ESC="$(escape_single_quotes "$RUNTIME_DIR_VAL")"
+        STORAGE_DIR_ESC="$(escape_single_quotes "$STORAGE_DIR_VAL")"
+        SRC_ESC="$(escape_single_quotes "$PLUGIN_SOURCE")"
+        BASENAME_ESC="$(escape_single_quotes "$PLUGIN_BASENAME")"
+
+        cat >"$PLUGIN_DEST" <<EOF
+#!/bin/bash
+set -euo pipefail
+export HAPPY_STACKS_HOME_DIR='$HOME_DIR_ESC'
+export HAPPY_LOCAL_DIR='$HOME_DIR_ESC'
+export HAPPY_STACKS_CANONICAL_HOME_DIR='$CANONICAL_DIR_ESC'
+export HAPPY_LOCAL_CANONICAL_HOME_DIR='$CANONICAL_DIR_ESC'
+export HAPPY_STACKS_SWIFTBAR_PLUGIN_BASENAME='$BASENAME_ESC'
+export HAPPY_LOCAL_SWIFTBAR_PLUGIN_BASENAME='$BASENAME_ESC'
+if [[ -n '$SANDBOX_DIR_ESC' ]]; then
+  export HAPPY_STACKS_SANDBOX_DIR='$SANDBOX_DIR_ESC'
+fi
+if [[ -n '$WORKSPACE_DIR_ESC' ]]; then
+  export HAPPY_STACKS_WORKSPACE_DIR='$WORKSPACE_DIR_ESC'
+  export HAPPY_LOCAL_WORKSPACE_DIR='$WORKSPACE_DIR_ESC'
+fi
+if [[ -n '$RUNTIME_DIR_ESC' ]]; then
+  export HAPPY_STACKS_RUNTIME_DIR='$RUNTIME_DIR_ESC'
+  export HAPPY_LOCAL_RUNTIME_DIR='$RUNTIME_DIR_ESC'
+fi
+if [[ -n '$STORAGE_DIR_ESC' ]]; then
+  export HAPPY_STACKS_STORAGE_DIR='$STORAGE_DIR_ESC'
+  export HAPPY_LOCAL_STORAGE_DIR='$STORAGE_DIR_ESC'
+fi
+# Prevent any re-exec into a "real" install when testing.
+export HAPPY_STACKS_CLI_ROOT_DISABLE="1"
+exec '$SRC_ESC'
+EOF
+        chmod +x "$PLUGIN_DEST"
+        if [[ "$EXISTED" == "1" ]]; then
+            echo -e "${GREEN}✓ Plugin updated (wrapper)${NC}"
         else
-            cp "$PLUGIN_SOURCE" "$PLUGIN_DEST"
-            chmod +x "$PLUGIN_DEST"
+            echo -e "${GREEN}✓ Plugin installed (wrapper)${NC}"
+        fi
+    else
+        cp "$PLUGIN_SOURCE" "$PLUGIN_DEST"
+        chmod +x "$PLUGIN_DEST"
+        if [[ "$EXISTED" == "1" ]]; then
             echo -e "${GREEN}✓ Plugin updated${NC}"
+        else
+            echo -e "${GREEN}✓ Plugin installed${NC}"
         fi
     fi
-else
-    cp "$PLUGIN_SOURCE" "$PLUGIN_DEST"
-    chmod +x "$PLUGIN_DEST"
-    echo -e "${GREEN}✓ Plugin installed${NC}"
 fi
 
+#
+# Ensure helper scripts are executable (SwiftBar menu actions rely on this).
+# The repo usually tracks +x, but home installs can lose mode bits depending on how assets are copied.
+#
+chmod +x "$SCRIPT_DIR"/*.sh 2>/dev/null || true
+
 echo ""
 
 # Step 4: Launch SwiftBar if not running