@paths.design/caws-cli 10.1.0 → 11.0.0

package/dist/utils/quality-gates-utils.js

@@ -1,387 +0,0 @@
-/**
- * CAWS Quality Gate Utilities
- *
- * Reusable quality gate scripts for CAWS projects.
- * Provides staged file analysis, god object detection, and TODO analysis.
- *
- * @author @darianrosebrook
- */
-
-const fs = require('fs');
-const path = require('path');
-const yaml = require('js-yaml');
-const { execSync } = require('child_process');
-const { getTodoAnalyzerSuggestion } = require('./project-analysis');
-
-/**
- * Quality Gate Configuration
- */
-const CONFIG = {
-  godObjectThresholds: {
-    warning: 1750,
-    critical: 2000,
-  },
-  todoConfidenceThreshold: 0.8,
-  supportedExtensions: ['.rs', '.ts', '.tsx', '.js', '.jsx', '.py'],
-  crisisResponseThresholds: {
-    godObjectCritical: 3000,
-    todoConfidenceThreshold: 0.9,
-  },
-};
-
-/**
- * Detect if project is in crisis response mode
- * @returns {boolean} True if in crisis mode
- */
-function detectCrisisMode() {
-  try {
-    const crisisIndicators = [
-      // Check for crisis response in any active spec (feature specs then legacy)
-      () => {
-        // Check feature specs first
-        const specsDir = path.join(process.cwd(), '.caws/specs');
-        if (fs.existsSync(specsDir)) {
-          try {
-            const files = fs.readdirSync(specsDir).filter(f => f.endsWith('.yaml') || f.endsWith('.yml'));
-            for (const file of files) {
-              const spec = yaml.load(fs.readFileSync(path.join(specsDir, file), 'utf8'));
-              if (spec && (spec.mode === 'crisis' || spec.crisis_mode === true)) {
-                return true;
-              }
-            }
-          } catch {
-            // Fall through to legacy check
-          }
-        }
-        // Legacy fallback
-        const legacyPath = path.join(process.cwd(), '.caws/working-spec.yaml');
-        if (fs.existsSync(legacyPath)) {
-          try {
-            const spec = yaml.load(fs.readFileSync(legacyPath, 'utf8'));
-            return spec.mode === 'crisis' || spec.crisis_mode === true;
-          } catch {
-            // Ignore
-          }
-        }
-        return false;
-      },
-      // Check for crisis response in environment
-      () => process.env.CAWS_CRISIS_MODE === 'true',
-      // Check for crisis response in git commit message
-      () => {
-        try {
-          const lastCommit = execSync('git log -1 --pretty=%B', { encoding: 'utf8' });
-          return (
-            lastCommit.toLowerCase().includes('crisis') ||
-            lastCommit.toLowerCase().includes('emergency')
-          );
-        } catch {
-          return false;
-        }
-      },
-    ];
-
-    return crisisIndicators.some((indicator) => indicator());
-  } catch (error) {
-    return false;
-  }
-}
-
-/**
- * Get staged files from git
- * @returns {string[]} Array of staged file paths
- */
-function getStagedFiles() {
-  try {
-    const stagedFiles = execSync('git diff --cached --name-only', {
-      encoding: 'utf8',
-      stdio: ['ignore', 'pipe', 'pipe'],
-    })
-      .trim()
-      .split('\n')
-      .filter((file) => file.trim() !== '');
-
-    return stagedFiles;
-  } catch (error) {
-    console.warn(`Could not get staged files: ${error.message}`);
-    return [];
-  }
-}
-
-/**
- * Check for god objects in staged files
- * @param {string[]} stagedFiles - Array of staged file paths
- * @param {string} language - Language to check ('rust', 'typescript', etc.)
- * @returns {Object} God object analysis results
- */
-function checkGodObjects(stagedFiles, language = 'rust') {
-  const extension =
-    language === 'rust'
-      ? '.rs'
-      : language === 'typescript'
-        ? '.ts'
-        : language === 'javascript'
-          ? '.js'
-          : '.py';
-
-  const files = stagedFiles.filter((file) => file.endsWith(extension));
-
-  if (files.length === 0) {
-    return { violations: [], warnings: [], total: 0 };
-  }
-
-  console.log(`Found ${files.length} staged ${language} files to check`);
-
-  const violations = [];
-  const warnings = [];
-
-  for (const file of files) {
-    try {
-      const fullPath = path.resolve(file);
-      if (!fs.existsSync(fullPath)) continue;
-
-      const content = fs.readFileSync(fullPath, 'utf8');
-      const lineCount = content.split('\n').length;
-
-      if (lineCount >= CONFIG.godObjectThresholds.critical) {
-        violations.push({
-          file,
-          lines: lineCount,
-          severity: 'critical',
-          message: `CRITICAL: ${lineCount} LOC exceeds god object threshold (${CONFIG.godObjectThresholds.critical}+ LOC)`,
-        });
-      } else if (lineCount >= CONFIG.godObjectThresholds.warning) {
-        warnings.push({
-          file,
-          lines: lineCount,
-          severity: 'warning',
-          message: `WARNING: ${lineCount} LOC approaches god object territory (${CONFIG.godObjectThresholds.warning}+ LOC)`,
-        });
-      }
-    } catch (error) {
-      console.warn(`Could not analyze ${file}: ${error.message}`);
-    }
-  }
-
-  return { violations, warnings, total: violations.length + warnings.length };
-}
-
-/**
- * Check for hidden TODOs in staged files
- * @param {string[]} stagedFiles - Array of staged file paths
- * @returns {Object} TODO analysis results
- */
-function checkHiddenTodos(stagedFiles) {
-  const supportedFiles = stagedFiles.filter((file) =>
-    CONFIG.supportedExtensions.some((ext) => file.endsWith(ext))
-  );
-
-  if (supportedFiles.length === 0) {
-    return { todos: [], blocking: 0, total: 0 };
-  }
-
-  console.log(`Found ${supportedFiles.length} staged files to analyze for TODOs`);
-
-  try {
-    // Find TODO analyzer .mjs file (preferred - no Python dependency)
-    const possiblePaths = [
-      // Published npm package (priority)
-      path.join(
-        process.cwd(),
-        'node_modules',
-        '@paths.design',
-        'quality-gates',
-        'todo-analyzer.mjs'
-      ),
-      // Legacy monorepo local copy
-      path.join(process.cwd(), 'node_modules', '@caws', 'quality-gates', 'todo-analyzer.mjs'),
-      // Monorepo structure (development)
-      path.join(process.cwd(), 'packages', 'quality-gates', 'todo-analyzer.mjs'),
-      // Local copy in scripts directory (if scaffolded)
-      path.join(process.cwd(), 'scripts', 'todo-analyzer.mjs'),
-      // Legacy Python analyzer (deprecated)
-      path.join(process.cwd(), 'scripts', 'v3', 'analysis', 'todo_analyzer.py'),
-    ];
-
-    let analyzerPath = null;
-    let usePython = false;
-
-    for (const testPath of possiblePaths) {
-      if (fs.existsSync(testPath)) {
-        analyzerPath = testPath;
-        usePython = testPath.endsWith('.py');
-        break;
-      }
-    }
-
-    if (!analyzerPath) {
-      console.warn('TODO analyzer not found - skipping TODO analysis');
-      const suggestion = getTodoAnalyzerSuggestion(process.cwd());
-      console.warn('Available options for TODO analysis:');
-      console.warn(suggestion);
-      return { todos: [], blocking: 0, total: 0 };
-    }
-
-    if (usePython) {
-      console.warn('Using legacy Python TODO analyzer (deprecated)');
-      const suggestion = getTodoAnalyzerSuggestion(process.cwd());
-      console.warn('Consider upgrading to Node.js version:');
-      console.warn(suggestion);
-    }
-
-    // Run the TODO analyzer with staged files
-    const command = usePython
-      ? `python3 ${analyzerPath} --staged-only --min-confidence ${CONFIG.todoConfidenceThreshold}`
-      : `node ${analyzerPath} --staged-only --ci-mode --min-confidence ${CONFIG.todoConfidenceThreshold}`;
-
-    const result = execSync(command, { encoding: 'utf8', cwd: process.cwd() });
-
-    // Parse the output to extract TODO count
-    const lines = result.split('\n');
-    const summaryLine = lines.find((line) => line.includes('Total hidden TODOs:'));
-    const todoCount = summaryLine ? parseInt(summaryLine.split(':')[1].trim()) : 0;
-
-    return {
-      todos: [],
-      blocking: todoCount,
-      total: todoCount,
-      details: result,
-    };
-  } catch (error) {
-    console.warn(`Could not run TODO analysis: ${error.message}`);
-    return { todos: [], blocking: 0, total: 0 };
-  }
-}
-
-/**
- * Run comprehensive quality gates on staged files
- * @param {Object} options - Options for quality gates
- * @returns {Object} Quality gate results
- */
-function runQualityGates(options = {}) {
-  const { languages = ['rust'], checkTodos = true, checkGodObjects = true, ci = false } = options;
-
-  console.log(`Running Quality Gates${ci ? ' (CI Mode)' : ' - Crisis Response Mode'}`);
-  console.log('==================================================');
-
-  // Get staged files
-  const stagedFiles = getStagedFiles();
-
-  if (stagedFiles.length === 0) {
-    console.log('No staged files to analyze');
-    return { passed: true, violations: [], warnings: [] };
-  }
-
-  console.log(`Analyzing ${stagedFiles.length} staged files`);
-
-  const results = {
-    passed: true,
-    violations: [],
-    warnings: [],
-    todos: 0,
-  };
-
-  // Check naming conventions
-  console.log('\nChecking naming conventions...');
-  console.log('   Naming conventions check passed');
-
-  // Check code freeze compliance
-  console.log('\nChecking code freeze compliance...');
-  console.log('   Code freeze compliance check passed');
-
-  // Check duplication
-  console.log('\nChecking duplication...');
-  console.log('   No duplication regression detected');
-
-  // Check god objects for each language
-  if (checkGodObjects) {
-    for (const language of languages) {
-      console.log(`\nChecking god objects (${language})...`);
-      const godObjectResults = checkGodObjects(stagedFiles, language);
-
-      results.violations.push(...godObjectResults.violations);
-      results.warnings.push(...godObjectResults.warnings);
-
-      if (godObjectResults.violations.length > 0) {
-        console.log('   God object violations detected:');
-        godObjectResults.violations.forEach((violation) => {
-          console.log(`      ${violation.file}: ${violation.message}`);
-        });
-      } else {
-        console.log('   No blocking god object violations');
-      }
-
-      if (godObjectResults.warnings.length > 0) {
-        console.log('   God object warnings:');
-        godObjectResults.warnings.forEach((warning) => {
-          console.log(`      ${warning.file}: ${warning.message}`);
-        });
-      }
-    }
-  }
-
-  // Check hidden TODOs
-  if (checkTodos) {
-    console.log('\nChecking hidden TODOs...');
-    const todoResults = checkHiddenTodos(stagedFiles);
-    results.todos = todoResults.total;
-
-    if (todoResults.total > 0) {
-      console.log(`   Found ${todoResults.total} hidden TODOs in staged files`);
-      console.log('   Fix stub implementations and placeholder code before committing');
-      console.log('   See docs/PLACEHOLDER-DETECTION-GUIDE.md for classification');
-    } else {
-      console.log('   No critical hidden TODOs found in staged files');
-    }
-  }
-
-  // Summary
-  console.log('\n==================================================');
-  console.log('QUALITY GATES RESULTS');
-  console.log('==================================================');
-
-  const totalViolations = results.violations.length;
-  const totalWarnings = results.warnings.length;
-  const totalTodos = results.todos;
-
-  if (totalViolations > 0) {
-    console.log(`\nCRITICAL VIOLATIONS (${totalViolations}):`);
-    results.violations.forEach((violation) => {
-      console.log(`   ${violation.file}: ${violation.message}`);
-    });
-    results.passed = false;
-  }
-
-  if (totalWarnings > 0) {
-    console.log(`\nWARNINGS (${totalWarnings}):`);
-    results.warnings.forEach((warning) => {
-      console.log(`   ${warning.file}: ${warning.message}`);
-    });
-  }
-
-  if (totalTodos > 0) {
-    console.log(`\nHIDDEN TODOS (${totalTodos}):`);
-    console.log(`   Found ${totalTodos} hidden TODOs in staged files`);
-    results.passed = false;
-  }
-
-  // Final result
-  if (results.passed) {
-    console.log('\nALL QUALITY GATES PASSED');
-    console.log('Commit allowed - quality maintained!');
-  } else {
-    console.log('\nQUALITY GATES FAILED');
-    console.log('Commit blocked - fix violations above');
-  }
-
-  return results;
-}
-
-module.exports = {
-  getStagedFiles,
-  checkGodObjects,
-  checkHiddenTodos,
-  detectCrisisMode,
-  runQualityGates,
-  CONFIG,
-};

package/dist/utils/schema-validator.js

@@ -1,50 +0,0 @@
-const Ajv = require('ajv');
-const fs = require('fs-extra');
-const path = require('path');
-
-const ajv = new Ajv({ allErrors: true, allowUnionTypes: true, strict: false, validateFormats: false });
-const cache = new Map();
-
-function createValidator(schemaPath) {
-  const resolved = path.resolve(schemaPath);
-  if (cache.has(resolved)) return cache.get(resolved);
-  let schema;
-  try {
-    schema = JSON.parse(fs.readFileSync(resolved, 'utf8'));
-  } catch (err) {
-    throw new Error(`Failed to parse schema file ${resolved}: ${err.message}`);
-  }
-  // Remove $schema keyword — Ajv handles validation without it and
-  // the 2020-12 meta-schema URI is not bundled with the base Ajv package.
-  delete schema.$schema;
-  const validate = ajv.compile(schema);
-  const validator = (data) => {
-    const valid = validate(data);
-    return {
-      valid,
-      errors: valid ? [] : validate.errors.map(e => ({
-        path: e.instancePath,
-        message: e.message,
-        params: e.params,
-      })),
-    };
-  };
-  cache.set(resolved, validator);
-  return validator;
-}
-
-function getSchemaPath(schemaName, projectRoot) {
-  // Order: flat repo layout (`.caws/<name>.schema.json`) wins so
-  // repos that tightened a schema in-place (e.g. CAWSFIX-03) are
-  // the authoritative source. Nested `.caws/schemas/<name>.schema.json`
-  // is the legacy layout kept for back-compat. Bundled template is
-  // the last-resort fallback used by globally-installed CLIs and
-  // projects without a local copy.
-  const flatPath = path.join(projectRoot, '.caws', schemaName);
-  if (fs.existsSync(flatPath)) return flatPath;
-  const nestedPath = path.join(projectRoot, '.caws', 'schemas', schemaName);
-  if (fs.existsSync(nestedPath)) return nestedPath;
-  return path.join(__dirname, '../../templates/.caws/schemas', schemaName);
-}
-
-module.exports = { createValidator, getSchemaPath };