@exaudeus/workrail 0.0.16 → 0.0.18

package/dist/utils/config.js

@@ -1,6 +1,4 @@
 "use strict";
-// Configuration Management System
-// Environment variable validation and type-safe configuration
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.config = exports.Configuration = void 0;
 exports.getConfig = getConfig;
@@ -8,66 +6,46 @@ exports.isFeatureEnabled = isFeatureEnabled;
 exports.validateConfiguration = validateConfiguration;
 exports.printConfigSummary = printConfigSummary;
 const zod_1 = require("zod");
-// =============================================================================
-// CONFIGURATION SCHEMAS
-// =============================================================================
 const configSchema = zod_1.z.object({
-    // Core configuration
     NODE_ENV: zod_1.z.enum(['development', 'production', 'test']).default('development'),
     PORT: zod_1.z.string().transform(Number).pipe(zod_1.z.number().min(1).max(65535)).default('3000'),
     HOST: zod_1.z.string().default('0.0.0.0'),
-    // MCP server configuration
     MCP_SERVER_HOST: zod_1.z.string().default('localhost'),
     MCP_SERVER_PORT: zod_1.z.string().transform(Number).pipe(zod_1.z.number().min(1).max(65535)).default('3000'),
-    // Workflow storage
     WORKFLOW_STORAGE_PATH: zod_1.z.string().optional(),
     WORKFLOW_STORAGE_TYPE: zod_1.z.enum(['file', 'database']).default('file'),
     WORKFLOW_INCLUDE_BUNDLED: zod_1.z.string().transform(val => val !== 'false').default('true'),
     WORKFLOW_INCLUDE_USER: zod_1.z.string().transform(val => val !== 'false').default('true'),
     WORKFLOW_INCLUDE_PROJECT: zod_1.z.string().transform(val => val !== 'false').default('true'),
-    // Security settings
     JWT_SECRET: zod_1.z.string().min(32, 'JWT secret must be at least 32 characters').default('your-super-secret-jwt-key-change-this-in-production'),
     MCP_API_KEY: zod_1.z.string().optional(),
     MAX_INPUT_SIZE: zod_1.z.string().transform(Number).pipe(zod_1.z.number().positive()).default('1048576'),
     RATE_LIMIT_WINDOW: zod_1.z.string().transform(Number).pipe(zod_1.z.number().positive()).default('60000'),
     RATE_LIMIT_MAX: zod_1.z.string().transform(Number).pipe(zod_1.z.number().positive()).default('100'),
-    // Performance settings
     CACHE_TTL: zod_1.z.string().transform(Number).pipe(zod_1.z.number().positive()).default('300000'),
     MAX_CONCURRENT_REQUESTS: zod_1.z.string().transform(Number).pipe(zod_1.z.number().positive()).default('1000'),
     MEMORY_LIMIT: zod_1.z.string().default('100MB'),
-    // Logging & monitoring
     LOG_LEVEL: zod_1.z.enum(['debug', 'info', 'warn', 'error']).default('info'),
     METRICS_ENABLED: zod_1.z.string().transform(val => val === 'true').default('true'),
     HEALTH_CHECK_INTERVAL: zod_1.z.string().transform(Number).pipe(zod_1.z.number().positive()).default('30000'),
-    // Database (optional)
     DATABASE_URL: zod_1.z.string().optional(),
     REDIS_URL: zod_1.z.string().optional(),
-    // Development settings
     DEBUG: zod_1.z.string().transform(val => val === 'true').default('false'),
     HOT_RELOAD: zod_1.z.string().transform(val => val === 'true').default('true'),
-    // Testing settings
     TEST_DATABASE_URL: zod_1.z.string().default('sqlite::memory:'),
     TEST_WORKFLOW_STORAGE_PATH: zod_1.z.string().default('./tests/fixtures/workflows'),
-    // Deployment settings
     COMPRESSION_ENABLED: zod_1.z.string().transform(val => val === 'true').default('true'),
     CORS_ORIGINS: zod_1.z.string().default('http://localhost:3000,http://localhost:3001'),
     TRUST_PROXY: zod_1.z.string().transform(val => val === 'true').default('false'),
-    // Workflow specific settings
     MAX_WORKFLOW_SIZE: zod_1.z.string().transform(Number).pipe(zod_1.z.number().positive()).default('1048576'),
     MAX_WORKFLOW_STEPS: zod_1.z.string().transform(Number).pipe(zod_1.z.number().positive()).default('50'),
     WORKFLOW_VALIDATION_ENABLED: zod_1.z.string().transform(val => val === 'true').default('true'),
     WORKFLOW_VALIDATION_STRICT: zod_1.z.string().transform(val => val === 'true').default('true'),
-    // MCP protocol settings
     MCP_PROTOCOL_VERSION: zod_1.z.string().default('2024-11-05'),
     MCP_DEBUG: zod_1.z.string().transform(val => val === 'true').default('false'),
     MCP_TIMEOUT: zod_1.z.string().transform(Number).pipe(zod_1.z.number().positive()).default('30000'),
 });
-// =============================================================================
-// CONFIGURATION CLASS
-// =============================================================================
 class Configuration {
-    static instance;
-    config;
     constructor() {
         this.config = this.loadConfiguration();
     }
@@ -77,14 +55,9 @@ class Configuration {
         }
         return Configuration.instance;
     }
-    /**
-     * Load and validate configuration from environment variables
-     */
     loadConfiguration() {
         try {
-            // Load environment variables
             const envVars = process.env;
-            // Parse and validate configuration
             const config = configSchema.parse(envVars);
             return config;
         }
@@ -99,15 +72,9 @@ class Configuration {
             throw error;
         }
     }
-    /**
-     * Get the complete configuration object
-     */
     getConfig() {
         return this.config;
     }
-    /**
-     * Get server configuration
-     */
     getServerConfig() {
         return {
             port: this.config.PORT,
@@ -134,51 +101,27 @@ class Configuration {
             },
         };
     }
-    /**
-     * Get a specific configuration value
-     */
     get(key) {
         return this.config[key];
     }
-    /**
-     * Check if running in development mode
-     */
     isDevelopment() {
         return this.config.NODE_ENV === 'development';
     }
-    /**
-     * Check if running in production mode
-     */
     isProduction() {
         return this.config.NODE_ENV === 'production';
     }
-    /**
-     * Check if running in test mode
-     */
     isTest() {
         return this.config.NODE_ENV === 'test';
     }
-    /**
-     * Check if debug mode is enabled
-     */
     isDebugEnabled() {
         return this.config.DEBUG;
     }
-    /**
-     * Check if metrics are enabled
-     */
     isMetricsEnabled() {
         return this.config.METRICS_ENABLED;
     }
-    /**
-     * Get CORS origins as array
-     */
     getCorsOrigins() {
         return this.config.CORS_ORIGINS.split(',').map(origin => origin.trim());
     }
-    /**
-     * Get memory limit in bytes
-     */
     getMemoryLimitBytes() {
         const memoryLimit = this.config.MEMORY_LIMIT;
         const units = {
@@ -196,9 +139,6 @@ class Configuration {
         const multiplier = units[unitUpper] ?? units['MB'];
         return parseInt(value || '0') * (multiplier || 1);
     }
-    /**
-     * Validate configuration for specific features
-     */
     validateFeatureConfig(feature) {
         const errors = [];
         switch (feature) {
@@ -228,9 +168,6 @@ class Configuration {
             errors,
         };
     }
-    /**
-     * Get configuration summary for logging
-     */
     getConfigSummary() {
         return {
             environment: this.config.NODE_ENV,
@@ -262,27 +199,15 @@ class Configuration {
             },
         };
     }
-    /**
-     * Reload configuration (useful for testing)
-     */
     reload() {
         this.config = this.loadConfiguration();
     }
 }
 exports.Configuration = Configuration;
-// =============================================================================
-// CONFIGURATION UTILITIES
-// =============================================================================
 exports.config = Configuration.getInstance();
-/**
- * Get configuration value with type safety
- */
 function getConfig(key) {
     return exports.config.get(key);
 }
-/**
- * Check if feature is enabled
- */
 function isFeatureEnabled(feature) {
     switch (feature) {
         case 'debug':
@@ -297,12 +222,8 @@ function isFeatureEnabled(feature) {
             return false;
     }
 }
-/**
- * Validate all configuration
- */
 function validateConfiguration() {
     const errors = [];
-    // Validate core features
     const features = ['database', 'redis', 'security', 'workflow-validation'];
     for (const feature of features) {
         const validation = exports.config.validateFeatureConfig(feature);
@@ -310,7 +231,6 @@ function validateConfiguration() {
             errors.push(...validation.errors);
         }
     }
-    // Validate environment-specific requirements
     if (exports.config.isProduction()) {
         if (exports.config.get('JWT_SECRET') === 'your-super-secret-jwt-key-change-this-in-production') {
             errors.push('JWT_SECRET must be changed in production');
@@ -324,12 +244,8 @@ function validateConfiguration() {
         errors,
     };
 }
-/**
- * Print configuration summary
- */
 function printConfigSummary() {
     const summary = exports.config.getConfigSummary();
     console.log('Configuration Summary:');
     console.log(JSON.stringify(summary, null, 2));
 }
-//# sourceMappingURL=config.js.map

package/dist/utils/storage-security.d.ts

@@ -1,74 +1,12 @@
-/**
- * Storage security utilities extracted from FileWorkflowStorage patterns
- * for consistent security across all storage implementations.
- */
-/**
- * Sanitize and validate workflow identifiers for security.
- * Prevents null byte injection and enforces valid character set.
- *
- * @param id - The workflow identifier to validate
- * @returns Normalized and validated identifier
- * @throws SecurityError for null bytes
- * @throws InvalidWorkflowError for invalid characters
- */
 export declare function sanitizeId(id: string): string;
-/**
- * Assert that a resolved path stays within the specified base directory.
- * Prevents path traversal attacks by ensuring no directory escape.
- *
- * @param resolvedPath - The fully resolved absolute path to check
- * @param baseDir - The base directory that should contain the path
- * @throws SecurityError if path escapes the base directory
- */
 export declare function assertWithinBase(resolvedPath: string, baseDir: string): void;
-/**
- * Validate file size against security limits.
- * Prevents resource exhaustion and DoS attacks via oversized files.
- *
- * @param fileSize - Size of the file in bytes
- * @param maxSize - Maximum allowed size in bytes
- * @param context - Context for error reporting (e.g., filename)
- * @throws SecurityError if file exceeds size limit
- */
 export declare function validateFileSize(fileSize: number, maxSize: number, context?: string): void;
-/**
- * Sanitize and resolve a file path safely within a base directory.
- * Combines path resolution with base directory validation.
- *
- * @param basePath - The base directory
- * @param relativePath - The relative path to resolve
- * @returns Safely resolved absolute path
- * @throws SecurityError if the resolved path escapes the base
- */
 export declare function securePathResolve(basePath: string, relativePath: string): string;
-/**
- * Validate URL security for remote storage implementations.
- * Ensures URLs use safe protocols and don't target local resources.
- *
- * @param url - The URL to validate
- * @throws SecurityError for unsafe URLs
- */
 export declare function validateSecureUrl(url: string): void;
-/**
- * Common security options interface for storage implementations.
- */
 export interface StorageSecurityOptions {
-    /** Maximum file size in bytes (default: 1MB) */
     maxFileSizeBytes?: number;
-    /** Whether to allow HTTP URLs (default: false, HTTPS only) */
     allowHttp?: boolean;
-    /** Custom allowed URL patterns (advanced use) */
     allowedUrlPatterns?: RegExp[];
 }
-/**
- * Default security configuration following FileWorkflowStorage patterns.
- */
 export declare const DEFAULT_SECURITY_OPTIONS: Required<StorageSecurityOptions>;
-/**
- * Validate security options and apply defaults.
- *
- * @param options - User-provided security options
- * @returns Validated options with defaults applied
- */
 export declare function validateSecurityOptions(options?: StorageSecurityOptions): Required<StorageSecurityOptions>;
-//# sourceMappingURL=storage-security.d.ts.map

package/dist/utils/storage-security.js

@@ -1,4 +1,7 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DEFAULT_SECURITY_OPTIONS = void 0;
 exports.sanitizeId = sanitizeId;
@@ -7,22 +10,8 @@ exports.validateFileSize = validateFileSize;
 exports.securePathResolve = securePathResolve;
 exports.validateSecureUrl = validateSecureUrl;
 exports.validateSecurityOptions = validateSecurityOptions;
-const tslib_1 = require("tslib");
-const path_1 = tslib_1.__importDefault(require("path"));
+const path_1 = __importDefault(require("path"));
 const error_handler_1 = require("../core/error-handler");
-/**
- * Storage security utilities extracted from FileWorkflowStorage patterns
- * for consistent security across all storage implementations.
- */
-/**
- * Sanitize and validate workflow identifiers for security.
- * Prevents null byte injection and enforces valid character set.
- *
- * @param id - The workflow identifier to validate
- * @returns Normalized and validated identifier
- * @throws SecurityError for null bytes
- * @throws InvalidWorkflowError for invalid characters
- */
 function sanitizeId(id) {
     if (id.includes('\u0000')) {
         throw new error_handler_1.SecurityError('Null byte detected in identifier', 'sanitizeId');
@@ -34,63 +23,28 @@ function sanitizeId(id) {
     }
     return normalised;
 }
-/**
- * Assert that a resolved path stays within the specified base directory.
- * Prevents path traversal attacks by ensuring no directory escape.
- *
- * @param resolvedPath - The fully resolved absolute path to check
- * @param baseDir - The base directory that should contain the path
- * @throws SecurityError if path escapes the base directory
- */
 function assertWithinBase(resolvedPath, baseDir) {
     if (!resolvedPath.startsWith(baseDir + path_1.default.sep) && resolvedPath !== baseDir) {
         throw new error_handler_1.SecurityError('Path escapes storage sandbox', 'file-access');
     }
 }
-/**
- * Validate file size against security limits.
- * Prevents resource exhaustion and DoS attacks via oversized files.
- *
- * @param fileSize - Size of the file in bytes
- * @param maxSize - Maximum allowed size in bytes
- * @param context - Context for error reporting (e.g., filename)
- * @throws SecurityError if file exceeds size limit
- */
 function validateFileSize(fileSize, maxSize, context) {
     if (fileSize > maxSize) {
         const contextStr = context ? ` (${context})` : '';
         throw new error_handler_1.SecurityError(`File exceeds size limit of ${maxSize} bytes${contextStr}`, 'file-size');
     }
 }
-/**
- * Sanitize and resolve a file path safely within a base directory.
- * Combines path resolution with base directory validation.
- *
- * @param basePath - The base directory
- * @param relativePath - The relative path to resolve
- * @returns Safely resolved absolute path
- * @throws SecurityError if the resolved path escapes the base
- */
 function securePathResolve(basePath, relativePath) {
     const resolvedPath = path_1.default.resolve(basePath, relativePath);
     assertWithinBase(resolvedPath, basePath);
     return resolvedPath;
 }
-/**
- * Validate URL security for remote storage implementations.
- * Ensures URLs use safe protocols and don't target local resources.
- *
- * @param url - The URL to validate
- * @throws SecurityError for unsafe URLs
- */
 function validateSecureUrl(url) {
     try {
         const parsed = new URL(url);
-        // Only allow HTTPS and HTTP protocols
         if (!['https:', 'http:'].includes(parsed.protocol)) {
             throw new error_handler_1.SecurityError(`Unsafe protocol: ${parsed.protocol}. Only HTTP/HTTPS allowed`, 'url-validation');
         }
-        // Prevent localhost and private IP access
         const hostname = parsed.hostname.toLowerCase();
         if (hostname === 'localhost' ||
             hostname === '127.0.0.1' ||
@@ -107,28 +61,18 @@ function validateSecureUrl(url) {
         throw new error_handler_1.SecurityError(`Invalid URL format: ${url}`, 'url-validation');
     }
 }
-/**
- * Default security configuration following FileWorkflowStorage patterns.
- */
 exports.DEFAULT_SECURITY_OPTIONS = {
-    maxFileSizeBytes: 1_000_000, // 1 MB
+    maxFileSizeBytes: 1000000,
     allowHttp: false,
     allowedUrlPatterns: []
 };
-/**
- * Validate security options and apply defaults.
- *
- * @param options - User-provided security options
- * @returns Validated options with defaults applied
- */
 function validateSecurityOptions(options = {}) {
     const validated = { ...exports.DEFAULT_SECURITY_OPTIONS, ...options };
     if (validated.maxFileSizeBytes <= 0) {
         throw new error_handler_1.SecurityError('maxFileSizeBytes must be positive', 'config-validation');
     }
-    if (validated.maxFileSizeBytes > 100_000_000) { // 100MB upper limit
+    if (validated.maxFileSizeBytes > 100000000) {
         throw new error_handler_1.SecurityError('maxFileSizeBytes exceeds reasonable limit (100MB)', 'config-validation');
     }
     return validated;
 }
-//# sourceMappingURL=storage-security.js.map

package/dist/validation/request-validator.d.ts

@@ -6,4 +6,3 @@ declare class RequestValidator {
 }
 export declare const requestValidator: RequestValidator;
 export {};
-//# sourceMappingURL=request-validator.d.ts.map

package/dist/validation/request-validator.js

@@ -1,15 +1,17 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.requestValidator = void 0;
-const tslib_1 = require("tslib");
-const ajv_1 = tslib_1.__importDefault(require("ajv"));
+const ajv_1 = __importDefault(require("ajv"));
 const schemas_1 = require("./schemas");
 const error_handler_1 = require("../core/error-handler");
 const mcp_types_1 = require("../types/mcp-types");
 class RequestValidator {
-    ajv = new ajv_1.default({ allErrors: true, strict: false });
-    compiled = new Map();
     constructor() {
+        this.ajv = new ajv_1.default({ allErrors: true, strict: false });
+        this.compiled = new Map();
         for (const [method, schema] of Object.entries(schemas_1.methodParamSchemas)) {
             this.compiled.set(method, this.ajv.compile(schema));
         }
@@ -17,7 +19,6 @@ class RequestValidator {
     validate(method, params) {
         const validator = this.compiled.get(method);
         if (!validator) {
-            // No schema registered – treat as allowed (for e.g., mcp handshake commands)
             return;
         }
         const valid = validator(params);
@@ -29,4 +30,3 @@ class RequestValidator {
     }
 }
 exports.requestValidator = new RequestValidator();
-//# sourceMappingURL=request-validator.js.map

package/dist/validation/response-validator.d.ts

@@ -6,4 +6,3 @@ export declare class ResponseValidator {
     validate(method: string, result: unknown): void;
 }
 export declare const responseValidator: ResponseValidator;
-//# sourceMappingURL=response-validator.d.ts.map

package/dist/validation/response-validator.js

@@ -4,9 +4,6 @@ exports.responseValidator = exports.ResponseValidator = exports.methodResultSche
 const zod_1 = require("zod");
 const error_handler_1 = require("../core/error-handler");
 const idRegex = /^[A-Za-z0-9_-]+$/;
-// ---------------------------------------------------------------------------
-// Reusable fragments
-// ---------------------------------------------------------------------------
 const workflowSummarySchema = zod_1.z.object({
     id: zod_1.z.string().regex(idRegex),
     name: zod_1.z.string(),
@@ -34,7 +31,6 @@ const workflowSchema = zod_1.z.object({
     steps: zod_1.z.array(workflowStepSchema),
     metaGuidance: zod_1.z.array(zod_1.z.string()).optional()
 });
-// Mode parameter response schemas
 const workflowMetadataSchema = zod_1.z.object({
     id: zod_1.z.string().regex(idRegex),
     name: zod_1.z.string(),
@@ -48,23 +44,16 @@ const workflowMetadataSchema = zod_1.z.object({
 const workflowPreviewSchema = workflowMetadataSchema.extend({
     firstStep: workflowStepSchema.nullable()
 });
-// Union schema for workflow_get that handles all three response types
 const workflowGetResponseSchema = zod_1.z.union([
-    workflowSchema, // Full workflow (for undefined mode or backward compatibility)
-    workflowMetadataSchema, // Metadata mode response
-    workflowPreviewSchema // Preview mode response
+    workflowSchema,
+    workflowMetadataSchema,
+    workflowPreviewSchema
 ]);
-// ---------------------------------------------------------------------------
-// Method result schemas
-// ---------------------------------------------------------------------------
 exports.methodResultSchemas = {
-    // workflow_list → { workflows: WorkflowSummary[] }
     workflow_list: zod_1.z.object({
         workflows: zod_1.z.array(workflowSummarySchema)
     }),
-    // workflow_get → Workflow | WorkflowMetadata | WorkflowPreview (union based on mode parameter)
     workflow_get: workflowGetResponseSchema,
-    // workflow_next → { step, guidance, isComplete }
     workflow_next: zod_1.z.object({
         step: workflowStepSchema.nullable(),
         guidance: zod_1.z.object({
@@ -75,25 +64,20 @@ exports.methodResultSchemas = {
         }),
         isComplete: zod_1.z.boolean()
     }),
-    // workflow_validate → { valid, issues?, suggestions? }
     workflow_validate: zod_1.z.object({
         valid: zod_1.z.boolean(),
         issues: zod_1.z.array(zod_1.z.string()).optional(),
         suggestions: zod_1.z.array(zod_1.z.string()).optional()
     })
 };
-// ---------------------------------------------------------------------------
-// Validator class
-// ---------------------------------------------------------------------------
 class ResponseValidator {
-    compiled;
     constructor(schemas) {
         this.compiled = schemas;
     }
     validate(method, result) {
         const schema = this.compiled[method];
         if (!schema)
-            return; // no schema means unchecked output
+            return;
         const parsed = schema.safeParse(result);
         if (!parsed.success) {
             throw new error_handler_1.ValidationError('Invalid response', undefined, parsed.error.format());
@@ -102,4 +86,3 @@ class ResponseValidator {
 }
 exports.ResponseValidator = ResponseValidator;
 exports.responseValidator = new ResponseValidator(exports.methodResultSchemas);
-//# sourceMappingURL=response-validator.js.map

package/dist/validation/schemas.d.ts

@@ -1,6 +1 @@
-/**
- * Collection of per-method parameter schemas used for request validation.
- * Using raw schema objects to keep typings simple.
- */
 export declare const methodParamSchemas: Record<string, any>;
-//# sourceMappingURL=schemas.d.ts.map

package/dist/validation/schemas.js

@@ -1,10 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.methodParamSchemas = void 0;
-/**
- * Collection of per-method parameter schemas used for request validation.
- * Using raw schema objects to keep typings simple.
- */
 exports.methodParamSchemas = {
     workflow_list: {
         type: 'object',
@@ -55,4 +51,3 @@ exports.methodParamSchemas = {
         additionalProperties: false
     }
 };
-//# sourceMappingURL=schemas.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@exaudeus/workrail",
-  "version": "0.0.16",
+  "version": "0.0.18",
   "description": "MCP server for structured workflow orchestration and step-by-step task guidance",
   "license": "MIT",
   "bin": {
@@ -12,10 +12,8 @@
     "workflows"
   ],
   "scripts": {
-    "build": "tsc && shx chmod +x dist/*.js",
+    "build": "tsc -p tsconfig.build.json",
     "dev": "npm run build && node dist/mcp-server.js",
-    "test": "jest",
-    "test:performance": "jest --config jest.performance.config.cjs",
     "prepare": "npm run build",
     "watch": "tsc --watch"
   },
@@ -30,15 +28,6 @@
     "tslib": "^2.8.1",
     "zod": "^3.22.4"
   },
-  "devDependencies": {
-    "@types/jest": "^29.5.5",
-    "@types/node": "^20.6.3",
-    "jest": "^29.7.0",
-    "shx": "^0.3.4",
-    "ts-jest": "^29.1.1",
-    "ts-node": "^10.9.1",
-    "typescript": "^5.2.2"
-  },
   "keywords": [
     "mcp",
     "model-context-protocol",
@@ -46,5 +35,9 @@
     "orchestration",
     "ai-assistant",
     "task-management"
-  ]
+  ],
+  "devDependencies": {
+    "@types/node": "^20.19.9",
+    "typescript": "^5.8.3"
+  }
 }

package/spec/mcp-protocol-handshake.md

@@ -1,8 +1,9 @@
-# MCP Protocol Specification for Workflow Orchestration
+# MCP Protocol Handshake Specification
 
-> 🤝 **Model Context Protocol Implementation for Workflow Orchestration System**
+> 🤝 **Specification for the MCP protocol handshake**
 
-[![Status](https://img.shields.io/badge/status-specification-orange.svg)](https://github.com/yourusername/workflow-orchestration-system)
+[![Status](https://img.shields.io/badge/status-specification-orange.svg)](https://github.com/EtienneBBeaulac/mcp)
+[![Spec Version](https://img.shields.io/badge/spec-1.0.0-blue.svg)](specs/)
 [![MCP Version](https://img.shields.io/badge/MCP-2024--11--05-blue.svg)](https://modelcontextprotocol.org)
 [![Protocol](https://img.shields.io/badge/protocol-JSON--RPC%202.0-green.svg)](https://www.jsonrpc.org/specification)