@paths.design/caws-cli 5.0.1 → 5.1.0

package/dist/minimal-cli.d.ts

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

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

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

package/dist/policy/PolicyManager.d.ts

@@ -0,0 +1,104 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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/policy/PolicyManager.js

@@ -54,51 +54,83 @@ class PolicyManager {
         }
       }
 
-      // Load from file
-      const policyPath = path.join(projectRoot, '.caws', 'policy.yaml');
-
-      try {
-        const content = await fs.readFile(policyPath, 'utf-8');
-        const policy = yaml.load(content);
+      // Load from file - check multiple locations for backward compatibility
+      const policyPaths = [
+        path.join(projectRoot, '.caws', 'policy.yaml'), // Preferred location
+        path.join(projectRoot, '.caws', 'policy', 'tier-policy.json'), // Legacy location
+      ];
+
+      let policyPath = null;
+      let policyContent = null;
+
+      // Try each path in order
+      for (const candidatePath of policyPaths) {
+        try {
+          if (await fs.pathExists(candidatePath)) {
+            policyPath = candidatePath;
+            const content = await fs.readFile(candidatePath, 'utf-8');
+
+            // Handle JSON format (legacy)
+            if (candidatePath.endsWith('.json')) {
+              policyContent = JSON.parse(content);
+            } else {
+              // Handle YAML format (preferred)
+              policyContent = yaml.load(content);
+            }
+            break;
+          }
+        } catch (error) {
+          // Continue to next path if this one fails
+          continue;
+        }
+      }
 
+      if (policyPath && policyContent) {
         // Validate policy structure
-        this.validatePolicy(policy);
+        this.validatePolicy(policyContent);
 
         // Update cache
         if (this.enableCaching) {
           this.policyCache.set(projectRoot, {
-            policy,
+            policy: policyContent,
             cachedAt: Date.now(),
             ttl: cacheTTL,
           });
         }
 
+        // Warn if using legacy location
+        if (policyPath.endsWith('.json')) {
+          console.warn(
+            '⚠️  Using legacy policy file location: .caws/policy/tier-policy.json\n' +
+              '   Migrate to .caws/policy.yaml for better compatibility\n' +
+              '   Run: caws init --migrate-policy'
+          );
+        }
+
         return {
-          ...policy,
+          ...policyContent,
           _cacheHit: false,
           _loadDuration: Date.now() - startTime,
+          _policyPath: policyPath,
         };
-      } catch (error) {
-        if (error.code === 'ENOENT') {
-          // Policy file doesn't exist - use default
-          const defaultPolicy = this.getDefaultPolicy();
-
-          if (this.enableCaching) {
-            this.policyCache.set(projectRoot, {
-              policy: defaultPolicy,
-              cachedAt: Date.now(),
-              ttl: cacheTTL,
-            });
-          }
+      } else {
+        // Policy file doesn't exist - use default
+        const defaultPolicy = this.getDefaultPolicy();
 
-          return {
-            ...defaultPolicy,
-            _isDefault: true,
-            _cacheHit: false,
-            _loadDuration: Date.now() - startTime,
-          };
+        if (this.enableCaching) {
+          this.policyCache.set(projectRoot, {
+            policy: defaultPolicy,
+            cachedAt: Date.now(),
+            ttl: cacheTTL,
+          });
         }
-        throw error;
+
+        return {
+          ...defaultPolicy,
+          _isDefault: true,
+          _cacheHit: false,
+          _loadDuration: Date.now() - startTime,
+        };
       }
     } catch (error) {
       throw new Error(`Policy load failed: ${error.message}`);

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

@@ -0,0 +1,7 @@
+/**
+ * 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

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

@@ -0,0 +1,20 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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/git-hooks.js

@@ -117,6 +117,7 @@ async function scaffoldGitHooks(projectDir, options = {}) {
 
 /**
  * Generate pre-commit hook content with staged file quality gates
+ * Implements fallback chain: Node script → CLI → Python scripts → Skip gracefully
  */
 function generatePreCommitHook(options) {
   const { qualityGates = true, stagedOnly = true } = options;
@@ -124,6 +125,7 @@ function generatePreCommitHook(options) {
   return `#!/bin/bash
 # CAWS Pre-commit Hook
 # Runs validation and quality checks before commits
+# Implements graceful fallback chain to avoid blocking commits
 
 set -e
 
@@ -136,39 +138,87 @@ if [ ! -d ".caws" ]; then
   exit 0
 fi
 
-# Run quality gates
-if command -v node >/dev/null 2>&1; then
-  if node scripts/quality-gates/run-quality-gates.js; then
-    echo "✅ Quality gates passed"
+# Fallback chain for quality gates:
+# 1. Try Node.js script (if exists)
+# 2. Try CAWS CLI
+# 3. Try Makefile target
+# 4. Try Python scripts
+# 5. Skip gracefully (warn only)
+
+QUALITY_GATES_RAN=false
+
+# Option 1: Node.js quality gates script
+if [ -f "scripts/quality-gates/run-quality-gates.js" ]; then
+  if command -v node >/dev/null 2>&1; then
+    echo "📁 Running Node.js quality gates script..."
+    if node scripts/quality-gates/run-quality-gates.js; then
+      echo "✅ Quality gates passed"
+      QUALITY_GATES_RAN=true
+    else
+      echo "❌ Quality gates failed - commit blocked"
+      echo "💡 Fix the violations above before committing"
+      exit 1
+    fi
+  fi
+# Option 2: CAWS CLI validation
+elif command -v caws >/dev/null 2>&1; then
+  echo "📋 Running CAWS CLI validation..."
+  if caws validate --quiet 2>/dev/null; then
+    echo "✅ CAWS validation passed"
+    QUALITY_GATES_RAN=true
   else
-    echo "❌ Quality gates failed - commit blocked"
-    echo "💡 Fix the violations above before committing"
-    echo "📖 See docs/refactoring.md for crisis response plan"
-    exit 1
+    echo "⚠️  CAWS validation failed, but allowing commit (non-blocking)"
+    echo "💡 Run 'caws validate' for details"
+    QUALITY_GATES_RAN=true
+  fi
+# Option 3: Makefile target
+elif [ -f "Makefile" ] && grep -q "caws-validate\\|caws-gates" Makefile; then
+  echo "🔧 Running Makefile quality gates..."
+  if make caws-validate >/dev/null 2>&1 || make caws-gates >/dev/null 2>&1; then
+    echo "✅ Makefile quality gates passed"
+    QUALITY_GATES_RAN=true
+  else
+    echo "⚠️  Makefile quality gates failed, but allowing commit (non-blocking)"
+    QUALITY_GATES_RAN=true
+  fi
+# Option 4: Python scripts
+elif [ -f "scripts/simple_gates.py" ] && command -v python3 >/dev/null 2>&1; then
+  echo "🐍 Running Python quality gates script..."
+  if python3 scripts/simple_gates.py all --tier 2 --profile backend-api >/dev/null 2>&1; then
+    echo "✅ Python quality gates passed"
+    QUALITY_GATES_RAN=true
+  else
+    echo "⚠️  Python quality gates failed, but allowing commit (non-blocking)"
+    QUALITY_GATES_RAN=true
   fi
+# Option 5: Skip gracefully
 else
-  echo "⚠️  Node.js not found - skipping quality gates"
-  echo "💡 Install Node.js to enable automatic quality checking"
-  exit 0
+  echo "⚠️  Quality gates not available - skipping"
+  echo "💡 Available options:"
+  echo "   • Install: npm install -g @paths.design/caws-cli"
+  echo "   • Use Python: python3 scripts/simple_gates.py"
+  echo "   • Use Makefile: make caws-gates"
+  QUALITY_GATES_RAN=true
 fi
 
-# Run hidden TODO analysis on staged files only
-echo "🔍 Checking for hidden TODOs in staged files..."
-if command -v python3 >/dev/null 2>&1; then
-  if python3 scripts/v3/analysis/todo_analyzer.py --staged-only --ci-mode --min-confidence 0.8 >/dev/null 2>&1; then
-    echo "✅ No critical hidden TODOs found in staged files"
-  else
-    echo "❌ Critical hidden TODOs detected in staged files - commit blocked"
-    echo "💡 Fix stub implementations and placeholder code before committing"
-    echo "📖 See docs/PLACEHOLDER-DETECTION-GUIDE.md for classification"
-    echo ""
-    echo "🔍 Running detailed analysis on staged files..."
-    python3 scripts/v3/analysis/todo_analyzer.py --staged-only --min-confidence 0.8
-    exit 1
+# Run hidden TODO analysis on staged files only (if Python available)
+if [ "$QUALITY_GATES_RAN" = true ]; then
+  echo "🔍 Checking for hidden TODOs in staged files..."
+  if command -v python3 >/dev/null 2>&1 && [ -f "scripts/v3/analysis/todo_analyzer.py" ]; then
+    if python3 scripts/v3/analysis/todo_analyzer.py --staged-only --ci-mode --min-confidence 0.8 >/dev/null 2>&1; then
+      echo "✅ No critical hidden TODOs found in staged files"
+    else
+      echo "❌ Critical hidden TODOs detected in staged files - commit blocked"
+      echo "💡 Fix stub implementations and placeholder code before committing"
+      echo "📖 See docs/PLACEHOLDER-DETECTION-GUIDE.md for classification"
+      echo ""
+      echo "🔍 Running detailed analysis on staged files..."
+      python3 scripts/v3/analysis/todo_analyzer.py --staged-only --min-confidence 0.8
+      exit 1
+    fi
+  elif command -v python3 >/dev/null 2>&1; then
+    echo "⚠️  Python3 found but TODO analyzer not available - skipping"
   fi
-else
-  echo "⚠️  Python3 not found - skipping hidden TODO analysis"
-  echo "💡 Install Python3 to enable automatic TODO checking"
 fi
 
 echo "✅ All quality checks passed - proceeding with commit"
@@ -280,6 +330,18 @@ if [ -f "package.json" ]; then
       # Don't fail on warnings, just warn
     fi
   fi
+elif [ -f "requirements.txt" ] || [ -f "pyproject.toml" ]; then
+  # Python project security checks
+  if command -v pip-audit >/dev/null 2>&1; then
+    echo "🔍 Checking Python vulnerabilities..."
+    pip-audit --desc 2>/dev/null || echo "⚠️  Install pip-audit for vulnerability checks: pip install pip-audit"
+  fi
+elif [ -f "Cargo.toml" ]; then
+  # Rust project security checks
+  if command -v cargo-audit >/dev/null 2>&1; then
+    echo "🔍 Checking Rust vulnerabilities..."
+    cargo audit 2>/dev/null || echo "⚠️  Install cargo-audit for vulnerability checks: cargo install cargo-audit"
+  fi
 fi
 
 echo "🎉 Pre-push checks completed!"

package/dist/scaffold/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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/scaffold/index.js

@@ -330,6 +330,31 @@ async function scaffoldProject(options) {
       required: false,
     });
 
+    // Install quality gates package if requested
+    if (options.withQualityGates) {
+      console.log(chalk.blue('\n📦 Installing quality gates package...'));
+      try {
+        const { execSync } = require('child_process');
+        const npmCommand = fs.existsSync(path.join(currentDir, 'package.json'))
+          ? 'npm install --save-dev @paths.design/quality-gates'
+          : 'npm install -g @paths.design/quality-gates';
+
+        console.log(chalk.gray(`   Running: ${npmCommand}`));
+        execSync(npmCommand, {
+          cwd: currentDir,
+          stdio: 'inherit',
+        });
+        console.log(chalk.green('✅ Quality gates package installed'));
+        console.log(chalk.blue('💡 You can now use: caws quality-gates'));
+      } catch (error) {
+        console.log(chalk.yellow(`⚠️  Failed to install quality gates package: ${error.message}`));
+        console.log(
+          chalk.gray('   You can install manually: npm install -g @paths.design/quality-gates')
+        );
+        console.log(chalk.gray('   Or use Python scripts: python3 scripts/simple_gates.py'));
+      }
+    }
+
     // Add commit conventions for setups that don't have them
     if (!setup.hasTemplates || !fs.existsSync(path.join(currentDir, 'COMMIT_CONVENTIONS.md'))) {
       enhancements.push({

package/dist/spec/SpecFileManager.d.ts

@@ -0,0 +1,146 @@
+/**
+ * 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

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