feat(scripts): improve dev.sh with spinner UI and better process

management

- Add spinner animation while waiting for web server - Log all process
output to debug/proc/*.log - Add timeout protection for web server
startup - Clean up all processes (web, studio, sdk) on exit - Use
consistent bun --cwd format for all commands - Add start-cli script to
package.json

Author: brandonkachen

package.json

@@ -18,6 +18,7 @@
   ],
   "scripts": {
     "dev": "bash scripts/dev.sh",
+    "start-cli": "bun --cwd cli dev",
     "start-db": "bun --cwd packages/internal db:start",
     "start-web": "bun start-db && bun --cwd web dev",
     "start-studio": "bun --cwd packages/internal db:studio",

scripts/dev.sh

@@ -1,45 +1,112 @@
 #!/bin/bash
 
-# Get the project root directory
+# =============================================================================
+# Development Environment Startup Script
+# =============================================================================
+
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 PROJECT_ROOT="$(dirname "$SCRIPT_DIR")"
-
-# Ensure .bin/bun is in PATH first so environment variables are loaded
 export PATH="$PROJECT_ROOT/.bin:$PATH"
 
-# Enable job control and set up trap for cleanup
-set -m
-READY_FILE="/tmp/codebuff_server_ready_$$"
-trap 'kill -TERM -$SERVER_PID 2>/dev/null; rm -f "$READY_FILE"; exit' EXIT INT TERM
-
-# Start the server in background
-echo "Starting server..."
-bun start-web 2>&1 | tee >(grep -m 1 "  - Local:        http://localhost:3000" > /dev/null && touch "$READY_FILE") &
-SERVER_PID=$!
-
-# Wait for the ready signal
-echo "Waiting for server to be ready..."
-while [[ ! -f "$READY_FILE" ]]; do
-    # Check if server process is still running
-    if ! kill -0 $SERVER_PID 2>/dev/null; then
-        echo "Server process died unexpectedly"
-        exit 1
+LOG_DIR="$PROJECT_ROOT/debug/proc"
+mkdir -p "$LOG_DIR"
+
+# =============================================================================
+# UI Helpers
+# =============================================================================
+
+SPINNER_FRAMES=('⠋' '⠙' '⠹' '⠸' '⠼' '⠴' '⠦' '⠧' '⠇' '⠏')
+
+# Print a success line
+ok() {
+    printf "  \033[32m✓\033[0m %-10s %s\033[K\n" "$1" "$2"
+}
+
+# Wait for a pattern in a log file, with spinner animation
+wait_for_log() {
+    local name="$1"
+    local pattern="$2"
+    local timeout="${3:-60}"
+    local frame=0
+    local elapsed=0
+    
+    printf "\033[?25l"  # Hide cursor
+    printf "  %s %-10s starting...\n" "${SPINNER_FRAMES[0]}" "$name"
+    
+    while ! grep -q "$pattern" "$LOG_DIR/$name.log" 2>/dev/null; do
+        printf "\033[1A"  # Move up one line
+        printf "  %s %-10s starting...\033[K\n" "${SPINNER_FRAMES[$frame]}" "$name"
+        
+        frame=$(( (frame + 1) % ${#SPINNER_FRAMES[@]} ))
+        sleep 0.1
+        elapsed=$(( elapsed + 1 ))
+        
+        if (( elapsed > timeout * 10 )); then
+            printf "\033[?25h"  # Show cursor
+            echo "Timeout waiting for $name" >&2
+            return 1
+        fi
+    done
+    
+    printf "\033[1A"  # Move up one line
+    ok "$name" "ready!"
+    printf "\033[?25h"  # Show cursor
+}
+
+# =============================================================================
+# Cleanup
+# =============================================================================
+
+kill_proc() {
+    local name="$1"
+    local pattern="$2"
+    if pkill -f "$pattern" 2>/dev/null; then
+        echo "[$(date '+%H:%M:%S')] Killed $name" >> "$LOG_DIR/$name.log"
+        return 0
     fi
-    sleep 0.1
-done
+    return 1
+}
+
+cleanup() {
+    printf "\033[?25h"  # Restore cursor
+    echo ""
+    echo "Shutting down..."
+    echo ""
+    
+    kill_proc "web" 'bun.*--cwd web dev' || kill_proc "web" 'next-server'
+    ok "web" "stopped"
+    
+    kill_proc "studio" 'drizzle-kit studio' && ok "studio" "stopped"
+    kill_proc "sdk" 'bun.*--cwd sdk' && ok "sdk" "stopped"
+    
+    echo ""
+}
+trap cleanup EXIT INT TERM
+
+# =============================================================================
+# Start Processes
+# =============================================================================
+
+echo "Starting development environment..."
+echo ""
 
-echo "Server is ready! Building SDK..."
+# 1. Database (blocking)
+printf "  %s %-10s starting...\r" "${SPINNER_FRAMES[0]}" "db"
+bun --cwd packages/internal db:start > "$LOG_DIR/db.log" 2>&1
+ok "db" "ready!"
 
-if ! bun --cwd=sdk run build; then
-    echo "Failed to build SDK. Stopping server..."
-    kill -TERM -$SERVER_PID 2>/dev/null
-    exit 1
-fi
+# 2. Background processes (fire and forget)
+bun --cwd sdk run build > "$LOG_DIR/sdk.log" 2>&1 &
+ok "sdk" "(background)"
 
-echo "Starting client..."
+bun --cwd packages/internal db:studio > "$LOG_DIR/studio.log" 2>&1 &
+ok "studio" "(background)"
 
-# Clean up the signal file
-rm -f "$READY_FILE"
+# 3. Web server (wait for ready)
+bun --cwd web dev > "$LOG_DIR/web.log" 2>&1 &
+wait_for_log "web" "Ready in" 60
 
-# Start the client
+# 4. CLI
+echo ""
+echo "Starting CLI..."
 bun --cwd cli dev "$@"