@yasserkhanorg/e2e-agents 1.8.1 → 1.8.3

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/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":"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;;;;;;;;;;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"}
+{"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

@@ -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
      *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yasserkhanorg/e2e-agents",
-  "version": "1.8.1",
+  "version": "1.8.3",
   "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