myaidev-method 0.0.7 → 0.1.0

package/README.md

@@ -1,14 +1,14 @@
 # MyAIDev Method
 
-> **🚀 The easiest way to supercharge your AI CLI with professional agents and WordPress integration**
+> **🚀 The easiest way to supercharge your AI CLI with professional agents and get real work done!**
 
-A comprehensive package for AI CLI tools (Claude Code, Gemini CLI, Codex CLI) that provides custom subagents and MCP integrations for enhanced development workflows. **Zero setup required** - just run one command and start creating professional content!
+A comprehensive package for AI CLI tools (Claude Code, Gemini CLI, Codex CLI) that provides custom subagents and MCP integrations for enhanced development workflows. **Zero code required** - just run one command and start creating professional content!
 
 **✨ What makes this special:**
 - **Instant setup**: One `npx` command and you're ready
 - **Professional agents**: Content writer and WordPress admin out-of-the-box
-- **Claude Code native**: Follows official standards for maximum compatibility
-- **No dependencies**: Works standalone, WordPress integration is optional
+- **Claude Code native**: Follows official standards for maximum compatibility, with Gemini and OpenAI Codex CLI too.
+- **No dependencies**: Works standalone, leverages MCPs for WordPress, Notion, Google Workspace integration is optional
 
 ## 📋 Table of Contents
 
@@ -62,11 +62,11 @@ npx myaidev-method init --codex
 npx myaidev-method init
 ```
 
-**That's it!** No authentication, no complex setup, no additional configuration needed.
+**That's it!** No complex setup.
 
 ### Requirements
 
-- Node.js >= 18.0.0
+- Node.js >= 20.0.0
 - Claude Code >= 1.0.0 (for Claude features)
 - WordPress site with REST API enabled (optional, for WordPress features)
 - SSH access to server (optional, for advanced WordPress admin features)

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/bin/cli.js

@@ -99,10 +99,12 @@ async function setupClaude(projectDir) {
   const claudeDir = path.join(projectDir, '.claude');
   const commandsDir = path.join(claudeDir, 'commands');
   const agentsDir = path.join(claudeDir, 'agents');
+  const mcpDir = path.join(claudeDir, 'mcp');
   
   // Ensure directories exist
   await fs.ensureDir(commandsDir);
   await fs.ensureDir(agentsDir);
+  await fs.ensureDir(mcpDir);
   
   // Copy command markdown files
   const templateCommandsDir = path.join(__dirname, '..', 'src', 'templates', 'claude', 'commands');
@@ -132,6 +134,20 @@ async function setupClaude(projectDir) {
     }
   }
   
+  // Copy MCP server files
+  const templateMcpDir = path.join(__dirname, '..', '.claude', 'mcp');
+  if (await fs.pathExists(templateMcpDir)) {
+    const mcpFiles = await fs.readdir(templateMcpDir);
+    for (const file of mcpFiles) {
+      if (file.endsWith('.js') || file.endsWith('.json')) {
+        await fs.copy(
+          path.join(templateMcpDir, file),
+          path.join(mcpDir, file)
+        );
+      }
+    }
+  }
+  
   // Create CLAUDE.md configuration file
   const claudeMd = `# Claude Code Configuration
 
@@ -197,28 +213,7 @@ DEFAULT_TONE=professional
   
   await fs.writeFile(path.join(projectDir, '.env.example'), envExample);
   
-  // Create WordPress MCP server file
-  const mcpDir = path.join(claudeDir, 'mcp');
-  await fs.ensureDir(mcpDir);
-  
-  const wordpressMcpServer = path.join(__dirname, '..', '.claude', 'mcp', 'wordpress-server.js');
-  if (await fs.pathExists(wordpressMcpServer)) {
-    await fs.copy(wordpressMcpServer, path.join(mcpDir, 'wordpress-server.js'));
-  }
-  
-  // Copy Gutenberg converter
-  const gutenbergConverter = path.join(__dirname, '..', '.claude', 'mcp', 'gutenberg-converter.js');
-  if (await fs.pathExists(gutenbergConverter)) {
-    await fs.copy(gutenbergConverter, path.join(mcpDir, 'gutenberg-converter.js'));
-  }
-  
-  // Copy scripts directory
-  const scriptsTemplateDir = path.join(__dirname, '..', 'src', 'templates', 'scripts');
-  const scriptsDestDir = path.join(projectDir, 'scripts');
-  
-  if (await fs.pathExists(scriptsTemplateDir)) {
-    await fs.copy(scriptsTemplateDir, scriptsDestDir);
-  }
+  // Note: MCP integration disabled for now - using native tools for WordPress REST API
 
   // Copy USER_GUIDE.md - Essential for users to understand customization
   const userGuide = path.join(__dirname, '..', 'USER_GUIDE.md');