@yasserkhanorg/e2e-agents 0.5.16 → 0.7.0

package/dist/api.js

@@ -2,28 +2,23 @@
 // Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
 // See LICENSE.txt for license information.
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.analyzeImpact = analyzeImpact;
-exports.findGaps = findGaps;
-exports.recommendTests = recommendTests;
 exports.handoffGeneratedTests = handoffGeneratedTests;
 exports.ingestTraceability = ingestTraceability;
+exports.analyzeImpactDeterministic = analyzeImpactDeterministic;
+exports.recommendTestsDeterministic = recommendTestsDeterministic;
+exports.recommendTestsAI = recommendTestsAI;
 exports.captureTraceability = captureTraceability;
-const fs_1 = require("fs");
-const path_1 = require("path");
 const config_js_1 = require("./agent/config.js");
-const runner_js_1 = require("./agent/runner.js");
 const plan_js_1 = require("./agent/plan.js");
-const operational_insights_js_1 = require("./agent/operational_insights.js");
+const impact_engine_js_1 = require("./engine/impact_engine.js");
+const plan_builder_js_1 = require("./engine/plan_builder.js");
+const git_js_1 = require("./agent/git.js");
+const diff_loader_js_1 = require("./engine/diff_loader.js");
+const ai_enrichment_js_1 = require("./engine/ai_enrichment.js");
+const anthropic_provider_js_1 = require("./anthropic_provider.js");
 const handoff_js_1 = require("./agent/handoff.js");
 const traceability_ingest_js_1 = require("./agent/traceability_ingest.js");
 const traceability_capture_js_1 = require("./agent/traceability_capture.js");
-function readReportJson(reportPath) {
-    if (!(0, fs_1.existsSync)(reportPath)) {
-        throw new Error(`Expected report not found: ${reportPath}`);
-    }
-    const raw = (0, fs_1.readFileSync)(reportPath, 'utf-8');
-    return JSON.parse(raw);
-}
 function resolveAgent(options, mode) {
     const cwd = options.cwd || process.cwd();
     const { config } = (0, config_js_1.resolveConfig)(cwd, options.configPath, {
@@ -35,51 +30,6 @@ function resolveAgent(options, mode) {
     }
     return config;
 }
-function reportPathFor(configPath, mode) {
-    return (0, path_1.join)(configPath, '.e2e-ai-agents', mode === 'impact' ? 'impact.json' : 'gap.json');
-}
-async function analyzeImpact(options = {}) {
-    const config = resolveAgent(options, 'impact');
-    await (0, runner_js_1.runImpact)(config, { apply: options.apply ?? false });
-    const reportRoot = config.testsRoot || config.path;
-    const reportPath = reportPathFor(reportRoot, 'impact');
-    const report = readReportJson(reportPath);
-    return { report, reportPath };
-}
-async function findGaps(options = {}) {
-    const config = resolveAgent(options, 'gap');
-    await (0, runner_js_1.runGap)(config, { apply: options.apply ?? false });
-    const reportRoot = config.testsRoot || config.path;
-    const reportPath = reportPathFor(reportRoot, 'gap');
-    const report = readReportJson(reportPath);
-    return { report, reportPath };
-}
-async function recommendTests(options = {}) {
-    const config = resolveAgent(options, 'impact');
-    await (0, runner_js_1.runImpact)(config, { apply: options.apply ?? false });
-    const reportRoot = config.testsRoot || config.path;
-    const impactPath = reportPathFor(reportRoot, 'impact');
-    const report = readReportJson(impactPath);
-    const basePlan = (0, plan_js_1.buildPlanFromImpactReport)(report, config.policy);
-    const withActions = (0, plan_js_1.attachDeveloperActions)(basePlan, {
-        appPath: config.path,
-        testsRoot: reportRoot,
-        sinceRef: config.git.since,
-    });
-    const plan = (0, operational_insights_js_1.applyOperationalInsights)(withActions, reportRoot);
-    const planPath = (0, plan_js_1.writePlanReport)(reportRoot, plan);
-    const ciSummaryMarkdown = (0, plan_js_1.renderCiSummaryMarkdown)(plan);
-    const ciSummaryPath = (0, plan_js_1.writeCiSummary)(reportRoot, ciSummaryMarkdown);
-    (0, plan_js_1.appendPlanMetrics)(reportRoot, plan);
-    return {
-        report,
-        reportPath: impactPath,
-        plan,
-        planPath,
-        ciSummaryMarkdown,
-        ciSummaryPath,
-    };
-}
 function handoffGeneratedTests(options) {
     return (0, handoff_js_1.finalizeGeneratedTests)(options);
 }
@@ -93,6 +43,64 @@ function ingestTraceability(options) {
     const reportRoot = config.testsRoot || config.path;
     return (0, traceability_ingest_js_1.ingestTraceabilityInput)(reportRoot, config.impact.traceability, options.payload, options.options);
 }
+function analyzeImpactDeterministic(options = {}) {
+    const config = resolveAgent(options, 'impact');
+    const reportRoot = config.testsRoot || config.path;
+    const gitResult = (0, git_js_1.getChangedFiles)(config.path, config.git.since, { includeUncommitted: config.git.includeUncommitted });
+    return (0, impact_engine_js_1.analyzeImpact)(gitResult.files, {
+        testsRoot: reportRoot,
+        routeFamilies: config.routeFamilies,
+    });
+}
+function recommendTestsDeterministic(options = {}) {
+    const config = resolveAgent(options, 'impact');
+    const reportRoot = config.testsRoot || config.path;
+    const gitResult = (0, git_js_1.getChangedFiles)(config.path, config.git.since, { includeUncommitted: config.git.includeUncommitted });
+    const impact = (0, impact_engine_js_1.analyzeImpact)(gitResult.files, {
+        testsRoot: reportRoot,
+        routeFamilies: config.routeFamilies,
+    });
+    const plan = (0, plan_builder_js_1.buildPlanFromImpact)(impact, config.policy);
+    const planPath = (0, plan_builder_js_1.writePlanReport)(reportRoot, plan);
+    const ciSummaryMarkdown = (0, plan_builder_js_1.renderCiSummaryMarkdown)(plan);
+    const ciSummaryPath = (0, plan_builder_js_1.writeCiSummary)(reportRoot, ciSummaryMarkdown);
+    (0, plan_js_1.appendPlanMetrics)(reportRoot, plan);
+    return { impact, plan, planPath, ciSummaryMarkdown, ciSummaryPath };
+}
+async function recommendTestsAI(options = {}) {
+    const config = resolveAgent(options, 'impact');
+    const reportRoot = config.testsRoot || config.path;
+    const gitResult = (0, git_js_1.getChangedFiles)(config.path, config.git.since, { includeUncommitted: config.git.includeUncommitted });
+    const impact = (0, impact_engine_js_1.analyzeImpact)(gitResult.files, {
+        testsRoot: reportRoot,
+        routeFamilies: config.routeFamilies,
+    });
+    const apiKey = process.env.ANTHROPIC_API_KEY;
+    let aiEnrichment;
+    if (apiKey) {
+        const diffs = (0, diff_loader_js_1.loadDiffs)(config.path, config.git.since, gitResult.files);
+        const provider = new anthropic_provider_js_1.AnthropicProvider({ apiKey });
+        // Collect all known spec paths from impacted features
+        const specSet = new Set();
+        for (const feature of impact.impactedFeatures) {
+            for (const s of feature.playwrightSpecs) {
+                specSet.add(s);
+            }
+        }
+        aiEnrichment = await (0, ai_enrichment_js_1.enrichImpactWithAI)({
+            deterministicImpact: impact,
+            diffs,
+            provider,
+            specList: [...specSet],
+        });
+    }
+    const plan = (0, plan_builder_js_1.buildPlanFromImpact)(impact, config.policy, aiEnrichment);
+    const planPath = (0, plan_builder_js_1.writePlanReport)(reportRoot, plan);
+    const ciSummaryMarkdown = (0, plan_builder_js_1.renderCiSummaryMarkdown)(plan);
+    const ciSummaryPath = (0, plan_builder_js_1.writeCiSummary)(reportRoot, ciSummaryMarkdown);
+    (0, plan_js_1.appendPlanMetrics)(reportRoot, plan);
+    return { impact, plan, planPath, ciSummaryMarkdown, ciSummaryPath, aiEnrichment };
+}
 function captureTraceability(options) {
     const cwd = options.cwd || process.cwd();
     const { config } = (0, config_js_1.resolveConfig)(cwd, options.configPath, {

package/dist/cli.js

@@ -8,9 +8,10 @@ const path_1 = require("path");
 const config_js_1 = require("./agent/config.js");
 const anthropic_provider_js_1 = require("./anthropic_provider.js");
 const provider_interface_js_1 = require("./provider_interface.js");
-const runner_js_1 = require("./agent/runner.js");
-const plan_js_1 = require("./agent/plan.js");
-const operational_insights_js_1 = require("./agent/operational_insights.js");
+const impact_engine_js_1 = require("./engine/impact_engine.js");
+const plan_builder_js_1 = require("./engine/plan_builder.js");
+const git_js_1 = require("./agent/git.js");
+const api_js_1 = require("./api.js");
 const feedback_js_1 = require("./agent/feedback.js");
 const handoff_js_1 = require("./agent/handoff.js");
 const traceability_ingest_js_1 = require("./agent/traceability_ingest.js");
@@ -61,13 +62,9 @@ function printUsage() {
     console.log([
         '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]',
+        '  e2e-ai-agents heal --path <app-root> --traceability-report <json> [options]',
         '  e2e-ai-agents finalize-generated-tests --path <app-root> [options]',
         '  e2e-ai-agents feedback --path <app-root> --feedback-input <json>',
         '  e2e-ai-agents traceability-capture --path <app-root> --traceability-report <json>',
@@ -146,13 +143,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'
         || command === 'finalize-generated-tests'
         || command === 'feedback'
         || command === 'traceability-capture'
@@ -502,6 +495,10 @@ function parseArgs(argv) {
             i += 1;
             continue;
         }
+        if (arg === '--no-ai') {
+            parsed.noAi = true;
+            continue;
+        }
     }
     return parsed;
 }
@@ -761,117 +758,6 @@ async function main() {
         }
         return;
     }
-    if (args.command === 'auto-heal-pr') {
-        if (!args.path && !autoConfig) {
-            // eslint-disable-next-line no-console
-            console.error('Error: --path is required for auto-heal-pr command');
-            process.exit(1);
-        }
-        const { config } = (0, config_js_1.resolveConfig)(process.cwd(), autoConfig, {
-            path: args.path,
-            profile: args.profile,
-            testsRoot: args.testsRoot,
-            mode: 'gap',
-            framework: args.framework,
-            timeLimitMinutes: args.timeLimitMinutes,
-            budget: {
-                maxUSD: args.budgetUSD,
-                maxTokens: args.budgetTokens,
-            },
-            testPatterns: args.testPatterns,
-            flowPatterns: args.flowPatterns,
-            flowExclude: args.flowExclude,
-            flowCatalogPath: args.flowCatalogPath,
-            specPDF: args.specPDF,
-            gitSince: args.gitSince,
-            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,
-                mcpOnly: args.pipelineMcpOnly,
-            },
-            llmProvider: args.llmProvider,
-        });
-        if (args.allowFallback) {
-            config.impact.allowFallback = true;
-        }
-        await (0, runner_js_1.runGap)(config, { apply: true });
-        const reportRoot = config.testsRoot || config.path;
-        if (args.traceabilityReportPath) {
-            const unstableSpecs = (0, playwright_report_js_1.extractPlaywrightUnstableSpecs)(args.traceabilityReportPath, [reportRoot, config.path]);
-            if (unstableSpecs.length > 0) {
-                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(`Auto-heal targeted unstable specs: ${unstableSpecs.length} (healed=${healedCount})`);
-                if (targetedSummary.warnings.length > 0) {
-                    // eslint-disable-next-line no-console
-                    console.log(`Auto-heal warnings: ${targetedSummary.warnings.join(' | ')}`);
-                }
-                const gapPath = (0, path_1.join)(reportRoot, '.e2e-ai-agents', 'gap.json');
-                if ((0, fs_1.existsSync)(gapPath)) {
-                    const gap = JSON.parse((0, fs_1.readFileSync)(gapPath, 'utf-8'));
-                    const existingResults = Array.isArray(gap.pipeline?.results) ? gap.pipeline?.results : [];
-                    const existingWarnings = Array.isArray(gap.pipeline?.warnings) ? gap.pipeline?.warnings : [];
-                    gap.pipeline = {
-                        runner: gap.pipeline?.runner || targetedSummary.runner,
-                        results: [...existingResults, ...targetedSummary.results],
-                        warnings: Array.from(new Set([...(existingWarnings || []), ...targetedSummary.warnings])),
-                    };
-                    (0, fs_1.writeFileSync)(gapPath, `${JSON.stringify(gap, null, 2)}\n`, 'utf-8');
-                }
-            }
-            else {
-                // eslint-disable-next-line no-console
-                console.log('Auto-heal targeted unstable specs: 0');
-            }
-        }
-        const branchSuffix = new Date().toISOString().replace(/[:.]/g, '-');
-        const result = (0, handoff_js_1.finalizeGeneratedTests)({
-            appPath: config.path,
-            testsRoot: reportRoot,
-            branch: args.branch || `auto-heal-${branchSuffix}`,
-            commitMessage: args.commitMessage || 'test(e2e): auto-heal generated specs',
-            createPr: true,
-            prTitle: args.prTitle || 'test(e2e): auto-heal generated specs',
-            prBody: args.prBody || 'Automated e2e-heal run generated by @yasserkhanorg/e2e-agents.',
-            baseBranch: args.prBase || 'master',
-            dryRun: args.dryRun,
-        });
-        // eslint-disable-next-line no-console
-        console.log(`Auto-heal repo root: ${result.repoRoot}`);
-        // eslint-disable-next-line no-console
-        console.log(`Auto-heal branch: ${result.branch}`);
-        // eslint-disable-next-line no-console
-        console.log(`Auto-heal staged paths: ${result.stagedPaths.join(', ') || 'none'}`);
-        // eslint-disable-next-line no-console
-        console.log(`Auto-heal commit: ${result.committed ? 'created' : 'skipped'}`);
-        if (result.commitSha) {
-            // eslint-disable-next-line no-console
-            console.log(`Auto-heal commit sha: ${result.commitSha}`);
-        }
-        if (result.prUrl) {
-            // eslint-disable-next-line no-console
-            console.log(`Auto-heal PR: ${result.prUrl}`);
-        }
-        return;
-    }
     if (args.command === 'heal') {
         if (!args.path && !autoConfig) {
             // eslint-disable-next-line no-console
@@ -936,13 +822,11 @@ async function main() {
         printUsage();
         process.exit(1);
     }
-    const forcePipelineFromApproval = args.command === 'approve-and-generate' || args.command === 'generate';
-    const forceAIPipelineFromApproval = args.command === 'approve-and-generate' || args.command === 'generate';
-    const { config, configPath } = (0, config_js_1.resolveConfig)(process.cwd(), autoConfig, {
+    const { config } = (0, config_js_1.resolveConfig)(process.cwd(), autoConfig, {
         path: args.path,
         profile: args.profile,
         testsRoot: args.testsRoot,
-        mode: (args.command === 'gap' || args.command === 'approve-and-generate' || args.command === 'generate') ? 'gap' : 'impact',
+        mode: 'impact',
         framework: args.framework,
         timeLimitMinutes: args.timeLimitMinutes,
         budget: {
@@ -956,7 +840,7 @@ async function main() {
         specPDF: args.specPDF,
         gitSince: args.gitSince,
         llmProvider: args.llmProvider,
-        pipeline: (args.pipeline || forcePipelineFromApproval)
+        pipeline: args.pipeline
             ? {
                 enabled: true,
                 scenarios: args.pipelineScenarios,
@@ -967,9 +851,9 @@ async function main() {
                 project: args.pipelineProject,
                 parallel: args.pipelineParallel,
                 dryRun: args.pipelineDryRun,
-                mcp: args.pipelineMcp !== undefined ? args.pipelineMcp : forceAIPipelineFromApproval,
+                mcp: args.pipelineMcp,
                 mcpAllowFallback: args.pipelineMcpAllowFallback,
-                mcpOnly: args.pipelineMcpOnly !== undefined ? args.pipelineMcpOnly : forceAIPipelineFromApproval,
+                mcpOnly: args.pipelineMcpOnly,
                 mcpCommandTimeoutMs: args.pipelineMcpTimeoutMs,
                 mcpRetries: args.pipelineMcpRetries,
             }
@@ -990,46 +874,81 @@ async function main() {
             }
             : undefined,
     });
-    if (args.allowFallback) {
-        config.impact.allowFallback = true;
-    }
     if (args.command === 'impact') {
-        await (0, runner_js_1.runImpact)(config, { apply: args.apply });
+        const reportRoot = config.testsRoot || config.path;
+        const gitResult = (0, git_js_1.getChangedFiles)(config.path, config.git.since, { includeUncommitted: config.git.includeUncommitted });
+        const impactResult = (0, impact_engine_js_1.analyzeImpact)(gitResult.files, {
+            testsRoot: reportRoot,
+            routeFamilies: config.routeFamilies,
+        });
+        // eslint-disable-next-line no-console
+        console.log(`Impact: ${impactResult.changedFiles.length} changed files → ${impactResult.impactedFeatures.length} features impacted`);
+        // eslint-disable-next-line no-console
+        console.log(`Unbound files: ${impactResult.unboundFiles.length}`);
+        for (const f of impactResult.impactedFeatures) {
+            const label = f.featureId || f.familyId;
+            // eslint-disable-next-line no-console
+            console.log(`  [${f.priority}] ${label}: ${f.coverageStatus} (PW=${f.playwrightSpecs.length}, Cy=${f.cypressSpecs.length})`);
+        }
+        if (impactResult.warnings.length > 0) {
+            for (const w of impactResult.warnings) {
+                // eslint-disable-next-line no-console
+                console.warn(`  Warning: ${w}`);
+            }
+        }
         return;
     }
     if (args.command === 'suggest' || args.command === 'plan') {
         const reportRoot = config.testsRoot || config.path;
-        const impactPath = (0, path_1.join)(reportRoot, '.e2e-ai-agents', 'impact.json');
-        try {
-            await (0, runner_js_1.runImpact)(config, { apply: args.apply });
-        }
-        catch (err) {
-            // If impact analysis already ran (e.g. a prior CI step wrote impact.json),
-            // fall back to that data rather than failing the plan step.
-            if ((0, fs_1.existsSync)(impactPath)) {
+        const apiOptions = {
+            cwd: process.cwd(),
+            configPath: autoConfig,
+            path: args.path,
+            profile: args.profile,
+            testsRoot: args.testsRoot,
+            gitSince: args.gitSince,
+            llmProvider: args.llmProvider,
+            policy: args.policyMinConfidence !== undefined ||
+                args.policySafeMergeConfidence !== undefined ||
+                args.policyWarningsThreshold !== undefined ||
+                (args.policyRiskyPatterns && args.policyRiskyPatterns.length > 0) ||
+                args.policyEnforcementMode !== undefined ||
+                (args.policyBlockActions && args.policyBlockActions.length > 0)
+                ? {
+                    minConfidenceForTargeted: args.policyMinConfidence,
+                    safeMergeMinConfidence: args.policySafeMergeConfidence,
+                    forceFullOnWarningsAtOrAbove: args.policyWarningsThreshold,
+                    riskyFilePatterns: args.policyRiskyPatterns,
+                    enforcementMode: args.policyEnforcementMode,
+                    blockOnActions: args.policyBlockActions,
+                }
+                : undefined,
+        };
+        let result;
+        if (args.noAi) {
+            result = (0, api_js_1.recommendTestsDeterministic)(apiOptions);
+        }
+        else {
+            result = await (0, api_js_1.recommendTestsAI)(apiOptions);
+            if (result.aiEnrichment) {
+                const { aiEnrichment } = result;
                 // eslint-disable-next-line no-console
-                console.warn(`Impact re-run failed (${err instanceof Error ? err.message : String(err)}); using existing impact.json.`);
+                console.log(`AI enrichment: ${aiEnrichment.enrichedFeatures.length} features enriched (${aiEnrichment.tokenUsage.input + aiEnrichment.tokenUsage.output} tokens)`);
             }
-            else {
-                throw err;
+            else if (!process.env.ANTHROPIC_API_KEY) {
+                // eslint-disable-next-line no-console
+                console.log('Tip: set ANTHROPIC_API_KEY to enable AI-powered enrichment');
             }
         }
-        if (!(0, fs_1.existsSync)(impactPath)) {
-            throw new Error(`Impact report not found at ${impactPath}`);
+        const { plan, planPath, ciSummaryMarkdown, ciSummaryPath } = result;
+        // Write CI summary to an additional path if --ci-comment-path was specified
+        if (args.ciCommentPath) {
+            (0, plan_builder_js_1.writeCiSummary)(reportRoot, ciSummaryMarkdown, args.ciCommentPath);
         }
-        const impact = JSON.parse((0, fs_1.readFileSync)(impactPath, 'utf-8'));
-        const basePlan = (0, plan_js_1.buildPlanFromImpactReport)(impact, config.policy);
-        const withActions = (0, plan_js_1.attachDeveloperActions)(basePlan, {
-            appPath: config.path,
-            testsRoot: reportRoot,
-            sinceRef: config.git.since,
-            configPath,
-        });
-        const plan = (0, operational_insights_js_1.applyOperationalInsights)(withActions, reportRoot);
-        const planPath = (0, plan_js_1.writePlanReport)(reportRoot, plan);
-        const summaryMarkdown = (0, plan_js_1.renderCiSummaryMarkdown)(plan);
-        const summaryPath = (0, plan_js_1.writeCiSummary)(reportRoot, summaryMarkdown, args.ciCommentPath);
-        const metrics = (0, plan_js_1.appendPlanMetrics)(reportRoot, plan);
+        const summaryPath = ciSummaryPath;
+        // Compute metrics paths (api already wrote metrics; derive paths for GHA output)
+        const metricsEventsPath = (0, path_1.join)(reportRoot, '.e2e-ai-agents/metrics.jsonl');
+        const metricsSummaryPath = (0, path_1.join)(reportRoot, '.e2e-ai-agents/metrics-summary.json');
         const ghaOutput = args.githubOutputPath || process.env.GITHUB_OUTPUT;
         if (ghaOutput) {
             (0, fs_1.appendFileSync)(ghaOutput, `run_set=${plan.runSet}\n`);
@@ -1041,8 +960,8 @@ async function main() {
             (0, fs_1.appendFileSync)(ghaOutput, `required_new_tests_count=${plan.requiredNewTests.length}\n`);
             (0, fs_1.appendFileSync)(ghaOutput, `plan_path=${planPath}\n`);
             (0, fs_1.appendFileSync)(ghaOutput, `summary_path=${summaryPath}\n`);
-            (0, fs_1.appendFileSync)(ghaOutput, `metrics_events_path=${metrics.eventsPath}\n`);
-            (0, fs_1.appendFileSync)(ghaOutput, `metrics_summary_path=${metrics.summaryPath}\n`);
+            (0, fs_1.appendFileSync)(ghaOutput, `metrics_events_path=${metricsEventsPath}\n`);
+            (0, fs_1.appendFileSync)(ghaOutput, `metrics_summary_path=${metricsSummaryPath}\n`);
         }
         // eslint-disable-next-line no-console
         console.log(`Suggested run set: ${plan.runSet} (confidence ${plan.confidence})`);
@@ -1055,26 +974,17 @@ async function main() {
         // eslint-disable-next-line no-console
         console.log(`CI summary: ${summaryPath}`);
         // eslint-disable-next-line no-console
-        console.log(`Plan metrics: ${metrics.summaryPath}`);
-        if (plan.nextActions) {
-            // eslint-disable-next-line no-console
-            console.log(`Next action (run existing): ${plan.nextActions.runRecommendedTests || plan.nextActions.runSmokeSuite}`);
-            // eslint-disable-next-line no-console
-            console.log(`Next action (approve + generate): ${plan.nextActions.approveAndGenerate || plan.nextActions.generateMissingTests}`);
-            // eslint-disable-next-line no-console
-            console.log(`Next action (heal): ${plan.nextActions.healGeneratedTests}`);
-        }
+        console.log(`Plan metrics: ${metricsSummaryPath}`);
         const failOnLegacyFlag = args.failOnMustAddTests && plan.decision.action === 'must-add-tests';
         if (failOnLegacyFlag || plan.enforcement.shouldFail) {
             process.exit(2);
         }
         return;
     }
-    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 });
+    // eslint-disable-next-line no-console
+    console.error(`Unknown command: ${args.command}`);
+    printUsage();
+    process.exit(1);
 }
 async function runLlmHealth() {
     if (!process.env.ANTHROPIC_API_KEY) {

package/dist/engine/ai_enrichment.d.ts

@@ -0,0 +1,43 @@
+import type { LLMProvider } from '../provider_interface.js';
+import type { ImpactResult } from './impact_engine.js';
+import type { FeaturePriority } from '../knowledge/route_families.js';
+export interface EnrichedFeature {
+    familyId: string;
+    featureId?: string;
+    priority: FeaturePriority;
+    changedFiles: string[];
+    coverageStatus: string;
+    playwrightSpecs: string[];
+    cypressSpecs: string[];
+    userFlows: string[];
+    aiReasons: string[];
+    aiMissingScenarios: string[];
+    aiCoveredBy: string[];
+}
+export interface AIEnrichmentResult {
+    enrichedFeatures: EnrichedFeature[];
+    unboundFileInsights: Array<{
+        file: string;
+        likelyFeature: string;
+        reason: string;
+    }>;
+    warnings: string[];
+    providerName: string;
+    tokenUsage: {
+        input: number;
+        output: number;
+    };
+}
+export interface AIEnrichmentOptions {
+    deterministicImpact: ImpactResult;
+    diffs: Map<string, string>;
+    provider: LLMProvider;
+    specList: string[];
+    manifestSummary?: string;
+}
+/**
+ * Enriches a deterministic impact result with AI-generated reasons,
+ * missing test scenarios, and coverage insights.
+ */
+export declare function enrichImpactWithAI(options: AIEnrichmentOptions): Promise<AIEnrichmentResult>;
+//# sourceMappingURL=ai_enrichment.d.ts.map

package/dist/engine/ai_enrichment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai_enrichment.d.ts","sourceRoot":"","sources":["../../src/engine/ai_enrichment.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,0BAA0B,CAAC;AAC1D,OAAO,KAAK,EAAC,YAAY,EAAkB,MAAM,oBAAoB,CAAC;AACtE,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,gCAAgC,CAAC;AAGpE,MAAM,WAAW,eAAe;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,eAAe,CAAC;IAC1B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,WAAW,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IAC/B,gBAAgB,EAAE,eAAe,EAAE,CAAC;IACpC,mBAAmB,EAAE,KAAK,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAC,CAAC,CAAC;IAClF,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAC,CAAC;CAC/C;AAED,MAAM,WAAW,mBAAmB;IAChC,mBAAmB,EAAE,YAAY,CAAC;IAClC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3B,QAAQ,EAAE,WAAW,CAAC;IACtB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC5B;AAoJD;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAkIlG"}