@yasserkhanorg/e2e-agents 1.8.0 → 1.8.2

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

@@ -1,9 +1,10 @@
 // Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
 // See LICENSE.txt for license information.
-import { appendFileSync } from 'fs';
+import { appendFileSync, writeFileSync } from 'fs';
 import { join } from 'path';
 import { writeCiSummary } from '../../engine/plan_builder.js';
 import { recommendTestsAI, recommendTestsDeterministic } from '../../api.js';
+import { appendCrewToSummary, runPlanCrewAnalysis, writeCrewArtifacts } from './plan_crew.js';
 export async function runPlanCommand(args, autoConfig, config) {
     const reportRoot = config.testsRoot || config.path;
     const apiOptions = {
@@ -40,41 +41,73 @@ export async function runPlanCommand(args, autoConfig, config) {
             const { aiEnrichment } = result;
             console.log(`AI enrichment: ${aiEnrichment.enrichedFeatures.length} features enriched (${aiEnrichment.tokenUsage.input + aiEnrichment.tokenUsage.output} tokens)`);
         }
-        else if (!process.env.ANTHROPIC_API_KEY) {
-            console.log('Tip: set ANTHROPIC_API_KEY to enable AI-powered enrichment');
+        else if (!process.env.ANTHROPIC_API_KEY && !process.env.OPENAI_API_KEY && !process.env.LLM_PROVIDER) {
+            console.log('Tip: configure ANTHROPIC_API_KEY, OPENAI_API_KEY, or LLM_PROVIDER to enable AI-powered enrichment');
         }
     }
     const { plan, planPath, ciSummaryMarkdown, ciSummaryPath } = result;
-    // Write CI summary to an additional path if --ci-comment-path was specified
-    if (args.ciCommentPath) {
-        writeCiSummary(reportRoot, ciSummaryMarkdown, args.ciCommentPath);
+    let planReport = plan;
+    let combinedSummaryMarkdown = ciSummaryMarkdown;
+    let crewSummaryPath = '';
+    let crewMarkdownPath = '';
+    if (args.crew) {
+        try {
+            const crew = await runPlanCrewAnalysis(plan, config, args);
+            planReport = {
+                ...plan,
+                crew,
+            };
+            combinedSummaryMarkdown = appendCrewToSummary(ciSummaryMarkdown, crew);
+            const artifacts = writeCrewArtifacts(reportRoot, crew);
+            crewSummaryPath = artifacts.crewSummaryPath;
+            crewMarkdownPath = artifacts.crewMarkdownPath;
+            writeFileSync(planPath, JSON.stringify(planReport, null, 2), 'utf-8');
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            console.warn(`Crew analysis unavailable: ${message}`);
+        }
     }
-    const summaryPath = ciSummaryPath;
+    writeCiSummary(reportRoot, combinedSummaryMarkdown);
+    const summaryPath = args.ciCommentPath
+        ? writeCiSummary(reportRoot, combinedSummaryMarkdown, args.ciCommentPath)
+        : ciSummaryPath;
     // Compute metrics paths (api already wrote metrics; derive paths for GHA output)
     const metricsEventsPath = join(reportRoot, '.e2e-ai-agents/metrics.jsonl');
     const metricsSummaryPath = join(reportRoot, '.e2e-ai-agents/metrics-summary.json');
     const ghaOutput = args.githubOutputPath || process.env.GITHUB_OUTPUT;
     if (ghaOutput) {
-        appendFileSync(ghaOutput, `run_set=${plan.runSet}\n`);
-        appendFileSync(ghaOutput, `action=${plan.decision.action}\n`);
-        appendFileSync(ghaOutput, `confidence=${plan.confidence}\n`);
-        appendFileSync(ghaOutput, `enforcement_mode=${plan.enforcement.mode}\n`);
-        appendFileSync(ghaOutput, `enforcement_should_fail=${plan.enforcement.shouldFail}\n`);
-        appendFileSync(ghaOutput, `recommended_tests_count=${plan.recommendedTests.length}\n`);
-        appendFileSync(ghaOutput, `required_new_tests_count=${plan.requiredNewTests.length}\n`);
+        appendFileSync(ghaOutput, `run_set=${planReport.runSet}\n`);
+        appendFileSync(ghaOutput, `action=${planReport.decision.action}\n`);
+        appendFileSync(ghaOutput, `confidence=${planReport.confidence}\n`);
+        appendFileSync(ghaOutput, `enforcement_mode=${planReport.enforcement.mode}\n`);
+        appendFileSync(ghaOutput, `enforcement_should_fail=${planReport.enforcement.shouldFail}\n`);
+        appendFileSync(ghaOutput, `recommended_tests_count=${planReport.recommendedTests.length}\n`);
+        appendFileSync(ghaOutput, `required_new_tests_count=${planReport.requiredNewTests.length}\n`);
         appendFileSync(ghaOutput, `plan_path=${planPath}\n`);
         appendFileSync(ghaOutput, `summary_path=${summaryPath}\n`);
         appendFileSync(ghaOutput, `metrics_events_path=${metricsEventsPath}\n`);
         appendFileSync(ghaOutput, `metrics_summary_path=${metricsSummaryPath}\n`);
+        appendFileSync(ghaOutput, `crew_enabled=${planReport.crew ? 'true' : 'false'}\n`);
+        appendFileSync(ghaOutput, `crew_workflow=${planReport.crew?.workflow || ''}\n`);
+        appendFileSync(ghaOutput, `crew_summary_path=${crewSummaryPath}\n`);
+        appendFileSync(ghaOutput, `crew_markdown_path=${crewMarkdownPath}\n`);
+        appendFileSync(ghaOutput, `crew_impacted_flows=${planReport.crew?.summary.impactedFlows || 0}\n`);
+        appendFileSync(ghaOutput, `crew_strategy_entries=${planReport.crew?.summary.strategyEntries || 0}\n`);
+        appendFileSync(ghaOutput, `crew_test_designs=${planReport.crew?.summary.testDesigns || 0}\n`);
     }
-    console.log(`Suggested run set: ${plan.runSet} (confidence ${plan.confidence})`);
-    console.log(`Decision: ${plan.decision.action} - ${plan.decision.summary}`);
-    console.log(`Enforcement: ${plan.enforcement.mode} (shouldFail=${plan.enforcement.shouldFail})`);
+    console.log(`Suggested run set: ${planReport.runSet} (confidence ${planReport.confidence})`);
+    console.log(`Decision: ${planReport.decision.action} - ${planReport.decision.summary}`);
+    console.log(`Enforcement: ${planReport.enforcement.mode} (shouldFail=${planReport.enforcement.shouldFail})`);
     console.log(`Plan data: ${planPath}`);
     console.log(`CI summary: ${summaryPath}`);
+    if (planReport.crew) {
+        console.log(`Crew workflow: ${planReport.crew.workflow} (impactedFlows=${planReport.crew.summary.impactedFlows}, strategyEntries=${planReport.crew.summary.strategyEntries}, testDesigns=${planReport.crew.summary.testDesigns})`);
+        console.log(`Crew summary: ${crewSummaryPath}`);
+    }
     console.log(`Plan metrics: ${metricsSummaryPath}`);
-    const failOnLegacyFlag = args.failOnMustAddTests && plan.decision.action === 'must-add-tests';
-    if (failOnLegacyFlag || plan.enforcement.shouldFail) {
+    const failOnLegacyFlag = args.failOnMustAddTests && planReport.decision.action === 'must-add-tests';
+    if (failOnLegacyFlag || planReport.enforcement.shouldFail) {
         process.exit(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/knowledge/route_families.js

@@ -2,6 +2,7 @@
 // See LICENSE.txt for license information.
 import { existsSync, readFileSync, statSync } from 'fs';
 import { join } from 'path';
+import { logger } from '../logger.js';
 const manifestCache = new Map();
 export function matchesGlob(filePath, pattern) {
     const normalized = filePath.replace(/\\/g, '/');
@@ -154,8 +155,7 @@ export function loadRouteFamilyManifest(testsRoot, config) {
         }
     }
     if (config?.strict) {
-        // eslint-disable-next-line no-console
-        console.warn('[e2e-agents] Route family manifest not found. The manifest is optional context for AI enrichment — create .e2e-ai-agents/route-families.json to enable family-level routing hints.');
+        logger.warn('Route family manifest not found. Create .e2e-ai-agents/route-families.json to enable family-level routing hints.');
     }
     return null;
 }

package/dist/esm/logger.js

@@ -1,8 +1,7 @@
 // Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
 // See LICENSE.txt for license information.
 /**
- * Simple structured logging system
- * Replaces 18 console.log statements with configurable logging
+ * Structured logging system.
  * Environment variable: LOG_LEVEL (ERROR, WARN, INFO, DEBUG)
  */
 export var LogLevel;

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/ollama_provider.js

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

package/dist/esm/provider_factory.js

@@ -1,6 +1,7 @@
 // Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
 // See LICENSE.txt for license information.
 import { AnthropicProvider } from './anthropic_provider.js';
+import { logger } from './logger.js';
 import { CustomProvider } from './custom_provider.js';
 import { OllamaProvider } from './ollama_provider.js';
 import { OpenAIProvider } from './openai_provider.js';
@@ -131,8 +132,7 @@ export class LLMProviderFactory {
         const ollama = new OllamaProvider({});
         const health = await ollama.checkHealth();
         if (health.healthy) {
-            // eslint-disable-next-line no-console
-            console.log('Auto-detected Ollama provider (free, local)');
+            logger.info('Auto-detected Ollama provider (free, local)');
             return ollama;
         }
         throw new Error('No LLM provider available. Please either:\n' +
@@ -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
      *
@@ -218,8 +229,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.debug(`[Hybrid] Using ${this.primary.name} for text generation`);
         return await this.primary.generateText(prompt, options);
     }
     async analyzeImage(images, prompt, options) {
@@ -227,8 +237,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.debug(`[Hybrid] Using ${this.fallback.name} for vision analysis (primary doesn't support vision)`);
                 if (!this.fallback.analyzeImage) {
                     throw new UnsupportedCapabilityError(this.name, 'vision');
                 }
@@ -237,8 +246,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.debug(`[Hybrid] Using ${this.primary.name} for vision analysis`);
             return await this.primary.analyzeImage(images, prompt, options);
         }
         throw new UnsupportedCapabilityError(this.name, 'vision');
@@ -248,8 +256,7 @@ class HybridProvider {
         if (!this.primary.streamText) {
             throw new UnsupportedCapabilityError(this.primary.name, 'streaming');
         }
-        // eslint-disable-next-line no-console
-        console.log(`[Hybrid] Using ${this.primary.name} for streaming`);
+        logger.debug(`[Hybrid] Using ${this.primary.name} for streaming`);
         yield* this.primary.streamText(prompt, options);
     }
     getUsageStats() {

package/dist/esm/training/enricher.js

@@ -2,6 +2,7 @@
 // See LICENSE.txt for license information.
 import { lstatSync, readdirSync, readFileSync } from 'fs';
 import { join, relative, resolve } from 'path';
+import { logger } from '../logger.js';
 import { isGuessedRoute } from './types.js';
 const MAX_FILES_PER_FAMILY = 20;
 const MAX_LINES_PER_FILE = 50;
@@ -289,11 +290,11 @@ export async function enrichFamilies(families, scanned, projectRoot, provider, b
             // 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.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.warn(`[train] Prompt truncated from ${prompt.length} to ${MAX_PROMPT_CHARS} chars`);
                 prompt = prompt.slice(0, MAX_PROMPT_CHARS);
             }
         }
@@ -325,7 +326,7 @@ export async function enrichFamilies(families, scanned, projectRoot, provider, b
         }
         catch (error) {
             // On LLM failure, keep families unchanged
-            console.warn(`[train] LLM enrichment failed for chunk: ${error instanceof Error ? error.message : String(error)}`);
+            logger.warn(`[train] LLM enrichment failed for chunk: ${error instanceof Error ? error.message : String(error)}`);
             enriched.push(...chunk);
         }
         finally {

package/dist/esm/training/validator.js

@@ -2,6 +2,7 @@
 // See LICENSE.txt for license information.
 import { execFileSync } from 'child_process';
 import { resolve } from 'path';
+import { logger } from '../logger.js';
 import { bindFilesToFamilies } from '../knowledge/route_families.js';
 /**
  * Glob-style patterns for infrastructure / cross-cutting files that will never
@@ -103,7 +104,7 @@ export function getCommitFiles(projectRoot, since) {
         });
     }
     catch (error) {
-        console.warn(`[train] git log failed: ${error instanceof Error ? error.message : String(error)}`);
+        logger.warn(`[train] git log failed: ${error instanceof Error ? error.message : String(error)}`);
         return [];
     }
     return parseGitLog(log);

package/dist/knowledge/route_families.d.ts.map

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

package/dist/knowledge/route_families.js

@@ -16,6 +16,7 @@ exports.getRoutesForBinding = getRoutesForBinding;
 exports.clearManifestCache = clearManifestCache;
 const fs_1 = require("fs");
 const path_1 = require("path");
+const logger_js_1 = require("../logger.js");
 const manifestCache = new Map();
 function matchesGlob(filePath, pattern) {
     const normalized = filePath.replace(/\\/g, '/');
@@ -168,8 +169,7 @@ function loadRouteFamilyManifest(testsRoot, config) {
         }
     }
     if (config?.strict) {
-        // eslint-disable-next-line no-console
-        console.warn('[e2e-agents] Route family manifest not found. The manifest is optional context for AI enrichment — create .e2e-ai-agents/route-families.json to enable family-level routing hints.');
+        logger_js_1.logger.warn('Route family manifest not found. Create .e2e-ai-agents/route-families.json to enable family-level routing hints.');
     }
     return null;
 }

package/dist/logger.d.ts

@@ -1,6 +1,5 @@
 /**
- * Simple structured logging system
- * Replaces 18 console.log statements with configurable logging
+ * Structured logging system.
  * Environment variable: LOG_LEVEL (ERROR, WARN, INFO, DEBUG)
  */
 export declare enum LogLevel {