aidevops 2.52.1

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

@@ -0,0 +1,744 @@
+#!/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
+
+# Localhost Development Helper Script
+# Sets up local Docker apps with .local domains and SSL certificates
+
+# Source shared constants if available
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+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'
+NC='\033[0m' # No Color
+
+# Error message constants (use shared-constants.sh if available, otherwise define locally)
+if [[ -z "${ERROR_UNKNOWN_COMMAND:-}" ]]; then
+    readonly ERROR_UNKNOWN_COMMAND="Unknown command:"
+fi
+if [[ -z "${HELP_USAGE_INFO:-}" ]]; then
+    readonly HELP_USAGE_INFO="Use '$0 help' for usage information"
+fi
+
+print_info() {
+    local msg="$1"
+    echo -e "${BLUE}[INFO]${NC} $msg"
+    return 0
+}
+
+print_success() {
+    local msg="$1"
+    echo -e "${GREEN}[SUCCESS]${NC} $msg"
+    return 0
+}
+
+print_warning() {
+    local msg="$1"
+    echo -e "${YELLOW}[WARNING]${NC} $msg"
+    return 0
+}
+
+print_error() {
+    local msg="$1"
+    echo -e "${RED}[ERROR]${NC} $msg" >&2
+    return 0
+}
+
+# Configuration file
+CONFIG_FILE="../configs/localhost-config.json"
+
+# =============================================================================
+# Port Management Functions
+# =============================================================================
+# These functions ensure port conflicts are avoided and services use available ports.
+# This is critical for:
+# 1. Avoiding "port already in use" errors
+# 2. Enabling SSL via reverse proxy (password managers require HTTPS)
+# 3. Consistent .local domain access across all local services
+
+# Default port range for auto-assignment
+readonly PORT_RANGE_START=3000
+readonly PORT_RANGE_END=9999
+
+# Check if a port is in use
+# Returns 0 if port is FREE, 1 if port is IN USE
+is_port_free() {
+    local port="$1"
+    if [[ -z "$port" ]]; then
+        print_error "Port number required"
+        return 1
+    fi
+    
+    # Check using lsof (works on macOS and Linux)
+    if lsof -i :"$port" >/dev/null 2>&1; then
+        return 1  # Port is in use
+    fi
+    
+    # Double-check with nc if available
+    if command -v nc >/dev/null 2>&1; then
+        if nc -z 127.0.0.1 "$port" 2>/dev/null; then
+            return 1  # Port is in use
+        fi
+    fi
+    
+    return 0  # Port is free
+}
+
+# Find the next available port starting from a given port
+# Usage: find_available_port [start_port]
+# Returns: Prints the first available port
+find_available_port() {
+    local start_port="${1:-$PORT_RANGE_START}"
+    local port="$start_port"
+    
+    while [[ $port -le $PORT_RANGE_END ]]; do
+        if is_port_free "$port"; then
+            echo "$port"
+            return 0
+        fi
+        ((port++))
+    done
+    
+    print_error "No available ports found in range $start_port-$PORT_RANGE_END"
+    return 1
+}
+
+# Check port and suggest alternative if in use
+# Usage: check_port_or_suggest [port]
+# Returns: 0 if port is free, 1 if in use (prints suggestion)
+check_port_or_suggest() {
+    local port="$1"
+    
+    if [[ -z "$port" ]]; then
+        print_error "Port number required"
+        return 1
+    fi
+    
+    if is_port_free "$port"; then
+        print_success "Port $port is available"
+        return 0
+    else
+        local process_info
+        process_info=$(lsof -i :"$port" 2>/dev/null | tail -1 | awk '{print $1, $2}')
+        print_warning "Port $port is in use by: $process_info"
+        
+        local suggested_port
+        suggested_port=$(find_available_port "$((port + 1))")
+        if [[ -n "$suggested_port" ]]; then
+            print_info "Suggested alternative: $suggested_port"
+            echo "SUGGESTED_PORT=$suggested_port"
+        fi
+        return 1
+    fi
+}
+
+# List all ports currently in use by local development services
+list_dev_ports() {
+    print_info "Ports in use by local development services:"
+    echo ""
+    
+    # Common development port ranges
+    local dev_ports=(3000 3001 3002 3003 4000 5000 5173 5174 8000 8080 8085 8888 9000 9222 11235)
+    
+    for port in "${dev_ports[@]}"; do
+        if ! is_port_free "$port"; then
+            local process_info
+            process_info=$(lsof -i :"$port" 2>/dev/null | tail -1 | awk '{print $1}')
+            echo "  :$port - $process_info"
+        fi
+    done
+    
+    echo ""
+    print_info "Use 'lsof -i :<port>' for detailed process info"
+    return 0
+}
+
+# Kill process on a specific port
+kill_port() {
+    local port="$1"
+    
+    if [[ -z "$port" ]]; then
+        print_error "Port number required"
+        return 1
+    fi
+    
+    local pids
+    pids=$(lsof -ti :"$port" 2>/dev/null)
+    
+    if [[ -z "$pids" ]]; then
+        print_info "No process found on port $port"
+        return 0
+    fi
+    
+    print_warning "Killing process(es) on port $port: $pids"
+    echo "$pids" | xargs kill -9 2>/dev/null
+    
+    # Wait up to 3 seconds for the port to become free
+    for _ in {1..6}; do
+        if is_port_free "$port"; then
+            print_success "Port $port is now free"
+            return 0
+        fi
+        sleep 0.5
+    done
+
+    print_error "Failed to free port $port"
+    return 1
+}
+
+# Check if config file exists
+check_config() {
+    if [[ ! -f "$CONFIG_FILE" ]]; then
+        print_error "$ERROR_CONFIG_NOT_FOUND"
+        print_info "Copy and customize: cp ../configs/localhost-config.json.txt $CONFIG_FILE"
+        exit 1
+    fi
+    return 0
+}
+
+# Check required tools
+check_requirements() {
+    local missing_tools=()
+    local optional_tools=()
+
+    command -v docker >/dev/null 2>&1 || missing_tools+=("docker")
+    command -v mkcert >/dev/null 2>&1 || missing_tools+=("mkcert")
+    command -v dnsmasq >/dev/null 2>&1 || missing_tools+=("dnsmasq")
+
+    # Check for LocalWP (optional)
+    if [[ -d "/Applications/Local.app" ]] || [[ -d "$HOME/Applications/Local.app" ]]; then
+        print_success "LocalWP found - WordPress development integration available"
+
+        # Check for LocalWP MCP server
+        if command -v mcp-local-wp >/dev/null 2>&1; then
+            print_success "LocalWP MCP server found - AI database access available"
+        else
+            print_info "Install LocalWP MCP server: npm install -g @verygoodplugins/mcp-local-wp"
+
+        # Check for Context7 MCP server
+        if command -v npx >/dev/null 2>&1; then
+            print_success "Context7 MCP server available via npx"
+        else
+            print_info "Install Node.js and npm for Context7 MCP server access"
+        fi
+        fi
+    else
+        optional_tools+=("LocalWP")
+    fi
+
+    if [[ ${#missing_tools[@]} -gt 0 ]]; then
+        print_error "Missing required tools: ${missing_tools[*]}"
+        echo ""
+        echo "Install missing tools:"
+        echo "  Docker: https://docs.docker.com/get-docker/"
+        echo "  mkcert: brew install mkcert (macOS) or see https://github.com/FiloSottile/mkcert"
+        echo "  dnsmasq: brew install dnsmasq (macOS) or sudo apt-get install dnsmasq (Linux)"
+        return 1
+    fi
+
+    if [[ ${#optional_tools[@]} -gt 0 ]]; then
+        print_info "Optional tools not found: ${optional_tools[*]}"
+        echo "  LocalWP: https://localwp.com/ (for WordPress development)"
+    fi
+
+    return 0
+}
+
+# Setup local DNS resolution for .local domains
+setup_local_dns() {
+    print_info "Setting up local DNS resolution for .local domains..."
+    
+    # Check if dnsmasq is configured
+    local dnsmasq_conf="/usr/local/etc/dnsmasq.conf"
+    if [[ "$OSTYPE" == "linux-gnu"* ]]; then
+        dnsmasq_conf="/etc/dnsmasq.conf"
+    fi
+    
+    if [[ -f "$dnsmasq_conf" ]]; then
+        if ! grep -q "address=/.local/127.0.0.1" "$dnsmasq_conf"; then
+            print_info "Adding .local domain resolution to dnsmasq..."
+            echo "address=/.local/127.0.0.1" | sudo tee -a "$dnsmasq_conf"
+            
+            # Restart dnsmasq
+            if [[ "$OSTYPE" == "darwin"* ]]; then
+                sudo brew services restart dnsmasq
+            else
+                sudo systemctl restart dnsmasq
+            fi
+            
+            print_success "dnsmasq configured for .local domains"
+        else
+            print_info "dnsmasq already configured for .local domains"
+        fi
+    else
+        print_warning "dnsmasq configuration file not found"
+        print_info "Manual setup required - see documentation"
+    fi
+    
+    # Setup resolver for macOS
+    if [[ "$OSTYPE" == "darwin"* ]]; then
+        sudo mkdir -p /etc/resolver
+        echo "nameserver 127.0.0.1" | sudo tee /etc/resolver/local
+        print_success "macOS resolver configured for .local domains"
+    fi
+    return 0
+}
+
+# Generate SSL certificate for local domain
+generate_ssl_cert() {
+    local domain="$1"
+    
+    if [[ -z "$domain" ]]; then
+        print_error "Please specify a domain"
+        return 1
+    fi
+    
+    print_info "Generating SSL certificate for $domain..."
+    
+    # Create certs directory
+    mkdir -p ~/.local-ssl-certs
+    
+    # Generate certificate with mkcert
+    cd ~/.local-ssl-certs || exit
+    mkcert "$domain" "*.$domain"
+    
+    if docker --version >/dev/null 2>&1; then
+        print_success "SSL certificate generated for $domain"
+        print_info "Certificate files:"
+        print_info "  - ~/.local-ssl-certs/$domain+1.pem (certificate)"
+        print_info "  - ~/.local-ssl-certs/$domain+1-key.pem (private key)"
+    else
+        print_error "Failed to generate SSL certificate"
+        return 1
+    fi
+    return 0
+}
+
+# List configured local apps
+list_apps() {
+    check_config
+    print_info "Configured local development apps:"
+
+    apps=$(jq -r '.apps | keys[]' "$CONFIG_FILE")
+    for app in $apps; do
+        domain=$(jq -r ".apps.$app.domain" "$CONFIG_FILE")
+        port=$(jq -r ".apps.$app.port" "$CONFIG_FILE")
+        ssl=$(jq -r ".apps.$app.ssl" "$CONFIG_FILE")
+        description=$(jq -r ".apps.$app.description" "$CONFIG_FILE")
+
+        ssl_status="HTTP"
+        if [[ "$ssl" == "true" ]]; then
+            ssl_status="HTTPS"
+        fi
+
+        echo "  - $app: $description"
+        echo "    URL: $ssl_status://$domain (port $port)"
+        echo ""
+    done
+    return 0
+}
+
+# Setup reverse proxy with Traefik
+setup_traefik() {
+    print_info "Setting up Traefik reverse proxy for local development..."
+    
+    # Create Traefik configuration
+    mkdir -p ~/.local-dev-proxy
+    
+    cat > ~/.local-dev-proxy/traefik.yml << 'EOF'
+api:
+  dashboard: true
+  insecure: true
+
+entryPoints:
+  web:
+    address: ":80"
+  websecure:
+    address: ":443"
+
+providers:
+  docker:
+    exposedByDefault: false
+  file:
+    filename: /etc/traefik/dynamic.yml
+    watch: true
+
+certificatesResolvers:
+  local:
+    acme:
+      email: dev@localhost
+      storage: acme.json
+      keyType: EC256
+EOF
+
+    cat > ~/.local-dev-proxy/dynamic.yml << 'EOF'
+tls:
+  certificates:
+    - certFile: /certs/localhost.pem
+      keyFile: /certs/localhost-key.pem
+EOF
+
+    # Create docker-compose for Traefik
+    cat > ~/.local-dev-proxy/docker-compose.yml << 'EOF'
+version: '3.8'
+
+services:
+  traefik:
+    image: traefik:v2.10
+    container_name: local-traefik
+    restart: unless-stopped
+    ports:
+      - "80:80"
+      - "443:443"
+      - "8080:8080"  # Traefik dashboard
+    volumes:
+      - /var/run/docker.sock:/var/run/docker.sock:ro
+      - ./traefik.yml:/etc/traefik/traefik.yml:ro
+      - ./dynamic.yml:/etc/traefik/dynamic.yml:ro
+      - ~/.local-ssl-certs:/certs:ro
+    networks:
+      - local-dev
+
+networks:
+  local-dev:
+    external: true
+EOF
+
+    # Create network
+    docker network create local-dev 2>/dev/null || true
+    
+    # Start Traefik
+    cd ~/.local-dev-proxy || exit
+    docker-compose up -d
+
+    print_success "Traefik reverse proxy started"
+    print_info "Dashboard available at: http://localhost:8080"
+    return 0
+}
+
+# List LocalWP sites
+list_localwp_sites() {
+    print_info "Checking for LocalWP sites..."
+
+    local localwp_path="$HOME/Local Sites"
+    if [[ -d "$localwp_path" ]]; then
+        print_success "LocalWP sites found:"
+        for site_dir in "$localwp_path"/*; do
+            if [[ -d "$site_dir" ]]; then
+                local site_name
+                site_name=$(basename "$site_dir")
+                local conf_file="$site_dir/conf/nginx/site.conf"
+                if [[ -f "$conf_file" ]]; then
+                    local port
+                    port=$(grep -o 'listen [0-9]*' "$conf_file" | head -1 | awk '{print $param2}')
+                    echo "  - $site_name (http://localhost:$port)"
+                else
+                    echo "  - $site_name (configuration not found)"
+                fi
+            fi
+        done
+    else
+        print_warning "LocalWP sites directory not found at: $localwp_path"
+        print_info "Install LocalWP from: https://localwp.com/"
+    fi
+    return 0
+}
+
+# Create LocalWP-compatible .local domain
+setup_localwp_domain() {
+    local site_name="$1"
+    local custom_domain="$param2"
+
+    if [[ -z "$site_name" ]]; then
+        print_error "Usage: setup-localwp-domain [site-name] [custom-domain.local]"
+        return 1
+    fi
+
+    local localwp_path="$HOME/Local Sites/$site_name"
+    if [[ ! -d "$localwp_path" ]]; then
+        print_error "LocalWP site not found: $site_name"
+        print_info "Available sites:"
+        list_localwp_sites
+        return 1
+    fi
+
+    local domain="${custom_domain:-$site_name.local}"
+    local conf_file="$localwp_path/conf/nginx/site.conf"
+
+    if [[ -f "$conf_file" ]]; then
+        local port
+        port=$(grep -o 'listen [0-9]*' "$conf_file" | head -1 | awk '{print $param2}')
+        print_info "Setting up $domain for LocalWP site $site_name (port $port)"
+
+        # Generate SSL certificate
+        generate_ssl_cert "$domain"
+
+        # Add to Traefik configuration
+        setup_localwp_traefik "$site_name" "$domain" "$port"
+
+        print_success "LocalWP site $site_name now available at: https://$domain"
+    else
+        print_error "LocalWP configuration not found for: $site_name"
+    fi
+    return 0
+}
+
+# Setup Traefik for LocalWP site
+setup_localwp_traefik() {
+    local site_name="$1"
+    local domain="$param2"
+    local port="$param3"
+
+    # Create Traefik configuration for LocalWP site
+    mkdir -p ~/.local-dev-proxy/localwp
+
+    cat > ~/.local-dev-proxy/localwp/"$site_name".yml << EOF
+http:
+  routers:
+    localwp-$site_name:
+      rule: "Host(\`$domain\`)"
+      tls: true
+      service: localwp-$site_name-service
+      entryPoints:
+        - websecure
+
+  services:
+    localwp-$site_name-service:
+      loadBalancer:
+        servers:
+          - url: "http://localhost:$port"
+EOF
+
+    print_success "Traefik configuration created for $site_name"
+    return 0
+}
+
+# Create Docker app with .local domain
+create_app() {
+    local app_name="$1"
+    local domain="$param2"
+    local port="$param3"
+    local ssl="${4:-true}"
+    local app_type="${5:-docker}"
+
+    if [[ -z "$app_name" || -z "$domain" || -z "$port" ]]; then
+        print_error "Usage: create-app [app-name] [domain.local] [port] [ssl:true/false] [type:docker/localwp]"
+        return 1
+    fi
+
+    print_info "Creating local app: $app_name at $domain:$port (type: $app_type)"
+
+    # Generate SSL certificate if needed
+    if [[ "$ssl" == "true" ]]; then
+        generate_ssl_cert "$domain"
+    fi
+
+    if [[ "$app_type" == "localwp" ]]; then
+        setup_localwp_domain "$app_name" "$domain"
+        return $?
+    fi
+
+    # Create app directory
+    mkdir -p ~/.local-apps/"$app_name"
+
+    # Create sample docker-compose with Traefik labels
+    cat > ~/.local-apps/"$app_name"/docker-compose.yml << EOF
+version: '3.8'
+
+services:
+  $app_name:
+    image: nginx:alpine
+    container_name: $app_name
+    restart: unless-stopped
+    labels:
+      - "traefik.enable=true"
+      - "traefik.http.routers.$app_name.rule=Host(\`$domain\`)"
+      - "traefik.http.services.$app_name.loadbalancer.server.port=$port"
+EOF
+
+    if [[ "$ssl" == "true" ]]; then
+        cat >> ~/.local-apps/"$app_name"/docker-compose.yml << EOF
+      - "traefik.http.routers.$app_name.tls=true"
+      - "traefik.http.routers.$app_name.entrypoints=websecure"
+EOF
+    else
+        cat >> ~/.local-apps/"$app_name"/docker-compose.yml << EOF
+      - "traefik.http.routers.$app_name.entrypoints=web"
+EOF
+    fi
+
+    cat >> ~/.local-apps/"$app_name"/docker-compose.yml << EOF
+    networks:
+      - local-dev
+
+networks:
+  local-dev:
+    external: true
+EOF
+
+    print_success "App configuration created at ~/.local-apps/$app_name/"
+
+    if [[ "$ssl" == "true" ]]; then
+        print_info "Access your app at: https://$domain"
+    else
+        # SONAR: Local dev without SSL is intentional
+        print_info "Access your app at: http://$domain"
+    fi
+    return 0
+}
+
+# Start LocalWP MCP server
+start_localwp_mcp() {
+    print_info "Starting LocalWP MCP server..."
+
+    if ! command -v mcp-local-wp >/dev/null 2>&1; then
+        print_error "LocalWP MCP server not installed"
+        print_info "Install with: npm install -g @verygoodplugins/mcp-local-wp"
+        return 1
+    fi
+
+    # Check if LocalWP is running
+    if ! pgrep -f "Local" >/dev/null 2>&1; then
+        print_warning "Local by Flywheel doesn't appear to be running"
+        print_info "Start Local by Flywheel and ensure a site is active"
+    fi
+
+    print_info "Starting MCP server on port 8085..."
+    mcp-local-wp --transport sse --port 8085 &
+    local mcp_pid=$!
+
+    sleep 2
+    if kill -0 "$mcp_pid" 2>/dev/null; then
+        print_success "LocalWP MCP server started (PID: $mcp_pid)"
+        print_info "AI assistants can now access your WordPress database"
+        print_info "Available tools: mysql_query, mysql_schema"
+        return 0
+    else
+        print_error "Failed to start LocalWP MCP server"
+        return 1
+    fi
+    return 0
+}
+
+# Stop LocalWP MCP server
+stop_localwp_mcp() {
+    print_info "Stopping LocalWP MCP server..."
+
+    local pids
+    pids=$(pgrep -f "mcp-local-wp")
+    if [[ -n "$pids" ]]; then
+        echo "$pids" | xargs kill
+        print_success "LocalWP MCP server stopped"
+    else
+        print_info "LocalWP MCP server not running"
+    fi
+    return 0
+}
+
+# Main function
+main() {
+    # Assign positional parameters to local variables
+    local command="${1:-help}"
+    local param2="$2"
+    local param3="$3"
+    local param4="$4"
+    local param5="$5"
+    local param6="$6"
+
+    # Main command handler
+    case "$command" in
+    "setup-dns")
+        check_requirements && setup_local_dns
+        ;;
+    "setup-proxy")
+        check_requirements && setup_traefik
+        ;;
+    "generate-cert")
+        generate_ssl_cert "$param2"
+        ;;
+    "list")
+        list_apps
+        ;;
+    "create-app")
+        create_app "$param2" "$param3" "$param4" "$param5" "$param6"
+        ;;
+    "list-localwp")
+        list_localwp_sites
+        ;;
+    "setup-localwp-domain")
+        setup_localwp_domain "$param2" "$param3"
+        ;;
+    "start-mcp")
+        start_localwp_mcp
+        ;;
+    "stop-mcp")
+        stop_localwp_mcp
+        ;;
+    "check-port")
+        check_port_or_suggest "$param2"
+        ;;
+    "find-port")
+        find_available_port "$param2"
+        ;;
+    "list-ports")
+        list_dev_ports
+        ;;
+    "kill-port")
+        kill_port "$param2"
+        ;;
+    "help"|"-h"|"--help"|"")
+        echo "Localhost Development Helper Script"
+        echo "Usage: $0 [command] [options]"
+        echo ""
+        echo "DNS & Proxy Commands:"
+        echo "  setup-dns                           - Setup local DNS resolution for .local domains"
+        echo "  setup-proxy                         - Setup Traefik reverse proxy"
+        echo "  generate-cert [domain]              - Generate SSL certificate for domain"
+        echo ""
+        echo "App Management Commands:"
+        echo "  list                                - List configured local apps"
+        echo "  create-app [name] [domain] [port] [ssl] [type] - Create new local app"
+        echo ""
+        echo "LocalWP Integration Commands:"
+        echo "  list-localwp                        - List LocalWP sites"
+        echo "  setup-localwp-domain [site] [domain] - Setup .local domain for LocalWP site"
+        echo "  start-mcp                           - Start LocalWP MCP server for AI database access"
+        echo "  stop-mcp                            - Stop LocalWP MCP server"
+        echo ""
+        echo "Port Management Commands:"
+        echo "  check-port [port]                   - Check if port is available, suggest alternative"
+        echo "  find-port [start]                   - Find next available port from start (default: 3000)"
+        echo "  list-ports                          - List common dev ports in use"
+        echo "  kill-port [port]                    - Kill process using specified port"
+        echo ""
+        echo "Examples:"
+        echo "  $0 setup-dns"
+        echo "  $0 setup-proxy"
+        echo "  $0 generate-cert myapp.local"
+        echo "  $0 create-app myapp myapp.local 3000 true docker"
+        echo "  $0 list-localwp"
+        echo "  $0 setup-localwp-domain plugin-testing plugin-testing.local"
+        echo "  $0 start-mcp"
+        echo "  $0 stop-mcp"
+        echo ""
+        echo "Requirements:"
+        echo "  - Docker and Docker Compose"
+        echo "  - mkcert for SSL certificates"
+        echo "  - dnsmasq for local DNS resolution"
+        echo "  - LocalWP (optional, for WordPress development)"
+        echo "  - @verygoodplugins/mcp-local-wp (optional, for AI database access)"
+        ;;
+    *)
+        print_error "$ERROR_UNKNOWN_COMMAND $command"
+        print_info "$HELP_USAGE_INFO"
+        exit 1
+        ;;
+esac
+return 0
+}
+
+# Run main function
+main "$@"