@jevitate/cli 0.9.0 → 0.10.0

package/dist/locator-health.d.ts

@@ -0,0 +1,195 @@
+import type { Recording, Step, TargetDescriptor } from "@jevitate/recording";
+import type { LocatorHealth, LocatorHealthStep, LocatorRung } from "./check-types.js";
+/**
+ * #470 — locator health, the pure core: for every step that acts on a target, the selector rung it
+ * resolves by, how robust that rung is, WHY it is brittle, and the fix for the app under test. A step
+ * is `stable` only when it resolves by a test id from the team's convention (`testIdAttributes`;
+ * `data-tflow-id` never counts, #468) that does not look generated; anything else is `brittle` and
+ * gets a suggestion — a work list for the codebase, de-duplicated by element.
+ *
+ * Static (a Journey's recorded descriptors) or dynamic (a run's `resolved` — the rung that actually
+ * matched at replay, `@jevitate/interpreter` `StepResolution`). No I/O: `locator-health-api.ts` loads
+ * Journeys, results and config; check/report/the review sheet call these helpers.
+ */
+/** The ladder's own grade for a rung (the recorder's `Stability`): how likely it is to survive change. */
+export type LocatorLevel = "high" | "medium" | "low";
+/** Why a step's locator is brittle — the stable vocabulary (machine-readable `code`, human `text`). */
+export type BrittleReasonCode = "no-test-id" | "test-id-not-in-convention" | "tflow-id-not-a-test-id" | "generated-value" | "no-accessible-name" | "duplicate-name" | "positional-css" | "text-copy";
+/** A run's resolution of one step (structurally `@jevitate/interpreter` `StepResolution`). */
+export interface ResolvedStepInput {
+    readonly index: number;
+    readonly stepId?: string;
+    readonly rung: string;
+    readonly testIdAttr?: string;
+    readonly ordinal?: number;
+    readonly candidates?: number;
+}
+/** One step's verdict, in detail (a `LocatorHealthStep`, plus what the reports and the review sheet show). */
+export interface LocatorHealthStepDetail extends LocatorHealthStep {
+    readonly kind: Step["kind"];
+    /** The ladder grade of the rung used. */
+    readonly level: LocatorLevel;
+    /** `recorded`: from the Journey's descriptor; `resolved`: the rung that matched at replay. */
+    readonly source: "recorded" | "resolved";
+    /** The route (path) of the page the step acts on, when known. */
+    readonly route?: string;
+    /** How the step finds its target, e.g. `role=button name="Save"`, `css=main > div:nth-of-type(2)`. */
+    readonly locator: string;
+    readonly reasonCodes: readonly BrittleReasonCode[];
+    /** The key of this step's suggestion (`LocatorSuggestion.key`); absent when stable. */
+    readonly suggestion?: string;
+}
+/** Where a brittle element is used. */
+export interface LocatorOccurrence {
+    readonly journeyId?: string;
+    readonly index: number;
+    readonly stepId?: string;
+}
+/** One actionable fix for the app, per element (route + role + name), however many steps use it. */
+export interface LocatorSuggestion {
+    /** The de-duplication key: `route|role|name` (or `route|css|selector` for an unnamed element). */
+    readonly key: string;
+    readonly route?: string;
+    readonly role?: string;
+    readonly name?: string;
+    /** The element in words, e.g. `the "Save" button`. */
+    readonly element: string;
+    /** A short outerHTML excerpt, when the caller had one (a live page); never a field's value. */
+    readonly html?: string;
+    /** The attribute the fix adds (the convention's first). */
+    readonly attribute: string;
+    /** The suggested test id (kebab-case, from the name and route). */
+    readonly testId: string;
+    /** The fix, e.g. `add data-testid="save-contact" to the "Save" button on /contacts/new`. */
+    readonly fix: string;
+    readonly reasons: readonly string[];
+    readonly occurrences: readonly LocatorOccurrence[];
+}
+export interface LocatorLevels {
+    readonly high: number;
+    readonly medium: number;
+    readonly low: number;
+}
+/** A Journey's (or a run's) locator health in detail — a `LocatorHealth` with the levels, line and fixes. */
+export interface LocatorHealthDetail extends LocatorHealth {
+    readonly steps: readonly LocatorHealthStepDetail[];
+    readonly levels: LocatorLevels;
+    /** e.g. `7/9 steps on stable locators; 2 brittle (high 7 · medium 1 · low 1)`. */
+    readonly line: string;
+    readonly suggestions: readonly LocatorSuggestion[];
+}
+export interface AnalyzeOptions {
+    /** The team's test-id convention (project config `testIdAttributes`). */
+    readonly testIdAttributes: readonly string[];
+    /** Tags each suggestion's occurrences (a multi-Journey report). */
+    readonly journeyId?: string;
+    /** A run's resolutions: the rung that actually matched, per step (overrides the recorded rung). */
+    readonly resolved?: readonly ResolvedStepInput[];
+    /** Short outerHTML excerpts by flat step index, when the caller had a live page. */
+    readonly html?: ReadonlyMap<number, string>;
+}
+/** The target a step acts on, or null (navigate, press, assert, a forEach's items are its own). */
+export declare function stepTarget(step: Step): TargetDescriptor | null;
+interface Verdict {
+    readonly rung: LocatorRung;
+    readonly level: LocatorLevel;
+    readonly codes: BrittleReasonCode[];
+}
+/**
+ * One target's verdict against the convention. `via` (a run's resolution) replaces the recorded rung
+ * when present; everything else is read from the descriptor.
+ */
+export declare function classifyTarget(d: TargetDescriptor, testIdAttributes: readonly string[], via?: ResolvedStepInput): Verdict;
+/** `"Save contact"` → `save-contact` (ASCII letters and digits, at most 40 chars). */
+export declare function kebabCase(s: string): string;
+/** The path of a page URL (`https://x/contacts/new?a=1` → `/contacts/new`); a path is kept as is. */
+export declare function routeOf(url: string | undefined): string | undefined;
+/**
+ * The suggested test id: the element's name in kebab-case, with the route's noun when the name is a
+ * single word (`Save` on /contacts/new → `save-contact`); an unnamed element is named by its route
+ * and tag (`contacts-div`).
+ */
+export declare function suggestTestId(name: string | undefined, route: string | undefined, fallbackTag: string): string;
+/** The element's identity across steps and runs: route + role + name (else its css). */
+export declare function suggestionKey(d: TargetDescriptor, route: string | undefined): string;
+/** Merges suggestions for the same element (route + role + name): occurrences and reasons combined. */
+export declare function dedupeSuggestions(lists: ReadonlyArray<readonly LocatorSuggestion[]>): LocatorSuggestion[];
+export declare function emptyLevels(): LocatorLevels;
+/** `7/9 steps on stable locators; 2 brittle (high 7 · medium 1 · low 1)`. */
+export declare function healthLine(h: {
+    readonly stable: number;
+    readonly brittle: number;
+    readonly levels: LocatorLevels;
+}): string;
+/**
+ * A recording's locator health: every step with a target (flat index, as the interpreter numbers
+ * them), against the convention; with `resolved`, the rung each step actually matched at replay.
+ */
+export declare function analyzeRecording(rec: Recording, opts: AnalyzeOptions): LocatorHealthDetail;
+/** Totals over several healths (a report, a check): counts, levels and the de-duplicated work list. */
+export declare function combineHealth(healths: readonly LocatorHealthDetail[]): {
+    stable: number;
+    brittle: number;
+    levels: LocatorLevels;
+    line: string;
+    suggestions: LocatorSuggestion[];
+};
+/** `check --max-brittle-steps <n>`: true when a Journey item's brittle steps exceed the opt-in threshold. */
+export declare function exceedsBrittleSteps(health: Pick<LocatorHealth, "brittle">, maxBrittleSteps: number | undefined): boolean;
+export interface LocatorTrendStep {
+    /** `stepId`, else `#<index>`. */
+    readonly key: string;
+    readonly from: {
+        readonly rung: LocatorRung;
+        readonly level: LocatorLevel;
+        readonly stability: "stable" | "brittle";
+    };
+    readonly to: {
+        readonly rung: LocatorRung;
+        readonly level: LocatorLevel;
+        readonly stability: "stable" | "brittle";
+    };
+}
+/** Against a baseline: steps whose locator improved / regressed (stability first, then level). */
+export interface LocatorHealthTrend {
+    readonly improved: number;
+    readonly regressed: number;
+    readonly unchanged: number;
+    /** Steps only in the current (added) or only in the baseline (removed). */
+    readonly added: number;
+    readonly removed: number;
+    readonly brittleDelta: number;
+    readonly changes: readonly (LocatorTrendStep & {
+        readonly direction: "improved" | "regressed";
+    })[];
+}
+type TrendInputStep = Pick<LocatorHealthStep, "stepId" | "index" | "rung" | "stability"> & {
+    readonly level?: LocatorLevel;
+};
+/**
+ * The trend of `current` against `baseline` (a previous report or run of the same Journey), keyed by
+ * step id (else index): a Journey re-recorded or healed after the app added test ids shows its
+ * improvement; a step that fell back to a brittle rung shows as a regression.
+ */
+export declare function compareLocatorHealth(current: {
+    readonly brittle: number;
+    readonly steps: readonly TrendInputStep[];
+}, baseline: {
+    readonly brittle: number;
+    readonly steps: readonly TrendInputStep[];
+}): LocatorHealthTrend;
+/** `trend vs baseline: 2 improved, 1 regressed (brittle -1)`. */
+export declare function trendLine(t: LocatorHealthTrend): string;
+/** What a run's result.json / a check item carries: counts, the line, levels, per-step verdicts, top fixes. */
+export interface CompactLocatorHealth extends LocatorHealth {
+    readonly levels: LocatorLevels;
+    readonly line: string;
+    readonly steps: readonly LocatorHealthStep[];
+    readonly suggestions: ReadonlyArray<Pick<LocatorSuggestion, "key" | "element" | "fix" | "reasons"> & {
+        readonly route?: string;
+        readonly steps: number;
+    }>;
+}
+/** The compact form of a detail: per-step rung/stability/reasons, and the top `top` fixes. */
+export declare function compactHealth(h: Pick<LocatorHealthDetail, "stable" | "brittle" | "steps" | "levels" | "line" | "suggestions">, top?: number): CompactLocatorHealth;
+export {};

package/dist/locator-health.js

@@ -0,0 +1,419 @@
+import { looksGenerated } from "@jevitate/recorder";
+// === Classification ===
+const LEVEL_RANK = { low: 0, medium: 1, high: 2 };
+/** One notch down: a rung that only resolves with an ordinal (the recorder's `CAPPED_STABILITY`). */
+const CAPPED = { high: "medium", medium: "low", low: "low" };
+const REASON_TEXT = {
+    "no-test-id": "no test id",
+    "test-id-not-in-convention": "test id attribute is not in the convention",
+    "tflow-id-not-a-test-id": "data-tflow-id is tracking metadata, not a test id",
+    "generated-value": "generated-looking id or name",
+    "no-accessible-name": "no accessible name",
+    "duplicate-name": "duplicate name needs disambiguation (nth)",
+    "positional-css": "deep or positional css path",
+    "text-copy": "text locator on copy likely to change",
+};
+/** The target a step acts on, or null (navigate, press, assert, a forEach's items are its own). */
+export function stepTarget(step) {
+    switch (step.kind) {
+        case "click":
+        case "fill":
+        case "waitFor":
+        case "extract":
+        case "select":
+        case "upload":
+        case "editText":
+            return step.target;
+        default:
+            return null;
+    }
+}
+/** The recorded rung replay tries (an anchor first, as `resolveTarget` does). */
+function recordedRung(d) {
+    if (d.anchor !== undefined && d.testId === undefined && (d.anchor.id !== undefined || d.anchor.name !== undefined))
+        return "anchor";
+    return ownRung(d);
+}
+function ownRung(d) {
+    if (d.testId)
+        return "testId";
+    if (d.role && d.name)
+        return "role+name";
+    if (d.label)
+        return "label";
+    if (d.text)
+        return "text";
+    if (d.css)
+        return "css";
+    return d.role ? "role" : "css";
+}
+function asRung(r) {
+    return ["testId", "anchor", "role+name", "role", "label", "text", "css"].find((x) => x === r) ?? "css";
+}
+/** How deep a css path is, and whether it is positional. */
+function cssShape(css) {
+    return { depth: css.split(">").length, positional: /:nth-(of-type|child)\(|:first-|:last-/.test(css) };
+}
+function describeLocator(d, rung) {
+    const nth = d.ordinal === undefined ? "" : ` nth=${d.ordinal}`;
+    switch (rung) {
+        case "testId":
+            return `testId[${d.testIdAttr ?? "data-testid"}]=${d.testId ?? "?"}`;
+        case "anchor":
+            return d.anchor?.id !== undefined ? `[id=${JSON.stringify(d.anchor.id)}]` : `[name=${JSON.stringify(d.anchor?.name ?? "")}]`;
+        case "role+name":
+            return `role=${d.role ?? "?"} name=${JSON.stringify(d.name ?? "")}${nth}`;
+        case "label":
+            return `label=${JSON.stringify(d.label ?? "")}${nth}`;
+        case "text":
+            return `text=${JSON.stringify(d.text ?? "")}${nth}`;
+        default:
+            return `css=${d.css ?? "?"}`;
+    }
+}
+/**
+ * One target's verdict against the convention. `via` (a run's resolution) replaces the recorded rung
+ * when present; everything else is read from the descriptor.
+ */
+export function classifyTarget(d, testIdAttributes, via) {
+    const rung = via === undefined ? recordedRung(d) : asRung(via.rung);
+    const ordinal = via === undefined ? d.ordinal : via.ordinal;
+    const codes = [];
+    let level;
+    switch (rung) {
+        case "testId": {
+            const attr = (via?.testIdAttr ?? d.testIdAttr ?? "data-testid").toLowerCase();
+            const generated = looksGenerated(d.testId ?? "");
+            level = generated ? "low" : "high";
+            if (attr === "data-tflow-id")
+                codes.push("tflow-id-not-a-test-id");
+            else if (!testIdAttributes.includes(attr))
+                codes.push("test-id-not-in-convention");
+            if (generated)
+                codes.push("generated-value");
+            break;
+        }
+        case "anchor":
+            // A non-generated id/name attribute (the recorder refuses generated ones): sturdy, but not the convention.
+            level = "medium";
+            codes.push("no-test-id");
+            break;
+        case "role+name":
+            level = looksGenerated(d.name ?? "") ? "low" : "high";
+            codes.push("no-test-id");
+            if (level === "low")
+                codes.push("generated-value");
+            break;
+        case "label":
+            level = "medium";
+            codes.push("no-test-id");
+            break;
+        case "text":
+            level = "medium";
+            codes.push("no-test-id", "text-copy");
+            break;
+        default: {
+            level = "low";
+            codes.push("no-test-id");
+            const shape = cssShape(d.css ?? "");
+            if (shape.positional || shape.depth > 3)
+                codes.push("positional-css");
+            if (/#[A-Za-z0-9_-]*\d{4}|[0-9a-fA-F]{8}/.test(d.css ?? ""))
+                codes.push("generated-value");
+        }
+    }
+    if (ordinal !== undefined && rung !== "testId" && rung !== "anchor" && rung !== "css") {
+        level = CAPPED[level];
+        codes.push("duplicate-name");
+    }
+    if (rung !== "testId" && !(d.name || d.label))
+        codes.push("no-accessible-name");
+    if (d.tflowId !== undefined && rung !== "testId" && !codes.includes("tflow-id-not-a-test-id"))
+        codes.push("tflow-id-not-a-test-id");
+    return { rung, level, codes };
+}
+// === Suggestions ===
+/** `"Save contact"` → `save-contact` (ASCII letters and digits, at most 40 chars). */
+export function kebabCase(s) {
+    return s
+        .normalize("NFKD")
+        .replace(/[̀-ͯ]/g, "")
+        .replace(/([a-z0-9])([A-Z])/g, "$1-$2")
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .slice(0, 40)
+        .replace(/-+$/g, "");
+}
+/** The path of a page URL (`https://x/contacts/new?a=1` → `/contacts/new`); a path is kept as is. */
+export function routeOf(url) {
+    if (url === undefined || url === "")
+        return undefined;
+    try {
+        return new URL(url).pathname;
+    }
+    catch {
+        const path = url.split(/[?#]/)[0] ?? url;
+        return path.startsWith("/") ? path : `/${path}`;
+    }
+}
+function singular(word) {
+    if (/ies$/.test(word))
+        return word.replace(/ies$/, "y");
+    if (/(ss|us)$/.test(word))
+        return word;
+    return word.replace(/s$/, "");
+}
+/** The route's first meaningful segment (not an id or a verb like `new`/`edit`), singular. */
+function routeWords(route) {
+    return (route ?? "").split("/").filter((s) => s !== "" && !/^\d+$/.test(s) && !looksGenerated(s) && !/^(new|edit|create|index|view)$/i.test(s));
+}
+function routeNoun(route) {
+    const first = routeWords(route)[0];
+    return first === undefined ? undefined : singular(kebabCase(first));
+}
+/**
+ * The suggested test id: the element's name in kebab-case, with the route's noun when the name is a
+ * single word (`Save` on /contacts/new → `save-contact`); an unnamed element is named by its route
+ * and tag (`contacts-div`).
+ */
+export function suggestTestId(name, route, fallbackTag) {
+    const base = name === undefined ? "" : kebabCase(name);
+    const noun = routeNoun(route);
+    if (base !== "")
+        return !base.includes("-") && noun !== undefined && !base.includes(noun) ? `${base}-${noun}` : base;
+    const where = kebabCase(routeWords(route).join("-"));
+    return `${where === "" ? "page" : where}-${fallbackTag}`;
+}
+function lastCssTag(css) {
+    const last = (css ?? "").split(">").pop()?.trim() ?? "";
+    return /^([a-z][a-z0-9-]*)/i.exec(last)?.[1]?.toLowerCase() ?? "element";
+}
+function describeElement(d) {
+    const name = d.name ?? d.label;
+    if (d.role && name)
+        return `the ${JSON.stringify(name)} ${d.role}`;
+    if (d.label)
+        return `the ${JSON.stringify(d.label)} field`;
+    if (d.role)
+        return `the ${d.role}`;
+    if (d.text)
+        return `the element with text ${JSON.stringify(d.text.length > 40 ? `${d.text.slice(0, 40)}…` : d.text)}`;
+    if (d.testId)
+        return `the element with ${d.testIdAttr ?? "data-testid"}=${JSON.stringify(d.testId)}`;
+    return `the element at css ${JSON.stringify(d.css ?? "?")}`;
+}
+/** The element's identity across steps and runs: route + role + name (else its css). */
+export function suggestionKey(d, route) {
+    const name = d.name ?? d.label ?? d.text;
+    if (name !== undefined)
+        return `${route ?? ""}|${d.role ?? ""}|${name}`;
+    if (d.testId !== undefined)
+        return `${route ?? ""}|testid|${d.testId}`;
+    return `${route ?? ""}|css|${d.css ?? ""}`;
+}
+function fixFor(d, codes, attribute, testId, element, route) {
+    const on = route === undefined ? "" : ` on ${route}`;
+    const named = codes.includes("no-accessible-name") ? " and give it an accessible name (visible text or aria-label)" : "";
+    if (codes.includes("test-id-not-in-convention") && d.testId !== undefined && !looksGenerated(d.testId)) {
+        return `use ${attribute}=${JSON.stringify(d.testId)} instead of ${d.testIdAttr ?? "?"} on ${element}${on} (or add ${d.testIdAttr ?? "?"} to testIdAttributes in .jevitate/project.json)`;
+    }
+    if (d.testId !== undefined && looksGenerated(d.testId)) {
+        return `replace the generated ${d.testIdAttr ?? attribute}=${JSON.stringify(d.testId)} on ${element}${on} with a stable ${attribute}=${JSON.stringify(testId)}`;
+    }
+    return `add ${attribute}=${JSON.stringify(testId)} to ${element}${on}${named}`;
+}
+function buildSuggestion(d, codes, route, attribute, html, occurrence) {
+    const name = d.name ?? d.label ?? d.text;
+    const testId = suggestTestId(d.testId !== undefined && !looksGenerated(d.testId) ? d.testId : name, route, lastCssTag(d.css));
+    const element = describeElement(d);
+    return {
+        key: suggestionKey(d, route),
+        ...(route === undefined ? {} : { route }),
+        ...(d.role === undefined ? {} : { role: d.role }),
+        ...(name === undefined ? {} : { name }),
+        element,
+        ...(html === undefined ? {} : { html: html.length > 160 ? `${html.slice(0, 160)}…` : html }),
+        attribute,
+        testId,
+        fix: fixFor(d, codes, attribute, testId, element, route),
+        reasons: codes.map((c) => REASON_TEXT[c]),
+        occurrences: [occurrence],
+    };
+}
+/** Merges suggestions for the same element (route + role + name): occurrences and reasons combined. */
+export function dedupeSuggestions(lists) {
+    const byKey = new Map();
+    for (const s of lists.flat()) {
+        const prev = byKey.get(s.key);
+        if (prev === undefined) {
+            byKey.set(s.key, s);
+            continue;
+        }
+        const occ = [...prev.occurrences];
+        for (const o of s.occurrences) {
+            if (!occ.some((p) => p.journeyId === o.journeyId && p.index === o.index && p.stepId === o.stepId))
+                occ.push(o);
+        }
+        byKey.set(s.key, {
+            ...prev,
+            ...(prev.html === undefined && s.html !== undefined ? { html: s.html } : {}),
+            reasons: [...new Set([...prev.reasons, ...s.reasons])],
+            occurrences: occ,
+        });
+    }
+    // The elements most steps depend on first: the highest-value fixes lead the work list.
+    return [...byKey.values()].sort((a, b) => b.occurrences.length - a.occurrences.length || a.key.localeCompare(b.key));
+}
+// === Analysis ===
+function flatWithRoute(rec) {
+    return rec.pages.flatMap((p) => p.steps.map((recorded) => ({ recorded, route: routeOf(p.url) })));
+}
+export function emptyLevels() {
+    return { high: 0, medium: 0, low: 0 };
+}
+/** `7/9 steps on stable locators; 2 brittle (high 7 · medium 1 · low 1)`. */
+export function healthLine(h) {
+    const total = h.stable + h.brittle;
+    if (total === 0)
+        return "no steps act on a target";
+    return `${h.stable}/${total} steps on stable locators; ${h.brittle} brittle (high ${h.levels.high} · medium ${h.levels.medium} · low ${h.levels.low})`;
+}
+/**
+ * A recording's locator health: every step with a target (flat index, as the interpreter numbers
+ * them), against the convention; with `resolved`, the rung each step actually matched at replay.
+ */
+export function analyzeRecording(rec, opts) {
+    const attribute = opts.testIdAttributes[0] ?? "data-testid";
+    const resolvedBy = new Map((opts.resolved ?? []).map((r) => [r.index, r]));
+    const steps = [];
+    const suggestions = [];
+    const levels = { high: 0, medium: 0, low: 0 };
+    flatWithRoute(rec).forEach(({ recorded, route }, index) => {
+        const d = stepTarget(recorded.step);
+        if (d === null)
+            return;
+        const via = resolvedBy.get(index);
+        const v = classifyTarget(d, opts.testIdAttributes, via);
+        const brittle = v.codes.length > 0;
+        levels[v.level] += 1;
+        const stepId = recorded.stepId ?? via?.stepId;
+        let key;
+        if (brittle) {
+            const occurrence = { ...(opts.journeyId === undefined ? {} : { journeyId: opts.journeyId }), index, ...(stepId === undefined ? {} : { stepId }) };
+            const s = buildSuggestion(d, v.codes, route, attribute, opts.html?.get(index), occurrence);
+            suggestions.push(s);
+            key = s.key;
+        }
+        steps.push({
+            ...(stepId === undefined ? {} : { stepId }),
+            index,
+            kind: recorded.step.kind,
+            rung: v.rung,
+            level: v.level,
+            stability: brittle ? "brittle" : "stable",
+            source: via === undefined ? "recorded" : "resolved",
+            ...(route === undefined ? {} : { route }),
+            locator: describeLocator(d, v.rung),
+            reasons: v.codes.map((c) => REASON_TEXT[c]),
+            reasonCodes: v.codes,
+            ...(key === undefined ? {} : { suggestion: key }),
+        });
+    });
+    const stable = steps.filter((s) => s.stability === "stable").length;
+    const brittle = steps.length - stable;
+    return { stable, brittle, steps, levels, line: healthLine({ stable, brittle, levels }), suggestions: dedupeSuggestions([suggestions]) };
+}
+/** Totals over several healths (a report, a check): counts, levels and the de-duplicated work list. */
+export function combineHealth(healths) {
+    const levels = { high: 0, medium: 0, low: 0 };
+    let stable = 0;
+    let brittle = 0;
+    for (const h of healths) {
+        stable += h.stable;
+        brittle += h.brittle;
+        levels.high += h.levels.high;
+        levels.medium += h.levels.medium;
+        levels.low += h.levels.low;
+    }
+    return { stable, brittle, levels, line: healthLine({ stable, brittle, levels }), suggestions: dedupeSuggestions(healths.map((h) => h.suggestions)) };
+}
+// === Gate ===
+/** `check --max-brittle-steps <n>`: true when a Journey item's brittle steps exceed the opt-in threshold. */
+export function exceedsBrittleSteps(health, maxBrittleSteps) {
+    return maxBrittleSteps !== undefined && health.brittle > maxBrittleSteps;
+}
+function stepKey(s) {
+    return s.stepId ?? `#${s.index}`;
+}
+function score(s) {
+    return (s.stability === "stable" ? 10 : 0) + LEVEL_RANK[s.level ?? (s.stability === "stable" ? "high" : "low")];
+}
+/**
+ * The trend of `current` against `baseline` (a previous report or run of the same Journey), keyed by
+ * step id (else index): a Journey re-recorded or healed after the app added test ids shows its
+ * improvement; a step that fell back to a brittle rung shows as a regression.
+ */
+export function compareLocatorHealth(current, baseline) {
+    const before = new Map(baseline.steps.map((s) => [stepKey(s), s]));
+    const seen = new Set();
+    const changes = [];
+    let unchanged = 0;
+    let added = 0;
+    const shape = (s) => ({ rung: s.rung, level: s.level ?? (s.stability === "stable" ? "high" : "low"), stability: s.stability });
+    for (const s of current.steps) {
+        const key = stepKey(s);
+        seen.add(key);
+        const b = before.get(key);
+        if (b === undefined) {
+            added++;
+            continue;
+        }
+        const delta = score(s) - score(b);
+        if (delta === 0)
+            unchanged++;
+        else
+            changes.push({ key, from: shape(b), to: shape(s), direction: delta > 0 ? "improved" : "regressed" });
+    }
+    const removed = [...before.keys()].filter((k) => !seen.has(k)).length;
+    return {
+        improved: changes.filter((c) => c.direction === "improved").length,
+        regressed: changes.filter((c) => c.direction === "regressed").length,
+        unchanged,
+        added,
+        removed,
+        brittleDelta: current.brittle - baseline.brittle,
+        changes,
+    };
+}
+/** `trend vs baseline: 2 improved, 1 regressed (brittle -1)`. */
+export function trendLine(t) {
+    const sign = t.brittleDelta > 0 ? `+${t.brittleDelta}` : String(t.brittleDelta);
+    return `trend vs baseline: ${t.improved} improved, ${t.regressed} regressed (brittle ${sign})`;
+}
+/** The compact form of a detail: per-step rung/stability/reasons, and the top `top` fixes. */
+export function compactHealth(h, top = 5) {
+    return {
+        stable: h.stable,
+        brittle: h.brittle,
+        levels: h.levels,
+        line: h.line,
+        steps: h.steps.map((s) => ({
+            ...(s.stepId === undefined ? {} : { stepId: s.stepId }),
+            index: s.index,
+            rung: s.rung,
+            stability: s.stability,
+            reasons: s.reasons,
+            ...("level" in s ? { level: s.level } : {}),
+        })),
+        suggestions: h.suggestions.slice(0, top).map((s) => ({
+            key: s.key,
+            element: s.element,
+            fix: s.fix,
+            reasons: s.reasons,
+            ...(s.route === undefined ? {} : { route: s.route }),
+            steps: s.occurrences.length,
+        })),
+    };
+}
+//# sourceMappingURL=locator-health.js.map

package/dist/locator-health.js.map

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

package/dist/mcp-cli-tools.d.ts

@@ -60,7 +60,9 @@ export type CliParamKind =
 /** `name=<storageState>` entries (`--persona`/`--actor`): each path confined as a session. */
  | "named-sessions"
 /** `<descriptor>=<file>` entries (`--type-fixture`): the file (after the LAST `=`) confined as a read path. */
- | "bound-paths";
+ | "bound-paths"
+/** #464: a path the command WRITES project output to — confined to the project roots only (never `~/.jevitate/`). */
+ | "project-path";
 export interface CliParam {
     readonly kind: CliParamKind;
     /** The long flag (`--env`); absent for a positional. */