@paths.design/caws-cli 8.0.1 → 8.2.0

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

@@ -0,0 +1,242 @@
+/**
+ * @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/index.js

@@ -2,7 +2,8 @@
 
 /**
  * @fileoverview CAWS CLI - Scaffolding tool for Coding Agent Workflow System
- * Provides commands to initialize new projects and scaffold existing ones with CAWS
+ * Provides commands to initialize new projects and scaffold existing ones with CAWS.
+ * Includes spec management, quality gates, and AI-assisted development workflows.
  * @author @darianrosebrook
  */
 
@@ -48,6 +49,7 @@ const { specsCommand } = require('./commands/specs');
 const { modeCommand } = require('./commands/mode');
 const { tutorialCommand } = require('./commands/tutorial');
 const { planCommand } = require('./commands/plan');
+const { worktreeCommand } = require('./commands/worktree');
 
 // Import scaffold functionality
 const { scaffoldProject, setScaffoldDependencies } = require('./scaffold');
@@ -104,6 +106,8 @@ program
   .option('-i, --interactive', 'Run interactive setup wizard', true)
   .option('--non-interactive', 'Skip interactive prompts (use defaults)', false)
   .option('--template <template>', 'Use specific project template')
+  .option('--mode <mode>', 'CAWS mode (lite, simple, standard, enterprise)')
+  .option('--ide <ides>', 'IDE integrations to install (comma-separated: cursor,claude,vscode,intellij,windsurf,copilot,all,none)')
   .action(initProject);
 
 // Scaffold command
@@ -115,6 +119,7 @@ program
   .option('--with-codemods', 'Include codemod scripts', false)
   .option('--with-oidc', 'Include OIDC trusted publisher setup', false)
   .option('--with-quality-gates', 'Install quality gates package and scripts', false)
+  .option('--ide <ides>', 'IDE integrations to install (comma-separated: cursor,claude,vscode,intellij,windsurf,copilot,all,none)')
   .action(scaffoldProject);
 
 // Validate command
@@ -342,6 +347,37 @@ program
   .option('--output <path>', 'Output file path for the plan')
   .action((action, options) => planCommand(action, options));
 
+// Worktree command group
+const worktreeCmd = program
+  .command('worktree')
+  .description('Manage git worktrees for agent scope isolation');
+
+worktreeCmd
+  .command('create <name>')
+  .description('Create a new isolated worktree')
+  .option('--scope <patterns>', 'Sparse checkout patterns (comma-separated, e.g., "src/auth/**")')
+  .option('--base-branch <branch>', 'Base branch to create from')
+  .option('--spec-id <id>', 'Associated spec ID')
+  .action((name, options) => worktreeCommand('create', { name, ...options }));
+
+worktreeCmd
+  .command('list')
+  .description('List all managed worktrees')
+  .action(() => worktreeCommand('list'));
+
+worktreeCmd
+  .command('destroy <name>')
+  .description('Destroy a worktree')
+  .option('--delete-branch', 'Also delete the associated branch', false)
+  .option('--force', 'Force removal even if worktree is dirty', false)
+  .action((name, options) => worktreeCommand('destroy', { name, ...options }));
+
+worktreeCmd
+  .command('prune')
+  .description('Clean up stale worktree entries')
+  .option('--max-age <days>', 'Remove entries older than N days', '30')
+  .action((options) => worktreeCommand('prune', options));
+
 // Templates command
 program
   .command('templates [subcommand]')
@@ -435,12 +471,8 @@ program
   .option('-v, --verbose', 'Show detailed error information', false)
   .action(qualityMonitorCommand);
 
-// Troubleshoot command - temporarily disabled due to registration issue
-// program
-//   .command('troubleshoot [guide]')
-//   .description('Display troubleshooting guides for common CAWS issues')
-//   .option('-l, --list', 'List all available troubleshooting guides', false)
-//   .action(troubleshootCommand);
+// Troubleshoot command available via: caws diagnose --troubleshoot <guide>
+// The standalone command was consolidated into the diagnose command.
 
 // Tool command
 program
@@ -614,6 +646,7 @@ program.exitOverride((err) => {
       'hooks',
       'burnup',
       'tool',
+      'worktree',
     ];
     const similar = findSimilarCommand(commandName, validCommands);
 

package/dist/minimal-cli.js

@@ -1,7 +1,9 @@
 #!/usr/bin/env node
 
 /**
- * @fileoverview Minimal CAWS CLI to test Chalk functionality
+ * @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
  */
 

package/dist/scaffold/claude-hooks.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Scaffold Claude Code hooks for a CAWS project
+ * Creates .claude/settings.json with hooks and .claude/hooks/ directory with scripts
+ *
+ * @param {string} projectDir - Project directory path
+ * @param {string[]} levels - Hook levels to enable: 'safety', 'quality', 'scope', 'audit'
+ */
+export function scaffoldClaudeHooks(projectDir: string, levels?: string[]): Promise<void>;
+/**
+ * Generate Claude Code settings with hooks configuration
+ * @param {string[]} levels - Enabled hook levels
+ * @param {Set<string>} enabledHooks - Set of enabled hook script names
+ * @returns {Object} Settings object for settings.json
+ */
+export function generateClaudeSettings(levels: string[], _enabledHooks: any): any;
+/**
+ * Check if Claude Code hooks are already configured
+ * @param {string} projectDir - Project directory
+ * @returns {boolean} True if hooks are configured
+ */
+export function hasClaudeHooks(projectDir: string): boolean;
+/**
+ * List configured Claude Code hooks
+ * @param {string} projectDir - Project directory
+ * @returns {Object} Hook configuration or null
+ */
+export function getClaudeHooksConfig(projectDir: string): any;
+//# sourceMappingURL=claude-hooks.d.ts.map

package/dist/scaffold/claude-hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-hooks.d.ts","sourceRoot":"","sources":["../../src/scaffold/claude-hooks.js"],"names":[],"mappings":"AAaA;;;;;;GAMG;AACH,gDAHW,MAAM,WACN,MAAM,EAAE,iBA6HlB;AAED;;;;;GAKG;AACH,+CAJW,MAAM,EAAE,2BAuJlB;AAED;;;;GAIG;AACH,2CAHW,MAAM,GACJ,OAAO,CAcnB;AAED;;;;GAIG;AACH,iDAHW,MAAM,OAehB"}