@electron-stagewright/plugin-budget 0.0.0-stage → 0.1.0

package/dist/check.js

@@ -0,0 +1,172 @@
+/**
+ * Compare a run to a budget. Pure: no I/O, no Electron.
+ *
+ * @module
+ */
+import { PROCESS_TYPES } from './budget.js';
+import { summarizeRun } from './run.js';
+const ANY_PHASE_ORDER = ['warm', 'live', 'cold'];
+function expectations(budget, platform, options) {
+    const list = [];
+    const tolerance = (own) => options.strict === true ? 0 : (own ?? budget.thresholdPercent ?? 0);
+    if (budget.startup !== undefined) {
+        list.push({
+            id: 'startup.firstWindowMs',
+            section: 'startup',
+            unit: 'ms',
+            limit: budget.startup.maxFirstWindowMs,
+            thresholdPercent: tolerance(budget.startup.thresholdPercent),
+            phase: options.phase ?? budget.startup.phase ?? 'cold',
+        });
+    }
+    const memory = budget.memory?.[platform];
+    if (memory !== undefined) {
+        const base = {
+            section: 'memory',
+            unit: 'MB',
+            thresholdPercent: tolerance(memory.thresholdPercent),
+            phase: options.phase ?? memory.phase ?? 'warm',
+            metric: memory.metric,
+        };
+        for (const type of PROCESS_TYPES) {
+            const max = memory.perTypeMb?.[type];
+            if (max !== undefined)
+                list.push({ ...base, id: `memory.${type}`, limit: max });
+        }
+        if (memory.totalWithoutGpuMb !== undefined) {
+            list.push({ ...base, id: 'memory.totalWithoutGpu', limit: memory.totalWithoutGpuMb });
+        }
+        if (memory.totalMb !== undefined) {
+            list.push({ ...base, id: 'memory.total', limit: memory.totalMb });
+        }
+    }
+    const mainThread = budget.mainThread;
+    if (mainThread !== undefined) {
+        const base = {
+            section: 'mainThread',
+            thresholdPercent: tolerance(mainThread.thresholdPercent),
+            ...(options.phase === undefined ? {} : { phase: options.phase }),
+        };
+        if (mainThread.maxBlockedPercent !== undefined) {
+            list.push({
+                ...base,
+                id: 'mainThread.blockedPercent',
+                unit: '%',
+                limit: mainThread.maxBlockedPercent,
+            });
+        }
+        if (mainThread.maxStallMs !== undefined) {
+            list.push({ ...base, id: 'mainThread.maxStallMs', unit: 'ms', limit: mainThread.maxStallMs });
+        }
+    }
+    const ipc = budget.ipc;
+    if (ipc !== undefined) {
+        const base = {
+            section: 'ipc',
+            unit: 'ms',
+            thresholdPercent: tolerance(ipc.thresholdPercent),
+            ...(options.phase === undefined ? {} : { phase: options.phase }),
+        };
+        if (ipc.maxP95Ms !== undefined)
+            list.push({ ...base, id: 'ipc.p95Ms', limit: ipc.maxP95Ms });
+        if (ipc.maxP99Ms !== undefined)
+            list.push({ ...base, id: 'ipc.p99Ms', limit: ipc.maxP99Ms });
+    }
+    for (const entry of budget.bundle?.entries ?? []) {
+        list.push({
+            id: `bundle.${entry.name ?? entry.path}`,
+            section: 'bundle',
+            unit: 'KB',
+            limit: entry.maxKb,
+            thresholdPercent: tolerance(budget.bundle?.thresholdPercent),
+        });
+    }
+    return list;
+}
+function findRow(rows, expectation) {
+    const candidates = rows.filter((row) => row.id === expectation.id &&
+        (expectation.metric === undefined || row.metric === expectation.metric));
+    if (expectation.section === 'bundle')
+        return candidates[0];
+    if (expectation.phase !== undefined) {
+        return candidates.find((row) => row.phase === expectation.phase);
+    }
+    for (const phase of ANY_PHASE_ORDER) {
+        const row = candidates.find((candidate) => candidate.phase === phase);
+        if (row !== undefined)
+            return row;
+    }
+    return undefined;
+}
+function unmeasuredDetail(run, expectation) {
+    if (expectation.section === 'bundle') {
+        const id = expectation.id.slice('bundle.'.length);
+        const entry = run.bundle?.entries.find((candidate) => candidate.id === id);
+        return entry?.unavailable ?? 'the run has no measurement for this bundle entry';
+    }
+    const rounds = run.rounds.filter((round) => expectation.phase === undefined || round.phase === expectation.phase);
+    if (rounds.length === 0) {
+        return expectation.phase === undefined
+            ? 'the run has no rounds'
+            : `the run has no ${expectation.phase} round`;
+    }
+    if (expectation.section === 'memory') {
+        const measured = rounds.map((round) => round.measurement.memory?.metric).find(Boolean);
+        // Megabytes in another metric are a different quantity, never a comparable one.
+        if (measured !== undefined && measured !== expectation.metric) {
+            return `the run measured ${measured}, the budget names ${expectation.metric}`;
+        }
+    }
+    if (expectation.section === 'ipc' && rounds.some((r) => r.measurement.ipc?.count === 0)) {
+        return 'the IPC probe completed no round trip';
+    }
+    const reason = rounds
+        .map((round) => round.measurement.unavailable?.[expectation.section])
+        .find((value) => value !== undefined);
+    return reason ?? `the run did not measure ${expectation.id}`;
+}
+/** Compare `run` to `budget` for the platform the run was measured on. */
+export function checkRun(run, budget, options = {}) {
+    const rows = summarizeRun(run);
+    const results = expectations(budget, run.platform, options).map((expectation) => {
+        // Divide last: 200 * (1 + 15 / 100) is 229.99999999999997, which would fail a 230.
+        const exactAllowed = (expectation.limit * (100 + expectation.thresholdPercent)) / 100;
+        const allowed = Math.round(exactAllowed * 10) / 10;
+        const base = {
+            id: expectation.id,
+            unit: expectation.unit,
+            limit: expectation.limit,
+            allowed,
+            ...(expectation.phase === undefined ? {} : { phase: expectation.phase }),
+            ...(expectation.metric === undefined ? {} : { metric: expectation.metric }),
+        };
+        const row = findRow(rows, expectation);
+        if (row === undefined) {
+            return { ...base, status: 'unmeasured', detail: unmeasuredDetail(run, expectation) };
+        }
+        return {
+            ...base,
+            ...(row.phase === undefined ? {} : { phase: row.phase }),
+            status: row.exact <= exactAllowed ? 'pass' : 'fail',
+            actual: row.value,
+        };
+    });
+    const count = (status) => results.filter((result) => result.status === status).length;
+    const summary = { pass: count('pass'), fail: count('fail'), unmeasured: count('unmeasured') };
+    const reason = results.length === 0
+        ? 'NO_EXPECTATIONS'
+        : summary.fail > 0
+            ? 'OVER_BUDGET'
+            : summary.pass === 0
+                ? 'NO_MEASUREMENTS'
+                : options.requireMeasurement === true && summary.unmeasured > 0
+                    ? 'UNMEASURED'
+                    : undefined;
+    return {
+        passed: reason === undefined,
+        ...(reason === undefined ? {} : { reason }),
+        summary,
+        results,
+    };
+}
+//# sourceMappingURL=check.js.map

package/dist/check.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,77 @@
+#!/usr/bin/env node
+/**
+ * `electron-stagewright-budget`: the CI face of the budget plugin.
+ *
+ * Exit codes: 0 within budget, 1 over budget or nothing measured, 2 usage, unreadable input, or any
+ * other error.
+ *
+ * @module
+ */
+import { type Phase } from './budget.js';
+import { measureApp, type LaunchPhase } from './measure.js';
+export declare const BUDGET_EXIT_CODES: {
+    readonly SUCCESS: 0;
+    readonly OVER_BUDGET: 1;
+    readonly USAGE: 2;
+};
+export type BudgetExitCode = (typeof BUDGET_EXIT_CODES)[keyof typeof BUDGET_EXIT_CODES];
+export interface BudgetCliIo {
+    readonly stdout: (text: string) => void;
+    readonly stderr: (text: string) => void;
+}
+export type BudgetCliOptions = {
+    readonly command: 'help';
+} | {
+    readonly command: 'check';
+    readonly runPath: string;
+    readonly budgetPath: string;
+    readonly strict: boolean;
+    readonly requireMeasurement: boolean;
+    readonly phase?: Phase;
+    readonly json: boolean;
+} | {
+    readonly command: 'compare';
+    readonly beforePath: string;
+    readonly afterPath: string;
+    readonly json: boolean;
+} | {
+    readonly command: 'bundle';
+    readonly budgetPath: string;
+    readonly root?: string;
+    readonly outPath?: string;
+    readonly strict: boolean;
+    readonly json: boolean;
+} | MeasureCliOptions;
+export interface MeasureCliOptions {
+    readonly command: 'measure';
+    readonly main?: string;
+    readonly executablePath?: string;
+    readonly args: readonly string[];
+    readonly env: Readonly<Record<string, string>>;
+    readonly budgetPath?: string;
+    readonly rounds: number;
+    readonly phases: readonly LaunchPhase[];
+    readonly settleMs?: number;
+    readonly windowMs?: number;
+    readonly workloadPath?: string;
+    readonly workloadTimeoutMs?: number;
+    readonly phase?: Phase;
+    readonly label?: string;
+    readonly outPath?: string;
+    readonly check: boolean;
+    readonly strict: boolean;
+    readonly requireMeasurement: boolean;
+    readonly json: boolean;
+}
+/** Seam for tests: the launch-and-measure step. */
+export interface BudgetCliDependencies {
+    readonly measureApp: typeof measureApp;
+}
+export declare function formatBudgetCliHelp(): string;
+/** Strict parser: an unknown flag or a missing value is a usage error. */
+export declare function parseBudgetCliArgs(argv: readonly string[]): BudgetCliOptions;
+/** Execute already-parsed options. Throws the typed file errors; the caller maps them to exit 2. */
+export declare function runBudgetCli(options: BudgetCliOptions, io?: BudgetCliIo, deps?: BudgetCliDependencies): Promise<BudgetExitCode>;
+/** Parse and execute; never throws. */
+export declare function runBudgetCliCommand(argv: readonly string[], io?: BudgetCliIo, deps?: BudgetCliDependencies): Promise<BudgetExitCode>;
+//# 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":"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"}

package/dist/cli.js

@@ -0,0 +1,401 @@
+#!/usr/bin/env node
+/**
+ * `electron-stagewright-budget`: the CI face of the budget plugin.
+ *
+ * Exit codes: 0 within budget, 1 over budget or nothing measured, 2 usage, unreadable input, or any
+ * other error.
+ *
+ * @module
+ */
+import { realpathSync } from 'node:fs';
+import { mkdir, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { BudgetFileError, PHASES, loadBudget } from './budget.js';
+import { measureBundle } from './bundle.js';
+import { checkRun } from './check.js';
+import { DEFAULT_ROUNDS, measureApp } from './measure.js';
+import { compareRuns, renderCheckReport, renderComparison } from './render.js';
+import { RunFileError, createRun, loadRun } from './run.js';
+export const BUDGET_EXIT_CODES = { SUCCESS: 0, OVER_BUDGET: 1, USAGE: 2 };
+const PROCESS_IO = {
+    stdout: (text) => process.stdout.write(text),
+    stderr: (text) => process.stderr.write(text),
+};
+class UsageError extends Error {
+}
+export function formatBudgetCliHelp() {
+    return [
+        'Usage:',
+        '  electron-stagewright-budget measure (--main <main.js> | --executable <path>) [--arg <v>]...',
+        '                              [--env K=V]... [--budget <file>] [--rounds 3]',
+        '                              [--phases cold,warm] [--settle-ms 3000] [--window-ms 2000]',
+        '                              [--workload <script.mjs> [--workload-timeout-ms 120000]]',
+        '                              [--label <text>] [--out <run.json>] [--json]',
+        '                              [--check [--strict] [--require-measurement] [--phase cold|warm]]',
+        '  electron-stagewright-budget check <run.json> --budget <file> [--strict]',
+        '                              [--require-measurement] [--phase cold|warm|live] [--json]',
+        '  electron-stagewright-budget compare <before.json> <after.json> [--json]',
+        '  electron-stagewright-budget bundle --budget <file> [--root <dir>] [--out <run.json>]',
+        '                              [--strict] [--json]',
+        '',
+        'measure   Launch the app on a throwaway profile and measure cold and warm rounds.',
+        '          --workload is an ES module whose default export, async ({ dispatch, sessionId,',
+        '          phase }), drives the app inside the measurement window. Without --out or',
+        '          --check the run document goes to stdout. --phase reads every metric from',
+        '          that phase; a metric whose phase was not measured is unmeasured.',
+        'check     Compare a measured run to a budget file.',
+        'compare   Print a before/after table of two runs.',
+        'bundle    Measure the bundle entries of a budget and gate them; needs no Electron.',
+        '',
+        '--strict               Ignore thresholdPercent; the limit itself gates.',
+        '--require-measurement  Fail when a budgeted metric was not measured.',
+        '',
+        'Exit codes: 0 within budget, 1 over budget or nothing measured,',
+        '            2 usage, unreadable input, or any other error.',
+    ].join('\n');
+}
+function positiveInt(flag, value, min = 1) {
+    const parsed = Number(value);
+    if (!Number.isSafeInteger(parsed) || parsed < min) {
+        throw new UsageError(`${flag} expects an integer of at least ${min}`);
+    }
+    return parsed;
+}
+function parseMeasureArgs(rest) {
+    const single = new Map();
+    const args = [];
+    const env = {};
+    const flags = new Set();
+    const valueFlags = [
+        '--main',
+        '--executable',
+        '--budget',
+        '--rounds',
+        '--phases',
+        '--settle-ms',
+        '--window-ms',
+        '--workload',
+        '--workload-timeout-ms',
+        '--phase',
+        '--label',
+        '--out',
+    ];
+    const booleanFlags = ['--check', '--strict', '--require-measurement', '--json'];
+    for (let index = 0; index < rest.length; index += 1) {
+        const token = rest[index];
+        // Scanned here, not over all of argv, so `--arg --help` is forwarded to the app.
+        if (token === '--help' || token === '-h')
+            return { command: 'help' };
+        if (booleanFlags.includes(token)) {
+            flags.add(token);
+            continue;
+        }
+        if (token !== '--arg' && token !== '--env' && !valueFlags.includes(token)) {
+            throw new UsageError(`Unknown option for measure: ${token}`);
+        }
+        const value = rest[index + 1];
+        // --arg forwards anything, including empty values and values that start with dashes.
+        if (value === undefined ||
+            (token !== '--arg' && (value.length === 0 || value.startsWith('--')))) {
+            throw new UsageError(`${token} expects a value`);
+        }
+        index += 1;
+        if (token === '--arg') {
+            args.push(value);
+        }
+        else if (token === '--env') {
+            const separator = value.indexOf('=');
+            if (separator <= 0)
+                throw new UsageError('--env expects KEY=VALUE');
+            env[value.slice(0, separator)] = value.slice(separator + 1);
+        }
+        else {
+            if (single.has(token))
+                throw new UsageError(`${token} may be given only once`);
+            single.set(token, value);
+        }
+    }
+    const main = single.get('--main');
+    const executablePath = single.get('--executable');
+    if (main === undefined && executablePath === undefined) {
+        throw new UsageError('measure requires --main <main.js> or --executable <path>');
+    }
+    const phases = [
+        ...new Set((single.get('--phases') ?? 'cold,warm').split(',').map((phase) => phase.trim())),
+    ];
+    if (phases.some((phase) => phase !== 'cold' && phase !== 'warm')) {
+        throw new UsageError('--phases expects cold, warm, or cold,warm');
+    }
+    const phase = single.get('--phase');
+    if (phase !== undefined && !phases.includes(phase)) {
+        throw new UsageError('--phase must name a measured phase: cold or warm');
+    }
+    const check = flags.has('--check');
+    const budgetPath = single.get('--budget');
+    if (check && budgetPath === undefined)
+        throw new UsageError('--check requires --budget <file>');
+    if (!check && (flags.has('--strict') || flags.has('--require-measurement') || phase)) {
+        throw new UsageError('--strict, --require-measurement, and --phase apply only with --check');
+    }
+    const optional = (key, value) => value === undefined ? {} : { [key]: value };
+    const number = (flag, min) => {
+        const value = single.get(flag);
+        return value === undefined ? undefined : positiveInt(flag, value, min);
+    };
+    return {
+        command: 'measure',
+        ...optional('main', main === undefined ? undefined : path.resolve(main)),
+        ...optional('executablePath', executablePath === undefined ? undefined : path.resolve(executablePath)),
+        args,
+        env,
+        ...optional('budgetPath', budgetPath),
+        rounds: number('--rounds', 1) ?? DEFAULT_ROUNDS,
+        phases: phases,
+        ...optional('settleMs', number('--settle-ms', 0)),
+        ...optional('windowMs', number('--window-ms', 250)),
+        ...optional('workloadPath', single.get('--workload')),
+        ...optional('workloadTimeoutMs', number('--workload-timeout-ms', 1000)),
+        ...optional('phase', phase),
+        ...optional('label', single.get('--label')),
+        ...optional('outPath', single.get('--out')),
+        check,
+        strict: flags.has('--strict'),
+        requireMeasurement: flags.has('--require-measurement'),
+        json: flags.has('--json'),
+    };
+}
+/** Strict parser: an unknown flag or a missing value is a usage error. */
+export function parseBudgetCliArgs(argv) {
+    const [command, ...rest] = argv;
+    if (command === undefined || command === 'help' || command === '--help' || command === '-h') {
+        if (command === undefined)
+            throw new UsageError('Expected a subcommand: measure, check, compare, bundle');
+        return { command: 'help' };
+    }
+    if (command === 'measure')
+        return parseMeasureArgs(rest);
+    if (command !== 'check' && command !== 'compare' && command !== 'bundle') {
+        throw new UsageError(`Unknown subcommand: ${command}`);
+    }
+    if (rest.includes('--help') || rest.includes('-h'))
+        return { command: 'help' };
+    const valueFlags = {
+        check: ['--budget', '--phase'],
+        compare: [],
+        bundle: ['--budget', '--root', '--out'],
+    };
+    const booleanFlags = {
+        check: ['--strict', '--require-measurement', '--json'],
+        compare: ['--json'],
+        bundle: ['--strict', '--json'],
+    };
+    const values = new Map();
+    const flags = new Set();
+    const positional = [];
+    for (let index = 0; index < rest.length; index += 1) {
+        const token = rest[index];
+        if (valueFlags[command].includes(token)) {
+            const value = rest[index + 1];
+            if (value === undefined || value.length === 0 || value.startsWith('--')) {
+                throw new UsageError(`${token} expects a value`);
+            }
+            values.set(token, value);
+            index += 1;
+        }
+        else if (booleanFlags[command].includes(token)) {
+            flags.add(token);
+        }
+        else if (token.startsWith('-')) {
+            throw new UsageError(`Unknown option for ${command}: ${token}`);
+        }
+        else {
+            positional.push(token);
+        }
+    }
+    const requireBudget = () => {
+        const budgetPath = values.get('--budget');
+        if (budgetPath === undefined)
+            throw new UsageError(`${command} requires --budget <file>`);
+        return budgetPath;
+    };
+    const json = flags.has('--json');
+    if (command === 'compare') {
+        const [beforePath, afterPath, extra] = positional;
+        if (beforePath === undefined || afterPath === undefined || extra !== undefined) {
+            throw new UsageError('compare expects exactly two run files');
+        }
+        return { command, beforePath, afterPath, json };
+    }
+    if (command === 'bundle') {
+        if (positional.length > 0)
+            throw new UsageError(`Unexpected argument: ${positional[0]}`);
+        const root = values.get('--root');
+        const outPath = values.get('--out');
+        return {
+            command,
+            budgetPath: requireBudget(),
+            ...(root === undefined ? {} : { root }),
+            ...(outPath === undefined ? {} : { outPath }),
+            strict: flags.has('--strict'),
+            json,
+        };
+    }
+    const [runPath, extra] = positional;
+    if (runPath === undefined || extra !== undefined) {
+        throw new UsageError('check expects exactly one run file');
+    }
+    const phase = values.get('--phase');
+    if (phase !== undefined && !PHASES.includes(phase)) {
+        throw new UsageError(`--phase expects one of ${PHASES.join(', ')}`);
+    }
+    return {
+        command,
+        runPath,
+        budgetPath: requireBudget(),
+        strict: flags.has('--strict'),
+        requireMeasurement: flags.has('--require-measurement'),
+        ...(phase === undefined ? {} : { phase: phase }),
+        json,
+    };
+}
+function emitReport(report, json, io) {
+    io.stdout(`${json ? JSON.stringify(report) : renderCheckReport(report)}\n`);
+    return report.passed ? BUDGET_EXIT_CODES.SUCCESS : BUDGET_EXIT_CODES.OVER_BUDGET;
+}
+async function writeRun(outPath, run) {
+    await mkdir(path.dirname(path.resolve(outPath)), { recursive: true });
+    await writeFile(outPath, `${JSON.stringify(run, null, 2)}\n`);
+}
+async function loadWorkload(workloadPath) {
+    let module;
+    try {
+        module = (await import(pathToFileURL(path.resolve(workloadPath)).href));
+    }
+    catch (error) {
+        throw new UsageError(`Cannot load workload ${workloadPath}: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    if (typeof module.default !== 'function') {
+        throw new UsageError(`Workload ${workloadPath} must default-export an async function`);
+    }
+    return module.default;
+}
+async function runMeasure(options, io, deps) {
+    const budget = options.budgetPath === undefined ? undefined : await loadBudget(options.budgetPath);
+    const workload = options.workloadPath === undefined ? undefined : await loadWorkload(options.workloadPath);
+    let run = await deps.measureApp({
+        launch: {
+            ...(options.main === undefined ? {} : { main: options.main }),
+            ...(options.executablePath === undefined ? {} : { executablePath: options.executablePath }),
+            args: options.args,
+            env: options.env,
+        },
+        rounds: options.rounds,
+        phases: options.phases,
+        ...(options.settleMs === undefined ? {} : { settleMs: options.settleMs }),
+        ...(options.windowMs === undefined ? {} : { windowMs: options.windowMs }),
+        ...(budget === undefined ? {} : { budget }),
+        ...(workload === undefined ? {} : { workload }),
+        ...(options.workloadTimeoutMs === undefined
+            ? {}
+            : { workloadTimeoutMs: options.workloadTimeoutMs }),
+        ...(options.label === undefined ? {} : { label: options.label }),
+        onProgress: (message) => io.stderr(`${message}\n`),
+    });
+    // A run with no round would later read as "nothing over budget"; never write one.
+    if (run.rounds.length === 0) {
+        io.stderr('No round produced a measurement; no run was written.\n');
+        return BUDGET_EXIT_CODES.OVER_BUDGET;
+    }
+    if (budget?.bundle !== undefined && options.budgetPath !== undefined) {
+        const root = path.dirname(path.resolve(options.budgetPath));
+        run = { ...run, bundle: await measureBundle(root, budget.bundle.entries) };
+    }
+    if (options.outPath !== undefined)
+        await writeRun(options.outPath, run);
+    if (options.check && budget !== undefined) {
+        const report = checkRun(run, budget, {
+            strict: options.strict,
+            requireMeasurement: options.requireMeasurement,
+            ...(options.phase === undefined ? {} : { phase: options.phase }),
+        });
+        return emitReport(report, options.json, io);
+    }
+    if (options.outPath === undefined)
+        io.stdout(`${JSON.stringify(run, null, 2)}\n`);
+    else
+        io.stderr(`Wrote ${options.outPath}\n`);
+    return BUDGET_EXIT_CODES.SUCCESS;
+}
+/** Execute already-parsed options. Throws the typed file errors; the caller maps them to exit 2. */
+export async function runBudgetCli(options, io = PROCESS_IO, deps = { measureApp }) {
+    if (options.command === 'help') {
+        io.stdout(`${formatBudgetCliHelp()}\n`);
+        return BUDGET_EXIT_CODES.SUCCESS;
+    }
+    if (options.command === 'measure')
+        return runMeasure(options, io, deps);
+    if (options.command === 'compare') {
+        const rows = compareRuns(await loadRun(options.beforePath), await loadRun(options.afterPath));
+        if (rows.length === 0) {
+            io.stderr('Neither run holds a measurement; nothing to compare.\n');
+            return BUDGET_EXIT_CODES.OVER_BUDGET;
+        }
+        io.stdout(`${options.json ? JSON.stringify({ rows }) : renderComparison(rows)}\n`);
+        return BUDGET_EXIT_CODES.SUCCESS;
+    }
+    const budget = await loadBudget(options.budgetPath);
+    if (options.command === 'check') {
+        const report = checkRun(await loadRun(options.runPath), budget, {
+            strict: options.strict,
+            requireMeasurement: options.requireMeasurement,
+            ...(options.phase === undefined ? {} : { phase: options.phase }),
+        });
+        return emitReport(report, options.json, io);
+    }
+    if (budget.bundle === undefined) {
+        throw new UsageError(`${options.budgetPath} has no "bundle" section to measure`);
+    }
+    const root = path.resolve(options.root ?? path.dirname(options.budgetPath));
+    const run = createRun({ rounds: [], bundle: await measureBundle(root, budget.bundle.entries) });
+    if (options.outPath !== undefined)
+        await writeRun(options.outPath, run);
+    const bundleOnly = {
+        ...(budget.thresholdPercent === undefined ? {} : { thresholdPercent: budget.thresholdPercent }),
+        bundle: budget.bundle,
+    };
+    // Every entry was asked for by name here, so one that matched nothing fails the command.
+    const report = checkRun(run, bundleOnly, { strict: options.strict, requireMeasurement: true });
+    return emitReport(report, options.json, io);
+}
+/** Parse and execute; never throws. */
+export async function runBudgetCliCommand(argv, io = PROCESS_IO, deps = { measureApp }) {
+    try {
+        return await runBudgetCli(parseBudgetCliArgs(argv), io, deps);
+    }
+    catch (error) {
+        const known = error instanceof UsageError ||
+            error instanceof BudgetFileError ||
+            error instanceof RunFileError;
+        const message = error instanceof Error ? error.message : String(error);
+        io.stderr(`${known ? 'usage' : 'fatal'}: ${message}\n`);
+        if (error instanceof UsageError)
+            io.stderr(`\n${formatBudgetCliHelp()}\n`);
+        // Exit 1 means over budget; a crash must never read as a measured verdict.
+        return BUDGET_EXIT_CODES.USAGE;
+    }
+}
+function isMainEntryPoint(moduleUrl, entryPath) {
+    if (entryPath === undefined)
+        return false;
+    try {
+        return moduleUrl === pathToFileURL(realpathSync(entryPath)).href;
+    }
+    catch {
+        return false;
+    }
+}
+if (isMainEntryPoint(import.meta.url, process.argv[1])) {
+    process.exitCode = await runBudgetCliCommand(process.argv.slice(2));
+}
+//# sourceMappingURL=cli.js.map