@yasserkhanorg/e2e-agents 0.5.16 → 0.6.0

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 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'
@@ -761,117 +754,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 +818,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 +836,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 +847,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,45 +870,41 @@ 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 });
-        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 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(`Impact re-run failed (${err instanceof Error ? err.message : String(err)}); using existing impact.json.`);
-            }
-            else {
-                throw err;
+                console.warn(`  Warning: ${w}`);
             }
         }
-        if (!(0, fs_1.existsSync)(impactPath)) {
-            throw new Error(`Impact report not found at ${impactPath}`);
-        }
-        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,
+        return;
+    }
+    if (args.command === 'suggest' || args.command === 'plan') {
+        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,
-            sinceRef: config.git.since,
-            configPath,
+            routeFamilies: config.routeFamilies,
         });
-        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 plan = (0, plan_builder_js_1.buildPlanFromImpact)(impactResult, config.policy);
+        const planPath = (0, plan_builder_js_1.writePlanReport)(reportRoot, plan);
+        const summaryMarkdown = (0, plan_builder_js_1.renderCiSummaryMarkdown)(plan);
+        const summaryPath = (0, plan_builder_js_1.writeCiSummary)(reportRoot, summaryMarkdown, args.ciCommentPath);
         const metrics = (0, plan_js_1.appendPlanMetrics)(reportRoot, plan);
         const ghaOutput = args.githubOutputPath || process.env.GITHUB_OUTPUT;
         if (ghaOutput) {
@@ -1056,25 +932,16 @@ async function main() {
         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}`);
-        }
         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/impact_engine.d.ts

@@ -0,0 +1,36 @@
+import type { FeaturePriority } from '../knowledge/route_families.js';
+import type { RouteFamiliesConfig } from '../agent/config.js';
+export type CoverageStatus = 'covered' | 'partial' | 'uncovered';
+export interface ImpactedFeature {
+    familyId: string;
+    featureId?: string;
+    priority: FeaturePriority;
+    changedFiles: string[];
+    playwrightSpecs: string[];
+    cypressSpecs: string[];
+    userFlows: string[];
+    coverageStatus: CoverageStatus;
+}
+export interface ImpactResult {
+    changedFiles: string[];
+    expandedFiles: string[];
+    impactedFeatures: ImpactedFeature[];
+    unboundFiles: string[];
+    warnings: string[];
+}
+export interface ImpactEngineOptions {
+    testsRoot: string;
+    cypressRoot?: string;
+    routeFamilies?: RouteFamiliesConfig;
+    expandedFiles?: string[];
+}
+export declare function analyzeImpact(changedFiles: string[], options: ImpactEngineOptions): ImpactResult;
+/**
+ * Get gaps: P0/P1 features with 'uncovered' status.
+ */
+export declare function getGaps(result: ImpactResult): ImpactedFeature[];
+/**
+ * Get partial gaps: P0/P1 features with 'partial' status (advisory).
+ */
+export declare function getPartialGaps(result: ImpactResult): ImpactedFeature[];
+//# sourceMappingURL=impact_engine.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"impact_engine.d.ts","sourceRoot":"","sources":["../../src/engine/impact_engine.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAGR,eAAe,EAClB,MAAM,gCAAgC,CAAC;AASxC,OAAO,KAAK,EAAC,mBAAmB,EAAC,MAAM,oBAAoB,CAAC;AAE5D,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,CAAC;AAEjE,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,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,cAAc,EAAE,cAAc,CAAC;CAClC;AAED,MAAM,WAAW,YAAY;IACzB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,gBAAgB,EAAE,eAAe,EAAE,CAAC;IACpC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,mBAAmB,CAAC;IACpC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAuGD,wBAAgB,aAAa,CACzB,YAAY,EAAE,MAAM,EAAE,EACtB,OAAO,EAAE,mBAAmB,GAC7B,YAAY,CA2Ed;AAYD;;GAEG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,YAAY,GAAG,eAAe,EAAE,CAI/D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,eAAe,EAAE,CAItE"}

package/dist/engine/impact_engine.js

@@ -0,0 +1,196 @@
+"use strict";
+// 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.getGaps = getGaps;
+exports.getPartialGaps = getPartialGaps;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const route_families_js_1 = require("../knowledge/route_families.js");
+function scanDirForSpecs(baseDir, specDir, extension) {
+    const fullDir = (0, path_1.join)(baseDir, specDir);
+    if (!(0, fs_1.existsSync)(fullDir)) {
+        return [];
+    }
+    const specs = [];
+    try {
+        const items = (0, fs_1.readdirSync)(fullDir, { withFileTypes: true });
+        for (const item of items) {
+            const itemPath = (0, path_1.join)(fullDir, item.name);
+            if (item.isDirectory()) {
+                specs.push(...scanDirForSpecsRecursive(itemPath, extension));
+            }
+            else if (item.name.endsWith(extension)) {
+                specs.push((0, path_1.join)(specDir, item.name));
+            }
+        }
+    }
+    catch {
+        // Directory not readable
+    }
+    return specs;
+}
+function scanDirForSpecsRecursive(dir, extension) {
+    const specs = [];
+    try {
+        const items = (0, fs_1.readdirSync)(dir, { withFileTypes: true });
+        for (const item of items) {
+            const fullPath = (0, path_1.join)(dir, item.name);
+            if (item.isDirectory()) {
+                specs.push(...scanDirForSpecsRecursive(fullPath, extension));
+            }
+            else if (item.name.endsWith(extension)) {
+                specs.push(fullPath);
+            }
+        }
+    }
+    catch {
+        // Directory not readable
+    }
+    return specs;
+}
+function resolvePlaywrightSpecs(testsRoot, specDirs) {
+    const specs = [];
+    for (const dir of specDirs) {
+        specs.push(...scanDirForSpecs(testsRoot, dir, '.spec.ts'));
+    }
+    return specs;
+}
+function resolveCypressSpecs(cypressRoot, specDirs) {
+    const specs = [];
+    for (const dir of specDirs) {
+        // cypressSpecDirs are relative to testsRoot (e.g. ../cypress/tests/integration/channels/search/)
+        // Resolve them relative to the cypress root
+        const resolvedDir = (0, path_1.join)(cypressRoot, dir.replace(/^\.\.\/cypress\//, ''));
+        if (!(0, fs_1.existsSync)(resolvedDir)) {
+            continue;
+        }
+        const found = scanDirForSpecsRecursive(resolvedDir, '.js');
+        const tsFound = scanDirForSpecsRecursive(resolvedDir, '.ts');
+        specs.push(...found, ...tsFound);
+    }
+    return specs;
+}
+function computeCoverageStatus(pwSpecs, cySpecs) {
+    const hasPw = pwSpecs.length > 0;
+    const hasCy = cySpecs.length > 0;
+    if (hasPw && hasCy) {
+        return 'covered';
+    }
+    if (hasPw || hasCy) {
+        return 'partial';
+    }
+    return 'uncovered';
+}
+/**
+ * Group file bindings into a deduplicated map of family/feature → changed files.
+ */
+function groupBindings(fileBindings) {
+    const groups = new Map();
+    for (const fb of fileBindings) {
+        for (const binding of fb.bindings) {
+            const key = binding.feature || binding.family;
+            const existing = groups.get(key);
+            if (existing) {
+                if (!existing.files.includes(fb.file)) {
+                    existing.files.push(fb.file);
+                }
+            }
+            else {
+                groups.set(key, {
+                    familyId: binding.family,
+                    featureId: binding.feature,
+                    files: [fb.file],
+                });
+            }
+        }
+    }
+    return groups;
+}
+function analyzeImpact(changedFiles, options) {
+    const { testsRoot, routeFamilies } = options;
+    const warnings = [];
+    // Load manifest
+    const manifest = (0, route_families_js_1.loadRouteFamilyManifest)(testsRoot, routeFamilies);
+    if (!manifest) {
+        return {
+            changedFiles,
+            expandedFiles: options.expandedFiles || [],
+            impactedFeatures: [],
+            unboundFiles: [...changedFiles],
+            warnings: ['Route family manifest not found. All files are unbound.'],
+        };
+    }
+    // Combine original + expanded files
+    const allFiles = [...new Set([...changedFiles, ...(options.expandedFiles || [])])];
+    // Bind files to families
+    const fileBindings = (0, route_families_js_1.bindFilesToFamilies)(allFiles, manifest);
+    // Find unbound files
+    const unboundFiles = fileBindings
+        .filter((fb) => fb.bindings.length === 0)
+        .map((fb) => fb.file);
+    // Group bindings into features
+    const groups = groupBindings(fileBindings.filter((fb) => fb.bindings.length > 0));
+    // Determine cypress root
+    const cypressRoot = options.cypressRoot || inferCypressRoot(testsRoot);
+    // Resolve specs and compute coverage for each feature
+    const impactedFeatures = [];
+    for (const group of groups.values()) {
+        const binding = { family: group.familyId, feature: group.featureId };
+        const specDirs = (0, route_families_js_1.getSpecDirsForBinding)(manifest, binding);
+        const cypressSpecDirs = (0, route_families_js_1.getCypressSpecDirsForBinding)(manifest, binding);
+        const priority = (0, route_families_js_1.getPriorityForBinding)(manifest, binding);
+        const userFlows = (0, route_families_js_1.getUserFlowsForBinding)(manifest, binding);
+        const playwrightSpecs = resolvePlaywrightSpecs(testsRoot, specDirs);
+        const cypressSpecs = cypressRoot ? resolveCypressSpecs(cypressRoot, cypressSpecDirs) : [];
+        const coverageStatus = computeCoverageStatus(playwrightSpecs, cypressSpecs);
+        impactedFeatures.push({
+            familyId: group.familyId,
+            featureId: group.featureId,
+            priority,
+            changedFiles: group.files,
+            playwrightSpecs,
+            cypressSpecs,
+            userFlows,
+            coverageStatus,
+        });
+    }
+    // Sort by priority (P0 first, then P1, then P2)
+    const priorityOrder = { P0: 0, P1: 1, P2: 2 };
+    impactedFeatures.sort((a, b) => priorityOrder[a.priority] - priorityOrder[b.priority]);
+    if (unboundFiles.length > 0 && unboundFiles.length <= 5) {
+        warnings.push(`${unboundFiles.length} file(s) not mapped to any route family: ${unboundFiles.join(', ')}`);
+    }
+    else if (unboundFiles.length > 5) {
+        warnings.push(`${unboundFiles.length} file(s) not mapped to any route family`);
+    }
+    return {
+        changedFiles,
+        expandedFiles: options.expandedFiles || [],
+        impactedFeatures,
+        unboundFiles,
+        warnings,
+    };
+}
+function inferCypressRoot(testsRoot) {
+    // testsRoot is typically the Playwright tests directory
+    // Cypress tests are at a sibling path: e2e-tests/cypress/tests/integration/channels/
+    const candidate = (0, path_1.join)(testsRoot, '..', 'cypress');
+    if ((0, fs_1.existsSync)(candidate)) {
+        return candidate;
+    }
+    return undefined;
+}
+/**
+ * Get gaps: P0/P1 features with 'uncovered' status.
+ */
+function getGaps(result) {
+    return result.impactedFeatures.filter((f) => (f.priority === 'P0' || f.priority === 'P1') && f.coverageStatus === 'uncovered');
+}
+/**
+ * Get partial gaps: P0/P1 features with 'partial' status (advisory).
+ */
+function getPartialGaps(result) {
+    return result.impactedFeatures.filter((f) => (f.priority === 'P0' || f.priority === 'P1') && f.coverageStatus === 'partial');
+}

package/dist/engine/plan_builder.d.ts

@@ -0,0 +1,9 @@
+import type { PolicyConfig } from '../agent/config.js';
+import type { ImpactResult } from './impact_engine.js';
+import type { PlanReport, GapDetail, CoveredFlowSummary } from '../agent/plan.js';
+export type { PlanReport, GapDetail, CoveredFlowSummary };
+export declare function buildPlanFromImpact(impact: ImpactResult, policyOverride?: Partial<PolicyConfig>): PlanReport;
+export declare function writePlanReport(appRoot: string, plan: PlanReport): string;
+export declare function renderCiSummaryMarkdown(plan: PlanReport): string;
+export declare function writeCiSummary(appRoot: string, markdown: string, relativePath?: string): string;
+//# sourceMappingURL=plan_builder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plan_builder.d.ts","sourceRoot":"","sources":["../../src/engine/plan_builder.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAC,YAAY,EAAkB,MAAM,oBAAoB,CAAC;AAItE,OAAO,KAAK,EACR,UAAU,EACV,SAAS,EACT,kBAAkB,EAIrB,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EAAC,UAAU,EAAE,SAAS,EAAE,kBAAkB,EAAC,CAAC;AAqOxD,wBAAgB,mBAAmB,CAC/B,MAAM,EAAE,YAAY,EACpB,cAAc,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GACvC,UAAU,CAiFZ;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,MAAM,CAMzE;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CA8ChE;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,SAAiC,GAAG,MAAM,CAMvH"}