@yasserkhanorg/e2e-agents 0.3.2 → 0.3.3

package/dist/agent/report.d.ts

@@ -67,6 +67,11 @@ export interface ReportData {
             error?: string;
         }>;
         warnings: string[];
+        mcp?: {
+            requested: boolean;
+            active: boolean;
+            backend: string;
+        };
     };
     applied?: {
         patchedFiles: string[];

package/dist/agent/report.d.ts.map

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

package/dist/agent/report.js

@@ -94,6 +94,9 @@ function writeReport(appRoot, config, data) {
         markdownLines.push('');
         markdownLines.push('Pipeline Results:');
         markdownLines.push(`- Runner: ${data.pipeline.runner}`);
+        if (data.pipeline.mcp) {
+            markdownLines.push(`- MCP: requested=${data.pipeline.mcp.requested} active=${data.pipeline.mcp.active} backend=${data.pipeline.mcp.backend}`);
+        }
         for (const result of data.pipeline.results) {
             const status = result.healStatus ? `${result.generateStatus}/${result.healStatus}` : result.generateStatus;
             markdownLines.push(`- ${result.flowId} (${result.flowName}): ${status} -> ${result.generatedDir}`);

package/dist/agent/runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/agent/runner.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,aAAa,CAAC;AA6M7C,MAAM,WAAW,UAAU;IACvB,KAAK,EAAE,OAAO,CAAC;CAClB;AAED,wBAAsB,SAAS,CAAC,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CA4LzF;AAED,wBAAsB,MAAM,CAAC,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CA4LtF"}
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/agent/runner.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,aAAa,CAAC;AAiN7C,MAAM,WAAW,UAAU;IACvB,KAAK,EAAE,OAAO,CAAC;CAClB;AAED,wBAAsB,SAAS,CAAC,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CA6LzF;AAED,wBAAsB,MAAM,CAAC,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CA0MtF"}

package/dist/agent/runner.js

@@ -21,6 +21,7 @@ const pipeline_js_1 = require("./pipeline.js");
 const gap_suggestions_js_1 = require("./gap_suggestions.js");
 const dependency_graph_js_1 = require("./dependency_graph.js");
 const traceability_js_1 = require("./traceability.js");
+const utils_js_1 = require("./utils.js");
 const PRIORITY_RANK = {
     P0: 0,
     P1: 1,
@@ -84,11 +85,14 @@ function buildRecommendedTestsWithFlags(flows, testsByFlow) {
         const tests = testsByFlow.get(flow.id) || [];
         const flagSummary = (0, flags_js_1.formatFlags)(flow.flags || []);
         for (const test of tests) {
-            if (!testNotes.has(test)) {
-                testNotes.set(test, new Set());
+            const normalizedTest = (0, utils_js_1.normalizePath)(test)
+                .replace(/^\.\//, '')
+                .replace(/^e2e-tests\/playwright\//, '');
+            if (!testNotes.has(normalizedTest)) {
+                testNotes.set(normalizedTest, new Set());
             }
             if (flagSummary !== 'none') {
-                testNotes.get(test)?.add(flagSummary);
+                testNotes.get(normalizedTest)?.add(flagSummary);
             }
         }
     }
@@ -213,7 +217,8 @@ async function runImpact(_config, _options) {
     if (changedFiles.length === 0 && !_config.impact.allowFallback) {
         throw new Error('No changed files detected. Provide --since or use gap mode (or --allow-fallback).');
     }
-    let analysisTargets = changedFiles.filter((file) => !(0, analysis_js_1.isTestFilePath)(file));
+    const changedAppFiles = changedFiles.filter((file) => !(0, analysis_js_1.isTestFilePath)(file));
+    let analysisTargets = [...changedAppFiles];
     if (analysisTargets.length === 0 && _config.impact.allowFallback) {
         warnings.push('No changed files detected. Falling back to repository scan for screens.');
         analysisTargets = (0, analysis_js_1.scanRepositoryFlows)(_config.path, 250, _config.flowDiscovery.patterns, _config.flowDiscovery.exclude);
@@ -379,7 +384,8 @@ async function runGap(_config, _options) {
     if (gitResult.error) {
         warnings.push(`Git diff failed: ${gitResult.error}`);
     }
-    let analysisTargets = changedFiles.filter((file) => !(0, analysis_js_1.isTestFilePath)(file));
+    const changedAppFiles = changedFiles.filter((file) => !(0, analysis_js_1.isTestFilePath)(file));
+    let analysisTargets = [...changedAppFiles];
     if (analysisTargets.length === 0) {
         analysisTargets = (0, analysis_js_1.scanRepositoryFlows)(_config.path, 250, _config.flowDiscovery.patterns, _config.flowDiscovery.exclude);
     }
@@ -414,7 +420,20 @@ async function runGap(_config, _options) {
     let traceabilityStats;
     if (catalog) {
         flowCatalogSource = catalog.source;
-        const mapping = (0, flow_mapping_js_1.mapChangesToCatalogFlows)(catalog, analysisTargets, 'gap', _config);
+        const catalogMode = changedAppFiles.length > 0 ? 'impact' : 'gap';
+        let mapping = (0, flow_mapping_js_1.mapChangesToCatalogFlows)(catalog, analysisTargets, catalogMode, _config);
+        if (catalogMode === 'impact' && mapping.flows.length === 0 && _config.impact.allowFallback) {
+            const fallbackMapping = (0, flow_mapping_js_1.mapChangesToCatalogFlows)(catalog, analysisTargets, 'gap', _config);
+            mapping = {
+                flows: fallbackMapping.flows,
+                testsByFlow: fallbackMapping.testsByFlow,
+                warnings: [
+                    ...mapping.warnings,
+                    ...fallbackMapping.warnings,
+                    'No catalog flow matched changed files; applied full-catalog fallback because allowFallback=true.',
+                ],
+            };
+        }
         flows = mapping.flows;
         testsByFlow = mapping.testsByFlow;
         warnings.push(...mapping.warnings);

package/dist/agent/tests.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tests.d.ts","sourceRoot":"","sources":["../../src/agent/tests.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,eAAe,CAAC;AAG9C,MAAM,WAAW,QAAQ;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,YAAY;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,MAAM,CAAC,EAAE,SAAS,GAAG,cAAc,GAAG,WAAW,CAAC;CACrD;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,CAkB7E;AAUD,wBAAgB,eAAe,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,YAAY,EAAE,CAgCtF;AAaD,wBAAgB,sBAAsB,CAClC,KAAK,EAAE,UAAU,EAAE,EACnB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GACnC,YAAY,EAAE,CA8BhB"}
+{"version":3,"file":"tests.d.ts","sourceRoot":"","sources":["../../src/agent/tests.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,eAAe,CAAC;AAG9C,MAAM,WAAW,QAAQ;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,YAAY;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,MAAM,CAAC,EAAE,SAAS,GAAG,cAAc,GAAG,WAAW,CAAC;CACrD;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,CAkB7E;AAUD,wBAAgB,eAAe,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,YAAY,EAAE,CAgCtF;AAuBD,wBAAgB,sBAAsB,CAClC,KAAK,EAAE,UAAU,EAAE,EACnB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GACnC,YAAY,EAAE,CA8BhB"}

package/dist/agent/tests.js

@@ -70,9 +70,19 @@ function resolveExpectedTests(testsRoot, expectedTests) {
         if (!entry) {
             continue;
         }
-        resolved.push((0, utils_js_1.normalizePath)(entry));
+        const normalized = (0, utils_js_1.normalizePath)(entry).replace(/^\.\//, '');
+        if (normalized.startsWith('e2e-tests/playwright/')) {
+            resolved.push(normalized.slice('e2e-tests/playwright/'.length));
+            continue;
+        }
+        const specsIndex = normalized.indexOf('specs/');
+        if (specsIndex >= 0) {
+            resolved.push(normalized.slice(specsIndex));
+            continue;
+        }
+        resolved.push(normalized);
     }
-    return resolved;
+    return Array.from(new Set(resolved));
 }
 function mapCatalogTestsToFlows(flows, testsRoot, testsByFlow) {
     return flows.map((flow) => {

package/dist/cli.js

@@ -61,6 +61,9 @@ function printUsage() {
         'Usage:',
         '  e2e-ai-agents impact --path <app-root> [options]',
         '  e2e-ai-agents gap --path <app-root> [options]',
+        '  e2e-ai-agents plan --path <app-root> [options]',
+        '  e2e-ai-agents generate --path <app-root> [options]',
+        '  e2e-ai-agents heal --path <app-root> --traceability-report <json> [options]',
         '  e2e-ai-agents suggest --path <app-root> [options]',
         '  e2e-ai-agents approve-and-generate --path <app-root> [options]',
         '  e2e-ai-agents auto-heal-pr --path <app-root> [options]',
@@ -90,6 +93,7 @@ function printUsage() {
         '  --pipeline-parallel   Enable parallel mode in generator',
         '  --pipeline-dry-run    Do not execute pipeline (report only)',
         '  --pipeline-mcp        Use Playwright MCP server for exploration/healing',
+        '  --pipeline-mcp-allow-fallback  Allow non-MCP fallback if official MCP setup fails',
         '  --spec <path>         Optional spec PDF for context',
         '  --since <git-ref>     Git ref for impact analysis (default HEAD~1)',
         '  --time <minutes>      Time limit in minutes',
@@ -132,6 +136,9 @@ function parseArgs(argv) {
     const command = argv[0];
     if (command === 'impact'
         || command === 'gap'
+        || command === 'plan'
+        || command === 'generate'
+        || command === 'heal'
         || command === 'suggest'
         || command === 'approve-and-generate'
         || command === 'auto-heal-pr'
@@ -205,6 +212,10 @@ function parseArgs(argv) {
             parsed.pipelineMcp = true;
             continue;
         }
+        if (arg === '--pipeline-mcp-allow-fallback') {
+            parsed.pipelineMcpAllowFallback = true;
+            continue;
+        }
         if (arg === '--pipeline-scenarios' && next) {
             const value = Number(next);
             if (Number.isFinite(value)) {
@@ -614,6 +625,7 @@ async function main() {
                 parallel: args.pipelineParallel,
                 dryRun: args.pipelineDryRun,
                 mcp: args.pipelineMcp,
+                mcpAllowFallback: args.pipelineMcpAllowFallback,
             },
         });
         if (args.allowFallback) {
@@ -688,17 +700,72 @@ async function main() {
         }
         return;
     }
+    if (args.command === 'heal') {
+        if (!args.path && !autoConfig) {
+            // eslint-disable-next-line no-console
+            console.error('Error: --path is required for heal command');
+            process.exit(1);
+        }
+        if (!args.traceabilityReportPath) {
+            // eslint-disable-next-line no-console
+            console.error('Error: --traceability-report <path> is required for heal command');
+            process.exit(1);
+        }
+        const { config } = (0, config_js_1.resolveConfig)(process.cwd(), autoConfig, {
+            path: args.path,
+            testsRoot: args.testsRoot,
+            mode: 'gap',
+            framework: args.framework,
+            pipeline: {
+                enabled: true,
+                scenarios: args.pipelineScenarios,
+                outputDir: args.pipelineOutput,
+                baseUrl: args.pipelineBaseUrl,
+                browser: args.pipelineBrowser,
+                headless: args.pipelineHeadless,
+                project: args.pipelineProject,
+                parallel: args.pipelineParallel,
+                dryRun: args.pipelineDryRun,
+                mcp: args.pipelineMcp,
+                mcpAllowFallback: args.pipelineMcpAllowFallback,
+            },
+        });
+        const reportRoot = config.testsRoot || config.path;
+        const unstableSpecs = (0, playwright_report_js_1.extractPlaywrightUnstableSpecs)(args.traceabilityReportPath, [reportRoot, config.path]);
+        if (unstableSpecs.length === 0) {
+            // eslint-disable-next-line no-console
+            console.log('Heal targeted unstable specs: 0');
+            return;
+        }
+        const targetedSummary = (0, pipeline_js_1.runTargetedSpecHeal)(reportRoot, unstableSpecs.map((spec) => ({
+            specPath: spec.specPath,
+            status: spec.status,
+            reason: `Playwright report: failingTests=${spec.failingTests}, flakyTests=${spec.flakyTests}`,
+        })), {
+            ...config.pipeline,
+            enabled: true,
+            heal: true,
+        });
+        const healedCount = targetedSummary.results.filter((result) => result.healStatus === 'success').length;
+        // eslint-disable-next-line no-console
+        console.log(`Heal targeted unstable specs: ${unstableSpecs.length} (healed=${healedCount})`);
+        if (targetedSummary.warnings.length > 0) {
+            // eslint-disable-next-line no-console
+            console.log(`Heal warnings: ${targetedSummary.warnings.join(' | ')}`);
+        }
+        return;
+    }
     if (!args.path && !autoConfig) {
         // eslint-disable-next-line no-console
         console.error('Error: --path is required (or provide a config file with path set)');
         printUsage();
         process.exit(1);
     }
-    const forcePipelineFromApproval = args.command === 'approve-and-generate';
+    const forcePipelineFromApproval = args.command === 'approve-and-generate' || args.command === 'generate';
     const { config } = (0, config_js_1.resolveConfig)(process.cwd(), autoConfig, {
         path: args.path,
         testsRoot: args.testsRoot,
-        mode: (args.command === 'gap' || args.command === 'approve-and-generate') ? 'gap' : 'impact',
+        mode: (args.command === 'gap' || args.command === 'approve-and-generate' || args.command === 'generate') ? 'gap' : 'impact',
         framework: args.framework,
         timeLimitMinutes: args.timeLimitMinutes,
         budget: {
@@ -723,6 +790,7 @@ async function main() {
                 parallel: args.pipelineParallel,
                 dryRun: args.pipelineDryRun,
                 mcp: args.pipelineMcp !== undefined ? args.pipelineMcp : forcePipelineFromApproval,
+                mcpAllowFallback: args.pipelineMcpAllowFallback,
             }
             : undefined,
         policy: args.policyMinConfidence !== undefined ||
@@ -744,7 +812,7 @@ async function main() {
         await (0, runner_js_1.runImpact)(config, { apply: args.apply });
         return;
     }
-    if (args.command === 'suggest') {
+    if (args.command === 'suggest' || args.command === 'plan') {
         await (0, runner_js_1.runImpact)(config, { apply: args.apply });
         const reportRoot = config.testsRoot || config.path;
         const impactPath = (0, path_1.join)(reportRoot, '.e2e-ai-agents', 'impact.json');
@@ -793,8 +861,8 @@ async function main() {
         }
         return;
     }
-    if (args.command === 'approve-and-generate') {
-        await (0, runner_js_1.runGap)(config, { apply: true });
+    if (args.command === 'approve-and-generate' || args.command === 'generate') {
+        await (0, runner_js_1.runGap)(config, { apply: args.apply });
         return;
     }
     await (0, runner_js_1.runGap)(config, { apply: args.apply });

package/dist/esm/agent/config.js

@@ -73,6 +73,7 @@ const DEFAULT_CONFIG = {
         outputDir: 'specs/functional/ai-assisted',
         heal: true,
         mcp: false,
+        mcpAllowFallback: false,
     },
     llm: {
         provider: 'anthropic',
@@ -434,6 +435,9 @@ function extractConfigPatch(raw) {
             parallel: pipeline.parallel !== undefined ? Boolean(pipeline.parallel) : undefined,
             dryRun: pipeline.dryRun !== undefined ? Boolean(pipeline.dryRun) : undefined,
             mcp: pipeline.mcp !== undefined ? Boolean(pipeline.mcp) : DEFAULT_CONFIG.pipeline.mcp,
+            mcpAllowFallback: pipeline.mcpAllowFallback !== undefined
+                ? Boolean(pipeline.mcpAllowFallback)
+                : DEFAULT_CONFIG.pipeline.mcpAllowFallback,
         };
     }
     if (raw.llm && typeof raw.llm === 'object') {
@@ -578,6 +582,12 @@ export function resolveConfig(cwd, configPath, overrides) {
         if (overrides.pipeline.dryRun !== undefined) {
             pipelinePatch.dryRun = overrides.pipeline.dryRun;
         }
+        if (overrides.pipeline.mcp !== undefined) {
+            pipelinePatch.mcp = overrides.pipeline.mcp;
+        }
+        if (overrides.pipeline.mcpAllowFallback !== undefined) {
+            pipelinePatch.mcpAllowFallback = overrides.pipeline.mcpAllowFallback;
+        }
         config.pipeline = { ...config.pipeline, ...pipelinePatch };
     }
     if (overrides?.policy) {