@paths.design/caws-cli 5.0.1 → 5.1.0

package/README.md

@@ -20,7 +20,7 @@ The CAWS CLI serves as the central control point for:
 ### Global Installation (Recommended)
 
 ```bash
-npm install -g @caws/cli
+npm install -g @paths.design/caws-cli
 ```
 
 ### Local Development
@@ -199,17 +199,17 @@ Projects use `.caws/working-spec.yaml` files:
 
 ```yaml
 id: PROJ-001
-title: "Feature implementation"
+title: 'Feature implementation'
 risk_tier: 2
 mode: feature
 change_budget:
   max_files: 25
   max_loc: 1000
 acceptance:
-  - id: "A1"
-    given: "Current state"
-    when: "Feature implemented"
-    then: "Expected behavior"
+  - id: 'A1'
+    given: 'Current state'
+    when: 'Feature implemented'
+    then: 'Expected behavior'
 ```
 
 ### Tool Configuration
@@ -256,7 +256,7 @@ class MyTool extends BaseTool {
       id: 'my-tool',
       name: 'My Custom Tool',
       capabilities: ['validation'],
-      version: '1.0.0'
+      version: '1.0.0',
     };
   }
 
@@ -306,9 +306,10 @@ npm run test:contract     # Contract tests
 ### Common Issues
 
 **Command not found**
+
 ```bash
 # Ensure global installation
-npm install -g @caws/cli
+npm install -g @paths.design/caws-cli
 caws --version
 
 # Or use local installation
@@ -316,6 +317,7 @@ node packages/caws-cli/dist/index.js --help
 ```
 
 **Tool loading errors**
+
 ```bash
 # Check tool directory structure
 ls -la apps/tools/caws/
@@ -328,6 +330,7 @@ chmod +x apps/tools/caws/*.js
 ```
 
 **Validation failures**
+
 ```bash
 # Check working spec syntax
 caws validate --suggestions .caws/working-spec.yaml
@@ -361,7 +364,7 @@ MIT License - see main project LICENSE file.
 
 ## Links
 
-- **Main Project**: https://github.com/paths-design/caws
-- **Documentation**: https://docs.caws.dev
-- **Issues**: https://github.com/paths-design/caws/issues
-- **Discussions**: https://github.com/paths-design/caws/discussions
+- **Main Project**: https://github.com/Paths-Design/coding-agent-working-standard
+- **Documentation**: https://docs.paths.design
+- **Issues**: https://github.com/Paths-Design/coding-agent-working-standard/issues
+- **Discussions**: https://github.com/Paths-Design/coding-agent-working-standard/discussions

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,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"}

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":"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"}

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":"AAoBA;;GAEG;AACH,2EAseC"}

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<void>;
+/**
+ * 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":"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"}

package/dist/commands/provenance.js

@@ -8,6 +8,7 @@ const fs = require('fs-extra');
 const path = require('path');
 const crypto = require('crypto');
 const yaml = require('js-yaml');
+const { commandWrapper } = require('../utils/command-wrapper');
 
 /**
  * Provenance command handler
@@ -15,29 +16,33 @@ const yaml = require('js-yaml');
  * @param {Object} options - Command options
  */
 async function provenanceCommand(subcommand, options) {
-  try {
-    switch (subcommand) {
-      case 'update':
-        return await updateProvenance(options);
-      case 'show':
-        return await showProvenance(options);
-      case 'verify':
-        return await verifyProvenance(options);
-      case 'analyze-ai':
-        return await analyzeAIProvenance(options);
-      case 'init':
-        return await initProvenance(options);
-      case 'install-hooks':
-        return await installHooks(options);
-      default:
-        console.error(`❌ Unknown provenance subcommand: ${subcommand}`);
-        console.log('Available commands: update, show, verify, analyze-ai, init, install-hooks');
-        process.exit(1);
+  return commandWrapper(
+    async () => {
+      switch (subcommand) {
+        case 'update':
+          return await updateProvenance(options);
+        case 'show':
+          return await showProvenance(options);
+        case 'verify':
+          return await verifyProvenance(options);
+        case 'analyze-ai':
+          return await analyzeAIProvenance(options);
+        case 'init':
+          return await initProvenance(options);
+        case 'install-hooks':
+          return await installHooks(options);
+        default:
+          throw new Error(
+            `Unknown provenance subcommand: ${subcommand}.\n` +
+            'Available commands: update, show, verify, analyze-ai, init, install-hooks'
+          );
+      }
+    },
+    {
+      commandName: `provenance ${subcommand}`,
+      context: { subcommand, options },
     }
-  } catch (error) {
-    console.error(`❌ Provenance command failed: ${error.message}`);
-    process.exit(1);
-  }
+  );
 }
 
 /**