aidevops 2.52.1 → 2.53.1

package/templates/standard-functions.sh

@@ -0,0 +1,179 @@
+#!/bin/bash
+
+# Standard Functions Template for AI DevOps Framework
+# This template provides SonarCloud-compliant function definitions
+
+# Color definitions
+GREEN='\033[0;32m'
+BLUE='\033[0;34m'
+YELLOW='\033[1;33m'
+RED='\033[0;31m'
+NC='\033[0m'
+
+# Standard print functions - SonarCloud compliant
+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
+}
+
+# Standard dependency check function
+check_dependencies() {
+    local missing_deps=0
+    
+    if ! command -v curl &> /dev/null; then
+        print_error "curl is required but not installed"
+        missing_deps=1
+    fi
+    
+    if ! command -v jq &> /dev/null; then
+        print_error "jq is required for JSON processing. Please install it:"
+        echo "  macOS: brew install jq" >&2
+        echo "  Ubuntu: sudo apt-get install jq" >&2
+        missing_deps=1
+    fi
+    
+    if [[ $missing_deps -eq 1 ]]; then
+        exit 1
+    fi
+    
+    return 0
+}
+
+# Standard configuration loading function
+load_config() {
+    local config_file="$1"
+    
+    if [[ ! -f "$config_file" ]]; then
+        print_error "Configuration file not found: $config_file"
+        print_info "Copy and customize the template file to get started"
+        exit 1
+    fi
+    
+    if ! jq empty "$config_file" 2>/dev/null; then
+        print_error "Invalid JSON in configuration file: $config_file"
+        exit 1
+    fi
+    
+    return 0
+}
+
+# Standard account configuration function
+get_account_config() {
+    local account_name="$1"
+    local config_file="$2"
+    
+    if [[ -z "$account_name" ]]; then
+        print_error "Account name is required"
+        return 1
+    fi
+    
+    if ! jq -e ".accounts.\"$account_name\"" "$config_file" >/dev/null 2>&1; then
+        print_error "Account '$account_name' not found in configuration"
+        print_info "Available accounts: $(jq -r '.accounts | keys | join(", ")' "$config_file" 2>/dev/null || echo "none")"
+        return 1
+    fi
+    
+    return 0
+}
+
+# Standard API request function
+api_request() {
+    local method="$1"
+    local url="$2"
+    local data="$3"
+    local headers="$4"
+    
+    local curl_args=(-s -X "$method")
+    
+    if [[ -n "$headers" ]]; then
+        while IFS= read -r header; do
+            curl_args+=(-H "$header")
+        done <<< "$headers"
+    fi
+    
+    if [[ -n "$data" && "$method" != "GET" ]]; then
+        curl_args+=(-d "$data")
+    fi
+    
+    curl_args+=("$url")
+    
+    local response
+    response=$(curl "${curl_args[@]}" 2>/dev/null)
+    local exit_code=$?
+    
+    if [[ $exit_code -ne 0 ]]; then
+        print_error "API request failed with exit code: $exit_code"
+        return 1
+    fi
+    
+    echo "$response"
+    return 0
+}
+
+# Standard help function template
+show_help() {
+    local script_name="$1"
+    local service_name="$2"
+    
+    echo "Usage: $script_name [command] [account] [options]"
+    echo ""
+    echo "$service_name Helper Script"
+    echo ""
+    echo "Commands:"
+    echo "  help                    Show this help message"
+    echo "  accounts               List configured accounts"
+    echo "  [service-specific]     Service-specific commands"
+    echo ""
+    echo "Examples:"
+    echo "  $script_name help"
+    echo "  $script_name accounts"
+    echo ""
+    
+    return 0
+}
+
+# Standard main function template
+main() {
+    local command="$1"
+    
+    case "$command" in
+        "help"|"--help"|"-h"|"")
+            show_help "$(basename "$0")" "Service"
+            return 0
+            ;;
+        "accounts")
+            list_accounts
+            return $?
+            ;;
+        *)
+            print_error "Unknown command: $command"
+            show_help "$(basename "$0")" "Service"
+            return 1
+            ;;
+    esac
+    return 0
+}
+
+# Note: Individual scripts should implement:
+# - list_accounts() function
+# - Service-specific functions
+# - Call main "$@" at the end of the script

package/templates/wordpress-performance-workflow.md

@@ -0,0 +1,217 @@
+# WordPress Performance Optimization Workflow
+
+This template provides a comprehensive workflow for optimizing WordPress website performance using the AI DevOps framework.
+
+## 🚀 **Quick Performance Audit**
+
+```bash
+# Comprehensive WordPress performance analysis
+./.agent/scripts/pagespeed-helper.sh wordpress https://your-wordpress-site.com
+
+# This will run:
+# 1. PageSpeed Insights (desktop & mobile)
+# 2. Lighthouse comprehensive audit
+# 3. WordPress-specific recommendations
+```text
+
+## 📊 **Step-by-Step Optimization Process**
+
+### **1. Initial Performance Baseline**
+
+```bash
+# Create baseline report
+./.agent/scripts/pagespeed-helper.sh audit https://your-site.com
+```text
+
+**Key Metrics to Track:**
+
+- Performance Score (target: >90%)
+- First Contentful Paint (target: <1.8s)
+- Largest Contentful Paint (target: <2.5s)
+- Cumulative Layout Shift (target: <0.1)
+
+### **2. WordPress-Specific Optimizations**
+
+#### Plugin Performance
+
+```bash
+# Use Query Monitor plugin to identify slow plugins
+# Disable unnecessary plugins
+# Replace heavy plugins with lightweight alternatives
+```text
+
+#### Image Optimization
+
+```bash
+# Convert images to WebP format
+# Implement lazy loading
+# Use proper image dimensions
+# Consider CDN for image delivery
+```text
+
+#### Caching Implementation
+
+```bash
+# Install caching plugin (WP Rocket recommended)
+# Configure page caching
+# Enable object caching (Redis/Memcached)
+# Set up CDN integration
+```text
+
+#### Database Optimization
+
+```bash
+# Clean up post revisions
+# Remove spam comments
+# Optimize database tables
+# Use WP-Optimize or similar plugin
+```text
+
+### **3. Server-Level Optimizations**
+
+```bash
+# Check server response time (TTFB)
+# Ensure adequate server resources
+# Consider upgrading hosting if needed
+# Implement server-level caching
+```text
+
+### **4. Code Optimizations**
+
+```bash
+# Minify CSS and JavaScript
+# Remove unused CSS/JS
+# Optimize critical rendering path
+# Use lightweight theme
+```text
+
+## 🔄 **Continuous Monitoring Workflow**
+
+### **Weekly Performance Check**
+
+```bash
+# Create monitoring script
+cat > weekly-performance-check.sh << 'EOF'
+#!/bin/bash
+SITE_URL="https://your-wordpress-site.com"
+DATE=$(date +"%Y-%m-%d")
+
+echo "Weekly Performance Check - $DATE"
+./.agent/scripts/pagespeed-helper.sh wordpress "$SITE_URL"
+
+# Save results for comparison
+cp ~/.ai-devops/reports/pagespeed/lighthouse_*.json "weekly-reports/lighthouse-$DATE.json"
+EOF
+
+chmod +x weekly-performance-check.sh
+```text
+
+### **Automated Monitoring with Cron**
+
+```bash
+# Add to crontab for weekly monitoring
+# 0 9 * * 1 /path/to/weekly-performance-check.sh
+```text
+
+## 🎯 **AI Assistant Integration**
+
+### **System Prompt for WordPress Optimization**
+
+Add this to your AI assistant's system prompt:
+
+```text
+For WordPress performance optimization, use the PageSpeed and Lighthouse tools in 
+~/git/aidevops/.agent/scripts/pagespeed-helper.sh. Focus on:
+
+1. Core Web Vitals improvement
+2. WordPress-specific optimizations (plugins, themes, caching)
+3. Image optimization and CDN implementation
+4. Database cleanup and optimization
+5. Server-level performance enhancements
+
+Always provide specific, actionable recommendations with implementation steps.
+```text
+
+### Common AI Assistant Tasks
+
+1. **"Audit my WordPress site performance"**
+
+   ```bash
+   ./.agent/scripts/pagespeed-helper.sh wordpress https://your-site.com
+   ```
+
+2. **"Compare performance before and after optimization"**
+
+   ```bash
+   ./.agent/scripts/pagespeed-helper.sh report before-optimization.json
+   ./.agent/scripts/pagespeed-helper.sh report after-optimization.json
+   ```
+
+3. **"Monitor multiple WordPress sites"**
+
+   ```bash
+   # Create sites list
+   echo "https://site1.com" > wordpress-sites.txt
+   echo "https://site2.com" >> wordpress-sites.txt
+   
+   ./.agent/scripts/pagespeed-helper.sh bulk wordpress-sites.txt
+   ```
+
+## 📈 **Performance Targets**
+
+### **Core Web Vitals Goals**
+
+- **First Contentful Paint (FCP)**: < 1.8 seconds
+- **Largest Contentful Paint (LCP)**: < 2.5 seconds
+- **First Input Delay (FID)**: < 100 milliseconds
+- **Cumulative Layout Shift (CLS)**: < 0.1
+
+### **Lighthouse Scores**
+
+- **Performance**: > 90%
+- **Accessibility**: > 95%
+- **Best Practices**: > 90%
+- **SEO**: > 90%
+
+## 🛠️ **Common WordPress Performance Issues & Solutions**
+
+### **Slow Loading Times**
+
+- **Issue**: Large images, unoptimized plugins
+- **Solution**: Image optimization, plugin audit, caching
+
+### **Poor Mobile Performance**
+
+- **Issue**: Unresponsive design, large resources
+- **Solution**: Mobile-first optimization, AMP implementation
+
+### **High Server Response Time**
+
+- **Issue**: Inadequate hosting, database issues
+- **Solution**: Hosting upgrade, database optimization
+
+### **Layout Shifts**
+
+- **Issue**: Images without dimensions, dynamic content
+- **Solution**: Specify image dimensions, optimize loading sequence
+
+## 📊 **Reporting and Analysis**
+
+### **Generate Performance Report**
+
+```bash
+# Generate comprehensive report
+./.agent/scripts/pagespeed-helper.sh lighthouse https://your-site.com json
+./.agent/scripts/pagespeed-helper.sh report ~/.ai-devops/reports/pagespeed/lighthouse_*.json
+```text
+
+### **Track Improvements Over Time**
+
+```bash
+# Compare reports
+echo "Performance improvement tracking:"
+echo "Before: $(jq '.categories.performance.score' before.json)"
+echo "After: $(jq '.categories.performance.score' after.json)"
+```text
+
+This workflow ensures systematic WordPress performance optimization with measurable results and continuous monitoring.