@paths.design/caws-cli 7.0.3 → 8.0.1

package/dist/index.js

@@ -142,6 +142,8 @@ program
     ''
   )
   .option('--fix', 'Attempt automatic fixes (experimental)', false)
+  .option('--context <context>', 'Execution context: commit (staged files), push (all tracked files), or ci (all tracked files)', 'commit')
+  .option('--all-files', 'Check all tracked files (equivalent to --context=ci)', false)
   .option('--help', 'Show detailed help and usage examples', false)
   .action(async (options) => {
     // Handle --help flag
@@ -161,6 +163,8 @@ OPTIONS:
   --json            Output machine-readable JSON to stdout
   --gates=<gates>   Run only specific gates (comma-separated)
   --fix             Attempt automatic fixes (experimental)
+  --context=<ctx>   Execution context: commit (staged files), push (all tracked), ci (all tracked)
+  --all-files       Check all tracked files (shortcut for --context=ci)
   --help            Show this help message
 
 VALID GATES:
@@ -182,6 +186,12 @@ EXAMPLES:
   # CI mode with JSON output
   caws quality-gates --ci --json
 
+  # Check all files in repository (not just staged)
+  caws quality-gates --all-files
+
+  # Use specific context
+  caws quality-gates --context=ci
+
   # Show detailed help
   caws quality-gates --help
 

package/dist/policy/PolicyManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PolicyManager.d.ts","sourceRoot":"","sources":["../../src/policy/PolicyManager.js"],"names":[],"mappings":"AAWA;;;;;;;;GAQG;AACH;IACE,0BAIC;IAHC,mBAAkD;IAClD,cAA0C;IAC1C,2BAA4B;IAG9B;;;;;;;;OAQG;IACH,wBANW,MAAM,YAEd;QAAyB,QAAQ,EAAzB,OAAO;QACS,QAAQ,EAAxB,MAAM;KACd,GAAU,OAAO,KAAQ,CAuE3B;IAED;;;;;;OAMG;IACH,qBAJW,MAAM,eACN,MAAM,GACJ,OAAO,CAAC,MAAO,IAAI,CAAC,CAchC;IAED;;;;;OAKG;IACH,4BAFa,OAAO,CA2BnB;IAED;;;;;;;OAOG;IACH,uCAJW,MAAM,EAAE,eACR,MAAM,GACJ,OAAO,KAAQ,CA2B3B;IAED;;;;;OAKG;IACH,kCA8BC;IAED;;;;;;OAMG;IACH,wBAoDC;IAED;;;;OAIG;IACH,yBAFW,MAAM,QAQhB;IAED;;;;;OAKG;IACH,4BAHW,MAAM,OAmBhB;IAED;;;;;OAKG;IACH,0BAHW,MAAM,GACJ,OAAO,KAAQ,CAK3B;IAED;;;;OAIG;IACH,qBAFa,MAAM,EAAE,CAIpB;IAED;;;;OAIG;IACH,qBA2BC;CACF;AAGD,iDAAiD;AAOnC,iFAA+E;AAC/E,2DAA6D;AACzD,8DAAiE"}
+{"version":3,"file":"PolicyManager.d.ts","sourceRoot":"","sources":["../../src/policy/PolicyManager.js"],"names":[],"mappings":"AAWA;;;;;;;;GAQG;AACH;IACE,0BAIC;IAHC,mBAAkD;IAClD,cAA0C;IAC1C,2BAA4B;IAG9B;;;;;;;;OAQG;IACH,wBANW,MAAM,YAEd;QAAyB,QAAQ,EAAzB,OAAO;QACS,QAAQ,EAAxB,MAAM;KACd,GAAU,OAAO,KAAQ,CAuG3B;IAED;;;;;;OAMG;IACH,qBAJW,MAAM,eACN,MAAM,GACJ,OAAO,CAAC,MAAO,IAAI,CAAC,CAchC;IAED;;;;;OAKG;IACH,4BAFa,OAAO,CA2BnB;IAED;;;;;;;OAOG;IACH,uCAJW,MAAM,EAAE,eACR,MAAM,GACJ,OAAO,KAAQ,CA2B3B;IAED;;;;;OAKG;IACH,kCA8BC;IAED;;;;;;OAMG;IACH,wBAoDC;IAED;;;;OAIG;IACH,yBAFW,MAAM,QAQhB;IAED;;;;;OAKG;IACH,4BAHW,MAAM,OAmBhB;IAED;;;;;OAKG;IACH,0BAHW,MAAM,GACJ,OAAO,KAAQ,CAK3B;IAED;;;;OAIG;IACH,qBAFa,MAAM,EAAE,CAIpB;IAED;;;;OAIG;IACH,qBA2BC;CACF;AAGD,iDAAiD;AAOnC,iFAA+E;AAC/E,2DAA6D;AACzD,8DAAiE"}

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

@@ -1 +1 @@
-{"version":3,"file":"cursor-hooks.d.ts","sourceRoot":"","sources":["../../src/scaffold/cursor-hooks.js"],"names":[],"mappings":"AAaA;;;;GAIG;AACH,gDAHW,MAAM,WACN,MAAM,EAAE,iBAqJlB"}
+{"version":3,"file":"cursor-hooks.d.ts","sourceRoot":"","sources":["../../src/scaffold/cursor-hooks.js"],"names":[],"mappings":"AAaA;;;;GAIG;AACH,gDAHW,MAAM,WACN,MAAM,EAAE,iBA6JlB"}

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

@@ -17,4 +17,22 @@ export function removeGitHooks(projectDir: string): Promise<void>;
  * @param {string} projectDir - Project directory path
  */
 export function checkGitHooksStatus(projectDir: string): Promise<void>;
+/**
+ * Generate pre-push hook content
+ * Blocks --no-verify to enforce quality gates before pushing
+ */
+export function generatePrePushHook(): string;
+/**
+ * Generate pre-commit hook content with staged file quality gates
+ * Implements fallback chain: Node script → CLI → Python scripts → Skip gracefully
+ */
+export function generatePreCommitHook(options: any): string;
+/**
+ * Generate post-commit hook content
+ */
+export function generatePostCommitHook(): string;
+/**
+ * Generate commit-msg hook content
+ */
+export function generateCommitMsgHook(): string;
 //# sourceMappingURL=git-hooks.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"git-hooks.d.ts","sourceRoot":"","sources":["../../src/scaffold/git-hooks.js"],"names":[],"mappings":"AASA;;;;GAIG;AACH,6CAHW,MAAM;;;GAwGhB;AAwND;;;GAGG;AACH,2CAFW,MAAM,iBAkChB;AAED;;;GAGG;AACH,gDAFW,MAAM,iBAgDhB"}
+{"version":3,"file":"git-hooks.d.ts","sourceRoot":"","sources":["../../src/scaffold/git-hooks.js"],"names":[],"mappings":"AAUA;;;;GAIG;AACH,6CAHW,MAAM;;;GAwGhB;AA4kBD;;;GAGG;AACH,2CAFW,MAAM,iBAkChB;AAED;;;GAGG;AACH,gDAFW,MAAM,iBAgDhB;AA9VD;;;GAGG;AACH,8CAqNC;AA7hBD;;;GAGG;AACH,4DAsRC;AAED;;GAEG;AACH,iDAmCC;AA6ND;;GAEG;AACH,gDAsCC"}

package/dist/scaffold/git-hooks.js

@@ -6,6 +6,7 @@
 
 const fs = require('fs-extra');
 const path = require('path');
+const { getTodoAnalyzerSuggestion } = require('../utils/project-analysis');
 
 /**
  * Scaffold git hooks for CAWS provenance tracking
@@ -39,7 +40,7 @@ async function scaffoldGitHooks(projectDir, options = {}) {
       name: 'pre-commit',
       description: 'Pre-commit validation and quality checks',
       enabled: validation || qualityGates,
-      content: generatePreCommitHook({ validation, qualityGates }),
+      content: generatePreCommitHook({ validation, qualityGates, projectDir }),
     },
     {
       name: 'post-commit',
@@ -120,7 +121,10 @@ async function scaffoldGitHooks(projectDir, options = {}) {
  * Implements fallback chain: Node script → CLI → Python scripts → Skip gracefully
  */
 function generatePreCommitHook(options) {
-  const { qualityGates = true, stagedOnly = true } = options;
+  const { qualityGates = true, stagedOnly = true, projectDir = process.cwd() } = options;
+
+  // Get language-agnostic suggestions based on runtime availability
+  const todoSuggestion = getTodoAnalyzerSuggestion(projectDir);
 
   return `#!/bin/bash
 # CAWS Pre-commit Hook
@@ -144,13 +148,13 @@ if [ -f ".git/index.lock" ]; then
   LOCK_AGE_MINUTES=$((LOCK_AGE / 60))
   
   if [ $LOCK_AGE_MINUTES -gt 5 ]; then
-    echo "⚠️  Stale git lock detected (${LOCK_AGE_MINUTES} minutes old)"
+    echo "⚠️  Stale git lock detected (\${LOCK_AGE_MINUTES} minutes old)"
     echo "💡 This may indicate a crashed git process"
     echo "💡 Remove stale lock: rm .git/index.lock"
     echo "⚠️  Warning: Check for running git/editor processes before removing"
     exit 1
   else
-    echo "⚠️  Git lock detected (${LOCK_AGE_MINUTES} minutes old)"
+    echo "⚠️  Git lock detected (\${LOCK_AGE_MINUTES} minutes old)"
     echo "💡 Another git process may be running"
     echo "💡 Wait for the other process to complete, or check for running processes"
     exit 1
@@ -162,7 +166,7 @@ echo "🔍 Validating YAML syntax for CAWS spec files..."
 YAML_VALIDATION_FAILED=false
 
 # Find all staged .yaml/.yml files in .caws directory
-STAGED_YAML_FILES=$(git diff --cached --name-only --diff-filter=ACM | grep -E '\.caws/.*\.(yaml|yml)$' || true)
+STAGED_YAML_FILES=$(git diff --cached --name-only --diff-filter=ACM | grep -E '\\.caws/.*\\.(yaml|yml)$' || true)
 
 if [ -n "$STAGED_YAML_FILES" ]; then
   # Use Node.js to validate YAML if available
@@ -326,42 +330,49 @@ fi
 if [ "$QUALITY_GATES_RAN" = true ]; then
   echo "🔍 Checking for hidden TODOs in staged files..."
   
-  # Find TODO analyzer .mjs file (preferred - no Python dependency)
-  TODO_ANALYZER=""
+  TODO_CHECK_RAN=false
   
-  # Try quality gates package TODO analyzer (published package)
-  if [ -f "node_modules/@paths.design/quality-gates/todo-analyzer.mjs" ]; then
-    TODO_ANALYZER="node_modules/@paths.design/quality-gates/todo-analyzer.mjs"
-  # Try quality gates package TODO analyzer (monorepo/local copy)
-  elif [ -f "node_modules/@caws/quality-gates/todo-analyzer.mjs" ]; then
-    TODO_ANALYZER="node_modules/@caws/quality-gates/todo-analyzer.mjs"
-  # Try monorepo structure (development)
-  elif [ -f "packages/quality-gates/todo-analyzer.mjs" ]; then
-    TODO_ANALYZER="packages/quality-gates/todo-analyzer.mjs"
-  # Try local copy in scripts directory (if scaffolded)
-  elif [ -f "scripts/todo-analyzer.mjs" ]; then
-    TODO_ANALYZER="scripts/todo-analyzer.mjs"
+  # Option 1: Find TODO analyzer .mjs file (if installed locally)
+  if [ "$TODO_CHECK_RAN" = false ]; then
+    TODO_ANALYZER=""
+    
+    # Try quality gates package TODO analyzer (published package)
+    if [ -f "node_modules/@paths.design/quality-gates/todo-analyzer.mjs" ]; then
+      TODO_ANALYZER="node_modules/@paths.design/quality-gates/todo-analyzer.mjs"
+    # Try quality gates package TODO analyzer (monorepo/local copy)
+    elif [ -f "node_modules/@caws/quality-gates/todo-analyzer.mjs" ]; then
+      TODO_ANALYZER="node_modules/@caws/quality-gates/todo-analyzer.mjs"
+    # Try monorepo structure (development)
+    elif [ -f "packages/quality-gates/todo-analyzer.mjs" ]; then
+      TODO_ANALYZER="packages/quality-gates/todo-analyzer.mjs"
+    # Try local copy in scripts directory (if scaffolded)
+    elif [ -f "scripts/todo-analyzer.mjs" ]; then
+      TODO_ANALYZER="scripts/todo-analyzer.mjs"
+    fi
+    
+    # Run TODO analyzer if found
+    if [ -n "$TODO_ANALYZER" ] && command -v node >/dev/null 2>&1; then
+      if node "$TODO_ANALYZER" --staged-only --ci-mode --min-confidence 0.8 >/dev/null 2>&1; then
+        echo "✅ No critical hidden TODOs found in staged files"
+        TODO_CHECK_RAN=true
+      else
+        echo "❌ Critical hidden TODOs detected in staged files - commit blocked"
+        echo "💡 Fix stub implementations and placeholder code before committing"
+        echo "📖 See docs/PLACEHOLDER-DETECTION-GUIDE.md for classification"
+        echo ""
+        echo "🔍 Running detailed analysis on staged files..."
+        node "$TODO_ANALYZER" --staged-only --min-confidence 0.8
+        exit 1
+      fi
+    fi
   fi
   
-  # Run TODO analyzer if found
-  if [ -n "$TODO_ANALYZER" ] && command -v node >/dev/null 2>&1; then
-    if node "$TODO_ANALYZER" --staged-only --ci-mode --min-confidence 0.8 >/dev/null 2>&1; then
-      echo "✅ No critical hidden TODOs found in staged files"
-    else
-      echo "❌ Critical hidden TODOs detected in staged files - commit blocked"
-      echo "💡 Fix stub implementations and placeholder code before committing"
-      echo "📖 See docs/PLACEHOLDER-DETECTION-GUIDE.md for classification"
-      echo ""
-      echo "🔍 Running detailed analysis on staged files..."
-      node "$TODO_ANALYZER" --staged-only --min-confidence 0.8
-      exit 1
-    fi
-  # Fallback to legacy Python analyzer (deprecated - will be removed)
-  elif command -v python3 >/dev/null 2>&1 && [ -f "scripts/v3/analysis/todo_analyzer.py" ]; then
+  # Option 2: Fallback to legacy Python analyzer (deprecated - will be removed)
+  if [ "$TODO_CHECK_RAN" = false ] && command -v python3 >/dev/null 2>&1 && [ -f "scripts/v3/analysis/todo_analyzer.py" ]; then
     echo "⚠️  Using legacy Python TODO analyzer (deprecated)"
-    echo "💡 Install @paths.design/quality-gates for Node.js version: npm install --save-dev @paths.design/quality-gates"
     if python3 scripts/v3/analysis/todo_analyzer.py --staged-only --ci-mode --min-confidence 0.8 >/dev/null 2>&1; then
       echo "✅ No critical hidden TODOs found in staged files"
+      TODO_CHECK_RAN=true
     else
       echo "❌ Critical hidden TODOs detected in staged files - commit blocked"
       echo "💡 Fix stub implementations and placeholder code before committing"
@@ -371,9 +382,16 @@ if [ "$QUALITY_GATES_RAN" = true ]; then
       python3 scripts/v3/analysis/todo_analyzer.py --staged-only --min-confidence 0.8
       exit 1
     fi
-  else
+  fi
+  
+  # Option 3: No analyzer available - show language-aware suggestions
+  if [ "$TODO_CHECK_RAN" = false ]; then
     echo "⚠️  TODO analyzer not available - skipping hidden TODO check"
-    echo "💡 Install @paths.design/quality-gates for TODO analysis: npm install --save-dev @paths.design/quality-gates"
+    echo "💡 Available options for TODO analysis:"
+${todoSuggestion
+  .split('\n')
+  .map((line) => `    echo "${line.replace(/"/g, '\\"')}"`)
+  .join('\n')}
   fi
 fi
 
@@ -444,8 +462,8 @@ for arg in "$@"; do
     echo "💡 To fix issues locally:"
     echo "   1. Run: caws validate"
     echo "   2. Fix reported issues"
-    echo "   3. Commit fixes: git commit --no-verify (allowed)"
-    echo "   4. Push again: git push (no --no-verify)"
+    echo "   3. Commit fixes: git commit --no-verify \\(allowed\\)"
+    echo "   4. Push again: git push \\(no --no-verify\\)"
     exit 1
   fi
 done
@@ -508,13 +526,13 @@ if command -v caws >/dev/null 2>&1; then
       echo "   No active waivers found"
       echo ""
       echo "💡 If this is infrastructure/setup work, you can create a waiver:"
-      echo "   caws waivers create \\"
-      echo "     --title='Initial CAWS setup' \\"
-      echo "     --reason=infrastructure_limitation \\"
-      echo "     --gates=contracts \\"
-      echo "     --expires-at='2024-12-31T23:59:59Z' \\"
-      echo "     --approved-by='@your-team' \\"
-      echo "     --impact-level=low \\"
+      echo "   caws waivers create \\\\"
+      echo "     --title='Initial CAWS setup' \\\\"
+      echo "     --reason=infrastructure_limitation \\\\"
+      echo "     --gates=contracts \\\\"
+      echo "     --expires-at='2024-12-31T23:59:59Z' \\\\"
+      echo "     --approved-by='@your-team' \\\\"
+      echo "     --impact-level=low \\\\"
       echo "     --mitigation-plan='Contracts will be added as features are developed'"
     fi
     
@@ -523,43 +541,121 @@ if command -v caws >/dev/null 2>&1; then
     echo "Next Steps:"
     echo "   1. Review errors above"
     echo "   2. Fix issues in .caws/working-spec.yaml"
-    echo "   3. Run: caws validate (to verify fixes)"
-    echo "   4. Commit fixes: git commit --no-verify (allowed)"
+    echo "   3. Run: caws validate \\(to verify fixes\\)"
+    echo "   4. Commit fixes: git commit --no-verify \\(allowed\\)"
     echo "   5. Push again: git push"
     echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
     exit 1
   fi
 fi
 
-# Run security checks
+# Run full pre-push checks (full test suite required before push)
+# Note: Pre-commit uses filtered tests for speed, but push requires full suite
+echo ""
+echo "⚡ Running full pre-push checks (full test suite required)..."
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+
+QUICK_CHECKS_FAILED=false
+
+# 1. Linting (fast)
+if [ -f "package.json" ]; then
+  if command -v npm >/dev/null 2>&1; then
+    if grep -q '"lint"' package.json; then
+      echo "🔍 Running linting..."
+      if npm run lint >/dev/null 2>&1; then
+        echo "✅ Linting passed"
+      else
+        echo "❌ Linting failed"
+        echo "💡 Fix lint errors: npm run lint"
+        QUICK_CHECKS_FAILED=true
+      fi
+    fi
+  fi
+fi
+
+# 2. Type checking (fast for TypeScript/JavaScript)
+if [ -f "package.json" ]; then
+  if command -v npm >/dev/null 2>&1; then
+    if grep -q '"typecheck"' package.json; then
+      echo "🔍 Running type checking..."
+      if npm run typecheck >/dev/null 2>&1; then
+        echo "✅ Type checking passed"
+      else
+        echo "❌ Type checking failed"
+        echo "💡 Fix type errors: npm run typecheck"
+        QUICK_CHECKS_FAILED=true
+      fi
+    fi
+  fi
+fi
+
+# 3. Run FULL test suite (required for push) - no filtering
+# Pre-commit uses filtered tests for speed, but push requires full suite
+if [ -f "package.json" ]; then
+  if command -v npm >/dev/null 2>&1 && grep -q '"test"' package.json; then
+    echo "🧪 Running FULL test suite (required for push)..."
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+    if npm test 2>&1 | tee /tmp/pre-push-test-full.log; then
+      echo "✅ Full test suite passed"
+      rm -f /tmp/pre-push-test-full.log
+    else
+      FULL_TEST_EXIT_CODE=\${PIPESTATUS[0]}
+      echo "❌ Full test suite failed (exit code: \${FULL_TEST_EXIT_CODE})"
+      echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+      echo "Test output (last 100 lines):"
+      tail -100 /tmp/pre-push-test-full.log 2>/dev/null || echo "No test output captured"
+      echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+      echo "💡 Fix test failures before pushing: npm test"
+      rm -f /tmp/pre-push-test-full.log
+      QUICK_CHECKS_FAILED=true
+    fi
+  fi
+fi
+
+# 4. Security checks (non-blocking warnings)
+echo ""
 echo "🔒 Running security checks..."
 if [ -f "package.json" ]; then
-  # Check for vulnerabilities
   if command -v npm >/dev/null 2>&1; then
     echo "🔍 Checking for vulnerabilities..."
     if npm audit --audit-level moderate >/dev/null 2>&1; then
       echo "✅ Security audit passed"
     else
-      echo "⚠️  Security vulnerabilities found"
+      echo "⚠️  Security vulnerabilities found (non-blocking)"
       echo "💡 Review with: npm audit"
-      # Don't fail on warnings, just warn
     fi
   fi
 elif [ -f "requirements.txt" ] || [ -f "pyproject.toml" ]; then
-  # Python project security checks
   if command -v pip-audit >/dev/null 2>&1; then
     echo "🔍 Checking Python vulnerabilities..."
-    pip-audit --desc 2>/dev/null || echo "⚠️  Install pip-audit for vulnerability checks: pip install pip-audit"
+    pip-audit --desc 2>/dev/null || echo "⚠️  Install pip-audit: pip install pip-audit"
   fi
 elif [ -f "Cargo.toml" ]; then
-  # Rust project security checks
   if command -v cargo-audit >/dev/null 2>&1; then
     echo "🔍 Checking Rust vulnerabilities..."
-    cargo audit 2>/dev/null || echo "⚠️  Install cargo-audit for vulnerability checks: cargo install cargo-audit"
+    cargo audit 2>/dev/null || echo "⚠️  Install cargo-audit: cargo install cargo-audit"
   fi
 fi
 
-echo "🎉 Pre-push checks completed!"
+# Fail if any checks failed
+if [ "$QUICK_CHECKS_FAILED" = true ]; then
+  echo ""
+  echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+  echo "❌ Pre-push checks failed"
+  echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+  echo "All checks (linting/type checking/full test suite) must pass before push."
+  echo ""
+  echo "💡 Fix failures before pushing:"
+  echo "   - Linting: npm run lint"
+  echo "   - Type checking: npm run typecheck"
+  echo "   - Tests: npm test"
+  echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+  exit 1
+fi
+
+echo ""
+echo "✅ Pre-push checks completed!"
+echo "💡 All quality gates passed - ready to push"
 `;
 }
 
@@ -583,7 +679,7 @@ fi
 
 # Basic commit message validation
 if [ \${#COMMIT_MSG} -lt 10 ]; then
-  echo "❌ Commit message too short (minimum 10 characters)"
+  echo "❌ Commit message too short \\(minimum 10 characters\\)"
   echo "💡 Write descriptive commit messages"
   exit 1
 fi
@@ -700,4 +796,9 @@ module.exports = {
   scaffoldGitHooks,
   removeGitHooks,
   checkGitHooksStatus,
+  // Export generator functions for testing
+  generatePrePushHook,
+  generatePreCommitHook,
+  generatePostCommitHook,
+  generateCommitMsgHook,
 };

package/dist/scaffold/index.d.ts

@@ -3,12 +3,7 @@
  * @param {Object} options - Scaffold options
  */
 export function scaffoldProject(options: any): Promise<void>;
-/**
- * Scaffold IDE integrations for comprehensive CAWS development experience
- * @param {string} targetDir - Target directory for scaffolding
- * @param {Object} options - Scaffold options
- */
-export function scaffoldIDEIntegrations(targetDir: string, options: any): Promise<{
+export function scaffoldIDEIntegrations(targetDir: any, options: any): Promise<{
     added: number;
     skipped: number;
 }>;

package/dist/scaffold/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/scaffold/index.js"],"names":[],"mappings":"AAkKA;;;GAGG;AACH,6DA6VC;AAhfD;;;;GAIG;AACH,mDAHW,MAAM;;;GA8HhB;AAMD;;;GAGG;AACH,yDAGC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/scaffold/index.js"],"names":[],"mappings":"AA6LA;;;GAGG;AACH,6DA6jBC;AA3sBD;;;GA2HC;AAMD;;;GAGG;AACH,yDAGC"}

package/dist/scaffold/index.js

@@ -735,7 +735,7 @@ async function scaffoldProject(options) {
     }
 
     // Update .gitignore to exclude CAWS local runtime files
-    const gitignoreUpdated = await updateGitignore(targetDir);
+    const gitignoreUpdated = await updateGitignore(currentDir);
     if (gitignoreUpdated) {
       console.log(chalk.green('\n✅ Updated .gitignore to exclude CAWS local runtime files'));
       console.log(

package/dist/templates/.caws/tools/README.md

@@ -18,3 +18,4 @@ node .caws/tools/scope-guard.js check .caws/working-spec.yaml
 
 The `.cursor/hooks/scope-guard.sh` hook automatically uses this tool to validate file attachments against working spec scope boundaries.
 
+

package/dist/tool-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-loader.d.ts","sourceRoot":"","sources":["../src/tool-loader.js"],"names":[],"mappings":";;AAcA;;;GAGG;AACH;IACE,0BAaC;IAXC;;;;;MAMC;IAED,2BAA4B;IAC5B,0BAAgC;IAChC,qBAA0B;IAG5B;;;OAGG;IACH,iBAFa,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAkDlC;IAED;;;;OAIG;IACH,mBAHW,MAAM,GACJ,OAAO,KAAQ,CAmC3B;IAED;;;OAGG;IACH,gBAFa,OAAO,CAAC,GAAG,CAAC,MAAM,MAAS,CAAC,CAuBxC;IAED;;;;OAIG;IACH,gBAHW,MAAM,GACJ,MAAO,IAAI,CAIvB;IAED;;;OAGG;IACH,eAFa,GAAG,CAAC,MAAM,MAAS,CAI/B;IAED;;;;OAIG;IACH,mBAHW,MAAM,GACJ,OAAO,CAQnB;IAED;;;;OAIG;IACH,yBAgCC;IAED;;;;OAIG;IACH,8BAkBC;IAED;;;;;OAKG;IACH,8BAyBC;IAED;;;OAGG;IACH,gBAQC;CACF"}
+{"version":3,"file":"tool-loader.d.ts","sourceRoot":"","sources":["../src/tool-loader.js"],"names":[],"mappings":";;AAcA;;;GAGG;AACH;IACE,0BAkBC;IAXC;;;;;MAMC;IAED,2BAA4B;IAC5B,0BAAgC;IAChC,qBAA0B;IAG5B;;;OAGG;IACH,iBAFa,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAkDlC;IAED;;;;OAIG;IACH,mBAHW,MAAM,GACJ,OAAO,KAAQ,CAmC3B;IAED;;;OAGG;IACH,gBAFa,OAAO,CAAC,GAAG,CAAC,MAAM,MAAS,CAAC,CAuBxC;IAED;;;;OAIG;IACH,gBAHW,MAAM,GACJ,MAAO,IAAI,CAIvB;IAED;;;OAGG;IACH,eAFa,GAAG,CAAC,MAAM,MAAS,CAI/B;IAED;;;;OAIG;IACH,mBAHW,MAAM,GACJ,OAAO,CAQnB;IAED;;;;OAIG;IACH,yBAgCC;IAED;;;;OAIG;IACH,8BAkBC;IAED;;;;;OAKG;IACH,8BAyBC;IAED;;;OAGG;IACH,gBAQC;CACF"}

package/dist/tool-validator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-validator.d.ts","sourceRoot":"","sources":["../src/tool-validator.js"],"names":[],"mappings":";;AAYA;;GAEG;AACH;IACE,0BAWC;IAVC;;;;MAMC;IAED,eAAqB;IACrB,+BAAgC;IAGlC;;;OAGG;IACH,iBAFa,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAqBlC;IAED;;;;OAIG;IACH,yBAFa,OAAO,KAAQ,CAsF3B;IAED;;;;OAIG;IACH,0BAgCC;IAED;;;;OAIG;IACH,0BA8CC;IAED;;;;OAIG;IACH,iCAkBC;IAED;;;;OAIG;IACH,8BAqCC;IAED;;;;OAIG;IACH,8BA4BC;IAED;;;;OAIG;IACH,yBAHW,MAAM,GACJ,OAAO,CAmBnB;IAED;;OAEG;IACH,mBAEC;IAED;;;OAGG;IACH,gBAOC;CACF"}
+{"version":3,"file":"tool-validator.d.ts","sourceRoot":"","sources":["../src/tool-validator.js"],"names":[],"mappings":";;AAYA;;GAEG;AACH;IACE,0BAiBC;IATC;;;;MAKC;IAED,eAAqB;IACrB,+BAAgC;IAGlC;;;OAGG;IACH,iBAFa,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAqBlC;IAED;;;;OAIG;IACH,yBAFa,OAAO,KAAQ,CAsF3B;IAED;;;;OAIG;IACH,0BAgCC;IAED;;;;OAIG;IACH,0BA8CC;IAED;;;;OAIG;IACH,iCAkBC;IAED;;;;OAIG;IACH,8BAqCC;IAED;;;;OAIG;IACH,8BA4BC;IAED;;;;OAIG;IACH,yBAHW,MAAM,GACJ,OAAO,CAmBnB;IAED;;OAEG;IACH,mBAEC;IAED;;;OAGG;IACH,gBAOC;CACF"}

package/dist/utils/async-utils.d.ts

@@ -0,0 +1,73 @@
+/**
+ * @fileoverview Async Operation Utilities
+ * Provides consistent patterns for async operations, parallel execution, and resource cleanup
+ * @author @darianrosebrook
+ */
+/**
+ * Execute multiple async operations in parallel
+ * @param {Array<Promise>} promises - Array of promises to execute
+ * @param {Object} options - Options
+ * @param {boolean} [options.failFast=true] - Stop on first error
+ * @returns {Promise<Array>} Array of results
+ */
+export function parallel(promises: Array<Promise<any>>, options?: {
+    failFast?: boolean;
+}): Promise<any[]>;
+/**
+ * Execute async operations sequentially
+ * @param {Array<Function>} operations - Array of async functions to execute
+ * @param {Object} options - Options
+ * @param {boolean} [options.stopOnError=true] - Stop on first error
+ * @returns {Promise<Array>} Array of results
+ */
+export function sequential(operations: Array<Function>, options?: {
+    stopOnError?: boolean;
+}): Promise<any[]>;
+/**
+ * Retry an async operation with exponential backoff
+ * @param {Function} operation - Async function to retry
+ * @param {Object} options - Retry options
+ * @param {number} [options.maxRetries=3] - Maximum number of retries
+ * @param {number} [options.initialDelay=1000] - Initial delay in ms
+ * @param {number} [options.maxDelay=10000] - Maximum delay in ms
+ * @param {Function} [options.shouldRetry] - Function to determine if error should be retried
+ * @returns {Promise<any>} Operation result
+ */
+export function retry(operation: Function, options?: {
+    maxRetries?: number;
+    initialDelay?: number;
+    maxDelay?: number;
+    shouldRetry?: Function;
+}): Promise<any>;
+/**
+ * Execute operation with timeout
+ * @param {Promise} promise - Promise to execute
+ * @param {number} timeoutMs - Timeout in milliseconds
+ * @param {string} [errorMessage] - Custom error message
+ * @returns {Promise<any>} Operation result
+ */
+export function withTimeout(promise: Promise<any>, timeoutMs: number, errorMessage?: string): Promise<any>;
+/**
+ * Execute operation with resource cleanup
+ * @param {Function} operation - Async operation to execute
+ * @param {Function} cleanup - Cleanup function (called in finally)
+ * @returns {Promise<any>} Operation result
+ */
+export function withCleanup(operation: Function, cleanup: Function): Promise<any>;
+/**
+ * Execute multiple operations and collect all errors
+ * @param {Array<Function>} operations - Array of async functions
+ * @returns {Promise<{successes: Array, errors: Array}>} Results and errors
+ */
+export function collectResults(operations: Array<Function>): Promise<{
+    successes: any[];
+    errors: any[];
+}>;
+/**
+ * Execute operation with cancellation support
+ * @param {Function} operation - Async operation to execute
+ * @param {AbortSignal} signal - Abort signal for cancellation
+ * @returns {Promise<any>} Operation result
+ */
+export function withCancellation(operation: Function, signal: AbortSignal): Promise<any>;
+//# sourceMappingURL=async-utils.d.ts.map

package/dist/utils/async-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-utils.d.ts","sourceRoot":"","sources":["../../src/utils/async-utils.js"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;GAMG;AACH,mCALW,KAAK,cAAS,YAEtB;IAA0B,QAAQ,GAA1B,OAAO;CACf,GAAU,OAAO,OAAO,CAmB1B;AAED;;;;;;GAMG;AACH,uCALW,KAAK,UAAU,YAEvB;IAA0B,WAAW,GAA7B,OAAO;CACf,GAAU,OAAO,OAAO,CAmB1B;AAED;;;;;;;;;GASG;AACH,qDANG;IAAyB,UAAU,GAA3B,MAAM;IACW,YAAY,GAA7B,MAAM;IACW,QAAQ,GAAzB,MAAM;IACa,WAAW;CACtC,GAAU,OAAO,CAAC,GAAG,CAAC,CA+BxB;AAED;;;;;;GAMG;AACH,8DAJW,MAAM,iBACN,MAAM,GACJ,OAAO,CAAC,GAAG,CAAC,CAWxB;AAED;;;;;GAKG;AACH,qEAFa,OAAO,CAAC,GAAG,CAAC,CAQxB;AAED;;;;GAIG;AACH,2CAHW,KAAK,UAAU,GACb,OAAO,CAAC;IAAC,SAAS,QAAQ;IAAC,MAAM,QAAO;CAAC,CAAC,CAmBtD;AAED;;;;;GAKG;AACH,8DAHW,WAAW,GACT,OAAO,CAAC,GAAG,CAAC,CAgBxB"}

package/dist/utils/command-wrapper.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Unified command wrapper that provides:
+ * - Consistent error handling
+ * - Standardized output formatting
+ * - Execution timing
+ * - JSON output support
+ *
+ * @param {Function} commandFn - Async command function to execute
+ * @param {Object} options - Command options
+ * @param {string} options.commandName - Name of the command (for error context)
+ * @param {boolean} [options.includeTiming=true] - Include execution timing
+ * @param {boolean} [options.exitOnError=true] - Exit process on error
+ * @param {Object} [options.context={}] - Additional context for error handling
+ * @returns {Promise<any>} Command result
+ */
+export function commandWrapper(commandFn: Function, options?: {
+    commandName: string;
+    includeTiming?: boolean;
+    exitOnError?: boolean;
+    context?: any;
+}): Promise<any>;
+export namespace Output {
+    /**
+     * Output success message
+     * @param {string} message - Success message
+     * @param {Object} [data] - Additional data to output
+     */
+    function success(message: string, data?: any): void;
+    /**
+     * Output error message
+     * @param {string} message - Error message
+     * @param {string[]} [suggestions] - Recovery suggestions
+     */
+    function error(message: string, suggestions?: string[]): void;
+    /**
+     * Output warning message
+     * @param {string} message - Warning message
+     * @param {string} [suggestion] - Optional suggestion
+     */
+    function warning(message: string, suggestion?: string): void;
+    /**
+     * Output info message
+     * @param {string} message - Info message
+     * @param {Object} [data] - Additional data
+     */
+    function info(message: string, data?: any): void;
+    /**
+     * Output data in JSON format
+     * @param {Object} data - Data to output
+     * @param {boolean} [success=true] - Whether operation was successful
+     */
+    function json(data: any, success?: boolean): void;
+    /**
+     * Output progress message
+     * @param {string} message - Progress message
+     */
+    function progress(message: string): void;
+    /**
+     * Output section header
+     * @param {string} title - Section title
+     */
+    function section(title: string): void;
+}
+import { isJsonOutput } from "../error-handler";
+export { isJsonOutput };
+//# sourceMappingURL=command-wrapper.d.ts.map

package/dist/utils/command-wrapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-wrapper.d.ts","sourceRoot":"","sources":["../../src/utils/command-wrapper.js"],"names":[],"mappings":"AASA;;;;;;;;;;;;;;GAcG;AACH,8DANG;IAAwB,WAAW,EAA3B,MAAM;IACY,aAAa,GAA/B,OAAO;IACW,WAAW,GAA7B,OAAO;IACU,OAAO;CAChC,GAAU,OAAO,CAAC,GAAG,CAAC,CAuCxB;;IAMC;;;;OAIG;IACH,0BAHW,MAAM,oBAmBhB;IAED;;;;OAIG;IACH,wBAHW,MAAM,gBACN,MAAM,EAAE,QAuBlB;IAED;;;;OAIG;IACH,0BAHW,MAAM,eACN,MAAM,QAkBhB;IAED;;;;OAIG;IACH,uBAHW,MAAM,oBAmBhB;IAED;;;;OAIG;IACH,mCAFW,OAAO,QAIjB;IAED;;;OAGG;IACH,2BAFW,MAAM,QAMhB;IAED;;;OAGG;IACH,wBAFW,MAAM,QAOhB"}

package/dist/utils/detection.d.ts

@@ -4,4 +4,11 @@
  * @returns {Object} Setup information
  */
 export function detectCAWSSetup(cwd?: string): any;
+/**
+ * Find the package root directory by looking for package.json
+ * Works in both development (src/) and production (dist/) scenarios
+ * @param {string} startDir - Directory to start searching from (defaults to __dirname)
+ * @returns {string} Package root directory path
+ */
+export function findPackageRoot(startDir?: string): string;
 //# sourceMappingURL=detection.d.ts.map

package/dist/utils/detection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"detection.d.ts","sourceRoot":"","sources":["../../src/utils/detection.js"],"names":[],"mappings":"AAUA;;;;GAIG;AACH,sCAHW,MAAM,OA6JhB"}
+{"version":3,"file":"detection.d.ts","sourceRoot":"","sources":["../../src/utils/detection.js"],"names":[],"mappings":"AA6BA;;;;GAIG;AACH,sCAHW,MAAM,OAqKhB;AA1LD;;;;;GAKG;AACH,2CAHW,MAAM,GACJ,MAAM,CAalB"}

package/dist/utils/git-lock.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Check for git lock files
+ * @param {string} projectRoot - Project root directory
+ * @returns {Object} Lock status information
+ */
+export function checkGitLock(projectRoot: string): any;
+/**
+ * Format git lock error message
+ * @param {Object} lockStatus - Lock status from checkGitLock
+ * @returns {string} Formatted error message
+ */
+export function formatGitLockError(lockStatus: any): string;
+//# sourceMappingURL=git-lock.d.ts.map

package/dist/utils/git-lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-lock.d.ts","sourceRoot":"","sources":["../../src/utils/git-lock.js"],"names":[],"mappings":"AASA;;;;GAIG;AACH,0CAHW,MAAM,OA+DhB;AAED;;;;GAIG;AACH,qDAFa,MAAM,CAgClB"}

package/dist/utils/git-lock.js

@@ -116,3 +116,4 @@ module.exports = {
   formatGitLockError,
 };
 
+