@gv-sh/specgen-app 0.6.8 → 0.7.1

package/README.md

@@ -1,8 +1,8 @@
 # SpecGen App - Complete Platform
 
-[![Version](https://img.shields.io/badge/version-0.6.8-blue.svg)](https://github.com/gv-sh/specgen-app)
+[![Version](https://img.shields.io/badge/version-0.7.1-blue.svg)](https://github.com/gv-sh/specgen-app)
 
-A unified deployment package for the SpecGen speculative fiction generator platform. **Optimized for port 8080 deployment with low memory usage.**
+A unified deployment package for the SpecGen speculative fiction generator platform. **Optimized for port 80 deployment with low memory usage.**
 
 ## 🚀 Quick Start
 
@@ -19,7 +19,7 @@ npx @gv-sh/specgen-app deploy
 **What this does:**
 - Downloads and sets up server, admin, and user components
 - Builds React frontends optimized for production
-- Configures everything for port 8080
+- Configures everything for port 80
 - Starts with PM2 for process management
 - Prompts for OpenAI API key
 
@@ -27,12 +27,12 @@ npx @gv-sh/specgen-app deploy
 
 Once deployed, access your application at:
 
-- **Main Application**: http://your-server:8080/
-- **User Interface**: http://your-server:8080/app  
-- **Admin Panel**: http://your-server:8080/admin
-- **API Documentation**: http://your-server:8080/api-docs
-- **Health Check**: http://your-server:8080/api/health
-- **API Endpoints**: http://your-server:8080/api/*
+- **Main Application**: http://your-server:80/
+- **User Interface**: http://your-server:80/app  
+- **Admin Panel**: http://your-server:80/admin
+- **API Documentation**: http://your-server:80/api-docs
+- **Health Check**: http://your-server:80/api/health
+- **API Endpoints**: http://your-server:80/api/*
 
 ## 🖥️ Server Requirements
 
@@ -80,7 +80,7 @@ npx @gv-sh/specgen-app dev
 **Development URLs:**
 - User Interface: http://localhost:3002
 - Admin Interface: http://localhost:3001  
-- API Server: http://localhost:8080
+- API Server: http://localhost:80
 
 ### Method 3: Manual Deployment
 
@@ -106,7 +106,7 @@ During deployment, you'll be prompted for your OpenAI API key. You can also set
 # Create/edit the environment file
 echo "OPENAI_API_KEY=your_openai_api_key_here" > server/.env
 echo "NODE_ENV=production" >> server/.env
-echo "PORT=8080" >> server/.env
+echo "PORT=80" >> server/.env
 
 # Restart the service
 npx pm2 restart specgen --update-env
@@ -115,7 +115,7 @@ npx pm2 restart specgen --update-env
 ### Environment Variables
 
 The deployment creates these configuration files:
-- `server/.env` - Server configuration (port 8080, API key)
+- `server/.env` - Server configuration (port 80, API key)
 - `admin/.env.development` - Admin development settings  
 - `user/.env.development` - User development settings
 
@@ -144,13 +144,13 @@ npx pm2 monit
 
 ### Common Issues and Solutions
 
-#### 1. Port 8080 Already in Use
+#### 1. Port 80 Already in Use
 ```bash
 # Check what's using the port
-sudo lsof -i :8080
+sudo lsof -i :80
 
 # Kill the process
-sudo lsof -ti:8080 | xargs kill -9
+sudo lsof -ti:80 | xargs kill -9
 
 # Redeploy
 npx @gv-sh/specgen-app deploy
@@ -178,7 +178,7 @@ npx pm2 env 0
 # Update API key
 echo "OPENAI_API_KEY=your_new_key_here" > server/.env
 echo "NODE_ENV=production" >> server/.env
-echo "PORT=8080" >> server/.env
+echo "PORT=80" >> server/.env
 
 # Restart with new environment
 npx pm2 restart specgen --update-env
@@ -211,10 +211,10 @@ sudo apt-get install -y nodejs
 
 ```bash
 # Test API health
-curl http://localhost:8080/api/health
+curl http://localhost:80/api/health
 
 # Test main page response
-curl -I http://localhost:8080/
+curl -I http://localhost:80/
 
 # Check server logs
 npx pm2 logs specgen --lines 50
@@ -222,8 +222,8 @@ npx pm2 logs specgen --lines 50
 # Check build status
 ls -la */build/ 2>/dev/null || echo "No builds found"
 
-# Check processes listening on port 8080
-sudo netstat -tlnp | grep :8080
+# Check processes listening on port 80
+sudo netstat -tlnp | grep :80
 ```
 
 ### Manual Build Process
@@ -265,14 +265,14 @@ npx pm2 start server/index.js --name specgen
 - **Static File Serving**: Builds must complete successfully for frontend access
 
 ### AWS EC2 Specific
-- **Security Groups**: Ensure port 8080 is open in your security group
+- **Security Groups**: Ensure port 80 is open in your security group
 - **Instance Type**: t2.micro may struggle with builds (t2.small recommended)
 - **Storage**: Ensure at least 2GB free space for node_modules and builds
 
 ## 📚 API Documentation
 
 Once deployed, access interactive API documentation at:
-- **Swagger UI**: http://your-server:8080/api-docs
+- **Swagger UI**: http://your-server:80/api-docs
 
 ### Key API Endpoints
 - `GET /api/health` - Health check and system status
@@ -303,7 +303,7 @@ tar -czf specgen-backup-$(date +%Y%m%d).tar.gz server/data server/.env logs/
 ## 🤝 Support
 
 ### Getting Help
-- **Health Check**: Visit http://your-server:8080/api/health
+- **Health Check**: Visit http://your-server:80/api/health
 - **Logs**: Run `npx pm2 logs specgen`
 - **Issues**: [GitHub Issues](https://github.com/gv-sh/specgen-app/issues)
 - **Status**: Run `npx pm2 status` to check process status
@@ -311,7 +311,7 @@ tar -czf specgen-backup-$(date +%Y%m%d).tar.gz server/data server/.env logs/
 ### Reporting Bugs
 When reporting issues, please include:
 - Output of `npx pm2 logs specgen`
-- Output of `curl http://localhost:8080/api/health`
+- Output of `curl http://localhost:80/api/health`
 - Your server specifications (RAM, OS version, Node.js version)
 - Any error messages from the deployment process
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gv-sh/specgen-app",
-  "version": "0.6.8",
+  "version": "0.7.1",
   "description": "Complete SpecGen application with server, admin, and user interfaces",
   "main": "index.js",
   "bin": {

package/scripts/deploy.sh

@@ -350,6 +350,8 @@ for component in admin user; do
     fi
 done
 
+npm install --no-save serve
+
 # ========================================
 # VERIFY BUILDS
 # ========================================
@@ -399,26 +401,58 @@ if [ "$DRY_RUN" = true ]; then
 else
     echo "🚀 Starting PM2 deployment..."
     
+    mkdir -p logs
+    cp server/.env .env 2>/dev/null || true
+
+    # Grant Node permission to bind to port 80
+    sudo setcap 'cap_net_bind_service=+ep' "$(which node)"
+
+    # Load environment variables from .env
+    set -o allexport
+    source .env
+    set +o allexport
+    
     cat > "$PROJECT_DIR/ecosystem.config.js" << EOF
 module.exports = {
-  apps: [{
-    name: 'specgen',
-    script: '$PROJECT_DIR/server/index.js',
-    cwd: '$PROJECT_DIR',
-    env: {
-      NODE_ENV: 'production',
-      PORT: 80,
-      HOST: '$BIND_HOST'
+  apps: [
+    {
+      name: 'specgen',
+      script: '$PROJECT_DIR/server/index.js',
+      cwd: '$PROJECT_DIR',
+      env: {
+        NODE_ENV: 'production',
+        PORT: 80,
+        HOST: '$BIND_HOST',
+        OPENAI_API_KEY: process.env.OPENAI_API_KEY
+      },
+      instances: 1,
+      exec_mode: 'fork',
+      max_memory_restart: '500M',
+      error_file: '$PROJECT_DIR/logs/err.log',
+      out_file: '$PROJECT_DIR/logs/out.log',
+      log_file: '$PROJECT_DIR/logs/combined.log',
+      time: true,
+      watch: false
     },
-    instances: 1,
-    exec_mode: 'fork',
-    max_memory_restart: '500M',
-    error_file: '$PROJECT_DIR/logs/err.log',
-    out_file: '$PROJECT_DIR/logs/out.log',
-    log_file: '$PROJECT_DIR/logs/combined.log',
-    time: true,
-    watch: false
-  }]
+    {
+      name: 'specgen-admin',
+      script: 'npx',
+      args: 'serve -s admin/build -l 5001',
+      cwd: '$PROJECT_DIR',
+      env: {
+        NODE_ENV: 'production'
+      }
+    },
+    {
+      name: 'specgen-user',
+      script: 'npx',
+      args: 'serve -s user/build -l 5002',
+      cwd: '$PROJECT_DIR',
+      env: {
+        NODE_ENV: 'production'
+      }
+    }
+  ]
 }
 EOF
     

package/scripts/deploy-8080.sh.bak

@@ -1,104 +0,0 @@
-#!/bin/bash
-
-# SpecGen Deploy Script - Port 80 Production Deployment
-set -e
-
-echo "🚀 Deploying SpecGen to production on port 80..."
-
-# Function to check if port is available
-check_port() {
-    local port=$1
-    if lsof -Pi :$port -sTCP:LISTEN -t >/dev/null 2>&1; then
-        return 1  # Port in use
-    else
-        return 0  # Port available
-    fi
-}
-
-# Stop existing PM2 processes
-echo "Stopping existing PM2 processes..."
-npx pm2 stop all 2>/dev/null || true
-npx pm2 delete all 2>/dev/null || true
-
-# Kill any processes on port 80
-echo "Freeing port 80..."
-if ! check_port 80; then
-    echo "Port 80 is in use. Attempting to free it..."
-    lsof -ti:80 | xargs kill -9 2>/dev/null || true
-    sleep 2
-fi
-
-# Run the production setup
-echo "Running production setup..."
-npm run production-low-memory &
-SETUP_PID=$!
-
-# Wait for setup to complete or timeout
-TIMEOUT=60
-COUNT=0
-while [ $COUNT -lt $TIMEOUT ]; do
-    if ! kill -0 $SETUP_PID 2>/dev/null; then
-        echo "Production setup completed"
-        break
-    fi
-    sleep 1
-    COUNT=$((COUNT + 1))
-done
-
-# Kill setup process if it's still running
-if kill -0 $SETUP_PID 2>/dev/null; then
-    echo "Setup taking too long, continuing with PM2 deployment..."
-    kill $SETUP_PID 2>/dev/null || true
-fi
-
-# Wait a moment for cleanup
-sleep 2
-
-# Create PM2 ecosystem configuration
-echo "Creating PM2 ecosystem configuration..."
-cat > ecosystem.config.js << 'EOF'
-module.exports = {
-  apps: [{
-    name: 'specgen',
-    script: './server/index.js',
-    cwd: process.cwd(),
-    env: {
-      NODE_ENV: 'production',
-      PORT: 80
-    },
-    instances: 1,
-    exec_mode: 'fork',
-    max_memory_restart: '500M',
-    error_file: './logs/err.log',
-    out_file: './logs/out.log',
-    log_file: './logs/combined.log',
-    time: true,
-    watch: false,
-    ignore_watch: ['node_modules', 'logs', '*.log']
-  }]
-}
-EOF
-
-# Create logs directory
-mkdir -p logs
-
-# Start with PM2
-echo "Starting SpecGen with PM2 on port 80..."
-NODE_ENV=production PORT=80 npx pm2 start ecosystem.config.js
-
-# Wait for startup
-sleep 5
-
-echo ""
-echo "✅ SpecGen deployment completed!"
-echo ""
-echo "🌐 Access your application at:"
-echo "   - Main page: http://$(curl -s ifconfig.me 2>/dev/null || echo 'your-server'):80/"
-echo "   - User app: http://$(curl -s ifconfig.me 2>/dev/null || echo 'your-server'):80/app"
-echo "   - Admin panel: http://$(curl -s ifconfig.me 2>/dev/null || echo 'your-server'):80/admin"
-echo "   - API docs: http://$(curl -s ifconfig.me 2>/dev/null || echo 'your-server'):80/api-docs"
-echo "   - Health check: http://$(curl -s ifconfig.me 2>/dev/null || echo 'your-server'):80/api/health"
-echo ""
-echo "📊 Check status with: npx pm2 status"
-echo "📝 View logs with: npx pm2 logs specgen"
-echo "🔄 Restart with: npx pm2 restart specgen"

package/scripts/production-low-memory.sh.bak

@@ -1,129 +0,0 @@
-#!/bin/bash
-
-# SpecGen Production Script - Port 80 Low Memory Version
-set -e
-
-echo "🚀 Starting SpecGen in production mode on port 80 (Low Memory)..."
-
-# Function to check if port is available
-check_port() {
-    local port=$1
-    if lsof -Pi :$port -sTCP:LISTEN -t >/dev/null 2>&1; then
-        return 1  # Port in use
-    else
-        return 0  # Port available
-    fi
-}
-
-# Verify OpenAI API key
-if [ -f "server/.env" ]; then
-    # In CI mode, skip API key validation
-    if [ "$CI" = "true" ]; then
-        echo "CI mode detected - skipping API key validation"
-    elif grep -q "OPENAI_API_KEY=your_openai_api_key_here" server/.env; then
-        echo "⚠️ No OpenAI API key detected!"
-        echo "Enter your OpenAI API key: "
-        read -r OPENAI_KEY
-        
-        if [ -z "$OPENAI_KEY" ]; then
-            echo "❌ No API key provided. Cannot start in production mode."
-            exit 1
-        else
-            # Update the API key in the .env file
-            sed -i.bak "s/OPENAI_API_KEY=.*/OPENAI_API_KEY=$OPENAI_KEY/" server/.env
-            rm -f server/.env.bak
-            echo "✅ API key updated in server/.env"
-        fi
-    fi
-else
-    echo "❌ server/.env file not found. Run 'npm run setup' first."
-    exit 1
-fi
-
-# Verify directories exist
-for dir in server admin user; do
-    if [ ! -d "$dir" ]; then
-        echo "❌ $dir directory not found. Run 'npm run setup' first."
-        exit 1
-    fi
-done
-
-# Make sure node_modules exist in the server directory
-if [ ! -d "server/node_modules" ]; then
-    echo "Installing server dependencies..."
-    cd server
-    # Create a .npmrc file that ignores engine requirements
-    echo "engine-strict=false" > .npmrc
-    npm install --no-fund --no-audit --production --maxsockets=2 --loglevel=warn
-    cd ..
-fi
-
-# Set production environment
-export NODE_ENV=production
-
-# Check if we need to build
-if [ ! -d "admin/build" ] || [ ! -d "user/build" ]; then
-    echo "Building web interfaces (optimized mode)..."
-    
-    # Admin build
-    if [ ! -d "admin/build" ]; then
-        echo "Building admin..."
-        cd admin
-        echo "engine-strict=false" > .npmrc
-        # Install only production dependencies
-        npm install --no-fund --no-audit --production --maxsockets=2 --loglevel=warn
-        # Set environment for smaller build
-        export GENERATE_SOURCEMAP=false
-        export SKIP_PREFLIGHT_CHECK=true
-        npm run build
-        cd ..
-    fi
-    
-    # User build
-    if [ ! -d "user/build" ]; then
-        echo "Building user..."
-        cd user
-        echo "engine-strict=false" > .npmrc
-        # Install only production dependencies
-        npm install --no-fund --no-audit --production --maxsockets=2 --loglevel=warn
-        # Set environment for smaller build
-        export GENERATE_SOURCEMAP=false
-        export SKIP_PREFLIGHT_CHECK=true
-        npm run build
-        cd ..
-    fi
-fi
-
-# Update server .env to use port 80
-if [ -f "server/.env" ]; then
-    # Update or add PORT=80 to .env
-    if grep -q "^PORT=" server/.env; then
-        sed -i.bak "s/^PORT=.*/PORT=80/" server/.env
-    else
-        echo "PORT=80" >> server/.env
-    fi
-    rm -f server/.env.bak
-fi
-
-# Create production-ready .env for server
-cat > server/.env.production << EOF
-$(cat server/.env)
-NODE_ENV=production
-PORT=80
-EOF
-
-# Kill existing processes on port 80 if needed
-echo "Checking port 80..."
-if ! check_port 80; then
-    echo "Port 80 is in use. Attempting to free it..."
-    lsof -ti:80 | xargs kill -9 2>/dev/null || true
-    sleep 2
-fi
-
-# Start production server
-echo "Starting production server on port 80..."
-if [ "$CI" = "true" ]; then
-    echo "CI mode detected - skipping server start"
-else
-    cd server && NODE_ENV=production PORT=80 npm start
-fi

package/scripts/setup-low-memory.sh.bak

@@ -1,203 +0,0 @@
-#!/bin/bash
-
-# SpecGen Low-Memory Setup Script
-set -e
-
-echo "🚀 Setting up SpecGen App (Low Memory Mode)..."
-
-# Check Node.js
-if ! command -v npm &> /dev/null; then
-    echo "❌ npm not found. Please install Node.js from https://nodejs.org/"
-    exit 1
-fi
-
-# Function to safely remove directories with permission handling
-safe_remove() {
-    if [ -d "$1" ]; then
-        echo "Removing $1..."
-        chmod -R u+w "$1" 2>/dev/null || true
-        rm -rf "$1" 2>/dev/null || true
-        # If still exists, try with sudo
-        if [ -d "$1" ]; then
-            echo "Using elevated permissions to remove $1..."
-            sudo rm -rf "$1" 2>/dev/null || true
-        fi
-    fi
-}
-
-# Clean existing directories with proper permission handling
-echo "Cleaning existing directories..."
-safe_remove "server"
-safe_remove "admin" 
-safe_remove "user"
-rm -f *.tgz package 2>/dev/null || true
-
-# Install dependencies one at a time with reduced memory usage
-echo "📦 Installing dependencies (low memory mode)..."
-npm install --no-fund --no-audit --ignore-scripts --production=false --maxsockets=2 --loglevel=warn
-
-# Create a .npmrc file that ignores engine requirements
-echo "engine-strict=false" > .npmrc
-
-# Download npm packages one at a time
-echo "📦 Downloading packages..."
-npm pack @gv-sh/specgen-server --loglevel=warn
-npm pack @gv-sh/specgen-admin --loglevel=warn
-npm pack @gv-sh/specgen-user --loglevel=warn
-
-# Extract packages
-echo "📁 Extracting packages..."
-
-# Extract server
-if [ -f "gv-sh-specgen-server-"*.tgz ]; then
-    echo "Extracting server..."
-    tar -xzf gv-sh-specgen-server-*.tgz
-    mv package server
-    rm gv-sh-specgen-server-*.tgz
-fi
-
-# Extract admin
-if [ -f "gv-sh-specgen-admin-"*.tgz ]; then
-    echo "Extracting admin..."
-    tar -xzf gv-sh-specgen-admin-*.tgz
-    mv package admin
-    rm gv-sh-specgen-admin-*.tgz
-fi
-
-# Extract user
-if [ -f "gv-sh-specgen-user-"*.tgz ]; then
-    echo "Extracting user..."
-    tar -xzf gv-sh-specgen-user-*.tgz
-    mv package user
-    rm gv-sh-specgen-user-*.tgz
-fi
-
-# Patch package.json files to fix React scripts
-echo "🔧 Patching package scripts..."
-
-# Fix user package start script
-if [ -f "user/package.json" ]; then
-    echo "Fixing user package start script..."
-    # Replace the start script to use react-scripts instead of missing scripts/start.js
-    sed -i.bak 's|"start": "cross-env PORT=3002 REACT_APP_API_URL=http://localhost:3000 node scripts/start.js"|"start": "cross-env PORT=3002 REACT_APP_API_URL=http://localhost:3000 react-scripts start"|g' user/package.json
-    rm -f user/package.json.bak
-fi
-
-# Fix admin package start script if needed
-if [ -f "admin/package.json" ]; then
-    echo "Checking admin package start script..."
-    # Check if admin has similar issue
-    if grep -q "node scripts/start.js" admin/package.json; then
-        echo "Fixing admin package start script..."
-        sed -i.bak 's|node scripts/start.js|react-scripts start|g' admin/package.json
-        rm -f admin/package.json.bak
-    fi
-fi
-
-# Create .npmrc files with engine-strict=false in each directory
-echo "Creating .npmrc files to ignore engine requirements..."
-for dir in server admin user; do
-  if [ -d "$dir" ]; then
-    echo "engine-strict=false" > "$dir/.npmrc"
-  fi
-done
-
-# Install dependencies for each component with memory optimizations
-echo "📚 Installing dependencies (low memory mode)..."
-for dir in server admin user; do
-    if [ -d "$dir" ]; then
-        echo "Installing $dir dependencies..."
-        (cd "$dir" && npm install --no-fund --no-audit --ignore-scripts --loglevel=warn --production=false --maxsockets=2 --force --omit=dev)
-    else
-        echo "⚠️  Warning: $dir directory not found"
-    fi
-done
-
-# Setup environment files
-echo "🔧 Setting up environment files..."
-
-# Server .env
-if [ ! -f server/.env ] || [ "$CI" = "true" ]; then
-    # If in CI mode, use a dummy key
-    if [ "$CI" = "true" ]; then
-        # If in CI environment and .env already exists, just use it
-        if [ -f server/.env ]; then
-            echo "Using existing .env file for CI environment"
-        else
-            # Create a CI .env file
-            cat > server/.env << EOF
-OPENAI_API_KEY=sk-test1234
-NODE_ENV=test
-PORT=3000
-EOF
-            echo "Created test .env file for CI environment"
-        fi
-        KEY_PROVIDED=true
-    else
-        # Normal interactive mode
-        # Prompt for OpenAI API key
-        echo "To use SpecGen, you need an OpenAI API key."
-        echo "Enter your OpenAI API key (or press enter to set it later): "
-        read -r OPENAI_KEY
-        
-        # If key is provided, use it, otherwise use placeholder
-        if [ -z "$OPENAI_KEY" ]; then
-            OPENAI_KEY="your_openai_api_key_here"
-            KEY_PROVIDED=false
-        else
-            KEY_PROVIDED=true
-        fi
-        
-        cat > server/.env << EOF
-# OpenAI API key
-OPENAI_API_KEY=$OPENAI_KEY
-NODE_ENV=development
-PORT=3000
-EOF
-        
-        if [ "$KEY_PROVIDED" = true ]; then
-            echo "✅ OpenAI API key saved to server/.env"
-        else
-            echo "⚠️ No OpenAI API key provided. You'll need to add it later to server/.env"
-        fi
-    fi
-fi
-
-# Admin .env.development  
-if [ -d admin ]; then
-    cat > admin/.env.development << 'EOF'
-REACT_APP_API_URL=http://localhost:3000
-PORT=3001
-SKIP_PREFLIGHT_CHECK=true
-GENERATE_SOURCEMAP=false
-EOF
-fi
-
-# User .env.development
-if [ -d user ]; then
-    cat > user/.env.development << 'EOF'
-REACT_APP_API_URL=http://localhost:3000  
-PORT=3002
-SKIP_PREFLIGHT_CHECK=true
-GENERATE_SOURCEMAP=false
-EOF
-fi
-
-echo "✅ Low-memory setup complete!"
-echo ""
-echo "Next steps:"
-if [ "$KEY_PROVIDED" = false ]; then
-    echo "1. Add your OpenAI API key to server/.env"
-    echo "2. Use 'npm run dev' to start all services"
-else
-    echo "1. Use 'npm run dev' to start all services"
-fi
-echo ""
-echo "If you're deploying on a low-memory system, we recommend:"
-echo "1. npm run build (to create optimized bundles)"
-echo "2. npm run production (to start in production mode)"
-echo ""
-echo "Access URLs:"
-echo "  🌐 User Interface: http://localhost:3002"
-echo "  ⚙️  Admin Interface: http://localhost:3001"  
-echo "  🔧 API: http://localhost:3000"