@yasserkhanorg/e2e-agents 0.3.2

package/dist/agent/gap_suggestions.js

@@ -0,0 +1,101 @@
+"use strict";
+// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
+// See LICENSE.txt for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildGapTestSuggestions = buildGapTestSuggestions;
+const path_1 = require("path");
+const utils_js_1 = require("./utils.js");
+function inferTestDir(patterns) {
+    if (patterns.length === 0) {
+        return 'tests';
+    }
+    const pattern = patterns[0];
+    const wildcardIndex = pattern.search(/[*{]/);
+    const base = wildcardIndex === -1 ? pattern : pattern.slice(0, wildcardIndex);
+    const trimmed = base.replace(/\/+$/, '');
+    return trimmed || 'tests';
+}
+function inferExtension(patterns) {
+    const joined = patterns.join(' ');
+    if (joined.includes('.ts') || joined.includes('.tsx')) {
+        return 'ts';
+    }
+    return 'js';
+}
+function normalizeFramework(framework) {
+    if (framework === 'cypress' || framework === 'selenium') {
+        return framework;
+    }
+    return 'playwright';
+}
+function buildSkeleton(flow, sourceFiles, framework) {
+    const linkedFiles = sourceFiles.length > 0 ? sourceFiles.join(', ') : 'N/A';
+    if (framework === 'cypress') {
+        return [
+            `describe('Flow: ${flow.name}', () => {`,
+            `  it('${flow.priority}: critical coverage for ${flow.id}', () => {`,
+            "    cy.visit('/');",
+            `    // Linked code areas: ${linkedFiles}`,
+            '    // TODO: implement critical user path assertions',
+            '  });',
+            '});',
+            '',
+        ].join('\n');
+    }
+    if (framework === 'selenium') {
+        return [
+            "const {Builder} = require('selenium-webdriver');",
+            '',
+            '(async () => {',
+            "  const driver = await new Builder().forBrowser('chrome').build();",
+            '  try {',
+            "    await driver.get('http://localhost:3000');",
+            `    // Linked code areas: ${linkedFiles}`,
+            '    // TODO: implement critical user path assertions',
+            '  } finally {',
+            '    await driver.quit();',
+            '  }',
+            '})();',
+            '',
+        ].join('\n');
+    }
+    return [
+        "import {test, expect} from '@mattermost/playwright-lib';",
+        '',
+        `test('${flow.priority}: ${flow.name} critical path', {tag: '@ai-assisted'}, async ({pw}) => {`,
+        '  const {user, team} = await pw.initSetup();',
+        '  const {channelsPage} = await pw.testBrowser.login(user);',
+        "  await channelsPage.goto(team.name);",
+        `  // Linked code areas: ${linkedFiles}`,
+        '  // TODO: implement critical user path assertions',
+        '  await expect(channelsPage.page).toHaveURL(/.*/);',
+        '});',
+        '',
+    ].join('\n');
+}
+function buildGapTestSuggestions(testsRoot, flowsWithGaps, framework, testPatterns) {
+    const testDir = inferTestDir(testPatterns);
+    const ext = inferExtension(testPatterns);
+    const resolvedFramework = normalizeFramework(framework);
+    return flowsWithGaps
+        .filter((flow) => flow.priority === 'P0' || flow.priority === 'P1')
+        .map((flow) => {
+        const fileName = resolvedFramework === 'cypress' ? `${flow.id}.cy.${ext}` : `${flow.id}.spec.${ext}`;
+        const candidatePath = (0, path_1.resolve)(testsRoot, testDir, fileName);
+        const suggestionPath = (0, utils_js_1.isPathWithinRoot)(testsRoot, candidatePath)
+            ? candidatePath
+            : (0, path_1.resolve)(testsRoot, 'tests', fileName);
+        const sourceFiles = (flow.files || []).slice(0, 6);
+        const rationale = flow.reasons.length > 0 ? flow.reasons.join('; ') : 'High priority flow is currently uncovered';
+        return {
+            flowId: flow.id,
+            flowName: flow.name,
+            priority: flow.priority,
+            rationale,
+            sourceFiles,
+            suggestedTestPath: suggestionPath,
+            framework: resolvedFramework,
+            skeleton: buildSkeleton(flow, sourceFiles, resolvedFramework),
+        };
+    });
+}

package/dist/agent/generator.d.ts

@@ -0,0 +1,10 @@
+import type { FrameworkType } from './config.js';
+import type { FlowImpact } from './analysis.js';
+export interface GeneratedTest {
+    path: string;
+    flowId: string;
+    created: boolean;
+    reason?: string;
+}
+export declare function generateTests(appRoot: string, flows: FlowImpact[], framework: FrameworkType, testPatterns: string[], testIdsByFlow: Map<string, string[]>): GeneratedTest[];
+//# sourceMappingURL=generator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/agent/generator.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,eAAe,CAAC;AAG9C,MAAM,WAAW,aAAa;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AA6ED,wBAAgB,aAAa,CACzB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,UAAU,EAAE,EACnB,SAAS,EAAE,aAAa,EACxB,YAAY,EAAE,MAAM,EAAE,EACtB,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GACrC,aAAa,EAAE,CAyCjB"}

package/dist/agent/generator.js

@@ -0,0 +1,115 @@
+"use strict";
+// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
+// See LICENSE.txt for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateTests = generateTests;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const utils_js_1 = require("./utils.js");
+function inferTestDir(patterns) {
+    if (patterns.length === 0) {
+        return 'tests';
+    }
+    const pattern = patterns[0];
+    const wildcardIndex = pattern.search(/[*{]/);
+    const base = wildcardIndex === -1 ? pattern : pattern.slice(0, wildcardIndex);
+    const trimmed = base.replace(/\/+$/, '');
+    return trimmed || 'tests';
+}
+function inferTestExtension(patterns, framework) {
+    const joined = patterns.join(' ');
+    if (joined.includes('.ts') || joined.includes('.tsx')) {
+        return 'ts';
+    }
+    return 'js';
+}
+function createPlaywrightTest(flow, testIds) {
+    const idsComment = testIds.length > 0 ? `// Suggested data-testid: ${testIds.join(', ')}` : '// TODO: add data-testid selectors';
+    return [
+        "import {test, expect} from '@mattermost/playwright-lib';",
+        '',
+        '/**',
+        ` * @objective Validate ${flow.name} flow`,
+        ' */',
+        `test('${flow.priority}: ${flow.name} basic flow', {tag: '@ai-assisted'}, async ({pw}) => {`,
+        '  const {user, team} = await pw.initSetup();',
+        '  const {channelsPage} = await pw.testBrowser.login(user);',
+        "  await channelsPage.goto(team.name);",
+        `  ${idsComment}`,
+        '  // # TODO: implement steps',
+        '  // * TODO: implement assertions',
+        '  await expect(channelsPage.page).toHaveURL(/.*/);',
+        '});',
+        '',
+    ].join('\n');
+}
+function createCypressTest(flow, testIds) {
+    const idsComment = testIds.length > 0 ? `// Suggested data-testid: ${testIds.join(', ')}` : '// TODO: add data-testid selectors';
+    return [
+        `describe('Flow: ${flow.name}', () => {`,
+        `  it('${flow.priority}: ${flow.name} basic flow', () => {`,
+        "    cy.visit('/');",
+        `    ${idsComment}`,
+        '    // TODO: implement steps',
+        '    cy.url().should(\'match\', /.*/);',
+        '  });',
+        '});',
+        '',
+    ].join('\n');
+}
+function createSeleniumTest(flow, testIds) {
+    const idsComment = testIds.length > 0 ? `// Suggested data-testid: ${testIds.join(', ')}` : '// TODO: add data-testid selectors';
+    return [
+        "const {Builder, By, until} = require('selenium-webdriver');",
+        '',
+        `(async () => {`,
+        "  const driver = await new Builder().forBrowser('chrome').build();",
+        '  try {',
+        "    await driver.get('http://localhost:3000');",
+        `    ${idsComment}`,
+        '    // TODO: implement steps',
+        '    await driver.wait(until.titleIs(\'\'), 5000);',
+        '  } finally {',
+        '    await driver.quit();',
+        '  }',
+        '})();',
+        '',
+    ].join('\n');
+}
+function generateTests(appRoot, flows, framework, testPatterns, testIdsByFlow) {
+    const inferredTestDir = inferTestDir(testPatterns);
+    const safeTestDir = (0, utils_js_1.isPathWithinRoot)(appRoot, (0, path_1.resolve)(appRoot, inferredTestDir)) ? inferredTestDir : 'tests';
+    const testDir = safeTestDir;
+    const extension = inferTestExtension(testPatterns, framework);
+    const generated = [];
+    for (const flow of flows) {
+        if (flow.priority !== 'P0' && flow.priority !== 'P1') {
+            continue;
+        }
+        const testIds = testIdsByFlow.get(flow.id) || [];
+        const fileName = framework === 'cypress' ? `${flow.id}.cy.${extension}` : `${flow.id}.spec.${extension}`;
+        const fullPath = (0, path_1.resolve)(appRoot, testDir, fileName);
+        if (!(0, utils_js_1.isPathWithinRoot)(appRoot, fullPath)) {
+            generated.push({ path: fullPath, flowId: flow.id, created: false, reason: 'outside-root' });
+            continue;
+        }
+        if ((0, fs_1.existsSync)(fullPath)) {
+            generated.push({ path: fullPath, flowId: flow.id, created: false, reason: 'exists' });
+            continue;
+        }
+        (0, fs_1.mkdirSync)((0, path_1.join)(appRoot, testDir), { recursive: true });
+        let content = '';
+        if (framework === 'cypress') {
+            content = createCypressTest(flow, testIds);
+        }
+        else if (framework === 'selenium') {
+            content = createSeleniumTest(flow, testIds);
+        }
+        else {
+            content = createPlaywrightTest(flow, testIds);
+        }
+        (0, fs_1.writeFileSync)(fullPath, content, 'utf-8');
+        generated.push({ path: fullPath, flowId: flow.id, created: true });
+    }
+    return generated;
+}

package/dist/agent/git.d.ts

@@ -0,0 +1,11 @@
+export interface GitChangeResult {
+    files: string[];
+    error?: string;
+    baseRef?: string;
+    baseStrategy?: 'merge-base' | 'direct';
+}
+export interface GitChangeOptions {
+    includeUncommitted?: boolean;
+}
+export declare function getChangedFiles(appRoot: string, since: string, options?: GitChangeOptions): GitChangeResult;
+//# sourceMappingURL=git.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../src/agent/git.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,eAAe;IAC5B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,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,CAuC3G"}

package/dist/agent/git.js

@@ -0,0 +1,90 @@
+"use strict";
+// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
+// See LICENSE.txt for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getChangedFiles = getChangedFiles;
+const child_process_1 = require("child_process");
+const utils_js_1 = require("./utils.js");
+function runGitRaw(args, cwd) {
+    const result = (0, child_process_1.spawnSync)('git', args, {
+        cwd,
+        encoding: 'utf-8',
+        timeout: 30000,
+    });
+    if (result.error || result.status !== 0) {
+        return null;
+    }
+    return result.stdout;
+}
+function runGit(args, cwd) {
+    const output = runGitRaw(args, cwd);
+    if (output === null) {
+        return null;
+    }
+    return output
+        .split('\n')
+        .map((file) => file.trim())
+        .filter(Boolean)
+        .map((file) => (0, utils_js_1.normalizePath)(file));
+}
+function parseStatusLines(lines) {
+    const files = [];
+    for (const line of lines) {
+        if (!line)
+            continue;
+        if (line.length < 4)
+            continue;
+        const pathPart = line.slice(3).trim();
+        if (!pathPart)
+            continue;
+        if (pathPart.includes('->')) {
+            const parts = pathPart.split('->').map((part) => part.trim());
+            const target = parts[parts.length - 1];
+            if (target) {
+                files.push((0, utils_js_1.normalizePath)(target));
+            }
+        }
+        else {
+            files.push((0, utils_js_1.normalizePath)(pathPart));
+        }
+    }
+    return files;
+}
+function getChangedFiles(appRoot, since, options) {
+    try {
+        const files = new Set();
+        let baseRef = since;
+        let baseStrategy = 'direct';
+        const mergeBase = runGitRaw(['merge-base', since, 'HEAD'], appRoot);
+        if (mergeBase) {
+            const candidate = mergeBase
+                .split('\n')
+                .map((line) => line.trim())
+                .find(Boolean);
+            if (candidate) {
+                baseRef = candidate;
+                baseStrategy = 'merge-base';
+            }
+        }
+        const diffFiles = runGit(['diff', '--name-only', `${baseRef}..HEAD`, '--', '.'], appRoot);
+        if (!diffFiles) {
+            return { files: [], error: 'git diff failed' };
+        }
+        diffFiles.forEach((file) => files.add(file));
+        if (options?.includeUncommitted) {
+            const staged = runGit(['diff', '--name-only', '--cached', '--', '.'], appRoot) || [];
+            staged.forEach((file) => files.add(file));
+            const unstaged = runGit(['diff', '--name-only', '--', '.'], appRoot) || [];
+            unstaged.forEach((file) => files.add(file));
+            const statusOutput = runGitRaw(['status', '--porcelain', '--', '.'], appRoot);
+            if (statusOutput) {
+                const statusLines = statusOutput.split('\n').filter(Boolean);
+                parseStatusLines(statusLines).forEach((file) => files.add(file));
+            }
+        }
+        return { files: Array.from(files), baseRef, baseStrategy };
+    }
+    catch {
+        return { files: [], error: 'git diff failed' };
+    }
+}

package/dist/agent/handoff.d.ts

@@ -0,0 +1,22 @@
+export interface FinalizeGeneratedTestsOptions {
+    appPath: string;
+    testsRoot?: string;
+    gapReportPath?: string;
+    branch?: string;
+    commitMessage?: string;
+    createPr?: boolean;
+    prTitle?: string;
+    prBody?: string;
+    baseBranch?: string;
+    dryRun?: boolean;
+}
+export interface FinalizeGeneratedTestsResult {
+    repoRoot: string;
+    branch: string;
+    stagedPaths: string[];
+    committed: boolean;
+    commitSha?: string;
+    prUrl?: string;
+}
+export declare function finalizeGeneratedTests(options: FinalizeGeneratedTestsOptions): FinalizeGeneratedTestsResult;
+//# sourceMappingURL=handoff.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"handoff.d.ts","sourceRoot":"","sources":["../../src/agent/handoff.ts"],"names":[],"mappings":"AAwBA,MAAM,WAAW,6BAA6B;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,4BAA4B;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AA+HD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,6BAA6B,GAAG,4BAA4B,CAmE3G"}

package/dist/agent/handoff.js

@@ -0,0 +1,180 @@
+"use strict";
+// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
+// See LICENSE.txt for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.finalizeGeneratedTests = finalizeGeneratedTests;
+const child_process_1 = require("child_process");
+const fs_1 = require("fs");
+const path_1 = require("path");
+function runCommand(bin, args, cwd, opts = {}) {
+    try {
+        const stdout = (0, child_process_1.execFileSync)(bin, args, { cwd, encoding: 'utf-8', stdio: ['ignore', 'pipe', 'pipe'] });
+        return { ok: true, stdout: stdout.trim(), stderr: '' };
+    }
+    catch (error) {
+        if (opts.allowFailure) {
+            const cause = error;
+            const stdout = typeof cause.stdout === 'string' ? cause.stdout : cause.stdout?.toString('utf-8') || '';
+            const stderr = typeof cause.stderr === 'string' ? cause.stderr : cause.stderr?.toString('utf-8') || cause.message || '';
+            return { ok: false, stdout: stdout.trim(), stderr: stderr.trim() };
+        }
+        throw error;
+    }
+}
+function normalizeBranchName(branch) {
+    if (!branch || !branch.trim()) {
+        return undefined;
+    }
+    const trimmed = branch.trim();
+    if (trimmed.startsWith('codex/')) {
+        return trimmed;
+    }
+    return `codex/${trimmed.replace(/^\/+/, '')}`;
+}
+function resolveRepoRoot(appPath) {
+    const abs = (0, path_1.resolve)(appPath);
+    const result = runCommand('git', ['-C', abs, 'rev-parse', '--show-toplevel'], abs, { allowFailure: true });
+    if (!result.ok || !result.stdout) {
+        throw new Error(`Unable to find git repository root from ${abs}: ${result.stderr || 'git rev-parse failed'}`);
+    }
+    return result.stdout;
+}
+function readGapReport(path) {
+    if (!(0, fs_1.existsSync)(path)) {
+        throw new Error(`Gap report not found: ${path}`);
+    }
+    try {
+        return JSON.parse((0, fs_1.readFileSync)(path, 'utf-8'));
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Unable to parse gap report at ${path}: ${message}`);
+    }
+}
+function uniq(values) {
+    return Array.from(new Set(values.filter(Boolean)));
+}
+function toRepoRelative(repoRoot, absoluteOrRelative) {
+    const absolute = (0, path_1.resolve)(absoluteOrRelative);
+    return (0, path_1.relative)(repoRoot, absolute) || '.';
+}
+function isRepoRelativePathSafe(path) {
+    if (!path || path === '.') {
+        return false;
+    }
+    if (path.startsWith('..') || path.includes('/../') || path.includes('\\..\\')) {
+        return false;
+    }
+    return true;
+}
+function collectStageTargets(repoRoot, appPath, testsRoot, gap) {
+    const targets = [];
+    const applied = gap.applied || {};
+    for (const patched of applied.patchedFiles || []) {
+        targets.push(toRepoRelative(repoRoot, (0, path_1.resolve)(appPath, patched)));
+    }
+    for (const generated of applied.generatedTests || []) {
+        targets.push(toRepoRelative(repoRoot, generated));
+    }
+    for (const result of gap.pipeline?.results || []) {
+        if (result.generatedDir) {
+            targets.push(toRepoRelative(repoRoot, result.generatedDir));
+        }
+    }
+    const artifacts = ['gap.json', 'impact.json', 'plan.json', 'ci-summary.md', 'pr-comment.md'];
+    for (const file of artifacts) {
+        targets.push(toRepoRelative(repoRoot, (0, path_1.resolve)(testsRoot, '.e2e-ai-agents', file)));
+    }
+    return uniq(targets).filter((path) => isRepoRelativePathSafe(path) && (0, fs_1.existsSync)((0, path_1.resolve)(repoRoot, path)));
+}
+function ensureBranch(repoRoot, requestedBranch, dryRun = false) {
+    const current = runCommand('git', ['branch', '--show-current'], repoRoot, { allowFailure: true });
+    const currentBranch = current.stdout || 'HEAD';
+    const normalized = normalizeBranchName(requestedBranch);
+    if (!normalized) {
+        return currentBranch;
+    }
+    if (currentBranch === normalized) {
+        return currentBranch;
+    }
+    const exists = runCommand('git', ['rev-parse', '--verify', normalized], repoRoot, { allowFailure: true }).ok;
+    if (!dryRun) {
+        if (exists) {
+            runCommand('git', ['checkout', normalized], repoRoot);
+        }
+        else {
+            runCommand('git', ['checkout', '-b', normalized], repoRoot);
+        }
+    }
+    return normalized;
+}
+function hasStagedChanges(repoRoot) {
+    const result = runCommand('git', ['diff', '--cached', '--name-only'], repoRoot, { allowFailure: true });
+    if (!result.ok) {
+        return false;
+    }
+    return result.stdout.trim().length > 0;
+}
+function finalizeGeneratedTests(options) {
+    const appPath = (0, path_1.resolve)(options.appPath);
+    const testsRoot = (0, path_1.resolve)(options.testsRoot || options.appPath);
+    const repoRoot = resolveRepoRoot(appPath);
+    const gapReportPath = options.gapReportPath || (0, path_1.resolve)(testsRoot, '.e2e-ai-agents', 'gap.json');
+    const gap = readGapReport(gapReportPath);
+    const stageTargets = collectStageTargets(repoRoot, appPath, testsRoot, gap);
+    const commitMessage = options.commitMessage || 'test(e2e): add generated coverage and healed specs';
+    const dryRun = Boolean(options.dryRun);
+    const branch = ensureBranch(repoRoot, options.branch, dryRun);
+    if (stageTargets.length === 0) {
+        return {
+            repoRoot,
+            branch,
+            stagedPaths: [],
+            committed: false,
+        };
+    }
+    for (const path of stageTargets) {
+        if (!dryRun) {
+            runCommand('git', ['add', '--', path], repoRoot, { allowFailure: true });
+        }
+    }
+    let committed = false;
+    let commitSha;
+    if (!dryRun && hasStagedChanges(repoRoot)) {
+        runCommand('git', ['commit', '-m', commitMessage], repoRoot);
+        committed = true;
+        const head = runCommand('git', ['rev-parse', 'HEAD'], repoRoot, { allowFailure: true });
+        if (head.ok) {
+            commitSha = head.stdout;
+        }
+    }
+    let prUrl;
+    if (!dryRun && options.createPr) {
+        const args = ['pr', 'create'];
+        if (options.prTitle) {
+            args.push('--title', options.prTitle);
+        }
+        if (options.prBody) {
+            args.push('--body', options.prBody);
+        }
+        if (options.baseBranch) {
+            args.push('--base', options.baseBranch);
+        }
+        if (!options.prTitle && !options.prBody) {
+            args.push('--fill');
+        }
+        const result = runCommand('gh', args, repoRoot, { allowFailure: true });
+        if (!result.ok) {
+            throw new Error(`Failed to create PR via gh: ${result.stderr || 'unknown error'}`);
+        }
+        prUrl = result.stdout.split('\n').find((line) => line.startsWith('http')) || result.stdout;
+    }
+    return {
+        repoRoot,
+        branch,
+        stagedPaths: stageTargets,
+        committed,
+        commitSha,
+        prUrl,
+    };
+}

package/dist/agent/impact-analyzer.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
+ * See LICENSE.txt for license information.
+ *
+ * Impact Analysis Engine
+ *
+ * Analyzes code changes and identifies which user flows are affected,
+ * then maps those flows to test coverage gaps.
+ */
+export interface GitChange {
+    path: string;
+    status: 'added' | 'modified' | 'deleted';
+    ref?: string;
+}
+export interface ChangeAnalysis {
+    file: string;
+    status: 'added' | 'modified' | 'deleted';
+    linesAdded: number;
+    linesRemoved: number;
+    functions: string[];
+    classes: string[];
+    imports: Array<{
+        from: string;
+        names: string[];
+    }>;
+}
+export interface Flow {
+    id: string;
+    name: string;
+    priority: 'P0' | 'P1' | 'P2';
+    keywords: string[];
+    paths: string[];
+    tests: string[];
+    audience: string[];
+    flags: Array<{
+        name: string;
+        source: string;
+    }>;
+}
+export interface FlowImpact {
+    flow: Flow;
+    matchType: 'path' | 'keyword' | 'import' | 'combined';
+    confidence: number;
+    affectedFiles: string[];
+    existingTests: string[];
+    testGaps: string[];
+    reasons: string[];
+}
+export interface FlowGroup {
+    id: string;
+    name: string;
+    description: string;
+    flows: string[];
+    testStrategy: 'sequential' | 'parallel' | 'mixed';
+    priority: string;
+    affectedFlows: FlowImpact[];
+}
+export interface ImpactReport {
+    timestamp: string;
+    gitRef: string;
+    totalChanges: number;
+    affectedFlows: FlowImpact[];
+    flowGroups: FlowGroup[];
+    ungroupedFlows: FlowImpact[];
+    priorityBreakdown: {
+        p0: number;
+        p1: number;
+        p2: number;
+    };
+    testCoverage: {
+        total: number;
+        covered: number;
+        gaps: number;
+    };
+    recommendations: string[];
+    hasP0Impact: boolean;
+}
+/**
+ * Intelligently detect the best git reference for comparison:
+ * - If on feature branch: use origin/master, origin/main, or master
+ * - If on main branch: use HEAD~1
+ * Returns the best available reference to compare against
+ */
+export declare function detectComparisonBase(): string;
+/**
+ * Get git changes since a given reference
+ * Filters to only include frontend files (webapp and e2e-tests)
+ */
+export declare function getGitChanges(since?: string): GitChange[];
+/**
+ * Load flow catalog from flows.json
+ */
+export declare function loadFlowCatalog(catalogPath?: string): Flow[];
+/**
+ * Match a flow to changed files
+ */
+export declare function matchFlowToChanges(flow: Flow, changes: ChangeAnalysis[]): FlowImpact | null;
+/**
+ * Find existing tests for a flow
+ */
+export declare function findExistingTests(flow: Flow, repoRoot?: string): string[];
+/**
+ * Identify test coverage gaps for a flow
+ */
+export declare function identifyTestGaps(flow: Flow, existingTests: string[]): string[];
+/**
+ * Analyze code impact and return comprehensive report
+ */
+export declare function analyzeImpact(changes: GitChange[], flows: Flow[], options?: {
+    verbose?: boolean;
+    includeTests?: boolean;
+    repoRoot?: string;
+}): Promise<ImpactReport>;
+//# sourceMappingURL=impact-analyzer.d.ts.map

package/dist/agent/impact-analyzer.d.ts.map

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