aidevops 2.52.1

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

@@ -0,0 +1,279 @@
+#!/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
+
+# Updown.io Helper Script
+# Managed by AI DevOps Framework
+#
+# Version: 1.0.0
+
+# Set strict mode
+set -euo pipefail
+
+# ------------------------------------------------------------------------------
+# CONFIGURATION & CONSTANTS
+# ------------------------------------------------------------------------------
+
+readonly SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)" || exit
+readonly REPO_ROOT="$(dirname "$SCRIPT_DIR")"
+readonly CONFIG_FILE="$REPO_ROOT/configs/updown-config.json"
+readonly API_BASE_URL="https://updown.io/api"
+
+# Colors
+readonly BLUE='\033[0;34m'
+readonly GREEN='\033[0;32m'
+readonly YELLOW='\033[1;33m'
+readonly RED='\033[0;31m'
+readonly NC='\033[0m'
+
+# HTTP Constants
+readonly CONTENT_TYPE_JSON="$CONTENT_TYPE_JSON"
+# Error Messages
+readonly ERROR_CONFIG_MISSING="Configuration file not found at $CONFIG_FILE"
+readonly ERROR_API_KEY_MISSING="API key not found in configuration"
+readonly ERROR_CURL_FAILED="Failed to execute API request"
+readonly ERROR_JQ_MISSING="jq is required but not installed"
+
+# ------------------------------------------------------------------------------
+# UTILITY FUNCTIONS
+# ------------------------------------------------------------------------------
+
+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
+}
+
+check_dependencies() {
+    if ! command -v jq >/dev/null 2>&1; then
+        print_error "$ERROR_JQ_MISSING"
+        return 1
+    fi
+    return 0
+}
+
+load_config() {
+    local api_key
+    
+    # First try environment variable (preferred - set via mcp-env.sh)
+    api_key="${UPDOWN_API_KEY:-}"
+    
+    # Fallback to config file if env var not set
+    if [[ -z "$api_key" && -f "$CONFIG_FILE" ]]; then
+        api_key=$(jq -r '.api_key // empty' "$CONFIG_FILE" 2>/dev/null)
+    fi
+
+    if [[ -z "$api_key" ]]; then
+        print_error "$ERROR_API_KEY_MISSING"
+        print_error "Set UPDOWN_API_KEY in ~/.config/aidevops/mcp-env.sh"
+        return 1
+    fi
+
+    echo "$api_key"
+    return 0
+}
+
+# ------------------------------------------------------------------------------
+# API INTERACTION FUNCTIONS
+# ------------------------------------------------------------------------------
+
+execute_request() {
+    local method="$command"
+    local endpoint="$account_name"
+    local data="${3:-}"
+    
+    local api_key
+    if ! api_key=$(load_config); then
+        return 1
+    fi
+
+    local response
+    local http_code
+    
+    local curl_cmd=(curl -s -w "\n%{http_code}" -X "$method")
+    curl_cmd+=(-H "X-API-KEY: $api_key")
+    
+    if [[ -n "$data" ]]; then
+        curl_cmd+=(-H "$CONTENT_TYPE_JSON")
+        curl_cmd+=(-d "$data")
+    fi
+    
+    curl_cmd+=("$API_BASE_URL$endpoint")
+
+    if ! response=$("${curl_cmd[@]}"); then
+        print_error "$ERROR_CURL_FAILED"
+        return 1
+    fi
+
+    http_code=$(echo "$response" | tail -n1)
+    local body
+    body=$(echo "$response" | sed '$d')
+
+    if [[ "$http_code" -ge 200 && "$http_code" -lt 300 ]]; then
+        echo "$body"
+        return 0
+    else
+        print_error "API request failed with status $http_code: $body"
+        return 1
+    fi
+    return 0
+}
+
+# ------------------------------------------------------------------------------
+# CORE FUNCTIONS
+# ------------------------------------------------------------------------------
+
+list_checks() {
+    local response
+    if response=$(execute_request "GET" "/checks"); then
+        echo "$response" | jq -r '.[] | "\(.token)\t\(.url)\t\(.alias // "")\t\(.status)\t(Last: \(.last_status))"' | column -t -s $'\t'
+        return 0
+    fi
+    return 1
+}
+
+get_checks_json() {
+    local response
+    if response=$(execute_request "GET" "/checks"); then
+        echo "$response"
+        return 0
+    fi
+    return 1
+}
+
+add_check() {
+    local url="$command"
+    local alias="${2:-}"
+    local period="${3:-3600}" # Default to 1 hour (3600 seconds)
+
+    if [[ -z "$url" ]]; then
+        print_error "URL is required"
+        return 1
+    fi
+
+    print_info "Adding check for $url..."
+
+    # Construct JSON payload safely
+    local payload
+    payload=$(jq -n \
+                  --arg url "$url" \
+                  --arg alias "$alias" \
+                  --argjson period "$period" \
+                  '{url: $url, alias: $alias, period: $period, published: true}')
+
+    if execute_request "POST" "/checks" "$payload" >/dev/null; then
+        print_success "Check added successfully for $url"
+        return 0
+    fi
+    return 1
+}
+
+delete_check() {
+    local token="$command"
+
+    if [[ -z "$token" ]]; then
+        print_error "Check token is required"
+        return 1
+    fi
+
+    print_info "Deleting check $token..."
+
+    if execute_request "DELETE" "/checks/$token" >/dev/null; then
+        print_success "Check deleted successfully"
+        return 0
+    fi
+    return 1
+}
+
+get_metrics() {
+    local token="$command"
+    
+    if [[ -z "$token" ]]; then
+        print_error "Check token is required"
+        return 1
+    fi
+
+    if execute_request "GET" "/checks/$token/metrics" >/dev/null; then
+        # The metrics endpoint returns complex JSON, just printing it for now or could use jq to format
+        execute_request "GET" "/checks/$token/metrics" | jq '.'
+        return 0
+    fi
+    return 1
+}
+
+show_help() {
+    echo "Usage: $(basename "$0") [command] [arguments...]"
+    echo
+    echo "Commands:"
+    echo "  list                    List all monitoring checks"
+    echo "  add <url> [alias]       Add a new check (default 1h interval)"
+    echo "  delete <token>          Delete a check"
+    echo "  json                    Output raw JSON of all checks"
+    echo "  help                    Show this help message"
+    echo
+    return 0
+}
+
+# ------------------------------------------------------------------------------
+# MAIN EXECUTION
+# ------------------------------------------------------------------------------
+
+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"
+    check_dependencies || return 1
+
+    local command="${1:-help}"
+    local arg1="${2:-}"
+    local arg2="${3:-}"
+    local arg3="${4:-}"
+
+    case "$command" in
+        "list")
+            list_checks
+            ;;
+        "json")
+            get_checks_json
+            ;;
+        "add")
+            add_check "$arg1" "$arg2" "$arg3"
+            ;;
+        "delete")
+            delete_check "$arg1"
+            ;;
+        "metrics")
+            get_metrics "$arg1"
+            ;;
+        "help"|*)
+            show_help
+            ;;
+    esac
+    return 0
+}
+
+main "$@"

package/.agent/scripts/validate-mcp-integrations.sh

@@ -0,0 +1,250 @@
+#!/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
+
+# 🔍 MCP Integrations Validation Script
+# Validates and tests all MCP integrations for proper functionality
+
+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 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; }
+
+# Test results tracking
+declare -i total_tests=0
+declare -i passed_tests=0
+declare -i failed_tests=0
+
+# Test function wrapper
+run_test() {
+    local test_name="$1"
+    local test_command="$2"
+    
+    ((total_tests++))
+    print_info "Testing: $test_name"
+    
+    if eval "$test_command" &>/dev/null; then
+        print_success "$test_name: PASSED"
+        ((passed_tests++))
+        return 0
+    else
+        print_error "$test_name: FAILED"
+        ((failed_tests++))
+        return 1
+    fi
+    return 0
+}
+
+# Test Node.js and npm
+test_prerequisites() {
+    print_header "Testing Prerequisites"
+    
+    run_test "Node.js availability" "command -v node"
+    run_test "npm availability" "command -v npm"
+    
+    if command -v node &>/dev/null; then
+        local node_version
+        node_version=$(node --version)
+        print_info "Node.js version: $node_version"
+    fi
+    
+    if command -v npm &>/dev/null; then
+        local npm_version
+        npm_version=$(npm --version)
+        print_info "npm version: $npm_version"
+    fi
+    return 0
+}
+
+# Test Chrome DevTools MCP
+test_chrome_devtools() {
+    print_header "Testing Chrome DevTools MCP"
+    
+    run_test "Chrome DevTools MCP package" "npm list -g chrome-devtools-mcp || npm info chrome-devtools-mcp"
+    
+    # Test Chrome availability
+    local chrome_paths=(
+        "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"
+        "/Applications/Google Chrome Canary.app/Contents/MacOS/Google Chrome Canary"
+        "/usr/bin/google-chrome"
+        "/usr/bin/google-chrome-stable"
+        "/usr/bin/chromium-browser"
+    )
+    
+    local chrome_found=false
+    for chrome_path in "${chrome_paths[@]}"; do
+        if [[ -x "$chrome_path" ]]; then
+            print_success "Chrome found: $chrome_path"
+            chrome_found=true
+            break
+        fi
+    done
+    
+    if [[ "$chrome_found" == false ]]; then
+        print_warning "Chrome not found in standard locations"
+    fi
+    return 0
+}
+
+# Test Playwright MCP
+test_playwright() {
+    print_header "Testing Playwright MCP"
+    
+    run_test "Playwright MCP package" "npm list -g playwright-mcp || npm info playwright-mcp"
+    run_test "Playwright package" "npm list -g playwright || npm info playwright"
+    
+    # Test browser installations
+    if command -v npx &>/dev/null; then
+        print_info "Checking Playwright browser installations..."
+        if npx playwright --version &>/dev/null; then
+            print_success "Playwright CLI available"
+        else
+            print_warning "Playwright CLI not available"
+        fi
+    fi
+    return 0
+}
+
+# Test API connectivity
+test_api_connectivity() {
+    print_header "Testing API Connectivity"
+    
+    # Test Ahrefs API
+    if [[ -n "${AHREFS_API_KEY:-}" ]]; then
+        run_test "Ahrefs API connectivity" "curl -s -H 'Authorization: Bearer $AHREFS_API_KEY' https://apiv2.ahrefs.com/v2/subscription_info"
+        print_success "Ahrefs API key configured"
+    else
+        print_warning "Ahrefs API key not configured (AHREFS_API_KEY)"
+    fi
+    
+    # Test Perplexity API
+    if [[ -n "${PERPLEXITY_API_KEY:-}" ]]; then
+        run_test "Perplexity API connectivity" "curl -s -H 'Authorization: Bearer $PERPLEXITY_API_KEY' https://api.perplexity.ai/chat/completions"
+        print_success "Perplexity API key configured"
+    else
+        print_warning "Perplexity API key not configured (PERPLEXITY_API_KEY)"
+    fi
+    
+    # Test Cloudflare API
+    if [[ -n "${CLOUDFLARE_API_TOKEN:-}" && -n "${CLOUDFLARE_ACCOUNT_ID:-}" ]]; then
+        run_test "Cloudflare API connectivity" "curl -s -H 'Authorization: Bearer $CLOUDFLARE_API_TOKEN' https://api.cloudflare.com/client/v4/accounts/$CLOUDFLARE_ACCOUNT_ID"
+        print_success "Cloudflare API credentials configured"
+    else
+        print_warning "Cloudflare API credentials not configured (CLOUDFLARE_API_TOKEN, CLOUDFLARE_ACCOUNT_ID)"
+    fi
+    return 0
+}
+
+# Test MCP configurations
+test_mcp_configurations() {
+    print_header "Testing MCP Configurations"
+    
+    local config_dir="configs/mcp-templates"
+    
+    if [[ -d "$config_dir" ]]; then
+        print_success "MCP templates directory exists"
+        
+        # Test each configuration file
+        for config_file in "$config_dir"/*.json; do
+            if [[ -f "$config_file" ]]; then
+                local filename
+                filename=$(basename "$config_file")
+                run_test "JSON validation: $filename" "python3 -m json.tool '$config_file'"
+            fi
+        done
+    else
+        print_error "MCP templates directory not found: $config_dir"
+    fi
+    return 0
+}
+
+# Test network connectivity
+test_network() {
+    print_header "Testing Network Connectivity"
+    
+    run_test "Internet connectivity" "curl -s --connect-timeout 5 https://www.google.com"
+    run_test "npm registry" "curl -s --connect-timeout 5 https://registry.npmjs.org/"
+    run_test "GitHub connectivity" "curl -s --connect-timeout 5 https://api.github.com"
+    return 0
+}
+
+# Generate validation report
+generate_report() {
+    print_header "Validation Report"
+    
+    echo
+    print_info "Total tests run: $total_tests"
+    print_success "Tests passed: $passed_tests"
+    
+    if [[ $failed_tests -gt 0 ]]; then
+        print_error "Tests failed: $failed_tests"
+    else
+        print_success "Tests failed: $failed_tests"
+    fi
+    
+    echo
+    local success_rate
+    success_rate=$((passed_tests * 100 / total_tests))
+    
+    if [[ $success_rate -ge 90 ]]; then
+        print_success "Overall status: EXCELLENT ($success_rate% success rate)"
+    elif [[ $success_rate -ge 75 ]]; then
+        print_success "Overall status: GOOD ($success_rate% success rate)"
+    elif [[ $success_rate -ge 50 ]]; then
+        print_warning "Overall status: NEEDS ATTENTION ($success_rate% success rate)"
+    else
+        print_error "Overall status: CRITICAL ISSUES ($success_rate% success rate)"
+    fi
+    
+    echo
+    if [[ $failed_tests -gt 0 ]]; then
+        print_info "Next steps:"
+        print_info "1. Review failed tests above"
+        print_info "2. Check .agent/MCP-TROUBLESHOOTING.md for solutions"
+        print_info "3. Run setup script: bash .agent/scripts/setup-mcp-integrations.sh"
+        print_info "4. Configure missing API keys"
+    else
+        print_success "All MCP integrations are ready to use!"
+        print_info "Check .agent/MCP-INTEGRATIONS.md for usage examples"
+    fi
+    return 0
+}
+
+# Main validation function
+main() {
+    print_header "MCP Integrations Validation"
+    echo
+    
+    test_prerequisites
+    echo
+    
+    test_network
+    echo
+    
+    test_chrome_devtools
+    echo
+    
+    test_playwright
+    echo
+    
+    test_api_connectivity
+    echo
+    
+    test_mcp_configurations
+    echo
+    
+    generate_report
+    return 0
+}
+
+main "$@"

package/.agent/scripts/validate-version-consistency.sh

@@ -0,0 +1,131 @@
+#!/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
+
+# AI DevOps Framework - Version Consistency Validator
+# Validates that all version references are synchronized across the framework
+
+set -euo pipefail
+
+# Configuration
+REPO_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)" || exit
+VERSION_FILE="$REPO_ROOT/VERSION"
+
+# Color output functions
+print_success() { local msg="$1"; echo -e "\033[32m✅ $msg\033[0m"; return 0; }
+print_error() { local msg="$1"; echo -e "\033[31m❌ $msg\033[0m"; return 0; }
+print_warning() { local msg="$1"; echo -e "\033[33m⚠️  $msg\033[0m"; return 0; }
+print_info() { local msg="$1"; echo -e "\033[34mℹ️  $msg\033[0m"; return 0; }
+
+# Function to get current version
+get_current_version() {
+    if [[ -f "$VERSION_FILE" ]]; then
+        cat "$VERSION_FILE"
+    else
+        echo "1.0.0"
+    fi
+    return 0
+}
+
+# Function to validate version consistency across files
+validate_version_consistency() {
+    local expected_version="$1"
+    local errors=0
+    local warnings=0
+    
+    print_info "🔍 Validating version consistency across files..."
+    print_info "Expected version: $expected_version"
+    echo ""
+    
+    # Check VERSION file
+    if [[ -f "$VERSION_FILE" ]]; then
+        local version_file_content
+        version_file_content=$(cat "$VERSION_FILE")
+        if [[ "$version_file_content" != "$expected_version" ]]; then
+            print_error "VERSION file contains '$version_file_content', expected '$expected_version'"
+            errors=$((errors + 1))
+        else
+            print_success "VERSION file: $expected_version"
+        fi
+    else
+        print_error "VERSION file not found at $VERSION_FILE"
+        errors=$((errors + 1))
+    fi
+    
+    # Check README badge
+    if [[ -f "$REPO_ROOT/README.md" ]]; then
+        if grep -q "Version-$expected_version-blue" "$REPO_ROOT/README.md"; then
+            print_success "README.md badge: $expected_version"
+        else
+            local current_badge
+            current_badge=$(grep -o "Version-[0-9]\+\.[0-9]\+\.[0-9]\+-blue" "$REPO_ROOT/README.md" || echo "not found")
+            print_error "README.md badge shows '$current_badge', expected 'Version-$expected_version-blue'"
+            errors=$((errors + 1))
+        fi
+    else
+        print_warning "README.md not found"
+        warnings=$((warnings + 1))
+    fi
+    
+    # Check sonar-project.properties
+    if [[ -f "$REPO_ROOT/sonar-project.properties" ]]; then
+        if grep -q "sonar.projectVersion=$expected_version" "$REPO_ROOT/sonar-project.properties"; then
+            print_success "sonar-project.properties: $expected_version"
+        else
+            local current_sonar
+            current_sonar=$(grep "sonar.projectVersion=" "$REPO_ROOT/sonar-project.properties" | cut -d'=' -f2 || echo "not found")
+            print_error "sonar-project.properties shows '$current_sonar', expected '$expected_version'"
+            errors=$((errors + 1))
+        fi
+    else
+        print_warning "sonar-project.properties not found"
+        warnings=$((warnings + 1))
+    fi
+    
+    # Check setup.sh
+    if [[ -f "$REPO_ROOT/setup.sh" ]]; then
+        if grep -q "# Version: $expected_version" "$REPO_ROOT/setup.sh"; then
+            print_success "setup.sh: $expected_version"
+        else
+            local current_setup
+            current_setup=$(grep "# Version:" "$REPO_ROOT/setup.sh" | cut -d':' -f2 | xargs || echo "not found")
+            print_error "setup.sh shows '$current_setup', expected '$expected_version'"
+            errors=$((errors + 1))
+        fi
+    else
+        print_warning "setup.sh not found"
+        warnings=$((warnings + 1))
+    fi
+    
+    echo ""
+    print_info "📊 Validation Summary:"
+    
+    if [[ $errors -eq 0 ]]; then
+        print_success "All version references are consistent: $expected_version"
+        if [[ $warnings -gt 0 ]]; then
+            print_warning "Found $warnings optional files missing (not critical)"
+        fi
+        return 0
+    else
+        print_error "Found $errors version inconsistencies"
+        if [[ $warnings -gt 0 ]]; then
+            print_warning "Found $warnings optional files missing"
+        fi
+        return 1
+    fi
+    return 0
+}
+
+# Main function
+main() {
+    local version_to_check="$1"
+    
+    if [[ -z "$version_to_check" ]]; then
+        version_to_check=$(get_current_version)
+        print_info "No version specified, using current version from VERSION file: $version_to_check"
+    fi
+    
+    validate_version_consistency "$version_to_check"
+    return 0
+}
+
+main "${1:-}"