@yasserkhanorg/impact-gate 2.0.0

package/dist/cli/errors.js

@@ -0,0 +1,57 @@
+"use strict";
+// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
+// See LICENSE.txt for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CliError = exports.EXIT_CODES = void 0;
+exports.classifyError = classifyError;
+/**
+ * CLI Error types with structured exit codes.
+ *
+ * Exit codes:
+ *   0 = success
+ *   1 = general/user error (bad args, missing config, invalid input)
+ *   2 = budget exceeded
+ *   3 = LLM provider unavailable (API down, auth failure)
+ *   4 = invalid manifest or config file
+ */
+exports.EXIT_CODES = {
+    SUCCESS: 0,
+    GENERAL_ERROR: 1,
+    BUDGET_EXCEEDED: 2,
+    PROVIDER_UNAVAILABLE: 3,
+    INVALID_CONFIG: 4,
+};
+class CliError extends Error {
+    constructor(message, exitCode = exports.EXIT_CODES.GENERAL_ERROR) {
+        super(message);
+        this.exitCode = exitCode;
+        this.name = 'CliError';
+    }
+}
+exports.CliError = CliError;
+/**
+ * Classify an unknown error into the appropriate exit code.
+ */
+function classifyError(error) {
+    if (error instanceof CliError)
+        return error.exitCode;
+    const msg = error instanceof Error ? error.message.toLowerCase() : String(error).toLowerCase();
+    // Budget errors
+    if (msg.includes('budget exceeded') || msg.includes('budget limit')) {
+        return exports.EXIT_CODES.BUDGET_EXCEEDED;
+    }
+    // Provider/auth errors
+    if (msg.includes('api key') || msg.includes('authentication') ||
+        msg.includes('unauthorized') || msg.includes('403') ||
+        (msg.includes('provider') && msg.includes('unavailable')) ||
+        msg.includes('econnrefused') || msg.includes('econnreset')) {
+        return exports.EXIT_CODES.PROVIDER_UNAVAILABLE;
+    }
+    // Config/manifest errors
+    if ((msg.includes('manifest') && (msg.includes('invalid') || msg.includes('not found') || msg.includes('parse'))) ||
+        (msg.includes('config') && msg.includes('invalid')) ||
+        (msg.includes('route-families') && msg.includes('invalid'))) {
+        return exports.EXIT_CODES.INVALID_CONFIG;
+    }
+    return exports.EXIT_CODES.GENERAL_ERROR;
+}

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":"AASA,OAAO,KAAK,EAAU,UAAU,EAAC,MAAM,YAAY,CAAC;AAEpD,eAAO,MAAM,iBAAiB,UAK7B,CAAC;AAEF,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;AA6JD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAyFpD"}

package/dist/cli/parse_args.js

@@ -0,0 +1,257 @@
+"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");
+const logger_js_1 = require("../logger.js");
+exports.CONFIG_CANDIDATES = [
+    'impact-gate.config.json',
+    '.impact-gate.config.json',
+    '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' },
+    '--crew': { key: 'crew', 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' },
+    '--degraded-mode': { key: 'degradedMode', type: 'boolean' },
+    '--enrich': { key: 'trainEnrich', type: 'boolean' },
+    '--no-enrich': { key: 'trainEnrich', type: 'boolean-false' },
+    '--validate': { key: 'trainValidate', type: 'boolean' },
+    '--yes': { key: 'trainYes', type: 'boolean', aliases: ['-y'] },
+    '--verbose': { key: 'verbose', type: 'boolean', aliases: ['-v'] },
+    '--json': { key: 'jsonOutput', 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' },
+    '--output': { key: 'trainOutput', type: 'string' },
+    '--server-path': { key: 'serverPath', type: 'string' },
+    '--workflow': { key: 'crewWorkflow', type: 'string' },
+    '--crew-workflow': { key: 'crewWorkflow', 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' },
+    '--pr': { key: 'trainPr', 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' },
+    '--plugins': { key: 'plugins', 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'),
+    },
+    // -- gate command --
+    '--threshold': { key: 'gateThreshold', type: 'number' },
+    // -- bootstrap command --
+    '--kg-path': { key: 'bootstrapKgPath', type: 'string' },
+    '--scaffold-framework': { key: 'bootstrapScaffoldFramework', type: 'boolean' },
+    '--test-mode': { key: 'bootstrapTestMode', type: 'enum', enumValues: ['ui', 'api', 'both'] },
+    '--max-families': { key: 'bootstrapMaxFamilies', type: 'number' },
+};
+// 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([
+    'init', 'impact', 'plan', 'heal', 'suggest', 'generate',
+    'finalize-generated-tests', 'feedback',
+    'traceability-capture', 'traceability-ingest',
+    'analyze', 'llm-health', 'train', 'crew', 'cost-report', 'gate',
+    'bootstrap',
+]);
+// ---------------------------------------------------------------------------
+// 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;
+    }
+    const startIndex = parsed.command ? 1 : 0;
+    for (let i = startIndex; i < argv.length; i += 1) {
+        const arg = argv[i];
+        const canonical = ALIAS_MAP[arg];
+        if (!canonical) {
+            if (arg.startsWith('--')) {
+                logger_js_1.logger.warn(`Unknown flag "${arg}" (ignored)`);
+            }
+            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) {
+                    const rawValue = def.transform ? def.transform(next) : Number(next);
+                    // Allow non-number transforms through; reject NaN/Infinity for numbers
+                    if (typeof rawValue === 'number') {
+                        if (Number.isFinite(rawValue)) {
+                            setField(parsed, def.key, rawValue);
+                        }
+                    }
+                    else {
+                        setField(parsed, def.key, rawValue);
+                    }
+                    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,87 @@
+import type { AnalysisProfile, FrameworkType } from '../agent/config.js';
+export type Command = 'init' | 'impact' | 'plan' | 'heal' | 'suggest' | 'generate' | 'finalize-generated-tests' | 'feedback' | 'traceability-capture' | 'traceability-ingest' | 'analyze' | 'llm-health' | 'train' | 'crew' | 'cost-report' | 'gate' | 'bootstrap';
+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;
+    crew?: 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;
+    trainEnrich?: boolean;
+    trainValidate?: boolean;
+    trainPr?: number;
+    trainOutput?: string;
+    trainYes?: boolean;
+    serverPath?: string;
+    crewWorkflow?: string;
+    plugins?: string[];
+    gateThreshold?: number;
+    bootstrapKgPath?: string;
+    bootstrapScaffoldFramework?: boolean;
+    bootstrapTestMode?: 'ui' | 'api' | 'both';
+    bootstrapMaxFamilies?: number;
+    degradedMode?: boolean;
+    verbose?: boolean;
+    jsonOutput?: boolean;
+}
+//# 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,CAyGjC"}

package/dist/cli/usage.js

@@ -0,0 +1,109 @@
+"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:',
+        '  impact-gate <command> [options]',
+        '',
+        'Core CI workflow:',
+        '  impact --path <app-root> [options]',
+        '  plan --path <app-root> [options]',
+        '  suggest --path <app-root> [options]',
+        '  gate --path <app-root> --threshold <n> [--since <ref>]',
+        '',
+        'Optional AI workflow:',
+        '  analyze --path <app-root> [--tests-root <path>] [--since <ref>] [--generate] [--generate-output <dir>] [--heal] [--heal-report <json>]',
+        '  generate [--scenarios <path|json>] [--max-attempts <n>] [--dry-run]',
+        '  heal --path <app-root> --traceability-report <json> [options]',
+        '  finalize-generated-tests --path <app-root> [options]',
+        '',
+        'Setup and calibration:',
+        '  init [--yes]',
+        '  train --path <project-root> [--no-enrich] [--validate] [--since <ref>] [--pr <num>]',
+        '  bootstrap --path <app-root> [options]',
+        '  feedback --path <app-root> --feedback-input <json>',
+        '  traceability-capture --path <app-root> --traceability-report <json>',
+        '  traceability-ingest --path <app-root> --traceability-input <json>',
+        '  cost-report [--path <app-root>]',
+        '  llm-health',
+        '',
+        'Advanced / experimental:',
+        '  crew --path <app-root> [--crew-workflow <name>] [--plugins <paths>]',
+        '',
+        'Options:',
+        '  --config <path>       Path to impact-gate.config.json (auto-discovered if present)',
+        '  --path <project-root> Path to the project root (scans both frontend and backend)',
+        '  --profile <name>     default | mattermost',
+        '  --mattermost         Shortcut for --profile mattermost',
+        '  --tests-root <path>   Path to tests root (optional)',
+        '  --framework <name>    auto | playwright | cypress | pytest | supertest | selenium',
+        '  --patterns <globs>    Comma-separated test patterns',
+        '  --flow-patterns <g>   Comma-separated flow discovery patterns',
+        '  --flow-exclude <g>    Comma-separated flow exclude patterns',
+        '  --plugins <paths>     Comma-separated plugin module paths for crew workflows',
+        '  --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',
+        '  --crew                               Run Crew enrichment and attach insights to plan output',
+        '  --crew-workflow <name>               full-qa | quick-check | design-only',
+        '  --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)',
+        '  --no-enrich              Disable LLM enrichment (offline mode, train command)',
+        '  --validate               Validate manifest against git history (train command)',
+        '  --pr <number>            GitHub PR number for validation (requires gh CLI)',
+        '  --yes, -y                Non-interactive mode (train command)',
+        '  --output <path>          Output path for route-families.json (train command)',
+        '  --help                Show help',
+    ].join('\n'));
+}

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

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