myaidev-method 0.2.5 → 0.2.6

package/src/templates/codex/commands/myai-sparc-workflow.md

@@ -0,0 +1,185 @@
+# SPARC Development Workflow
+
+Execute the complete 5-phase SPARC development workflow using MyAIDev Method's systematic approach: $ARGUMENTS
+
+Orchestrates all development agents in sequence: Architecture → Implementation → Testing → Review → Documentation
+
+## SPARC Workflow Phases
+
+The workflow executes these phases in sequence:
+
+### 1. **Specification & Architecture** (`/myai-dev-architect`)
+- Requirements analysis
+- System design with Mermaid diagrams
+- API specifications
+- Data modeling
+- Technology recommendations
+- Security planning
+
+**Output**: `.myaidev-method/sparc/architecture.md`
+
+### 2. **Pseudocode & Implementation** (`/myai-dev-code`)
+- Feature implementation based on architecture
+- SOLID principles application
+- Security best practices
+- Error handling
+- Inline documentation
+
+**Output**: `.myaidev-method/sparc/code-output/`
+
+### 3. **Architecture Validation & Testing** (`/myai-dev-test`)
+- Unit test creation
+- Integration test development
+- Coverage analysis (80%+ target)
+- Quality gate validation
+- Test execution
+
+**Output**: `.myaidev-method/sparc/test-results/`
+
+### 4. **Refinement & Review** (`/myai-dev-review`)
+- Code quality analysis
+- Security audit (OWASP Top 10)
+- Performance review
+- Best practices validation
+- Technical debt assessment
+
+**Output**: `.myaidev-method/sparc/review-report.md`
+
+### 5. **Completion & Documentation** (`/myai-dev-docs`)
+- API documentation
+- User guides
+- Architecture documentation
+- Code examples
+- Deployment guides
+
+**Output**: `.myaidev-method/sparc/documentation/`
+
+## What It Does
+
+The SPARC workflow orchestrator will:
+1. Initialize `.myaidev-method/sparc/` directory structure
+2. Create task tracking files in `.myaidev-method/tasks/`
+3. Execute each phase sequentially with proper handoffs
+4. Validate phase outputs before proceeding
+5. Generate comprehensive workflow summary
+6. Track progress and results
+7. Handle errors with graceful phase rollback
+8. Produce production-ready deliverables
+
+## Directory Structure Created
+
+```
+.myaidev-method/
+├── sparc/
+│   ├── architecture.md              # Phase 1 output
+│   ├── code-output/                 # Phase 2 output
+│   │   ├── src/
+│   │   └── ...
+│   ├── test-results/                # Phase 3 output
+│   │   ├── unit/
+│   │   ├── integration/
+│   │   └── coverage-report.md
+│   ├── review-report.md             # Phase 4 output
+│   └── documentation/               # Phase 5 output
+│       ├── api/
+│       ├── user-guide/
+│       └── architecture/
+├── tasks/
+│   └── workflow_[timestamp].json
+└── workflows/
+    └── sparc_[timestamp].json
+```
+
+## Output
+
+Creates a comprehensive workflow summary in `.myaidev-method/workflows/`:
+- Complete workflow execution log
+- Phase-by-phase results
+- Quality metrics and coverage
+- Review findings and recommendations
+- Documentation index
+- Next steps and maintenance guide
+
+## Examples
+
+### Complete Feature Development
+```bash
+/myai-sparc-workflow "Build JWT-based authentication system with refresh tokens"
+```
+
+### Specific Technology Stack
+```bash
+/myai-sparc-workflow "Create e-commerce checkout flow" --tech-stack "react,node,stripe,postgres"
+```
+
+### Run Specific Phases
+```bash
+/myai-sparc-workflow "Refactor payment module" --phases "architecture,review,documentation"
+```
+
+### Custom Test Framework
+```bash
+/myai-sparc-workflow "Build API endpoints" --test-framework pytest
+```
+
+## Options
+
+- Task description (required) - Clear description of the complete feature/system to build
+- `--phases <phases>` - Specific phases to run (comma-separated): architecture,implementation,testing,review,documentation
+- `--tech-stack <stack>` - Technology preferences (e.g., "node,postgres,redis")
+- `--output-dir <path>` - Custom output directory (default: `.myaidev-method/sparc/`)
+- `--test-framework <name>` - Testing framework preference (jest, mocha, pytest, etc.)
+- `--skip-phase <phase>` - Skip specific phase (use with caution)
+
+## Workflow Benefits
+
+- **Systematic Approach**: No missed steps, comprehensive coverage
+- **Quality Assurance**: Built-in review and testing at every phase
+- **Documentation**: Complete documentation generated automatically
+- **Traceability**: Full workflow history and decision tracking
+- **Best Practices**: SOLID, Clean Code, Security embedded in process
+- **Reproducible**: Consistent results across projects and teams
+
+## Integration with MyAIDev Method
+
+This command orchestrates the complete MyAIDev Method development workflow:
+- **Methodology**: SPARC (Specification, Pseudocode, Architecture, Refinement, Completion)
+- **Agent Coordination**: Sequential execution with file-based handoffs
+- **Quality Gates**: Validation at each phase transition
+- **Outputs**: Production-ready code with comprehensive documentation
+
+## Quality Standards
+
+All phases follow MyAIDev Method standards:
+- **Code Quality**: SOLID principles, Clean Code, DRY/KISS/YAGNI
+- **Testing**: 80%+ coverage, integration tests, quality gates
+- **Security**: OWASP Top 10 compliance, input validation, error handling
+- **Documentation**: API docs, user guides, architecture specifications
+- **Performance**: Optimization analysis, scalability planning
+
+## Error Handling
+
+The workflow includes robust error handling:
+- **Phase Validation**: Verify outputs before proceeding to next phase
+- **Graceful Degradation**: Continue with warnings when possible
+- **Rollback Support**: Restore previous state on critical failures
+- **Error Reports**: Detailed error logs in `.myaidev-method/workflows/`
+- **Manual Override**: Skip or retry phases as needed
+
+## Next Steps After Completion
+
+1. **Review Outputs**: Examine all generated artifacts in `.myaidev-method/sparc/`
+2. **Address Findings**: Review phase 4 report and address issues
+3. **Integration**: Integrate code into your project structure
+4. **Testing**: Run final integration tests
+5. **Deployment**: Follow deployment guide in documentation
+6. **Maintenance**: Use generated documentation for ongoing development
+
+## MyAIDev Method Philosophy
+
+The SPARC workflow embodies MyAIDev Method principles:
+- **Specification First**: Clear requirements before implementation
+- **Architecture Planning**: Design before coding
+- **Testing Built-In**: Quality from the start
+- **Continuous Review**: Iterative refinement
+- **Documentation Integral**: Knowledge preservation

package/src/templates/codex/commands/myai-wordpress-admin.md

@@ -0,0 +1,143 @@
+# WordPress Site Administrator
+
+Execute WordPress administration operations: $ARGUMENTS
+
+Launch the WordPress administrator agent for comprehensive site management, security analysis, and performance optimization.
+
+## Available Operations
+
+### Security Operations
+- `security-scan` - Comprehensive security assessment and vulnerability check
+- `malware-check` - Scan for malicious code and suspicious files
+- `user-audit` - Review user accounts, roles, and permissions
+- `plugin-security` - Check plugins and themes for known vulnerabilities
+- `ssl-check` - Verify SSL/TLS certificate and security configuration
+- `file-permissions` - Audit file and directory permissions
+
+### Performance Operations
+- `speed-test` - Analyze site performance and Core Web Vitals
+- `database-optimize` - Clean and optimize WordPress database
+- `cache-setup` - Configure and optimize caching strategies
+- `image-optimize` - Analyze and optimize media files
+- `resource-monitor` - Check server resource usage and optimization
+
+### Health Operations
+- `health-check` - Comprehensive WordPress site health assessment
+- `error-analysis` - Review and analyze error logs
+- `uptime-check` - Monitor site availability and response times
+- `backup-verify` - Validate backup integrity and restore capabilities
+- `update-check` - Check for WordPress, plugin, and theme updates
+
+### Administration Operations
+- `user-manage` - User and role management operations
+- `plugin-manage` - Plugin installation, updates, and management
+- `content-cleanup` - Remove spam, unused content, and optimize database
+- `settings-optimize` - Configure optimal WordPress settings
+- `staging-deploy` - Manage staging environment operations
+
+## Usage Examples
+
+### Security Assessment
+```
+/myai-wordpress-admin security-scan
+/myai-wordpress-admin malware-check
+/myai-wordpress-admin user-audit --role administrator
+```
+
+### Performance Optimization
+```
+/myai-wordpress-admin speed-test --detailed
+/myai-wordpress-admin database-optimize --cleanup-revisions
+/myai-wordpress-admin cache-setup --type redis
+```
+
+### Site Health Monitoring
+```
+/myai-wordpress-admin health-check --comprehensive
+/myai-wordpress-admin error-analysis --last-24h
+/myai-wordpress-admin uptime-check --setup-monitoring
+```
+
+### Administrative Tasks
+```
+/myai-wordpress-admin plugin-manage --update-all --check-security
+/myai-wordpress-admin content-cleanup --remove-spam --optimize-db
+/myai-wordpress-admin settings-optimize --performance-focus
+```
+
+## Process Flow
+
+1. **Initialize WordPress Connection**
+   - Validate MCP connection to WordPress
+   - Check SSH access if configured
+   - Verify administrative permissions
+
+2. **Execute Operation**
+   - Load wordpress-admin agent configuration
+   - Parse operation parameters from $ARGUMENTS
+   - Execute requested administrative task
+
+3. **Security & Safety Checks**
+   - Create backups before destructive operations
+   - Validate permissions before changes
+   - Log all administrative actions
+
+4. **Generate Report**
+   - Provide detailed findings and analysis
+   - Include actionable recommendations
+   - Create priority-based action items
+
+5. **Follow-up Actions**
+   - Suggest monitoring setup
+   - Recommend maintenance schedules
+   - Provide next steps guidance
+
+## Required Environment Variables
+
+```bash
+WORDPRESS_URL=https://your-wordpress-site.com
+WORDPRESS_USERNAME=admin-username
+WORDPRESS_APP_PASSWORD=application-password
+
+# Optional SSH access for server-level operations
+SSH_HOST=server-ip-address
+SSH_USERNAME=server-username
+SSH_KEY_PATH=/path/to/private/key
+```
+
+## Safety Features
+
+- **Backup Creation**: Automatic backup before major changes
+- **Permission Validation**: Verify admin rights before operations
+- **Staging Support**: Test changes in staging environment first
+- **Rollback Capability**: Provide undo procedures for changes
+- **Audit Logging**: Track all administrative actions
+
+## Output Format
+
+The agent will provide structured reports with:
+- **Executive Summary**: High-level findings and status
+- **Critical Issues**: Immediate attention required
+- **Warnings**: Items requiring near-term resolution
+- **Recommendations**: Optimization suggestions
+- **Action Items**: Specific tasks with priorities
+- **Technical Details**: Logs, metrics, and detailed analysis
+
+## Security Considerations
+
+This agent has extensive administrative capabilities. Ensure:
+- Strong authentication credentials
+- Limited access to authorized personnel
+- Regular audit of administrative actions
+- Backup verification before major changes
+- Staging environment testing when possible
+
+## Integration Notes
+
+- Works with WordPress REST API via MCP
+- Optional SSH integration for server-level access
+- Supports both managed and self-hosted WordPress
+- Compatible with major security and performance plugins
+- Provides recommendations for popular caching solutions
+
+Always prioritize site security and stability. When in doubt, create backups and test in staging environments first.

package/src/templates/codex/commands/myai-wordpress-publish.md

@@ -0,0 +1,66 @@
+# WordPress Content Publisher
+
+Publish the specified markdown file to WordPress: $ARGUMENTS
+
+Read and publish the file to WordPress using native tools and the WordPress REST API.
+
+## Process
+
+1. **Read the markdown file** from the path provided in $ARGUMENTS
+2. **Parse the frontmatter** to extract:
+   - title
+   - meta_description (use as excerpt)
+   - slug
+   - tags
+   - category
+   - use_gutenberg (optional, default: false)
+3. **Load WordPress configuration** from `.env` file:
+   - WORDPRESS_URL
+   - WORDPRESS_USERNAME
+   - WORDPRESS_APP_PASSWORD
+   - WORDPRESS_USE_GUTENBERG (optional, default: false)
+4. **Convert content format** if Gutenberg is enabled:
+   - If use_gutenberg is true or WORDPRESS_USE_GUTENBERG is true
+   - Convert HTML to Gutenberg block format using patterns:
+     * `<!-- wp:paragraph --><p>content</p><!-- /wp:paragraph -->`
+     * `<!-- wp:heading {"level":2} --><h2>title</h2><!-- /wp:heading -->`
+5. **Create categories and tags** if they don't exist using WordPress REST API
+6. **Publish the post** using curl with Basic Authentication:
+   ```bash
+   curl -X POST "${WORDPRESS_URL}/wp-json/wp/v2/posts" \
+     -H "Authorization: Basic $(echo -n "${USERNAME}:${APP_PASSWORD}" | base64)" \
+     -H "Content-Type: application/json" \
+     -d '{"title":"Post Title","content":"Content","status":"draft"}'
+   ```
+7. **Report the result** including:
+   - Post ID
+   - Preview URL
+   - Edit URL in WordPress admin
+   - Format used (Classic or Gutenberg)
+
+## Parameters
+
+- File path (required): Path to markdown file
+- --status: draft (default), publish, pending, private
+- --gutenberg: Use Gutenberg block format (default: false)
+- --classic: Force classic editor format (overrides defaults)
+
+## Error Handling
+
+If WordPress credentials are not configured:
+- Guide user to set up environment variables
+- Provide instructions for creating Application Password
+
+If file doesn't exist or isn't readable:
+- Report clear error message
+- Suggest checking file path
+
+## Success Response
+
+```
+✅ Successfully published to WordPress!
+- Post ID: [id]
+- Status: [draft/published]
+- Preview: [preview_url]
+- Edit: [admin_edit_url]
+```

package/src/templates/gemini/commands/myai-astro-publish.toml

@@ -0,0 +1,76 @@
+prompt = """
+Publish markdown content to Astro static site with content collections support and git workflow: {{args}}
+
+Invoke the Astro publishing agent to transform frontmatter, validate schemas, and deploy via git.
+
+## Task
+Add markdown content to Astro site with content collection validation.
+
+## Process
+
+1. **Read the markdown file** from the path provided
+2. **Transform frontmatter** for Astro compatibility:
+   - `date` → `pubDate` (ISO 8601 format)
+   - `status: published` → `draft: false`
+   - `excerpt` → `description`
+   - `image` → `heroImage`
+3. **Validate against content collection schema** (if exists)
+4. **Copy file to appropriate directory**:
+   - Content collection: `src/content/[collection]/`
+   - Pages: `src/pages/`
+5. **Commit and push** via git workflow
+
+## Parameters
+
+When parsing {{args}}, look for:
+- File path (required): Path to markdown file
+- --collection: Target content collection name (default: blog)
+- --pages: Publish to pages directory instead of collections
+- --project: Astro project path (default: current directory)
+- --branch: Git branch name (default: main)
+- --no-push: Commit but don't push
+- --dry-run: Validate without publishing
+
+## Examples
+
+Publish to content collection:
+```
+myai-astro-publish "my-article.md" --collection blog
+```
+
+Publish to pages:
+```
+myai-astro-publish "about.md" --pages
+```
+
+Custom project:
+```
+myai-astro-publish "post.md" --project ~/my-site --branch staging
+```
+
+## Frontmatter Transformation
+
+Automatically converts common frontmatter fields:
+- `date` → `pubDate` (ISO 8601 format)
+- `status: published` → `draft: false`
+- `status: draft` → `draft: true`
+- `excerpt` → `description`
+- `image` → `heroImage`
+- Preserves all other fields
+
+## Prerequisites
+
+Requires Astro project with:
+- astro.config.mjs
+- Content collections configured (optional)
+- Git repository initialized
+
+## Validation
+
+If content collection schema exists:
+1. Load schema from config
+2. Validate frontmatter fields
+3. Check required fields
+4. Verify field types
+5. Report validation errors before publishing
+"""

package/src/templates/gemini/commands/myai-configure.toml

@@ -0,0 +1,188 @@
+prompt = """
+Configure MyAI Method settings: {{args}}
+
+## Available Configurations
+
+### wordpress
+Interactive WordPress setup - no manual .env file creation needed!
+
+**Process:**
+1. **Collect WordPress site URL**
+   - Prompt: "Enter your WordPress site URL (e.g., https://yoursite.com):"
+   - Validate URL format and accessibility
+   - Test basic connectivity
+
+2. **Get WordPress username**
+   - Prompt: "Enter your WordPress admin username:"
+   - Validate username format
+
+3. **Guide through Application Password creation**
+   - Show step-by-step instructions:
+     * "Go to your WordPress Admin → Users → Your Profile"
+     * "Scroll down to 'Application Passwords' section"
+     * "Enter a name like 'MyAI Dev Method' and click 'Add New'"
+     * "Copy the generated password (it looks like: xxxx xxxx xxxx xxxx)"
+   - Prompt: "Paste your Application Password here:"
+   - Validate password format
+
+4. **Test connection**
+   - Verify credentials by making test API call
+   - Show success/failure message with troubleshooting tips
+
+5. **Save configuration**
+   - Create/update `.env` file automatically
+   - Set proper file permissions (600)
+   - Show confirmation of saved settings
+
+6. **Optional SSH setup**
+   - Ask: "Do you want to set up SSH for advanced WordPress administration? (y/n)"
+   - If yes, prompt for SSH details:
+     * SSH host/IP
+     * SSH username
+     * SSH key path (optional)
+   - Test SSH connection if credentials provided
+
+**Success message:**
+```
+✅ WordPress integration configured successfully!
+- Site: [URL]
+- User: [username]
+- Connection: ✅ Verified
+- Available commands: myai-wordpress-admin, myai-wordpress-publish
+```
+
+### defaults
+Configure default content settings:
+- Default word count
+- Default post status
+- Default tone
+- Default audience
+
+### agents
+List and manage available agents:
+- **List**: Show all installed agents with descriptions and capabilities
+- **Status**: Check agent configuration validity and tool availability
+- **Edit**: Open agent files for customization
+- **Backup**: Create backups before modifying agents
+- **Restore**: Restore agents from backups
+- **Validate**: Test agent configuration structure
+- **Tools**: Show what tools each agent has access to
+
+## WordPress Setup Process
+
+When configuring WordPress:
+
+1. **Parse arguments** to determine configuration type
+2. **Interactive prompts** for required values
+3. **Validate configuration** and test connectivity
+4. **Save to .env file** with secure permissions
+5. **Confirm successful configuration**
+
+## WordPress REST API Integration
+
+WordPress integration uses the native WordPress REST API with Application Passwords:
+
+1. **Authentication**: HTTP Basic Auth with Application Passwords
+2. **Content Creation**: Direct API calls for publishing
+3. **Gutenberg Support**: Block format conversion when needed
+4. **No Additional Dependencies**: Uses standard REST API endpoints
+
+## WordPress Setup Example
+
+```
+# User runs the command
+myai-configure wordpress
+
+# System prompts and responses:
+? Enter your WordPress site URL: https://myblog.com
+✓ URL format valid, testing connection...
+✓ WordPress site accessible
+
+? Enter your WordPress admin username: john_admin
+✓ Username format valid
+
+# System shows instructions
+📝 Create Application Password:
+1. Go to https://myblog.com/wp-admin/profile.php
+2. Scroll to "Application Passwords"
+3. Enter name: "MyAI Dev Method"
+4. Click "Add New"
+5. Copy the generated password
+
+? Paste your Application Password: abcd efgh ijkl mnop
+✓ Password format valid, testing connection...
+✓ WordPress API connection successful!
+
+? Set up SSH for advanced features? (y/n): y
+? SSH host/IP: myblog.com
+? SSH username: john
+? SSH key path (press enter for default): /home/user/.ssh/id_rsa
+✓ SSH connection tested successfully
+
+✅ Configuration saved to .env
+✅ File permissions set to 600 (secure)
+
+WordPress integration ready! Available commands:
+• myai-wordpress-admin health-check
+• myai-wordpress-publish filename.md
+• myai-content-writer "topic" --publish_to_wordpress true
+```
+
+## Agent Management Examples
+
+```
+# List all available agents
+myai-configure agents --list
+
+# Show detailed agent status
+myai-configure agents --status
+
+# Check specific agent configuration
+myai-configure agents --validate content-writer
+
+# Create backup before editing
+myai-configure agents --backup wordpress-admin
+
+# Show agent tool permissions
+myai-configure agents --tools wordpress-admin
+```
+
+## Agent Operations
+
+### List Operation
+Shows:
+- Agent name and description
+- File location
+- Available tools
+- Last modified date
+- Configuration status (valid/invalid)
+
+### Status Operation
+Checks:
+- Configuration validity
+- Required fields presence
+- Tool availability
+- File permissions
+- Syntax errors
+
+### Validate Operation
+Performs:
+- Syntax validation
+- Required field verification
+- Tool permission verification
+- Configuration structure analysis
+- Best practice recommendations
+
+### Backup/Restore Operations
+- Creates timestamped backups
+- Maintains backup history
+- Safe restoration with confirmation prompts
+- Backup before any modifications
+
+## Security
+
+- Never display passwords in plain text
+- Use environment variables for sensitive data
+- Validate URLs and credentials before saving
+- Set secure file permissions (600) for .env files
+"""