@polymorphism-tech/morph-spec 7.9.4 → 8.1.0

package/bin/validate.js

@@ -1,379 +1,379 @@
-#!/usr/bin/env node
-
-/**
- * Validation CLI
- *
- * Runs validators for the current project stack (detected from .morph/config/config.json).
- *
- * .NET/Blazor stacks: packages, architecture, contrast, spec-tasks
- * Next.js stack:      next-components, spec-tasks
- * Other stacks:       spec-tasks
- *
- * Usage:
- *   morph-spec validate [options]
- *   morph-spec validate all
- *   morph-spec validate next-components  (Next.js projects)
- *   morph-spec validate packages         (.NET projects)
- *
- * MORPH-SPEC 3.0
- */
-
-import chalk from 'chalk';
-import { getStackProfile } from '../src/lib/stack/stack-profile.js';
-
-/**
- * Build the VALIDATORS registry for the current stack.
- * .NET stacks  → packages, architecture, contrast, spec-tasks
- * nextjs stack → next-components, spec-tasks
- * other stacks → spec-tasks only
- */
-async function buildValidators(stack) {
-  const validators = {};
-
-  const isDotnet = !stack || ['dotnet', 'blazor', 'aspnet', 'dotnet-blazor'].includes(stack.toLowerCase());
-  const isNextjs = stack && ['nextjs', 'next', 'next.js'].includes(stack.toLowerCase());
-
-  if (isDotnet) {
-    const { validatePackages } = await import('../src/lib/validators/packages/package-validator.js');
-    const { validateArchitecture } = await import('../src/lib/validators/architecture/architecture-validator.js');
-    const { validateContrast } = await import('../src/lib/validators/ui/ui-contrast-validator.js');
-
-    validators.packages = {
-      name: 'Package Compatibility',
-      description: 'Validates NuGet package versions against .NET compatibility matrix',
-      run: validatePackages
-    };
-    validators.architecture = {
-      name: 'Architecture Patterns',
-      description: 'Detects DI anti-patterns, middleware issues, and configuration problems in .NET',
-      run: validateArchitecture
-    };
-    validators.contrast = {
-      name: 'UI Contrast (WCAG)',
-      description: 'Validates color contrast ratios for accessibility',
-      run: validateContrast
-    };
-  }
-
-  if (isNextjs) {
-    const { validateNextComponentFiles } = await import('../src/lib/validators/nextjs/next-component-validator.js');
-    validators['next-components'] = {
-      name: 'Next.js Components',
-      description: "Validates 'use client' directives, hook usage, and file naming conventions",
-      run: (projectPath, opts) => validateNextComponentFiles(projectPath, opts)
-    };
-  }
-
-  validators['spec-tasks'] = {
-    name: 'Spec vs Tasks Coverage',
-    description: 'Validates that tasks.json covers all requirements from spec.md',
-    run: validateSpecVsTasks
-  };
-
-  return validators;
-}
-
-/**
- * Validate spec.md requirements are covered by tasks
- */
-async function validateSpecVsTasks(projectPath, options = {}) {
-  const path = await import('path');
-  const fs = await import('fs');
-  const { loadState } = await import('../src/core/state/state-manager.js');
-
-  const results = [];
-  let errors = 0;
-  let warnings = 0;
-
-  try {
-    const state = loadState(false);
-    if (!state || !state.features) {
-      return { status: 'ok', errors: 0, warnings: 0, message: 'No features to validate' };
-    }
-
-    for (const [featureName, feature] of Object.entries(state.features)) {
-      const outputsPath = path.join(projectPath, '.morph/features', featureName);
-      const specPath = path.join(outputsPath, 'spec.md');
-
-      if (!fs.existsSync(specPath)) {
-        continue; // No spec to validate
-      }
-
-      // Read spec.md and extract requirements
-      const specContent = fs.readFileSync(specPath, 'utf-8');
-
-      // Extract requirement patterns (## Requisitos, - [ ], numbered lists, etc.)
-      const requirementPatterns = [
-        /^#+\s*Requisitos?\s*$/gim,
-        /^-\s*\[.\]\s*(.+)$/gm,
-        /^\d+\.\s+(.+)$/gm
-      ];
-
-      const requirements = [];
-      for (const pattern of requirementPatterns) {
-        const matches = specContent.matchAll(pattern);
-        for (const match of matches) {
-          if (match[1]) {
-            requirements.push(match[1].trim());
-          }
-        }
-      }
-
-      // Check if feature has tasks
-      if (!feature.tasks || (Array.isArray(feature.tasks) && feature.tasks.length === 0)) {
-        if (requirements.length > 0) {
-          warnings++;
-          results.push({
-            feature: featureName,
-            level: 'warning',
-            message: `Spec has ${requirements.length} requirements but no tasks defined`
-          });
-        }
-        continue;
-      }
-
-      // Get task titles
-      const taskTitles = Array.isArray(feature.tasks)
-        ? feature.tasks.map(t => t.title?.toLowerCase() || '')
-        : [];
-
-      // Check each requirement has a matching task (fuzzy match)
-      for (const req of requirements.slice(0, 20)) { // Limit to first 20
-        const reqLower = req.toLowerCase();
-        const hasMatch = taskTitles.some(title =>
-          title.includes(reqLower.slice(0, 20)) ||
-          reqLower.includes(title.slice(0, 20))
-        );
-
-        if (!hasMatch && options.verbose) {
-          console.log(chalk.gray(`  ? Requirement may not be covered: "${req.slice(0, 50)}..."`));
-        }
-      }
-
-      if (options.verbose) {
-        console.log(chalk.green(`  ✓ ${featureName}: ${requirements.length} requirements, ${taskTitles.length} tasks`));
-      }
-    }
-
-  } catch (error) {
-    if (options.verbose) {
-      console.log(chalk.yellow(`  ⚠ Could not validate: ${error.message}`));
-    }
-  }
-
-  return {
-    status: errors > 0 ? 'error' : warnings > 0 ? 'warning' : 'ok',
-    errors,
-    warnings,
-    results
-  };
-}
-
-/**
- * Main validation command
- */
-export async function validateCommand(args = []) {
-  const validatorName = args[0] || 'all';
-  const options = parseOptions(args);
-
-  const { stack } = getStackProfile();
-  const VALIDATORS = await buildValidators(stack);
-
-  console.log(chalk.bold.cyan('\n🔍 MORPH-SPEC Validator\n'));
-  if (stack) {
-    console.log(chalk.gray(`Stack: ${stack}\n`));
-  }
-
-  if (validatorName === 'all') {
-    await runAllValidators(VALIDATORS, options);
-  } else if (VALIDATORS[validatorName]) {
-    await runValidator(VALIDATORS, validatorName, options);
-  } else {
-    console.error(chalk.red(`❌ Unknown validator: ${validatorName}`));
-    console.log(chalk.gray('\nAvailable validators:'));
-    for (const [name, validator] of Object.entries(VALIDATORS)) {
-      console.log(chalk.gray(`  - ${name}: ${validator.description}`));
-    }
-    console.log(chalk.gray('  - all: Run all validators'));
-    process.exit(1);
-  }
-}
-
-/**
- * Run all validators
- */
-async function runAllValidators(VALIDATORS, options) {
-  const results = {};
-  let totalErrors = 0;
-  let totalWarnings = 0;
-
-  console.log(chalk.gray('Running all validators...\n'));
-
-  for (const [name, validator] of Object.entries(VALIDATORS)) {
-    console.log(chalk.cyan(`\n▸ ${validator.name}`));
-    console.log(chalk.gray(`  ${validator.description}\n`));
-
-    try {
-      const result = await validator.run('.', {
-        verbose: options.verbose,
-        autoFix: options.autoFix
-      });
-
-      results[name] = result;
-
-      // Count errors/warnings
-      if (result.errors !== undefined) {
-        totalErrors += result.errors;
-        totalWarnings += result.warnings || 0;
-      } else if (result.results) {
-        // Count issues in results array
-        const issues = result.results.flatMap(r => r.issues || []);
-        totalErrors += issues.filter(i => i.level === 'error').length;
-        totalWarnings += issues.filter(i => i.level === 'warning').length;
-      }
-
-    } catch (error) {
-      console.error(chalk.red(`  ❌ Failed: ${error.message}`));
-      results[name] = { status: 'error', error: error.message };
-    }
-  }
-
-  // Summary
-  console.log(chalk.bold.cyan('\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n'));
-  console.log(chalk.bold('📊 Validation Summary\n'));
-
-  if (totalErrors === 0 && totalWarnings === 0) {
-    console.log(chalk.green('✅ All validations passed!'));
-  } else {
-    if (totalErrors > 0) {
-      console.log(chalk.red(`❌ ${totalErrors} error(s) found`));
-    }
-    if (totalWarnings > 0) {
-      console.log(chalk.yellow(`⚠️  ${totalWarnings} warning(s) found`));
-    }
-  }
-
-  console.log('');
-
-  // Exit with error code if errors found
-  if (totalErrors > 0 && !options.noFail) {
-    process.exit(1);
-  }
-}
-
-/**
- * Run single validator
- */
-async function runValidator(VALIDATORS, name, options) {
-  const validator = VALIDATORS[name];
-
-  console.log(chalk.cyan(`▸ ${validator.name}`));
-  console.log(chalk.gray(`  ${validator.description}\n`));
-
-  try {
-    const result = await validator.run('.', {
-      verbose: true, // Always verbose for single validator
-      autoFix: options.autoFix,
-      wcagLevel: options.wcagLevel
-    });
-
-    if (result.status === 'ok') {
-      console.log(chalk.green('\n✅ Validation passed!\n'));
-    } else {
-      console.log(chalk.yellow('\n⚠️  Validation completed with issues\n'));
-
-      if (result.errors > 0 && !options.noFail) {
-        process.exit(1);
-      }
-    }
-
-  } catch (error) {
-    console.error(chalk.red(`\n❌ Validation failed: ${error.message}\n`));
-    if (!options.noFail) {
-      process.exit(1);
-    }
-  }
-}
-
-/**
- * Parse command-line options
- */
-function parseOptions(args) {
-  const options = {
-    verbose: false,
-    autoFix: false,
-    noFail: false,
-    wcagLevel: 'AA'
-  };
-
-  for (const arg of args) {
-    if (arg === '--verbose' || arg === '-v') {
-      options.verbose = true;
-    } else if (arg === '--auto-fix' || arg === '--fix') {
-      options.autoFix = true;
-    } else if (arg === '--no-fail') {
-      options.noFail = true;
-    } else if (arg === '--wcag-aaa') {
-      options.wcagLevel = 'AAA';
-    }
-  }
-
-  return options;
-}
-
-/**
- * Show help
- */
-export function showValidateHelp() {
-  console.log(`
-${chalk.bold.cyan('morph-spec validate')} - Run project validations
-
-${chalk.bold('USAGE')}
-  morph-spec validate [validator] [options]
-
-${chalk.bold('VALIDATORS')}
-  all             Run all validators (default)
-  packages        Validate NuGet package compatibility (.NET 10)
-  architecture    Validate architecture patterns (DI, lifecycle)
-  contrast        Validate UI contrast ratios (WCAG 2.1)
-
-${chalk.bold('OPTIONS')}
-  --verbose, -v        Show detailed output
-  --auto-fix, --fix    Auto-fix issues where possible
-  --no-fail            Don't exit with error code
-  --wcag-aaa           Use WCAG AAA standard (stricter)
-
-${chalk.bold('EXAMPLES')}
-  morph-spec validate                    # Run all validators
-  morph-spec validate packages --fix     # Validate packages and auto-fix
-  morph-spec validate architecture -v    # Verbose architecture validation
-  morph-spec validate contrast --wcag-aaa # Stricter contrast validation
-  morph-spec validate all                # Run all validators
-
-${chalk.bold('EXIT CODES')}
-  0    All validations passed
-  1    Validation errors found (unless --no-fail)
-
-${chalk.bold('INTEGRATION')}
-  Add to pre-commit hook:
-    morph-spec validate --no-fail
-
-  CI/CD pipeline:
-    morph-spec validate || exit 1
-`);
-}
-
-// Run if called directly
-if (import.meta.url === `file://${process.argv[1]}`) {
-  const args = process.argv.slice(2);
-
-  if (args.includes('--help') || args.includes('-h')) {
-    showValidateHelp();
-    process.exit(0);
-  }
-
-  validateCommand(args).catch(error => {
-    console.error(chalk.red(`\n❌ Error: ${error.message}\n`));
-    process.exit(1);
-  });
-}
+#!/usr/bin/env node
+
+/**
+ * Validation CLI
+ *
+ * Runs validators for the current project stack (detected from .morph/config/config.json).
+ *
+ * .NET/Blazor stacks: packages, architecture, contrast, spec-tasks
+ * Next.js stack:      next-components, spec-tasks
+ * Other stacks:       spec-tasks
+ *
+ * Usage:
+ *   morph-spec validate [options]
+ *   morph-spec validate all
+ *   morph-spec validate next-components  (Next.js projects)
+ *   morph-spec validate packages         (.NET projects)
+ *
+ * MORPH-SPEC 3.0
+ */
+
+import chalk from 'chalk';
+import { getStackProfile } from '../src/lib/stack/stack-profile.js';
+
+/**
+ * Build the VALIDATORS registry for the current stack.
+ * .NET stacks  → packages, architecture, contrast, spec-tasks
+ * nextjs stack → next-components, spec-tasks
+ * other stacks → spec-tasks only
+ */
+async function buildValidators(stack) {
+  const validators = {};
+
+  const isDotnet = !stack || ['dotnet', 'blazor', 'aspnet', 'dotnet-blazor'].includes(stack.toLowerCase());
+  const isNextjs = stack && ['nextjs', 'next', 'next.js'].includes(stack.toLowerCase());
+
+  if (isDotnet) {
+    const { validatePackages } = await import('../src/lib/validators/packages/package-validator.js');
+    const { validateArchitecture } = await import('../src/lib/validators/architecture/architecture-validator.js');
+    const { validateContrast } = await import('../src/lib/validators/ui/ui-contrast-validator.js');
+
+    validators.packages = {
+      name: 'Package Compatibility',
+      description: 'Validates NuGet package versions against .NET compatibility matrix',
+      run: validatePackages
+    };
+    validators.architecture = {
+      name: 'Architecture Patterns',
+      description: 'Detects DI anti-patterns, middleware issues, and configuration problems in .NET',
+      run: validateArchitecture
+    };
+    validators.contrast = {
+      name: 'UI Contrast (WCAG)',
+      description: 'Validates color contrast ratios for accessibility',
+      run: validateContrast
+    };
+  }
+
+  if (isNextjs) {
+    const { validateNextComponentFiles } = await import('../src/lib/validators/nextjs/next-component-validator.js');
+    validators['next-components'] = {
+      name: 'Next.js Components',
+      description: "Validates 'use client' directives, hook usage, and file naming conventions",
+      run: (projectPath, opts) => validateNextComponentFiles(projectPath, opts)
+    };
+  }
+
+  validators['spec-tasks'] = {
+    name: 'Spec vs Tasks Coverage',
+    description: 'Validates that tasks.json covers all requirements from spec.md',
+    run: validateSpecVsTasks
+  };
+
+  return validators;
+}
+
+/**
+ * Validate spec.md requirements are covered by tasks
+ */
+async function validateSpecVsTasks(projectPath, options = {}) {
+  const path = await import('path');
+  const fs = await import('fs');
+  const { loadState } = await import('../src/core/state/state-manager.js');
+
+  const results = [];
+  let errors = 0;
+  let warnings = 0;
+
+  try {
+    const state = loadState(false);
+    if (!state || !state.features) {
+      return { status: 'ok', errors: 0, warnings: 0, message: 'No features to validate' };
+    }
+
+    for (const [featureName, feature] of Object.entries(state.features)) {
+      const outputsPath = path.join(projectPath, '.morph/features', featureName);
+      const specPath = path.join(outputsPath, 'spec.md');
+
+      if (!fs.existsSync(specPath)) {
+        continue; // No spec to validate
+      }
+
+      // Read spec.md and extract requirements
+      const specContent = fs.readFileSync(specPath, 'utf-8');
+
+      // Extract requirement patterns (## Requisitos, - [ ], numbered lists, etc.)
+      const requirementPatterns = [
+        /^#+\s*Requisitos?\s*$/gim,
+        /^-\s*\[.\]\s*(.+)$/gm,
+        /^\d+\.\s+(.+)$/gm
+      ];
+
+      const requirements = [];
+      for (const pattern of requirementPatterns) {
+        const matches = specContent.matchAll(pattern);
+        for (const match of matches) {
+          if (match[1]) {
+            requirements.push(match[1].trim());
+          }
+        }
+      }
+
+      // Check if feature has tasks
+      if (!feature.tasks || (Array.isArray(feature.tasks) && feature.tasks.length === 0)) {
+        if (requirements.length > 0) {
+          warnings++;
+          results.push({
+            feature: featureName,
+            level: 'warning',
+            message: `Spec has ${requirements.length} requirements but no tasks defined`
+          });
+        }
+        continue;
+      }
+
+      // Get task titles
+      const taskTitles = Array.isArray(feature.tasks)
+        ? feature.tasks.map(t => t.title?.toLowerCase() || '')
+        : [];
+
+      // Check each requirement has a matching task (fuzzy match)
+      for (const req of requirements.slice(0, 20)) { // Limit to first 20
+        const reqLower = req.toLowerCase();
+        const hasMatch = taskTitles.some(title =>
+          title.includes(reqLower.slice(0, 20)) ||
+          reqLower.includes(title.slice(0, 20))
+        );
+
+        if (!hasMatch && options.verbose) {
+          console.log(chalk.gray(`  ? Requirement may not be covered: "${req.slice(0, 50)}..."`));
+        }
+      }
+
+      if (options.verbose) {
+        console.log(chalk.green(`  ✓ ${featureName}: ${requirements.length} requirements, ${taskTitles.length} tasks`));
+      }
+    }
+
+  } catch (error) {
+    if (options.verbose) {
+      console.log(chalk.yellow(`  ⚠ Could not validate: ${error.message}`));
+    }
+  }
+
+  return {
+    status: errors > 0 ? 'error' : warnings > 0 ? 'warning' : 'ok',
+    errors,
+    warnings,
+    results
+  };
+}
+
+/**
+ * Main validation command
+ */
+export async function validateCommand(args = []) {
+  const validatorName = args[0] || 'all';
+  const options = parseOptions(args);
+
+  const { stack } = getStackProfile();
+  const VALIDATORS = await buildValidators(stack);
+
+  console.log(chalk.bold.cyan('\n🔍 MORPH-SPEC Validator\n'));
+  if (stack) {
+    console.log(chalk.gray(`Stack: ${stack}\n`));
+  }
+
+  if (validatorName === 'all') {
+    await runAllValidators(VALIDATORS, options);
+  } else if (VALIDATORS[validatorName]) {
+    await runValidator(VALIDATORS, validatorName, options);
+  } else {
+    console.error(chalk.red(`❌ Unknown validator: ${validatorName}`));
+    console.log(chalk.gray('\nAvailable validators:'));
+    for (const [name, validator] of Object.entries(VALIDATORS)) {
+      console.log(chalk.gray(`  - ${name}: ${validator.description}`));
+    }
+    console.log(chalk.gray('  - all: Run all validators'));
+    process.exit(1);
+  }
+}
+
+/**
+ * Run all validators
+ */
+async function runAllValidators(VALIDATORS, options) {
+  const results = {};
+  let totalErrors = 0;
+  let totalWarnings = 0;
+
+  console.log(chalk.gray('Running all validators...\n'));
+
+  for (const [name, validator] of Object.entries(VALIDATORS)) {
+    console.log(chalk.cyan(`\n▸ ${validator.name}`));
+    console.log(chalk.gray(`  ${validator.description}\n`));
+
+    try {
+      const result = await validator.run('.', {
+        verbose: options.verbose,
+        autoFix: options.autoFix
+      });
+
+      results[name] = result;
+
+      // Count errors/warnings
+      if (result.errors !== undefined) {
+        totalErrors += result.errors;
+        totalWarnings += result.warnings || 0;
+      } else if (result.results) {
+        // Count issues in results array
+        const issues = result.results.flatMap(r => r.issues || []);
+        totalErrors += issues.filter(i => i.level === 'error').length;
+        totalWarnings += issues.filter(i => i.level === 'warning').length;
+      }
+
+    } catch (error) {
+      console.error(chalk.red(`  ❌ Failed: ${error.message}`));
+      results[name] = { status: 'error', error: error.message };
+    }
+  }
+
+  // Summary
+  console.log(chalk.bold.cyan('\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n'));
+  console.log(chalk.bold('📊 Validation Summary\n'));
+
+  if (totalErrors === 0 && totalWarnings === 0) {
+    console.log(chalk.green('✅ All validations passed!'));
+  } else {
+    if (totalErrors > 0) {
+      console.log(chalk.red(`❌ ${totalErrors} error(s) found`));
+    }
+    if (totalWarnings > 0) {
+      console.log(chalk.yellow(`⚠️  ${totalWarnings} warning(s) found`));
+    }
+  }
+
+  console.log('');
+
+  // Exit with error code if errors found
+  if (totalErrors > 0 && !options.noFail) {
+    process.exit(1);
+  }
+}
+
+/**
+ * Run single validator
+ */
+async function runValidator(VALIDATORS, name, options) {
+  const validator = VALIDATORS[name];
+
+  console.log(chalk.cyan(`▸ ${validator.name}`));
+  console.log(chalk.gray(`  ${validator.description}\n`));
+
+  try {
+    const result = await validator.run('.', {
+      verbose: true, // Always verbose for single validator
+      autoFix: options.autoFix,
+      wcagLevel: options.wcagLevel
+    });
+
+    if (result.status === 'ok') {
+      console.log(chalk.green('\n✅ Validation passed!\n'));
+    } else {
+      console.log(chalk.yellow('\n⚠️  Validation completed with issues\n'));
+
+      if (result.errors > 0 && !options.noFail) {
+        process.exit(1);
+      }
+    }
+
+  } catch (error) {
+    console.error(chalk.red(`\n❌ Validation failed: ${error.message}\n`));
+    if (!options.noFail) {
+      process.exit(1);
+    }
+  }
+}
+
+/**
+ * Parse command-line options
+ */
+function parseOptions(args) {
+  const options = {
+    verbose: false,
+    autoFix: false,
+    noFail: false,
+    wcagLevel: 'AA'
+  };
+
+  for (const arg of args) {
+    if (arg === '--verbose' || arg === '-v') {
+      options.verbose = true;
+    } else if (arg === '--auto-fix' || arg === '--fix') {
+      options.autoFix = true;
+    } else if (arg === '--no-fail') {
+      options.noFail = true;
+    } else if (arg === '--wcag-aaa') {
+      options.wcagLevel = 'AAA';
+    }
+  }
+
+  return options;
+}
+
+/**
+ * Show help
+ */
+export function showValidateHelp() {
+  console.log(`
+${chalk.bold.cyan('morph-spec validate')} - Run project validations
+
+${chalk.bold('USAGE')}
+  morph-spec validate [validator] [options]
+
+${chalk.bold('VALIDATORS')}
+  all             Run all validators (default)
+  packages        Validate NuGet package compatibility (.NET 10)
+  architecture    Validate architecture patterns (DI, lifecycle)
+  contrast        Validate UI contrast ratios (WCAG 2.1)
+
+${chalk.bold('OPTIONS')}
+  --verbose, -v        Show detailed output
+  --auto-fix, --fix    Auto-fix issues where possible
+  --no-fail            Don't exit with error code
+  --wcag-aaa           Use WCAG AAA standard (stricter)
+
+${chalk.bold('EXAMPLES')}
+  morph-spec validate                    # Run all validators
+  morph-spec validate packages --fix     # Validate packages and auto-fix
+  morph-spec validate architecture -v    # Verbose architecture validation
+  morph-spec validate contrast --wcag-aaa # Stricter contrast validation
+  morph-spec validate all                # Run all validators
+
+${chalk.bold('EXIT CODES')}
+  0    All validations passed
+  1    Validation errors found (unless --no-fail)
+
+${chalk.bold('INTEGRATION')}
+  Add to pre-commit hook:
+    morph-spec validate --no-fail
+
+  CI/CD pipeline:
+    morph-spec validate || exit 1
+`);
+}
+
+// Run if called directly
+if (import.meta.url === `file://${process.argv[1]}`) {
+  const args = process.argv.slice(2);
+
+  if (args.includes('--help') || args.includes('-h')) {
+    showValidateHelp();
+    process.exit(0);
+  }
+
+  validateCommand(args).catch(error => {
+    console.error(chalk.red(`\n❌ Error: ${error.message}\n`));
+    process.exit(1);
+  });
+}