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#   --foreground          Run server in the current terminal (no backgrounding).
15#   --background          Force background mode (overrides Codex auto-foreground).
16 
17SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
18 
19# Parse arguments
20PROJECT_DIR=""
21FOREGROUND="false"
22FORCE_BACKGROUND="false"
23BIND_HOST="127.0.0.1"
24URL_HOST=""
25while [[ $# -gt 0 ]]; do
26  case "$1" in
27    --project-dir)
28      PROJECT_DIR="$2"
29      shift 2
30      ;;
31    --host)
32      BIND_HOST="$2"
33      shift 2
34      ;;
35    --url-host)
36      URL_HOST="$2"
37      shift 2
38      ;;
39    --foreground|--no-daemon)
40      FOREGROUND="true"
41      shift
42      ;;
43    --background|--daemon)
44      FORCE_BACKGROUND="true"
45      shift
46      ;;
47    *)
48      echo "{\"error\": \"Unknown argument: $1\"}"
49      exit 1
50      ;;
51  esac
52done
53 
54if [[ -z "$URL_HOST" ]]; then
55  if [[ "$BIND_HOST" == "127.0.0.1" || "$BIND_HOST" == "localhost" ]]; then
56    URL_HOST="localhost"
57  else
58    URL_HOST="$BIND_HOST"
59  fi
60fi
61 
62# Some environments reap detached/background processes. Auto-foreground when detected.
63if [[ -n "${CODEX_CI:-}" && "$FOREGROUND" != "true" && "$FORCE_BACKGROUND" != "true" ]]; then
64  FOREGROUND="true"
65fi
66 
67# Windows/Git Bash reaps nohup background processes. Auto-foreground when detected.
68if [[ "$FOREGROUND" != "true" && "$FORCE_BACKGROUND" != "true" ]]; then
69  case "${OSTYPE:-}" in
70    msys*|cygwin*|mingw*) FOREGROUND="true" ;;
71  esac
72  if [[ -n "${MSYSTEM:-}" ]]; then
73    FOREGROUND="true"
74  fi
75fi
76 
77# Generate unique session directory
78SESSION_ID="$$-$(date +%s)"
79 
80if [[ -n "$PROJECT_DIR" ]]; then
81  SESSION_DIR="${PROJECT_DIR}/.superpowers/brainstorm/${SESSION_ID}"
82else
83  SESSION_DIR="/tmp/brainstorm-${SESSION_ID}"
84fi
85 
86STATE_DIR="${SESSION_DIR}/state"
87PID_FILE="${STATE_DIR}/server.pid"
88LOG_FILE="${STATE_DIR}/server.log"
89 
90# Create fresh session directory with content and state peers
91mkdir -p "${SESSION_DIR}/content" "$STATE_DIR"
92 
93# Kill any existing server
94if [[ -f "$PID_FILE" ]]; then
95  old_pid=$(cat "$PID_FILE")
96  kill "$old_pid" 2>/dev/null
97  rm -f "$PID_FILE"
98fi
99 
100cd "$SCRIPT_DIR"
101 
102# Resolve the harness PID (grandparent of this script).
103# $PPID is the ephemeral shell the harness spawned to run us — it dies
104# when this script exits. The harness itself is $PPID's parent.
105OWNER_PID="$(ps -o ppid= -p "$PPID" 2>/dev/null | tr -d ' ')"
106if [[ -z "$OWNER_PID" || "$OWNER_PID" == "1" ]]; then
107  OWNER_PID="$PPID"
108fi
109 
110# Foreground mode for environments that reap detached/background processes.
111if [[ "$FOREGROUND" == "true" ]]; then
112  echo "$$" > "$PID_FILE"
113  env BRAINSTORM_DIR="$SESSION_DIR" BRAINSTORM_HOST="$BIND_HOST" BRAINSTORM_URL_HOST="$URL_HOST" BRAINSTORM_OWNER_PID="$OWNER_PID" node server.cjs
114  exit $?
115fi
116 
117# Start server, capturing output to log file
118# Use nohup to survive shell exit; disown to remove from job table
119nohup env BRAINSTORM_DIR="$SESSION_DIR" BRAINSTORM_HOST="$BIND_HOST" BRAINSTORM_URL_HOST="$URL_HOST" BRAINSTORM_OWNER_PID="$OWNER_PID" node server.cjs > "$LOG_FILE" 2>&1 &
120SERVER_PID=$!
121disown "$SERVER_PID" 2>/dev/null
122echo "$SERVER_PID" > "$PID_FILE"
123 
124# Wait for server-started message (check log file)
125for i in {1..50}; do
126  if grep -q "server-started" "$LOG_FILE" 2>/dev/null; then
127    # Verify server is still alive after a short window (catches process reapers)
128    alive="true"
129    for _ in {1..20}; do
130      if ! kill -0 "$SERVER_PID" 2>/dev/null; then
131        alive="false"
132        break
133      fi
134      sleep 0.1
135    done
136    if [[ "$alive" != "true" ]]; then
137      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\"}"
138      exit 1
139    fi
140    grep "server-started" "$LOG_FILE" | head -1
141    exit 0
142  fi
143  sleep 0.1
144done
145 
146# Timeout - server didn't start
147echo '{"error": "Server failed to start within 5 seconds"}'
148exit 1
149