@yasserkhanorg/impact-gate 2.0.0

package/dist/agent/llm_agents_flow.js

@@ -0,0 +1,434 @@
+"use strict";
+// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
+// See LICENSE.txt for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findSpecFiles = findSpecFiles;
+exports.findDisallowedDescribeFiles = findDisallowedDescribeFiles;
+exports.hasCommand = hasCommand;
+exports.hasPlaywrightAgentDefinitions = hasPlaywrightAgentDefinitions;
+exports.hasPlaywrightConfig = hasPlaywrightConfig;
+exports.bootstrapPlaywrightAgentDefinitions = bootstrapPlaywrightAgentDefinitions;
+exports.resolveAgentSeedSpec = resolveAgentSeedSpec;
+exports.buildPlaywrightAgentsPrompt = buildPlaywrightAgentsPrompt;
+exports.buildPlaywrightHealerPrompt = buildPlaywrightHealerPrompt;
+exports.runPlaywrightAgentsFlow = runPlaywrightAgentsFlow;
+exports.runPlaywrightAgentsPipeline = runPlaywrightAgentsPipeline;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const utils_js_1 = require("./utils.js");
+const pipeline_utils_js_1 = require("./pipeline_utils.js");
+const spec_generator_js_1 = require("./spec_generator.js");
+const process_runner_js_1 = require("./process_runner.js");
+const validation_runner_js_1 = require("./validation_runner.js");
+const api_catalog_js_1 = require("./api_catalog.js");
+function findSpecFiles(root) {
+    if (!(0, fs_1.existsSync)(root)) {
+        return [];
+    }
+    const entries = (0, fs_1.readdirSync)(root, { withFileTypes: true });
+    const files = [];
+    for (const entry of entries) {
+        const fullPath = (0, path_1.join)(root, entry.name);
+        if (entry.isDirectory()) {
+            files.push(...findSpecFiles(fullPath));
+        }
+        else if (entry.isFile() && entry.name.endsWith('.spec.ts')) {
+            files.push(fullPath);
+        }
+    }
+    return files;
+}
+function findDisallowedDescribeFiles(root) {
+    const files = findSpecFiles(root);
+    return files.filter((file) => /\btest\.describe\s*\(/.test((0, fs_1.readFileSync)(file, 'utf-8')));
+}
+function hasCommand(command, cwd) {
+    const result = (0, process_runner_js_1.runCommand)(command, ['--version'], cwd);
+    return result.status === 0;
+}
+function hasPlaywrightAgentDefinitions(testsRoot) {
+    const required = [
+        '.mcp.json',
+        '.claude/agents/playwright-test-planner.md',
+        '.claude/agents/playwright-test-generator.md',
+        '.claude/agents/playwright-test-healer.md',
+    ];
+    return required.every((path) => (0, fs_1.existsSync)((0, path_1.join)(testsRoot, path)));
+}
+function hasPlaywrightConfig(testsRoot) {
+    const candidates = [
+        'playwright.config.ts',
+        'playwright.config.js',
+        'playwright.config.mts',
+        'playwright.config.mjs',
+        'playwright.config.cts',
+        'playwright.config.cjs',
+    ];
+    return candidates.some((candidate) => (0, fs_1.existsSync)((0, path_1.join)(testsRoot, candidate)));
+}
+function bootstrapPlaywrightAgentDefinitions(testsRoot, pipeline, timeoutMs) {
+    const args = ['playwright', 'init-agents', '--loop=claude', '--prompts'];
+    if (pipeline.project) {
+        args.push('--project', pipeline.project);
+    }
+    return (0, process_runner_js_1.runCommand)('npx', args, testsRoot, timeoutMs);
+}
+function resolveAgentSeedSpec(testsRoot) {
+    const preferred = (0, path_1.join)(testsRoot, 'specs', 'seed.spec.ts');
+    const specsRoot = (0, path_1.join)(testsRoot, 'specs');
+    const specFiles = findSpecFiles(specsRoot).filter((file) => !(0, utils_js_1.normalizePath)(file).includes('/functional/ai-assisted/'));
+    const scored = specFiles
+        .map((file) => {
+        const rel = (0, utils_js_1.normalizePath)((0, path_1.relative)(testsRoot, file));
+        const content = (0, fs_1.readFileSync)(file, 'utf-8');
+        let score = 0;
+        if (rel.endsWith('/seed.spec.ts')) {
+            // Generated default seed from init-agents is often a placeholder; prefer real tests.
+            if (!/generate code here/i.test(content)) {
+                score += 2;
+            }
+        }
+        if (content.includes('@mattermost/playwright-lib')) {
+            score += 8;
+        }
+        if (content.includes('pw.initSetup(')) {
+            score += 6;
+        }
+        if (content.includes('testBrowser.login(')) {
+            score += 4;
+        }
+        if (content.includes('channelsPage')) {
+            score += 2;
+        }
+        if (rel.includes('/functional/channels/')) {
+            score += 1;
+        }
+        return { rel, score };
+    })
+        .sort((a, b) => b.score - a.score);
+    if (scored.length > 0 && scored[0].score > 0) {
+        return scored[0].rel;
+    }
+    if ((0, fs_1.existsSync)(preferred)) {
+        return (0, utils_js_1.normalizePath)((0, path_1.relative)(testsRoot, preferred));
+    }
+    return null;
+}
+function buildPlaywrightAgentsPrompt(flow, seedFile, planFile, testFile, includeHealer) {
+    const linkedFiles = (0, pipeline_utils_js_1.firstFlowFiles)(flow).join(', ') || 'N/A';
+    const reasons = (flow.reasons || []).slice(0, 5).join(' | ') || 'N/A';
+    return [
+        'Use official Playwright Test agents (planner, generator, healer) to implement exactly one high-quality test for this flow.',
+        '',
+        `Flow ID: ${flow.id}`,
+        `Flow Name: ${flow.name}`,
+        `Priority: ${flow.priority}`,
+        `Linked files: ${linkedFiles}`,
+        `Risk reasons: ${reasons}`,
+        '',
+        'Workflow requirements:',
+        '1) Use #playwright-test-planner to explore and save a focused test plan.',
+        '2) Use #playwright-test-generator to generate one test from that plan.',
+        includeHealer
+            ? '3) Use #playwright-test-healer to run and fix that generated test.'
+            : '3) Skip runtime healing and focus on producing compile-ready test code.',
+        '',
+        `Seed file: ${seedFile}`,
+        `Plan file to save: ${planFile}`,
+        `Generated test file path (must be exact): ${testFile}`,
+        '',
+        'Quality constraints (must follow):',
+        '- The generated file must contain a standalone test() and must not use test.describe or test.only.',
+        '- Do not mark the test with test.fixme unless user explicitly requests skipping.',
+        "- The generated test must include a single tag string '@ai-assisted'.",
+        '- Match fixture/import style from the seed file. Prefer existing page-object APIs over raw brittle selectors.',
+        '- Only use `pw` and page-object methods that already exist in the seed/current specs (for example, do not invent APIs like `pw.mainClient.*`).',
+        '- For system-console/admin flows, avoid `systemConsolePage.toBeVisible()` and brittle class selectors (`.backstage-navbar`, `.admin-console__wrapper`, `.left-panel`, `.panel-card`).',
+        '- Prefer stable assertions using URL patterns, test IDs, roles, labels, and established page-object methods.',
+        '- Keep the scenario strictly aligned to the flow and linked files, not broad unrelated flows.',
+        '',
+        'At the end, return a short summary that includes the generated test file path and whether healing succeeded.',
+    ].join('\n');
+}
+function buildPlaywrightHealerPrompt(testFile, extra) {
+    const lines = [
+        'Heal this specific Playwright test file and keep edits minimal.',
+        `Target test file: ${testFile}`,
+        'Constraints:',
+        '- Do not use test.describe or test.only.',
+        "- Keep a single tag string '@ai-assisted'.",
+        '- Use only existing Mattermost Playwright fixture/page-object APIs; do not invent new `pw.*` clients or methods.',
+        '- Avoid `systemConsolePage.toBeVisible()` and brittle class selectors (`.backstage-navbar`, `.admin-console__wrapper`, `.left-panel`, `.panel-card`).',
+        '- Prefer stable checks with URL/test IDs/roles/page-object methods.',
+        '- Keep the test intent unchanged and focused.',
+        '',
+        'Run and fix this test until it compiles/passes, or mark test.fixme with a clear comment when behavior is truly broken.',
+    ];
+    if (extra) {
+        lines.push('', `Context: ${extra}`);
+    }
+    return lines.join('\n');
+}
+function runPlaywrightAgentsFlow(testsRoot, flow, pipeline, outputDir, preferredTestFile, seedFile, apiSurface, playwrightBinary, mcpTimeoutMs, mcpRetries) {
+    (0, fs_1.mkdirSync)(outputDir, { recursive: true });
+    const slug = (0, pipeline_utils_js_1.toSafeSlug)(flow.id);
+    const planFile = (0, utils_js_1.normalizePath)((0, path_1.relative)(testsRoot, (0, path_1.join)(outputDir, `${slug}.plan.md`)));
+    const absolutePlanFile = (0, path_1.join)(testsRoot, planFile);
+    const targetTestFile = (0, utils_js_1.normalizePath)((0, path_1.relative)(testsRoot, preferredTestFile));
+    const existingSpecFiles = findSpecFiles(outputDir);
+    const existingSpecSnapshots = new Map();
+    for (const specFile of existingSpecFiles) {
+        try {
+            existingSpecSnapshots.set(specFile, (0, fs_1.readFileSync)(specFile, 'utf-8'));
+        }
+        catch {
+            continue;
+        }
+    }
+    const originalPlanContent = (0, fs_1.existsSync)(absolutePlanFile) ? (0, fs_1.readFileSync)(absolutePlanFile, 'utf-8') : null;
+    const restoreArtifactsOnFailure = () => {
+        for (const currentSpecFile of findSpecFiles(outputDir)) {
+            const originalSpecContent = existingSpecSnapshots.get(currentSpecFile);
+            if (originalSpecContent === undefined) {
+                (0, fs_1.rmSync)(currentSpecFile, { force: true });
+                continue;
+            }
+            try {
+                if ((0, fs_1.readFileSync)(currentSpecFile, 'utf-8') !== originalSpecContent) {
+                    (0, fs_1.writeFileSync)(currentSpecFile, originalSpecContent, 'utf-8');
+                }
+            }
+            catch {
+                // best-effort restore only
+            }
+        }
+        for (const [specFile, originalSpecContent] of existingSpecSnapshots.entries()) {
+            if (!(0, fs_1.existsSync)(specFile)) {
+                (0, fs_1.writeFileSync)(specFile, originalSpecContent, 'utf-8');
+            }
+        }
+        if (originalPlanContent === null) {
+            (0, fs_1.rmSync)(absolutePlanFile, { force: true });
+        }
+        else {
+            try {
+                if (!(0, fs_1.existsSync)(absolutePlanFile) || (0, fs_1.readFileSync)(absolutePlanFile, 'utf-8') !== originalPlanContent) {
+                    (0, fs_1.writeFileSync)(absolutePlanFile, originalPlanContent, 'utf-8');
+                }
+            }
+            catch {
+                // best-effort restore only
+            }
+        }
+    };
+    const failFlow = (error) => {
+        restoreArtifactsOnFailure();
+        return {
+            flowId: flow.id,
+            flowName: flow.name,
+            generatedDir: outputDir,
+            generateStatus: 'failed',
+            healStatus: pipeline.heal ? 'failed' : undefined,
+            error,
+        };
+    };
+    if (pipeline.dryRun) {
+        return {
+            flowId: flow.id,
+            flowName: flow.name,
+            generatedDir: outputDir,
+            generateStatus: 'skipped',
+            healStatus: pipeline.heal ? 'skipped' : undefined,
+        };
+    }
+    const prompt = buildPlaywrightAgentsPrompt(flow, seedFile, planFile, targetTestFile, Boolean(pipeline.heal));
+    const runArgs = [
+        '-p',
+        '--permission-mode',
+        'bypassPermissions',
+        '--setting-sources',
+        'project,local',
+        '--strict-mcp-config',
+        '--mcp-config',
+        '.mcp.json',
+        '--add-dir',
+        testsRoot,
+        '--',
+        prompt,
+    ];
+    const runResult = (0, process_runner_js_1.runCommandWithRetries)('claude', runArgs, testsRoot, mcpTimeoutMs, mcpRetries);
+    if (runResult.status !== 0) {
+        return failFlow((0, process_runner_js_1.summarizeCommandOutput)(runResult.stdout, runResult.stderr) || runResult.error || 'Playwright agents run failed');
+    }
+    let actualTestFile = preferredTestFile;
+    if (!(0, fs_1.existsSync)(actualTestFile)) {
+        const candidates = findSpecFiles(outputDir);
+        if (candidates.length === 1) {
+            actualTestFile = candidates[0];
+        }
+    }
+    if (!(0, fs_1.existsSync)(actualTestFile)) {
+        return failFlow(`Playwright agents did not produce expected test file: ${targetTestFile}`);
+    }
+    const relativeActualTestFile = (0, utils_js_1.normalizePath)((0, path_1.relative)(testsRoot, actualTestFile));
+    let qualityIssues = (0, spec_generator_js_1.validateGeneratedSpecContent)((0, fs_1.readFileSync)(actualTestFile, 'utf-8'), apiSurface);
+    if (qualityIssues.length > 0 && pipeline.heal) {
+        const healResult = (0, process_runner_js_1.runCommandWithRetries)('claude', [
+            '-p',
+            '--permission-mode',
+            'bypassPermissions',
+            '--setting-sources',
+            'project,local',
+            '--strict-mcp-config',
+            '--agent',
+            'playwright-test-healer',
+            '--mcp-config',
+            '.mcp.json',
+            '--add-dir',
+            testsRoot,
+            '--',
+            buildPlaywrightHealerPrompt(relativeActualTestFile, qualityIssues.map((issue) => issue.message).join(' | ')),
+        ], testsRoot, mcpTimeoutMs, mcpRetries);
+        if (healResult.status === 0 && (0, fs_1.existsSync)(actualTestFile)) {
+            qualityIssues = (0, spec_generator_js_1.validateGeneratedSpecContent)((0, fs_1.readFileSync)(actualTestFile, 'utf-8'), apiSurface);
+        }
+    }
+    if (qualityIssues.length > 0) {
+        return failFlow(`Playwright agents produced invalid test content: ${qualityIssues.map((issue) => issue.message).join(' | ')}`);
+    }
+    if (pipeline.heal) {
+        let compileValidation = (0, validation_runner_js_1.runPlaywrightListValidation)(testsRoot, actualTestFile, pipeline, playwrightBinary);
+        if (compileValidation.status === 'failed') {
+            const healResult = (0, process_runner_js_1.runCommandWithRetries)('claude', [
+                '-p',
+                '--permission-mode',
+                'bypassPermissions',
+                '--setting-sources',
+                'project,local',
+                '--strict-mcp-config',
+                '--agent',
+                'playwright-test-healer',
+                '--mcp-config',
+                '.mcp.json',
+                '--add-dir',
+                testsRoot,
+                '--',
+                buildPlaywrightHealerPrompt(relativeActualTestFile, compileValidation.detail || 'playwright --list failed'),
+            ], testsRoot, mcpTimeoutMs, mcpRetries);
+            if (healResult.status === 0 && (0, fs_1.existsSync)(actualTestFile)) {
+                compileValidation = (0, validation_runner_js_1.runPlaywrightListValidation)(testsRoot, actualTestFile, pipeline, playwrightBinary);
+            }
+            if (compileValidation.status === 'failed') {
+                return failFlow(`Playwright agents compile validation failed: ${compileValidation.detail || 'playwright --list failed'}`);
+            }
+        }
+        let runtimeValidation = (0, validation_runner_js_1.runPlaywrightRuntimeValidation)(testsRoot, actualTestFile, pipeline, playwrightBinary);
+        if (runtimeValidation.status === 'failed') {
+            const healResult = (0, process_runner_js_1.runCommandWithRetries)('claude', [
+                '-p',
+                '--permission-mode',
+                'bypassPermissions',
+                '--setting-sources',
+                'project,local',
+                '--strict-mcp-config',
+                '--agent',
+                'playwright-test-healer',
+                '--mcp-config',
+                '.mcp.json',
+                '--add-dir',
+                testsRoot,
+                '--',
+                buildPlaywrightHealerPrompt(relativeActualTestFile, runtimeValidation.detail || 'playwright runtime failed'),
+            ], testsRoot, mcpTimeoutMs, mcpRetries);
+            if (healResult.status === 0 && (0, fs_1.existsSync)(actualTestFile)) {
+                runtimeValidation = (0, validation_runner_js_1.runPlaywrightRuntimeValidation)(testsRoot, actualTestFile, pipeline, playwrightBinary);
+            }
+            if (runtimeValidation.status === 'failed') {
+                return failFlow(`Playwright agents runtime validation failed: ${runtimeValidation.detail || 'playwright test failed'}`);
+            }
+        }
+    }
+    return {
+        flowId: flow.id,
+        flowName: flow.name,
+        generatedDir: outputDir,
+        generateStatus: 'success',
+        healStatus: pipeline.heal ? 'success' : undefined,
+    };
+}
+function runPlaywrightAgentsPipeline(testsRoot, flows, pipeline) {
+    const warnings = [];
+    const results = [];
+    const mcpTimeoutMs = (0, process_runner_js_1.resolveMcpCommandTimeoutMs)(pipeline);
+    const mcpRetries = (0, process_runner_js_1.resolveMcpRetries)(pipeline);
+    if (!hasCommand('claude', testsRoot)) {
+        warnings.push('Claude CLI is required for official Playwright planner/generator/healer execution but was not found.');
+        return { runner: 'unknown', results, warnings, mcp: (0, pipeline_utils_js_1.createMcpStatus)('unknown', true) };
+    }
+    if (!hasPlaywrightConfig(testsRoot)) {
+        warnings.push('Playwright config file not found in testsRoot; skipping official Playwright agents backend.');
+        return { runner: 'unknown', results, warnings, mcp: (0, pipeline_utils_js_1.createMcpStatus)('unknown', true) };
+    }
+    if (!hasPlaywrightAgentDefinitions(testsRoot)) {
+        const bootstrap = bootstrapPlaywrightAgentDefinitions(testsRoot, pipeline, mcpTimeoutMs);
+        if (bootstrap.status !== 0) {
+            warnings.push((0, process_runner_js_1.summarizeCommandOutput)(bootstrap.stdout, bootstrap.stderr) ||
+                bootstrap.error ||
+                'Failed to initialize Playwright agents via `npx playwright init-agents`.');
+            return { runner: 'unknown', results, warnings, mcp: (0, pipeline_utils_js_1.createMcpStatus)('unknown', true) };
+        }
+    }
+    if (!hasPlaywrightAgentDefinitions(testsRoot)) {
+        warnings.push('Playwright agent definitions are missing after bootstrap.');
+        return { runner: 'unknown', results, warnings, mcp: (0, pipeline_utils_js_1.createMcpStatus)('unknown', true) };
+    }
+    const seedFile = resolveAgentSeedSpec(testsRoot);
+    if (!seedFile) {
+        warnings.push('No seed spec file found under specs/. Playwright planner cannot be initialized.');
+        return { runner: 'unknown', results, warnings, mcp: (0, pipeline_utils_js_1.createMcpStatus)('unknown', true) };
+    }
+    const playwrightBinary = pipeline.heal ? (0, process_runner_js_1.resolvePlaywrightBinary)(testsRoot) : null;
+    const apiSurface = (0, api_catalog_js_1.buildApiSurfaceCatalog)(testsRoot, seedFile);
+    if (pipeline.heal && !playwrightBinary) {
+        warnings.push('Playwright binary was not found. Healer runtime validation may be limited.');
+    }
+    const outputBase = (0, path_1.resolve)(testsRoot, pipeline.outputDir || 'specs/functional/ai-assisted');
+    if (!(0, utils_js_1.isPathWithinRoot)(testsRoot, outputBase)) {
+        warnings.push(`Pipeline outputDir resolves outside testsRoot and was blocked: ${pipeline.outputDir}`);
+        return { runner: 'unknown', results, warnings, mcp: (0, pipeline_utils_js_1.createMcpStatus)('unknown', true) };
+    }
+    for (const flow of flows) {
+        if (flow.priority !== 'P0' && flow.priority !== 'P1') {
+            continue;
+        }
+        const slug = (0, pipeline_utils_js_1.toSafeSlug)(flow.id);
+        const outputDir = (0, utils_js_1.normalizePath)((0, path_1.join)(outputBase, slug));
+        if (!(0, utils_js_1.isPathWithinRoot)(testsRoot, outputDir)) {
+            results.push({
+                flowId: flow.id,
+                flowName: flow.name,
+                generatedDir: outputDir,
+                generateStatus: 'failed',
+                error: 'output directory resolves outside testsRoot',
+            });
+            continue;
+        }
+        const testFile = (0, utils_js_1.normalizePath)((0, path_1.join)(outputDir, `${slug}.spec.ts`));
+        if (!(0, utils_js_1.isPathWithinRoot)(testsRoot, testFile)) {
+            results.push({
+                flowId: flow.id,
+                flowName: flow.name,
+                generatedDir: outputDir,
+                generateStatus: 'failed',
+                error: 'generated test path resolves outside testsRoot',
+            });
+            continue;
+        }
+        results.push(runPlaywrightAgentsFlow(testsRoot, flow, pipeline, outputDir, testFile, seedFile, apiSurface, playwrightBinary, mcpTimeoutMs, mcpRetries));
+        if (pipeline.mcpOnly && results[results.length - 1].generateStatus === 'failed') {
+            warnings.push(`MCP-only mode: stopping after first failed flow (${flow.id}).`);
+            break;
+        }
+    }
+    return { runner: 'playwright-agents', results, warnings, mcp: (0, pipeline_utils_js_1.createMcpStatus)('playwright-agents', true) };
+}

package/dist/agent/native_flow.d.ts

@@ -0,0 +1,6 @@
+import type { PipelineConfig } from './config.js';
+import type { FlowImpact } from './types.js';
+import type { ApiSurfaceCatalog, PipelineResult, PipelineSummary } from './pipeline_types.js';
+export declare function runPackageNativeFlow(testsRoot: string, flow: FlowImpact, pipeline: PipelineConfig, outputDir: string, testFile: string, playwrightBinary: string | null, apiSurface: ApiSurfaceCatalog): PipelineResult;
+export declare function runPackageNativePipeline(testsRoot: string, flows: FlowImpact[], pipeline: PipelineConfig, baseWarnings?: string[]): PipelineSummary;
+//# sourceMappingURL=native_flow.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"native_flow.d.ts","sourceRoot":"","sources":["../../src/agent/native_flow.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAC,iBAAiB,EAAsB,cAAc,EAAE,eAAe,EAAC,MAAM,qBAAqB,CAAC;AAShH,wBAAgB,oBAAoB,CAChC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,UAAU,EAChB,QAAQ,EAAE,cAAc,EACxB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,gBAAgB,EAAE,MAAM,GAAG,IAAI,EAC/B,UAAU,EAAE,iBAAiB,GAC9B,cAAc,CAgHhB;AAED,wBAAgB,wBAAwB,CACpC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,UAAU,EAAE,EACnB,QAAQ,EAAE,cAAc,EACxB,YAAY,GAAE,MAAM,EAAO,GAC5B,eAAe,CA+DjB"}

package/dist/agent/native_flow.js

@@ -0,0 +1,179 @@
+"use strict";
+// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
+// See LICENSE.txt for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runPackageNativeFlow = runPackageNativeFlow;
+exports.runPackageNativePipeline = runPackageNativePipeline;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const utils_js_1 = require("./utils.js");
+const pipeline_utils_js_1 = require("./pipeline_utils.js");
+const spec_generator_js_1 = require("./spec_generator.js");
+const process_runner_js_1 = require("./process_runner.js");
+const validation_runner_js_1 = require("./validation_runner.js");
+const api_catalog_js_1 = require("./api_catalog.js");
+const llm_agents_flow_js_1 = require("./llm_agents_flow.js");
+function runPackageNativeFlow(testsRoot, flow, pipeline, outputDir, testFile, playwrightBinary, apiSurface) {
+    const flowId = flow.id;
+    const flowName = flow.name;
+    const existingFile = (0, fs_1.existsSync)(testFile);
+    const originalContent = existingFile ? (0, fs_1.readFileSync)(testFile, 'utf-8') : null;
+    if (existingFile && !pipeline.heal) {
+        return {
+            flowId,
+            flowName,
+            generatedDir: outputDir,
+            generateStatus: 'skipped',
+        };
+    }
+    const slug = (0, pipeline_utils_js_1.toSafeSlug)(flow.id);
+    const strategies = (0, pipeline_utils_js_1.buildNativeStrategyOrder)(flow);
+    const attempts = [];
+    const candidates = [];
+    if (pipeline.heal && originalContent !== null) {
+        candidates.push({
+            label: 'existing',
+            content: originalContent,
+            write: false,
+        });
+    }
+    for (const strategy of strategies) {
+        candidates.push({
+            label: strategy,
+            strategy,
+            content: (0, spec_generator_js_1.createNativePlaywrightSpec)(flow, slug, strategy),
+            write: true,
+        });
+    }
+    (0, fs_1.mkdirSync)(outputDir, { recursive: true });
+    let wroteNewFile = false;
+    for (let i = 0; i < candidates.length; i += 1) {
+        const candidate = candidates[i];
+        if (candidate.write) {
+            (0, fs_1.writeFileSync)(testFile, candidate.content, 'utf-8');
+            wroteNewFile = true;
+        }
+        const currentContent = candidate.write ? candidate.content : (originalContent || '');
+        const qualityIssues = (0, spec_generator_js_1.validateGeneratedSpecContent)(currentContent, apiSurface);
+        if (qualityIssues.length > 0) {
+            attempts.push(`${candidate.label}: ${qualityIssues.map((issue) => issue.message).join(' ')}`);
+            if (pipeline.heal && i < candidates.length - 1) {
+                continue;
+            }
+            if (originalContent !== null) {
+                (0, fs_1.writeFileSync)(testFile, originalContent, 'utf-8');
+            }
+            else if (wroteNewFile && (0, fs_1.existsSync)(testFile)) {
+                (0, fs_1.rmSync)(testFile, { force: true });
+            }
+            return {
+                flowId,
+                flowName,
+                generatedDir: outputDir,
+                generateStatus: 'failed',
+                healStatus: pipeline.heal ? 'failed' : undefined,
+                error: `Quality checks failed. Attempts: ${attempts.join(' | ')}`,
+            };
+        }
+        if (pipeline.heal) {
+            const validation = (0, validation_runner_js_1.runPlaywrightListValidation)(testsRoot, testFile, pipeline, playwrightBinary);
+            if (validation.status === 'failed') {
+                attempts.push(`${candidate.label}: ${validation.detail || 'playwright validation failed'}`);
+                if (i < candidates.length - 1) {
+                    continue;
+                }
+                if (originalContent !== null) {
+                    (0, fs_1.writeFileSync)(testFile, originalContent, 'utf-8');
+                }
+                else if (wroteNewFile && (0, fs_1.existsSync)(testFile)) {
+                    (0, fs_1.rmSync)(testFile, { force: true });
+                }
+                return {
+                    flowId,
+                    flowName,
+                    generatedDir: outputDir,
+                    generateStatus: 'failed',
+                    healStatus: 'failed',
+                    error: `Heal validation failed. Attempts: ${attempts.join(' | ')}`,
+                };
+            }
+        }
+        return {
+            flowId,
+            flowName,
+            generatedDir: outputDir,
+            generateStatus: candidate.write ? 'success' : 'skipped',
+            healStatus: pipeline.heal ? 'success' : undefined,
+        };
+    }
+    if (originalContent !== null) {
+        (0, fs_1.writeFileSync)(testFile, originalContent, 'utf-8');
+    }
+    else if (wroteNewFile && (0, fs_1.existsSync)(testFile)) {
+        (0, fs_1.rmSync)(testFile, { force: true });
+    }
+    return {
+        flowId,
+        flowName,
+        generatedDir: outputDir,
+        generateStatus: 'failed',
+        healStatus: pipeline.heal ? 'failed' : undefined,
+        error: attempts.length > 0 ? attempts.join(' | ') : 'No generation candidates were available.',
+    };
+}
+function runPackageNativePipeline(testsRoot, flows, pipeline, baseWarnings = []) {
+    const warningSet = new Set(baseWarnings);
+    const mcp = (0, pipeline_utils_js_1.createMcpStatus)('package-native', Boolean(pipeline.mcp));
+    const playwrightBinary = pipeline.heal ? (0, process_runner_js_1.resolvePlaywrightBinary)(testsRoot) : null;
+    const seedFile = (0, llm_agents_flow_js_1.resolveAgentSeedSpec)(testsRoot) || 'specs/seed.spec.ts';
+    const apiSurface = (0, api_catalog_js_1.buildApiSurfaceCatalog)(testsRoot, seedFile);
+    if (pipeline.heal && !playwrightBinary) {
+        warningSet.add('Playwright binary was not found. Heal uses static quality checks without runtime compile validation.');
+    }
+    const results = [];
+    const outputBase = (0, path_1.resolve)(testsRoot, pipeline.outputDir || 'specs/functional/ai-assisted');
+    if (!(0, utils_js_1.isPathWithinRoot)(testsRoot, outputBase)) {
+        warningSet.add(`Pipeline outputDir resolves outside testsRoot and was blocked: ${pipeline.outputDir}`);
+        return { runner: 'unknown', results, warnings: Array.from(warningSet), mcp: (0, pipeline_utils_js_1.createMcpStatus)('unknown', Boolean(pipeline.mcp)) };
+    }
+    for (const flow of flows) {
+        if (flow.priority !== 'P0' && flow.priority !== 'P1') {
+            continue;
+        }
+        const slug = (0, pipeline_utils_js_1.toSafeSlug)(flow.id);
+        const outputDir = (0, utils_js_1.normalizePath)((0, path_1.join)(outputBase, slug));
+        if (!(0, utils_js_1.isPathWithinRoot)(testsRoot, outputDir)) {
+            results.push({
+                flowId: flow.id,
+                flowName: flow.name,
+                generatedDir: outputDir,
+                generateStatus: 'failed',
+                error: 'output directory resolves outside testsRoot',
+            });
+            continue;
+        }
+        if (pipeline.dryRun) {
+            results.push({
+                flowId: flow.id,
+                flowName: flow.name,
+                generatedDir: outputDir,
+                generateStatus: 'skipped',
+                healStatus: pipeline.heal ? 'skipped' : undefined,
+            });
+            continue;
+        }
+        const testFile = (0, utils_js_1.normalizePath)((0, path_1.join)(outputDir, `${slug}.spec.ts`));
+        if (!(0, utils_js_1.isPathWithinRoot)(testsRoot, testFile)) {
+            results.push({
+                flowId: flow.id,
+                flowName: flow.name,
+                generatedDir: outputDir,
+                generateStatus: 'failed',
+                error: 'generated test path resolves outside testsRoot',
+            });
+            continue;
+        }
+        results.push(runPackageNativeFlow(testsRoot, flow, pipeline, outputDir, testFile, playwrightBinary, apiSurface));
+    }
+    return { runner: 'package-native', results, warnings: Array.from(warningSet), mcp };
+}

package/dist/agent/pipeline.d.ts

@@ -0,0 +1,7 @@
+import type { PipelineConfig } from './config.js';
+import type { FlowImpact } from './types.js';
+import type { PipelineSummary, SpecHealTarget } from './pipeline_types.js';
+export type { PipelineResult, PipelineSummary, SpecHealTarget } from './pipeline_types.js';
+export declare function runTargetedSpecHeal(testsRoot: string, targets: SpecHealTarget[], pipeline: PipelineConfig): PipelineSummary;
+export declare function runPlaywrightPipeline(testsRoot: string, flows: FlowImpact[], pipeline: PipelineConfig): PipelineSummary;
+//# sourceMappingURL=pipeline.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/agent/pipeline.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,YAAY,CAAC;AAE3C,OAAO,KAAK,EAAiB,eAAe,EAAE,cAAc,EAAC,MAAM,qBAAqB,CAAC;AAOzF,YAAY,EAAC,cAAc,EAAE,eAAe,EAAE,cAAc,EAAC,MAAM,qBAAqB,CAAC;AAOzF,wBAAgB,mBAAmB,CAC/B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,cAAc,EAAE,EACzB,QAAQ,EAAE,cAAc,GACzB,eAAe,CA4FjB;AAED,wBAAgB,qBAAqB,CACjC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,UAAU,EAAE,EACnB,QAAQ,EAAE,cAAc,GACzB,eAAe,CAmLjB"}