@yasserkhanorg/e2e-agents 0.5.9 → 0.5.11

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

@@ -1 +1 @@
-{"version":3,"file":"ai_mapping.d.ts","sourceRoot":"","sources":["../../src/agent/ai_mapping.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAC,qBAAqB,EAAC,MAAM,aAAa,CAAC;AACvD,OAAO,KAAK,EAAC,YAAY,EAAE,QAAQ,EAAC,MAAM,YAAY,CAAC;AA2BvD,MAAM,WAAW,eAAe;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACtB;AAiOD,wBAAsB,iBAAiB,CACnC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,qBAAqB,EAC7B,KAAK,EAAE,UAAU,EAAE,EACnB,KAAK,EAAE,QAAQ,EAAE,GAClB,OAAO,CAAC,eAAe,CAAC,CAoN1B"}
+{"version":3,"file":"ai_mapping.d.ts","sourceRoot":"","sources":["../../src/agent/ai_mapping.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAC,qBAAqB,EAAC,MAAM,aAAa,CAAC;AACvD,OAAO,KAAK,EAAC,YAAY,EAAE,QAAQ,EAAC,MAAM,YAAY,CAAC;AA4BvD,MAAM,WAAW,eAAe;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACtB;AAuTD,wBAAsB,iBAAiB,CACnC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,qBAAqB,EAC7B,KAAK,EAAE,UAAU,EAAE,EACnB,KAAK,EAAE,QAAQ,EAAE,GAClB,OAAO,CAAC,eAAe,CAAC,CA0O1B"}

package/dist/agent/ai_mapping.js

@@ -12,7 +12,7 @@ const PRIORITY_RANK = {
     P1: 1,
     P2: 2,
 };
-const MIN_SINGLE_KEYWORD_LENGTH = 8;
+const MIN_SINGLE_KEYWORD_LENGTH = 6;
 const LOW_SIGNAL_FLOW_KEYWORDS = new Set([
     'app',
     'apps',
@@ -139,14 +139,36 @@ function isStrongCandidateMatch(flow, matchedKeywords) {
     const keywords = flowKeywords(flow);
     return keywords.length === 1 && matchedKeywords[0].length >= MIN_SINGLE_KEYWORD_LENGTH;
 }
+// Extract test/describe/it title strings from file content for semantic matching.
+function extractTestTitles(content) {
+    const titles = [];
+    const pattern = /(?:^|\s)(?:test|it|describe)\s*\(\s*(?:'([^']*)'|"([^"]*)"|`([^`]*)`)/gm;
+    let match;
+    while ((match = pattern.exec(content)) !== null) {
+        const title = match[1] ?? match[2] ?? match[3];
+        if (title) {
+            titles.push(title);
+        }
+    }
+    return titles.join(' ');
+}
+function matchedFlowKeywordsInTitles(flow, testContent) {
+    const haystack = extractTestTitles(testContent).toLowerCase();
+    if (!haystack) {
+        return [];
+    }
+    return flowKeywords(flow).filter((keyword) => keyword && haystack.includes(keyword.toLowerCase()));
+}
 function selectCandidateTests(flows, tests, maxCandidateTests) {
     const selected = new Set();
     const byFlow = new Map();
     const evidence = [];
     const warnings = [];
     const normalizedTests = tests.map((test) => (0, utils_js_1.normalizePath)(test.path)).filter(Boolean);
+    const testByNormalizedPath = new Map(tests.map((t) => [(0, utils_js_1.normalizePath)(t.path), t]));
     const perFlowLimit = Math.max(2, Math.min(6, Math.floor(maxCandidateTests / Math.max(1, flows.length))));
     for (const flow of flows) {
+        // Pass 1: path-keyword matching
         const scored = [];
         for (const testPath of normalizedTests) {
             const matchedKeywords = matchedFlowKeywords(flow, testPath);
@@ -163,7 +185,37 @@ function selectCandidateTests(flows, tests, maxCandidateTests) {
             .filter((candidate) => isStrongCandidateMatch(flow, candidate.matchedKeywords))
             .sort((a, b) => b.score - a.score || a.path.localeCompare(b.path))
             .slice(0, perFlowLimit);
-        if (strongCandidates.length === 0) {
+        // Pass 2: content-title matching
+        // For flows without enough path-matched candidates, also search test/describe/it
+        // title strings for flow keywords. This surfaces semantically related tests even
+        // when the file name does not match the flow (e.g. a search.spec.ts with a test
+        // titled "search for message in channel" covers search_messages).
+        const contentCandidates = [];
+        if (strongCandidates.length < perFlowLimit) {
+            const alreadyByPath = new Set(strongCandidates.map((c) => c.path));
+            for (const testPath of normalizedTests) {
+                if (alreadyByPath.has(testPath)) {
+                    continue;
+                }
+                const testFile = testByNormalizedPath.get(testPath);
+                if (!testFile?.content) {
+                    continue;
+                }
+                const titleKeywords = matchedFlowKeywordsInTitles(flow, testFile.content);
+                if (!isStrongCandidateMatch(flow, titleKeywords)) {
+                    continue;
+                }
+                // Score content matches lower than path matches so path candidates rank higher.
+                contentCandidates.push({
+                    path: testPath,
+                    score: titleKeywords.length,
+                    matchedKeywords: titleKeywords,
+                });
+            }
+            contentCandidates.sort((a, b) => b.score - a.score || a.path.localeCompare(b.path));
+        }
+        const allCandidates = [...strongCandidates, ...contentCandidates.slice(0, perFlowLimit)];
+        if (allCandidates.length === 0) {
             // Exact-name fallback: if the flow ID has no effective keywords (all tokens are
             // low-signal, e.g. view_user_group_modal), look for a test whose path contains
             // the exact flow ID as a directory name or filename without extension.
@@ -181,9 +233,9 @@ function selectCandidateTests(flows, tests, maxCandidateTests) {
             }
             continue;
         }
-        byFlow.set(flow.id, new Set(strongCandidates.map((candidate) => candidate.path)));
-        evidence.push({ flowId: flow.id, candidates: strongCandidates });
-        for (const candidate of strongCandidates) {
+        byFlow.set(flow.id, new Set(allCandidates.map((candidate) => candidate.path)));
+        evidence.push({ flowId: flow.id, candidates: allCandidates });
+        for (const candidate of allCandidates) {
             selected.add(candidate.path);
         }
     }
@@ -194,7 +246,34 @@ function selectCandidateTests(flows, tests, maxCandidateTests) {
         warnings,
     };
 }
-function buildCoverage(flows, mapped) {
+function readCandidateTestContents(testsRoot, testPaths) {
+    const result = [];
+    const maxCharsPerFile = 6000;
+    const maxTotalChars = 24000;
+    let totalChars = 0;
+    for (const testPath of testPaths.slice(0, 6)) {
+        if (totalChars >= maxTotalChars) {
+            break;
+        }
+        const candidates = (0, path_1.isAbsolute)(testPath) ? [testPath] : [(0, path_1.join)(testsRoot, testPath)];
+        for (const fullPath of candidates) {
+            if (!(0, fs_1.existsSync)(fullPath)) {
+                continue;
+            }
+            const content = (0, fs_1.readFileSync)(fullPath, 'utf-8').trim();
+            if (!content) {
+                continue;
+            }
+            const remaining = Math.max(0, maxTotalChars - totalChars);
+            const clipped = content.slice(0, Math.min(maxCharsPerFile, remaining));
+            result.push({ path: testPath, content: clipped });
+            totalChars += clipped.length;
+            break;
+        }
+    }
+    return result;
+}
+function buildCoverage(flows, mapped, scenarioGaps) {
     return flows.map((flow) => ({
         flowId: flow.id,
         flowName: flow.name,
@@ -202,6 +281,7 @@ function buildCoverage(flows, mapped) {
         coveredBy: mapped.get(flow.id) || [],
         score: (mapped.get(flow.id) || []).length,
         source: 'ai',
+        missingScenarios: scenarioGaps.get(flow.id) || [],
     }));
 }
 function providerFor(config) {
@@ -255,6 +335,12 @@ async function mapAITestsToFlows(appRoot, testsRoot, config, flows, tests) {
     if (contextFiles.length === 0) {
         warnings.push('AI mapping context files were not found; continuing without optional markdown context.');
     }
+    // Read candidate test file contents so the AI can reason about what scenarios
+    // are already covered and which ones are still missing.
+    const candidateTestContents = readCandidateTestContents(testsRoot, candidateTests);
+    const testContentBlock = candidateTestContents.length > 0
+        ? candidateTestContents.map((entry) => `### Test: ${entry.path}\n\`\`\`typescript\n${entry.content}\n\`\`\``).join('\n\n')
+        : 'No candidate test file contents could be read.';
     let provider;
     try {
         provider = config.provider === 'auto'
@@ -280,7 +366,7 @@ async function mapAITestsToFlows(appRoot, testsRoot, config, flows, tests) {
         'Only use tests from CANDIDATE_TESTS. Never invent paths.',
         'Prefer no mapping over a broad or generic mapping.',
         'Return strict JSON only with this shape:',
-        '{"mappings":[{"flowId":"<flow id>","tests":["specs/..."],"reason":"short reason","confidence":0.0}]}',
+        '{"mappings":[{"flowId":"<flow id>","tests":["specs/..."],"reason":"short reason","confidence":0.0,"missingScenarios":["scenario description"]}]}',
         '',
         'Rules:',
         '- Keep at most 5 tests per flow.',
@@ -290,6 +376,8 @@ async function mapAITestsToFlows(appRoot, testsRoot, config, flows, tests) {
         '- Treat single-keyword or broad subsystem overlap as insufficient evidence.',
         '- If the candidate path overlap is weak or ambiguous, return tests: [].',
         '- If unsure for a flow, return tests: [].',
+        '- For every flow you map to tests, read CANDIDATE_TEST_CONTENT and list up to 5 specific test scenarios NOT yet covered by those tests. Write each as a short imperative statement (e.g. "Search messages with date filter"). Only include missingScenarios you can clearly identify; return [] if unsure.',
+        '- If tests: [], set missingScenarios: [] as well — do not invent scenarios for unmapped flows.',
         '',
         `FLOWS (${prioritizedFlows.length}):`,
         JSON.stringify(prioritizedFlows.map((flow) => ({
@@ -307,6 +395,9 @@ async function mapAITestsToFlows(appRoot, testsRoot, config, flows, tests) {
         `FLOW_CANDIDATE_SIGNALS (${candidateSelection.evidence.length}):`,
         JSON.stringify(candidateSelection.evidence, null, 2),
         '',
+        `CANDIDATE_TEST_CONTENT (${candidateTestContents.length} file(s)):`,
+        testContentBlock,
+        '',
         contextBlock,
     ].join('\n');
     let parsed = null;
@@ -347,6 +438,7 @@ async function mapAITestsToFlows(appRoot, testsRoot, config, flows, tests) {
     const allowedFlowIds = new Set(prioritizedFlows.map((flow) => flow.id));
     const prioritizedFlowsById = new Map(prioritizedFlows.map((flow) => [flow.id, flow]));
     const mapped = new Map();
+    const scenarioGaps = new Map();
     const matchedTests = new Set();
     for (const entry of parsed.mappings) {
         if (!entry || !allowedFlowIds.has(entry.flowId) || !Array.isArray(entry.tests)) {
@@ -370,6 +462,15 @@ async function mapAITestsToFlows(appRoot, testsRoot, config, flows, tests) {
         for (const testPath of valid) {
             matchedTests.add(testPath);
         }
+        // Store missing scenarios identified by the AI for this flow.
+        if (Array.isArray(entry.missingScenarios) && entry.missingScenarios.length > 0) {
+            const scenarios = entry.missingScenarios
+                .filter((s) => typeof s === 'string' && s.trim().length > 0)
+                .slice(0, 5);
+            if (scenarios.length > 0) {
+                scenarioGaps.set(entry.flowId, scenarios);
+            }
+        }
     }
     // Post-AI exact-name fallback: for any flow still uncovered, search all test paths
     // for a file or directory whose name exactly matches the flow ID. This handles flows
@@ -389,7 +490,7 @@ async function mapAITestsToFlows(appRoot, testsRoot, config, flows, tests) {
             matchedTests.add(exactMatch);
         }
     }
-    const coverage = buildCoverage(flows, mapped);
+    const coverage = buildCoverage(flows, mapped, scenarioGaps);
     if (mapped.size === 0) {
         warnings.push(`AI mapping returned no valid test mappings (${provider.name}).`);
     }

package/dist/agent/analysis.d.ts

@@ -40,6 +40,8 @@ export interface FlowImpact {
     priorityFloor?: FlowPriority;
     subsystemRiskBoost?: number;
     subsystemRiskRules?: string[];
+    existingTests?: string[];
+    missingScenarios?: string[];
 }
 export interface ImpactAnalysisResult {
     files: FileAnalysis[];

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

@@ -1 +1 @@
-{"version":3,"file":"analysis.d.ts","sourceRoot":"","sources":["../../src/agent/analysis.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAC,WAAW,EAAE,YAAY,EAAa,MAAM,aAAa,CAAC;AACvE,OAAO,EAAqE,KAAK,WAAW,EAAE,KAAK,OAAO,EAAC,MAAM,YAAY,CAAC;AAY9H,MAAM,MAAM,YAAY,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAE9C,MAAM,WAAW,YAAY;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,OAAO,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,EAAE,OAAO,CAAC;IACzB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAAC;IAC5B,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,aAAa,CAAC,EAAE;QACZ,KAAK,EAAE,MAAM,EAAE,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,aAAa,CAAC,EAAE,YAAY,CAAC;QAC7B,OAAO,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;CACL;AAED,MAAM,WAAW,UAAU;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,YAAY,CAAC;IACvB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAC;IAC1B,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;IAClB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,aAAa,CAAC,EAAE,YAAY,CAAC;IAC7B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,oBAAoB;IACjC,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,aAAa,EAAE;QACX,MAAM,EAAE,KAAK,CAAC;QACd,OAAO,EAAE,OAAO,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,OAAO,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;KACxB,CAAC;CACL;AA6HD,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,WAAW,GAAG,oBAAoB,CA+IhH;AAED,wBAAgB,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,SAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAsCnH"}
+{"version":3,"file":"analysis.d.ts","sourceRoot":"","sources":["../../src/agent/analysis.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAC,WAAW,EAAE,YAAY,EAAa,MAAM,aAAa,CAAC;AACvE,OAAO,EAAqE,KAAK,WAAW,EAAE,KAAK,OAAO,EAAC,MAAM,YAAY,CAAC;AAY9H,MAAM,MAAM,YAAY,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAE9C,MAAM,WAAW,YAAY;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,OAAO,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,EAAE,OAAO,CAAC;IACzB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAAC;IAC5B,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,aAAa,CAAC,EAAE;QACZ,KAAK,EAAE,MAAM,EAAE,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,aAAa,CAAC,EAAE,YAAY,CAAC;QAC7B,OAAO,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;CACL;AAED,MAAM,WAAW,UAAU;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,YAAY,CAAC;IACvB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAC;IAC1B,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;IAClB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,aAAa,CAAC,EAAE,YAAY,CAAC;IAC7B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,oBAAoB;IACjC,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,aAAa,EAAE;QACX,MAAM,EAAE,KAAK,CAAC;QACd,OAAO,EAAE,OAAO,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,OAAO,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;KACxB,CAAC;CACL;AA6HD,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,WAAW,GAAG,oBAAoB,CA+IhH;AAED,wBAAgB,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,SAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAsCnH"}

package/dist/agent/plan.d.ts

@@ -18,6 +18,8 @@ export interface GapDetail {
     priority: string;
     reasons: string[];
     files: string[];
+    existingTests?: string[];
+    missingScenarios?: string[];
 }
 export interface CoveredFlowSummary {
     id: string;

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

@@ -1 +1 @@
-{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../src/agent/plan.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../src/agent/plan.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,aAAa,CAAC;AAE9C,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,UAAU,GAAG,MAAM,CAAC;AAC9D,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,gBAAgB,GAAG,eAAe,CAAC;AAEtE,MAAM,WAAW,gBAAgB;IAC7B,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,OAAO,EAAE,YAAY,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC5B,MAAM,EAAE,QAAQ,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,SAAS;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,kBAAkB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,UAAU;IACvB,aAAa,EAAE,OAAO,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,QAAQ,CAAC;IACjB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,YAAY,EAAE,kBAAkB,EAAE,CAAC;IACnC,MAAM,EAAE,gBAAgB,CAAC;IACzB,QAAQ,EAAE,eAAe,CAAC;IAC1B,WAAW,EAAE;QACT,IAAI,EAAE,YAAY,CAAC,iBAAiB,CAAC,CAAC;QACtC,cAAc,EAAE,QAAQ,EAAE,CAAC;QAC3B,aAAa,EAAE,OAAO,CAAC;QACvB,UAAU,EAAE,OAAO,CAAC;QACpB,OAAO,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,QAAQ,CAAC,EAAE;QACP,KAAK,CAAC,EAAE;YACJ,wBAAwB,EAAE,KAAK,CAAC;gBAC5B,IAAI,EAAE,MAAM,CAAC;gBACb,SAAS,EAAE,MAAM,CAAC;gBAClB,WAAW,CAAC,EAAE,MAAM,CAAC;gBACrB,YAAY,CAAC,EAAE,MAAM,CAAC;gBACtB,KAAK,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,QAAQ,CAAC;gBACjC,SAAS,CAAC,EAAE,MAAM,CAAC;gBACnB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;gBAClB,UAAU,CAAC,EAAE,OAAO,CAAC;gBACrB,eAAe,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,kBAAkB,CAAC;gBACzD,aAAa,CAAC,EAAE,MAAM,CAAC;aAC1B,CAAC,CAAC;YACH,2BAA2B,EAAE,MAAM,EAAE,CAAC;YACtC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;SAC5B,CAAC;QACF,YAAY,CAAC,EAAE;YACX,MAAM,EAAE,KAAK,CAAC;gBAAC,IAAI,EAAE,MAAM,CAAC;gBAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;gBAAC,OAAO,CAAC,EAAE,MAAM,CAAA;aAAC,CAAC,CAAC;YAClF,QAAQ,EAAE,KAAK,CAAC;gBAAC,IAAI,EAAE,MAAM,CAAC;gBAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;gBAAC,OAAO,CAAC,EAAE,MAAM,CAAA;aAAC,CAAC,CAAC;SACvF,CAAC;QACF,WAAW,CAAC,EAAE;YACV,SAAS,EAAE,MAAM,CAAC;YAClB,MAAM,EAAE,MAAM,CAAC;YACf,iBAAiB,EAAE,MAAM,CAAC;SAC7B,CAAC;KACL,CAAC;IACF,WAAW,CAAC,EAAE;QACV,iCAAiC,EAAE,OAAO,CAAC;QAC3C,mBAAmB,CAAC,EAAE,MAAM,CAAC;QAC7B,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,oBAAoB,CAAC,EAAE,MAAM,CAAC;QAC9B,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,oBAAoB,CAAC,EAAE,MAAM,CAAC;QAC9B,eAAe,CAAC,EAAE,MAAM,CAAC;KAC5B,CAAC;IACF,OAAO,EAAE;QACL,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,EAAE,MAAM,CAAC;QACtB,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,QAAQ,EAAE,MAAM,CAAC;KACpB,CAAC;CACL;AAmPD,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,CAKnE;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,UAAU,EAAE,cAAc,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,UAAU,CAgEhH;AAED,wBAAgB,sBAAsB,CAClC,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAC,GACtF,UAAU,CAuBZ;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,MAAM,CAMzE;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CA2BhE;AAED,MAAM,WAAW,eAAe;IAC5B,aAAa,EAAE,OAAO,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,QAAQ,CAAC;IACjB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,YAAY,CAAC,iBAAiB,CAAC,CAAC;IACjD,qBAAqB,EAAE,OAAO,CAAC;CAClC;AAED,MAAM,WAAW,kBAAkB;IAC/B,aAAa,EAAE,OAAO,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACnC,QAAQ,EAAE,MAAM,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAC;IAC5C,uBAAuB,EAAE,MAAM,CAAC;IAChC,YAAY,EAAE,MAAM,CAAC;CACxB;AAqBD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAC,CAkE9G;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,SAAiC,GAAG,MAAM,CAMvH"}

package/dist/agent/plan.js

@@ -265,6 +265,8 @@ function buildPlanFromImpactReport(impact, policyOverride) {
         priority: flow.priority,
         reasons: (flow.reasons || []).slice(0, 5),
         files: (flow.files || []).slice(0, 6),
+        existingTests: flow.existingTests && flow.existingTests.length > 0 ? flow.existingTests.slice(0, 3) : undefined,
+        missingScenarios: flow.missingScenarios && flow.missingScenarios.length > 0 ? flow.missingScenarios.slice(0, 5) : undefined,
     }));
     const coveredFlowIds = new Set(impact.gaps.map((g) => g.id));
     const coveredFlows = impact.coverage

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

@@ -1 +1 @@
-{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/agent/runner.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,aAAa,CAAC;AA+R7C,MAAM,WAAW,UAAU;IACvB,KAAK,EAAE,OAAO,CAAC;CAClB;AAYD,wBAAsB,SAAS,CAAC,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAuTzF;AAED,wBAAsB,MAAM,CAAC,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAoUtF"}
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/agent/runner.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,aAAa,CAAC;AA+S7C,MAAM,WAAW,UAAU;IACvB,KAAK,EAAE,OAAO,CAAC;CAClB;AAYD,wBAAsB,SAAS,CAAC,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAwTzF;AAED,wBAAsB,MAAM,CAAC,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAqUtF"}

package/dist/agent/runner.js

@@ -34,13 +34,29 @@ function ensureAppRoot(path) {
         throw new Error(`App path does not exist: ${path}`);
     }
 }
-function computeGaps(flows, coverageMap) {
-    return flows.filter((flow) => {
+function computeGaps(flows, coverageMap, coverage) {
+    const coverageByFlowId = new Map((coverage || []).map((c) => [c.flowId, c]));
+    return flows
+        .filter((flow) => {
         if (flow.priority !== 'P0' && flow.priority !== 'P1') {
             return false;
         }
         const coveredBy = coverageMap.get(flow.id) || [];
-        return coveredBy.length === 0;
+        if (coveredBy.length === 0) {
+            return true; // no tests at all
+        }
+        // Also flag as a gap if tests exist but the AI identified missing scenarios.
+        const flowCoverage = coverageByFlowId.get(flow.id);
+        return (flowCoverage?.missingScenarios || []).length > 0;
+    })
+        .map((flow) => {
+        const coveredBy = coverageMap.get(flow.id) || [];
+        const flowCoverage = coverageByFlowId.get(flow.id);
+        return {
+            ...flow,
+            existingTests: coveredBy.length > 0 ? coveredBy : undefined,
+            missingScenarios: flowCoverage?.missingScenarios?.length ? flowCoverage.missingScenarios : undefined,
+        };
     });
 }
 function normalizeChangedFiles(appRoot, files) {
@@ -460,7 +476,8 @@ async function runImpact(_config, _options) {
         for (const entry of coverage) {
             coverageMap.set(entry.flowId, entry.coveredBy);
         }
-        gaps = computeGaps(flows, coverageMap);
+        // Pass the full coverage array so partial gaps (tests exist but missing scenarios) are included.
+        gaps = computeGaps(flows, coverageMap, coverage);
     }
     if (Date.now() <= deadline) {
         testSuggestions = (0, gap_suggestions_js_1.buildGapTestSuggestions)(testsRoot, gaps, frameworkDetection.framework, testPatterns.patterns);
@@ -750,7 +767,8 @@ async function runGap(_config, _options) {
         for (const entry of coverage) {
             coverageMap.set(entry.flowId, entry.coveredBy);
         }
-        gaps = computeGaps(flows, coverageMap);
+        // Pass the full coverage array so partial gaps (tests exist but missing scenarios) are included.
+        gaps = computeGaps(flows, coverageMap, coverage);
     }
     if (Date.now() <= deadline) {
         testSuggestions = (0, gap_suggestions_js_1.buildGapTestSuggestions)(testsRoot, gaps, frameworkDetection.framework, testPatterns.patterns);

package/dist/agent/tests.d.ts

@@ -11,6 +11,7 @@ export interface FlowCoverage {
     score: number;
     expectedTests?: string[];
     source?: 'catalog' | 'traceability' | 'heuristic' | 'ai';
+    missingScenarios?: string[];
 }
 export declare function discoverTests(appRoot: string, patterns: string[]): TestFile[];
 export declare function mapTestsToFlows(flows: FlowImpact[], tests: TestFile[]): FlowCoverage[];

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

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

package/dist/esm/agent/ai_mapping.js

@@ -9,7 +9,7 @@ const PRIORITY_RANK = {
     P1: 1,
     P2: 2,
 };
-const MIN_SINGLE_KEYWORD_LENGTH = 8;
+const MIN_SINGLE_KEYWORD_LENGTH = 6;
 const LOW_SIGNAL_FLOW_KEYWORDS = new Set([
     'app',
     'apps',
@@ -136,14 +136,36 @@ function isStrongCandidateMatch(flow, matchedKeywords) {
     const keywords = flowKeywords(flow);
     return keywords.length === 1 && matchedKeywords[0].length >= MIN_SINGLE_KEYWORD_LENGTH;
 }
+// Extract test/describe/it title strings from file content for semantic matching.
+function extractTestTitles(content) {
+    const titles = [];
+    const pattern = /(?:^|\s)(?:test|it|describe)\s*\(\s*(?:'([^']*)'|"([^"]*)"|`([^`]*)`)/gm;
+    let match;
+    while ((match = pattern.exec(content)) !== null) {
+        const title = match[1] ?? match[2] ?? match[3];
+        if (title) {
+            titles.push(title);
+        }
+    }
+    return titles.join(' ');
+}
+function matchedFlowKeywordsInTitles(flow, testContent) {
+    const haystack = extractTestTitles(testContent).toLowerCase();
+    if (!haystack) {
+        return [];
+    }
+    return flowKeywords(flow).filter((keyword) => keyword && haystack.includes(keyword.toLowerCase()));
+}
 function selectCandidateTests(flows, tests, maxCandidateTests) {
     const selected = new Set();
     const byFlow = new Map();
     const evidence = [];
     const warnings = [];
     const normalizedTests = tests.map((test) => normalizePath(test.path)).filter(Boolean);
+    const testByNormalizedPath = new Map(tests.map((t) => [normalizePath(t.path), t]));
     const perFlowLimit = Math.max(2, Math.min(6, Math.floor(maxCandidateTests / Math.max(1, flows.length))));
     for (const flow of flows) {
+        // Pass 1: path-keyword matching
         const scored = [];
         for (const testPath of normalizedTests) {
             const matchedKeywords = matchedFlowKeywords(flow, testPath);
@@ -160,7 +182,37 @@ function selectCandidateTests(flows, tests, maxCandidateTests) {
             .filter((candidate) => isStrongCandidateMatch(flow, candidate.matchedKeywords))
             .sort((a, b) => b.score - a.score || a.path.localeCompare(b.path))
             .slice(0, perFlowLimit);
-        if (strongCandidates.length === 0) {
+        // Pass 2: content-title matching
+        // For flows without enough path-matched candidates, also search test/describe/it
+        // title strings for flow keywords. This surfaces semantically related tests even
+        // when the file name does not match the flow (e.g. a search.spec.ts with a test
+        // titled "search for message in channel" covers search_messages).
+        const contentCandidates = [];
+        if (strongCandidates.length < perFlowLimit) {
+            const alreadyByPath = new Set(strongCandidates.map((c) => c.path));
+            for (const testPath of normalizedTests) {
+                if (alreadyByPath.has(testPath)) {
+                    continue;
+                }
+                const testFile = testByNormalizedPath.get(testPath);
+                if (!testFile?.content) {
+                    continue;
+                }
+                const titleKeywords = matchedFlowKeywordsInTitles(flow, testFile.content);
+                if (!isStrongCandidateMatch(flow, titleKeywords)) {
+                    continue;
+                }
+                // Score content matches lower than path matches so path candidates rank higher.
+                contentCandidates.push({
+                    path: testPath,
+                    score: titleKeywords.length,
+                    matchedKeywords: titleKeywords,
+                });
+            }
+            contentCandidates.sort((a, b) => b.score - a.score || a.path.localeCompare(b.path));
+        }
+        const allCandidates = [...strongCandidates, ...contentCandidates.slice(0, perFlowLimit)];
+        if (allCandidates.length === 0) {
             // Exact-name fallback: if the flow ID has no effective keywords (all tokens are
             // low-signal, e.g. view_user_group_modal), look for a test whose path contains
             // the exact flow ID as a directory name or filename without extension.
@@ -178,9 +230,9 @@ function selectCandidateTests(flows, tests, maxCandidateTests) {
             }
             continue;
         }
-        byFlow.set(flow.id, new Set(strongCandidates.map((candidate) => candidate.path)));
-        evidence.push({ flowId: flow.id, candidates: strongCandidates });
-        for (const candidate of strongCandidates) {
+        byFlow.set(flow.id, new Set(allCandidates.map((candidate) => candidate.path)));
+        evidence.push({ flowId: flow.id, candidates: allCandidates });
+        for (const candidate of allCandidates) {
             selected.add(candidate.path);
         }
     }
@@ -191,7 +243,34 @@ function selectCandidateTests(flows, tests, maxCandidateTests) {
         warnings,
     };
 }
-function buildCoverage(flows, mapped) {
+function readCandidateTestContents(testsRoot, testPaths) {
+    const result = [];
+    const maxCharsPerFile = 6000;
+    const maxTotalChars = 24000;
+    let totalChars = 0;
+    for (const testPath of testPaths.slice(0, 6)) {
+        if (totalChars >= maxTotalChars) {
+            break;
+        }
+        const candidates = isAbsolute(testPath) ? [testPath] : [join(testsRoot, testPath)];
+        for (const fullPath of candidates) {
+            if (!existsSync(fullPath)) {
+                continue;
+            }
+            const content = readFileSync(fullPath, 'utf-8').trim();
+            if (!content) {
+                continue;
+            }
+            const remaining = Math.max(0, maxTotalChars - totalChars);
+            const clipped = content.slice(0, Math.min(maxCharsPerFile, remaining));
+            result.push({ path: testPath, content: clipped });
+            totalChars += clipped.length;
+            break;
+        }
+    }
+    return result;
+}
+function buildCoverage(flows, mapped, scenarioGaps) {
     return flows.map((flow) => ({
         flowId: flow.id,
         flowName: flow.name,
@@ -199,6 +278,7 @@ function buildCoverage(flows, mapped) {
         coveredBy: mapped.get(flow.id) || [],
         score: (mapped.get(flow.id) || []).length,
         source: 'ai',
+        missingScenarios: scenarioGaps.get(flow.id) || [],
     }));
 }
 function providerFor(config) {
@@ -252,6 +332,12 @@ export async function mapAITestsToFlows(appRoot, testsRoot, config, flows, tests
     if (contextFiles.length === 0) {
         warnings.push('AI mapping context files were not found; continuing without optional markdown context.');
     }
+    // Read candidate test file contents so the AI can reason about what scenarios
+    // are already covered and which ones are still missing.
+    const candidateTestContents = readCandidateTestContents(testsRoot, candidateTests);
+    const testContentBlock = candidateTestContents.length > 0
+        ? candidateTestContents.map((entry) => `### Test: ${entry.path}\n\`\`\`typescript\n${entry.content}\n\`\`\``).join('\n\n')
+        : 'No candidate test file contents could be read.';
     let provider;
     try {
         provider = config.provider === 'auto'
@@ -277,7 +363,7 @@ export async function mapAITestsToFlows(appRoot, testsRoot, config, flows, tests
         'Only use tests from CANDIDATE_TESTS. Never invent paths.',
         'Prefer no mapping over a broad or generic mapping.',
         'Return strict JSON only with this shape:',
-        '{"mappings":[{"flowId":"<flow id>","tests":["specs/..."],"reason":"short reason","confidence":0.0}]}',
+        '{"mappings":[{"flowId":"<flow id>","tests":["specs/..."],"reason":"short reason","confidence":0.0,"missingScenarios":["scenario description"]}]}',
         '',
         'Rules:',
         '- Keep at most 5 tests per flow.',
@@ -287,6 +373,8 @@ export async function mapAITestsToFlows(appRoot, testsRoot, config, flows, tests
         '- Treat single-keyword or broad subsystem overlap as insufficient evidence.',
         '- If the candidate path overlap is weak or ambiguous, return tests: [].',
         '- If unsure for a flow, return tests: [].',
+        '- For every flow you map to tests, read CANDIDATE_TEST_CONTENT and list up to 5 specific test scenarios NOT yet covered by those tests. Write each as a short imperative statement (e.g. "Search messages with date filter"). Only include missingScenarios you can clearly identify; return [] if unsure.',
+        '- If tests: [], set missingScenarios: [] as well — do not invent scenarios for unmapped flows.',
         '',
         `FLOWS (${prioritizedFlows.length}):`,
         JSON.stringify(prioritizedFlows.map((flow) => ({
@@ -304,6 +392,9 @@ export async function mapAITestsToFlows(appRoot, testsRoot, config, flows, tests
         `FLOW_CANDIDATE_SIGNALS (${candidateSelection.evidence.length}):`,
         JSON.stringify(candidateSelection.evidence, null, 2),
         '',
+        `CANDIDATE_TEST_CONTENT (${candidateTestContents.length} file(s)):`,
+        testContentBlock,
+        '',
         contextBlock,
     ].join('\n');
     let parsed = null;
@@ -344,6 +435,7 @@ export async function mapAITestsToFlows(appRoot, testsRoot, config, flows, tests
     const allowedFlowIds = new Set(prioritizedFlows.map((flow) => flow.id));
     const prioritizedFlowsById = new Map(prioritizedFlows.map((flow) => [flow.id, flow]));
     const mapped = new Map();
+    const scenarioGaps = new Map();
     const matchedTests = new Set();
     for (const entry of parsed.mappings) {
         if (!entry || !allowedFlowIds.has(entry.flowId) || !Array.isArray(entry.tests)) {
@@ -367,6 +459,15 @@ export async function mapAITestsToFlows(appRoot, testsRoot, config, flows, tests
         for (const testPath of valid) {
             matchedTests.add(testPath);
         }
+        // Store missing scenarios identified by the AI for this flow.
+        if (Array.isArray(entry.missingScenarios) && entry.missingScenarios.length > 0) {
+            const scenarios = entry.missingScenarios
+                .filter((s) => typeof s === 'string' && s.trim().length > 0)
+                .slice(0, 5);
+            if (scenarios.length > 0) {
+                scenarioGaps.set(entry.flowId, scenarios);
+            }
+        }
     }
     // Post-AI exact-name fallback: for any flow still uncovered, search all test paths
     // for a file or directory whose name exactly matches the flow ID. This handles flows
@@ -386,7 +487,7 @@ export async function mapAITestsToFlows(appRoot, testsRoot, config, flows, tests
             matchedTests.add(exactMatch);
         }
     }
-    const coverage = buildCoverage(flows, mapped);
+    const coverage = buildCoverage(flows, mapped, scenarioGaps);
     if (mapped.size === 0) {
         warnings.push(`AI mapping returned no valid test mappings (${provider.name}).`);
     }

package/dist/esm/agent/plan.js

@@ -256,6 +256,8 @@ export function buildPlanFromImpactReport(impact, policyOverride) {
         priority: flow.priority,
         reasons: (flow.reasons || []).slice(0, 5),
         files: (flow.files || []).slice(0, 6),
+        existingTests: flow.existingTests && flow.existingTests.length > 0 ? flow.existingTests.slice(0, 3) : undefined,
+        missingScenarios: flow.missingScenarios && flow.missingScenarios.length > 0 ? flow.missingScenarios.slice(0, 5) : undefined,
     }));
     const coveredFlowIds = new Set(impact.gaps.map((g) => g.id));
     const coveredFlows = impact.coverage

package/dist/esm/agent/runner.js

@@ -30,13 +30,29 @@ function ensureAppRoot(path) {
         throw new Error(`App path does not exist: ${path}`);
     }
 }
-function computeGaps(flows, coverageMap) {
-    return flows.filter((flow) => {
+function computeGaps(flows, coverageMap, coverage) {
+    const coverageByFlowId = new Map((coverage || []).map((c) => [c.flowId, c]));
+    return flows
+        .filter((flow) => {
         if (flow.priority !== 'P0' && flow.priority !== 'P1') {
             return false;
         }
         const coveredBy = coverageMap.get(flow.id) || [];
-        return coveredBy.length === 0;
+        if (coveredBy.length === 0) {
+            return true; // no tests at all
+        }
+        // Also flag as a gap if tests exist but the AI identified missing scenarios.
+        const flowCoverage = coverageByFlowId.get(flow.id);
+        return (flowCoverage?.missingScenarios || []).length > 0;
+    })
+        .map((flow) => {
+        const coveredBy = coverageMap.get(flow.id) || [];
+        const flowCoverage = coverageByFlowId.get(flow.id);
+        return {
+            ...flow,
+            existingTests: coveredBy.length > 0 ? coveredBy : undefined,
+            missingScenarios: flowCoverage?.missingScenarios?.length ? flowCoverage.missingScenarios : undefined,
+        };
     });
 }
 function normalizeChangedFiles(appRoot, files) {
@@ -456,7 +472,8 @@ export async function runImpact(_config, _options) {
         for (const entry of coverage) {
             coverageMap.set(entry.flowId, entry.coveredBy);
         }
-        gaps = computeGaps(flows, coverageMap);
+        // Pass the full coverage array so partial gaps (tests exist but missing scenarios) are included.
+        gaps = computeGaps(flows, coverageMap, coverage);
     }
     if (Date.now() <= deadline) {
         testSuggestions = buildGapTestSuggestions(testsRoot, gaps, frameworkDetection.framework, testPatterns.patterns);
@@ -746,7 +763,8 @@ export async function runGap(_config, _options) {
         for (const entry of coverage) {
             coverageMap.set(entry.flowId, entry.coveredBy);
         }
-        gaps = computeGaps(flows, coverageMap);
+        // Pass the full coverage array so partial gaps (tests exist but missing scenarios) are included.
+        gaps = computeGaps(flows, coverageMap, coverage);
     }
     if (Date.now() <= deadline) {
         testSuggestions = buildGapTestSuggestions(testsRoot, gaps, frameworkDetection.framework, testPatterns.patterns);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yasserkhanorg/e2e-agents",
-  "version": "0.5.9",
+  "version": "0.5.11",
   "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",