@yasserkhanorg/e2e-agents 1.8.0 → 1.8.2

package/dist/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AAEH,oBAAY,QAAQ;IAChB,KAAK,IAAI;IACT,IAAI,IAAI;IACR,IAAI,IAAI;IACR,KAAK,IAAI;CACZ;AAqCD,qBAAa,MAAM;IACf,OAAO,CAAC,KAAK,CAAW;IACxB,OAAO,CAAC,QAAQ,CAAU;gBAEd,QAAQ,CAAC,EAAE,QAAQ;IAK/B,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAM/D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAM9D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAM9D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAM/D,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAI/B,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAInC;;;OAGG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG;QAAC,GAAG,EAAE,MAAM,MAAM,CAAA;KAAC;IAWzC,OAAO,CAAC,GAAG;CAoBd;AAGD,eAAO,MAAM,MAAM,QAAe,CAAC"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAGA;;;GAGG;AAEH,oBAAY,QAAQ;IAChB,KAAK,IAAI;IACT,IAAI,IAAI;IACR,IAAI,IAAI;IACR,KAAK,IAAI;CACZ;AAqCD,qBAAa,MAAM;IACf,OAAO,CAAC,KAAK,CAAW;IACxB,OAAO,CAAC,QAAQ,CAAU;gBAEd,QAAQ,CAAC,EAAE,QAAQ;IAK/B,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAM/D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAM9D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAM9D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAM/D,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAI/B,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAInC;;;OAGG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG;QAAC,GAAG,EAAE,MAAM,MAAM,CAAA;KAAC;IAWzC,OAAO,CAAC,GAAG;CAoBd;AAGD,eAAO,MAAM,MAAM,QAAe,CAAC"}

package/dist/logger.js

@@ -4,8 +4,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.logger = exports.Logger = exports.LogLevel = void 0;
 /**
- * Simple structured logging system
- * Replaces 18 console.log statements with configurable logging
+ * Structured logging system.
  * Environment variable: LOG_LEVEL (ERROR, WARN, INFO, DEBUG)
  */
 var LogLevel;

package/dist/mcp-server.d.ts

@@ -1,3 +1,4 @@
+#!/usr/bin/env node
 interface Tool {
     name: string;
     description: string;
@@ -31,5 +32,37 @@ export declare class E2EAgentsMCPServer {
      */
     getTools(): Tool[];
 }
+/**
+ * Encode a JSON-RPC message with Content-Length framing.
+ * Exported for testability.
+ */
+export declare function encodeJsonRpcMessage(message: Record<string, unknown>): string;
+/**
+ * Parse Content-Length framed JSON-RPC messages from a buffer.
+ * Returns parsed messages and the remaining (unconsumed) buffer.
+ * Exported for testability.
+ */
+export declare function parseJsonRpcFrames(input: Buffer): {
+    messages: Array<{
+        id?: unknown;
+        method?: string;
+        params?: Record<string, unknown>;
+    }>;
+    remainder: Buffer<ArrayBuffer>;
+};
+/**
+ * Handle a single JSON-RPC message against the server.
+ * Returns the response message (or null for notifications).
+ * Exported for testability.
+ */
+export declare function handleJsonRpcMessage(server: E2EAgentsMCPServer, message: {
+    id?: unknown;
+    method?: string;
+    params?: Record<string, unknown>;
+}): Promise<Record<string, unknown> | null>;
+/**
+ * Start MCP server over stdio using Content-Length framed JSON-RPC messages.
+ */
+export declare function startStdioServer(repoRoot?: string): void;
 export default E2EAgentsMCPServer;
 //# sourceMappingURL=mcp-server.d.ts.map

package/dist/mcp-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../src/mcp-server.ts"],"names":[],"mappings":"AAaA,UAAU,IAAI;IACV,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC;AA4GD;;;GAGG;AACH,qBAAa,kBAAkB;IAC3B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,WAAW,CAAc;gBAErB,QAAQ,GAAE,MAAsB;IAM5C,OAAO,CAAC,WAAW;IAmGnB;;;OAGG;IACG,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAwB5E,OAAO,CAAC,aAAa;IA6BrB,OAAO,CAAC,QAAQ;IAmBhB,OAAO,CAAC,SAAS;IAwCjB,OAAO,CAAC,QAAQ;IAyDhB,OAAO,CAAC,aAAa;IA2BrB,OAAO,CAAC,oBAAoB;IAqD5B,OAAO,CAAC,eAAe;IAwBvB,OAAO,CAAC,sBAAsB;IAW9B;;OAEG;IACH,QAAQ,IAAI,IAAI,EAAE;CAGrB;AAYD,eAAe,kBAAkB,CAAC"}
+{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../src/mcp-server.ts"],"names":[],"mappings":";AAeA,UAAU,IAAI;IACV,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC;AA4GD;;;GAGG;AACH,qBAAa,kBAAkB;IAC3B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,WAAW,CAAc;gBAErB,QAAQ,GAAE,MAAsB;IAM5C,OAAO,CAAC,WAAW;IAmGnB;;;OAGG;IACG,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAwB5E,OAAO,CAAC,aAAa;IA6BrB,OAAO,CAAC,QAAQ;IAmBhB,OAAO,CAAC,SAAS;IAwCjB,OAAO,CAAC,QAAQ;IAyDhB,OAAO,CAAC,aAAa;IA2BrB,OAAO,CAAC,oBAAoB;IAqD5B,OAAO,CAAC,eAAe;IAwBvB,OAAO,CAAC,sBAAsB;IAW9B;;OAEG;IACH,QAAQ,IAAI,IAAI,EAAE;CAGrB;AAgBD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAG7E;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG;IAAC,QAAQ,EAAE,KAAK,CAAC;QAAC,EAAE,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAC,CAAC,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC,WAAW,CAAC,CAAA;CAAC,CA0BtK;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CACtC,MAAM,EAAE,kBAAkB,EAC1B,OAAO,EAAE;IAAC,EAAE,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAC,GAC3E,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAmEzC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,GAAE,MAAsB,GAAG,IAAI,CAmCvE;AAMD,eAAe,kBAAkB,CAAC"}

package/dist/mcp-server.js

@@ -1,8 +1,13 @@
+#!/usr/bin/env node
 "use strict";
 // Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
 // See LICENSE.txt for license information.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.E2EAgentsMCPServer = void 0;
+exports.encodeJsonRpcMessage = encodeJsonRpcMessage;
+exports.parseJsonRpcFrames = parseJsonRpcFrames;
+exports.handleJsonRpcMessage = handleJsonRpcMessage;
+exports.startStdioServer = startStdioServer;
 /**
  * MCP Server for E2E Agents - SECURITY HARDENED
  * Exposes tools for Claude and Playwright agents to discover, generate, and heal tests
@@ -475,12 +480,152 @@ class E2EAgentsMCPServer {
 }
 exports.E2EAgentsMCPServer = E2EAgentsMCPServer;
 /**
- * Start MCP server
- * Usage: node dist/mcp-server.js
+ * Read the package version at runtime so the MCP initialize response
+ * always reflects the installed version.
  */
+function getPackageVersion() {
+    try {
+        const pkgPath = (0, path_1.join)((0, path_1.dirname)(__dirname), 'package.json');
+        const pkg = JSON.parse((0, fs_1.readFileSync)(pkgPath, 'utf-8'));
+        return pkg.version || '0.0.0';
+    }
+    catch {
+        return '0.0.0';
+    }
+}
+/**
+ * Encode a JSON-RPC message with Content-Length framing.
+ * Exported for testability.
+ */
+function encodeJsonRpcMessage(message) {
+    const body = JSON.stringify(message);
+    return `Content-Length: ${Buffer.byteLength(body, 'utf8')}\r\n\r\n${body}`;
+}
+/**
+ * Parse Content-Length framed JSON-RPC messages from a buffer.
+ * Returns parsed messages and the remaining (unconsumed) buffer.
+ * Exported for testability.
+ */
+function parseJsonRpcFrames(input) {
+    const messages = [];
+    let buffer = Buffer.from(input);
+    while (true) {
+        const headerEnd = buffer.indexOf('\r\n\r\n');
+        if (headerEnd === -1)
+            break;
+        const headerText = buffer.slice(0, headerEnd).toString('utf8');
+        const match = headerText.match(/Content-Length:\s*(\d+)/i);
+        if (!match) {
+            buffer = Buffer.alloc(0);
+            break;
+        }
+        const contentLength = Number(match[1]);
+        const messageEnd = headerEnd + 4 + contentLength;
+        if (buffer.length < messageEnd)
+            break;
+        const body = buffer.slice(headerEnd + 4, messageEnd).toString('utf8');
+        buffer = buffer.slice(messageEnd);
+        messages.push(JSON.parse(body));
+    }
+    return { messages, remainder: buffer };
+}
+/**
+ * Handle a single JSON-RPC message against the server.
+ * Returns the response message (or null for notifications).
+ * Exported for testability.
+ */
+async function handleJsonRpcMessage(server, message) {
+    const { id, method, params } = message;
+    const version = getPackageVersion();
+    if (method === 'initialize') {
+        return {
+            jsonrpc: '2.0',
+            id,
+            result: {
+                protocolVersion: typeof params?.protocolVersion === 'string' ? params.protocolVersion : '2024-11-05',
+                capabilities: { tools: {}, resources: {}, prompts: {} },
+                serverInfo: { name: 'e2e-agents-mcp', version },
+            },
+        };
+    }
+    if (method === 'notifications/initialized' || method === 'initialized') {
+        return null;
+    }
+    if (method === 'tools/list') {
+        return {
+            jsonrpc: '2.0',
+            id,
+            result: {
+                tools: server.getTools().map((tool) => ({
+                    name: tool.name,
+                    description: tool.description,
+                    inputSchema: tool.inputSchema,
+                })),
+            },
+        };
+    }
+    if (method === 'tools/call') {
+        const resultText = await server.callTool(typeof params?.name === 'string' ? params.name : '', typeof params?.arguments === 'object' && params.arguments !== null ? params.arguments : {});
+        let isError = false;
+        try {
+            const parsed = JSON.parse(resultText);
+            isError = Boolean(parsed.error);
+        }
+        catch {
+            isError = false;
+        }
+        return {
+            jsonrpc: '2.0',
+            id,
+            result: { content: [{ type: 'text', text: resultText }], isError },
+        };
+    }
+    if (method === 'resources/list') {
+        return { jsonrpc: '2.0', id, result: { resources: [] } };
+    }
+    if (method === 'prompts/list') {
+        return { jsonrpc: '2.0', id, result: { prompts: [] } };
+    }
+    if (method === 'ping') {
+        return { jsonrpc: '2.0', id, result: {} };
+    }
+    return { jsonrpc: '2.0', id, error: { code: -32601, message: `Method not found: ${method}` } };
+}
+/**
+ * Start MCP server over stdio using Content-Length framed JSON-RPC messages.
+ */
+function startStdioServer(repoRoot = process.cwd()) {
+    const server = new E2EAgentsMCPServer(repoRoot);
+    let buffer = Buffer.alloc(0);
+    const sendMessage = (message) => {
+        process.stdout.write(encodeJsonRpcMessage(message));
+    };
+    const sendError = (id, code, msg) => {
+        sendMessage({ jsonrpc: '2.0', id, error: { code, message: msg } });
+    };
+    const processBuffer = () => {
+        const { messages, remainder } = parseJsonRpcFrames(buffer);
+        buffer = remainder;
+        for (const parsed of messages) {
+            void handleJsonRpcMessage(server, parsed)
+                .then((response) => {
+                if (response)
+                    sendMessage(response);
+            })
+                .catch((error) => {
+                sendError(parsed.id ?? null, -32603, error instanceof Error ? error.message : String(error));
+            });
+        }
+    };
+    process.stdin.on('data', (chunk) => {
+        buffer = Buffer.concat([buffer, chunk]);
+        processBuffer();
+    });
+    process.stdin.on('end', () => {
+        process.exit(0);
+    });
+}
 if (require.main === module) {
-    const server = new E2EAgentsMCPServer();
-    console.log('E2E Agents MCP Server started');
-    console.log('Tools:', server.getTools().map((t) => t.name).join(', '));
+    startStdioServer();
 }
 exports.default = E2EAgentsMCPServer;

package/dist/ollama_provider.js

@@ -110,7 +110,7 @@ class OllamaProvider extends base_provider_js_1.BaseProvider {
         // SECURITY: Validate and sanitize URL
         const urlValidation = validateOllamaUrl(config.baseUrl);
         if (!urlValidation.valid && urlValidation.warning) {
-            console.warn(urlValidation.warning);
+            logger_js_1.logger.warn(urlValidation.warning);
         }
         // SECURITY: Validate timeout
         const timeout = validateTimeout(config.timeout);

package/dist/provider_factory.d.ts

@@ -55,6 +55,11 @@ export declare class LLMProviderFactory {
      * 5. Error (no provider available)
      */
     static createFromEnv(): Promise<LLMProvider>;
+    /**
+     * Create provider from an explicit preference when supplied, otherwise
+     * fall back to environment auto-detection.
+     */
+    static createFromPreference(providerPreference?: string): Promise<LLMProvider>;
     /**
      * Create provider from simple string format
      *

package/dist/provider_factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"provider_factory.d.ts","sourceRoot":"","sources":["../src/provider_factory.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAKR,WAAW,EAIX,cAAc,EAEjB,MAAM,yBAAyB,CAAC;AAGjC;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,kBAAkB;IAC3B;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,GAAG,WAAW;IAmBlD;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,WAAW;IAWtD;;;;;;;;;OASG;WACU,aAAa,IAAI,OAAO,CAAC,WAAW,CAAC;IA0ElD;;;;;;;;;;OAUG;IACH,MAAM,CAAC,gBAAgB,CAAC,cAAc,EAAE,MAAM,GAAG,WAAW;CAkC/D;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB;;;OAGG;IACH,OAAO,EAAE,cAAc,CAAC;IAExB;;;OAGG;IACH,QAAQ,EAAE,cAAc,CAAC;IAEzB;;;OAGG;IACH,cAAc,CAAC,EAAE,KAAK,CAAC,QAAQ,GAAG,mBAAmB,GAAG,wBAAwB,CAAC,CAAC;CACrF;AAqJD;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,QAAQ,EAAE,WAAW,GAAG,OAAO,CAAC;IACxE,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,EAAE,CAAC;CAC1B,CAAC,CAsCD"}
+{"version":3,"file":"provider_factory.d.ts","sourceRoot":"","sources":["../src/provider_factory.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAKR,WAAW,EAIX,cAAc,EAEjB,MAAM,yBAAyB,CAAC;AAGjC;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,kBAAkB;IAC3B;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,GAAG,WAAW;IAmBlD;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,WAAW;IAWtD;;;;;;;;;OASG;WACU,aAAa,IAAI,OAAO,CAAC,WAAW,CAAC;IAyElD;;;OAGG;WACU,oBAAoB,CAAC,kBAAkB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IASpF;;;;;;;;;;OAUG;IACH,MAAM,CAAC,gBAAgB,CAAC,cAAc,EAAE,MAAM,GAAG,WAAW;CAkC/D;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB;;;OAGG;IACH,OAAO,EAAE,cAAc,CAAC;IAExB;;;OAGG;IACH,QAAQ,EAAE,cAAc,CAAC;IAEzB;;;OAGG;IACH,cAAc,CAAC,EAAE,KAAK,CAAC,QAAQ,GAAG,mBAAmB,GAAG,wBAAwB,CAAC,CAAC;CACrF;AA+ID;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,QAAQ,EAAE,WAAW,GAAG,OAAO,CAAC;IACxE,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,EAAE,CAAC;CAC1B,CAAC,CAsCD"}

package/dist/provider_factory.js

@@ -5,6 +5,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.LLMProviderFactory = void 0;
 exports.validateProviderSetup = validateProviderSetup;
 const anthropic_provider_js_1 = require("./anthropic_provider.js");
+const logger_js_1 = require("./logger.js");
 const custom_provider_js_1 = require("./custom_provider.js");
 const ollama_provider_js_1 = require("./ollama_provider.js");
 const openai_provider_js_1 = require("./openai_provider.js");
@@ -135,8 +136,7 @@ class LLMProviderFactory {
         const ollama = new ollama_provider_js_1.OllamaProvider({});
         const health = await ollama.checkHealth();
         if (health.healthy) {
-            // eslint-disable-next-line no-console
-            console.log('Auto-detected Ollama provider (free, local)');
+            logger_js_1.logger.info('Auto-detected Ollama provider (free, local)');
             return ollama;
         }
         throw new Error('No LLM provider available. Please either:\n' +
@@ -145,6 +145,17 @@ class LLMProviderFactory {
             '3. Set OPENAI_API_KEY environment variable\n' +
             '4. Set LLM_PROVIDER environment variable');
     }
+    /**
+     * Create provider from an explicit preference when supplied, otherwise
+     * fall back to environment auto-detection.
+     */
+    static async createFromPreference(providerPreference) {
+        const normalized = providerPreference?.trim().toLowerCase();
+        if (!normalized || normalized === 'auto') {
+            return this.createFromEnv();
+        }
+        return this.createFromString(normalized);
+    }
     /**
      * Create provider from simple string format
      *
@@ -223,8 +234,7 @@ class HybridProvider {
     }
     async generateText(prompt, options) {
         // Use primary for text generation (free)
-        // eslint-disable-next-line no-console
-        console.log(`[Hybrid] Using ${this.primary.name} for text generation`);
+        logger_js_1.logger.debug(`[Hybrid] Using ${this.primary.name} for text generation`);
         return await this.primary.generateText(prompt, options);
     }
     async analyzeImage(images, prompt, options) {
@@ -232,8 +242,7 @@ class HybridProvider {
         if (this.useFallbackFor.has('vision')) {
             // Use fallback if primary doesn't support vision
             if (!this.primary.capabilities.vision) {
-                // eslint-disable-next-line no-console
-                console.log(`[Hybrid] Using ${this.fallback.name} for vision analysis (primary doesn't support vision)`);
+                logger_js_1.logger.debug(`[Hybrid] Using ${this.fallback.name} for vision analysis (primary doesn't support vision)`);
                 if (!this.fallback.analyzeImage) {
                     throw new provider_interface_js_1.UnsupportedCapabilityError(this.name, 'vision');
                 }
@@ -242,8 +251,7 @@ class HybridProvider {
         }
         // Try primary first
         if (this.primary.analyzeImage) {
-            // eslint-disable-next-line no-console
-            console.log(`[Hybrid] Using ${this.primary.name} for vision analysis`);
+            logger_js_1.logger.debug(`[Hybrid] Using ${this.primary.name} for vision analysis`);
             return await this.primary.analyzeImage(images, prompt, options);
         }
         throw new provider_interface_js_1.UnsupportedCapabilityError(this.name, 'vision');
@@ -253,8 +261,7 @@ class HybridProvider {
         if (!this.primary.streamText) {
             throw new provider_interface_js_1.UnsupportedCapabilityError(this.primary.name, 'streaming');
         }
-        // eslint-disable-next-line no-console
-        console.log(`[Hybrid] Using ${this.primary.name} for streaming`);
+        logger_js_1.logger.debug(`[Hybrid] Using ${this.primary.name} for streaming`);
         yield* this.primary.streamText(prompt, options);
     }
     getUsageStats() {

package/dist/training/enricher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"enricher.d.ts","sourceRoot":"","sources":["../../src/training/enricher.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,0BAA0B,CAAC;AAC1D,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,gCAAgC,CAAC;AAGhE,OAAO,KAAK,EAAC,gBAAgB,EAAE,aAAa,EAAC,MAAM,YAAY,CAAC;AAkLhE,MAAM,WAAW,aAAa;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,aAAa,EAAE,CAmBlE;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,EAAE,CAwBrE;AAkCD,wBAAsB,cAAc,CAChC,QAAQ,EAAE,WAAW,EAAE,EACvB,OAAO,EAAE,aAAa,EAAE,EACxB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,WAAW,EACrB,SAAS,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,gBAAgB,CAAC,CAuF3B"}
+{"version":3,"file":"enricher.d.ts","sourceRoot":"","sources":["../../src/training/enricher.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,0BAA0B,CAAC;AAC1D,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,gCAAgC,CAAC;AAGhE,OAAO,KAAK,EAAC,gBAAgB,EAAE,aAAa,EAAC,MAAM,YAAY,CAAC;AAkLhE,MAAM,WAAW,aAAa;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,aAAa,EAAE,CAmBlE;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,EAAE,CAwBrE;AAkCD,wBAAsB,cAAc,CAChC,QAAQ,EAAE,WAAW,EAAE,EACvB,OAAO,EAAE,aAAa,EAAE,EACxB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,WAAW,EACrB,SAAS,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,gBAAgB,CAAC,CAuF3B"}

package/dist/training/enricher.js

@@ -7,6 +7,7 @@ exports.parseEnrichResponse = parseEnrichResponse;
 exports.enrichFamilies = enrichFamilies;
 const fs_1 = require("fs");
 const path_1 = require("path");
+const logger_js_1 = require("../logger.js");
 const types_js_1 = require("./types.js");
 const MAX_FILES_PER_FAMILY = 20;
 const MAX_LINES_PER_FILE = 50;
@@ -294,11 +295,11 @@ async function enrichFamilies(families, scanned, projectRoot, provider, budgetUS
             // Truncate at the last complete section boundary to avoid malformed input
             const lastSectionEnd = prompt.lastIndexOf('\n---\n', MAX_PROMPT_CHARS);
             if (lastSectionEnd > 0) {
-                console.warn(`[train] Prompt truncated from ${prompt.length} chars at section boundary`);
+                logger_js_1.logger.warn(`[train] Prompt truncated from ${prompt.length} chars at section boundary`);
                 prompt = prompt.slice(0, lastSectionEnd);
             }
             else {
-                console.warn(`[train] Prompt truncated from ${prompt.length} to ${MAX_PROMPT_CHARS} chars`);
+                logger_js_1.logger.warn(`[train] Prompt truncated from ${prompt.length} to ${MAX_PROMPT_CHARS} chars`);
                 prompt = prompt.slice(0, MAX_PROMPT_CHARS);
             }
         }
@@ -330,7 +331,7 @@ async function enrichFamilies(families, scanned, projectRoot, provider, budgetUS
         }
         catch (error) {
             // On LLM failure, keep families unchanged
-            console.warn(`[train] LLM enrichment failed for chunk: ${error instanceof Error ? error.message : String(error)}`);
+            logger_js_1.logger.warn(`[train] LLM enrichment failed for chunk: ${error instanceof Error ? error.message : String(error)}`);
             enriched.push(...chunk);
         }
         finally {

package/dist/training/validator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../src/training/validator.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAC,mBAAmB,EAAC,MAAM,gCAAgC,CAAC;AAExE,OAAO,KAAK,EAAC,gBAAgB,EAAE,gBAAgB,EAAC,MAAM,YAAY,CAAC;AAoBnE;;;GAGG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CA6BrD;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAC,CAAC,CA6BhG;AAED,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAC,CAAC,CAgB1H;AA+CD,wBAAgB,cAAc,CAC1B,QAAQ,EAAE,mBAAmB,EAC7B,KAAK,EAAE,MAAM,EAAE,EACf,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,YAAY,CAAC,EAAE,MAAM,EAAE,GACxB,gBAAgB,CA+BlB;AAED,wBAAgB,qBAAqB,CACjC,OAAO,EAAE,gBAAgB,EAAE,EAC3B,QAAQ,EAAE,mBAAmB,GAC9B,gBAAgB,CAkDlB;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAgCvE"}
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../src/training/validator.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAC,mBAAmB,EAAC,MAAM,gCAAgC,CAAC;AAExE,OAAO,KAAK,EAAC,gBAAgB,EAAE,gBAAgB,EAAC,MAAM,YAAY,CAAC;AAoBnE;;;GAGG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CA6BrD;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAC,CAAC,CA6BhG;AAED,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAC,CAAC,CAgB1H;AA+CD,wBAAgB,cAAc,CAC1B,QAAQ,EAAE,mBAAmB,EAC7B,KAAK,EAAE,MAAM,EAAE,EACf,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,YAAY,CAAC,EAAE,MAAM,EAAE,GACxB,gBAAgB,CA+BlB;AAED,wBAAgB,qBAAqB,CACjC,OAAO,EAAE,gBAAgB,EAAE,EAC3B,QAAQ,EAAE,mBAAmB,GAC9B,gBAAgB,CAkDlB;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAgCvE"}

package/dist/training/validator.js

@@ -10,6 +10,7 @@ exports.buildValidationReport = buildValidationReport;
 exports.formatValidationReport = formatValidationReport;
 const child_process_1 = require("child_process");
 const path_1 = require("path");
+const logger_js_1 = require("../logger.js");
 const route_families_js_1 = require("../knowledge/route_families.js");
 /**
  * Glob-style patterns for infrastructure / cross-cutting files that will never
@@ -111,7 +112,7 @@ function getCommitFiles(projectRoot, since) {
         });
     }
     catch (error) {
-        console.warn(`[train] git log failed: ${error instanceof Error ? error.message : String(error)}`);
+        logger_js_1.logger.warn(`[train] git log failed: ${error instanceof Error ? error.message : String(error)}`);
         return [];
     }
     return parseGitLog(log);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yasserkhanorg/e2e-agents",
-  "version": "1.8.0",
+  "version": "1.8.2",
   "description": "AI-powered E2E test impact analysis, generation, and healing. Analyzes code changes to identify affected Playwright tests, detects coverage gaps, and generates or repairs specs using pluggable LLM providers (Claude, OpenAI, Ollama). Includes MCP server, traceability, and CI/CD integration.",
   "main": "dist/index.js",
   "module": "dist/esm/index.js",
@@ -28,7 +28,8 @@
   },
   "bin": {
     "e2e-ai-agents": "./dist/cli.js",
-    "e2e-qa-agent": "./dist/qa-agent/cli.js"
+    "e2e-qa-agent": "./dist/qa-agent/cli.js",
+    "e2e-agents-mcp": "./dist/mcp-server.js"
   },
   "files": [
     "dist",
@@ -38,7 +39,7 @@
   ],
   "scripts": {
     "build": "npm run build:cjs && npm run build:esm",
-    "postbuild": "chmod +x dist/cli.js dist/qa-agent/cli.js",
+    "postbuild": "chmod +x dist/cli.js dist/qa-agent/cli.js dist/mcp-server.js",
     "build:cjs": "tsc -p tsconfig.json",
     "build:esm": "tsc -p tsconfig.esm.json && node scripts/write-esm-package.js",
     "clean": "rm -rf dist",

package/schemas/plan.schema.json

@@ -280,6 +280,68 @@
       },
       "additionalProperties": false
     },
+    "crew": {
+      "type": "object",
+      "required": [
+        "workflow",
+        "providerOverride",
+        "summary",
+        "impactedFlows",
+        "strategyEntries",
+        "testDesigns",
+        "crossImpacts",
+        "regressionRisks",
+        "findings",
+        "warnings",
+        "timings"
+      ],
+      "properties": {
+        "workflow": {"type": "string"},
+        "providerOverride": {"type": "string"},
+        "summary": {
+          "type": "object",
+          "required": [
+            "impactedFlows",
+            "strategyEntries",
+            "testDesigns",
+            "crossImpacts",
+            "highRiskCrossImpacts",
+            "regressionRisks",
+            "findings",
+            "generatedSpecs",
+            "manualReviewEntries",
+            "totalCostUSD",
+            "totalTokens"
+          ],
+          "properties": {
+            "impactedFlows": {"type": "number"},
+            "strategyEntries": {"type": "number"},
+            "testDesigns": {"type": "number"},
+            "crossImpacts": {"type": "number"},
+            "highRiskCrossImpacts": {"type": "number"},
+            "regressionRisks": {"type": "number"},
+            "findings": {"type": "number"},
+            "generatedSpecs": {"type": "number"},
+            "manualReviewEntries": {"type": "number"},
+            "totalCostUSD": {"type": "number"},
+            "totalTokens": {"type": "number"}
+          },
+          "additionalProperties": false
+        },
+        "impactedFlows": {"type": "array", "items": {"$ref": "#/$defs/flowDecision"}},
+        "strategyEntries": {"type": "array", "items": {"$ref": "#/$defs/strategyEntry"}},
+        "testDesigns": {"type": "array", "items": {"$ref": "#/$defs/testDesign"}},
+        "crossImpacts": {"type": "array", "items": {"$ref": "#/$defs/crossImpact"}},
+        "regressionRisks": {"type": "array", "items": {"$ref": "#/$defs/regressionRisk"}},
+        "findings": {"type": "array", "items": {"$ref": "#/$defs/finding"}},
+        "warnings": {"type": "array", "items": {"type": "string"}},
+        "timings": {
+          "type": "object",
+          "additionalProperties": {"type": "number"}
+        }
+      },
+      "additionalProperties": false
+    },
     "metrics": {
       "type": "object",
       "required": [
@@ -327,6 +389,102 @@
         "details": {"type": "string"}
       },
       "additionalProperties": false
+    },
+    "flowDecision": {
+      "type": "object",
+      "required": ["flowId", "flowName", "routeFamily", "changedFiles", "evidence", "evidenceSource", "confidence", "existingSpecs", "action", "priority"],
+      "properties": {
+        "flowId": {"type": "string"},
+        "flowName": {"type": "string"},
+        "routeFamily": {"type": "string"},
+        "changedFiles": {"type": "array", "items": {"type": "string"}},
+        "evidence": {"type": "string"},
+        "evidenceSource": {"enum": ["deterministic", "ai", "hybrid"]},
+        "confidence": {"type": "number"},
+        "existingSpecs": {"type": "array", "items": {"type": "string"}},
+        "action": {"enum": ["create_spec", "update_spec", "skip"]},
+        "priority": {"enum": ["P0", "P1", "P2"]},
+        "userActions": {"type": "array", "items": {"type": "string"}}
+      },
+      "additionalProperties": true
+    },
+    "strategyEntry": {
+      "type": "object",
+      "required": ["flowId", "flowName", "priority", "approach", "rationale", "testCategories", "crossImpactRisk"],
+      "properties": {
+        "flowId": {"type": "string"},
+        "flowName": {"type": "string"},
+        "priority": {"enum": ["P0", "P1", "P2"]},
+        "approach": {"enum": ["full-test", "smoke-test", "skip", "manual-review"]},
+        "rationale": {"type": "string"},
+        "testCategories": {"type": "array", "items": {"type": "string"}},
+        "crossImpactRisk": {"enum": ["high", "medium", "low", "none"]}
+      },
+      "additionalProperties": false
+    },
+    "testDesign": {
+      "type": "object",
+      "required": ["flowId", "flowName", "testCases"],
+      "properties": {
+        "flowId": {"type": "string"},
+        "flowName": {"type": "string"},
+        "testCases": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": ["name", "type", "preconditions", "steps", "expectedOutcome", "priority", "rationale"],
+            "properties": {
+              "name": {"type": "string"},
+              "type": {"enum": ["happy-path", "edge-case", "boundary", "negative", "state-transition", "race-condition", "permission", "accessibility", "performance"]},
+              "preconditions": {"type": "array", "items": {"type": "string"}},
+              "steps": {"type": "array", "items": {"type": "string"}},
+              "expectedOutcome": {"type": "string"},
+              "priority": {"enum": ["P0", "P1", "P2"]},
+              "rationale": {"type": "string"}
+            },
+            "additionalProperties": false
+          }
+        }
+      },
+      "additionalProperties": false
+    },
+    "crossImpact": {
+      "type": "object",
+      "required": ["sourceFamily", "affectedFamily", "sharedDependency", "riskLevel", "evidence"],
+      "properties": {
+        "sourceFamily": {"type": "string"},
+        "affectedFamily": {"type": "string"},
+        "sharedDependency": {"type": "string"},
+        "riskLevel": {"enum": ["high", "medium", "low"]},
+        "evidence": {"type": "string"}
+      },
+      "additionalProperties": false
+    },
+    "regressionRisk": {
+      "type": "object",
+      "required": ["familyId", "filePattern", "riskScore", "reason", "historicalFailures"],
+      "properties": {
+        "familyId": {"type": "string"},
+        "filePattern": {"type": "string"},
+        "riskScore": {"type": "number"},
+        "reason": {"type": "string"},
+        "historicalFailures": {"type": "number"}
+      },
+      "additionalProperties": false
+    },
+    "finding": {
+      "type": "object",
+      "required": ["id", "type", "severity", "source", "summary", "details", "relatedFlows"],
+      "properties": {
+        "id": {"type": "string"},
+        "type": {"enum": ["bug", "gap", "risk", "flaky"]},
+        "severity": {"enum": ["critical", "high", "medium", "low"]},
+        "source": {"enum": ["strategist", "test-designer", "cross-impact", "regression-advisor", "impact-analyst", "coverage-evaluator", "generator", "executor", "healer", "explorer"]},
+        "summary": {"type": "string"},
+        "details": {"type": "string"},
+        "relatedFlows": {"type": "array", "items": {"type": "string"}}
+      },
+      "additionalProperties": false
     }
   },
   "additionalProperties": false