@paths.design/caws-cli 10.1.0 → 11.0.0

package/dist/config/lite-scope.js

@@ -1,158 +0,0 @@
-/**
- * @fileoverview CAWS Lite-Mode Scope Configuration Loader
- * Reads and validates .caws/scope.json for guardrails-only mode
- * @author @darianrosebrook
- */
-
-const fs = require('fs-extra');
-const path = require('path');
-const micromatch = require('micromatch');
-
-const SCOPE_FILE = '.caws/scope.json';
-
-/**
- * Default scope configuration for lite mode
- * @returns {Object} Default scope.json contents
- */
-function getLiteScopeDefaults() {
-  return {
-    version: 1,
-    allowedDirectories: ['src/', 'tests/', 'docs/'],
-    bannedPatterns: {
-      files: ['*-enhanced.*', '*-final.*', '*-v2.*', '*-copy.*'],
-      directories: ['*venv*', '.venv', 'm-venv', 'env/'],
-      docs: ['*-summary.md', '*-recap.md', '*-plan.md', 'sprint-*'],
-    },
-    maxNewFilesPerCommit: 10,
-    designatedVenvPath: '.venv',
-  };
-}
-
-/**
- * Load lite scope configuration from .caws/scope.json
- * @param {string} [projectRoot] - Project root directory (defaults to cwd)
- * @returns {Object} Scope configuration (defaults if file not found)
- */
-function loadLiteScope(projectRoot) {
-  const root = projectRoot || process.cwd();
-  const scopePath = path.join(root, SCOPE_FILE);
-
-  try {
-    if (!fs.existsSync(scopePath)) {
-      return getLiteScopeDefaults();
-    }
-
-    const raw = fs.readFileSync(scopePath, 'utf8');
-    const config = JSON.parse(raw);
-
-    // Merge with defaults for any missing fields
-    const defaults = getLiteScopeDefaults();
-    return {
-      version: config.version || defaults.version,
-      allowedDirectories: config.allowedDirectories || defaults.allowedDirectories,
-      bannedPatterns: {
-        files: config.bannedPatterns?.files || defaults.bannedPatterns.files,
-        directories: config.bannedPatterns?.directories || defaults.bannedPatterns.directories,
-        docs: config.bannedPatterns?.docs || defaults.bannedPatterns.docs,
-      },
-      maxNewFilesPerCommit: config.maxNewFilesPerCommit ?? defaults.maxNewFilesPerCommit,
-      designatedVenvPath: config.designatedVenvPath || defaults.designatedVenvPath,
-    };
-  } catch (error) {
-    // If file is malformed, return defaults
-    return getLiteScopeDefaults();
-  }
-}
-
-/**
- * Check if a file path is allowed by the scope configuration
- * @param {string} filePath - Relative file path to check
- * @param {Object} [scope] - Scope configuration (loads from disk if not provided)
- * @param {string} [projectRoot] - Project root directory
- * @returns {boolean} Whether the path is allowed
- */
-function isPathAllowed(filePath, scope, projectRoot) {
-  const config = scope || loadLiteScope(projectRoot);
-  const dirs = config.allowedDirectories;
-
-  // If no allowed directories specified, everything is allowed
-  if (!dirs || dirs.length === 0) {
-    return true;
-  }
-
-  // Normalize the file path
-  const normalized = filePath.replace(/\\/g, '/');
-
-  // Check if file is within any allowed directory
-  for (const dir of dirs) {
-    const normalizedDir = dir.replace(/\\/g, '/').replace(/\/$/, '');
-    if (normalized.startsWith(normalizedDir + '/') || normalized === normalizedDir) {
-      return true;
-    }
-  }
-
-  // Also allow root-level config files (package.json, etc.)
-  if (!normalized.includes('/')) {
-    return true;
-  }
-
-  // Allow .caws/ directory itself
-  if (normalized.startsWith('.caws/')) {
-    return true;
-  }
-
-  return false;
-}
-
-/**
- * Check if a filename or path matches any banned pattern
- * @param {string} filePath - File path to check
- * @param {Object} [scope] - Scope configuration (loads from disk if not provided)
- * @param {string} [projectRoot] - Project root directory
- * @returns {{ matched: boolean, pattern: string|null, category: string|null }} Match result
- */
-function matchesBannedPattern(filePath, scope, projectRoot) {
-  const config = scope || loadLiteScope(projectRoot);
-  const banned = config.bannedPatterns;
-  const basename = path.basename(filePath);
-  const normalized = filePath.replace(/\\/g, '/');
-
-  // Check file patterns
-  if (banned.files && banned.files.length > 0) {
-    if (micromatch.isMatch(basename, banned.files, { dot: true })) {
-      const matched = banned.files.find((p) => micromatch.isMatch(basename, p, { dot: true }));
-      return { matched: true, pattern: matched, category: 'files' };
-    }
-  }
-
-  // Check directory patterns
-  if (banned.directories && banned.directories.length > 0) {
-    const parts = normalized.split('/');
-    for (const part of parts) {
-      if (micromatch.isMatch(part, banned.directories, { dot: true })) {
-        const matched = banned.directories.find((p) =>
-          micromatch.isMatch(part, p, { dot: true })
-        );
-        return { matched: true, pattern: matched, category: 'directories' };
-      }
-    }
-  }
-
-  // Check doc patterns
-  if (banned.docs && banned.docs.length > 0) {
-    if (micromatch.isMatch(basename, banned.docs, { dot: true })) {
-      const matched = banned.docs.find((p) => micromatch.isMatch(basename, p, { dot: true }));
-      return { matched: true, pattern: matched, category: 'docs' };
-    }
-  }
-
-  return { matched: false, pattern: null, category: null };
-}
-
-module.exports = {
-  loadLiteScope,
-  isPathAllowed,
-  matchesBannedPattern,
-  getLiteScopeDefaults,
-  SCOPE_FILE,
-};

package/dist/config/modes.js

@@ -1,347 +0,0 @@
-/**
- * @fileoverview CAWS Complexity Modes Configuration
- * Defines different tiers of CAWS complexity for different project needs
- * @author @darianrosebrook
- */
-
-const chalk = require('chalk');
-
-/**
- * CAWS Complexity Tiers
- */
-const COMPLEXITY_TIERS = {
-  lite: {
-    name: 'Lite',
-    description: 'Guardrails-only mode — no YAML specs required',
-    color: chalk.magenta,
-    icon: '',
-    features: {
-      workingSpec: false,
-      destructiveCommandBlocking: true,
-      fileSprawlDetection: true,
-      scopeFence: true,
-      simplificationGuard: true,
-      worktreeIsolation: true,
-    },
-    qualityRequirements: {
-      testCoverage: 0,
-      mutationScore: 0,
-      contracts: 'none',
-    },
-    riskTiers: ['T3'],
-    commands: {
-      init: true,
-      status: true,
-      worktree: true,
-    },
-  },
-
-  simple: {
-    name: 'Simple',
-    description: 'Minimal CAWS for small projects and quick prototyping',
-    color: chalk.green,
-    icon: '',
-    features: {
-      workingSpec: true,
-      basicValidation: true,
-      statusDisplay: true,
-      noQualityGates: true,
-      noProvenance: true,
-      noWaivers: true,
-      noChangeBudgets: true,
-      noMultiSpec: false, // Can use multi-spec but simplified
-    },
-    qualityRequirements: {
-      testCoverage: 70,
-      mutationScore: 30,
-      contracts: 'optional',
-    },
-    riskTiers: ['T3'], // Only T3 supported
-    commands: {
-      init: true,
-      validate: true,
-      status: true,
-      specs: true, // Basic specs support
-      // No: diagnose, evaluate, iterate, provenance, waivers, hooks, archive
-    },
-  },
-
-  standard: {
-    name: 'Standard',
-    description: 'Balanced CAWS with change management and quality gates',
-    color: chalk.yellow,
-    icon: '',
-    features: {
-      workingSpec: true,
-      fullValidation: true,
-      statusDisplay: true,
-      qualityGates: true,
-      provenance: true,
-      waivers: true,
-      changeBudgets: true,
-      multiSpec: true,
-      changeFolders: true,
-    },
-    qualityRequirements: {
-      testCoverage: 80,
-      mutationScore: 50,
-      contracts: 'required',
-    },
-    riskTiers: ['T1', 'T2', 'T3'],
-    commands: {
-      init: true,
-      validate: true,
-      status: true,
-      specs: true,
-      diagnose: true,
-      evaluate: true,
-      iterate: true,
-      provenance: true,
-      waivers: true,
-      hooks: true,
-      archive: true,
-    },
-  },
-
-  enterprise: {
-    name: 'Enterprise',
-    description: 'Full CAWS with comprehensive audit trails and compliance',
-    color: chalk.red,
-    icon: '',
-    features: {
-      workingSpec: true,
-      fullValidation: true,
-      statusDisplay: true,
-      qualityGates: true,
-      provenance: true,
-      waivers: true,
-      changeBudgets: true,
-      multiSpec: true,
-      changeFolders: true,
-      auditTrails: true,
-      compliance: true,
-      advancedMonitoring: true,
-    },
-    qualityRequirements: {
-      testCoverage: 90,
-      mutationScore: 70,
-      contracts: 'required',
-    },
-    riskTiers: ['T1', 'T2', 'T3'],
-    commands: {
-      init: true,
-      validate: true,
-      status: true,
-      specs: true,
-      diagnose: true,
-      evaluate: true,
-      iterate: true,
-      provenance: true,
-      waivers: true,
-      hooks: true,
-      archive: true,
-      troubleshoot: true,
-      testAnalysis: true,
-      qualityMonitor: true,
-    },
-  },
-};
-
-/**
- * Get tier information
- * @param {string} tier - Tier name
- * @returns {Object} Tier configuration
- */
-function getTier(tier) {
-  return COMPLEXITY_TIERS[tier] || COMPLEXITY_TIERS.standard;
-}
-
-/**
- * Get available tiers
- * @returns {string[]} Array of tier names
- */
-function getAvailableTiers() {
-  return Object.keys(COMPLEXITY_TIERS);
-}
-
-/**
- * Check if a command is available in the current tier
- * @param {string} command - Command name
- * @param {string} tier - Tier name
- * @returns {boolean} Whether command is available
- */
-function isCommandAvailable(command, tier = 'standard') {
-  const tierConfig = getTier(tier);
-  return tierConfig.commands[command] === true;
-}
-
-/**
- * Check if a feature is enabled in the current tier
- * @param {string} feature - Feature name
- * @param {string} tier - Tier name
- * @returns {boolean} Whether feature is enabled
- */
-function isFeatureEnabled(feature, tier = 'standard') {
-  const tierConfig = getTier(tier);
-  return tierConfig.features[feature] === true;
-}
-
-/**
- * Get quality requirements for a tier
- * @param {string} tier - Tier name
- * @returns {Object} Quality requirements
- */
-function getQualityRequirements(tier = 'standard') {
-  const tierConfig = getTier(tier);
-  return tierConfig.qualityRequirements;
-}
-
-/**
- * Get supported risk tiers for a complexity tier
- * @param {string} tier - Tier name
- * @returns {string[]} Supported risk tiers
- */
-function getSupportedRiskTiers(tier = 'standard') {
-  const tierConfig = getTier(tier);
-  return tierConfig.riskTiers;
-}
-
-/**
- * Validate if a risk tier is supported in the current complexity tier
- * @param {string} riskTier - Risk tier to validate
- * @param {string} complexityTier - Complexity tier
- * @returns {boolean} Whether risk tier is supported
- */
-function isRiskTierSupported(riskTier, complexityTier = 'standard') {
-  const supportedTiers = getSupportedRiskTiers(complexityTier);
-  return supportedTiers.includes(riskTier);
-}
-
-/**
- * Display tier comparison
- */
-function displayTierComparison() {
-  console.log(chalk.bold.cyan('\nCAWS Complexity Tiers'));
-  console.log(chalk.cyan('=========================================================\n'));
-
-  // Header
-  console.log(
-    chalk.bold(
-      'Tier'.padEnd(12) +
-        'Features'.padEnd(15) +
-        'Coverage'.padEnd(10) +
-        'Commands'.padEnd(12) +
-        'Use Case'
-    )
-  );
-  console.log(chalk.gray('-'.repeat(90)));
-
-  Object.entries(COMPLEXITY_TIERS).forEach(([tierName, tier]) => {
-    const tierColor = tier.color;
-    const icon = tier.icon;
-
-    const features = Object.entries(tier.features)
-      .filter(([, enabled]) => enabled)
-      .map(([feature]) => feature.replace(/([A-Z])/g, ' $1').toLowerCase())
-      .slice(0, 3)
-      .join(', ');
-
-    const commands = Object.keys(tier.commands).filter((cmd) => tier.commands[cmd]).length;
-
-    console.log(
-      `${icon} ${tierColor(tierName.padEnd(10))} ${features.padEnd(13)} ${tier.qualityRequirements.testCoverage}%${' '.padEnd(8)}${commands}${' '.padEnd(10)}${tier.description}`
-    );
-  });
-
-  console.log('');
-}
-
-/**
- * Get current mode from configuration
- * @returns {Promise<string>} Current mode
- */
-async function getCurrentMode() {
-  const fs = require('fs-extra');
-  const MODE_CONFIG = '.caws/mode.json';
-
-  try {
-    if (!(await fs.pathExists(MODE_CONFIG))) {
-      return 'standard'; // Default to standard mode
-    }
-
-    const config = JSON.parse(await fs.readFile(MODE_CONFIG, 'utf8'));
-    return config.current || 'standard';
-  } catch (error) {
-    return 'standard'; // Default to standard mode on error
-  }
-}
-
-/**
- * Set current mode in configuration
- * @param {string} mode - Mode to set
- * @returns {Promise<boolean>} Success status
- */
-async function setCurrentMode(mode) {
-  const fs = require('fs-extra');
-  const path = require('path');
-  const MODE_CONFIG = '.caws/mode.json';
-
-  if (!getAvailableTiers().includes(mode)) {
-    return false;
-  }
-
-  try {
-    await fs.ensureDir(path.dirname(MODE_CONFIG));
-    const config = {
-      current: mode,
-      initialized: true,
-      lastChanged: new Date().toISOString(),
-    };
-    await fs.writeFile(MODE_CONFIG, JSON.stringify(config, null, 2));
-    return true;
-  } catch (error) {
-    return false;
-  }
-}
-
-/**
- * Get tier recommendation based on project characteristics
- * @param {Object} projectInfo - Project information
- * @returns {string} Recommended tier
- */
-function getTierRecommendation(projectInfo = {}) {
-  const { size = 'medium', teamSize = 1, compliance = false, auditRequired = false } = projectInfo;
-
-  // Enterprise tier for compliance/audit requirements
-  if (compliance || auditRequired) {
-    return 'enterprise';
-  }
-
-  // Enterprise for large teams or projects
-  if (teamSize > 5 || size === 'large') {
-    return 'enterprise';
-  }
-
-  // Standard for medium teams/projects
-  if (teamSize > 1 || size === 'medium') {
-    return 'standard';
-  }
-
-  // Simple for solo/small projects
-  return 'simple';
-}
-
-module.exports = {
-  COMPLEXITY_TIERS,
-  getTier,
-  getAvailableTiers,
-  getCurrentMode,
-  setCurrentMode,
-  isCommandAvailable,
-  isFeatureEnabled,
-  getQualityRequirements,
-  getSupportedRiskTiers,
-  isRiskTierSupported,
-  displayTierComparison,
-  getTierRecommendation,
-};

package/dist/constants/spec-types.js

@@ -1,65 +0,0 @@
-/**
- * @fileoverview Spec Types and Status Constants
- * Defines spec types, statuses, and their metadata for consistent display
- * @author @darianrosebrook
- */
-
-const chalk = require('chalk');
-
-/**
- * Spec types and their metadata
- */
-const SPEC_TYPES = {
-  feature: {
-    color: chalk.green,
-    icon: '',
-    description: 'New feature development',
-  },
-  fix: {
-    color: chalk.red,
-    icon: '',
-    description: 'Bug fixes and patches',
-  },
-  refactor: {
-    color: chalk.blue,
-    icon: '',
-    description: 'Code refactoring and improvements',
-  },
-  chore: {
-    color: chalk.gray,
-    icon: '',
-    description: 'Maintenance and cleanup',
-  },
-  docs: {
-    color: chalk.cyan,
-    icon: '',
-    description: 'Documentation updates',
-  },
-};
-
-/**
- * Spec statuses and lifecycle metadata.
- * Terminal statuses mean the spec is done — its scope restrictions
- * should NOT be enforced by the scope guard.
- */
-const SPEC_STATUSES = {
-  draft: { label: 'Draft', color: chalk.yellow, terminal: false },
-  active: { label: 'Active', color: chalk.green, terminal: false },
-  in_progress: { label: 'In Progress', color: chalk.green, terminal: false },
-  completed: { label: 'Completed', color: chalk.blue, terminal: true },
-  closed: { label: 'Closed', color: chalk.gray, terminal: true },
-  archived: { label: 'Archived', color: chalk.gray, terminal: true },
-};
-
-/**
- * Status keys that indicate a spec is done (scope no longer enforced).
- */
-const TERMINAL_STATUSES = Object.entries(SPEC_STATUSES)
-  .filter(([, v]) => v.terminal)
-  .map(([k]) => k);
-
-module.exports = {
-  SPEC_TYPES,
-  SPEC_STATUSES,
-  TERMINAL_STATUSES,
-};

package/dist/gates/budget-limit.js

@@ -1,121 +0,0 @@
-/**
- * @fileoverview Budget enforcement gate
- * Checks changes against tier budget limits from policy.
- * Context-aware: commit context counts staged changes, cli context skips (budget is per-change, not per-repo).
- * @author @darianrosebrook
- */
-
-const { deriveBudget, checkBudgetCompliance } = require('../budget-derivation');
-const { execSync } = require('child_process');
-
-const name = 'budget_limit';
-
-/**
- * Count staged files and lines of code from git diff
- * @param {string[]} stagedFiles - List of staged file paths
- * @param {string} projectRoot - Project root directory
- * @returns {Object} Stats with files_changed and lines_changed
- */
-function getStagedStats(stagedFiles, projectRoot) {
-  const filesChanged = stagedFiles.length;
-  let linesChanged = 0;
-
-  try {
-    const numstat = execSync('git diff --cached --numstat', {
-      cwd: projectRoot,
-      encoding: 'utf8',
-      stdio: ['ignore', 'pipe', 'pipe'],
-    });
-    for (const line of numstat.trim().split('\n').filter(Boolean)) {
-      const [added, removed] = line.split('\t');
-      const addedNum = added === '-' ? 0 : parseInt(added, 10) || 0;
-      const removedNum = removed === '-' ? 0 : parseInt(removed, 10) || 0;
-      linesChanged += addedNum + removedNum;
-    }
-  } catch (err) {
-    // Fail-closed: if git fails, we cannot verify budget compliance
-    return {
-      files_changed: filesChanged,
-      lines_changed: -1,
-      error: `Cannot count staged line changes: ${err.message}`,
-    };
-  }
-
-  return { files_changed: filesChanged, lines_changed: linesChanged };
-}
-
-/**
- * Run the budget limit gate
- * @param {Object} params - Gate parameters
- * @param {string[]} params.stagedFiles - Staged file paths
- * @param {Object} params.spec - Working spec
- * @param {Object} params.policy - Policy configuration
- * @param {string} params.projectRoot - Project root
- * @param {number} params.riskTier - Risk tier number
- * @param {string} [params.context] - Execution context (commit, cli, edit)
- * @returns {Promise<Object>} Gate result with status and messages
- */
-async function run({ stagedFiles, spec, _policy, projectRoot, riskTier, context }) {
-  const messages = [];
-
-  // Budget limits apply to changes, not to the entire repo.
-  // In cli context with all tracked files, budget check is meaningless.
-  // Return 'skipped' (not 'pass') so the pipeline summary counts this gate under
-  // `skipped`, matching pipeline.js semantics for gates that did not actually run.
-  if (context === 'cli') {
-    return {
-      status: 'skipped',
-      messages: ['Budget check skipped in CLI context (budget applies to changes, not full repo)'],
-    };
-  }
-
-  // Build a minimal spec for deriveBudget
-  const specForBudget = {
-    risk_tier: riskTier,
-    waiver_ids: spec?.waiver_ids || [],
-  };
-
-  try {
-    const budget = await deriveBudget(specForBudget, projectRoot, { useCache: true });
-    const stats = getStagedStats(stagedFiles, projectRoot);
-
-    // Fail-closed: if git stats errored, report it
-    if (stats.error) {
-      messages.push(stats.error);
-      return { status: 'fail', messages };
-    }
-
-    const compliance = checkBudgetCompliance(budget, stats);
-
-    if (!compliance.compliant) {
-      for (const violation of compliance.violations) {
-        messages.push(violation.message);
-      }
-      return { status: 'fail', messages };
-    }
-
-    // Emit budget:pressure if usage > 80% but still compliant
-    try {
-      const filePercent = budget.max_files > 0 ? stats.files_changed / budget.max_files : 0;
-      const locPercent = budget.max_loc > 0 ? stats.lines_changed / budget.max_loc : 0;
-      if (filePercent > 0.8 || locPercent > 0.8) {
-        const { lifecycle, EVENTS } = require('../utils/lifecycle-events');
-        lifecycle.emit(EVENTS.BUDGET_PRESSURE, {
-          specId: spec?.id || null,
-          filesUsed: stats.files_changed,
-          filesLimit: budget.max_files,
-          locUsed: stats.lines_changed,
-          locLimit: budget.max_loc,
-          percentUsed: Math.round(Math.max(filePercent, locPercent) * 100),
-          timestamp: new Date().toISOString(),
-        });
-      }
-    } catch { /* non-fatal */ }
-
-    return { status: 'pass', messages };
-  } catch (err) {
-    return { status: 'fail', messages: [`Budget check error: ${err.message}`] };
-  }
-}
-
-module.exports = { name, run };