myaidev-method 0.2.22 → 0.2.24-1

package/bin/cli.js

@@ -7,7 +7,17 @@ import fs from 'fs-extra';
 import path from 'path';
 import { fileURLToPath } from 'url';
 import inquirer from 'inquirer';
-import { getASCIIBanner, getSPARCBreakdown, getInitSuccessMessage } from '../src/lib/ascii-banner.js';
+import {
+  getASCIIBanner,
+  getSPARCBreakdown,
+  getInitSuccessMessage,
+  getWorkflowBanner,
+  getContentWorkflowSuccess,
+  getVisualWorkflowSuccess,
+  getDevWorkflowSuccess,
+  getPublishWorkflowSuccess,
+  getDeployWorkflowSuccess
+} from '../src/lib/ascii-banner.js';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
@@ -31,53 +41,174 @@ program
   .version('0.2.22')
   .description('MyAIDev Method - Comprehensive development framework with SPARC methodology');
 
+// Helper function for CLI type selection
+async function selectCLIType(options) {
+  if (options.claude) return 'claude';
+  if (options.gemini) return 'gemini';
+  if (options.codex) return 'codex';
+
+  // Interactive selection if no flag provided
+  const answer = await inquirer.prompt([
+    {
+      type: 'list',
+      name: 'cliType',
+      message: 'Which AI CLI are you configuring for?',
+      choices: [
+        { name: 'Claude Code (Recommended)', value: 'claude' },
+        { name: 'Gemini CLI', value: 'gemini' },
+        { name: 'Codex CLI / OpenCode', value: 'codex' }
+      ],
+      default: 'claude'
+    }
+  ]);
+  return answer.cliType;
+}
+
 // Modular workflow installation commands
 program
   .command('content')
   .description('Install content creation workflow')
   .option('--claude', 'Install for Claude Code')
+  .option('--gemini', 'Install for Gemini CLI')
+  .option('--codex', 'Install for Codex CLI')
   .option('--dry-run', 'Show what would be installed without making changes')
   .option('--verbose', 'Show detailed progress')
   .action(async (options) => {
-    await loadWorkflowSystem();
-    const installer = new WorkflowInstaller({
-      projectRoot: process.cwd(),
-      verbose: options.verbose,
-      dryRun: options.dryRun
-    });
-    await installer.install(['content']);
+    // Display workflow banner
+    console.log(getWorkflowBanner('content'));
+
+    const cliType = await selectCLIType(options);
+
+    // For non-Claude CLIs, inform user about limited support
+    if (cliType !== 'claude') {
+      console.log(chalk.yellow(`\nNote: Content workflow is optimized for Claude Code.`));
+      console.log(chalk.gray(`Some features may have limited support for ${cliType}.\n`));
+    }
+
+    const spinner = ora('Installing content creation workflow...').start();
+
+    try {
+      await loadWorkflowSystem();
+      const installer = new WorkflowInstaller({
+        projectRoot: process.cwd(),
+        verbose: options.verbose,
+        dryRun: options.dryRun
+      });
+      const result = await installer.install(['content']);
+
+      if (options.dryRun) {
+        spinner.succeed(chalk.yellow('Dry run complete - no changes made'));
+      } else {
+        spinner.succeed(chalk.green('Content workflow installed successfully!'));
+
+        // Display rich success message
+        console.log(getContentWorkflowSuccess(result.results || [], cliType));
+
+        console.log(chalk.cyan(`\n🔄 Restart ${cliType} to load your new content commands!`));
+      }
+    } catch (error) {
+      spinner.fail(chalk.red('Failed to install content workflow'));
+      console.error(chalk.red(error.message));
+      if (options.verbose) console.error(error);
+      process.exit(1);
+    }
   });
 
 program
   .command('visual')
   .description('Install visual content generation workflow')
   .option('--claude', 'Install for Claude Code')
+  .option('--gemini', 'Install for Gemini CLI')
+  .option('--codex', 'Install for Codex CLI')
   .option('--dry-run', 'Show what would be installed without making changes')
   .option('--verbose', 'Show detailed progress')
   .action(async (options) => {
-    await loadWorkflowSystem();
-    const installer = new WorkflowInstaller({
-      projectRoot: process.cwd(),
-      verbose: options.verbose,
-      dryRun: options.dryRun
-    });
-    await installer.install(['visual']);
+    // Display workflow banner
+    console.log(getWorkflowBanner('visual'));
+
+    const cliType = await selectCLIType(options);
+
+    // For non-Claude CLIs, inform user about limited support
+    if (cliType !== 'claude') {
+      console.log(chalk.yellow(`\nNote: Visual workflow is optimized for Claude Code.`));
+      console.log(chalk.gray(`Some features may have limited support for ${cliType}.\n`));
+    }
+
+    const spinner = ora('Installing visual content generation workflow...').start();
+
+    try {
+      await loadWorkflowSystem();
+      const installer = new WorkflowInstaller({
+        projectRoot: process.cwd(),
+        verbose: options.verbose,
+        dryRun: options.dryRun
+      });
+      const result = await installer.install(['visual']);
+
+      if (options.dryRun) {
+        spinner.succeed(chalk.yellow('Dry run complete - no changes made'));
+      } else {
+        spinner.succeed(chalk.green('Visual workflow installed successfully!'));
+
+        // Display rich success message
+        console.log(getVisualWorkflowSuccess(result.results || [], cliType));
+
+        console.log(chalk.cyan(`\n🔄 Restart ${cliType} to load your new visual commands!`));
+      }
+    } catch (error) {
+      spinner.fail(chalk.red('Failed to install visual workflow'));
+      console.error(chalk.red(error.message));
+      if (options.verbose) console.error(error);
+      process.exit(1);
+    }
   });
 
 program
   .command('dev')
   .description('Install development workflow (SPARC methodology)')
   .option('--claude', 'Install for Claude Code')
+  .option('--gemini', 'Install for Gemini CLI')
+  .option('--codex', 'Install for Codex CLI')
   .option('--dry-run', 'Show what would be installed without making changes')
   .option('--verbose', 'Show detailed progress')
   .action(async (options) => {
-    await loadWorkflowSystem();
-    const installer = new WorkflowInstaller({
-      projectRoot: process.cwd(),
-      verbose: options.verbose,
-      dryRun: options.dryRun
-    });
-    await installer.install(['development']);
+    // Display workflow banner
+    console.log(getWorkflowBanner('development'));
+
+    const cliType = await selectCLIType(options);
+
+    if (cliType !== 'claude') {
+      console.log(chalk.yellow(`\nNote: Development workflow is optimized for Claude Code.`));
+      console.log(chalk.gray(`Some features may have limited support for ${cliType}.\n`));
+    }
+
+    const spinner = ora('Installing SPARC development workflow...').start();
+
+    try {
+      await loadWorkflowSystem();
+      const installer = new WorkflowInstaller({
+        projectRoot: process.cwd(),
+        verbose: options.verbose,
+        dryRun: options.dryRun
+      });
+      const result = await installer.install(['development']);
+
+      if (options.dryRun) {
+        spinner.succeed(chalk.yellow('Dry run complete - no changes made'));
+      } else {
+        spinner.succeed(chalk.green('Development workflow installed successfully!'));
+
+        // Display rich success message
+        console.log(getDevWorkflowSuccess(result.results || [], cliType));
+
+        console.log(chalk.cyan(`\n🔄 Restart ${cliType} to load your new development commands!`));
+      }
+    } catch (error) {
+      spinner.fail(chalk.red('Failed to install development workflow'));
+      console.error(chalk.red(error.message));
+      if (options.verbose) console.error(error);
+      process.exit(1);
+    }
   });
 
 program
@@ -90,7 +221,9 @@ program
   .option('--dry-run', 'Show what would be installed without making changes')
   .option('--verbose', 'Show detailed progress')
   .action(async (options) => {
-    await loadWorkflowSystem();
+    // Display workflow banner
+    console.log(getWorkflowBanner('publish'));
+
     const workflows = [];
     if (options.wordpress) workflows.push('publish-wordpress');
     if (options.payloadcms) workflows.push('publish-payloadcms');
@@ -103,12 +236,34 @@ program
       console.log(chalk.gray('  --wordpress, --payloadcms, --static, or --all'));
       process.exit(1);
     }
-    const installer = new WorkflowInstaller({
-      projectRoot: process.cwd(),
-      verbose: options.verbose,
-      dryRun: options.dryRun
-    });
-    await installer.install(workflows);
+
+    const spinner = ora('Installing publishing workflows...').start();
+
+    try {
+      await loadWorkflowSystem();
+      const installer = new WorkflowInstaller({
+        projectRoot: process.cwd(),
+        verbose: options.verbose,
+        dryRun: options.dryRun
+      });
+      const result = await installer.install(workflows);
+
+      if (options.dryRun) {
+        spinner.succeed(chalk.yellow('Dry run complete - no changes made'));
+      } else {
+        spinner.succeed(chalk.green('Publishing workflows installed successfully!'));
+
+        // Display rich success message
+        console.log(getPublishWorkflowSuccess(workflows, result.results || [], 'claude'));
+
+        console.log(chalk.cyan(`\n🔄 Restart Claude Code to load your new publishing commands!`));
+      }
+    } catch (error) {
+      spinner.fail(chalk.red('Failed to install publishing workflows'));
+      console.error(chalk.red(error.message));
+      if (options.verbose) console.error(error);
+      process.exit(1);
+    }
   });
 
 program
@@ -119,19 +274,43 @@ program
   .option('--dry-run', 'Show what would be installed without making changes')
   .option('--verbose', 'Show detailed progress')
   .action(async (options) => {
-    await loadWorkflowSystem();
+    // Display workflow banner
+    console.log(getWorkflowBanner('deploy'));
+
     const workflows = [];
     if (options.coolify) workflows.push('coolify');
     if (options.all) workflows.push('deployment', 'coolify');
     if (workflows.length === 0) {
       workflows.push('deployment');
     }
-    const installer = new WorkflowInstaller({
-      projectRoot: process.cwd(),
-      verbose: options.verbose,
-      dryRun: options.dryRun
-    });
-    await installer.install(workflows);
+
+    const spinner = ora('Installing deployment workflows...').start();
+
+    try {
+      await loadWorkflowSystem();
+      const installer = new WorkflowInstaller({
+        projectRoot: process.cwd(),
+        verbose: options.verbose,
+        dryRun: options.dryRun
+      });
+      const result = await installer.install(workflows);
+
+      if (options.dryRun) {
+        spinner.succeed(chalk.yellow('Dry run complete - no changes made'));
+      } else {
+        spinner.succeed(chalk.green('Deployment workflows installed successfully!'));
+
+        // Display rich success message
+        console.log(getDeployWorkflowSuccess(workflows, result.results || [], 'claude'));
+
+        console.log(chalk.cyan(`\n🔄 Restart Claude Code to load your new deployment commands!`));
+      }
+    } catch (error) {
+      spinner.fail(chalk.red('Failed to install deployment workflows'));
+      console.error(chalk.red(error.message));
+      if (options.verbose) console.error(error);
+      process.exit(1);
+    }
   });
 
 // Workflow management commands
@@ -210,11 +389,12 @@ program
           {
             type: 'list',
             name: 'cliType',
-            message: 'Which AI CLI are you configuring for?',
+            message: 'Which AI CLI are you configuring for? (claude|gemini|codex|opencode)',
             choices: [
               { name: 'Claude Code', value: 'claude' },
               { name: 'Gemini CLI', value: 'gemini' },
-              { name: 'Codex CLI', value: 'codex' }
+              { name: 'Codex CLI', value: 'codex' },
+              { name: 'Opencode CLI', value: 'opencode'}
             ]
           }
         ]);
@@ -663,6 +843,24 @@ This configuration follows Claude Code's official standards for custom commands
     }
   }
 
+  // Copy template documentation (WordPress integration, etc.)
+  const templateDocsDir = path.join(__dirname, '..', 'src', 'templates', 'docs');
+  if (await fs.pathExists(templateDocsDir)) {
+    const docFiles = await fs.readdir(templateDocsDir);
+    for (const file of docFiles) {
+      if (file.endsWith('.md')) {
+        const destPath = path.join(projectDir, file);
+        // Only copy if destination doesn't exist (don't overwrite user customizations)
+        if (!await fs.pathExists(destPath)) {
+          await fs.copy(
+            path.join(templateDocsDir, file),
+            destPath
+          );
+        }
+      }
+    }
+  }
+
   // Create content-rules.md if it doesn't already exist
   const contentRulesPath = path.join(projectDir, 'content-rules.md');
   if (!await fs.pathExists(contentRulesPath)) {

package/content-rules.example.md

@@ -141,6 +141,54 @@ This file contains custom rules and guidelines for the content-writer agent. Cop
 - Prerequisites and materials list
 - Troubleshooting section
 
+## Prohibited Words & Phrases
+
+NEVER use these AI filler words and clichéd phrases:
+
+### Generic AI Filler Words
+- "robust"
+- "leverage"
+- "streamline"
+- "optimize"
+- "enhance"
+- "cutting-edge"
+- "game-changing"
+- "innovative"
+- "seamless"
+- "holistic"
+- "synergy"
+- "empower"
+
+### Overused Transitions
+- "delve"
+- "unlock"
+- "harness"
+- "dive into"
+- "in conclusion"
+- "it's worth noting"
+- "at the end of the day"
+
+### Buzzwords to Avoid
+- "landscape"
+- "paradigm"
+- "disruptive"
+- "best-in-class"
+- "world-class"
+- "revolutionary"
+- "transformative"
+- "mission-critical"
+
+### Hyperbolic Adjectives
+- "stunning"
+- "incredible"
+- "amazing"
+- "powerful"
+- "perfect"
+- "comprehensive"
+- "crucial"
+- "critical"
+- "essential"
+
 ## Topics & Restrictions
 
 ### Topics to Avoid
@@ -178,6 +226,38 @@ This file contains custom rules and guidelines for the content-writer agent. Cop
 - Structure content for screen readers
 - Use simple language for complex topics
 
+## Visual Content Preferences
+
+### Visual Importance
+- **Level**: Essential - Every piece needs images/diagrams
+- **Style**: Clean & minimal - Simple, professional graphics
+
+### Image Types by Content
+| Content Type | Recommended Visuals |
+|--------------|---------------------|
+| Blog Posts | Hero image + 1-2 illustrations |
+| Technical Tutorials | Hero + diagrams + code screenshots |
+| API Documentation | Sequence diagrams + endpoint examples |
+| Architecture Guides | Architecture diagrams + flowcharts |
+| Listicles | Hero + item graphics + summary infographic |
+| Comparison Guides | Comparison infographic + decision flowchart |
+
+### Infographic Preferences
+- **Data Visualization**: Include for statistics and metrics
+- **Process Flows**: Use for step-by-step explanations
+- **Comparisons**: Side-by-side infographics for versus content
+- **Style**: Modern flat design, brand colors, clear typography
+
+### Diagram Style
+- **Architecture**: Isometric or flat technical illustration
+- **Flowcharts**: Standard shapes (diamonds, rectangles, ovals)
+- **Sequence**: UML-style with lifelines and arrows
+
+### Visual Generation Services
+- **Primary**: Gemini (fast, cost-effective)
+- **Text-Heavy**: GPT Image 1.5 (best text rendering)
+- **Detailed**: FLUX 2 Pro (excellent detail)
+
 ## Brand-Specific Requirements
 
 ### Company Information

package/dist/mcp/mcp-launcher.js

@@ -0,0 +1,237 @@
+#!/usr/bin/env node
+
+/**
+ * MCP Server Launcher Script
+ * Manages MCP server lifecycle with proper error handling and configuration
+ */
+
+import { spawn } from 'child_process';
+import { promises as fs } from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+class MCPLauncher {
+  constructor() {
+    this.serverProcess = null;
+    this.serverPath = path.resolve(__dirname, '../../.claude/mcp/wordpress-server.js');
+    this.isShuttingDown = false;
+  }
+
+  log(message, level = 'info') {
+    const timestamp = new Date().toISOString();
+    const prefix = {
+      info: '🔧',
+      success: '✅',
+      error: '❌',
+      warn: '⚠️'
+    }[level] || 'ℹ️';
+    
+    console.log(`[${timestamp}] ${prefix} ${message}`);
+  }
+
+  async validateEnvironment() {
+    this.log('Validating environment configuration...');
+    
+    const required = ['WORDPRESS_URL', 'WORDPRESS_USERNAME', 'WORDPRESS_APP_PASSWORD'];
+    const missing = required.filter(key => !process.env[key]);
+    
+    if (missing.length > 0) {
+      throw new Error(`Missing required environment variables: ${missing.join(', ')}`);
+    }
+    
+    this.log('Environment validation passed', 'success');
+  }
+
+  async validateServerFile() {
+    this.log('Checking MCP server file...');
+    
+    try {
+      await fs.access(this.serverPath);
+      this.log('MCP server file found', 'success');
+    } catch (error) {
+      throw new Error(`MCP server file not found: ${this.serverPath}`);
+    }
+  }
+
+  async startServer() {
+    if (this.serverProcess) {
+      this.log('Server is already running', 'warn');
+      return;
+    }
+
+    this.log('Starting Enhanced WordPress MCP Server...');
+    
+    this.serverProcess = spawn('node', [this.serverPath], {
+      stdio: ['inherit', 'pipe', 'pipe'],
+      env: process.env
+    });
+
+    // Handle server output
+    this.serverProcess.stdout.on('data', (data) => {
+      const output = data.toString().trim();
+      if (output) {
+        console.log(`[SERVER] ${output}`);
+      }
+    });
+
+    this.serverProcess.stderr.on('data', (data) => {
+      const output = data.toString().trim();
+      if (output) {
+        if (output.includes('Enhanced WordPress MCP Server') && output.includes('running')) {
+          this.log('MCP Server started successfully', 'success');
+          this.log(`Server PID: ${this.serverProcess.pid}`);
+          this.log('MCP Server is ready to accept connections');
+        } else if (output.includes('ERROR') || output.includes('Error')) {
+          this.log(`Server error: ${output}`, 'error');
+        } else {
+          console.log(`[SERVER] ${output}`);
+        }
+      }
+    });
+
+    // Handle server exit
+    this.serverProcess.on('exit', (code, signal) => {
+      if (!this.isShuttingDown) {
+        if (code === 0) {
+          this.log('Server exited gracefully');
+        } else {
+          this.log(`Server exited with code ${code} (signal: ${signal})`, 'error');
+        }
+      }
+      this.serverProcess = null;
+    });
+
+    this.serverProcess.on('error', (error) => {
+      this.log(`Server startup error: ${error.message}`, 'error');
+      this.serverProcess = null;
+    });
+
+    // Setup graceful shutdown
+    this.setupShutdownHandlers();
+  }
+
+  setupShutdownHandlers() {
+    const shutdown = async (signal) => {
+      if (this.isShuttingDown) return;
+      
+      this.isShuttingDown = true;
+      this.log(`Received ${signal}, shutting down gracefully...`);
+      
+      if (this.serverProcess) {
+        this.log('Stopping MCP server...');
+        this.serverProcess.kill('SIGTERM');
+        
+        // Force kill after 10 seconds
+        setTimeout(() => {
+          if (this.serverProcess) {
+            this.log('Force killing server...', 'warn');
+            this.serverProcess.kill('SIGKILL');
+          }
+        }, 10000);
+        
+        // Wait for server to exit
+        await new Promise((resolve) => {
+          if (!this.serverProcess) {
+            resolve();
+            return;
+          }
+          
+          this.serverProcess.on('exit', () => {
+            resolve();
+          });
+        });
+      }
+      
+      this.log('Shutdown complete');
+      process.exit(0);
+    };
+
+    process.on('SIGINT', () => shutdown('SIGINT'));
+    process.on('SIGTERM', () => shutdown('SIGTERM'));
+    process.on('SIGHUP', () => shutdown('SIGHUP'));
+  }
+
+  async launch() {
+    try {
+      this.log('🚀 MyAIDev Method MCP Server Launcher');
+      this.log('=====================================');
+      
+      await this.validateEnvironment();
+      await this.validateServerFile();
+      await this.startServer();
+      
+      // Keep the launcher running
+      this.log('Launcher is monitoring server...');
+      
+    } catch (error) {
+      this.log(`Launch failed: ${error.message}`, 'error');
+      process.exit(1);
+    }
+  }
+
+  async status() {
+    this.log('MCP Server Status Check');
+    this.log('======================');
+    
+    if (this.serverProcess) {
+      this.log(`Server is running (PID: ${this.serverProcess.pid})`, 'success');
+      this.log(`Server path: ${this.serverPath}`);
+    } else {
+      this.log('Server is not running', 'warn');
+    }
+    
+    // Environment status
+    const envVars = ['WORDPRESS_URL', 'WORDPRESS_USERNAME', 'WORDPRESS_APP_PASSWORD'];
+    this.log('\nEnvironment variables:');
+    envVars.forEach(key => {
+      const status = process.env[key] ? '✅' : '❌';
+      const value = process.env[key] ? 'configured' : 'missing';
+      console.log(`  ${status} ${key}: ${value}`);
+    });
+    
+    return {
+      running: !!this.serverProcess,
+      pid: this.serverProcess?.pid,
+      serverPath: this.serverPath
+    };
+  }
+}
+
+// CLI interface
+async function main() {
+  const launcher = new MCPLauncher();
+  const command = process.argv[2] || 'start';
+  
+  switch (command) {
+    case 'start':
+      await launcher.launch();
+      break;
+      
+    case 'status':
+      await launcher.status();
+      break;
+      
+    case 'health':
+      const { default: healthCheck } = await import('./health-check.js');
+      await healthCheck();
+      break;
+      
+    default:
+      console.log('Usage: node mcp-launcher.js [start|status|health]');
+      console.log('');
+      console.log('Commands:');
+      console.log('  start   - Start the MCP server (default)');
+      console.log('  status  - Show server status');
+      console.log('  health  - Run health check');
+      process.exit(1);
+  }
+}
+
+export { MCPLauncher };
+
+// Run if called directly
+if (import.meta.url === `file://${process.argv[1]}`) {
+  main().catch(console.error);
+}