@polymorphism-tech/morph-spec 2.3.0 → 3.0.0

package/src/lib/validation-runner.js

@@ -0,0 +1,283 @@
+/**
+ * MORPH-SPEC Validation Runner
+ *
+ * Unified orchestrator that runs the right validators based on the feature's
+ * active agents and decisions. Called by task-done before marking tasks complete.
+ *
+ * MORPH-SPEC 3.0 - Phase A: Active Validation Pipeline
+ */
+
+import { existsSync, readFileSync } from 'fs';
+import { join } from 'path';
+import chalk from 'chalk';
+import { loadState } from './state-manager.js';
+import { loadConstraints } from './decision-constraint-loader.js';
+
+/**
+ * Load agent → validators map from agents.json (data-driven)
+ * @param {string} projectPath - Root path of the project
+ * @returns {Object} Map of agent IDs to validator arrays
+ */
+function loadAgentValidatorMap(projectPath) {
+  try {
+    const agentsPath = join(projectPath, 'content/.morph/config/agents.json');
+    const agentsConfig = JSON.parse(readFileSync(agentsPath, 'utf8'));
+
+    const map = {};
+    Object.entries(agentsConfig.agents || {}).forEach(([agentId, agent]) => {
+      if (!agentId.startsWith('_comment') && agent.validators && agent.validators.length > 0) {
+        map[agentId] = agent.validators;
+      }
+    });
+
+    return map;
+  } catch (err) {
+    console.warn(chalk.yellow('⚠️  Failed to load agents.json - no validators will run'));
+    console.warn(chalk.gray(`   Run 'morph-spec init' to set up MORPH-SPEC configuration`));
+    return {}; // Empty map = honest failure
+  }
+}
+
+/**
+ * Run all relevant validators for a feature
+ *
+ * @param {string} projectPath - Project root path
+ * @param {string} featureName - Feature name from state.json
+ * @param {Object} options - Options
+ * @param {boolean} options.verbose - Show detailed output
+ * @param {string[]} options.validators - Specific validators to run (overrides agent-based detection)
+ * @returns {Object} { passed, errors, warnings, issues, summary }
+ */
+export async function runValidation(projectPath, featureName, options = {}) {
+  const result = {
+    passed: true,
+    errors: 0,
+    warnings: 0,
+    issues: [],
+    summary: '',
+    results: {} // Per-validator results for hooks integration
+  };
+
+  // Load decision constraints from decisions.md
+  const constraints = loadConstraints(projectPath, featureName);
+
+  // Determine which validators to run
+  const validatorIds = options.validators || detectValidators(featureName, projectPath);
+
+  // Merge constraint-enabled validators
+  validatorIds.push(...constraints.enabledValidators);
+
+  if (validatorIds.length === 0) {
+    result.summary = 'No validators applicable for this feature';
+    return result;
+  }
+
+  if (options.verbose) {
+    console.log(chalk.gray(`\n  Running validators: ${validatorIds.join(', ')}`));
+    if (constraints.enabledValidators.length > 0) {
+      console.log(chalk.gray(`  (+ ${constraints.enabledValidators.length} from decisions)`));
+    }
+  }
+
+  // Always run contract compliance if contracts.cs exists
+  const contractsPath = join(projectPath, '.morph/project/outputs', featureName, 'contracts.cs');
+  if (existsSync(contractsPath)) {
+    validatorIds.push('contract-compliance');
+  }
+
+  // Deduplicate
+  const uniqueValidators = [...new Set(validatorIds)];
+
+  // Run each validator
+  for (const validatorId of uniqueValidators) {
+    try {
+      // Pass validator-specific constraints from decisions.md
+      const validatorOptions = {
+        ...options,
+        constraints: constraints.validators[validatorId] || {}
+      };
+
+      const validatorResult = await runSingleValidator(validatorId, projectPath, featureName, validatorOptions);
+
+      if (validatorResult) {
+        result.errors += validatorResult.errors || 0;
+        result.warnings += validatorResult.warnings || 0;
+
+        if (validatorResult.issues) {
+          result.issues.push(...validatorResult.issues);
+        }
+
+        // Store per-validator results for hooks
+        result.results[validatorId] = {
+          passed: (validatorResult.errors || 0) === 0,
+          issues: validatorResult.issues || []
+        };
+      }
+    } catch (err) {
+      if (options.verbose) {
+        console.log(chalk.yellow(`  ⚠ Validator '${validatorId}' failed: ${err.message}`));
+      }
+      result.results[validatorId] = {
+        passed: false,
+        error: err.message
+      };
+    }
+  }
+
+  result.passed = result.errors === 0;
+  result.summary = result.passed
+    ? `✅ All validations passed (${result.warnings} warnings)`
+    : `❌ ${result.errors} error(s), ${result.warnings} warning(s)`;
+
+  return result;
+}
+
+/**
+ * Detect which validators to run based on feature's active agents
+ * @param {string} featureName - Feature name
+ * @param {string} projectPath - Project root path (default: current directory)
+ * @returns {string[]} Array of validator IDs to run
+ */
+function detectValidators(featureName, projectPath = '.') {
+  const state = loadState(false);
+  if (!state || !state.features[featureName]) {
+    return ['architecture', 'packages']; // Default validators
+  }
+
+  const feature = state.features[featureName];
+  const agents = feature.activeAgents || [];
+  const validatorSet = new Set();
+
+  // Load agent → validators map from agents.json (data-driven)
+  const agentValidatorMap = loadAgentValidatorMap(projectPath);
+
+  for (const agentId of agents) {
+    const validators = agentValidatorMap[agentId] || [];
+    validators.forEach(v => validatorSet.add(v));
+  }
+
+  // Always include architecture and packages as baseline
+  validatorSet.add('architecture');
+  validatorSet.add('packages');
+
+  return Array.from(validatorSet);
+}
+
+/**
+ * Run a single validator by ID
+ */
+async function runSingleValidator(validatorId, projectPath, featureName, options) {
+  switch (validatorId) {
+    case 'architecture': {
+      const { validateArchitecture } = await import('./validators/architecture-validator.js');
+      return await validateArchitecture(projectPath, options);
+    }
+
+    case 'packages': {
+      const { validatePackages } = await import('./validators/package-validator.js');
+      return await validatePackages(projectPath, options);
+    }
+
+    case 'contrast': {
+      const { validateContrast } = await import('./validators/ui-contrast-validator.js');
+      return await validateContrast(projectPath, options);
+    }
+
+    case 'blazor': {
+      try {
+        const { validateBlazorPatterns } = await import('./blazor-validator.js');
+        return await validateBlazorPatterns(projectPath, options);
+      } catch {
+        return null; // Validator may not exist or have different export
+      }
+    }
+
+    case 'blazor-concurrency': {
+      try {
+        const { analyzeConcurrency } = await import('./blazor-concurrency-analyzer.js');
+        return await analyzeConcurrency(projectPath, options);
+      } catch {
+        return null;
+      }
+    }
+
+    case 'blazor-state': {
+      try {
+        const { validateState } = await import('./blazor-state-validator.js');
+        return await validateState(projectPath, options);
+      } catch {
+        return null;
+      }
+    }
+
+    case 'css': {
+      try {
+        const { validateCss } = await import('./css-validator.js');
+        return await validateCss(projectPath, options);
+      } catch {
+        return null;
+      }
+    }
+
+    case 'contract-compliance': {
+      const { validateContracts } = await import('./validators/contract-compliance-validator.js');
+      return await validateContracts(projectPath, featureName, options);
+    }
+
+    case 'design-system': {
+      const { validateDesignSystem } = await import('./validators/design-system-validator.js');
+      return await validateDesignSystem(projectPath, featureName, options);
+    }
+
+    default:
+      if (options.verbose) {
+        console.log(chalk.gray(`  Unknown validator: ${validatorId}`));
+      }
+      return null;
+  }
+}
+
+/**
+ * Format validation results for console output
+ */
+export function formatValidationResults(result) {
+  if (result.passed && result.warnings === 0) {
+    console.log(chalk.green('\n  ✅ All validations passed!\n'));
+    return;
+  }
+
+  if (result.passed && result.warnings > 0) {
+    console.log(chalk.yellow(`\n  ⚠️  Passed with ${result.warnings} warning(s)\n`));
+  } else {
+    console.log(chalk.red(`\n  ❌ Validation FAILED: ${result.errors} error(s), ${result.warnings} warning(s)\n`));
+  }
+
+  // Group issues by level
+  const errors = result.issues.filter(i => i.level === 'error');
+  const warnings = result.issues.filter(i => i.level === 'warning');
+
+  if (errors.length > 0) {
+    console.log(chalk.red.bold('  Errors:'));
+    for (const issue of errors.slice(0, 10)) {
+      console.log(chalk.red(`    ✗ ${issue.message}`));
+      if (issue.file) console.log(chalk.gray(`      ${issue.file}${issue.line ? ':' + issue.line : ''}`));
+      if (issue.solution) console.log(chalk.cyan(`      Fix: ${issue.solution}`));
+    }
+    if (errors.length > 10) {
+      console.log(chalk.gray(`    ... and ${errors.length - 10} more errors`));
+    }
+  }
+
+  if (warnings.length > 0) {
+    console.log(chalk.yellow('\n  Warnings:'));
+    for (const issue of warnings.slice(0, 5)) {
+      console.log(chalk.yellow(`    ⚠ ${issue.message}`));
+      if (issue.file) console.log(chalk.gray(`      ${issue.file}`));
+    }
+    if (warnings.length > 5) {
+      console.log(chalk.gray(`    ... and ${warnings.length - 5} more warnings`));
+    }
+  }
+
+  console.log('');
+}

package/src/lib/validators/contract-compliance-validator.js

@@ -0,0 +1,273 @@
+/**
+ * Contract Compliance Validator
+ *
+ * Parses contracts.cs from feature outputs and verifies that the project code
+ * actually implements all defined interfaces, methods, DTOs, and enums.
+ *
+ * MORPH-SPEC 3.0 - Phase A: Active Validation Pipeline
+ */
+
+import { readFileSync, existsSync } from 'fs';
+import { join } from 'path';
+import { glob } from 'glob';
+import chalk from 'chalk';
+
+/**
+ * Validate that contracts.cs interfaces are implemented in project code
+ *
+ * @param {string} projectPath - Project root path
+ * @param {string} featureName - Feature name
+ * @param {Object} options - Options
+ * @returns {Object} { status, errors, warnings, issues, coverage }
+ */
+export async function validateContracts(projectPath, featureName, options = {}) {
+  const contractsPath = join(projectPath, '.morph/project/outputs', featureName, 'contracts.cs');
+
+  if (!existsSync(contractsPath)) {
+    return {
+      status: 'ok',
+      errors: 0,
+      warnings: 0,
+      issues: [],
+      coverage: null,
+      message: 'No contracts.cs found — skipping'
+    };
+  }
+
+  const contractsContent = readFileSync(contractsPath, 'utf-8');
+  const contracts = parseContracts(contractsContent);
+
+  if (contracts.interfaces.length === 0 && contracts.records.length === 0 && contracts.enums.length === 0) {
+    return {
+      status: 'ok',
+      errors: 0,
+      warnings: 1,
+      issues: [{ level: 'warning', message: 'contracts.cs exists but no interfaces/records/enums found' }],
+      coverage: null
+    };
+  }
+
+  // Find all .cs files in the project (excluding .morph outputs, bin, obj)
+  const csFiles = await glob('**/*.cs', {
+    cwd: projectPath,
+    ignore: ['.morph/**', '**/bin/**', '**/obj/**', '**/node_modules/**']
+  });
+
+  const projectCode = {};
+  for (const file of csFiles) {
+    const fullPath = join(projectPath, file);
+    try {
+      projectCode[file] = readFileSync(fullPath, 'utf-8');
+    } catch {
+      // Skip unreadable files
+    }
+  }
+
+  const issues = [];
+  let implemented = 0;
+  let total = 0;
+  const interfaceResults = [];
+
+  // Validate interfaces
+  for (const iface of contracts.interfaces) {
+    total++;
+    const result = validateInterface(iface, projectCode, options);
+    interfaceResults.push(result);
+
+    if (result.implemented) {
+      implemented++;
+      if (options.verbose) {
+        console.log(chalk.green(`    ✓ ${iface.name} → ${result.implementingClass} (${result.implementedMethods}/${result.totalMethods} methods)`));
+      }
+    } else {
+      issues.push({
+        level: 'error',
+        message: `Interface ${iface.name} not implemented in project code`,
+        solution: `Create a class that implements ${iface.name} with all ${iface.methods.length} method(s)`
+      });
+    }
+
+    // Check for missing methods
+    for (const method of result.missingMethods || []) {
+      issues.push({
+        level: 'error',
+        message: `Method ${method} missing from ${result.implementingClass || iface.name} implementation`,
+        file: result.implementingFile,
+        solution: `Add method ${method} to the class implementing ${iface.name}`
+      });
+    }
+  }
+
+  // Validate records/DTOs
+  for (const record of contracts.records) {
+    total++;
+    const found = Object.entries(projectCode).some(([, content]) =>
+      new RegExp(`(class|record|struct)\\s+${escapeRegex(record.name)}`, 'g').test(content)
+    );
+
+    if (found) {
+      implemented++;
+      if (options.verbose) {
+        console.log(chalk.green(`    ✓ ${record.name} (${record.type})`));
+      }
+    } else {
+      issues.push({
+        level: 'warning',
+        message: `${record.type} ${record.name} defined in contracts but not found in project code`,
+        solution: `Create ${record.type} ${record.name} matching the contract definition`
+      });
+    }
+  }
+
+  // Validate enums
+  for (const enumDef of contracts.enums) {
+    total++;
+    const found = Object.entries(projectCode).some(([, content]) =>
+      new RegExp(`enum\\s+${escapeRegex(enumDef.name)}`, 'g').test(content)
+    );
+
+    if (found) {
+      implemented++;
+      if (options.verbose) {
+        console.log(chalk.green(`    ✓ ${enumDef.name} (enum)`));
+      }
+    } else {
+      issues.push({
+        level: 'warning',
+        message: `Enum ${enumDef.name} defined in contracts but not found in project code`,
+        solution: `Create enum ${enumDef.name} matching the contract definition`
+      });
+    }
+  }
+
+  const coveragePercent = total > 0 ? Math.round((implemented / total) * 100) : 100;
+  const errors = issues.filter(i => i.level === 'error').length;
+  const warnings = issues.filter(i => i.level === 'warning').length;
+
+  if (options.verbose) {
+    console.log(chalk.cyan(`\n    Contract coverage: ${coveragePercent}% (${implemented}/${total})`));
+  }
+
+  return {
+    status: errors > 0 ? 'error' : 'ok',
+    errors,
+    warnings,
+    issues,
+    coverage: {
+      percentage: coveragePercent,
+      implemented,
+      total,
+      interfaces: interfaceResults
+    }
+  };
+}
+
+/**
+ * Parse contracts.cs content and extract interfaces, records, and enums
+ */
+function parseContracts(content) {
+  const interfaces = [];
+  const records = [];
+  const enums = [];
+
+  // Extract interfaces with their methods
+  const interfaceRegex = /public\s+interface\s+(I\w+)(?:\s*:\s*[\w<>,\s]+)?\s*\{([^}]*)\}/gs;
+  let match;
+
+  while ((match = interfaceRegex.exec(content)) !== null) {
+    const name = match[1];
+    const body = match[2];
+    const methods = extractMethods(body);
+
+    interfaces.push({ name, methods });
+  }
+
+  // Extract records/classes (DTOs)
+  const recordRegex = /public\s+(record|class|struct)\s+(\w+)/g;
+  while ((match = recordRegex.exec(content)) !== null) {
+    const type = match[1];
+    const name = match[2];
+    // Skip interface names that were already captured
+    if (!name.startsWith('I') || !interfaces.some(i => i.name === name)) {
+      records.push({ type, name });
+    }
+  }
+
+  // Extract enums
+  const enumRegex = /public\s+enum\s+(\w+)/g;
+  while ((match = enumRegex.exec(content)) !== null) {
+    enums.push({ name: match[1] });
+  }
+
+  return { interfaces, records, enums };
+}
+
+/**
+ * Extract method signatures from an interface body
+ */
+function extractMethods(body) {
+  const methods = [];
+
+  // Match method signatures like: Task<Result> DoSomethingAsync(params);
+  const methodRegex = /(?:Task<[^>]+>|Task|void|string|int|bool|decimal|[\w<>[\],\s?]+)\s+(\w+)\s*\(/g;
+  let match;
+
+  while ((match = methodRegex.exec(body)) !== null) {
+    const methodName = match[1];
+    // Skip property getters/setters
+    if (!['get', 'set', 'init'].includes(methodName)) {
+      methods.push(methodName);
+    }
+  }
+
+  return methods;
+}
+
+/**
+ * Validate that an interface is implemented in project code
+ */
+function validateInterface(iface, projectCode, options) {
+  const result = {
+    name: iface.name,
+    implemented: false,
+    implementingClass: null,
+    implementingFile: null,
+    totalMethods: iface.methods.length,
+    implementedMethods: 0,
+    missingMethods: []
+  };
+
+  // Search for classes implementing this interface
+  const implRegex = new RegExp(`class\\s+(\\w+)\\s*(?:<[^>]*>)?\\s*:\\s*[^{]*${escapeRegex(iface.name)}`, 'g');
+
+  for (const [file, content] of Object.entries(projectCode)) {
+    const match = implRegex.exec(content);
+    if (match) {
+      result.implemented = true;
+      result.implementingClass = match[1];
+      result.implementingFile = file;
+
+      // Check which methods are implemented
+      for (const method of iface.methods) {
+        const methodExists = new RegExp(`(public|protected|private|internal)?\\s*(async\\s+)?\\S+\\s+${escapeRegex(method)}\\s*\\(`, 'g').test(content);
+        if (methodExists) {
+          result.implementedMethods++;
+        } else {
+          result.missingMethods.push(method);
+        }
+      }
+
+      break; // Found the implementation
+    }
+    implRegex.lastIndex = 0; // Reset for next file
+  }
+
+  return result;
+}
+
+/**
+ * Escape special regex characters in a string
+ */
+function escapeRegex(str) {
+  return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}