@paths.design/caws-cli 10.2.0 → 11.1.0

package/dist/commands/quality-monitor.js

@@ -1,284 +0,0 @@
-/**
- * CAWS Quality Monitor Command
- *
- * Monitors code quality impact in real-time based on development actions.
- * Provides actionable recommendations for maintaining quality standards.
- *
- * @author @darianrosebrook
- */
-
-const chalk = require('chalk');
-const path = require('path');
-const { resolveSpec } = require('../utils/spec-resolver');
-
-/**
- * Analyze quality impact of an action
- *
- * @param {string} action - Type of action (file_saved, code_edited, test_run)
- * @param {array} files - Files affected by the action
- * @param {object} context - Additional context information
- * @returns {object} Quality analysis
- */
-function analyzeQualityImpact(action, files = [], context = {}) {
-  const analysis = {
-    action,
-    files_affected: files?.length || 0,
-    quality_impact: 'unknown',
-    recommendations: [],
-    risk_level: 'low',
-    timestamp: new Date().toISOString(),
-  };
-
-  // Analyze based on action type
-  switch (action) {
-    case 'file_saved':
-      analysis.quality_impact = 'code_change';
-      analysis.recommendations = [
-        'Run CAWS validation: caws evaluate',
-        'Check for linting issues',
-        'Verify test coverage if applicable',
-      ];
-      break;
-
-    case 'code_edited':
-      analysis.quality_impact = 'implementation_change';
-      analysis.recommendations = [
-        'Run unit tests for affected files',
-        'Check CAWS quality gates',
-        'Update documentation if public APIs changed',
-      ];
-      analysis.risk_level = files?.length > 5 ? 'medium' : 'low';
-
-      // Add file-specific recommendations
-      if (files.length > 0) {
-        const hasTests = files.some((f) => f.includes('test') || f.includes('spec'));
-        const hasConfig = files.some((f) => f.includes('config') || f.includes('.json'));
-
-        if (hasTests) {
-          analysis.recommendations.push('Run full test suite to ensure consistency');
-        }
-        if (hasConfig) {
-          analysis.risk_level = 'high';
-          analysis.recommendations.unshift('Configuration changed - validate carefully');
-        }
-      }
-      break;
-
-    case 'test_run':
-      analysis.quality_impact = 'validation_complete';
-      analysis.recommendations = [
-        'Review test results',
-        'Address any failing tests',
-        'Update CAWS working spec if needed',
-      ];
-      break;
-
-    default:
-      analysis.quality_impact = 'unknown_action';
-      analysis.recommendations = ['Run CAWS evaluation to assess impact'];
-  }
-
-  // Add context-based recommendations
-  if (context.project_tier) {
-    analysis.project_tier = context.project_tier;
-  }
-
-  return analysis;
-}
-
-/**
- * Enrich analysis with project tier and resolved spec metadata.
- * @param {Object} analysis
- * @param {Object|null} resolvedSpec
- * @returns {Object}
- */
-function applySpecContext(analysis, resolvedSpec) {
-  if (!resolvedSpec?.spec) {
-    return analysis;
-  }
-
-  const projectTier = resolvedSpec.spec.risk_tier;
-  analysis.project_tier = projectTier;
-  analysis.spec_id = resolvedSpec.spec.id || null;
-  analysis.spec_path = resolvedSpec.path
-    ? path.relative(process.cwd(), resolvedSpec.path)
-    : null;
-
-  if (projectTier <= 2) {
-    analysis.recommendations.unshift(
-      'High-risk project (Tier ' + projectTier + '): Run comprehensive validation'
-    );
-    if (analysis.risk_level === 'low') {
-      analysis.risk_level = 'medium';
-    } else if (analysis.risk_level === 'medium') {
-      analysis.risk_level = 'high';
-    }
-  }
-
-  if (projectTier === 1) {
-    analysis.quality_gates = [
-      'Branch coverage ≥ 90%',
-      'Mutation score ≥ 70%',
-      'All contract tests passing',
-      'Manual code review required',
-    ];
-  } else if (projectTier === 2) {
-    analysis.quality_gates = [
-      'Branch coverage ≥ 80%',
-      'Mutation score ≥ 50%',
-      'Contract tests passing (if applicable)',
-    ];
-  } else {
-    analysis.quality_gates = ['Branch coverage ≥ 70%', 'Mutation score ≥ 30%'];
-  }
-
-  return analysis;
-}
-
-/**
- * Quality monitor command handler
- *
- * @param {string} action - Type of action to monitor
- * @param {object} options - Command options
- */
-async function qualityMonitorCommand(action, options = {}) {
-  try {
-    // Parse files if provided
-    let files = [];
-    if (options.files) {
-      files =
-        typeof options.files === 'string'
-          ? options.files.split(',').map((f) => f.trim())
-          : options.files;
-    }
-
-    // Parse context if provided
-    let context = {};
-    if (options.context) {
-      try {
-        context =
-          typeof options.context === 'string' ? JSON.parse(options.context) : options.context;
-      } catch (e) {
-        console.warn(chalk.yellow('Invalid context JSON, ignoring'));
-      }
-    }
-
-    // Validate action
-    const validActions = ['file_saved', 'code_edited', 'test_run'];
-    if (!validActions.includes(action)) {
-      console.error(chalk.red(`\nInvalid action: ${action}`));
-      console.log(chalk.blue('\nValid actions:'));
-      validActions.forEach((a) => {
-        console.log(chalk.blue(`   - ${a}`));
-      });
-      process.exit(1);
-    }
-
-    // Analyze quality impact
-    let analysis = analyzeQualityImpact(action, files, context);
-
-    try {
-      const resolved = await resolveSpec({
-        specId: options.specId,
-        warnLegacy: false,
-        interactive: false,
-      });
-      analysis = applySpecContext(analysis, resolved);
-    } catch {
-      // Best-effort enrichment only
-    }
-
-    // Display results
-    console.log(chalk.bold('\nCAWS Quality Monitor\n'));
-    console.log('-'.repeat(60));
-
-    // Action info
-    console.log(chalk.bold(`\nAction: ${action}`));
-    console.log(chalk.gray(`Time: ${new Date(analysis.timestamp).toLocaleString()}`));
-
-    if (analysis.files_affected > 0) {
-      console.log(chalk.bold(`\nFiles Affected: ${analysis.files_affected}`));
-      if (files.length > 0 && files.length <= 10) {
-        files.forEach((file) => {
-          console.log(chalk.gray(`   - ${file}`));
-        });
-      } else if (files.length > 10) {
-        files.slice(0, 10).forEach((file) => {
-          console.log(chalk.gray(`   - ${file}`));
-        });
-        console.log(chalk.gray(`   ... and ${files.length - 10} more`));
-      }
-    }
-
-    // Quality impact
-    const impactColor =
-      analysis.quality_impact === 'validation_complete'
-        ? chalk.green
-        : analysis.quality_impact === 'code_change'
-          ? chalk.yellow
-          : chalk.blue;
-
-    console.log(chalk.bold('\nQuality Impact:'));
-    console.log(impactColor(`   ${analysis.quality_impact}`));
-
-    // Risk level
-    const riskColor =
-      analysis.risk_level === 'high'
-        ? chalk.red
-        : analysis.risk_level === 'medium'
-          ? chalk.yellow
-          : chalk.green;
-
-    console.log(chalk.bold('\nRisk Level:'));
-    console.log(riskColor(`   ${analysis.risk_level.toUpperCase()}`));
-
-    // Project tier
-    if (analysis.project_tier) {
-      console.log(chalk.bold(`\nProject Tier: ${analysis.project_tier}`));
-      if (analysis.spec_id) {
-        console.log(chalk.gray(`Spec: ${analysis.spec_id}${analysis.spec_path ? ` (${analysis.spec_path})` : ''}`));
-      }
-    }
-
-    // Quality gates
-    if (analysis.quality_gates && analysis.quality_gates.length > 0) {
-      console.log(chalk.bold('\nQuality Gates to Check:\n'));
-      analysis.quality_gates.forEach((gate) => {
-        console.log(chalk.gray(`   □ ${gate}`));
-      });
-    }
-
-    // Recommendations
-    console.log(chalk.bold('\nRecommendations:\n'));
-    analysis.recommendations.forEach((rec, idx) => {
-      const icon = idx === 0 ? '' : '  -';
-      console.log(chalk.blue(`   ${icon} ${rec}`));
-    });
-
-    // Suggested commands
-    console.log(chalk.bold('\nSuggested Commands:\n'));
-    switch (action) {
-      case 'file_saved':
-      case 'code_edited':
-        console.log(chalk.gray('   caws evaluate       - Check quality score'));
-        console.log(chalk.gray('   caws validate       - Run validation'));
-        console.log(chalk.gray('   caws diagnose       - Health check'));
-        break;
-      case 'test_run':
-        console.log(chalk.gray('   caws status         - Project status'));
-        console.log(chalk.gray('   caws iterate        - Next steps'));
-        break;
-    }
-
-    console.log('\n' + '-'.repeat(60) + '\n');
-  } catch (error) {
-    console.error(chalk.red(`\nQuality monitoring failed: ${error.message}`));
-    console.error(chalk.gray(error.stack));
-    process.exit(1);
-  }
-}
-
-module.exports = {
-  qualityMonitorCommand,
-  analyzeQualityImpact,
-};

package/dist/commands/scope.js

@@ -1,264 +0,0 @@
-/**
- * @fileoverview CAWS Scope CLI Command
- * Inspects and displays effective scope boundaries for the current context
- * @author @darianrosebrook
- */
-
-const chalk = require('chalk');
-const path = require('path');
-const fs = require('fs-extra');
-const yaml = require('js-yaml');
-const {
-  getRepoRoot,
-  loadRegistry,
-  findFeatureSpecPath,
-  WORKTREES_DIR,
-} = require('../worktree/worktree-manager');
-
-/**
- * Handle scope subcommands
- * @param {string} subcommand - Subcommand name
- * @param {Object} options - Command options
- */
-async function scopeCommand(subcommand, options = {}) {
-  try {
-    switch (subcommand) {
-      case 'show':
-        return handleShow(options);
-      default:
-        console.error(chalk.red(`Unknown scope subcommand: ${subcommand}`));
-        console.log(chalk.blue('Available: show'));
-        process.exit(1);
-    }
-  } catch (error) {
-    console.error(chalk.red(`${error.message}`));
-    process.exit(1);
-  }
-}
-
-/**
- * Detect if current working directory is inside a worktree
- * @param {string} root - Repository root
- * @returns {{ inWorktree: boolean, worktreeName: string|null }}
- */
-function detectWorktreeContext(root) {
-  const cwd = process.cwd();
-  const worktreesBase = path.join(root, WORKTREES_DIR);
-
-  if (!cwd.startsWith(worktreesBase + path.sep) && cwd !== worktreesBase) {
-    return { inWorktree: false, worktreeName: null };
-  }
-
-  // Extract worktree name: first path segment after the worktrees dir
-  const relative = path.relative(worktreesBase, cwd);
-  const worktreeName = relative.split(path.sep)[0];
-
-  if (!worktreeName) {
-    return { inWorktree: false, worktreeName: null };
-  }
-
-  return { inWorktree: true, worktreeName };
-}
-
-/**
- * Load a spec file and return its parsed contents
- * @param {string} specPath - Absolute path to spec YAML
- * @returns {Object|null}
- */
-function loadSpec(specPath) {
-  try {
-    if (!fs.existsSync(specPath)) return null;
-    const content = fs.readFileSync(specPath, 'utf8');
-    return yaml.load(content);
-  } catch {
-    return null;
-  }
-}
-
-/**
- * Find all active spec files in .caws/specs/
- * @param {string} root - Repository root
- * @returns {Array<{ id: string, path: string, data: Object }>}
- */
-function findAllActiveSpecs(root) {
-  const specsDir = path.join(root, '.caws', 'specs');
-  if (!fs.existsSync(specsDir)) return [];
-
-  const files = fs.readdirSync(specsDir).filter(f => f.endsWith('.yaml') || f.endsWith('.yml'));
-  const specs = [];
-
-  for (const file of files) {
-    const specPath = path.join(specsDir, file);
-    const data = loadSpec(specPath);
-    if (!data) continue;
-
-    // Skip closed/archived specs
-    const status = (data.status || '').toLowerCase();
-    if (status === 'closed' || status === 'archived') continue;
-
-    const id = path.basename(file, path.extname(file));
-    specs.push({ id, path: specPath, data });
-  }
-
-  return specs;
-}
-
-/**
- * Print scope patterns for a spec
- * @param {Object} data - Parsed spec YAML
- * @param {string} indent - Indentation prefix
- */
-function printScopePatterns(data, indent = '   ') {
-  const scope = data.scope || {};
-  const scopeIn = scope.in || scope.include || [];
-  const scopeOut = scope.out || scope.exclude || [];
-
-  if (scopeIn.length > 0) {
-    console.log(chalk.green(`${indent}scope.in:`));
-    for (const pattern of scopeIn) {
-      console.log(chalk.gray(`${indent}  - ${pattern}`));
-    }
-  } else {
-    console.log(chalk.yellow(`${indent}scope.in: (none defined)`));
-  }
-
-  if (scopeOut.length > 0) {
-    console.log(chalk.red(`${indent}scope.out:`));
-    for (const pattern of scopeOut) {
-      console.log(chalk.gray(`${indent}  - ${pattern}`));
-    }
-  } else {
-    console.log(chalk.gray(`${indent}scope.out: (none)`));
-  }
-}
-
-/**
- * Handle the 'show' subcommand
- * @param {Object} options - Command options
- */
-function handleShow(_options) {
-  const root = getRepoRoot();
-  const { inWorktree, worktreeName } = detectWorktreeContext(root);
-
-  console.log(chalk.bold.cyan('CAWS Scope Inspector'));
-  console.log(chalk.cyan('='.repeat(50)));
-  console.log('');
-
-  if (inWorktree) {
-    return handleAuthoritativeMode(root, worktreeName);
-  } else {
-    return handleUnionMode(root);
-  }
-}
-
-/**
- * Handle authoritative mode: agent is inside a worktree with a bound spec
- * @param {string} root - Repository root
- * @param {string} worktreeName - Name of the worktree
- */
-function handleAuthoritativeMode(root, worktreeName) {
-  console.log(chalk.white(`Worktree: ${chalk.bold(worktreeName)}`));
-
-  const registry = loadRegistry(root);
-  const entry = registry.worktrees ? registry.worktrees[worktreeName] : null;
-
-  if (!entry) {
-    console.log(chalk.red(`Worktree '${worktreeName}' not found in registry.`));
-    console.log(chalk.yellow('The scope guard is operating in union mode (all active specs).'));
-    return handleUnionMode(root);
-  }
-
-  const specId = entry.specId;
-
-  if (!specId) {
-    console.log(chalk.yellow('Mode: union (no spec bound to this worktree)'));
-    console.log('');
-    console.log(chalk.yellow('This worktree has no spec binding. The scope guard checks'));
-    console.log(chalk.yellow('against the union of all active specs.'));
-    console.log('');
-    console.log(chalk.blue('To bind a spec: caws worktree bind <spec-id>'));
-    console.log('');
-    return handleUnionMode(root);
-  }
-
-  // Load the spec
-  const specPath = findFeatureSpecPath(root, specId);
-  if (!specPath) {
-    console.log(chalk.red(`Bound spec '${specId}' not found on disk.`));
-    console.log(chalk.yellow('Fix: recreate the spec or rebind with a valid spec ID.'));
-    console.log(chalk.blue(`  caws worktree bind <valid-spec-id>`));
-    return;
-  }
-
-  const specData = loadSpec(specPath);
-  if (!specData) {
-    console.log(chalk.red(`Failed to parse spec file: ${specPath}`));
-    return;
-  }
-
-  console.log(chalk.green(`Mode: authoritative (single bound spec)`));
-  console.log(chalk.white(`Spec: ${chalk.bold(specId)}`));
-  if (specData.title) {
-    console.log(chalk.gray(`Title: ${specData.title}`));
-  }
-  console.log('');
-
-  // Print scope patterns
-  printScopePatterns(specData);
-  console.log('');
-
-  // Check binding health: mutual reference
-  const specWorktreeRef = specData.worktree || null;
-  const registrySpecRef = specId;
-
-  if (specWorktreeRef !== worktreeName) {
-    console.log(chalk.yellow('Binding health: BROKEN'));
-    console.log(chalk.yellow(`  Registry points to spec '${registrySpecRef}'`));
-    console.log(chalk.yellow(`  Spec 'worktree' field: ${specWorktreeRef || '(missing)'} (expected: ${worktreeName})`));
-    console.log('');
-    console.log(chalk.blue(`Fix: caws worktree bind ${specId}`));
-  } else {
-    console.log(chalk.green('Binding health: OK'));
-    console.log(chalk.gray(`  Registry -> spec: ${registrySpecRef}`));
-    console.log(chalk.gray(`  Spec -> worktree: ${specWorktreeRef}`));
-  }
-}
-
-/**
- * Handle union mode: no worktree or no spec binding
- * @param {string} root - Repository root
- */
-function handleUnionMode(root) {
-  const specs = findAllActiveSpecs(root);
-
-  if (specs.length === 0) {
-    console.log(chalk.gray('Mode: union (no active specs found)'));
-    console.log('');
-    console.log(chalk.gray('No active feature specs in .caws/specs/.'));
-    console.log(chalk.gray('The scope guard has no patterns to enforce.'));
-    console.log('');
-    console.log(chalk.blue('Create a spec: caws specs create <id> --title "description"'));
-    return;
-  }
-
-  console.log(chalk.white('Mode: union (checking all active specs)'));
-  console.log(chalk.gray(`Active specs: ${specs.length}`));
-  console.log('');
-
-  for (const spec of specs) {
-    const statusLabel = spec.data.status || 'draft';
-    console.log(chalk.white(`  ${chalk.bold(spec.id)} [${statusLabel}]`));
-    if (spec.data.title) {
-      console.log(chalk.gray(`  Title: ${spec.data.title}`));
-    }
-    printScopePatterns(spec.data, '    ');
-
-    // Check if this spec has a worktree binding
-    if (spec.data.worktree) {
-      console.log(chalk.gray(`    worktree: ${spec.data.worktree}`));
-    }
-    console.log('');
-  }
-}
-
-module.exports = { scopeCommand };