@jevitate/cli 0.1.0 → 0.2.0

package/dist/bin.js.map

@@ -1 +1 @@
-{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,6EAA6E;AAC7E,MAAM,QAAQ,GAAG,IAAI,cAAc,CAAC,cAAc,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;AAClE,MAAM,MAAM,GAAG,cAAc,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC;AAC7C,MAAM,OAAO,GAAG,YAAY,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;AACnD,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IAC7C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACzC,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEtD,kGAAkG;AAClG,mGAAmG;AACnG,mGAAmG;AACnG,+DAA+D;AAC/D,KAAK,MAAM,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;IACtD,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAA0B,EAAE,EAAE;QAChD,IAAI,GAAG,CAAC,IAAI,KAAK,OAAO;YAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC1C,MAAM,GAAG,CAAC;IACZ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,oGAAoG;AACpG,gGAAgG;AAChG,8FAA8F;AAC9F,mGAAmG;AACnG,6FAA6F;AAC7F,oEAAoE;AACpE,wBAAwB,EAAE,CAAC;AAE3B,iGAAiG;AACjG,kGAAkG;AAClG,MAAM,WAAW,GAAG,kBAAkB,EAAE,CAAC;AACzC,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;IAC3B,KAAK,MAAM,CAAC,IAAI,WAAW;QAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC;IAC7E,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;AACjC,CAAC;AAED,6EAA6E;AAC7E,MAAM,QAAQ,GAAG,IAAI,cAAc,CAAC,cAAc,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;AAClE,MAAM,MAAM,GAAG,cAAc,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC;AAC7C,MAAM,OAAO,GAAG,YAAY,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;AAC9E,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IAC7C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACzC,2FAA2F;IAC3F,OAAO,CAAC,QAAQ,GAAG,UAAU,CAAC,YAAY,CAAC;AAC7C,CAAC,CAAC,CAAC"}

package/dist/browser-run-options.d.ts

@@ -0,0 +1,58 @@
+import type { BrowserLaunchOptions, OpenOptions } from "@jevitate/playwright";
+/** The browser options a runner takes: how Chromium is launched, plus how the run is shown (#245). */
+export interface BrowserRunOptions extends BrowserLaunchOptions {
+    /** A visible browser window (`--headed` / `JEVITATE_HEADED=1` / a suite item's `headed`). Default: headless. */
+    readonly headed?: boolean;
+    /**
+     * Record a Playwright video of every browser context the run opens (`--record-video [dir]`).
+     * `dir` absent ⇒ next to the run's output. Works headless too.
+     */
+    readonly recordVideo?: {
+        readonly dir?: string;
+    };
+    /** `--no-overlay` (false): a headed explore run shows the on-page demo overlay unless this is false. */
+    readonly overlay?: boolean;
+}
+/** `--slow-mo` when `--headed` is given without one: slow enough for an audience to follow. */
+export declare const HEADED_DEFAULT_SLOW_MO_MS = 250;
+/** The launch part of a session's `OpenOptions` — the ONE place headedness, slowMo and video are resolved. */
+export type SessionLaunchOptions = BrowserLaunchOptions & Pick<OpenOptions, "headless" | "recordVideo">;
+/**
+ * `browser` → the launch fields of `BrowserPort.open`: headless unless `headed`; `slowMo` as given,
+ * else `HEADED_DEFAULT_SLOW_MO_MS` when headed; `recordVideo` into `videoDir` when the run records
+ * (see `runVideoDir`). The demo-only fields (`headed`, `recordVideo`, `overlay`) never reach the port.
+ */
+export declare function sessionLaunchOptions(browser: BrowserRunOptions | undefined, videoDir?: string): SessionLaunchOptions;
+/** The explore config's `demoOverlay` (#245): shown on a headed run unless `--no-overlay`. */
+export declare function demoOverlayOf(browser: BrowserRunOptions | undefined): boolean;
+/**
+ * Where one run's videos go, or `undefined` when it does not record: a per-run folder named for the
+ * run's artifact (`<stem>.videos/`), under `--record-video <dir>` or else beside `artifactPath` —
+ * so a run's `videoPaths` are exactly the files in it, never another run's.
+ */
+export declare function runVideoDir(browser: BrowserRunOptions | undefined, artifactPath: string): string | undefined;
+/**
+ * The video files in a run's video folder, oldest first (absolute paths). Synchronous so a killed
+ * run's partial result can list them too. A missing folder (nothing recorded yet) is an empty list.
+ */
+export declare function listVideos(videoDir: string): string[];
+/**
+ * #245: a video is finalized only when its browser context closes — so a recording run closes its
+ * session(s) BEFORE its result is written, then lists the files. `close` must be idempotent (the
+ * runner's own `finally` calls it again; see `closeOnce`). Not recording: nothing closes early, `{}`.
+ */
+export declare function finalizeVideos(videoDir: string | undefined, close: () => Promise<void>): Promise<{
+    videoPaths?: string[];
+}>;
+/** Wraps an async teardown so only its first call runs; later calls await the same promise. */
+export declare function closeOnce(close: () => Promise<void>): () => Promise<void>;
+/** Headed without a display (#245): refused before any browser launches, a usage error (exit 64). */
+export declare class HeadedWithoutDisplayError extends Error {
+    constructor();
+}
+/** Throws `HeadedWithoutDisplayError` for a headed run on Linux with no X11/Wayland display. */
+export declare function assertHeadedDisplay(headed: boolean, env?: Readonly<Record<string, string | undefined>>, platform?: NodeJS.Platform): void;
+/** `JEVITATE_HEADED=1` (or `true`) turns `--headed` on for every command that takes it. */
+export declare function headedFromEnv(env: Readonly<Record<string, string | undefined>>): boolean;
+/** The one-line warning for a headed run that opens several windows at once (#245: warn, never refuse). */
+export declare function multiWindowWarning(what: string): string;

package/dist/browser-run-options.js

@@ -0,0 +1,106 @@
+/**
+ * Demo mode (#245): how a run's browser is SHOWN — a visible window, slowed down, recorded to video,
+ * with the on-page overlay — resolved in ONE place. Every runner (every explore strategy, `journey
+ * run`, `verify-fix`, regression capture/replay, observers and hang-replay sessions) builds its
+ * `BrowserPort.open` options with `sessionLaunchOptions`, never with its own `headless: true`, so a
+ * `--headed` run shows every window it opens and a run without the flags is unchanged: headless,
+ * no slowMo, no video, no overlay.
+ */
+import { readdirSync, statSync } from "node:fs";
+import { basename, dirname, join } from "node:path";
+/** `--slow-mo` when `--headed` is given without one: slow enough for an audience to follow. */
+export const HEADED_DEFAULT_SLOW_MO_MS = 250;
+/**
+ * `browser` → the launch fields of `BrowserPort.open`: headless unless `headed`; `slowMo` as given,
+ * else `HEADED_DEFAULT_SLOW_MO_MS` when headed; `recordVideo` into `videoDir` when the run records
+ * (see `runVideoDir`). The demo-only fields (`headed`, `recordVideo`, `overlay`) never reach the port.
+ */
+export function sessionLaunchOptions(browser, videoDir) {
+    const { headed, recordVideo: _video, overlay: _overlay, slowMo, ...launch } = browser ?? {};
+    const effectiveSlowMo = slowMo ?? (headed === true ? HEADED_DEFAULT_SLOW_MO_MS : undefined);
+    return {
+        ...launch,
+        headless: headed !== true,
+        ...(effectiveSlowMo === undefined ? {} : { slowMo: effectiveSlowMo }),
+        ...(videoDir === undefined ? {} : { recordVideo: { dir: videoDir } }),
+    };
+}
+/** The explore config's `demoOverlay` (#245): shown on a headed run unless `--no-overlay`. */
+export function demoOverlayOf(browser) {
+    return browser?.headed === true && browser.overlay !== false;
+}
+/**
+ * Where one run's videos go, or `undefined` when it does not record: a per-run folder named for the
+ * run's artifact (`<stem>.videos/`), under `--record-video <dir>` or else beside `artifactPath` —
+ * so a run's `videoPaths` are exactly the files in it, never another run's.
+ */
+export function runVideoDir(browser, artifactPath) {
+    if (browser?.recordVideo === undefined)
+        return undefined;
+    const stem = basename(artifactPath).replace(/\.json$/, "");
+    return join(browser.recordVideo.dir ?? dirname(artifactPath), `${stem}.videos`);
+}
+/**
+ * The video files in a run's video folder, oldest first (absolute paths). Synchronous so a killed
+ * run's partial result can list them too. A missing folder (nothing recorded yet) is an empty list.
+ */
+export function listVideos(videoDir) {
+    let names;
+    try {
+        names = readdirSync(videoDir).filter((n) => n.endsWith(".webm"));
+    }
+    catch {
+        return [];
+    }
+    const files = names.map((n) => join(videoDir, n));
+    const mtime = (f) => {
+        try {
+            return statSync(f).mtimeMs;
+        }
+        catch {
+            return 0;
+        }
+    };
+    return files.sort((a, b) => mtime(a) - mtime(b) || a.localeCompare(b));
+}
+/**
+ * #245: a video is finalized only when its browser context closes — so a recording run closes its
+ * session(s) BEFORE its result is written, then lists the files. `close` must be idempotent (the
+ * runner's own `finally` calls it again; see `closeOnce`). Not recording: nothing closes early, `{}`.
+ */
+export async function finalizeVideos(videoDir, close) {
+    if (videoDir === undefined)
+        return {};
+    await close();
+    return { videoPaths: listVideos(videoDir) };
+}
+/** Wraps an async teardown so only its first call runs; later calls await the same promise. */
+export function closeOnce(close) {
+    let done;
+    return () => (done ??= close());
+}
+/** Headed without a display (#245): refused before any browser launches, a usage error (exit 64). */
+export class HeadedWithoutDisplayError extends Error {
+    constructor() {
+        super("--headed needs a display, but neither DISPLAY nor WAYLAND_DISPLAY is set (on WSL2 a visible window needs WSLg). " +
+            "Run headless and record it instead: --record-video");
+        this.name = "HeadedWithoutDisplayError";
+    }
+}
+/** Throws `HeadedWithoutDisplayError` for a headed run on Linux with no X11/Wayland display. */
+export function assertHeadedDisplay(headed, env = process.env, platform = process.platform) {
+    if (!headed || platform !== "linux")
+        return;
+    if ((env.DISPLAY ?? "") === "" && (env.WAYLAND_DISPLAY ?? "") === "")
+        throw new HeadedWithoutDisplayError();
+}
+/** `JEVITATE_HEADED=1` (or `true`) turns `--headed` on for every command that takes it. */
+export function headedFromEnv(env) {
+    const v = env.JEVITATE_HEADED?.trim().toLowerCase();
+    return v === "1" || v === "true";
+}
+/** The one-line warning for a headed run that opens several windows at once (#245: warn, never refuse). */
+export function multiWindowWarning(what) {
+    return `warning: --headed with ${what} opens several browser windows; each is shown.\n`;
+}
+//# sourceMappingURL=browser-run-options.js.map

package/dist/browser-run-options.js.map

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

package/dist/build-info.generated.d.ts

@@ -0,0 +1,2 @@
+export declare const GENERATED_COMMIT: string;
+export declare const GENERATED_BUILT_AT: string;

package/dist/build-info.generated.js

@@ -0,0 +1,10 @@
+// AUTO-GENERATED by packages/cli/scripts/generate-build-info.mjs at build time.
+// Do not edit by hand — regenerated on every `build`/`bundle` run. Gitignored.
+//
+// The tsc-build counterpart to build.mjs's esbuild `define`: a dev `npm link` install runs
+// this plain `tsc --build` dist (no bundler substitution), so it needs real committed values
+// here instead. See ./engine.ts, which prefers the esbuild-injected value when present and
+// falls back to these.
+export const GENERATED_COMMIT = "09b80b5";
+export const GENERATED_BUILT_AT = "2026-09-29T20:26:11.852Z";
+//# sourceMappingURL=build-info.generated.js.map

package/dist/build-info.generated.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-info.generated.js","sourceRoot":"","sources":["../src/build-info.generated.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,+EAA+E;AAC/E,EAAE;AACF,2FAA2F;AAC3F,6FAA6F;AAC7F,2FAA2F;AAC3F,uBAAuB;AACvB,MAAM,CAAC,MAAM,gBAAgB,GAAW,SAAS,CAAC;AAClD,MAAM,CAAC,MAAM,kBAAkB,GAAW,0BAA0B,CAAC"}

package/dist/check-api.d.ts

@@ -0,0 +1,5 @@
+import { type CheckResult, type RunCheckOptions } from "./check-types.js";
+export { affectedBy } from "./check-plan.js";
+export { BudgetMeter } from "./check-budget.js";
+export { type BudgetReport, CheckAiSetupError, type CheckFinding, type CheckGateways, type CheckItemReport, CheckPreflightError, type CheckResult, type CheckRunners, type ItemKind, type RunCheckOptions } from "./check-types.js";
+export declare function runCheck(opts: RunCheckOptions): Promise<CheckResult>;

package/dist/check-api.js

@@ -0,0 +1,233 @@
+import { mkdir, writeFile } from "node:fs/promises";
+import { join, resolve } from "node:path";
+import { aggregateOf, formatUsageLine } from "@jevitate/ai-core";
+import { consolidate, diffRuns, renderJUnit, renderReportMarkdown, renderSarif } from "@jevitate/findings";
+import { runAdversarialCliMission, runCoverageMission, runExploration, runFeatureCliMission } from "./explore-api.js";
+import { runJourneyProgrammatically } from "./journey-api.js";
+import { runUsabilityMission } from "./ux-api.js";
+import { runVerifyFix } from "./verify-fix-api.js";
+import { currentEngineInfo } from "./engine.js";
+import { loadRunFile, resolveBaseline, scanRuns, summarizeRun } from "./report-api.js";
+import { CheckAiSetupError } from "./check-types.js";
+import { BudgetMeter } from "./check-budget.js";
+import { errorMessage, plan, prepareTarget } from "./check-plan.js";
+import { caseDetail, execute } from "./check-execute.js";
+export { affectedBy } from "./check-plan.js";
+export { BudgetMeter } from "./check-budget.js";
+export { CheckAiSetupError, CheckPreflightError } from "./check-types.js";
+const REAL_RUNNERS = {
+    journey: runJourneyProgrammatically,
+    goal: runExploration,
+    coverage: runCoverageMission,
+    adversarial: runAdversarialCliMission,
+    feature: runFeatureCliMission,
+    usability: runUsabilityMission,
+    verifyFix: runVerifyFix,
+};
+export async function runCheck(opts) {
+    const nowIso = opts.nowIso ?? (() => new Date().toISOString());
+    const startedAt = nowIso();
+    const engine = currentEngineInfo();
+    const outDir = resolve(opts.outDir);
+    const resultsDir = join(outDir, "results");
+    const runners = { ...REAL_RUNNERS, ...opts.runners };
+    // Preflight — everything validated before the first browser opens.
+    const prepared = [];
+    for (const t of opts.suite.targets)
+        prepared.push(await prepareTarget(t, opts));
+    const items = plan(prepared, opts.changedRoutes, opts);
+    let gw;
+    const gateways = () => {
+        if (opts.gateways === undefined)
+            return Promise.reject(new CheckAiSetupError("this suite needs a model gateway: pass --real or --fake-ai (or set \"ai\" in the suite)"));
+        gw ??= opts.gateways();
+        return gw;
+    };
+    // A missing/unselectable gateway throws here (typed), before any browser opens.
+    if (items.some((i) => i.needsAi && i.skipped === undefined))
+        await gateways();
+    await mkdir(resultsDir, { recursive: true });
+    const meter = new BudgetMeter(opts.suite.budget, { ...(opts.now === undefined ? {} : { now: opts.now }), costKnownZero: opts.aiMode === "fake" });
+    const usage = async () => (gw === undefined ? undefined : (await gw).usage.snapshot());
+    let n = 0;
+    const ctx = { opts, runners, resultsDir, gateways, engine, seq: () => String(++n) };
+    const now = opts.now ?? Date.now;
+    let exceeded;
+    const executed = [];
+    for (const item of items) {
+        if (item.skipped !== undefined) {
+            executed.push({ item, ex: undefined, durationMs: 0 });
+            continue;
+        }
+        const blocked = meter.blocked(await usage());
+        if (blocked !== undefined) {
+            exceeded ??= blocked;
+            executed.push({ item, ex: { status: "error", actions: 0, error: { type: "budget-exceeded", message: `not run: ${blocked}` } }, durationMs: 0 });
+            continue;
+        }
+        const t0 = now();
+        let ex;
+        try {
+            ex = await execute(item, ctx, meter.remainingActions());
+        }
+        catch (e) {
+            ex = { status: "error", actions: 0, error: { type: e instanceof Error ? e.name : "error", message: errorMessage(e) } };
+        }
+        const over = meter.charge(ex.actions, await usage());
+        if (over !== undefined)
+            exceeded ??= over;
+        executed.push({ item, ex, durationMs: now() - t0 });
+    }
+    // Findings: the shared identity over every result this check wrote.
+    const runs = [];
+    const runOf = new Map();
+    for (const { ex } of executed) {
+        if (ex?.resultPath === undefined)
+            continue;
+        const run = loadRunFile(ex.resultPath);
+        if (run === null)
+            continue;
+        runs.push(run);
+        runOf.set(ex.resultPath, run);
+    }
+    const defects = consolidate(runs);
+    let diff;
+    let baselineRuns;
+    if (opts.baseline !== undefined) {
+        const dirs = opts.baselineDirs ?? [resultsDir];
+        baselineRuns = resolveBaseline(opts.baseline, runs, {
+            dirs,
+            ...(opts.baselinesDir === undefined ? {} : { baselinesDir: opts.baselinesDir }),
+            pool: scanRuns(dirs),
+        });
+        diff = diffRuns(baselineRuns, runs);
+    }
+    const entryOf = new Map(diff?.entries.map((e) => [e.key, e]) ?? []);
+    const isGating = (d) => {
+        if (d.severity !== "hard" && !opts.suite.gateAdvisory)
+            return false;
+        if (diff === undefined)
+            return true;
+        // A finding is matched to its diff entry by any member key (merged cascades).
+        const entry = d.keys.map((k) => entryOf.get(k)).find((e) => e !== undefined) ?? entryOf.get(d.key);
+        return entry === undefined ? true : !entry.inBaseline;
+    };
+    const statusOf = (d) => d.keys.map((k) => entryOf.get(k)?.status).find((s) => s !== undefined);
+    const gating = defects.filter(isGating);
+    const itemReports = executed.map(({ item, ex, durationMs }) => {
+        const base = {
+            target: item.t.target.name,
+            kind: item.kind,
+            name: item.name,
+            ...(item.strategy === undefined ? {} : { strategy: item.strategy }),
+            durationMs,
+        };
+        if (ex === undefined)
+            return { ...base, status: "skipped", actions: 0, verdict: "skipped", gating: [] };
+        const run = ex.resultPath === undefined ? undefined : runOf.get(ex.resultPath);
+        const own = run === undefined ? [] : gating.filter((d) => d.modes.some((m) => m.runs.some((r) => r.path === run.path)));
+        const verdict = ex.status === "error" ? "error" : own.length > 0 ? "failed" : "passed";
+        return {
+            ...base,
+            status: ex.status,
+            actions: ex.actions,
+            verdict,
+            gating: own.map((d) => d.key),
+            ...(ex.error === undefined ? {} : { error: ex.error }),
+            ...(ex.resultPath === undefined ? {} : { resultPath: ex.resultPath }),
+            ...(run === undefined ? {} : { runId: run.runId }),
+            ...(ex.outcome === undefined ? {} : { outcome: ex.outcome }),
+            ...(ex.goalOutcome === undefined ? {} : { goalOutcome: ex.goalOutcome }),
+        };
+    });
+    const errors = itemReports.filter((i) => i.verdict === "error").length;
+    const exitCode = gating.length > 0 ? 1 : errors > 0 || exceeded !== undefined ? 2 : 0;
+    const junitPath = resolve(opts.junitPath ?? join(outDir, "junit.xml"));
+    const sarifPath = resolve(opts.sarifPath ?? join(outDir, "jevitate.sarif"));
+    const jsonPath = resolve(opts.jsonPath ?? join(outDir, "check.json"));
+    const reportPath = join(outDir, "report.md");
+    const cases = itemReports.map((i) => {
+        const own = gating.filter((d) => i.gating.includes(d.key));
+        const first = own[0];
+        // #250: each gating finding's repro clip and screenshots, attached to the case CI shows.
+        const attachments = [
+            ...new Set(own.flatMap((d) => d.evidence.flatMap((e) => [e.video, e.screenshot]).filter((f) => f !== undefined && /\.(webm|png)$/i.test(f)))),
+        ];
+        return {
+            suite: i.target,
+            classname: `jevitate.${i.target}.${i.kind}${i.strategy === undefined ? "" : `.${i.strategy}`}`,
+            name: i.name,
+            timeSec: i.durationMs / 1000,
+            status: i.verdict,
+            ...(i.resultPath === undefined ? {} : { resultPath: i.resultPath }),
+            ...(attachments.length === 0 ? {} : { attachments }),
+            ...(i.verdict === "failed" && first !== undefined
+                ? { type: first.category, message: `${own.length} gating finding(s): ${first.title}`, detail: caseDetail(own) }
+                : {}),
+            ...(i.verdict === "error" && i.error !== undefined ? { type: i.error.type, message: i.error.message } : {}),
+            ...(i.verdict === "skipped" ? { message: "not affected by --changed-routes" } : {}),
+        };
+    });
+    if (exceeded !== undefined && !cases.some((c) => c.type === "budget-exceeded")) {
+        cases.push({ suite: "budget", classname: "jevitate.budget", name: "total budget", timeSec: 0, status: "error", type: "budget-exceeded", message: exceeded });
+    }
+    const findings = defects.map((d) => {
+        const status = statusOf(d);
+        return {
+            key: d.key,
+            title: d.title,
+            category: d.category,
+            severity: d.severity,
+            identity: d.identity,
+            gating: gating.includes(d),
+            modes: d.modes,
+            ...(status === undefined ? {} : { status }),
+            ...(d.reproduce === undefined ? {} : { reproduce: d.reproduce }),
+        };
+    });
+    const finalUsage = await usage();
+    const suiteUsage = finalUsage === undefined ? undefined : aggregateOf(finalUsage, executed.filter((e) => e.ex !== undefined).length);
+    const result = {
+        kind: "jevitate-check",
+        suite: opts.suite.name,
+        suitePath: opts.suite.path,
+        verdict: exitCode === 0 ? "pass" : "fail",
+        exitCode,
+        engine,
+        ...(opts.targetBuild === undefined ? {} : { targetBuild: opts.targetBuild }),
+        startedAt,
+        budget: meter.report(finalUsage, exceeded),
+        ...(suiteUsage === undefined ? {} : { usage: suiteUsage }),
+        items: itemReports,
+        findings,
+        summary: {
+            items: itemReports.length,
+            passed: itemReports.filter((i) => i.verdict === "passed").length,
+            failed: itemReports.filter((i) => i.verdict === "failed").length,
+            errors,
+            skipped: itemReports.filter((i) => i.verdict === "skipped").length,
+            gatingFindings: gating.length,
+        },
+        ...(diff === undefined || baselineRuns === undefined ? {} : { diff: { baseline: baselineRuns.map(summarizeRun), summary: diff.summary } }),
+        results: runs.map((r) => r.path),
+        junitPath,
+        sarifPath,
+        jsonPath,
+        reportPath,
+    };
+    await writeFile(junitPath, renderJUnit(`jevitate check: ${opts.suite.name}`, cases, startedAt), "utf8");
+    const sarif = renderSarif({
+        toolVersion: engine.version,
+        engineCommit: engine.commit,
+        ...(opts.targetBuild === undefined ? {} : { targetBuild: opts.targetBuild }),
+        suiteUri: opts.suiteUri ?? opts.suite.path,
+        automationId: `jevitate-check/${opts.suite.name}/`,
+        findings: defects.map((d) => ({ defect: d, gating: gating.includes(d), ...(statusOf(d) === undefined ? {} : { status: statusOf(d) }) })),
+    });
+    await writeFile(sarifPath, `${JSON.stringify(sarif, null, 2)}\n`, "utf8");
+    await writeFile(reportPath, renderReportMarkdown({ title: `jevitate check: ${opts.suite.name} — ${result.verdict}`, runs, defects, ...(diff === undefined ? {} : { diff }) }) +
+        (suiteUsage === undefined ? "" : `\n## Model cost\n\n${formatUsageLine(suiteUsage)}\n`), "utf8");
+    await writeFile(jsonPath, `${JSON.stringify({ v: 1, ok: true, data: result }, null, 2)}\n`, "utf8");
+    return result;
+}
+//# sourceMappingURL=check-api.js.map

package/dist/check-api.js.map

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

package/dist/check-budget.d.ts

@@ -0,0 +1,26 @@
+import { type UsageCounts } from "@jevitate/ai-core";
+import type { SuiteBudget } from "./check-suite.js";
+import { type BudgetReport } from "./check-types.js";
+/** The suite's total budget. Exceeding any limit fails the check (fail closed). */
+export declare class BudgetMeter {
+    #private;
+    constructor(limits: SuiteBudget, opts?: {
+        now?: () => number;
+        costKnownZero?: boolean;
+    });
+    get actions(): number;
+    /** Actions left (undefined: no action limit). */
+    remainingActions(): number | undefined;
+    minutes(): number;
+    /**
+     * The spend so far: 0 when no model call was made (or the gateways are fakes), the FULL total
+     * (Jev + generation, #163) when every call was priced, else undefined — a partial total is not a
+     * measurable spend, so a `maxUsd` budget fails closed on it rather than passing on an undercount.
+     */
+    usd(usage: UsageCounts | undefined): number | undefined;
+    /** Records an item's actions and re-checks every limit. Returns why the budget is now exceeded, if it is. */
+    charge(actions: number, usage: UsageCounts | undefined): string | undefined;
+    /** Can another item start? Returns why not (the budget is exhausted or already exceeded). */
+    blocked(usage: UsageCounts | undefined): string | undefined;
+    report(usage: UsageCounts | undefined, exceeded: string | undefined): BudgetReport;
+}

package/dist/check-budget.js

@@ -0,0 +1,89 @@
+// ── budget ───────────────────────────────────────────────────────────────────
+/** Why a spend is not measurable: what could not be priced. */
+function unmeasurable(usage) {
+    const missing = usage?.missing ?? [];
+    return `${usage?.priced === "none" ? "unpriced" : "only partially priced"}${missing.length === 0 ? "" : ` — missing: ${missing.join("; ")}`}`;
+}
+/** The suite's total budget. Exceeding any limit fails the check (fail closed). */
+export class BudgetMeter {
+    #limits;
+    #now;
+    #start;
+    #costKnownZero;
+    #actions = 0;
+    #exceeded;
+    constructor(limits, opts = {}) {
+        this.#limits = limits;
+        this.#now = opts.now ?? Date.now;
+        this.#start = this.#now();
+        this.#costKnownZero = opts.costKnownZero === true;
+    }
+    get actions() {
+        return this.#actions;
+    }
+    /** Actions left (undefined: no action limit). */
+    remainingActions() {
+        return this.#limits.maxActions === undefined ? undefined : this.#limits.maxActions - this.#actions;
+    }
+    minutes() {
+        return (this.#now() - this.#start) / 60_000;
+    }
+    /**
+     * The spend so far: 0 when no model call was made (or the gateways are fakes), the FULL total
+     * (Jev + generation, #163) when every call was priced, else undefined — a partial total is not a
+     * measurable spend, so a `maxUsd` budget fails closed on it rather than passing on an undercount.
+     */
+    usd(usage) {
+        if (usage === undefined || usage.judgments + usage.generations === 0)
+            return 0;
+        if (this.#costKnownZero)
+            return usage.totalUsd ?? 0;
+        return usage.priced === "full" ? (usage.totalUsd ?? 0) : undefined;
+    }
+    /** Records an item's actions and re-checks every limit. Returns why the budget is now exceeded, if it is. */
+    charge(actions, usage) {
+        this.#actions += actions;
+        const l = this.#limits;
+        if (this.#exceeded === undefined && l.maxActions !== undefined && this.#actions > l.maxActions) {
+            this.#exceeded = `action budget exceeded: ${this.#actions} > ${l.maxActions}`;
+        }
+        if (this.#exceeded === undefined && l.maxMinutes !== undefined && this.minutes() > l.maxMinutes) {
+            this.#exceeded = `time budget exceeded: ${this.minutes().toFixed(2)} > ${l.maxMinutes} min`;
+        }
+        if (this.#exceeded === undefined && l.maxUsd !== undefined) {
+            const usd = this.usd(usage);
+            if (usd === undefined)
+                this.#exceeded = `usd budget set but the model spend is ${unmeasurable(usage)} (spend not measurable)`;
+            else if (usd > l.maxUsd)
+                this.#exceeded = `usd budget exceeded: $${usd.toFixed(4)} > $${l.maxUsd}`;
+        }
+        return this.#exceeded;
+    }
+    /** Can another item start? Returns why not (the budget is exhausted or already exceeded). */
+    blocked(usage) {
+        if (this.#exceeded !== undefined)
+            return this.#exceeded;
+        const l = this.#limits;
+        if (l.maxActions !== undefined && this.#actions >= l.maxActions)
+            return `action budget exhausted: ${this.#actions}/${l.maxActions}`;
+        if (l.maxMinutes !== undefined && this.minutes() >= l.maxMinutes)
+            return `time budget exhausted: ${l.maxMinutes} min`;
+        if (l.maxUsd !== undefined) {
+            const usd = this.usd(usage);
+            if (usd === undefined)
+                return `usd budget set but the model spend is ${unmeasurable(usage)} (spend not measurable)`;
+            if (usd >= l.maxUsd)
+                return `usd budget exhausted: $${usd.toFixed(4)}/$${l.maxUsd}`;
+        }
+        return undefined;
+    }
+    report(usage, exceeded) {
+        const usd = this.usd(usage);
+        return {
+            limits: this.#limits,
+            used: { actions: this.#actions, minutes: Number(this.minutes().toFixed(3)), ...(usd === undefined ? {} : { usd }) },
+            ...(exceeded === undefined ? {} : { exceeded }),
+        };
+    }
+}
+//# sourceMappingURL=check-budget.js.map

package/dist/check-budget.js.map

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

package/dist/check-cli.d.ts

@@ -0,0 +1,31 @@
+import type { Command } from "commander";
+import type { BrowserLaunchOptions, BrowserPort } from "@jevitate/playwright";
+import { type CheckGateways, type CheckRunners } from "./check-api.js";
+/**
+ * `jevitate check --suite <file.json>` (#137). Registered by `program.ts`; its model gateways and
+ * browser wiring come in through `CheckCliDeps` so this file never builds a gateway itself.
+ *
+ * Exit codes (exit-codes.ts): 0 pass · 1 a gating (hard, or new vs `--baseline`) finding · 2 no
+ * gating finding but an item errored, the budget was exceeded, or the check itself failed · 64 the
+ * suite, preflight, targets file or AI setup was refused (a usage/input error: nothing ran).
+ */
+export interface CheckCliDeps {
+    /** Builds the explore gateways for `--real` / `--fake-ai` (program.ts's `buildExploreGateways`). */
+    readonly buildGateways: (sel: {
+        real: boolean;
+        fakeAi: boolean;
+    }) => Promise<CheckGateways>;
+    readonly journeysDir: string;
+    /** The site-policy database (`jevitate site policy set`) Journey items are gated by. */
+    readonly sitePolicyDbPath?: string;
+    readonly targetsConfigPath?: string;
+    /** #247: the environments file a Journey item's `env` names (default: the repo's `.jevitate/environments.json`). */
+    readonly environmentsFile?: string;
+    readonly browserPortFactory?: () => BrowserPort;
+    /** Maps the command's browser launch flags to launch options (program.ts's `browserLaunchFromFlags`). */
+    readonly browserLaunch?: (flags: object) => BrowserLaunchOptions | undefined;
+    readonly baselinesDir?: string;
+    /** Test seam: replace the runners. */
+    readonly runners?: Partial<CheckRunners>;
+}
+export declare function registerCheckCommand(program: Command, deps: CheckCliDeps, withLaunchFlags: (cmd: Command) => Command): void;