@paths.design/caws-cli 7.0.0 → 7.0.2

package/dist/commands/specs.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Specs command handler
+ * @param {string} action - Action to perform (list, create, show, update, delete, conflicts, migrate)
+ * @param {Object} options - Command options
+ */
+export function specsCommand(action: string, options?: any): Promise<any>;
+/**
+ * Load specs registry
+ * @returns {Promise<Object>} Registry data
+ */
+export function loadSpecsRegistry(): Promise<any>;
+/**
+ * Save specs registry
+ * @param {Object} registry - Registry data
+ * @returns {Promise<void>}
+ */
+export function saveSpecsRegistry(registry: any): Promise<void>;
+/**
+ * List all spec files in the specs directory
+ * @returns {Promise<Array>} Array of spec file info
+ */
+export function listSpecFiles(): Promise<any[]>;
+/**
+ * Create a new spec file
+ * @param {string} id - Spec identifier
+ * @param {Object} options - Creation options
+ * @returns {Promise<Object>} Created spec info
+ */
+export function createSpec(id: string, options?: any): Promise<any>;
+/**
+ * Load a specific spec file
+ * @param {string} id - Spec identifier
+ * @returns {Promise<Object|null>} Spec data or null
+ */
+export function loadSpec(id: string): Promise<any | null>;
+/**
+ * Update a spec file
+ * @param {string} id - Spec identifier
+ * @param {Object} updates - Updates to apply
+ * @returns {Promise<boolean>} Success status
+ */
+export function updateSpec(id: string, updates?: any): Promise<boolean>;
+/**
+ * Delete a spec file
+ * @param {string} id - Spec identifier
+ * @returns {Promise<boolean>} Success status
+ */
+export function deleteSpec(id: string): Promise<boolean>;
+/**
+ * Display specs in a formatted table
+ * @param {Array} specs - Array of spec objects
+ */
+export function displaySpecsTable(specs: any[]): void;
+/**
+ * Display detailed spec information
+ * @param {Object} spec - Spec object
+ */
+export function displaySpecDetails(spec: any): void;
+/**
+ * Ask user how to resolve spec creation conflicts
+ * @returns {Promise<string>} User's choice: 'cancel', 'rename', 'merge', 'override'
+ */
+export function askConflictResolution(): Promise<string>;
+/**
+ * Specs directory structure
+ */
+export const SPECS_DIR: ".caws/specs";
+export const SPECS_REGISTRY: ".caws/specs/registry.json";
+import { SPEC_TYPES } from "../constants/spec-types";
+export { SPEC_TYPES };
+//# sourceMappingURL=specs.d.ts.map

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

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

package/dist/commands/status.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Status command handler
+ * @param {Object} options - Command options
+ */
+export function statusCommand(options?: any): Promise<any>;
+/**
+ * Load working specification (legacy single file approach)
+ * @param {string} specPath - Path to working spec
+ * @returns {Promise<Object|null>} Parsed spec or null
+ */
+export function loadWorkingSpec(specPath?: string): Promise<any | null>;
+/**
+ * Check Git hooks status
+ * @returns {Promise<Object>} Hooks status
+ */
+export function checkGitHooks(): Promise<any>;
+/**
+ * Load provenance chain
+ * @returns {Promise<Object>} Provenance status
+ */
+export function loadProvenanceChain(): Promise<any>;
+/**
+ * Load waiver status
+ * @returns {Promise<Object>} Waiver status
+ */
+export function loadWaiverStatus(): Promise<any>;
+/**
+ * Check quality gates status (simplified)
+ * @returns {Promise<Object>} Quality gates status
+ */
+export function checkQualityGates(): Promise<any>;
+/**
+ * Display project status
+ * @param {Object} data - Status data
+ */
+export function displayStatus(data: any): void;
+/**
+ * Generate actionable suggestions based on status and mode
+ * @param {Object} data - Status data
+ * @param {string} currentMode - Current CAWS mode
+ * @returns {string[]} Array of suggestions
+ */
+export function generateSuggestions(data: any, currentMode: string): string[];
+//# sourceMappingURL=status.d.ts.map

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

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

package/dist/commands/templates.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Templates command handler
+ * @param {string} subcommand - Subcommand (list, info)
+ * @param {Object} options - Command options
+ */
+export function templatesCommand(subcommand?: string, options?: any): Promise<void>;
+/**
+ * List all available templates
+ */
+export function listTemplates(): void;
+/**
+ * Show detailed template information
+ * @param {string} templateId - Template ID
+ */
+export function showTemplateInfo(templateId: string): void;
+/**
+ * Check which templates actually exist
+ * @returns {Object} Available templates
+ */
+export function getAvailableTemplates(): any;
+/**
+ * Built-in template definitions
+ */
+export const BUILTIN_TEMPLATES: {
+    'typescript-library': {
+        name: string;
+        description: string;
+        category: string;
+        tier: number;
+        features: string[];
+        path: string;
+    };
+    'typescript-api': {
+        name: string;
+        description: string;
+        category: string;
+        tier: number;
+        features: string[];
+        path: string;
+    };
+    'typescript-monorepo': {
+        name: string;
+        description: string;
+        category: string;
+        tier: number;
+        features: string[];
+        path: string;
+    };
+    'javascript-package': {
+        name: string;
+        description: string;
+        category: string;
+        tier: number;
+        features: string[];
+        path: string;
+    };
+    'react-component-lib': {
+        name: string;
+        description: string;
+        category: string;
+        tier: number;
+        features: string[];
+        path: string;
+    };
+    'vscode-extension': {
+        name: string;
+        description: string;
+        category: string;
+        tier: number;
+        features: string[];
+        path: string;
+    };
+};
+//# sourceMappingURL=templates.d.ts.map

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

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

package/dist/commands/templates.js

@@ -7,6 +7,7 @@
 const fs = require('fs-extra');
 const path = require('path');
 const chalk = require('chalk');
+const { findPackageRoot } = require('../utils/detection');
 
 /**
  * Built-in template definitions
@@ -64,11 +65,20 @@ const BUILTIN_TEMPLATES = {
 
 /**
  * Get template directory path
+ * Works in both development and global install scenarios
  * @returns {string|null} Template directory path or null
  */
 function getTemplateDir() {
+  // Find package root using shared utility
+  const packageRoot = findPackageRoot(__dirname);
+  
   const possiblePaths = [
+    // First: Try templates relative to package root (works in dev and global install)
+    path.join(packageRoot, 'templates'),
+    // Fallback: Try relative to current file location (for development)
     path.join(__dirname, '../../templates'),
+    path.join(__dirname, '../templates'),
+    // Legacy fallbacks
     path.join(process.cwd(), 'packages/caws-cli/templates'),
     path.join(process.cwd(), 'templates'),
   ];

package/dist/commands/tool.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Initialize tool system
+ * @returns {Promise<ToolLoader|null>} Initialized tool loader or null if failed
+ */
+export function initializeToolSystem(): Promise<ToolLoader | null>;
+/**
+ * Execute tool command handler
+ * @param {string} toolId - ID of the tool to execute
+ * @param {Object} options - Command options
+ */
+export function executeTool(toolId: string, options: any): Promise<void>;
+import ToolLoader = require("../tool-loader");
+//# sourceMappingURL=tool.d.ts.map

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

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

package/dist/commands/troubleshoot.d.ts

@@ -0,0 +1,8 @@
+export = troubleshootCommand;
+/**
+ * Troubleshoot command handler
+ * @param {string} guide - Guide key argument
+ * @param {Object} options - Command options
+ */
+declare function troubleshootCommand(guide: string, options: any): void;
+//# sourceMappingURL=troubleshoot.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"troubleshoot.d.ts","sourceRoot":"","sources":["../../src/commands/troubleshoot.js"],"names":[],"mappings":";AAqFA;;;;GAIG;AACH,4CAHW,MAAM,sBAchB"}

package/dist/commands/tutorial.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Tutorial command handler
+ * @param {string} tutorialType - Type of tutorial to run
+ * @param {Object} options - Command options
+ */
+export function tutorialCommand(tutorialType: string, _options?: {}): Promise<any>;
+export namespace TUTORIALS {
+    namespace agent {
+        let name: string;
+        let description: string;
+        let icon: string;
+        let steps: ({
+            id: string;
+            title: string;
+            content: string;
+            action: string;
+            verify?: undefined;
+        } | {
+            id: string;
+            title: string;
+            content: string;
+            action: string;
+            verify: string;
+        })[];
+    }
+    namespace developer {
+        let name_1: string;
+        export { name_1 as name };
+        let description_1: string;
+        export { description_1 as description };
+        let icon_1: string;
+        export { icon_1 as icon };
+        let steps_1: ({
+            id: string;
+            title: string;
+            content: string;
+            action: string;
+            verify?: undefined;
+        } | {
+            id: string;
+            title: string;
+            content: string;
+            action: string;
+            verify: string;
+        })[];
+        export { steps_1 as steps };
+    }
+}
+/**
+ * Interactive tutorial session
+ * @param {string} tutorialType - Type of tutorial (agent, developer)
+ * @returns {Promise<void>}
+ */
+export function runInteractiveTutorial(tutorialType: string): Promise<void>;
+//# sourceMappingURL=tutorial.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tutorial.d.ts","sourceRoot":"","sources":["../../src/commands/tutorial.js"],"names":[],"mappings":"AA4aA;;;;GAIG;AACH,8CAHW,MAAM,+BA4ChB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA/FD;;;;GAIG;AACH,qDAHW,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CA4CzB"}

package/dist/commands/validate.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Validate command handler
+ * Enhanced with multi-spec support and JSON output format
+ * @param {string} specFile - Path to spec file (optional, uses spec resolution)
+ * @param {Object} options - Command options
+ * @param {string} [options.specId] - Feature-specific spec ID
+ * @param {boolean} [options.interactive] - Use interactive spec selection
+ * @param {boolean} [options.format] - Output format (json)
+ */
+export function validateCommand(specFile: string, options?: {
+    specId?: string;
+    interactive?: boolean;
+    format?: boolean;
+}): Promise<void>;
+//# sourceMappingURL=validate.d.ts.map

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

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

package/dist/commands/validate.js

@@ -194,6 +194,18 @@ async function validateCommand(specFile, options = {}) {
           if (error.suggestion) {
             console.log(`      ${chalk.blue('💡 ' + error.suggestion)}`);
           }
+          if (error.example) {
+            console.log(`      ${chalk.gray('Example:')}`);
+            if (error.example.contracts) {
+              error.example.contracts.forEach((contract) => {
+                console.log(`        ${chalk.gray('- type: ' + contract.type)}`);
+                console.log(`          ${chalk.gray('path: ' + contract.path)}`);
+                if (contract.description) {
+                  console.log(`          ${chalk.gray('description: ' + contract.description)}`);
+                }
+              });
+            }
+          }
         });
 
         // Show warnings

package/dist/commands/waivers.d.ts

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

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

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

package/dist/commands/workflow.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Workflow command handler
+ *
+ * @param {string} workflowType - Type of workflow
+ * @param {object} options - Command options
+ */
+export function workflowCommand(workflowType: string, options?: object): Promise<void>;
+/**
+ * Generate workflow guidance
+ *
+ * @param {string} workflowType - Type of workflow (tdd, refactor, feature)
+ * @param {number} currentStep - Current step number (1-based)
+ * @param {object} context - Optional context information
+ * @returns {object} Workflow guidance
+ */
+export function generateWorkflowGuidance(workflowType: string, currentStep: number, context?: object): object;
+export namespace WORKFLOW_TEMPLATES {
+    namespace tdd {
+        let name: string;
+        let steps: string[];
+        let guidance: {
+            1: string;
+            2: string;
+            3: string;
+            4: string;
+            5: string;
+            6: string;
+        };
+        let recommendations: {
+            1: string[];
+            2: string[];
+            3: string[];
+            4: string[];
+            5: string[];
+            6: string[];
+        };
+    }
+    namespace refactor {
+        let name_1: string;
+        export { name_1 as name };
+        let steps_1: string[];
+        export { steps_1 as steps };
+        let guidance_1: {
+            1: string;
+            2: string;
+            3: string;
+            4: string;
+            5: string;
+        };
+        export { guidance_1 as guidance };
+        let recommendations_1: {
+            1: string[];
+            2: string[];
+            3: string[];
+            4: string[];
+            5: string[];
+        };
+        export { recommendations_1 as recommendations };
+    }
+    namespace feature {
+        let name_2: string;
+        export { name_2 as name };
+        let steps_2: string[];
+        export { steps_2 as steps };
+        let guidance_2: {
+            1: string;
+            2: string;
+            3: string;
+            4: string;
+            5: string;
+            6: string;
+        };
+        export { guidance_2 as guidance };
+        let recommendations_2: {
+            1: string[];
+            2: string[];
+            3: string[];
+            4: string[];
+            5: string[];
+            6: string[];
+        };
+        export { recommendations_2 as recommendations };
+    }
+}
+//# sourceMappingURL=workflow.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../../src/commands/workflow.js"],"names":[],"mappings":"AA2IA;;;;;GAKG;AACH,8CAHW,MAAM,YACN,MAAM,iBA6FhB;AA7ID;;;;;;;GAOG;AACH,uDALW,MAAM,eACN,MAAM,YACN,MAAM,GACJ,MAAM,CAoClB"}

package/dist/config/index.d.ts

@@ -0,0 +1,29 @@
+import CLI_VERSION_1 = require("../../package.json");
+import CLI_VERSION = CLI_VERSION_1.version;
+/**
+ * Initialize global setup detection
+ * @returns {Object} Setup configuration
+ */
+export function initializeGlobalSetup(): any;
+/**
+ * Load provenance tools dynamically
+ * @returns {Object|null} Provenance tools or null if not available
+ */
+export function loadProvenanceTools(): any | null;
+/**
+ * Initialize language support tools
+ * @returns {Object|null} Language support tools or null if not available
+ */
+export function initializeLanguageSupport(): any | null;
+/**
+ * Get global CAWS setup
+ * @returns {Object} CAWS setup configuration
+ */
+export function getGlobalCAWSSetup(): any;
+/**
+ * Set global CAWS setup (for testing or override)
+ * @param {Object} setup - Setup configuration
+ */
+export function setGlobalCAWSSetup(setup: any): void;
+export { CLI_VERSION };
+//# sourceMappingURL=index.d.ts.map

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

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