@paths.design/caws-cli 10.2.0 → 11.0.0

package/dist/generators/jest-config-generator.js

@@ -1,242 +0,0 @@
-/**
- * @fileoverview Jest Configuration Generator
- * Generates Jest configuration for TypeScript projects
- * @author @darianrosebrook
- */
-
-const fs = require('fs-extra');
-const path = require('path');
-const chalk = require('chalk');
-
-/**
- * Generate Jest configuration for TypeScript project
- * @param {Object} options - Configuration options
- * @returns {string} Jest configuration content
- */
-function generateJestConfig(options = {}) {
-  const {
-    preset = 'ts-jest',
-    testEnvironment = 'node',
-    rootDir = '.',
-    testMatch = ['**/__tests__/**/*.ts', '**/?(*.)+(spec|test).ts'],
-    moduleFileExtensions = ['ts', 'tsx', 'js', 'jsx', 'json', 'node'],
-    collectCoverageFrom = ['src/**/*.ts', '!src/**/*.d.ts', '!src/**/*.test.ts'],
-    coverageThreshold = {
-      global: {
-        branches: 80,
-        functions: 80,
-        lines: 80,
-        statements: 80,
-      },
-    },
-  } = options;
-
-  const config = {
-    preset,
-    testEnvironment,
-    rootDir,
-    testMatch,
-    moduleFileExtensions,
-    collectCoverageFrom,
-    coverageThreshold,
-    transform: {
-      '^.+\\.tsx?$': [
-        'ts-jest',
-        {
-          tsconfig: 'tsconfig.json',
-        },
-      ],
-    },
-    moduleNameMapper: {
-      '^@/(.*)$': '<rootDir>/src/$1',
-    },
-  };
-
-  return `module.exports = ${JSON.stringify(config, null, 2)};\n`;
-}
-
-/**
- * Generate test setup file for TypeScript
- * @returns {string} Setup file content
- */
-function generateTestSetup() {
-  return `/**
- * Jest setup file for TypeScript tests
- * @author @darianrosebrook
- */
-
-// Add custom matchers or global test setup here
-beforeAll(() => {
-  // Global setup
-});
-
-afterAll(() => {
-  // Global teardown
-});
-`;
-}
-
-/**
- * Install Jest and TypeScript dependencies
- * @param {string} projectDir - Project directory
- * @param {Object} packageJson - Existing package.json
- * @returns {Promise<Object>} Installation result
- */
-async function installJestDependencies(projectDir, packageJson) {
-  const dependencies = ['jest', '@types/jest', 'ts-jest'];
-
-  // Check which dependencies are already installed
-  const allDeps = {
-    ...packageJson.dependencies,
-    ...packageJson.devDependencies,
-  };
-
-  const toInstall = dependencies.filter((dep) => !(dep in allDeps));
-
-  if (toInstall.length === 0) {
-    return {
-      installed: false,
-      message: 'All Jest dependencies already installed',
-      dependencies: [],
-    };
-  }
-
-  return {
-    installed: false,
-    needsInstall: true,
-    dependencies: toInstall,
-    installCommand: `npm install --save-dev ${toInstall.join(' ')}`,
-  };
-}
-
-/**
- * Configure Jest for TypeScript project
- * @param {string} projectDir - Project directory path
- * @param {Object} options - Configuration options
- * @returns {Promise<Object>} Configuration result
- */
-async function configureJestForTypeScript(projectDir = process.cwd(), options = {}) {
-  const { force = false, quiet = false } = options;
-
-  // Check if Jest config already exists
-  const jestConfigPath = path.join(projectDir, 'jest.config.js');
-  if (fs.existsSync(jestConfigPath) && !force) {
-    return {
-      configured: false,
-      skipped: true,
-      message: 'Jest configuration already exists',
-      path: jestConfigPath,
-    };
-  }
-
-  // Generate Jest config
-  const jestConfig = generateJestConfig();
-  await fs.writeFile(jestConfigPath, jestConfig);
-
-  if (!quiet) {
-    console.log(chalk.green('Created jest.config.js'));
-  }
-
-  // Generate test setup file
-  const setupPath = path.join(projectDir, 'tests', 'setup.ts');
-  await fs.ensureDir(path.join(projectDir, 'tests'));
-  await fs.writeFile(setupPath, generateTestSetup());
-
-  if (!quiet) {
-    console.log(chalk.green('Created tests/setup.ts'));
-  }
-
-  // Update package.json with test script if needed
-  const packageJsonPath = path.join(projectDir, 'package.json');
-  if (fs.existsSync(packageJsonPath)) {
-    const packageJson = JSON.parse(await fs.readFile(packageJsonPath, 'utf8'));
-
-    if (!packageJson.scripts) {
-      packageJson.scripts = {};
-    }
-
-    if (!packageJson.scripts.test) {
-      packageJson.scripts.test = 'jest';
-      packageJson.scripts['test:coverage'] = 'jest --coverage';
-      packageJson.scripts['test:watch'] = 'jest --watch';
-
-      await fs.writeFile(packageJsonPath, JSON.stringify(packageJson, null, 2) + '\n');
-
-      if (!quiet) {
-        console.log(chalk.green('Added test scripts to package.json'));
-      }
-    }
-  }
-
-  return {
-    configured: true,
-    files: [jestConfigPath, setupPath],
-    nextSteps: [
-      'Install dependencies: npm install --save-dev jest @types/jest ts-jest',
-      'Run tests: npm test',
-      'Run with coverage: npm run test:coverage',
-    ],
-  };
-}
-
-/**
- * Get Jest configuration recommendations
- * @param {string} projectDir - Project directory path
- * @returns {Object} Recommendations
- */
-function getJestRecommendations(projectDir = process.cwd()) {
-  const recommendations = [];
-  const hasJestConfig = fs.existsSync(path.join(projectDir, 'jest.config.js'));
-  const packageJsonPath = path.join(projectDir, 'package.json');
-
-  if (fs.existsSync(packageJsonPath)) {
-    const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
-    const allDeps = {
-      ...packageJson.dependencies,
-      ...packageJson.devDependencies,
-    };
-
-    if (!hasJestConfig && !('jest' in allDeps)) {
-      recommendations.push({
-        type: 'missing_framework',
-        severity: 'high',
-        message: 'No testing framework detected',
-        fix: 'Install Jest: npm install --save-dev jest @types/jest ts-jest',
-        autoFixable: false,
-      });
-    }
-
-    if ('typescript' in allDeps && 'jest' in allDeps && !('ts-jest' in allDeps)) {
-      recommendations.push({
-        type: 'missing_ts_jest',
-        severity: 'high',
-        message: 'TypeScript project with Jest but missing ts-jest',
-        fix: 'Install ts-jest: npm install --save-dev ts-jest',
-        autoFixable: false,
-      });
-    }
-
-    if (!hasJestConfig && 'jest' in allDeps) {
-      recommendations.push({
-        type: 'missing_config',
-        severity: 'medium',
-        message: 'Jest installed but not configured',
-        fix: 'Run: caws scaffold to generate Jest configuration',
-        autoFixable: true,
-      });
-    }
-  }
-
-  return {
-    hasIssues: recommendations.length > 0,
-    recommendations,
-  };
-}
-
-module.exports = {
-  configureJestForTypeScript,
-  generateJestConfig,
-  generateTestSetup,
-  installJestDependencies,
-  getJestRecommendations,
-};

package/dist/generators/working-spec.js

@@ -1,237 +0,0 @@
-/**
- * @fileoverview Working Spec Generation Utilities
- * Functions for generating and validating CAWS working specifications
- * @author @darianrosebrook
- */
-
-const yaml = require('js-yaml');
-const chalk = require('chalk');
-
-// Import validation utilities
-const { validateWorkingSpec } = require('../validation/spec-validation');
-
-/**
- * Generate working spec YAML with user input
- * @param {Object} answers - User responses
- * @returns {string} - Generated YAML content
- */
-function generateWorkingSpec(answers) {
-  const template = {
-    id: answers.projectId || 'PROJ-001',
-    title: answers.projectTitle || 'New CAWS Project',
-    risk_tier: answers.riskTier || 2,
-    mode: answers.projectMode || 'feature',
-    change_budget: {
-      max_files: answers.maxFiles || 25,
-      max_loc: answers.maxLoc || 1000,
-    },
-    blast_radius: {
-      modules: (answers.blastModules || 'src, tests')
-        .split(',')
-        .map((m) => m.trim())
-        .filter((m) => m),
-      data_migration: answers.dataMigration ?? false,
-    },
-    operational_rollback_slo: answers.rollbackSlo || '5m',
-    threats: (answers.projectThreats || '')
-      .split('\n')
-      .map((t) => t.trim())
-      .filter((t) => t && !t.startsWith('-') === false), // Allow lines starting with -
-    scope: {
-      in: (answers.scopeIn || 'src/, tests/')
-        .split(',')
-        .map((s) => s.trim())
-        .filter((s) => s),
-      out: (answers.scopeOut || 'node_modules/, dist/, build/')
-        .split(',')
-        .map((s) => s.trim())
-        .filter((s) => s)
-        // Remove glob patterns - scope.out should only contain directory paths
-        .filter((s) => !s.includes('*') && !s.includes('?'))
-        // Ensure paths end with / for directories or are explicit file paths
-        .map((s) => {
-          // If it's a directory pattern without trailing slash, add it
-          if (!s.includes('.') && !s.endsWith('/')) {
-            return s + '/';
-          }
-          return s;
-        }),
-    },
-    invariants: (answers.projectInvariants || 'System maintains data consistency')
-      .split('\n')
-      .map((i) => i.trim())
-      .filter((i) => i),
-    acceptance: (
-      answers.acceptanceCriteria || 'Given current state, when action occurs, then expected result'
-    )
-      .split('\n')
-      .filter((a) => a.trim())
-      .map((criteria, index) => {
-        const id = `A${index + 1}`;
-        const upperCriteria = criteria.toUpperCase();
-
-        // Try different variations of the format
-        let given = '';
-        let when = '';
-        let then = '';
-
-        if (
-          upperCriteria.includes('GIVEN') &&
-          upperCriteria.includes('WHEN') &&
-          upperCriteria.includes('THEN')
-        ) {
-          given = criteria.split(/WHEN/i)[0]?.replace(/GIVEN/i, '').trim() || '';
-          const whenThen = criteria.split(/WHEN/i)[1];
-          when = whenThen?.split(/THEN/i)[0]?.trim() || '';
-          then = whenThen?.split(/THEN/i)[1]?.trim() || '';
-        } else {
-          // Fallback: just split by lines and create simple criteria
-          given = 'Current system state';
-          when = criteria.replace(/^(GIVEN|WHEN|THEN)/i, '').trim();
-          then = 'Expected behavior occurs';
-        }
-
-        return {
-          id,
-          given: given || 'Current system state',
-          when: when || criteria,
-          then: then || 'Expected behavior occurs',
-        };
-      }),
-    non_functional: {
-      a11y: (answers.a11yRequirements || 'keyboard')
-        .split(',')
-        .map((a) => a.trim())
-        .filter((a) => a),
-      perf: { api_p95_ms: answers.perfBudget || 250 },
-      security: (answers.securityRequirements || 'validation')
-        .split(',')
-        .map((s) => s.trim())
-        .filter((s) => s),
-    },
-    contracts: (() => {
-      // If contract type/path provided, use it
-      if (answers.contractType && answers.contractPath) {
-        return [
-          {
-            type: answers.contractType,
-            path: answers.contractPath,
-          },
-        ];
-      }
-
-      // For Tier 1 & 2, provide minimal project_setup contract if none specified
-      const riskTier = answers.riskTier || 2;
-      if (riskTier === 1 || riskTier === 2) {
-        return [
-          {
-            type: 'project_setup',
-            path: '.caws/working-spec.yaml',
-            description:
-              'Project-level CAWS configuration. Feature-specific contracts will be added as features are developed.',
-          },
-        ];
-      }
-
-      // Tier 3 doesn't require contracts
-      return [];
-    })(),
-    observability: {
-      logs: (answers.observabilityLogs || '')
-        .split(',')
-        .map((l) => l.trim())
-        .filter((l) => l),
-      metrics: (answers.observabilityMetrics || '')
-        .split(',')
-        .map((m) => m.trim())
-        .filter((m) => m),
-      traces: (answers.observabilityTraces || '')
-        .split(',')
-        .map((t) => t.trim())
-        .filter((t) => t),
-    },
-    migrations: (answers.migrationPlan || '')
-      .split('\n')
-      .map((m) => m.trim())
-      .filter((m) => m),
-    rollback: (answers.rollbackPlan || '')
-      .split('\n')
-      .map((r) => r.trim())
-      .filter((r) => r),
-    human_override: answers.needsOverride
-      ? {
-          enabled: true,
-          approver: answers.overrideApprover,
-          rationale: answers.overrideRationale,
-          waived_gates: answers.waivedGates,
-          approved_at: new Date().toISOString(),
-          expires_at: new Date(
-            Date.now() + answers.overrideExpiresDays * 24 * 60 * 60 * 1000
-          ).toISOString(),
-        }
-      : undefined,
-    experimental_mode: answers.isExperimental
-      ? {
-          enabled: true,
-          rationale: answers.experimentalRationale,
-          expires_at: new Date(
-            Date.now() + answers.experimentalExpiresDays * 24 * 60 * 60 * 1000
-          ).toISOString(),
-          sandbox_location: answers.experimentalSandbox,
-        }
-      : undefined,
-    ai_assessment: {
-      confidence_level: answers.aiConfidence || 0.8,
-      uncertainty_areas: (answers.uncertaintyAreas || '')
-        .split(',')
-        .map((a) => a.trim())
-        .filter((a) => a),
-      complexity_factors: (answers.complexityFactors || '')
-        .split(',')
-        .map((f) => f.trim())
-        .filter((f) => f),
-      risk_factors: [], // Could be populated by AI analysis
-    },
-  };
-
-  return yaml.dump(template, { indent: 2 });
-}
-
-/**
- * Validate generated working spec against JSON schema
- * @param {string} specContent - YAML spec content
- * @param {Object} answers - User responses for error context
- */
-function validateGeneratedSpec(specContent, _answers) {
-  try {
-    const spec = yaml.load(specContent);
-
-    const isValid = validateWorkingSpec(spec);
-
-    if (!isValid) {
-      console.error(chalk.red('Generated working spec failed validation:'));
-      validateWorkingSpec.errors.forEach((error) => {
-        console.error(`   - ${error.instancePath || 'root'}: ${error.message}`);
-      });
-
-      // Provide helpful guidance
-      console.log(chalk.blue('\nValidation Tips:'));
-      console.log('   - Ensure risk_tier is 1, 2, or 3');
-      console.log('   - Check that scope.in is not empty');
-      console.log('   - Verify invariants and acceptance criteria are provided');
-      console.log('   - For tier 1 and 2, ensure contracts are specified');
-
-      process.exit(1);
-    }
-
-    console.log(chalk.green('Generated working spec passed validation'));
-  } catch (error) {
-    console.error(chalk.red('Error validating working spec:'), error.message);
-    process.exit(1);
-  }
-}
-
-module.exports = {
-  generateWorkingSpec,
-  validateGeneratedSpec,
-};

package/dist/minimal-cli.js

@@ -1,88 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * @fileoverview Minimal CAWS CLI for testing and development
- * Provides a lightweight CLI structure with version and help commands
- * for quick verification of CLI functionality.
- * @author @darianrosebrook
- */
-
-const { Command } = require('commander');
-const chalk = require('chalk');
-
-const program = new Command();
-
-// Configuration
-const CLI_VERSION = require('../package.json').version;
-
-/**
- * Show version information
- */
-function showVersion() {
-  console.log(chalk.bold(`CAWS CLI v${CLI_VERSION}`));
-  console.log(chalk.cyan('Coding Agent Workflow System - Scaffolding Tool'));
-  console.log(chalk.gray('Author: @darianrosebrook'));
-  console.log(chalk.gray('License: MIT'));
-}
-
-/**
- * Initialize a new project
- */
-async function initProject(projectName, _options) {
-  console.log(chalk.cyan(`Initializing new CAWS project: ${projectName}`));
-
-  try {
-    if (!projectName || projectName.trim() === '') {
-      console.error(chalk.red('Project name is required'));
-      console.error(chalk.blue('Usage: caws init <project-name>'));
-      process.exit(1);
-    }
-
-    console.log(chalk.green('Project initialization started'));
-    console.log(chalk.bold('\nConfiguration Summary:'));
-    console.log(`   ${chalk.cyan('Project')}: ${projectName}`);
-    console.log(`   ${chalk.cyan('Status')}: Initialized`);
-
-    console.log(chalk.green('\nProject initialized successfully!'));
-    console.log(chalk.blue('\nFor help: caws --help'));
-  } catch (error) {
-    console.error(chalk.red('Error during project initialization:'), error.message);
-    process.exit(1);
-  }
-}
-
-// CLI Commands
-program
-  .name('caws')
-  .description('CAWS - Coding Agent Workflow System CLI')
-  .version(CLI_VERSION, '-v, --version', 'Show version information');
-
-program
-  .command('init')
-  .alias('i')
-  .description('Initialize a new project with CAWS')
-  .argument('<project-name>', 'Name of the new project')
-  .action(initProject);
-
-program.command('version').alias('v').description('Show version information').action(showVersion);
-
-// Error handling
-program.exitOverride((err) => {
-  if (err.code === 'commander.help') {
-    process.exit(0);
-  }
-  console.error(chalk.red('Error:'), err.message);
-  process.exit(1);
-});
-
-// Parse and run
-try {
-  program.parse();
-} catch (error) {
-  if (error.code === 'commander.help' || error.code === 'commander.version') {
-    process.exit(0);
-  } else {
-    console.error(chalk.red('Error:'), error.message);
-    process.exit(1);
-  }
-}