@exaudeus/workrail 0.0.2-beta.0

package/README.md

@@ -0,0 +1,223 @@
+# Workflow Orchestration Server (MCP-Compatible)
+
+> **Reliable, test-driven workflow execution for AI coding assistants – powered by Clean Architecture**
+
+[![Build](https://img.shields.io/github/actions/workflow/status/yourusername/workflow-orchestration/ci.yml?branch=main)]()
+[![Version](https://img.shields.io/badge/version-0.0.1--alpha-orange)]()
+[![MCP Compatible](https://img.shields.io/badge/MCP-compatible-purple.svg)](https://modelcontextprotocol.org)
+
+---
+
+## 🚀 Overview
+
+Large language models are phenomenal at generating code, yet they often hallucinate, lose context, or perform unsafe operations.  
+This server provides **structured, step-by-step workflows** (defined as JSON documents) that guide an AI assistant through safe, repeatable tasks.  
+It follows [Model Context Protocol (MCP)](https://modelcontextprotocol.org) conventions and exposes a **JSON-RPC 2.0** interface on `stdin/stdout`.
+
+The codebase now implements the full MVP described in the original specification, refactored with Clean Architecture for long-term maintainability.
+
+---
+
+## ✨ 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_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
+* **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.
+* **Typed Error Mapping** – domain errors (`WorkflowNotFoundError`, `ValidationError`, …) automatically translate to proper JSON-RPC codes.
+* **CLI Validation** – `validate` command for testing workflow files locally with comprehensive error reporting.
+* **Comprehensive Test Coverage** – 81 tests passing, 7 failing (performance optimizations in progress), 88 total tests covering storage, validation, error mapping, CLI, and server logic.
+
+---
+
+## ⚡ Quick Start
+
+### Prerequisites
+* Node 18+
+* `npm install`
+
+### Development mode
+```bash
+npm run dev
+```
+The MCP server listens for JSON-RPC requests on **stdin/stdout**.
+
+### Production build
+```bash
+npm run build
+node dist/mcp-server.js
+```
+
+### Workflow validation (CLI utility)
+```bash
+npx ts-node src/cli.ts validate <workflow-file.json>
+```
+
+### Docker
+```bash
+docker-compose up
+```
+
+---
+
+## 🔧 Configuration
+
+### Usage with Claude Desktop
+
+Add this to your `claude_desktop_config.json`:
+
+#### npx (once published to npm)
+
+```json
+{
+  "mcpServers": {
+    "workflow-orchestration": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@exaudeus/workrail"
+      ]
+    }
+  }
+}
+```
+
+#### Local development
+
+```json
+{
+  "mcpServers": {
+    "workflow-orchestration": {
+      "command": "node",
+      "args": [
+        "/path/to/your/workflow-orchestration/dist/mcp-server.js"
+      ]
+    }
+  }
+}
+```
+
+### Usage with VS Code
+
+For manual installation, add this to your User Settings (JSON) or `.vscode/mcp.json`:
+
+#### npx (once published)
+
+```json
+{
+  "mcp": {
+    "servers": {
+      "workflow-orchestration": {
+        "command": "npx",
+        "args": [
+          "-y",
+          "@exaudeus/workrail"
+        ]
+      }
+    }
+  }
+}
+```
+
+#### Local development
+
+```json
+{
+  "mcp": {
+    "servers": {
+      "workflow-orchestration": {
+        "command": "node",
+        "args": [
+          "/path/to/your/workflow-orchestration/dist/mcp-server.js"
+        ]
+      }
+    }
+  }
+}
+```
+
+---
+
+## 🗂️ Project Structure (post-refactor)
+
+```
+workflow-orchestration/
+  ├─ src/
+  │   ├─ domain/               # Pure entities & errors (no dependencies)
+  │   ├─ application/          # Use-cases, services, ValidationEngine (depends on domain)
+  │   ├─ infrastructure/
+  │   │   ├─ rpc/              # JSON-RPC server adapter
+  │   │   └─ storage/          # File, in-memory, caching, schema-validating adapters
+  │   ├─ mcp-server.ts         # MCP server implementation (main entry point)
+  │   ├─ cli.ts                # CLI utility for workflow validation
+  │   ├─ container.ts          # DI registrations
+  │   └─ index.ts              # Library entrypoint (exports container)
+  ├─ tests/                    # Jest test suites (unit & integration)
+  └─ docs/                     # Guides, reference, advanced topics
+```
+
+### Layered flow
+```
+Client (AI Agent)
+   ▼  MCP Protocol (stdin/stdout)
+MCP Server       ── mcp-server.ts (MCP SDK adapter)
+   ▼  calls
+Application      ── use-cases (pure biz logic)
+   ▼  operates on
+Domain           ── entities & value objects
+```
+
+---
+
+## 🛠️ Environment Variables
+
+| Env Var | Default | Description |
+|---------|---------|-------------|
+| `WORKFLOW_DIR` | `spec/examples` | Path where workflow JSON files are loaded (file storage) |
+| `CACHE_TTL` | `300000` | Cache TTL in ms for `CachingWorkflowStorage` |
+| `PORT` | _n/a_ | Not used (stdin/stdout transport) |
+
+Change them before starting the server, e.g. `export WORKFLOW_DIR=/opt/workflows`.
+
+---
+
+## 🧪 Running Tests
+
+```bash
+npm test
+```
+Current status: 81 tests passing, 7 failing (performance optimizations in progress), 88 total tests.
+
+---
+
+## 📚 Documentation Status
+
+| Component | Status | Updated |
+|-----------|--------|---------|
+| Root README | ✅ Complete | 2024-07-10 |
+| Implementation guides | 🔄 In Progress | 2024-07-10 |
+| Migration guide 1.2 | 🔄 In Progress | 2024-07-10 |
+| Code snippet refresh | 🔄 In Progress | 2024-07-10 |
+
+---
+
+## 🤝 Contributing
+
+1. **Fork & PR** – small, focused pull requests please.
+2. **Follow the Architecture** – domain logic must remain framework-free; side effects live in infrastructure.
+3. **Add Tests** – no code is accepted without unit tests.
+4. **Run `npm run lint:fix`** before pushing.
+
+See `docs/advanced/contributing.md` for full details.
+
+---
+
+## 📄 License
+
+MIT – see [LICENSE](LICENSE).

package/dist/application/app.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Lightweight mediator that maps JSON-RPC method names to handler functions.
+ * It delegates parameter validation to an injected validator and remains
+ * agnostic of transport concerns.
+ */
+export type MethodHandler = (params: any) => Promise<any> | any;
+export interface MethodValidator {
+    validate(method: string, params: any): void;
+}
+export declare class ApplicationMediator {
+    private readonly handlers;
+    private readonly validateFn;
+    constructor(validator: MethodValidator);
+    register(method: string, handler: MethodHandler): void;
+    /** Execute a method after validation. */
+    execute(method: string, params: any): Promise<any>;
+    private responseValidate?;
+    setResponseValidator(fn: (method: string, result: any) => void): void;
+}
+import { WorkflowService } from './services/workflow-service';
+export declare const METHOD_NAMES: {
+    readonly WORKFLOW_LIST: "workflow_list";
+    readonly WORKFLOW_GET: "workflow_get";
+    readonly WORKFLOW_NEXT: "workflow_next";
+    readonly WORKFLOW_VALIDATE: "workflow_validate";
+    readonly INITIALIZE: "initialize";
+    readonly TOOLS_LIST: "tools/list";
+    readonly SHUTDOWN: "shutdown";
+};
+export type MethodName = typeof METHOD_NAMES[keyof typeof METHOD_NAMES];
+export declare function buildWorkflowApplication(workflowService: WorkflowService, validator?: MethodValidator): ApplicationMediator;
+//# sourceMappingURL=app.d.ts.map

package/dist/application/app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../src/application/app.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,MAAM,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;AAEhE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,IAAI,CAAC;CAC7C;AAED,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoC;IAC7D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAwC;gBAEvD,SAAS,EAAE,eAAe;IAItC,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI;IAOtD,yCAAyC;IACnC,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IAexD,OAAO,CAAC,gBAAgB,CAAC,CAAwC;IAEjE,oBAAoB,CAAC,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,KAAK,IAAI,GAAG,IAAI;CAGtE;AAMD,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAQ9D,eAAO,MAAM,YAAY;;;;;;;;CAQf,CAAC;AAEX,MAAM,MAAM,UAAU,GAAG,OAAO,YAAY,CAAC,MAAM,OAAO,YAAY,CAAC,CAAC;AAExE,wBAAgB,wBAAwB,CACtC,eAAe,EAAE,eAAe,EAChC,SAAS,GAAE,eAAkC,GAC5C,mBAAmB,CAmErB"}

package/dist/application/app.js

@@ -0,0 +1,133 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.METHOD_NAMES = exports.ApplicationMediator = void 0;
+exports.buildWorkflowApplication = buildWorkflowApplication;
+const error_handler_1 = require("../core/error-handler");
+const mcp_types_1 = require("../types/mcp-types");
+class ApplicationMediator {
+    handlers = new Map();
+    validateFn;
+    constructor(validator) {
+        this.validateFn = validator.validate.bind(validator);
+    }
+    register(method, handler) {
+        if (this.handlers.has(method)) {
+            throw new Error(`Method already registered: ${method}`);
+        }
+        this.handlers.set(method, handler);
+    }
+    /** Execute a method after validation. */
+    async execute(method, params) {
+        const handler = this.handlers.get(method);
+        if (!handler) {
+            throw new error_handler_1.MCPError(mcp_types_1.MCPErrorCodes.METHOD_NOT_FOUND, 'Method not found', { method });
+        }
+        // Perform validation once
+        this.validateFn(method, params);
+        const result = await handler(params);
+        // Validate output if a response validator is registered
+        if (this.responseValidate) {
+            this.responseValidate(method, result);
+        }
+        return result;
+    }
+    // Optional response validator injection
+    responseValidate;
+    setResponseValidator(fn) {
+        this.responseValidate = fn;
+    }
+}
+exports.ApplicationMediator = ApplicationMediator;
+const request_validator_1 = require("../validation/request-validator");
+const response_validator_1 = require("../validation/response-validator");
+const list_workflows_1 = require("./use-cases/list-workflows");
+const get_workflow_1 = require("./use-cases/get-workflow");
+const get_next_step_1 = require("./use-cases/get-next-step");
+const validate_step_output_1 = require("./use-cases/validate-step-output");
+exports.METHOD_NAMES = {
+    WORKFLOW_LIST: 'workflow_list',
+    WORKFLOW_GET: 'workflow_get',
+    WORKFLOW_NEXT: 'workflow_next',
+    WORKFLOW_VALIDATE: 'workflow_validate',
+    INITIALIZE: 'initialize',
+    TOOLS_LIST: 'tools/list',
+    SHUTDOWN: 'shutdown'
+};
+function buildWorkflowApplication(workflowService, validator = request_validator_1.requestValidator) {
+    const app = new ApplicationMediator(validator);
+    // Attach response validator
+    app.setResponseValidator((method, result) => response_validator_1.responseValidator.validate(method, result));
+    // ------------------------------------------------------------------------
+    // Create use-case instances with injected dependencies
+    // ------------------------------------------------------------------------
+    const listWorkflowsUseCase = (0, list_workflows_1.createListWorkflows)(workflowService);
+    const getWorkflowUseCase = (0, get_workflow_1.createGetWorkflow)(workflowService);
+    const getNextStepUseCase = (0, get_next_step_1.createGetNextStep)(workflowService);
+    const validateStepOutputUseCase = (0, validate_step_output_1.createValidateStepOutput)(workflowService);
+    // ------------------------------------------------------------------------
+    // Workflow tool methods
+    // ------------------------------------------------------------------------
+    app.register(exports.METHOD_NAMES.WORKFLOW_LIST, async (_params) => {
+        const workflows = await listWorkflowsUseCase();
+        return { workflows };
+    });
+    app.register(exports.METHOD_NAMES.WORKFLOW_GET, async (params) => {
+        return getWorkflowUseCase(params.id);
+    });
+    app.register(exports.METHOD_NAMES.WORKFLOW_NEXT, async (params) => {
+        return getNextStepUseCase(params.workflowId, params.completedSteps || [], params.context);
+    });
+    app.register(exports.METHOD_NAMES.WORKFLOW_VALIDATE, async (params) => {
+        return validateStepOutputUseCase(params.workflowId, params.stepId, params.output);
+    });
+    // ------------------------------------------------------------------------
+    // System/handshake methods – dynamic imports to avoid circular deps
+    // ------------------------------------------------------------------------
+    app.register(exports.METHOD_NAMES.INITIALIZE, async (params) => {
+        const { initializeHandler } = await Promise.resolve().then(() => __importStar(require('../tools/mcp_initialize')));
+        return (await initializeHandler({ id: 0, params, method: 'initialize', jsonrpc: '2.0' })).result;
+    });
+    app.register(exports.METHOD_NAMES.TOOLS_LIST, async (params) => {
+        const { toolsListHandler } = await Promise.resolve().then(() => __importStar(require('../tools/mcp_tools_list')));
+        return (await toolsListHandler({ id: 0, params, method: 'tools/list', jsonrpc: '2.0' })).result;
+    });
+    app.register(exports.METHOD_NAMES.SHUTDOWN, async (params) => {
+        const { shutdownHandler } = await Promise.resolve().then(() => __importStar(require('../tools/mcp_shutdown')));
+        return (await shutdownHandler({ id: 0, params, method: 'shutdown', jsonrpc: '2.0' })).result;
+    });
+    return app;
+}
+//# sourceMappingURL=app.js.map

package/dist/application/app.js.map

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

package/dist/application/services/validation-engine.d.ts

@@ -0,0 +1,102 @@
+import { Condition, ConditionContext } from '../../utils/condition-evaluator';
+export interface ValidationRule {
+    type: 'contains' | 'regex' | 'length' | 'schema';
+    message: string;
+    value?: string;
+    pattern?: string;
+    flags?: string;
+    min?: number;
+    max?: number;
+    schema?: Record<string, any>;
+    condition?: Condition;
+}
+export interface ValidationComposition {
+    and?: ValidationCriteria[];
+    or?: ValidationCriteria[];
+    not?: ValidationCriteria;
+}
+export type ValidationCriteria = ValidationRule | ValidationComposition;
+export interface ValidationResult {
+    valid: boolean;
+    issues: string[];
+    suggestions: string[];
+}
+/**
+ * ValidationEngine handles step output validation with support for
+ * multiple validation rule types. This engine is responsible for
+ * evaluating validation criteria against step outputs.
+ */
+export declare class ValidationEngine {
+    private ajv;
+    private schemaCache;
+    constructor();
+    /**
+     * Compiles a JSON schema with caching for performance.
+     *
+     * @param schema - The JSON schema to compile
+     * @returns Compiled schema validator function
+     */
+    private compileSchema;
+    /**
+     * Evaluates validation criteria (either array or composition format).
+     *
+     * @param output - The step output to validate
+     * @param criteria - Validation criteria to evaluate
+     * @param context - Execution context for conditional validation
+     * @returns ValidationResult with validation status and issues
+     */
+    private evaluateCriteria;
+    /**
+     * Evaluates an array of validation rules (legacy format).
+     *
+     * @param output - The step output to validate
+     * @param rules - Array of validation rules to apply
+     * @param context - Execution context for conditional validation
+     * @returns ValidationResult with validation status and issues
+     */
+    private evaluateRuleArray;
+    /**
+     * Evaluates a validation composition with logical operators.
+     *
+     * @param output - The step output to validate
+     * @param composition - The validation composition to evaluate
+     * @param context - Execution context for conditional validation
+     * @returns Boolean indicating if the composition is valid
+     */
+    private evaluateComposition;
+    /**
+     * Evaluates a single validation criteria (rule or composition).
+     *
+     * @param output - The step output to validate
+     * @param criteria - Single validation criteria to evaluate
+     * @param context - Execution context for conditional validation
+     * @returns Boolean indicating if the criteria is valid
+     */
+    private evaluateSingleCriteria;
+    /**
+     * Type guard to check if criteria is a ValidationRule.
+     */
+    private isValidationRule;
+    /**
+     * Type guard to check if criteria is a ValidationComposition.
+     */
+    private isValidationComposition;
+    /**
+     * Validates a step output against validation criteria.
+     *
+     * @param output - The step output to validate
+     * @param criteria - Array of validation rules or composition object to apply
+     * @param context - Optional context for context-aware validation
+     * @returns ValidationResult with validation status and any issues
+     */
+    validate(output: string, criteria: ValidationRule[] | ValidationComposition, context?: ConditionContext): Promise<ValidationResult>;
+    /**
+     * Evaluates a single validation rule against the output.
+     *
+     * @param output - The step output to validate
+     * @param rule - The validation rule to apply
+     * @param issues - Array to collect validation issues
+     */
+    private evaluateRule;
+}
+//# sourceMappingURL=validation-engine.d.ts.map

package/dist/application/services/validation-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-engine.d.ts","sourceRoot":"","sources":["../../../src/application/services/validation-engine.ts"],"names":[],"mappings":"AACA,OAAO,EAAqB,SAAS,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAGjG,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,UAAU,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7B,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAED,MAAM,WAAW,qBAAqB;IACpC,GAAG,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAC3B,EAAE,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAC1B,GAAG,CAAC,EAAE,kBAAkB,CAAC;CAC1B;AAED,MAAM,MAAM,kBAAkB,GAAG,cAAc,GAAG,qBAAqB,CAAC;AAExE,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;;;GAIG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,GAAG,CAAM;IACjB,OAAO,CAAC,WAAW,CAA0B;;IAM7C;;;;;OAKG;IACH,OAAO,CAAC,aAAa;IAgBrB;;;;;;;OAOG;IACH,OAAO,CAAC,gBAAgB;IA+BxB;;;;;;;OAOG;IACH,OAAO,CAAC,iBAAiB;IAgCzB;;;;;;;OAOG;IACH,OAAO,CAAC,mBAAmB;IA4B3B;;;;;;;OAOG;IACH,OAAO,CAAC,sBAAsB;IAwB9B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAIxB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAO/B;;;;;;;OAOG;IACG,QAAQ,CACZ,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,cAAc,EAAE,GAAG,qBAAqB,EAClD,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,gBAAgB,CAAC;IA+B5B;;;;;;OAMG;IACH,OAAO,CAAC,YAAY;CAuFrB"}