@jevitate/cli 0.1.0 → 0.3.0

package/dist/check-api.js

@@ -0,0 +1,234 @@
+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";
+import { clock } from "@jevitate/domain";
+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 ?? (() => clock.nowIso());
+    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 ?? clock.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,90 @@
+import { clock } from "@jevitate/domain";
+// ── 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 ?? clock.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;

package/dist/check-cli.js

@@ -0,0 +1,109 @@
+import { MissingCredentialError, formatUsageLine } from "@jevitate/ai-core";
+import { ok, fail } from "./envelope.js";
+import { emitEnvelope } from "./cli-output.js";
+import { CheckAiSetupError, CheckPreflightError, runCheck } from "./check-api.js";
+import { SuiteError, loadSuite } from "./check-suite.js";
+import { ReportInputError, defaultResultDirs } from "./report-api.js";
+import { TargetConfigError, loadTargetsFile } from "./target-config.js";
+/** #210: the envelope with --json; a refusal without it is an `error <CODE>: …` line (exit-codes.ts class). */
+function emit(program, envelope, json, exitCode) {
+    emitEnvelope(program, envelope, { json, command: "check", ...(exitCode === undefined ? {} : { exitCode }) });
+}
+const collect = (v, prev) => [...prev, v];
+const collectList = (v, prev) => [...prev, ...v.split(",").map((s) => s.trim()).filter((s) => s !== "")];
+export function registerCheckCommand(program, deps, withLaunchFlags) {
+    withLaunchFlags(program
+        .command("check")
+        .description("CI regression gate: run a suite of Journeys, invariants, goals and missions within a budget; JUnit + SARIF + JSON"))
+        .requiredOption("--suite <file>", "the suite JSON (targets, promoted Journeys, invariant files, goals, missions, budget)")
+        .option("--target-build <id>", "the target's build/commit id, stamped on every result")
+        .option("--baseline <run|tag|last>", "only findings NOT in this baseline gate (a run, a `baseline tag`, or `last`)")
+        .option("--baseline-dir <dir>", "results dir holding baseline runs (repeatable; default: this check's results, then ~/.jevitate)", collect, [])
+        .option("--changed-routes <globs>", "only run Journeys and goals touching these route globs (comma list, repeatable), e.g. '/settings/**'", collectList, [])
+        .option("--out <dir>", "output dir: results/, junit.xml, jevitate.sarif, report.md, check.json", "jevitate-check")
+        .option("--junit <path>", "JUnit XML path (default <out>/junit.xml)")
+        .option("--sarif <path>", "SARIF path (default <out>/jevitate.sarif)")
+        .option("--json-out <path>", "JSON envelope path (default <out>/check.json)")
+        .option("--real", "use live Jev + OpenRouter gateways for goals and model-driven missions (requires keys)", false)
+        .option("--fake-ai", "use deterministic fake gateways (pipeline smoke only)", false)
+        .option("--json", "emit the JSON envelope (default: a one-line summary per item, then the envelope path)")
+        .action(async function () {
+        const o = this.opts();
+        try {
+            const suite = loadSuite(o.suite);
+            const real = o.real === true || (o.fakeAi !== true && suite.ai === "real");
+            const fakeAi = o.fakeAi === true || (o.real !== true && suite.ai === "fake");
+            const aiMode = real ? "real" : fakeAi ? "fake" : undefined;
+            const browser = deps.browserLaunch?.(this.opts());
+            const result = await runCheck({
+                suite,
+                suiteUri: o.suite,
+                outDir: o.out,
+                journeysDir: deps.journeysDir,
+                ...(deps.sitePolicyDbPath === undefined ? {} : { sitePolicyDbPath: deps.sitePolicyDbPath }),
+                targetsConfig: loadTargetsFile(deps.targetsConfigPath),
+                ...(deps.environmentsFile === undefined ? {} : { environmentsFile: deps.environmentsFile }),
+                ...(o.targetBuild === undefined ? {} : { targetBuild: o.targetBuild }),
+                ...(o.baseline === undefined ? {} : { baseline: o.baseline }),
+                ...(o.baselineDir.length > 0 ? { baselineDirs: o.baselineDir } : o.baseline === undefined ? {} : { baselineDirs: [`${o.out}/results`, ...defaultResultDirs()] }),
+                ...(deps.baselinesDir === undefined ? {} : { baselinesDir: deps.baselinesDir }),
+                ...(o.changedRoutes.length > 0 ? { changedRoutes: o.changedRoutes } : {}),
+                ...(o.junit === undefined ? {} : { junitPath: o.junit }),
+                ...(o.sarif === undefined ? {} : { sarifPath: o.sarif }),
+                ...(o.jsonOut === undefined ? {} : { jsonPath: o.jsonOut }),
+                ...(aiMode === undefined ? {} : { aiMode, gateways: () => deps.buildGateways({ real, fakeAi }) }),
+                ...(deps.browserPortFactory === undefined ? {} : { browserPortFactory: deps.browserPortFactory }),
+                ...(browser === undefined ? {} : { browser }),
+                ...(deps.runners === undefined ? {} : { runners: deps.runners }),
+            });
+            if (o.json)
+                emit(program, ok(result), true, result.exitCode);
+            else {
+                const out = program.configureOutput().writeOut;
+                const findingTitle = new Map(result.findings.map((f) => [f.key, f.title]));
+                for (const i of result.items) {
+                    const reason = i.error !== undefined
+                        ? ` — ${i.error.message}`
+                        : i.verdict === "failed" && i.gating.length > 0
+                            ? ` — ${i.gating.map((k) => findingTitle.get(k) ?? k).join("; ")}`
+                            : "";
+                    out?.(`${i.verdict.toUpperCase().padEnd(7)} ${i.target} ${i.kind} ${i.name}${reason}\n`);
+                }
+                // #213: 0 calls is nothing to report (not $0 vs "unpriced" noise) — omit the line entirely.
+                if (result.usage !== undefined && result.usage.judgments + result.usage.generations > 0) {
+                    out?.(`COST    ${formatUsageLine(result.usage)}\n`);
+                }
+                if (result.budget.exceeded !== undefined)
+                    out?.(`BUDGET  ${result.budget.exceeded}\n`);
+                // #213: exit 2 (an item errored, or the budget ran out, but no gating finding) is never
+                // headed FAIL — that reads as a defect was found when the run simply proved nothing.
+                const headline = result.exitCode === 0
+                    ? `PASS: ${result.summary.gatingFindings} gating finding(s)`
+                    : result.exitCode === 1
+                        ? `FAIL: ${result.summary.gatingFindings} gating finding(s)`
+                        : result.summary.errors > 0
+                            ? `ERROR: ${result.summary.errors} item(s) errored${result.budget.exceeded === undefined ? "" : " · budget exceeded"}`
+                            : `INCONCLUSIVE: ${result.budget.exceeded ?? "the budget was exceeded before every item ran"}`;
+                out?.(`${headline} · ${result.jsonPath}\n`);
+                out?.(result.summary.gatingFindings > 0 ? "next: jevitate report (the findings by fingerprint) · jevitate verify-fix <fp> after a fix\n" : "next: jevitate report\n");
+                process.exitCode = result.exitCode;
+            }
+        }
+        catch (err) {
+            if (err instanceof SuiteError ||
+                err instanceof CheckPreflightError ||
+                err instanceof CheckAiSetupError ||
+                err instanceof ReportInputError ||
+                err instanceof TargetConfigError) {
+                emit(program, fail(err.code, err.message), o.json === true);
+            }
+            else if (err instanceof MissingCredentialError || (err instanceof Error && err.name === "GatewaySelectionError")) {
+                emit(program, fail("E_AI_SETUP_REQUIRED", err.message), o.json === true);
+            }
+            else {
+                emit(program, fail("E_CHECK", err instanceof Error ? err.message : String(err)), o.json === true);
+            }
+        }
+    });
+}
+//# sourceMappingURL=check-cli.js.map

package/dist/check-cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-cli.js","sourceRoot":"","sources":["../src/check-cli.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAE5E,OAAO,EAAE,EAAE,EAAE,IAAI,EAAqB,MAAM,eAAe,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,QAAQ,EAAyC,MAAM,gBAAgB,CAAC;AACzH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AA4BxE,+GAA+G;AAC/G,SAAS,IAAI,CAAC,OAAgB,EAAE,QAA+B,EAAE,IAAa,EAAE,QAAiB;IAC/F,YAAY,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;AAC/G,CAAC;AAED,MAAM,OAAO,GAAG,CAAC,CAAS,EAAE,IAAc,EAAY,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC;AACtE,MAAM,WAAW,GAAG,CAAC,CAAS,EAAE,IAAc,EAAY,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;AAErI,MAAM,UAAU,oBAAoB,CAAC,OAAgB,EAAE,IAAkB,EAAE,eAA0C;IACnH,eAAe,CACb,OAAO;SACJ,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,mHAAmH,CAAC,CACpI;SACE,cAAc,CAAC,gBAAgB,EAAE,uFAAuF,CAAC;SACzH,MAAM,CAAC,qBAAqB,EAAE,uDAAuD,CAAC;SACtF,MAAM,CAAC,2BAA2B,EAAE,8EAA8E,CAAC;SACnH,MAAM,CAAC,sBAAsB,EAAE,iGAAiG,EAAE,OAAO,EAAE,EAAc,CAAC;SAC1J,MAAM,CAAC,0BAA0B,EAAE,sGAAsG,EAAE,WAAW,EAAE,EAAc,CAAC;SACvK,MAAM,CAAC,aAAa,EAAE,wEAAwE,EAAE,gBAAgB,CAAC;SACjH,MAAM,CAAC,gBAAgB,EAAE,0CAA0C,CAAC;SACpE,MAAM,CAAC,gBAAgB,EAAE,2CAA2C,CAAC;SACrE,MAAM,CAAC,mBAAmB,EAAE,+CAA+C,CAAC;SAC5E,MAAM,CAAC,QAAQ,EAAE,wFAAwF,EAAE,KAAK,CAAC;SACjH,MAAM,CAAC,WAAW,EAAE,uDAAuD,EAAE,KAAK,CAAC;SACnF,MAAM,CAAC,QAAQ,EAAE,uFAAuF,CAAC;SACzG,MAAM,CAAC,KAAK;QACX,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,EAaf,CAAC;QACL,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;YACjC,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC;YAC3E,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,IAAI,KAAK,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC;YAC7E,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;YAC3D,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;YAClD,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC;gBAC5B,KAAK;gBACL,QAAQ,EAAE,CAAC,CAAC,KAAK;gBACjB,MAAM,EAAE,CAAC,CAAC,GAAG;gBACb,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,GAAG,CAAC,IAAI,CAAC,gBAAgB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,EAAE,CAAC;gBAC3F,aAAa,EAAE,eAAe,CAAC,IAAI,CAAC,iBAAiB,CAAC;gBACtD,GAAG,CAAC,IAAI,CAAC,gBAAgB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,EAAE,CAAC;gBAC3F,GAAG,CAAC,CAAC,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;gBACtE,GAAG,CAAC,CAAC,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC;gBAC7D,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,UAAU,EAAE,GAAG,iBAAiB,EAAE,CAAC,EAAE,CAAC;gBAChK,GAAG,CAAC,IAAI,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC;gBAC/E,GAAG,CAAC,CAAC,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACzE,GAAG,CAAC,CAAC,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;gBACxD,GAAG,CAAC,CAAC,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;gBACxD,GAAG,CAAC,CAAC,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;gBAC3D,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;gBACjG,GAAG,CAAC,IAAI,CAAC,kBAAkB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,kBAAkB,EAAE,IAAI,CAAC,kBAAkB,EAAE,CAAC;gBACjG,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC;gBAC7C,GAAG,CAAC,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;aACjE,CAAC,CAAC;YACH,IAAI,CAAC,CAAC,IAAI;gBAAE,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;iBACxD,CAAC;gBACJ,MAAM,GAAG,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,QAAQ,CAAC;gBAC/C,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;gBAC3E,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;oBAC7B,MAAM,MAAM,GACV,CAAC,CAAC,KAAK,KAAK,SAAS;wBACnB,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE;wBACzB,CAAC,CAAC,CAAC,CAAC,OAAO,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;4BAC7C,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;4BAClE,CAAC,CAAC,EAAE,CAAC;oBACX,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,GAAG,MAAM,IAAI,CAAC,CAAC;gBAC3F,CAAC;gBACD,4FAA4F;gBAC5F,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,IAAI,MAAM,CAAC,KAAK,CAAC,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,WAAW,GAAG,CAAC,EAAE,CAAC;oBACxF,GAAG,EAAE,CAAC,WAAW,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBACtD,CAAC;gBACD,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,KAAK,SAAS;oBAAE,GAAG,EAAE,CAAC,WAAW,MAAM,CAAC,MAAM,CAAC,QAAQ,IAAI,CAAC,CAAC;gBACvF,wFAAwF;gBACxF,qFAAqF;gBACrF,MAAM,QAAQ,GACZ,MAAM,CAAC,QAAQ,KAAK,CAAC;oBACnB,CAAC,CAAC,SAAS,MAAM,CAAC,OAAO,CAAC,cAAc,oBAAoB;oBAC5D,CAAC,CAAC,MAAM,CAAC,QAAQ,KAAK,CAAC;wBACrB,CAAC,CAAC,SAAS,MAAM,CAAC,OAAO,CAAC,cAAc,oBAAoB;wBAC5D,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;4BACzB,CAAC,CAAC,UAAU,MAAM,CAAC,OAAO,CAAC,MAAM,mBAAmB,MAAM,CAAC,MAAM,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,oBAAoB,EAAE;4BACtH,CAAC,CAAC,iBAAiB,MAAM,CAAC,MAAM,CAAC,QAAQ,IAAI,+CAA+C,EAAE,CAAC;gBACvG,GAAG,EAAE,CAAC,GAAG,QAAQ,MAAM,MAAM,CAAC,QAAQ,IAAI,CAAC,CAAC;gBAC5C,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC,CAAC,8FAA8F,CAAC,CAAC,CAAC,yBAAyB,CAAC,CAAC;gBACtK,OAAO,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;YACrC,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IACE,GAAG,YAAY,UAAU;gBACzB,GAAG,YAAY,mBAAmB;gBAClC,GAAG,YAAY,iBAAiB;gBAChC,GAAG,YAAY,gBAAgB;gBAC/B,GAAG,YAAY,iBAAiB,EAChC,CAAC;gBACD,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;YAC9D,CAAC;iBAAM,IAAI,GAAG,YAAY,sBAAsB,IAAI,CAAC,GAAG,YAAY,KAAK,IAAI,GAAG,CAAC,IAAI,KAAK,uBAAuB,CAAC,EAAE,CAAC;gBACnH,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,qBAAqB,EAAE,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;YAC3E,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;YACpG,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/check-execute.d.ts

@@ -0,0 +1,29 @@
+import { type ConsolidatedDefect } from "@jevitate/findings";
+import { type EngineInfo } from "./engine.js";
+import { type CheckGateways, type CheckRunners, type RunCheckOptions } from "./check-types.js";
+import { type Planned } from "./check-plan.js";
+export interface Executed {
+    readonly status: "ran" | "error";
+    readonly resultPath?: string;
+    readonly outcome?: string;
+    readonly goalOutcome?: string;
+    readonly actions: number;
+    readonly error?: {
+        type: string;
+        message: string;
+    };
+}
+export interface ExecContext {
+    readonly opts: RunCheckOptions;
+    readonly runners: CheckRunners;
+    readonly resultsDir: string;
+    readonly gateways: () => Promise<CheckGateways>;
+    readonly engine: EngineInfo;
+    readonly seq: () => string;
+}
+/**
+ * #293: a journey-anchored mission item runs between the target's fixture setup and restore (as a
+ * Journey item does), so one stop point's side effects never leak into the next of a sweep.
+ */
+export declare function execute(item: Planned, ctx: ExecContext, remaining: number | undefined): Promise<Executed>;
+export declare function caseDetail(defects: readonly ConsolidatedDefect[]): string;