happy-stacks 0.1.2 → 0.2.0

package/extras/swiftbar/lib/utils.sh

@@ -17,6 +17,146 @@ shorten_path() {
   shorten_text "$pretty" "$max"
 }
 
+swiftbar_is_sandboxed() {
+  [[ -n "${HAPPY_STACKS_SANDBOX_DIR:-}" ]]
+}
+
+swiftbar_profile_enabled() {
+  [[ "${HAPPY_STACKS_SWIFTBAR_PROFILE:-}" == "1" || "${HAPPY_LOCAL_SWIFTBAR_PROFILE:-}" == "1" ]]
+}
+
+swiftbar_now_ms() {
+  # macOS `date` doesn't support %N, so use Time::HiRes when available.
+  if command -v perl >/dev/null 2>&1; then
+    perl -MTime::HiRes=time -e 'printf("%.0f\n", time()*1000)'
+    return
+  fi
+  if command -v python3 >/dev/null 2>&1; then
+    python3 -c 'import time; print(int(time.time()*1000))'
+    return
+  fi
+  # Fallback: seconds granularity.
+  echo $(( $(date +%s 2>/dev/null || echo 0) * 1000 ))
+}
+
+swiftbar_profile_log_file() {
+  # Keep logs in the home install by default (stable across repos/worktrees).
+  local canonical="${HAPPY_STACKS_CANONICAL_HOME_DIR:-${HAPPY_LOCAL_CANONICAL_HOME_DIR:-$HOME/.happy-stacks}}"
+  local home="${HAPPY_STACKS_HOME_DIR:-${HAPPY_LOCAL_DIR:-$canonical}}"
+  echo "${home}/cache/swiftbar/profile.log"
+}
+
+swiftbar_profile_log() {
+  # Usage: swiftbar_profile_log "event" "k=v" "k2=v2" ...
+  swiftbar_profile_enabled || return 0
+
+  local log_file
+  log_file="$(swiftbar_profile_log_file)"
+  mkdir -p "$(dirname "$log_file")" 2>/dev/null || true
+
+  local ts
+  ts="$(swiftbar_now_ms)"
+  {
+    printf '%s\t%s' "$ts" "$1"
+    shift || true
+    for kv in "$@"; do
+      printf '\t%s' "$kv"
+    done
+    printf '\n'
+  } >>"$log_file" 2>/dev/null || true
+}
+
+swiftbar_profile_time() {
+  # Usage: swiftbar_profile_time <label> -- <command...>
+  swiftbar_profile_enabled || { shift; [[ "${1:-}" == "--" ]] && shift; "$@"; return $?; }
+  local label="$1"
+  shift
+  [[ "${1:-}" == "--" ]] && shift
+
+  local t0 t1 rc
+  t0="$(swiftbar_now_ms)"
+  "$@"
+  rc=$?
+  t1="$(swiftbar_now_ms)"
+  swiftbar_profile_log "time" "label=${label}" "ms=$((t1 - t0))" "rc=${rc}"
+  return $rc
+}
+
+swiftbar_cache_hash12() {
+  # Usage: swiftbar_cache_hash12 "string"
+  local s="$1"
+  if command -v md5 >/dev/null 2>&1; then
+    md5 -q -s "$s" 2>/dev/null | head -c 12
+    return
+  fi
+  if command -v shasum >/dev/null 2>&1; then
+    printf '%s' "$s" | shasum -a 256 2>/dev/null | awk '{print substr($1,1,12)}'
+    return
+  fi
+  # Last resort (not cryptographic): length + a sanitized prefix.
+  printf '%s' "${#s}-$(echo "$s" | tr -cd '[:alnum:]' | head -c 10)"
+}
+
+swiftbar_hash() {
+  # Usage: swiftbar_hash "string"
+  local s="$1"
+  if command -v md5 >/dev/null 2>&1; then
+    md5 -q -s "$s" 2>/dev/null || true
+    return
+  fi
+  if command -v shasum >/dev/null 2>&1; then
+    printf '%s' "$s" | shasum -a 256 2>/dev/null | awk '{print $1}'
+    return
+  fi
+  printf '%s' "$(swiftbar_cache_hash12 "$s")"
+}
+
+swiftbar_run_cache_dir() {
+  # Per-process (per-refresh) cache. Avoid persisting across SwiftBar refreshes.
+  local base="${TMPDIR:-/tmp}"
+  local dir="${base%/}/happy-stacks-swiftbar-cache-${UID:-0}-$$"
+  mkdir -p "$dir" 2>/dev/null || true
+  echo "$dir"
+}
+
+swiftbar_cache_file_for_key() {
+  local key="$1"
+  local dir
+  dir="$(swiftbar_run_cache_dir)"
+  echo "${dir}/$(swiftbar_cache_hash12 "$key").cache"
+}
+
+swiftbar_cache_get() {
+  # Usage: swiftbar_cache_get <key>
+  # Output: cached stdout (may be empty). Exit status: cached rc.
+  local key="$1"
+  local f
+  f="$(swiftbar_cache_file_for_key "$key")"
+  # Important: return a distinct code on cache-miss so callers can distinguish from cached rc=1.
+  [[ -f "$f" ]] || return 111
+  local rc_line rc
+  rc_line="$(head -n 1 "$f" 2>/dev/null || true)"
+  rc="${rc_line#rc:}"
+  tail -n +2 "$f" 2>/dev/null || true
+  [[ "$rc" =~ ^[0-9]+$ ]] || rc=0
+  return "$rc"
+}
+
+swiftbar_cache_set() {
+  # Usage: swiftbar_cache_set <key> <rc> <stdout>
+  local key="$1"
+  local rc="$2"
+  local out="${3:-}"
+  local f
+  f="$(swiftbar_cache_file_for_key "$key")"
+  {
+    printf 'rc:%s\n' "${rc:-0}"
+    printf '%s' "$out"
+    # Keep files line-friendly.
+    [[ "$out" == *$'\n' ]] || printf '\n'
+  } >"$f" 2>/dev/null || true
+}
+
 dotenv_get() {
   # Usage: dotenv_get /path/to/env KEY
   # Notes:
@@ -60,7 +200,8 @@ expand_home_path() {
 }
 
 resolve_happy_local_dir() {
-  local home="${HAPPY_STACKS_HOME_DIR:-$HOME/.happy-stacks}"
+  local canonical="${HAPPY_STACKS_CANONICAL_HOME_DIR:-${HAPPY_LOCAL_CANONICAL_HOME_DIR:-$HOME/.happy-stacks}}"
+  local home="${HAPPY_STACKS_HOME_DIR:-${HAPPY_LOCAL_DIR:-$canonical}}"
 
   # If user provided a valid directory, keep it.
   if [[ -n "${HAPPY_LOCAL_DIR:-}" ]] && [[ -f "$HAPPY_LOCAL_DIR/extras/swiftbar/lib/utils.sh" ]]; then
@@ -103,6 +244,12 @@ resolve_stacks_storage_root() {
     return
   fi
 
+  # In sandbox mode, avoid falling back to the user's real ~/.happy/stacks.
+  if swiftbar_is_sandboxed; then
+    echo "${HAPPY_STACKS_STORAGE_DIR:-${HAPPY_STACKS_SANDBOX_DIR%/}/storage}"
+    return
+  fi
+
   echo "$HOME/.happy/stacks"
 }
 
@@ -117,18 +264,22 @@ resolve_stack_env_file() {
     return
   fi
 
-  local legacy="$HOME/.happy/local/stacks/${stack_name}/env"
-  if [[ -f "$legacy" ]]; then
-    echo "$legacy"
-    return
+  if ! swiftbar_is_sandboxed; then
+    local legacy="$HOME/.happy/local/stacks/${stack_name}/env"
+    if [[ -f "$legacy" ]]; then
+      echo "$legacy"
+      return
+    fi
   fi
 
   # Very old single-stack location (best-effort).
-  if [[ "$stack_name" == "main" ]]; then
-    local legacy_single="$HOME/.happy/local/env"
-    if [[ -f "$legacy_single" ]]; then
-      echo "$legacy_single"
-      return
+  if ! swiftbar_is_sandboxed; then
+    if [[ "$stack_name" == "main" ]]; then
+      local legacy_single="$HOME/.happy/local/env"
+      if [[ -f "$legacy_single" ]]; then
+        echo "$legacy_single"
+        return
+      fi
     fi
   fi
 
@@ -179,6 +330,11 @@ resolve_stack_label() {
     primary="com.happy.stacks.${stack_name}"
     legacy="com.happy.local.${stack_name}"
   fi
+  if swiftbar_is_sandboxed; then
+    # Never inspect global LaunchAgents in sandbox mode.
+    echo "$primary"
+    return
+  fi
   local primary_plist="$HOME/Library/LaunchAgents/${primary}.plist"
   local legacy_plist="$HOME/Library/LaunchAgents/${legacy}.plist"
   if [[ -f "$primary_plist" ]]; then
@@ -208,10 +364,12 @@ resolve_pnpm_bin() {
   fi
 
   local global_happys
-  global_happys="$(command -v happys 2>/dev/null || true)"
-  if [[ -n "$global_happys" ]]; then
-    echo "$global_happys"
-    return
+  if ! swiftbar_is_sandboxed; then
+    global_happys="$(command -v happys 2>/dev/null || true)"
+    if [[ -n "$global_happys" ]]; then
+      echo "$global_happys"
+      return
+    fi
   fi
 
   echo ""
@@ -228,8 +386,9 @@ resolve_node_bin() {
     return
   fi
 
-  # Fall back to reading ~/.happy-stacks/.env (written by `happys init`).
-  local home="${HAPPY_STACKS_HOME_DIR:-$HOME/.happy-stacks}"
+  # Fall back to reading the canonical pointer env (written by `happys init`).
+  local canonical="${HAPPY_STACKS_CANONICAL_HOME_DIR:-${HAPPY_LOCAL_CANONICAL_HOME_DIR:-$HOME/.happy-stacks}}"
+  local home="${HAPPY_STACKS_HOME_DIR:-${HAPPY_LOCAL_DIR:-$canonical}}"
   local env_file="$home/.env"
   if [[ -f "$env_file" ]]; then
     local v
@@ -281,17 +440,19 @@ resolve_main_env_file() {
     echo "$main"
     return
   fi
-  # Legacy stacks location (pre-migration).
-  local legacy="$HOME/.happy/local/stacks/main/env"
-  if [[ -f "$legacy" ]]; then
-    echo "$legacy"
-    return
-  fi
-  # Very old single-stack location (best-effort).
-  local legacy_single="$HOME/.happy/local/env"
-  if [[ -f "$legacy_single" ]]; then
-    echo "$legacy_single"
-    return
+  if ! swiftbar_is_sandboxed; then
+    # Legacy stacks location (pre-migration).
+    local legacy="$HOME/.happy/local/stacks/main/env"
+    if [[ -f "$legacy" ]]; then
+      echo "$legacy"
+      return
+    fi
+    # Very old single-stack location (best-effort).
+    local legacy_single="$HOME/.happy/local/env"
+    if [[ -f "$legacy_single" ]]; then
+      echo "$legacy_single"
+      return
+    fi
   fi
   echo ""
 }
@@ -302,7 +463,8 @@ resolve_main_port() {
   # 2) main stack env
   # 3) home env.local
   # 4) home .env
-  # 4) fallback to HAPPY_LOCAL_PORT / 3005
+  # 5) runtime state (ephemeral stacks)
+  # 6) fallback to HAPPY_LOCAL_PORT / 3005
   if [[ -n "${HAPPY_LOCAL_SERVER_PORT:-}" ]]; then
     echo "$HAPPY_LOCAL_SERVER_PORT"
     return
@@ -338,9 +500,98 @@ resolve_main_port() {
     return
   fi
 
+  # Runtime-only port overlay (ephemeral stacks): best-effort.
+  local base_dir state_file
+  base_dir="$(resolve_stack_base_dir main "$env_file")"
+  state_file="${base_dir}/stack.runtime.json"
+  p="$(resolve_runtime_server_port_from_state_file "$state_file")"
+  if [[ -n "$p" ]]; then
+    echo "$p"
+    return
+  fi
+
   echo "${HAPPY_LOCAL_PORT:-3005}"
 }
 
+resolve_runtime_server_port_from_state_file() {
+  # Reads stack.runtime.json and returns ports.server, but only if ownerPid is alive.
+  # Output: port number or empty.
+  local state_file="$1"
+  [[ -n "$state_file" && -f "$state_file" ]] || return 0
+
+  local owner="" port=""
+
+  # Fast-path: parse our own JSON shape without spawning node (best-effort).
+  if command -v grep >/dev/null 2>&1; then
+    owner="$(grep -oE '"ownerPid"[[:space:]]*:[[:space:]]*[0-9]+' "$state_file" 2>/dev/null | head -1 | grep -oE '[0-9]+' || true)"
+    port="$(grep -oE '"server"[[:space:]]*:[[:space:]]*[0-9]+' "$state_file" 2>/dev/null | head -1 | grep -oE '[0-9]+' || true)"
+  fi
+
+  if [[ -z "$owner" || -z "$port" ]]; then
+    local node_bin
+    node_bin="$(resolve_node_bin)"
+    if [[ -n "$node_bin" && -x "$node_bin" ]]; then
+      local out
+      out="$(
+        "$node_bin" -e '
+          const fs=require("fs");
+          try {
+            const s=JSON.parse(fs.readFileSync(process.argv[1],"utf8"));
+            const owner=String(s?.ownerPid ?? "");
+            const port=String(s?.ports?.server ?? "");
+            process.stdout.write(owner + "\t" + port);
+          } catch { process.stdout.write("\t"); }
+        ' "$state_file" 2>/dev/null || true
+      )"
+      IFS=$'\t' read -r owner port <<<"$out"
+    elif command -v python3 >/dev/null 2>&1; then
+      local out
+      out="$(
+        python3 -c 'import json,sys; 
+try:
+  s=json.load(open(sys.argv[1],"r"))
+  owner=str(s.get("ownerPid",""))
+  port=str((s.get("ports") or {}).get("server",""))
+  print(owner+"\\t"+port,end="")
+except Exception:
+  print("\\t",end="")' "$state_file" 2>/dev/null || true
+      )"
+      IFS=$'\t' read -r owner port <<<"$out"
+    fi
+  fi
+
+  [[ "$owner" =~ ^[0-9]+$ ]] || owner=""
+  [[ "$port" =~ ^[0-9]+$ ]] || port=""
+  if [[ -n "$owner" ]] && kill -0 "$owner" 2>/dev/null; then
+    echo "$port"
+  fi
+}
+
+resolve_stack_server_port() {
+  # Usage: resolve_stack_server_port <stack_name> <env_file>
+  # Priority:
+  # - pinned port in env file
+  # - runtime port in stack.runtime.json (only if ownerPid alive)
+  local stack_name="${1:-main}"
+  local env_file="${2:-}"
+
+  local p=""
+  if [[ -n "$env_file" && -f "$env_file" ]]; then
+    p="$(dotenv_get "$env_file" "HAPPY_STACKS_SERVER_PORT")"
+    [[ -z "$p" ]] && p="$(dotenv_get "$env_file" "HAPPY_LOCAL_SERVER_PORT")"
+  fi
+  if [[ -n "$p" ]]; then
+    echo "$p"
+    return
+  fi
+
+  local base_dir state_file
+  base_dir="$(resolve_stack_base_dir "$stack_name" "$env_file")"
+  state_file="${base_dir}/stack.runtime.json"
+  p="$(resolve_runtime_server_port_from_state_file "$state_file")"
+  echo "$p"
+}
+
 resolve_main_server_component() {
   if [[ -n "${HAPPY_LOCAL_SERVER_COMPONENT:-}" ]]; then
     echo "$HAPPY_LOCAL_SERVER_COMPONENT"
@@ -379,3 +630,35 @@ resolve_main_server_component() {
 
   echo "happy-server-light"
 }
+
+resolve_menubar_mode() {
+  # selfhost | dev (default: dev)
+  local raw=""
+  if [[ -n "${HAPPY_LOCAL_MENUBAR_MODE:-}" ]]; then
+    raw="$HAPPY_LOCAL_MENUBAR_MODE"
+  elif [[ -n "${HAPPY_STACKS_MENUBAR_MODE:-}" ]]; then
+    raw="$HAPPY_STACKS_MENUBAR_MODE"
+  fi
+
+  local env_file
+  env_file="$(resolve_main_env_file)"
+  if [[ -z "$raw" && -n "$env_file" ]]; then
+    raw="$(dotenv_get "$env_file" "HAPPY_LOCAL_MENUBAR_MODE")"
+    [[ -z "$raw" ]] && raw="$(dotenv_get "$env_file" "HAPPY_STACKS_MENUBAR_MODE")"
+  fi
+
+  if [[ -z "$raw" ]]; then
+    raw="$(dotenv_get "$HAPPY_LOCAL_DIR/env.local" "HAPPY_LOCAL_MENUBAR_MODE")"
+    [[ -z "$raw" ]] && raw="$(dotenv_get "$HAPPY_LOCAL_DIR/env.local" "HAPPY_STACKS_MENUBAR_MODE")"
+  fi
+  if [[ -z "$raw" ]]; then
+    raw="$(dotenv_get "$HAPPY_LOCAL_DIR/.env" "HAPPY_LOCAL_MENUBAR_MODE")"
+    [[ -z "$raw" ]] && raw="$(dotenv_get "$HAPPY_LOCAL_DIR/.env" "HAPPY_STACKS_MENUBAR_MODE")"
+  fi
+
+  raw="$(echo "${raw:-}" | tr '[:upper:]' '[:lower:]' | tr -d '[:space:]')"
+  case "$raw" in
+    selfhost|self-host|self_host|host) echo "selfhost" ;;
+    *) echo "dev" ;;
+  esac
+}

package/extras/swiftbar/pnpm.sh

@@ -4,7 +4,8 @@ set -euo pipefail
 # Back-compat wrapper for SwiftBar menu actions.
 # Historically this executed `pnpm`; now it delegates to `happys.sh`.
 
-HAPPY_STACKS_HOME_DIR="${HAPPY_STACKS_HOME_DIR:-$HOME/.happy-stacks}"
+CANONICAL_HOME_DIR="${HAPPY_STACKS_CANONICAL_HOME_DIR:-${HAPPY_LOCAL_CANONICAL_HOME_DIR:-$HOME/.happy-stacks}}"
+HAPPY_STACKS_HOME_DIR="${HAPPY_STACKS_HOME_DIR:-$CANONICAL_HOME_DIR}"
 HAPPY_LOCAL_DIR="${HAPPY_LOCAL_DIR:-$HAPPY_STACKS_HOME_DIR}"
 
 exec "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/happys.sh" "$@"

package/extras/swiftbar/set-interval.sh

@@ -26,13 +26,18 @@ if [[ -z "$PLUGIN_DIR" ]]; then
 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}"
+PLUGIN_BASENAME="${HAPPY_STACKS_SWIFTBAR_PLUGIN_BASENAME:-${HAPPY_LOCAL_SWIFTBAR_PLUGIN_BASENAME:-happy-stacks}}"
+TARGET="$PLUGIN_DIR/${PLUGIN_BASENAME}.${INTERVAL}.sh"
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+DEFAULT_HOME_DIR="$(cd "$SCRIPT_DIR/../.." && pwd)"
+
+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}"
 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)"
+EXISTING="$(ls "$PLUGIN_DIR"/"${PLUGIN_BASENAME}".*.sh 2>/dev/null | head -1 || true)"
 if [[ -n "$EXISTING" ]]; then
   if [[ "$EXISTING" != "$TARGET" ]]; then
     rm -f "$TARGET"
@@ -47,7 +52,7 @@ else
 fi
 
 # Remove any other intervals to avoid duplicates in SwiftBar.
-for f in "$PLUGIN_DIR"/happy-stacks.*.sh; do
+for f in "$PLUGIN_DIR"/"${PLUGIN_BASENAME}".*.sh; do
   [[ "$f" == "$TARGET" ]] && continue
   rm -f "$f" || true
 done

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

@@ -24,8 +24,11 @@ if [[ "$FLAVOR" != "happy-server" && "$FLAVOR" != "happy-server-light" ]]; then
   exit 2
 fi
 
-HAPPY_STACKS_HOME_DIR="${HAPPY_STACKS_HOME_DIR:-$HOME/.happy-stacks}"
-HAPPY_LOCAL_DIR="${HAPPY_LOCAL_DIR:-$HAPPY_STACKS_HOME_DIR}"
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+DEFAULT_HOME_DIR="$(cd "$SCRIPT_DIR/../.." && pwd)"
+
+HAPPY_LOCAL_DIR="${HAPPY_LOCAL_DIR:-${HAPPY_STACKS_HOME_DIR:-$DEFAULT_HOME_DIR}}"
+HAPPY_STACKS_HOME_DIR="${HAPPY_STACKS_HOME_DIR:-$HAPPY_LOCAL_DIR}"
 
 HAPPYS_BIN="$HAPPY_LOCAL_DIR/extras/swiftbar/happys.sh"
 if [[ ! -x "$HAPPYS_BIN" ]]; then
@@ -34,6 +37,9 @@ if [[ ! -x "$HAPPYS_BIN" ]]; then
 fi
 
 restart_main_service_best_effort() {
+  if [[ -n "${HAPPY_STACKS_SANDBOX_DIR:-}" ]]; then
+    return 0
+  fi
   "$HAPPYS_BIN" service:restart >/dev/null 2>&1 || true
   # If the installed LaunchAgent is still legacy/baked, reinstall so it persists only env-file pointer.
   "$HAPPYS_BIN" service:install >/dev/null 2>&1 || true
@@ -41,6 +47,9 @@ restart_main_service_best_effort() {
 
 restart_stack_service_best_effort() {
   local name="$1"
+  if [[ -n "${HAPPY_STACKS_SANDBOX_DIR:-}" ]]; then
+    return 0
+  fi
   "$HAPPYS_BIN" stack service:restart "$name" >/dev/null 2>&1 || true
   "$HAPPYS_BIN" stack service:install "$name" >/dev/null 2>&1 || true
 }

package/extras/swiftbar/wt-pr.sh

@@ -17,11 +17,18 @@ set -euo pipefail
 COMPONENT="${1:-}"
 STACK_NAME="${2:-}"
 
-HAPPY_STACKS_HOME_DIR="${HAPPY_STACKS_HOME_DIR:-$HOME/.happy-stacks}"
-HAPPY_LOCAL_DIR="${HAPPY_LOCAL_DIR:-$HAPPY_STACKS_HOME_DIR}"
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+DEFAULT_HOME_DIR="$(cd "$SCRIPT_DIR/../.." && pwd)"
+
+HAPPY_LOCAL_DIR="${HAPPY_LOCAL_DIR:-${HAPPY_STACKS_HOME_DIR:-$DEFAULT_HOME_DIR}}"
+HAPPY_STACKS_HOME_DIR="${HAPPY_STACKS_HOME_DIR:-$HAPPY_LOCAL_DIR}"
 
 HAPPYS="$HAPPY_LOCAL_DIR/extras/swiftbar/happys.sh"
 if [[ ! -x "$HAPPYS" ]]; then
+  if [[ -n "${HAPPY_STACKS_SANDBOX_DIR:-}" ]]; then
+    echo "missing happys wrapper in sandbox: $HAPPYS" >&2
+    exit 1
+  fi
   HAPPYS="$(command -v happys 2>/dev/null || true)"
 fi
 if [[ -z "$HAPPYS" ]]; then

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "happy-stacks",
   "type": "module",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "packageManager": "pnpm@10.18.3",
   "bin": {
     "happys": "./bin/happys.mjs",
@@ -14,6 +14,7 @@
     "scripts/"
   ],
   "scripts": {
+    "setup": "node ./scripts/setup.mjs",
     "init": "node ./scripts/init.mjs",
     "uninstall": "node ./scripts/uninstall.mjs",
     "where": "node ./scripts/where.mjs",