@healflow/playwright 0.1.1 → 0.1.3

package/dist/runtime-techniques/t0-retry.js

@@ -0,0 +1,334 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executeT0Retry = executeT0Retry;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const shared_1 = require("@healflow/shared");
+const shared_js_1 = require("./shared.js");
+async function executeT0Retry(ctx) {
+    const { classification, rawPage, locator, action, args, error } = ctx;
+    const message = (0, shared_js_1.errorHaystack)(error);
+    const staleId = message.match(/getByTestId\(['"]([^'"]+)['"]\)/i)?.[1];
+    if (staleId && (action === 'click' || action === 'tap' || action === 'fill')) {
+        for (const normalized of (0, shared_js_1.normalizeStaleTestIds)(staleId)) {
+            const target = rawPage.getByTestId(normalized);
+            if ((await target.count().catch(() => 0)) !== 1)
+                continue;
+            try {
+                await (0, shared_js_1.runLocatorAction)(target.first(), action, (0, shared_js_1.healActionArgs)(action, args));
+                return {
+                    type: 'done',
+                    heal: {
+                        oldValue: staleId,
+                        newValue: normalized,
+                        category: shared_1.FailureCategory.SELECTOR,
+                        rootCause: 'Stale Id Normalize',
+                        confidence: 0.9,
+                        technique: shared_1.HealingTechnique.T0_RETRY,
+                    },
+                };
+            }
+            catch (clickErr) {
+                const clickMsg = (0, shared_js_1.errorHaystack)(clickErr);
+                if (/intercepts pointer|obscured|overlay-blocker|modal-overlay/i.test(clickMsg)) {
+                    await (0, shared_js_1.dismissOverlays)(rawPage);
+                    await (0, shared_js_1.waitForBlockingOverlays)(rawPage);
+                    try {
+                        await (0, shared_js_1.runLocatorAction)(target.first(), action, (0, shared_js_1.healActionArgs)(action, args));
+                        return {
+                            type: 'done',
+                            heal: {
+                                oldValue: staleId,
+                                newValue: normalized,
+                                category: shared_1.FailureCategory.SELECTOR,
+                                rootCause: 'Overlay Dismiss Then Click',
+                                confidence: 0.86,
+                                technique: shared_1.HealingTechnique.T0_RETRY,
+                            },
+                        };
+                    }
+                    catch {
+                        // fall through to force click
+                    }
+                }
+                if (action === 'click' || action === 'tap') {
+                    const forced = await (0, shared_js_1.healAttachedForceAction)(target, action, args);
+                    if (forced) {
+                        return {
+                            type: 'done',
+                            heal: {
+                                oldValue: staleId,
+                                newValue: normalized,
+                                category: shared_1.FailureCategory.SELECTOR,
+                                rootCause: 'Force Click Stale Target',
+                                confidence: 0.78,
+                                technique: shared_1.HealingTechnique.T0_RETRY,
+                            },
+                        };
+                    }
+                }
+            }
+        }
+    }
+    if (classification.category === shared_1.FailureCategory.OVERLAY) {
+        await (0, shared_js_1.dismissOverlays)(rawPage);
+        await (0, shared_js_1.waitForBlockingOverlays)(rawPage);
+        if (action === 'click' || action === 'tap') {
+            await (0, shared_js_1.scrollLocatorIntoView)(locator);
+            try {
+                await (0, shared_js_1.runLocatorAction)(locator.first(), action, (0, shared_js_1.healActionArgs)(action, args));
+                return {
+                    type: 'done',
+                    heal: {
+                        category: shared_1.FailureCategory.OVERLAY,
+                        rootCause: 'Overlay Blocked',
+                        confidence: classification.confidence,
+                        technique: shared_1.HealingTechnique.T0_RETRY,
+                    },
+                };
+            }
+            catch {
+                try {
+                    await locator.first().click({ force: true, timeout: shared_js_1.T0_QUICK_TIMEOUT_MS });
+                    return {
+                        type: 'done',
+                        heal: {
+                            category: shared_1.FailureCategory.OVERLAY,
+                            rootCause: 'Overlay Force Click',
+                            confidence: classification.confidence,
+                            technique: shared_1.HealingTechnique.T0_RETRY,
+                        },
+                    };
+                }
+                catch {
+                    return {
+                        type: 'retry',
+                        heal: {
+                            category: shared_1.FailureCategory.OVERLAY,
+                            rootCause: 'Overlay Blocked',
+                            confidence: classification.confidence,
+                            technique: shared_1.HealingTechnique.T0_RETRY,
+                        },
+                    };
+                }
+            }
+        }
+        if (action === 'fill') {
+            await (0, shared_js_1.scrollLocatorIntoView)(locator);
+        }
+        return {
+            type: 'retry',
+            heal: {
+                category: shared_1.FailureCategory.OVERLAY,
+                rootCause: 'Overlay Blocked',
+                confidence: classification.confidence,
+                technique: shared_1.HealingTechnique.T0_RETRY,
+            },
+        };
+    }
+    if (classification.category === shared_1.FailureCategory.TIMING) {
+        await (0, shared_js_1.waitForLocator)(locator);
+        if (action === 'click' || action === 'tap') {
+            await locator
+                .first()
+                .waitFor({ state: 'visible', timeout: shared_js_1.HEAL_RETRY_TIMEOUT_MS })
+                .catch(() => { });
+            await locator
+                .first()
+                .waitFor({ state: 'attached', timeout: shared_js_1.HEAL_RETRY_TIMEOUT_MS })
+                .catch(() => { });
+        }
+        if (action === 'fill') {
+            await rawPage.waitForLoadState('domcontentloaded').catch(() => { });
+        }
+        return {
+            type: 'retry',
+            heal: {
+                category: shared_1.FailureCategory.TIMING,
+                rootCause: 'Timing',
+                confidence: classification.confidence,
+                technique: shared_1.HealingTechnique.T0_RETRY,
+            },
+        };
+    }
+    if (classification.category === shared_1.FailureCategory.NAVIGATION) {
+        await rawPage
+            .waitForLoadState('domcontentloaded', { timeout: shared_js_1.HEAL_RETRY_TIMEOUT_MS })
+            .catch(() => { });
+        await rawPage
+            .waitForLoadState('networkidle', { timeout: shared_js_1.HEAL_RETRY_TIMEOUT_MS })
+            .catch(() => { });
+        return {
+            type: 'retry',
+            heal: {
+                category: shared_1.FailureCategory.NAVIGATION,
+                rootCause: 'Navigation',
+                confidence: classification.confidence,
+                technique: shared_1.HealingTechnique.T0_RETRY,
+            },
+        };
+    }
+    if (classification.category === shared_1.FailureCategory.NETWORK) {
+        await rawPage
+            .waitForLoadState('networkidle', { timeout: shared_js_1.HEAL_RETRY_TIMEOUT_MS })
+            .catch(() => { });
+        if (action === 'goto') {
+            const url = typeof args[0] === 'string' ? args[0] : undefined;
+            if (url) {
+                try {
+                    await rawPage.goto(url, {
+                        waitUntil: 'domcontentloaded',
+                        timeout: shared_js_1.HEAL_RETRY_TIMEOUT_MS,
+                    });
+                    return {
+                        type: 'done',
+                        heal: {
+                            category: shared_1.FailureCategory.NETWORK,
+                            rootCause: 'Network Retry',
+                            confidence: classification.confidence,
+                            technique: shared_1.HealingTechnique.T0_RETRY,
+                        },
+                    };
+                }
+                catch {
+                    return { type: 'continue' };
+                }
+            }
+        }
+        return {
+            type: 'retry',
+            heal: {
+                category: shared_1.FailureCategory.NETWORK,
+                rootCause: 'Network Retry',
+                confidence: classification.confidence,
+                technique: shared_1.HealingTechnique.T0_RETRY,
+            },
+        };
+    }
+    if (classification.category === shared_1.FailureCategory.MOBILE) {
+        await rawPage.setViewportSize({ width: 390, height: 844 }).catch(() => { });
+        await (0, shared_js_1.scrollLocatorIntoView)(locator);
+        return {
+            type: 'retry',
+            heal: {
+                category: shared_1.FailureCategory.MOBILE,
+                rootCause: 'Mobile Viewport',
+                confidence: classification.confidence,
+                technique: shared_1.HealingTechnique.T0_RETRY,
+            },
+        };
+    }
+    if ((classification.category === shared_1.FailureCategory.UPLOAD || /ENOENT/i.test((0, shared_js_1.errorHaystack)(error))) &&
+        action === 'setInputFiles') {
+        const fallbackPaths = [
+            (0, node_path_1.join)(process.cwd(), 'fixtures/sample-upload.txt'),
+            (0, node_path_1.join)(process.cwd(), 'apps/demo-playwright/fixtures/sample-upload.txt'),
+        ];
+        for (const filePath of fallbackPaths) {
+            if (!(0, node_fs_1.existsSync)(filePath))
+                continue;
+            try {
+                await (0, shared_js_1.runLocatorAction)(locator.first(), action, [filePath]);
+                return {
+                    type: 'done',
+                    heal: {
+                        category: shared_1.FailureCategory.UPLOAD,
+                        rootCause: 'Upload Fix',
+                        newValue: filePath,
+                        confidence: classification.confidence,
+                        technique: shared_1.HealingTechnique.T0_RETRY,
+                    },
+                };
+            }
+            catch {
+                // try next fallback path
+            }
+        }
+        return {
+            type: 'retry',
+            heal: {
+                category: shared_1.FailureCategory.UPLOAD,
+                rootCause: 'Upload Retry',
+                confidence: classification.confidence,
+                technique: shared_1.HealingTechnique.T0_RETRY,
+            },
+        };
+    }
+    if (/not enabled|element is not enabled|disabled/i.test(message)) {
+        try {
+            await locator.first().waitFor({ state: 'attached', timeout: shared_js_1.HEAL_RETRY_TIMEOUT_MS });
+            await rawPage.waitForFunction((el) => Boolean(el && !el.hasAttribute?.('disabled')), await locator.first().elementHandle(), { timeout: shared_js_1.HEAL_RETRY_TIMEOUT_MS });
+            return {
+                type: 'retry',
+                heal: {
+                    category: shared_1.FailureCategory.SELECTOR,
+                    rootCause: 'Wait For Enabled',
+                    confidence: 0.82,
+                    technique: shared_1.HealingTechnique.T0_RETRY,
+                },
+            };
+        }
+        catch {
+            try {
+                await locator.first().click({ force: true, timeout: shared_js_1.HEAL_RETRY_TIMEOUT_MS });
+                return {
+                    type: 'retry',
+                    heal: {
+                        category: shared_1.FailureCategory.SELECTOR,
+                        rootCause: 'Force Click Disabled',
+                        confidence: 0.7,
+                        technique: shared_1.HealingTechnique.T0_RETRY,
+                    },
+                };
+            }
+            catch {
+                return { type: 'continue' };
+            }
+        }
+    }
+    if (/outside viewport|not in viewport|scroll into view/i.test(message)) {
+        await (0, shared_js_1.scrollLocatorIntoView)(locator);
+        return {
+            type: 'retry',
+            heal: {
+                category: shared_1.FailureCategory.SELECTOR,
+                rootCause: 'Scroll Into View',
+                confidence: 0.85,
+                technique: shared_1.HealingTechnique.T0_RETRY,
+            },
+        };
+    }
+    if (/intercepts pointer events|element is obscured|subtree intercepts|spinner-overlay/i.test(message)) {
+        await (0, shared_js_1.waitForBlockingOverlays)(rawPage);
+        await (0, shared_js_1.dismissOverlays)(rawPage);
+        return {
+            type: 'retry',
+            heal: {
+                category: shared_1.FailureCategory.OVERLAY,
+                rootCause: 'Overlay Blocked',
+                confidence: 0.88,
+                technique: shared_1.HealingTechnique.T0_RETRY,
+            },
+        };
+    }
+    if (/timeout|waiting for/i.test(message)) {
+        try {
+            await (0, shared_js_1.waitForLocator)(locator);
+            return {
+                type: 'retry',
+                heal: {
+                    category: shared_1.FailureCategory.TIMING,
+                    rootCause: 'Timing',
+                    confidence: 0.8,
+                    technique: shared_1.HealingTechnique.T0_RETRY,
+                },
+            };
+        }
+        catch {
+            return { type: 'continue' };
+        }
+    }
+    return { type: 'continue' };
+}
+/** T1 — scope to parent chain */
+//# sourceMappingURL=t0-retry.js.map

package/dist/runtime-techniques/t0-retry.js.map

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

package/dist/runtime-techniques/t1-scope.d.ts

@@ -0,0 +1,4 @@
+import type { RuntimeTechniqueContext, RuntimeTechniqueOutcome } from './types.js';
+export declare function executeT1Scope(ctx: RuntimeTechniqueContext): Promise<RuntimeTechniqueOutcome>;
+/** T2 + T3 — normalize and fingerprint fallback locators */
+//# sourceMappingURL=t1-scope.d.ts.map

package/dist/runtime-techniques/t1-scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"t1-scope.d.ts","sourceRoot":"","sources":["../../src/runtime-techniques/t1-scope.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AASnF,wBAAsB,cAAc,CAClC,GAAG,EAAE,uBAAuB,GAC3B,OAAO,CAAC,uBAAuB,CAAC,CAiElC;AAED,4DAA4D"}

package/dist/runtime-techniques/t1-scope.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executeT1Scope = executeT1Scope;
+const shared_1 = require("@healflow/shared");
+const shared_js_1 = require("./shared.js");
+async function executeT1Scope(ctx) {
+    const { rawPage, action, args, error } = ctx;
+    const haystack = (0, shared_js_1.errorHaystack)(error);
+    const parentMatch = haystack.match(/locator\(['"]([^'"]+)['"]\)/i);
+    const testIdMatch = haystack.match(/getByTestId\(['"]([^'"]+)['"]\)/i);
+    const chainMatch = haystack.match(/getByTestId\(['"]([^'"]+)['"]\)\.getByTestId\(['"]([^'"]+)['"]\)/i);
+    if (chainMatch?.[1] && chainMatch[2]) {
+        for (const testId of (0, shared_js_1.normalizeStaleTestIds)(chainMatch[2])) {
+            const scoped = rawPage.getByTestId(chainMatch[1]).getByTestId(testId);
+            const confident = await (0, shared_js_1.assertUniqueVisibleCandidate)(scoped);
+            if (!confident)
+                continue;
+            try {
+                await (0, shared_js_1.runLocatorAction)(scoped.first(), action, (0, shared_js_1.healActionArgs)(action, args));
+                return {
+                    type: 'done',
+                    heal: {
+                        oldValue: chainMatch[2],
+                        newValue: `getByTestId('${chainMatch[1]}').getByTestId('${testId}')`,
+                        category: shared_1.FailureCategory.SELECTOR,
+                        rootCause: 'Scoped Selector',
+                        confidence: 0.9,
+                        technique: shared_1.HealingTechnique.T1_SCOPE,
+                    },
+                };
+            }
+            catch {
+                // try next normalized test id
+            }
+        }
+    }
+    if (!parentMatch?.[1] || !testIdMatch?.[1])
+        return { type: 'continue' };
+    const staleTestId = testIdMatch[1];
+    const normalizedTestIds = (0, shared_js_1.normalizeStaleTestIds)(staleTestId);
+    if (!normalizedTestIds.includes(staleTestId)) {
+        normalizedTestIds.unshift(staleTestId);
+    }
+    for (const testId of normalizedTestIds) {
+        const scoped = rawPage.locator(parentMatch[1]).getByTestId(testId);
+        const confident = await (0, shared_js_1.assertUniqueVisibleCandidate)(scoped);
+        if (!confident)
+            continue;
+        try {
+            await (0, shared_js_1.runLocatorAction)(scoped.first(), action, (0, shared_js_1.healActionArgs)(action, args));
+            return {
+                type: 'done',
+                heal: {
+                    oldValue: staleTestId,
+                    newValue: `${parentMatch[1]} >> getByTestId('${testId}')`,
+                    category: shared_1.FailureCategory.SELECTOR,
+                    rootCause: 'Scoped Selector',
+                    confidence: 0.9,
+                    technique: shared_1.HealingTechnique.T1_SCOPE,
+                },
+            };
+        }
+        catch {
+            // try next normalized test id
+        }
+    }
+    return { type: 'continue' };
+}
+/** T2 + T3 — normalize and fingerprint fallback locators */
+//# sourceMappingURL=t1-scope.js.map

package/dist/runtime-techniques/t1-scope.js.map

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

package/dist/runtime-techniques/t2-normalize.d.ts

@@ -0,0 +1,3 @@
+import type { RuntimeTechniqueContext, RuntimeTechniqueOutcome } from './types.js';
+export declare function executeT2Normalize(ctx: RuntimeTechniqueContext): Promise<RuntimeTechniqueOutcome>;
+//# sourceMappingURL=t2-normalize.d.ts.map

package/dist/runtime-techniques/t2-normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"t2-normalize.d.ts","sourceRoot":"","sources":["../../src/runtime-techniques/t2-normalize.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAGnF,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,uBAAuB,GAC3B,OAAO,CAAC,uBAAuB,CAAC,CAUlC"}

package/dist/runtime-techniques/t2-normalize.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executeT2Normalize = executeT2Normalize;
+const shared_1 = require("@healflow/shared");
+const heal_helpers_js_1 = require("./heal-helpers.js");
+async function executeT2Normalize(ctx) {
+    const healed = await (0, heal_helpers_js_1.healSelector)(ctx.rawPage, ctx.action, ctx.args, ctx.error, shared_1.HealingTechnique.T2_NORMALIZE);
+    if (healed)
+        return { type: 'done', heal: healed };
+    return { type: 'continue' };
+}
+//# sourceMappingURL=t2-normalize.js.map

package/dist/runtime-techniques/t2-normalize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"t2-normalize.js","sourceRoot":"","sources":["../../src/runtime-techniques/t2-normalize.ts"],"names":[],"mappings":";;AAIA,gDAYC;AAhBD,6CAAoD;AAEpD,uDAAiD;AAE1C,KAAK,UAAU,kBAAkB,CACtC,GAA4B;IAE5B,MAAM,MAAM,GAAG,MAAM,IAAA,8BAAY,EAC/B,GAAG,CAAC,OAAO,EACX,GAAG,CAAC,MAAM,EACV,GAAG,CAAC,IAAI,EACR,GAAG,CAAC,KAAK,EACT,yBAAgB,CAAC,YAAY,CAC9B,CAAC;IACF,IAAI,MAAM;QAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAClD,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;AAC9B,CAAC"}

package/dist/runtime-techniques/t3-fingerprint.d.ts

@@ -0,0 +1,4 @@
+import type { RuntimeTechniqueContext, RuntimeTechniqueOutcome } from './types.js';
+export declare function executeT3Fingerprint(ctx: RuntimeTechniqueContext): Promise<RuntimeTechniqueOutcome>;
+/** T4 — trace-derived frame/shadow context */
+//# sourceMappingURL=t3-fingerprint.d.ts.map

package/dist/runtime-techniques/t3-fingerprint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"t3-fingerprint.d.ts","sourceRoot":"","sources":["../../src/runtime-techniques/t3-fingerprint.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAGnF,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,uBAAuB,GAC3B,OAAO,CAAC,uBAAuB,CAAC,CAUlC;AAED,8CAA8C"}

package/dist/runtime-techniques/t3-fingerprint.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executeT3Fingerprint = executeT3Fingerprint;
+const shared_1 = require("@healflow/shared");
+const heal_helpers_js_1 = require("./heal-helpers.js");
+async function executeT3Fingerprint(ctx) {
+    const healed = await (0, heal_helpers_js_1.healSelector)(ctx.rawPage, ctx.action, ctx.args, ctx.error, shared_1.HealingTechnique.T3_FINGERPRINT);
+    if (healed)
+        return { type: 'done', heal: healed };
+    return { type: 'continue' };
+}
+/** T4 — trace-derived frame/shadow context */
+//# sourceMappingURL=t3-fingerprint.js.map

package/dist/runtime-techniques/t3-fingerprint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"t3-fingerprint.js","sourceRoot":"","sources":["../../src/runtime-techniques/t3-fingerprint.ts"],"names":[],"mappings":";;AAIA,oDAYC;AAhBD,6CAAoD;AAEpD,uDAAiD;AAE1C,KAAK,UAAU,oBAAoB,CACxC,GAA4B;IAE5B,MAAM,MAAM,GAAG,MAAM,IAAA,8BAAY,EAC/B,GAAG,CAAC,OAAO,EACX,GAAG,CAAC,MAAM,EACV,GAAG,CAAC,IAAI,EACR,GAAG,CAAC,KAAK,EACT,yBAAgB,CAAC,cAAc,CAChC,CAAC;IACF,IAAI,MAAM;QAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAClD,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;AAC9B,CAAC;AAED,8CAA8C"}

package/dist/runtime-techniques/t4-trace.d.ts

@@ -0,0 +1,4 @@
+import type { RuntimeTechniqueContext, RuntimeTechniqueOutcome } from './types.js';
+export declare function executeT4Trace(ctx: RuntimeTechniqueContext): Promise<RuntimeTechniqueOutcome>;
+/** T5 — org fix history from local heals.json / fixes.json */
+//# sourceMappingURL=t4-trace.d.ts.map

package/dist/runtime-techniques/t4-trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"t4-trace.d.ts","sourceRoot":"","sources":["../../src/runtime-techniques/t4-trace.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAWnF,wBAAsB,cAAc,CAClC,GAAG,EAAE,uBAAuB,GAC3B,OAAO,CAAC,uBAAuB,CAAC,CA8HlC;AAED,8DAA8D"}

package/dist/runtime-techniques/t4-trace.js

@@ -0,0 +1,125 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executeT4Trace = executeT4Trace;
+const shared_1 = require("@healflow/shared");
+const heal_helpers_js_1 = require("./heal-helpers.js");
+const shared_js_1 = require("./shared.js");
+async function executeT4Trace(ctx) {
+    const { rawPage, locator, action, args, error, classification } = ctx;
+    const traceHints = (0, shared_js_1.parsePlaywrightTraceHints)(error);
+    if (classification.category === shared_1.FailureCategory.IFRAME || traceHints.frameSelector) {
+        const healed = await (0, heal_helpers_js_1.healIframe)(rawPage, locator, action, args, error, traceHints);
+        if (healed) {
+            return { type: 'done', heal: { ...healed, technique: shared_1.HealingTechnique.T4_TRACE } };
+        }
+        return {
+            type: 'retry',
+            heal: {
+                category: shared_1.FailureCategory.IFRAME,
+                rootCause: 'Iframe Context',
+                confidence: classification.confidence,
+                technique: shared_1.HealingTechnique.T4_TRACE,
+            },
+        };
+    }
+    if (classification.category === shared_1.FailureCategory.SHADOW_DOM) {
+        const healed = await (0, heal_helpers_js_1.healShadowDom)(rawPage, action, args, error, traceHints);
+        if (healed) {
+            return { type: 'done', heal: { ...healed, technique: shared_1.HealingTechnique.T4_TRACE } };
+        }
+        return { type: 'abort' };
+    }
+    if (classification.category === shared_1.FailureCategory.AUTH ||
+        classification.category === shared_1.FailureCategory.SESSION) {
+        const healed = await (0, heal_helpers_js_1.healAuth)(rawPage, ctx.config);
+        if (healed) {
+            return {
+                type: 'retry',
+                heal: {
+                    ...healed,
+                    category: classification.category,
+                    technique: shared_1.HealingTechnique.T4_TRACE,
+                },
+            };
+        }
+        return { type: 'abort' };
+    }
+    if (classification.category === shared_1.FailureCategory.NAVIGATION) {
+        await rawPage
+            .waitForLoadState('networkidle', { timeout: shared_js_1.HEAL_RETRY_TIMEOUT_MS })
+            .catch(() => { });
+        return {
+            type: 'retry',
+            heal: {
+                category: shared_1.FailureCategory.NAVIGATION,
+                rootCause: 'Navigation Trace',
+                confidence: classification.confidence,
+                technique: shared_1.HealingTechnique.T4_TRACE,
+            },
+        };
+    }
+    if (classification.category === shared_1.FailureCategory.MULTI_TAB) {
+        const targetTestId = (0, shared_js_1.errorHaystack)(error).match(/getByTestId\(['"]([^'"]+)['"]\)/i)?.[1];
+        const popup = rawPage
+            .context()
+            .pages()
+            .find((p) => p !== rawPage);
+        if (popup && targetTestId) {
+            await popup.waitForLoadState('domcontentloaded').catch(() => { });
+            try {
+                await (0, shared_js_1.runLocatorAction)(popup.getByTestId(targetTestId).first(), action, (0, shared_js_1.healActionArgs)(action, args));
+                return {
+                    type: 'done',
+                    heal: {
+                        category: shared_1.FailureCategory.MULTI_TAB,
+                        rootCause: 'Multi-tab Context',
+                        newValue: `popup >> getByTestId('${targetTestId}')`,
+                        confidence: classification.confidence,
+                        technique: shared_1.HealingTechnique.T4_TRACE,
+                    },
+                };
+            }
+            catch {
+                await popup.bringToFront().catch(() => { });
+            }
+        }
+        else if (popup) {
+            await popup.bringToFront();
+            return {
+                type: 'retry',
+                heal: {
+                    category: shared_1.FailureCategory.MULTI_TAB,
+                    rootCause: 'Multi-tab Context',
+                    confidence: classification.confidence,
+                    technique: shared_1.HealingTechnique.T4_TRACE,
+                },
+            };
+        }
+    }
+    if (traceHints.targetTestId && /^[\w-]+$/.test(traceHints.targetTestId)) {
+        const candidate = rawPage.getByTestId(traceHints.targetTestId);
+        const confident = await (0, shared_js_1.assertUniqueVisibleCandidate)(candidate);
+        if (confident) {
+            try {
+                await (0, shared_js_1.runLocatorAction)(candidate.first(), action, (0, shared_js_1.healActionArgs)(action, args));
+                return {
+                    type: 'done',
+                    heal: {
+                        oldValue: error.message.slice(0, 80),
+                        newValue: traceHints.targetTestId,
+                        category: classification.category,
+                        rootCause: 'Trace Target',
+                        confidence: 0.82,
+                        technique: shared_1.HealingTechnique.T4_TRACE,
+                    },
+                };
+            }
+            catch {
+                // continue
+            }
+        }
+    }
+    return { type: 'continue' };
+}
+/** T5 — org fix history from local heals.json / fixes.json */
+//# sourceMappingURL=t4-trace.js.map

package/dist/runtime-techniques/t4-trace.js.map

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

package/dist/runtime-techniques/t5-history.d.ts

@@ -0,0 +1,3 @@
+import type { RuntimeTechniqueContext, RuntimeTechniqueOutcome } from './types.js';
+export declare function executeT5History(ctx: RuntimeTechniqueContext): Promise<RuntimeTechniqueOutcome>;
+//# sourceMappingURL=t5-history.d.ts.map

package/dist/runtime-techniques/t5-history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"t5-history.d.ts","sourceRoot":"","sources":["../../src/runtime-techniques/t5-history.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AASnF,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,uBAAuB,GAC3B,OAAO,CAAC,uBAAuB,CAAC,CAwDlC"}