@yasserkhanorg/e2e-agents 1.7.5 → 1.7.7

package/dist/agent/git.d.ts

@@ -1,7 +1,7 @@
 export interface GitChangeResult {
     files: string[];
-    /** All files from the diff before relevance filtering (includes test files, config, etc.). */
-    allFiles?: string[];
+    /** Test/spec files from the diff that were filtered by isRelevantFile(). Only includes files matching TEST_FILE_PATTERNS — not config, docs, or other non-test filtered files. */
+    filteredTestFiles: string[];
     error?: string;
     baseRef?: string;
     baseStrategy?: 'merge-base' | 'direct';

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

@@ -1 +1 @@
-{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../src/agent/git.ts"],"names":[],"mappings":"AAkHA,MAAM,WAAW,eAAe;IAC5B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,8FAA8F;IAC9F,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,YAAY,GAAG,QAAQ,CAAC;CAC1C;AAED,MAAM,WAAW,gBAAgB;IAC7B,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAChC;AA8CD,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,eAAe,CA4C3G"}
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../src/agent/git.ts"],"names":[],"mappings":"AAkHA,MAAM,WAAW,eAAe;IAC5B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,kLAAkL;IAClL,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,YAAY,GAAG,QAAQ,CAAC;CAC1C;AAED,MAAM,WAAW,gBAAgB;IAC7B,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAChC;AAiFD,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,eAAe,CA8D3G"}

package/dist/agent/git.js

@@ -146,6 +146,38 @@ function parseStatusLines(lines) {
     }
     return files;
 }
+// Comment-line patterns by file extension.
+// A diff that ONLY touches these lines is a comment-only change (typo fix, doc update).
+const COMMENT_PATTERNS = [
+    { extensions: ['.go'], pattern: /^\s*(\/\/|\/\*|\*)/ },
+    { extensions: ['.ts', '.tsx', '.js', '.jsx'], pattern: /^\s*(\/\/|\/\*|\*|\*\/)/ },
+    { extensions: ['.py'], pattern: /^\s*#/ },
+    { extensions: ['.css', '.scss'], pattern: /^\s*(\/\*|\*|\*\/)/ },
+];
+/**
+ * Check if a file's diff only changes comment lines (no code changes).
+ * Returns true if the diff is comment-only and can be safely excluded.
+ */
+function isCommentOnlyDiff(file, repoRoot, baseRef) {
+    const diff = runGitRaw(['diff', `${baseRef}..HEAD`, '-U0', '--', file], repoRoot);
+    if (!diff)
+        return false;
+    const ext = file.slice(file.lastIndexOf('.'));
+    const commentEntry = COMMENT_PATTERNS.find((cp) => cp.extensions.includes(ext));
+    if (!commentEntry)
+        return false;
+    // Extract only added/removed content lines (skip diff headers)
+    const contentLines = diff
+        .split('\n')
+        .filter((line) => (line.startsWith('+') || line.startsWith('-')) && !line.startsWith('+++') && !line.startsWith('---'));
+    if (contentLines.length === 0)
+        return false;
+    // Every changed line must be a comment line
+    return contentLines.every((line) => {
+        const content = line.slice(1).trim(); // Remove +/- prefix
+        return content === '' || commentEntry.pattern.test(content);
+    });
+}
 function getChangedFiles(appRoot, since, options) {
     try {
         const files = new Set();
@@ -167,7 +199,7 @@ function getChangedFiles(appRoot, since, options) {
         const repoRoot = runGitRaw(['rev-parse', '--show-toplevel'], appRoot)?.trim() || appRoot;
         const diffFiles = runGit(['diff', '--name-only', `${baseRef}..HEAD`], repoRoot);
         if (!diffFiles) {
-            return { files: [], error: 'git diff failed' };
+            return { files: [], filteredTestFiles: [], error: 'git diff failed' };
         }
         diffFiles.forEach((file) => files.add(file));
         if (options?.includeUncommitted) {
@@ -182,9 +214,28 @@ function getChangedFiles(appRoot, since, options) {
             }
         }
         const allFiles = Array.from(files);
-        return { files: allFiles.filter(isRelevantFile), allFiles, baseRef, baseStrategy };
+        const relevant = [];
+        const filteredTestFiles = [];
+        for (const f of allFiles) {
+            if (isRelevantFile(f)) {
+                // Skip files where the diff only touches comments (typo fixes, doc updates)
+                if (isCommentOnlyDiff(f, repoRoot, baseRef)) {
+                    continue;
+                }
+                relevant.push(f);
+            }
+            else {
+                // Only capture files that were filtered because they match test patterns.
+                // Config, docs, workflow files etc. are not useful for PR-test detection.
+                const basename = f.split('/').pop() || f;
+                if (TEST_FILE_PATTERNS.some((p) => p.test(basename))) {
+                    filteredTestFiles.push(f);
+                }
+            }
+        }
+        return { files: relevant, filteredTestFiles, baseRef, baseStrategy };
     }
     catch {
-        return { files: [], error: 'git diff failed' };
+        return { files: [], filteredTestFiles: [], error: 'git diff failed' };
     }
 }

package/dist/api.js

@@ -51,7 +51,7 @@ function analyzeImpactDeterministic(options = {}) {
     return (0, impact_engine_js_1.analyzeImpact)(gitResult.files, {
         testsRoot: reportRoot,
         routeFamilies: config.routeFamilies,
-        allFiles: gitResult.allFiles,
+        filteredTestFiles: gitResult.filteredTestFiles,
     });
 }
 function recommendTestsDeterministic(options = {}) {
@@ -61,7 +61,7 @@ function recommendTestsDeterministic(options = {}) {
     const impact = (0, impact_engine_js_1.analyzeImpact)(gitResult.files, {
         testsRoot: reportRoot,
         routeFamilies: config.routeFamilies,
-        allFiles: gitResult.allFiles,
+        filteredTestFiles: gitResult.filteredTestFiles,
     });
     const adaptive = (0, feedback_js_1.getAdaptiveThresholds)(reportRoot);
     const plan = (0, plan_builder_js_1.buildPlanFromImpact)(impact, config.policy, undefined, adaptive);
@@ -78,7 +78,7 @@ async function recommendTestsAI(options = {}) {
     const impact = (0, impact_engine_js_1.analyzeImpact)(gitResult.files, {
         testsRoot: reportRoot,
         routeFamilies: config.routeFamilies,
-        allFiles: gitResult.allFiles,
+        filteredTestFiles: gitResult.filteredTestFiles,
     });
     const apiKey = process.env.ANTHROPIC_API_KEY;
     let aiEnrichment;

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,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;AAmLD;;;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;AAoLD;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAkIlG"}

package/dist/engine/ai_enrichment.js

@@ -41,7 +41,8 @@ function buildPrompt(options) {
         const specCount = feature.playwrightSpecs.length + feature.cypressSpecs.length;
         const specList2 = [...feature.playwrightSpecs, ...feature.cypressSpecs];
         const specsDisplay = specList2.length > 0 ? specList2.join(', ') : 'none';
-        lines.push(`- familyId=${feature.familyId} ${featureIdPart} (${feature.priority}): ${specCount} files, coverage=${feature.coverageStatus}, specs=[${specsDisplay}]`);
+        const userFlowsDisplay = feature.userFlows.length > 0 ? ` userFlows=[${feature.userFlows.slice(0, 5).join(', ')}]` : '';
+        lines.push(`- familyId=${feature.familyId} ${featureIdPart} (${feature.priority}): ${specCount} specs, coverage=${feature.coverageStatus}, specs=[${specsDisplay}]${userFlowsDisplay}`);
     }
     lines.push('');
     // Unbound files

package/dist/engine/impact_engine.d.ts

@@ -36,8 +36,8 @@ export interface ImpactEngineOptions {
     cypressRoot?: string;
     routeFamilies?: RouteFamiliesConfig;
     expandedFiles?: string[];
-    /** Full unfiltered file list from git diff (includes test files). Used to detect PR-included E2E specs. */
-    allFiles?: string[];
+    /** Test files that were filtered by the caller (e.g. isRelevantFile in git.ts). Used to detect PR-included E2E specs. */
+    filteredTestFiles?: string[];
 }
 /**
  * Extract describe/test/it titles from a spec file using regex.
@@ -45,13 +45,24 @@ export interface ImpactEngineOptions {
  */
 export declare function extractScenarios(filePath: string, framework: 'playwright' | 'cypress'): string[];
 export declare function analyzeImpact(changedFiles: string[], options: ImpactEngineOptions): ImpactResult;
+export interface GapResult {
+    /** Active gaps that should be reported/enforced. */
+    gaps: ImpactedFeature[];
+    /** Family-level gaps suppressed because all their files are covered by specific feature matches. These should be promoted to advisory. */
+    suppressedGaps: ImpactedFeature[];
+}
 /**
  * Get gaps: P0/P1 features with 'uncovered' status.
  *
  * Suppresses family-level (generic) gaps when ALL their changed files are
  * already covered by feature-level (specific) matches in other families.
- * This prevents double-counting when a file like `policies.tsx` matches both
- * a generic family (`config`) and a specific feature (`system_console/permissions`).
+ * Suppressed gaps are returned separately so the plan builder can promote
+ * them to advisory ("new behavior detected") on covered flows.
+ */
+export declare function getGapsWithSuppressed(result: ImpactResult): GapResult;
+/**
+ * Get gaps: P0/P1 features with 'uncovered' status.
+ * Convenience wrapper that returns only active gaps (backward-compatible).
  */
 export declare function getGaps(result: ImpactResult): ImpactedFeature[];
 /**

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,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,MAAM,cAAc,GAAG,YAAY,GAAG,SAAS,GAAG,MAAM,GAAG,UAAU,CAAC;AAE5E,MAAM,WAAW,UAAU;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,cAAc,CAAC;CACxB;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;IACnB,oFAAoF;IACpF,mBAAmB,EAAE,UAAU,EAAE,CAAC;CACrC;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;IACzB,2GAA2G;IAC3G,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AA+CD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,YAAY,GAAG,SAAS,GAAG,MAAM,EAAE,CAgBhG;AA0GD,wBAAgB,aAAa,CACzB,YAAY,EAAE,MAAM,EAAE,EACtB,OAAO,EAAE,mBAAmB,GAC7B,YAAY,CAwFd;AAYD;;;;;;;GAOG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,YAAY,GAAG,eAAe,EAAE,CAuB/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,MAAM,cAAc,GAAG,YAAY,GAAG,SAAS,GAAG,MAAM,GAAG,UAAU,CAAC;AAE5E,MAAM,WAAW,UAAU;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,cAAc,CAAC;CACxB;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;IACnB,oFAAoF;IACpF,mBAAmB,EAAE,UAAU,EAAE,CAAC;CACrC;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;IACzB,yHAAyH;IACzH,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;CAChC;AA+CD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,YAAY,GAAG,SAAS,GAAG,MAAM,EAAE,CAgBhG;AA0GD,wBAAgB,aAAa,CACzB,YAAY,EAAE,MAAM,EAAE,EACtB,OAAO,EAAE,mBAAmB,GAC7B,YAAY,CAuFd;AAYD,MAAM,WAAW,SAAS;IACtB,oDAAoD;IACpD,IAAI,EAAE,eAAe,EAAE,CAAC;IACxB,0IAA0I;IAC1I,cAAc,EAAE,eAAe,EAAE,CAAC;CACrC;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,YAAY,GAAG,SAAS,CA2BrE;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,YAAY,GAAG,eAAe,EAAE,CAE/D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,eAAe,EAAE,CAItE"}

package/dist/engine/impact_engine.js

@@ -4,6 +4,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.extractScenarios = extractScenarios;
 exports.analyzeImpact = analyzeImpact;
+exports.getGapsWithSuppressed = getGapsWithSuppressed;
 exports.getGaps = getGaps;
 exports.getPartialGaps = getPartialGaps;
 const fs_1 = require("fs");
@@ -180,11 +181,10 @@ function analyzeImpact(changedFiles, options) {
     const { testsRoot, routeFamilies } = options;
     const warnings = [];
     // Partition into source files and test files.
-    // When allFiles is provided (from git.ts before relevance filtering), use it
-    // to capture test files that were pre-filtered by the caller.
-    const allOriginalFiles = options.allFiles && options.allFiles.length > 0
-        ? [...new Set([...options.allFiles, ...changedFiles])]
-        : [...changedFiles];
+    // Combine: (a) test files already in changedFiles that isTestFile catches, and
+    // (b) test files pre-filtered by the caller (filteredTestFiles from git.ts).
+    const preFilteredTests = options.filteredTestFiles ?? [];
+    const allOriginalFiles = [...new Set([...changedFiles, ...preFilteredTests])];
     changedFiles = changedFiles.filter((f) => !isTestFile(f));
     const prIncludedTestFiles = classifyPrTestFiles(allOriginalFiles, changedFiles);
     // Load manifest
@@ -267,10 +267,10 @@ function inferCypressRoot(testsRoot) {
  *
  * Suppresses family-level (generic) gaps when ALL their changed files are
  * already covered by feature-level (specific) matches in other families.
- * This prevents double-counting when a file like `policies.tsx` matches both
- * a generic family (`config`) and a specific feature (`system_console/permissions`).
+ * Suppressed gaps are returned separately so the plan builder can promote
+ * them to advisory ("new behavior detected") on covered flows.
  */
-function getGaps(result) {
+function getGapsWithSuppressed(result) {
     // Collect files that are covered via feature-level matches (more specific)
     const filesCoveredByFeatures = new Set();
     for (const f of result.impactedFeatures) {
@@ -280,18 +280,29 @@ function getGaps(result) {
             }
         }
     }
-    return result.impactedFeatures.filter((f) => {
+    const gaps = [];
+    const suppressedGaps = [];
+    for (const f of result.impactedFeatures) {
         if (f.priority !== 'P0' && f.priority !== 'P1')
-            return false;
+            continue;
         if (f.coverageStatus !== 'uncovered')
-            return false;
+            continue;
         // Only suppress FAMILY-level gaps (no featureId = generic match).
-        // If it's a feature-level gap, keep it — it's specific and intentional.
         if (!f.featureId && f.changedFiles.every((file) => filesCoveredByFeatures.has(file))) {
-            return false;
+            suppressedGaps.push(f);
         }
-        return true;
-    });
+        else {
+            gaps.push(f);
+        }
+    }
+    return { gaps, suppressedGaps };
+}
+/**
+ * Get gaps: P0/P1 features with 'uncovered' status.
+ * Convenience wrapper that returns only active gaps (backward-compatible).
+ */
+function getGaps(result) {
+    return getGapsWithSuppressed(result).gaps;
 }
 /**
  * Get partial gaps: P0/P1 features with 'partial' status (advisory).

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;AAErD,OAAO,KAAK,EAAC,YAAY,EAAkB,MAAM,oBAAoB,CAAC;AAEtE,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,sBAAsB,CAAC;AAG7D,OAAO,KAAK,EACR,UAAU,EACV,SAAS,EACT,kBAAkB,EAIrB,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EAAC,UAAU,EAAE,SAAS,EAAE,kBAAkB,EAAC,CAAC;AAgQxD,wBAAgB,mBAAmB,CAC/B,MAAM,EAAE,YAAY,EACpB,cAAc,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,EACtC,YAAY,CAAC,EAAE,kBAAkB,EACjC,kBAAkB,CAAC,EAAE,kBAAkB,GACxC,UAAU,CAyKZ;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,MAAM,CAMzE;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CA4IhE;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;AAErD,OAAO,KAAK,EAAC,YAAY,EAA8B,MAAM,oBAAoB,CAAC;AAGlF,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,sBAAsB,CAAC;AAG7D,OAAO,KAAK,EACR,UAAU,EACV,SAAS,EACT,kBAAkB,EAIrB,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EAAC,UAAU,EAAE,SAAS,EAAE,kBAAkB,EAAC,CAAC;AAsUxD,wBAAgB,mBAAmB,CAC/B,MAAM,EAAE,YAAY,EACpB,cAAc,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,EACtC,YAAY,CAAC,EAAE,kBAAkB,EACjC,kBAAkB,CAAC,EAAE,kBAAkB,GACxC,UAAU,CA6LZ;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,MAAM,CAMzE;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CA4IhE;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,SAAiC,GAAG,MAAM,CAMvH"}

package/dist/engine/plan_builder.js

@@ -11,6 +11,7 @@ const path_1 = require("path");
 const minimatch_1 = require("minimatch");
 const test_path_js_1 = require("../agent/test_path.js");
 const impact_engine_js_1 = require("./impact_engine.js");
+const route_families_js_1 = require("../knowledge/route_families.js");
 const DEFAULT_POLICY = {
     minConfidenceForTargeted: 60,
     safeMergeMinConfidence: 85,
@@ -111,17 +112,73 @@ function pickRunSet(impact, confidence, policy) {
         riskyFiles,
     };
 }
+/**
+ * Check which gaps have matching PR-included E2E spec files by binding
+ * spec files to families via the manifest. Returns familyIds that are covered.
+ */
+function matchPrSpecsToGaps(prTestFiles, gaps, testsRoot) {
+    const coveredFamilies = new Set();
+    const prE2ESpecs = prTestFiles.filter((t) => t.type === 'playwright' || t.type === 'cypress');
+    if (prE2ESpecs.length === 0 || !testsRoot) {
+        return coveredFamilies;
+    }
+    // Try to bind PR spec files to families via the manifest
+    const manifest = (0, route_families_js_1.loadRouteFamilyManifest)(testsRoot);
+    if (manifest) {
+        const specBindings = (0, route_families_js_1.bindFilesToFamilies)(prE2ESpecs.map((s) => s.file), manifest);
+        for (const sb of specBindings) {
+            for (const binding of sb.bindings) {
+                coveredFamilies.add(binding.family);
+            }
+        }
+    }
+    // Fallback heuristic: if manifest binding didn't match (common for Cypress specs
+    // in directories not mapped in the manifest), check path-based keyword overlap.
+    if (coveredFamilies.size === 0) {
+        const gapFamilyIds = new Set(gaps.map((g) => g.familyId));
+        for (const spec of prE2ESpecs) {
+            const specLower = spec.file.toLowerCase().replace(/[_\-/\\]/g, ' ');
+            for (const familyId of gapFamilyIds) {
+                // Check if the spec path contains the family name or related terms
+                if (specLower.includes(familyId.toLowerCase())) {
+                    coveredFamilies.add(familyId);
+                }
+            }
+        }
+    }
+    return coveredFamilies;
+}
 function buildDecision(impact, runSet, confidence, policy) {
-    const gaps = (0, impact_engine_js_1.getGaps)(impact);
+    const gaps = (0, impact_engine_js_1.getGapsWithSuppressed)(impact).gaps;
     if (gaps.length > 0) {
-        // Check if PR already includes E2E test files that likely cover the gaps
-        const prE2ESpecCount = (impact.prIncludedTestFiles ?? [])
-            .filter((t) => t.type === 'playwright' || t.type === 'cypress').length;
-        if (prE2ESpecCount > 0) {
+        const prE2ESpecs = (impact.prIncludedTestFiles ?? [])
+            .filter((t) => t.type === 'playwright' || t.type === 'cypress');
+        if (prE2ESpecs.length > 0) {
+            // Bind PR specs to families — only soften gaps that have matching specs
+            const coveredFamilies = matchPrSpecsToGaps(impact.prIncludedTestFiles ?? [], gaps);
+            const uncoveredGaps = gaps.filter((g) => !coveredFamilies.has(g.familyId));
+            if (uncoveredGaps.length === 0) {
+                // ALL gaps have matching PR specs
+                return {
+                    action: 'run-now',
+                    title: 'Run now',
+                    summary: `Detected ${gaps.length} coverage gap(s), but the PR includes ${prE2ESpecs.length} E2E test file(s) covering them. Verify the new tests cover impacted flows.`,
+                };
+            }
+            if (uncoveredGaps.length < gaps.length) {
+                // SOME gaps covered by PR specs, others not
+                return {
+                    action: 'must-add-tests',
+                    title: 'Must add tests',
+                    summary: `Detected ${gaps.length} coverage gap(s). PR includes E2E tests for ${gaps.length - uncoveredGaps.length}, but ${uncoveredGaps.length} flow(s) still need coverage.`,
+                };
+            }
+            // No gaps matched by PR specs — but PR still has E2E files.
+            // Soften to run-now since the developer is actively writing tests.
             return {
                 action: 'run-now',
                 title: 'Run now',
-                summary: `Detected ${gaps.length} coverage gap(s), but the PR includes ${prE2ESpecCount} E2E test file(s). Verify the new tests cover impacted flows.`,
+                summary: `Detected ${gaps.length} coverage gap(s), but the PR includes ${prE2ESpecs.length} E2E test file(s). Verify the new tests cover impacted flows.`,
             };
         }
         return {
@@ -239,7 +296,7 @@ function buildPlanFromImpact(impact, policyOverride, aiEnrichment, adaptiveThres
     const runSetResult = pickRunSet(impact, confidence, policy);
     const decision = buildDecision(impact, runSetResult.runSet, confidence, policy);
     const enforcement = evaluateEnforcement(decision, policy);
-    const gaps = (0, impact_engine_js_1.getGaps)(impact);
+    const { gaps, suppressedGaps } = (0, impact_engine_js_1.getGapsWithSuppressed)(impact);
     const partialGaps = (0, impact_engine_js_1.getPartialGaps)(impact);
     // Build two separate lookup maps from aiEnrichment: one by featureId, one by familyId.
     // The familyId map stores only the FIRST feature encountered to avoid last-write-wins collisions.
@@ -324,9 +381,27 @@ function buildPlanFromImpact(impact, policyOverride, aiEnrichment, adaptiveThres
             ? (aiFeatureByFeatureId.get(f.featureId) ?? aiFeatureByFamilyId.get(f.familyId))
             : aiFeatureByFamilyId.get(f.familyId);
         // Only surface advisory scenarios when AI found new behavior in this diff
-        const advisoryScenarios = aiFeature?.aiMissingScenarios?.length
-            ? aiFeature.aiMissingScenarios
+        let advisoryScenarios = aiFeature?.aiMissingScenarios?.length
+            ? [...aiFeature.aiMissingScenarios]
             : undefined;
+        // Promote suppressed gaps to advisory on covered flows that share changed files.
+        // When a family-level gap is suppressed (e.g. "post" because post.go is also in
+        // a covered feature like "channels/threads"), the behavioral change should appear
+        // here as "new behavior detected" instead of vanishing.
+        for (const sg of suppressedGaps) {
+            const sharedFiles = sg.changedFiles.filter((file) => f.changedFiles.includes(file));
+            if (sharedFiles.length > 0) {
+                const sgAi = sg.featureId
+                    ? (aiFeatureByFeatureId.get(sg.featureId) ?? aiFeatureByFamilyId.get(sg.familyId))
+                    : aiFeatureByFamilyId.get(sg.familyId);
+                const sgScenarios = sgAi?.aiMissingScenarios?.length
+                    ? sgAi.aiMissingScenarios
+                    : sg.userFlows.slice(0, 3);
+                if (sgScenarios.length > 0) {
+                    advisoryScenarios = [...(advisoryScenarios || []), ...sgScenarios];
+                }
+            }
+        }
         return {
             id: featureLabel(f),
             name: featureLabel(f),

package/dist/esm/agent/git.js

@@ -143,6 +143,38 @@ function parseStatusLines(lines) {
     }
     return files;
 }
+// Comment-line patterns by file extension.
+// A diff that ONLY touches these lines is a comment-only change (typo fix, doc update).
+const COMMENT_PATTERNS = [
+    { extensions: ['.go'], pattern: /^\s*(\/\/|\/\*|\*)/ },
+    { extensions: ['.ts', '.tsx', '.js', '.jsx'], pattern: /^\s*(\/\/|\/\*|\*|\*\/)/ },
+    { extensions: ['.py'], pattern: /^\s*#/ },
+    { extensions: ['.css', '.scss'], pattern: /^\s*(\/\*|\*|\*\/)/ },
+];
+/**
+ * Check if a file's diff only changes comment lines (no code changes).
+ * Returns true if the diff is comment-only and can be safely excluded.
+ */
+function isCommentOnlyDiff(file, repoRoot, baseRef) {
+    const diff = runGitRaw(['diff', `${baseRef}..HEAD`, '-U0', '--', file], repoRoot);
+    if (!diff)
+        return false;
+    const ext = file.slice(file.lastIndexOf('.'));
+    const commentEntry = COMMENT_PATTERNS.find((cp) => cp.extensions.includes(ext));
+    if (!commentEntry)
+        return false;
+    // Extract only added/removed content lines (skip diff headers)
+    const contentLines = diff
+        .split('\n')
+        .filter((line) => (line.startsWith('+') || line.startsWith('-')) && !line.startsWith('+++') && !line.startsWith('---'));
+    if (contentLines.length === 0)
+        return false;
+    // Every changed line must be a comment line
+    return contentLines.every((line) => {
+        const content = line.slice(1).trim(); // Remove +/- prefix
+        return content === '' || commentEntry.pattern.test(content);
+    });
+}
 export function getChangedFiles(appRoot, since, options) {
     try {
         const files = new Set();
@@ -164,7 +196,7 @@ export function getChangedFiles(appRoot, since, options) {
         const repoRoot = runGitRaw(['rev-parse', '--show-toplevel'], appRoot)?.trim() || appRoot;
         const diffFiles = runGit(['diff', '--name-only', `${baseRef}..HEAD`], repoRoot);
         if (!diffFiles) {
-            return { files: [], error: 'git diff failed' };
+            return { files: [], filteredTestFiles: [], error: 'git diff failed' };
         }
         diffFiles.forEach((file) => files.add(file));
         if (options?.includeUncommitted) {
@@ -179,9 +211,28 @@ export function getChangedFiles(appRoot, since, options) {
             }
         }
         const allFiles = Array.from(files);
-        return { files: allFiles.filter(isRelevantFile), allFiles, baseRef, baseStrategy };
+        const relevant = [];
+        const filteredTestFiles = [];
+        for (const f of allFiles) {
+            if (isRelevantFile(f)) {
+                // Skip files where the diff only touches comments (typo fixes, doc updates)
+                if (isCommentOnlyDiff(f, repoRoot, baseRef)) {
+                    continue;
+                }
+                relevant.push(f);
+            }
+            else {
+                // Only capture files that were filtered because they match test patterns.
+                // Config, docs, workflow files etc. are not useful for PR-test detection.
+                const basename = f.split('/').pop() || f;
+                if (TEST_FILE_PATTERNS.some((p) => p.test(basename))) {
+                    filteredTestFiles.push(f);
+                }
+            }
+        }
+        return { files: relevant, filteredTestFiles, baseRef, baseStrategy };
     }
     catch {
-        return { files: [], error: 'git diff failed' };
+        return { files: [], filteredTestFiles: [], error: 'git diff failed' };
     }
 }

package/dist/esm/api.js

@@ -43,7 +43,7 @@ export function analyzeImpactDeterministic(options = {}) {
     return analyzeImpactV2(gitResult.files, {
         testsRoot: reportRoot,
         routeFamilies: config.routeFamilies,
-        allFiles: gitResult.allFiles,
+        filteredTestFiles: gitResult.filteredTestFiles,
     });
 }
 export function recommendTestsDeterministic(options = {}) {
@@ -53,7 +53,7 @@ export function recommendTestsDeterministic(options = {}) {
     const impact = analyzeImpactV2(gitResult.files, {
         testsRoot: reportRoot,
         routeFamilies: config.routeFamilies,
-        allFiles: gitResult.allFiles,
+        filteredTestFiles: gitResult.filteredTestFiles,
     });
     const adaptive = getAdaptiveThresholds(reportRoot);
     const plan = buildPlanFromImpact(impact, config.policy, undefined, adaptive);
@@ -70,7 +70,7 @@ export async function recommendTestsAI(options = {}) {
     const impact = analyzeImpactV2(gitResult.files, {
         testsRoot: reportRoot,
         routeFamilies: config.routeFamilies,
-        allFiles: gitResult.allFiles,
+        filteredTestFiles: gitResult.filteredTestFiles,
     });
     const apiKey = process.env.ANTHROPIC_API_KEY;
     let aiEnrichment;

package/dist/esm/engine/ai_enrichment.js

@@ -38,7 +38,8 @@ function buildPrompt(options) {
         const specCount = feature.playwrightSpecs.length + feature.cypressSpecs.length;
         const specList2 = [...feature.playwrightSpecs, ...feature.cypressSpecs];
         const specsDisplay = specList2.length > 0 ? specList2.join(', ') : 'none';
-        lines.push(`- familyId=${feature.familyId} ${featureIdPart} (${feature.priority}): ${specCount} files, coverage=${feature.coverageStatus}, specs=[${specsDisplay}]`);
+        const userFlowsDisplay = feature.userFlows.length > 0 ? ` userFlows=[${feature.userFlows.slice(0, 5).join(', ')}]` : '';
+        lines.push(`- familyId=${feature.familyId} ${featureIdPart} (${feature.priority}): ${specCount} specs, coverage=${feature.coverageStatus}, specs=[${specsDisplay}]${userFlowsDisplay}`);
     }
     lines.push('');
     // Unbound files

package/dist/esm/engine/impact_engine.js

@@ -174,11 +174,10 @@ export function analyzeImpact(changedFiles, options) {
     const { testsRoot, routeFamilies } = options;
     const warnings = [];
     // Partition into source files and test files.
-    // When allFiles is provided (from git.ts before relevance filtering), use it
-    // to capture test files that were pre-filtered by the caller.
-    const allOriginalFiles = options.allFiles && options.allFiles.length > 0
-        ? [...new Set([...options.allFiles, ...changedFiles])]
-        : [...changedFiles];
+    // Combine: (a) test files already in changedFiles that isTestFile catches, and
+    // (b) test files pre-filtered by the caller (filteredTestFiles from git.ts).
+    const preFilteredTests = options.filteredTestFiles ?? [];
+    const allOriginalFiles = [...new Set([...changedFiles, ...preFilteredTests])];
     changedFiles = changedFiles.filter((f) => !isTestFile(f));
     const prIncludedTestFiles = classifyPrTestFiles(allOriginalFiles, changedFiles);
     // Load manifest
@@ -261,10 +260,10 @@ function inferCypressRoot(testsRoot) {
  *
  * Suppresses family-level (generic) gaps when ALL their changed files are
  * already covered by feature-level (specific) matches in other families.
- * This prevents double-counting when a file like `policies.tsx` matches both
- * a generic family (`config`) and a specific feature (`system_console/permissions`).
+ * Suppressed gaps are returned separately so the plan builder can promote
+ * them to advisory ("new behavior detected") on covered flows.
  */
-export function getGaps(result) {
+export function getGapsWithSuppressed(result) {
     // Collect files that are covered via feature-level matches (more specific)
     const filesCoveredByFeatures = new Set();
     for (const f of result.impactedFeatures) {
@@ -274,18 +273,29 @@ export function getGaps(result) {
             }
         }
     }
-    return result.impactedFeatures.filter((f) => {
+    const gaps = [];
+    const suppressedGaps = [];
+    for (const f of result.impactedFeatures) {
         if (f.priority !== 'P0' && f.priority !== 'P1')
-            return false;
+            continue;
         if (f.coverageStatus !== 'uncovered')
-            return false;
+            continue;
         // Only suppress FAMILY-level gaps (no featureId = generic match).
-        // If it's a feature-level gap, keep it — it's specific and intentional.
         if (!f.featureId && f.changedFiles.every((file) => filesCoveredByFeatures.has(file))) {
-            return false;
+            suppressedGaps.push(f);
         }
-        return true;
-    });
+        else {
+            gaps.push(f);
+        }
+    }
+    return { gaps, suppressedGaps };
+}
+/**
+ * Get gaps: P0/P1 features with 'uncovered' status.
+ * Convenience wrapper that returns only active gaps (backward-compatible).
+ */
+export function getGaps(result) {
+    return getGapsWithSuppressed(result).gaps;
 }
 /**
  * Get partial gaps: P0/P1 features with 'partial' status (advisory).

package/dist/esm/engine/plan_builder.js

@@ -4,7 +4,8 @@ import { mkdirSync, writeFileSync } from 'fs';
 import { dirname, join } from 'path';
 import { minimatch } from 'minimatch';
 import { inferSubsystemFromTestPath } from '../agent/test_path.js';
-import { getGaps, getPartialGaps } from './impact_engine.js';
+import { getGaps, getGapsWithSuppressed, getPartialGaps } from './impact_engine.js';
+import { bindFilesToFamilies, loadRouteFamilyManifest } from '../knowledge/route_families.js';
 const DEFAULT_POLICY = {
     minConfidenceForTargeted: 60,
     safeMergeMinConfidence: 85,
@@ -105,17 +106,73 @@ function pickRunSet(impact, confidence, policy) {
         riskyFiles,
     };
 }
+/**
+ * Check which gaps have matching PR-included E2E spec files by binding
+ * spec files to families via the manifest. Returns familyIds that are covered.
+ */
+function matchPrSpecsToGaps(prTestFiles, gaps, testsRoot) {
+    const coveredFamilies = new Set();
+    const prE2ESpecs = prTestFiles.filter((t) => t.type === 'playwright' || t.type === 'cypress');
+    if (prE2ESpecs.length === 0 || !testsRoot) {
+        return coveredFamilies;
+    }
+    // Try to bind PR spec files to families via the manifest
+    const manifest = loadRouteFamilyManifest(testsRoot);
+    if (manifest) {
+        const specBindings = bindFilesToFamilies(prE2ESpecs.map((s) => s.file), manifest);
+        for (const sb of specBindings) {
+            for (const binding of sb.bindings) {
+                coveredFamilies.add(binding.family);
+            }
+        }
+    }
+    // Fallback heuristic: if manifest binding didn't match (common for Cypress specs
+    // in directories not mapped in the manifest), check path-based keyword overlap.
+    if (coveredFamilies.size === 0) {
+        const gapFamilyIds = new Set(gaps.map((g) => g.familyId));
+        for (const spec of prE2ESpecs) {
+            const specLower = spec.file.toLowerCase().replace(/[_\-/\\]/g, ' ');
+            for (const familyId of gapFamilyIds) {
+                // Check if the spec path contains the family name or related terms
+                if (specLower.includes(familyId.toLowerCase())) {
+                    coveredFamilies.add(familyId);
+                }
+            }
+        }
+    }
+    return coveredFamilies;
+}
 function buildDecision(impact, runSet, confidence, policy) {
-    const gaps = getGaps(impact);
+    const gaps = getGapsWithSuppressed(impact).gaps;
     if (gaps.length > 0) {
-        // Check if PR already includes E2E test files that likely cover the gaps
-        const prE2ESpecCount = (impact.prIncludedTestFiles ?? [])
-            .filter((t) => t.type === 'playwright' || t.type === 'cypress').length;
-        if (prE2ESpecCount > 0) {
+        const prE2ESpecs = (impact.prIncludedTestFiles ?? [])
+            .filter((t) => t.type === 'playwright' || t.type === 'cypress');
+        if (prE2ESpecs.length > 0) {
+            // Bind PR specs to families — only soften gaps that have matching specs
+            const coveredFamilies = matchPrSpecsToGaps(impact.prIncludedTestFiles ?? [], gaps);
+            const uncoveredGaps = gaps.filter((g) => !coveredFamilies.has(g.familyId));
+            if (uncoveredGaps.length === 0) {
+                // ALL gaps have matching PR specs
+                return {
+                    action: 'run-now',
+                    title: 'Run now',
+                    summary: `Detected ${gaps.length} coverage gap(s), but the PR includes ${prE2ESpecs.length} E2E test file(s) covering them. Verify the new tests cover impacted flows.`,
+                };
+            }
+            if (uncoveredGaps.length < gaps.length) {
+                // SOME gaps covered by PR specs, others not
+                return {
+                    action: 'must-add-tests',
+                    title: 'Must add tests',
+                    summary: `Detected ${gaps.length} coverage gap(s). PR includes E2E tests for ${gaps.length - uncoveredGaps.length}, but ${uncoveredGaps.length} flow(s) still need coverage.`,
+                };
+            }
+            // No gaps matched by PR specs — but PR still has E2E files.
+            // Soften to run-now since the developer is actively writing tests.
             return {
                 action: 'run-now',
                 title: 'Run now',
-                summary: `Detected ${gaps.length} coverage gap(s), but the PR includes ${prE2ESpecCount} E2E test file(s). Verify the new tests cover impacted flows.`,
+                summary: `Detected ${gaps.length} coverage gap(s), but the PR includes ${prE2ESpecs.length} E2E test file(s). Verify the new tests cover impacted flows.`,
             };
         }
         return {
@@ -233,7 +290,7 @@ export function buildPlanFromImpact(impact, policyOverride, aiEnrichment, adapti
     const runSetResult = pickRunSet(impact, confidence, policy);
     const decision = buildDecision(impact, runSetResult.runSet, confidence, policy);
     const enforcement = evaluateEnforcement(decision, policy);
-    const gaps = getGaps(impact);
+    const { gaps, suppressedGaps } = getGapsWithSuppressed(impact);
     const partialGaps = getPartialGaps(impact);
     // Build two separate lookup maps from aiEnrichment: one by featureId, one by familyId.
     // The familyId map stores only the FIRST feature encountered to avoid last-write-wins collisions.
@@ -318,9 +375,27 @@ export function buildPlanFromImpact(impact, policyOverride, aiEnrichment, adapti
             ? (aiFeatureByFeatureId.get(f.featureId) ?? aiFeatureByFamilyId.get(f.familyId))
             : aiFeatureByFamilyId.get(f.familyId);
         // Only surface advisory scenarios when AI found new behavior in this diff
-        const advisoryScenarios = aiFeature?.aiMissingScenarios?.length
-            ? aiFeature.aiMissingScenarios
+        let advisoryScenarios = aiFeature?.aiMissingScenarios?.length
+            ? [...aiFeature.aiMissingScenarios]
             : undefined;
+        // Promote suppressed gaps to advisory on covered flows that share changed files.
+        // When a family-level gap is suppressed (e.g. "post" because post.go is also in
+        // a covered feature like "channels/threads"), the behavioral change should appear
+        // here as "new behavior detected" instead of vanishing.
+        for (const sg of suppressedGaps) {
+            const sharedFiles = sg.changedFiles.filter((file) => f.changedFiles.includes(file));
+            if (sharedFiles.length > 0) {
+                const sgAi = sg.featureId
+                    ? (aiFeatureByFeatureId.get(sg.featureId) ?? aiFeatureByFamilyId.get(sg.familyId))
+                    : aiFeatureByFamilyId.get(sg.familyId);
+                const sgScenarios = sgAi?.aiMissingScenarios?.length
+                    ? sgAi.aiMissingScenarios
+                    : sg.userFlows.slice(0, 3);
+                if (sgScenarios.length > 0) {
+                    advisoryScenarios = [...(advisoryScenarios || []), ...sgScenarios];
+                }
+            }
+        }
         return {
             id: featureLabel(f),
             name: featureLabel(f),

package/dist/esm/index.js

@@ -11,7 +11,7 @@ export { LLMProviderFactory, validateProviderSetup } from './provider_factory.js
 // Agent API (deterministic impact + plan, traceability)
 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 { analyzeImpact as analyzeImpactV2, getGaps, getGapsWithSuppressed, getPartialGaps } from './engine/impact_engine.js';
 export { extractScenarios } from './engine/impact_engine.js';
 export { buildPlanFromImpact } from './engine/plan_builder.js';
 export { appendFeedbackAndRecompute, readCalibration, readFlakyTests, getAdaptiveThresholds } from './agent/feedback.js';

package/dist/index.d.ts

@@ -20,8 +20,8 @@ export { LLMProviderFactory, validateProviderSetup } from './provider_factory.js
 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, SpecWithScenarios, PrTestFile, PrTestFileType } from './engine/impact_engine.js';
+export { analyzeImpact as analyzeImpactV2, getGaps, getGapsWithSuppressed, getPartialGaps } from './engine/impact_engine.js';
+export type { ImpactResult, ImpactedFeature, CoverageStatus, ImpactEngineOptions, SpecWithScenarios, PrTestFile, PrTestFileType, GapResult } from './engine/impact_engine.js';
 export { extractScenarios } from './engine/impact_engine.js';
 export { buildPlanFromImpact } from './engine/plan_builder.js';
 export { appendFeedbackAndRecompute, readCalibration, readFlakyTests, getAdaptiveThresholds } 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,8 +2,8 @@
 // Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
 // See LICENSE.txt for license information.
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.scanProject = exports.runAgenticGeneration = 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.getAdaptiveThresholds = exports.readFlakyTests = 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;
-exports.formatValidationReport = exports.buildValidationReport = exports.validateCommit = exports.getCommitFiles = exports.enrichFamilies = exports.detectStaleFamilies = exports.mergeFamilies = void 0;
+exports.runAgenticGeneration = 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.getAdaptiveThresholds = exports.readFlakyTests = exports.readCalibration = exports.appendFeedbackAndRecompute = exports.buildPlanFromImpact = exports.extractScenarios = exports.getPartialGaps = exports.getGapsWithSuppressed = 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.formatValidationReport = exports.buildValidationReport = exports.validateCommit = exports.getCommitFiles = exports.enrichFamilies = exports.detectStaleFamilies = exports.mergeFamilies = exports.scanProject = 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,7 @@ Object.defineProperty(exports, "captureTraceability", { enumerable: true, get: f
 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, "getGapsWithSuppressed", { enumerable: true, get: function () { return impact_engine_js_1.getGapsWithSuppressed; } });
 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; } });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yasserkhanorg/e2e-agents",
-  "version": "1.7.5",
+  "version": "1.7.7",
   "description": "AI-powered E2E test impact analysis, generation, and healing. Analyzes code changes to identify affected Playwright tests, detects coverage gaps, and generates or repairs specs using pluggable LLM providers (Claude, OpenAI, Ollama). Includes MCP server, traceability, and CI/CD integration.",
   "main": "dist/index.js",
   "module": "dist/esm/index.js",