@paths.design/caws-cli 7.0.3 → 8.0.1

package/dist/budget-derivation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"budget-derivation.d.ts","sourceRoot":"","sources":["../src/budget-derivation.js"],"names":[],"mappings":"AA8JA;;;;;;;;GAQG;AACH,sDALW,MAAM,YAEd;IAAyB,QAAQ,EAAzB,OAAO;CACf,OA+FF;AA4FD;;;;;;GAMG;AACH,qCAJW,MAAM,eACN,MAAM,GACJ,MAAO,IAAI,CAuCvB;AAED;;;;;;GAMG;AACH,0DAFa,OAAO,CAgDnB;AAED;;;;;GAKG;AACH,kFA8BC;AAqCD;;;;;;GAMG;AACH,6EAFa,MAAM,CA8ClB;AAtFD;;;;GAIG;AACH,uEAiBC;AAED;;;;;GAKG;AACH,4EAHW,MAAM,GACJ,OAAO,CAKnB;AAhgBD;;;;GAIG;AACH,kDA+FC;AAED;;;GAGG;AACH,wCAsCC;AA0GD;;;;GAIG;AACH,2DAmFC"}
+{"version":3,"file":"budget-derivation.d.ts","sourceRoot":"","sources":["../src/budget-derivation.js"],"names":[],"mappings":"AA8JA;;;;;;;;GAQG;AACH,sDALW,MAAM,YAEd;IAAyB,QAAQ,EAAzB,OAAO;CACf,OAgGF;AA4FD;;;;;;GAMG;AACH,qCAJW,MAAM,eACN,MAAM,GACJ,MAAO,IAAI,CAuCvB;AAED;;;;;;GAMG;AACH,0DAFa,OAAO,CAgDnB;AAED;;;;;GAKG;AACH,kFA8BC;AAqCD;;;;;;GAMG;AACH,6EAFa,MAAM,CA8ClB;AAtFD;;;;GAIG;AACH,uEAiBC;AAED;;;;;GAKG;AACH,4EAHW,MAAM,GACJ,OAAO,CAKnB;AAjgBD;;;;GAIG;AACH,kDA+FC;AAED;;;GAGG;AACH,wCAsCC;AA2GD;;;;GAIG;AACH,2DAmFC"}

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

@@ -1 +1 @@
-{"version":3,"file":"diagnose.d.ts","sourceRoot":"","sources":["../../src/commands/diagnose.js"],"names":[],"mappings":"AAubA;;;GAGG;AACH,8DAiDC;AApND;;;GAGG;AACH,gCAFa,OAAO,KAAQ,CAkD3B;AAED;;;GAGG;AACH,wCAFW,KAAQ,QA4ClB;AAED;;;;GAIG;AACH,wCAHW,KAAQ,GACN,OAAO,KAAQ,CAoD3B;AAtaD;;;GAGG;AACH,oCAFa,OAAO,KAAQ,CA2C3B;AAED;;;GAGG;AACH,iCAFa,OAAO,KAAQ,CAiB3B;AAED;;;GAGG;AACH,iCAFa,OAAO,KAAQ,CA0C3B;AAED;;;GAGG;AACH,yCAFa,OAAO,KAAQ,CAgE3B;AAED;;;GAGG;AACH,kCAFa,OAAO,KAAQ,CAoC3B;AAED;;;GAGG;AACH,kCAFa,OAAO,KAAQ,CAuC3B"}
+{"version":3,"file":"diagnose.d.ts","sourceRoot":"","sources":["../../src/commands/diagnose.js"],"names":[],"mappings":"AA0bA;;;GAGG;AACH,8DAoDC;AAvND;;;GAGG;AACH,gCAFa,OAAO,KAAQ,CAkD3B;AAED;;;GAGG;AACH,wCAFW,KAAQ,QA4ClB;AAED;;;;GAIG;AACH,wCAHW,KAAQ,GACN,OAAO,KAAQ,CAoD3B;AAzaD;;;GAGG;AACH,oCAFa,OAAO,KAAQ,CA2C3B;AAED;;;GAGG;AACH,iCAFa,OAAO,KAAQ,CAiB3B;AAED;;;GAGG;AACH,iCAFa,OAAO,KAAQ,CA0C3B;AAED;;;GAGG;AACH,yCAFa,OAAO,KAAQ,CAgE3B;AAED;;;GAGG;AACH,kCAFa,OAAO,KAAQ,CAoC3B;AAED;;;GAGG;AACH,kCAFa,OAAO,KAAQ,CA0C3B"}

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

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

package/dist/commands/provenance.d.ts

@@ -3,7 +3,7 @@
  * @param {string} subcommand - The subcommand to execute
  * @param {Object} options - Command options
  */
-export function provenanceCommand(subcommand: string, options: any): Promise<void>;
+export function provenanceCommand(subcommand: string, options: any): Promise<any>;
 /**
  * Update provenance with new commit information
  * @param {Object} options - Command options

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

@@ -1 +1 @@
-{"version":3,"file":"provenance.d.ts","sourceRoot":"","sources":["../../src/commands/provenance.js"],"names":[],"mappings":"AAWA;;;;GAIG;AACH,8CAHW,MAAM,+BA2BhB;AAED;;;GAGG;AACH,8DA4EC;AAED;;;GAGG;AACH,4DAyEC;AAED;;;GAGG;AACH,8DA8CC;AA6iBD;;;GAGG;AACH,4DAmEC;AAzcD;;;GAGG;AACH,0DAwEC"}
+{"version":3,"file":"provenance.d.ts","sourceRoot":"","sources":["../../src/commands/provenance.js"],"names":[],"mappings":"AAYA;;;;GAIG;AACH,8CAHW,MAAM,8BA+BhB;AAED;;;GAGG;AACH,8DA4EC;AAED;;;GAGG;AACH,4DAyEC;AAED;;;GAGG;AACH,8DA8CC;AA6iBD;;;GAGG;AACH,4DAmEC;AAzcD;;;GAGG;AACH,0DAwEC"}

package/dist/commands/quality-gates.d.ts

@@ -1,49 +1,3 @@
-/**
- * Quality Gates Configuration
- */
-/**
- * Update provenance with quality gates results
- * @param {Object} results - Quality gates results
- * @param {boolean} crisisMode - Whether in crisis mode
- * @param {string[]} stagedFiles - Array of staged files
- */
-/**
- * Detect agent type for provenance tracking
- * @returns {string} Agent type identifier
- */
-/**
- * Check if a waiver applies to the given gate
- * @param {string} gate - Gate name to check
- * @returns {Object} Waiver check result
- */
-/**
- * Detect if project is in crisis response mode
- * @returns {boolean} True if in crisis mode
- */
-/**
- * Get staged files from git
- * @returns {string[]} Array of staged file paths
- */
-/**
- * Check for god objects in staged Rust files with waiver and crisis mode support
- * @param {string[]} stagedFiles - Array of staged file paths
- * @param {boolean} crisisMode - Whether in crisis response mode
- * @returns {Object} God object analysis results
- */
-/**
- * Check for hidden TODOs in staged files with waiver and crisis mode support
- * @param {string[]} stagedFiles - Array of staged file paths
- * @param {boolean} crisisMode - Whether in crisis response mode
- * @returns {Object} TODO analysis results
- */
-/**
- * Check for human override in working spec
- * @returns {Object} Human override check result
- */
-/**
- * Get CAWS tier from working spec
- * @returns {number|null} CAWS tier (1, 2, or 3) or null if not found
- */
 /**
  * Run comprehensive quality gates on staged files
  * @param {Object} options - Command options

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

@@ -1 +1 @@
-{"version":3,"file":"quality-gates.d.ts","sourceRoot":"","sources":["../../src/commands/quality-gates.js"],"names":[],"mappings":"AAqBA;;GAEG;AAkBH;;;;;GAKG;AAGH;;;GAGG;AA6BH;;;;GAIG;AAiCH;;;GAGG;AAoCH;;;GAGG;AAeH;;;;;GAKG;AAmFH;;;;;GAKG;AAqEH;;;GAGG;AA0BH;;;GAGG;AAaH;;;GAGG;AACH,iEAmGC"}
+{"version":3,"file":"quality-gates.d.ts","sourceRoot":"","sources":["../../src/commands/quality-gates.js"],"names":[],"mappings":"AAqBA;;;GAGG;AACH,iEA4ZC"}

package/dist/commands/quality-gates.js

@@ -44,14 +44,66 @@ async function qualityGatesCommand(options = {}) {
       const packagesDir = path.dirname(cliPackageDir);
       const monorepoRunner = path.join(packagesDir, 'quality-gates', 'run-quality-gates.mjs');
 
-      // Option 2: Check VS Code extension bundled (if running from extension context)
+      // Option 2: Check globally installed CLI for bundled quality gates
+      let globalCliPath = null;
+      try {
+        const { execSync } = require('child_process');
+        const whichCaws = execSync('which caws', { encoding: 'utf8', stdio: 'pipe' }).trim();
+        if (whichCaws) {
+          // Resolve symlink to actual path
+          const realPath = fs.realpathSync(whichCaws);
+          const globalCliDir = path.dirname(realPath);
+          // Check for bundled quality gates in global CLI installation
+          const possibleBundledPaths = [
+            path.join(
+              globalCliDir,
+              '..',
+              'lib',
+              'node_modules',
+              '@paths.design',
+              'caws-cli',
+              'node_modules',
+              '@paths.design',
+              'quality-gates',
+              'run-quality-gates.mjs'
+            ),
+            path.join(
+              globalCliDir,
+              '..',
+              'lib',
+              'node_modules',
+              '@paths.design',
+              'quality-gates',
+              'run-quality-gates.mjs'
+            ),
+            path.join(
+              globalCliDir,
+              '..',
+              'node_modules',
+              '@paths.design',
+              'quality-gates',
+              'run-quality-gates.mjs'
+            ),
+          ];
+          for (const bundledPath of possibleBundledPaths) {
+            if (fs.existsSync(bundledPath)) {
+              globalCliPath = bundledPath;
+              break;
+            }
+          }
+        }
+      } catch (e) {
+        // Ignore errors finding global CLI
+      }
+
+      // Option 3: Check VS Code extension bundled (if running from extension context)
       const vscodeExtensionPath =
         process.env.VSCODE_EXTENSION_PATH || process.env.VSCODE_EXTENSION_DIR;
       const bundledRunner = vscodeExtensionPath
         ? path.join(vscodeExtensionPath, 'bundled', 'quality-gates', 'run-quality-gates.mjs')
         : null;
 
-      // Option 3: Check node_modules for quality-gates package (prioritize published package)
+      // Option 4: Check node_modules for quality-gates package (prioritize published package)
       const nodeModulesPaths = [
         // Published npm package (priority)
         path.join(
@@ -69,6 +121,8 @@ async function qualityGatesCommand(options = {}) {
       // Try all possible paths in order
       if (fs.existsSync(monorepoRunner)) {
         qualityGatesRunner = monorepoRunner;
+      } else if (globalCliPath) {
+        qualityGatesRunner = globalCliPath;
       } else if (bundledRunner && fs.existsSync(bundledRunner)) {
         qualityGatesRunner = bundledRunner;
       } else {
@@ -132,14 +186,104 @@ async function qualityGatesCommand(options = {}) {
         }
       }
 
-      // If still no runner found, provide helpful error
+      // Option 5: Try npx (no installation required) - works if Node.js is available
       if (!qualityGatesRunner) {
-        const suggestions = [
-          'Install quality gates package: npm install -g @paths.design/quality-gates',
-          'Use Python script (if available): python3 scripts/simple_gates.py all --tier 2 --profile backend-api',
-          'Use Makefile target (if available): make caws-gates',
-          'Run from CAWS monorepo root',
-        ];
+        try {
+          const { execSync } = require('child_process');
+          // Check if npx is available
+          execSync('command -v npx', { encoding: 'utf8', stdio: 'ignore' });
+
+          Output.info('Using npx to run quality gates (no installation required)...');
+
+          // Build npx command - the package exposes 'caws-quality-gates' bin command
+          // Use npx to download and run without installing
+          const npxArgs = ['npx', '--yes', '@paths.design/quality-gates'];
+
+          // Map CLI options to runner options
+          if (options.ci) {
+            npxArgs.push('--ci');
+          }
+          if (options.json) {
+            npxArgs.push('--json');
+          }
+          if (options.gates && options.gates.trim()) {
+            npxArgs.push('--gates', options.gates.trim());
+          }
+          if (options.fix) {
+            npxArgs.push('--fix');
+          }
+          // Handle context options: --all-files takes precedence, then --context
+          if (options.allFiles) {
+            npxArgs.push('--context=ci');
+          } else if (options.context && options.context !== 'commit') {
+            npxArgs.push(`--context=${options.context}`);
+          }
+
+          Output.progress('Executing quality gates via npx...');
+          Output.info(`Command: ${npxArgs.join(' ')}`);
+
+          // Execute via npx
+          const { execSync: execSyncNpx } = require('child_process');
+          execSyncNpx(npxArgs.join(' '), {
+            stdio: 'inherit',
+            cwd: projectRoot,
+            env: {
+              ...process.env,
+              CAWS_CLI_INTEGRATION: 'true',
+              CAWS_CLI_VERSION: require(path.join(cliPackageDir, 'package.json')).version,
+            },
+          });
+
+          Output.success('Quality gates completed successfully');
+          return;
+        } catch (npxError) {
+          // npx not available or failed - continue to error message
+        }
+      }
+
+      // If still no runner found, provide helpful error with language-agnostic suggestions
+      if (!qualityGatesRunner) {
+        // Check if Node.js/npx is available (language-agnostic check)
+        let hasNodeJs = false;
+        try {
+          const { execSync } = require('child_process');
+          execSync('command -v node', { encoding: 'utf8', stdio: 'ignore' });
+          execSync('command -v npx', { encoding: 'utf8', stdio: 'ignore' });
+          hasNodeJs = true;
+        } catch (e) {
+          // Node.js/npx not available
+        }
+
+        const suggestions = [];
+
+        if (hasNodeJs) {
+          // Node.js available - suggest npx (works for any language, no installation)
+          suggestions.push(
+            'Use npx (no installation required): npx --yes @paths.design/quality-gates'
+          );
+          suggestions.push('Install globally: npm install -g @paths.design/quality-gates');
+          suggestions.push('Install locally: npm install --save-dev @paths.design/quality-gates');
+        } else {
+          // Node.js not available - suggest installation or alternatives
+          suggestions.push('Install Node.js to use quality gates: https://nodejs.org/');
+          suggestions.push(
+            'Then use: npx --yes @paths.design/quality-gates (no installation required)'
+          );
+          suggestions.push('Or install globally: npm install -g @paths.design/quality-gates');
+        }
+
+        // Language-agnostic fallback options (if they exist)
+        const pythonScript = path.join(projectRoot, 'scripts', 'simple_gates.py');
+        const makefile = path.join(projectRoot, 'Makefile');
+
+        if (fs.existsSync(pythonScript)) {
+          suggestions.push(`Use project script: python3 ${pythonScript} all --tier 2`);
+        }
+        if (fs.existsSync(makefile)) {
+          suggestions.push('Use Makefile target: make caws-gates');
+        }
+
+        suggestions.push('Run from CAWS monorepo root (if developing CAWS itself)');
 
         throw new Error(
           'Quality gates runner not found.\n\n' +
@@ -172,6 +316,13 @@ async function qualityGatesCommand(options = {}) {
         args.push('--fix');
       }
 
+      // Handle context options: --all-files takes precedence, then --context
+      if (options.allFiles) {
+        args.push('--context=ci');
+      } else if (options.context && options.context !== 'commit') {
+        args.push(`--context=${options.context}`);
+      }
+
       // Add CAWS-specific environment variables for integration
       const env = {
         ...process.env,
@@ -198,7 +349,47 @@ async function qualityGatesCommand(options = {}) {
       const timeoutMs = options.timeout || (options.ci ? 30 * 60 * 1000 : 10 * 60 * 1000);
 
       const completionPromise = new Promise((resolve, reject) => {
+        let resolved = false;
+
+        // Handle process termination signals
+        const signalHandlers = {
+          SIGINT: () => {
+            if (!resolved && !child.killed && child.pid) {
+              child.kill('SIGINT');
+            }
+          },
+          SIGTERM: () => {
+            if (!resolved && !child.killed && child.pid) {
+              child.kill('SIGTERM');
+            }
+          },
+        };
+
+        process.on('SIGINT', signalHandlers.SIGINT);
+        process.on('SIGTERM', signalHandlers.SIGTERM);
+
+        const cleanup = () => {
+          if (resolved) return;
+          resolved = true;
+
+          // Remove signal handlers
+          try {
+            process.removeListener('SIGINT', signalHandlers.SIGINT);
+            process.removeListener('SIGTERM', signalHandlers.SIGTERM);
+          } catch (e) {
+            // Ignore errors removing listeners
+          }
+
+          // Remove event listeners to prevent memory leaks
+          try {
+            child.removeAllListeners();
+          } catch (e) {
+            // Ignore errors removing listeners
+          }
+        };
+
         child.on('close', (code) => {
+          cleanup();
           if (code === 0) {
             resolve();
           } else {
@@ -207,12 +398,36 @@ async function qualityGatesCommand(options = {}) {
         });
 
         child.on('error', (error) => {
+          cleanup();
           reject(new Error(`Failed to execute quality gates runner: ${error.message}`));
         });
       });
 
-      await withTimeout(completionPromise, timeoutMs, 'Quality gates execution timed out');
-      Output.success('Quality gates completed successfully');
+      try {
+        await withTimeout(completionPromise, timeoutMs, 'Quality gates execution timed out');
+        Output.success('Quality gates completed successfully');
+      } catch (error) {
+        // Ensure child process is killed on timeout or error
+        try {
+          if (!child.killed && child.pid) {
+            child.kill('SIGTERM');
+            // Give it a moment to exit gracefully, then force kill
+            // eslint-disable-next-line no-undef
+            setTimeout(() => {
+              if (!child.killed && child.pid) {
+                try {
+                  child.kill('SIGKILL');
+                } catch (e) {
+                  // Ignore errors killing process
+                }
+              }
+            }, 1000);
+          }
+        } catch (killError) {
+          // Ignore errors killing process
+        }
+        throw error;
+      }
     },
     {
       commandName: 'quality-gates',

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

@@ -1 +1 @@
-{"version":3,"file":"specs.d.ts","sourceRoot":"","sources":["../../src/commands/specs.js"],"names":[],"mappings":"AAghBA;;;;GAIG;AACH,qCAHW,MAAM,+BA2LhB;AAvrBD;;;GAGG;AACH,qCAFa,OAAO,KAAQ,CAqB3B;AAED;;;;GAIG;AACH,kDAFa,OAAO,CAAC,IAAI,CAAC,CAMzB;AAED;;;GAGG;AACH,iCAFa,OAAO,OAAO,CAmC1B;AAED;;;;;GAKG;AACH,+BAJW,MAAM,kBAEJ,OAAO,KAAQ,CA8H3B;AAED;;;;GAIG;AACH,6BAHW,MAAM,GACJ,OAAO,CAAC,MAAO,IAAI,CAAC,CAiBhC;AAED;;;;;GAKG;AACH,+BAJW,MAAM,kBAEJ,OAAO,CAAC,OAAO,CAAC,CA6B5B;AAED;;;;GAIG;AACH,+BAHW,MAAM,GACJ,OAAO,CAAC,OAAO,CAAC,CAmB5B;AAED;;;GAGG;AACH,sDA2CC;AAED;;;GAGG;AACH,oDAoCC;AAsFD;;;GAGG;AACH,yCAFa,OAAO,CAAC,MAAM,CAAC,CAuC3B;AA9fD;;GAEG;AACH,wBAAkB,aAAa,CAAC;AAChC,6BAAuB,2BAA2B,CAAC"}
+{"version":3,"file":"specs.d.ts","sourceRoot":"","sources":["../../src/commands/specs.js"],"names":[],"mappings":"AAipBA;;;;GAIG;AACH,qCAHW,MAAM,+BA+LhB;AA3zBD;;;GAGG;AACH,qCAFa,OAAO,KAAQ,CAqB3B;AAED;;;;GAIG;AACH,kDAFa,OAAO,CAAC,IAAI,CAAC,CAMzB;AAED;;;GAGG;AACH,iCAFa,OAAO,OAAO,CAmC1B;AAED;;;;;GAKG;AACH,+BAJW,MAAM,kBAEJ,OAAO,KAAQ,CAkO3B;AAED;;;;GAIG;AACH,6BAHW,MAAM,GACJ,OAAO,CAAC,MAAO,IAAI,CAAC,CAiBhC;AAED;;;;;GAKG;AACH,+BAJW,MAAM,kBAEJ,OAAO,CAAC,OAAO,CAAC,CA6B5B;AAED;;;;GAIG;AACH,+BAHW,MAAM,GACJ,OAAO,CAAC,OAAO,CAAC,CAmB5B;AAED;;;GAGG;AACH,sDA2CC;AAED;;;GAGG;AACH,oDAoCC;AAoHD;;;GAGG;AACH,yCAFa,OAAO,CAAC,MAAM,CAAC,CAqC3B;AA9nBD;;GAEG;AACH,wBAAkB,aAAa,CAAC;AAChC,6BAAuB,2BAA2B,CAAC"}

package/dist/commands/specs.js

@@ -154,9 +154,13 @@ async function createSpec(id, options = {}) {
         console.log(chalk.blue('ℹ️  Spec creation canceled.'));
         return null;
       } else if (answer === 'rename') {
-        // Generate new name with timestamp suffix
-        const timestamp = new Date().toISOString().replace(/[:.]/g, '-').slice(0, -5);
-        const newId = `${id}-${timestamp}`;
+        // Generate new name with valid PREFIX-NUMBER format
+        // Extract prefix from existing ID or use default
+        const prefixMatch = id.match(/^([A-Z]+)-\d+$/);
+        const prefix = prefixMatch ? prefixMatch[1] : 'FEAT';
+        // Generate sequential number based on timestamp
+        const number = Date.now().toString().slice(-6); // Last 6 digits of timestamp
+        const newId = `${prefix}-${number}`;
         console.log(chalk.blue(`📝 Creating spec with new name: ${newId}`));
         return await createSpec(newId, { ...options, interactive: false });
       } else if (answer === 'merge') {
@@ -183,9 +187,10 @@ async function createSpec(id, options = {}) {
   // Ensure specs directory exists
   await fs.ensureDir(SPECS_DIR);
 
-  // Generate spec content
-  const specContent = {
-    id,
+  // Generate spec content with all required fields
+  // Merge template carefully to preserve required fields and structure
+  const defaultSpec = {
+    id, // Always use the provided id parameter
     type,
     title,
     status: 'draft',
@@ -193,8 +198,64 @@ async function createSpec(id, options = {}) {
     mode,
     created_at: new Date().toISOString(),
     updated_at: new Date().toISOString(),
-    acceptance_criteria: [],
+    // Required fields for validation
+    blast_radius: {
+      modules: [],
+      data_migration: false,
+    },
+    operational_rollback_slo: '5m',
+    scope: {
+      in: ['src/', 'tests/'],
+      out: ['node_modules/', 'dist/', 'build/'],
+    },
+    invariants: ['System maintains data consistency'],
+    acceptance: [], // Note: validation expects 'acceptance', not 'acceptance_criteria'
+    acceptance_criteria: [], // Keep for backward compatibility
+    non_functional: {
+      a11y: [],
+      perf: {},
+      security: [],
+    },
+    contracts: [],
+  };
+
+  // Merge template, but preserve required structure
+  // Map template.criteria to acceptance if present
+  const templateAcceptance = template?.criteria || template?.acceptance;
+
+  const specContent = {
+    ...defaultSpec,
     ...(template || {}),
+    // Always preserve these critical fields
+    id, // Never allow template to override id
+    // Map criteria to acceptance if template uses criteria
+    acceptance: templateAcceptance || defaultSpec.acceptance,
+    acceptance_criteria: templateAcceptance || defaultSpec.acceptance_criteria,
+    // Deep merge scope if template provides it
+    scope: template?.scope
+      ? {
+          in: template.scope.in || defaultSpec.scope.in,
+          out: template.scope.out || defaultSpec.scope.out,
+        }
+      : defaultSpec.scope,
+    // Deep merge blast_radius if template provides it
+    blast_radius: template?.blast_radius
+      ? {
+          modules: template.blast_radius.modules || defaultSpec.blast_radius.modules,
+          data_migration:
+            template.blast_radius.data_migration !== undefined
+              ? template.blast_radius.data_migration
+              : defaultSpec.blast_radius.data_migration,
+        }
+      : defaultSpec.blast_radius,
+    // Deep merge non_functional if template provides it
+    non_functional: template?.non_functional
+      ? {
+          a11y: template.non_functional.a11y || defaultSpec.non_functional.a11y,
+          perf: template.non_functional.perf || defaultSpec.non_functional.perf,
+          security: template.non_functional.security || defaultSpec.non_functional.security,
+        }
+      : defaultSpec.non_functional,
   };
 
   // Create file path
@@ -442,9 +503,10 @@ function displaySpecDetails(spec) {
 /**
  * Migrate from legacy working-spec.yaml to feature-specific specs
  * @param {Object} options - Migration options
+ * @param {Function} [createSpecFn] - Function to create specs (for testing)
  * @returns {Promise<Object>} Migration result
  */
-async function migrateFromLegacy(options = {}) {
+async function migrateFromLegacy(options = {}, createSpecFn = createSpec) {
   const fs = require('fs-extra');
   const path = require('path');
   const yaml = require('js-yaml');
@@ -461,6 +523,14 @@ async function migrateFromLegacy(options = {}) {
   const legacyContent = await fs.readFile(legacyPath, 'utf8');
   const legacySpec = yaml.load(legacyContent);
 
+  if (!legacySpec) {
+    throw new Error('Legacy working-spec.yaml is empty or invalid');
+  }
+
+  if (!legacySpec.acceptance || !Array.isArray(legacySpec.acceptance)) {
+    throw new Error('Legacy working-spec.yaml must have an acceptance array');
+  }
+
   // Suggest feature breakdown based on acceptance criteria
   const features = suggestFeatureBreakdown(legacySpec);
 
@@ -480,15 +550,32 @@ async function migrateFromLegacy(options = {}) {
   }
 
   if (options.features && options.features.length > 0) {
+    // Filter by original feature IDs (before transformation)
     selectedFeatures = features.filter((f) => options.features.includes(f.id));
-    console.log(chalk.blue(`\n📋 Migrating selected features: ${options.features.join(', ')}`));
+    if (selectedFeatures.length === 0) {
+      const errorMsg = `No features found matching: ${options.features.join(', ')}. Available features: ${features.map((f) => f.id).join(', ')}`;
+      console.log(chalk.yellow(`⚠️  ${errorMsg}`));
+      throw new Error(errorMsg);
+    } else {
+      console.log(chalk.blue(`\n📋 Migrating selected features: ${options.features.join(', ')}`));
+    }
   }
 
   // Create each feature spec
   const createdSpecs = [];
+  let featureCounter = 1;
   for (const feature of selectedFeatures) {
     try {
-      await createSpec(feature.id, {
+      // Transform feature ID to proper format (PREFIX-NUMBER) if needed
+      let specId = feature.id;
+      if (!/^[A-Z]+-\d+$/.test(specId)) {
+        // Convert 'auth' -> 'FEAT-001', 'payment' -> 'FEAT-002', etc.
+        const prefix = specId.toUpperCase().replace(/[^A-Z0-9]/g, '');
+        specId = `${prefix || 'FEAT'}-${String(featureCounter).padStart(3, '0')}`;
+        featureCounter++;
+      }
+
+      await createSpecFn(specId, {
         type: 'feature',
         title: feature.title,
         risk_tier: 'T3', // Default tier
@@ -496,10 +583,14 @@ async function migrateFromLegacy(options = {}) {
         template: feature,
       });
 
-      createdSpecs.push(feature.id);
-      console.log(chalk.green(`   ✅ Created spec: ${feature.id}`));
+      createdSpecs.push(specId);
+      console.log(chalk.green(`   ✅ Created spec: ${specId}`));
     } catch (error) {
+      // Log full error details for debugging
       console.log(chalk.red(`   ❌ Failed to create spec ${feature.id}: ${error.message}`));
+      if (process.env.DEBUG_MIGRATION) {
+        console.log(chalk.gray(`   Error details: ${error.stack}`));
+      }
     }
   }
 
@@ -628,7 +719,11 @@ async function specsCommand(action, options = {}) {
         }
 
         case 'migrate': {
-          const result = await migrateFromLegacy(options);
+          // Allow tests to inject createSpec function
+          const createSpecFn = options._createSpecFn || createSpec;
+          const migrationOptions = { ...options };
+          delete migrationOptions._createSpecFn; // Remove test-only option
+          const result = await migrateFromLegacy(migrationOptions, createSpecFn);
 
           return outputResult({
             command: 'specs migrate',

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

@@ -1 +1 @@
-{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/commands/status.js"],"names":[],"mappings":"AA6uBA;;;GAGG;AACH,2DA6IC;AAl3BD;;;;GAIG;AACH,2CAHW,MAAM,GACJ,OAAO,CAAC,MAAO,IAAI,CAAC,CAahC;AAgBD;;;GAGG;AACH,iCAFa,OAAO,KAAQ,CAgC3B;AAED;;;GAGG;AACH,uCAFa,OAAO,KAAQ,CA+B3B;AAED;;;GAGG;AACH,oCAFa,OAAO,KAAQ,CA0D3B;AAED;;;GAGG;AACH,qCAFa,OAAO,KAAQ,CAS3B;AAwBD;;;GAGG;AACH,+CAgGC;AAED;;;;;GAKG;AACH,4DAHW,MAAM,GACJ,MAAM,EAAE,CAoCpB"}
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/commands/status.js"],"names":[],"mappings":"AA8uBA;;;GAGG;AACH,2DA+IC;AAp3BD;;;;GAIG;AACH,2CAHW,MAAM,GACJ,OAAO,CAAC,MAAO,IAAI,CAAC,CAahC;AAgBD;;;GAGG;AACH,iCAFa,OAAO,KAAQ,CAgC3B;AAED;;;GAGG;AACH,uCAFa,OAAO,KAAQ,CA+B3B;AAED;;;GAGG;AACH,oCAFa,OAAO,KAAQ,CA0D3B;AAED;;;GAGG;AACH,qCAFa,OAAO,KAAQ,CAS3B;AAwBD;;;GAGG;AACH,+CAgGC;AAED;;;;;GAKG;AACH,4DAHW,MAAM,GACJ,MAAM,EAAE,CAoCpB"}

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

@@ -1 +1 @@
-{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/commands/templates.js"],"names":[],"mappings":"AAoMA;;;;GAIG;AACH,8CAHW,MAAM,gCA4BhB;AAvHD;;GAEG;AACH,sCAuCC;AAED;;;GAGG;AACH,6CAFW,MAAM,QAyChB;AA9GD;;;GAGG;AACH,6CAiBC;AA/FD;;GAEG;AACH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiDE"}
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/commands/templates.js"],"names":[],"mappings":"AA8MA;;;;GAIG;AACH,8CAHW,MAAM,gCA4BhB;AAvHD;;GAEG;AACH,sCAuCC;AAED;;;GAGG;AACH,6CAFW,MAAM,QAyChB;AA9GD;;;GAGG;AACH,6CAiBC;AAxGD;;GAEG;AACH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiDE"}

package/dist/commands/tool.d.ts

@@ -8,6 +8,6 @@ export function initializeToolSystem(): Promise<ToolLoader | null>;
  * @param {string} toolId - ID of the tool to execute
  * @param {Object} options - Command options
  */
-export function executeTool(toolId: string, options: any): Promise<void>;
+export function executeTool(toolId: string, options: any): Promise<any>;
 import ToolLoader = require("../tool-loader");
 //# sourceMappingURL=tool.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../src/commands/tool.js"],"names":[],"mappings":"AAiBA;;;GAGG;AACH,wCAFa,OAAO,CAAC,UAAU,GAAC,IAAI,CAAC,CAoCpC;AAED;;;;GAIG;AACH,oCAHW,MAAM,+BAyEhB"}
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../src/commands/tool.js"],"names":[],"mappings":"AAgBA;;;GAGG;AACH,wCAFa,OAAO,CAAC,UAAU,GAAC,IAAI,CAAC,CAwCpC;AAED;;;;GAIG;AACH,oCAHW,MAAM,8BAoEhB"}

package/dist/commands/tool.js

@@ -4,7 +4,6 @@
  * @author @darianrosebrook
  */
 
-const path = require('path');
 const { commandWrapper, Output } = require('../utils/command-wrapper');
 
 // Import tool system

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

@@ -1 +1 @@
-{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/commands/validate.js"],"names":[],"mappings":"AAkBA;;;;;;;;GAQG;AACH,0CANW,MAAM,YAEd;IAAyB,MAAM,GAAvB,MAAM;IACY,WAAW,GAA7B,OAAO;IACW,MAAM,GAAxB,OAAO;CACjB,iBAiNA"}
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/commands/validate.js"],"names":[],"mappings":"AAkBA;;;;;;;;GAQG;AACH,0CANW,MAAM,YAEd;IAAyB,MAAM,GAAvB,MAAM;IACY,WAAW,GAA7B,OAAO;IACW,MAAM,GAAxB,OAAO;CACjB,iBA6NA"}

package/dist/commands/waivers.d.ts

@@ -4,5 +4,5 @@
  * @param {string} subcommand - create, list, show, revoke
  * @param {object} options - Command options
  */
-export function waiversCommand(subcommand?: string, options?: object): Promise<void>;
+export function waiversCommand(subcommand?: string, options?: object): Promise<any>;
 //# sourceMappingURL=waivers.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"waivers.d.ts","sourceRoot":"","sources":["../../src/commands/waivers.js"],"names":[],"mappings":"AAmBA;;;;;GAKG;AACH,4CAHW,MAAM,YACN,MAAM,iBA2ChB"}
+{"version":3,"file":"waivers.d.ts","sourceRoot":"","sources":["../../src/commands/waivers.js"],"names":[],"mappings":"AAoBA;;;;;GAKG;AACH,4CAHW,MAAM,YACN,MAAM,gBAyChB"}

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.js"],"names":[],"mappings":";mCAakD,OAAO;AAOzD;;;GAGG;AACH,6CAkBC;AAED;;;GAGG;AACH,uCAFa,MAAO,IAAI,CA2CvB;AAED;;;GAGG;AACH,6CAFa,MAAO,IAAI,CAmCvB;AAED;;;GAGG;AACH,0CAEC;AAED;;;GAGG;AACH,qDAEC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.js"],"names":[],"mappings":";mCAakD,OAAO;AAOzD;;;GAGG;AACH,6CAkBC;AAED;;;GAGG;AACH,uCAFa,MAAO,IAAI,CA+CvB;AAED;;;GAGG;AACH,6CAFa,MAAO,IAAI,CAwCvB;AAED;;;GAGG;AACH,0CAEC;AAED;;;GAGG;AACH,qDAEC"}

package/dist/generators/working-spec.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"working-spec.d.ts","sourceRoot":"","sources":["../../src/generators/working-spec.js"],"names":[],"mappings":"AAYA;;;;GAIG;AACH,mDAFa,MAAM,CAqJlB;AAED;;;;GAIG;AACH,mDAHW,MAAM,uBA8BhB"}
+{"version":3,"file":"working-spec.d.ts","sourceRoot":"","sources":["../../src/generators/working-spec.js"],"names":[],"mappings":"AAYA;;;;GAIG;AACH,mDAFa,MAAM,CAsLlB;AAED;;;;GAIG;AACH,mDAHW,MAAM,uBA8BhB"}