happy-stacks 0.0.0

package/extras/swiftbar/lib/system.sh

@@ -0,0 +1,190 @@
+#!/bin/bash
+
+get_process_metrics() {
+  local pid="$1"
+  if [[ -z "$pid" ]]; then
+    echo ""
+    return
+  fi
+  # Output: cpu|mem_mb|etime
+  local line
+  line="$(ps -p "$pid" -o %cpu= -o rss= -o etime= 2>/dev/null | head -1 | tr -s ' ' | sed 's/^ //')"
+  if [[ -z "$line" ]]; then
+    echo ""
+    return
+  fi
+  local cpu rss etime
+  cpu="$(echo "$line" | awk '{print $1}')"
+  rss="$(echo "$line" | awk '{print $2}')" # KB
+  etime="$(echo "$line" | awk '{print $3}')"
+  local mem_mb
+  mem_mb="$(awk -v rss="$rss" 'BEGIN { printf "%.0f", (rss/1024.0) }')"
+  echo "$cpu|$mem_mb|$etime"
+}
+
+get_port_listener_pid() {
+  local port="$1"
+  if [[ -z "$port" ]]; then
+    echo ""
+    return
+  fi
+  if ! command -v lsof >/dev/null 2>&1; then
+    echo ""
+    return
+  fi
+  lsof -nP -iTCP:"$port" -sTCP:LISTEN -t 2>/dev/null | head -1 || true
+}
+
+# Cached launchctl output for speed across many stacks.
+LAUNCHCTL_LIST_CACHE=""
+
+ensure_launchctl_cache() {
+  if [[ -n "$LAUNCHCTL_LIST_CACHE" ]]; then
+    return
+  fi
+  if command -v launchctl >/dev/null 2>&1; then
+    LAUNCHCTL_LIST_CACHE="$(launchctl list 2>/dev/null || true)"
+  fi
+}
+
+check_launchagent_status() {
+  local label="${1:-com.happy.stacks}"
+  local plist="${2:-$HOME/Library/LaunchAgents/${label}.plist}"
+  if [[ ! -f "$plist" ]]; then
+    echo "not_installed"
+    return
+  fi
+
+  ensure_launchctl_cache
+  if echo "$LAUNCHCTL_LIST_CACHE" | grep -q "$label"; then
+    echo "loaded"
+    return
+  fi
+  echo "unloaded"
+}
+
+launchagent_pid_for_label() {
+  local label="$1"
+  if [[ -z "$label" ]]; then
+    return
+  fi
+  ensure_launchctl_cache
+  if [[ -z "$LAUNCHCTL_LIST_CACHE" ]]; then
+    return
+  fi
+  local pid
+  pid="$(echo "$LAUNCHCTL_LIST_CACHE" | awk -v lbl="$label" '$3==lbl{print $1}' | head -1)"
+  if [[ "$pid" == "-" ]]; then
+    return
+  fi
+  echo "$pid"
+}
+
+check_server_health() {
+  local port="$1"
+  if [[ -z "$port" ]]; then
+    echo "stopped"
+    return
+  fi
+  local response
+  # Tight timeouts to keep menus snappy even with many stacks.
+  response="$(curl -s --connect-timeout 0.2 --max-time 0.6 "http://127.0.0.1:${port}/health" 2>/dev/null || true)"
+  if [[ "$response" == *"ok"* ]] || [[ "$response" == *"Welcome"* ]]; then
+    echo "running"
+    return
+  fi
+  echo "stopped"
+}
+
+check_daemon_status() {
+  local cli_home_dir="$1"
+  local state_file="$cli_home_dir/daemon.state.json"
+  if [[ -z "$cli_home_dir" ]] || [[ ! -f "$state_file" ]]; then
+    # If the daemon is starting but hasn't written daemon.state.json yet, we can still detect it
+    # via the lock file PID.
+    local lock_file="$cli_home_dir/daemon.state.json.lock"
+    if [[ -f "$lock_file" ]]; then
+      local lock_pid
+      lock_pid="$(cat "$lock_file" 2>/dev/null | tr -d '[:space:]')"
+      if [[ -n "$lock_pid" ]] && [[ "$lock_pid" =~ ^[0-9]+$ ]]; then
+        if kill -0 "$lock_pid" 2>/dev/null; then
+          # Best-effort: classify "auth required" by inspecting the latest daemon log.
+          local latest_log
+          latest_log="$(ls -1t "$cli_home_dir"/logs/*-daemon.log 2>/dev/null | head -1 || true)"
+          if [[ -n "$latest_log" ]]; then
+            if tail -n 120 "$latest_log" 2>/dev/null | rg -q "No credentials found|starting authentication flow|Waiting for credentials"; then
+              echo "auth_required:$lock_pid"
+              return
+            fi
+          fi
+          echo "starting:$lock_pid"
+          return
+        fi
+        echo "stale"
+        return
+      fi
+    fi
+
+    echo "stopped"
+    return
+  fi
+
+  local pid httpPort
+  pid="$(node -e 'const fs=require("fs"); const s=JSON.parse(fs.readFileSync(process.argv[1],"utf8")); process.stdout.write(String(s.pid ?? ""));' "$state_file" 2>/dev/null || true)"
+  httpPort="$(node -e 'const fs=require("fs"); const s=JSON.parse(fs.readFileSync(process.argv[1],"utf8")); process.stdout.write(String(s.httpPort ?? ""));' "$state_file" 2>/dev/null || true)"
+
+  if [[ -z "$pid" ]] || ! [[ "$pid" =~ ^[0-9]+$ ]]; then
+    echo "unknown"
+    return
+  fi
+
+  if ! kill -0 "$pid" 2>/dev/null; then
+    echo "stale"
+    return
+  fi
+
+  # Best-effort: confirm the control server is responding (tight timeouts).
+  if [[ -n "$httpPort" ]] && [[ "$httpPort" =~ ^[0-9]+$ ]]; then
+    if curl -s --connect-timeout 0.2 --max-time 0.5 -X POST -H 'content-type: application/json' -d '{}' "http://127.0.0.1:${httpPort}/list" >/dev/null 2>&1; then
+      echo "running:$pid"
+      return
+    fi
+    echo "running-no-http:$pid"
+    return
+  fi
+
+  echo "running:$pid"
+}
+
+get_daemon_uptime() {
+  local cli_home_dir="$1"
+  local state_file="$cli_home_dir/daemon.state.json"
+  if [[ -z "$cli_home_dir" ]] || [[ ! -f "$state_file" ]]; then
+    return
+  fi
+  node -e 'const fs=require("fs"); const s=JSON.parse(fs.readFileSync(process.argv[1],"utf8")); if (s.startTime) process.stdout.write(String(s.startTime));' "$state_file" 2>/dev/null || true
+}
+
+get_last_heartbeat() {
+  local cli_home_dir="$1"
+  local state_file="$cli_home_dir/daemon.state.json"
+  if [[ -z "$cli_home_dir" ]] || [[ ! -f "$state_file" ]]; then
+    return
+  fi
+  node -e 'const fs=require("fs"); const s=JSON.parse(fs.readFileSync(process.argv[1],"utf8")); if (s.lastHeartbeat) process.stdout.write(String(s.lastHeartbeat));' "$state_file" 2>/dev/null || true
+}
+
+get_tailscale_url() {
+  # Try multiple methods to get the Tailscale URL (best-effort).
+  local url=""
+
+  if command -v tailscale &>/dev/null; then
+    url="$(tailscale serve status 2>/dev/null | grep -oE 'https://[^ ]+' | head -1 || true)"
+  fi
+  if [[ -z "$url" ]] && [[ -x "/Applications/Tailscale.app/Contents/MacOS/Tailscale" ]]; then
+    url="$(/Applications/Tailscale.app/Contents/MacOS/Tailscale serve status 2>/dev/null | grep -oE 'https://[^ ]+' | head -1 || true)"
+  fi
+
+  echo "$url"
+}
+

package/extras/swiftbar/lib/utils.sh

@@ -0,0 +1,205 @@
+#!/bin/bash
+
+shorten_text() {
+  local s="$1"
+  local max="${2:-44}"
+  if [[ ${#s} -le $max ]]; then
+    echo "$s"
+    return
+  fi
+  echo "${s:0:$((max - 3))}..."
+}
+
+shorten_path() {
+  local p="$1"
+  local max="${2:-44}"
+  local pretty="${p/#$HOME/~}"
+  shorten_text "$pretty" "$max"
+}
+
+dotenv_get() {
+  # Usage: dotenv_get /path/to/env KEY
+  # Notes:
+  # - ignores blank lines and comments
+  # - does not expand variables
+  # - strips simple surrounding quotes
+  local file="$1"
+  local key="$2"
+  if [[ -z "$file" ]] || [[ -z "$key" ]] || [[ ! -f "$file" ]]; then
+    return
+  fi
+  awk -v k="$key" '
+    BEGIN { FS="=" }
+    /^[[:space:]]*$/ { next }
+    /^[[:space:]]*#/ { next }
+    {
+      kk=$1
+      gsub(/^[[:space:]]+|[[:space:]]+$/, "", kk)
+      if (kk != k) next
+
+      vv=$0
+      sub(/^[^=]*=/, "", vv)
+      gsub(/^[[:space:]]+|[[:space:]]+$/, "", vv)
+
+      if (vv ~ /^".*"$/) { sub(/^"/, "", vv); sub(/"$/, "", vv) }
+      if (vv ~ /^'\''.*'\''$/) { sub(/^'\''/, "", vv); sub(/'\''$/, "", vv) }
+
+      print vv
+      exit
+    }
+  ' "$file" 2>/dev/null
+}
+
+resolve_happy_local_dir() {
+  local home="${HAPPY_STACKS_HOME_DIR:-$HOME/.happy-stacks}"
+
+  # If user provided a valid directory, keep it.
+  if [[ -n "${HAPPY_LOCAL_DIR:-}" ]] && [[ -f "$HAPPY_LOCAL_DIR/extras/swiftbar/lib/utils.sh" ]]; then
+    echo "$HAPPY_LOCAL_DIR"
+    return
+  fi
+
+  # Canonical install location.
+  if [[ -f "$home/extras/swiftbar/lib/utils.sh" ]]; then
+    echo "$home"
+    return
+  fi
+
+  # Fall back to home even if missing so the menu can show actionable errors.
+  echo "$home"
+}
+
+resolve_pnpm_bin() {
+  # Back-compat: historically this was "pnpm", but the plugin now runs `happys` via a wrapper script.
+  local wrapper="$HAPPY_LOCAL_DIR/extras/swiftbar/pnpm.sh"
+  if [[ -x "$wrapper" ]]; then
+    echo "$wrapper"
+    return
+  fi
+
+  local global_happys
+  global_happys="$(command -v happys 2>/dev/null || true)"
+  if [[ -n "$global_happys" ]]; then
+    echo "$global_happys"
+    return
+  fi
+
+  echo ""
+}
+
+resolve_workspace_dir() {
+  if [[ -n "${HAPPY_STACKS_WORKSPACE_DIR:-}" ]]; then
+    echo "$HAPPY_STACKS_WORKSPACE_DIR"
+    return
+  fi
+  local p
+  p="$(dotenv_get "$HAPPY_LOCAL_DIR/.env" "HAPPY_STACKS_WORKSPACE_DIR")"
+  [[ -z "$p" ]] && p="$(dotenv_get "$HAPPY_LOCAL_DIR/env.local" "HAPPY_STACKS_WORKSPACE_DIR")"
+  if [[ -n "$p" ]]; then
+    echo "$p"
+    return
+  fi
+  echo "$HAPPY_LOCAL_DIR/workspace"
+}
+
+resolve_components_dir() {
+  echo "$(resolve_workspace_dir)/components"
+}
+
+resolve_main_env_file() {
+  local explicit="${HAPPY_STACKS_ENV_FILE:-${HAPPY_LOCAL_ENV_FILE:-}}"
+  if [[ -n "$explicit" ]] && [[ -f "$explicit" ]]; then
+    echo "$explicit"
+    return
+  fi
+  local main="$HOME/.happy/stacks/main/env"
+  if [[ -f "$main" ]]; then
+    echo "$main"
+    return
+  fi
+  echo ""
+}
+
+resolve_main_port() {
+  # Priority:
+  # 1) explicit env var
+  # 2) main stack env (~/.happy/stacks/main/env)
+  # 3) home env.local
+  # 4) home .env
+  # 4) fallback to HAPPY_LOCAL_PORT / 3005
+  if [[ -n "${HAPPY_LOCAL_SERVER_PORT:-}" ]]; then
+    echo "$HAPPY_LOCAL_SERVER_PORT"
+    return
+  fi
+  if [[ -n "${HAPPY_STACKS_SERVER_PORT:-}" ]]; then
+    echo "$HAPPY_STACKS_SERVER_PORT"
+    return
+  fi
+
+  local p
+  local env_file
+  env_file="$(resolve_main_env_file)"
+  if [[ -n "$env_file" ]]; then
+    p="$(dotenv_get "$env_file" "HAPPY_LOCAL_SERVER_PORT")"
+    [[ -z "$p" ]] && p="$(dotenv_get "$env_file" "HAPPY_STACKS_SERVER_PORT")"
+  fi
+  if [[ -n "$p" ]]; then
+    echo "$p"
+    return
+  fi
+
+  p="$(dotenv_get "$HAPPY_LOCAL_DIR/env.local" "HAPPY_LOCAL_SERVER_PORT")"
+  [[ -z "$p" ]] && p="$(dotenv_get "$HAPPY_LOCAL_DIR/env.local" "HAPPY_STACKS_SERVER_PORT")"
+  if [[ -n "$p" ]]; then
+    echo "$p"
+    return
+  fi
+
+  p="$(dotenv_get "$HAPPY_LOCAL_DIR/.env" "HAPPY_LOCAL_SERVER_PORT")"
+  [[ -z "$p" ]] && p="$(dotenv_get "$HAPPY_LOCAL_DIR/.env" "HAPPY_STACKS_SERVER_PORT")"
+  if [[ -n "$p" ]]; then
+    echo "$p"
+    return
+  fi
+
+  echo "${HAPPY_LOCAL_PORT:-3005}"
+}
+
+resolve_main_server_component() {
+  if [[ -n "${HAPPY_LOCAL_SERVER_COMPONENT:-}" ]]; then
+    echo "$HAPPY_LOCAL_SERVER_COMPONENT"
+    return
+  fi
+  if [[ -n "${HAPPY_STACKS_SERVER_COMPONENT:-}" ]]; then
+    echo "$HAPPY_STACKS_SERVER_COMPONENT"
+    return
+  fi
+
+  local c
+  local env_file
+  env_file="$(resolve_main_env_file)"
+  if [[ -n "$env_file" ]]; then
+    c="$(dotenv_get "$env_file" "HAPPY_LOCAL_SERVER_COMPONENT")"
+    [[ -z "$c" ]] && c="$(dotenv_get "$env_file" "HAPPY_STACKS_SERVER_COMPONENT")"
+  fi
+  if [[ -n "$c" ]]; then
+    echo "$c"
+    return
+  fi
+
+  c="$(dotenv_get "$HAPPY_LOCAL_DIR/env.local" "HAPPY_LOCAL_SERVER_COMPONENT")"
+  [[ -z "$c" ]] && c="$(dotenv_get "$HAPPY_LOCAL_DIR/env.local" "HAPPY_STACKS_SERVER_COMPONENT")"
+  if [[ -n "$c" ]]; then
+    echo "$c"
+    return
+  fi
+
+  c="$(dotenv_get "$HAPPY_LOCAL_DIR/.env" "HAPPY_LOCAL_SERVER_COMPONENT")"
+  [[ -z "$c" ]] && c="$(dotenv_get "$HAPPY_LOCAL_DIR/.env" "HAPPY_STACKS_SERVER_COMPONENT")"
+  if [[ -n "$c" ]]; then
+    echo "$c"
+    return
+  fi
+
+  echo "happy-server-light"
+}

package/extras/swiftbar/pnpm-term.sh

@@ -0,0 +1,125 @@
+#!/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.
+
+HAPPY_STACKS_HOME_DIR="${HAPPY_STACKS_HOME_DIR:-$HOME/.happy-stacks}"
+HAPPY_LOCAL_DIR="${HAPPY_LOCAL_DIR:-$HAPPY_STACKS_HOME_DIR}"
+
+WORKDIR="${HAPPY_STACKS_WORKSPACE_DIR:-$HAPPY_STACKS_HOME_DIR/workspace}"
+if [[ ! -d "$WORKDIR" ]]; then
+  WORKDIR="$HOME"
+fi
+
+PNPM_SH="$HAPPY_LOCAL_DIR/extras/swiftbar/pnpm.sh"
+if [[ ! -x "$PNPM_SH" ]]; then
+  echo "missing happys wrapper: $PNPM_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=( "$PNPM_SH" "$@" )
+
+escape_for_osascript_string() {
+  # Escape for inclusion inside an AppleScript string literal.
+  # (We generate: write text "<cmd>")
+  local s="$1"
+  s="${s//\\/\\\\}"
+  s="${s//\"/\\\"}"
+  echo "$s"
+}
+
+shell_cmd() {
+  # Build a zsh command that cds and runs happys (via wrapper), leaving the shell open.
+  local joined=""
+  local q
+  joined="cd \"${WORKDIR//\"/\\\"}\"; "
+  for q in "${cmd[@]}"; do
+    # Basic shell quoting
+    if [[ "$q" =~ [[:space:]\\"\'\$\`\!\&\|\;\<\>\(\)\[\]\{\}] ]]; then
+      joined+="'${q//\'/\'\\\'\'}' "
+    else
+      joined+="$q "
+    fi
+  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)"
+  # Terminal.app uses do script.
+  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
+
+  # Best-effort: try to run the command. If ghostty doesn't support -e on this system,
+  # fall back to opening the dir and copying the command.
+  local s
+  s="$(shell_cmd)"
+  if ghostty --working-directory "$WORKDIR" -e /bin/zsh -lc "$s" >/dev/null 2>&1; then
+    return 0
+  fi
+
+  # Fallback: open in dir and copy command for manual paste.
+  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/pnpm.sh

@@ -0,0 +1,21 @@
+#!/bin/bash
+set -euo pipefail
+
+# Back-compat wrapper for SwiftBar menu actions.
+# Historically this executed `pnpm` in the cloned repo; it now executes `happys`.
+
+HAPPY_STACKS_HOME_DIR="${HAPPY_STACKS_HOME_DIR:-$HOME/.happy-stacks}"
+HAPPY_LOCAL_DIR="${HAPPY_LOCAL_DIR:-$HAPPY_STACKS_HOME_DIR}"
+
+HAPPYS_BIN="$HAPPY_LOCAL_DIR/bin/happys"
+if [[ ! -x "$HAPPYS_BIN" ]]; then
+  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/set-interval.sh

@@ -0,0 +1,62 @@
+#!/bin/bash
+set -euo pipefail
+
+# Usage:
+#   ./set-interval.sh 10s|30s|1m|5m|10m|15m|30m|1h|2h|6h|12h
+#
+# Runs non-interactively from SwiftBar:
+# - figures out SwiftBar's active plugin directory
+# - renames (or installs) happy-stacks.<interval>.sh
+# - restarts SwiftBar so the new schedule takes effect
+
+INTERVAL="${1:-}"
+if [[ -z "$INTERVAL" ]]; then
+  echo "missing interval (example: 5m)" >&2
+  exit 2
+fi
+
+if ! [[ "$INTERVAL" =~ ^[0-9]+[smhd]$ ]]; then
+  echo "invalid interval: $INTERVAL (expected like 10s, 5m, 1h, 1d)" >&2
+  exit 2
+fi
+
+PLUGIN_DIR="$(defaults read com.ameba.SwiftBar PluginDirectory 2>/dev/null || true)"
+if [[ -z "$PLUGIN_DIR" ]]; then
+  PLUGIN_DIR="$HOME/Library/Application Support/SwiftBar/Plugins"
+fi
+mkdir -p "$PLUGIN_DIR"
+
+TARGET="$PLUGIN_DIR/happy-stacks.${INTERVAL}.sh"
+HAPPY_STACKS_HOME_DIR="${HAPPY_STACKS_HOME_DIR:-$HOME/.happy-stacks}"
+HAPPY_LOCAL_DIR="${HAPPY_LOCAL_DIR:-$HAPPY_STACKS_HOME_DIR}"
+SOURCE="${HAPPY_LOCAL_DIR}/extras/swiftbar/happy-stacks.5s.sh"
+
+# If a happy-stacks plugin already exists, rename it into place; otherwise copy from repo source.
+EXISTING="$(ls "$PLUGIN_DIR"/happy-stacks.*.sh 2>/dev/null | head -1 || true)"
+if [[ -n "$EXISTING" ]]; then
+  if [[ "$EXISTING" != "$TARGET" ]]; then
+    rm -f "$TARGET"
+    mv "$EXISTING" "$TARGET"
+  fi
+else
+  if [[ ! -f "$SOURCE" ]]; then
+    echo "cannot find plugin source at: $SOURCE" >&2
+    exit 1
+  fi
+  cp "$SOURCE" "$TARGET"
+fi
+
+# Remove any other intervals to avoid duplicates in SwiftBar.
+for f in "$PLUGIN_DIR"/happy-stacks.*.sh; do
+  [[ "$f" == "$TARGET" ]] && continue
+  rm -f "$f" || true
+done
+
+chmod +x "$TARGET"
+touch "$TARGET"
+
+# Restart SwiftBar so the new filename interval is picked up reliably.
+killall SwiftBar 2>/dev/null || true
+open -a SwiftBar
+
+echo "ok: $TARGET"

package/extras/swiftbar/set-server-flavor.sh

@@ -0,0 +1,57 @@
+#!/bin/bash
+set -euo pipefail
+
+# Usage:
+#   ./set-server-flavor.sh main|<stackName> happy-server|happy-server-light
+#
+# For main:
+#   - updates env.local via `happys srv use ...`
+#   - restarts the LaunchAgent service if installed (best-effort)
+#
+# For stacks:
+#   - updates the stack env via `happys stack srv <name> -- use ...`
+#   - restarts the stack LaunchAgent service if installed (best-effort)
+
+STACK="${1:-}"
+FLAVOR="${2:-}"
+
+if [[ -z "$STACK" ]] || [[ -z "$FLAVOR" ]]; then
+  echo "usage: $0 <main|stackName> <happy-server|happy-server-light>" >&2
+  exit 2
+fi
+if [[ "$FLAVOR" != "happy-server" && "$FLAVOR" != "happy-server-light" ]]; then
+  echo "invalid flavor: $FLAVOR" >&2
+  exit 2
+fi
+
+HAPPY_STACKS_HOME_DIR="${HAPPY_STACKS_HOME_DIR:-$HOME/.happy-stacks}"
+HAPPY_LOCAL_DIR="${HAPPY_LOCAL_DIR:-$HAPPY_STACKS_HOME_DIR}"
+
+PNPM_BIN="$HAPPY_LOCAL_DIR/extras/swiftbar/pnpm.sh"
+if [[ ! -x "$PNPM_BIN" ]]; then
+  echo "happys wrapper not found (run: happys menubar install)" >&2
+  exit 1
+fi
+
+restart_main_service_best_effort() {
+  "$PNPM_BIN" service:restart >/dev/null 2>&1 || true
+  # If the installed LaunchAgent is still legacy/baked, reinstall so it persists only env-file pointer.
+  "$PNPM_BIN" service:install >/dev/null 2>&1 || true
+}
+
+restart_stack_service_best_effort() {
+  local name="$1"
+  "$PNPM_BIN" stack service:restart "$name" >/dev/null 2>&1 || true
+  "$PNPM_BIN" stack service:install "$name" >/dev/null 2>&1 || true
+}
+
+if [[ "$STACK" == "main" ]]; then
+  "$PNPM_BIN" srv -- use "$FLAVOR"
+  restart_main_service_best_effort
+  echo "ok: main -> $FLAVOR"
+  exit 0
+fi
+
+"$PNPM_BIN" stack srv "$STACK" -- use "$FLAVOR"
+restart_stack_service_best_effort "$STACK"
+echo "ok: $STACK -> $FLAVOR"