@paths.design/caws-cli 7.0.3 → 8.0.0

package/dist/minimal-cli.d.ts

@@ -1,3 +0,0 @@
-#!/usr/bin/env node
-export {};
-//# sourceMappingURL=minimal-cli.d.ts.map

package/dist/minimal-cli.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"minimal-cli.d.ts","sourceRoot":"","sources":["../src/minimal-cli.js"],"names":[],"mappings":""}

package/dist/policy/PolicyManager.d.ts

@@ -1,104 +0,0 @@
-/**
- * Policy Manager - Handles policy loading with intelligent caching
- *
- * Features:
- * - TTL-based caching for performance
- * - Graceful fallback to defaults when policy.yaml missing
- * - Cache inspection and management API
- * - Waiver validation and delta application
- */
-export class PolicyManager {
-    constructor(options?: {});
-    enableCaching: any;
-    cacheTTL: any;
-    policyCache: Map<any, any>;
-    /**
-     * Load CAWS policy from policy.yaml with caching
-     *
-     * @param {string} projectRoot - Project root directory
-     * @param {Object} options - Loading options
-     * @param {boolean} options.useCache - Use cache if available (default: true)
-     * @param {number} options.cacheTTL - Cache TTL override in milliseconds
-     * @returns {Promise<Object>} Policy object
-     */
-    loadPolicy(projectRoot: string, options?: {
-        useCache: boolean;
-        cacheTTL: number;
-    }): Promise<any>;
-    /**
-     * Load a waiver document by ID
-     *
-     * @param {string} waiverId - Waiver ID (e.g., WV-0001)
-     * @param {string} projectRoot - Project root directory
-     * @returns {Promise<Object|null>} Waiver document or null if not found
-     */
-    loadWaiver(waiverId: string, projectRoot: string): Promise<any | null>;
-    /**
-     * Check if a waiver is currently valid
-     *
-     * @param {Object} waiver - Waiver document
-     * @returns {boolean} True if waiver is valid and active
-     */
-    isWaiverValid(waiver: any): boolean;
-    /**
-     * Apply waivers to baseline budget
-     *
-     * @param {Object} baseline - Baseline budget from policy
-     * @param {string[]} waiverIds - Array of waiver IDs to apply
-     * @param {string} projectRoot - Project root directory
-     * @returns {Promise<Object>} Effective budget with waivers applied
-     */
-    applyWaivers(baseline: any, waiverIds: string[], projectRoot: string): Promise<any>;
-    /**
-     * Validate policy structure
-     *
-     * @param {Object} policy - Policy to validate
-     * @throws {Error} If policy is invalid
-     */
-    validatePolicy(policy: any): void;
-    /**
-     * Get default CAWS policy
-     *
-     * Returns sensible defaults when policy.yaml doesn't exist.
-     *
-     * @returns {Object} Default policy configuration
-     */
-    getDefaultPolicy(): any;
-    /**
-     * Clear policy cache
-     *
-     * @param {string} [projectRoot] - Specific project to clear, or all if omitted
-     */
-    clearCache(projectRoot?: string): void;
-    /**
-     * Get cache status for a project
-     *
-     * @param {string} projectRoot - Project root directory
-     * @returns {Object} Cache status information
-     */
-    getCacheStatus(projectRoot: string): any;
-    /**
-     * Reload policy from disk (bypassing cache)
-     *
-     * @param {string} projectRoot - Project root directory
-     * @returns {Promise<Object>} Fresh policy
-     */
-    reloadPolicy(projectRoot: string): Promise<any>;
-    /**
-     * Get all cached projects
-     *
-     * @returns {string[]} Array of project roots with cached policies
-     */
-    getCachedProjects(): string[];
-    /**
-     * Get cache statistics
-     *
-     * @returns {Object} Cache statistics
-     */
-    getCacheStats(): any;
-}
-export const defaultPolicyManager: PolicyManager;
-export declare function loadPolicy(projectRoot: any, options: any): Promise<any>;
-export declare function clearCache(projectRoot: any): void;
-export declare function getCacheStatus(projectRoot: any): any;
-//# sourceMappingURL=PolicyManager.d.ts.map

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

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

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

@@ -1,7 +0,0 @@
-/**
- * Scaffold Cursor hooks for a CAWS project
- * @param {string} projectDir - Project directory path
- * @param {string[]} levels - Hook levels to enable
- */
-export function scaffoldCursorHooks(projectDir: string, levels?: string[]): Promise<void>;
-//# sourceMappingURL=cursor-hooks.d.ts.map

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

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

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

@@ -1,20 +0,0 @@
-/**
- * Scaffold git hooks for CAWS provenance tracking
- * @param {string} projectDir - Project directory path
- * @param {Object} options - Hook options
- */
-export function scaffoldGitHooks(projectDir: string, options?: any): Promise<{
-    added: number;
-    skipped: number;
-}>;
-/**
- * Remove CAWS git hooks
- * @param {string} projectDir - Project directory path
- */
-export function removeGitHooks(projectDir: string): Promise<void>;
-/**
- * Check git hooks status
- * @param {string} projectDir - Project directory path
- */
-export function checkGitHooksStatus(projectDir: string): Promise<void>;
-//# sourceMappingURL=git-hooks.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"git-hooks.d.ts","sourceRoot":"","sources":["../../src/scaffold/git-hooks.js"],"names":[],"mappings":"AASA;;;;GAIG;AACH,6CAHW,MAAM;;;GAwGhB;AAwND;;;GAGG;AACH,2CAFW,MAAM,iBAkChB;AAED;;;GAGG;AACH,gDAFW,MAAM,iBAgDhB"}

package/dist/scaffold/index.d.ts

@@ -1,20 +0,0 @@
-/**
- * Scaffold existing project with CAWS components
- * @param {Object} options - Scaffold options
- */
-export function scaffoldProject(options: any): Promise<void>;
-/**
- * Scaffold IDE integrations for comprehensive CAWS development experience
- * @param {string} targetDir - Target directory for scaffolding
- * @param {Object} options - Scaffold options
- */
-export function scaffoldIDEIntegrations(targetDir: string, options: any): Promise<{
-    added: number;
-    skipped: number;
-}>;
-/**
- * Set dependencies for scaffold module
- * @param {Object} deps - Dependencies object
- */
-export function setScaffoldDependencies(deps: any): void;
-//# sourceMappingURL=index.d.ts.map

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

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

package/dist/spec/SpecFileManager.d.ts

@@ -1,146 +0,0 @@
-/**
- * Spec File Manager - Handles WorkingSpec file operations and YAML conversion
- *
- * Features:
- * - Bidirectional WorkingSpec ↔ YAML conversion
- * - Temporary file support for validation workflows
- * - Backup/restore capabilities
- * - Automatic cleanup of old temporary files
- */
-export class SpecFileManager {
-    constructor(config?: {});
-    projectRoot: any;
-    useTemporaryFiles: any;
-    tempDir: any;
-    /**
-     * Convert WorkingSpec object to YAML string
-     *
-     * @param {Object} spec - WorkingSpec to convert
-     * @returns {string} YAML string representation
-     */
-    specToYaml(spec: any): string;
-    /**
-     * Parse YAML string to WorkingSpec object
-     *
-     * @param {string} yamlContent - YAML string to parse
-     * @returns {Object} Parsed WorkingSpec object
-     * @throws {Error} If YAML is invalid or doesn't match WorkingSpec schema
-     */
-    yamlToSpec(yamlContent: string): any;
-    /**
-     * Get path to .caws/working-spec.yaml in project
-     *
-     * @returns {string} Absolute path to working spec file
-     */
-    getSpecFilePath(): string;
-    /**
-     * Check if working spec file exists
-     *
-     * @returns {Promise<boolean>} True if file exists
-     */
-    specFileExists(): Promise<boolean>;
-    /**
-     * Read working spec from .caws/working-spec.yaml
-     *
-     * @returns {Promise<Object>} Parsed WorkingSpec object
-     * @throws {Error} If file doesn't exist or is invalid
-     */
-    readSpecFile(): Promise<any>;
-    /**
-     * Write WorkingSpec to file
-     *
-     * Writes to .caws/working-spec.yaml or a temporary file based on configuration.
-     *
-     * @param {Object} spec - WorkingSpec to write
-     * @param {Object} options - Write options
-     * @param {boolean} options.useTemp - Override temp file usage
-     * @param {boolean} options.backup - Create backup before writing
-     * @returns {Promise<Object>} Write result with file path and cleanup function
-     */
-    writeSpecFile(spec: any, options?: {
-        useTemp: boolean;
-        backup: boolean;
-    }): Promise<any>;
-    /**
-     * Update existing working spec file
-     *
-     * Reads current spec, merges changes, and writes back.
-     *
-     * @param {Object} updates - Partial WorkingSpec with fields to update
-     * @returns {Promise<Object>} Updated WorkingSpec
-     */
-    updateSpecFile(updates: any): Promise<any>;
-    /**
-     * Create backup of working spec
-     *
-     * @returns {Promise<string>} Path to backup file
-     */
-    backupSpecFile(): Promise<string>;
-    /**
-     * Restore working spec from backup
-     *
-     * @param {string} backupPath - Path to backup file
-     * @returns {Promise<void>}
-     */
-    restoreSpecFile(backupPath: string): Promise<void>;
-    /**
-     * List all backup files
-     *
-     * @returns {Promise<string[]>} Array of backup file paths
-     */
-    listBackups(): Promise<string[]>;
-    /**
-     * Delete old backup files
-     *
-     * @param {Object} options - Cleanup options
-     * @param {number} options.maxAge - Maximum age in milliseconds (default: 7 days)
-     * @param {number} options.keep - Minimum number of backups to keep (default: 5)
-     * @returns {Promise<number>} Number of backups deleted
-     */
-    cleanupBackups(options?: {
-        maxAge: number;
-        keep: number;
-    }): Promise<number>;
-    /**
-     * Validate spec file exists and is parseable
-     *
-     * @returns {Promise<Object>} Validation result
-     */
-    validateSpecFile(): Promise<any>;
-    /**
-     * Clean up old temporary spec files
-     *
-     * Removes temp files older than specified age.
-     *
-     * @param {number} maxAge - Maximum age in milliseconds (default: 1 hour)
-     * @returns {Promise<number>} Number of files cleaned up
-     */
-    cleanupTempFiles(maxAge?: number): Promise<number>;
-    /**
-     * Get spec file stats (size, modified date, etc.)
-     *
-     * @returns {Promise<Object>} File stats
-     */
-    getSpecFileStats(): Promise<any>;
-    /**
-     * Create a new SpecFileManager instance with different configuration
-     *
-     * @param {Object} config - New configuration
-     * @returns {SpecFileManager} New instance
-     */
-    withConfig(config: any): SpecFileManager;
-}
-export const defaultSpecFileManager: SpecFileManager;
-/**
- * Create a SpecFileManager instance with default configuration
- *
- * @param {string} projectRoot - Project root directory
- * @param {Object} options - Additional options
- * @returns {SpecFileManager} SpecFileManager instance
- */
-export function createSpecFileManager(projectRoot: string, options?: any): SpecFileManager;
-export declare function specToYaml(spec: any): string;
-export declare function yamlToSpec(yaml: any): any;
-export declare function readSpecFile(projectRoot: any): Promise<any>;
-export declare function writeSpecFile(spec: any, projectRoot: any, options: any): Promise<any>;
-//# sourceMappingURL=SpecFileManager.d.ts.map

package/dist/spec/SpecFileManager.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"SpecFileManager.d.ts","sourceRoot":"","sources":["../../src/spec/SpecFileManager.js"],"names":[],"mappings":"AAaA;;;;;;;;GAQG;AACH;IACE,yBAIC;IAHC,iBAAsD;IACtD,uBAA0D;IAC1D,aAA4C;IAG9C;;;;;OAKG;IACH,uBAFa,MAAM,CASlB;IAED;;;;;;OAMG;IACH,wBAJW,MAAM,OAqBhB;IAED;;;;OAIG;IACH,mBAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,kBAFa,OAAO,CAAC,OAAO,CAAC,CAS5B;IAED;;;;;OAKG;IACH,gBAHa,OAAO,KAAQ,CAe3B;IAED;;;;;;;;;;OAUG;IACH,mCAJG;QAAyB,OAAO,EAAxB,OAAO;QACU,MAAM,EAAvB,OAAO;KACf,GAAU,OAAO,KAAQ,CA2C3B;IAED;;;;;;;OAOG;IACH,8BAFa,OAAO,KAAQ,CAa3B;IAED;;;;OAIG;IACH,kBAFa,OAAO,CAAC,MAAM,CAAC,CAS3B;IAED;;;;;OAKG;IACH,4BAHW,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAKzB;IAED;;;;OAIG;IACH,eAFa,OAAO,CAAC,MAAM,EAAE,CAAC,CAoB7B;IAED;;;;;;;OAOG;IACH,yBAJG;QAAwB,MAAM,EAAtB,MAAM;QACU,IAAI,EAApB,MAAM;KACd,GAAU,OAAO,CAAC,MAAM,CAAC,CA+B3B;IAED;;;;OAIG;IACH,oBAFa,OAAO,KAAQ,CAe3B;IAED;;;;;;;OAOG;IACH,0BAHW,MAAM,GACJ,OAAO,CAAC,MAAM,CAAC,CA6B3B;IAED;;;;OAIG;IACH,oBAFa,OAAO,KAAQ,CA0B3B;IAED;;;;;OAKG;IACH,yBAFa,eAAe,CAS3B;CACF;AAiBD,qDAAqD;AAfrD;;;;;;GAMG;AACH,mDAJW,MAAM,kBAEJ,eAAe,CAO3B;AAWa,sDAAiD;AACjD,mDAAiD;AAC/C,qEAKb;AACc,+FAKd"}

package/dist/test-analysis.d.ts

@@ -1,182 +0,0 @@
-/**
- * Main Test Analysis CLI handler
- */
-export function testAnalysisCommand(subcommand: any, options?: any[]): Promise<void>;
-/**
- * Waiver Pattern Learning Engine
- * Analyzes waiver history to find systematic patterns in budget overruns
- */
-export class WaiverPatternLearner {
-    constructor(projectRoot?: string);
-    projectRoot: string;
-    /**
-     * Analyze waiver patterns from historical data
-     */
-    analyzePatterns(): {
-        status: string;
-        patterns: {
-            total_waivers: number;
-            budget_overruns: {
-                average_overrun_files: number;
-                average_overrun_loc: number;
-                common_patterns: any[];
-                total_budget_waivers?: undefined;
-            } | {
-                total_budget_waivers: any;
-                average_overrun_files: number;
-                average_overrun_loc: number;
-                common_patterns: {
-                    reason: string;
-                    frequency: number;
-                    avg_overrun_files: number;
-                    avg_overrun_loc: number;
-                }[];
-            };
-            common_reasons: {
-                reason: string;
-                count: any;
-                frequency: number;
-            }[];
-            risk_factors: {
-                factor: string;
-                description: string;
-                risk_level: string;
-            }[];
-            generated_at: string;
-        };
-        message?: undefined;
-    } | {
-        status: string;
-        message: any;
-        patterns: {};
-    };
-    /**
-     * Load all waiver files from .caws/waivers/
-     */
-    loadWaivers(): any[];
-    /**
-     * Load historical working specs (mock implementation)
-     */
-    loadHistoricalSpecs(): any[];
-    /**
-     * Analyze budget overrun patterns
-     */
-    analyzeBudgetOverruns(waivers: any, specs: any): {
-        average_overrun_files: number;
-        average_overrun_loc: number;
-        common_patterns: any[];
-        total_budget_waivers?: undefined;
-    } | {
-        total_budget_waivers: any;
-        average_overrun_files: number;
-        average_overrun_loc: number;
-        common_patterns: {
-            reason: string;
-            frequency: number;
-            avg_overrun_files: number;
-            avg_overrun_loc: number;
-        }[];
-    };
-    /**
-     * Analyze most common waiver reasons
-     */
-    analyzeCommonReasons(waivers: any): {
-        reason: string;
-        count: any;
-        frequency: number;
-    }[];
-    /**
-     * Identify risk factors from waiver patterns
-     */
-    identifyRiskFactors(waivers: any, specs: any): {
-        factor: string;
-        description: string;
-        risk_level: string;
-    }[];
-}
-/**
- * Project Similarity Matcher
- * Finds historical projects similar to current work
- */
-export class ProjectSimilarityMatcher {
-    constructor(projectRoot?: string);
-    projectRoot: string;
-    /**
-     * Find projects similar to the current spec
-     */
-    findSimilarProjects(currentSpec: any): {
-        project: string;
-        similarity_score: number;
-        budget_accuracy: number;
-        waiver_count: number;
-        details: {
-            id: string;
-            title: string;
-            risk_tier: number;
-            mode: string;
-            tech_stack: string;
-            feature_type: string;
-            actual_budget: {
-                files: number;
-                loc: number;
-            };
-            allocated_budget: {
-                files: number;
-                loc: number;
-            };
-            waivers: string[];
-        };
-    }[];
-    /**
-     * Calculate similarity score between two specs/projects
-     */
-    calculateSimilarity(spec1: any, spec2: any): number;
-}
-/**
- * Budget Predictor using statistical analysis
- */
-export class BudgetPredictor {
-    constructor(projectRoot?: string);
-    projectRoot: string;
-    patternLearner: WaiverPatternLearner;
-    similarityMatcher: ProjectSimilarityMatcher;
-    /**
-     * Assess budget for a working spec
-     */
-    assessBudget(spec: any): {
-        status: string;
-        assessment: {
-            similar_projects_analyzed: number;
-            recommended_budget: {
-                files: number;
-                loc: number;
-            };
-            baseline_budget: {
-                files: number;
-                loc: number;
-            };
-            buffer_applied: {
-                files_percent: number;
-                loc_percent: number;
-            };
-            rationale: string[];
-            risk_factors: any;
-            confidence: number;
-        };
-        message?: undefined;
-        recommendation?: undefined;
-    } | {
-        status: string;
-        message: any;
-        recommendation: {
-            use_default_tier: boolean;
-            confidence: number;
-        };
-        assessment?: undefined;
-    };
-    /**
-     * Generate human-readable rationale for the recommendation
-     */
-    generateRationale(spec: any, similarProjects: any, patterns: any): string[];
-}
-//# sourceMappingURL=test-analysis.d.ts.map

package/dist/test-analysis.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"test-analysis.d.ts","sourceRoot":"","sources":["../src/test-analysis.js"],"names":[],"mappings":"AAiZA;;GAEG;AACH,qFAsBC;AAhaD;;;GAGG;AACH;IACE,kCAEC;IADC,oBAA8B;IAGhC;;OAEG;IACH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAgCC;IAED;;OAEG;IACH,qBAsBC;IAED;;OAEG;IACH,6BAIC;IAED;;OAEG;IACH;;;;;;;;;;;;;;;MA6CC;IAED;;OAEG;IACH;;;;QAaC;IAED;;OAEG;IACH;;;;QAeC;CACF;AAED;;;GAGG;AACH;IACE,kCAEC;IADC,oBAA8B;IAGhC;;OAEG;IACH;;;;;;;;;;;;;;;;;;;;;;QAkEC;IAED;;OAEG;IACH,oDA6BC;CACF;AAED;;GAEG;AACH;IACE,kCAIC;IAHC,oBAA8B;IAC9B,qCAA2D;IAC3D,4CAAkE;IAGpE;;OAEG;IACH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MA8DC;IAED;;OAEG;IACH,4EAsBC;CACF"}