@paths.design/caws-cli 8.1.0 → 8.2.0

package/dist/scaffold/index.js

@@ -19,6 +19,9 @@ const { updateGitignore } = require('../utils/gitignore-updater');
 // Import Claude Code hooks scaffolding
 const { scaffoldClaudeHooks } = require('./claude-hooks');
 
+// Import IDE detection utilities
+const { IDE_REGISTRY, parseIDESelection, getRecommendedIDEs } = require('../utils/ide-detection');
+
 // CLI version from package.json
 const CLI_VERSION = require('../../package.json').version;
 
@@ -55,12 +58,20 @@ function findTemplateDir() {
 async function scaffoldIDEIntegrations(targetDir, options) {
   const templateDir = findTemplateDir() || path.join(__dirname, '../../templates');
 
-  console.log(chalk.cyan('🎨 Setting up IDE integrations...'));
+  // Determine which IDEs to install
+  const selectedIDEs = options.ides || [];
+  if (selectedIDEs.length === 0) {
+    console.log(chalk.gray('Skipping IDE setup (none selected)'));
+    return { added: 0, skipped: 0 };
+  }
+
+  const ideNames = selectedIDEs.map((id) => IDE_REGISTRY[id]?.name || id).join(', ');
+  console.log(chalk.cyan(`Setting up IDE integrations: ${ideNames}`));
 
   let addedCount = 0;
   let skippedCount = 0;
 
-  // Setup git hooks with provenance integration
+  // Setup git hooks with provenance integration (always -- not IDE-specific)
   try {
     const gitHooksResult = await scaffoldGitHooks(targetDir, {
       provenance: true,
@@ -72,71 +83,63 @@ async function scaffoldIDEIntegrations(targetDir, options) {
     addedCount += gitHooksResult.added;
     skippedCount += gitHooksResult.skipped;
   } catch (error) {
-    console.log(chalk.yellow(`⚠️  Git hooks setup failed: ${error.message}`));
+    console.log(chalk.yellow(`Warning: Git hooks setup failed: ${error.message}`));
   }
 
-  // List of IDE integration templates to copy
-  const ideTemplates = [
-    // VS Code
-    {
-      src: '.vscode/settings.json',
-      dest: '.vscode/settings.json',
-      desc: 'VS Code workspace settings',
-    },
-    {
-      src: '.vscode/launch.json',
-      dest: '.vscode/launch.json',
-      desc: 'VS Code debug configurations',
-    },
-
-    // IntelliJ IDEA
-    {
-      src: '.idea/runConfigurations/CAWS_Validate.xml',
-      dest: '.idea/runConfigurations/CAWS_Validate.xml',
-      desc: 'IntelliJ run configuration for CAWS validate',
-    },
-    {
-      src: '.idea/runConfigurations/CAWS_Evaluate.xml',
-      dest: '.idea/runConfigurations/CAWS_Evaluate.xml',
-      desc: 'IntelliJ run configuration for CAWS evaluate',
-    },
-
-    // Windsurf
-    {
-      src: '.windsurf/workflows/caws-guided-development.md',
-      dest: '.windsurf/workflows/caws-guided-development.md',
-      desc: 'Windsurf workflow for CAWS-guided development',
-    },
-
-    // GitHub Copilot
-    {
-      src: '.github/copilot/instructions.md',
-      dest: '.github/copilot/instructions.md',
-      desc: 'GitHub Copilot CAWS integration instructions',
-    },
-
-    // Git hooks are handled separately by scaffoldGitHooks
-
-    // Cursor hooks (already handled by scaffoldCursorHooks, but ensure README is copied)
-    {
-      src: '.cursor/README.md',
-      dest: '.cursor/README.md',
-      desc: 'Cursor integration documentation',
-    },
-
-    // Claude Code hooks
-    {
-      src: '.claude/README.md',
-      dest: '.claude/README.md',
-      desc: 'Claude Code integration documentation',
-    },
-  ];
+  // Build IDE templates list dynamically based on selection
+  const ideTemplates = [];
 
-  // Setup Claude Code hooks
-  try {
-    await scaffoldClaudeHooks(targetDir, ['safety', 'quality', 'scope', 'audit']);
-  } catch (error) {
-    console.log(chalk.yellow(`⚠️  Claude Code hooks setup failed: ${error.message}`));
+  if (selectedIDEs.includes('vscode')) {
+    ideTemplates.push(
+      { src: '.vscode/settings.json', dest: '.vscode/settings.json', desc: 'VS Code workspace settings' },
+      { src: '.vscode/launch.json', dest: '.vscode/launch.json', desc: 'VS Code debug configurations' }
+    );
+  }
+
+  if (selectedIDEs.includes('intellij')) {
+    ideTemplates.push(
+      { src: '.idea/runConfigurations/CAWS_Validate.xml', dest: '.idea/runConfigurations/CAWS_Validate.xml', desc: 'IntelliJ run configuration for CAWS validate' },
+      { src: '.idea/runConfigurations/CAWS_Evaluate.xml', dest: '.idea/runConfigurations/CAWS_Evaluate.xml', desc: 'IntelliJ run configuration for CAWS evaluate' }
+    );
+  }
+
+  if (selectedIDEs.includes('junie')) {
+    ideTemplates.push(
+      { src: '.junie/guidelines.md', dest: '.junie/guidelines.md', desc: 'JetBrains Junie AI agent guidelines' }
+    );
+  }
+
+  if (selectedIDEs.includes('windsurf')) {
+    ideTemplates.push(
+      { src: '.windsurf/workflows/caws-guided-development.md', dest: '.windsurf/workflows/caws-guided-development.md', desc: 'Windsurf workflow for CAWS-guided development' },
+      { src: '.windsurf/rules/caws-quality-standards.md', dest: '.windsurf/rules/caws-quality-standards.md', desc: 'Windsurf CAWS quality rules' }
+    );
+  }
+
+  if (selectedIDEs.includes('copilot')) {
+    ideTemplates.push(
+      { src: '.github/copilot-instructions.md', dest: '.github/copilot-instructions.md', desc: 'GitHub Copilot CAWS integration instructions' }
+    );
+  }
+
+  if (selectedIDEs.includes('cursor')) {
+    ideTemplates.push(
+      { src: '.cursor/README.md', dest: '.cursor/README.md', desc: 'Cursor integration documentation' }
+    );
+  }
+
+  if (selectedIDEs.includes('claude')) {
+    ideTemplates.push(
+      { src: '.claude/README.md', dest: '.claude/README.md', desc: 'Claude Code integration documentation' },
+      { src: 'CLAUDE.md', dest: 'CLAUDE.md', desc: 'Claude Code project instructions' }
+    );
+
+    // Setup Claude Code hooks
+    try {
+      await scaffoldClaudeHooks(targetDir, ['safety', 'quality', 'scope', 'audit']);
+    } catch (error) {
+      console.log(chalk.yellow(`Warning: Claude Code hooks setup failed: ${error.message}`));
+    }
   }
 
   for (const template of ideTemplates) {
@@ -144,48 +147,43 @@ async function scaffoldIDEIntegrations(targetDir, options) {
     const destPath = path.join(targetDir, template.dest);
 
     try {
-      // Check if source exists
       if (!(await fs.pathExists(srcPath))) {
         if (!template.optional) {
-          console.log(chalk.yellow(`⚠️  Template not found: ${template.src}`));
+          console.log(chalk.yellow(`Warning: Template not found: ${template.src}`));
         }
         continue;
       }
 
-      // Check if destination already exists
       const destExists = await fs.pathExists(destPath);
 
       if (destExists && !options.force) {
-        console.log(chalk.gray(`⏭️  Skipped ${template.desc} (already exists)`));
+        console.log(chalk.gray(`Skipped ${template.desc} (already exists)`));
         skippedCount++;
         continue;
       }
 
-      // Ensure destination directory exists
       await fs.ensureDir(path.dirname(destPath));
-
-      // Copy the file
       await fs.copy(srcPath, destPath);
 
-      // Make scripts executable if they're in hooks or cursor directories
-      if (destPath.includes('.git/hooks/') || destPath.includes('.cursor/hooks/')) {
+      if (destPath.includes('.git/hooks/') || destPath.includes('.cursor/hooks/') || destPath.includes('.claude/hooks/')) {
         try {
           await fs.chmod(destPath, '755');
-        } catch (error) {
+        } catch (_) {
           // Ignore chmod errors on some systems
         }
       }
 
-      console.log(chalk.green(`✅ Added ${template.desc}`));
+      console.log(chalk.green(`Added ${template.desc}`));
       addedCount++;
     } catch (error) {
-      console.log(chalk.red(`❌ Failed to add ${template.desc}: ${error.message}`));
+      console.log(chalk.red(`Failed to add ${template.desc}: ${error.message}`));
     }
   }
 
   if (addedCount > 0) {
-    console.log(chalk.green(`\n🎨 IDE integrations: ${addedCount} added, ${skippedCount} skipped`));
-    console.log(chalk.blue('💡 Restart your IDE to activate the new integrations'));
+    console.log(chalk.green(`\nIDE integrations: ${addedCount} added, ${skippedCount} skipped`));
+    console.log(chalk.gray(`   Installed: ${ideNames}`));
+    console.log(chalk.blue('Restart your IDE to activate the new integrations'));
   }
 
   return { added: addedCount, skipped: skippedCount };
@@ -370,15 +368,19 @@ async function scaffoldProject(options) {
       });
     }
 
-    // Add IDE integrations for comprehensive development experience
-    enhancements.push({
-      name: 'ide-integrations',
-      description: 'IDE integrations (VS Code, IntelliJ, Windsurf, Git hooks)',
-      required: false,
-      customHandler: async (targetDir, options) => {
-        return await scaffoldIDEIntegrations(targetDir, options);
-      },
-    });
+    // Add IDE integrations for selected IDEs
+    const selectedIDEs = options.ide ? parseIDESelection(options.ide) : getRecommendedIDEs();
+    if (selectedIDEs.length > 0) {
+      const ideNames = selectedIDEs.map((id) => IDE_REGISTRY[id]?.name || id).join(', ');
+      enhancements.push({
+        name: 'ide-integrations',
+        description: `IDE integrations (${ideNames})`,
+        required: false,
+        customHandler: async (targetDir, opts) => {
+          return await scaffoldIDEIntegrations(targetDir, { ...opts, ides: selectedIDEs });
+        },
+      });
+    }
 
     // Add quality gates package and configuration if requested
     // Note: These are optional - git hooks fall back to CAWS CLI if package isn't installed
@@ -558,7 +560,7 @@ async function scaffoldProject(options) {
       !fs.existsSync(path.join(currentDir, 'caws.md'))
     ) {
       enhancements.push({
-        name: 'agents.md',
+        name: 'AGENTS.md',
         description: 'CAWS agent workflow guide',
         required: false,
       });

package/dist/templates/.caws/schemas/scope.schema.json

@@ -0,0 +1,52 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "CAWS Lite Scope Configuration",
+  "description": "Scope configuration for CAWS lite mode — guardrails without YAML specs",
+  "type": "object",
+  "required": ["version", "allowedDirectories"],
+  "properties": {
+    "version": {
+      "type": "integer",
+      "const": 1,
+      "description": "Schema version"
+    },
+    "allowedDirectories": {
+      "type": "array",
+      "items": { "type": "string" },
+      "minItems": 1,
+      "description": "Directories the agent is allowed to modify (e.g., src/, tests/)"
+    },
+    "bannedPatterns": {
+      "type": "object",
+      "properties": {
+        "files": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Glob patterns for banned file names (e.g., *-enhanced.*, *-final.*)"
+        },
+        "directories": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Glob patterns for banned directory names (e.g., *venv*, .venv)"
+        },
+        "docs": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Glob patterns for banned doc file names (e.g., *-summary.md)"
+        }
+      },
+      "additionalProperties": false
+    },
+    "maxNewFilesPerCommit": {
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 100,
+      "description": "Maximum number of new files allowed per commit (prevents file sprawl)"
+    },
+    "designatedVenvPath": {
+      "type": "string",
+      "description": "The only allowed virtual environment path (e.g., .venv)"
+    }
+  },
+  "additionalProperties": false
+}

package/dist/templates/.caws/schemas/working-spec.schema.json

@@ -16,7 +16,7 @@
     "contracts"
   ],
   "properties": {
-    "id": { "type": "string", "pattern": "^(PROJ|FEAT|FIX|ARCH)-\\d{4}$" },
+    "id": { "type": "string", "pattern": "^[A-Z]{2,6}-\\d{3,4}$" },
     "title": { "type": "string", "minLength": 10, "maxLength": 200 },
     "risk_tier": { "type": ["integer", "string"], "enum": [1, 2, 3, "1", "2", "3"] },
     "mode": { "type": "string", "enum": ["feature", "refactor", "fix", "doc", "chore"] },

package/dist/templates/.caws/schemas/worktrees.schema.json

@@ -0,0 +1,36 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "CAWS Worktree Registry",
+  "description": "Registry of git worktrees managed by CAWS for agent scope isolation",
+  "type": "object",
+  "required": ["version", "worktrees"],
+  "properties": {
+    "version": {
+      "type": "integer",
+      "const": 1
+    },
+    "worktrees": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "object",
+        "required": ["name", "path", "branch", "baseBranch", "createdAt", "status"],
+        "properties": {
+          "name": { "type": "string", "pattern": "^[a-zA-Z0-9_-]+$" },
+          "path": { "type": "string" },
+          "branch": { "type": "string" },
+          "baseBranch": { "type": "string" },
+          "scope": { "type": ["string", "null"] },
+          "specId": { "type": ["string", "null"] },
+          "createdAt": { "type": "string", "format": "date-time" },
+          "destroyedAt": { "type": "string", "format": "date-time" },
+          "status": {
+            "type": "string",
+            "enum": ["active", "orphaned", "missing", "destroyed"]
+          }
+        },
+        "additionalProperties": false
+      }
+    }
+  },
+  "additionalProperties": false
+}

package/dist/templates/.claude/hooks/block-dangerous.sh

@@ -65,11 +65,44 @@ DANGEROUS_PATTERNS=(
   'reboot'
   'init 0'
   'init 6'
+
+  # Git destructive operations
+  'git init'
+  'git reset --hard'
+  'git push --force'
+  'git push -f '
+  'git push --force-with-lease'
+  'git clean -f'
+  'git checkout \.'
+  'git restore \.'
+
+  # Virtual environment creation (prevents venv sprawl)
+  'python -m venv'
+  'python3 -m venv'
+  'virtualenv '
+  'conda create'
 )
 
 # Check command against dangerous patterns
 for pattern in "${DANGEROUS_PATTERNS[@]}"; do
   if echo "$COMMAND" | grep -qiE "$pattern"; then
+    # Allow git init in worktree context
+    if [[ "$pattern" == "git init" ]] && [[ "${CAWS_WORKTREE_CONTEXT:-0}" == "1" ]]; then
+      continue
+    fi
+
+    # Allow venv commands if target matches designated venv path from scope.json
+    if echo "$pattern" | grep -qE '(python.*venv|virtualenv|conda create)'; then
+      PROJECT_DIR="${CLAUDE_PROJECT_DIR:-.}"
+      SCOPE_FILE="$PROJECT_DIR/.caws/scope.json"
+      if [[ -f "$SCOPE_FILE" ]] && command -v node >/dev/null 2>&1; then
+        DESIGNATED_VENV=$(node -e "try { const s = JSON.parse(require('fs').readFileSync('$SCOPE_FILE','utf8')); console.log(s.designatedVenvPath || ''); } catch(e) { console.log(''); }" 2>/dev/null || echo "")
+        if [[ -n "$DESIGNATED_VENV" ]] && echo "$COMMAND" | grep -qF "$DESIGNATED_VENV"; then
+          continue
+        fi
+      fi
+    fi
+
     # Output to stderr for Claude to see
     echo "BLOCKED: Command matches dangerous pattern: $pattern" >&2
     echo "Command was: $COMMAND" >&2

package/dist/templates/.claude/hooks/lite-sprawl-check.sh

@@ -0,0 +1,117 @@
+#!/bin/bash
+# CAWS Lite-Mode Sprawl Check Hook
+# Checks for file sprawl patterns (banned names, venv dirs, doc sprawl)
+# @author @darianrosebrook
+
+set -euo pipefail
+
+# Read JSON input from Claude Code
+INPUT=$(cat)
+
+# Extract tool info
+TOOL_NAME=$(echo "$INPUT" | jq -r '.tool_name // ""')
+FILE_PATH=$(echo "$INPUT" | jq -r '.tool_input.file_path // ""')
+
+# Only check Write operations (new file creation)
+if [[ "$TOOL_NAME" != "Write" ]]; then
+  exit 0
+fi
+
+if [[ -z "$FILE_PATH" ]]; then
+  exit 0
+fi
+
+PROJECT_DIR="${CLAUDE_PROJECT_DIR:-.}"
+SCOPE_FILE="$PROJECT_DIR/.caws/scope.json"
+
+# Only active in lite mode (scope.json present, no working-spec.yaml)
+if [[ ! -f "$SCOPE_FILE" ]]; then
+  exit 0
+fi
+
+# Get relative path
+# Get relative path (portable — macOS realpath lacks --relative-to)
+if [[ "$FILE_PATH" == "$PROJECT_DIR"/* ]]; then
+  REL_PATH="${FILE_PATH#$PROJECT_DIR/}"
+else
+  REL_PATH="$FILE_PATH"
+fi
+BASENAME=$(basename "$REL_PATH")
+
+# Use Node.js to check banned patterns
+if command -v node >/dev/null 2>&1; then
+  SPRAWL_CHECK=$(node -e "
+    const fs = require('fs');
+    const path = require('path');
+    try {
+      const scope = JSON.parse(fs.readFileSync('$SCOPE_FILE', 'utf8'));
+      const filePath = '$REL_PATH';
+      const basename = '$BASENAME';
+      const banned = scope.bannedPatterns || {};
+
+      function matchGlob(str, pattern) {
+        const regex = new RegExp('^' + pattern.replace(/\\*/g, '.*').replace(/\\?/g, '.') + '$');
+        return regex.test(str);
+      }
+
+      // Check banned file patterns
+      for (const p of (banned.files || [])) {
+        if (matchGlob(basename, p)) {
+          console.log('banned_file:' + p);
+          process.exit(0);
+        }
+      }
+
+      // Check banned doc patterns
+      for (const p of (banned.docs || [])) {
+        if (matchGlob(basename, p)) {
+          console.log('banned_doc:' + p);
+          process.exit(0);
+        }
+      }
+
+      // Check banned directory patterns
+      const parts = filePath.split('/');
+      for (const part of parts) {
+        for (const p of (banned.directories || [])) {
+          if (matchGlob(part, p)) {
+            console.log('banned_dir:' + p + ':' + part);
+            process.exit(0);
+          }
+        }
+      }
+
+      console.log('ok');
+    } catch (error) {
+      console.log('error:' + error.message);
+    }
+  " 2>&1)
+
+  if [[ "$SPRAWL_CHECK" == banned_file:* ]]; then
+    PATTERN="${SPRAWL_CHECK#banned_file:}"
+    echo "BLOCKED: File name matches banned sprawl pattern: $PATTERN" >&2
+    echo "File: $REL_PATH" >&2
+    echo "Banned patterns prevent shadow files like *-enhanced.*, *-final.*, *-v2.*, *-copy.*" >&2
+    echo "Instead, modify the original file directly." >&2
+    exit 2
+  fi
+
+  if [[ "$SPRAWL_CHECK" == banned_doc:* ]]; then
+    PATTERN="${SPRAWL_CHECK#banned_doc:}"
+    echo "BLOCKED: Doc file matches banned sprawl pattern: $PATTERN" >&2
+    echo "File: $REL_PATH" >&2
+    echo "Avoid creating many summary/recap/plan files. Update existing documentation instead." >&2
+    exit 2
+  fi
+
+  if [[ "$SPRAWL_CHECK" == banned_dir:* ]]; then
+    IFS=':' read -r _ PATTERN DIR_NAME <<< "$SPRAWL_CHECK"
+    echo "BLOCKED: Directory matches banned pattern: $PATTERN (directory: $DIR_NAME)" >&2
+    echo "File: $REL_PATH" >&2
+    echo "Use the designated venv path instead of creating new virtual environments." >&2
+    exit 2
+  fi
+fi
+
+# Allow the operation
+exit 0

package/dist/templates/.claude/hooks/scope-guard.sh

@@ -23,14 +23,101 @@ fi
 
 PROJECT_DIR="${CLAUDE_PROJECT_DIR:-.}"
 SPEC_FILE="$PROJECT_DIR/.caws/working-spec.yaml"
+SCOPE_FILE="$PROJECT_DIR/.caws/scope.json"
 
-# Check if spec file exists
-if [[ ! -f "$SPEC_FILE" ]]; then
+# Check if spec file or scope.json exists
+if [[ ! -f "$SPEC_FILE" ]] && [[ ! -f "$SCOPE_FILE" ]]; then
   exit 0
 fi
 
-# Get relative path from project root
-REL_PATH=$(realpath --relative-to="$PROJECT_DIR" "$FILE_PATH" 2>/dev/null || echo "$FILE_PATH")
+# Get relative path from project root (portable — macOS realpath lacks --relative-to)
+if [[ "$FILE_PATH" == "$PROJECT_DIR"/* ]]; then
+  REL_PATH="${FILE_PATH#$PROJECT_DIR/}"
+else
+  REL_PATH="$FILE_PATH"
+fi
+
+# Lite mode: check scope.json if no working-spec.yaml
+if [[ ! -f "$SPEC_FILE" ]] && [[ -f "$SCOPE_FILE" ]]; then
+  if command -v node >/dev/null 2>&1; then
+    LITE_CHECK=$(node -e "
+      const fs = require('fs');
+      const path = require('path');
+      try {
+        const scope = JSON.parse(fs.readFileSync('$SCOPE_FILE', 'utf8'));
+        const filePath = '$REL_PATH';
+        const dirs = scope.allowedDirectories || [];
+        const banned = scope.bannedPatterns || {};
+
+        // Check banned file patterns
+        const basename = path.basename(filePath);
+        const bannedFiles = banned.files || [];
+        for (const pattern of bannedFiles) {
+          const regex = new RegExp(pattern.replace(/\\*/g, '.*').replace(/\\?/g, '.'));
+          if (regex.test(basename)) {
+            console.log('banned:' + pattern);
+            process.exit(0);
+          }
+        }
+
+        // Check banned doc patterns
+        const bannedDocs = banned.docs || [];
+        for (const pattern of bannedDocs) {
+          const regex = new RegExp(pattern.replace(/\\*/g, '.*').replace(/\\?/g, '.'));
+          if (regex.test(basename)) {
+            console.log('banned:' + pattern);
+            process.exit(0);
+          }
+        }
+
+        // Check allowed directories
+        if (dirs.length > 0) {
+          const normalized = filePath.replace(/\\\\\\\\/g, '/');
+          let found = false;
+          for (const dir of dirs) {
+            const d = dir.replace(/\\/$/, '');
+            if (normalized.startsWith(d + '/') || normalized === d) { found = true; break; }
+          }
+          // Allow root-level files and .caws/ directory
+          if (!normalized.includes('/') || normalized.startsWith('.caws/')) found = true;
+          if (!found) {
+            console.log('not_allowed');
+            process.exit(0);
+          }
+        }
+        console.log('allowed');
+      } catch (error) {
+        console.log('error:' + error.message);
+      }
+    " 2>&1)
+
+    if [[ "$LITE_CHECK" == banned:* ]]; then
+      PATTERN="${LITE_CHECK#banned:}"
+      echo '{
+        "hookSpecificOutput": {
+          "hookEventName": "PreToolUse",
+          "permissionDecision": "ask",
+          "permissionDecisionReason": "This file ('"$REL_PATH"') matches a banned pattern ('"$PATTERN"') in .caws/scope.json. Creating files with this pattern is blocked to prevent file sprawl."
+        }
+      }'
+      exit 0
+    fi
+
+    if [[ "$LITE_CHECK" == "not_allowed" ]]; then
+      echo '{
+        "hookSpecificOutput": {
+          "hookEventName": "PreToolUse",
+          "permissionDecision": "ask",
+          "permissionDecisionReason": "This file ('"$REL_PATH"') is outside the allowed directories in .caws/scope.json. Please confirm this edit is intentional."
+        }
+      }'
+      exit 0
+    fi
+
+    # File is allowed - exit normally
+    exit 0
+  fi
+fi
 
 # Use Node.js to parse YAML and check scope
 if command -v node >/dev/null 2>&1; then
@@ -44,7 +131,7 @@ if command -v node >/dev/null 2>&1; then
       const filePath = '$REL_PATH';
 
       // Check if file is explicitly out of scope
-      const outOfScope = spec.scope?.out_of_scope || [];
+      const outOfScope = spec.scope?.out || [];
       for (const pattern of outOfScope) {
         // Simple glob-like matching
         const regex = new RegExp(pattern.replace(/\*/g, '.*').replace(/\?/g, '.'));
@@ -55,7 +142,7 @@ if command -v node >/dev/null 2>&1; then
       }
 
       // Check if file is in scope (if scope is explicitly defined)
-      const inScope = spec.scope?.files || spec.scope?.directories || [];
+      const inScope = spec.scope?.in || [];
       if (inScope.length > 0) {
         let found = false;
         for (const pattern of inScope) {