@paths.design/caws-cli 8.0.0 → 8.0.1

package/dist/budget-derivation.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Derive budget for a working spec based on policy and waivers
+ * Enhanced to use PolicyManager for caching
+ * @param {Object} spec - Working spec object
+ * @param {string} projectRoot - Project root directory
+ * @param {Object} options - Derivation options
+ * @param {boolean} options.useCache - Use cached policy (default: true)
+ * @returns {Object} Derived budget with baseline and effective limits
+ */
+export function deriveBudget(spec: any, projectRoot?: string, options?: {
+    useCache: boolean;
+}): any;
+/**
+ * Load a waiver by ID
+ * Enhanced with structure validation and detailed error reporting
+ * @param {string} waiverId - Waiver ID (e.g., WV-0001)
+ * @param {string} projectRoot - Project root directory
+ * @returns {Object|null} Waiver object or null if not found
+ */
+export function loadWaiver(waiverId: string, projectRoot: string): any | null;
+/**
+ * Check if a waiver is currently valid
+ * Enhanced with proper expiry and approval validation
+ * @param {Object} waiver - Waiver object
+ * @param {Object} policy - Policy configuration (optional)
+ * @returns {boolean} Whether waiver is valid and active
+ */
+export function isWaiverValid(waiver: any, policy?: any): boolean;
+/**
+ * Check if current changes exceed derived budget
+ * @param {Object} derivedBudget - Budget from deriveBudget()
+ * @param {Object} currentStats - Current change statistics
+ * @returns {Object} Budget check result
+ */
+export function checkBudgetCompliance(derivedBudget: any, currentStats: any): any;
+/**
+ * Generate burn-up report for scope visibility
+ * Enhanced with utilization metrics and warnings
+ * @param {Object} derivedBudget - Budget from deriveBudget()
+ * @param {Object} currentStats - Current change statistics
+ * @returns {string} Human-readable burn-up report
+ */
+export function generateBurnupReport(derivedBudget: any, currentStats: any): string;
+/**
+ * Calculate budget utilization percentages
+ * @param {Object} budgetCompliance - Budget compliance result
+ * @returns {Object} Utilization percentages
+ */
+export function calculateBudgetUtilization(budgetCompliance: any): any;
+/**
+ * Check if changes are approaching budget limit
+ * @param {Object} budgetCompliance - Budget compliance result
+ * @param {number} threshold - Warning threshold (default 80)
+ * @returns {boolean} Whether approaching limit
+ */
+export function isApproachingBudgetLimit(budgetCompliance: any, threshold?: number): boolean;
+/**
+ * Validate policy structure and content
+ * @param {Object} policy - Policy object from policy.yaml
+ * @throws {Error} If policy is invalid
+ */
+export function validatePolicy(policy: any): void;
+/**
+ * Get default policy as fallback
+ * @returns {Object} Default CAWS policy
+ */
+export function getDefaultPolicy(): any;
+/**
+ * Validate waiver document structure
+ * @param {Object} waiver - Waiver document to validate
+ * @throws {Error} If waiver structure is invalid
+ */
+export function validateWaiverStructure(waiver: any): void;
+//# sourceMappingURL=budget-derivation.d.ts.map

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

@@ -0,0 +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,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/cicd-optimizer.d.ts

@@ -0,0 +1,142 @@
+export = CICDOptimizer;
+declare class CICDOptimizer {
+    constructor(options?: {});
+    projectRoot: any;
+    cacheDir: string;
+    optimizationConfig: string;
+    /**
+     * Analyze project and generate CI/CD optimization recommendations
+     */
+    analyzeProject(specPath?: string): Promise<{
+        project_tier: string;
+        recommended_optimizations: any[];
+        cache_strategy: {};
+        parallel_groups: any[];
+        conditional_execution: {};
+        estimated_savings: {};
+    }>;
+    /**
+     * Generate tier-based conditional execution rules
+     */
+    generateConditionalExecutionRules(tier: any): {
+        coverage_required: boolean;
+        mutation_required: boolean;
+        contract_testing: boolean;
+        accessibility_check: boolean;
+        performance_budget: boolean;
+        security_scan: boolean;
+        lint_strict: boolean;
+    };
+    /**
+     * Analyze what optimizations are beneficial for this tier
+     */
+    analyzeOptimizationOpportunities(tier: any): Promise<{
+        type: string;
+        description: string;
+        impact: string;
+        effort: string;
+    }[]>;
+    /**
+     * Generate intelligent caching strategy
+     */
+    generateCacheStrategy(): Promise<{
+        node_modules: {
+            key: string;
+            paths: string[];
+            restore_keys: string[];
+        };
+        build_artifacts: {
+            key: string;
+            paths: string[];
+            restore_keys: any[];
+        };
+        test_cache: {
+            key: string;
+            paths: string[];
+            restore_keys: string[];
+        };
+    }>;
+    /**
+     * Create parallel execution groups for quality gates
+     */
+    createParallelGroups(): Promise<{
+        name: string;
+        description: string;
+        jobs: string[];
+        max_parallel: number;
+        timeout: number;
+    }[]>;
+    /**
+     * Analyze changed files to determine what tests to run
+     */
+    analyzeChangedFiles(changedFiles?: any[]): Promise<{
+        unit: any[];
+        integration: any[];
+        contract: any[];
+        e2e: any[];
+    }>;
+    /**
+     * Estimate time savings from optimizations
+     */
+    estimateTimeSavings(analysis: any): {
+        original_minutes: any;
+        optimized_minutes: number;
+        savings_percent: number;
+        monthly_savings_hours: number;
+    };
+    /**
+     * Generate optimized CI/CD configuration
+     */
+    generateOptimizedConfig(platform?: string): Promise<string | {
+        name: string;
+        on: {
+            push: {
+                branches: string[];
+            };
+            pull_request: {
+                branches: string[];
+            };
+        };
+        jobs: {};
+    } | {
+        stages: string[];
+        cache: {
+            key: string;
+            paths: string[];
+        };
+    }>;
+    /**
+     * Generate optimized GitHub Actions workflow
+     */
+    generateGitHubActionsConfig(analysis: any): {
+        name: string;
+        on: {
+            push: {
+                branches: string[];
+            };
+            pull_request: {
+                branches: string[];
+            };
+        };
+        jobs: {};
+    };
+    /**
+     * Generate GitLab CI configuration
+     */
+    generateGitLabCIConfig(analysis: any): {
+        stages: string[];
+        cache: {
+            key: string;
+            paths: string[];
+        };
+    };
+    /**
+     * Generate Jenkins pipeline configuration
+     */
+    generateJenkinsConfig(analysis: any): string;
+    /**
+     * Create hash for cache invalidation
+     */
+    createCacheHash(files: any): string;
+}
+//# sourceMappingURL=cicd-optimizer.d.ts.map

package/dist/cicd-optimizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cicd-optimizer.d.ts","sourceRoot":"","sources":["../src/cicd-optimizer.js"],"names":[],"mappings":";AAaA;IACE,0BASC;IARC,iBAAuD;IACvD,iBAA6D;IAC7D,2BAAkF;IAQpF;;OAEG;IACH;;;;;;;OAyCC;IAED;;OAEG;IACH;;;;;;;;MAyBC;IAED;;OAEG;IACH;;;;;SA6CC;IAED;;OAEG;IACH;;;;;;;;;;;;;;;;OA8CC;IAED;;OAEG;IACH;;;;;;SA0BC;IAED;;OAEG;IACH;;;;;OA2BC;IAED;;OAEG;IACH;;;;;MA+BC;IAED;;OAEG;IACH;;;;;;;;;;;;;;;;;OAYC;IAED;;OAEG;IACH;;;;;;;;;;;MA4EC;IAED;;OAEG;IACH;;;;;;MAiCC;IAED;;OAEG;IACH,6CA+CC;IAED;;OAEG;IACH,oCAQC;CACF"}

package/dist/commands/archive.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Archive command handler
+ * @param {string} changeId - Change identifier to archive
+ * @param {Object} options - Command options
+ */
+export function archiveCommand(changeId: string, options?: any): Promise<any>;
+/**
+ * Load change folder structure
+ * @param {string} changeId - Change identifier
+ * @returns {Promise<Object|null>} Change data or null
+ */
+export function loadChange(changeId: string): Promise<any | null>;
+/**
+ * Validate all acceptance criteria are met
+ * @param {Object} workingSpec - Working specification
+ * @returns {Promise<Object>} Validation result
+ */
+export function validateAcceptanceCriteria(workingSpec: any): Promise<any>;
+/**
+ * Validate change meets quality gates
+ * @param {string} changeId - Change identifier
+ * @returns {Promise<Object>} Quality gate result
+ */
+export function validateQualityGates(_changeId: any): Promise<any>;
+/**
+ * Generate change summary for archival
+ * @param {Object} change - Change data
+ * @returns {Promise<string>} Summary text
+ */
+export function generateChangeSummary(change: any): Promise<string>;
+/**
+ * Archive change folder to archive directory
+ * @param {Object} change - Change data
+ * @returns {Promise<void>}
+ */
+export function archiveChange(change: any): Promise<void>;
+/**
+ * Update provenance with completion
+ * @param {Object} change - Change data
+ * @returns {Promise<void>}
+ */
+export function updateProvenance(change: any): Promise<void>;
+/**
+ * Display archive results
+ * @param {Object} change - Change data
+ * @param {Object} validation - Validation result
+ * @param {Object} qualityGates - Quality gates result
+ */
+export function displayArchiveResults(change: any, validation: any, qualityGates: any): void;
+//# sourceMappingURL=archive.d.ts.map

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

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

package/dist/commands/burnup.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Burn-up command handler
+ * @param {string} specFile - Path to spec file
+ */
+export function burnupCommand(specFile: string): Promise<void>;
+//# sourceMappingURL=burnup.d.ts.map

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

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

package/dist/commands/diagnose.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Diagnose command handler
+ * @param {Object} options - Command options
+ */
+export function diagnoseCommand(options?: any): Promise<void>;
+/**
+ * Run all health checks
+ * @returns {Promise<Object>} Diagnosis results
+ */
+export function runDiagnosis(): Promise<any>;
+/**
+ * Display diagnosis results
+ * @param {Object[]} results - Diagnosis results
+ */
+export function displayResults(results: any[]): void;
+/**
+ * Apply automatic fixes
+ * @param {Object[]} results - Diagnosis results
+ * @returns {Promise<Object>} Fix results
+ */
+export function applyAutoFixes(results: any[]): Promise<any>;
+/**
+ * Health check: Working spec validity
+ * @returns {Promise<Object>} Check result
+ */
+export function checkWorkingSpec(): Promise<any>;
+/**
+ * Health check: Git repository
+ * @returns {Promise<Object>} Check result
+ */
+export function checkGitSetup(): Promise<any>;
+/**
+ * Health check: Git hooks
+ * @returns {Promise<Object>} Check result
+ */
+export function checkGitHooks(): Promise<any>;
+/**
+ * Health check: TypeScript configuration
+ * @returns {Promise<Object>} Check result
+ */
+export function checkTypeScriptConfig(): Promise<any>;
+/**
+ * Health check: Test files exist
+ * @returns {Promise<Object>} Check result
+ */
+export function checkTestFiles(): Promise<any>;
+/**
+ * Health check: CAWS tools directory
+ * @returns {Promise<Object>} Check result
+ */
+export function checkCAWSTools(): Promise<any>;
+//# sourceMappingURL=diagnose.d.ts.map

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

@@ -0,0 +1 @@
+{"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/evaluate.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Evaluate command handler
+ *
+ * @param {string} specFile - Path to working spec file
+ * @param {object} options - Command options
+ */
+export function evaluateCommand(specFile?: string, options?: object): Promise<void>;
+//# sourceMappingURL=evaluate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"evaluate.d.ts","sourceRoot":"","sources":["../../src/commands/evaluate.js"],"names":[],"mappings":"AAeA;;;;;GAKG;AACH,2CAHW,MAAM,YACN,MAAM,iBA0QhB"}

package/dist/commands/init.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Initialize a new project with CAWS
+ */
+export function initProject(projectName: any, options: any): Promise<void>;
+//# sourceMappingURL=init.d.ts.map

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

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

package/dist/commands/iterate.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Iterate command handler
+ *
+ * @param {string} specFile - Path to working spec file
+ * @param {object} options - Command options
+ */
+export function iterateCommand(specFile?: string, options?: object): Promise<void>;
+//# sourceMappingURL=iterate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"iterate.d.ts","sourceRoot":"","sources":["../../src/commands/iterate.js"],"names":[],"mappings":"AAiBA;;;;;GAKG;AACH,0CAHW,MAAM,YACN,MAAM,iBAgLhB"}

package/dist/commands/mode.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Mode command handler
+ * @param {string} action - Action to perform (current, set, compare, recommend)
+ * @param {Object} options - Command options
+ */
+export function modeCommand(action: string, options?: any): Promise<any>;
+import { getCurrentMode } from "../config/modes";
+import { setCurrentMode } from "../config/modes";
+/**
+ * Display current mode status
+ */
+export function displayCurrentMode(): void;
+/**
+ * Display mode details
+ * @param {string} mode - Mode to display
+ */
+export function displayModeDetails(mode: string): void;
+/**
+ * Interactive mode selection
+ * @returns {Promise<string>} Selected mode
+ */
+export function interactiveModeSelection(): Promise<string>;
+export { getCurrentMode, setCurrentMode };
+//# sourceMappingURL=mode.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mode.d.ts","sourceRoot":"","sources":["../../src/commands/mode.js"],"names":[],"mappings":"AAuHA;;;;GAIG;AACH,oCAHW,MAAM,+BAgIhB;;;AAvOD;;GAEG;AACH,2CAOC;AAED;;;GAGG;AACH,yCAFW,MAAM,QA+ChB;AAED;;;GAGG;AACH,4CAFa,OAAO,CAAC,MAAM,CAAC,CAkC3B"}

package/dist/commands/plan.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Plan command handler
+ * @param {string} action - Action to perform (generate)
+ * @param {Object} options - Command options
+ */
+export function planCommand(action: string, options?: any): Promise<any>;
+/**
+ * Generate implementation plan from spec
+ * @param {Object} spec - Spec data
+ * @returns {Object} Generated plan
+ */
+export function generateImplementationPlan(spec: any): any;
+/**
+ * Write plan to file
+ * @param {Object} plan - Plan data
+ * @param {string} outputPath - Output file path
+ * @returns {Promise<void>}
+ */
+export function writePlanToFile(plan: any, outputPath: string): Promise<void>;
+/**
+ * Generate markdown content from plan
+ * @param {Object} plan - Plan data
+ * @returns {string} Markdown content
+ */
+export function generatePlanMarkdown(plan: any): string;
+/**
+ * Display generated plan
+ * @param {Object} plan - Plan data
+ */
+export function displayGeneratedPlan(plan: any): void;
+export namespace PLAN_TEMPLATES {
+    namespace feature {
+        let sections: string[];
+        let defaultTasks: string[];
+    }
+    namespace fix {
+        let sections_1: string[];
+        export { sections_1 as sections };
+        let defaultTasks_1: string[];
+        export { defaultTasks_1 as defaultTasks };
+    }
+    namespace refactor {
+        let sections_2: string[];
+        export { sections_2 as sections };
+        let defaultTasks_2: string[];
+        export { defaultTasks_2 as defaultTasks };
+    }
+}
+//# sourceMappingURL=plan.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../src/commands/plan.js"],"names":[],"mappings":"AA6XA;;;;GAIG;AACH,oCAHW,MAAM,+BAuDhB;AA1OD;;;;GAIG;AACH,2DA8CC;AAED;;;;;GAKG;AACH,uDAHW,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAQzB;AAED;;;;GAIG;AACH,iDAFa,MAAM,CAiElB;AAED;;;GAGG;AACH,sDAkCC"}

package/dist/commands/provenance.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Provenance command handler
+ * @param {string} subcommand - The subcommand to execute
+ * @param {Object} options - Command options
+ */
+export function provenanceCommand(subcommand: string, options: any): Promise<any>;
+/**
+ * Update provenance with new commit information
+ * @param {Object} options - Command options
+ */
+export function updateProvenance(options: any): Promise<void>;
+/**
+ * Show current provenance information
+ * @param {Object} options - Command options
+ */
+export function showProvenance(options: any): Promise<void>;
+/**
+ * Verify provenance chain integrity
+ * @param {Object} options - Command options
+ */
+export function verifyProvenance(options: any): Promise<void>;
+/**
+ * Initialize provenance tracking for the project
+ * @param {Object} options - Command options
+ */
+export function initProvenance(options: any): Promise<void>;
+/**
+ * Install git hooks for automatic provenance updates
+ * @param {Object} options - Command options
+ */
+export function installHooks(options: any): Promise<void>;
+//# sourceMappingURL=provenance.d.ts.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,6 @@
+/**
+ * Run comprehensive quality gates on staged files
+ * @param {Object} options - Command options
+ */
+export function qualityGatesCommand(options?: any): Promise<any>;
+//# sourceMappingURL=quality-gates.d.ts.map

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

@@ -0,0 +1 @@
+{"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

@@ -212,6 +212,12 @@ async function qualityGatesCommand(options = {}) {
           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(' ')}`);
@@ -310,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,
@@ -336,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 {
@@ -345,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/quality-monitor.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Quality monitor command handler
+ *
+ * @param {string} action - Type of action to monitor
+ * @param {object} options - Command options
+ */
+export function qualityMonitorCommand(action: string, options?: object): Promise<void>;
+/**
+ * Analyze quality impact of an action
+ *
+ * @param {string} action - Type of action (file_saved, code_edited, test_run)
+ * @param {array} files - Files affected by the action
+ * @param {object} context - Additional context information
+ * @returns {object} Quality analysis
+ */
+export function analyzeQualityImpact(action: string, files?: any[], context?: object): object;
+//# sourceMappingURL=quality-monitor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"quality-monitor.d.ts","sourceRoot":"","sources":["../../src/commands/quality-monitor.js"],"names":[],"mappings":"AAoIA;;;;;GAKG;AACH,8CAHW,MAAM,YACN,MAAM,iBA2HhB;AArPD;;;;;;;GAOG;AACH,6CALW,MAAM,2BAEN,MAAM,GACJ,MAAM,CA8GlB"}