aidevops 2.52.1

package/.agent/tools/wordpress/mainwp.md

@@ -0,0 +1,391 @@
+---
+description: MainWP WordPress fleet management - bulk updates, backups, security scans, and monitoring across multiple WordPress sites via REST API
+mode: subagent
+temperature: 0.1
+tools:
+  bash: true
+  read: true
+  write: true
+  edit: true
+  glob: true
+  grep: true
+  task: true
+---
+
+# MainWP WordPress Management Guide
+
+<!-- AI-CONTEXT-START -->
+
+## Quick Reference
+
+- **Type**: Self-hosted WordPress site management platform
+- **Auth**: consumer_key + consumer_secret via REST API
+- **Config**: `configs/mainwp-config.json`
+- **Commands**: `mainwp-helper.sh [instances|sites|site-details|monitor|update-core|update-plugins|plugins|themes|backup|backups|security-scan|security-results|audit-security|sync] [instance] [site-id] [args]`
+- **Requires**: MainWP Dashboard + REST API Extension + MainWP Child plugin on sites
+- **API test**: `curl -I https://mainwp.yourdomain.com/wp-json/mainwp/v1/`
+- **Bulk ops**: `bulk-update-wp`, `bulk-update-plugins` for multiple site IDs
+- **Backup types**: full, db, files
+- **Related**: `@wp-admin` (calls this for fleet management), `@wp-preferred` (plugin recommendations)
+<!-- AI-CONTEXT-END -->
+
+MainWP is a powerful self-hosted WordPress management platform that allows you to manage multiple WordPress sites from a single dashboard with comprehensive API access.
+
+## Provider Overview
+
+### **MainWP Characteristics:**
+
+- **Service Type**: Self-hosted WordPress management platform
+- **Architecture**: Central dashboard managing multiple WordPress sites
+- **API Support**: Comprehensive REST API for automation
+- **Scalability**: Manage unlimited WordPress sites
+- **Security**: Built-in security scanning and monitoring
+- **Backup Management**: Automated backup scheduling and management
+- **Update Management**: Centralized WordPress, plugin, and theme updates
+
+### **Best Use Cases:**
+
+- **WordPress agencies** managing multiple client sites
+- **Large organizations** with multiple WordPress properties
+- **Developers** managing staging and production environments
+- **Automated WordPress maintenance** and monitoring
+- **Centralized security management** across WordPress sites
+- **Bulk operations** on multiple WordPress installations
+
+## 🔧 **Configuration**
+
+### **Setup Configuration:**
+
+```bash
+# Copy template
+cp configs/mainwp-config.json.txt configs/mainwp-config.json
+
+# Edit with your actual MainWP instance details
+```
+
+### **Multi-Instance Configuration:**
+
+```json
+{
+  "instances": {
+    "production": {
+      "base_url": "https://mainwp.yourdomain.com",
+      "consumer_key": "YOUR_MAINWP_CONSUMER_KEY_HERE",
+      "consumer_secret": "YOUR_MAINWP_CONSUMER_SECRET_HERE",
+      "description": "Production MainWP instance",
+      "managed_sites_count": 25
+    },
+    "staging": {
+      "base_url": "https://staging-mainwp.yourdomain.com",
+      "consumer_key": "YOUR_STAGING_MAINWP_CONSUMER_KEY_HERE",
+      "consumer_secret": "YOUR_STAGING_MAINWP_CONSUMER_SECRET_HERE",
+      "description": "Staging MainWP instance",
+      "managed_sites_count": 5
+    }
+  }
+}
+```
+
+### **API Credentials Setup:**
+
+1. **Install MainWP Dashboard** on your server
+2. **Install MainWP REST API Extension**
+3. **Generate API credentials** in MainWP Dashboard
+4. **Configure child sites** with MainWP Child plugin
+5. **Test API access** with the helper script
+
+## 🚀 **Usage Examples**
+
+### **Basic Commands:**
+
+```bash
+# List all MainWP instances
+./.agent/scripts/mainwp-helper.sh instances
+
+# List all managed sites
+./.agent/scripts/mainwp-helper.sh sites production
+
+# Get site details
+./.agent/scripts/mainwp-helper.sh site-details production 123
+
+# Monitor all sites
+./.agent/scripts/mainwp-helper.sh monitor production
+```
+
+### **WordPress Management:**
+
+```bash
+# Update WordPress core for a site
+./.agent/scripts/mainwp-helper.sh update-core production 123
+
+# Update all plugins for a site
+./.agent/scripts/mainwp-helper.sh update-plugins production 123
+
+# Update specific plugin
+./.agent/scripts/mainwp-helper.sh update-plugin production 123 akismet
+
+# List site plugins
+./.agent/scripts/mainwp-helper.sh plugins production 123
+
+# List site themes
+./.agent/scripts/mainwp-helper.sh themes production 123
+```
+
+### **Backup Management:**
+
+```bash
+# Create full backup
+./.agent/scripts/mainwp-helper.sh backup production 123 full
+
+# Create database backup
+./.agent/scripts/mainwp-helper.sh backup production 123 db
+
+# Create files backup
+./.agent/scripts/mainwp-helper.sh backup production 123 files
+
+# List all backups
+./.agent/scripts/mainwp-helper.sh backups production 123
+```
+
+### **Security Management:**
+
+```bash
+# Run security scan
+./.agent/scripts/mainwp-helper.sh security-scan production 123
+
+# Get security scan results
+./.agent/scripts/mainwp-helper.sh security-results production 123
+
+# Comprehensive security audit
+./.agent/scripts/mainwp-helper.sh audit-security production 123
+
+# Get uptime status
+./.agent/scripts/mainwp-helper.sh uptime production 123
+```
+
+### **Bulk Operations:**
+
+```bash
+# Bulk WordPress core updates
+./.agent/scripts/mainwp-helper.sh bulk-update-wp production 123 124 125
+
+# Bulk plugin updates
+./.agent/scripts/mainwp-helper.sh bulk-update-plugins production 123 124 125
+
+# Sync multiple sites
+for site_id in 123 124 125; do
+    ./.agent/scripts/mainwp-helper.sh sync production $site_id
+done
+```
+
+### **Site Monitoring:**
+
+```bash
+# Get site status
+./.agent/scripts/mainwp-helper.sh site-status production 123
+
+# Sync site data
+./.agent/scripts/mainwp-helper.sh sync production 123
+
+# Monitor all sites overview
+./.agent/scripts/mainwp-helper.sh monitor production
+```
+
+## 🛡️ **Security Best Practices**
+
+### **API Security:**
+
+- **Secure credentials**: Store API credentials securely
+- **HTTPS only**: Always use HTTPS for MainWP instances
+- **Regular rotation**: Rotate API credentials regularly
+- **Access control**: Limit API access to trusted systems
+- **Rate limiting**: Implement appropriate rate limiting
+
+### **MainWP Instance Security:**
+
+```bash
+# Regular security audits
+./.agent/scripts/mainwp-helper.sh audit-security production 123
+
+# Monitor security scan results
+./.agent/scripts/mainwp-helper.sh security-results production 123
+
+# Check uptime and availability
+./.agent/scripts/mainwp-helper.sh uptime production 123
+```
+
+### **WordPress Security:**
+
+- **Regular updates**: Keep WordPress core, plugins, and themes updated
+- **Security scanning**: Run regular security scans on all sites
+- **Backup verification**: Verify backup integrity regularly
+- **Access monitoring**: Monitor login attempts and access patterns
+- **SSL certificates**: Ensure all sites have valid SSL certificates
+
+## 🔍 **Troubleshooting**
+
+### **Common Issues:**
+
+#### **API Connection Errors:**
+
+```bash
+# Verify API credentials
+./.agent/scripts/mainwp-helper.sh instances
+
+# Check MainWP instance accessibility
+curl -I https://mainwp.yourdomain.com/wp-json/mainwp/v1/
+
+# Verify SSL certificate
+openssl s_client -connect mainwp.yourdomain.com:443
+```
+
+#### **Site Sync Issues:**
+
+```bash
+# Force site sync
+./.agent/scripts/mainwp-helper.sh sync production 123
+
+# Check site status
+./.agent/scripts/mainwp-helper.sh site-status production 123
+
+# Verify child plugin is active on target site
+```
+
+#### **Update Failures:**
+
+```bash
+# Check site details for error messages
+./.agent/scripts/mainwp-helper.sh site-details production 123
+
+# Verify site accessibility
+./.agent/scripts/mainwp-helper.sh uptime production 123
+
+# Check for maintenance mode or plugin conflicts
+```
+
+## 📊 **Monitoring & Analytics**
+
+### **Site Health Monitoring:**
+
+```bash
+# Daily monitoring routine
+./.agent/scripts/mainwp-helper.sh monitor production
+
+# Check for sites needing updates
+./.agent/scripts/mainwp-helper.sh monitor production | grep "updates available"
+
+# Security status overview
+for site_id in $(./.agent/scripts/mainwp-helper.sh sites production | awk '{print $1}' | grep -E '^[0-9]+$'); do
+    ./.agent/scripts/mainwp-helper.sh security-results production $site_id
+done
+```
+
+### **Automated Monitoring:**
+
+```bash
+# Create monitoring script
+#!/bin/bash
+INSTANCE="production"
+
+# Get sites needing attention
+echo "=== SITES NEEDING UPDATES ==="
+./.agent/scripts/mainwp-helper.sh monitor $INSTANCE
+
+echo "=== BACKUP STATUS ==="
+for site_id in $(./.agent/scripts/mainwp-helper.sh sites $INSTANCE | awk '{print $1}' | grep -E '^[0-9]+$'); do
+    echo "Site $site_id backups:"
+    ./.agent/scripts/mainwp-helper.sh backups $INSTANCE $site_id | tail -5
+done
+
+echo "=== SECURITY ALERTS ==="
+for site_id in $(./.agent/scripts/mainwp-helper.sh sites $INSTANCE | awk '{print $1}' | grep -E '^[0-9]+$'); do
+    security_results=$(./.agent/scripts/mainwp-helper.sh security-results $INSTANCE $site_id)
+    if echo "$security_results" | grep -q "warning\|error\|critical"; then
+        echo "Site $site_id has security issues:"
+        echo "$security_results"
+    fi
+done
+```
+
+### **Performance Tracking:**
+
+- **Update success rates**: Track successful vs failed updates
+- **Backup completion**: Monitor backup success rates
+- **Site uptime**: Track site availability and performance
+- **Security scan results**: Monitor security scan outcomes
+- **Response times**: Track API response times and site performance
+
+## 🔄 **Backup & Disaster Recovery**
+
+### **Backup Strategies:**
+
+```bash
+# Daily backup routine
+#!/bin/bash
+INSTANCE="production"
+
+for site_id in $(./.agent/scripts/mainwp-helper.sh sites $INSTANCE | awk '{print $1}' | grep -E '^[0-9]+$'); do
+    echo "Creating backup for site $site_id"
+    ./.agent/scripts/mainwp-helper.sh backup $INSTANCE $site_id full
+    sleep 30  # Rate limiting
+done
+```
+
+### **Backup Verification:**
+
+```bash
+# Verify recent backups
+for site_id in $(./.agent/scripts/mainwp-helper.sh sites production | awk '{print $1}' | grep -E '^[0-9]+$'); do
+    echo "Backup status for site $site_id:"
+    ./.agent/scripts/mainwp-helper.sh backups production $site_id | head -3
+done
+```
+
+## 📚 **Best Practices**
+
+### **WordPress Management:**
+
+1. **Staged updates**: Test updates on staging before production
+2. **Regular backups**: Maintain regular backup schedules
+3. **Security monitoring**: Run regular security scans
+4. **Performance monitoring**: Monitor site performance and uptime
+5. **Documentation**: Document all maintenance procedures
+
+### **Automation Strategies:**
+
+- **Scheduled maintenance**: Automate routine maintenance tasks
+- **Update workflows**: Implement staged update procedures
+- **Backup verification**: Automate backup integrity checks
+- **Security monitoring**: Automate security scan scheduling
+- **Alert integration**: Integrate with monitoring and alerting systems
+
+### **Multi-Site Management:**
+
+- **Site categorization**: Organize sites by type and criticality
+- **Update policies**: Implement different update policies per site type
+- **Backup strategies**: Tailor backup frequency to site importance
+- **Security levels**: Apply appropriate security measures per site
+- **Access control**: Implement role-based access control
+
+## 🎯 **AI Assistant Integration**
+
+### **Automated WordPress Management:**
+
+- **Update orchestration**: Automated WordPress, plugin, and theme updates
+- **Backup management**: Automated backup scheduling and verification
+- **Security monitoring**: Automated security scanning and threat detection
+- **Performance optimization**: Automated performance monitoring and optimization
+- **Issue resolution**: Automated detection and resolution of common issues
+
+### **Intelligent Operations:**
+
+- **Predictive maintenance**: AI-driven maintenance scheduling
+- **Anomaly detection**: Automated detection of unusual site behavior
+- **Performance analysis**: Automated performance analysis and recommendations
+- **Security assessment**: Automated security posture assessment
+- **Capacity planning**: Automated resource usage analysis and planning
+
+  task: true
+---
+
+**MainWP provides comprehensive WordPress management capabilities with powerful API access, making it ideal for automated WordPress site management at scale.** 🚀