@polymorphism-tech/morph-spec 3.1.0 → 4.2.0

package/src/lib/continuous-validator.js

@@ -1,421 +0,0 @@
-/**
- * Continuous Validator
- *
- * Background watcher that validates project in real-time.
- * Detects issues before they become problems.
- *
- * MORPH-SPEC 3.0 - Sprint 4
- */
-
-import { readFileSync, existsSync, watch } from 'fs';
-import { glob } from 'glob';
-import { join, dirname } from 'path';
-import chalk from 'chalk';
-
-export class ContinuousValidator {
-  constructor(projectPath = '.') {
-    this.projectPath = projectPath;
-    this.watchers = [];
-    this.validationInterval = null;
-  }
-
-  /**
-   * Start continuous validation
-   */
-  async start(options = {}) {
-    const { watchMode = true, interval = 30000 } = options;
-
-    console.log(chalk.cyan('🔍 Starting continuous validation...'));
-
-    // Initial validation
-    await this.runAllValidations();
-
-    if (watchMode) {
-      // Watch for file changes
-      this.setupFileWatchers();
-
-      // Periodic validation
-      this.validationInterval = setInterval(() => {
-        this.runAllValidations();
-      }, interval);
-
-      console.log(chalk.gray(`Watching for changes (interval: ${interval/1000}s)...`));
-    }
-  }
-
-  /**
-   * Stop continuous validation
-   */
-  stop() {
-    // Stop file watchers
-    this.watchers.forEach(watcher => watcher.close());
-    this.watchers = [];
-
-    // Stop periodic validation
-    if (this.validationInterval) {
-      clearInterval(this.validationInterval);
-      this.validationInterval = null;
-    }
-
-    console.log(chalk.gray('Stopped continuous validation'));
-  }
-
-  /**
-   * Setup file watchers
-   */
-  setupFileWatchers() {
-    const watchPaths = [
-      '**/*.csproj',
-      '**/Program.cs',
-      'wwwroot/css/**/*.css',
-      'infra/**/*.bicep'
-    ];
-
-    for (const pattern of watchPaths) {
-      const watcher = watch(pattern, { persistent: false }, async (eventType, filename) => {
-        if (filename) {
-          console.log(chalk.gray(`File changed: ${filename}`));
-          await this.runAllValidations();
-        }
-      });
-
-      this.watchers.push(watcher);
-    }
-  }
-
-  /**
-   * Run all validations
-   */
-  async runAllValidations() {
-    const results = await Promise.all([
-      this.validatePackageCompatibility(),
-      this.validateArchitecturePatterns(),
-      this.validateProgramCs(),
-      this.validateUIContrast()
-    ]);
-
-    const errors = results.filter(r => r.level === 'error');
-    const warnings = results.filter(r => r.level === 'warning');
-    const infos = results.filter(r => r.level === 'info');
-
-    // Display summary
-    if (errors.length === 0 && warnings.length === 0) {
-      console.log(chalk.green('✅ All validations passed'));
-    } else {
-      if (errors.length > 0) {
-        console.log(chalk.red(`\n❌ ${errors.length} error(s) found:`));
-        errors.forEach(e => console.log(chalk.red(`  - ${e.message}`)));
-      }
-
-      if (warnings.length > 0) {
-        console.log(chalk.yellow(`\n⚠️  ${warnings.length} warning(s):`));
-        warnings.forEach(w => console.log(chalk.yellow(`  - ${w.message}`)));
-      }
-    }
-
-    // Auto-fix errors if possible
-    const fixableErrors = errors.filter(e => e.autoFix);
-    if (fixableErrors.length > 0) {
-      console.log(chalk.cyan(`\n🔧 Auto-fixing ${fixableErrors.length} issue(s)...`));
-      for (const error of fixableErrors) {
-        try {
-          await error.autoFix();
-          console.log(chalk.green(`  ✅ Fixed: ${error.message}`));
-        } catch (ex) {
-          console.log(chalk.red(`  ❌ Failed to fix: ${error.message}`));
-        }
-      }
-    }
-
-    return { errors, warnings, infos };
-  }
-
-  /**
-   * Validate package compatibility (.NET 10)
-   */
-  async validatePackageCompatibility() {
-    try {
-      const csprojFiles = await glob('**/*.csproj', { ignore: '**/obj/**' });
-
-      for (const file of csprojFiles) {
-        const content = readFileSync(file, 'utf-8');
-
-        // Extract .NET version
-        const tfmMatch = content.match(/<TargetFramework>(.*?)<\/TargetFramework>/);
-        if (!tfmMatch) continue;
-
-        const targetFramework = tfmMatch[1];
-        const dotnetVersion = parseInt(targetFramework.replace('net', ''));
-
-        if (dotnetVersion < 10) {
-          return {
-            level: 'info',
-            message: `${file}: Using .NET ${dotnetVersion} (consider upgrading to .NET 10)`
-          };
-        }
-
-        // Package compatibility matrix
-        const incompatiblePackages = this.checkPackageCompatibility(content, dotnetVersion);
-
-        if (incompatiblePackages.length > 0) {
-          return {
-            level: 'error',
-            message: `${file}: Incompatible packages with .NET ${dotnetVersion}:\n` +
-                     incompatiblePackages.map(p => `    - ${p.name} ${p.version} → upgrade to ${p.requiredVersion}`).join('\n'),
-            packages: incompatiblePackages
-          };
-        }
-      }
-
-      return { level: 'ok' };
-    } catch (error) {
-      return { level: 'error', message: `Package validation failed: ${error.message}` };
-    }
-  }
-
-  /**
-   * Check package compatibility
-   */
-  checkPackageCompatibility(csprojContent, dotnetVersion) {
-    const incompatible = [];
-
-    // Compatibility matrix (from dotnet10-compatibility.md)
-    const matrix = {
-      'MudBlazor': {
-        10: '8.15.0',
-        pattern: /<PackageReference Include="MudBlazor" Version="(.*?)"/
-      },
-      'Microsoft.FluentUI.AspNetCore.Components': {
-        10: '5.0.0',
-        pattern: /<PackageReference Include="Microsoft\.FluentUI\.AspNetCore\.Components" Version="(.*?)"/
-      },
-      'Hangfire.AspNetCore': {
-        10: '1.8.22',
-        pattern: /<PackageReference Include="Hangfire\.AspNetCore" Version="(.*?)"/
-      }
-    };
-
-    for (const [pkg, config] of Object.entries(matrix)) {
-      const match = csprojContent.match(config.pattern);
-      if (match) {
-        const installedVersion = match[1];
-        const requiredVersion = config[dotnetVersion];
-
-        if (requiredVersion && this.compareVersions(installedVersion, requiredVersion) < 0) {
-          incompatible.push({
-            name: pkg,
-            version: installedVersion,
-            requiredVersion
-          });
-        }
-      }
-    }
-
-    return incompatible;
-  }
-
-  /**
-   * Compare semantic versions
-   */
-  compareVersions(v1, v2) {
-    const parts1 = v1.split('.').map(Number);
-    const parts2 = v2.split('.').map(Number);
-
-    for (let i = 0; i < Math.max(parts1.length, parts2.length); i++) {
-      const p1 = parts1[i] || 0;
-      const p2 = parts2[i] || 0;
-      if (p1 < p2) return -1;
-      if (p1 > p2) return 1;
-    }
-
-    return 0;
-  }
-
-  /**
-   * Validate architecture patterns
-   */
-  async validateArchitecturePatterns() {
-    try {
-      const blazorFiles = await glob('**/*.razor.cs', { ignore: '**/obj/**' });
-
-      for (const file of blazorFiles) {
-        const content = readFileSync(file, 'utf-8');
-
-        // Check for Application layer injection (anti-pattern)
-        if (/\[Inject\].*I\w+Command/.test(content)) {
-          return {
-            level: 'error',
-            message: `${file}: Blazor component injecting Application layer directly (use HttpClient pattern)`,
-            reference: 'framework/standards/blazor-pitfalls.md'
-          };
-        }
-
-        // Check for DbContext injection (anti-pattern)
-        if (/\[Inject\].*DbContext/.test(content)) {
-          return {
-            level: 'error',
-            message: `${file}: Blazor component injecting DbContext directly (use HttpClient → API → Handler)`,
-            reference: 'framework/standards/blazor-pitfalls.md'
-          };
-        }
-
-        // Check for JSRuntime in OnInitialized (pitfall)
-        if (/OnInitialized.*JSRuntime/.test(content.replace(/\s+/g, ''))) {
-          return {
-            level: 'warning',
-            message: `${file}: Possible JSRuntime call in OnInitialized (use OnAfterRenderAsync)`,
-            reference: 'framework/standards/blazor-lifecycle.md'
-          };
-        }
-      }
-
-      return { level: 'ok' };
-    } catch (error) {
-      return { level: 'error', message: `Architecture validation failed: ${error.message}` };
-    }
-  }
-
-  /**
-   * Validate Program.cs setup
-   */
-  async validateProgramCs() {
-    try {
-      const programCs = 'Program.cs';
-      if (!existsSync(programCs)) {
-        return { level: 'ok' }; // Not a Blazor project
-      }
-
-      const content = readFileSync(programCs, 'utf-8');
-
-      const checks = [
-        { pattern: /app\.UseStaticFiles\(\)/, message: 'app.UseStaticFiles() is missing', critical: true },
-        { pattern: /AddHttpClient\(\)/, message: 'AddHttpClient() is missing', critical: true },
-        { pattern: /AddHttpContextAccessor\(\)/, message: 'AddHttpContextAccessor() is missing', critical: true }
-      ];
-
-      for (const check of checks) {
-        if (!check.pattern.test(content)) {
-          return {
-            level: check.critical ? 'error' : 'warning',
-            message: `Program.cs: ${check.message}`,
-            reference: 'framework/standards/program-cs-checklist.md'
-          };
-        }
-      }
-
-      // Check middleware order (UseStaticFiles before UseAntiforgery)
-      const staticFilesIndex = content.indexOf('UseStaticFiles');
-      const antiforgeryIndex = content.indexOf('UseAntiforgery');
-
-      if (staticFilesIndex > 0 && antiforgeryIndex > 0 && staticFilesIndex > antiforgeryIndex) {
-        return {
-          level: 'error',
-          message: 'Program.cs: app.UseStaticFiles() must come BEFORE app.UseAntiforgery()',
-          reference: 'framework/standards/program-cs-checklist.md'
-        };
-      }
-
-      return { level: 'ok' };
-    } catch (error) {
-      return { level: 'error', message: `Program.cs validation failed: ${error.message}` };
-    }
-  }
-
-  /**
-   * Validate UI contrast (WCAG 2.1 AA)
-   */
-  async validateUIContrast() {
-    try {
-      const cssFiles = await glob('wwwroot/css/**/*.css', { ignore: '**/node_modules/**' });
-
-      for (const file of cssFiles) {
-        const content = readFileSync(file, 'utf-8');
-
-        // Extract color variables
-        const colors = this.extractColors(content);
-
-        // Check common color pairs
-        const issues = [];
-        const bgColors = colors.filter(c => c.name.includes('background') || c.name.includes('bg'));
-        const textColors = colors.filter(c => c.name.includes('text') || c.name.includes('color'));
-
-        for (const bg of bgColors) {
-          for (const text of textColors) {
-            const ratio = this.calculateContrastRatio(bg.value, text.value);
-            if (ratio < 4.5) { // WCAG AA minimum for text
-              issues.push({ bg: bg.name, text: text.name, ratio: ratio.toFixed(2) });
-            }
-          }
-        }
-
-        if (issues.length > 0) {
-          return {
-            level: 'warning',
-            message: `${file}: Low contrast detected (WCAG AA requires 4.5:1):\n` +
-                     issues.map(i => `    - ${i.text} on ${i.bg}: ${i.ratio}:1`).join('\n')
-          };
-        }
-      }
-
-      return { level: 'ok' };
-    } catch (error) {
-      return { level: 'ok' }; // CSS parsing is optional
-    }
-  }
-
-  /**
-   * Extract colors from CSS
-   */
-  extractColors(css) {
-    const colors = [];
-    const hexPattern = /--([\w-]+):\s*(#[0-9a-fA-F]{3,6})/g;
-    let match;
-
-    while ((match = hexPattern.exec(css)) !== null) {
-      colors.push({ name: match[1], value: match[2] });
-    }
-
-    return colors;
-  }
-
-  /**
-   * Calculate contrast ratio (WCAG formula)
-   */
-  calculateContrastRatio(color1, color2) {
-    const l1 = this.getLuminance(color1);
-    const l2 = this.getLuminance(color2);
-
-    const lighter = Math.max(l1, l2);
-    const darker = Math.min(l1, l2);
-
-    return (lighter + 0.05) / (darker + 0.05);
-  }
-
-  /**
-   * Get relative luminance
-   */
-  getLuminance(hex) {
-    const rgb = this.hexToRgb(hex);
-    if (!rgb) return 0;
-
-    const [r, g, b] = rgb.map(val => {
-      val = val / 255;
-      return val <= 0.03928 ? val / 12.92 : Math.pow((val + 0.055) / 1.055, 2.4);
-    });
-
-    return 0.2126 * r + 0.7152 * g + 0.0722 * b;
-  }
-
-  /**
-   * Convert hex to RGB
-   */
-  hexToRgb(hex) {
-    const result = /^#?([a-f\d]{2})([a-f\d]{2})([a-f\d]{2})$/i.exec(hex);
-    return result ? [
-      parseInt(result[1], 16),
-      parseInt(result[2], 16),
-      parseInt(result[3], 16)
-    ] : null;
-  }
-
-}

package/src/lib/decision-constraint-loader.js

@@ -1,109 +0,0 @@
-/**
- * Decision Constraint Loader
- *
- * Reads decisions.md ADRs for a feature and produces constraint rules
- * that the ValidationRunner uses to enable/disable/configure validators.
- *
- * MORPH-SPEC 3.0 - Phase B: Spec-Driven Pipeline
- */
-
-import { readFileSync, existsSync } from 'fs';
-import { join } from 'path';
-
-/**
- * Decision-to-constraint mapping
- * Each key is a pattern to search for in decision text, value is the constraint it activates
- */
-const DECISION_CONSTRAINTS = [
-  { pattern: /fluent\s*ui/i, constraint: { validator: 'blazor', config: { uiLib: 'fluent' } } },
-  { pattern: /mudblazor/i, constraint: { validator: 'blazor', config: { uiLib: 'mudblazor' } } },
-  { pattern: /cqrs/i, constraint: { validator: 'architecture', config: { pattern: 'cqrs' } } },
-  { pattern: /repository\s*pattern/i, constraint: { validator: 'architecture', config: { pattern: 'repository' } } },
-  { pattern: /azure\s*sql/i, constraint: { validator: 'packages', config: { database: 'azure-sql' } } },
-  { pattern: /cosmos/i, constraint: { validator: 'packages', config: { database: 'cosmos' } } },
-  { pattern: /clerk/i, constraint: { validator: 'architecture', config: { auth: 'clerk' } } },
-  { pattern: /azure\s*identity|entra/i, constraint: { validator: 'architecture', config: { auth: 'azure-identity' } } },
-  { pattern: /hangfire/i, constraint: { enableValidators: ['blazor-concurrency'] } },
-  { pattern: /next\.?js/i, constraint: { enableValidators: ['nextjs'] } },
-  { pattern: /prisma/i, constraint: { enableValidators: ['nextjs'] } }
-];
-
-/**
- * Load constraints from a feature's decisions.md
- *
- * @param {string} projectPath - Project root path
- * @param {string} featureName - Feature name
- * @returns {Object} { validators: {}, enabledValidators: [], decisions: [] }
- */
-export function loadConstraints(projectPath, featureName) {
-  const result = {
-    validators: {},        // { validatorId: { config } }
-    enabledValidators: [], // Additional validators to enable
-    decisions: []          // Parsed decisions for reference
-  };
-
-  const decisionsPath = join(projectPath, '.morph/project/outputs', featureName, 'decisions.md');
-
-  if (!existsSync(decisionsPath)) {
-    return result;
-  }
-
-  const content = readFileSync(decisionsPath, 'utf-8');
-  const adrs = parseADRs(content);
-  result.decisions = adrs;
-
-  // Apply constraint mappings
-  for (const adr of adrs) {
-    const searchText = `${adr.title} ${adr.decision} ${adr.context}`;
-
-    for (const mapping of DECISION_CONSTRAINTS) {
-      if (mapping.pattern.test(searchText)) {
-        if (mapping.constraint.validator) {
-          result.validators[mapping.constraint.validator] = {
-            ...result.validators[mapping.constraint.validator],
-            ...mapping.constraint.config
-          };
-        }
-        if (mapping.constraint.enableValidators) {
-          result.enabledValidators.push(...mapping.constraint.enableValidators);
-        }
-      }
-    }
-  }
-
-  // Deduplicate enabled validators
-  result.enabledValidators = [...new Set(result.enabledValidators)];
-
-  return result;
-}
-
-/**
- * Parse ADR blocks from decisions.md
- * Expected format: ## ADR-N: Title + Status/Context/Decision/Consequences sections
- * Handles both **Key:** value and **Key**: value markdown formats
- */
-function parseADRs(content) {
-  const adrs = [];
-  const adrBlocks = content.split(/^##\s+ADR-\d+/m);
-  // First element is text before the first ## ADR-N — skip it
-  adrBlocks.shift();
-
-  for (const block of adrBlocks) {
-    if (!block.trim()) continue;
-
-    const titleMatch = block.match(/^[:\s]*(.+?)$/m);
-    // Handle **Status:** value OR **Status**: value
-    const statusMatch = block.match(/\*\*Status\s*[:*]+\s*(.+?)$/m);
-    const contextMatch = block.match(/\*\*Context\s*[:*]+\s*([\s\S]*?)(?=\n\*\*|$)/m);
-    const decisionMatch = block.match(/\*\*Decision\s*[:*]+\s*([\s\S]*?)(?=\n\*\*|$)/m);
-
-    adrs.push({
-      title: titleMatch ? titleMatch[1].trim() : '',
-      status: statusMatch ? statusMatch[1].trim() : 'unknown',
-      context: contextMatch ? contextMatch[1].trim() : '',
-      decision: decisionMatch ? decisionMatch[1].trim() : ''
-    });
-  }
-
-  return adrs;
-}