@jevitate/cli 0.12.0 → 0.14.0

package/dist/ux-usability/analysis.js

@@ -0,0 +1,106 @@
+// ux-usability/analysis.ts — phase 3 of `runUsabilityMission` (#500): signals, probes, evidence sidecar, claim analysis.
+import { mkdir, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { a11yChecks, analyzeClaims, detectFriction, detectSignals, loadV1Rubric, persistableScreen } from "@jevitate/ux";
+import { captureFindingShots, planGuardProbes, runGuardProbes, skippedProbes, withProbePage } from "../ux-claim-probe.js";
+import { DEFAULT_JUDGMENT_BUDGET, extractTypedValues } from "../ux-evidence.js";
+/**
+ * Phase 3 — evidence & analysis: the run's signal findings and friction, the guard probes, the
+ * evidence sidecar (written before analysis) and the claim analysis with its finding screenshots.
+ */
+export async function analyzeUsabilityRun(ctx, loop) {
+    const { opts, collected, overflowFindings, capture, secrets, session, outDir, stamp, product } = ctx;
+    const { run } = loop;
+    // #85 item 1: the live run's own typed values (from its emitted Recording's fill/select
+    // steps — never a secret), so the vocabulary/jargon tier can tell the app's own copy apart
+    // from user-authored content it merely echoed back (same mechanism as the offline pass).
+    const typedValues = extractTypedValues(run.recording);
+    const screens = typedValues.length > 0 ? collected.map((ev) => ({ ...ev, typedValues })) : collected;
+    // #96: findings from the run's own measurements (hung request, duplicate write, internal id,
+    // inert control) — independent code, no model — reported alongside the rubric's.
+    const signalCapture = await capture.signalCapture(run.transcript, typedValues);
+    // A gRPC-web/Connect read is never a duplicate write (#110); `--read-rpc` marks more reads.
+    const readRequests = opts.target?.safety?.readRequests;
+    const signalFindings = [
+        ...detectSignals(signalCapture, readRequests === undefined ? opts.signals : { ...opts.signals, readRequests }),
+        // #149: horizontal-overflow, computed live during the run (never from the captured timeline).
+        ...overflowFindings,
+    ];
+    // #132: the friction the run walked into — what grounds (or not) each rubric finding.
+    const friction = detectFriction(signalCapture, run.outcome);
+    // #198: every destructive control on an analyzed screen is clicked once with its writes blocked
+    // (ux-claim-probe.ts) — the code evidence `destructive-unguarded` claims are verified against.
+    // On a dedicated page in the run's context, after the loop: the run's oracles never see it.
+    // A screen that cannot be redacted means no probes at all (destructive claims: unverifiable).
+    let probes;
+    try {
+        const plan = planGuardProbes(screens, secrets, opts.target?.safety);
+        probes = [...plan.refused];
+        // Clicking is opt-in (--probe-guards): without it every destructive control is `skipped`, and
+        // its guard claim is reported unverifiable — never asserted, never silently dropped.
+        if (opts.probeGuards !== true)
+            probes.push(...skippedProbes(plan.targets));
+        else if (plan.targets.length > 0) {
+            try {
+                probes.push(...(await runGuardProbes(session.page, plan.targets, { allowlist: opts.allowlist, secrets })));
+            }
+            catch (err) {
+                const why = `the guard probe could not open a page: ${err instanceof Error ? err.message.split("\n")[0] : String(err)}`;
+                probes.push(...plan.targets.map((t) => ({ screenId: t.screen.screenId, route: t.route, control: t.label, controlKey: t.key, status: "failed", detail: why })));
+            }
+        }
+    }
+    catch {
+        probes = undefined;
+    }
+    // #134: the evidence sidecar, written through the redaction door BEFORE analysis (so it exists
+    // even when analysis fails). Fail-closed: if any screen cannot be redacted, no file is written.
+    const evidencePath = join(outDir, `usability-${stamp}.evidence.json`);
+    let evidenceWritten = null;
+    try {
+        const file = {
+            version: 1,
+            appContext: opts.appContext,
+            job: opts.job,
+            screens: screens.map((ev) => persistableScreen(ev, secrets)),
+            signals: signalCapture,
+            outcome: run.outcome,
+            ...(probes === undefined ? {} : { probes }),
+        };
+        await mkdir(outDir, { recursive: true });
+        await writeFile(evidencePath, `${JSON.stringify(file, null, 2)}\n`, "utf8");
+        evidenceWritten = evidencePath;
+    }
+    catch {
+        evidenceWritten = null;
+    }
+    // #198: findings are claims verified by code (claims.ts) — guard probes, product facts and the
+    // friction the run walked into — categorized and graded by Jev, written from templates.
+    const claimed = await analyzeClaims({
+        screens,
+        rubric: loadV1Rubric(),
+        appContext: opts.appContext,
+        secrets,
+        judgmentBudget: opts.judgmentBudget ?? DEFAULT_JUDGMENT_BUDGET,
+        friction,
+        steps: signalCapture.steps,
+        signalFindings,
+        ...(probes === undefined ? {} : { probes }),
+        ...(product.facts === undefined ? {} : { facts: product.facts }),
+    }, { judge: opts.judge, gen: opts.gen, a11yChecker: a11yChecks, ...(opts.polish === true ? { polish: true } : {}) });
+    // #198: a cropped, masked screenshot with the cited control boxed, per verified claim finding.
+    let outcome = claimed;
+    if (claimed.kind === "analyzed" && claimed.findings.some((f) => f.claim !== undefined)) {
+        const byScreen = new Map(screens.map((ev) => [ev.screenId, ev]));
+        const dir = join(outDir, `usability-${stamp}.findings`);
+        try {
+            const findings = await withProbePage(session.page, (p) => captureFindingShots(p, claimed.findings, byScreen, { dir, allowlist: opts.allowlist, secrets }));
+            outcome = { ...claimed, findings };
+        }
+        catch {
+            outcome = claimed; // presentation only: findings without screenshots are still the findings
+        }
+    }
+    return { signalFindings, friction, outcome, evidenceWritten };
+}
+//# sourceMappingURL=analysis.js.map

package/dist/ux-usability/analysis.js.map

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

package/dist/ux-usability/done-adjudication.d.ts

@@ -0,0 +1,15 @@
+import { type HangFinding } from "@jevitate/explore";
+import { type MissionFailure } from "@jevitate/domain";
+import type { UsabilitySetup } from "./setup.js";
+import type { UsabilityLoop } from "./loop.js";
+/**
+ * Phase 5 — done adjudication: the job's verdict from the loop's stop, its outcome (was the job
+ * completed / verified?) and its success checks, then the host-health fold. The ONE place the
+ * mission decides whether the job under review was done (#209/#213/#225).
+ */
+export declare function adjudicateUsabilityJob(ctx: UsabilitySetup, loop: UsabilityLoop, hang: HangFinding | undefined): Promise<{
+    host: import("../host-health-run.js").HostHealthVerdict<"clean" | "pending-review" | "defects-found" | "hang" | "intermittent" | "inconclusive" | "crashed">;
+    runOutcome: "clean" | "pending-review" | "defects-found" | "hang" | "intermittent" | "inconclusive" | "crashed";
+    jobFailure: MissionFailure | undefined;
+}>;
+export type UsabilityVerdict = Awaited<ReturnType<typeof adjudicateUsabilityJob>>;

package/dist/ux-usability/done-adjudication.js

@@ -0,0 +1,56 @@
+// ux-usability/done-adjudication.ts — phase 5 of `runUsabilityMission` (#500): was the job done? The mission's verdict.
+import { hangOutcome } from "@jevitate/explore";
+import { foldGoalOutcome } from "@jevitate/domain";
+import { finishHostHealth } from "../host-health-run.js";
+/**
+ * Phase 5 — done adjudication: the job's verdict from the loop's stop, its outcome (was the job
+ * completed / verified?) and its success checks, then the host-health fold. The ONE place the
+ * mission decides whether the job under review was done (#209/#213/#225).
+ */
+export async function adjudicateUsabilityJob(ctx, loop, hang) {
+    const { health } = ctx;
+    const { run, adjudication } = loop;
+    // #150 — a declared mission spend budget crossed (or a paid action was refused before crossing
+    // it): a clean, deliberate stop, never `crashed` — but never `clean` either (the run's own work
+    // past the stop is unproven), so it maps to `inconclusive` the same as `run.stop === "inconclusive"`.
+    const loopOutcome = run.stop === "crashed"
+        ? "crashed"
+        : run.stop === "inconclusive" || run.stop === "budget"
+            ? "inconclusive"
+            : run.stop === "hang"
+                ? hangOutcome(hang?.reproduction.status ?? "inconclusive")
+                : "clean";
+    // #209: a review whose job was never completed (the loop gave up, ran out of budget, or its
+    // `done` was never verified) did not see what a user who finished it would: its silence about
+    // the rest proves nothing, so it is `inconclusive` (`job-incomplete`) — never `clean`, whatever
+    // the advisory UX findings say.
+    const jobIncomplete = loopOutcome === "clean" && run.outcome.status === "incomplete"
+        ? { kind: "job-incomplete", message: `the job under review was not completed: ${run.outcome.reason}` }
+        : undefined;
+    // #225: with success checks, THEY decide whether the job was done — folded exactly like a goal
+    // run's ending (a failed check `defects-found`, a vacuous one `inconclusive`, all held `clean`).
+    const checked = adjudication === undefined ? undefined : foldGoalOutcome(adjudication.outcome);
+    const jobVerdict = loopOutcome !== "clean" ? loopOutcome : checked !== undefined ? checked : jobIncomplete === undefined ? "clean" : "inconclusive";
+    // #225/#209: a failed success check is named as such (never "job-incomplete"), as on a goal run.
+    const failedChecks = adjudication?.checks.filter((c) => !c.passed) ?? [];
+    const checkFailure = adjudication?.failure ??
+        (failedChecks.length === 0
+            ? undefined
+            : { kind: "success-check-failed", message: `success check ${failedChecks.map((c) => `'${c.check}' ${c.detail}`).join("; ")}` });
+    const jobFailure = loopOutcome !== "clean" ? undefined : checked === undefined ? jobIncomplete : checked === "clean" ? undefined : (checkFailure ?? jobIncomplete);
+    // #203: most steps on a starved host → `inconclusive` (degraded-environment), never `clean`.
+    // #213: a job whose completion code verified (#225: its success checks held, or its done was
+    // adjudicated from save signals) is a positive proof — a starved host does not undo it. Only an
+    // unverified ending is downgraded, and it keeps its own reason (a failed check) in the degraded one.
+    // A model-only `grounded-judgment` is not code's proof, so it is still downgraded.
+    const jobVerified = jobVerdict === "clean" &&
+        (checked === "clean" || (checked === undefined && run.outcome.status === "completed" && run.outcome.verifiedBy !== "grounded-judgment"));
+    const host = await finishHostHealth(health, jobVerdict, {
+        verified: jobVerified,
+        ...(run.failure === undefined ? {} : { failure: run.failure }),
+        ...(jobFailure === undefined ? {} : { wouldHaveBeen: jobFailure.message }),
+    });
+    const runOutcome = host.outcome;
+    return { host, runOutcome, jobFailure };
+}
+//# sourceMappingURL=done-adjudication.js.map

package/dist/ux-usability/done-adjudication.js.map

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

package/dist/ux-usability/hang.d.ts

@@ -0,0 +1,5 @@
+import { type HangFinding } from "@jevitate/explore";
+import type { UsabilitySetup } from "./setup.js";
+import type { UsabilityLoop } from "./loop.js";
+/** Phase 4 — a run that stopped on a hang: reproduced in fresh contexts (`undefined` when it did not). */
+export declare function reproduceUsabilityHang(ctx: UsabilitySetup, run: UsabilityLoop["run"]): Promise<HangFinding | undefined>;

package/dist/ux-usability/hang.js

@@ -0,0 +1,41 @@
+// ux-usability/hang.ts — phase 4 of `runUsabilityMission` (#500): hang reproduction.
+import { journeyFixtureBaseDir } from "../journey-api.js";
+import { CastActor, BrowseTheWeb } from "@jevitate/screenplay";
+import { reproduceHang, hangFinding } from "@jevitate/explore";
+/**
+ * Opens a FRESH browser session for replays (hang reproduction): a new context from the same port
+ * and options — same authenticated storageState, never the session the finding was made in.
+ */
+function freshSessionOpener(portFactory, launch, allowlist) {
+    return async () => {
+        const session = await portFactory().open(launch);
+        const actor = CastActor.named("replay").whoCan(new BrowseTheWeb(session, [...allowlist]));
+        return { page: session.page, actor, close: () => session.close() };
+    };
+}
+/** Phase 4 — a run that stopped on a hang: reproduced in fresh contexts (`undefined` when it did not). */
+export async function reproduceUsabilityHang(ctx, run) {
+    const { opts, portFactory, launch } = ctx;
+    // #126: a run that stops on a hang is never `clean` — it is reproduced in fresh contexts (same
+    // as a goal mission) and mapped through the same hang/intermittent/inconclusive rule.
+    let hang;
+    if (run.stop === "hang" && run.hang !== undefined) {
+        const h = run.hang;
+        const reproduction = await reproduceHang({
+            recording: run.recording,
+            recordingStepIndex: h.recordingStepIndex,
+            hang: h.signal,
+            openSession: freshSessionOpener(portFactory, launch, opts.allowlist),
+            fixtureBaseDir: journeyFixtureBaseDir(),
+            ...(opts.target?.safety === undefined ? {} : { safety: opts.target.safety }),
+            writtenBy: run.sideEffects.map((e) => e.control), // #181
+            perceive: {
+                ...(opts.target?.settle === undefined ? {} : { settleConfig: opts.target.settle }),
+                ...(opts.target?.hangs === undefined ? {} : { hangConfig: opts.target.hangs }),
+            },
+        });
+        hang = hangFinding(h.signal, run.transcript, h.recordingStepIndex, reproduction);
+    }
+    return hang;
+}
+//# sourceMappingURL=hang.js.map

package/dist/ux-usability/hang.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hang.js","sourceRoot":"","sources":["../../src/ux-usability/hang.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAE1D,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,WAAW,EAAwC,MAAM,mBAAmB,CAAC;AAIrG;;;GAGG;AACH,SAAS,kBAAkB,CACzB,WAA8B,EAC9B,MAA0C,EAC1C,SAA4B;IAE5B,OAAO,KAAK,IAAI,EAAE;QAChB,MAAM,OAAO,GAAG,MAAM,WAAW,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACjD,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,YAAY,CAAC,OAAO,EAAE,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;QAC1F,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;IACrE,CAAC,CAAC;AACJ,CAAC;AAED,0GAA0G;AAC1G,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,GAAmB,EAAE,GAAyB;IACzF,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC;IAC1C,+FAA+F;IAC/F,sFAAsF;IACtF,IAAI,IAA6B,CAAC;IAClC,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAClD,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC;QACnB,MAAM,YAAY,GAAG,MAAM,aAAa,CAAC;YACvC,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,kBAAkB,EAAE,CAAC,CAAC,kBAAkB;YACxC,IAAI,EAAE,CAAC,CAAC,MAAM;YACd,WAAW,EAAE,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC;YACpE,cAAc,EAAE,qBAAqB,EAAE;YACvC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YAC5E,SAAS,EAAE,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,OAAO;YACzD,QAAQ,EAAE;gBACR,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;gBAClF,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;aAC/E;SACF,CAAC,CAAC;QACH,IAAI,GAAG,WAAW,CAAC,CAAC,CAAC,MAAM,EAAE,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC,kBAAkB,EAAE,YAAY,CAAC,CAAC;IACnF,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/ux-usability/loop.d.ts

@@ -0,0 +1,15 @@
+import { type GoalBasedResult, BudgetMonitor } from "@jevitate/explore";
+import type { UsabilitySetup } from "./setup.js";
+/**
+ * Phase 2 — the act loop: the Journey prefix (if any), the budget hooks, then the model-driven loop —
+ * through the goal mission's independent adjudication when `successChecks` were given, else
+ * `explore()` — and the drained server-log transcript, Recording and transcript written.
+ */
+export declare function runUsabilityLoop(ctx: UsabilitySetup): Promise<{
+    start: import("../journey-prefix.js").AnchoredStart;
+    budget: BudgetMonitor | null;
+    adjudication: GoalBasedResult | undefined;
+    run: import("@jevitate/explore").ExploreRun;
+    serverLogRun: import("../log-correlation.js").ServerLogRuntimeResult | undefined;
+}>;
+export type UsabilityLoop = Awaited<ReturnType<typeof runUsabilityLoop>>;

package/dist/ux-usability/loop.js

@@ -0,0 +1,104 @@
+// ux-usability/loop.ts — phase 2 of `runUsabilityMission` (#500): the model-driven act loop.
+import { journeyFixtureBaseDir } from "../journey-api.js";
+import { demoOverlayOf } from "../browser-run-options.js";
+import { CastActor, BrowseTheWeb } from "@jevitate/screenplay";
+import { explore, runGoalBasedMission, InvariantMonitor, BudgetMonitor } from "@jevitate/explore";
+import { conversationConfig } from "../conversation-options.js";
+import { startFromJourney } from "../journey-prefix.js";
+import { usabilityOnSnapshot } from "./observe.js";
+/**
+ * Phase 2 — the act loop: the Journey prefix (if any), the budget hooks, then the model-driven loop —
+ * through the goal mission's independent adjudication when `successChecks` were given, else
+ * `explore()` — and the drained server-log transcript, Recording and transcript written.
+ */
+export async function runUsabilityLoop(ctx) {
+    const { opts, session, origin, serverLog, journalListener, journal, health, uxSecretCommand, fixture, capture } = ctx;
+    // #293: a journey-anchored review first replays its Journey's prefix into this very session.
+    const start = await startFromJourney(opts.journeyPrefix, session, opts.url, opts.allowlist, opts.browser);
+    const actor = CastActor.named("usability-mission").whoCan(new BrowseTheWeb(session, [...opts.allowlist]));
+    // #150 — usability's own budget wiring: a plain `InvariantMonitor` reads a budget's declared
+    // observables (the same #86/#135 read/auth/redaction machinery), but this mission folds NO
+    // invariant defects — only a budget crossing can end the run early, via the same pre-action
+    // guard / post-settle hooks `explore()` offers every mission.
+    const budgetDecls = opts.invariants?.budget ?? [];
+    const invariantMonitor = opts.invariants === undefined || budgetDecls.length === 0
+        ? null
+        : new InvariantMonitor(opts.invariants, {
+            allowlist: opts.allowlist,
+            baseUrl: opts.url,
+            ...(opts.secrets === undefined ? {} : { secrets: opts.secrets }),
+            ...(opts.invariantAuthTokens === undefined ? {} : { authTokens: opts.invariantAuthTokens }),
+        });
+    const budget = invariantMonitor === null ? null : new BudgetMonitor(budgetDecls, invariantMonitor);
+    let budgetSettledSteps = 0;
+    const exploreCfg = {
+        ...(opts.target?.timing === undefined ? {} : { timingConfig: opts.target.timing }),
+        ...(opts.target?.settle === undefined ? {} : { settle: opts.target.settle }),
+        ...(opts.target?.hangs === undefined ? {} : { hangs: opts.target.hangs }),
+        ...(opts.target?.safety === undefined ? {} : { safety: opts.target.safety }),
+        onTranscriptEntry: serverLog?.onTranscriptEntry ?? journalListener,
+        onRecording: journal.onRecording,
+        // #303 (opt-in): action deltas, with Jev's advisory relevance labels.
+        ...(opts.actionDeltas === true ? { actionDeltas: { jev: true } } : {}),
+        hostHealth: health,
+        demoOverlay: demoOverlayOf(opts.browser),
+        ...(opts.secretFields === undefined ? {} : { secretFields: opts.secretFields }),
+        ...(uxSecretCommand === undefined ? {} : { secretCommand: uxSecretCommand }),
+        ...(opts.secretCommandAttempts === undefined ? {} : { secretCommandAttempts: opts.secretCommandAttempts }),
+        actor,
+        judge: opts.judge,
+        gen: opts.gen,
+        goal: opts.job,
+        allowlist: opts.allowlist,
+        startUrl: start.url,
+        ...(start.branch === undefined ? {} : { startInPlace: true }),
+        ...(start.restart === undefined ? {} : { restartAtStart: start.restart.restartAtStart }),
+        bounds: opts.bounds,
+        secrets: opts.secrets,
+        site: origin,
+        fixture,
+        fixtureRoot: journeyFixtureBaseDir(),
+        ...conversationConfig(opts.conversation),
+        onSnapshot: usabilityOnSnapshot(ctx),
+        ...(budget === null
+            ? {}
+            : {
+                onBeforeAction: async (info) => {
+                    const g = await budget.guard(session.page, info);
+                    return g.refuse ? { refuse: true, reason: g.reason ?? "budget guard refused the action" } : { refuse: false };
+                },
+                onSettled: async () => {
+                    budgetSettledSteps += 1;
+                    // The FIRST settled snapshot (before any action) is the budget's baseline.
+                    if (budgetSettledSteps === 1) {
+                        const b = await budget.baseline(session.page);
+                        return b.crossed ? { stop: true, reason: b.reason ?? "budget observable unreadable at run start" } : { stop: false };
+                    }
+                    const r = await budget.afterSettle(session.page, budgetSettledSteps);
+                    return r.crossed ? { stop: true, reason: r.reason ?? "mission budget crossed" } : { stop: false };
+                },
+            }),
+    };
+    const brief = "usability review: pursue the stated job as a plausible first-time user, using only what is on screen";
+    // #225: `--success` is never ignored — with checks the loop runs through the goal mission's
+    // independent adjudication (the same oracle, `held`/vacuous rules and verdict as a goal run).
+    const checks = opts.successChecks ?? [];
+    const adjudication = checks.length === 0
+        ? undefined
+        : await runGoalBasedMission({
+            ...exploreCfg,
+            missionBrief: brief,
+            successChecks: checks,
+            // #225: a `done` whose check failed on a job judged done ends the run — never the whole budget.
+            stopWhenJudgedDone: true,
+            ...(opts.successWhen === undefined ? {} : { successWhen: opts.successWhen }),
+            ...(opts.allowVacuousChecks === true ? { allowVacuousChecks: true } : {}),
+        });
+    const run = adjudication?.run ?? (await explore({ ...exploreCfg, missionContext: brief }));
+    // Never blocks the mission itself: the drain wait happens AFTER `explore()` returned.
+    const serverLogRun = serverLog === undefined ? undefined : await serverLog.finish(run.transcript);
+    journal.writeRecording(run.recording);
+    journal.writeTranscript(capture.withScreenshots(serverLogRun?.transcript ?? run.transcript));
+    return { start, budget, adjudication, run, serverLogRun };
+}
+//# sourceMappingURL=loop.js.map

package/dist/ux-usability/loop.js.map

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

package/dist/ux-usability/observe.d.ts

@@ -0,0 +1,7 @@
+import { type ExploreConfig } from "@jevitate/explore";
+import type { UsabilitySetup } from "./setup.js";
+/**
+ * Phase 2a — the act loop's `onSnapshot` hook: one screen's evidence per observation, its
+ * (secret-masked) screenshot and the overflow/clipping hard signals. Never gates the loop.
+ */
+export declare function usabilityOnSnapshot(ctx: UsabilitySetup): NonNullable<ExploreConfig["onSnapshot"]>;

package/dist/ux-usability/observe.js

@@ -0,0 +1,89 @@
+// ux-usability/observe.ts — the usability act loop's per-screen observation hook (#500).
+import { clippingSummary, detectClipping, detectOverflow, shouldCheckOverflow } from "@jevitate/explore";
+import { makeSignalFinding } from "@jevitate/ux";
+import { snapshotToEvidence } from "../ux-evidence.js";
+/**
+ * Phase 2a — the act loop's `onSnapshot` hook: one screen's evidence per observation, its
+ * (secret-masked) screenshot and the overflow/clipping hard signals. Never gates the loop.
+ */
+export function usabilityOnSnapshot(ctx) {
+    const { opts, extract, session, collected, history, capture, seenOverflow, overflowFindings, secrets } = ctx;
+    return async (snap) => {
+        let visibleText = "";
+        try {
+            visibleText = await extract(session);
+        }
+        catch {
+            visibleText = ""; // best-effort; the analyzer Skips visibleText items honestly
+        }
+        const ev = snapshotToEvidence(snap, visibleText, opts.appContext, opts.job, [...history]);
+        collected.push(ev);
+        history.push({ screenId: ev.screenId, url: ev.url });
+        // #98 the step's (secret-masked) screenshot; #96 the screen's facts for the signal oracles.
+        await capture.observe(snap, visibleText);
+        // #149: horizontal-overflow hard signal — pure DOM geometry, never a model judgment.
+        // Best-effort like visibleText extraction above: a detection failure never fails the mission.
+        try {
+            const vp = session.page.viewportSize();
+            if (shouldCheckOverflow(vp?.width, opts.overflow?.checkOverflow ?? false)) {
+                const overflow = await detectOverflow(session.page, {
+                    viewport: vp ?? { width: 1280, height: 720 },
+                    ...(opts.emulation?.device === undefined ? {} : { device: opts.emulation.device }),
+                    ...(opts.overflow?.toleranceCss === undefined ? {} : { toleranceCss: opts.overflow.toleranceCss }),
+                    ...(opts.overflow?.ignoreSelectors === undefined ? {} : { ignoreSelectors: opts.overflow.ignoreSelectors }),
+                    secrets,
+                });
+                if (overflow !== null && !seenOverflow.has(overflow.fingerprint)) {
+                    seenOverflow.add(overflow.fingerprint);
+                    overflowFindings.push(makeSignalFinding({
+                        kind: "horizontal-overflow",
+                        confidence: 0.9,
+                        url: ev.url,
+                        screenId: ev.screenId,
+                        observation: `${overflow.element.descriptor} overflows the ${overflow.viewport.width}px viewport by ${overflow.overflowPx}px on ${overflow.route}.`,
+                        userImpact: "Content extends past the visible viewport; a user on this device must discover and use horizontal scrolling to see it, and may miss it entirely.",
+                        recommendation: `Constrain ${overflow.element.descriptor} to the viewport width (e.g. a responsive layout, or an explicit scroll container) at ${overflow.viewport.width}px.`,
+                        controls: [overflow.element.descriptor],
+                        evidence: {
+                            kind: "horizontal-overflow",
+                            steps: [history.length],
+                            requests: [],
+                            detail: `scrollWidth exceeds innerWidth by ${overflow.overflowPx}px at a ${overflow.viewport.width}x${overflow.viewport.height} viewport`,
+                        },
+                    }));
+                }
+                // #302: text cut off vertically (a fixed-height box, or above the page top) — one finding per element.
+                const clipped = await detectClipping(session.page, {
+                    viewport: vp ?? { width: 1280, height: 720 },
+                    ...(opts.emulation?.device === undefined ? {} : { device: opts.emulation.device }),
+                    ...(opts.overflow?.ignoreSelectors === undefined ? {} : { ignoreSelectors: opts.overflow.ignoreSelectors }),
+                    secrets,
+                });
+                for (const c of clipped) {
+                    if (seenOverflow.has(c.fingerprint))
+                        continue;
+                    seenOverflow.add(c.fingerprint);
+                    overflowFindings.push(makeSignalFinding({
+                        kind: "vertical-clipping",
+                        confidence: 0.9,
+                        url: ev.url,
+                        screenId: ev.screenId,
+                        observation: c.cause === "overflow-hidden"
+                            ? `${c.element.descriptor} cuts off its text by ${c.clippedPx}px on ${c.route}: the content is taller than the box and overflow is hidden.`
+                            : `${c.element.descriptor} is cut off ${c.clippedPx}px above the top of the page on ${c.route}.`,
+                        userImpact: "Part of the text is cut off and no scroll position shows it: a user on this device cannot read it.",
+                        recommendation: c.cause === "overflow-hidden"
+                            ? `Let ${c.element.descriptor} grow with its content (min-height instead of height), make it scrollable, or truncate on purpose with line-clamp at ${c.viewport.width}px.`
+                            : `Give the container of ${c.element.descriptor} room for its wrapped content (no fixed height, or no wrapping) at ${c.viewport.width}px.`,
+                        controls: [c.element.descriptor],
+                        evidence: { kind: "vertical-clipping", steps: [history.length], requests: [], detail: clippingSummary(c) },
+                    }));
+                }
+            }
+        }
+        catch {
+            // Best-effort: the run's own explore loop is never held up or failed by this check.
+        }
+    };
+}
+//# sourceMappingURL=observe.js.map

package/dist/ux-usability/observe.js.map

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

package/dist/ux-usability/result.d.ts

@@ -0,0 +1,11 @@
+import type { HangFinding } from "@jevitate/explore";
+import type { RunUsabilityMissionResult } from "../ux-usability.js";
+import type { UsabilitySetup } from "./setup.js";
+import type { UsabilityLoop } from "./loop.js";
+import type { UsabilityAnalysis } from "./analysis.js";
+import type { UsabilityVerdict } from "./done-adjudication.js";
+/**
+ * Phase 6 — result: every context closed (videos finalized), the result's common fields, then the
+ * report (or the typed analysis-unavailable result), persisted and returned with its run evidence.
+ */
+export declare function writeUsabilityResult(ctx: UsabilitySetup, loop: UsabilityLoop, analysis: UsabilityAnalysis, hang: HangFinding | undefined, verdict: UsabilityVerdict): Promise<RunUsabilityMissionResult>;

package/dist/ux-usability/result.js

@@ -0,0 +1,113 @@
+// ux-usability/result.ts — phase 6 of `runUsabilityMission` (#500): the report and the typed, persisted result.
+import { writeFile } from "node:fs/promises";
+import { resolve as resolvePath } from "node:path";
+import { finalizeVideos } from "../browser-run-options.js";
+import { evidenceOf, withRunEvidence } from "../defect-evidence.js";
+import { buildReport, calibrationCaveat, claimsCaveat, groundFindings, withSignalFindings } from "@jevitate/ux";
+import { NO_PRODUCT_FACTS_CAVEAT } from "../ux-product.js";
+import { resultPathFor, writeMissionResult } from "../mission-journal.js";
+import { MISSION_RESULT_SCHEMA_VERSION, advisoryDefects, defectFields } from "../result-schema.js";
+import { missionExitCode } from "../mission-exit.js";
+import { branchFields } from "../journey-prefix.js";
+import { failureWithHostStarved } from "../host-health-run.js";
+import { currentEngineInfo } from "../engine.js";
+import { triageOf } from "../explore-shared.js";
+import { serverLogResult } from "../explore-api.js";
+import { UxAnalysisFailedError } from "../ux-review.js";
+/**
+ * Phase 6 — result: every context closed (videos finalized), the result's common fields, then the
+ * report (or the typed analysis-unavailable result), persisted and returned with its run evidence.
+ */
+export async function writeUsabilityResult(ctx, loop, analysis, hang, verdict) {
+    const { opts, runCapture, videoDir, closeSession, journal, collected, screenshotDir, capture, runUsage, http5xx, secrets, minConfidence, quality, maxFindingsPerRoute, product, reportPath } = ctx;
+    const { start, run, serverLogRun, budget, adjudication } = loop;
+    const { signalFindings, friction, outcome, evidenceWritten } = analysis;
+    const { host, runOutcome, jobFailure } = verdict;
+    // #245: every context closed (videos finalized) before the result naming them is written.
+    const shotFields = await runCapture.finish();
+    const videos = await finalizeVideos(videoDir, closeSession);
+    const base = {
+        schemaVersion: MISSION_RESULT_SCHEMA_VERSION,
+        strategy: "usability",
+        target: {
+            seedUrl: start.persistUrl,
+            allowlist: [...opts.allowlist],
+            ...(opts.storageState !== undefined ? { storageStatePath: resolvePath(opts.storageState) } : {}),
+        },
+        ...branchFields(start),
+        recordingPaths: [journal.recordingPath],
+        ...videos,
+        ...shotFields,
+        resultPath: resultPathFor(journal.recordingPath),
+        hangs: hang === undefined ? [] : [hang],
+        timing: run.timing,
+        stop: run.stop,
+        outcome: run.outcome,
+        ...(run.answer === undefined ? {} : { answer: run.answer }),
+        screensObserved: collected.length,
+        transcriptPath: journal.transcriptPath,
+        screenshotDir,
+        evidencePath: evidenceWritten,
+        screenshots: capture.screenshots(),
+        sideEffects: run.sideEffects,
+        ...(run.sideEffectsTruncated === undefined ? {} : { sideEffectsTruncated: run.sideEffectsTruncated }),
+        ...(run.safetyOverrides === undefined ? {} : { safetyOverrides: run.safetyOverrides }),
+        ...(run.actionDeltas === undefined ? {} : { actionDeltas: run.actionDeltas }),
+        engine: currentEngineInfo(),
+        ...(() => {
+            const f = failureWithHostStarved(host, run.failure ?? host.failure ?? jobFailure);
+            return f === undefined ? {} : { failure: f };
+        })(),
+        ...(run.crash === undefined ? {} : { crash: run.crash }),
+        finalUrl: run.finalUrl,
+        decisions: run.decisions,
+        actions: run.actions,
+        depth: run.depth,
+        ...(runUsage === undefined ? {} : { usage: runUsage.snapshot() }),
+        ...(hang === undefined ? {} : { hang }),
+        // #142 follow-up: reported but never gates `missionOutcome`/`exitCode` — a UX finding is
+        // always advisory, and a `server-log` defect here is treated the same way. So is an HTTP 5xx
+        // hard-signal defect (#208): listed with its fingerprint (verify-fix replays it), advisory here.
+        ...serverLogResult(serverLogRun),
+        ...defectFields([
+            ...http5xx.defects(run.transcript, run.recording.pages.flatMap((p) => p.steps)[0]?.step.kind === "navigate" ? 1 : 0).map((d) => ({ ...d, advisory: true })),
+            ...advisoryDefects(serverLogRun?.defects),
+        ]),
+        ...(budget === null ? {} : { budget: budget.trajectory() }),
+        ...(adjudication === undefined
+            ? {}
+            : {
+                goalOutcome: adjudication.outcome,
+                checks: adjudication.checks,
+                ...(adjudication.warnings === undefined ? {} : { checkWarnings: adjudication.warnings }),
+            }),
+        ...host.fields,
+    };
+    if (outcome.kind === "failed") {
+        // The analysis is the review's product: without it the review is inconclusive (never a
+        // fabricated clean report) — but the run's transcript is kept, and this is a typed result.
+        const why = new UxAnalysisFailedError(outcome.reason, outcome.screenId, outcome.rubricItemId).message;
+        const missionOutcome = runOutcome === "clean" ? "inconclusive" : runOutcome;
+        const unavailable = {
+            ...base,
+            report: null,
+            reportPath: null,
+            missionOutcome,
+            exitCode: missionExitCode(missionOutcome),
+            analysisUnavailable: why,
+        };
+        // Persisted like every other mission's typed result, so MCP `get_mission_result` can read it (#117).
+        return await withRunEvidence({ ...unavailable, resultPath: writeMissionResult(journal.recordingPath, missionOutcome, unavailable.exitCode, unavailable, runUsage) }, evidenceOf(opts, secrets), triageOf(opts, serverLogRun, secrets));
+    }
+    const report = buildReport(groundFindings(withSignalFindings(outcome, signalFindings), friction), {
+        minConfidence,
+        quality,
+        maxFindingsPerRoute,
+        ...(product.facts === undefined ? { evidenceCaveats: [NO_PRODUCT_FACTS_CAVEAT] } : {}),
+        calibrationCaveats: [calibrationCaveat(opts.appContext.appClass), claimsCaveat()],
+    });
+    await writeFile(reportPath, `${JSON.stringify(report, null, 2)}\n`, "utf8");
+    const reviewed = { ...base, report, reportPath, missionOutcome: runOutcome, exitCode: missionExitCode(runOutcome) };
+    return await withRunEvidence({ ...reviewed, resultPath: writeMissionResult(journal.recordingPath, runOutcome, reviewed.exitCode, reviewed, runUsage) }, evidenceOf(opts, secrets), triageOf(opts, serverLogRun, secrets));
+}
+//# sourceMappingURL=result.js.map