@paths.design/caws-cli 7.0.3 → 8.0.1

package/dist/utils/gitignore-updater.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Update .gitignore to include CAWS runtime file exclusions
+ * @param {string} projectRoot - Project root directory
+ * @param {Object} options - Options
+ * @param {boolean} options.force - Force update even if entries exist
+ * @returns {Promise<boolean>} Whether .gitignore was updated
+ */
+export function updateGitignore(projectRoot: string, options?: {
+    force: boolean;
+}): Promise<boolean>;
+/**
+ * Verify .gitignore has proper CAWS entries
+ * @param {string} projectRoot - Project root directory
+ * @returns {Promise<boolean>} Whether .gitignore has CAWS entries
+ */
+export function verifyGitignore(projectRoot: string): Promise<boolean>;
+/**
+ * CAWS .gitignore entries
+ *
+ * Strategy: Track shared/collaborative files, ignore local-only runtime data
+ *
+ * TRACKED (shared with team):
+ * - .caws/working-spec.yaml (main spec)
+ * - .caws/specs/*.yaml (feature specs)
+ * - .caws/policy.yaml (team policy)
+ * - .caws/waivers/*.yaml (project-wide waivers)
+ * - .caws/provenance/ (audit trails for compliance)
+ * - .caws/changes/ (change tracking for team visibility)
+ * - .caws/archive/ (archived changes for history)
+ * - .caws/plans/*.md (implementation plans)
+ *
+ * IGNORED (local-only):
+ * - .agent/ (agent runtime tracking, local to each developer)
+ * - Temporary files (*.tmp, *.bak)
+ * - Logs (caws.log, debug logs)
+ * - Local overrides (caws.local.*)
+ */
+export const CAWS_GITIGNORE_ENTRIES: "\n# CAWS Local Runtime Data (developer-specific, should not be tracked)\n# ====================================================================\n# Note: Specs, policy, waivers, provenance, and plans ARE tracked for team collaboration\n# Only local agent tracking, generated tools, and temporary files are ignored\n\n# Agent runtime tracking (local to each developer)\n.agent/\n\n# CAWS tools (now in .caws/tools/)\n.caws/tools/\n# Legacy location (for backward compatibility)\napps/tools/caws/\n\n# Temporary CAWS files\n**/*.caws.tmp\n**/*.working-spec.bak\n.caws/*.tmp\n.caws/*.bak\n\n# CAWS logs (local debugging)\ncaws-debug.log*\n**/caws.log\n.caws/*.log\n\n# Local development overrides (developer-specific)\ncaws.local.*\n.caws/local.*\n";
+//# sourceMappingURL=gitignore-updater.d.ts.map

package/dist/utils/gitignore-updater.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitignore-updater.d.ts","sourceRoot":"","sources":["../../src/utils/gitignore-updater.js"],"names":[],"mappings":"AA6DA;;;;;;GAMG;AACH,6CALW,MAAM,YAEd;IAAyB,KAAK,EAAtB,OAAO;CACf,GAAU,OAAO,CAAC,OAAO,CAAC,CA2D5B;AAED;;;;GAIG;AACH,6CAHW,MAAM,GACJ,OAAO,CAAC,OAAO,CAAC,CAW5B;AAnID;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,gxBA4BE"}

package/dist/utils/project-analysis.d.ts

@@ -11,4 +11,24 @@ export function detectProjectType(cwd?: string): string;
  * @returns {boolean} Whether to init in current directory
  */
 export function shouldInitInCurrentDirectory(projectName: string, currentDir: string): boolean;
+/**
+ * Detect if project publishes packages to registries
+ * Checks for publishing configuration in package.json, pyproject.toml, etc.
+ * @param {string} cwd - Current working directory
+ * @returns {boolean} Whether project appears to publish packages
+ */
+export function detectsPublishing(cwd?: string): boolean;
+/**
+ * Detect primary programming language(s) used in project
+ * @param {string} cwd - Current working directory
+ * @returns {Object} Language detection result with primary language and indicators
+ */
+export function detectProjectLanguage(cwd?: string): any;
+/**
+ * Get language-agnostic suggestion for TODO analyzer installation
+ * Focuses on runtime availability (Node.js/npx) rather than project language
+ * @param {string} cwd - Current working directory
+ * @returns {string} Installation suggestion message
+ */
+export function getTodoAnalyzerSuggestion(cwd?: string): string;
 //# sourceMappingURL=project-analysis.d.ts.map

package/dist/utils/project-analysis.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"project-analysis.d.ts","sourceRoot":"","sources":["../../src/utils/project-analysis.js"],"names":[],"mappings":"AASA;;;;GAIG;AACH,wCAHW,MAAM,GACJ,MAAM,CAmDlB;AAED;;;;;GAKG;AACH,0DAJW,MAAM,cACN,MAAM,GACJ,OAAO,CA8BnB"}
+{"version":3,"file":"project-analysis.d.ts","sourceRoot":"","sources":["../../src/utils/project-analysis.js"],"names":[],"mappings":"AASA;;;;GAIG;AACH,wCAHW,MAAM,GACJ,MAAM,CAmDlB;AAED;;;;;GAKG;AACH,0DAJW,MAAM,cACN,MAAM,GACJ,OAAO,CA8BnB;AAED;;;;;GAKG;AACH,wCAHW,MAAM,GACJ,OAAO,CAsFnB;AAED;;;;GAIG;AACH,4CAHW,MAAM,OAiHhB;AAED;;;;;GAKG;AACH,gDAHW,MAAM,GACJ,MAAM,CA6ClB"}

package/dist/utils/project-analysis.js

@@ -111,9 +111,7 @@ function detectsPublishing(cwd = process.cwd()) {
   // Check package.json for npm publishing
   if (files.includes('package.json')) {
     try {
-      const packageJson = JSON.parse(
-        fs.readFileSync(path.join(cwd, 'package.json'), 'utf8')
-      );
+      const packageJson = JSON.parse(fs.readFileSync(path.join(cwd, 'package.json'), 'utf8'));
 
       // Indicators of publishing:
       // - Has publishConfig
@@ -123,9 +121,7 @@ function detectsPublishing(cwd = process.cwd()) {
       const hasPublishConfig = packageJson.publishConfig;
       const hasPublishScript =
         packageJson.scripts &&
-        Object.keys(packageJson.scripts).some((key) =>
-          key.toLowerCase().includes('publish')
-        );
+        Object.keys(packageJson.scripts).some((key) => key.toLowerCase().includes('publish'));
       const hasScopedName = packageJson.name && packageJson.name.startsWith('@');
       const hasRepository = packageJson.repository;
 
@@ -140,16 +136,13 @@ function detectsPublishing(cwd = process.cwd()) {
   // Check pyproject.toml for PyPI publishing
   if (files.includes('pyproject.toml')) {
     try {
-      const pyprojectContent = fs.readFileSync(
-        path.join(cwd, 'pyproject.toml'),
-        'utf8'
-      );
+      const pyprojectContent = fs.readFileSync(path.join(cwd, 'pyproject.toml'), 'utf8');
 
       // Check for build system and project metadata (indicates publishable package)
       const hasBuildSystem = pyprojectContent.includes('[build-system]');
       const hasProjectMetadata = pyprojectContent.includes('[project]');
-      const hasToolPublish = pyprojectContent.includes('[tool.publish]') ||
-                            pyprojectContent.includes('[tool.twine]');
+      const hasToolPublish =
+        pyprojectContent.includes('[tool.publish]') || pyprojectContent.includes('[tool.twine]');
 
       if ((hasBuildSystem && hasProjectMetadata) || hasToolPublish) {
         return true;
@@ -177,10 +170,7 @@ function detectsPublishing(cwd = process.cwd()) {
       const workflowFiles = fs.readdirSync(workflowsPath);
       for (const workflowFile of workflowFiles) {
         if (workflowFile.endsWith('.yml') || workflowFile.endsWith('.yaml')) {
-          const workflowContent = fs.readFileSync(
-            path.join(workflowsPath, workflowFile),
-            'utf8'
-          );
+          const workflowContent = fs.readFileSync(path.join(workflowsPath, workflowFile), 'utf8');
           // Check for common publishing actions/commands
           if (
             workflowContent.includes('npm publish') ||
@@ -201,8 +191,178 @@ function detectsPublishing(cwd = process.cwd()) {
   return false;
 }
 
+/**
+ * Detect primary programming language(s) used in project
+ * @param {string} cwd - Current working directory
+ * @returns {Object} Language detection result with primary language and indicators
+ */
+function detectProjectLanguage(cwd = process.cwd()) {
+  const files = fs.readdirSync(cwd);
+  const indicators = {
+    javascript: false,
+    typescript: false,
+    python: false,
+    rust: false,
+    go: false,
+    java: false,
+    csharp: false,
+    php: false,
+  };
+
+  // JavaScript/TypeScript indicators
+  if (files.includes('package.json')) {
+    indicators.javascript = true;
+    try {
+      const packageJson = JSON.parse(fs.readFileSync(path.join(cwd, 'package.json'), 'utf8'));
+      const allDeps = {
+        ...(packageJson.dependencies || {}),
+        ...(packageJson.devDependencies || {}),
+      };
+      if ('typescript' in allDeps || files.includes('tsconfig.json')) {
+        indicators.typescript = true;
+        indicators.javascript = false; // TypeScript supersedes JavaScript
+      }
+    } catch (e) {
+      // Ignore parse errors
+    }
+  }
+
+  // Python indicators
+  if (
+    files.includes('requirements.txt') ||
+    files.includes('pyproject.toml') ||
+    files.includes('setup.py') ||
+    files.includes('Pipfile') ||
+    files.includes('poetry.lock') ||
+    files.some((f) => f.endsWith('.py'))
+  ) {
+    indicators.python = true;
+  }
+
+  // Rust indicators
+  if (files.includes('Cargo.toml') || files.some((f) => f.endsWith('.rs'))) {
+    indicators.rust = true;
+  }
+
+  // Go indicators
+  if (
+    files.includes('go.mod') ||
+    files.includes('go.sum') ||
+    files.some((f) => f.endsWith('.go'))
+  ) {
+    indicators.go = true;
+  }
+
+  // Java indicators
+  if (
+    files.includes('pom.xml') ||
+    files.includes('build.gradle') ||
+    files.some((f) => f.endsWith('.java'))
+  ) {
+    indicators.java = true;
+  }
+
+  // C# indicators
+  if (
+    files.some((f) => f.endsWith('.csproj')) ||
+    files.some((f) => f.endsWith('.sln')) ||
+    files.some((f) => f.endsWith('.cs'))
+  ) {
+    indicators.csharp = true;
+  }
+
+  // PHP indicators
+  if (
+    files.includes('composer.json') ||
+    files.includes('composer.lock') ||
+    files.some((f) => f.endsWith('.php'))
+  ) {
+    indicators.php = true;
+  }
+
+  // Determine primary language (priority order)
+  let primaryLanguage = 'unknown';
+  if (indicators.typescript) {
+    primaryLanguage = 'typescript';
+  } else if (indicators.javascript) {
+    primaryLanguage = 'javascript';
+  } else if (indicators.python) {
+    primaryLanguage = 'python';
+  } else if (indicators.rust) {
+    primaryLanguage = 'rust';
+  } else if (indicators.go) {
+    primaryLanguage = 'go';
+  } else if (indicators.java) {
+    primaryLanguage = 'java';
+  } else if (indicators.csharp) {
+    primaryLanguage = 'csharp';
+  } else if (indicators.php) {
+    primaryLanguage = 'php';
+  }
+
+  return {
+    primary: primaryLanguage,
+    indicators,
+    hasNodeJs: indicators.javascript || indicators.typescript,
+    hasPython: indicators.python,
+  };
+}
+
+/**
+ * Get language-agnostic suggestion for TODO analyzer installation
+ * Focuses on runtime availability (Node.js/npx) rather than project language
+ * @param {string} cwd - Current working directory
+ * @returns {string} Installation suggestion message
+ */
+function getTodoAnalyzerSuggestion(cwd = process.cwd()) {
+  // Check runtime availability (language-agnostic)
+  let hasNodeJs = false;
+  let hasNpx = false;
+  try {
+    const { execSync } = require('child_process');
+    execSync('command -v node', { encoding: 'utf8', stdio: 'ignore' });
+    hasNodeJs = true;
+    execSync('command -v npx', { encoding: 'utf8', stdio: 'ignore' });
+    hasNpx = true;
+  } catch (e) {
+    // Node.js/npx not available
+  }
+
+  const suggestions = [];
+
+  if (hasNpx) {
+    // npx available - works for any language, no installation needed
+    suggestions.push(
+      '   • Use npx (no installation required): npx --yes @paths.design/quality-gates'
+    );
+    suggestions.push('   • Install package: npm install --save-dev @paths.design/quality-gates');
+  } else if (hasNodeJs) {
+    // Node.js available but npx not found (unusual)
+    suggestions.push('   • Install package: npm install --save-dev @paths.design/quality-gates');
+    suggestions.push(
+      '   • Install npx: npm install -g npx (then use: npx --yes @paths.design/quality-gates)'
+    );
+  } else {
+    // Node.js not available - suggest installation
+    suggestions.push(
+      '   • Install Node.js: https://nodejs.org/ (then use: npx --yes @paths.design/quality-gates)'
+    );
+    suggestions.push('   • Use CAWS MCP server: caws quality-gates (via MCP)');
+  }
+
+  // Check for project-specific scripts (language-agnostic - if they exist, suggest them)
+  const pythonScript = path.join(cwd, 'scripts', 'v3', 'analysis', 'todo_analyzer.py');
+  if (fs.existsSync(pythonScript)) {
+    suggestions.push(`   • Use project script: python3 ${pythonScript}`);
+  }
+
+  return suggestions.join('\n');
+}
+
 module.exports = {
   detectProjectType,
   shouldInitInCurrentDirectory,
   detectsPublishing,
+  detectProjectLanguage,
+  getTodoAnalyzerSuggestion,
 };

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

@@ -0,0 +1,30 @@
+/**
+ * @fileoverview Promise Utilities
+ * Utilities for converting callback-based APIs to promises
+ * @author @darianrosebrook
+ */
+/**
+ * Convert readline question to promise
+ * @param {readline.Interface} rl - Readline interface
+ * @param {string} question - Question to ask
+ * @returns {Promise<string>} User's answer
+ */
+export function question(rl: readline.Interface, questionText: any): Promise<string>;
+/**
+ * Close readline interface and return promise
+ * @param {readline.Interface} rl - Readline interface
+ * @returns {Promise<void>}
+ */
+export function closeReadline(rl: readline.Interface): Promise<void>;
+/**
+ * Create a promise that resolves when event fires
+ * @param {EventEmitter} emitter - Event emitter
+ * @param {string} event - Event name
+ * @param {Object} options - Options
+ * @param {number} [options.timeout] - Timeout in ms
+ * @returns {Promise<any>} Event data
+ */
+export function once(emitter: EventEmitter, event: string, options?: {
+    timeout?: number;
+}): Promise<any>;
+//# sourceMappingURL=promise-utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"promise-utils.d.ts","sourceRoot":"","sources":["../../src/utils/promise-utils.js"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;GAKG;AACH,6BAJW,QAAQ,CAAC,SAAS,sBAEhB,OAAO,CAAC,MAAM,CAAC,CAQ3B;AAED;;;;GAIG;AACH,kCAHW,QAAQ,CAAC,SAAS,GAChB,OAAO,CAAC,IAAI,CAAC,CAOzB;AAED;;;;;;;GAOG;AACH,8BANW,YAAY,SACZ,MAAM,YAEd;IAAyB,OAAO,GAAxB,MAAM;CACd,GAAU,OAAO,CAAC,GAAG,CAAC,CAyBxB"}

package/dist/utils/quality-gates.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"quality-gates.d.ts","sourceRoot":"","sources":["../../src/utils/quality-gates.js"],"names":[],"mappings":"AAyGA;;;GAGG;AACH,kCAFa,MAAM,EAAE,CAcpB;AAED;;;;;GAKG;AACH,6CAJW,MAAM,EAAE,aACR,MAAM,OAqDhB;AAED;;;;GAIG;AACH,8CAHW,MAAM,EAAE,OA2ClB;AApMD;;;;GAIG;AACH,kCAHW,MAAM,OAiChB;AAED;;;GAGG;AACH,oCAFa,OAAO,CAkCnB;AA6HD;;;;GAIG;AACH,oDAqHC"}
+{"version":3,"file":"quality-gates.d.ts","sourceRoot":"","sources":["../../src/utils/quality-gates.js"],"names":[],"mappings":"AA0GA;;;GAGG;AACH,kCAFa,MAAM,EAAE,CAcpB;AAED;;;;;GAKG;AACH,6CAJW,MAAM,EAAE,aACR,MAAM,OAqDhB;AAED;;;;GAIG;AACH,8CAHW,MAAM,EAAE,OAmFlB;AA5OD;;;;GAIG;AACH,kCAHW,MAAM,OAiChB;AAED;;;GAGG;AACH,oCAFa,OAAO,CAkCnB;AAqKD;;;;GAIG;AACH,oDAqHC"}

package/dist/utils/quality-gates.js

@@ -11,6 +11,7 @@ const fs = require('fs');
 const path = require('path');
 const yaml = require('js-yaml');
 const { execSync } = require('child_process');
+const { getTodoAnalyzerSuggestion } = require('./project-analysis');
 
 /**
  * Quality Gate Configuration
@@ -229,17 +230,17 @@ function checkHiddenTodos(stagedFiles) {
 
     if (!analyzerPath) {
       console.warn('⚠️  TODO analyzer not found - skipping TODO analysis');
-      console.warn(
-        '💡 Install @paths.design/quality-gates: npm install --save-dev @paths.design/quality-gates'
-      );
+      const suggestion = getTodoAnalyzerSuggestion(process.cwd());
+      console.warn('💡 Available options for TODO analysis:');
+      console.warn(suggestion);
       return { todos: [], blocking: 0, total: 0 };
     }
 
     if (usePython) {
       console.warn('⚠️  Using legacy Python TODO analyzer (deprecated)');
-      console.warn(
-        '💡 Install @paths.design/quality-gates for Node.js version: npm install --save-dev @paths.design/quality-gates'
-      );
+      const suggestion = getTodoAnalyzerSuggestion(process.cwd());
+      console.warn('💡 Consider upgrading to Node.js version:');
+      console.warn(suggestion);
     }
 
     // Run the TODO analyzer with staged files

package/dist/utils/spec-resolver.d.ts

@@ -61,15 +61,7 @@ export function interactiveSpecSelection(specIds: string[]): Promise<string>;
  * @returns {Promise<Object>} Registry data
  */
 export function loadSpecsRegistry(): Promise<any>;
-export function suggestFeatureBreakdown(legacySpec: any): {
-    id: string;
-    title: any;
-    criteria: any;
-    scope: {
-        in: string[];
-        out: any[];
-    };
-}[];
+export function suggestFeatureBreakdown(legacySpec: any): any[];
 /**
  * Check if two paths overlap (simplified implementation)
  * @param {string} path1 - First path

package/dist/utils/spec-resolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"spec-resolver.d.ts","sourceRoot":"","sources":["../../src/utils/spec-resolver.js"],"names":[],"mappings":"AAwBA;;;;;;;;GAQG;AACH,sCANG;IAAyB,MAAM,GAAvB,MAAM;IACW,QAAQ,GAAzB,MAAM;IACY,UAAU,GAA5B,OAAO;IACW,WAAW,GAA7B,OAAO;CACf,GAAU,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,SAAS,GAAG,QAAQ,CAAC;IAAC,IAAI,MAAQ;CAAC,CAAC,CAwK7E;AA6BD;;;GAGG;AACH,sCAFa,OAAO,CAAC,KAAK,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAC,CAAC,CAAC,CAoDpE;AAgDD;;;GAGG;AACH,wCAFa,OAAO,CAAC;IAAC,WAAW,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,OAAO,CAAA;CAAC,CAAC,CAavF;AAED;;;;GAIG;AACH,6CAHW,MAAM,EAAE,GACN,OAAO,CAAC,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,EAAE,CAAA;CAAC,CAAC,CAAC,CA2D/E;AA+DD;;;GAGG;AACH,oCAFa,OAAO,CAAC,IAAI,CAAC,CAczB;AA5MD;;;;GAIG;AACH,kDAHW,MAAM,EAAE,GACN,OAAO,CAAC,MAAM,CAAC,CAyC3B;AA/HD;;;GAGG;AACH,qCAFa,OAAO,KAAQ,CAuB3B;AAyQD;;;;;;;;IA+FC;AA/KD;;;;;GAKG;AACH,oCAJW,MAAM,SACN,MAAM,GACJ,OAAO,CAuDnB;AAvcD;;;;GAIG;AACH,wBAAkB,aAAa,CAAC;AAChC,0BAAoB,yBAAyB,CAAC;AAC9C,6BAAuB,2BAA2B,CAAC"}
+{"version":3,"file":"spec-resolver.d.ts","sourceRoot":"","sources":["../../src/utils/spec-resolver.js"],"names":[],"mappings":"AAwBA;;;;;;;;GAQG;AACH,sCANG;IAAyB,MAAM,GAAvB,MAAM;IACW,QAAQ,GAAzB,MAAM;IACY,UAAU,GAA5B,OAAO;IACW,WAAW,GAA7B,OAAO;CACf,GAAU,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,SAAS,GAAG,QAAQ,CAAC;IAAC,IAAI,MAAQ;CAAC,CAAC,CA+K7E;AA6BD;;;GAGG;AACH,sCAFa,OAAO,CAAC,KAAK,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAC,CAAC,CAAC,CAoDpE;AAgDD;;;GAGG;AACH,wCAFa,OAAO,CAAC;IAAC,WAAW,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,OAAO,CAAA;CAAC,CAAC,CAavF;AAED;;;;GAIG;AACH,6CAHW,MAAM,EAAE,GACN,OAAO,CAAC,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,EAAE,CAAA;CAAC,CAAC,CAAC,CAwE/E;AA+DD;;;GAGG;AACH,oCAFa,OAAO,CAAC,IAAI,CAAC,CAczB;AAzND;;;;GAIG;AACH,kDAHW,MAAM,EAAE,GACN,OAAO,CAAC,MAAM,CAAC,CAyC3B;AA/HD;;;GAGG;AACH,qCAFa,OAAO,KAAQ,CAuB3B;AAsRD,gEAmGC;AAnLD;;;;;GAKG;AACH,oCAJW,MAAM,SACN,MAAM,GACJ,OAAO,CAuDnB;AA3dD;;;;GAIG;AACH,wBAAkB,aAAa,CAAC;AAChC,0BAAoB,yBAAyB,CAAC;AAC9C,6BAAuB,2BAA2B,CAAC"}

package/dist/utils/spec-resolver.js

@@ -512,6 +512,10 @@ async function suggestMigration() {
 function suggestFeatureBreakdown(legacySpec) {
   const features = [];
 
+  if (!legacySpec) {
+    return features;
+  }
+
   if (legacySpec.acceptance && legacySpec.acceptance.length > 0) {
     // Group acceptance criteria by logical features
     const criteriaByFeature = {};

package/dist/utils/yaml-validation.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Validate YAML syntax for a file
+ * @param {string} filePath - Path to YAML file
+ * @returns {Object} Validation result with valid flag and error details
+ */
+export function validateYamlSyntax(filePath: string): any;
+/**
+ * Validate YAML syntax for multiple files
+ * @param {string[]} filePaths - Array of file paths to validate
+ * @returns {Object} Validation results with summary
+ */
+export function validateYamlFiles(filePaths: string[]): any;
+/**
+ * Find all YAML files in .caws directory
+ * @param {string} projectRoot - Project root directory
+ * @returns {string[]} Array of YAML file paths
+ */
+export function findCawsYamlFiles(projectRoot: string): string[];
+/**
+ * Validate all CAWS YAML files in project
+ * @param {string} projectRoot - Project root directory
+ * @returns {Object} Validation results
+ */
+export function validateAllCawsYamlFiles(projectRoot: string): any;
+/**
+ * Format validation error for display
+ * @param {Object} error - Error object from validateYamlSyntax
+ * @param {string} filePath - File path
+ * @returns {string} Formatted error message
+ */
+export function formatYamlError(error: any, filePath: string): string;
+//# sourceMappingURL=yaml-validation.d.ts.map

package/dist/utils/yaml-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml-validation.d.ts","sourceRoot":"","sources":["../../src/utils/yaml-validation.js"],"names":[],"mappings":"AAUA;;;;GAIG;AACH,6CAHW,MAAM,OA2BhB;AAED;;;;GAIG;AACH,6CAHW,MAAM,EAAE,OAgClB;AAED;;;;GAIG;AACH,+CAHW,MAAM,GACJ,MAAM,EAAE,CA6BpB;AAED;;;;GAIG;AACH,sDAHW,MAAM,OAMhB;AAED;;;;;GAKG;AACH,sDAHW,MAAM,GACJ,MAAM,CAoBlB"}

package/dist/utils/yaml-validation.js

@@ -153,3 +153,4 @@ module.exports = {
   formatYamlError,
 };
 
+

package/dist/validation/spec-validation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"spec-validation.d.ts","sourceRoot":"","sources":["../../src/validation/spec-validation.js"],"names":[],"mappings":"AAQA;;;;;GAKG;AACH,mEA8HC;AAED;;;;;GAKG;AACH,kFAyWC;AAoCD;;;;;GAKG;AACH,0CAJW,MAAM,eAEJ,MAAM,CAkBlB;AAED;;;;;GAKG;AACH,uCAJW,MAAM,eAEJ,OAAO,CAKnB;AAnED;;;;;;GAMG;AACH,0EAFa,MAAM,CAclB;AAED;;;;GAIG;AACH,0CAHW,MAAM,GACJ,MAAM,CAQlB"}
+{"version":3,"file":"spec-validation.d.ts","sourceRoot":"","sources":["../../src/validation/spec-validation.js"],"names":[],"mappings":"AAQA;;;;;GAKG;AACH,mEA8HC;AAED;;;;;GAKG;AACH,kFAgdC;AAoCD;;;;;GAKG;AACH,0CAJW,MAAM,eAEJ,MAAM,CAkBlB;AAED;;;;;GAKG;AACH,uCAJW,MAAM,eAEJ,OAAO,CAKnB;AAnED;;;;;;GAMG;AACH,0EAFa,MAAM,CAclB;AAED;;;;GAIG;AACH,0CAHW,MAAM,GACJ,MAAM,CAQlB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@paths.design/caws-cli",
-  "version": "7.0.3",
+  "version": "8.0.1",
   "description": "CAWS CLI - Coding Agent Workflow System command line tools",
   "main": "dist/index.js",
   "bin": {

package/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.
 
+