myaidev-method 0.2.2 → 0.2.4

package/src/scripts/dev-review.js

@@ -0,0 +1,117 @@
+#!/usr/bin/env node
+
+/**
+ * MyAIDev Method - Code Review CLI
+ *
+ * Invokes the dev-reviewer agent to analyze code quality, security,
+ * performance, and best practices compliance.
+ *
+ * Usage:
+ *   npx myaidev-method dev:review "Review authentication module"
+ *   npx myaidev-method dev:review "Security audit for payments" --security
+ */
+
+import { SparcWorkflow } from '../lib/dev-workflow/sparc-workflow.js';
+import { getAgentByPhase } from '../lib/dev-workflow/agent-types.js';
+
+async function main() {
+  const args = process.argv.slice(2);
+
+  if (args.length === 0 || args.includes('--help') || args.includes('-h')) {
+    console.log(`
+👁️  MyAIDev Method - Code Review
+
+Usage:
+  npx myaidev-method dev:review "Review authentication"
+  npx myaidev-method dev:review "Audit payment module" --security --performance
+
+Options:
+  --security            Focus on security analysis (OWASP Top 10)
+  --performance         Focus on performance optimization
+  --output-dir <path>   Custom output directory (default: .myaidev-method/sparc/)
+  --help, -h            Show this help message
+
+Examples:
+  npx myaidev-method dev:review "Review user authentication module"
+  npx myaidev-method dev:review "Security audit for payment processing" --security
+  npx myaidev-method dev:review "Performance review of database queries" --performance
+
+Review Standards:
+  - Code Quality: Complexity, readability, maintainability
+  - Security: OWASP Top 10, vulnerability patterns
+  - Performance: Algorithm complexity, resource management
+  - Best Practices: SOLID principles, framework standards
+  - Technical Debt: Assessment, prioritization, remediation
+
+Output:
+  .myaidev-method/sparc/review-report.md
+
+Next Phase:
+  After review, run:
+  npx myaidev-method dev:docs "Document [feature]"
+    `);
+    process.exit(0);
+  }
+
+  const taskDescription = args[0];
+
+  // Parse options
+  const options = {
+    workingDir: process.cwd(),
+  };
+
+  for (let i = 1; i < args.length; i++) {
+    if (args[i] === '--security') {
+      options.focusSecurity = true;
+    } else if (args[i] === '--performance') {
+      options.focusPerformance = true;
+    } else if (args[i] === '--output-dir' && args[i + 1]) {
+      options.outputDir = args[i + 1];
+      i++;
+    }
+  }
+
+  try {
+    console.log('👁️  MyAIDev Method - Code Review');
+    console.log('📋 Task:', taskDescription);
+    if (options.focusSecurity) {
+      console.log('🛡️  Focus: Security Analysis (OWASP Top 10)');
+    }
+    if (options.focusPerformance) {
+      console.log('⚡ Focus: Performance Optimization');
+    }
+    console.log('');
+
+    const workflow = new SparcWorkflow(taskDescription, options);
+    const agent = getAgentByPhase('review');
+
+    console.log(`🚀 Invoking ${agent.emoji} ${agent.name}...`);
+    console.log('');
+
+    const result = await workflow.runPhase('review');
+
+    console.log('');
+    console.log('✅ Review complete!');
+    console.log('📄 Report:', result.outputFile);
+    console.log('');
+    console.log('📊 Review Summary:');
+    if (result.summary) {
+      console.log('  - Critical Issues:', result.summary.critical || 0);
+      console.log('  - High Priority:', result.summary.high || 0);
+      console.log('  - Medium Priority:', result.summary.medium || 0);
+      console.log('  - Low Priority:', result.summary.low || 0);
+    }
+    console.log('');
+    console.log('📌 Next Steps:');
+    console.log('  1. Review report in .myaidev-method/sparc/review-report.md');
+    console.log('  2. Address critical and high-priority issues');
+    console.log('  3. Run: npx myaidev-method dev:docs "Document [feature]"');
+    console.log('');
+
+  } catch (error) {
+    console.error('❌ Error:', error.message);
+    process.exit(1);
+  }
+}
+
+main();

package/src/scripts/dev-test.js

@@ -0,0 +1,115 @@
+#!/usr/bin/env node
+
+/**
+ * MyAIDev Method - Testing CLI
+ *
+ * Invokes the dev-tester agent to create comprehensive test suites,
+ * generate coverage reports, and validate quality gates.
+ *
+ * Usage:
+ *   npx myaidev-method dev:test "Test authentication system"
+ *   npx myaidev-method dev:test "Integration tests for checkout" --integration
+ */
+
+import { SparcWorkflow } from '../lib/dev-workflow/sparc-workflow.js';
+import { getAgentByPhase } from '../lib/dev-workflow/agent-types.js';
+
+async function main() {
+  const args = process.argv.slice(2);
+
+  if (args.length === 0 || args.includes('--help') || args.includes('-h')) {
+    console.log(`
+🧪 MyAIDev Method - Testing
+
+Usage:
+  npx myaidev-method dev:test "Test authentication"
+  npx myaidev-method dev:test "Test checkout flow" --integration --coverage
+
+Options:
+  --coverage            Generate coverage report
+  --integration         Focus on integration tests
+  --framework <name>    Testing framework (jest, mocha, pytest, etc.)
+  --output-dir <path>   Custom output directory (default: .myaidev-method/sparc/test-results/)
+  --help, -h            Show this help message
+
+Examples:
+  npx myaidev-method dev:test "Test user authentication"
+  npx myaidev-method dev:test "Integration tests for API" --integration --coverage
+  npx myaidev-method dev:test "Test payment module" --framework jest
+
+Testing Standards:
+  - 80%+ coverage for critical paths
+  - 60%+ overall coverage
+  - AAA pattern (Arrange, Act, Assert)
+  - Edge cases and error scenarios
+  - Quality gates (pre-commit, pre-merge)
+
+Output:
+  .myaidev-method/sparc/test-results/
+
+Next Phase:
+  After testing, run:
+  npx myaidev-method dev:review "Review [feature]"
+    `);
+    process.exit(0);
+  }
+
+  const taskDescription = args[0];
+
+  // Parse options
+  const options = {
+    workingDir: process.cwd(),
+  };
+
+  for (let i = 1; i < args.length; i++) {
+    if (args[i] === '--coverage') {
+      options.coverage = true;
+    } else if (args[i] === '--integration') {
+      options.integration = true;
+    } else if (args[i] === '--framework' && args[i + 1]) {
+      options.framework = args[i + 1];
+      i++;
+    } else if (args[i] === '--output-dir' && args[i + 1]) {
+      options.outputDir = args[i + 1];
+      i++;
+    }
+  }
+
+  try {
+    console.log('🧪 MyAIDev Method - Testing');
+    console.log('📋 Task:', taskDescription);
+    if (options.integration) {
+      console.log('🔗 Focus: Integration Tests');
+    }
+    if (options.framework) {
+      console.log('🔧 Framework:', options.framework);
+    }
+    console.log('');
+
+    const workflow = new SparcWorkflow(taskDescription, options);
+    const agent = getAgentByPhase('testing');
+
+    console.log(`🚀 Invoking ${agent.emoji} ${agent.name}...`);
+    console.log('');
+
+    const result = await workflow.runPhase('testing');
+
+    console.log('');
+    console.log('✅ Testing complete!');
+    console.log('📁 Output:', result.outputDir);
+    if (options.coverage) {
+      console.log('📊 Coverage Report:', result.coverageReport);
+    }
+    console.log('');
+    console.log('📌 Next Steps:');
+    console.log('  1. Review test results in .myaidev-method/sparc/test-results/');
+    console.log('  2. Run: npx myaidev-method dev:review "Review [feature]"');
+    console.log('');
+
+  } catch (error) {
+    console.error('❌ Error:', error.message);
+    process.exit(1);
+  }
+}
+
+main();

package/src/scripts/sparc-workflow.js

@@ -0,0 +1,187 @@
+#!/usr/bin/env node
+
+/**
+ * MyAIDev Method - Complete SPARC Workflow CLI
+ *
+ * Orchestrates the complete 5-phase SPARC development workflow:
+ * Architecture → Implementation → Testing → Review → Documentation
+ *
+ * Usage:
+ *   npx myaidev-method sparc "Build user authentication system"
+ *   npx myaidev-method sparc "Create payment module" --tech-stack "node,stripe,postgres"
+ *   npm run sparc "Build feature" (from package root)
+ */
+
+import { SparcWorkflow } from '../lib/dev-workflow/sparc-workflow.js';
+import { getWorkflowPhases } from '../lib/dev-workflow/agent-types.js';
+
+async function main() {
+  const args = process.argv.slice(2);
+
+  if (args.length === 0 || args.includes('--help') || args.includes('-h')) {
+    console.log(`
+🌟 MyAIDev Method - Complete SPARC Workflow
+
+Execute the complete 5-phase systematic development workflow:
+  1. Architecture - Design system and APIs
+  2. Implementation - Write production-ready code
+  3. Testing - Create comprehensive tests
+  4. Review - Analyze quality and security
+  5. Documentation - Generate complete docs
+
+Usage:
+  npx myaidev-method sparc "Build authentication system"
+  npx myaidev-method sparc "Create payment module" --tech-stack "node,stripe,postgres"
+
+Options:
+  --phases <phases>       Run specific phases (comma-separated)
+  --tech-stack <stack>    Technology preferences
+  --test-framework <fw>   Testing framework (jest, mocha, pytest)
+  --skip-phase <phase>    Skip specific phase (use with caution)
+  --output-dir <path>     Custom output directory
+  --help, -h              Show this help message
+
+Examples:
+  npx myaidev-method sparc "Build JWT authentication with refresh tokens"
+  npx myaidev-method sparc "Create e-commerce checkout" --tech-stack "react,node,stripe"
+  npx myaidev-method sparc "Refactor payment module" --phases "architecture,review,documentation"
+
+Workflow Phases:
+  1. 🏗️  Architecture   - System design, API specs, data modeling
+  2. 💻 Implementation - SOLID code, security, error handling
+  3. 🧪 Testing        - Unit/integration tests, 80%+ coverage
+  4. 👁️  Review         - Quality, security (OWASP), performance
+  5. 📚 Documentation  - API docs, user guides, architecture
+
+Output Structure:
+  .myaidev-method/
+  ├── sparc/
+  │   ├── architecture.md
+  │   ├── code-output/
+  │   ├── test-results/
+  │   ├── review-report.md
+  │   └── documentation/
+  ├── tasks/
+  └── workflows/
+
+Quality Standards:
+  - Code Quality: SOLID, Clean Code, DRY/KISS/YAGNI
+  - Testing: 80%+ coverage, integration tests
+  - Security: OWASP Top 10 compliance
+  - Documentation: Complete API and user documentation
+  - Performance: Optimization analysis included
+    `);
+    process.exit(0);
+  }
+
+  const taskDescription = args[0];
+
+  // Parse options
+  const options = {
+    workingDir: process.cwd(),
+  };
+
+  let skipPhases = [];
+
+  for (let i = 1; i < args.length; i++) {
+    if (args[i] === '--phases' && args[i + 1]) {
+      options.phases = args[i + 1].split(',').map(p => p.trim());
+      i++;
+    } else if (args[i] === '--tech-stack' && args[i + 1]) {
+      options.techStack = args[i + 1];
+      i++;
+    } else if (args[i] === '--test-framework' && args[i + 1]) {
+      options.framework = args[i + 1];
+      i++;
+    } else if (args[i] === '--skip-phase' && args[i + 1]) {
+      skipPhases.push(args[i + 1]);
+      i++;
+    } else if (args[i] === '--output-dir' && args[i + 1]) {
+      options.outputDir = args[i + 1];
+      i++;
+    }
+  }
+
+  // Apply skip-phase logic
+  if (skipPhases.length > 0) {
+    const allPhases = getWorkflowPhases();
+    options.phases = allPhases.filter(p => !skipPhases.includes(p));
+    console.log('⚠️  Skipping phases:', skipPhases.join(', '));
+  }
+
+  try {
+    console.log('');
+    console.log('═══════════════════════════════════════════════');
+    console.log('🌟 MyAIDev Method - SPARC Workflow');
+    console.log('═══════════════════════════════════════════════');
+    console.log('');
+    console.log('📋 Task:', taskDescription);
+    if (options.techStack) {
+      console.log('🔧 Tech Stack:', options.techStack);
+    }
+    if (options.framework) {
+      console.log('🧪 Test Framework:', options.framework);
+    }
+    console.log('');
+
+    const workflow = new SparcWorkflow(taskDescription, options);
+    const phases = options.phases || getWorkflowPhases();
+
+    console.log('📊 Workflow Plan:');
+    phases.forEach((phase, index) => {
+      console.log(`  ${index + 1}. ${phase}`);
+    });
+    console.log('');
+    console.log('═══════════════════════════════════════════════');
+    console.log('');
+
+    // Execute complete workflow
+    const results = await workflow.runComplete();
+
+    console.log('');
+    console.log('═══════════════════════════════════════════════');
+    console.log('🎉 SPARC Workflow Complete!');
+    console.log('═══════════════════════════════════════════════');
+    console.log('');
+    console.log('✅ All Phases Completed:');
+
+    Object.entries(results).forEach(([phase, result]) => {
+      console.log(`  ✓ ${phase}: ${result.status}`);
+    });
+
+    console.log('');
+    console.log('📁 Output Directory: .myaidev-method/sparc/');
+    console.log('');
+    console.log('📌 Deliverables:');
+    console.log('  - Architecture: architecture.md');
+    console.log('  - Code: code-output/');
+    console.log('  - Tests: test-results/');
+    console.log('  - Review: review-report.md');
+    console.log('  - Documentation: documentation/');
+    console.log('');
+    console.log('📌 Next Steps:');
+    console.log('  1. Review all artifacts in .myaidev-method/sparc/');
+    console.log('  2. Address any review findings (check review-report.md)');
+    console.log('  3. Run tests to verify implementation');
+    console.log('  4. Integrate code into your project structure');
+    console.log('  5. Deploy with confidence! 🚀');
+    console.log('');
+    console.log('═══════════════════════════════════════════════');
+    console.log('');
+
+  } catch (error) {
+    console.error('');
+    console.error('═══════════════════════════════════════════════');
+    console.error('❌ Workflow Error');
+    console.error('═══════════════════════════════════════════════');
+    console.error('');
+    console.error('Error:', error.message);
+    console.error('');
+    console.error('Please check the error above and try again.');
+    console.error('For help, run: npm run sparc --help');
+    console.error('');
+    process.exit(1);
+  }
+}
+
+main();