@yasserkhanorg/e2e-agents 1.8.1 → 1.8.2

package/dist/esm/cli/commands/plan_crew.js

@@ -0,0 +1,143 @@
+// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
+// See LICENSE.txt for license information.
+import { mkdirSync, writeFileSync } from 'fs';
+import { join } from 'path';
+import { CrossImpactAgent } from '../../agents/cross-impact.js';
+import { ImpactAnalystAgent } from '../../agents/impact-analyst.js';
+import { RegressionAdvisorAgent } from '../../agents/regression-advisor.js';
+import { StrategistAgent } from '../../agents/strategist.js';
+import { TestDesignerAgent } from '../../agents/test-designer.js';
+import { CrewOrchestrator } from '../../crew/orchestrator.js';
+const VALID_WORKFLOWS = new Set(['full-qa', 'quick-check', 'design-only']);
+function uniqueStrings(values) {
+    return Array.from(new Set(values.filter(Boolean)));
+}
+function singleLine(value) {
+    return value.replace(/\s+/g, ' ').trim();
+}
+function chooseCrewWorkflow(explicitWorkflow, plan) {
+    if (explicitWorkflow && VALID_WORKFLOWS.has(explicitWorkflow)) {
+        return explicitWorkflow;
+    }
+    if (plan.decision.action === 'must-add-tests' || plan.metrics.uncoveredP0P1Flows > 0) {
+        return 'design-only';
+    }
+    return 'quick-check';
+}
+function registerCrewAgents(orchestrator) {
+    orchestrator.registerAgent(new ImpactAnalystAgent());
+    orchestrator.registerAgent(new StrategistAgent());
+    orchestrator.registerAgent(new TestDesignerAgent());
+    orchestrator.registerAgent(new CrossImpactAgent());
+    orchestrator.registerAgent(new RegressionAdvisorAgent());
+}
+export async function runPlanCrewAnalysis(plan, config, args) {
+    const reportRoot = config.testsRoot || config.path;
+    const workflow = chooseCrewWorkflow(args.crewWorkflow, plan);
+    const normalizedProvider = config.llm.provider?.trim().toLowerCase();
+    const providerOverride = normalizedProvider && normalizedProvider !== 'auto' ? normalizedProvider : 'auto';
+    const orchestrator = new CrewOrchestrator();
+    registerCrewAgents(orchestrator);
+    const result = await orchestrator.run({
+        appPath: config.path,
+        testsRoot: reportRoot,
+        gitSince: args.gitSince || config.git.since,
+        routeFamilies: config.routeFamilies,
+        apiSurface: config.apiSurface,
+        workflow,
+        providerOverride: providerOverride === 'auto' ? undefined : providerOverride,
+        budgetUSD: args.budgetUSD,
+        dryRun: args.dryRun,
+    });
+    const ctx = result.context;
+    const highRiskCrossImpacts = ctx.crossImpacts.filter((entry) => entry.riskLevel === 'high');
+    const manualReviewEntries = ctx.strategyEntries.filter((entry) => entry.approach === 'manual-review');
+    return {
+        workflow,
+        providerOverride,
+        summary: {
+            impactedFlows: ctx.impactedFlows.length,
+            strategyEntries: ctx.strategyEntries.length,
+            testDesigns: ctx.testDesigns.length,
+            crossImpacts: ctx.crossImpacts.length,
+            highRiskCrossImpacts: highRiskCrossImpacts.length,
+            regressionRisks: ctx.regressionRisks.length,
+            findings: ctx.findings.length,
+            generatedSpecs: ctx.generatedSpecs.length,
+            manualReviewEntries: manualReviewEntries.length,
+            totalCostUSD: Number(ctx.usage.totalCost.toFixed(4)),
+            totalTokens: ctx.usage.totalTokens,
+        },
+        impactedFlows: ctx.impactedFlows,
+        strategyEntries: ctx.strategyEntries,
+        testDesigns: ctx.testDesigns,
+        crossImpacts: ctx.crossImpacts,
+        regressionRisks: ctx.regressionRisks,
+        findings: ctx.findings,
+        warnings: uniqueStrings([...ctx.warnings, ...result.warnings]),
+        timings: result.timings,
+    };
+}
+export function buildCrewMarkdown(crew) {
+    const lines = [
+        '### Crew Insights',
+        '',
+        `Workflow: \`${crew.workflow}\``,
+        `Provider override: \`${crew.providerOverride}\``,
+        `Impacted flows: **${crew.summary.impactedFlows}**`,
+        `Strategy entries: **${crew.summary.strategyEntries}**`,
+        `Structured test designs: **${crew.summary.testDesigns}**`,
+        `Cross-impacts: **${crew.summary.crossImpacts}** (${crew.summary.highRiskCrossImpacts} high risk)`,
+        `Findings: **${crew.summary.findings}**`,
+        `Estimated AI cost: **$${crew.summary.totalCostUSD.toFixed(4)}**`,
+    ];
+    if (crew.strategyEntries.length > 0) {
+        lines.push('');
+        lines.push('Top Strategy Recommendations:');
+        for (const entry of crew.strategyEntries.slice(0, 5)) {
+            lines.push(`- ${entry.priority} ${entry.flowName} -> ${entry.approach} (${entry.crossImpactRisk} cross-impact risk)`);
+        }
+    }
+    if (crew.testDesigns.length > 0) {
+        lines.push('');
+        lines.push('Structured Test Designs:');
+        for (const design of crew.testDesigns.slice(0, 3)) {
+            lines.push(`- ${design.flowName}: ${design.testCases.length} designed test case(s)`);
+        }
+    }
+    const riskyCrossImpacts = crew.crossImpacts.filter((entry) => entry.riskLevel === 'high');
+    if (riskyCrossImpacts.length > 0) {
+        lines.push('');
+        lines.push('High-Risk Cross-Impacts:');
+        for (const entry of riskyCrossImpacts.slice(0, 5)) {
+            lines.push(`- ${entry.sourceFamily} -> ${entry.affectedFamily}: ${entry.sharedDependency}`);
+        }
+    }
+    if (crew.findings.length > 0) {
+        lines.push('');
+        lines.push('Crew Findings:');
+        for (const finding of crew.findings.slice(0, 5)) {
+            lines.push(`- ${finding.severity} ${finding.type}: ${finding.summary}`);
+        }
+    }
+    if (crew.warnings.length > 0) {
+        lines.push('');
+        lines.push('Crew Warnings:');
+        for (const warning of crew.warnings.slice(0, 5)) {
+            lines.push(`- ${singleLine(warning)}`);
+        }
+    }
+    return lines.join('\n');
+}
+export function appendCrewToSummary(baseMarkdown, crew) {
+    return `${baseMarkdown}\n\n---\n\n${buildCrewMarkdown(crew)}`;
+}
+export function writeCrewArtifacts(reportRoot, crew) {
+    const outputDir = join(reportRoot, '.e2e-ai-agents');
+    mkdirSync(outputDir, { recursive: true });
+    const crewSummaryPath = join(outputDir, 'crew-summary.json');
+    const crewMarkdownPath = join(outputDir, 'crew-summary.md');
+    writeFileSync(crewSummaryPath, JSON.stringify(crew, null, 2), 'utf-8');
+    writeFileSync(crewMarkdownPath, buildCrewMarkdown(crew), 'utf-8');
+    return { crewSummaryPath, crewMarkdownPath };
+}

package/dist/esm/cli/parse_args.js

@@ -56,6 +56,7 @@ const FLAGS = {
     '--pipeline-parallel': { key: 'pipelineParallel', type: 'boolean' },
     '--pipeline-dry-run': { key: 'pipelineDryRun', type: 'boolean' },
     '--fail-on-must-add-tests': { key: 'failOnMustAddTests', type: 'boolean' },
+    '--crew': { key: 'crew', type: 'boolean' },
     '--create-pr': { key: 'createPr', type: 'boolean' },
     '--dry-run': { key: 'dryRun', type: 'boolean' },
     '--generate': { key: 'analyzeGenerate', type: 'boolean' },
@@ -99,6 +100,7 @@ const FLAGS = {
     '--output': { key: 'trainOutput', type: 'string' },
     '--server-path': { key: 'serverPath', type: 'string' },
     '--workflow': { key: 'crewWorkflow', type: 'string' },
+    '--crew-workflow': { key: 'crewWorkflow', type: 'string' },
     // -- number flags (with isFinite guard) --
     '--pipeline-scenarios': { key: 'pipelineScenarios', type: 'number' },
     '--time': { key: 'timeLimitMinutes', type: 'number' },

package/dist/esm/cli/usage.js

@@ -56,6 +56,8 @@ export function printUsage() {
         '  --policy-risky-patterns <globs>     Comma-separated risky file globs',
         '  --policy-enforcement-mode <mode>    advisory | warn | block',
         '  --policy-block-actions <actions>    Comma-separated CI actions to block/warn',
+        '  --crew                               Run Crew enrichment and attach insights to plan output',
+        '  --crew-workflow <name>               full-qa | quick-check | design-only',
         '  --ci-comment-path <path>            Write CI markdown summary',
         '  --github-output <path>              Write GitHub Actions outputs',
         '  --fail-on-must-add-tests            Exit non-zero on must-add-tests decision',

package/dist/esm/mcp-server.js

@@ -1,3 +1,4 @@
+#!/usr/bin/env node
 // Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
 // See LICENSE.txt for license information.
 /**
@@ -6,7 +7,7 @@
  */
 import { spawnSync } from 'child_process';
 import { readFileSync, writeFileSync, existsSync, realpathSync } from 'fs';
-import { resolve } from 'path';
+import { join, resolve, dirname } from 'path';
 import { globSync } from 'glob';
 /**
  * SECURITY: Path validation helper
@@ -471,12 +472,152 @@ export class 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 = join(dirname(__dirname), 'package.json');
+        const pkg = JSON.parse(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.
+ */
+export 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.
+ */
+export 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.
+ */
+export 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.
+ */
+export 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();
 }
 export default E2EAgentsMCPServer;

package/dist/esm/provider_factory.js

@@ -141,6 +141,17 @@ export 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/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/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.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",