1#!/usr/bin/env bash
2# Start the brainstorm server and output connection info
3# Usage: start-server.sh [--project-dir <path>] [--host <bind-host>] [--url-host <display-host>] [--foreground] [--background]
4#
5# Starts server on a random high port, outputs JSON with URL.
6# Each session gets its own directory to avoid conflicts.
7#
8# Options:
9#   --project-dir <path>  Store session files under <path>/.superpowers/brainstorm/
10#                         instead of /tmp. Files persist after server stops.
11#   --host <bind-host>    Host/interface to bind (default: 127.0.0.1).
12#                         Use 0.0.0.0 in remote/containerized environments.
13#   --url-host <host>     Hostname shown in returned URL JSON.
14#   --idle-timeout-minutes <n>  Shut down after n minutes idle (default 240 = 4h).
15#   --open                Auto-open the browser on the first screen (use only
16#                         after the user approves the visual companion).
17#   --foreground          Run server in the current terminal (no backgrounding).
18#   --background          Force background mode (overrides Codex auto-foreground).
19 
20SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
21 
22# Parse arguments
23PROJECT_DIR=""
24FOREGROUND="false"
25FORCE_BACKGROUND="false"
26BIND_HOST="127.0.0.1"
27URL_HOST=""
28IDLE_TIMEOUT_MINUTES=""
29while [[ $# -gt 0 ]]; do
30  case "$1" in
31    --project-dir)
32      PROJECT_DIR="$2"
33      shift 2
34      ;;
35    --host)
36      BIND_HOST="$2"
37      shift 2
38      ;;
39    --url-host)
40      URL_HOST="$2"
41      shift 2
42      ;;
43    --idle-timeout-minutes)
44      IDLE_TIMEOUT_MINUTES="$2"
45      shift 2
46      ;;
47    --open)
48      export BRAINSTORM_OPEN=1
49      shift
50      ;;
51    --foreground|--no-daemon)
52      FOREGROUND="true"
53      shift
54      ;;
55    --background|--daemon)
56      FORCE_BACKGROUND="true"
57      shift
58      ;;
59    *)
60      echo "{\"error\": \"Unknown argument: $1\"}"
61      exit 1
62      ;;
63  esac
64done
65 
66if [[ -z "$URL_HOST" ]]; then
67  if [[ "$BIND_HOST" == "127.0.0.1" || "$BIND_HOST" == "localhost" ]]; then
68    URL_HOST="localhost"
69  else
70    URL_HOST="$BIND_HOST"
71  fi
72fi
73 
74if [[ -n "$IDLE_TIMEOUT_MINUTES" ]]; then
75  if ! [[ "$IDLE_TIMEOUT_MINUTES" =~ ^[0-9]+$ ]] || [[ "$IDLE_TIMEOUT_MINUTES" -lt 1 ]]; then
76    echo "{\"error\": \"--idle-timeout-minutes must be a positive integer\"}"
77    exit 1
78  fi
79  export BRAINSTORM_IDLE_TIMEOUT_MS=$(( IDLE_TIMEOUT_MINUTES * 60 * 1000 ))
80fi
81 
82is_windows_like_shell() {
83  case "${OSTYPE:-}" in
84    msys*|cygwin*|mingw*) return 0 ;;
85  esac
86  if [[ -n "${MSYSTEM:-}" ]]; then
87    return 0
88  fi
89  local uname_s
90  uname_s="$(uname -s 2>/dev/null || true)"
91  case "$uname_s" in
92    MSYS*|MINGW*|CYGWIN*) return 0 ;;
93  esac
94  return 1
95}
96 
97# Some environments reap detached/background processes. Auto-foreground when detected.
98if [[ -n "${CODEX_CI:-}" && "$FOREGROUND" != "true" && "$FORCE_BACKGROUND" != "true" ]]; then
99  FOREGROUND="true"
100fi
101 
102# Windows/Git Bash reaps nohup background processes. Auto-foreground when detected.
103if [[ "$FOREGROUND" != "true" && "$FORCE_BACKGROUND" != "true" ]]; then
104  if is_windows_like_shell; then
105    FOREGROUND="true"
106  fi
107fi
108 
109# Session files (server.log, server-info, .last-token) embed the session key —
110# keep everything this script and the server create owner-only.
111umask 077
112 
113# Generate unique session directory
114SESSION_ID="$$-$(date +%s)"
115 
116if [[ -n "$PROJECT_DIR" ]]; then
117  SESSION_DIR="${PROJECT_DIR}/.superpowers/brainstorm/${SESSION_ID}"
118  # Persist the bound port and key per project so a restart reuses them and an
119  # already-open browser tab reconnects to the same URL with a valid cookie.
120  export BRAINSTORM_PORT_FILE="${PROJECT_DIR}/.superpowers/brainstorm/.last-port"
121  export BRAINSTORM_TOKEN_FILE="${PROJECT_DIR}/.superpowers/brainstorm/.last-token"
122else
123  SESSION_DIR="/tmp/brainstorm-${SESSION_ID}"
124fi
125 
126STATE_DIR="${SESSION_DIR}/state"
127PID_FILE="${STATE_DIR}/server.pid"
128LOG_FILE="${STATE_DIR}/server.log"
129SERVER_ID_FILE="${STATE_DIR}/server-instance-id"
130 
131# Create fresh session directory with content and state peers
132mkdir -p "${SESSION_DIR}/content" "$STATE_DIR"
133 
134SERVER_ID=""
135if [[ -r /dev/urandom ]]; then
136  SERVER_ID="$(od -An -N24 -tx1 /dev/urandom 2>/dev/null | tr -d ' \n' || true)"
137fi
138if ! [[ "$SERVER_ID" =~ ^[A-Za-z0-9_-]{32,64}$ ]]; then
139  SERVER_ID="$(printf '%08x%08x%08x%08x' "$$" "$(date +%s)" "${RANDOM:-0}" "${RANDOM:-0}")"
140fi
141printf '%s\n' "$SERVER_ID" > "$SERVER_ID_FILE"
142chmod 600 "$SERVER_ID_FILE" 2>/dev/null || true
143 
144# Kill any existing server
145if [[ -f "$PID_FILE" ]]; then
146  old_pid=$(cat "$PID_FILE")
147  kill "$old_pid" 2>/dev/null
148  rm -f "$PID_FILE"
149fi
150 
151cd "$SCRIPT_DIR" || exit 1
152 
153# Resolve the harness PID (grandparent of this script).
154# $PPID is the ephemeral shell the harness spawned to run us — it dies
155# when this script exits. The harness itself is $PPID's parent.
156OWNER_PID="$(ps -o ppid= -p "$PPID" 2>/dev/null | tr -d ' ')"
157if [[ -z "$OWNER_PID" || "$OWNER_PID" == "1" ]]; then
158  OWNER_PID="$PPID"
159fi
160 
161# Windows/MSYS2: Node.js cannot see POSIX PIDs from the MSYS2 namespace.
162# Passing a PID node cannot verify causes server to log owner-pid-invalid
163# and self-terminate at the 60-second lifecycle check. Clear it so the
164# watchdog is disabled and the idle timeout becomes the only shutdown trigger.
165if is_windows_like_shell; then
166  OWNER_PID=""
167fi
168 
169# Foreground mode for environments that reap detached/background processes.
170if [[ "$FOREGROUND" == "true" ]]; then
171  env BRAINSTORM_DIR="$SESSION_DIR" BRAINSTORM_HOST="$BIND_HOST" BRAINSTORM_URL_HOST="$URL_HOST" BRAINSTORM_OWNER_PID="$OWNER_PID" node server.cjs "--brainstorm-server-id=$SERVER_ID" &
172  SERVER_PID=$!
173  echo "$SERVER_PID" > "$PID_FILE"
174  wait "$SERVER_PID"
175  exit $?
176fi
177 
178# Start server, capturing output to log file
179# Use nohup to survive shell exit; disown to remove from job table
180nohup env BRAINSTORM_DIR="$SESSION_DIR" BRAINSTORM_HOST="$BIND_HOST" BRAINSTORM_URL_HOST="$URL_HOST" BRAINSTORM_OWNER_PID="$OWNER_PID" node server.cjs "--brainstorm-server-id=$SERVER_ID" > "$LOG_FILE" 2>&1 &
181SERVER_PID=$!
182disown "$SERVER_PID" 2>/dev/null
183echo "$SERVER_PID" > "$PID_FILE"
184 
185# Wait for server-started message (check log file)
186for _ in {1..50}; do
187  if grep -q "server-started" "$LOG_FILE" 2>/dev/null; then
188    # Verify server is still alive after a short window (catches process reapers)
189    alive="true"
190    for _ in {1..20}; do
191      if ! kill -0 "$SERVER_PID" 2>/dev/null; then
192        alive="false"
193        break
194      fi
195      sleep 0.1
196    done
197    if [[ "$alive" != "true" ]]; then
198      echo "{\"error\": \"Server started but was killed. Retry in a persistent terminal with: $SCRIPT_DIR/start-server.sh${PROJECT_DIR:+ --project-dir $PROJECT_DIR} --host $BIND_HOST --url-host $URL_HOST --foreground\"}"
199      exit 1
200    fi
201    grep "server-started" "$LOG_FILE" | head -1
202    exit 0
203  fi
204  sleep 0.1
205done
206 
207# Timeout - server didn't start
208echo '{"error": "Server failed to start within 5 seconds"}'
209exit 1
210