@yasserkhanorg/e2e-agents 0.10.0 → 0.11.0

package/dist/cli/commands/traceability.js

@@ -0,0 +1,77 @@
+"use strict";
+// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
+// See LICENSE.txt for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runTraceabilityCaptureCommand = runTraceabilityCaptureCommand;
+exports.runTraceabilityIngestCommand = runTraceabilityIngestCommand;
+const fs_1 = require("fs");
+const config_js_1 = require("../../agent/config.js");
+const traceability_capture_js_1 = require("../../agent/traceability_capture.js");
+const traceability_ingest_js_1 = require("../../agent/traceability_ingest.js");
+function runTraceabilityCaptureCommand(args, autoConfig) {
+    if (!args.path && !autoConfig) {
+        console.error('Error: --path is required for traceability-capture command');
+        process.exit(1);
+    }
+    if (!args.traceabilityReportPath) {
+        console.error('Error: --traceability-report <path> is required for traceability-capture command');
+        process.exit(1);
+    }
+    const { config } = (0, config_js_1.resolveConfig)(process.cwd(), autoConfig, {
+        path: args.path,
+        profile: args.profile,
+        testsRoot: args.testsRoot,
+        mode: 'impact',
+        gitSince: args.gitSince,
+        llmProvider: args.llmProvider,
+    });
+    const reportRoot = config.testsRoot || config.path;
+    const output = (0, traceability_capture_js_1.captureTraceabilityInput)({
+        appPath: config.path,
+        testsRoot: reportRoot,
+        reportPath: args.traceabilityReportPath,
+        sinceRef: args.gitSince || config.git.since,
+        outputPath: args.traceabilityCaptureOutputPath,
+        coverageMapPath: args.traceabilityCoverageMapPath,
+        changedFilesPath: args.traceabilityChangedFilesPath,
+    });
+    console.log(`Traceability input: ${output.outputPath}`);
+    console.log(`Traceability tests seen: ${output.testsSeen}`);
+    console.log(`Traceability runs generated: ${output.runsGenerated}`);
+    console.log(`Traceability changed files used: ${output.changedFilesUsed}`);
+    if (output.warnings.length > 0) {
+        console.log(`Traceability warnings: ${output.warnings.join(' | ')}`);
+    }
+}
+function runTraceabilityIngestCommand(args, autoConfig) {
+    if (!args.path && !autoConfig) {
+        console.error('Error: --path is required for traceability-ingest command');
+        process.exit(1);
+    }
+    if (!args.traceabilityInputPath) {
+        console.error('Error: --traceability-input <path> is required for traceability-ingest command');
+        process.exit(1);
+    }
+    const { config } = (0, config_js_1.resolveConfig)(process.cwd(), autoConfig, {
+        path: args.path,
+        profile: args.profile,
+        testsRoot: args.testsRoot,
+        mode: 'impact',
+        llmProvider: args.llmProvider,
+    });
+    const reportRoot = config.testsRoot || config.path;
+    const raw = JSON.parse((0, fs_1.readFileSync)(args.traceabilityInputPath, 'utf-8'));
+    const output = (0, traceability_ingest_js_1.ingestTraceabilityInput)(reportRoot, config.impact.traceability, raw, {
+        minHits: args.traceabilityMinHits,
+        maxFilesPerTest: args.traceabilityMaxFilesPerTest,
+        maxAgeDays: args.traceabilityMaxAgeDays,
+    });
+    console.log(`Traceability manifest: ${output.manifestPath}`);
+    console.log(`Traceability state: ${output.statePath}`);
+    console.log(`Traceability ingested entries: ${output.entriesIngested}`);
+    console.log(`Traceability tracked tests: ${output.testsTracked}`);
+    console.log(`Traceability tracked edges: ${output.edgesTracked}`);
+    if (output.warnings.length > 0) {
+        console.log(`Traceability warnings: ${output.warnings.join(' | ')}`);
+    }
+}

package/dist/cli/parse_args.d.ts

@@ -0,0 +1,6 @@
+import type { ParsedArgs } from './types.js';
+export declare const CONFIG_CANDIDATES: string[];
+export declare function findConfigUpwards(startDir: string | undefined): string | undefined;
+export declare function resolveAutoConfig(args: ParsedArgs): string | undefined;
+export declare function parseArgs(argv: string[]): ParsedArgs;
+//# sourceMappingURL=parse_args.d.ts.map

package/dist/cli/parse_args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse_args.d.ts","sourceRoot":"","sources":["../../src/cli/parse_args.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAU,UAAU,EAAC,MAAM,YAAY,CAAC;AAEpD,eAAO,MAAM,iBAAiB,UAA8D,CAAC;AAE7F,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAmBlF;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,CAmBtE;AAqID,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CA4EpD"}

package/dist/cli/parse_args.js

@@ -0,0 +1,216 @@
+"use strict";
+// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
+// See LICENSE.txt for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CONFIG_CANDIDATES = void 0;
+exports.findConfigUpwards = findConfigUpwards;
+exports.resolveAutoConfig = resolveAutoConfig;
+exports.parseArgs = parseArgs;
+const fs_1 = require("fs");
+const path_1 = require("path");
+exports.CONFIG_CANDIDATES = ['e2e-ai-agents.config.json', '.e2e-ai-agents.config.json'];
+function findConfigUpwards(startDir) {
+    if (!startDir) {
+        return undefined;
+    }
+    let current = (0, path_1.resolve)(startDir);
+    while (true) {
+        for (const candidate of exports.CONFIG_CANDIDATES) {
+            const fullPath = (0, path_1.join)(current, candidate);
+            if ((0, fs_1.existsSync)(fullPath)) {
+                return fullPath;
+            }
+        }
+        const parent = (0, path_1.dirname)(current);
+        if (parent === current) {
+            break;
+        }
+        current = parent;
+    }
+    return undefined;
+}
+function resolveAutoConfig(args) {
+    if (args.configPath) {
+        return args.configPath;
+    }
+    const searchRoots = [
+        process.cwd(),
+        args.testsRoot,
+        args.path,
+    ].filter(Boolean);
+    for (const root of searchRoots) {
+        const found = findConfigUpwards(root);
+        if (found) {
+            return found;
+        }
+    }
+    return undefined;
+}
+const csvSplit = (v) => v.split(',').map((s) => s.trim()).filter(Boolean);
+// prettier-ignore
+const FLAGS = {
+    // -- boolean flags --
+    '--help': { key: 'help', type: 'boolean', aliases: ['-h'] },
+    '--apply': { key: 'apply', type: 'boolean' },
+    '--allow-fallback': { key: 'allowFallback', type: 'boolean' },
+    '--pipeline': { key: 'pipeline', type: 'boolean' },
+    '--pipeline-mcp': { key: 'pipelineMcp', type: 'boolean' },
+    '--pipeline-mcp-allow-fallback': { key: 'pipelineMcpAllowFallback', type: 'boolean' },
+    '--pipeline-mcp-only': { key: 'pipelineMcpOnly', type: 'boolean' },
+    '--pipeline-headless': { key: 'pipelineHeadless', type: 'boolean' },
+    '--pipeline-headed': { key: 'pipelineHeadless', type: 'boolean-false' },
+    '--pipeline-parallel': { key: 'pipelineParallel', type: 'boolean' },
+    '--pipeline-dry-run': { key: 'pipelineDryRun', type: 'boolean' },
+    '--fail-on-must-add-tests': { key: 'failOnMustAddTests', type: 'boolean' },
+    '--create-pr': { key: 'createPr', type: 'boolean' },
+    '--dry-run': { key: 'dryRun', type: 'boolean' },
+    '--generate': { key: 'analyzeGenerate', type: 'boolean' },
+    '--heal': { key: 'analyzeHeal', type: 'boolean' },
+    '--no-ai': { key: 'noAi', type: 'boolean' },
+    '--mattermost': { key: 'profile', type: 'boolean', transform: () => 'mattermost' },
+    // -- string flags --
+    '--config': { key: 'configPath', type: 'string' },
+    '--path': { key: 'path', type: 'string' },
+    '--tests-root': { key: 'testsRoot', type: 'string' },
+    '--framework': { key: 'framework', type: 'string', transform: (v) => v },
+    '--scenarios': { key: 'generateScenarios', type: 'string' },
+    '--pipeline-output': { key: 'pipelineOutput', type: 'string' },
+    '--pipeline-base-url': { key: 'pipelineBaseUrl', type: 'string' },
+    '--pipeline-project': { key: 'pipelineProject', type: 'string' },
+    '--spec': { key: 'specPDF', type: 'string' },
+    '--since': { key: 'gitSince', type: 'string' },
+    '--llm-provider': { key: 'llmProvider', type: 'string' },
+    '--ci-comment-path': { key: 'ciCommentPath', type: 'string' },
+    '--github-output': { key: 'githubOutputPath', type: 'string' },
+    '--feedback-input': { key: 'feedbackInputPath', type: 'string' },
+    '--traceability-report': { key: 'traceabilityReportPath', type: 'string' },
+    '--traceability-capture-output': { key: 'traceabilityCaptureOutputPath', type: 'string' },
+    '--traceability-coverage-map': { key: 'traceabilityCoverageMapPath', type: 'string' },
+    '--traceability-changed-files': { key: 'traceabilityChangedFilesPath', type: 'string' },
+    '--traceability-input': { key: 'traceabilityInputPath', type: 'string' },
+    '--branch': { key: 'branch', type: 'string' },
+    '--commit-message': { key: 'commitMessage', type: 'string' },
+    '--pr-title': { key: 'prTitle', type: 'string' },
+    '--pr-body': { key: 'prBody', type: 'string' },
+    '--pr-base': { key: 'prBase', type: 'string' },
+    '--generate-output': { key: 'analyzeGenerateOutputDir', type: 'string' },
+    '--heal-report': { key: 'analyzeHealReport', type: 'string' },
+    '--flow-catalog': { key: 'flowCatalogPath', type: 'string' },
+    // -- number flags (with isFinite guard) --
+    '--pipeline-scenarios': { key: 'pipelineScenarios', type: 'number' },
+    '--time': { key: 'timeLimitMinutes', type: 'number' },
+    '--budget-usd': { key: 'budgetUSD', type: 'number' },
+    '--budget-tokens': { key: 'budgetTokens', type: 'number' },
+    '--policy-min-confidence': { key: 'policyMinConfidence', type: 'number' },
+    '--policy-safe-merge-confidence': { key: 'policySafeMergeConfidence', type: 'number' },
+    '--policy-force-full-on-warnings': { key: 'policyWarningsThreshold', type: 'number' },
+    '--traceability-min-hits': { key: 'traceabilityMinHits', type: 'number' },
+    '--traceability-max-files-per-test': { key: 'traceabilityMaxFilesPerTest', type: 'number' },
+    '--traceability-max-age-days': { key: 'traceabilityMaxAgeDays', type: 'number' },
+    // -- number-raw flags (no isFinite guard, assigned directly via Number()) --
+    '--max-attempts': { key: 'maxAttempts', type: 'number-raw', transform: (v) => parseInt(v, 10) },
+    '--pipeline-mcp-timeout-ms': { key: 'pipelineMcpTimeoutMs', type: 'number-raw' },
+    '--pipeline-mcp-retries': { key: 'pipelineMcpRetries', type: 'number-raw' },
+    // -- enum flags --
+    '--profile': { key: 'profile', type: 'enum', enumValues: ['default', 'mattermost'] },
+    '--pipeline-browser': { key: 'pipelineBrowser', type: 'enum', enumValues: ['chrome', 'chromium', 'firefox', 'webkit'] },
+    '--policy-enforcement-mode': { key: 'policyEnforcementMode', type: 'enum', enumValues: ['advisory', 'warn', 'block'] },
+    // -- csv flags --
+    '--patterns': { key: 'testPatterns', type: 'csv' },
+    '--flow-patterns': { key: 'flowPatterns', type: 'csv' },
+    '--flow-exclude': { key: 'flowExclude', type: 'csv' },
+    '--policy-risky-patterns': { key: 'policyRiskyPatterns', type: 'csv' },
+    '--policy-block-actions': {
+        key: 'policyBlockActions',
+        type: 'csv',
+        transform: (v) => csvSplit(v).filter((s) => s === 'run-now' || s === 'must-add-tests' || s === 'safe-to-merge'),
+    },
+};
+// Build a lookup from alias -> canonical flag name
+const ALIAS_MAP = {};
+for (const [flag, def] of Object.entries(FLAGS)) {
+    ALIAS_MAP[flag] = flag;
+    if (def.aliases) {
+        for (const alias of def.aliases) {
+            ALIAS_MAP[alias] = flag;
+        }
+    }
+}
+const COMMANDS = new Set([
+    'impact', 'plan', 'heal', 'suggest', 'generate',
+    'finalize-generated-tests', 'feedback',
+    'traceability-capture', 'traceability-ingest',
+    'analyze', 'llm-health',
+]);
+// ---------------------------------------------------------------------------
+// Parser
+// ---------------------------------------------------------------------------
+function setField(obj, key, value) {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    obj[key] = value;
+}
+function parseArgs(argv) {
+    const parsed = { apply: false, help: false };
+    if (argv.length === 0) {
+        return parsed;
+    }
+    const command = argv[0];
+    if (COMMANDS.has(command)) {
+        parsed.command = command;
+    }
+    for (let i = 1; i < argv.length; i += 1) {
+        const arg = argv[i];
+        const canonical = ALIAS_MAP[arg];
+        if (!canonical) {
+            continue;
+        }
+        const def = FLAGS[canonical];
+        const next = argv[i + 1];
+        switch (def.type) {
+            case 'boolean':
+                setField(parsed, def.key, def.transform ? def.transform('') : true);
+                break;
+            case 'boolean-false':
+                setField(parsed, def.key, false);
+                break;
+            case 'string':
+                if (next) {
+                    setField(parsed, def.key, def.transform ? def.transform(next) : next);
+                    i += 1;
+                }
+                break;
+            case 'number':
+                if (next) {
+                    const value = Number(next);
+                    if (Number.isFinite(value)) {
+                        setField(parsed, def.key, value);
+                    }
+                    i += 1;
+                }
+                break;
+            case 'number-raw':
+                if (next) {
+                    setField(parsed, def.key, def.transform ? def.transform(next) : Number(next));
+                    i += 1;
+                }
+                break;
+            case 'csv':
+                if (next) {
+                    setField(parsed, def.key, def.transform ? def.transform(next) : csvSplit(next));
+                    i += 1;
+                }
+                break;
+            case 'enum':
+                if (next) {
+                    if (def.enumValues.includes(next)) {
+                        setField(parsed, def.key, next);
+                    }
+                    i += 1;
+                }
+                break;
+            default:
+                break;
+        }
+    }
+    return parsed;
+}

package/dist/cli/types.d.ts

@@ -0,0 +1,70 @@
+import type { AnalysisProfile, FrameworkType } from '../agent/config.js';
+export type Command = 'impact' | 'plan' | 'heal' | 'suggest' | 'generate' | 'finalize-generated-tests' | 'feedback' | 'traceability-capture' | 'traceability-ingest' | 'analyze' | 'llm-health';
+export interface ParsedArgs {
+    command?: Command;
+    configPath?: string;
+    path?: string;
+    profile?: AnalysisProfile;
+    testsRoot?: string;
+    framework?: FrameworkType;
+    timeLimitMinutes?: number;
+    budgetUSD?: number;
+    budgetTokens?: number;
+    llmProvider?: string;
+    testPatterns?: string[];
+    flowPatterns?: string[];
+    flowExclude?: string[];
+    flowCatalogPath?: string;
+    specPDF?: string;
+    gitSince?: string;
+    allowFallback?: boolean;
+    pipeline?: boolean;
+    pipelineScenarios?: number;
+    pipelineOutput?: string;
+    pipelineBaseUrl?: string;
+    pipelineBrowser?: 'chrome' | 'chromium' | 'firefox' | 'webkit';
+    pipelineHeadless?: boolean;
+    pipelineProject?: string;
+    pipelineParallel?: boolean;
+    pipelineDryRun?: boolean;
+    pipelineMcp?: boolean;
+    pipelineMcpAllowFallback?: boolean;
+    pipelineMcpOnly?: boolean;
+    pipelineMcpTimeoutMs?: number;
+    pipelineMcpRetries?: number;
+    policyMinConfidence?: number;
+    policySafeMergeConfidence?: number;
+    policyWarningsThreshold?: number;
+    policyRiskyPatterns?: string[];
+    policyEnforcementMode?: 'advisory' | 'warn' | 'block';
+    policyBlockActions?: Array<'run-now' | 'must-add-tests' | 'safe-to-merge'>;
+    ciCommentPath?: string;
+    githubOutputPath?: string;
+    failOnMustAddTests?: boolean;
+    feedbackInputPath?: string;
+    traceabilityReportPath?: string;
+    traceabilityCaptureOutputPath?: string;
+    traceabilityCoverageMapPath?: string;
+    traceabilityChangedFilesPath?: string;
+    traceabilityInputPath?: string;
+    traceabilityMinHits?: number;
+    traceabilityMaxFilesPerTest?: number;
+    traceabilityMaxAgeDays?: number;
+    branch?: string;
+    commitMessage?: string;
+    createPr?: boolean;
+    prTitle?: string;
+    prBody?: string;
+    prBase?: string;
+    dryRun?: boolean;
+    apply: boolean;
+    help: boolean;
+    analyzeGenerate?: boolean;
+    analyzeGenerateOutputDir?: string;
+    analyzeHeal?: boolean;
+    analyzeHealReport?: string;
+    noAi?: boolean;
+    maxAttempts?: number;
+    generateScenarios?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/cli/types.d.ts.map

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

package/dist/cli/types.js

@@ -0,0 +1,4 @@
+"use strict";
+// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
+// See LICENSE.txt for license information.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cli/usage.d.ts

@@ -0,0 +1,2 @@
+export declare function printUsage(): void;
+//# sourceMappingURL=usage.d.ts.map

package/dist/cli/usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../src/cli/usage.ts"],"names":[],"mappings":"AAGA,wBAAgB,UAAU,IAAI,IAAI,CAkFjC"}

package/dist/cli/usage.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.printUsage = printUsage;
+function printUsage() {
+    console.log([
+        'Usage:',
+        '  e2e-ai-agents impact --path <app-root> [options]',
+        '  e2e-ai-agents plan --path <app-root> [options]',
+        '  e2e-ai-agents suggest --path <app-root> [options]',
+        '  e2e-ai-agents heal --path <app-root> --traceability-report <json> [options]',
+        '  e2e-ai-agents finalize-generated-tests --path <app-root> [options]',
+        '  e2e-ai-agents feedback --path <app-root> --feedback-input <json>',
+        '  e2e-ai-agents traceability-capture --path <app-root> --traceability-report <json>',
+        '  e2e-ai-agents traceability-ingest --path <app-root> --traceability-input <json>',
+        '  e2e-ai-agents generate [--scenarios <path|json>] [--max-attempts <n>] [--dry-run]',
+        '  e2e-ai-agents analyze --path <app-root> [--tests-root <path>] [--since <ref>] [--generate] [--generate-output <dir>] [--heal] [--heal-report <json>]',
+        '  e2e-ai-agents llm-health',
+        '',
+        'Options:',
+        '  --config <path>       Path to e2e-ai-agents.config.json (auto-discovered if present)',
+        '  --path <app-root>     Path to the web app (required)',
+        '  --profile <name>     default | mattermost',
+        '  --mattermost         Shortcut for --profile mattermost',
+        '  --tests-root <path>   Path to tests root (optional)',
+        '  --framework <name>    auto | playwright | cypress | selenium',
+        '  --patterns <globs>    Comma-separated test patterns',
+        '  --flow-patterns <g>   Comma-separated flow discovery patterns',
+        '  --flow-exclude <g>    Comma-separated flow exclude patterns',
+        '  --flow-catalog <path> Path to flow catalog JSON',
+        '  --allow-fallback      Allow impact analysis without diff',
+        '  --pipeline            Run Playwright AI pipeline for missing P0/P1 flows',
+        '  --pipeline-scenarios  Number of scenarios per flow (default 3)',
+        '  --pipeline-output     Output directory for generated tests',
+        '  --pipeline-base-url   Base URL for Playwright runs',
+        '  --pipeline-browser    Browser: chrome|chromium|firefox|webkit',
+        '  --pipeline-headless   Run in headless mode',
+        '  --pipeline-headed     Run in headed mode',
+        '  --pipeline-project    Playwright project name',
+        '  --pipeline-parallel   Enable parallel mode in generator',
+        '  --pipeline-dry-run    Do not execute pipeline (report only)',
+        '  --pipeline-mcp        Use Playwright MCP server for exploration/healing',
+        '  --pipeline-mcp-allow-fallback  Allow non-MCP fallback if official MCP setup fails',
+        '  --pipeline-mcp-only   Require MCP for UI exploration (fail if unavailable)',
+        '  --pipeline-mcp-timeout-ms <n>  Timeout per MCP CLI invocation in milliseconds',
+        '  --pipeline-mcp-retries <n>  Retry count for retryable MCP CLI failures',
+        '  --spec <path>         Optional spec PDF for context',
+        '  --since <git-ref>     Git ref for impact analysis (default HEAD~1)',
+        '  --time <minutes>      Time limit in minutes',
+        '  --budget-usd <amount> Max LLM budget in USD',
+        '  --budget-tokens <n>   Max LLM tokens',
+        '  --llm-provider <name> LLM provider: auto | anthropic | openai | ollama',
+        '  --policy-min-confidence <n>   Minimum confidence for targeted suite',
+        '  --policy-safe-merge-confidence <n> Confidence needed for safe-to-merge',
+        '  --policy-force-full-on-warnings <n> Escalate to full at warning count',
+        '  --policy-risky-patterns <globs>     Comma-separated risky file globs',
+        '  --policy-enforcement-mode <mode>    advisory | warn | block',
+        '  --policy-block-actions <actions>    Comma-separated CI actions to block/warn',
+        '  --ci-comment-path <path>            Write CI markdown summary',
+        '  --github-output <path>              Write GitHub Actions outputs',
+        '  --fail-on-must-add-tests            Exit non-zero on must-add-tests decision',
+        '  --feedback-input <path>             Path to recommendation feedback JSON',
+        '  --traceability-report <path>        Path to Playwright JSON report for traceability capture',
+        '  --traceability-capture-output <path> Output path for generated traceability ingest JSON',
+        '  --traceability-coverage-map <path>  Optional coverage map (test<->files) to enrich traceability capture',
+        '  --traceability-changed-files <path> Optional changed-files list/JSON fallback for traceability capture',
+        '  --traceability-input <path>         Path to traceability ingest JSON payload',
+        '  --traceability-min-hits <n>         Minimum signal hits required per file mapping',
+        '  --traceability-max-files-per-test <n> Cap max mapped files per test',
+        '  --traceability-max-age-days <n>     Drop stale mappings older than N days',
+        '  --branch <name>      Optional handoff branch (prefixed with codex/)',
+        '  --commit-message <m> Commit message for finalize-generated-tests',
+        '  --create-pr          Open PR with gh after commit',
+        '  --pr-title <title>   PR title for finalize-generated-tests',
+        '  --pr-body <body>     PR body for finalize-generated-tests',
+        '  --pr-base <branch>   PR base branch for finalize-generated-tests',
+        '                      (auto-heal-pr defaults to base=master)',
+        '  --dry-run            Preview actions without mutating git state',
+        '  --max-attempts <n>    Max fix attempts per scenario (default: 3)',
+        '  --scenarios <path|json>  Scenarios file/JSON for generate command',
+        '  --apply               Apply data-testid patches and generate tests',
+        '                        (legacy shortcut; prefer approve-and-generate)',
+        '  --help                Show help',
+    ].join('\n'));
+}