@yasserkhanorg/e2e-agents 0.7.6 → 0.8.0

package/dist/api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAIA,OAAO,EAAgB,KAAK,eAAe,EAAC,MAAM,mBAAmB,CAAC;AACtE,OAAO,EAEH,KAAK,UAAU,EAClB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAmC,KAAK,YAAY,EAAC,MAAM,2BAA2B,CAAC;AAS9F,OAAO,EAAqB,KAAK,kBAAkB,EAAC,MAAM,2BAA2B,CAAC;AAEtF,OAAO,EAAyB,KAAK,6BAA6B,EAAE,KAAK,4BAA4B,EAAC,MAAM,oBAAoB,CAAC;AACjI,OAAO,EAEH,KAAK,yBAAyB,EAC9B,KAAK,wBAAwB,EAChC,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAGH,KAAK,yBAAyB,EACjC,MAAM,iCAAiC,CAAC;AAEzC,MAAM,WAAW,eAAgB,SAAQ,IAAI,CAAC,eAAe,EAAE,MAAM,CAAC;IAClE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,aAAa,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,4BAA4B;IACzC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,yBAAyB,CAAC;CACvC;AAED,MAAM,WAAW,6BAA6B;IAC1C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAcD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,6BAA6B,GAAG,4BAA4B,CAE1G;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,4BAA4B,GAAG,wBAAwB,CASlG;AAED,MAAM,WAAW,sBAAsB;IACnC,MAAM,EAAE,YAAY,CAAC;IACrB,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,0BAA0B,CAAC,OAAO,GAAE,eAAoB,GAAG,YAAY,CAQtF;AAED,wBAAgB,2BAA2B,CAAC,OAAO,GAAE,eAAoB,GAAG,sBAAsB,CAcjG;AAED,wBAAsB,gBAAgB,CAAC,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,sBAAsB,GAAG;IAAE,YAAY,CAAC,EAAE,kBAAkB,CAAA;CAAE,CAAC,CAoC7I;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,6BAA6B,GAAG,yBAAyB,CAkBrG"}
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAIA,OAAO,EAAgB,KAAK,eAAe,EAAC,MAAM,mBAAmB,CAAC;AACtE,OAAO,EAEH,KAAK,UAAU,EAClB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAmC,KAAK,YAAY,EAAC,MAAM,2BAA2B,CAAC;AAS9F,OAAO,EAAqB,KAAK,kBAAkB,EAAC,MAAM,2BAA2B,CAAC;AAEtF,OAAO,EAAyB,KAAK,6BAA6B,EAAE,KAAK,4BAA4B,EAAC,MAAM,oBAAoB,CAAC;AACjI,OAAO,EAEH,KAAK,yBAAyB,EAC9B,KAAK,wBAAwB,EAChC,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAGH,KAAK,yBAAyB,EACjC,MAAM,iCAAiC,CAAC;AAEzC,MAAM,WAAW,eAAgB,SAAQ,IAAI,CAAC,eAAe,EAAE,MAAM,CAAC;IAClE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,aAAa,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,4BAA4B;IACzC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,yBAAyB,CAAC;CACvC;AAED,MAAM,WAAW,6BAA6B;IAC1C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAcD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,6BAA6B,GAAG,4BAA4B,CAE1G;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,4BAA4B,GAAG,wBAAwB,CASlG;AAED,MAAM,WAAW,sBAAsB;IACnC,MAAM,EAAE,YAAY,CAAC;IACrB,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,0BAA0B,CAAC,OAAO,GAAE,eAAoB,GAAG,YAAY,CAQtF;AAED,wBAAgB,2BAA2B,CAAC,OAAO,GAAE,eAAoB,GAAG,sBAAsB,CAcjG;AAED,wBAAsB,gBAAgB,CAAC,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,sBAAsB,GAAG;IAAE,YAAY,CAAC,EAAE,kBAAkB,CAAA;CAAE,CAAC,CAgD7I;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,6BAA6B,GAAG,yBAAyB,CAkBrG"}

package/dist/api.js

@@ -80,18 +80,30 @@ async function recommendTestsAI(options = {}) {
     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
+        // Collect all known spec paths and scenario details from impacted features
         const specSet = new Set();
+        const specDetailsMap = new Map();
         for (const feature of impact.impactedFeatures) {
             for (const s of feature.playwrightSpecs) {
                 specSet.add(s);
             }
+            for (const detail of feature.playwrightSpecDetails) {
+                if (!specDetailsMap.has(detail.file)) {
+                    specDetailsMap.set(detail.file, detail);
+                }
+            }
+            for (const detail of feature.cypressSpecDetails) {
+                if (!specDetailsMap.has(detail.file)) {
+                    specDetailsMap.set(detail.file, detail);
+                }
+            }
         }
         aiEnrichment = await (0, ai_enrichment_js_1.enrichImpactWithAI)({
             deterministicImpact: impact,
             diffs,
             provider,
             specList: [...specSet],
+            specDetails: [...specDetailsMap.values()],
         });
     }
     const plan = (0, plan_builder_js_1.buildPlanFromImpact)(impact, config.policy, aiEnrichment);

package/dist/engine/ai_enrichment.d.ts

@@ -1,5 +1,5 @@
 import type { LLMProvider } from '../provider_interface.js';
-import type { ImpactResult } from './impact_engine.js';
+import type { ImpactResult, SpecWithScenarios } from './impact_engine.js';
 import type { FeaturePriority } from '../knowledge/route_families.js';
 export interface EnrichedFeature {
     familyId: string;
@@ -33,6 +33,7 @@ export interface AIEnrichmentOptions {
     diffs: Map<string, string>;
     provider: LLMProvider;
     specList: string[];
+    specDetails?: SpecWithScenarios[];
     manifestSummary?: string;
 }
 /**

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

@@ -1 +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;AA0JD;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAkIlG"}
+{"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,EAAmB,iBAAiB,EAAC,MAAM,oBAAoB,CAAC;AACzF,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,WAAW,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAClC,eAAe,CAAC,EAAE,MAAM,CAAC;CAC5B;AAkLD;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAkIlG"}

package/dist/engine/ai_enrichment.js

@@ -11,8 +11,9 @@ function normalizePriority(value) {
     }
     return 'P2';
 }
+const MAX_SCENARIOS_PER_SPEC = 20;
 function buildPrompt(options) {
-    const { deterministicImpact, diffs, specList, manifestSummary } = options;
+    const { deterministicImpact, diffs, specList, specDetails, manifestSummary } = options;
     const { changedFiles, impactedFeatures, unboundFiles } = deterministicImpact;
     const lines = [];
     // Optional manifest summary
@@ -51,8 +52,26 @@ function buildPrompt(options) {
         }
         lines.push('');
     }
-    // Spec list (capped at 50)
-    if (specList.length > 0) {
+    // Spec coverage with scenario titles (when available) or bare file paths
+    if (specDetails && specDetails.length > 0) {
+        const cappedDetails = specDetails.slice(0, MAX_SPEC_LIST);
+        const totalScenarios = cappedDetails.reduce((sum, s) => sum + s.scenarios.length, 0);
+        lines.push(`## Existing Test Coverage (${cappedDetails.length} specs, ${totalScenarios} scenarios)`);
+        lines.push('Use this to avoid suggesting scenarios that already exist.');
+        lines.push('');
+        for (const spec of cappedDetails) {
+            lines.push(`- ${spec.file}`);
+            const cappedScenarios = spec.scenarios.slice(0, MAX_SCENARIOS_PER_SPEC);
+            for (const scenario of cappedScenarios) {
+                lines.push(`  • "${scenario}"`);
+            }
+            if (spec.scenarios.length > MAX_SCENARIOS_PER_SPEC) {
+                lines.push(`  • ... and ${spec.scenarios.length - MAX_SCENARIOS_PER_SPEC} more`);
+            }
+        }
+        lines.push('');
+    }
+    else if (specList.length > 0) {
         const cappedSpecs = specList.slice(0, MAX_SPEC_LIST);
         lines.push(`## Available Test Specs (showing ${cappedSpecs.length} of ${specList.length})`);
         for (const s of cappedSpecs) {
@@ -64,9 +83,14 @@ function buildPrompt(options) {
     lines.push('## Instructions');
     lines.push('Return ONLY valid JSON (no markdown fences, no explanation) in this exact shape:');
     lines.push('');
+    lines.push('Rules for coveredBy:');
+    lines.push('- Reference SPECIFIC scenario titles from the Existing Test Coverage section when possible.');
+    lines.push('- Format: "file.spec.ts → scenario title"');
+    lines.push('');
     lines.push('Rules for missingScenarios:');
+    lines.push('- Cross-reference the scenario titles in Existing Test Coverage. If a scenario already exists that covers the behavior, do NOT suggest it — instead list it in coveredBy.');
     lines.push('- For coverage=uncovered: list all scenarios the feature needs.');
-    lines.push('- For coverage=covered or coverage=partial: ONLY list scenarios introduced by THIS diff that are likely not covered by existing tests. If the diff adds no new user-visible behavior, return []. Do not pad with generic scenarios.');
+    lines.push('- For coverage=covered or coverage=partial: ONLY list scenarios introduced by THIS diff that have NO matching scenario in existing coverage. If the diff adds no new user-visible behavior, return []. Do not pad with generic scenarios.');
     lines.push('');
     lines.push(JSON.stringify({
         impactedFlows: [

package/dist/engine/impact_engine.d.ts

@@ -1,6 +1,10 @@
 import type { FeaturePriority } from '../knowledge/route_families.js';
 import type { RouteFamiliesConfig } from '../agent/config.js';
 export type CoverageStatus = 'covered' | 'partial' | 'uncovered';
+export interface SpecWithScenarios {
+    file: string;
+    scenarios: string[];
+}
 export interface ImpactedFeature {
     familyId: string;
     featureId?: string;
@@ -8,6 +12,8 @@ export interface ImpactedFeature {
     changedFiles: string[];
     playwrightSpecs: string[];
     cypressSpecs: string[];
+    playwrightSpecDetails: SpecWithScenarios[];
+    cypressSpecDetails: SpecWithScenarios[];
     userFlows: string[];
     coverageStatus: CoverageStatus;
 }
@@ -24,6 +30,11 @@ export interface ImpactEngineOptions {
     routeFamilies?: RouteFamiliesConfig;
     expandedFiles?: string[];
 }
+/**
+ * Extract describe/test/it titles from a spec file using regex.
+ * Returns an empty array if the file cannot be read.
+ */
+export declare function extractScenarios(filePath: string, framework: 'playwright' | 'cypress'): string[];
 export declare function analyzeImpact(changedFiles: string[], options: ImpactEngineOptions): ImpactResult;
 /**
  * Get gaps: P0/P1 features with 'uncovered' status.

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

@@ -1 +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;AAwGD,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"}
+{"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,iBAAiB;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,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,qBAAqB,EAAE,iBAAiB,EAAE,CAAC;IAC3C,kBAAkB,EAAE,iBAAiB,EAAE,CAAC;IACxC,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;AA+CD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,YAAY,GAAG,SAAS,GAAG,MAAM,EAAE,CAgBhG;AA0ED,wBAAgB,aAAa,CACzB,YAAY,EAAE,MAAM,EAAE,EACtB,OAAO,EAAE,mBAAmB,GAC7B,YAAY,CA6Ed;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

@@ -2,6 +2,7 @@
 // Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
 // See LICENSE.txt for license information.
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractScenarios = extractScenarios;
 exports.analyzeImpact = analyzeImpact;
 exports.getGaps = getGaps;
 exports.getPartialGaps = getPartialGaps;
@@ -50,15 +51,48 @@ function scanDirForSpecsRecursive(dir, extension) {
     }
     return specs;
 }
+// Regex patterns for extracting test scenario titles from spec files.
+// Playwright uses test() and test.describe(); Cypress uses describe(), context(), it().
+const PLAYWRIGHT_SCENARIO_RE = /(?:test\.describe|test)\(\s*['"`]([^'"`]+)['"`]/g;
+const CYPRESS_SCENARIO_RE = /(?:describe|context|it)\(\s*['"`]([^'"`]+)['"`]/g;
+/**
+ * Extract describe/test/it titles from a spec file using regex.
+ * Returns an empty array if the file cannot be read.
+ */
+function extractScenarios(filePath, framework) {
+    let content;
+    try {
+        content = (0, fs_1.readFileSync)(filePath, 'utf-8');
+    }
+    catch {
+        return [];
+    }
+    const re = framework === 'playwright' ? PLAYWRIGHT_SCENARIO_RE : CYPRESS_SCENARIO_RE;
+    const scenarios = [];
+    let match;
+    // Reset lastIndex in case the regex was used before
+    re.lastIndex = 0;
+    while ((match = re.exec(content)) !== null) {
+        scenarios.push(match[1]);
+    }
+    return scenarios;
+}
 function resolvePlaywrightSpecs(testsRoot, specDirs) {
-    const specs = [];
+    const paths = [];
+    const details = [];
     for (const dir of specDirs) {
-        specs.push(...scanDirForSpecs(testsRoot, dir, '.spec.ts'));
+        const found = scanDirForSpecs(testsRoot, dir, '.spec.ts');
+        for (const relPath of found) {
+            paths.push(relPath);
+            const absPath = (0, path_1.join)(testsRoot, relPath);
+            details.push({ file: relPath, scenarios: extractScenarios(absPath, 'playwright') });
+        }
     }
-    return specs;
+    return { paths, details };
 }
 function resolveCypressSpecs(cypressRoot, specDirs) {
-    const specs = [];
+    const paths = [];
+    const details = [];
     for (const dir of specDirs) {
         // cypressSpecDirs are relative to testsRoot (e.g. ../cypress/tests/integration/channels/search/)
         // Resolve them relative to the cypress root
@@ -68,9 +102,12 @@ function resolveCypressSpecs(cypressRoot, specDirs) {
         }
         const found = scanDirForSpecsRecursive(resolvedDir, '.js');
         const tsFound = scanDirForSpecsRecursive(resolvedDir, '.ts');
-        specs.push(...found, ...tsFound);
+        for (const absPath of [...found, ...tsFound]) {
+            paths.push(absPath);
+            details.push({ file: absPath, scenarios: extractScenarios(absPath, 'cypress') });
+        }
     }
-    return specs;
+    return { paths, details };
 }
 function computeCoverageStatus(pwSpecs, cySpecs) {
     // Playwright is the primary framework — having Playwright specs is sufficient for "covered".
@@ -143,16 +180,18 @@ function analyzeImpact(changedFiles, options) {
         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);
+        const pw = resolvePlaywrightSpecs(testsRoot, specDirs);
+        const cy = cypressRoot ? resolveCypressSpecs(cypressRoot, cypressSpecDirs) : { paths: [], details: [] };
+        const coverageStatus = computeCoverageStatus(pw.paths, cy.paths);
         impactedFeatures.push({
             familyId: group.familyId,
             featureId: group.featureId,
             priority,
             changedFiles: group.files,
-            playwrightSpecs,
-            cypressSpecs,
+            playwrightSpecs: pw.paths,
+            cypressSpecs: cy.paths,
+            playwrightSpecDetails: pw.details,
+            cypressSpecDetails: cy.details,
             userFlows,
             coverageStatus,
         });

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

@@ -1 +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;AAEtE,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,oBAAoB,CAAC;AAG3D,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,EACtC,YAAY,CAAC,EAAE,kBAAkB,GAClC,UAAU,CA0IZ;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,MAAM,CAMzE;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAkGhE;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,SAAiC,GAAG,MAAM,CAMvH"}
+{"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;AAEtE,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,oBAAoB,CAAC;AAG3D,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,EACtC,YAAY,CAAC,EAAE,kBAAkB,GAClC,UAAU,CA0IZ;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,MAAM,CAMzE;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAuGhE;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,SAAiC,GAAG,MAAM,CAMvH"}

package/dist/engine/plan_builder.js

@@ -361,47 +361,52 @@ function renderCiSummaryMarkdown(plan) {
     // ── Blocking gaps ──────────────────────────────────────────────────────────
     if (mustAddTests && plan.requiredNewTests.length > 0) {
         lines.push('');
-        lines.push('### ⚠️ Add E2E tests for these uncovered P0/P1 features');
-        lines.push('');
-        lines.push(`The following ${uncoveredP0P1Flows} feature(s) have no test coverage and must be covered before merge:`);
+        lines.push(`### ⚠️ Missing coverage for ${uncoveredP0P1Flows} P0/P1 flow(s)`);
         lines.push('');
         for (const gap of plan.gapDetails.filter((g) => !g.name.includes('(partial)'))) {
             const aiLabel = gap.source === 'ai+deterministic' ? ' ✦ AI-enriched' : '';
+            // Warning box: name + priority + AI reason (always visible)
             lines.push(`> [!WARNING]`);
             lines.push(`> **${gap.name}** · ${gap.priority}${aiLabel}`);
-            // AI-provided reasons (skip the first generic deterministic reason)
             const aiReasons = gap.reasons.slice(1);
             if (aiReasons.length > 0) {
                 lines.push(`> ${aiReasons.join(' ')}`);
             }
+            lines.push('');
+            // Scenarios: collapsible below the warning box
             if (gap.missingScenarios && gap.missingScenarios.length > 0) {
-                lines.push(`>`);
-                lines.push(`> **Suggested test scenarios:**`);
+                lines.push(`<details><summary>📋 Suggested test scenarios (${gap.missingScenarios.length})</summary>`);
+                lines.push('');
                 for (const scenario of gap.missingScenarios) {
-                    lines.push(`> - [ ] ${scenario}`);
+                    lines.push(`- [ ] ${scenario}`);
                 }
+                lines.push('');
+                lines.push('</details>');
+                lines.push('');
             }
-            lines.push('');
         }
     }
-    // ── Advisory: covered flows with new behavior (collapsible) ─────────────
+    // ── Advisory: covered flows with new behavior ─────────────────────────────
     if (flowsWithAdvisory.length > 0) {
         lines.push('');
-        lines.push(`<details>`);
-        lines.push(`<summary>💡 New behavior detected in ${flowsWithAdvisory.length} covered feature${flowsWithAdvisory.length !== 1 ? 's' : ''} — consider adding tests</summary>`);
-        lines.push('');
-        lines.push('These features already have E2E tests, but this PR introduces new behavior worth covering:');
+        lines.push(`### 💡 New behavior detected in ${flowsWithAdvisory.length} covered feature${flowsWithAdvisory.length !== 1 ? 's' : ''} — consider adding tests`);
         lines.push('');
         for (const flow of flowsWithAdvisory) {
-            lines.push(`#### ${flow.name} · ${flow.priority}`);
-            lines.push(`*${flow.coveredBy.join(', ')}*`);
+            // Green [!TIP] box: just the name (always visible, compact)
+            lines.push(`> [!TIP]`);
+            lines.push(`> **${flow.name}** · ${flow.priority}`);
+            lines.push('');
+            // Specs + scenarios: collapsible below
+            const coverageSummary = flow.coveredBy.join(', ');
+            lines.push(`<details><summary>${coverageSummary} — click to see suggested scenarios</summary>`);
             lines.push('');
             for (const s of flow.advisoryScenarios) {
                 lines.push(`- [ ] ${s}`);
             }
             lines.push('');
+            lines.push('</details>');
+            lines.push('');
         }
-        lines.push('</details>');
     }
     // ── Clean covered flows (collapsed) ───────────────────────────────────────
     if (cleanFlows.length > 0) {

package/dist/esm/api.js

@@ -72,18 +72,30 @@ export async function recommendTestsAI(options = {}) {
     if (apiKey) {
         const diffs = loadDiffs(config.path, config.git.since, gitResult.files);
         const provider = new AnthropicProvider({ apiKey });
-        // Collect all known spec paths from impacted features
+        // Collect all known spec paths and scenario details from impacted features
         const specSet = new Set();
+        const specDetailsMap = new Map();
         for (const feature of impact.impactedFeatures) {
             for (const s of feature.playwrightSpecs) {
                 specSet.add(s);
             }
+            for (const detail of feature.playwrightSpecDetails) {
+                if (!specDetailsMap.has(detail.file)) {
+                    specDetailsMap.set(detail.file, detail);
+                }
+            }
+            for (const detail of feature.cypressSpecDetails) {
+                if (!specDetailsMap.has(detail.file)) {
+                    specDetailsMap.set(detail.file, detail);
+                }
+            }
         }
         aiEnrichment = await enrichImpactWithAI({
             deterministicImpact: impact,
             diffs,
             provider,
             specList: [...specSet],
+            specDetails: [...specDetailsMap.values()],
         });
     }
     const plan = buildPlanFromImpact(impact, config.policy, aiEnrichment);

package/dist/esm/engine/ai_enrichment.js

@@ -8,8 +8,9 @@ function normalizePriority(value) {
     }
     return 'P2';
 }
+const MAX_SCENARIOS_PER_SPEC = 20;
 function buildPrompt(options) {
-    const { deterministicImpact, diffs, specList, manifestSummary } = options;
+    const { deterministicImpact, diffs, specList, specDetails, manifestSummary } = options;
     const { changedFiles, impactedFeatures, unboundFiles } = deterministicImpact;
     const lines = [];
     // Optional manifest summary
@@ -48,8 +49,26 @@ function buildPrompt(options) {
         }
         lines.push('');
     }
-    // Spec list (capped at 50)
-    if (specList.length > 0) {
+    // Spec coverage with scenario titles (when available) or bare file paths
+    if (specDetails && specDetails.length > 0) {
+        const cappedDetails = specDetails.slice(0, MAX_SPEC_LIST);
+        const totalScenarios = cappedDetails.reduce((sum, s) => sum + s.scenarios.length, 0);
+        lines.push(`## Existing Test Coverage (${cappedDetails.length} specs, ${totalScenarios} scenarios)`);
+        lines.push('Use this to avoid suggesting scenarios that already exist.');
+        lines.push('');
+        for (const spec of cappedDetails) {
+            lines.push(`- ${spec.file}`);
+            const cappedScenarios = spec.scenarios.slice(0, MAX_SCENARIOS_PER_SPEC);
+            for (const scenario of cappedScenarios) {
+                lines.push(`  • "${scenario}"`);
+            }
+            if (spec.scenarios.length > MAX_SCENARIOS_PER_SPEC) {
+                lines.push(`  • ... and ${spec.scenarios.length - MAX_SCENARIOS_PER_SPEC} more`);
+            }
+        }
+        lines.push('');
+    }
+    else if (specList.length > 0) {
         const cappedSpecs = specList.slice(0, MAX_SPEC_LIST);
         lines.push(`## Available Test Specs (showing ${cappedSpecs.length} of ${specList.length})`);
         for (const s of cappedSpecs) {
@@ -61,9 +80,14 @@ function buildPrompt(options) {
     lines.push('## Instructions');
     lines.push('Return ONLY valid JSON (no markdown fences, no explanation) in this exact shape:');
     lines.push('');
+    lines.push('Rules for coveredBy:');
+    lines.push('- Reference SPECIFIC scenario titles from the Existing Test Coverage section when possible.');
+    lines.push('- Format: "file.spec.ts → scenario title"');
+    lines.push('');
     lines.push('Rules for missingScenarios:');
+    lines.push('- Cross-reference the scenario titles in Existing Test Coverage. If a scenario already exists that covers the behavior, do NOT suggest it — instead list it in coveredBy.');
     lines.push('- For coverage=uncovered: list all scenarios the feature needs.');
-    lines.push('- For coverage=covered or coverage=partial: ONLY list scenarios introduced by THIS diff that are likely not covered by existing tests. If the diff adds no new user-visible behavior, return []. Do not pad with generic scenarios.');
+    lines.push('- For coverage=covered or coverage=partial: ONLY list scenarios introduced by THIS diff that have NO matching scenario in existing coverage. If the diff adds no new user-visible behavior, return []. Do not pad with generic scenarios.');
     lines.push('');
     lines.push(JSON.stringify({
         impactedFlows: [

package/dist/esm/engine/impact_engine.js

@@ -1,6 +1,6 @@
 // Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
 // See LICENSE.txt for license information.
-import { existsSync, readdirSync } from 'fs';
+import { existsSync, readdirSync, readFileSync } from 'fs';
 import { join } from 'path';
 import { loadRouteFamilyManifest, bindFilesToFamilies, getSpecDirsForBinding, getCypressSpecDirsForBinding, getPriorityForBinding, getUserFlowsForBinding, } from '../knowledge/route_families.js';
 function scanDirForSpecs(baseDir, specDir, extension) {
@@ -45,15 +45,48 @@ function scanDirForSpecsRecursive(dir, extension) {
     }
     return specs;
 }
+// Regex patterns for extracting test scenario titles from spec files.
+// Playwright uses test() and test.describe(); Cypress uses describe(), context(), it().
+const PLAYWRIGHT_SCENARIO_RE = /(?:test\.describe|test)\(\s*['"`]([^'"`]+)['"`]/g;
+const CYPRESS_SCENARIO_RE = /(?:describe|context|it)\(\s*['"`]([^'"`]+)['"`]/g;
+/**
+ * Extract describe/test/it titles from a spec file using regex.
+ * Returns an empty array if the file cannot be read.
+ */
+export function extractScenarios(filePath, framework) {
+    let content;
+    try {
+        content = readFileSync(filePath, 'utf-8');
+    }
+    catch {
+        return [];
+    }
+    const re = framework === 'playwright' ? PLAYWRIGHT_SCENARIO_RE : CYPRESS_SCENARIO_RE;
+    const scenarios = [];
+    let match;
+    // Reset lastIndex in case the regex was used before
+    re.lastIndex = 0;
+    while ((match = re.exec(content)) !== null) {
+        scenarios.push(match[1]);
+    }
+    return scenarios;
+}
 function resolvePlaywrightSpecs(testsRoot, specDirs) {
-    const specs = [];
+    const paths = [];
+    const details = [];
     for (const dir of specDirs) {
-        specs.push(...scanDirForSpecs(testsRoot, dir, '.spec.ts'));
+        const found = scanDirForSpecs(testsRoot, dir, '.spec.ts');
+        for (const relPath of found) {
+            paths.push(relPath);
+            const absPath = join(testsRoot, relPath);
+            details.push({ file: relPath, scenarios: extractScenarios(absPath, 'playwright') });
+        }
     }
-    return specs;
+    return { paths, details };
 }
 function resolveCypressSpecs(cypressRoot, specDirs) {
-    const specs = [];
+    const paths = [];
+    const details = [];
     for (const dir of specDirs) {
         // cypressSpecDirs are relative to testsRoot (e.g. ../cypress/tests/integration/channels/search/)
         // Resolve them relative to the cypress root
@@ -63,9 +96,12 @@ function resolveCypressSpecs(cypressRoot, specDirs) {
         }
         const found = scanDirForSpecsRecursive(resolvedDir, '.js');
         const tsFound = scanDirForSpecsRecursive(resolvedDir, '.ts');
-        specs.push(...found, ...tsFound);
+        for (const absPath of [...found, ...tsFound]) {
+            paths.push(absPath);
+            details.push({ file: absPath, scenarios: extractScenarios(absPath, 'cypress') });
+        }
     }
-    return specs;
+    return { paths, details };
 }
 function computeCoverageStatus(pwSpecs, cySpecs) {
     // Playwright is the primary framework — having Playwright specs is sufficient for "covered".
@@ -138,16 +174,18 @@ export function analyzeImpact(changedFiles, options) {
         const cypressSpecDirs = getCypressSpecDirsForBinding(manifest, binding);
         const priority = getPriorityForBinding(manifest, binding);
         const userFlows = getUserFlowsForBinding(manifest, binding);
-        const playwrightSpecs = resolvePlaywrightSpecs(testsRoot, specDirs);
-        const cypressSpecs = cypressRoot ? resolveCypressSpecs(cypressRoot, cypressSpecDirs) : [];
-        const coverageStatus = computeCoverageStatus(playwrightSpecs, cypressSpecs);
+        const pw = resolvePlaywrightSpecs(testsRoot, specDirs);
+        const cy = cypressRoot ? resolveCypressSpecs(cypressRoot, cypressSpecDirs) : { paths: [], details: [] };
+        const coverageStatus = computeCoverageStatus(pw.paths, cy.paths);
         impactedFeatures.push({
             familyId: group.familyId,
             featureId: group.featureId,
             priority,
             changedFiles: group.files,
-            playwrightSpecs,
-            cypressSpecs,
+            playwrightSpecs: pw.paths,
+            cypressSpecs: cy.paths,
+            playwrightSpecDetails: pw.details,
+            cypressSpecDetails: cy.details,
             userFlows,
             coverageStatus,
         });

package/dist/esm/engine/plan_builder.js

@@ -355,47 +355,52 @@ export function renderCiSummaryMarkdown(plan) {
     // ── Blocking gaps ──────────────────────────────────────────────────────────
     if (mustAddTests && plan.requiredNewTests.length > 0) {
         lines.push('');
-        lines.push('### ⚠️ Add E2E tests for these uncovered P0/P1 features');
-        lines.push('');
-        lines.push(`The following ${uncoveredP0P1Flows} feature(s) have no test coverage and must be covered before merge:`);
+        lines.push(`### ⚠️ Missing coverage for ${uncoveredP0P1Flows} P0/P1 flow(s)`);
         lines.push('');
         for (const gap of plan.gapDetails.filter((g) => !g.name.includes('(partial)'))) {
             const aiLabel = gap.source === 'ai+deterministic' ? ' ✦ AI-enriched' : '';
+            // Warning box: name + priority + AI reason (always visible)
             lines.push(`> [!WARNING]`);
             lines.push(`> **${gap.name}** · ${gap.priority}${aiLabel}`);
-            // AI-provided reasons (skip the first generic deterministic reason)
             const aiReasons = gap.reasons.slice(1);
             if (aiReasons.length > 0) {
                 lines.push(`> ${aiReasons.join(' ')}`);
             }
+            lines.push('');
+            // Scenarios: collapsible below the warning box
             if (gap.missingScenarios && gap.missingScenarios.length > 0) {
-                lines.push(`>`);
-                lines.push(`> **Suggested test scenarios:**`);
+                lines.push(`<details><summary>📋 Suggested test scenarios (${gap.missingScenarios.length})</summary>`);
+                lines.push('');
                 for (const scenario of gap.missingScenarios) {
-                    lines.push(`> - [ ] ${scenario}`);
+                    lines.push(`- [ ] ${scenario}`);
                 }
+                lines.push('');
+                lines.push('</details>');
+                lines.push('');
             }
-            lines.push('');
         }
     }
-    // ── Advisory: covered flows with new behavior (collapsible) ─────────────
+    // ── Advisory: covered flows with new behavior ─────────────────────────────
     if (flowsWithAdvisory.length > 0) {
         lines.push('');
-        lines.push(`<details>`);
-        lines.push(`<summary>💡 New behavior detected in ${flowsWithAdvisory.length} covered feature${flowsWithAdvisory.length !== 1 ? 's' : ''} — consider adding tests</summary>`);
-        lines.push('');
-        lines.push('These features already have E2E tests, but this PR introduces new behavior worth covering:');
+        lines.push(`### 💡 New behavior detected in ${flowsWithAdvisory.length} covered feature${flowsWithAdvisory.length !== 1 ? 's' : ''} — consider adding tests`);
         lines.push('');
         for (const flow of flowsWithAdvisory) {
-            lines.push(`#### ${flow.name} · ${flow.priority}`);
-            lines.push(`*${flow.coveredBy.join(', ')}*`);
+            // Green [!TIP] box: just the name (always visible, compact)
+            lines.push(`> [!TIP]`);
+            lines.push(`> **${flow.name}** · ${flow.priority}`);
+            lines.push('');
+            // Specs + scenarios: collapsible below
+            const coverageSummary = flow.coveredBy.join(', ');
+            lines.push(`<details><summary>${coverageSummary} — click to see suggested scenarios</summary>`);
             lines.push('');
             for (const s of flow.advisoryScenarios) {
                 lines.push(`- [ ] ${s}`);
             }
             lines.push('');
+            lines.push('</details>');
+            lines.push('');
         }
-        lines.push('</details>');
     }
     // ── Clean covered flows (collapsed) ───────────────────────────────────────
     if (cleanFlows.length > 0) {

package/dist/esm/index.js

@@ -12,6 +12,7 @@ export { LLMProviderFactory, validateProviderSetup } from './provider_factory.js
 export { analyzeImpactDeterministic, recommendTestsDeterministic, handoffGeneratedTests, ingestTraceability, captureTraceability } from './api.js';
 // V2 Engine (deterministic impact + plan)
 export { analyzeImpact as analyzeImpactV2, getGaps, getPartialGaps } from './engine/impact_engine.js';
+export { extractScenarios } from './engine/impact_engine.js';
 export { buildPlanFromImpact } from './engine/plan_builder.js';
 export { appendFeedbackAndRecompute, readCalibration } from './agent/feedback.js';
 export { finalizeGeneratedTests } from './agent/handoff.js';

package/dist/index.d.ts

@@ -21,7 +21,8 @@ export type { HybridConfig } from './provider_factory.js';
 export { analyzeImpactDeterministic, recommendTestsDeterministic, handoffGeneratedTests, ingestTraceability, captureTraceability } from './api.js';
 export type { AgentApiOptions, RecommendTestsV2Result, TraceabilityIngestApiOptions, TraceabilityCaptureApiOptions, } from './api.js';
 export { analyzeImpact as analyzeImpactV2, getGaps, getPartialGaps } from './engine/impact_engine.js';
-export type { ImpactResult, ImpactedFeature, CoverageStatus, ImpactEngineOptions } from './engine/impact_engine.js';
+export type { ImpactResult, ImpactedFeature, CoverageStatus, ImpactEngineOptions, SpecWithScenarios } from './engine/impact_engine.js';
+export { extractScenarios } from './engine/impact_engine.js';
 export { buildPlanFromImpact } from './engine/plan_builder.js';
 export { appendFeedbackAndRecompute, readCalibration } from './agent/feedback.js';
 export type { RecommendationFeedbackEntry, CalibrationSummary } from './agent/feedback.js';

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -2,7 +2,7 @@
 // Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
 // See LICENSE.txt for license information.
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getSpecsForFamily = exports.buildSpecIndex = exports.loadOrBuildApiSurface = exports.buildApiSurface = exports.getUserFlowsForBinding = exports.getPriorityForBinding = exports.getCypressSpecDirsForBinding = exports.bindFilesToFamilies = exports.loadRouteFamilyManifest = exports.buildQualityFixPrompt = exports.buildHealPrompt = exports.renderHealMarkdown = exports.resolveHealTargets = exports.healFromReport = exports.runHealStage = exports.detectHallucinatedMethods = exports.parseGenerationResponse = exports.buildGenerationPrompt = exports.runGenerationStage = exports.runPipeline = exports.captureTraceabilityInput = exports.ingestTraceabilityInput = exports.finalizeGeneratedTests = exports.readCalibration = exports.appendFeedbackAndRecompute = exports.buildPlanFromImpact = exports.getPartialGaps = exports.getGaps = exports.analyzeImpactV2 = exports.captureTraceability = exports.ingestTraceability = exports.handoffGeneratedTests = exports.recommendTestsDeterministic = exports.analyzeImpactDeterministic = exports.validateProviderSetup = exports.LLMProviderFactory = exports.CustomProvider = exports.checkOpenAISetup = exports.OpenAIProvider = exports.checkOllamaSetup = exports.OllamaProvider = exports.checkAnthropicSetup = exports.AnthropicProvider = exports.UnsupportedCapabilityError = exports.LLMProviderError = void 0;
+exports.getSpecsForFamily = exports.buildSpecIndex = exports.loadOrBuildApiSurface = exports.buildApiSurface = exports.getUserFlowsForBinding = exports.getPriorityForBinding = exports.getCypressSpecDirsForBinding = exports.bindFilesToFamilies = exports.loadRouteFamilyManifest = exports.buildQualityFixPrompt = exports.buildHealPrompt = exports.renderHealMarkdown = exports.resolveHealTargets = exports.healFromReport = exports.runHealStage = exports.detectHallucinatedMethods = exports.parseGenerationResponse = exports.buildGenerationPrompt = exports.runGenerationStage = exports.runPipeline = exports.captureTraceabilityInput = exports.ingestTraceabilityInput = exports.finalizeGeneratedTests = exports.readCalibration = exports.appendFeedbackAndRecompute = exports.buildPlanFromImpact = exports.extractScenarios = exports.getPartialGaps = exports.getGaps = exports.analyzeImpactV2 = exports.captureTraceability = exports.ingestTraceability = exports.handoffGeneratedTests = exports.recommendTestsDeterministic = exports.analyzeImpactDeterministic = exports.validateProviderSetup = exports.LLMProviderFactory = exports.CustomProvider = exports.checkOpenAISetup = exports.OpenAIProvider = exports.checkOllamaSetup = exports.OllamaProvider = exports.checkAnthropicSetup = exports.AnthropicProvider = exports.UnsupportedCapabilityError = exports.LLMProviderError = void 0;
 var provider_interface_js_1 = require("./provider_interface.js");
 Object.defineProperty(exports, "LLMProviderError", { enumerable: true, get: function () { return provider_interface_js_1.LLMProviderError; } });
 Object.defineProperty(exports, "UnsupportedCapabilityError", { enumerable: true, get: function () { return provider_interface_js_1.UnsupportedCapabilityError; } });
@@ -34,6 +34,8 @@ var impact_engine_js_1 = require("./engine/impact_engine.js");
 Object.defineProperty(exports, "analyzeImpactV2", { enumerable: true, get: function () { return impact_engine_js_1.analyzeImpact; } });
 Object.defineProperty(exports, "getGaps", { enumerable: true, get: function () { return impact_engine_js_1.getGaps; } });
 Object.defineProperty(exports, "getPartialGaps", { enumerable: true, get: function () { return impact_engine_js_1.getPartialGaps; } });
+var impact_engine_js_2 = require("./engine/impact_engine.js");
+Object.defineProperty(exports, "extractScenarios", { enumerable: true, get: function () { return impact_engine_js_2.extractScenarios; } });
 var plan_builder_js_1 = require("./engine/plan_builder.js");
 Object.defineProperty(exports, "buildPlanFromImpact", { enumerable: true, get: function () { return plan_builder_js_1.buildPlanFromImpact; } });
 var feedback_js_1 = require("./agent/feedback.js");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yasserkhanorg/e2e-agents",
-  "version": "0.7.6",
+  "version": "0.8.0",
   "description": "Pluggable LLM provider library for AI-powered test automation. Use Claude, Ollama, or your own LLM. Integrate with Playwright, Jest, or any test framework. MCP server for test agents, cost tracking, and hybrid provider mode.",
   "main": "dist/index.js",
   "module": "dist/esm/index.js",