@polymorphism-tech/morph-spec 8.46.0 → 9.0.0

package/src/lib/validators/architecture/architecture-validator.js

@@ -1,270 +0,0 @@
-/**
- * Architecture Pattern Validator
- *
- * Validates architectural patterns and detects anti-patterns in .NET apps.
- * Checks Program.cs configuration, middleware order, and common DI issues.
- *
- * MORPH-SPEC 3.0 - Sprint 4
- */
-
-import { readFileSync } from 'fs';
-import { join } from 'path';
-import chalk from 'chalk';
-
-/**
- * Architecture Validation Rules
- */
-const VALIDATION_RULES = {
-  // Program.cs Issues
-  missingHttpClient: {
-    pattern: /AddHttpClient\(\)/,
-    inverse: true, // Rule triggers if pattern NOT found
-    level: 'error',
-    message: 'AddHttpClient() missing in Program.cs',
-    reference: 'framework/standards/program-cs-checklist.md',
-    solution: 'Add builder.Services.AddHttpClient() before builder.Build()'
-  },
-
-  missingHttpContextAccessor: {
-    pattern: /AddHttpContextAccessor\(\)/,
-    inverse: true,
-    level: 'warning',
-    message: 'AddHttpContextAccessor() missing (needed for auth contexts)',
-    reference: 'framework/standards/program-cs-checklist.md',
-    solution: 'Add builder.Services.AddHttpContextAccessor()'
-  },
-
-  missingStaticFiles: {
-    pattern: /app\.UseStaticFiles\(\)/,
-    inverse: true,
-    level: 'error',
-    message: 'app.UseStaticFiles() missing (CSS/JS won\'t load)',
-    reference: 'framework/standards/program-cs-checklist.md',
-    solution: 'Add app.UseStaticFiles() before app.UseAntiforgery()'
-  },
-
-  wrongMiddlewareOrder: {
-    // Custom validator (checked in validateProgramCs)
-    level: 'error',
-    message: 'app.UseStaticFiles() must come BEFORE app.UseAntiforgery()',
-    reference: 'framework/standards/program-cs-checklist.md',
-    solution: 'Reorder: UseStaticFiles() → UseAntiforgery() → UseAuthorization()'
-  }
-};
-
-/**
- * Architecture Validator Class
- */
-export class ArchitectureValidator {
-  constructor(projectPath = '.') {
-    this.projectPath = projectPath;
-  }
-
-  /**
-   * Validate all architecture rules
-   */
-  async validateAll() {
-    const results = {
-      programCs: await this.validateProgramCs()
-    };
-
-    const allIssues = [
-      ...results.programCs.issues
-    ];
-
-    return {
-      status: allIssues.length === 0 ? 'ok' : 'error',
-      totalIssues: allIssues.length,
-      errors: allIssues.filter(i => i.level === 'error').length,
-      warnings: allIssues.filter(i => i.level === 'warning').length,
-      // Top-level too, not only nested under `results`: the runner reports
-      // "❌ 2 error(s)" from the counts but prints the issue list, and reading
-      // only the top level meant a failure arrived with no file, no line and
-      // no fix — impossible to act on.
-      issues: allIssues,
-      results
-    };
-  }
-
-  /**
-   * Validate Program.cs
-   */
-  async validateProgramCs() {
-    // Resolved against `projectPath`, not the cwd. The constructor stored
-    // `projectPath` and nothing ever read it, so this validator inspected
-    // whatever directory the process happened to be in — in a worktree or a
-    // fleet run that is a different project, and reporting "no Program.cs,
-    // nothing to check" reads exactly like a pass.
-    const programCsPath = join(this.projectPath, 'Program.cs');
-
-    try {
-      const content = readFileSync(programCsPath, 'utf-8');
-      return this.validateProgramCsContent(content);
-    } catch (error) {
-      // No Program.cs found (not a .NET project)
-      return {
-        exists: false,
-        issues: []
-      };
-    }
-  }
-
-  /**
-   * Validate Program.cs content
-   */
-  validateProgramCsContent(content) {
-    const issues = [];
-
-    // Check missing patterns (inverse rules)
-    const inverseRules = ['missingHttpClient', 'missingHttpContextAccessor', 'missingStaticFiles'];
-
-    for (const ruleId of inverseRules) {
-      const rule = VALIDATION_RULES[ruleId];
-      const found = rule.pattern.test(content);
-
-      if (!found) {
-        issues.push({
-          file: 'Program.cs',
-          rule: ruleId,
-          level: rule.level,
-          message: rule.message,
-          reference: rule.reference,
-          solution: rule.solution
-        });
-      }
-    }
-
-    // Check middleware order
-    const staticFilesIndex = content.indexOf('UseStaticFiles');
-    const antiforgeryIndex = content.indexOf('UseAntiforgery');
-
-    if (staticFilesIndex > 0 && antiforgeryIndex > 0 && staticFilesIndex > antiforgeryIndex) {
-      const rule = VALIDATION_RULES.wrongMiddlewareOrder;
-      issues.push({
-        file: 'Program.cs',
-        rule: 'wrongMiddlewareOrder',
-        level: rule.level,
-        message: rule.message,
-        reference: rule.reference,
-        solution: rule.solution,
-        lineNumber: this.findLineNumber(content, /UseStaticFiles/)
-      });
-    }
-
-    return {
-      exists: true,
-      issues
-    };
-  }
-
-  /**
-   * Find line number of pattern match
-   */
-  findLineNumber(content, pattern) {
-    const lines = content.split('\n');
-    for (let i = 0; i < lines.length; i++) {
-      if (pattern.test(lines[i])) {
-        return i + 1;
-      }
-    }
-    return null;
-  }
-
-  /**
-   * Format validation results for console output
-   */
-  formatResults(results) {
-    if (results.status === 'ok') {
-      console.log(chalk.green('✅ No architecture issues found'));
-      return;
-    }
-
-    console.log(chalk.yellow(`\n⚠️  Found ${results.totalIssues} architecture issue(s):\n`));
-
-    // Group by file
-    const issuesByFile = new Map();
-    const allIssues = [
-      ...results.results.programCs.issues
-    ];
-
-    for (const issue of allIssues) {
-      if (!issuesByFile.has(issue.file)) {
-        issuesByFile.set(issue.file, []);
-      }
-      issuesByFile.get(issue.file).push(issue);
-    }
-
-    // Display by file
-    for (const [file, issues] of issuesByFile) {
-      console.log(chalk.cyan(`\n📄 ${file}`));
-
-      const errors = issues.filter(i => i.level === 'error');
-      const warnings = issues.filter(i => i.level === 'warning');
-
-      if (errors.length > 0) {
-        console.log(chalk.red(`  ❌ ${errors.length} error(s):`));
-        errors.forEach(e => {
-          const location = e.lineNumber ? `:${e.lineNumber}` : '';
-          console.log(chalk.red(`    ${file}${location}`));
-          console.log(chalk.red(`    - ${e.message}`));
-          console.log(chalk.gray(`      Solution: ${e.solution}`));
-          console.log(chalk.blue(`      Reference: ${e.reference}`));
-        });
-      }
-
-      if (warnings.length > 0) {
-        console.log(chalk.yellow(`  ⚠️  ${warnings.length} warning(s):`));
-        warnings.forEach(w => {
-          const location = w.lineNumber ? `:${w.lineNumber}` : '';
-          console.log(chalk.yellow(`    ${file}${location}`));
-          console.log(chalk.yellow(`    - ${w.message}`));
-          console.log(chalk.gray(`      Solution: ${w.solution}`));
-        });
-      }
-    }
-
-    console.log('');
-  }
-
-  /**
-   * Get suggested fixes
-   */
-  getSuggestedFixes(results) {
-    const fixes = [];
-    const allIssues = [
-      ...results.results.programCs.issues
-    ];
-
-    for (const issue of allIssues) {
-      fixes.push({
-        file: issue.file,
-        line: issue.lineNumber,
-        issue: issue.message,
-        solution: issue.solution,
-        reference: issue.reference,
-        severity: issue.level
-      });
-    }
-
-    return fixes;
-  }
-}
-
-/**
- * Quick validation function (for imports)
- */
-export async function validateArchitecture(projectPath = '.', options = {}) {
-  const validator = new ArchitectureValidator(projectPath);
-  const results = await validator.validateAll();
-
-  if (options.verbose) {
-    validator.formatResults(results);
-  }
-
-  if (options.fixes) {
-    const fixes = validator.getSuggestedFixes(results);
-    return { ...results, fixes };
-  }
-
-  return results;
-}

package/src/lib/validators/architecture/index.js

@@ -1,7 +0,0 @@
-/**
- * Architecture Validators
- *
- * Architecture pattern validation (DI, CQRS, etc.)
- */
-
-export * from './architecture-validator.js';

package/src/lib/validators/css/css-validator.js

@@ -1,340 +0,0 @@
-/**
- * MORPH-SPEC CSS Validator Library
- *
- * Validates that CSS classes used in HTML/JSX/TSX files exist in CSS files.
- * Helps catch missing CSS definitions before runtime.
- *
- * @module css-validator
- */
-
-import { readFileSync, existsSync } from 'fs';
-import { glob } from 'glob';
-import { join, relative } from 'path';
-
-// ============================================================================
-// CSS CLASS EXTRACTION
-// ============================================================================
-
-/**
- * Extract CSS class names from a CSS file content
- * @param {string} content - CSS file content
- * @returns {Set<string>} Set of class names defined in the CSS
- */
-export function extractCssClasses(content) {
-  const classes = new Set();
-
-  // Match class selectors: .class-name
-  // Handles: .class, .class:hover, .class::before, .class.other-class
-  const classRegex = /\.([a-zA-Z_-][a-zA-Z0-9_-]*)/g;
-
-  let match;
-  while ((match = classRegex.exec(content)) !== null) {
-    classes.add(match[1]);
-  }
-
-  return classes;
-}
-
-/**
- * Extract CSS classes used in HTML/JSX/TSX file content
- * @param {string} content - HTML or JSX/TSX file content
- * @returns {Array<{className: string, line: number}>} Array of class usages with line numbers
- */
-export function extractRazorClasses(content) {
-  const usages = [];
-  const lines = content.split('\n');
-
-  lines.forEach((line, index) => {
-    // Match class="..." or class='...'
-    const classAttrRegex = /class\s*=\s*["']([^"']+)["']/gi;
-
-    // Match className="..." (React/Next.js JSX)
-    const componentClassRegex = /\bclassName\s*=\s*["']([^"']+)["']/gi;
-
-    // Match Style with class-like patterns in CSS modules
-    const cssModuleRegex = /styles\.([a-zA-Z_-][a-zA-Z0-9_-]*)/gi;
-
-    for (const regex of [classAttrRegex, componentClassRegex]) {
-      let match;
-      while ((match = regex.exec(line)) !== null) {
-        const classString = match[1];
-
-        // Split by whitespace to get individual classes
-        const classes = classString.split(/\s+/).filter(c => c.length > 0);
-
-        for (const className of classes) {
-          // Skip interpolated strings
-          if (className.includes('{') || className.includes('}')) continue;
-
-          // Skip conditional ternary results (partial matches)
-          if (className === '?' || className === ':') continue;
-
-          usages.push({
-            className: className.trim(),
-            line: index + 1
-          });
-        }
-      }
-    }
-
-    // CSS modules
-    let cssModuleMatch;
-    while ((cssModuleMatch = cssModuleRegex.exec(line)) !== null) {
-      usages.push({
-        className: cssModuleMatch[1],
-        line: index + 1
-      });
-    }
-  });
-
-  return usages;
-}
-
-// ============================================================================
-// VALIDATION
-// ============================================================================
-
-/**
- * Known utility class prefixes from common frameworks
- * These are excluded from validation as they come from external libraries
- */
-const UTILITY_PREFIXES = [
-  // Tailwind CSS
-  'bg-', 'text-', 'font-', 'p-', 'px-', 'py-', 'pt-', 'pb-', 'pl-', 'pr-',
-  'm-', 'mx-', 'my-', 'mt-', 'mb-', 'ml-', 'mr-', 'w-', 'h-', 'min-', 'max-',
-  'flex', 'grid', 'block', 'inline', 'hidden', 'overflow-', 'rounded-',
-  'border-', 'shadow-', 'opacity-', 'z-', 'gap-', 'space-', 'justify-',
-  'items-', 'content-', 'self-', 'col-', 'row-', 'order-', 'animate-',
-  'transition-', 'duration-', 'ease-', 'delay-', 'scale-', 'rotate-',
-  'translate-', 'skew-', 'origin-', 'cursor-', 'select-', 'resize-',
-  'list-', 'appearance-', 'pointer-', 'fill-', 'stroke-', 'object-',
-  'aspect-', 'columns-', 'break-', 'box-', 'float-', 'clear-', 'isolation-',
-  'mix-blend-', 'bg-blend-', 'filter-', 'backdrop-', 'blur-', 'brightness-',
-  'contrast-', 'drop-shadow-', 'grayscale-', 'hue-rotate-', 'invert-',
-  'saturate-', 'sepia-', 'table-', 'caption-', 'border-collapse-', 'outline-',
-  'ring-', 'placeholder-', 'caret-', 'accent-', 'scroll-', 'snap-', 'touch-',
-  'will-change-', 'contain-',
-
-  // Bootstrap
-  'container', 'row', 'col-', 'btn-', 'alert-', 'badge-', 'card-', 'nav-',
-  'navbar-', 'dropdown-', 'modal-', 'form-', 'input-', 'table-', 'list-',
-  'd-', 'align-', 'justify-', 'order-', 'offset-', 'g-', 'gy-', 'gx-',
-
-  // Common framework classes
-  'sr-only', 'not-sr-only', 'disabled', 'active', 'show', 'fade', 'collapse'
-];
-
-/**
- * Check if a class name is a utility class from a known framework
- * @param {string} className - Class name to check
- * @returns {boolean} True if it's a utility class
- */
-function isUtilityClass(className) {
-  return UTILITY_PREFIXES.some(prefix => className.startsWith(prefix));
-}
-
-/**
- * Validate CSS classes in a project directory
- * @param {string} projectPath - Path to the project directory
- * @param {Object} options - Validation options
- * @param {boolean} options.verbose - Show detailed output
- * @param {boolean} options.includeUtilities - Include utility classes in validation
- * @param {string[]} options.cssGlob - Glob patterns for CSS files
- * @param {string[]} options.razorGlob - Glob patterns for HTML/JSX/TSX files
- * @returns {Promise<Object>} Validation results
- */
-export async function validateCssClasses(projectPath, options = {}) {
-  const {
-    verbose = false,
-    includeUtilities = false,
-    cssGlob = ['**/*.css'],
-    razorGlob = ['**/*.html', '**/*.jsx', '**/*.tsx']
-  } = options;
-
-  // Find all CSS files
-  const cssFiles = [];
-  for (const pattern of cssGlob) {
-    const files = await glob(pattern, {
-      cwd: projectPath,
-      ignore: ['**/node_modules/**', '**/bin/**', '**/obj/**', '**/dist/**', '**/.next/**']
-    });
-    cssFiles.push(...files);
-  }
-
-  // Find all source files (HTML/JSX/TSX)
-  const razorFiles = [];
-  for (const pattern of razorGlob) {
-    const files = await glob(pattern, {
-      cwd: projectPath,
-      ignore: ['**/node_modules/**', '**/bin/**', '**/obj/**']
-    });
-    razorFiles.push(...files);
-  }
-
-  // Extract all defined CSS classes
-  const definedClasses = new Set();
-  const cssFileDetails = [];
-
-  for (const file of cssFiles) {
-    const fullPath = join(projectPath, file);
-    if (!existsSync(fullPath)) continue;
-
-    const content = readFileSync(fullPath, 'utf8');
-    const classes = extractCssClasses(content);
-
-    cssFileDetails.push({
-      file,
-      classCount: classes.size
-    });
-
-    for (const cls of classes) {
-      definedClasses.add(cls);
-    }
-  }
-
-  // Extract all used CSS classes from source files
-  const usedClasses = new Map(); // className -> [{file, line}]
-  const razorFileDetails = [];
-
-  for (const file of razorFiles) {
-    const fullPath = join(projectPath, file);
-    if (!existsSync(fullPath)) continue;
-
-    const content = readFileSync(fullPath, 'utf8');
-    const usages = extractRazorClasses(content);
-
-    razorFileDetails.push({
-      file,
-      usageCount: usages.length
-    });
-
-    for (const usage of usages) {
-      if (!usedClasses.has(usage.className)) {
-        usedClasses.set(usage.className, []);
-      }
-      usedClasses.get(usage.className).push({
-        file,
-        line: usage.line
-      });
-    }
-  }
-
-  // Find missing classes
-  const missingClasses = [];
-
-  for (const [className, locations] of usedClasses) {
-    // Skip utility classes unless explicitly included
-    if (!includeUtilities && isUtilityClass(className)) continue;
-
-    // Skip if class is defined
-    if (definedClasses.has(className)) continue;
-
-    missingClasses.push({
-      className,
-      locations
-    });
-  }
-
-  // Sort missing classes by number of usages (most used first)
-  missingClasses.sort((a, b) => b.locations.length - a.locations.length);
-
-  return {
-    summary: {
-      cssFilesScanned: cssFiles.length,
-      razorFilesScanned: razorFiles.length,
-      definedClasses: definedClasses.size,
-      usedClasses: usedClasses.size,
-      missingClasses: missingClasses.length
-    },
-    cssFiles: cssFileDetails,
-    razorFiles: razorFileDetails,
-    definedClasses: Array.from(definedClasses).sort(),
-    missingClasses,
-    valid: missingClasses.length === 0
-  };
-}
-
-/**
- * Format validation results for CLI output
- * @param {Object} results - Validation results from validateCssClasses
- * @param {boolean} verbose - Show detailed output
- * @returns {string} Formatted output
- */
-export function formatValidationResults(results, verbose = false) {
-  const lines = [];
-
-  // Header
-  lines.push('');
-  lines.push('CSS Validation Results');
-  lines.push('='.repeat(50));
-  lines.push('');
-
-  // Summary
-  lines.push(`CSS files scanned:   ${results.summary.cssFilesScanned}`);
-  lines.push(`Source files scanned: ${results.summary.razorFilesScanned}`);
-  lines.push(`Classes defined:     ${results.summary.definedClasses}`);
-  lines.push(`Classes used:        ${results.summary.usedClasses}`);
-  lines.push(`Missing classes:     ${results.summary.missingClasses}`);
-  lines.push('');
-
-  if (results.valid) {
-    lines.push('All CSS classes are defined.');
-    return lines.join('\n');
-  }
-
-  // Missing classes
-  lines.push('Missing CSS Classes:');
-  lines.push('-'.repeat(50));
-
-  for (const missing of results.missingClasses) {
-    lines.push(`\n  .${missing.className}`);
-
-    if (verbose) {
-      for (const loc of missing.locations) {
-        lines.push(`    - ${loc.file}:${loc.line}`);
-      }
-    } else {
-      // Show first 3 locations
-      const shown = missing.locations.slice(0, 3);
-      for (const loc of shown) {
-        lines.push(`    - ${loc.file}:${loc.line}`);
-      }
-      if (missing.locations.length > 3) {
-        lines.push(`    ... and ${missing.locations.length - 3} more`);
-      }
-    }
-  }
-
-  lines.push('');
-
-  return lines.join('\n');
-}
-
-/**
- * Generate a CSS stub file with missing class definitions
- * @param {Object} results - Validation results
- * @returns {string} CSS file content with stub classes
- */
-export function generateCssStub(results) {
-  if (results.valid) {
-    return '/* No missing classes */';
-  }
-
-  const lines = [
-    '/* ==========================================================================',
-    '   MISSING CSS CLASSES - Generated by MORPH-SPEC validate-css',
-    '   Add these classes to your design-system.css or appropriate CSS file',
-    '   ========================================================================== */',
-    ''
-  ];
-
-  for (const missing of results.missingClasses) {
-    lines.push(`/* Used in: ${missing.locations.map(l => `${l.file}:${l.line}`).slice(0, 3).join(', ')}${missing.locations.length > 3 ? '...' : ''} */`);
-    lines.push(`.${missing.className} {`);
-    lines.push('  /* TODO: Add styles */');
-    lines.push('}');
-    lines.push('');
-  }
-
-  return lines.join('\n');
-}

package/src/lib/validators/css/index.js

@@ -1,7 +0,0 @@
-/**
- * CSS Validators
- *
- * CSS validation and design system compliance.
- */
-
-export * from './css-validator.js';