@ia-qa/self-healing 0.1.0

package/dist/browser/contract.js

@@ -0,0 +1,107 @@
+"use strict";
+/**
+ * Page contract as Markdown — the framework- and language-agnostic artifact an
+ * LLM reads to auto-heal a broken UI test.
+ *
+ * Pure, dependency-free JS (no imports, no fs) so both the CLI and ia-qa.com's
+ * web tool render byte-identical contracts from the same mapping. The CLI writes
+ * the result to `<page>.md`; the browser offers it as a download.
+ *
+ * The workflow it enables: `map` emits `<page>.json` (for tooling / diff) AND
+ * `<page>.md` (for a model). When a Cypress/Playwright/Selenium test breaks in
+ * CI, you hand the failing test file + this `.md` to an LLM: it finds the element
+ * by role + accessible name, reads the current selector, and rewrites the test in
+ * whatever framework/language it is written in. The self-describing header tells
+ * the model how to use the file.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderPageContract = renderPageContract;
+const ROLE_ORDER = [
+    'textbox',
+    'combobox',
+    'checkbox',
+    'radio',
+    'slider',
+    'button',
+    'link',
+    'tab',
+    'menuitem',
+];
+function escapeCell(s) {
+    return (s || '').replace(/\|/g, '\\|').replace(/\n/g, ' ');
+}
+function groupByRole(elements) {
+    const groups = new Map();
+    for (const el of elements) {
+        const list = groups.get(el.role);
+        if (list)
+            list.push(el);
+        else
+            groups.set(el.role, [el]);
+    }
+    const roles = Array.from(groups.keys()).sort((a, b) => {
+        const ia = ROLE_ORDER.indexOf(a);
+        const ib = ROLE_ORDER.indexOf(b);
+        if (ia === -1 && ib === -1)
+            return a.localeCompare(b);
+        if (ia === -1)
+            return 1;
+        if (ib === -1)
+            return -1;
+        return ia - ib;
+    });
+    const ordered = new Map();
+    for (const role of roles)
+        ordered.set(role, groups.get(role));
+    return ordered;
+}
+function renderPageContract(mapping) {
+    const page = mapping.page || 'page';
+    const url = mapping.url || '';
+    const capturedAt = mapping.capturedAt || '';
+    const elements = (mapping && mapping.elements) || [];
+    const groups = groupByRole(elements);
+    const lines = [];
+    lines.push('# Page contract — ' + page);
+    lines.push('');
+    lines.push('- **URL:** `' + url + '`');
+    lines.push('- **Captured:** ' + capturedAt);
+    lines.push('- **Interactive elements:** ' + elements.length);
+    lines.push('');
+    lines.push('> Generated by `@ia-qa/self-healing`. This file is the **current source of truth** for the');
+    lines.push('> selectors on this page. **To heal a broken UI test** (any framework — Cypress, Playwright,');
+    lines.push('> Selenium… — any language): find the element below by its **role** and **accessible name**,');
+    lines.push('> then replace the stale selector in the test with the current `selector`. If an element from');
+    lines.push('> the test is absent here, it was removed or renamed — flag it instead of guessing.');
+    lines.push('');
+    if (elements.length === 0) {
+        lines.push('_No visible interactive elements were captured on this page._');
+        lines.push('');
+        return lines.join('\n');
+    }
+    const anyContext = elements.some((el) => el.context);
+    for (const [role, els] of groups) {
+        lines.push('## ' + role + ' (' + els.length + ')');
+        lines.push('');
+        if (anyContext) {
+            lines.push('| Accessible name | Context | Selector |');
+            lines.push('| --- | --- | --- |');
+            for (const el of els) {
+                const name = el.name ? escapeCell(el.name) : '_(no accessible name)_';
+                const ctx = el.context ? escapeCell(el.context) : '—';
+                lines.push('| ' + name + ' | ' + ctx + ' | `' + escapeCell(el.selector) + '` |');
+            }
+        }
+        else {
+            lines.push('| Accessible name | Selector |');
+            lines.push('| --- | --- |');
+            for (const el of els) {
+                const name = el.name ? escapeCell(el.name) : '_(no accessible name)_';
+                lines.push('| ' + name + ' | `' + escapeCell(el.selector) + '` |');
+            }
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=contract.js.map

package/dist/browser/contract.js.map

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

package/dist/browser/extract.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Accessibility-oriented DOM extraction — the single source of truth.
+ *
+ * This function is used three ways and MUST stay self-contained (no imports, no
+ * closures over module scope, no TypeScript syntax):
+ *   1. `ia-qa-heal map` passes it to Playwright's `page.evaluate()`, which
+ *      serializes it via `toString()` and injects it into the page.
+ *   2. The healer re-runs it on the live page to find healing candidates.
+ *   3. ia-qa.com imports this file with `?raw` and shows it as a copy-paste
+ *      DevTools snippet, so the zero-install flow produces byte-identical
+ *      mappings to the CLI.
+ *
+ * Any dependency added here silently breaks (1) and (3).
+ *
+ * `page.accessibility.snapshot()` is deprecated and returns nodes *without any
+ * selector*, which makes it useless for a mapping meant to drive clicks. We walk
+ * the DOM ourselves and compute, per visible interactive element: its ARIA role,
+ * its accessible name (accname priority order), and a stable selector.
+ */
+export function extractInPage(): {
+    role: any;
+    name: string;
+    selector: string;
+    context: string;
+}[];

package/dist/browser/extract.js

@@ -0,0 +1,194 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractInPage = extractInPage;
+/**
+ * Accessibility-oriented DOM extraction — the single source of truth.
+ *
+ * This function is used three ways and MUST stay self-contained (no imports, no
+ * closures over module scope, no TypeScript syntax):
+ *   1. `ia-qa-heal map` passes it to Playwright's `page.evaluate()`, which
+ *      serializes it via `toString()` and injects it into the page.
+ *   2. The healer re-runs it on the live page to find healing candidates.
+ *   3. ia-qa.com imports this file with `?raw` and shows it as a copy-paste
+ *      DevTools snippet, so the zero-install flow produces byte-identical
+ *      mappings to the CLI.
+ *
+ * Any dependency added here silently breaks (1) and (3).
+ *
+ * `page.accessibility.snapshot()` is deprecated and returns nodes *without any
+ * selector*, which makes it useless for a mapping meant to drive clicks. We walk
+ * the DOM ourselves and compute, per visible interactive element: its ARIA role,
+ * its accessible name (accname priority order), and a stable selector.
+ */
+function extractInPage() {
+    const INTERACTIVE_SELECTOR = [
+        'button',
+        'a[href]',
+        'input:not([type="hidden"])',
+        'select',
+        'textarea',
+        '[role="button"]',
+        '[role="link"]',
+        '[role="textbox"]',
+        '[role="combobox"]',
+        '[role="checkbox"]',
+        '[role="radio"]',
+        '[role="menuitem"]',
+        '[role="tab"]',
+        '[onclick]',
+    ].join(', ');
+    function isVisible(el) {
+        const rect = el.getBoundingClientRect();
+        if (rect.width === 0 || rect.height === 0)
+            return false;
+        const style = window.getComputedStyle(el);
+        return style.visibility !== 'hidden' && style.display !== 'none' && style.opacity !== '0';
+    }
+    function role(el) {
+        const explicit = el.getAttribute('role');
+        if (explicit)
+            return explicit;
+        const tag = el.tagName.toLowerCase();
+        if (tag === 'a')
+            return 'link';
+        if (tag === 'button')
+            return 'button';
+        if (tag === 'select')
+            return 'combobox';
+        if (tag === 'textarea')
+            return 'textbox';
+        if (tag === 'input') {
+            const type = el.type;
+            if (type === 'checkbox')
+                return 'checkbox';
+            if (type === 'radio')
+                return 'radio';
+            if (type === 'submit' || type === 'button' || type === 'reset')
+                return 'button';
+            if (type === 'range')
+                return 'slider';
+            return 'textbox';
+        }
+        return 'generic';
+    }
+    function accessibleName(el) {
+        const clean = (s) => (s == null ? '' : String(s)).trim().replace(/\s+/g, ' ').slice(0, 120);
+        const ariaLabel = el.getAttribute('aria-label');
+        if (ariaLabel)
+            return clean(ariaLabel);
+        const labelledBy = el.getAttribute('aria-labelledby');
+        if (labelledBy) {
+            const joined = labelledBy
+                .split(/\s+/)
+                .map((id) => {
+                const node = document.getElementById(id);
+                return node ? node.textContent : '';
+            })
+                .join(' ');
+            if (clean(joined))
+                return clean(joined);
+        }
+        const tag = el.tagName.toLowerCase();
+        if (tag === 'input' || tag === 'textarea' || tag === 'select') {
+            const label = el.labels && el.labels.length > 0 ? el.labels[0].textContent : '';
+            if (clean(label))
+                return clean(label);
+            if (tag === 'input' && ['submit', 'button', 'reset'].indexOf(el.type) !== -1 && el.value) {
+                return clean(el.value);
+            }
+            const placeholder = el.getAttribute('placeholder');
+            if (placeholder)
+                return clean(placeholder);
+            const nameAttr = el.getAttribute('name');
+            if (nameAttr)
+                return clean(nameAttr);
+        }
+        const title = el.getAttribute('title');
+        const text = clean(el.textContent);
+        return text || clean(title);
+    }
+    function stableSelector(el) {
+        const testId = el.getAttribute('data-testid') || el.getAttribute('data-test-id');
+        if (testId)
+            return '[data-testid="' + testId + '"]';
+        if (el.id)
+            return el.tagName.toLowerCase() + '#' + CSS.escape(el.id);
+        const nameAttr = el.getAttribute('name');
+        if (nameAttr)
+            return el.tagName.toLowerCase() + '[name="' + nameAttr + '"]';
+        const parts = [];
+        let node = el;
+        while (node && node !== document.body && parts.length < 5) {
+            if (node.id) {
+                parts.unshift('#' + CSS.escape(node.id));
+                break;
+            }
+            let part = node.tagName.toLowerCase();
+            const parent = node.parentElement;
+            if (parent) {
+                const current = node;
+                const sameTag = Array.prototype.filter.call(parent.children, (c) => c.tagName === current.tagName);
+                if (sameTag.length > 1)
+                    part += ':nth-of-type(' + (sameTag.indexOf(current) + 1) + ')';
+            }
+            parts.unshift(part);
+            node = parent;
+        }
+        return parts.join(' > ');
+    }
+    const LANDMARK_TAGS = { MAIN: 'main', NAV: 'nav', HEADER: 'banner', FOOTER: 'contentinfo', ASIDE: 'complementary', FORM: 'form' };
+    const LANDMARK_ROLES = ['main', 'navigation', 'banner', 'contentinfo', 'complementary', 'form', 'search', 'region', 'dialog'];
+    function clean(s) {
+        return (s == null ? '' : String(s)).trim().replace(/\s+/g, ' ').slice(0, 80);
+    }
+    // Disambiguating context: what container this element lives in, so two elements
+    // with the same role + accessible name (e.g. many "Delete" buttons) stay
+    // distinguishable. We surface the nearest landmark and the nearest section
+    // heading — both human-meaningful and stable against class/id churn.
+    function context(el) {
+        let landmark = '';
+        let node = el.parentElement;
+        while (node && node !== document.body) {
+            const roleAttr = node.getAttribute('role');
+            if (roleAttr && LANDMARK_ROLES.indexOf(roleAttr) !== -1) {
+                landmark = clean(node.getAttribute('aria-label')) || roleAttr;
+                break;
+            }
+            if (LANDMARK_TAGS[node.tagName]) {
+                landmark = clean(node.getAttribute('aria-label')) || LANDMARK_TAGS[node.tagName];
+                break;
+            }
+            node = node.parentElement;
+        }
+        // Nearest heading that precedes the element in document order.
+        let heading = '';
+        const headings = document.querySelectorAll('h1, h2, h3, h4, h5, h6, [role="heading"]');
+        for (let i = headings.length - 1; i >= 0; i--) {
+            const h = headings[i];
+            const pos = h.compareDocumentPosition(el);
+            if (pos & Node.DOCUMENT_POSITION_FOLLOWING) {
+                heading = clean(h.textContent);
+                if (heading)
+                    break;
+            }
+        }
+        if (landmark && heading)
+            return landmark + ' › ' + heading;
+        return landmark || heading || '';
+    }
+    const seen = {};
+    const elements = [];
+    const found = document.querySelectorAll(INTERACTIVE_SELECTOR);
+    for (let i = 0; i < found.length; i++) {
+        const el = found[i];
+        if (!isVisible(el))
+            continue;
+        const selector = stableSelector(el);
+        if (seen[selector])
+            continue;
+        seen[selector] = true;
+        elements.push({ role: role(el), name: accessibleName(el), selector: selector, context: context(el) });
+    }
+    return elements;
+}
+//# sourceMappingURL=extract.js.map

package/dist/browser/extract.js.map

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

package/dist/browser/match.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Semantic matching + mapping diff — shared by the Playwright healer and by the
+ * zero-install web flow on ia-qa.com.
+ *
+ * Plain, dependency-free JS so the browser can import it as-is. Keep it that way:
+ * if the healer and the web tool ever compute different matches, a selector that
+ * ia-qa.com reports as "auto-healable" would still fail in CI, which is worse
+ * than reporting nothing.
+ */
+export function normalize(s: any): string;
+/** Sørensen–Dice similarity over character bigrams. */
+export function diceSimilarity(a: any, b: any): number;
+/**
+ * Resolve `target` against live `candidates`. Returns one of:
+ *   - { matched: true, selector, score, matchType, name, disambiguatedBy? }
+ *   - { ambiguous: true, count }  — several equally-good elements; refuse to
+ *     guess (healing the wrong one is worse than failing). A human decides.
+ *   - null — no candidate matches.
+ *
+ * Disambiguation: when role + accessible name collide (many "Delete" buttons),
+ * the element's `context` (nearest landmark + section heading) breaks the tie.
+ * If context can't reduce it to one, we return `ambiguous` rather than pick.
+ */
+export function matchElement(target: any, candidates: any): {
+    ambiguous: boolean;
+    count: any;
+    matched?: undefined;
+    selector?: undefined;
+    score?: undefined;
+    matchType?: undefined;
+    name?: undefined;
+    disambiguatedBy?: undefined;
+} | {
+    matched: boolean;
+    selector: any;
+    score: any;
+    matchType: string;
+    name: any;
+    disambiguatedBy: string | undefined;
+    ambiguous?: undefined;
+    count?: undefined;
+} | {
+    matched: boolean;
+    selector: any;
+    score: any;
+    matchType: string;
+    name: any;
+    ambiguous?: undefined;
+    count?: undefined;
+    disambiguatedBy?: undefined;
+} | null;
+/** Healer-facing shim: selector only when unambiguously matched, else null. */
+export function heuristicMatch(target: any, candidates: any): any;
+/**
+ * Diff a baseline mapping against a current one and produce a CI-style verdict.
+ *
+ * Per baseline element:
+ * - `ok`        — selector still resolves and the accessible name is unchanged
+ * - `renamed`   — selector still resolves but the accessible name changed. The
+ *                 test still PASSES, but this is a *content* drift (i18n / copy /
+ *                 a real product change) a human should eyeball — opposite of a
+ *                 structural break.
+ * - `healable`  — selector is gone, but role + name (+ context) still identify
+ *                 exactly one element → deterministic old→new rewrite
+ * - `ambiguous` — selector is gone and several elements match equally; healing
+ *                 would be a guess, so we refuse and hand it to a human
+ * - `lost`      — selector is gone and nothing matches: the test will hard-fail
+ * - `added`     — element present now, absent from the baseline
+ *
+ * Verdict (drives the CI exit code): BLOCK if anything is lost or ambiguous,
+ * FIX if anything is only healable, else PASS (renamed does not fail the gate —
+ * the test still runs — but is surfaced for review).
+ */
+export function diffMappings(before: any, after: any): {
+    verdict: string;
+    counts: {
+        total: any;
+        ok: any;
+        renamed: any;
+        healable: any;
+        ambiguous: any;
+        lost: any;
+        added: any;
+    };
+    rows: any;
+    added: any;
+};
+export const FUZZY_THRESHOLD: 0.6;

package/dist/browser/match.js

@@ -0,0 +1,179 @@
+"use strict";
+/**
+ * Semantic matching + mapping diff — shared by the Playwright healer and by the
+ * zero-install web flow on ia-qa.com.
+ *
+ * Plain, dependency-free JS so the browser can import it as-is. Keep it that way:
+ * if the healer and the web tool ever compute different matches, a selector that
+ * ia-qa.com reports as "auto-healable" would still fail in CI, which is worse
+ * than reporting nothing.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FUZZY_THRESHOLD = void 0;
+exports.normalize = normalize;
+exports.diceSimilarity = diceSimilarity;
+exports.matchElement = matchElement;
+exports.heuristicMatch = heuristicMatch;
+exports.diffMappings = diffMappings;
+function normalize(s) {
+    return (s == null ? '' : String(s)).toLowerCase().trim().replace(/\s+/g, ' ');
+}
+/** Sørensen–Dice similarity over character bigrams. */
+function diceSimilarity(a, b) {
+    if (!a || !b)
+        return 0;
+    if (a === b)
+        return 1;
+    if (a.length < 2 || b.length < 2)
+        return 0;
+    const bigrams = (s) => {
+        const map = new Map();
+        for (let i = 0; i < s.length - 1; i++) {
+            const bg = s.slice(i, i + 2);
+            map.set(bg, (map.get(bg) || 0) + 1);
+        }
+        return map;
+    };
+    const aBigrams = bigrams(a);
+    const bBigrams = bigrams(b);
+    let overlap = 0;
+    for (const [bg, count] of aBigrams) {
+        overlap += Math.min(count, bBigrams.get(bg) || 0);
+    }
+    return (2 * overlap) / (a.length - 1 + b.length - 1);
+}
+exports.FUZZY_THRESHOLD = 0.6;
+/**
+ * Resolve `target` against live `candidates`. Returns one of:
+ *   - { matched: true, selector, score, matchType, name, disambiguatedBy? }
+ *   - { ambiguous: true, count }  — several equally-good elements; refuse to
+ *     guess (healing the wrong one is worse than failing). A human decides.
+ *   - null — no candidate matches.
+ *
+ * Disambiguation: when role + accessible name collide (many "Delete" buttons),
+ * the element's `context` (nearest landmark + section heading) breaks the tie.
+ * If context can't reduce it to one, we return `ambiguous` rather than pick.
+ */
+function matchElement(target, candidates) {
+    const sameRole = candidates.filter((c) => c.role === target.role);
+    const wanted = normalize(target.name);
+    const wantedCtx = normalize(target.context);
+    const exact = sameRole.filter((c) => normalize(c.name) === wanted && wanted !== '');
+    const exactPick = disambiguate(exact, wantedCtx);
+    if (exactPick.one) {
+        return { matched: true, selector: exactPick.one.selector, score: 1, matchType: 'exact', name: exactPick.one.name, disambiguatedBy: exactPick.by };
+    }
+    if (exactPick.ambiguous)
+        return { ambiguous: true, count: exact.length };
+    const scored = sameRole
+        .map((c) => ({ c, score: diceSimilarity(normalize(c.name), wanted) }))
+        .filter((x) => x.score >= exports.FUZZY_THRESHOLD)
+        .sort((a, b) => b.score - a.score);
+    if (scored.length === 0)
+        return null;
+    const top = scored[0].score;
+    const tied = scored.filter((x) => top - x.score < 0.05).map((x) => x.c);
+    const fuzzyPick = disambiguate(tied, wantedCtx);
+    if (fuzzyPick.one) {
+        const chosen = scored.find((x) => x.c === fuzzyPick.one);
+        return { matched: true, selector: fuzzyPick.one.selector, score: chosen.score, matchType: 'fuzzy', name: fuzzyPick.one.name, disambiguatedBy: fuzzyPick.by };
+    }
+    if (fuzzyPick.ambiguous)
+        return { ambiguous: true, count: tied.length };
+    return { matched: true, selector: scored[0].c.selector, score: top, matchType: 'fuzzy', name: scored[0].c.name };
+}
+/**
+ * Reduce a set of same-name candidates to one.
+ * - 0 → { one: null }
+ * - 1 → { one }
+ * - >1 → try context: exactly one shares the target context → { one, by:'context' };
+ *        otherwise { ambiguous: true }.
+ */
+function disambiguate(cands, wantedCtx) {
+    if (cands.length === 0)
+        return { one: null };
+    if (cands.length === 1)
+        return { one: cands[0] };
+    if (wantedCtx) {
+        const byCtx = cands.filter((c) => normalize(c.context) === wantedCtx);
+        if (byCtx.length === 1)
+            return { one: byCtx[0], by: 'context' };
+    }
+    return { ambiguous: true };
+}
+/** Healer-facing shim: selector only when unambiguously matched, else null. */
+function heuristicMatch(target, candidates) {
+    const match = matchElement(target, candidates);
+    return match && match.matched ? match.selector : null;
+}
+/**
+ * Diff a baseline mapping against a current one and produce a CI-style verdict.
+ *
+ * Per baseline element:
+ * - `ok`        — selector still resolves and the accessible name is unchanged
+ * - `renamed`   — selector still resolves but the accessible name changed. The
+ *                 test still PASSES, but this is a *content* drift (i18n / copy /
+ *                 a real product change) a human should eyeball — opposite of a
+ *                 structural break.
+ * - `healable`  — selector is gone, but role + name (+ context) still identify
+ *                 exactly one element → deterministic old→new rewrite
+ * - `ambiguous` — selector is gone and several elements match equally; healing
+ *                 would be a guess, so we refuse and hand it to a human
+ * - `lost`      — selector is gone and nothing matches: the test will hard-fail
+ * - `added`     — element present now, absent from the baseline
+ *
+ * Verdict (drives the CI exit code): BLOCK if anything is lost or ambiguous,
+ * FIX if anything is only healable, else PASS (renamed does not fail the gate —
+ * the test still runs — but is surfaced for review).
+ */
+function diffMappings(before, after) {
+    const beforeElements = (before && before.elements) || [];
+    const afterElements = (after && after.elements) || [];
+    const afterBySelector = new Map(afterElements.map((e) => [e.selector, e]));
+    const beforeSelectors = new Set(beforeElements.map((e) => e.selector));
+    const rows = beforeElements.map((el) => {
+        const still = afterBySelector.get(el.selector);
+        if (still) {
+            if (normalize(still.name) === normalize(el.name)) {
+                return { status: 'ok', role: el.role, name: el.name, selector: el.selector, context: el.context };
+            }
+            return { status: 'renamed', role: el.role, name: el.name, selector: el.selector, context: el.context, newName: still.name };
+        }
+        const match = matchElement(el, afterElements);
+        if (match && match.matched) {
+            return {
+                status: 'healable',
+                role: el.role,
+                name: el.name,
+                selector: el.selector,
+                context: el.context,
+                healedSelector: match.selector,
+                healedName: match.name,
+                score: match.score,
+                matchType: match.matchType,
+                disambiguatedBy: match.disambiguatedBy,
+            };
+        }
+        if (match && match.ambiguous) {
+            return { status: 'ambiguous', role: el.role, name: el.name, selector: el.selector, context: el.context, candidateCount: match.count };
+        }
+        return { status: 'lost', role: el.role, name: el.name, selector: el.selector, context: el.context };
+    });
+    const healedSelectors = new Set(rows.filter((r) => r.status === 'healable').map((r) => r.healedSelector));
+    const added = afterElements
+        .filter((el) => !beforeSelectors.has(el.selector) && !healedSelectors.has(el.selector))
+        .map((el) => ({ status: 'added', role: el.role, name: el.name, selector: el.selector, context: el.context }));
+    const count = (s) => rows.filter((r) => r.status === s).length;
+    const counts = {
+        total: beforeElements.length,
+        ok: count('ok'),
+        renamed: count('renamed'),
+        healable: count('healable'),
+        ambiguous: count('ambiguous'),
+        lost: count('lost'),
+        added: added.length,
+    };
+    const verdict = counts.lost > 0 || counts.ambiguous > 0 ? 'BLOCK' : counts.healable > 0 ? 'FIX' : 'PASS';
+    return { verdict, counts, rows, added };
+}
+//# sourceMappingURL=match.js.map

package/dist/browser/match.js.map

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

package/dist/cli/diff.d.ts

@@ -0,0 +1,13 @@
+/**
+ * `ia-qa-heal diff <baseline.json> <current.json>` — CI-gate verdict.
+ *
+ * Reads two mappings (produced by `ia-qa-heal map` or the browser snippet on
+ * ia-qa.com) and reports which selectors survived, which the runtime healer
+ * would recover, and which will hard-fail. Same engine as the web tool.
+ *
+ * Exit codes (so a pipeline can gate on it):
+ *   0 — PASS, or FIX without `--strict`
+ *   1 — BLOCK (a selector broke with no semantic match), or FIX with `--strict`
+ *   2 — bad usage / unreadable input
+ */
+export declare function runDiff(args: string[]): Promise<void>;