aidevops 2.52.1

package/.agent/scripts/opencode-test-helper.sh

@@ -0,0 +1,213 @@
+#!/bin/bash
+# shellcheck disable=SC2155
+# =============================================================================
+# OpenCode CLI Testing Helper
+# =============================================================================
+# Quick testing of OpenCode configuration changes without TUI restart.
+# Useful for testing new MCPs, agent permissions, and slash commands.
+#
+# Usage:
+#   opencode-test-helper.sh test-mcp <mcp-name> <agent>
+#   opencode-test-helper.sh test-agent <agent>
+#   opencode-test-helper.sh list-tools <agent>
+#   opencode-test-helper.sh serve [port]
+#   opencode-test-helper.sh attach <message> [agent] [port]
+#   opencode-test-helper.sh run <message> [--agent <agent>]
+# =============================================================================
+
+set -euo pipefail
+
+# Colors
+readonly GREEN='\033[0;32m'
+readonly BLUE='\033[0;34m'
+readonly YELLOW='\033[1;33m'
+readonly RED='\033[0;31m'
+readonly NC='\033[0m'
+
+print_info() { echo -e "${BLUE}[INFO]${NC} $1"; return 0; }
+print_success() { echo -e "${GREEN}[OK]${NC} $1"; return 0; }
+print_warning() { echo -e "${YELLOW}[WARN]${NC} $1"; return 0; }
+print_error() { echo -e "${RED}[ERROR]${NC} $1"; return 0; }
+
+show_help() {
+    cat << 'EOF'
+OpenCode CLI Testing Helper
+
+Test OpenCode configuration changes without restarting the TUI.
+
+Commands:
+  test-mcp <mcp-name> [agent]   Test if MCP is accessible by agent
+  test-agent <agent>            Test agent tool permissions
+  list-tools [agent]            List tools available to agent
+  serve [port]                  Start persistent server (default: 4096)
+  attach <message> [agent]      Run against persistent server
+  run <message> [--agent name]  Run single command (passthrough to opencode)
+  
+Examples:
+  opencode-test-helper.sh test-mcp dataforseo SEO
+  opencode-test-helper.sh test-mcp serper SEO
+  opencode-test-helper.sh test-agent Plan+
+  opencode-test-helper.sh list-tools Build+
+  opencode-test-helper.sh serve 4096
+  opencode-test-helper.sh attach "quick test" SEO
+
+Workflow for testing new MCPs:
+  1. Edit ~/.config/opencode/opencode.json
+  2. Run: opencode-test-helper.sh test-mcp <mcp-name> <agent>
+  3. If working, restart TUI
+  4. If failing, check output and iterate
+EOF
+    return 0
+}
+
+# Check if opencode is installed
+check_opencode() {
+    if ! command -v opencode &> /dev/null; then
+        print_error "OpenCode CLI not found. Install from https://opencode.ai"
+        exit 1
+    fi
+    return 0
+}
+
+# Test if MCP is accessible by agent
+test_mcp() {
+    local mcp_name="$1"
+    local agent="${2:-Build+}"
+    
+    print_info "Testing MCP '$mcp_name' with agent '$agent'..."
+    echo ""
+    
+    local result
+    result=$(opencode run "List all tools you have access to that start with '${mcp_name}_'. Format as a simple list. If none found, say 'No ${mcp_name} tools available'." --agent "$agent" 2>&1) || true
+    
+    echo "$result"
+    echo ""
+    
+    if echo "$result" | grep -qi "no.*tools\|not available\|error\|failed"; then
+        print_warning "MCP '$mcp_name' may not be accessible to agent '$agent'"
+        print_info "Check ~/.config/opencode/opencode.json for:"
+        print_info "  1. MCP server is defined in 'mcp' section"
+        print_info "  2. Tool pattern '${mcp_name}_*' is enabled for agent"
+        return 1
+    else
+        print_success "MCP '$mcp_name' appears accessible to agent '$agent'"
+        return 0
+    fi
+}
+
+# Test agent permissions
+test_agent() {
+    local agent="$1"
+    
+    print_info "Testing agent '$agent' permissions..."
+    echo ""
+    
+    print_info "Testing read access..."
+    opencode run "Read the first 3 lines of ~/.aidevops/agents/AGENTS.md and confirm you can read files." --agent "$agent" 2>&1 || true
+    echo ""
+    
+    print_info "Testing write access (should fail for read-only agents like Plan+)..."
+    local write_result
+    write_result=$(opencode run "Try to create a file at /tmp/opencode-test-$$.txt with content 'test'. Report if you succeeded or were denied." --agent "$agent" 2>&1) || true
+    echo "$write_result"
+    
+    # Cleanup
+    rm -f "/tmp/opencode-test-$$.txt" 2>/dev/null || true
+    
+    echo ""
+    if echo "$write_result" | grep -qi "denied\|cannot\|not allowed\|permission"; then
+        print_info "Agent '$agent' is read-only (write denied)"
+    else
+        print_info "Agent '$agent' has write access"
+    fi
+    
+    return 0
+}
+
+# List tools available to agent
+list_tools() {
+    local agent="${1:-Build+}"
+    
+    print_info "Listing tools for agent '$agent'..."
+    echo ""
+    
+    opencode run "List ALL tools you have access to. Group them by: 1) Built-in tools (read, write, edit, bash, etc.) 2) MCP tools (grouped by MCP name). Be comprehensive and format as a clear list." --agent "$agent" 2>&1 || true
+    
+    return 0
+}
+
+# Start persistent server
+start_serve() {
+    local port="${1:-4096}"
+    
+    print_info "Starting OpenCode server on port $port..."
+    print_info "Use 'opencode run --attach http://localhost:$port \"message\" --agent AgentName' to test"
+    print_info "Or use: $0 attach \"message\" AgentName"
+    print_warning "Press Ctrl+C to stop"
+    echo ""
+    
+    opencode serve --port "$port"
+    return 0
+}
+
+# Run against persistent server
+run_attach() {
+    local message="$1"
+    local agent="${2:-Build+}"
+    local port="${3:-4096}"
+    
+    print_info "Running against server on port $port with agent '$agent'..."
+    opencode run --attach "http://localhost:$port" "$message" --agent "$agent"
+    return 0
+}
+
+# Passthrough to opencode run
+run_passthrough() {
+    opencode run "$@"
+    return 0
+}
+
+# Main
+main() {
+    check_opencode
+    
+    local command="${1:-help}"
+    
+    case "$command" in
+        test-mcp)
+            [[ $# -lt 2 ]] && { print_error "Usage: $0 test-mcp <mcp-name> [agent]"; exit 1; }
+            test_mcp "$2" "${3:-Build+}"
+            ;;
+        test-agent)
+            [[ $# -lt 2 ]] && { print_error "Usage: $0 test-agent <agent>"; exit 1; }
+            test_agent "$2"
+            ;;
+        list-tools)
+            list_tools "${2:-Build+}"
+            ;;
+        serve)
+            start_serve "${2:-4096}"
+            ;;
+        attach)
+            [[ $# -lt 2 ]] && { print_error "Usage: $0 attach <message> [agent] [port]"; exit 1; }
+            run_attach "$2" "${3:-Build+}" "${4:-4096}"
+            ;;
+        run)
+            shift
+            run_passthrough "$@"
+            ;;
+        help|--help|-h)
+            show_help
+            ;;
+        *)
+            print_error "Unknown command: $command"
+            echo ""
+            show_help
+            exit 1
+            ;;
+    esac
+    
+    return 0
+}
+
+main "$@"

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

@@ -0,0 +1,464 @@
+#!/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
+
+# 🚀 PageSpeed Insights & Lighthouse Helper Script
+# Comprehensive website performance auditing and optimization guidance
+
+set -euo pipefail
+
+# Colors for output
+readonly RED='\033[0;31m'
+readonly GREEN='\033[0;32m'
+readonly BLUE='\033[0;34m'
+readonly YELLOW='\033[1;33m'
+readonly PURPLE='\033[0;35m'
+readonly CYAN='\033[0;36m'
+readonly NC='\033[0m'
+
+print_header() { local msg="$1"; echo -e "${PURPLE}$msg${NC}"; return 0; }
+print_info() { local msg="$1"; echo -e "${BLUE}$msg${NC}"; return 0; }
+print_success() { local msg="$1"; echo -e "${GREEN}$msg${NC}"; return 0; }
+print_warning() { local msg="$1"; echo -e "${YELLOW}$msg${NC}"; return 0; }
+print_error() { local msg="$1"; echo -e "${RED}$msg${NC}"; return 0; }
+print_metric() { local msg="$1"; echo -e "${CYAN}$msg${NC}"; return 0; }
+
+# Configuration
+readonly PAGESPEED_API_URL="https://www.googleapis.com/pagespeedonline/v5/runPagespeed"
+readonly REPORTS_DIR="$HOME/.ai-devops/reports/pagespeed"
+
+# Ensure reports directory exists
+mkdir -p "$REPORTS_DIR"
+
+# Check prerequisites
+check_prerequisites() {
+    print_header "Checking Prerequisites"
+    
+    # Check for curl
+    if ! command -v curl &> /dev/null; then
+        print_error "curl is required but not installed"
+        exit 1
+    fi
+    
+    # Check for jq (for JSON parsing)
+    if ! command -v jq &> /dev/null; then
+        print_warning "jq not found. Installing for better JSON parsing..."
+        if [[ "$OSTYPE" == "darwin"* ]]; then
+            if command -v brew &> /dev/null; then
+                brew install jq
+            else
+                print_error "Please install jq manually: https://stedolan.github.io/jq/"
+                exit 1
+            fi
+        else
+            print_error "Please install jq manually: https://stedolan.github.io/jq/"
+            exit 1
+        fi
+    fi
+    
+    # Check for Lighthouse CLI
+    if ! command -v lighthouse &> /dev/null; then
+        print_warning "Lighthouse CLI not found. Installing..."
+        if command -v npm &> /dev/null; then
+            npm install -g lighthouse
+            print_success "Lighthouse CLI installed"
+        else
+            print_error "npm is required to install Lighthouse CLI"
+            print_info "Install Node.js from: https://nodejs.org/"
+            exit 1
+        fi
+    fi
+    
+    print_success "All prerequisites satisfied"
+    return 0
+}
+
+# Run PageSpeed Insights API test
+run_pagespeed_api() {
+    local url="$command"
+    local strategy="${2:-desktop}"  # desktop or mobile
+    local api_key="${GOOGLE_API_KEY:-}"
+    
+    print_header "Running PageSpeed Insights API Test"
+    print_info "URL: $url"
+    print_info "Strategy: $strategy"
+    
+    # Build API URL
+    local api_url="$PAGESPEED_API_URL?url=$url&strategy=$strategy"
+    
+    if [[ -n "$api_key" ]]; then
+        api_url="$api_url&key=$api_key"
+        print_info "Using API key for higher rate limits"
+    else
+        print_warning "No API key provided. Using public rate limits."
+        print_info "Set GOOGLE_API_KEY environment variable for higher limits"
+    fi
+    
+    # Make API request
+    local timestamp
+    timestamp=$(date +"%Y%m%d_%H%M%S")
+    local report_file="$REPORTS_DIR/pagespeed_${timestamp}_${strategy}.json"
+    
+    print_info "Fetching PageSpeed data..."
+    
+    if curl -s "$api_url" > "$report_file"; then
+        print_success "PageSpeed report saved: $report_file"
+        
+        # Parse and display key metrics
+        parse_pagespeed_report "$report_file"
+    else
+        print_error "Failed to fetch PageSpeed data"
+        return 1
+    fi
+    
+    return 0
+}
+
+# Parse PageSpeed report and extract actionable insights
+parse_pagespeed_report() {
+    local report_file="$command"
+    
+    print_header "PageSpeed Insights Results"
+    
+    # Check if report contains error
+    if jq -e '.error' "$report_file" &> /dev/null; then
+        local error_message
+        error_message=$(jq -r '.error.message' "$report_file")
+        print_error "API Error: $error_message"
+        return 1
+    fi
+    
+    # Extract key metrics
+    local performance_score
+    local fcp
+    local lcp
+    local cls
+    local fid
+    local ttfb
+    
+    performance_score=$(jq -r '.lighthouseResult.categories.performance.score // "N/A"' "$report_file")
+    fcp=$(jq -r '.lighthouseResult.audits["first-contentful-paint"].displayValue // "N/A"' "$report_file")
+    lcp=$(jq -r '.lighthouseResult.audits["largest-contentful-paint"].displayValue // "N/A"' "$report_file")
+    cls=$(jq -r '.lighthouseResult.audits["cumulative-layout-shift"].displayValue // "N/A"' "$report_file")
+    fid=$(jq -r '.lighthouseResult.audits["max-potential-fid"].displayValue // "N/A"' "$report_file")
+    ttfb=$(jq -r '.lighthouseResult.audits["server-response-time"].displayValue // "N/A"' "$report_file")
+    
+    # Display metrics with color coding
+    echo
+    print_metric "Performance Score: $(format_score "$performance_score")"
+    print_metric "First Contentful Paint (FCP): $fcp"
+    print_metric "Largest Contentful Paint (LCP): $lcp"
+    print_metric "Cumulative Layout Shift (CLS): $cls"
+    print_metric "First Input Delay (FID): $fid"
+    print_metric "Time to First Byte (TTFB): $ttfb"
+    echo
+    
+    # Extract opportunities for improvement
+    print_header "Optimization Opportunities"
+    
+    local opportunities
+    opportunities=$(jq -r '.lighthouseResult.audits | to_entries[] | select(.value.details.overallSavingsMs > 0) | "\(.key): \(.value.title) - Potential savings: \(.value.details.overallSavingsMs)ms"' "$report_file" 2>/dev/null || echo "No specific opportunities found")
+    
+    if [[ "$opportunities" != "No specific opportunities found" ]]; then
+        echo "$opportunities" | head -10
+    else
+        print_info "No major optimization opportunities identified"
+    fi
+    
+    return 0
+}
+
+# Format score with color coding
+format_score() {
+    local score="$command"
+    
+    if [[ "$score" == "N/A" ]]; then
+        echo "N/A"
+        return
+    fi
+    
+    # Convert to percentage
+    local percentage
+    percentage=$(echo "$score * 100" | bc -l 2>/dev/null || echo "0")
+    local int_percentage
+    int_percentage=${percentage%.*}
+    
+    if [[ $int_percentage -ge 90 ]]; then
+        echo -e "${GREEN}${int_percentage}%${NC}"
+    elif [[ $int_percentage -ge 50 ]]; then
+        echo -e "${YELLOW}${int_percentage}%${NC}"
+    else
+        echo -e "${RED}${int_percentage}%${NC}"
+    fi
+    return 0
+}
+
+# Run Lighthouse CLI audit
+run_lighthouse_audit() {
+    local url="$command"
+    local output_format="${2:-html}"  # html, json, csv
+    
+    print_header "Running Lighthouse CLI Audit"
+    print_info "URL: $url"
+    print_info "Output format: $output_format"
+    
+    local timestamp
+    timestamp=$(date +"%Y%m%d_%H%M%S")
+    local report_file="$REPORTS_DIR/lighthouse_${timestamp}.$output_format"
+    
+    print_info "Running comprehensive Lighthouse audit..."
+    
+    # Run Lighthouse with comprehensive options
+    if lighthouse "$url" \
+        --output="$output_format" \
+        --output-path="$report_file" \
+        --chrome-flags="--headless --no-sandbox" \
+        --quiet; then
+        
+        print_success "Lighthouse report saved: $report_file"
+        
+        # If JSON format, parse key metrics
+        if [[ "$output_format" == "json" ]]; then
+            parse_lighthouse_json "$report_file"
+        else
+            print_info "Open the HTML report in your browser to view detailed results"
+        fi
+    else
+        print_error "Lighthouse audit failed"
+        return 1
+    fi
+    
+    return 0
+}
+
+# Parse Lighthouse JSON report
+parse_lighthouse_json() {
+    local report_file="$command"
+    
+    print_header "Lighthouse Audit Results"
+    
+    # Extract scores for all categories
+    local performance
+    local accessibility
+    local best_practices
+    local seo
+    local pwa
+    
+    performance=$(jq -r '.categories.performance.score // "N/A"' "$report_file")
+    accessibility=$(jq -r '.categories.accessibility.score // "N/A"' "$report_file")
+    best_practices=$(jq -r '.categories["best-practices"].score // "N/A"' "$report_file")
+    seo=$(jq -r '.categories.seo.score // "N/A"' "$report_file")
+    pwa=$(jq -r '.categories.pwa.score // "N/A"' "$report_file")
+    
+    echo
+    print_metric "Performance: $(format_score "$performance")"
+    print_metric "Accessibility: $(format_score "$accessibility")"
+    print_metric "Best Practices: $(format_score "$best_practices")"
+    print_metric "SEO: $(format_score "$seo")"
+    print_metric "PWA: $(format_score "$pwa")"
+    echo
+
+    return 0
+}
+
+# WordPress-specific performance analysis
+analyze_wordpress_performance() {
+    local url="$command"
+
+    print_header "WordPress Performance Analysis"
+    print_info "Analyzing WordPress-specific performance issues for: $url"
+
+    # Run both PageSpeed and Lighthouse
+    run_pagespeed_api "$url" "desktop"
+    echo
+    run_pagespeed_api "$url" "mobile"
+    echo
+    run_lighthouse_audit "$url" "json"
+
+    # WordPress-specific recommendations
+    print_header "WordPress Optimization Recommendations"
+    echo
+    print_info "Common WordPress Performance Issues to Check:"
+    echo "• Plugin Performance: Disable unnecessary plugins"
+    echo "• Image Optimization: Use WebP format and proper sizing"
+    echo "• Caching: Implement page caching (WP Rocket, W3 Total Cache)"
+    echo "• CDN: Use a Content Delivery Network (Cloudflare, MaxCDN)"
+    echo "• Database Optimization: Clean up revisions and spam"
+    echo "• Theme Performance: Use lightweight, optimized themes"
+    echo "• Hosting: Ensure adequate server resources"
+    echo
+
+    return 0
+}
+
+# Bulk audit multiple URLs
+bulk_audit() {
+    local urls_file="$command"
+
+    if [[ ! -f "$urls_file" ]]; then
+        print_error "URLs file not found: $urls_file"
+        return 1
+    fi
+
+    print_header "Bulk Website Audit"
+    print_info "Processing URLs from: $urls_file"
+
+    local count=0
+    while IFS= read -r url; do
+        # Skip empty lines and comments
+        [[ -z "$url" || "$url" =~ ^#.*$ ]] && continue
+
+        count=$((count + 1))
+        print_header "Auditing Site $count: $url"
+
+        # Run PageSpeed for both desktop and mobile
+        run_pagespeed_api "$url" "desktop"
+        run_pagespeed_api "$url" "mobile"
+
+        echo "----------------------------------------"
+
+        # Add delay to respect rate limits
+        sleep 2
+
+    done < "$urls_file"
+
+    print_success "Bulk audit completed for $count websites"
+    return 0
+}
+
+# Generate actionable report
+generate_actionable_report() {
+    local report_file="$command"
+
+    if [[ ! -f "$report_file" ]]; then
+        print_error "Report file not found: $report_file"
+        return 1
+    fi
+
+    print_header "Actionable Performance Report"
+
+    # Extract and prioritize recommendations
+    local recommendations
+    recommendations=$(jq -r '
+        .lighthouseResult.audits |
+        to_entries[] |
+        select(.value.score != null and .value.score < 0.9) |
+        select(.value.details.overallSavingsMs > 100 or .value.numericValue > 2000) |
+        {
+            title: .value.title,
+            description: .value.description,
+            savings: (.value.details.overallSavingsMs // 0),
+            impact: (if .value.details.overallSavingsMs > 1000 then "HIGH"
+                    elif .value.details.overallSavingsMs > 500 then "MEDIUM"
+                    else "LOW" end)
+        }
+    ' "$report_file" 2>/dev/null)
+
+    if [[ -n "$recommendations" ]]; then
+        echo "$recommendations" | jq -r '"🔧 \(.title) (\(.impact) IMPACT)\n   💡 \(.description)\n   ⏱️  Potential savings: \(.savings)ms\n"'
+    else
+        print_info "No major performance issues found. Great job!"
+    fi
+
+    return 0
+}
+
+# Main function
+main() {
+    # Assign positional parameters to local variables
+    local command="${1:-help}"
+    local account_name="$account_name"
+    local target="$target"
+    local options="$options"
+    # Assign positional parameters to local variables
+    local command="${1:-help}"
+    local account_name="$account_name"
+    local target="$target"
+    local options="$options"
+    # Assign positional parameters to local variables
+    local command="${1:-help}"
+    local account_name="$account_name"
+    local target="$target"
+    local options="$options"
+    # Assign positional parameters to local variables
+    case "${1:-help}" in
+        "check"|"audit")
+            if [[ -z "${2:-}" ]]; then
+                print_error "Please provide a URL to audit"
+                print_info "Usage: $0 audit <url>"
+                exit 1
+            fi
+            check_prerequisites
+            run_pagespeed_api "$account_name" "desktop"
+            echo
+            run_pagespeed_api "$account_name" "mobile"
+            ;;
+        "lighthouse")
+            if [[ -z "${2:-}" ]]; then
+                print_error "Please provide a URL for Lighthouse audit"
+                print_info "Usage: $0 lighthouse <url> [format]"
+                exit 1
+            fi
+            check_prerequisites
+            run_lighthouse_audit "$account_name" "${3:-html}"
+            ;;
+        "wordpress"|"wp")
+            if [[ -z "${2:-}" ]]; then
+                print_error "Please provide a WordPress URL to analyze"
+                print_info "Usage: $0 wordpress <url>"
+                exit 1
+            fi
+            check_prerequisites
+            analyze_wordpress_performance "$account_name"
+            ;;
+        "bulk")
+            if [[ -z "${2:-}" ]]; then
+                print_error "Please provide a file containing URLs"
+                print_info "Usage: $0 bulk <urls-file>"
+                print_info "File format: one URL per line"
+                exit 1
+            fi
+            check_prerequisites
+            bulk_audit "$account_name"
+            ;;
+        "report")
+            if [[ -z "${2:-}" ]]; then
+                print_error "Please provide a report file to analyze"
+                print_info "Usage: $0 report <report-file.json>"
+                exit 1
+            fi
+            generate_actionable_report "$account_name"
+            ;;
+        "install-deps")
+            check_prerequisites
+            ;;
+        "help"|*)
+            print_header "PageSpeed Insights & Lighthouse Helper"
+            echo "Usage: $0 [command] [options]"
+            echo ""
+            echo "Commands:"
+            echo "  audit <url>              - Run PageSpeed Insights for desktop & mobile"
+            echo "  lighthouse <url> [fmt]   - Run Lighthouse audit (html/json/csv)"
+            echo "  wordpress <url>          - WordPress-specific performance analysis"
+            echo "  bulk <urls-file>         - Audit multiple URLs from file"
+            echo "  report <report.json>     - Generate actionable report from JSON"
+            echo "  install-deps             - Install required dependencies"
+            echo "  help                     - Show this help"
+            echo ""
+            echo "Environment Variables:"
+            echo "  GOOGLE_API_KEY          - Google API key for higher rate limits"
+            echo ""
+            echo "Examples:"
+            echo "  $0 audit https://example.com"
+            echo "  $0 lighthouse https://example.com json"
+            echo "  $0 wordpress https://myblog.com"
+            echo "  $0 bulk websites.txt"
+            echo ""
+            echo "Reports are saved to: $REPORTS_DIR"
+            ;;
+    esac
+    return 0
+}
+
+main "$@"
+
+return 0