feat: Implement agents05 signal system with CLI startup fixes

.env.example

@@ -1,19 +1,117 @@
-# PRP Environment Configuration
+# PRP MCP Server Environment Configuration
+# Copy this file to .env and update the values
 
-# AI Provider Configuration (optional)
-# Uncomment and set the API key for your preferred provider
+# =============================================================================
+# REQUIRED CONFIGURATION
+# =============================================================================
 
-# OpenAI (GPT-4, Codex)
-# OPENAI_API_KEY=sk-...
+# API_SECRET: JWT signing secret for MCP server authentication
+# Generate a secure random key: openssl rand -hex 32
+API_SECRET=your-very-secure-api-secret-key-here
 
-# Anthropic (Claude)
-# ANTHROPIC_API_KEY=sk-ant-...
+# =============================================================================
+# SERVER CONFIGURATION
+# =============================================================================
 
-# Google (Gemini)
-# GOOGLE_API_KEY=...
+# Server port (default: 8080)
+PORT=8080
 
-# Default AI Provider (openai, anthropic, google)
-# AI_PROVIDER=openai
+# Server host (default: 0.0.0.0)
+HOST=0.0.0.0
 
-# Other Configuration
-# DEBUG=prp:*
+# Node environment (development|production)
+NODE_ENV=development
+
+# Log level (error|warn|info|debug|verbose)
+LOG_LEVEL=info
+
+# =============================================================================
+# SECURITY CONFIGURATION
+# =============================================================================
+
+# JWT token expiration (e.g., 1h, 24h, 7d)
+JWT_EXPIRATION=1h
+
+# Rate limiting: window in minutes
+RATE_LIMIT_WINDOW=5
+
+# Rate limiting: max requests per window
+RATE_LIMIT_MAX=50
+
+# Maximum concurrent connections
+MAX_CONNECTIONS=100
+
+# CORS allowed origins (comma-separated, or * for all)
+CORS_ORIGINS=http://localhost:3000,http://localhost:5173
+
+# Enable streaming responses
+ENABLE_STREAMING=true
+
+# =============================================================================
+# AI PROVIDER CONFIGURATION (Optional)
+# =============================================================================
+
+# OpenAI API key for GPT models
+OPENAI_API_KEY=sk-your-openai-api-key-here
+
+# Anthropic API key for Claude models
+ANTHROPIC_API_KEY=sk-ant-your-anthropic-api-key-here
+
+# GLM API key for large language models
+GLM_API_KEY=your-glm-api-key-here
+
+# =============================================================================
+# NOTIFICATION CONFIGURATION (Optional)
+# =============================================================================
+
+# Nudge service secret for notifications
+NUDGE_SECRET=your-nudge-secret-here
+
+# Admin ID for notifications
+ADMIN_ID=your-admin-id-here
+
+# =============================================================================
+# SSL CONFIGURATION (Optional - for production)
+# =============================================================================
+
+# Enable SSL/HTTPS
+SSL_ENABLED=false
+
+# SSL certificate path (when SSL_ENABLED=true)
+SSL_CERT_PATH=/etc/ssl/certs/cert.pem
+
+# SSL private key path (when SSL_ENABLED=true)
+SSL_KEY_PATH=/etc/ssl/private/key.pem
+
+# =============================================================================
+# MONITORING CONFIGURATION (Optional)
+# =============================================================================
+
+# Grafana admin password (for monitoring stack)
+GRAFANA_PASSWORD=your-grafana-password-here
+
+# =============================================================================
+# DEVELOPMENT SETTINGS
+# =============================================================================
+
+# Enable debug mode
+DEBUG=false
+
+# Disable colored output
+NO_COLOR=false
+
+# Enable telemetry
+PRP_TELEMETRY=false
+
+# =============================================================================
+# EXAMPLE VALUES FOR TESTING
+# =============================================================================
+
+# Example API_SECRET (generate your own!)
+# API_SECRET=a1b2c3d4e5f6789012345678901234567890abcdef1234567890abcdef123456
+
+# Example CORS for development
+# CORS_ORIGINS=http://localhost:3000,http://localhost:5173,http://127.0.0.1:3000
+
+# Example CORS for production
+# CORS_ORIGINS=https://yourdomain.com,https://app.yourdomain.com