@jevitate/cli 0.2.0 → 0.4.0

package/dist/ux-claim-probe.d.ts

@@ -0,0 +1,45 @@
+import type { Page } from "playwright";
+import { type SafetyConfig } from "@jevitate/explore";
+import { type Control, type GuardProbe, type UxEvidence, type UxFinding } from "@jevitate/ux";
+/** At most this many controls are probed per run; the rest are recorded as not probed (unverifiable). */
+export declare const MAX_GUARD_PROBES = 25;
+/** Why nothing was clicked without the opt-in. */
+export declare const PROBE_OPT_IN_REASON = "not probed: clicking destructive controls is opt-in (--probe-guards)";
+/** The fail-safe destructive-request classifier, shared with the find-out guard (#270): one vocabulary. */
+export declare function looksDestructive(url: string, body?: string | null, method?: string): boolean;
+export interface ProbeTarget {
+    readonly screen: UxEvidence;
+    readonly control: Control;
+    /** Redacted `role "name"`. */
+    readonly label: string;
+    /** controlKey over the REDACTED role/name (what the claim pipeline matches on). */
+    readonly key: string;
+    readonly route: string;
+}
+/** The destructive controls to probe (one per route × control) and the ones a `--deny` pattern refuses. */
+export declare function planGuardProbes(screens: readonly UxEvidence[], secrets: readonly string[], safety?: SafetyConfig): {
+    readonly targets: ProbeTarget[];
+    readonly refused: GuardProbe[];
+};
+/** The opt-out record: every planned target is `skipped` (its guard claim: unverifiable). */
+export declare function skippedProbes(targets: readonly ProbeTarget[]): GuardProbe[];
+/**
+ * Probes each target, each on a fresh page in `runPage`'s context (call only with the opt-in).
+ * Never throws per target; a target that cannot be probed safely is `refused`/`failed`.
+ */
+export declare function runGuardProbes(runPage: Page, targets: readonly ProbeTarget[], opts: {
+    readonly allowlist: readonly string[];
+    readonly secrets: readonly string[];
+}): Promise<GuardProbe[]>;
+/**
+ * Cropped, masked, boxed screenshots for the verified claim findings (`finding.screenshot`). Best
+ * effort per finding: one that cannot be located or masked has none. Fails CLOSED on masking: if
+ * the pixel mask cannot be installed or proven, no screenshot is written.
+ */
+export declare function captureFindingShots(page: Page, findings: readonly UxFinding[], screens: ReadonlyMap<string, UxEvidence>, opts: {
+    readonly dir: string;
+    readonly allowlist: readonly string[];
+    readonly secrets: readonly string[];
+}): Promise<UxFinding[]>;
+/** Opens the dedicated probe page in the run's context; closing it deletes its video, if any. */
+export declare function withProbePage<T>(runPage: Page, fn: (page: Page) => Promise<T>): Promise<T>;

package/dist/ux-claim-probe.js

@@ -0,0 +1,386 @@
+// ux-claim-probe.ts — the CODE side of the UX claim pipeline (#198), on the live run's browser.
+//
+// 1. Guard probes — OPT-IN (`--probe-guards`). Without it nothing is clicked: every destructive
+//    control is recorded `skipped`, so its guard claim is reported unverifiable (coverage), never
+//    asserted and never silently dropped. With it, every control the shared safety policy calls
+//    DESTRUCTIVE (explore safety.ts's vocabulary) on an analyzed screen is clicked ONCE (per route ×
+//    control), each on a FRESH page in the run's context, fail-safe:
+//      - refused (→ unverifiable, reason recorded) when the page has an open WebSocket or
+//        EventSource, or a service worker controls it — writes over those cannot be blocked;
+//      - new WebSocket/EventSource connections are refused by the page once the probe is armed;
+//      - every request is aborted that is not GET/HEAD/OPTIONS, or whose URL (path or query) or body
+//        names a destructive verb (delete, remove, destroy, revoke, purge, archive… — also as an RPC
+//        name such as `DeleteUser`), whatever its method;
+//      - the page is closed as soon as a confirm/alert or a page dialog is observed: the probe never
+//        clicks anything inside a dialog (a native dialog is dismissed — cancel — then the page closes).
+//    It records whether a dialog or confirmation page guarded the click and which writes it
+//    attempted. A `--deny` control is never clicked (recorded `refused`).
+// 2. Finding screenshots: each verified claim finding with a cited control or quoted text gets a
+//    cropped, secret-masked screenshot (the run's pixel mask, demo-capture.ts) with the cited
+//    element boxed (no click; the same request blocker is active).
+//
+// Both run on DEDICATED pages in the run's own browser context (same session), after the run's
+// loop ended — never on the page the run's oracles listen to — and a probe page's video (if
+// recorded) is deleted.
+import { mkdir } from "node:fs/promises";
+import { join } from "node:path";
+import { SafetyPolicy, assertAuthorizedExploreTarget, controlRisk, endpointOf, looksDestructiveRequest, redactText, redactUrl } from "@jevitate/explore";
+import { descriptorToLocator } from "@jevitate/recorder";
+import { controlKey, redactEvidence, routeOf } from "@jevitate/ux";
+import { MaskUnavailableError, SecretPixelMask, captureStepScreenshot } from "./demo-capture.js";
+import { clock } from "@jevitate/domain";
+const SAFE_METHODS = new Set(["GET", "HEAD", "OPTIONS"]);
+const OPEN_DIALOGS = 'dialog[open], [role="dialog"], [role="alertdialog"], [aria-modal="true"]';
+const PROBE_TIMEOUT_MS = 8_000;
+/** At most this many controls are probed per run; the rest are recorded as not probed (unverifiable). */
+export const MAX_GUARD_PROBES = 25;
+const SETTLE_MS = 1_500;
+/** Why nothing was clicked without the opt-in. */
+export const PROBE_OPT_IN_REASON = "not probed: clicking destructive controls is opt-in (--probe-guards)";
+/** The fail-safe destructive-request classifier, shared with the find-out guard (#270): one vocabulary. */
+export function looksDestructive(url, body = null, method = "GET") {
+    return looksDestructiveRequest(method, url, body);
+}
+/** The destructive controls to probe (one per route × control) and the ones a `--deny` pattern refuses. */
+export function planGuardProbes(screens, secrets, safety) {
+    // Only the operator's --deny patterns refuse here: the built-in destructive category is exactly
+    // what the (opted-in) probe exists to click — fail-safe, its writes blocked.
+    const deny = new SafetyPolicy({ deny: safety?.deny ?? [], allowDestructive: true });
+    const seen = new Set();
+    const targets = [];
+    const refused = [];
+    for (const screen of screens) {
+        const red = redactEvidence(screen, secrets);
+        const route = routeOf(red.url);
+        screen.controls.forEach((c, i) => {
+            if (controlRisk(c.name, c.role)?.risk !== "destructive")
+                return;
+            const rc = red.controls[i];
+            const key = controlKey(rc);
+            if (seen.has(`${route}|${key}`))
+                return;
+            seen.add(`${route}|${key}`);
+            const label = `${rc.role || "control"} "${rc.name}"`;
+            const verdict = deny.refuses({ name: c.name, role: c.role, descriptor: c.descriptor ?? {} });
+            if (verdict !== null) {
+                refused.push({ screenId: screen.screenId, route, control: label, controlKey: key, status: "refused", detail: verdict.reason });
+                return;
+            }
+            targets.push({ screen, control: c, label, key, route });
+        });
+    }
+    return { targets, refused };
+}
+/** The opt-out record: every planned target is `skipped` (its guard claim: unverifiable). */
+export function skippedProbes(targets) {
+    return targets.map((t) => ({ screenId: t.screen.screenId, route: t.route, control: t.label, controlKey: t.key, status: "skipped", detail: PROBE_OPT_IN_REASON }));
+}
+function locatorFor(page, c) {
+    if (c.descriptor !== undefined)
+        return descriptorToLocator(page, c.descriptor);
+    return page.getByRole(c.role, { name: c.name, exact: true });
+}
+function errText(e) {
+    return (e instanceof Error ? e.message : String(e)).split("\n")[0].slice(0, 200);
+}
+/**
+ * Aborts every write and every destructive-looking request (see `looksDestructive`); records each
+ * one, in order. `allowDocument` is the screen's own URL: its load is let through.
+ */
+function writeBlocker(secrets, seq, allowDocument) {
+    const blocked = [];
+    const handler = async (route) => {
+        const req = route.request();
+        const method = req.method().toUpperCase();
+        let body = null;
+        try {
+            body = req.postData();
+        }
+        catch {
+            body = null;
+        }
+        const own = allowDocument?.() !== undefined && req.isNavigationRequest() && req.url() === allowDocument();
+        if (own || (SAFE_METHODS.has(method) && !looksDestructive(req.url(), body, method))) {
+            await route.continue().catch(() => undefined);
+            return;
+        }
+        blocked.push({ at: seq.n++, endpoint: redactText(redactUrl(endpointOf(method, req.url())), secrets) });
+        await route.abort("blockedbyclient").catch(() => undefined);
+    };
+    return { blocked, handler };
+}
+async function openDialogs(page) {
+    return page
+        .evaluate((sel) => Array.from(document.querySelectorAll(sel)).filter((el) => {
+        const r = el.getBoundingClientRect();
+        const st = getComputedStyle(el);
+        return r.width > 0 && r.height > 0 && st.visibility !== "hidden" && st.display !== "none";
+    }).length, OPEN_DIALOGS)
+        .catch(() => 0);
+}
+/**
+ * BROWSER (init script on a probe page): counts WebSocket/EventSource connections the page opens,
+ * and refuses new ones once `window.__jevProbeArmed` is set (just before the click).
+ */
+const CONNECTION_GUARD = `(() => {
+  const w = window;
+  w.__jevProbeConnections = 0;
+  for (const name of ["WebSocket", "EventSource"]) {
+    const Orig = w[name];
+    if (typeof Orig !== "function") continue;
+    const Wrapped = function (...args) {
+      if (w.__jevProbeArmed) throw new Error("jevitate guard probe: " + name + " refused while probing");
+      w.__jevProbeConnections += 1;
+      return new Orig(...args);
+    };
+    Wrapped.prototype = Orig.prototype;
+    for (const k of ["CONNECTING", "OPEN", "CLOSING", "CLOSED"]) if (k in Orig) Object.defineProperty(Wrapped, k, { value: Orig[k] });
+    w[name] = Wrapped;
+  }
+})();`;
+/** Why the page cannot be probed safely (a channel whose writes the probe cannot block), or null. */
+async function unsafeChannel(page, sockets) {
+    const state = await page
+        .evaluate(() => {
+        const w = window;
+        return { connections: w.__jevProbeConnections ?? 0, sw: typeof navigator.serviceWorker !== "undefined" && navigator.serviceWorker.controller !== null };
+    })
+        .catch(() => null);
+    if (state === null)
+        return "the page's connections could not be inspected";
+    if (sockets > 0)
+        return "the page has an open WebSocket (its messages cannot be blocked)";
+    if (state.connections > 0)
+        return "the page opened a WebSocket or EventSource (its messages cannot be blocked)";
+    if (state.sw)
+        return "a service worker controls the page (its requests cannot be blocked)";
+    return null;
+}
+/** Opens a fresh probe page in `runPage`'s context; `close()` closes it and deletes its video. */
+async function openProbePage(runPage) {
+    const page = await runPage.context().newPage();
+    let closed = false;
+    return {
+        page,
+        close: async () => {
+            if (closed)
+                return;
+            closed = true;
+            const video = page.video();
+            await page.close().catch(() => undefined);
+            await video?.delete().catch(() => undefined);
+        },
+    };
+}
+/**
+ * Probes each target, each on a fresh page in `runPage`'s context (call only with the opt-in).
+ * Never throws per target; a target that cannot be probed safely is `refused`/`failed`.
+ */
+export async function runGuardProbes(runPage, targets, opts) {
+    const out = [];
+    for (const [i, t] of targets.entries()) {
+        const base = { screenId: t.screen.screenId, route: t.route, control: t.label, controlKey: t.key };
+        if (i >= MAX_GUARD_PROBES) {
+            out.push({ ...base, status: "failed", detail: `not probed: the run's probe cap (${MAX_GUARD_PROBES} controls) was reached` });
+            continue;
+        }
+        let probe;
+        try {
+            assertAuthorizedExploreTarget(t.screen.url, opts.allowlist);
+            probe = await openProbePage(runPage);
+            const page = probe.page;
+            const seq = { n: 0 };
+            let screenUrl = t.screen.url;
+            const { blocked, handler } = writeBlocker(opts.secrets, seq, () => screenUrl);
+            const dialogs = [];
+            let sockets = 0;
+            page.on("websocket", () => {
+                sockets += 1;
+            });
+            page.on("dialog", (d) => {
+                dialogs.push({ at: seq.n++, type: d.type() });
+                // Cancel — never accept: the probe never confirms anything. The page is closed right after.
+                void d.dismiss().catch(() => undefined);
+            });
+            await page.addInitScript({ content: CONNECTION_GUARD });
+            await page.route("**/*", handler);
+            await page.goto(t.screen.url, { waitUntil: "domcontentloaded", timeout: PROBE_TIMEOUT_MS });
+            await page.waitForLoadState("networkidle", { timeout: 2_000 }).catch(() => undefined);
+            screenUrl = undefined; // from here on, even a reload of the screen goes through the blocker
+            const loc = locatorFor(page, t.control).first();
+            if (!(await loc.isVisible().catch(() => false))) {
+                out.push({ ...base, status: "not-found", detail: "the control was not visible on a fresh load of its screen (it may need state the run built up)" });
+                continue;
+            }
+            const unsafe = await unsafeChannel(page, sockets);
+            if (unsafe !== null) {
+                out.push({ ...base, status: "refused", detail: `not probed: ${unsafe}` });
+                continue;
+            }
+            await page.evaluate(() => {
+                window.__jevProbeArmed = true;
+            });
+            const before = await openDialogs(page);
+            // Anything the page load itself sent is not the click's.
+            blocked.length = 0;
+            dialogs.length = 0;
+            const startUrl = page.url().split("#")[0];
+            await loc.click({ timeout: 3_000 });
+            let domDialog = false;
+            for (let waited = 0; waited < SETTLE_MS && blocked.length === 0 && dialogs.length === 0 && !domDialog; waited += 100) {
+                await clock.sleep(100);
+                domDialog = (await openDialogs(page)) > before;
+            }
+            // A dialog was observed: stop here — the page closes without anything inside it being clicked.
+            const sawDialog = dialogs.length > 0 || domDialog;
+            if (!sawDialog) {
+                await clock.sleep(150);
+                domDialog = (await openDialogs(page)) > before;
+            }
+            const navigated = !page.isClosed() && page.url().split("#")[0] !== startUrl;
+            const lateSocket = sockets > 0;
+            await probe.close();
+            const firstWrite = blocked[0]?.at ?? Number.POSITIVE_INFINITY;
+            const firstDialog = dialogs[0]?.at ?? Number.POSITIVE_INFINITY;
+            // A write attempted before any native dialog was NOT guarded by it (a confirm blocks the write
+            // until answered; the probe cancels it, so a guarded action never writes).
+            const guard = blocked.length > 0 && firstWrite < firstDialog ? "none" : dialogs.length > 0 ? "native-dialog" : domDialog ? "dom-dialog" : navigated && blocked.length === 0 ? "navigation" : "none";
+            if (lateSocket && guard === "none") {
+                out.push({ ...base, status: "refused", detail: "not judged: the click opened a WebSocket (its messages cannot be blocked)" });
+                continue;
+            }
+            const writes = [...new Set(blocked.map((b) => b.endpoint))];
+            out.push({
+                ...base,
+                status: "probed",
+                guard,
+                blockedWrites: writes,
+                detail: guard === "none"
+                    ? writes.length > 0
+                        ? `no guard: the click attempted ${writes.join(", ")} (aborted by the probe)`
+                        : "no guard and no write attempted"
+                    : `guarded by ${guard === "native-dialog" ? `a native ${dialogs[0]?.type ?? "dialog"} (cancelled)` : guard === "dom-dialog" ? "a dialog on the page (left unanswered)" : "a navigation to another page"}`,
+            });
+        }
+        catch (e) {
+            out.push({ ...base, status: "failed", detail: redactText(`the probe could not click it: ${errText(e)}`, opts.secrets) });
+        }
+        finally {
+            await probe?.close();
+        }
+    }
+    return out;
+}
+const PAD = 48;
+const QUOTE_ATTR = "data-jevitate-quote";
+/** BROWSER: wraps the first text-node occurrence of `q` under `el` in an inline marker span. */
+function wrapQuote(el, q) {
+    const walker = document.createTreeWalker(el, NodeFilter.SHOW_TEXT);
+    for (let n = walker.nextNode(); n !== null; n = walker.nextNode()) {
+        const at = (n.nodeValue ?? "").indexOf(q);
+        if (at < 0)
+            continue;
+        const range = document.createRange();
+        range.setStart(n, at);
+        range.setEnd(n, at + q.length);
+        const span = document.createElement("span");
+        span.setAttribute("data-jevitate-quote", "");
+        range.surroundContents(span);
+        return true;
+    }
+    return false;
+}
+/**
+ * Cropped, masked, boxed screenshots for the verified claim findings (`finding.screenshot`). Best
+ * effort per finding: one that cannot be located or masked has none. Fails CLOSED on masking: if
+ * the pixel mask cannot be installed or proven, no screenshot is written.
+ */
+export async function captureFindingShots(page, findings, screens, opts) {
+    const mask = new SecretPixelMask(opts.secrets);
+    try {
+        await mask.install(page);
+    }
+    catch (e) {
+        if (e instanceof MaskUnavailableError)
+            return [...findings];
+        throw e;
+    }
+    const seq = { n: 0 };
+    let current;
+    const { handler } = writeBlocker(opts.secrets, seq, () => current);
+    await page.route("**/*", handler);
+    const out = [];
+    let n = 0;
+    try {
+        for (const f of findings) {
+            const screen = screens.get(f.screenId);
+            if (f.claim === undefined || screen === undefined) {
+                out.push(f);
+                continue;
+            }
+            const ref = f.evidenceRefs.find((r) => r.id.startsWith("control:"));
+            const control = ref === undefined ? undefined : screen.controls.find((c) => `control:${c.index}` === ref.id);
+            const quote = f.quotes[0];
+            if (control === undefined && quote === undefined) {
+                out.push(f);
+                continue;
+            }
+            try {
+                assertAuthorizedExploreTarget(screen.url, opts.allowlist);
+                current = screen.url;
+                await page.goto(screen.url, { waitUntil: "domcontentloaded", timeout: PROBE_TIMEOUT_MS });
+                current = undefined;
+                await page.waitForLoadState("networkidle", { timeout: 2_000 }).catch(() => undefined);
+                let loc = (control !== undefined ? locatorFor(page, control) : page.getByText(quote.slice(0, 120), { exact: false })).first();
+                if (!(await loc.isVisible().catch(() => false))) {
+                    out.push(f);
+                    continue;
+                }
+                // A quote is boxed tightly: its text is wrapped in an inline marker on this throwaway page
+                // (a block element's box would span the page). Falls back to the element.
+                if (control === undefined && (await loc.evaluate(wrapQuote, quote.slice(0, 120)).catch(() => false))) {
+                    loc = page.locator(`[${QUOTE_ATTR}]`).first();
+                }
+                await loc.scrollIntoViewIfNeeded({ timeout: 2_000 });
+                const bb = await loc.boundingBox();
+                const vp = page.viewportSize() ?? { width: 1280, height: 720 };
+                if (bb === null) {
+                    out.push(f);
+                    continue;
+                }
+                const x = Math.max(0, Math.floor(bb.x - PAD));
+                const y = Math.max(0, Math.floor(bb.y - PAD));
+                const clip = { x, y, width: Math.max(1, Math.min(vp.width - x, Math.ceil(bb.width + 2 * PAD))), height: Math.max(1, Math.min(vp.height - y, Math.ceil(bb.height + 2 * PAD))) };
+                await mask.highlightLocator(page, loc);
+                await mkdir(opts.dir, { recursive: true });
+                n += 1;
+                const path = join(opts.dir, `finding-${n}.png`);
+                await captureStepScreenshot(page, path, { step: 0 }, [mask.layer()], clip);
+                await mask.clearHighlight(page);
+                const target = f.claim.target ?? (control !== undefined ? f.controls[0] ?? control.name : `text ${JSON.stringify(quote.slice(0, 80))}`);
+                const screenshot = { path, target, box: { x: Math.round(bb.x - x), y: Math.round(bb.y - y), width: Math.round(bb.width), height: Math.round(bb.height) } };
+                out.push(Object.freeze({ ...f, screenshot }));
+            }
+            catch {
+                out.push(f); // presentation only: a finding without a screenshot is still the finding
+            }
+        }
+    }
+    finally {
+        await page.unroute("**/*", handler).catch(() => undefined);
+    }
+    return out;
+}
+/** Opens the dedicated probe page in the run's context; closing it deletes its video, if any. */
+export async function withProbePage(runPage, fn) {
+    const page = await runPage.context().newPage();
+    try {
+        return await fn(page);
+    }
+    finally {
+        const video = page.video();
+        await page.close().catch(() => undefined);
+        await video?.delete().catch(() => undefined);
+    }
+}
+//# sourceMappingURL=ux-claim-probe.js.map

package/dist/ux-claim-probe.js.map

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

package/dist/ux-cli.js

@@ -5,7 +5,7 @@ import { ok, fail } from "./envelope.js";
 import { withEngine } from "./engine.js";
 import { discoverRecordingSidecars, loadRecordingSidecars, runUxReview, UxAnalysisFailedError } from "./ux-api.js";
 import { UxConfigError } from "./ux-config.js";
-import { MinConfidenceError, QualityPolicyError, MaxFindingsPerRouteError } from "@jevitate/ux";
+import { MinConfidenceError, QualityPolicyError, MaxFindingsPerRouteError, ProductFactsError } from "@jevitate/ux";
 import { emitJson, GatewaySelectionError, buildExploreGateways } from "./cli-shared.js";
 /** Registers `jevitate ux <recording>`. */
 export function registerUxCommands(program, deps) {
@@ -24,6 +24,8 @@ export function registerUxCommands(program, deps) {
         .option("--out <dir>", "directory to write the UX report")
         .option("--result <file>", "mission result JSON (as written alongside the Recording by `jevitate explore`) — supplies blocked/disabled-target evidence the Recording alone cannot carry; default: <stem>.result.json, else <stem>.transcript.json, next to the Recording")
         .option("--evidence <file>", "a live usability run's evidence sidecar (screens as analyzed + run signals); default: <stem>.evidence.json next to the Recording — with it, offline review reproduces the live run's findings")
+        .option("--product <file>", "product facts JSON (plans/prices, key journeys, each page's intended next step) the review checks screens against in code; default .jevitate/product.json in the project when present (docs/ux-findings.md)")
+        .option("--polish", "polish each verified finding's recommendation with one generation call (opt-in; the default prose is built from templates)")
         .option("--real", "use live Jev gateways (requires keys)", false)
         .option("--fake-ai", "use deterministic fake gateways", false)
         .option("--json", "emit a JSON envelope")
@@ -81,6 +83,8 @@ export function registerUxCommands(program, deps) {
                 ...(o.minConfidence !== undefined ? { minConfidence: o.minConfidence } : {}),
                 ...(o.show !== undefined ? { show: o.show } : {}),
                 ...(o.maxFindingsPerPage !== undefined ? { maxFindingsPerRoute: o.maxFindingsPerPage } : {}),
+                ...(o.product !== undefined ? { product: o.product } : {}),
+                ...(o.polish === true ? { polish: true } : {}),
                 outDir: o.out,
                 ...sidecars,
             });
@@ -90,6 +94,9 @@ export function registerUxCommands(program, deps) {
             if (err instanceof UxAnalysisFailedError) {
                 emitJson(program, fail("E_UX_ANALYSIS", err.message));
             }
+            else if (err instanceof ProductFactsError) {
+                emitJson(program, fail(err.code, err.message));
+            }
             else if (err instanceof MinConfidenceError || err instanceof QualityPolicyError || err instanceof MaxFindingsPerRouteError || err instanceof UxConfigError) {
                 emitJson(program, fail("E_UX_ARGS", err.message));
             }

package/dist/ux-cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"ux-cli.js","sourceRoot":"","sources":["../src/ux-cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,OAAO,EAAE,eAAe,EAAkB,MAAM,qBAAqB,CAAC;AACtE,OAAO,EAAE,sBAAsB,EAAwD,MAAM,mBAAmB,CAAC;AACjH,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACnH,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAChG,OAAO,EAAgB,QAAQ,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAEtG,2CAA2C;AAC3C,MAAM,UAAU,kBAAkB,CAAC,OAAgB,EAAE,IAAa;IAChE,2EAA2E;IAC3E,4EAA4E;IAC5E,mDAAmD;IACnD,OAAO;SACJ,OAAO,CAAC,gBAAgB,CAAC;SACzB,WAAW,CAAC,2EAA2E,CAAC;SACxF,MAAM,CAAC,qBAAqB,EAAE,oEAAoE,CAAC;SACnG,MAAM,CACL,iBAAiB,EACjB,ySAAyS,CAC1S;SACA,MAAM,CACL,sBAAsB,EACtB,kWAAkW,CACnW;SACA,MAAM,CACL,6BAA6B,EAC7B,uPAAuP,CACxP;SACA,MAAM,CAAC,eAAe,EAAE,kCAAkC,CAAC;SAC3D,MAAM,CAAC,cAAc,EAAE,+CAA+C,CAAC;SACvE,MAAM,CAAC,aAAa,EAAE,kCAAkC,CAAC;SACzD,MAAM,CACL,iBAAiB,EACjB,8OAA8O,CAC/O;SACA,MAAM,CACL,mBAAmB,EACnB,+LAA+L,CAChM;SACA,MAAM,CAAC,QAAQ,EAAE,uCAAuC,EAAE,KAAK,CAAC;SAChE,MAAM,CAAC,WAAW,EAAE,iCAAiC,EAAE,KAAK,CAAC;SAC7D,MAAM,CAAC,QAAQ,EAAE,sBAAsB,CAAC;SACxC,MAAM,CAAC,KAAK,WAA0B,aAAqB;QAC1D,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,EAaf,CAAC;QACL,IAAI,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;YAChB,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,yBAAyB,CAAC,CAAC,CAAC;YAChE,OAAO;QACT,CAAC;QACD,IAAI,SAAoB,CAAC;QACzB,IAAI,CAAC;YACH,SAAS,GAAG,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;QACvF,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,mFAAmF;YACnF,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YACxF,OAAO;QACT,CAAC;QACD,6FAA6F;QAC7F,2FAA2F;QAC3F,wFAAwF;QACxF,wBAAwB;QACxB,MAAM,KAAK,GAAG,yBAAyB,CAAC,aAAa,CAAC,CAAC;QACvD,MAAM,QAAQ,GAAG,MAAM,qBAAqB,CAAC;YAC3C,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,IAAI,KAAK,CAAC,YAAY,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,QAAQ,IAAI,KAAK,CAAC,YAAY,EAAE,CAAC;YAC/G,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,KAAK,CAAC,UAAU,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,MAAM,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;YACrG,GAAG,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,IAAI,KAAK,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,KAAK,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAClH,CAAC,CAAC;QACH,IAAI,OAAqB,CAAC;QAC1B,IAAI,KAAqB,CAAC;QAC1B,IAAI,OAAqB,CAAC;QAC1B,IAAI,CAAC;YACH,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,MAAM,oBAAoB,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC;QAC5I,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,sBAAsB,IAAI,GAAG,YAAY,qBAAqB,EAAE,CAAC;gBAClF,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,qBAAqB,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;YAC9D,CAAC;iBAAM,CAAC;gBACN,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YAC1F,CAAC;YACD,OAAO;QACT,CAAC;QACD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC;gBAC/B,SAAS;gBACT,UAAU,EAAE;oBACV,QAAQ,EAAE,CAAC,CAAC,QAAQ;oBACpB,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC5C,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBACjC;gBACD,KAAK,EAAE,OAAO;gBACd,GAAG,EAAE,KAAK;gBACV,KAAK,EAAE,OAAO;gBACd,GAAG,CAAC,CAAC,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC5E,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACjD,GAAG,CAAC,CAAC,CAAC,kBAAkB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,mBAAmB,EAAE,CAAC,CAAC,kBAAkB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC5F,MAAM,EAAE,CAAC,CAAC,GAAG;gBACb,GAAG,QAAQ;aACZ,CAAC,CAAC;YACH,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,EAAE,GAAG,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;QACpE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,qBAAqB,EAAE,CAAC;gBACzC,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,eAAe,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;YACxD,CAAC;iBAAM,IAAI,GAAG,YAAY,kBAAkB,IAAI,GAAG,YAAY,kBAAkB,IAAI,GAAG,YAAY,wBAAwB,IAAI,GAAG,YAAY,aAAa,EAAE,CAAC;gBAC7J,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;YACpD,CAAC;iBAAM,CAAC;gBACN,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YACxF,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}
+{"version":3,"file":"ux-cli.js","sourceRoot":"","sources":["../src/ux-cli.ts"],"names":[],"mappings":"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"}

package/dist/ux-product.d.ts

@@ -0,0 +1,14 @@
+import { type ProductFacts } from "@jevitate/ux";
+import { type LayoutDeps } from "./project-dir.js";
+export declare const PRODUCT_FACTS_FILE = "product.json";
+export interface LoadedProductFacts {
+    readonly facts?: ProductFacts;
+    /** The file read, when one was. */
+    readonly path?: string;
+}
+/** The facts file to read: the flag, else `<project>/.jevitate/product.json` when present. */
+export declare function productFactsPath(flag: string | undefined, deps?: LayoutDeps): string | undefined;
+/** Reads and validates the product facts. Throws `ProductFactsError` for a missing/invalid file. */
+export declare function loadProductFacts(flag: string | undefined, deps?: LayoutDeps): Promise<LoadedProductFacts>;
+/** The report caveat when no facts were available (prices and intended next steps went unchecked). */
+export declare const NO_PRODUCT_FACTS_CAVEAT = "no product facts (.jevitate/product.json or --product): prices, trial lengths and each page's intended next step were not checked against the product's own facts (docs/ux-findings.md).";

package/dist/ux-product.js

@@ -0,0 +1,39 @@
+// ux-product.ts — finding and loading the product facts file for the UX review (#198).
+//
+// `--product <file>` wins; otherwise the project's `.jevitate/product.json` (found by walking up
+// from the working directory, like every other in-repo `.jevitate/` file) is used when it exists.
+// An unreadable or invalid file is a typed refusal (`E_UX_PRODUCT_INPUT`, usage error) BEFORE any
+// browser opens — never a silently ignored file.
+import { existsSync, statSync } from "node:fs";
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { ProductFactsError, parseProductFactsText } from "@jevitate/ux";
+import { findProjectDir } from "./project-dir.js";
+export const PRODUCT_FACTS_FILE = "product.json";
+/** The facts file to read: the flag, else `<project>/.jevitate/product.json` when present. */
+export function productFactsPath(flag, deps = {}) {
+    if (flag !== undefined)
+        return flag;
+    const dir = findProjectDir(deps);
+    if (dir === null)
+        return undefined;
+    const p = join(dir, PRODUCT_FACTS_FILE);
+    return existsSync(p) && statSync(p).isFile() ? p : undefined;
+}
+/** Reads and validates the product facts. Throws `ProductFactsError` for a missing/invalid file. */
+export async function loadProductFacts(flag, deps = {}) {
+    const path = productFactsPath(flag, deps);
+    if (path === undefined)
+        return {};
+    let text;
+    try {
+        text = await readFile(path, "utf8");
+    }
+    catch (err) {
+        throw new ProductFactsError(path, [`cannot read the file: ${err instanceof Error ? err.message : String(err)}`]);
+    }
+    return { facts: parseProductFactsText(text, path), path };
+}
+/** The report caveat when no facts were available (prices and intended next steps went unchecked). */
+export const NO_PRODUCT_FACTS_CAVEAT = "no product facts (.jevitate/product.json or --product): prices, trial lengths and each page's intended next step were not checked against the product's own facts (docs/ux-findings.md).";
+//# sourceMappingURL=ux-product.js.map

package/dist/ux-product.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ux-product.js","sourceRoot":"","sources":["../src/ux-product.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,EAAE;AACF,iGAAiG;AACjG,kGAAkG;AAClG,kGAAkG;AAClG,iDAAiD;AACjD,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAqB,MAAM,cAAc,CAAC;AAC3F,OAAO,EAAE,cAAc,EAAmB,MAAM,kBAAkB,CAAC;AAEnE,MAAM,CAAC,MAAM,kBAAkB,GAAG,cAAc,CAAC;AAQjD,8FAA8F;AAC9F,MAAM,UAAU,gBAAgB,CAAC,IAAwB,EAAE,OAAmB,EAAE;IAC9E,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACpC,MAAM,GAAG,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IACjC,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IACnC,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,kBAAkB,CAAC,CAAC;IACxC,OAAO,UAAU,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC/D,CAAC;AAED,oGAAoG;AACpG,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAAwB,EAAE,OAAmB,EAAE;IACpF,MAAM,IAAI,GAAG,gBAAgB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC1C,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IAClC,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QACH,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACtC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,iBAAiB,CAAC,IAAI,EAAE,CAAC,yBAAyB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IACnH,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,qBAAqB,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC;AAC5D,CAAC;AAED,sGAAsG;AACtG,MAAM,CAAC,MAAM,uBAAuB,GAClC,0LAA0L,CAAC"}

package/dist/ux-review.d.ts

@@ -61,6 +61,10 @@ export interface RunUxReviewOptions {
     readonly evidenceUnavailable?: string;
     /** Tuning of the run-signal oracles (#96/#131). */
     readonly signals?: SignalOptions;
+    /** #198 `--product <file>`: product facts (default `.jevitate/product.json` in the project). */
+    readonly product?: string;
+    /** #198 `--polish`: polish each verified finding's recommendation with one generation call (opt-in). */
+    readonly polish?: boolean;
 }
 export interface RunUxReviewResult {
     readonly report: UxReport;