@yasserkhanorg/impact-gate 2.0.0

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

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

package/dist/agent/plan.js

@@ -0,0 +1,86 @@
+"use strict";
+// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
+// See LICENSE.txt for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.appendPlanMetrics = appendPlanMetrics;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const PLAN_METRICS_EVENTS_PATH = '.e2e-ai-agents/metrics.jsonl';
+const PLAN_METRICS_SUMMARY_PATH = '.e2e-ai-agents/metrics-summary.json';
+function parsePlanMetricLine(line) {
+    const trimmed = line.trim();
+    if (!trimmed) {
+        return null;
+    }
+    try {
+        const parsed = JSON.parse(trimmed);
+        if (!parsed || parsed.schemaVersion !== '1.0.0' || typeof parsed.runId !== 'string') {
+            return null;
+        }
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+function appendPlanMetrics(appRoot, plan) {
+    const baseDir = (0, path_1.join)(appRoot, '.e2e-ai-agents');
+    (0, fs_1.mkdirSync)(baseDir, { recursive: true });
+    const eventsPath = (0, path_1.join)(appRoot, PLAN_METRICS_EVENTS_PATH);
+    const summaryPath = (0, path_1.join)(appRoot, PLAN_METRICS_SUMMARY_PATH);
+    const event = {
+        schemaVersion: '1.0.0',
+        timestamp: new Date().toISOString(),
+        runId: plan.runId,
+        sourceRunId: plan.sourceRunId,
+        action: plan.decision.action,
+        runSet: plan.runSet,
+        confidence: plan.confidence,
+        changedFiles: plan.metrics.changedFiles,
+        impactedFlows: plan.metrics.impactedFlows,
+        uncoveredP0P1Flows: plan.metrics.uncoveredP0P1Flows,
+        warnings: plan.metrics.warnings,
+        enforcementMode: plan.enforcement.mode,
+        enforcementShouldFail: plan.enforcement.shouldFail,
+    };
+    (0, fs_1.appendFileSync)(eventsPath, `${JSON.stringify(event)}\n`, 'utf-8');
+    const allEvents = (0, fs_1.existsSync)(eventsPath)
+        ? (0, fs_1.readFileSync)(eventsPath, 'utf-8')
+            .split('\n')
+            .map(parsePlanMetricLine)
+            .filter((item) => Boolean(item))
+        : [event];
+    const byAction = {
+        'run-now': 0,
+        'must-add-tests': 0,
+        'safe-to-merge': 0,
+    };
+    const byRunSet = {
+        smoke: 0,
+        targeted: 0,
+        full: 0,
+    };
+    let totalConfidence = 0;
+    let blockingRecommendations = 0;
+    for (const metricEvent of allEvents) {
+        byAction[metricEvent.action] += 1;
+        byRunSet[metricEvent.runSet] += 1;
+        totalConfidence += metricEvent.confidence;
+        if (metricEvent.enforcementShouldFail) {
+            blockingRecommendations += 1;
+        }
+    }
+    const totalRuns = allEvents.length;
+    const summary = {
+        schemaVersion: '1.0.0',
+        generatedAt: new Date().toISOString(),
+        totalRuns,
+        averageConfidence: totalRuns > 0 ? Number((totalConfidence / totalRuns).toFixed(2)) : 0,
+        byAction,
+        byRunSet,
+        blockingRecommendations,
+        blockingRate: totalRuns > 0 ? Number((blockingRecommendations / totalRuns).toFixed(4)) : 0,
+    };
+    (0, fs_1.writeFileSync)(summaryPath, JSON.stringify(summary, null, 2), 'utf-8');
+    return { eventsPath, summaryPath };
+}

package/dist/agent/playwright_report.d.ts

@@ -0,0 +1,8 @@
+export interface UnstablePlaywrightSpec {
+    specPath: string;
+    status: 'failed' | 'flaky';
+    failingTests: number;
+    flakyTests: number;
+}
+export declare function extractPlaywrightUnstableSpecs(reportPath: string, roots: string[]): UnstablePlaywrightSpec[];
+//# sourceMappingURL=playwright_report.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"playwright_report.d.ts","sourceRoot":"","sources":["../../src/agent/playwright_report.ts"],"names":[],"mappings":"AA6BA,MAAM,WAAW,sBAAsB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,QAAQ,GAAG,OAAO,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACtB;AA4HD,wBAAgB,8BAA8B,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,sBAAsB,EAAE,CAW5G"}

package/dist/agent/playwright_report.js

@@ -0,0 +1,126 @@
+"use strict";
+// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
+// See LICENSE.txt for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractPlaywrightUnstableSpecs = extractPlaywrightUnstableSpecs;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const utils_js_1 = require("./utils.js");
+function asRecord(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        return null;
+    }
+    return value;
+}
+function asArray(value) {
+    return Array.isArray(value) ? value : [];
+}
+function isFailureStatus(value) {
+    return value === 'failed' || value === 'timedOut' || value === 'interrupted';
+}
+function classifyTestInstability(testNode) {
+    const outcome = typeof testNode.outcome === 'string' ? testNode.outcome : '';
+    if (outcome === 'unexpected') {
+        return 'failed';
+    }
+    if (outcome === 'flaky') {
+        return 'flaky';
+    }
+    const status = typeof testNode.status === 'string' ? testNode.status : '';
+    if (status === 'flaky') {
+        return 'flaky';
+    }
+    if (isFailureStatus(status)) {
+        return 'failed';
+    }
+    let sawFailure = false;
+    let sawPass = false;
+    for (const resultValue of asArray(testNode.results)) {
+        const resultNode = asRecord(resultValue);
+        if (!resultNode) {
+            continue;
+        }
+        const resultStatus = typeof resultNode.status === 'string' ? resultNode.status : '';
+        if (isFailureStatus(resultStatus)) {
+            sawFailure = true;
+        }
+        else if (resultStatus === 'passed') {
+            sawPass = true;
+        }
+    }
+    if (sawFailure && sawPass) {
+        return 'flaky';
+    }
+    if (sawFailure) {
+        return 'failed';
+    }
+    return 'stable';
+}
+function relativize(pathValue, roots) {
+    const normalized = (0, utils_js_1.normalizePath)(pathValue);
+    for (const root of roots) {
+        const normalizedRoot = (0, utils_js_1.normalizePath)((0, path_1.resolve)(root));
+        if (normalized === normalizedRoot) {
+            return '.';
+        }
+        if (normalized.startsWith(`${normalizedRoot}/`)) {
+            return normalized.slice(normalizedRoot.length + 1);
+        }
+    }
+    return normalized;
+}
+function collectUnstableSpecs(value, roots, unstableMap) {
+    const node = asRecord(value);
+    if (!node) {
+        return;
+    }
+    for (const specValue of asArray(node.specs)) {
+        const specNode = asRecord(specValue);
+        if (!specNode || typeof specNode.file !== 'string') {
+            continue;
+        }
+        let failingTests = 0;
+        let flakyTests = 0;
+        for (const testValue of asArray(specNode.tests)) {
+            const testNode = asRecord(testValue);
+            if (!testNode) {
+                continue;
+            }
+            const instability = classifyTestInstability(testNode);
+            if (instability === 'failed') {
+                failingTests += 1;
+            }
+            else if (instability === 'flaky') {
+                flakyTests += 1;
+            }
+        }
+        if (failingTests === 0 && flakyTests === 0) {
+            continue;
+        }
+        const specPath = relativize(specNode.file, roots);
+        const existing = unstableMap.get(specPath);
+        const mergedFailing = (existing?.failingTests || 0) + failingTests;
+        const mergedFlaky = (existing?.flakyTests || 0) + flakyTests;
+        unstableMap.set(specPath, {
+            specPath,
+            status: mergedFailing > 0 ? 'failed' : 'flaky',
+            failingTests: mergedFailing,
+            flakyTests: mergedFlaky,
+        });
+    }
+    for (const suite of asArray(node.suites)) {
+        collectUnstableSpecs(suite, roots, unstableMap);
+    }
+}
+function extractPlaywrightUnstableSpecs(reportPath, roots) {
+    const fullPath = (0, path_1.resolve)(reportPath);
+    const raw = JSON.parse((0, fs_1.readFileSync)(fullPath, 'utf-8'));
+    const unstableMap = new Map();
+    collectUnstableSpecs(raw, roots, unstableMap);
+    return Array.from(unstableMap.values()).sort((a, b) => {
+        if (a.status !== b.status) {
+            return a.status === 'failed' ? -1 : 1;
+        }
+        return a.specPath.localeCompare(b.specPath);
+    });
+}

package/dist/agent/process_runner.d.ts

@@ -0,0 +1,10 @@
+import type { PipelineConfig } from './config.js';
+import type { CommandResult } from './pipeline_types.js';
+export declare function resolvePlaywrightBinary(testsRoot: string): string | null;
+export declare function summarizeCommandOutput(stdout: string, stderr: string): string;
+export declare function runCommand(command: string, args: string[], cwd: string, timeoutMs?: number, envOverride?: NodeJS.ProcessEnv): CommandResult;
+export declare function resolveMcpCommandTimeoutMs(pipeline: PipelineConfig): number;
+export declare function resolveMcpRetries(pipeline: PipelineConfig): number;
+export declare function isRetryableMcpFailure(result: CommandResult): boolean;
+export declare function runCommandWithRetries(command: string, args: string[], cwd: string, timeoutMs: number, retries: number): CommandResult;
+//# sourceMappingURL=process_runner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"process_runner.d.ts","sourceRoot":"","sources":["../../src/agent/process_runner.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,qBAAqB,CAAC;AAEvD,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAUxE;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAO7E;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,SAAiB,EAAE,WAAW,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,aAAa,CAsBnJ;AAED,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,CAM3E;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,CAMlE;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAQpE;AAED,wBAAgB,qBAAqB,CACjC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GAChB,aAAa,CAYf"}

package/dist/agent/process_runner.js

@@ -0,0 +1,92 @@
+"use strict";
+// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
+// See LICENSE.txt for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolvePlaywrightBinary = resolvePlaywrightBinary;
+exports.summarizeCommandOutput = summarizeCommandOutput;
+exports.runCommand = runCommand;
+exports.resolveMcpCommandTimeoutMs = resolveMcpCommandTimeoutMs;
+exports.resolveMcpRetries = resolveMcpRetries;
+exports.isRetryableMcpFailure = isRetryableMcpFailure;
+exports.runCommandWithRetries = runCommandWithRetries;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const child_process_1 = require("child_process");
+function resolvePlaywrightBinary(testsRoot) {
+    const unixPath = (0, path_1.join)(testsRoot, 'node_modules', '.bin', 'playwright');
+    const windowsPath = (0, path_1.join)(testsRoot, 'node_modules', '.bin', 'playwright.cmd');
+    if ((0, fs_1.existsSync)(unixPath)) {
+        return unixPath;
+    }
+    if ((0, fs_1.existsSync)(windowsPath)) {
+        return windowsPath;
+    }
+    return null;
+}
+function summarizeCommandOutput(stdout, stderr) {
+    const combined = [stdout, stderr].filter(Boolean).join('\n').trim();
+    if (!combined) {
+        return '';
+    }
+    const lines = combined.split('\n').slice(-20);
+    return lines.join('\n').slice(0, 2000);
+}
+function runCommand(command, args, cwd, timeoutMs = 60 * 60 * 1000, envOverride) {
+    // When spawning `claude`, unset CLAUDECODE so nested invocations are allowed.
+    // Claude Code sets this variable to block nested sessions; child processes
+    // that spawn their own claude instance must run without it.
+    let env = envOverride;
+    if (!env && command === 'claude') {
+        const { CLAUDECODE: _, ...rest } = process.env;
+        env = rest;
+    }
+    const result = (0, child_process_1.spawnSync)(command, args, {
+        cwd,
+        encoding: 'utf-8',
+        timeout: timeoutMs,
+        stdio: 'pipe',
+        ...(env ? { env } : {}),
+    });
+    return {
+        status: result.status ?? 1,
+        stdout: result.stdout || '',
+        stderr: result.stderr || '',
+        error: result.error ? result.error.message : undefined,
+    };
+}
+function resolveMcpCommandTimeoutMs(pipeline) {
+    const value = pipeline.mcpCommandTimeoutMs;
+    if (typeof value !== 'number' || !Number.isFinite(value)) {
+        return 180000;
+    }
+    return Math.max(60000, Math.min(15 * 60 * 1000, Math.round(value)));
+}
+function resolveMcpRetries(pipeline) {
+    const value = pipeline.mcpRetries;
+    if (typeof value !== 'number' || !Number.isFinite(value)) {
+        return 1;
+    }
+    return Math.max(0, Math.min(5, Math.round(value)));
+}
+function isRetryableMcpFailure(result) {
+    const haystack = [result.error || '', result.stderr || '', result.stdout || ''].join('\n').toLowerCase();
+    return haystack.includes('etimedout') ||
+        haystack.includes('timed out') ||
+        haystack.includes('econnreset') ||
+        haystack.includes('429') ||
+        haystack.includes('rate limit') ||
+        haystack.includes('temporar');
+}
+function runCommandWithRetries(command, args, cwd, timeoutMs, retries) {
+    let result = runCommand(command, args, cwd, timeoutMs);
+    for (let attempt = 1; attempt <= retries; attempt += 1) {
+        if (result.status === 0) {
+            return result;
+        }
+        if (!isRetryableMcpFailure(result)) {
+            return result;
+        }
+        result = runCommand(command, args, cwd, timeoutMs);
+    }
+    return result;
+}

package/dist/agent/spec_generator.d.ts

@@ -0,0 +1,5 @@
+import type { FlowImpact } from './types.js';
+import type { ApiSurfaceCatalog, NativeSpecQualityIssue, NativeSpecStrategy } from './pipeline_types.js';
+export declare function validateGeneratedSpecContent(content: string, apiSurface?: ApiSurfaceCatalog): NativeSpecQualityIssue[];
+export declare function createNativePlaywrightSpec(flow: FlowImpact, slug: string, strategy: NativeSpecStrategy): string;
+//# sourceMappingURL=spec_generator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"spec_generator.d.ts","sourceRoot":"","sources":["../../src/agent/spec_generator.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAC,iBAAiB,EAAE,sBAAsB,EAAE,kBAAkB,EAAC,MAAM,qBAAqB,CAAC;AAIvG,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,iBAAiB,GAAG,sBAAsB,EAAE,CAgHtH;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,kBAAkB,GAAG,MAAM,CAyJ/G"}

package/dist/agent/spec_generator.js

@@ -0,0 +1,253 @@
+"use strict";
+// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
+// See LICENSE.txt for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateGeneratedSpecContent = validateGeneratedSpecContent;
+exports.createNativePlaywrightSpec = createNativePlaywrightSpec;
+const api_catalog_js_1 = require("./api_catalog.js");
+const pipeline_utils_js_1 = require("./pipeline_utils.js");
+function validateGeneratedSpecContent(content, apiSurface) {
+    const issues = [];
+    if (/\btest\.describe\s*\(/.test(content)) {
+        issues.push({
+            code: 'disallowed-describe',
+            message: 'Generated tests must not use test.describe.',
+        });
+    }
+    if (/\btest\.only\s*\(/.test(content)) {
+        issues.push({
+            code: 'disallowed-only',
+            message: 'Generated tests must not use test.only.',
+        });
+    }
+    if (!/\btest\s*\(/.test(content)) {
+        issues.push({
+            code: 'missing-test',
+            message: 'Generated file does not include a test() declaration.',
+        });
+    }
+    if (/\btag\s*:\s*\[/.test(content)) {
+        issues.push({
+            code: 'tag-array-disallowed',
+            message: 'Generated tests must use a single tag string, not a tag array.',
+        });
+    }
+    const hasTagOption = /\btag\s*:\s*['"][^'"]+['"]/.test(content);
+    const hasTagInTitle = /\btest(?:\.\w+)?\s*\(\s*['"][^'"]*@ai-assisted[^'"]*['"]/.test(content);
+    if (!(hasTagOption || hasTagInTitle) || !/@ai-assisted/.test(content)) {
+        issues.push({
+            code: 'missing-tag',
+            message: "Generated tests must include '@ai-assisted' either as tag option or in test title.",
+        });
+    }
+    if (/\bsystemConsolePage\.toBeVisible\s*\(/.test(content)) {
+        issues.push({
+            code: 'fragile-system-console-visibility',
+            message: 'Avoid systemConsolePage.toBeVisible(); it relies on legacy backstage navigation that may be absent.',
+        });
+    }
+    const fragileSelectors = [
+        '.backstage-navbar',
+        '.admin-console__wrapper',
+        '.left-panel',
+        '.panel-card',
+    ].filter((selector) => content.includes(selector));
+    if (fragileSelectors.length > 0) {
+        issues.push({
+            code: 'fragile-selector',
+            message: `Avoid brittle class selectors in generated tests: ${Array.from(new Set(fragileSelectors)).join(', ')}`,
+        });
+    }
+    if (apiSurface) {
+        const unknownPwProps = Array.from((0, api_catalog_js_1.collectMatches)(content, /\bpw\.([A-Za-z_][A-Za-z0-9_]*)\b/g)).filter((prop) => !apiSurface.pwProps.has(prop));
+        const unknownBrowserMethods = Array.from((0, api_catalog_js_1.collectMatches)(content, /\bpw\.testBrowser\.([A-Za-z_][A-Za-z0-9_]*)\b/g)).filter((method) => !apiSurface.testBrowserMethods.has(method));
+        const unknownNestedPwMembers = [];
+        for (const match of content.matchAll(/\bpw\.([A-Za-z_][A-Za-z0-9_]*)\.([A-Za-z_][A-Za-z0-9_]*)\b/g)) {
+            const objectName = match[1];
+            const methodName = match[2];
+            if (!objectName || !methodName || objectName === 'testBrowser') {
+                continue;
+            }
+            const knownMethods = apiSurface.pwNestedMethods.get(objectName);
+            if (!knownMethods || !knownMethods.has(methodName)) {
+                unknownNestedPwMembers.push(`pw.${objectName}.${methodName}`);
+            }
+        }
+        const unknownChannelMembers = Array.from((0, api_catalog_js_1.collectMatches)(content, /\bchannelsPage\.([A-Za-z_][A-Za-z0-9_]*)\b/g)).filter((member) => !apiSurface.channelsPageMembers.has(member));
+        const unknownSidebarMembers = Array.from((0, api_catalog_js_1.collectMatches)(content, /\bchannelsPage\.sidebarRight\.([A-Za-z_][A-Za-z0-9_]*)\b/g)).filter((member) => !apiSurface.sidebarRightMembers.has(member));
+        const initSetupBindings = (0, api_catalog_js_1.parseInitSetupBindings)(content);
+        const unknownInitSetupKeys = initSetupBindings
+            .map((binding) => binding.key)
+            .filter((key) => !apiSurface.initSetupKeys.has(key));
+        const unknownInitSetupVariableMethods = [];
+        for (const binding of initSetupBindings) {
+            const knownMethods = apiSurface.initSetupVariableMethods.get(binding.variable);
+            if (!knownMethods || knownMethods.size === 0) {
+                continue;
+            }
+            const methodPattern = new RegExp(`\\b${(0, api_catalog_js_1.escapeRegExp)(binding.variable)}\\.([A-Za-z_][A-Za-z0-9_]*)\\b`, 'g');
+            for (const method of (0, api_catalog_js_1.collectMatches)(content, methodPattern)) {
+                if (!knownMethods.has(method)) {
+                    unknownInitSetupVariableMethods.push(`${binding.variable}.${method}`);
+                }
+            }
+        }
+        const unknown = [
+            ...unknownPwProps.map((value) => `pw.${value}`),
+            ...unknownBrowserMethods.map((value) => `pw.testBrowser.${value}`),
+            ...unknownNestedPwMembers,
+            ...unknownChannelMembers.map((value) => `channelsPage.${value}`),
+            ...unknownSidebarMembers.map((value) => `channelsPage.sidebarRight.${value}`),
+            ...unknownInitSetupKeys.map((value) => `pw.initSetup.{${value}}`),
+            ...unknownInitSetupVariableMethods,
+        ];
+        if (unknown.length > 0) {
+            issues.push({
+                code: 'unknown-api-surface',
+                message: `Generated test uses unknown API/page-object members: ${Array.from(new Set(unknown)).join(', ')}`,
+            });
+        }
+    }
+    return issues;
+}
+function createNativePlaywrightSpec(flow, slug, strategy) {
+    const linkedFiles = (0, pipeline_utils_js_1.firstFlowFiles)(flow).join(', ') || 'N/A';
+    const header = [
+        "import {test, expect} from '@mattermost/playwright-lib';",
+        '',
+        '/**',
+        ` * Auto-generated by @yasserkhanorg/impact-gate`,
+        ` * Flow: ${flow.id} (${flow.name})`,
+        ` * Strategy: ${strategy}`,
+        ` * Linked files: ${linkedFiles}`,
+        ' */',
+    ];
+    const start = [
+        `test('${flow.priority}: ${flow.name} generated coverage', {tag: '@ai-assisted'}, async ({pw}) => {`,
+        '  const {user, team} = await pw.initSetup();',
+        '  const {channelsPage} = await pw.testBrowser.login(user);',
+        '  await channelsPage.goto(team.name);',
+    ];
+    const end = [
+        '});',
+        '',
+    ];
+    if (strategy === 'thread-reply') {
+        return [
+            ...header,
+            ...start,
+            `  const parentMessage = \`ai-${slug}-parent-\${Date.now()}\`;`,
+            '  await channelsPage.postMessage(parentMessage);',
+            '  const rootPost = await channelsPage.getLastPost();',
+            '  await rootPost.openAThread();',
+            `  const replyMessage = \`ai-${slug}-reply-\${Date.now()}\`;`,
+            '  await channelsPage.sidebarRight.postMessage(replyMessage);',
+            '  const lastReply = await channelsPage.sidebarRight.getLastPost();',
+            '  await expect(lastReply.container).toContainText(replyMessage);',
+            ...end,
+        ].join('\n');
+    }
+    if (strategy === 'lifecycle-channel') {
+        return [
+            ...header,
+            ...start,
+            `  const channelName = \`ai-${slug}-\${Date.now().toString().slice(-6)}\`;`,
+            "  await channelsPage.newChannel(channelName, 'O');",
+            '  await expect(channelsPage.page).toHaveURL(new RegExp(`/channels/${channelName}$`));',
+            ...end,
+        ].join('\n');
+    }
+    if (strategy === 'channel-settings') {
+        return [
+            ...header,
+            ...start,
+            '  await channelsPage.openChannelSettings();',
+            "  await expect(channelsPage.page.getByRole('dialog', {name: 'Channel Settings'})).toBeVisible();",
+            "  await channelsPage.page.keyboard.press('Escape');",
+            ...end,
+        ].join('\n');
+    }
+    if (strategy === 'channel-switch') {
+        return [
+            ...header,
+            ...start,
+            "  await channelsPage.goto(team.name, 'off-topic');",
+            "  await expect(channelsPage.page).toHaveURL(/\\/channels\\/off-topic$/);",
+            "  await expect(channelsPage.page.locator('#channelHeaderTitle')).toContainText(/off-topic/i);",
+            ...end,
+        ].join('\n');
+    }
+    if (strategy === 'markdown-post') {
+        return [
+            ...header,
+            ...start,
+            `  const message = '**ai-${slug}-bold** _italic_';`,
+            '  await channelsPage.postMessage(message);',
+            '  const lastPost = await channelsPage.getLastPost();',
+            "  await expect(lastPost.container.locator('strong')).toBeVisible();",
+            ...end,
+        ].join('\n');
+    }
+    if (strategy === 'mentions-post') {
+        return [
+            ...header,
+            ...start,
+            '  const mention = `@${user.username}`;',
+            '  await channelsPage.postMessage(`Ping ${mention}`);',
+            '  const lastPost = await channelsPage.getLastPost();',
+            '  await expect(lastPost.container).toContainText(mention);',
+            ...end,
+        ].join('\n');
+    }
+    if (strategy === 'realtime-post') {
+        return [
+            ...header,
+            ...start,
+            `  const message = \`ai-${slug}-realtime-\${Date.now()}\`;`,
+            '  await channelsPage.postMessage(message);',
+            '  const lastPost = await channelsPage.getLastPost();',
+            '  await expect(lastPost.container).toContainText(message);',
+            "  await expect(channelsPage.page.locator('#channel_view')).toBeVisible();",
+            ...end,
+        ].join('\n');
+    }
+    if (strategy === 'message-post') {
+        return [
+            ...header,
+            ...start,
+            `  const message = \`ai-${slug}-message-\${Date.now()}\`;`,
+            '  await channelsPage.postMessage(message);',
+            '  await expect(channelsPage.getLastPost()).toContainText(message);',
+            ...end,
+        ].join('\n');
+    }
+    if (strategy === 'channel-baseline') {
+        return [
+            ...header,
+            ...start,
+            "  await expect(channelsPage.page.locator('#channelHeaderTitle')).toBeVisible();",
+            "  await expect(channelsPage.page.locator('#SidebarContainer')).toBeVisible();",
+            ...end,
+        ].join('\n');
+    }
+    if (strategy === 'search-baseline') {
+        return [
+            ...header,
+            ...start,
+            `  const searchTerm = \`ai-${slug}-\${Date.now().toString().slice(-6)}\`;`,
+            '  await channelsPage.postMessage(searchTerm);',
+            '  await channelsPage.globalHeader.openSearch();',
+            '  await channelsPage.searchBox.searchInput.fill(searchTerm);',
+            "  await channelsPage.page.keyboard.press('Enter');",
+            "  await expect(channelsPage.page.locator('#searchContainer')).toBeVisible();",
+            ...end,
+        ].join('\n');
+    }
+    return [
+        ...header,
+        ...start,
+        '  await expect(channelsPage.page).toHaveURL(/\\/channels\\//);',
+        "  await expect(channelsPage.page.locator('#channelHeaderTitle')).toBeVisible();",
+        ...end,
+    ].join('\n');
+}

package/dist/agent/test_path.d.ts

@@ -0,0 +1,2 @@
+export declare function inferSubsystemFromTestPath(test: string): string;
+//# sourceMappingURL=test_path.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"test_path.d.ts","sourceRoot":"","sources":["../../src/agent/test_path.ts"],"names":[],"mappings":"AAOA,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAiB/D"}

package/dist/agent/test_path.js

@@ -0,0 +1,23 @@
+"use strict";
+// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
+// See LICENSE.txt for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.inferSubsystemFromTestPath = inferSubsystemFromTestPath;
+function normalizeTestName(test) {
+    return test.replace(/ \(flags:.*\)$/, '').trim();
+}
+function inferSubsystemFromTestPath(test) {
+    const normalized = normalizeTestName(test).replace(/^\/+/, '');
+    const parts = normalized.split('/').filter(Boolean);
+    if (parts.length === 0) {
+        return 'unknown';
+    }
+    const specsIdx = parts.findIndex((part) => part === 'specs' || part === 'tests');
+    if (specsIdx >= 0 && specsIdx + 1 < parts.length) {
+        return parts[specsIdx + 1] || 'unknown';
+    }
+    if (parts.length >= 2 && (parts[0] === 'e2e-tests' || parts[0] === 'playwright')) {
+        return parts[1] || 'unknown';
+    }
+    return parts[0] || 'unknown';
+}

package/dist/agent/traceability_capture.d.ts

@@ -0,0 +1,18 @@
+export interface TraceabilityCaptureOptions {
+    appPath: string;
+    testsRoot: string;
+    reportPath: string;
+    sinceRef: string;
+    outputPath?: string;
+    coverageMapPath?: string;
+    changedFilesPath?: string;
+}
+export interface TraceabilityCaptureResult {
+    outputPath: string;
+    testsSeen: number;
+    runsGenerated: number;
+    changedFilesUsed: number;
+    warnings: string[];
+}
+export declare function captureTraceabilityInput(options: TraceabilityCaptureOptions): TraceabilityCaptureResult;
+//# sourceMappingURL=traceability_capture.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"traceability_capture.d.ts","sourceRoot":"","sources":["../../src/agent/traceability_capture.ts"],"names":[],"mappings":"AAmCA,MAAM,WAAW,0BAA0B;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,yBAAyB;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACtB;AAgRD,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,0BAA0B,GAAG,yBAAyB,CAgFvG"}