@exaudeus/workrail 0.0.3 → 0.0.5

package/README.md

@@ -18,15 +18,46 @@ The codebase now implements the full MVP described in the original specification
 
 ---
 
+## 🚀 Quick Start
+
+```bash
+# Install globally
+npm install -g @exaudeus/workrail
+
+# Initialize your personal workflow directory
+workrail init
+
+# List all available workflows (bundled + your custom ones)
+workrail list
+
+# Check workflow sources and status
+workrail sources
+
+# Validate a workflow file
+workrail validate my-workflow.json
+
+# Start the MCP server
+workrail start
+```
+
+**Multiple Workflow Sources**: WorkRail automatically loads workflows from:
+- **Bundled workflows** (included with the package)
+- **User workflows** (`~/.workrail/workflows/`)
+- **Project workflows** (`./workflows/`)
+- **Custom directories** (via `WORKFLOW_STORAGE_PATH` environment variable)
+
+---
+
 ## ✨ Key Features
 
 * **Clean Architecture** – clear separation of **Domain → Application → Infrastructure** layers.
 * **MCP Protocol Support** – Full MCP SDK integration with proper tool definitions and stdio transport.
-* **Workflow Orchestration Tools** – 4 core tools for workflow management:
+* **Workflow Orchestration Tools** – 5 core tools for workflow management:
   - `workflow_list` - List all available workflows
   - `workflow_get` - Get detailed workflow information  
   - `workflow_next` - Get the next step in a workflow
   - `workflow_validate` - Advanced validation of step outputs with schema, context-aware, and composition rules
+  - `workflow_validate_json` - Direct JSON workflow validation with comprehensive error reporting and actionable suggestions
 * **Dependency Injection** – pluggable components are wired by `src/container.ts` (Inversify-style, no runtime reflection).
 * **Async, Secure Storage** – interchangeable back-ends: in-memory (default for tests) and file-based storage with path-traversal safeguards.
 * **Advanced ValidationEngine** – Three-tier validation system with JSON Schema validation (AJV), Context-Aware Validation (conditional rules), and Logical Composition (and/or/not operators) for comprehensive step output quality assurance.

package/dist/application/use-cases/validate-workflow-json.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Enhanced validation result interface that matches other use cases
+ */
+export interface WorkflowJsonValidationResult {
+    valid: boolean;
+    issues: string[];
+    suggestions: string[];
+}
+/**
+ * Factory function that creates a pure use-case for validating workflow JSON.
+ * Dependencies are injected at creation time, returning a pure function.
+ */
+export declare function createValidateWorkflowJson(): (workflowJson: string) => Promise<WorkflowJsonValidationResult>;
+/**
+ * @deprecated Use createValidateWorkflowJson factory function instead
+ * Legacy export for backward compatibility
+ */
+export declare function validateWorkflowJson(workflowJson: string): Promise<WorkflowJsonValidationResult>;
+//# sourceMappingURL=validate-workflow-json.d.ts.map

package/dist/application/use-cases/validate-workflow-json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-workflow-json.d.ts","sourceRoot":"","sources":["../../../src/application/use-cases/validate-workflow-json.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,KAEtC,cAAc,MAAM,KACnB,OAAO,CAAC,4BAA4B,CAAC,CA6DzC;AAgGD;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,4BAA4B,CAAC,CAEvC"}

package/dist/application/use-cases/validate-workflow-json.js

@@ -0,0 +1,148 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createValidateWorkflowJson = createValidateWorkflowJson;
+exports.validateWorkflowJson = validateWorkflowJson;
+const validation_1 = require("../validation");
+/**
+ * Factory function that creates a pure use-case for validating workflow JSON.
+ * Dependencies are injected at creation time, returning a pure function.
+ */
+function createValidateWorkflowJson() {
+    return async (workflowJson) => {
+        // Handle null, undefined, or non-string input
+        if (workflowJson === null || workflowJson === undefined || typeof workflowJson !== 'string') {
+            return {
+                valid: false,
+                issues: ['Workflow JSON content is required and must be a string.'],
+                suggestions: ['Provide valid JSON content for the workflow.']
+            };
+        }
+        // Handle empty string after trimming
+        const trimmedJson = workflowJson.trim();
+        if (trimmedJson.length === 0) {
+            return {
+                valid: false,
+                issues: ['Workflow JSON content is empty.'],
+                suggestions: ['Provide valid JSON content for the workflow.']
+            };
+        }
+        // Parse JSON with detailed error handling
+        let parsedWorkflow;
+        try {
+            parsedWorkflow = JSON.parse(trimmedJson);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : 'Unknown JSON parsing error';
+            return {
+                valid: false,
+                issues: [`Invalid JSON syntax: ${errorMessage}`],
+                suggestions: [
+                    'Check for missing quotes, commas, or brackets in the JSON.',
+                    'Ensure all strings are properly quoted.',
+                    'Verify that brackets and braces are properly matched.',
+                    'Use a JSON formatter or validator to identify syntax errors.'
+                ]
+            };
+        }
+        // Validate the parsed workflow using existing validation
+        const validationResult = (0, validation_1.validateWorkflow)(parsedWorkflow);
+        // Transform validation result to match use case interface
+        const issues = [];
+        const suggestions = [];
+        if (!validationResult.valid) {
+            // Process validation errors and provide enhanced error messages
+            validationResult.errors.forEach(error => {
+                issues.push(enhanceErrorMessage(error));
+            });
+            // Add general suggestions based on common validation errors
+            suggestions.push(...generateSuggestions(validationResult.errors));
+        }
+        return {
+            valid: validationResult.valid,
+            issues,
+            suggestions
+        };
+    };
+}
+/**
+ * Enhance error messages to be more user-friendly for LLM consumption
+ */
+function enhanceErrorMessage(error) {
+    // Handle common AJV error patterns and make them more descriptive
+    if (error.includes('must have required property')) {
+        const match = error.match(/must have required property '(.+)'/);
+        if (match) {
+            const property = match[1];
+            return `Missing required field '${property}'. This field is mandatory for all workflows.`;
+        }
+    }
+    if (error.includes('must be string')) {
+        return `${error} - Expected a text value enclosed in quotes.`;
+    }
+    if (error.includes('must be array')) {
+        return `${error} - Expected a list of items enclosed in square brackets [].`;
+    }
+    if (error.includes('must be object')) {
+        return `${error} - Expected a JSON object enclosed in curly braces {}.`;
+    }
+    if (error.includes('must match pattern')) {
+        return `${error} - The value does not match the required format or pattern.`;
+    }
+    if (error.includes('must NOT have additional properties')) {
+        return `Unexpected property found. Remove this property or check for typos.`;
+    }
+    if (error.includes('additionalProperties')) {
+        return `${error} - Remove any unexpected properties or check for typos.`;
+    }
+    if (error.includes('must be >= 1')) {
+        return `${error} - Value must be at least 1.`;
+    }
+    if (error.includes('must be <= ')) {
+        return `${error} - Value exceeds the maximum allowed length.`;
+    }
+    // Return original error if no specific enhancement is available
+    return error;
+}
+/**
+ * Generate actionable suggestions based on validation errors
+ */
+function generateSuggestions(errors) {
+    const suggestions = [];
+    const errorText = errors.join(' ').toLowerCase();
+    // Add suggestions based on common error patterns
+    if (errorText.includes('id')) {
+        suggestions.push('Ensure the workflow ID follows the pattern: lowercase letters, numbers, and hyphens only.');
+    }
+    if (errorText.includes('name')) {
+        suggestions.push('Provide a clear, descriptive name for the workflow.');
+    }
+    if (errorText.includes('description')) {
+        suggestions.push('Add a meaningful description explaining what the workflow accomplishes.');
+    }
+    if (errorText.includes('version')) {
+        suggestions.push('Use semantic versioning format (e.g., "0.0.1", "1.0.0").');
+    }
+    if (errorText.includes('steps')) {
+        suggestions.push('Ensure the workflow has at least one step with id, title, and prompt fields.');
+    }
+    if (errorText.includes('step')) {
+        suggestions.push('Check that all steps have required fields: id, title, and prompt.');
+    }
+    if (errorText.includes('pattern')) {
+        suggestions.push('Review the workflow schema documentation for correct field formats.');
+    }
+    // Add general suggestions if no specific ones were added
+    if (suggestions.length === 0) {
+        suggestions.push('Review the workflow schema documentation for correct structure and formatting.');
+        suggestions.push('Check that all required fields are present and properly formatted.');
+    }
+    return suggestions;
+}
+/**
+ * @deprecated Use createValidateWorkflowJson factory function instead
+ * Legacy export for backward compatibility
+ */
+async function validateWorkflowJson(workflowJson) {
+    return createValidateWorkflowJson()(workflowJson);
+}
+//# sourceMappingURL=validate-workflow-json.js.map

package/dist/application/use-cases/validate-workflow-json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-workflow-json.js","sourceRoot":"","sources":["../../../src/application/use-cases/validate-workflow-json.ts"],"names":[],"mappings":"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"}

package/dist/cli.js

@@ -6,44 +6,142 @@ const commander_1 = require("commander");
 const fs_1 = tslib_1.__importDefault(require("fs"));
 const path_1 = tslib_1.__importDefault(require("path"));
 const chalk_1 = tslib_1.__importDefault(require("chalk"));
+const os_1 = tslib_1.__importDefault(require("os"));
 const server_1 = require("./infrastructure/rpc/server");
 const workflow_service_1 = require("./application/services/workflow-service");
-const storage_1 = require("./infrastructure/storage");
+// import { createDefaultWorkflowStorage } from './infrastructure/storage';
 const validation_1 = require("./application/validation");
+const multi_directory_workflow_storage_1 = require("./infrastructure/storage/multi-directory-workflow-storage");
 const program = new commander_1.Command();
 program
-    .name('workflow-lookup')
+    .name('workrail')
     .description('MCP server for workflow orchestration and guidance')
-    .version('0.0.1');
+    .version('0.0.3');
 program
-    .command('start')
-    .description('Start the workflow lookup server')
+    .command('init')
+    .description('Initialize user workflow directory with sample workflows')
     .action(async () => {
     try {
-        const workflowService = new workflow_service_1.DefaultWorkflowService((0, storage_1.createDefaultWorkflowStorage)());
-        const server = (0, server_1.createWorkflowLookupServer)(workflowService);
-        await server.start();
-        console.log('Workflow Lookup MCP Server started successfully');
-        // Graceful shutdown on SIGINT/SIGTERM
-        const shutdown = async (signal) => {
-            console.log(`Received ${signal}, shutting down...`);
-            await server.stop();
-            process.exit(0);
-        };
-        process.on('SIGINT', () => shutdown('SIGINT'));
-        process.on('SIGTERM', () => shutdown('SIGTERM'));
+        console.log(chalk_1.default.blue('🚀 Initializing user workflow directory...'));
+        const userDir = await (0, multi_directory_workflow_storage_1.initializeUserWorkflowDirectory)();
+        console.log(chalk_1.default.green('✅ User workflow directory initialized:'));
+        console.log(chalk_1.default.cyan(`   ${userDir}`));
+        console.log();
+        console.log(chalk_1.default.yellow('📝 Getting started:'));
+        console.log(chalk_1.default.white('1. Edit the sample workflow in the directory above'));
+        console.log(chalk_1.default.white('2. Create new workflow JSON files following the schema'));
+        console.log(chalk_1.default.white('3. Run "workrail list" to see your workflows'));
+        console.log(chalk_1.default.white('4. Use your workflows with any MCP-enabled AI assistant'));
+        console.log();
+        console.log(chalk_1.default.gray('💡 Tip: Use "workrail validate <file>" to check your workflow syntax'));
     }
     catch (error) {
-        console.error('Failed to start server:', error);
+        console.error(chalk_1.default.red('❌ Failed to initialize user workflow directory:'));
+        console.error(chalk_1.default.red(error.message));
         process.exit(1);
     }
 });
 program
-    .command('validate')
-    .description('Validate a workflow file against the schema')
-    .argument('<file>', 'path to workflow JSON file')
-    .action(async (file) => {
-    await validateWorkflowFile(file);
+    .command('list')
+    .description('List all available workflows from all sources')
+    .option('-v, --verbose', 'Show detailed information including sources')
+    .action(async (options) => {
+    try {
+        console.log(chalk_1.default.blue('📋 Available workflows:'));
+        console.log();
+        const workflowService = new workflow_service_1.DefaultWorkflowService();
+        const workflows = await workflowService.listWorkflowSummaries();
+        if (workflows.length === 0) {
+            console.log(chalk_1.default.yellow('   No workflows found.'));
+            console.log(chalk_1.default.gray('   Run "workrail init" to create your first workflow.'));
+            return;
+        }
+        workflows.forEach((workflow, index) => {
+            console.log(chalk_1.default.green(`${index + 1}. ${workflow.name}`));
+            console.log(chalk_1.default.white(`   ID: ${workflow.id}`));
+            console.log(chalk_1.default.gray(`   ${workflow.description}`));
+            if (options.verbose) {
+                console.log(chalk_1.default.cyan(`   Version: ${workflow.version}`));
+            }
+            console.log();
+        });
+        console.log(chalk_1.default.gray(`Total: ${workflows.length} workflows`));
+    }
+    catch (error) {
+        console.error(chalk_1.default.red('❌ Failed to list workflows:'));
+        console.error(chalk_1.default.red(error.message));
+        process.exit(1);
+    }
+});
+program
+    .command('sources')
+    .description('Show workflow directory sources and their status')
+    .action(async () => {
+    try {
+        console.log(chalk_1.default.blue('📂 Workflow directory sources:'));
+        console.log();
+        const sources = [
+            {
+                name: 'Bundled Workflows',
+                path: path_1.default.resolve(__dirname, '../workflows'),
+                type: 'bundled',
+                description: 'Pre-built workflows included with WorkRail'
+            },
+            {
+                name: 'User Workflows',
+                path: path_1.default.join(os_1.default.homedir(), '.workrail', 'workflows'),
+                type: 'user',
+                description: 'Your personal workflow collection'
+            },
+            {
+                name: 'Project Workflows',
+                path: path_1.default.resolve(process.cwd(), 'workflows'),
+                type: 'project',
+                description: 'Project-specific workflows'
+            }
+        ];
+        // Add custom paths from environment
+        const envPaths = process.env['WORKFLOW_STORAGE_PATH'];
+        if (envPaths) {
+            const customPaths = envPaths.split(path_1.default.delimiter);
+            customPaths.forEach((customPath, index) => {
+                sources.push({
+                    name: `Custom Path ${index + 1}`,
+                    path: path_1.default.resolve(customPath.trim()),
+                    type: 'custom',
+                    description: 'Custom workflow directory'
+                });
+            });
+        }
+        sources.forEach((source, index) => {
+            const exists = fs_1.default.existsSync(source.path);
+            const icon = exists ? '✅' : '❌';
+            const status = exists ? 'Found' : 'Not found';
+            console.log(chalk_1.default.white(`${index + 1}. ${source.name} ${icon}`));
+            console.log(chalk_1.default.gray(`   Path: ${source.path}`));
+            console.log(chalk_1.default.gray(`   Status: ${status}`));
+            console.log(chalk_1.default.gray(`   ${source.description}`));
+            if (exists) {
+                try {
+                    const files = fs_1.default.readdirSync(source.path).filter(f => f.endsWith('.json'));
+                    console.log(chalk_1.default.cyan(`   Workflows: ${files.length} files`));
+                }
+                catch (error) {
+                    console.log(chalk_1.default.red(`   Error reading directory`));
+                }
+            }
+            console.log();
+        });
+        console.log(chalk_1.default.yellow('💡 Tips:'));
+        console.log(chalk_1.default.white('• Run "workrail init" to create the user workflow directory'));
+        console.log(chalk_1.default.white('• Set WORKFLOW_STORAGE_PATH to add custom directories'));
+        console.log(chalk_1.default.white('• Use colon-separated paths for multiple custom directories'));
+    }
+    catch (error) {
+        console.error(chalk_1.default.red('❌ Failed to check workflow sources:'));
+        console.error(chalk_1.default.red(error.message));
+        process.exit(1);
+    }
 });
 async function validateWorkflowFile(filePath) {
     try {
@@ -102,5 +200,24 @@ async function validateWorkflowFile(filePath) {
         process.exit(1);
     }
 }
+program
+    .command('validate <file>')
+    .description('Validate a workflow file against the schema')
+    .action(validateWorkflowFile);
+program
+    .command('start')
+    .description('Start the MCP server')
+    .action(async () => {
+    try {
+        console.log(chalk_1.default.blue('🚀 Starting WorkRail MCP server...'));
+        const workflowService = new workflow_service_1.DefaultWorkflowService();
+        const server = (0, server_1.createWorkflowLookupServer)(workflowService);
+        await server.start();
+    }
+    catch (error) {
+        console.error(chalk_1.default.red('❌ Failed to start server:'), error.message);
+        process.exit(1);
+    }
+});
 program.parse();
 //# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";;;;AAEA,yCAAoC;AACpC,oDAAoB;AACpB,wDAAwB;AACxB,0DAA0B;AAC1B,oDAAoB;AACpB,wDAAyE;AACzE,8EAAiF;AACjF,2EAA2E;AAC3E,yDAA4D;AAC5D,gHAA4G;AAE5G,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,UAAU,CAAC;KAChB,WAAW,CAAC,oDAAoD,CAAC;KACjE,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,OAAO;KACJ,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,0DAA0D,CAAC;KACvE,MAAM,CAAC,KAAK,IAAI,EAAE;IACjB,IAAI,CAAC;QACH,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC,CAAC;QAEtE,MAAM,OAAO,GAAG,MAAM,IAAA,kEAA+B,GAAE,CAAC;QAExD,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,KAAK,CAAC,wCAAwC,CAAC,CAAC,CAAC;QACnE,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,MAAM,OAAO,EAAE,CAAC,CAAC,CAAC;QACzC,OAAO,CAAC,GAAG,EAAE,CAAC;QACd,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC,CAAC;QACjD,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,KAAK,CAAC,oDAAoD,CAAC,CAAC,CAAC;QAC/E,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,KAAK,CAAC,wDAAwD,CAAC,CAAC,CAAC;QACnF,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,KAAK,CAAC,8CAA8C,CAAC,CAAC,CAAC;QACzE,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,KAAK,CAAC,yDAAyD,CAAC,CAAC,CAAC;QACpF,OAAO,CAAC,GAAG,EAAE,CAAC;QACd,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,sEAAsE,CAAC,CAAC,CAAC;IAClG,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,OAAO,CAAC,KAAK,CAAC,eAAK,CAAC,GAAG,CAAC,iDAAiD,CAAC,CAAC,CAAC;QAC5E,OAAO,CAAC,KAAK,CAAC,eAAK,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;QACxC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,+CAA+C,CAAC;KAC5D,MAAM,CAAC,eAAe,EAAE,6CAA6C,CAAC;KACtE,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;IACxB,IAAI,CAAC;QACH,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC,CAAC;QACnD,OAAO,CAAC,GAAG,EAAE,CAAC;QAEd,MAAM,eAAe,GAAG,IAAI,yCAAsB,EAAE,CAAC;QACrD,MAAM,SAAS,GAAG,MAAM,eAAe,CAAC,qBAAqB,EAAE,CAAC;QAEhE,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3B,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,MAAM,CAAC,wBAAwB,CAAC,CAAC,CAAC;YACpD,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,uDAAuD,CAAC,CAAC,CAAC;YACjF,OAAO;QACT,CAAC;QAED,SAAS,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE;YACpC,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,KAAK,CAAC,GAAG,KAAK,GAAG,CAAC,KAAK,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;YAC3D,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,KAAK,CAAC,UAAU,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;YAClD,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;YAEtD,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;gBACpB,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,eAAe,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;YAC7D,CAAC;YAED,OAAO,CAAC,GAAG,EAAE,CAAC;QAChB,CAAC,CAAC,CAAC;QAEH,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,UAAU,SAAS,CAAC,MAAM,YAAY,CAAC,CAAC,CAAC;IAClE,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,OAAO,CAAC,KAAK,CAAC,eAAK,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC,CAAC;QACxD,OAAO,CAAC,KAAK,CAAC,eAAK,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;QACxC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,SAAS,CAAC;KAClB,WAAW,CAAC,kDAAkD,CAAC;KAC/D,MAAM,CAAC,KAAK,IAAI,EAAE;IACjB,IAAI,CAAC;QACH,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC,CAAC;QAC1D,OAAO,CAAC,GAAG,EAAE,CAAC;QAEd,MAAM,OAAO,GAAG;YACd;gBACE,IAAI,EAAE,mBAAmB;gBACzB,IAAI,EAAE,cAAI,CAAC,OAAO,CAAC,SAAS,EAAE,cAAc,CAAC;gBAC7C,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,4CAA4C;aAC1D;YACD;gBACE,IAAI,EAAE,gBAAgB;gBACtB,IAAI,EAAE,cAAI,CAAC,IAAI,CAAC,YAAE,CAAC,OAAO,EAAE,EAAE,WAAW,EAAE,WAAW,CAAC;gBACvD,IAAI,EAAE,MAAM;gBACZ,WAAW,EAAE,mCAAmC;aACjD;YACD;gBACE,IAAI,EAAE,mBAAmB;gBACzB,IAAI,EAAE,cAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,WAAW,CAAC;gBAC9C,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,4BAA4B;aAC1C;SACF,CAAC;QAEF,oCAAoC;QACpC,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;QACtD,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,WAAW,GAAG,QAAQ,CAAC,KAAK,CAAC,cAAI,CAAC,SAAS,CAAC,CAAC;YACnD,WAAW,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,KAAK,EAAE,EAAE;gBACxC,OAAO,CAAC,IAAI,CAAC;oBACX,IAAI,EAAE,eAAe,KAAK,GAAG,CAAC,EAAE;oBAChC,IAAI,EAAE,cAAI,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;oBACrC,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,2BAA2B;iBACzC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACL,CAAC;QAED,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE;YAChC,MAAM,MAAM,GAAG,YAAE,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAC1C,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;YAChC,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC;YAE9C,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,KAAK,CAAC,GAAG,KAAK,GAAG,CAAC,KAAK,MAAM,CAAC,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC;YACjE,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,YAAY,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;YACnD,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,cAAc,MAAM,EAAE,CAAC,CAAC,CAAC;YAChD,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,MAAM,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;YAEpD,IAAI,MAAM,EAAE,CAAC;gBACX,IAAI,CAAC;oBACH,MAAM,KAAK,GAAG,YAAE,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;oBAC3E,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,iBAAiB,KAAK,CAAC,MAAM,QAAQ,CAAC,CAAC,CAAC;gBACjE,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC,CAAC;gBACvD,CAAC;YACH,CAAC;YAED,OAAO,CAAC,GAAG,EAAE,CAAC;QAChB,CAAC,CAAC,CAAC;QAEH,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC;QACtC,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,KAAK,CAAC,6DAA6D,CAAC,CAAC,CAAC;QACxF,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,KAAK,CAAC,uDAAuD,CAAC,CAAC,CAAC;QAClF,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,KAAK,CAAC,6DAA6D,CAAC,CAAC,CAAC;IAC1F,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,OAAO,CAAC,KAAK,CAAC,eAAK,CAAC,GAAG,CAAC,qCAAqC,CAAC,CAAC,CAAC;QAChE,OAAO,CAAC,KAAK,CAAC,eAAK,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;QACxC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,KAAK,UAAU,oBAAoB,CAAC,QAAgB;IAClD,IAAI,CAAC;QACH,iCAAiC;QACjC,MAAM,YAAY,GAAG,cAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAE5C,IAAI,CAAC,YAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YACjC,OAAO,CAAC,KAAK,CAAC,eAAK,CAAC,GAAG,CAAC,0BAA0B,CAAC,EAAE,QAAQ,CAAC,CAAC;YAC/D,OAAO,CAAC,KAAK,CAAC,eAAK,CAAC,MAAM,CAAC,6CAA6C,CAAC,CAAC,CAAC;YAC3E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,uBAAuB;QACvB,IAAI,OAAe,CAAC;QACpB,IAAI,CAAC;YACH,OAAO,GAAG,YAAE,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QACnD,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC5B,OAAO,CAAC,KAAK,CAAC,eAAK,CAAC,GAAG,CAAC,6BAA6B,CAAC,EAAE,QAAQ,CAAC,CAAC;gBAClE,OAAO,CAAC,KAAK,CAAC,eAAK,CAAC,MAAM,CAAC,gDAAgD,CAAC,CAAC,CAAC;YAChF,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,KAAK,CAAC,eAAK,CAAC,GAAG,CAAC,uBAAuB,CAAC,EAAE,QAAQ,CAAC,CAAC;gBAC5D,OAAO,CAAC,KAAK,CAAC,eAAK,CAAC,MAAM,CAAC,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;YACpD,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,gBAAgB;QAChB,IAAI,QAAa,CAAC;QAClB,IAAI,CAAC;YACH,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACjC,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,OAAO,CAAC,KAAK,CAAC,eAAK,CAAC,GAAG,CAAC,iCAAiC,CAAC,EAAE,QAAQ,CAAC,CAAC;YACtE,OAAO,CAAC,KAAK,CAAC,eAAK,CAAC,MAAM,CAAC,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;YAClD,OAAO,CAAC,KAAK,CAAC,eAAK,CAAC,MAAM,CAAC,+CAA+C,CAAC,CAAC,CAAC;YAC7E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,uBAAuB;QACvB,MAAM,MAAM,GAAG,IAAA,6BAAgB,EAAC,QAAQ,CAAC,CAAC;QAE1C,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YACjB,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,KAAK,CAAC,sBAAsB,CAAC,EAAE,QAAQ,CAAC,CAAC;YAC3D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,KAAK,CAAC,eAAK,CAAC,GAAG,CAAC,+BAA+B,CAAC,EAAE,QAAQ,CAAC,CAAC;YACpE,OAAO,CAAC,KAAK,CAAC,eAAK,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC,CAAC;YACpD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;gBAC5B,OAAO,CAAC,KAAK,CAAC,eAAK,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC;YACzC,CAAC,CAAC,CAAC;YACH,OAAO,CAAC,KAAK,CAAC,eAAK,CAAC,MAAM,CAAC,WAAW,MAAM,CAAC,MAAM,CAAC,MAAM,oBAAoB,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;YACzH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IAEH,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,OAAO,CAAC,KAAK,CAAC,eAAK,CAAC,GAAG,CAAC,qBAAqB,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QAC/D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,OAAO;KACJ,OAAO,CAAC,iBAAiB,CAAC;KAC1B,WAAW,CAAC,6CAA6C,CAAC;KAC1D,MAAM,CAAC,oBAAoB,CAAC,CAAC;AAEhC,OAAO;KACJ,OAAO,CAAC,OAAO,CAAC;KAChB,WAAW,CAAC,sBAAsB,CAAC;KACnC,MAAM,CAAC,KAAK,IAAI,EAAE;IACjB,IAAI,CAAC;QACH,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC,CAAC;QAE9D,MAAM,eAAe,GAAG,IAAI,yCAAsB,EAAE,CAAC;QACrD,MAAM,MAAM,GAAG,IAAA,mCAA0B,EAAC,eAAe,CAAC,CAAC;QAE3D,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,OAAO,CAAC,KAAK,CAAC,eAAK,CAAC,GAAG,CAAC,2BAA2B,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QACrE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/infrastructure/storage/multi-directory-workflow-storage.d.ts

@@ -0,0 +1,50 @@
+import { IWorkflowStorage } from '../../types/storage';
+import { Workflow, WorkflowSummary } from '../../types/mcp-types';
+/**
+ * Multi-directory workflow storage that loads workflows from multiple directories
+ * and merges them together. Supports:
+ * - Bundled workflows (always included)
+ * - User-specific workflows (~/.workrail/workflows)
+ * - Project-specific workflows (./workflows or custom path)
+ * - Multiple custom directories (colon-separated paths)
+ */
+export declare class MultiDirectoryWorkflowStorage implements IWorkflowStorage {
+    private storageInstances;
+    constructor(options?: MultiDirectoryOptions);
+    private resolveDirectories;
+    loadAllWorkflows(): Promise<Workflow[]>;
+    getWorkflowById(id: string): Promise<Workflow | null>;
+    listWorkflowSummaries(): Promise<WorkflowSummary[]>;
+    save?(_workflow: Workflow): Promise<void>;
+    /**
+     * Get information about loaded directories
+     */
+    getDirectoryInfo(): DirectoryInfo[];
+    private getDirectoryType;
+}
+export interface MultiDirectoryOptions {
+    excludeBundled?: boolean;
+    excludeUser?: boolean;
+    excludeProject?: boolean;
+    additionalDirectories?: string[];
+    fileStorageOptions?: {
+        maxFileSizeBytes?: number;
+        cacheTTLms?: number;
+        cacheSize?: number;
+        indexCacheTTLms?: number;
+    };
+}
+export interface DirectoryInfo {
+    path: string;
+    index: number;
+    type: 'bundled' | 'user' | 'project' | 'custom';
+}
+/**
+ * Create a multi-directory storage with sensible defaults
+ */
+export declare function createMultiDirectoryWorkflowStorage(options?: MultiDirectoryOptions): MultiDirectoryWorkflowStorage;
+/**
+ * Initialize user workflow directory if it doesn't exist
+ */
+export declare function initializeUserWorkflowDirectory(): Promise<string>;
+//# sourceMappingURL=multi-directory-workflow-storage.d.ts.map

package/dist/infrastructure/storage/multi-directory-workflow-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multi-directory-workflow-storage.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/storage/multi-directory-workflow-storage.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAGlE;;;;;;;GAOG;AACH,qBAAa,6BAA8B,YAAW,gBAAgB;IACpE,OAAO,CAAC,gBAAgB,CAA6B;gBAEzC,OAAO,GAAE,qBAA0B;IAS/C,OAAO,CAAC,kBAAkB;IAgDpB,gBAAgB,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IA8BvC,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAmBrD,qBAAqB,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAWnD,IAAI,CAAC,CAAC,SAAS,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB/C;;OAEG;IACI,gBAAgB,IAAI,aAAa,EAAE;IAQ1C,OAAO,CAAC,gBAAgB;CAYzB;AAED,MAAM,WAAW,qBAAqB;IACpC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;IACjC,kBAAkB,CAAC,EAAE;QACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,CAAC;CACH;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAC;CACjD;AAED;;GAEG;AACH,wBAAgB,mCAAmC,CAAC,OAAO,GAAE,qBAA0B,GAAG,6BAA6B,CAStH;AAED;;GAEG;AACH,wBAAsB,+BAA+B,IAAI,OAAO,CAAC,MAAM,CAAC,CAmCvE"}