happy-stacks 0.0.0

package/extras/swiftbar/lib/render.sh

@@ -0,0 +1,774 @@
+#!/bin/bash
+
+# Requires:
+# - utils.sh
+# - icons.sh
+# - system.sh
+
+level_from_server_daemon() {
+  local server_status="$1"
+  local daemon_status="$2"
+  if [[ "$server_status" == "running" && "$daemon_status" == "running" ]]; then
+    echo "green"
+    return
+  fi
+  if [[ "$server_status" == "running" || "$daemon_status" == "running" ]]; then
+    echo "orange"
+    return
+  fi
+  echo "red"
+}
+
+color_for_level() {
+  local level="$1"
+  if [[ "$level" == "green" ]]; then echo "$GREEN"; return; fi
+  if [[ "$level" == "orange" ]]; then echo "$YELLOW"; return; fi
+  echo "$RED"
+}
+
+sf_for_level() {
+  local level="$1"
+  if [[ "$level" == "green" ]]; then echo "checkmark.circle.fill"; return; fi
+  if [[ "$level" == "orange" ]]; then echo "exclamationmark.triangle.fill"; return; fi
+  echo "xmark.circle.fill"
+}
+
+print_item() {
+  local prefix="$1"
+  shift
+  echo "${prefix}$*"
+}
+
+print_sep() {
+  local prefix="$1"
+  print_item "$prefix" "---"
+}
+
+render_component_server() {
+  local prefix="$1"         # "" for top-level, "--" for stack submenu
+  local stack_name="$2"     # main | <name>
+  local port="$3"
+  local server_component="$4"
+  local server_status="$5"
+  local server_pid="$6"
+  local server_metrics="$7"
+  local tailscale_url="$8"  # main only (optional)
+  local launch_label="${9:-}" # optional (com.happy.stacks[.<stack>])
+
+  local level="red"
+  [[ "$server_status" == "running" ]] && level="green"
+
+  local label="Server (${server_component})"
+  local sf="$(sf_for_level "$level")"
+  local color="$(color_for_level "$level")"
+  print_item "$prefix" "$label | sfimage=$sf color=$color"
+
+  local p2="${prefix}--"
+  print_item "$p2" "Status: $server_status"
+  print_item "$p2" "Internal: http://127.0.0.1:${port}"
+  if [[ -n "$server_pid" ]]; then
+    if [[ -n "$server_metrics" ]]; then
+      local cpu mem etime
+      cpu="$(echo "$server_metrics" | cut -d'|' -f1)"
+      mem="$(echo "$server_metrics" | cut -d'|' -f2)"
+      etime="$(echo "$server_metrics" | cut -d'|' -f3)"
+      print_item "$p2" "PID: ${server_pid}, CPU: ${cpu}%, RAM: ${mem}MB, Uptime: ${etime}"
+    else
+      print_item "$p2" "PID: ${server_pid}"
+    fi
+  fi
+  print_item "$p2" "Open UI (local) | href=http://localhost:${port}/"
+  print_item "$p2" "Open Health | href=http://127.0.0.1:${port}/health"
+  if [[ -n "$tailscale_url" ]]; then
+    print_item "$p2" "Open UI (Tailscale) | href=$tailscale_url"
+  fi
+
+  # Start/stop shortcuts (so you can control from the Server submenu too).
+  if [[ -n "$PNPM_BIN" ]]; then
+    local PNPM_TERM="$HAPPY_LOCAL_DIR/extras/swiftbar/pnpm-term.sh"
+    local plist=""
+    local svc_installed="0"
+    if [[ -n "$launch_label" ]]; then
+      plist="$HOME/Library/LaunchAgents/${launch_label}.plist"
+      [[ -f "$plist" ]] && svc_installed="1"
+    fi
+
+    print_sep "$p2"
+    if [[ "$stack_name" == "main" ]]; then
+      if [[ "$svc_installed" == "1" ]]; then
+        if [[ "$server_status" == "running" ]]; then
+          print_item "$p2" "Stop stack (service) | bash=$PNPM_BIN param1=service:stop dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
+        else
+          print_item "$p2" "Start stack (service) | bash=$PNPM_BIN param1=service:start dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
+        fi
+        print_item "$p2" "Restart stack (service) | bash=$PNPM_BIN param1=service:restart dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
+      else
+        if [[ "$server_status" == "running" ]]; then
+          print_item "$p2" "Stop (kill port listeners) | bash=$PNPM_TERM param1=stack:fix dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
+        else
+          print_item "$p2" "Start stack (foreground) | bash=$PNPM_TERM param1=start dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
+        fi
+      fi
+    else
+      if [[ "$svc_installed" == "1" ]]; then
+        if [[ "$server_status" == "running" ]]; then
+          print_item "$p2" "Stop stack (service) | bash=$PNPM_BIN param1=stack param2=service:stop param3=$stack_name dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
+        else
+          print_item "$p2" "Start stack (service) | bash=$PNPM_BIN param1=stack param2=service:start param3=$stack_name dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
+        fi
+        print_item "$p2" "Restart stack (service) | bash=$PNPM_BIN param1=stack param2=service:restart param3=$stack_name dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
+      else
+        if [[ "$server_status" == "running" ]]; then
+          print_item "$p2" "Stop (kill port listeners) | bash=$PNPM_TERM param1=stack param2=fix param3=$stack_name dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
+        else
+          print_item "$p2" "Start stack (foreground) | bash=$PNPM_TERM param1=stack param2=start param3=$stack_name dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
+        fi
+      fi
+    fi
+  fi
+
+  # Flavor switching (status-aware: only show switching to the other option).
+  local helper="$HAPPY_LOCAL_DIR/extras/swiftbar/set-server-flavor.sh"
+  if [[ -n "$PNPM_BIN" ]]; then
+    local PNPM_TERM="$HAPPY_LOCAL_DIR/extras/swiftbar/pnpm-term.sh"
+    print_sep "$p2"
+    if [[ "$server_component" == "happy-server" ]]; then
+      print_item "$p2" "Switch to happy-server-light (restart if service installed) | bash=$helper param1=$stack_name param2=happy-server-light dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
+    else
+      print_item "$p2" "Switch to happy-server (restart if service installed) | bash=$helper param1=$stack_name param2=happy-server dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
+    fi
+    if [[ "$stack_name" == "main" ]]; then
+      print_item "$p2" "Show flavor status | bash=$PNPM_TERM param1=srv param2=-- param3=status dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
+    else
+      print_item "$p2" "Show flavor status | bash=$PNPM_TERM param1=stack param2=srv param3=$stack_name param4=-- param5=status dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
+    fi
+  fi
+}
+
+render_component_daemon() {
+  local prefix="$1"
+  local daemon_status="$2"   # running|stale|stopped|unknown|running-no-http|auth_required|starting
+  local daemon_pid="$3"
+  local daemon_metrics="$4"
+  local daemon_uptime="$5"
+  local last_heartbeat="$6"
+  local state_file="$7"
+  local stack_name="$8"
+
+  local level="red"
+  if [[ "$daemon_status" == "running" ]]; then level="green"; fi
+  if [[ "$daemon_status" == "running-no-http" || "$daemon_status" == "stale" || "$daemon_status" == "auth_required" || "$daemon_status" == "starting" ]]; then level="orange"; fi
+
+  local sf="$(sf_for_level "$level")"
+  local color="$(color_for_level "$level")"
+  print_item "$prefix" "Daemon | sfimage=$sf color=$color"
+
+  local p2="${prefix}--"
+  print_item "$p2" "Status: $daemon_status"
+  if [[ -n "$daemon_pid" ]]; then
+    if [[ -n "$daemon_metrics" ]]; then
+      local cpu mem etime
+      cpu="$(echo "$daemon_metrics" | cut -d'|' -f1)"
+      mem="$(echo "$daemon_metrics" | cut -d'|' -f2)"
+      etime="$(echo "$daemon_metrics" | cut -d'|' -f3)"
+      print_item "$p2" "PID: ${daemon_pid}, CPU: ${cpu}%, RAM: ${mem}MB, Uptime: ${etime}"
+    else
+      print_item "$p2" "PID: ${daemon_pid}"
+    fi
+  fi
+  [[ -n "$daemon_uptime" ]] && print_item "$p2" "Started: $(shorten_text "$daemon_uptime" 52)"
+  [[ -n "$last_heartbeat" ]] && print_item "$p2" "Last heartbeat: $(shorten_text "$last_heartbeat" 52)"
+  # State file may not exist yet (e.g. daemon is waiting for auth).
+  print_item "$p2" "State file: $(shorten_path "$state_file" 52)"
+
+  if [[ -n "$PNPM_BIN" ]]; then
+    print_sep "$p2"
+    if [[ "$daemon_status" == "auth_required" ]]; then
+      # Provide a direct "fix" action for the common first-run problem under launchd.
+      local auth_helper="$HAPPY_LOCAL_DIR/extras/swiftbar/auth-login.sh"
+      local server_url="http://127.0.0.1:$(resolve_main_port)"
+      local webapp_url
+      webapp_url="$(get_tailscale_url)"
+      [[ -z "$webapp_url" ]] && webapp_url="http://localhost:$(resolve_main_port)"
+      if [[ "$stack_name" == "main" ]]; then
+        print_item "$p2" "Auth login (opens browser) | bash=$auth_helper param1=main param2=$server_url param3=$webapp_url dir=$HAPPY_LOCAL_DIR terminal=false refresh=false"
+      else
+        # For stacks, best-effort use the stack's configured port if available (fallback to main port).
+        local env_file="$HOME/.happy/stacks/$stack_name/env"
+        local port
+        port="$(dotenv_get "$env_file" "HAPPY_LOCAL_SERVER_PORT")"
+        [[ -z "$port" ]] && port="$(resolve_main_port)"
+        server_url="http://127.0.0.1:${port}"
+        webapp_url="$(get_tailscale_url)"
+        [[ -z "$webapp_url" ]] && webapp_url="http://localhost:${port}"
+        print_item "$p2" "Auth login (opens browser) | bash=$auth_helper param1=$stack_name param2=$server_url param3=$webapp_url param4=$HOME/.happy/stacks/$stack_name/cli dir=$HAPPY_LOCAL_DIR terminal=false refresh=false"
+      fi
+      print_sep "$p2"
+    fi
+    if [[ "$stack_name" == "main" ]]; then
+      print_item "$p2" "Restart stack (service) | bash=$PNPM_BIN param1=service:restart dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
+    else
+      print_item "$p2" "Restart stack (service) | bash=$PNPM_BIN param1=stack param2=service:restart param3=$stack_name dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
+    fi
+  fi
+}
+
+render_component_autostart() {
+  local prefix="$1"
+  local stack_name="$2"
+  local label="$3"
+  local launchagent_status="$4"  # loaded|unloaded|not_installed
+  local autostart_pid="$5"
+  local autostart_metrics="$6"
+  local logs_dir="$7"
+
+  local level="red"
+  if [[ "$launchagent_status" == "loaded" ]]; then level="green"; fi
+  if [[ "$launchagent_status" == "unloaded" ]]; then level="orange"; fi
+
+  local sf="$(sf_for_level "$level")"
+  local color="$(color_for_level "$level")"
+  print_item "$prefix" "Autostart | sfimage=$sf color=$color"
+
+  local p2="${prefix}--"
+  print_item "$p2" "Status: $launchagent_status"
+  print_item "$p2" "Plist: $(shorten_path "$HOME/Library/LaunchAgents/${label}.plist" 52)"
+  if [[ -n "$autostart_pid" ]]; then
+    if [[ -n "$autostart_metrics" ]]; then
+      local cpu mem etime
+      cpu="$(echo "$autostart_metrics" | cut -d'|' -f1)"
+      mem="$(echo "$autostart_metrics" | cut -d'|' -f2)"
+      etime="$(echo "$autostart_metrics" | cut -d'|' -f3)"
+      print_item "$p2" "PID: ${autostart_pid}, CPU: ${cpu}%, RAM: ${mem}MB, Uptime: ${etime}"
+    else
+      print_item "$p2" "PID: ${autostart_pid}"
+    fi
+  fi
+  local stdout_file="happy-stacks.out.log"
+  local stderr_file="happy-stacks.err.log"
+  if [[ -f "${logs_dir}/happy-local.out.log" && ! -f "${logs_dir}/happy-stacks.out.log" ]]; then stdout_file="happy-local.out.log"; fi
+  if [[ -f "${logs_dir}/happy-local.err.log" && ! -f "${logs_dir}/happy-stacks.err.log" ]]; then stderr_file="happy-local.err.log"; fi
+  print_item "$p2" "Open logs (stdout) | bash=/usr/bin/open param1=-a param2=Console param3='${logs_dir}/${stdout_file}' terminal=false"
+  print_item "$p2" "Open logs (stderr) | bash=/usr/bin/open param1=-a param2=Console param3='${logs_dir}/${stderr_file}' terminal=false"
+
+  if [[ -z "$PNPM_BIN" ]]; then
+    return
+  fi
+  print_sep "$p2"
+  if [[ "$stack_name" == "main" ]]; then
+    if [[ "$launchagent_status" == "not_installed" ]]; then
+      print_item "$p2" "Install Autostart | bash=$PNPM_BIN param1=service:install dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
+      return
+    fi
+    # Status-aware: show only the relevant toggle (enable vs disable).
+    if [[ "$launchagent_status" == "loaded" ]]; then
+      print_item "$p2" "Disable Autostart | bash=$PNPM_BIN param1=service:disable dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
+    else
+      print_item "$p2" "Enable Autostart | bash=$PNPM_BIN param1=service:enable dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
+    fi
+    print_item "$p2" "Uninstall Autostart | bash=$PNPM_BIN param1=service:uninstall dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
+    return
+  fi
+
+  if [[ "$launchagent_status" == "not_installed" ]]; then
+    print_item "$p2" "Install Autostart | bash=$PNPM_BIN param1=stack param2=service:install param3=$stack_name dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
+    return
+  fi
+  # Status-aware: show only the relevant toggle (enable vs disable).
+  if [[ "$launchagent_status" == "loaded" ]]; then
+    print_item "$p2" "Disable Autostart | bash=$PNPM_BIN param1=stack param2=service:disable param3=$stack_name dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
+  else
+    print_item "$p2" "Enable Autostart | bash=$PNPM_BIN param1=stack param2=service:enable param3=$stack_name dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
+  fi
+  print_item "$p2" "Uninstall Autostart | bash=$PNPM_BIN param1=stack param2=service:uninstall param3=$stack_name dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
+}
+
+render_component_tailscale() {
+  local prefix="$1"
+  local stack_name="$2"
+  local tailscale_url="$3"
+
+  local level="red"
+  [[ -n "$tailscale_url" ]] && level="green"
+
+  local sf="$(sf_for_level "$level")"
+  local color="$(color_for_level "$level")"
+  print_item "$prefix" "Tailscale | sfimage=$sf color=$color"
+
+  local p2="${prefix}--"
+  if [[ -n "$tailscale_url" ]]; then
+    local display="$tailscale_url"
+    [[ ${#display} -gt 48 ]] && display="${display:0:48}..."
+    print_item "$p2" "URL: $display"
+    print_item "$p2" "Copy URL | bash=/bin/bash param1=-c param2='echo -n \"$tailscale_url\" | pbcopy' terminal=false"
+    print_item "$p2" "Open URL | href=$tailscale_url"
+  else
+    print_item "$p2" "Status: not configured / unknown"
+  fi
+
+  if [[ -z "$PNPM_BIN" ]]; then
+    return
+  fi
+  print_sep "$p2"
+
+  if [[ "$stack_name" == "main" ]]; then
+    local PNPM_TERM="$HAPPY_LOCAL_DIR/extras/swiftbar/pnpm-term.sh"
+    print_item "$p2" "Tailscale status | bash=$PNPM_TERM param1=tailscale:status dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
+    if [[ -n "$tailscale_url" ]]; then
+      print_item "$p2" "Disable Tailscale Serve | bash=$PNPM_BIN param1=tailscale:disable dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
+    else
+      print_item "$p2" "Enable Tailscale Serve | bash=$PNPM_TERM param1=tailscale:enable dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
+    fi
+    print_item "$p2" "Print URL | bash=$PNPM_TERM param1=tailscale:url dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
+    return
+  fi
+
+  local PNPM_TERM="$HAPPY_LOCAL_DIR/extras/swiftbar/pnpm-term.sh"
+  print_item "$p2" "Tailscale status | bash=$PNPM_TERM param1=stack param2=tailscale:status param3=$stack_name dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
+  if [[ -n "$tailscale_url" ]]; then
+    print_item "$p2" "Disable Tailscale Serve | bash=$PNPM_BIN param1=stack param2=tailscale:disable param3=$stack_name dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
+  else
+    print_item "$p2" "Enable Tailscale Serve | bash=$PNPM_TERM param1=stack param2=tailscale:enable param3=$stack_name dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
+  fi
+  print_item "$p2" "Print URL | bash=$PNPM_TERM param1=stack param2=tailscale:url param3=$stack_name dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
+}
+
+render_component_repo() {
+  # Git/worktree component view (unified UI).
+  # Usage:
+  #   render_component_repo <prefix> <component> <context> <stack_name> <env_file>
+  # context: main|stack
+  local prefix="$1"
+  local component="$2"
+  local context="$3"
+  local stack_name="$4"
+  local env_file="$5"
+
+  local active_dir=""
+  if [[ "$context" == "stack" && -n "$env_file" ]]; then
+    active_dir="$(resolve_component_dir_from_env_file "$env_file" "$component")"
+  else
+    active_dir="$(resolve_component_dir_from_env "$component")"
+  fi
+
+  local level="red"
+  local detail="missing"
+  if is_git_repo "$active_dir"; then
+    local dirty
+    dirty="$(git_dirty_flag "$active_dir")"
+    local ab
+    ab="$(git_ahead_behind "$active_dir")"
+    local ahead="" behind=""
+    if [[ -n "$ab" ]]; then
+      ahead="$(echo "$ab" | cut -d'|' -f1)"
+      behind="$(echo "$ab" | cut -d'|' -f2)"
+    fi
+
+    if [[ "$dirty" == "dirty" ]] || [[ -n "$behind" && "$behind" != "0" ]]; then
+      level="orange"
+    else
+      level="green"
+    fi
+    detail="ok"
+  fi
+
+  local sf color
+  sf="$(sf_for_level "$level")"
+  color="$(color_for_level "$level")"
+  print_item "$prefix" "${component} | sfimage=$sf color=$color"
+
+  local p2="${prefix}--"
+  print_item "$p2" "Dir: $(shorten_path "$active_dir" 52)"
+  if [[ "$detail" != "ok" ]]; then
+    print_item "$p2" "Status: not a git repo / missing"
+    if [[ -n "$PNPM_BIN" ]]; then
+      print_sep "$p2"
+      local PNPM_TERM="$HAPPY_LOCAL_DIR/extras/swiftbar/pnpm-term.sh"
+      print_item "$p2" "Bootstrap (clone missing components) | bash=$PNPM_TERM param1=bootstrap dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
+    fi
+    return
+  fi
+
+  local branch head upstream
+  branch="$(git_head_branch "$active_dir")"
+  head="$(git_head_short "$active_dir")"
+  upstream="$(git_upstream_short "$active_dir")"
+
+  local dirty
+  dirty="$(git_dirty_flag "$active_dir")"
+  local ab ahead behind
+  ab="$(git_ahead_behind "$active_dir")"
+  ahead=""
+  behind=""
+  if [[ -n "$ab" ]]; then
+    ahead="$(echo "$ab" | cut -d'|' -f1)"
+    behind="$(echo "$ab" | cut -d'|' -f2)"
+  fi
+
+  print_item "$p2" "HEAD: ${branch:-"(unknown)"} ${head:+($head)}"
+  print_item "$p2" "Upstream: ${upstream:-"(none)"}"
+  if [[ -n "$ahead" && -n "$behind" ]]; then
+    print_item "$p2" "Ahead/Behind: ${ahead}/${behind}"
+  fi
+  print_item "$p2" "Working tree: ${dirty}"
+
+  local main_branch main_upstream main_ab
+  main_branch="$(git_main_branch_name "$active_dir")"
+  if [[ -n "$main_branch" ]]; then
+    main_upstream="$(git_branch_upstream_short "$active_dir" "$main_branch")"
+    main_ab="$(git_branch_ahead_behind "$active_dir" "$main_branch")"
+    if [[ -n "$main_upstream" ]]; then
+      print_item "$p2" "Main: ${main_branch} → ${main_upstream}"
+    else
+      print_item "$p2" "Main: ${main_branch} → (no upstream)"
+    fi
+    if [[ -n "$main_ab" ]]; then
+      print_item "$p2" "Main ahead/behind: $(echo "$main_ab" | cut -d'|' -f1)/$(echo "$main_ab" | cut -d'|' -f2)"
+    fi
+
+    # Always show comparisons against origin/* and upstream/* when those remote refs exist.
+    # (These reflect your last fetch; we do not auto-fetch in the menu.)
+    local oref uref
+    oref="$(git_remote_main_ref "$active_dir" "origin")"
+    uref="$(git_remote_main_ref "$active_dir" "upstream")"
+    if [[ -n "$oref" ]]; then
+      local oref_short="${oref#refs/remotes/}"
+      local oab
+      oab="$(git_ahead_behind_refs "$active_dir" "$oref" "$main_branch")"
+      if [[ -n "$oab" ]]; then
+        print_item "$p2" "Origin: ${oref_short} ahead/behind: $(echo "$oab" | cut -d'|' -f1)/$(echo "$oab" | cut -d'|' -f2)"
+      else
+        print_item "$p2" "Origin: ${oref_short}"
+      fi
+    else
+      print_item "$p2" "Origin: (no origin/main|master ref)"
+    fi
+    if [[ -n "$uref" ]]; then
+      local uref_short="${uref#refs/remotes/}"
+      local uab
+      uab="$(git_ahead_behind_refs "$active_dir" "$uref" "$main_branch")"
+      if [[ -n "$uab" ]]; then
+        print_item "$p2" "Upstream: ${uref_short} ahead/behind: $(echo "$uab" | cut -d'|' -f1)/$(echo "$uab" | cut -d'|' -f2)"
+      else
+        print_item "$p2" "Upstream: ${uref_short}"
+      fi
+    else
+      print_item "$p2" "Upstream: (no upstream/main|master ref)"
+    fi
+  fi
+
+  local wt_count
+  wt_count="$(git_worktree_count "$active_dir")"
+
+  # Quick actions
+  print_sep "$p2"
+  print_item "$p2" "Open folder | bash=/usr/bin/open param1='$active_dir' terminal=false"
+
+  if [[ -n "$PNPM_BIN" ]]; then
+    local PNPM_TERM="$HAPPY_LOCAL_DIR/extras/swiftbar/pnpm-term.sh"
+    # Run via stack wrappers when in a stack context so env-file stays authoritative.
+    if [[ "$context" == "stack" && -n "$stack_name" ]]; then
+      print_item "$p2" "Status (active) | bash=$PNPM_TERM param1=stack param2=wt param3=$stack_name param4=-- param5=status param6=$component dir=$HAPPY_LOCAL_DIR terminal=false"
+      print_item "$p2" "Sync mirror (upstream/main) | bash=$PNPM_BIN param1=stack param2=wt param3=$stack_name param4=-- param5=sync param6=$component dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
+      print_item "$p2" "Update (dry-run) | bash=$PNPM_TERM param1=stack param2=wt param3=$stack_name param4=-- param5=update param6=$component param7=active param8=--dry-run dir=$HAPPY_LOCAL_DIR terminal=false"
+      print_item "$p2" "Update (apply) | bash=$PNPM_BIN param1=stack param2=wt param3=$stack_name param4=-- param5=update param6=$component param7=active dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
+      print_item "$p2" "Update (apply + stash) | bash=$PNPM_BIN param1=stack param2=wt param3=$stack_name param4=-- param5=update param6=$component param7=active param8=--stash dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
+    else
+      print_item "$p2" "Status (active) | bash=$PNPM_TERM param1=wt param2=status param3=$component dir=$HAPPY_LOCAL_DIR terminal=false"
+      print_item "$p2" "Sync mirror (upstream/main) | bash=$PNPM_BIN param1=wt param2=sync param3=$component dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
+      print_item "$p2" "Update (dry-run) | bash=$PNPM_TERM param1=wt param2=update param3=$component param4=active param5=--dry-run dir=$HAPPY_LOCAL_DIR terminal=false"
+      print_item "$p2" "Update (apply) | bash=$PNPM_BIN param1=wt param2=update param3=$component param4=active dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
+      print_item "$p2" "Update (apply + stash) | bash=$PNPM_BIN param1=wt param2=update param3=$component param4=active param5=--stash dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
+    fi
+
+    print_sep "$p2"
+    if [[ "$context" == "stack" && -n "$stack_name" ]]; then
+      print_item "$p2" "Switch stack worktree (interactive) | bash=$PNPM_TERM param1=stack param2=wt param3=$stack_name param4=-- param5=use param6=$component param7=--interactive dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
+      print_item "$p2" "New worktree (interactive) | bash=$PNPM_TERM param1=stack param2=wt param3=$stack_name param4=-- param5=new param6=--interactive dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
+      print_item "$p2" "List worktrees (terminal) | bash=$PNPM_TERM param1=stack param2=wt param3=$stack_name param4=-- param5=list param6=$component dir=$HAPPY_LOCAL_DIR terminal=false"
+    else
+      print_item "$p2" "Use worktree (interactive) | bash=$PNPM_TERM param1=wt param2=use param3=--interactive dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
+      print_item "$p2" "New worktree (interactive) | bash=$PNPM_TERM param1=wt param2=new param3=--interactive dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
+      print_item "$p2" "List worktrees (terminal) | bash=$PNPM_TERM param1=wt param2=list param3=$component dir=$HAPPY_LOCAL_DIR terminal=false"
+    fi
+
+    # PR worktree (prompt)
+    local pr_helper="$HAPPY_LOCAL_DIR/extras/swiftbar/wt-pr.sh"
+    if [[ -x "$pr_helper" ]]; then
+      if [[ "$context" == "stack" && -n "$stack_name" ]]; then
+        print_item "$p2" "PR worktree (prompt) | bash=$pr_helper param1=$component param2=$stack_name dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
+      else
+        print_item "$p2" "PR worktree (prompt) | bash=$pr_helper param1=$component dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
+      fi
+    fi
+
+    print_sep "$p2"
+    if [[ "$context" == "stack" && -n "$stack_name" ]]; then
+      print_item "$p2" "Shell (active, new window) | bash=$PNPM_TERM param1=stack param2=wt param3=$stack_name param4=-- param5=shell param6=$component param7=active param8=--new-window dir=$HAPPY_LOCAL_DIR terminal=false"
+      print_item "$p2" "Open in VS Code (active) | bash=$PNPM_BIN param1=stack param2=wt param3=$stack_name param4=-- param5=code param6=$component param7=active dir=$HAPPY_LOCAL_DIR terminal=false"
+      print_item "$p2" "Open in Cursor (active) | bash=$PNPM_BIN param1=stack param2=wt param3=$stack_name param4=-- param5=cursor param6=$component param7=active dir=$HAPPY_LOCAL_DIR terminal=false"
+    else
+      print_item "$p2" "Shell (active, new window) | bash=$PNPM_TERM param1=wt param2=shell param3=$component param4=active param5=--new-window dir=$HAPPY_LOCAL_DIR terminal=false"
+      print_item "$p2" "Open in VS Code (active) | bash=$PNPM_BIN param1=wt param2=code param3=$component param4=active dir=$HAPPY_LOCAL_DIR terminal=false"
+      print_item "$p2" "Open in Cursor (active) | bash=$PNPM_BIN param1=wt param2=cursor param3=$component param4=active dir=$HAPPY_LOCAL_DIR terminal=false"
+    fi
+
+    # Worktrees listing (inline in SwiftBar, plus stack-aware switch).
+    local wt_label="Worktrees: ${wt_count:-0} | sfimage=arrow.triangle.branch"
+    print_item "$p2" "$wt_label"
+    local p3="${p2}--"
+    local tsv
+    tsv="$(git_worktrees_tsv "$active_dir" 2>/dev/null || true)"
+    if [[ -z "$tsv" ]]; then
+      print_item "$p3" "No worktrees found | color=$GRAY"
+    else
+      local root="$(resolve_components_dir)/.worktrees/$component/"
+      local shown=0
+      while IFS=$'\t' read -r wt_path wt_branchref; do
+        [[ -n "$wt_path" ]] || continue
+        shown=$((shown + 1))
+        if [[ $shown -gt 30 ]]; then
+          print_item "$p3" "More… (open folder) | bash=/usr/bin/open param1='$root' terminal=false"
+          break
+        fi
+
+        local label=""
+        local spec=""
+        if [[ "$wt_path" == "$root"* ]]; then
+          spec="${wt_path#"$root"}"
+          label="$spec"
+        else
+          spec="$wt_path"
+          label="$(shorten_path "$wt_path" 52)"
+        fi
+
+        if [[ -n "$wt_branchref" && "$wt_branchref" == refs/heads/* ]]; then
+          label="$label ($(basename "$wt_branchref"))"
+        fi
+        if [[ "$wt_path" == "$active_dir" ]]; then
+          label="(active) $label"
+        fi
+
+        if [[ "$context" == "stack" && -n "$stack_name" ]]; then
+          print_item "$p3" "$label"
+          print_item "${p3}--" "Use in stack | bash=$PNPM_BIN param1=stack param2=wt param3=$stack_name param4=-- param5=use param6=$component param7=$spec dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
+          print_item "${p3}--" "Shell (new window) | bash=$PNPM_TERM param1=stack param2=wt param3=$stack_name param4=-- param5=shell param6=$component param7=$spec param8=--new-window dir=$HAPPY_LOCAL_DIR terminal=false"
+          print_item "${p3}--" "Open in VS Code | bash=$PNPM_BIN param1=stack param2=wt param3=$stack_name param4=-- param5=code param6=$component param7=$spec dir=$HAPPY_LOCAL_DIR terminal=false"
+          print_item "${p3}--" "Open in Cursor | bash=$PNPM_BIN param1=stack param2=wt param3=$stack_name param4=-- param5=cursor param6=$component param7=$spec dir=$HAPPY_LOCAL_DIR terminal=false"
+        else
+          print_item "$p3" "$label"
+          print_item "${p3}--" "Use (main) | bash=$PNPM_BIN param1=wt param2=use param3=$component param4=$spec dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
+          print_item "${p3}--" "Shell (new window) | bash=$PNPM_TERM param1=wt param2=shell param3=$component param4=$spec param5=--new-window dir=$HAPPY_LOCAL_DIR terminal=false"
+          print_item "${p3}--" "Open in VS Code | bash=$PNPM_BIN param1=wt param2=code param3=$component param4=$spec dir=$HAPPY_LOCAL_DIR terminal=false"
+          print_item "${p3}--" "Open in Cursor | bash=$PNPM_BIN param1=wt param2=cursor param3=$component param4=$spec dir=$HAPPY_LOCAL_DIR terminal=false"
+        fi
+      done <<<"$tsv"
+    fi
+  fi
+}
+
+render_components_menu() {
+  # Usage: render_components_menu <prefix> <context> <stack_name> <env_file>
+  local prefix="$1"   # "" for main menu, "--" for inside a stack
+  local context="$2"  # main|stack
+  local stack_name="$3"
+  local env_file="$4"
+
+  print_item "$prefix" "Components | sfimage=cube"
+  local p2="${prefix}--"
+  local components_dir
+  components_dir="$(resolve_components_dir)"
+  if [[ ! -d "$components_dir" ]]; then
+    print_item "$p2" "Missing components dir: $(shorten_path "$components_dir" 52) | color=$GRAY"
+    return
+  fi
+
+  local any="0"
+  for c in happy happy-cli happy-server-light happy-server; do
+    if [[ -d "$components_dir/$c" ]]; then
+      any="1"
+      render_component_repo "$p2" "$c" "$context" "$stack_name" "$env_file"
+      print_sep "$p2"
+    fi
+  done
+  if [[ "$any" == "0" ]]; then
+    print_item "$p2" "No components found under components/ | color=$GRAY"
+  fi
+}
+
+render_stack_overview_item() {
+  local title="$1"
+  local level="$2"  # green|orange|red
+  local prefix="$3"
+
+  local icon_b64
+  icon_b64="$(status_icon_b64 "$level" 14)"
+  if [[ -n "$icon_b64" ]]; then
+    print_item "$prefix" "$title | image=$icon_b64"
+  else
+    print_item "$prefix" "$title"
+  fi
+}
+
+collect_stack_status() {
+  # Output (tab-separated):
+  # level server_status server_pid server_metrics daemon_status daemon_pid daemon_metrics daemon_uptime last_heartbeat launchagent_status autostart_pid autostart_metrics
+  local port="$1"
+  local cli_home_dir="$2"
+  local label="$3"
+  local base_dir="$4"
+
+  local server_status server_pid server_metrics
+  server_status="$(check_server_health "$port")"
+  server_pid=""
+  server_metrics=""
+  if [[ "$server_status" == "running" ]]; then
+    server_pid="$(get_port_listener_pid "$port")"
+    server_metrics="$(get_process_metrics "$server_pid")"
+  fi
+
+  local daemon_raw daemon_status daemon_pid daemon_metrics
+  daemon_raw="$(check_daemon_status "$cli_home_dir")"
+  daemon_status="$daemon_raw"
+  daemon_pid=""
+  if [[ "$daemon_raw" == running:* ]] || [[ "$daemon_raw" == running-no-http:* ]]; then
+    daemon_pid="${daemon_raw#*:}"
+    daemon_status="${daemon_raw%%:*}"
+  fi
+  daemon_metrics=""
+  if [[ -n "$daemon_pid" ]]; then
+    daemon_metrics="$(get_process_metrics "$daemon_pid")"
+  fi
+
+  local daemon_uptime last_heartbeat
+  daemon_uptime="$(get_daemon_uptime "$cli_home_dir")"
+  last_heartbeat="$(get_last_heartbeat "$cli_home_dir")"
+
+  local plist_path="$HOME/Library/LaunchAgents/${label}.plist"
+  local launchagent_status autostart_pid autostart_metrics
+  launchagent_status="$(check_launchagent_status "$label" "$plist_path")"
+  autostart_pid=""
+  autostart_metrics=""
+  if [[ "$launchagent_status" != "not_installed" ]]; then
+    autostart_pid="$(launchagent_pid_for_label "$label")"
+    autostart_metrics="$(get_process_metrics "$autostart_pid")"
+  fi
+
+  local level
+  level="$(level_from_server_daemon "$server_status" "$daemon_status")"
+
+  # Important: callers use `read` with IFS=$'\t' which collapses consecutive delimiters.
+  # Emit "-" placeholders for optional/empty fields so parsing stays stable.
+  local spid="${server_pid:-"-"}"
+  local smet="${server_metrics:-"-"}"
+  local dpid="${daemon_pid:-"-"}"
+  local dmet="${daemon_metrics:-"-"}"
+  local dupt="${daemon_uptime:-"-"}"
+  local dhb="${last_heartbeat:-"-"}"
+  local apid="${autostart_pid:-"-"}"
+  local amet="${autostart_metrics:-"-"}"
+
+  printf '%s\t%s\t%s\t%s\t%s\t%s\t%s\t%s\t%s\t%s\t%s\t%s\n' \
+    "$level" \
+    "$server_status" "$spid" "$smet" \
+    "$daemon_status" "$dpid" "$dmet" "$dupt" "$dhb" \
+    "$launchagent_status" "$apid" "$amet"
+}
+
+render_stack_info() {
+  # Renders a single "Info" item (with actions) at the given prefix.
+  local prefix="$1"         # "" or "--"
+  local stack_name="$2"
+  local port="$3"
+  local server_component="$4"
+  local base_dir="$5"
+  local cli_home_dir="$6"
+  local label="$7"
+  local env_file="$8"       # optional
+  local tailscale_url="$9"  # optional
+
+  # Avoid low-contrast gray in the main list; keep it readable in both light/dark.
+  print_item "$prefix" "Stack details | sfimage=info.circle"
+  local p2="${prefix}--"
+  print_item "$p2" "Server component: ${server_component}"
+  print_item "$p2" "Port: ${port}"
+  print_item "$p2" "Label: ${label}"
+  [[ -n "$env_file" ]] && print_item "$p2" "Env: $(shorten_path "$env_file" 52)"
+  [[ -n "$tailscale_url" ]] && print_item "$p2" "Tailscale: $(shorten_text "$tailscale_url" 52)"
+
+  print_sep "$p2"
+  print_item "$p2" "Open repo | bash=/usr/bin/open param1='$HAPPY_LOCAL_DIR' terminal=false"
+  print_item "$p2" "Open data dir | bash=/usr/bin/open param1='$base_dir' terminal=false"
+  print_item "$p2" "Open logs dir | bash=/usr/bin/open param1='${base_dir}/logs' terminal=false"
+  print_item "$p2" "Open CLI home | bash=/usr/bin/open param1='$cli_home_dir' terminal=false"
+  if [[ "$stack_name" == "main" ]]; then
+    local main_env
+    main_env="$(resolve_main_env_file)"
+    if [[ -n "$main_env" ]]; then
+      print_item "$p2" "Edit main env | bash=/usr/bin/open param1=-a param2=TextEdit param3='$main_env' terminal=false"
+    else
+      print_item "$p2" "Edit env.local | bash=/usr/bin/open param1=-a param2=TextEdit param3='$HAPPY_LOCAL_DIR/env.local' terminal=false"
+    fi
+  else
+    print_item "$p2" "Open stack env | bash=/usr/bin/open param1='$env_file' terminal=false"
+  fi
+
+  if [[ -z "$PNPM_BIN" ]]; then
+    return
+  fi
+  print_sep "$p2"
+
+  local plist="$HOME/Library/LaunchAgents/${label}.plist"
+  local svc_installed="0"
+  [[ -f "$plist" ]] && svc_installed="1"
+
+  if [[ "$stack_name" == "main" ]]; then
+    local PNPM_TERM="$HAPPY_LOCAL_DIR/extras/swiftbar/pnpm-term.sh"
+    if [[ "$svc_installed" == "1" ]]; then
+      # Status-aware: only show start/stop based on whether the stack is running.
+      if [[ "${MAIN_LEVEL:-}" == "red" ]]; then
+        print_item "$p2" "Start (service) | bash=$PNPM_BIN param1=service:start dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
+      else
+        print_item "$p2" "Stop (service) | bash=$PNPM_BIN param1=service:stop dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
+      fi
+      print_item "$p2" "Restart (service) | bash=$PNPM_BIN param1=service:restart dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
+    else
+      if [[ "${MAIN_LEVEL:-}" == "red" ]]; then
+        print_item "$p2" "Start (foreground) | bash=$PNPM_TERM param1=start dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
+      else
+        print_item "$p2" "Stop (kill port listeners) | bash=$PNPM_TERM param1=stack:fix dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
+      fi
+    fi
+    print_item "$p2" "Dev mode | bash=$PNPM_TERM param1=dev dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
+    print_item "$p2" "Build UI | bash=$PNPM_TERM param1=build dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
+    print_item "$p2" "Doctor | bash=$PNPM_TERM param1=stack:doctor dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
+    return
+  fi
+
+  local PNPM_TERM="$HAPPY_LOCAL_DIR/extras/swiftbar/pnpm-term.sh"
+  if [[ "$svc_installed" == "1" ]]; then
+    # Status-aware: only show start/stop based on whether the stack is running.
+    if [[ "$STACK_LEVEL" == "red" ]]; then
+      print_item "$p2" "Start (service) | bash=$PNPM_BIN param1=stack param2=service:start param3=$stack_name dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
+    else
+      print_item "$p2" "Stop (service) | bash=$PNPM_BIN param1=stack param2=service:stop param3=$stack_name dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
+    fi
+    print_item "$p2" "Restart (service) | bash=$PNPM_BIN param1=stack param2=service:restart param3=$stack_name dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
+  else
+    if [[ "$STACK_LEVEL" == "red" ]]; then
+      print_item "$p2" "Start (foreground) | bash=$PNPM_TERM param1=stack param2=start param3=$stack_name dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
+    else
+      print_item "$p2" "Stop (kill port listeners) | bash=$PNPM_TERM param1=stack param2=fix param3=$stack_name dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
+    fi
+  fi
+  print_item "$p2" "Dev mode | bash=$PNPM_TERM param1=stack param2=dev param3=$stack_name dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
+  print_item "$p2" "Build UI | bash=$PNPM_TERM param1=stack param2=build param3=$stack_name dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
+  print_item "$p2" "Doctor | bash=$PNPM_TERM param1=stack param2=doctor param3=$stack_name dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
+  print_item "$p2" "Edit stack (interactive) | bash=$PNPM_TERM param1=stack param2=edit param3=$stack_name param4=--interactive dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
+  print_item "$p2" "Select worktrees (interactive) | bash=$PNPM_TERM param1=stack param2=wt param3=$stack_name param4=-- param5=use param6=--interactive dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
+
+  local pr_helper="$HAPPY_LOCAL_DIR/extras/swiftbar/wt-pr.sh"
+  if [[ -x "$pr_helper" ]]; then
+    print_item "$p2" "PR worktree into this stack (prompt) | bash=$pr_helper param1=_prompt_ param2=$stack_name dir=$HAPPY_LOCAL_DIR terminal=false refresh=true"
+  fi
+}