aidevops 2.52.1

package/.agent/scripts/webhosting-helper.sh

@@ -0,0 +1,471 @@
+#!/bin/bash
+# shellcheck disable=SC2034,SC2155,SC2317,SC2329,SC2016,SC2181,SC1091,SC2154,SC2015,SC2086,SC2129,SC2030,SC2031,SC2119,SC2120,SC2001,SC2162,SC2088,SC2089,SC2090,SC2029,SC2006,SC2153
+
+# Web Hosting Helper Script
+# Manages .local domains for web applications in ~/Git
+# Compatible with LocalWP and standalone nginx setups
+
+# Source shared constants if available
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)" || exit
+source "$SCRIPT_DIR/shared-constants.sh" 2>/dev/null || true
+
+# Colors for output
+GREEN='\033[0;32m'
+BLUE='\033[0;34m'
+YELLOW='\033[1;33m'
+RED='\033[0;31m'
+PURPLE='\033[0;35m'
+NC='\033[0m' # No Color
+
+# Configuration
+CERT_DIR="$HOME/.localhost-setup/certs"
+NGINX_CONF_DIR="/Users/$(whoami)/Library/Application Support/Local/run/router/nginx/conf"
+GIT_DIR="$HOME/Git"
+# CONFIG_FILE="../configs/webhosting-config.json"  # Reserved for future use
+
+print_header() {
+    local message="$1"
+    echo -e "${PURPLE}================================${NC}"
+    echo -e "${PURPLE}$message${NC}"
+    echo -e "${PURPLE}================================${NC}"
+    return 0
+}
+
+print_info() {
+    local message="$1"
+    echo -e "${BLUE}[INFO]${NC} $message"
+    return 0
+}
+
+print_success() {
+    local message="$1"
+    echo -e "${GREEN}[SUCCESS]${NC} $message"
+    return 0
+}
+
+print_warning() {
+    local message="$1"
+    echo -e "${YELLOW}[WARNING]${NC} $message"
+    return 0
+}
+
+print_error() {
+    local message="$1"
+    echo -e "${RED}[ERROR]${NC} $message" >&2
+    return 0
+}
+
+# Check if LocalWP is available
+check_localwp() {
+    if [[ -d "/Applications/Local.app" ]] || [[ -d "$HOME/Applications/Local.app" ]]; then
+        if [[ -d "$NGINX_CONF_DIR" ]]; then
+            print_success "LocalWP nginx router detected - using existing setup"
+            return 0
+        else
+            print_warning "LocalWP found but nginx router not running"
+            return 1
+        fi
+    else
+        print_info "LocalWP not found - standalone mode"
+        return 1
+    fi
+    return 0
+}
+
+# Detect web application type and default port
+detect_webapp_type() {
+    local project_dir="$1"
+    
+    if [[ -f "$project_dir/package.json" ]]; then
+        if grep -q "next" "$project_dir/package.json"; then
+            echo "nextjs:3000"
+        elif grep -q "react" "$project_dir/package.json"; then
+            echo "react:3000"
+        elif grep -q "vue" "$project_dir/package.json"; then
+            echo "vue:3000"
+        elif grep -q "nuxt" "$project_dir/package.json"; then
+            echo "nuxt:3000"
+        elif grep -q "svelte" "$project_dir/package.json"; then
+            echo "svelte:5173"
+        elif grep -q "vite" "$project_dir/package.json"; then
+            echo "vite:5173"
+        else
+            echo "node:3000"
+        fi
+    elif [[ -f "$project_dir/Gemfile" ]]; then
+        echo "rails:3000"
+    elif [[ -f "$project_dir/requirements.txt" ]] || [[ -f "$project_dir/pyproject.toml" ]]; then
+        echo "python:8000"
+    elif [[ -f "$project_dir/Cargo.toml" ]]; then
+        echo "rust:8000"
+    elif [[ -f "$project_dir/go.mod" ]]; then
+        echo "go:8080"
+    elif [[ -f "$project_dir/composer.json" ]]; then
+        echo "php:8000"
+    else
+        echo "unknown:3000"
+    fi
+    return 0
+}
+
+# Generate SSL certificate
+generate_ssl_cert() {
+    local domain="$1"
+    
+    print_info "Generating SSL certificate for $domain..."
+    mkdir -p "$CERT_DIR"
+    
+    if [[ -f "$CERT_DIR/$domain.crt" ]]; then
+        print_warning "SSL certificate already exists for $domain"
+        return 0
+    fi
+    
+    openssl req -x509 -newkey rsa:2048 \
+        -keyout "$CERT_DIR/$domain.key" \
+        -out "$CERT_DIR/$domain.crt" \
+        -days 365 -nodes \
+        -subj "/C=US/ST=Local/L=Local/O=Local Development/CN=$domain" \
+        2>/dev/null
+    
+    print_success "SSL certificate generated for $domain"
+    return 0
+}
+
+# Create nginx configuration for LocalWP router
+create_localwp_nginx_config() {
+    local domain="$1"
+    local port="$2"
+    local webapp_type="$3"
+    
+    print_info "Creating LocalWP nginx configuration for $domain..."
+    
+    local nginx_conf="$NGINX_CONF_DIR/route.$domain.conf"
+    
+    if [[ -f "$nginx_conf" ]]; then
+        print_warning "Nginx configuration exists, backing up..."
+        cp "$nginx_conf" "$nginx_conf.backup.$(date +%s)"
+    fi
+    
+    # Create nginx configuration based on webapp type
+    # NOSONAR - HTTP used for localhost proxy_pass is safe (internal traffic only)
+    cat > "$nginx_conf" << EOF
+# Local Development Site: $domain ($webapp_type)
+server {
+    listen 80;
+    server_name $domain;
+    
+    # Redirect HTTP to HTTPS
+    return 301 https://\$server_name\$request_uri;
+}
+
+server {
+    listen 443 ssl;
+    http2 on;
+    server_name $domain;
+    
+    # SSL Configuration
+    ssl_certificate "$CERT_DIR/$domain.crt";
+    ssl_certificate_key "$CERT_DIR/$domain.key";
+    ssl_protocols TLSv1.2 TLSv1.3;
+    ssl_ciphers ECDHE-RSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-GCM-SHA384;
+    ssl_prefer_server_ciphers off;
+    
+    # Proxy to local development server
+    location / {
+        proxy_pass http://127.0.0.1:$port;
+        proxy_http_version 1.1;
+        proxy_set_header Upgrade \$http_upgrade;
+        proxy_set_header Connection 'upgrade';
+        proxy_set_header Host \$host;
+        proxy_set_header X-Real-IP \$remote_addr;
+        proxy_set_header X-Forwarded-For \$proxy_add_x_forwarded_for;
+        proxy_set_header X-Forwarded-Proto \$scheme;
+        proxy_cache_bypass \$http_upgrade;
+        proxy_read_timeout 86400;
+    }
+EOF
+
+    # Add framework-specific configurations
+    case "$webapp_type" in
+        "nextjs"|"react"|"vue"|"nuxt")
+            cat >> "$nginx_conf" << EOF
+    
+    # Handle WebSocket connections for hot reload
+    location /_next/webpack-hmr {
+        proxy_pass http://127.0.0.1:$port;
+        proxy_http_version 1.1;
+        proxy_set_header Upgrade \$http_upgrade;
+        proxy_set_header Connection "upgrade";
+        proxy_set_header Host \$host;
+        proxy_set_header X-Real-IP \$remote_addr;
+        proxy_set_header X-Forwarded-For \$proxy_add_x_forwarded_for;
+        proxy_set_header X-Forwarded-Proto \$scheme;
+    }
+EOF
+            ;;
+        "vite"|"svelte")
+            cat >> "$nginx_conf" << EOF
+    
+    # Handle Vite HMR WebSocket
+    location /vite-dev-server {
+        proxy_pass http://127.0.0.1:$port;
+        proxy_http_version 1.1;
+        proxy_set_header Upgrade \$http_upgrade;
+        proxy_set_header Connection "upgrade";
+        proxy_set_header Host \$host;
+    }
+EOF
+            ;;
+        *)
+            # No additional configuration needed for other webapp types
+            ;;
+    esac
+    
+    echo "}" >> "$nginx_conf"
+    
+    print_success "LocalWP nginx configuration created for $domain"
+    return 0
+}
+
+# Add domain to hosts file
+add_to_hosts() {
+    local domain="$1"
+
+    if grep -q "$domain" /etc/hosts; then
+        print_warning "Domain $domain already exists in hosts file"
+        return 0
+    fi
+
+    print_info "Adding $domain to /etc/hosts (requires sudo)..."
+    echo "127.0.0.1 $domain" | sudo tee -a /etc/hosts > /dev/null
+    print_success "Domain added to hosts file"
+    return 0
+}
+
+# Reload nginx
+reload_nginx() {
+    print_info "Reloading nginx configuration..."
+
+    local nginx_pid
+    nginx_pid=$(pgrep -f "nginx.*router" | head -1)
+    if [[ -n "$nginx_pid" ]]; then
+        kill -HUP "$nginx_pid"
+        print_success "Nginx configuration reloaded"
+    else
+        print_warning "Nginx router not running - configuration will be loaded when it starts"
+    fi
+    return 0
+}
+
+# Setup a new local domain
+setup_domain() {
+    local project_name="$1"
+    local port="$2"
+
+    if [[ -z "$project_name" ]]; then
+        print_error "Project name is required"
+        exit 1
+    fi
+
+    local project_dir="$GIT_DIR/$project_name"
+    local domain="$project_name.local"
+
+    if [[ ! -d "$project_dir" ]]; then
+        print_error "Project directory does not exist: $project_dir"
+        exit 1
+    fi
+
+    print_header "Setting up $domain"
+
+    # Detect webapp type and default port if not specified
+    local webapp_info
+    webapp_info=$(detect_webapp_type "$project_dir")
+    local webapp_type="${webapp_info%:*}"
+    local default_port="${webapp_info#*:}"
+
+    # Use provided port or default
+    port="${port:-$default_port}"
+
+    print_info "Detected: $webapp_type application"
+    print_info "Using port: $port"
+
+    # Generate SSL certificate
+    generate_ssl_cert "$domain"
+
+    # Check if LocalWP is available and create appropriate config
+    if check_localwp; then
+        create_localwp_nginx_config "$domain" "$port" "$webapp_type"
+        reload_nginx
+    else
+        print_warning "LocalWP not available - manual nginx setup required"
+        print_info "See documentation for standalone nginx setup"
+    fi
+
+    # Add to hosts file
+    add_to_hosts "$domain"
+
+    print_success "Local domain setup complete!"
+    echo ""
+    echo -e "${GREEN}✅ Domain configured: https://$domain${NC}"
+    echo ""
+    echo -e "${YELLOW}⚠️  CRITICAL STEP REQUIRED:${NC}"
+    echo -e "${RED}The domain is NOT yet accessible because it's missing from /etc/hosts${NC}"
+    echo ""
+    echo -e "${BLUE}📝 Complete these steps to finish setup:${NC}"
+    echo ""
+    echo -e "${YELLOW}1. Add domain to hosts file (REQUIRED):${NC}"
+    echo "   echo \"127.0.0.1 $domain\" | sudo tee -a /etc/hosts"
+    echo ""
+    echo -e "${YELLOW}2. Start your development server on port $port:${NC}"
+    echo "   cd ~/Git/$project_name" || exit
+    echo "   PORT=$port npm run dev  # or pnpm dev, yarn dev"
+    echo ""
+    echo -e "${YELLOW}3. Visit https://$domain in your browser${NC}"
+    echo ""
+    echo -e "${YELLOW}4. Handle SSL certificate warning:${NC}"
+    echo "   Browser will show: \"Your connection is not private\""
+    echo "   Click: \"Proceed to $domain (unsafe)\""
+    echo ""
+    echo -e "${GREEN}5. Verify success:${NC}"
+    echo "   - HTTP redirect: http://$domain → https://$domain"
+    echo "   - HTTPS access: https://$domain shows your app"
+    echo ""
+    return 0
+}
+
+# List configured domains
+list_domains() {
+    print_header "Configured Local Domains"
+
+    if check_localwp; then
+        local found_domains=false
+
+        for conf_file in "$NGINX_CONF_DIR"/route.*.local.conf; do
+            if [[ -f "$conf_file" ]]; then
+                local domain
+                domain=$(basename "$conf_file" | sed 's/route\.\(.*\)\.conf/\1/')
+                local port
+                port=$(grep "proxy_pass" "$conf_file" | head -1 | sed 's/.*127\.0\.0\.1:\([0-9]*\).*/\1/')
+                local status="❌ Not running"
+
+                # Check if port is in use
+                if lsof -i ":$port" >/dev/null 2>&1; then
+                    status="✅ Running"
+                fi
+
+                echo -e "${BLUE}🌐 https://$domain${NC} → Port $port $status"
+                found_domains=true
+            fi
+        done
+
+        if [[ "$found_domains" == false ]]; then
+            print_warning "No local domains configured"
+        fi
+    else
+        print_warning "LocalWP not available - cannot list domains"
+    fi
+    return 0
+}
+
+# Remove a domain
+remove_domain() {
+    local project_name="$1"
+
+    if [[ -z "$project_name" ]]; then
+        print_error "Project name is required"
+        exit 1
+    fi
+
+    local domain="$project_name.local"
+
+    print_header "Removing $domain"
+
+    if check_localwp; then
+        local nginx_conf="$NGINX_CONF_DIR/route.$domain.conf"
+
+        # Remove nginx configuration
+        if [[ -f "$nginx_conf" ]]; then
+            rm "$nginx_conf"
+            print_success "Nginx configuration removed"
+            reload_nginx
+        else
+            print_warning "Nginx configuration not found"
+        fi
+    fi
+
+    # Remove SSL certificates
+    if [[ -f "$CERT_DIR/$domain.crt" ]]; then
+        rm "$CERT_DIR/$domain.crt" "$CERT_DIR/$domain.key"
+        print_success "SSL certificates removed"
+    else
+        print_warning "SSL certificates not found"
+    fi
+
+    # Remove from hosts file (requires manual intervention due to sudo)
+    if grep -q "$domain" /etc/hosts; then
+        print_warning "Please manually remove '$domain' from /etc/hosts"
+        print_info "Run: sudo sed -i '' '/$domain/d' /etc/hosts"
+    fi
+
+    print_success "Domain removal complete!"
+    return 0
+}
+
+# Show help
+show_help() {
+    echo "Web Hosting Helper - Local Domain Management"
+    echo ""
+    echo "Usage: $0 [command] [options]"
+    echo ""
+    echo "Commands:"
+    echo "  setup <project-name> [port]  Setup local domain for project"
+    echo "  list                         List all configured domains"
+    echo "  remove <project-name>        Remove local domain configuration"
+    echo "  help                         Show this help message"
+    echo ""
+    echo "Examples:"
+    echo "  $0 setup myapp 3000"
+    echo "  $0 setup webapp-source 3001"
+    echo "  $0 list"
+    echo "  $0 remove myapp"
+    echo ""
+    echo "Supported frameworks:"
+    echo "  - Next.js, React, Vue, Nuxt (port 3000)"
+    echo "  - Vite, Svelte (port 5173)"
+    echo "  - Rails (port 3000)"
+    echo "  - Python/Django (port 8000)"
+    echo "  - Go (port 8080)"
+    echo "  - PHP (port 8000)"
+    echo ""
+    echo "Requirements:"
+    echo "  - LocalWP (recommended) or standalone nginx"
+    echo "  - OpenSSL for certificate generation"
+    echo "  - sudo access for hosts file modification"
+    echo ""
+    return 0
+}
+
+# Main script logic
+main() {
+    local command="${1:-help}"
+    local project_name="$2"
+    local port="$3"
+
+    case "$command" in
+        "setup")
+            setup_domain "$project_name" "$port"
+            ;;
+        "list")
+            list_domains
+            ;;
+        "remove")
+            remove_domain "$project_name"
+            ;;
+        "help"|*)
+            show_help
+            ;;
+    esac
+    return 0
+}
+
+main "$@"

package/.agent/scripts/webhosting-verify.sh

@@ -0,0 +1,238 @@
+#!/bin/bash
+# shellcheck disable=SC2034,SC2155,SC2317,SC2329,SC2016,SC2181,SC1091,SC2154,SC2015,SC2086,SC2129,SC2030,SC2031,SC2119,SC2120,SC2001,SC2162,SC2088,SC2089,SC2090,SC2029,SC2006,SC2153
+
+# Web Hosting Verification Script
+# Verifies local domain setup and provides detailed troubleshooting
+
+# Source shared constants if available
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)" || exit
+source "$SCRIPT_DIR/shared-constants.sh" 2>/dev/null || true
+
+# Colors for output
+GREEN='\033[0;32m'
+BLUE='\033[0;34m'
+YELLOW='\033[1;33m'
+RED='\033[0;31m'
+PURPLE='\033[0;35m'
+NC='\033[0m' # No Color
+
+# Configuration
+CERT_DIR="$HOME/.localhost-setup/certs"
+NGINX_CONF_DIR="/Users/$(whoami)/Library/Application Support/Local/run/router/nginx/conf"
+GIT_DIR="$HOME/Git"
+
+print_header() {
+    local message="$1"
+    echo -e "${PURPLE}================================${NC}"
+    echo -e "${PURPLE}$message${NC}"
+    echo -e "${PURPLE}================================${NC}"
+    return 0
+}
+
+print_info() {
+    local message="$1"
+    echo -e "${BLUE}[INFO]${NC} $message"
+    return 0
+}
+
+print_success() {
+    local message="$1"
+    echo -e "${GREEN}[SUCCESS]${NC} $message"
+    return 0
+}
+
+print_warning() {
+    local message="$1"
+    echo -e "${YELLOW}[WARNING]${NC} $message"
+    return 0
+}
+
+print_error() {
+    local message="$1"
+    echo -e "${RED}[ERROR]${NC} $message" >&2
+    return 0
+}
+
+# Verify domain setup
+verify_domain() {
+    local project_name="$1"
+    
+    if [[ -z "$project_name" ]]; then
+        print_error "Project name is required"
+        exit 1
+    fi
+    
+    local domain="$project_name.local"
+    local project_dir="$GIT_DIR/$project_name"
+    
+    print_header "Verifying $domain Setup"
+    
+    local all_checks_passed=true
+    
+    # Check 1: Project directory exists
+    echo -e "${BLUE}1. Checking project directory...${NC}"
+    if [[ -d "$project_dir" ]]; then
+        print_success "Project directory exists: $project_dir"
+    else
+        print_error "Project directory not found: $project_dir"
+        all_checks_passed=false
+    fi
+    
+    # Check 2: Hosts file entry
+    echo -e "${BLUE}2. Checking hosts file...${NC}"
+    if grep -q "$domain" /etc/hosts; then
+        print_success "Domain found in /etc/hosts"
+    else
+        print_error "Domain NOT found in /etc/hosts"
+        print_warning "Fix: echo \"127.0.0.1 $domain\" | sudo tee -a /etc/hosts"
+        all_checks_passed=false
+    fi
+    
+    # Check 3: Nginx configuration
+    echo -e "${BLUE}3. Checking nginx configuration...${NC}"
+    local nginx_conf="$NGINX_CONF_DIR/route.$domain.conf"
+    if [[ -f "$nginx_conf" ]]; then
+        print_success "Nginx configuration exists"
+        
+        # Check port configuration
+        local port
+        port=$(grep "proxy_pass" "$nginx_conf" | head -1 | sed 's/.*127\.0\.0\.1:\([0-9]*\).*/\1/')
+        if [[ -n "$port" ]]; then
+            print_info "Configured port: $port"
+        else
+            print_warning "Could not determine configured port"
+        fi
+    else
+        print_error "Nginx configuration missing: $nginx_conf"
+        all_checks_passed=false
+    fi
+    
+    # Check 4: SSL certificates
+    echo -e "${BLUE}4. Checking SSL certificates...${NC}"
+    if [[ -f "$CERT_DIR/$domain.crt" && -f "$CERT_DIR/$domain.key" ]]; then
+        print_success "SSL certificates exist"
+        
+        # Check certificate validity
+        local cert_info
+        if cert_info=$(openssl x509 -in "$CERT_DIR/$domain.crt" -noout -dates 2>/dev/null); then
+            print_info "Certificate info: $cert_info"
+        fi
+    else
+        print_error "SSL certificates missing"
+        all_checks_passed=false
+    fi
+    
+    # Check 5: LocalWP nginx router
+    echo -e "${BLUE}5. Checking nginx router...${NC}"
+    if pgrep -f "nginx.*router" >/dev/null; then
+        print_success "Nginx router is running"
+    else
+        print_error "Nginx router not running"
+        print_warning "Start LocalWP application or check nginx status"
+        all_checks_passed=false
+    fi
+    
+    # Check 6: Development server (if hosts file is correct)
+    if grep -q "$domain" /etc/hosts && [[ -n "$port" ]]; then
+        echo -e "${BLUE}6. Checking development server...${NC}"
+        if lsof -i ":$port" >/dev/null 2>&1; then
+            print_success "Development server running on port $port"
+        else
+            print_warning "No service running on port $port"
+            print_info "Start with: cd $project_dir && PORT=$port npm run dev" || exit
+        fi
+        
+        # Check 7: DNS resolution
+        echo -e "${BLUE}7. Testing DNS resolution...${NC}"
+        if ping -c 1 "$domain" >/dev/null 2>&1; then
+            print_success "Domain resolves to localhost"
+        else
+            print_error "Domain resolution failed"
+            all_checks_passed=false
+        fi
+        
+        # Check 8: HTTP redirect
+        echo -e "${BLUE}8. Testing HTTP redirect...${NC}"
+        local http_response
+        # NOSONAR - Testing HTTP to HTTPS redirect behavior requires HTTP request
+        http_response=$(curl -s -o /dev/null -w "%{http_code}" "http://$domain" 2>/dev/null || echo "000")
+        if [[ "$http_response" == "301" ]]; then
+            print_success "HTTP redirects to HTTPS (301)"
+        else
+            print_warning "HTTP redirect test failed (got $http_response)"
+            if [[ "$http_response" == "000" ]]; then
+                print_info "This may be normal if development server is not running"
+            fi
+        fi
+        
+        # Check 9: HTTPS connection (with SSL verification)
+        echo -e "${BLUE}9. Testing HTTPS connection...${NC}"
+        local https_response
+        # First try with SSL verification enabled (secure)
+        https_response=$(curl -s -o /dev/null -w "%{http_code}" --connect-timeout 10 "https://$domain" 2>/dev/null || echo "000")
+        if [[ "$https_response" == "200" ]]; then
+            print_success "HTTPS connection successful with valid SSL (200)"
+        elif [[ "$https_response" == "000" ]]; then
+            # SSL verification may have failed - this could indicate self-signed cert
+            print_warning "HTTPS connection failed - SSL certificate may be invalid or self-signed"
+            print_info "This may be normal for local development environments"
+        else
+            print_warning "HTTPS connection test failed (got $https_response)"
+        fi
+    fi
+    
+    echo ""
+    if [[ "$all_checks_passed" == true ]]; then
+        print_success "All critical checks passed!"
+        echo ""
+        echo -e "${GREEN}✅ Domain is ready: https://$domain${NC}"
+        echo ""
+        echo -e "${BLUE}Next steps:${NC}"
+        echo "1. Start development server: cd $project_dir && PORT=$port npm run dev" || exit
+        echo "2. Visit: https://$domain"
+        echo "3. Accept SSL certificate warning in browser"
+    else
+        print_error "Some checks failed - see messages above for fixes"
+        echo ""
+        echo -e "${YELLOW}Common fixes:${NC}"
+        echo "• Add to hosts: echo \"127.0.0.1 $domain\" | sudo tee -a /etc/hosts"
+        echo "• Setup domain: ./webhosting-helper.sh setup $project_name"
+        echo "• Start LocalWP application"
+    fi
+    return 0
+}
+
+# Show help
+show_help() {
+    echo "Web Hosting Verification Script"
+    echo ""
+    echo "Usage: $0 [command] [options]"
+    echo ""
+    echo "Commands:"
+    echo "  verify <project-name>    Verify local domain setup"
+    echo "  help                     Show this help message"
+    echo ""
+    echo "Examples:"
+    echo "  $0 verify myapp"
+    echo "  $0 verify turbostarter-source"
+    echo ""
+    return 0
+}
+
+# Main script logic
+main() {
+    local command="${1:-help}"
+    local project_name="$2"
+
+    case "$command" in
+        "verify")
+            verify_domain "$project_name"
+            ;;
+        "help"|*)
+            show_help
+            ;;
+    esac
+    return 0
+}
+
+main "$@"