@paths.design/caws-cli 8.0.1 → 8.2.0

package/README.md

@@ -13,7 +13,7 @@ The CAWS CLI serves as the central control point for:
 - **Agent Integration**: Programmatic APIs for AI agents to evaluate and guide development
 - **Waiver Management**: Fast-lane escape hatches with full audit trails
 - **CI/CD Optimization**: Pipeline generation and optimization tools
-- **Experimental Features**: Dry-run capabilities for cutting-edge functionality
+- **Experimental Features**: Dry-run capabilities for experimental functionality
 
 ## Installation
 
@@ -157,15 +157,14 @@ caws-cli/
         │                       │
         └───────────────────────┘
                 │
-        ┌─────────────────┐    ┌──────────────────┐
-        │ caws-mcp-server │────│ caws-vscode-ext  │
-        │ (Agent Bridge)  │    │   (IDE Integration)
-        └─────────────────┘    └──────────────────┘
+        ┌─────────────────┐
+        │ caws-mcp-server │
+        │ (Agent Bridge)  │
+        └─────────────────┘
 ```
 
 - **caws-template**: Provides the tools and configurations that CLI manages
 - **caws-mcp-server**: Exposes CLI functionality to AI agents via MCP protocol
-- **caws-vscode-extension**: Provides IDE integration using CLI capabilities
 
 ### Quality Gates Integration
 

package/dist/commands/archive.d.ts

@@ -18,6 +18,7 @@ export function loadChange(changeId: string): Promise<any | null>;
 export function validateAcceptanceCriteria(workingSpec: any): Promise<any>;
 /**
  * Validate change meets quality gates
+ * Runs the actual quality gates runner and checks for violations
  * @param {string} changeId - Change identifier
  * @returns {Promise<Object>} Quality gate result
  */

package/dist/commands/archive.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"archive.d.ts","sourceRoot":"","sources":["../../src/commands/archive.js"],"names":[],"mappings":"AA8OA;;;;GAIG;AACH,yCAHW,MAAM,+BAqGhB;AAtUD;;;;GAIG;AACH,qCAHW,MAAM,GACJ,OAAO,CAAC,MAAO,IAAI,CAAC,CAgChC;AAED;;;;GAIG;AACH,8DAFa,OAAO,KAAQ,CA8B3B;AAED;;;;GAIG;AACH,sDAFa,OAAO,KAAQ,CAS3B;AAED;;;;GAIG;AACH,oDAFa,OAAO,CAAC,MAAM,CAAC,CAgC3B;AAED;;;;GAIG;AACH,4CAFa,OAAO,CAAC,IAAI,CAAC,CAazB;AAED;;;;GAIG;AACH,+CAFa,OAAO,CAAC,IAAI,CAAC,CAoCzB;AAED;;;;;GAKG;AACH,6FAiCC"}
+{"version":3,"file":"archive.d.ts","sourceRoot":"","sources":["../../src/commands/archive.js"],"names":[],"mappings":"AA0VA;;;;GAIG;AACH,yCAHW,MAAM,+BAqGhB;AAjbD;;;;GAIG;AACH,qCAHW,MAAM,GACJ,OAAO,CAAC,MAAO,IAAI,CAAC,CAgChC;AAED;;;;GAIG;AACH,8DAFa,OAAO,KAAQ,CA8B3B;AAED;;;;;GAKG;AACH,sDAFa,OAAO,KAAQ,CAmH3B;AAED;;;;GAIG;AACH,oDAFa,OAAO,CAAC,MAAM,CAAC,CAgC3B;AAED;;;;GAIG;AACH,4CAFa,OAAO,CAAC,IAAI,CAAC,CAazB;AAED;;;;GAIG;AACH,+CAFa,OAAO,CAAC,IAAI,CAAC,CAoCzB;AAED;;;;;GAKG;AACH,6FAiCC"}

package/dist/commands/archive.js

@@ -8,6 +8,7 @@ const fs = require('fs-extra');
 const path = require('path');
 const yaml = require('js-yaml');
 const chalk = require('chalk');
+const { execSync } = require('child_process');
 const { safeAsync, outputResult } = require('../error-handler');
 
 // Import spec resolution system
@@ -87,16 +88,123 @@ async function validateAcceptanceCriteria(workingSpec) {
 
 /**
  * Validate change meets quality gates
+ * Runs the actual quality gates runner and checks for violations
  * @param {string} changeId - Change identifier
  * @returns {Promise<Object>} Quality gate result
  */
 async function validateQualityGates(_changeId) {
-  // For now, return success - in full implementation would run actual gate checks
-  return {
-    valid: true,
-    message: 'Quality gates passed (implementation pending)',
-    gates: ['test-coverage', 'linting', 'type-checking'],
-  };
+  const gates = [];
+  const violations = [];
+  const warnings = [];
+
+  try {
+    // Try to run the quality gates runner
+    const qualityGatesPath = path.join(
+      __dirname,
+      '..',
+      '..',
+      '..',
+      'quality-gates',
+      'run-quality-gates.mjs'
+    );
+
+    // Check if quality gates runner exists
+    if (await fs.pathExists(qualityGatesPath)) {
+      try {
+        // Run quality gates in CI mode (checks all files, not just staged)
+        const result = execSync(`node "${qualityGatesPath}" --context=ci --json 2>&1`, {
+          encoding: 'utf8',
+          timeout: 60000, // 60 second timeout
+          cwd: process.cwd(),
+        });
+
+        // Try to parse JSON output
+        try {
+          const jsonMatch = result.match(/\{[\s\S]*\}$/);
+          if (jsonMatch) {
+            const parsed = JSON.parse(jsonMatch[0]);
+            if (parsed.violations) {
+              violations.push(...parsed.violations);
+            }
+            if (parsed.warnings) {
+              warnings.push(...parsed.warnings);
+            }
+            gates.push(...(parsed.gates || []));
+          }
+        } catch {
+          // JSON parsing failed, check for error indicators in output
+          if (result.includes('❌') || result.includes('FAIL')) {
+            violations.push({ message: 'Quality gates reported failures', output: result });
+          }
+        }
+      } catch (execError) {
+        // Command failed - check exit code and output
+        if (execError.status !== 0) {
+          const output = execError.stdout || execError.message;
+          if (output.includes('violations') || output.includes('❌')) {
+            violations.push({ message: 'Quality gates failed', output: output.substring(0, 500) });
+          }
+        }
+      }
+    }
+
+    // Also check for active waivers that might cover violations
+    const waiversPath = path.join(process.cwd(), '.caws', 'waivers', 'active-waivers.yaml');
+    let hasActiveWaivers = false;
+    if (await fs.pathExists(waiversPath)) {
+      const waiversContent = await fs.readFile(waiversPath, 'utf8');
+      const waivers = yaml.load(waiversContent);
+      if (waivers && waivers.waivers) {
+        const activeWaiverCount = Object.keys(waivers.waivers).length;
+        if (activeWaiverCount > 0) {
+          hasActiveWaivers = true;
+          gates.push(`${activeWaiverCount} active waiver(s)`);
+        }
+      }
+    }
+
+    // Determine overall validity
+    const hasBlockingViolations = violations.some(
+      (v) => v.severity === 'block' || v.severity === 'fail'
+    );
+
+    if (violations.length === 0) {
+      return {
+        valid: true,
+        message: 'All quality gates passed',
+        gates: gates.length > 0 ? gates : ['naming', 'duplication', 'god-objects', 'hidden-todo'],
+        violations: [],
+        warnings,
+      };
+    } else if (hasActiveWaivers && !hasBlockingViolations) {
+      return {
+        valid: true,
+        message: `Quality gates passed with ${violations.length} waived violation(s)`,
+        gates,
+        violations,
+        warnings,
+        waived: true,
+      };
+    } else {
+      return {
+        valid: false,
+        message: `${violations.length} quality gate violation(s) found`,
+        gates,
+        violations,
+        warnings,
+      };
+    }
+  } catch (error) {
+    // If quality gates can't be run, warn but don't block
+    return {
+      valid: true,
+      message: `Quality gates check skipped: ${error.message}`,
+      gates: [],
+      violations: [],
+      warnings: [{ message: `Could not run quality gates: ${error.message}` }],
+      skipped: true,
+    };
+  }
 }
 
 /**

package/dist/commands/burnup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"burnup.d.ts","sourceRoot":"","sources":["../../src/commands/burnup.js"],"names":[],"mappings":"AAaA;;;GAGG;AACH,wCAFW,MAAM,iBAsEhB"}
+{"version":3,"file":"burnup.d.ts","sourceRoot":"","sources":["../../src/commands/burnup.js"],"names":[],"mappings":"AAsFA;;;GAGG;AACH,wCAFW,MAAM,iBAgGhB"}

package/dist/commands/burnup.js

@@ -8,9 +8,82 @@ const fs = require('fs-extra');
 const path = require('path');
 const yaml = require('js-yaml');
 const chalk = require('chalk');
+const { execSync } = require('child_process');
 
 const { deriveBudget, generateBurnupReport } = require('../budget-derivation');
 
+/**
+ * Get actual git change statistics from the repository
+ * Analyzes changes since the last tag or initial commit
+ * @param {string} specDir - Directory containing the spec file
+ * @returns {Object} Stats with files_changed, lines_added, lines_removed, lines_changed
+ */
+function getGitChangeStats(specDir) {
+  try {
+    const cwd = specDir || process.cwd();
+
+    // Find the base reference - prefer last tag, fall back to first commit
+    let baseRef;
+    try {
+      baseRef = execSync('git describe --tags --abbrev=0 2>/dev/null', {
+        cwd,
+        encoding: 'utf8',
+      }).trim();
+    } catch {
+      // No tags, use first commit
+      try {
+        baseRef = execSync('git rev-list --max-parents=0 HEAD', {
+          cwd,
+          encoding: 'utf8',
+        }).trim();
+      } catch {
+        // Not a git repo or no commits
+        return null;
+      }
+    }
+
+    // Get file change count
+    const filesOutput = execSync(`git diff --name-only ${baseRef}..HEAD`, {
+      cwd,
+      encoding: 'utf8',
+    });
+    const filesChanged = filesOutput.trim().split('\n').filter(Boolean).length;
+
+    // Get line statistics using --numstat
+    const numstatOutput = execSync(`git diff --numstat ${baseRef}..HEAD`, {
+      cwd,
+      encoding: 'utf8',
+    });
+
+    let linesAdded = 0;
+    let linesRemoved = 0;
+
+    numstatOutput
+      .trim()
+      .split('\n')
+      .filter(Boolean)
+      .forEach((line) => {
+        const [added, removed] = line.split('\t');
+        // Skip binary files (shown as '-')
+        if (added !== '-' && removed !== '-') {
+          linesAdded += parseInt(added, 10) || 0;
+          linesRemoved += parseInt(removed, 10) || 0;
+        }
+      });
+
+    return {
+      files_changed: filesChanged,
+      lines_added: linesAdded,
+      lines_removed: linesRemoved,
+      lines_changed: linesAdded + linesRemoved,
+      base_ref: baseRef,
+    };
+  } catch (error) {
+    // Return null if git analysis fails
+    return null;
+  }
+}
+
 /**
  * Burn-up command handler
  * @param {string} specFile - Path to spec file
@@ -32,15 +105,34 @@ async function burnupCommand(specFile) {
     // Derive budget
     const derivedBudget = deriveBudget(spec, path.dirname(specPath));
 
-    // Mock current stats - in real implementation this would analyze actual git changes
-    const mockStats = {
-      files_changed: 50, // This would be calculated from actual changes
-      lines_changed: 5000,
-      risk_tier: spec.risk_tier,
-    };
+    // Get actual git change statistics
+    const gitStats = getGitChangeStats(path.dirname(specPath));
+
+    let currentStats;
+    if (gitStats) {
+      currentStats = {
+        files_changed: gitStats.files_changed,
+        lines_changed: gitStats.lines_changed,
+        lines_added: gitStats.lines_added,
+        lines_removed: gitStats.lines_removed,
+        risk_tier: spec.risk_tier,
+        base_ref: gitStats.base_ref,
+      };
+      console.log(chalk.gray(`   Analyzing changes since: ${gitStats.base_ref}`));
+    } else {
+      // Fallback if git analysis fails (not in a repo or no commits)
+      console.log(chalk.yellow('   ⚠️  Could not analyze git history, using zero values'));
+      currentStats = {
+        files_changed: 0,
+        lines_changed: 0,
+        lines_added: 0,
+        lines_removed: 0,
+        risk_tier: spec.risk_tier,
+      };
+    }
 
     // Generate report
-    const report = generateBurnupReport(derivedBudget, mockStats);
+    const report = generateBurnupReport(derivedBudget, currentStats);
 
     console.log(report);
 
@@ -63,15 +155,22 @@ async function burnupCommand(specFile) {
 
     console.log(
       chalk.gray(
-        `   Current Usage: ${mockStats.files_changed} files, ${mockStats.lines_changed} LOC`
+        `   Current Usage: ${currentStats.files_changed} files, ${currentStats.lines_changed} LOC`
       )
     );
+    if (currentStats.lines_added !== undefined) {
+      console.log(
+        chalk.gray(
+          `   Breakdown: +${currentStats.lines_added} added, -${currentStats.lines_removed} removed`
+        )
+      );
+    }
 
     const filePercent = Math.round(
-      (mockStats.files_changed / derivedBudget.effective.max_files) * 100
+      (currentStats.files_changed / derivedBudget.effective.max_files) * 100
     );
     const locPercent = Math.round(
-      (mockStats.lines_changed / derivedBudget.effective.max_loc) * 100
+      (currentStats.lines_changed / derivedBudget.effective.max_loc) * 100
     );
 
     if (filePercent > 90 || locPercent > 90) {

package/dist/commands/diagnose.js

@@ -11,7 +11,7 @@ const chalk = require('chalk');
 
 // Import utilities
 const { checkTypeScriptTestConfig } = require('../utils/typescript-detector');
-const { configureJestForTypeScript } = require('../generators/jest-config');
+const { configureJestForTypeScript } = require('../generators/jest-config-generator');
 
 /**
  * Health check: Working spec validity

package/dist/commands/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.js"],"names":[],"mappings":"AAqBA;;GAEG;AACH,2EAwiBC"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.js"],"names":[],"mappings":"AAwBA;;GAEG;AACH,2EA6mBC"}

package/dist/commands/init.js

@@ -18,6 +18,15 @@ const { finalizeProject } = require('../utils/finalization');
 const { scaffoldCursorHooks } = require('../scaffold/cursor-hooks');
 const { scaffoldIDEIntegrations } = require('../scaffold/index');
 const { updateGitignore } = require('../utils/gitignore-updater');
+const { getLiteScopeDefaults } = require('../config/lite-scope');
+const { scaffoldClaudeHooks } = require('../scaffold/claude-hooks');
+const { setCurrentMode } = require('../config/modes');
+const {
+  IDE_REGISTRY,
+  detectActiveIDEs,
+  getRecommendedIDEs,
+  parseIDESelection,
+} = require('../utils/ide-detection');
 
 /**
  * Initialize a new project with CAWS
@@ -115,8 +124,9 @@ async function initProject(projectName, options) {
     const cawsSetup = detectCAWSSetup(targetDir);
     const originalTemplateDir = cawsSetup?.hasTemplateDir ? cawsSetup.templateDir : null;
 
-    // Check for existing agents.md/caws.md in target directory
-    const existingAgentsMd = fs.existsSync(path.join(targetDir, 'agents.md'));
+    // Check for existing AGENTS.md/agents.md/caws.md in target directory
+    const existingAgentsMd = fs.existsSync(path.join(targetDir, 'AGENTS.md')) ||
+      fs.existsSync(path.join(targetDir, 'agents.md'));
     const existingCawsMd = fs.existsSync(path.join(targetDir, 'caws.md'));
 
     // Create project directory and change to it (unless already in current directory)
@@ -137,55 +147,45 @@ async function initProject(projectName, options) {
       await fs.ensureDir('.agent');
       console.log(chalk.blue('ℹ️  Created basic CAWS structure'));
 
-      // Copy agents.md guide if templates are available
+      // Copy AGENTS.md guide if templates are available
       if (originalTemplateDir) {
         try {
-          const agentsMdSource = path.join(originalTemplateDir, 'agents.md');
-          let targetFile = 'agents.md';
+          const agentsMdSource = path.join(originalTemplateDir, 'AGENTS.md');
+          let targetFile = 'AGENTS.md';
 
           if (fs.existsSync(agentsMdSource)) {
-            // Use the pre-checked values for conflicts
             if (existingAgentsMd) {
-              // Conflict: user already has agents.md
               if (options.interactive && !options.nonInteractive) {
-                // Interactive mode: ask user
                 const overwriteAnswer = await inquirer.prompt([
                   {
                     type: 'confirm',
                     name: 'overwrite',
-                    message: '⚠️  agents.md already exists. Overwrite with CAWS guide?',
+                    message: 'AGENTS.md already exists. Overwrite with CAWS guide?',
                     default: false,
                   },
                 ]);
 
-                if (overwriteAnswer.overwrite) {
-                  targetFile = 'agents.md';
-                } else {
+                if (!overwriteAnswer.overwrite) {
                   targetFile = 'caws.md';
                 }
               } else {
-                // Non-interactive mode: use caws.md instead
                 targetFile = 'caws.md';
-                console.log(chalk.blue('ℹ️  agents.md exists, using caws.md for CAWS guide'));
+                console.log(chalk.blue('AGENTS.md exists, using caws.md for CAWS guide'));
               }
             }
 
-            // If caws.md also exists and that's our target, skip
             if (targetFile === 'caws.md' && existingCawsMd) {
               console.log(
-                chalk.yellow('⚠️  Both agents.md and caws.md exist, skipping guide copy')
+                chalk.yellow('Both AGENTS.md and caws.md exist, skipping guide copy')
               );
             } else {
               const agentsMdDest = path.join(process.cwd(), targetFile);
               await fs.copyFile(agentsMdSource, agentsMdDest);
-              console.log(chalk.green(`✅ Added ${targetFile} guide`));
+              console.log(chalk.green(`Added ${targetFile} guide`));
             }
           }
         } catch (templateError) {
-          console.warn(chalk.yellow('⚠️  Could not copy agents guide:'), templateError.message);
-          console.warn(
-            chalk.blue('💡 You can manually copy the guide from the caws-template package')
-          );
+          console.warn(chalk.yellow('Could not copy agents guide:'), templateError.message);
         }
       }
     } else {
@@ -193,12 +193,92 @@ async function initProject(projectName, options) {
       console.log(chalk.green('✅ CAWS project detected - skipping template copy'));
     }
 
+    // Handle lite mode init path
+    if (options.mode === 'lite') {
+      console.log(chalk.magenta('🛡️  CAWS Lite Mode — guardrails without YAML specs'));
+
+      // Detect allowed directories
+      const detectedDirs = [];
+      const commonDirs = ['src/', 'lib/', 'app/', 'tests/', 'test/', 'docs/'];
+      for (const dir of commonDirs) {
+        if (fs.existsSync(path.join(process.cwd(), dir.replace(/\/$/, '')))) {
+          detectedDirs.push(dir);
+        }
+      }
+
+      let allowedDirs = detectedDirs.length > 0 ? detectedDirs : ['src/', 'tests/', 'docs/'];
+
+      if (options.interactive && !options.nonInteractive) {
+        const liteAnswers = await inquirer.prompt([
+          {
+            type: 'input',
+            name: 'projectName',
+            message: '📝 Project name:',
+            default: path.basename(process.cwd()),
+          },
+          {
+            type: 'input',
+            name: 'allowedDirs',
+            message: '📁 Allowed directories (comma-separated):',
+            default: allowedDirs.join(', '),
+          },
+        ]);
+        allowedDirs = liteAnswers.allowedDirs.split(',').map((d) => d.trim()).filter(Boolean);
+      }
+
+      // Generate .caws/scope.json
+      await fs.ensureDir('.caws');
+      const scopeConfig = getLiteScopeDefaults();
+      scopeConfig.allowedDirectories = allowedDirs;
+      await fs.writeFile(
+        path.join('.caws', 'scope.json'),
+        JSON.stringify(scopeConfig, null, 2)
+      );
+      console.log(chalk.green('✅ Created .caws/scope.json'));
+
+      // Set mode to lite
+      await setCurrentMode('lite');
+      console.log(chalk.green('✅ Set mode to lite in .caws/mode.json'));
+
+      // Scaffold hooks: block-dangerous + scope-guard + lite-sprawl-check + simplification-guard
+      const liteIDEs = options.ide ? parseIDESelection(options.ide) : ['claude'];
+      if (liteIDEs.includes('claude')) {
+        console.log(chalk.blue('🔧 Setting up lite-mode hooks...'));
+        await scaffoldClaudeHooks(process.cwd(), ['safety', 'scope', 'lite']);
+      }
+
+      // Update .gitignore
+      console.log(chalk.blue('📝 Updating .gitignore...'));
+      await updateGitignore(process.cwd());
+
+      // Success
+      console.log(chalk.green('\n🎉 CAWS Lite mode initialized!'));
+      console.log(chalk.blue('\nGuardrails active:'));
+      console.log('  - Destructive command blocking (git push --force, rm -rf, etc.)');
+      console.log('  - Scope fencing (edits outside allowed directories require confirmation)');
+      console.log('  - File sprawl detection (banned patterns like *-enhanced.*, *-final.*)');
+      console.log('  - Simplification guard (prevents stubbing out implementations)');
+      console.log(chalk.blue('\nNext steps:'));
+      console.log('  1. Review .caws/scope.json and customize for your project');
+      console.log('  2. Start coding — hooks will protect against common AI mistakes');
+      console.log('  3. Use `caws worktree create <name>` for isolated agent workspaces');
+      return;
+    }
+
     // Handle interactive wizard or template-based setup
     if (options.interactive && !options.nonInteractive) {
       console.log(chalk.cyan('🎯 CAWS Interactive Setup Wizard'));
       console.log(chalk.blue('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'));
       console.log(chalk.gray('This wizard will guide you through creating a CAWS working spec\n'));
 
+      // Detect active IDEs for pre-selecting the IDE prompt
+      const detectedIDEs = detectActiveIDEs();
+      const recommendedIDEs = getRecommendedIDEs();
+      if (detectedIDEs.length > 0) {
+        console.log(chalk.blue(`Detected IDE: ${detectedIDEs.map((id) => IDE_REGISTRY[id].name).join(', ')}`));
+        console.log(chalk.gray('   (Pre-selected based on your environment)\n'));
+      }
+
       // Detect project type
       const detectedType = detectProjectType(process.cwd());
       console.log(chalk.blue(`📦 Detected project type: ${chalk.cyan(detectedType)}`));
@@ -337,10 +417,65 @@ async function initProject(projectName, options) {
           },
         },
         {
-          type: 'confirm',
-          name: 'useCursorHooks',
-          message: '🎯 Enable Cursor IDE hooks for real-time quality gates?',
-          default: true,
+          type: 'checkbox',
+          name: 'selectedIDEs',
+          message: 'Which IDE integrations do you want to install?',
+          choices: [
+            {
+              name: `Cursor (hooks, rules, audit) - AI-first IDE`,
+              value: 'cursor',
+              checked: options.ide
+                ? parseIDESelection(options.ide).includes('cursor')
+                : recommendedIDEs.includes('cursor'),
+            },
+            {
+              name: `Claude Code (safety hooks, settings)`,
+              value: 'claude',
+              checked: options.ide
+                ? parseIDESelection(options.ide).includes('claude')
+                : recommendedIDEs.includes('claude'),
+            },
+            {
+              name: `VS Code (settings, debug configs)`,
+              value: 'vscode',
+              checked: options.ide
+                ? parseIDESelection(options.ide).includes('vscode')
+                : recommendedIDEs.includes('vscode'),
+            },
+            {
+              name: `IntelliJ IDEA (run configurations)`,
+              value: 'intellij',
+              checked: options.ide
+                ? parseIDESelection(options.ide).includes('intellij')
+                : recommendedIDEs.includes('intellij'),
+            },
+            {
+              name: `Windsurf (CAWS workflow)`,
+              value: 'windsurf',
+              checked: options.ide
+                ? parseIDESelection(options.ide).includes('windsurf')
+                : recommendedIDEs.includes('windsurf'),
+            },
+            {
+              name: `GitHub Copilot (instructions)`,
+              value: 'copilot',
+              checked: options.ide
+                ? parseIDESelection(options.ide).includes('copilot')
+                : recommendedIDEs.includes('copilot'),
+            },
+            {
+              name: `JetBrains Junie (AI agent guidelines)`,
+              value: 'junie',
+              checked: options.ide
+                ? parseIDESelection(options.ide).includes('junie')
+                : recommendedIDEs.includes('junie'),
+            },
+            new inquirer.Separator(),
+            {
+              name: 'All IDEs (install everything)',
+              value: 'all',
+            },
+          ],
         },
         {
           type: 'confirm',
@@ -412,15 +547,20 @@ Happy coding! 🎯
         console.log(chalk.green('✅ Created test and docs directories'));
       }
 
-      // Setup Cursor hooks if requested
-      if (answers.useCursorHooks) {
-        console.log(chalk.blue('🎯 Setting up Cursor hooks...'));
+      // Setup selected IDE integrations
+      const selectedIDEs = parseIDESelection(answers.selectedIDEs || []);
+
+      if (selectedIDEs.includes('cursor')) {
+        console.log(chalk.blue('Setting up Cursor hooks...'));
         await scaffoldCursorHooks(process.cwd());
       }
 
-      // Setup IDE integrations for comprehensive development experience
-      console.log(chalk.blue('🎨 Setting up IDE integrations...'));
-      await scaffoldIDEIntegrations(process.cwd(), { force: false });
+      if (selectedIDEs.length > 0) {
+        console.log(chalk.blue('Setting up IDE integrations...'));
+        await scaffoldIDEIntegrations(process.cwd(), { force: false, ides: selectedIDEs });
+      } else {
+        console.log(chalk.gray('Skipping IDE setup (none selected, run `caws scaffold --ide <ides>` later)'));
+      }
 
       // Update .gitignore to exclude CAWS local runtime files
       console.log(chalk.blue('📝 Updating .gitignore...'));
@@ -500,13 +640,18 @@ Happy coding! 🎯
         console.log(chalk.green('✅ Created .caws/policy.yaml (optional - defaults work fine)'));
       }
 
-      // Setup Cursor hooks by default in non-interactive mode
-      console.log(chalk.blue('🎯 Setting up Cursor hooks...'));
-      await scaffoldCursorHooks(process.cwd());
+      // Setup IDE integrations based on --ide flag or auto-detection
+      const selectedIDEs = options.ide ? parseIDESelection(options.ide) : getRecommendedIDEs();
 
-      // Setup IDE integrations by default in non-interactive mode
-      console.log(chalk.blue('🎨 Setting up IDE integrations...'));
-      await scaffoldIDEIntegrations(process.cwd(), { force: false });
+      if (selectedIDEs.includes('cursor')) {
+        console.log(chalk.blue('Setting up Cursor hooks...'));
+        await scaffoldCursorHooks(process.cwd());
+      }
+
+      if (selectedIDEs.length > 0) {
+        console.log(chalk.blue(`Setting up IDE integrations: ${selectedIDEs.map((id) => IDE_REGISTRY[id].name).join(', ')}...`));
+        await scaffoldIDEIntegrations(process.cwd(), { force: false, ides: selectedIDEs });
+      }
 
       // Update .gitignore to exclude CAWS local runtime files
       console.log(chalk.blue('📝 Updating .gitignore...'));
@@ -549,8 +694,9 @@ Happy coding! 🎯
     console.log('   3. Run: caws validate (verify setup)');
     console.log('   4. Run: caws diagnose (check health)');
     console.log('   5. Optional: Create .caws/policy.yaml for custom budgets');
-    if (answers?.useCursorHooks || options.interactive === false) {
-      console.log('   6. Restart Cursor IDE to activate quality gates');
+    const finalIDEs = answers?.selectedIDEs || [];
+    if (finalIDEs.includes('cursor') || finalIDEs.includes('claude') || options.interactive === false) {
+      console.log('   6. Restart your IDE to activate quality gates');
     }
     console.log('\n💡 Quick start: caws scaffold && caws validate && caws diagnose');
   } catch (error) {