playwright-locator-healer 0.1.3

package/dist/healing/overlay/inject.js

@@ -0,0 +1,277 @@
+import { DOCK_CSS } from './dock.css.js';
+import { renderDock } from './dock.html.js';
+import { BINDING_NAME } from './bridge.js';
+import { mountDrag } from './drag.js';
+import { mountKeybinds } from './keybinds.js';
+const pageOverlayState = new WeakMap();
+/**
+ * Inject the heal overlay (shadow host + dock UI + drag + keybinds) into
+ * the given Playwright page. Idempotent per page: subsequent calls reuse
+ * the same message queue. The returned handle owns the lifecycle.
+ *
+ * @param page - Playwright `Page` to inject into.
+ * @returns Handle the orchestrator uses to drive the overlay.
+ */
+export async function injectOverlay(page) {
+    let state = pageOverlayState.get(page);
+    if (!state) {
+        state = { queue: [], waiters: [], abortHandler: null };
+        pageOverlayState.set(page, state);
+        const s = state;
+        await page.exposeBinding(BINDING_NAME, (_src, msg) => {
+            // Out-of-band abort: if a handler is registered, give it first refusal.
+            if (s.abortHandler && s.abortHandler(msg))
+                return;
+            const w = s.waiters.shift();
+            if (w)
+                w(msg);
+            else
+                s.queue.push(msg);
+        });
+    }
+    const { queue, waiters } = state;
+    await page.evaluate(({ css, html }) => {
+        const host = document.createElement('div');
+        host.id = '__heal_host__';
+        document.documentElement.appendChild(host);
+        const root = host.attachShadow({ mode: 'open' });
+        window.__healOverlay_root = root;
+        const style = document.createElement('style');
+        style.textContent = css;
+        root.appendChild(style);
+        const container = document.createElement('div');
+        container.id = '__heal_container__';
+        container.innerHTML = html;
+        root.appendChild(container);
+        const send = (msg) => window.__healOverlay_send(msg);
+        let picking = false;
+        let lastEl = null;
+        let lastOutline = '';
+        let lastOffset = '';
+        let lastBoxShadow = '';
+        const hl = (el) => {
+            if (lastEl) {
+                lastEl.style.outline = lastOutline;
+                lastEl.style.outlineOffset = lastOffset;
+                lastEl.style.boxShadow = lastBoxShadow;
+            }
+            lastEl = el instanceof HTMLElement ? el : null;
+            if (lastEl) {
+                lastOutline = lastEl.style.outline;
+                lastOffset = lastEl.style.outlineOffset;
+                lastBoxShadow = lastEl.style.boxShadow;
+                lastEl.style.outline = '2px solid #c7ff00';
+                lastEl.style.outlineOffset = '2px';
+                lastEl.style.boxShadow = '0 0 0 6px rgba(199,255,0,0.18)';
+            }
+        };
+        const xpathFor = (el) => {
+            const segs = [];
+            for (let n = el; n && n.nodeType === 1; n = n.parentElement) {
+                let i = 1;
+                for (let s = n.previousElementSibling; s; s = s.previousElementSibling)
+                    if (s.tagName === n.tagName)
+                        i++;
+                segs.unshift(`${n.tagName.toLowerCase()}[${i}]`);
+            }
+            return '/' + segs.join('/');
+        };
+        const isTooBroad = (el) => {
+            if (!el)
+                return true;
+            const tag = el.tagName.toLowerCase();
+            return tag === 'html' || tag === 'body';
+        };
+        document.addEventListener('mousemove', (e) => {
+            if (!picking)
+                return;
+            const el = e.target;
+            if (!el || host.contains(el) || isTooBroad(el)) {
+                hl(null);
+                return;
+            }
+            hl(el);
+        }, true);
+        const summarise = (el) => {
+            const tag = el.tagName.toLowerCase();
+            const attrs = [];
+            for (const a of Array.from(el.attributes)) {
+                if (a.name === 'style')
+                    continue;
+                const v = a.value.length > 60 ? a.value.slice(0, 60) + '…' : a.value;
+                attrs.push(`${a.name}="${v}"`);
+            }
+            const text = (el.textContent ?? '').trim().replace(/\s+/g, ' ').slice(0, 80);
+            const open = `<${tag}${attrs.length ? ' ' + attrs.join(' ') : ''}>`;
+            return text ? `${open}${text}${text.length === 80 ? '…' : ''}</${tag}>` : `${open}…</${tag}>`;
+        };
+        document.addEventListener('click', (e) => {
+            if (!picking)
+                return;
+            // P2-6: composedPath() pierces open shadow DOM so we capture the
+            // deepest non-overlay element instead of the shadow host.
+            // P2-7: when the path's deepest element has a closed shadowRoot (or
+            // we cannot reach past the host), surface a clear shadow-unsupported
+            // marker so the orchestrator can throw a typed HealingError.
+            const path = (e.composedPath ? e.composedPath() : [e.target]);
+            let target = null;
+            for (const node of path) {
+                const el = node;
+                if (!el || el.nodeType !== 1)
+                    continue;
+                if (host.contains(el))
+                    continue;
+                if (isTooBroad(el))
+                    continue;
+                target = el;
+                break;
+            }
+            if (!target) {
+                // composedPath() returned no usable element — most commonly because
+                // we hit a closed shadow root (open shadow elements come through in
+                // composedPath; closed ones cannot be pierced from outside).
+                const host0 = path[0];
+                if (host0) {
+                    e.preventDefault();
+                    e.stopPropagation();
+                    send({ type: 'pick-error', reason: 'shadow-unsupported', xpath: xpathFor(host0) });
+                }
+                return;
+            }
+            e.preventDefault();
+            e.stopPropagation();
+            send({ type: 'pick', html: summarise(target), xpath: xpathFor(target) });
+        }, true);
+        // Document-level keydown shortcuts mounted from ./keybinds.ts after this
+        // shadow-host evaluate block returns. The keybinds module looks up
+        // `__heal_host__`, the shadow root, and the exposed `__healOverlay_send`
+        // binding (set by page.exposeBinding above).
+        // Drag logic lives in overlay/drag.ts — wired via window.__healOverlay_drag.
+        const wireButtons = () => {
+            const buttons = root.querySelectorAll('button[data-act]');
+            buttons.forEach((btn) => {
+                btn.addEventListener('click', (ev) => {
+                    ev.preventDefault();
+                    ev.stopPropagation();
+                    const act = btn.dataset.act;
+                    if (act === 'intent') {
+                        const ta = root.getElementById('heal-intent');
+                        send({ type: 'intent', text: ta?.value ?? '' });
+                    }
+                    else if (act === 'accept') {
+                        send({ type: 'accept' });
+                    }
+                    else if (act === 'reject') {
+                        send({ type: 'reject' });
+                    }
+                    else if (act === 'edit') {
+                        send({ type: 'edit' });
+                    }
+                    else if (act === 'cancel') {
+                        send({ type: 'cancel' });
+                    }
+                    else if (act === 'broaden') {
+                        send({ type: 'broaden' });
+                    }
+                    else if (act === 'force-llm') {
+                        send({ type: 'force-llm' });
+                    }
+                    else if (act === 'cancel-llm') {
+                        send({ type: 'cancel-llm' });
+                    }
+                    else if (act === 'pick-preview-continue') {
+                        send({ type: 'pick-preview-continue' });
+                    }
+                    else if (act === 'pick-preview-repick') {
+                        send({ type: 'pick-preview-repick' });
+                    }
+                });
+            });
+        };
+        // Elapsed timer: poll a single span#heal-elapsed inside the dock.
+        // We start an interval on first setState; it no-ops if the span is absent.
+        let elapsedTimer = null;
+        const tickElapsed = () => {
+            const span = root.getElementById('heal-elapsed');
+            if (!span)
+                return;
+            const startedStr = span.dataset.started || '';
+            const started = Number(startedStr);
+            if (!started || !Number.isFinite(started))
+                return;
+            const secs = Math.max(0, Math.floor((Date.now() - started) / 1000));
+            span.textContent = secs + 's';
+        };
+        window.__healOverlay_api = {
+            setState(stateHtml) {
+                container.innerHTML = stateHtml;
+                window.__healOverlay_drag?.wireDrag?.();
+                wireButtons();
+                window.__healOverlay_drag?.applyDockTransform?.();
+                if (elapsedTimer === null) {
+                    elapsedTimer = window.setInterval(tickElapsed, 250);
+                }
+                tickElapsed();
+                const ta = root.getElementById('heal-intent');
+                if (ta) {
+                    ta.focus();
+                    ta.addEventListener('keydown', (e) => {
+                        if (e.key === 'Enter' && !e.shiftKey) {
+                            e.preventDefault();
+                            send({ type: 'intent', text: ta.value });
+                        }
+                    });
+                }
+            },
+            pickOn() { picking = true; document.body.style.cursor = 'crosshair'; },
+            pickOff() { picking = false; document.body.style.cursor = ''; hl(null); },
+            highlight(xp) {
+                const it = document.evaluate(xp, document, null, XPathResult.FIRST_ORDERED_NODE_TYPE, null);
+                if (it.singleNodeValue)
+                    hl(it.singleNodeValue);
+            },
+            destroy() {
+                if (elapsedTimer !== null) {
+                    clearInterval(elapsedTimer);
+                    elapsedTimer = null;
+                }
+                host.remove();
+            },
+        };
+    }, { css: DOCK_CSS, html: '' });
+    await mountDrag(page);
+    await mountKeybinds(page);
+    let cancelFn = null;
+    return {
+        async setState(state) {
+            const html = renderDock(state);
+            // Sync stage to keybinds module so keyboard routing stays correct.
+            await page.evaluate(([h, stage]) => {
+                window.__healOverlay_api.setState(h);
+                window.__healOverlay_setStage?.(stage);
+            }, [html, state.stage]);
+        },
+        async enablePickMode() { await page.evaluate(() => window.__healOverlay_api.pickOn()); },
+        async disablePickMode() { await page.evaluate(() => window.__healOverlay_api.pickOff()); },
+        async highlight(xpath) { await page.evaluate((x) => window.__healOverlay_api.highlight(x), xpath); },
+        waitForMessage() {
+            return new Promise((resolve) => {
+                const m = queue.shift();
+                if (m)
+                    resolve(m);
+                else
+                    waiters.push(resolve);
+            });
+        },
+        async destroy() { await page.evaluate(() => window.__healOverlay_api.destroy()); },
+        setCancelInFlight(fn) { cancelFn = fn; },
+        cancelInFlight() { if (cancelFn) {
+            try {
+                cancelFn();
+            }
+            catch { /* ignore */ }
+        } },
+        setAbortHandler(fn) { state.abortHandler = fn; },
+    };
+}
+//# sourceMappingURL=inject.js.map

package/dist/healing/overlay/inject.js.map

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

package/dist/healing/overlay/keybinds.d.ts

@@ -0,0 +1,33 @@
+/**
+ * healing/overlay/keybinds.ts
+ *
+ * Document-level keydown handler for the heal overlay. Mounted via
+ * `mountKeybinds(page)` after the shadow host is in place. Routes
+ * single-letter shortcuts to overlay actions, but suppresses them when
+ * the keystroke originates from an input/textarea/contentEditable so the
+ * developer can type freely into the intent textarea.
+ *
+ * Shortcuts (only active OUTSIDE text fields):
+ *   A → accept     R → reject     E → edit       B → broaden
+ *   L → force-llm  P → cancel-llm
+ *
+ * pick-preview stage shortcuts (never conflicting with text fields — no
+ * textarea is present in this stage):
+ *   Enter → pick-preview-continue
+ *   r / R → pick-preview-repick
+ *   Escape → cancel
+ *
+ * Escape always cancels, even from inside a text field.
+ * Enter inside the `#heal-intent` textarea submits the intent.
+ */
+import type { Page } from '@playwright/test';
+/**
+ * Install the global keydown listener that drives the overlay's keyboard
+ * shortcuts. Idempotent in practice — relies on `injectOverlay` running
+ * once per page lifecycle.
+ *
+ * @param page - Playwright `Page` the overlay is mounted on.
+ * @returns Resolves once the listener is attached.
+ */
+export declare function mountKeybinds(page: Page): Promise<void>;
+//# sourceMappingURL=keybinds.d.ts.map

package/dist/healing/overlay/keybinds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keybinds.d.ts","sourceRoot":"","sources":["../../../healing/overlay/keybinds.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAE7C;;;;;;;GAOG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAgG7D"}

package/dist/healing/overlay/keybinds.js

@@ -0,0 +1,105 @@
+/**
+ * Install the global keydown listener that drives the overlay's keyboard
+ * shortcuts. Idempotent in practice — relies on `injectOverlay` running
+ * once per page lifecycle.
+ *
+ * @param page - Playwright `Page` the overlay is mounted on.
+ * @returns Resolves once the listener is attached.
+ */
+export async function mountKeybinds(page) {
+    await page.evaluate(() => {
+        const host = document.getElementById('__heal_host__');
+        if (!host)
+            return;
+        const root = window.__healOverlay_root;
+        if (!root)
+            return;
+        const send = (msg) => window.__healOverlay_send(msg);
+        // Current stage is tracked in a closure variable, updated by the orchestrator
+        // via a lightweight state-sync hook on the __healOverlay_api.setState path.
+        // This allows keybinds to branch by stage without polling the DOM.
+        let currentStage = 'pick';
+        const origSetState = window.__healOverlay_api?.setState;
+        // Hook into setState to track the current stage. We patch it here (after
+        // mountDrag / mountKeybinds run) — setState is called before any
+        // interactive stage, so the first call syncs the state.
+        const patchSetState = () => {
+            const api = window.__healOverlay_api;
+            if (!api || api.__keybinds_patched)
+                return;
+            const original = api.setState.bind(api);
+            api.setState = (html) => {
+                // Extract stage from the rendered HTML: look for data-stage attribute
+                // or the dock div class / stage indicator embedded by renderDock.
+                // We use a tiny sentinel comment injected at render time.
+                const m = html.match(/data-stage="([^"]+)"/);
+                if (m)
+                    currentStage = m[1];
+                return original(html);
+            };
+            api.__keybinds_patched = true;
+        };
+        document.addEventListener('keydown', (e) => {
+            // Lazy-patch setState on first keydown (api guaranteed to exist by then).
+            patchSetState();
+            // ── pick-preview stage: dedicated shortcuts, no textarea conflict ──
+            if (currentStage === 'pick-preview') {
+                if (e.key === 'Escape')
+                    return send({ type: 'cancel' });
+                if (e.key === 'Enter') {
+                    e.preventDefault();
+                    return send({ type: 'pick-preview-continue' });
+                }
+                if (e.key === 'r' || e.key === 'R') {
+                    e.preventDefault();
+                    return send({ type: 'pick-preview-repick' });
+                }
+                // Swallow all other keys in this stage to prevent accidental actions.
+                return;
+            }
+            // If the keystroke originated from any text input (textarea / input /
+            // contentEditable), suppress letter shortcuts entirely. Otherwise
+            // letters typed into the intent box would trigger A/R/E/B/L/P actions.
+            const path = e.composedPath();
+            const typingInField = path.some((n) => {
+                if (!(n instanceof HTMLElement))
+                    return false;
+                const tag = n.tagName;
+                return tag === 'TEXTAREA' || tag === 'INPUT' || n.isContentEditable;
+            });
+            // Escape always cancels, even from inside the textarea.
+            if (e.key === 'Escape')
+                return send({ type: 'cancel' });
+            if (typingInField) {
+                // Enter inside our intent textarea submits intent.
+                const intent = root.getElementById('heal-intent');
+                if (intent && e.target === host && e.key === 'Enter' && !e.shiftKey) {
+                    e.preventDefault();
+                    return send({ type: 'intent', text: intent.value });
+                }
+                return; // let the field receive the keystroke normally
+            }
+            // Outside any input field — overlay shortcuts active.
+            if (e.key === 'a' || e.key === 'A')
+                return send({ type: 'accept' });
+            if (e.key === 'r' || e.key === 'R')
+                return send({ type: 'reject' });
+            if (e.key === 'e' || e.key === 'E')
+                return send({ type: 'edit' });
+            if (e.key === 'b' || e.key === 'B')
+                return send({ type: 'broaden' });
+            if (e.key === 'l' || e.key === 'L')
+                return send({ type: 'force-llm' });
+            if (e.key === 'p' || e.key === 'P')
+                return send({ type: 'cancel-llm' });
+        }, true);
+        // Expose a direct stage-sync function so the orchestrator (running in
+        // Node.js context) can set the stage label via page.evaluate without
+        // depending on HTML parsing. Called by injectOverlay.setState wrapper.
+        window.__healOverlay_setStage = (stage) => { currentStage = stage; };
+        // intentionally swallowed: origSetState ref may be undefined if keybinds
+        // mount before api — patchSetState handles the deferred case
+        void origSetState;
+    });
+}
+//# sourceMappingURL=keybinds.js.map

package/dist/healing/overlay/keybinds.js.map

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

package/dist/healing/prompts/heal-v21.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Senior-SDET persona + strict tier rubric used for every
+ * `requestHealedLocator` call. Mutating this string invalidates OpenAI's
+ * prompt-cache hash and momentarily increases per-call cost until the new
+ * prefix re-warms.
+ */
+export declare const HEAL_V21_SYSTEM_PROMPT = "# WHO YOU ARE\nYou are a senior SDET architect with 8+ years writing Playwright and\nSelenium tests at production scale. You have been burned by every UI\nframework footgun \u2014 React reconciliation ids, Emotion / styled-\ncomponents hashed class names, MUI `css-1k4n5`, Vue `data-v-{hash}`,\nAngular `_ngcontent-c12`, Ember UUIDs, React 18 `:r0:` useId,\nSalesforce LWC scoped classes. You instinctively distrust anything that\nlooks generated and instinctively trust ARIA roles, accessible names,\nand test ids. You write the locator a careful human would write by\nhand \u2014 not the locator a tool would auto-export.\n\n# WHAT YOU DO (scope of work)\nONE thing only: take the developer's picked element + their intent\ndescription, and produce exactly 3 ranked Playwright locators in JSON.\nThat is all. You do not refactor tests. You do not suggest test design\nchanges. You do not explain your reasoning at length. You do not output\nanything that is not strict JSON matching the required schema.\n\n# WHAT IS IN SCOPE\n- Generating ARIA-role, test-id, label, text, attribute-CSS, xpath, or\n  Playwright filter-chain locators that uniquely match the picked\n  element on the current page.\n- Drilling DOWN when the picked element is a container \u2014 your locator\n  must resolve to the inner element matching the user's intent verb.\n- Drilling UP when the picked element is a non-interactive descendant\n  (a `<span>` / `<svg>` / `<i>` inside a `<button>` / `<a>`) AND the\n  developer's intent describes the interactive ancestor \u2014 target the\n  clickable ancestor.\n\n# WHAT IS OUT OF SCOPE (do not do these)\n- Inventing role names, attribute values, or text that does not appear\n  in the picked element or candidate list. NO HALLUCINATION.\n- Proposing any locator with auto-generated tokens. If a token has the\n  shape `<prefix>-<digits/hex>` with 5+ alphanumeric chars after a\n  hyphen or underscore, it is auto-generated. Reject it.\n- Producing positional xpath (`//div[3]/section[2]/button[1]`) or deep\n  descendant CSS chains (`body > div > main > div > section > button`)\n  before round 3.\n- Producing `page.evaluate(...)` or JavaScript expressions unless round\n  is exactly 4.\n- Returning more or fewer than 3 suggestions.\n- Returning prose, commentary, markdown fences, or anything outside the\n  JSON object.\n\n# HOW YOU THINK (silent 3-step internal monologue \u2014 do NOT emit)\n\n  Step 1. UNDERSTAND\n    Restate the developer's intent in one sentence. What element are\n    they acting on? What is the verb (click, fill, expect)? If the\n    intent words and the picked element disagree (intent says \"submit\"\n    but pick is a Cancel button), THE PICK WINS. Note the disagreement\n    in your rationale.\n\n  Step 2. ANCHOR\n    Walk the picked element's properties in this priority order. Stop\n    at the FIRST strong stable anchor:\n      a. dataTestId present and not auto-generated \u2192 use it.\n      b. accessibleName non-empty AND (explicit role OR implicit role\n         from the table below) \u2192 use role + name.\n      c. associated <label> text for form fields \u2192 use label.\n      d. unique visible text (siblingsSameTag === 1 AND no other\n         candidate has the same accessibleName) \u2192 use text.\n      e. stable id (does not match auto-gen pattern) \u2192 use #id.\n      f. stable attribute (name, type, data-action / data-event /\n         data-name \u2014 NOT data-v / data-reactid / data-emotion).\n    If NONE hold, you are in fragile territory: announce in rationale\n    and fall back to tier 4\u20136.\n\n  Step 3. SCOPE\n    Ask: does my chosen anchor uniquely identify THE picked element on\n    the current page? Check siblingsSameTag and candidate count.\n      \u2192 If YES, emit the bare semantic locator (tier 1 or 2).\n      \u2192 If NO, wrap it in a filter-chain (tier 3). Pick a parent\n        landmark visible in parentRole (form, navigation, dialog,\n        region, main, listitem, table). Add `filter({hasText: 'X'})`\n        using a phrase that comes from the intent or visible sibling\n        text \u2014 never invented.\n\n# WHAT YOU KNOW (skill)\n\n## Implicit ARIA roles (use when no explicit role attribute)\n  <button>              \u2192 button\n  <a href>              \u2192 link\n  <input type=text>     \u2192 textbox\n  <input type=submit>   \u2192 button\n  <input type=checkbox> \u2192 checkbox\n  <input type=radio>    \u2192 radio\n  <select>              \u2192 combobox\n  <textarea>            \u2192 textbox\n  <h1>..<h6>            \u2192 heading\n  <nav>                 \u2192 navigation\n  <main>                \u2192 main\n  <header>              \u2192 banner\n  <footer>              \u2192 contentinfo\n  <aside>               \u2192 complementary\n  <ul>/<ol>             \u2192 list\n  <li>                  \u2192 listitem\n  <table>               \u2192 table\n  <tr>                  \u2192 row\n  <td>                  \u2192 cell\n  <form>                \u2192 form\n\n## Accessible name computation (use this order)\n  1. aria-labelledby (referenced element's text)\n  2. aria-label attribute\n  3. <label for=id> for inputs (or wrapping <label>)\n  4. element's visible textContent\n  5. placeholder (inputs only, weak fallback)\n  6. title attribute (weakest)\n\n## Edge-case recognition (apply these rules without being asked)\n  - Pick is <span>/<svg>/<i> inside a <button>/<a> \u2192\n    target the interactive ancestor. Use parentRole + nearest\n    accessibleName.\n  - Pick is a container <section>/<div>/<form> and intent verb is\n    click/fill/select/expect-visible \u2192 drill down to the inner\n    interactive element matching the intent noun.\n  - accessibleName empty (icon-only button) \u2192 look for aria-label or\n    title. If neither, the element is a11y-broken; fall to data-*\n    or stable id.\n  - Multiple elements share the same accessibleName (5 \"Edit\" buttons\n    in a table) \u2192 tier 3 filter-chain by row text from neighborText.\n  - Form input has no <label for=> but has placeholder \u2192 use\n    role=textbox + accessibleName from associatedLabel, OR scope to\n    enclosing form.\n  - Generic visible text (\"Submit\", \"Save\", \"Close\") appears in many\n    components on the page \u2192 NEVER bare text=; always scope via\n    filter-chain.\n\n# OUTPUT CONTRACT\nReturn strict JSON: { \"suggestions\": [3 entries] }. Each entry:\n  - selectorType: \"role\" | \"text\" | \"label\" | \"testid\" | \"css\" |\n                  \"xpath\" | \"filter-chain\" | \"js\"\n  - selector: the bare selector value (forms below)\n  - tier: integer 1-7 matching the tier table\n  - rationale: ONE sentence stating the tier and what disambiguates.\n\n## Selector forms by type\n  role         \u2192 `button[name=\"Submit\"]` (NO `role=` prefix in the value)\n  text         \u2192 `Sign in` (visible text only)\n  label        \u2192 `Email address` (label text only)\n  testid       \u2192 `submit-btn` (the testid value only)\n  css          \u2192 `#stable-id`, `[name=\"email\"]`, `[data-action=\"save\"]`\n  xpath        \u2192 `//button[@data-x=\"y\"]` (attribute-anchored only)\n  filter-chain \u2192 JSON: {\"root\":\"role=...\",\"filters\":[{\"hasText\":\"...\"}],\"target\":\"role=...\"}\n  js           \u2192 JS expression returning ONE Element (round 4 only, never cached)\n\n## Tier rubric (the tier you emit is a CONSEQUENCE of ANCHOR + SCOPE)\n  1 = clean semantic (role+name / label / text) \u2014 anchor unique\n  2 = testid \u2014 dataTestId present and clean\n  3 = filter-chain \u2014 semantic anchor exists but multi-matches \u2192 scope\n  4 = attribute CSS / stable id\n  5 = class chain CSS (brittle \u2014 last CSS resort)\n  6 = attr-anchored xpath\n  7 = js evaluate (round 4 escape hatch, never cached)\n\n## Round semantics\n  Round 1: best single-shot. Allowed tiers: 1-4.\n  Round 2: previous attempts failed \u2014 read previousAttempts, avoid\n           repeats. Allowed tiers: 1-5. Strongly prefer chained scope.\n  Round 3: allow tier 6 (attribute-anchored xpath).\n  Round 4: allow tier 7 (js evaluate).\n\n## Quoting (multi-word names break without quotes)\n  CORRECT: role=region[name=\"Login form\"]\n  CORRECT: button[name=\"Sign in\"]\n  WRONG:   role=region[name=Login form]    \u2190 will not parse\n\n# WORKED EXAMPLE (shows ANCHOR + SCOPE producing tier 1)\nPicked: <button class=\"x_a82\">Sign in</button> inside <form aria-label=\"Login form\">\nsiblingsSameTag: 1, accessibleName: \"Sign in\", parentRole: \"form\"\nIntent: \"sign-in button in the login form\"\nRound: 1\nPrevious: []\nSilent reasoning: UNDERSTAND \u2192 click the sign-in button.\n                  ANCHOR \u2192 no testid, but accessibleName \"Sign in\" +\n                           implicit role button.\n                  SCOPE \u2192 siblingsSameTag=1, only one Sign in on page \u2192\n                          tier 1.\nOutput:\n{\"suggestions\":[\n  {\"selectorType\":\"role\",\"selector\":\"button[name=\\\"Sign in\\\"]\",\"rationale\":\"Tier 1: unique role+accessibleName.\",\"tier\":1},\n  {\"selectorType\":\"filter-chain\",\"selector\":\"{\\\"root\\\":\\\"role=region[name=\\\\\\\"Login form\\\\\\\"]\\\",\\\"filters\\\":[],\\\"target\\\":\\\"role=button[name=\\\\\\\"Sign in\\\\\\\"]\\\"}\",\"rationale\":\"Tier 3: scoped via login-form landmark for extra robustness.\",\"tier\":3},\n  {\"selectorType\":\"text\",\"selector\":\"Sign in\",\"rationale\":\"Tier 1 text variant.\",\"tier\":1}\n]}\n\n# REMEMBER\nThink silently. Output strict JSON only. No markdown fences. No\ncommentary outside JSON. No invented values.";
+//# sourceMappingURL=heal-v21.d.ts.map

package/dist/healing/prompts/heal-v21.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heal-v21.d.ts","sourceRoot":"","sources":["../../../healing/prompts/heal-v21.ts"],"names":[],"mappings":"AASA;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,s6SA4LU,CAAC"}