Implement comprehensive startup automation and health monitoring

- Add startup.sh: Automated service orchestration with dependency management
- Add health-check.sh: Comprehensive service monitoring and diagnostics
- Update .gitpod/automations.yaml: Fix PostgreSQL service and add proper error handling
- Update .devcontainer/devcontainer.json: Add postStartCommand for automatic startup
- Update .devcontainer/setup.sh: Install required tools and make scripts executable
- Update README.md: Complete documentation with troubleshooting guide

Features:
- Automatic service startup on environment creation
- Port conflict resolution and cleanup
- Service dependency management (DB → Backend → Frontend)
- Health checks with detailed status reporting
- Error recovery and troubleshooting guidance
- Colored output and progress indicators

Co-authored-by: Ona <no-reply@ona.com>

Author: jrcoak

.devcontainer/devcontainer.json

@@ -28,6 +28,7 @@
     5432
   ],
   "postCreateCommand": ".devcontainer/setup.sh",
+  "postStartCommand": "./startup.sh",
   "customizations": {
     "vscode": {
       "extensions": [

.devcontainer/setup.sh

@@ -10,6 +10,16 @@ if ! command -v pg_isready &> /dev/null; then
     exit 1
 fi
 
+# Install jq if not present (for health checks)
+if ! command -v jq &> /dev/null; then
+    echo "📦 Installing jq for JSON processing..."
+    sudo apt-get update && sudo apt-get install -y jq
+fi
+
+# Make scripts executable
+chmod +x startup.sh 2>/dev/null || true
+chmod +x health-check.sh 2>/dev/null || true
+
 echo "✅ Setup completed successfully!" 
 
 # GitHub CLI authentication (optional)
@@ -19,3 +29,7 @@ if [ -n "$GH_CLI_TOKEN" ]; then
 else
     echo "ℹ️  GH_CLI_TOKEN not set, skipping authentication"
 fi
+
+echo "🔧 Available commands:"
+echo "   ./startup.sh      - Start all services"
+echo "   ./health-check.sh - Check service health"

.gitpod/automations.yaml

@@ -7,24 +7,43 @@ services:
       - postEnvironmentStart
     commands:
       start: |
-        # Force cleanup of any existing PostgreSQL containers
+        cd /workspaces/gitpodflix-demo/database/main
+        
+        # Clean up any existing containers that might conflict
         echo "Cleaning up any existing PostgreSQL containers..."
-        docker rm -f postgres 2>/dev/null || true
-        sleep 2  # Give Docker time to clean up
-
-        echo "Starting PostgreSQL with Docker..."
-        docker run --rm \
-          --name postgres \
-          -e POSTGRES_USER=gitpod \
-          -e POSTGRES_PASSWORD=gitpod \
-          -e POSTGRES_DB=gitpodflix \
-          -p 5432:5432 \
-          -v postgres_data:/var/lib/postgresql/data \
-          -v /workspaces/gitpodflix-demo/database/main/migrations:/docker-entrypoint-initdb.d \
-          postgres:15
+        docker stop main-postgres-1 2>/dev/null || true
+        docker rm main-postgres-1 2>/dev/null || true
+        docker stop postgres 2>/dev/null || true
+        docker rm postgres 2>/dev/null || true
+        
+        # Kill any process using port 5432
+        if lsof -Pi :5432 -sTCP:LISTEN -t >/dev/null 2>&1; then
+          echo "Killing process on port 5432..."
+          kill -9 $(lsof -ti:5432) 2>/dev/null || true
+          sleep 3
+        fi
+        
+        echo "Starting PostgreSQL with docker-compose..."
+        docker-compose up -d
+        
+        # Wait for container to be healthy
+        echo "Waiting for PostgreSQL to be healthy..."
+        for i in {1..30}; do
+          if docker-compose ps | grep -q "healthy"; then
+            echo "PostgreSQL container is healthy"
+            break
+          fi
+          if [ $i -eq 30 ]; then
+            echo "Timeout waiting for PostgreSQL to be healthy"
+            docker-compose logs
+            exit 1
+          fi
+          echo "Waiting... attempt $i/30"
+          sleep 2
+        done
 
       ready: |
-        if docker exec postgres pg_isready -U gitpod; then
+        if PGPASSWORD=gitpod psql -h localhost -U gitpod -d gitpodflix -c "SELECT 1" >/dev/null 2>&1; then
           echo "PostgreSQL is ready and accepting connections"
           exit 0
         else
@@ -33,10 +52,9 @@ services:
         fi
 
       stop: |
-        echo "Stopping PostgreSQL container..."
-        docker stop postgres || true
-        echo "Removing PostgreSQL container..."
-        docker rm -f postgres || true
+        cd /workspaces/gitpodflix-demo/database/main
+        echo "Stopping PostgreSQL with docker-compose..."
+        docker-compose down
 
   catalog:
     name: "Catalog Service"
@@ -48,26 +66,47 @@ services:
       start: |
         cd /workspaces/gitpodflix-demo/backend/catalog
         
+        # Kill any existing process on port 3001
+        if lsof -Pi :3001 -sTCP:LISTEN -t >/dev/null 2>&1; then
+          echo "Killing existing process on port 3001..."
+          kill -9 $(lsof -ti:3001) 2>/dev/null || true
+          sleep 2
+        fi
+        
+        # Create .env file if it doesn't exist
+        if [ ! -f .env ]; then
+          echo "Creating .env file..."
+          cat > .env << EOF
+        DB_HOST=localhost
+        DB_USER=gitpod
+        DB_PASSWORD=gitpod
+        DB_NAME=gitpodflix
+        DB_PORT=5432
+        PORT=3001
+        EOF
+        fi
+        
         # Ensure dependencies are installed
-        echo "Ensuring dependencies are installed..."
+        echo "Installing dependencies..."
         npm install
         
-        # Wait for ts-node to be available
-        echo "Waiting for ts-node to be available..."
-        for i in {1..30}; do
-          if [ -f "node_modules/.bin/ts-node" ]; then
-            echo "✓ ts-node is available"
+        # Wait for PostgreSQL to be ready before starting
+        echo "Waiting for PostgreSQL to be ready..."
+        for i in {1..60}; do
+          if PGPASSWORD=gitpod psql -h localhost -U gitpod -d gitpodflix -c "SELECT 1" >/dev/null 2>&1; then
+            echo "✓ PostgreSQL is ready"
             break
           fi
-          if [ $i -eq 30 ]; then
-            echo "✗ Timeout waiting for ts-node"
+          if [ $i -eq 60 ]; then
+            echo "✗ Timeout waiting for PostgreSQL"
             exit 1
           fi
-          echo "Waiting for ts-node... attempt $i/30"
-          sleep 1
+          echo "Waiting for PostgreSQL... attempt $i/60"
+          sleep 2
         done
         
-        PORT=3001 npm run dev
+        echo "Starting catalog service..."
+        npm run dev
       ready: |
         if curl -s http://localhost:3001/health > /dev/null; then
           echo "Catalog service is ready"
@@ -77,6 +116,9 @@ services:
           exit 1
         fi
       stop: |
+        if lsof -Pi :3001 -sTCP:LISTEN -t >/dev/null 2>&1; then
+          kill -9 $(lsof -ti:3001) 2>/dev/null || true
+        fi
         pkill -f "node.*catalog" || true
 
   gitpod-flix:
@@ -89,22 +131,34 @@ services:
       start: |
         cd /workspaces/gitpodflix-demo/frontend
 
-        # Wait for vite to be available
-        echo "Waiting for vite to be available..."
-        for i in {1..30}; do
-          if command -v vite >/dev/null 2>&1 || [ -f "node_modules/.bin/vite" ]; then
-            echo "✓ vite is available"
+        # Kill any existing process on port 3000
+        if lsof -Pi :3000 -sTCP:LISTEN -t >/dev/null 2>&1; then
+          echo "Killing existing process on port 3000..."
+          kill -9 $(lsof -ti:3000) 2>/dev/null || true
+          sleep 2
+        fi
+
+        # Install dependencies
+        echo "Installing frontend dependencies..."
+        npm install
+
+        # Wait for backend to be ready before starting frontend
+        echo "Waiting for backend API to be ready..."
+        for i in {1..60}; do
+          if curl -s http://localhost:3001/health >/dev/null 2>&1; then
+            echo "✓ Backend API is ready"
             break
           fi
-          if [ $i -eq 30 ]; then
-            echo "✗ Timeout waiting for vite"
+          if [ $i -eq 60 ]; then
+            echo "✗ Timeout waiting for backend API"
             exit 1
           fi
-          echo "Waiting for vite... attempt $i/30"
+          echo "Waiting for backend... attempt $i/60"
           sleep 2
         done
 
-        PORT=3000 npm run dev
+        echo "Starting frontend service..."
+        npm run dev
       ready: |
         if curl -s http://localhost:3000 > /dev/null; then
           echo "Gitpod Flix is ready"
@@ -114,7 +168,11 @@ services:
           exit 1
         fi
       stop: |
+        if lsof -Pi :3000 -sTCP:LISTEN -t >/dev/null 2>&1; then
+          kill -9 $(lsof -ti:3000) 2>/dev/null || true
+        fi
         pkill -f "node.*frontend" || true
+        pkill -f "vite" || true
 
 tasks:
   seedDatabase: