@ia-qa/self-healing 1.7.8 → 1.7.11

package/dist/ingest.js

@@ -140,6 +140,19 @@ const PATTERNS = [
  * Shared call shapes (`.type`, `.press`, `.fill`…) take text in one framework and
  * a selector in another, so a captured literal is only recorded when it *reads*
  * like a selector. A bare tag (`click('button')`) is the accepted miss.
+ *
+ * "Reads like a selector" used to mean *contains a structural character* — a `>`,
+ * a `[`, a leading `.`. That test cannot tell `div > span` from `age > 18`, and
+ * the permissive Page Object shape below offers it every `foo = '…'` in the suite,
+ * so a SQL condition typed into a field was inventoried as a selector. The cost
+ * was argued as one line in an advisory count; `explain` then made it a red gate
+ * (`exit 1`) pointing at a healthy test line. So the test is now *validity*, not
+ * presence: `18` is not a type selector, `.5` is not a class, `fix:` is not a
+ * pseudo. Seven of the eight parasites in the reference corpus are refused by the
+ * grammar alone, and none of them needed a list of known-bad shapes.
+ *
+ * What the grammar cannot see stays: `a.b.c` is a valid selector whether it names
+ * an element or a JWT. That residue is real and is not worth a length heuristic.
  */
 function plausibleSelector(value) {
     const v = value.trim();
@@ -161,17 +174,212 @@ function plausibleSelector(value) {
         return false;
     if (/^#[0-9a-f]{3,8}$/i.test(v))
         return false;
-    if (/^[#.[]/.test(v))
-        return true;
-    if (v.includes('>>'))
+    return v
+        .split('>>')
+        .every((part) => selectorPart(part));
+}
+/** An engine-prefixed locator states its own grammar; we do not know it. */
+const ENGINE_PREFIX = /^(?:text|role|xpath|css|data-testid|id|nth|visible|internal:[\w-]+)=/;
+/** A bare XPath — `//button`, `(//tr)[2]`. Legal in Playwright, not CSS. */
+const XPATH_START = /^\(*\/\//;
+function selectorPart(part) {
+    const p = part.trim();
+    if (p === '')
+        return false;
+    if (ENGINE_PREFIX.test(p))
         return true;
-    if (/[>[\]]/.test(v))
+    if (XPATH_START.test(p))
         return true;
-    if (/^[a-z][a-z0-9-]*[#.:]/i.test(v))
+    return isSelectorShaped(p);
+}
+// Non-ASCII is a legal CSS identifier character — `.café` and `.日本語` are classes.
+const NON_ASCII = '\u0080';
+const BACKSLASH = '\u005c';
+const isIdentStart = (c) => /[A-Za-z_]/.test(c) || c === BACKSLASH || c >= NON_ASCII;
+const isIdentChar = (c) => /[-A-Za-z0-9_]/.test(c) || c === BACKSLASH || c >= NON_ASCII;
+/**
+ * Every element name a browser can be asked for by type, plus the SVG ones a test
+ * realistically queries. A closed set, and that is the point: a type selector names
+ * an *element*, so anything outside this list has to look like a custom element to
+ * be admitted at all.
+ */
+const HTML_TAGS = new Set(('a abbr address area article aside audio b base bdi bdo big blockquote body br button canvas caption ' +
+    'cite code col colgroup data datalist dd del details dfn dialog div dl dt em embed fieldset figcaption ' +
+    'figure footer form h1 h2 h3 h4 h5 h6 head header hgroup hr html i iframe img input ins kbd label ' +
+    'legend li link main map mark menu meta meter nav noscript object ol optgroup option output p param ' +
+    'picture pre progress q rp rt ruby s samp script search section select slot small source span strong ' +
+    'style sub summary sup table tbody td template textarea tfoot th thead time title tr track u ul var ' +
+    'video wbr ' +
+    'svg circle ellipse g line path polygon polyline rect stop text tspan use defs symbol foreignObject')
+    .split(' '));
+/**
+ * Can this identifier be an element name?
+ *
+ * The grammar alone cannot tell `div.active` from `demo_tool.input.free` — a JSON
+ * schema path is a perfectly well-formed `tag.class.class`, and the reference corpus
+ * holds eleven of them. HTML settles it: an element is either a known tag or a custom
+ * element, and a custom element must start lowercase, must contain a hyphen, and may
+ * never contain an underscore. `demo_tool` fails all three; `app-root`, `mat-button`
+ * and `ion-select` pass, which is what this rule exists to protect.
+ *
+ * A placeholder is unknowable, so `${tag}.foo` is admitted rather than guessed at.
+ */
+function plausibleTypeName(name) {
+    if (name.indexOf('${') !== -1)
         return true;
-    if (/^(?:text|role|xpath|css|data-testid)=/.test(v))
+    if (HTML_TAGS.has(name.toLowerCase()))
         return true;
-    return false;
+    return /^[a-z][a-z0-9.]*-[a-z0-9.-]*$/.test(name);
+}
+/**
+ * Is `sel` a well-formed CSS selector that actually *qualifies* something?
+ *
+ * Three conditions, all load-bearing. Well-formed rejects `age > 18` and `v1.5.1`.
+ * Element-named rejects `demo_tool.input.free`. Qualified — at least one `#`, `.`,
+ * `[`, `:` or an explicit combinator — rejects `hello world`, which the grammar alone
+ * would happily read as two type selectors. A bare tag was already the accepted miss;
+ * two bare tags are the same miss, and admitting them would inventory every two-word
+ * English string.
+ */
+function isSelectorShaped(sel) {
+    let i = 0;
+    let qualified = false;
+    const n = sel.length;
+    const skipWs = () => {
+        const from = i;
+        while (i < n && /\s/.test(sel[i]))
+            i++;
+        return i > from;
+    };
+    /** Consume a balanced `[...]` / `(...)`, quotes honoured. Depth, not first close. */
+    const skipBalanced = (open, close) => {
+        let depth = 0;
+        while (i < n) {
+            const c = sel[i];
+            if (c === '"' || c === "'") {
+                const q = c;
+                i++;
+                while (i < n && sel[i] !== q)
+                    i += sel[i] === '\\' ? 2 : 1;
+                if (i >= n)
+                    return false;
+                i++;
+                continue;
+            }
+            if (c === open)
+                depth++;
+            else if (c === close) {
+                depth--;
+                i++;
+                if (depth === 0)
+                    return true;
+                continue;
+            }
+            i++;
+        }
+        return false;
+    };
+    /**
+     * An identifier, plus the one non-CSS token that belongs here: `${…}`. A
+     * template placeholder is opaque to every consumer of this inventory, but
+     * `#row-${id}` is an ordinary selector and refusing it would drop a real one.
+     */
+    const readIdent = () => {
+        const from = i;
+        if (i < n && sel[i] === '$' && sel[i + 1] === '{') {
+            i++;
+            if (!skipBalanced('{', '}'))
+                return false;
+        }
+        else {
+            if (i >= n || !isIdentStart(sel[i]))
+                return false;
+            if (sel[i] === '\\')
+                i++;
+            i++;
+        }
+        while (i < n) {
+            if (sel[i] === '$' && sel[i + 1] === '{') {
+                i++;
+                if (!skipBalanced('{', '}'))
+                    return false;
+                continue;
+            }
+            if (!isIdentChar(sel[i]))
+                break;
+            i += sel[i] === '\\' ? 2 : 1;
+        }
+        return i > from;
+    };
+    const readCompound = () => {
+        let pieces = 0;
+        if (i < n && sel[i] === '*') {
+            i++;
+            pieces++;
+        }
+        else if (i < n && (isIdentStart(sel[i]) || (sel[i] === '$' && sel[i + 1] === '{'))) {
+            const from = i;
+            if (!readIdent())
+                return false;
+            if (!plausibleTypeName(sel.slice(from, i)))
+                return false;
+            pieces++;
+        }
+        for (;;) {
+            const c = sel[i];
+            if (c === '#' || c === '.') {
+                i++;
+                if (!readIdent())
+                    return false;
+            }
+            else if (c === '[') {
+                if (!skipBalanced('[', ']'))
+                    return false;
+            }
+            else if (c === ':') {
+                i++;
+                if (sel[i] === ':')
+                    i++;
+                if (!readIdent())
+                    return false;
+                if (sel[i] === '(' && !skipBalanced('(', ')'))
+                    return false;
+            }
+            else
+                break;
+            pieces++;
+            qualified = true;
+        }
+        return pieces > 0;
+    };
+    skipWs();
+    if (i < n && '>+~'.indexOf(sel[i]) !== -1) {
+        i++;
+        qualified = true;
+        skipWs();
+    }
+    for (;;) {
+        if (!readCompound())
+            return false;
+        const hadWs = skipWs();
+        if (i >= n)
+            break;
+        const c = sel[i];
+        if (c === ',') {
+            i++;
+            skipWs();
+            continue;
+        }
+        if ('>+~'.indexOf(c) !== -1) {
+            i++;
+            qualified = true;
+            skipWs();
+            continue;
+        }
+        if (!hadWs)
+            return false;
+    }
+    return qualified;
 }
 function scanText(text, file) {
     const out = [];

package/dist/ingest.js.map

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

package/dist/nextStep.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Two fields an agent needs and a terminal does not: how sure the tool is about one
+ * proposed rewrite, and what to run next.
+ *
+ * Both are **derived**, never scored. Every value below is a rename of information the
+ * matcher already produced — `matchType`, `status`, the verdict ladder. Inventing a
+ * confidence index here would be the uncalibrated-judge anti-pattern wearing a
+ * deterministic tool's clothes: a number that looks like evidence, is not, and that a
+ * model would branch on precisely because it looks like one.
+ *
+ * A human reads the same facts off the terminal's own wording ("the element exists, only
+ * its class changed"). This is that sentence, in a field.
+ */
+/**
+ * How safe one proposed rewrite is.
+ *
+ * `ambiguous` is deliberately not a low number. A number invites a threshold, and a
+ * threshold over "17 candidates matched equally well" would let an agent apply one of
+ * them — the coin flip this package refuses everywhere else. It is a different *kind* of
+ * answer, so it gets a different word.
+ */
+export type Confidence = 'high' | 'medium' | 'ambiguous' | 'none';
+export interface ConfidenceInput {
+    status: string;
+    matchType?: 'exact' | 'fuzzy';
+    rebound?: boolean;
+}
+/**
+ * `rebound` deliberately does **not** lower confidence, and getting this backwards is
+ * easy enough that it is worth writing down.
+ *
+ * A first version treated the flag as "danger, do not touch" and zeroed out every rewrite
+ * carrying it — 12 of 401 on the reference corpus. That inverts its meaning. On a
+ * *contract row*, `match.js` sets `rebound` alongside `healable` when the old selector now
+ * resolves onto a **different** element and the original was re-identified elsewhere: the
+ * test is green today while clicking the wrong thing, and `old → new` is the repair that
+ * cures exactly that. It is the highest-value rewrite this tool produces.
+ *
+ * What `rebound` *does* is raise the verdict to BLOCK so a human sees it before it is
+ * applied. That is a gate concern, not a confidence one, and the flag travels on the row
+ * for anyone who needs it. (The `rebound` of `resolution.ts` is a different thing under
+ * the same name — there a test's own literal reaches a new element with nothing proving
+ * what it should reach, and it is never rewritten.)
+ */
+export declare function confidenceFor(row: ConfidenceInput): Confidence;
+export interface NextStep {
+    /** A command to run, or `null` when the honest answer is "not yours to run". */
+    next_command: string | null;
+    /** Why — one sentence, the same one the terminal prints. */
+    next: string;
+}
+/**
+ * What to do with this verdict.
+ *
+ * BLOCK returns a **null command**, and that is the load-bearing case. The console is
+ * where a human picks between candidates, and the skill forbids an agent from starting
+ * it (it blocks until a browser tab closes). Naming a command here that an agent must
+ * not run would put this file in direct conflict with that prohibition — so BLOCK says
+ * what it is instead: a decision, and not this caller's.
+ */
+export declare function nextStepFor(verdict: 'PASS' | 'FIX' | 'BLOCK', opts?: {
+    dirMode?: boolean;
+    systemicUnresolved?: boolean;
+}): NextStep;
+/**
+ * The version of the JSON these verbs emit.
+ *
+ * Added the day the first rename was refused. `healable` means two quantities — contract
+ * rows in `diff`, rewrite pairs in `fix` — and the terminal wording now separates them
+ * ("drifted" and "rewrites"). The *field names* deliberately did not move: the zero-install
+ * web tool reads `row.status === 'healable'` and `counts.healable` straight out of the same
+ * `match.js` that ships to npm, so renaming the status would blank that page unless both
+ * deploys landed together — silently, showing zero rows rather than an error.
+ *
+ * So the field names stay and this number exists, which is the honest trade: a consumer can
+ * pin it, and the day the rename is worth two coordinated deploys it becomes `2` instead of
+ * being a breaking change nobody was warned about.
+ */
+export declare const SCHEMA_VERSION = 1;

package/dist/nextStep.js

@@ -0,0 +1,107 @@
+"use strict";
+/**
+ * Two fields an agent needs and a terminal does not: how sure the tool is about one
+ * proposed rewrite, and what to run next.
+ *
+ * Both are **derived**, never scored. Every value below is a rename of information the
+ * matcher already produced — `matchType`, `status`, the verdict ladder. Inventing a
+ * confidence index here would be the uncalibrated-judge anti-pattern wearing a
+ * deterministic tool's clothes: a number that looks like evidence, is not, and that a
+ * model would branch on precisely because it looks like one.
+ *
+ * A human reads the same facts off the terminal's own wording ("the element exists, only
+ * its class changed"). This is that sentence, in a field.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SCHEMA_VERSION = void 0;
+exports.confidenceFor = confidenceFor;
+exports.nextStepFor = nextStepFor;
+/**
+ * `rebound` deliberately does **not** lower confidence, and getting this backwards is
+ * easy enough that it is worth writing down.
+ *
+ * A first version treated the flag as "danger, do not touch" and zeroed out every rewrite
+ * carrying it — 12 of 401 on the reference corpus. That inverts its meaning. On a
+ * *contract row*, `match.js` sets `rebound` alongside `healable` when the old selector now
+ * resolves onto a **different** element and the original was re-identified elsewhere: the
+ * test is green today while clicking the wrong thing, and `old → new` is the repair that
+ * cures exactly that. It is the highest-value rewrite this tool produces.
+ *
+ * What `rebound` *does* is raise the verdict to BLOCK so a human sees it before it is
+ * applied. That is a gate concern, not a confidence one, and the flag travels on the row
+ * for anyone who needs it. (The `rebound` of `resolution.ts` is a different thing under
+ * the same name — there a test's own literal reaches a new element with nothing proving
+ * what it should reach, and it is never rewritten.)
+ */
+function confidenceFor(row) {
+    switch (row.status) {
+        case 'ok':
+        case 'renamed':
+            // Nothing is being proposed, so nothing needs weighing.
+            return 'high';
+        case 'healable':
+            // The element survived and was re-identified. `exact` means role, name and context
+            // all still agree — the "only its class changed" case, which is a safe rewrite.
+            // `fuzzy` cleared the similarity threshold and is a proposal, not a certainty.
+            return row.matchType === 'fuzzy' ? 'medium' : 'high';
+        case 'ambiguous':
+            return 'ambiguous';
+        default:
+            // `lost`, `added`, and anything a future status introduces: no repair is on offer,
+            // so there is nothing to be confident about. Unknown statuses land here on purpose.
+            return 'none';
+    }
+}
+/**
+ * What to do with this verdict.
+ *
+ * BLOCK returns a **null command**, and that is the load-bearing case. The console is
+ * where a human picks between candidates, and the skill forbids an agent from starting
+ * it (it blocks until a browser tab closes). Naming a command here that an agent must
+ * not run would put this file in direct conflict with that prohibition — so BLOCK says
+ * what it is instead: a decision, and not this caller's.
+ */
+function nextStepFor(verdict, opts = {}) {
+    const scope = opts.dirMode === false ? '' : ' --dir';
+    if (opts.systemicUnresolved) {
+        // Ranked above the verdict on purpose: while a cross-page group is unexplained, every
+        // other number in the report is measured against a capture nobody has vouched for.
+        return {
+            next_command: `ia-qa-heal map && ia-qa-heal baseline`,
+            next: 'The same element moved on every page at once and the capture state cannot explain it. ' +
+                'Re-map and re-baseline so the next diff can tell an app change from a state difference — ' +
+                'or declare the state in config.prepare.',
+        };
+    }
+    switch (verdict) {
+        case 'PASS':
+            return { next_command: null, next: 'Nothing drifted. No action.' };
+        case 'FIX':
+            return {
+                next_command: `ia-qa-heal fix${scope} --dry-run`,
+                next: 'Every break has a deterministic rewrite. Read the plan, then run it again without --dry-run.',
+            };
+        case 'BLOCK':
+            return {
+                next_command: null,
+                next: 'A human decides. Nothing here is safe to rewrite — surface the rows and their file:line, ' +
+                    'and do not run `ia-qa-heal ui` yourself: it blocks until a browser tab is closed.',
+            };
+    }
+}
+/**
+ * The version of the JSON these verbs emit.
+ *
+ * Added the day the first rename was refused. `healable` means two quantities — contract
+ * rows in `diff`, rewrite pairs in `fix` — and the terminal wording now separates them
+ * ("drifted" and "rewrites"). The *field names* deliberately did not move: the zero-install
+ * web tool reads `row.status === 'healable'` and `counts.healable` straight out of the same
+ * `match.js` that ships to npm, so renaming the status would blank that page unless both
+ * deploys landed together — silently, showing zero rows rather than an error.
+ *
+ * So the field names stay and this number exists, which is the honest trade: a consumer can
+ * pin it, and the day the rename is worth two coordinated deploys it becomes `2` instead of
+ * being a breaking change nobody was warned about.
+ */
+exports.SCHEMA_VERSION = 1;
+//# sourceMappingURL=nextStep.js.map

package/dist/nextStep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nextStep.js","sourceRoot":"","sources":["../src/nextStep.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;;AAmCH,sCAkBC;AAkBD,kCAkCC;AAvFD;;;;;;;;;;;;;;;;GAgBG;AACH,SAAgB,aAAa,CAAC,GAAoB;IAChD,QAAQ,GAAG,CAAC,MAAM,EAAE,CAAC;QACnB,KAAK,IAAI,CAAC;QACV,KAAK,SAAS;YACZ,wDAAwD;YACxD,OAAO,MAAM,CAAC;QAChB,KAAK,UAAU;YACb,mFAAmF;YACnF,gFAAgF;YAChF,+EAA+E;YAC/E,OAAO,GAAG,CAAC,SAAS,KAAK,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC;QACvD,KAAK,WAAW;YACd,OAAO,WAAW,CAAC;QACrB;YACE,mFAAmF;YACnF,oFAAoF;YACpF,OAAO,MAAM,CAAC;IAClB,CAAC;AACH,CAAC;AASD;;;;;;;;GAQG;AACH,SAAgB,WAAW,CACzB,OAAiC,EACjC,OAA4D,EAAE;IAE9D,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;IAErD,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC5B,sFAAsF;QACtF,mFAAmF;QACnF,OAAO;YACL,YAAY,EAAE,uCAAuC;YACrD,IAAI,EACF,wFAAwF;gBACxF,2FAA2F;gBAC3F,yCAAyC;SAC5C,CAAC;IACJ,CAAC;IAED,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,MAAM;YACT,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,IAAI,EAAE,6BAA6B,EAAE,CAAC;QACrE,KAAK,KAAK;YACR,OAAO;gBACL,YAAY,EAAE,iBAAiB,KAAK,YAAY;gBAChD,IAAI,EAAE,8FAA8F;aACrG,CAAC;QACJ,KAAK,OAAO;YACV,OAAO;gBACL,YAAY,EAAE,IAAI;gBAClB,IAAI,EACF,2FAA2F;oBAC3F,mFAAmF;aACtF,CAAC;IACN,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;GAaG;AACU,QAAA,cAAc,GAAG,CAAC,CAAC"}

package/dist/systemicDelta.d.ts

@@ -0,0 +1,129 @@
+import { CaptureState, StateComparison } from './captureState';
+/**
+ * The same element missing from every page is one fact, not one fact per page.
+ *
+ * Measured on a 142-page app whose suite was green and whose site was sound:
+ * `diff --dir` returned ⛔ BLOCK on 139 of 142 pages, 288 `lost` rows, exactly two
+ * per page. Behind all 288: two buttons of a cookie banner, present in a baseline
+ * captured before consent and absent from a capture taken after it. The app had not
+ * moved. Nobody triages 288 rows to find that out, and a gate that shouts on a
+ * healthy app is a gate that gets turned off.
+ *
+ * This module is the missing half of a de-duplication the package already performs
+ * twice elsewhere — `check` collapses a finding repeated across pages ("a navbar on
+ * 142 pages is one fix, not 142 findings") and `_layouts/` lifts the shared shell out
+ * of the contracts structurally. Neither reaches the *verdict*, which is where the
+ * cost lands.
+ *
+ * **What it is not.** It is not a filter on noisy rows, and it is emphatically not
+ * driven by `usage.json`. The first version of this idea held out rows no test
+ * referenced; on the very corpus that motivated it, `usage.names` held both `reject`
+ * and `accept all` — a spec tests that banner on purpose — so the rule would have
+ * fired on nothing at all. What separates the two cases is not who references the
+ * element; it is that *one page's worth of change explains every page's rows*.
+ *
+ * **Why it lives outside `src/browser/match.js`**, like `nameDrift.ts` and
+ * `nameMask.ts`: that file ships twice (npm + the zero-install web tool), stays
+ * dependency-free, and — decisively here — compares exactly two pages. A cross-page
+ * fact is unrepresentable there. The same boundary is why the MCP tools
+ * `diff_mappings` and `fix_tests` are out of scope rather than divergent: they take
+ * two files, and two files cannot show that something is true of every page. With
+ * one page compared, this module returns no groups, so a single-page `diff` is
+ * bit-for-bit what it was before.
+ */
+export interface SystemicRowLike {
+    status: string;
+    role?: string;
+    name?: string;
+    rebound?: boolean;
+}
+export interface SystemicReportLike {
+    verdict: 'PASS' | 'FIX' | 'BLOCK';
+    counts: Record<string, number>;
+    rows: SystemicRowLike[];
+    added: SystemicRowLike[];
+}
+export interface SystemicPageLike {
+    name: string;
+    report: SystemicReportLike;
+    isLayout: boolean;
+}
+export interface SystemicGroup {
+    /** `lost` — gone from every page. `added` — appeared on every page. */
+    kind: 'lost' | 'added';
+    role: string;
+    name: string;
+    /** The pages carrying this row, in walk order. */
+    pages: string[];
+    /**
+     * Pages whose contract holds this element at all — the denominator. A control that
+     * only ever existed on the 40 tool pages is systemic when it leaves all 40, not
+     * when it leaves 40 of 142.
+     */
+    seenOn: number;
+}
+/**
+ * Whether the groups were held out of the verdict, and on what evidence.
+ *
+ * `in-verdict` is not a failure mode — it is the honest answer whenever the capture
+ * state cannot exonerate the app. A navbar the app really deleted produces exactly
+ * the same rows as a banner that was merely dismissed, and letting that through as a
+ * pass is worse than every false BLOCK this module exists to remove.
+ */
+export type SystemicPolicy = 'held-out' | 'in-verdict';
+export interface SystemicOutcome {
+    groups: SystemicGroup[];
+    policy: SystemicPolicy;
+    /** How the two moments' capture state compared — the reason for the policy. */
+    state: StateComparison;
+    baselineState?: CaptureState;
+    currentState?: CaptureState;
+}
+/**
+ * A group must cover this many pages before it can be called systemic.
+ *
+ * Below it the collapse buys nothing (five rows is a list, not a wall) while still
+ * costing the ability to see them per page. It also keeps small projects — a
+ * three-page app where everything is on every page — entirely out of this code path.
+ */
+export declare const MIN_PAGES = 5;
+/**
+ * …and this share of the pages that held the element. Deliberately not 1.0: one page
+ * whose capture happened to catch the banner mid-animation should not turn a
+ * 142-page fact back into 142 facts.
+ */
+export declare const MIN_SHARE = 0.9;
+/**
+ * Find the cross-page groups. Pure — no policy, no state, no I/O.
+ *
+ * Layout pages are excluded from both numerator and denominator: `_layouts/` already
+ * holds one row for the whole shell, so counting it would let a single layout row
+ * pull a group over the threshold on its own.
+ */
+export declare function findSystemicGroups(pages: SystemicPageLike[]): SystemicGroup[];
+/**
+ * Detection plus policy.
+ *
+ * The policy is one line and it carries the whole risk of the feature: a group leaves
+ * the verdict **only** when the two captures are known to have run under different
+ * browser state. Identical state means the app really did change — that is a finding,
+ * collapsed to one row but still red. Unknown state (any baseline written before
+ * fingerprints existed) is also red, because "I cannot tell" and "they match" must
+ * not lead to the same place.
+ */
+export declare function assessSystemic(pages: SystemicPageLike[], baselineState?: CaptureState, currentState?: CaptureState): SystemicOutcome;
+/**
+ * Remove the held-out rows and re-derive each page's verdict.
+ *
+ * Returns fresh report objects: the caller's reports are the ones the HTML report and
+ * the JUnit writer read, and mutating them in place would make the collapse depend on
+ * which consumer ran first. Counts are recomputed from the surviving rows rather than
+ * decremented, so a status this module does not know about cannot silently skew them.
+ *
+ * `total` is left alone on purpose. It is the size of the baseline contract, not a
+ * tally of rows — lowering it would quietly shrink the denominator every coverage
+ * line in the tool is computed against.
+ */
+export declare function applySystemic(pages: SystemicPageLike[], outcome: SystemicOutcome): SystemicPageLike[];
+/** One line for the terminal and the report, or null when nothing is systemic. */
+export declare function systemicHeadline(outcome: SystemicOutcome): string | null;