myaidev-method 0.0.8 → 0.2.0

package/WORDPRESS_ADMIN_SCRIPTS.md

@@ -0,0 +1,474 @@
+# WordPress Admin Scripts
+
+Reusable Node.js utilities for WordPress administration tasks with predictable JSON output for agent processing.
+
+## Overview
+
+The MyAIDev Method package includes scriptable WordPress admin utilities that can be:
+- Run directly via `npm run` commands
+- Called via `npx myaidev-method` commands
+- Used by the `wordpress-admin` agent for automated analysis
+- Integrated into CI/CD pipelines for monitoring
+
+## Installation
+
+```bash
+npm install myaidev-method
+# or
+npx myaidev-method init --claude
+```
+
+## Configuration
+
+All scripts use WordPress REST API credentials from `.env`:
+
+```bash
+WORDPRESS_URL=https://your-site.com
+WORDPRESS_USERNAME=admin_username
+WORDPRESS_APP_PASSWORD=xxxx xxxx xxxx xxxx
+```
+
+Create WordPress Application Password:
+1. Go to WordPress Admin → Users → Your Profile
+2. Scroll to "Application Passwords"
+3. Enter name (e.g., "MyAIDev Scripts") and click "Add New"
+4. Copy the generated password to `.env`
+
+## Available Scripts
+
+### 1. Health Check
+
+Comprehensive WordPress site health assessment.
+
+**Usage:**
+```bash
+# Via npm
+npm run wordpress:health-check
+
+# Via npx
+npx myaidev-method wordpress:health-check
+
+# With options
+npm run wordpress:health-check -- --format text --output health-report.txt
+npx myaidev-method wordpress:health-check -- --verbose
+```
+
+**Options:**
+- `--format <type>` - Output format: `json` (default) or `text`
+- `--output <file>` / `-o <file>` - Write output to file
+- `--verbose` / `-v` - Show detailed progress
+- `--help` / `-h` - Show help
+
+**Checks performed:**
+- WordPress version status
+- Plugin health and updates
+- Content health (posts, media, cleanup needs)
+- User security audit
+- Performance metrics
+
+**Output Structure (JSON):**
+```json
+{
+  "success": true,
+  "timestamp": "2025-10-01T12:00:00.000Z",
+  "site": { "name": "...", "url": "..." },
+  "overall_health": {
+    "score": 85,
+    "grade": "B",
+    "status": "healthy"
+  },
+  "checks": [...],
+  "summary": {
+    "total_checks": 5,
+    "passed": 4,
+    "warnings": 1,
+    "critical": 0
+  },
+  "recommendations": [...]
+}
+```
+
+**Exit Codes:**
+- `0` - No critical issues
+- `1` - Scan error
+- `2` - Critical issues found
+
+---
+
+### 2. Security Scan
+
+Security vulnerability detection and user audit.
+
+**Usage:**
+```bash
+# Via npm
+npm run wordpress:security-scan
+
+# Via npx
+npx myaidev-method wordpress:security-scan
+
+# With options
+npm run wordpress:security-scan -- --detailed --output security-report.json
+```
+
+**Options:**
+- `--format <type>` - Output format: `json` (default) or `text`
+- `--output <file>` / `-o <file>` - Write output to file
+- `--verbose` / `-v` - Show detailed progress
+- `--detailed` / `-d` - Include detailed vulnerability info
+- `--help` / `-h` - Show help
+
+**Security checks:**
+- User account security audit
+- Plugin vulnerability detection
+- Outdated software detection
+- Common security misconfigurations
+- Weak password patterns
+
+**Output Structure (JSON):**
+```json
+{
+  "success": true,
+  "timestamp": "2025-10-01T12:00:00.000Z",
+  "site": { "name": "...", "url": "..." },
+  "security_score": 85,
+  "vulnerabilities": [],
+  "warnings": [...],
+  "summary": {
+    "critical_issues": 0,
+    "warnings": 2,
+    "status": "warning"
+  },
+  "recommendations": [...]
+}
+```
+
+**Exit Codes:**
+- `0` - No security issues
+- `1` - Scan error
+- `2` - Warnings found
+- `3` - Critical vulnerabilities found
+
+---
+
+### 3. Performance Check
+
+Performance analysis with timing measurements.
+
+**Usage:**
+```bash
+# Via npm
+npm run wordpress:performance-check
+
+# Via npx
+npx myaidev-method wordpress:performance-check
+
+# With options
+npm run wordpress:performance-check -- --iterations 5 --output perf-report.json
+```
+
+**Options:**
+- `--format <type>` - Output format: `json` (default) or `text`
+- `--output <file>` / `-o <file>` - Write output to file
+- `--verbose` / `-v` - Show detailed progress
+- `--iterations <n>` / `-i <n>` - Number of timing iterations (default: 3)
+- `--help` / `-h` - Show help
+
+**Performance checks:**
+- API response time measurement (avg, median, min, max)
+- Database content analysis
+- Media file optimization opportunities
+- Plugin performance impact
+- Resource usage patterns
+
+**Output Structure (JSON):**
+```json
+{
+  "success": true,
+  "timestamp": "2025-10-01T12:00:00.000Z",
+  "site": { "name": "...", "url": "..." },
+  "performance_score": 85,
+  "timing": {
+    "average": 250,
+    "median": 245,
+    "min": 230,
+    "max": 280
+  },
+  "metrics": {
+    "post_count": 150,
+    "media_count": 400,
+    "plugin_count": 15,
+    "active_plugins": 12
+  },
+  "analysis": {...},
+  "recommendations": [...]
+}
+```
+
+**Exit Codes:**
+- `0` - No performance issues
+- `1` - Check error
+- `2` - Performance warnings
+
+---
+
+### 4. Comprehensive Report
+
+Runs all checks and synthesizes into comprehensive report.
+
+**Usage:**
+```bash
+# Via npm
+npm run wordpress:comprehensive-report
+
+# Via npx
+npx myaidev-method wordpress:comprehensive-report
+
+# With options
+npm run wordpress:comprehensive-report -- --format markdown --output wp-report.md
+npm run wordpress:comprehensive-report -- --save-individual --verbose
+```
+
+**Options:**
+- `--format <type>` - Output format: `markdown` (default) or `json`
+- `--output <file>` / `-o <file>` - Write output to file
+- `--verbose` / `-v` - Show detailed progress
+- `--save-individual` - Save individual report files as well
+- `--health-only` - Only run health check
+- `--security-only` - Only run security scan
+- `--performance-only` - Only run performance check
+- `--help` / `-h` - Show help
+
+**Report includes:**
+- Executive summary with all scores
+- Critical issues requiring immediate attention
+- Warnings and recommendations
+- Prioritized action items
+- Key metrics and statistics
+- Individual check results
+
+**Exit Codes:**
+- `0` - No critical issues
+- `1` - Error occurred
+- `2` - Warnings found
+- `3` - Critical issues found
+
+---
+
+## Agent Integration
+
+These scripts are designed to work with the `wordpress-admin` agent:
+
+### Example: WordPress Admin Agent Workflow
+
+```bash
+# Agent calls comprehensive report
+npx myaidev-method wordpress:comprehensive-report --format json --output /tmp/wp-report.json
+
+# Agent reads and processes JSON output
+# Agent generates natural language analysis
+# Agent provides actionable recommendations
+```
+
+### Agent Usage Pattern
+
+1. **Script Execution**: Agent runs script to get structured data
+2. **Data Processing**: Agent parses JSON output
+3. **Analysis**: Agent synthesizes findings with context
+4. **Recommendations**: Agent provides prioritized actions
+
+### Calling from Agent
+
+In `.claude/agents/wordpress-admin.md`:
+
+```markdown
+## Running Health Check
+
+Use the Bash tool to execute the health check script:
+
+```bash
+npm run wordpress:health-check -- --format json --output /tmp/health.json
+```
+
+Then read the JSON output:
+
+```bash
+# Read the report
+cat /tmp/health.json
+```
+
+Process the structured data and provide comprehensive analysis.
+```
+
+---
+
+## Library Usage
+
+You can also use the utilities programmatically:
+
+```javascript
+import { WordPressAdminUtils } from 'myaidev-method/src/lib/wordpress-admin-utils.js';
+import { ReportSynthesizer } from 'myaidev-method/src/lib/report-synthesizer.js';
+
+// Initialize
+const wpUtils = new WordPressAdminUtils({
+  url: 'https://your-site.com',
+  username: 'admin',
+  appPassword: 'xxxx xxxx xxxx xxxx'
+});
+
+// Run health check
+const healthData = await wpUtils.runHealthCheck();
+console.log(healthData);
+
+// Run security scan
+const securityData = await wpUtils.runSecurityScan();
+console.log(securityData);
+
+// Synthesize multiple reports
+const synthesizer = new ReportSynthesizer();
+synthesizer.addReport(healthData, 'health');
+synthesizer.addReport(securityData, 'security');
+
+const comprehensive = synthesizer.synthesize();
+console.log(comprehensive);
+
+// Generate markdown report
+const markdown = synthesizer.generateMarkdownReport();
+console.log(markdown);
+```
+
+---
+
+## CI/CD Integration
+
+### Example: GitHub Actions
+
+```yaml
+name: WordPress Health Check
+
+on:
+  schedule:
+    - cron: '0 0 * * *'  # Daily at midnight
+
+jobs:
+  health-check:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v3
+        with:
+          node-version: '18'
+
+      - name: Install dependencies
+        run: npm install myaidev-method
+
+      - name: Run health check
+        env:
+          WORDPRESS_URL: ${{ secrets.WORDPRESS_URL }}
+          WORDPRESS_USERNAME: ${{ secrets.WORDPRESS_USERNAME }}
+          WORDPRESS_APP_PASSWORD: ${{ secrets.WORDPRESS_APP_PASSWORD }}
+        run: |
+          npx myaidev-method wordpress:comprehensive-report \
+            --format json \
+            --output health-report.json
+
+      - name: Upload report
+        uses: actions/upload-artifact@v3
+        with:
+          name: wordpress-health-report
+          path: health-report.json
+
+      - name: Check for critical issues
+        run: |
+          # Exit code 3 = critical issues
+          if [ $? -eq 3 ]; then
+            echo "::error::Critical WordPress issues found"
+            exit 1
+          fi
+```
+
+---
+
+## Monitoring & Automation
+
+### Scheduled Health Checks
+
+```bash
+# Add to crontab for daily checks
+0 0 * * * cd /path/to/project && npm run wordpress:comprehensive-report -- --output /var/log/wp-health-$(date +\%Y\%m\%d).json
+```
+
+### Alert on Critical Issues
+
+```bash
+#!/bin/bash
+# health-check-alert.sh
+
+npm run wordpress:health-check -- --format json --output /tmp/health.json
+EXIT_CODE=$?
+
+if [ $EXIT_CODE -eq 2 ]; then
+  # Send alert (email, Slack, etc.)
+  echo "Critical WordPress issues detected!"
+  cat /tmp/health.json | mail -s "WordPress Critical Alert" admin@example.com
+fi
+```
+
+---
+
+## Troubleshooting
+
+### Authentication Errors
+
+```bash
+# Test connection
+npx myaidev-method wordpress:health-check --verbose
+
+# Common issues:
+# - Incorrect application password (no spaces in .env)
+# - Wrong username
+# - REST API disabled
+# - Firewall blocking requests
+```
+
+### Permission Errors
+
+Some operations require administrator privileges:
+- Plugin management
+- User audits
+- Theme information
+
+Ensure the WordPress user has admin role.
+
+### Script Not Found
+
+```bash
+# Ensure package is installed
+npm list myaidev-method
+
+# Reinstall if needed
+npm install myaidev-method
+
+# Run from project root
+npm run wordpress:health-check
+```
+
+---
+
+## Contributing
+
+To add new WordPress admin utilities:
+
+1. Add functions to `src/lib/wordpress-admin-utils.js`
+2. Create script in `src/scripts/wordpress-*.js`
+3. Add npm script to `package.json`
+4. Update this documentation
+
+---
+
+## License
+
+MIT - See LICENSE file for details

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "myaidev-method",
-  "version": "0.0.8",
+  "version": "0.2.0",
   "description": "AI CLI tools package with custom subagents and MCP integrations for Claude Code, Gemini CLI, and more",
   "mcpName": "io.github.myaione/myaidev-method",
   "main": "src/index.js",
@@ -23,16 +23,41 @@
     "build:mcp": "mkdir -p dist/mcp && cp .claude/mcp/*.js .claude/mcp/*.json dist/mcp/",
     "prepublishOnly": "npm install && npm test && npm run build:mcp",
     "postinstall": "echo \"MyAIDev Method installed successfully! Run 'npx myaidev-method init --claude' to get started.\"",
-    "wordpress:troubleshoot": "node src/templates/docs/wordpress-troubleshoot.js"
+    "wordpress:troubleshoot": "node src/templates/docs/wordpress-troubleshoot.js",
+    "wordpress:health-check": "node src/scripts/wordpress-health-check.js",
+    "wordpress:security-scan": "node src/scripts/wordpress-security-scan.js",
+    "wordpress:performance-check": "node src/scripts/wordpress-performance-check.js",
+    "wordpress:comprehensive-report": "node src/scripts/wordpress-comprehensive-report.js",
+    "coolify:status": "node src/scripts/coolify-status.js",
+    "coolify:list": "node src/scripts/coolify-list-resources.js",
+    "payloadcms:publish": "node src/scripts/payloadcms-publish.js",
+    "docusaurus:publish": "node src/scripts/docusaurus-publish.js",
+    "mintlify:publish": "node src/scripts/mintlify-publish.js",
+    "astro:publish": "node src/scripts/astro-publish.js",
+    "configure": "node src/scripts/configure-cms.js",
+    "init": "node src/scripts/init-project.js"
   },
   "keywords": [
     "claude-code",
     "ai-cli",
     "mcp",
     "wordpress",
+    "payloadcms",
+    "payload",
+    "docusaurus",
+    "mintlify",
+    "astro",
+    "coolify",
     "content-writer",
+    "cms",
+    "headless-cms",
+    "publishing",
+    "static-site",
+    "documentation",
     "ai-agents",
     "automation",
+    "deployment",
+    "devops",
     "cli-tool",
     "slash-commands",
     "gemini-cli",
@@ -47,9 +72,12 @@
     "commander": "^12.0.0",
     "dotenv": "^16.4.1",
     "fs-extra": "^11.2.0",
+    "gray-matter": "^4.0.3",
     "inquirer": "^9.2.15",
+    "marked": "^11.0.0",
     "node-fetch": "^3.3.2",
     "ora": "^8.0.1",
+    "simple-git": "^3.22.0",
     "ssh2": "^1.15.0",
     "zod": "^3.23.8"
   },
@@ -69,7 +97,12 @@
     "README.md",
     "USER_GUIDE.md",
     "LICENSE",
-    ".env.example"
+    ".env.example",
+    "WORDPRESS_ADMIN_SCRIPTS.md",
+    "COOLIFY_DEPLOYMENT.md",
+    "PAYLOADCMS_PUBLISHING.md",
+    "STATIC_SITE_PUBLISHING.md",
+    "PUBLISHING_GUIDE.md"
   ],
   "engines": {
     "node": ">=18.0.0"