@aplaytest/heal 0.1.0

package/dist/propose.js

@@ -0,0 +1,218 @@
+/**
+ * The heal pipeline, end to end.
+ *
+ * Order is load-bearing, and two of the gates are the whole reason this is
+ * defensible at all:
+ *
+ *   1. NEVER_HEAL kinds are refused outright. A schema violation or an
+ *      uncaught application error IS the bug; "repairing" it would delete the
+ *      most valuable signal a suite produces.
+ *   2. Known-flaky tests are refused. Healing a flake is the worst outcome
+ *      available: a permanent code change made to chase noise, the flake
+ *      continues, and now the selector is wrong too. Flaky and broken are
+ *      different problems, and the engine must decide which it is FIRST.
+ *
+ * Only then does it generate candidates, and only then does Playwright decide.
+ */
+import { readFile } from 'node:fs/promises';
+import { isAbsolute, join } from 'node:path';
+import { NEVER_HEAL, ROUTING, isHealable, parseLocator, } from '@aplaytest/core';
+import { assessBundle, generateCandidates, missingTestIds, DEFAULT_CANDIDATE_OPTIONS, } from './candidates.js';
+import { patchConstant } from './patch.js';
+import { DEFAULT_HEAL_TARGET_GLOBS, resolveSelectorSource } from './resolve.js';
+import { validateHeal } from './validate.js';
+export const DEFAULT_HEAL_OPTIONS = {
+    validationRuns: 3,
+    checkCollateral: true,
+    flakeThreshold: 0.15,
+};
+async function resolvePatchSource(options, value) {
+    if (options.constantsFile !== undefined && options.constantsText !== undefined) {
+        return { file: options.constantsFile, text: options.constantsText };
+    }
+    if (options.constantsFile !== undefined) {
+        const path = isAbsolute(options.constantsFile)
+            ? options.constantsFile
+            : join(options.cwd, options.constantsFile);
+        const text = await readFile(path, 'utf8').catch(() => null);
+        if (text === null)
+            return null;
+        return { file: options.constantsFile, text };
+    }
+    const resolved = await resolveSelectorSource({
+        cwd: options.cwd,
+        value,
+        globs: options.targetGlobs ?? DEFAULT_HEAL_TARGET_GLOBS,
+    });
+    if (resolved === null)
+        return null;
+    return { file: resolved.file, text: resolved.text };
+}
+function refuse(bundle, status, reason, candidates = []) {
+    return {
+        status,
+        evidenceId: bundle.id,
+        testTitle: bundle.test.title,
+        reason,
+        intendedSelector: bundle.intent.selector,
+        candidates,
+        chosen: null,
+        patch: null,
+        validation: null,
+        tierOne: null,
+    };
+}
+/**
+ * Run the heal pipeline against one evidence bundle.
+ *
+ * Order is load-bearing: `NEVER_HEAL` kinds and known-flaky tests are refused
+ * before any candidate is generated. Playwright, not the ranking score,
+ * decides whether a patch is proposable.
+ *
+ * @param bundle - Captured failure (selector, ARIA, test-id index).
+ * @param options - Working directory, spec to re-run, and validation policy.
+ * @returns A proposal whose `status` is `proposed`, `rejected`, or one of the
+ *   `refused-*` / `no-*` outcomes. Never throws on a refused heal.
+ *
+ * @example
+ * ```ts
+ * const proposal = await proposeHeal(bundle, {
+ *   cwd: process.cwd(),
+ *   specFile: 'tests/gyms.spec.ts',
+ *   validationRuns: 3,
+ *   checkCollateral: true,
+ * });
+ * if (proposal.status === 'proposed') {
+ *   console.log(proposal.chosen?.value);
+ * }
+ * ```
+ */
+export async function proposeHeal(bundle, options) {
+    const kind = bundle.failure.kind;
+    // Gate 1 — the hard guard. Not a policy setting; not overridable.
+    if (NEVER_HEAL.has(kind) || !isHealable(kind)) {
+        return refuse(bundle, 'refused-never-heal', `${kind}: ${ROUTING[kind].note} Healing is refused for this failure kind.`);
+    }
+    // Gate 2 — flaky before broken. Changing code to chase noise leaves you with
+    // the noise AND a wrong selector.
+    const threshold = options.flakeThreshold ?? DEFAULT_HEAL_OPTIONS.flakeThreshold;
+    if (options.flakeScore !== undefined && options.flakeScore > threshold) {
+        return refuse(bundle, 'refused-flaky', `This test scores ${options.flakeScore.toFixed(2)} for flakiness (threshold ${threshold}). ` +
+            'Healing a flake changes code permanently to chase noise. Bisect it first.');
+    }
+    const candidateOptions = {
+        ...(options.candidateOptions ?? DEFAULT_CANDIDATE_OPTIONS),
+        ...(options.allowedStrategies === undefined
+            ? {}
+            : { allowedStrategies: options.allowedStrategies }),
+    };
+    const eligibility = assessBundle(bundle, candidateOptions);
+    if (!eligibility.eligible) {
+        return refuse(bundle, 'refused-ineligible', eligibility.reason);
+    }
+    const candidates = generateCandidates(bundle, candidateOptions);
+    if (candidates.length === 0) {
+        return refuse(bundle, 'no-candidates', `${eligibility.reason}, and no test id on the page is close enough to be a plausible rename. ` +
+            'The element was probably removed — that is a real change, not a drifted selector.');
+    }
+    let chosen = candidates[0];
+    if (chosen === undefined)
+        return refuse(bundle, 'no-candidates', 'no candidate survived ranking');
+    // The id to replace is the MISSING one, not the first one the selector
+    // mentions: a composite locator names its container first, and the
+    // container is usually the id that still exists.
+    const parsed = parseLocator(bundle.intent.selector);
+    const intendedValue = missingTestIds(bundle.intent.selector, bundle.page.testIdsPresent)[0] ??
+        parsed?.accessibleName ??
+        (parsed !== null && parsed.strategy !== 'testid' ? parsed.value : undefined);
+    if (intendedValue === undefined) {
+        return refuse(bundle, 'refused-ineligible', 'could not identify which locator value is missing');
+    }
+    // Tier 1: reorder by intent, if a ranker is wired in. It can only pick from
+    // the candidates Tier 0 already verified, and its pick is validated exactly
+    // the same way — so the worst a wrong answer costs is a rejected proposal.
+    let tierOne = null;
+    if (options.rankCandidates !== undefined) {
+        const ranked = await options.rankCandidates({ candidates, missingTestId: intendedValue });
+        tierOne = {
+            used: ranked.used,
+            model: ranked.model,
+            outcome: ranked.outcome,
+            reasoning: ranked.reasoning,
+            confidence: ranked.confidence,
+            usd: ranked.usd,
+            changedChoice: ranked.chosen !== null && ranked.chosen !== chosen.value,
+        };
+        if (ranked.realBug) {
+            return {
+                ...refuse(bundle, 'refused-never-heal', 'The ranker judged this an application defect rather than a renamed selector. ' +
+                    'Healing is refused; file a bug.', candidates),
+                tierOne,
+            };
+        }
+        const preferred = candidates.find(c => c.value === ranked.chosen);
+        if (preferred !== undefined)
+            chosen = preferred;
+    }
+    const source = await resolvePatchSource(options, intendedValue);
+    if (source === null) {
+        return {
+            ...refuse(bundle, 'no-constant', 'No selector source found. Pass --constants, or add the file to heal.targets ' +
+                '(constants, page objects, and specs are searched by default).', candidates),
+            chosen,
+            tierOne,
+        };
+    }
+    const patch = patchConstant(source.text, {
+        file: source.file,
+        from: intendedValue,
+        to: chosen.value,
+    });
+    if (patch.status !== 'applied' || patch.after === null) {
+        return {
+            ...refuse(bundle, 'no-constant', patch.message, candidates),
+            chosen,
+            patch,
+            tierOne,
+        };
+    }
+    if (options.skipValidation === true) {
+        return {
+            status: 'proposed',
+            evidenceId: bundle.id,
+            testTitle: bundle.test.title,
+            reason: `${eligibility.reason}. NOT VALIDATED — re-run required before this can be accepted.`,
+            intendedSelector: bundle.intent.selector,
+            candidates,
+            chosen,
+            patch,
+            validation: null,
+            tierOne,
+        };
+    }
+    const validation = await validateHeal({
+        cwd: options.cwd,
+        specFile: options.specFile,
+        testTitle: bundle.test.title,
+        patchFile: source.file,
+        patchedText: patch.after,
+        config: options.config,
+        project: options.project,
+        runs: options.validationRuns,
+        checkCollateral: options.checkCollateral,
+        timeoutMs: options.timeoutMs,
+    });
+    return {
+        status: validation.status === 'validated' ? 'proposed' : 'rejected',
+        evidenceId: bundle.id,
+        testTitle: bundle.test.title,
+        reason: validation.message,
+        intendedSelector: bundle.intent.selector,
+        candidates,
+        chosen,
+        patch,
+        validation,
+        tierOne,
+    };
+}
+//# sourceMappingURL=propose.js.map

package/dist/propose.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"propose.js","sourceRoot":"","sources":["../src/propose.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE7C,OAAO,EACL,UAAU,EACV,OAAO,EACP,UAAU,EACV,YAAY,GAGb,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,cAAc,EACd,yBAAyB,GAG1B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,aAAa,EAAoB,MAAM,YAAY,CAAC;AAC7D,OAAO,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAChF,OAAO,EAAE,YAAY,EAAyB,MAAM,eAAe,CAAC;AAuEpE,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,cAAc,EAAE,CAAC;IACjB,eAAe,EAAE,IAAI;IACrB,cAAc,EAAE,IAAI;CACrB,CAAC;AAEF,KAAK,UAAU,kBAAkB,CAC/B,OAAuB,EACvB,KAAa;IAEb,IAAI,OAAO,CAAC,aAAa,KAAK,SAAS,IAAI,OAAO,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;QAC/E,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,aAAa,EAAE,IAAI,EAAE,OAAO,CAAC,aAAa,EAAE,CAAC;IACtE,CAAC;IAED,IAAI,OAAO,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;QACxC,MAAM,IAAI,GAAG,UAAU,CAAC,OAAO,CAAC,aAAa,CAAC;YAC5C,CAAC,CAAC,OAAO,CAAC,aAAa;YACvB,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;QAC7C,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;QAC5D,IAAI,IAAI,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QAC/B,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,aAAa,EAAE,IAAI,EAAE,CAAC;IAC/C,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,qBAAqB,CAAC;QAC3C,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,KAAK;QACL,KAAK,EAAE,OAAO,CAAC,WAAW,IAAI,yBAAyB;KACxD,CAAC,CAAC;IACH,IAAI,QAAQ,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACnC,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC;AACtD,CAAC;AAED,SAAS,MAAM,CACb,MAAsB,EACtB,MAAsB,EACtB,MAAc,EACd,aAAuC,EAAE;IAEzC,OAAO;QACL,MAAM;QACN,UAAU,EAAE,MAAM,CAAC,EAAE;QACrB,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK;QAC5B,MAAM;QACN,gBAAgB,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ;QACxC,UAAU;QACV,MAAM,EAAE,IAAI;QACZ,KAAK,EAAE,IAAI;QACX,UAAU,EAAE,IAAI;QAChB,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,MAAsB,EACtB,OAAuB;IAEvB,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC;IAEjC,kEAAkE;IAClE,IAAI,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9C,OAAO,MAAM,CACX,MAAM,EACN,oBAAoB,EACpB,GAAG,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,4CAA4C,CAC3E,CAAC;IACJ,CAAC;IAED,6EAA6E;IAC7E,kCAAkC;IAClC,MAAM,SAAS,GAAG,OAAO,CAAC,cAAc,IAAI,oBAAoB,CAAC,cAAc,CAAC;IAChF,IAAI,OAAO,CAAC,UAAU,KAAK,SAAS,IAAI,OAAO,CAAC,UAAU,GAAG,SAAS,EAAE,CAAC;QACvE,OAAO,MAAM,CACX,MAAM,EACN,eAAe,EACf,oBAAoB,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,6BAA6B,SAAS,KAAK;YAC1F,2EAA2E,CAC9E,CAAC;IACJ,CAAC;IAED,MAAM,gBAAgB,GAAqB;QACzC,GAAG,CAAC,OAAO,CAAC,gBAAgB,IAAI,yBAAyB,CAAC;QAC1D,GAAG,CAAC,OAAO,CAAC,iBAAiB,KAAK,SAAS;YACzC,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,iBAAiB,EAAE,OAAO,CAAC,iBAAiB,EAAE,CAAC;KACtD,CAAC;IAEF,MAAM,WAAW,GAAG,YAAY,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAC3D,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC;QAC1B,OAAO,MAAM,CAAC,MAAM,EAAE,oBAAoB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAClE,CAAC;IAED,MAAM,UAAU,GAAG,kBAAkB,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAChE,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,MAAM,CACX,MAAM,EACN,eAAe,EACf,GAAG,WAAW,CAAC,MAAM,yEAAyE;YAC5F,mFAAmF,CACtF,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;IAC3B,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC,MAAM,EAAE,eAAe,EAAE,+BAA+B,CAAC,CAAC;IAElG,uEAAuE;IACvE,mEAAmE;IACnE,iDAAiD;IACjD,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACpD,MAAM,aAAa,GACjB,cAAc,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;QACrE,MAAM,EAAE,cAAc;QACtB,CAAC,MAAM,KAAK,IAAI,IAAI,MAAM,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAC/E,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;QAChC,OAAO,MAAM,CAAC,MAAM,EAAE,oBAAoB,EAAE,mDAAmD,CAAC,CAAC;IACnG,CAAC;IAED,4EAA4E;IAC5E,4EAA4E;IAC5E,2EAA2E;IAC3E,IAAI,OAAO,GAAyB,IAAI,CAAC;IACzC,IAAI,OAAO,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;QACzC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,cAAc,CAAC,EAAE,UAAU,EAAE,aAAa,EAAE,aAAa,EAAE,CAAC,CAAC;QAC1F,OAAO,GAAG;YACR,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,GAAG,EAAE,MAAM,CAAC,GAAG;YACf,aAAa,EAAE,MAAM,CAAC,MAAM,KAAK,IAAI,IAAI,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,KAAK;SACxE,CAAC;QAEF,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,OAAO;gBACL,GAAG,MAAM,CACP,MAAM,EACN,oBAAoB,EACpB,+EAA+E;oBAC7E,iCAAiC,EACnC,UAAU,CACX;gBACD,OAAO;aACR,CAAC;QACJ,CAAC;QAED,MAAM,SAAS,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC,MAAM,CAAC,CAAC;QAClE,IAAI,SAAS,KAAK,SAAS;YAAE,MAAM,GAAG,SAAS,CAAC;IAClD,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;IAChE,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACpB,OAAO;YACL,GAAG,MAAM,CACP,MAAM,EACN,aAAa,EACb,8EAA8E;gBAC5E,+DAA+D,EACjE,UAAU,CACX;YACD,MAAM;YACN,OAAO;SACR,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,EAAE;QACvC,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,IAAI,EAAE,aAAa;QACnB,EAAE,EAAE,MAAM,CAAC,KAAK;KACjB,CAAC,CAAC;IAEH,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,IAAI,KAAK,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;QACvD,OAAO;YACL,GAAG,MAAM,CAAC,MAAM,EAAE,aAAa,EAAE,KAAK,CAAC,OAAO,EAAE,UAAU,CAAC;YAC3D,MAAM;YACN,KAAK;YACL,OAAO;SACR,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,CAAC,cAAc,KAAK,IAAI,EAAE,CAAC;QACpC,OAAO;YACL,MAAM,EAAE,UAAU;YAClB,UAAU,EAAE,MAAM,CAAC,EAAE;YACrB,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK;YAC5B,MAAM,EAAE,GAAG,WAAW,CAAC,MAAM,gEAAgE;YAC7F,gBAAgB,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ;YACxC,UAAU;YACV,MAAM;YACN,KAAK;YACL,UAAU,EAAE,IAAI;YAChB,OAAO;SACR,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAAG,MAAM,YAAY,CAAC;QACpC,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK;QAC5B,SAAS,EAAE,MAAM,CAAC,IAAI;QACtB,WAAW,EAAE,KAAK,CAAC,KAAK;QACxB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,IAAI,EAAE,OAAO,CAAC,cAAc;QAC5B,eAAe,EAAE,OAAO,CAAC,eAAe;QACxC,SAAS,EAAE,OAAO,CAAC,SAAS;KAC7B,CAAC,CAAC;IAEH,OAAO;QACL,MAAM,EAAE,UAAU,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU;QACnE,UAAU,EAAE,MAAM,CAAC,EAAE;QACrB,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK;QAC5B,MAAM,EAAE,UAAU,CAAC,OAAO;QAC1B,gBAAgB,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ;QACxC,UAAU;QACV,MAAM;QACN,KAAK;QACL,UAAU;QACV,OAAO;KACR,CAAC;AACJ,CAAC"}

package/dist/resolve.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Find the file that actually holds a drifted locator.
+ *
+ * Healing used to require `--constants` because the first suite kept every
+ * selector in `*.constants.ts`. Suites also inline literals in page objects
+ * and specs (`getByTestId('page-header')`). The engine walks configured globs
+ * and prefers the most reviewable target.
+ */
+import { type TouchedConstant } from './patch.js';
+export declare const DEFAULT_HEAL_TARGET_GLOBS: readonly ["src/**/*.constants.ts", "src/**/*.page.ts", "src/**/*.section.ts", "tests/**/*.spec.ts", "tests/**/*.test.ts"];
+export type HealTargetKind = 'constants' | 'page-object' | 'spec';
+export interface ResolvedSelectorSource {
+    readonly kind: HealTargetKind;
+    readonly file: string;
+    readonly text: string;
+    readonly hits: readonly TouchedConstant[];
+}
+export declare function classifyHealTarget(file: string): HealTargetKind;
+export declare function globToRegExp(glob: string): RegExp;
+export declare function resolveSelectorSource(input: {
+    readonly cwd: string;
+    readonly value: string;
+    readonly globs?: readonly string[] | undefined;
+}): Promise<ResolvedSelectorSource | null>;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../src/resolve.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,EAAgB,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAEhE,eAAO,MAAM,yBAAyB,2HAM5B,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,aAAa,GAAG,MAAM,CAAC;AAElE,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,SAAS,eAAe,EAAE,CAAC;CAC3C;AAUD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAK/D;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CASjD;AAkBD,wBAAsB,qBAAqB,CAAC,KAAK,EAAE;IACjD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;CAChD,GAAG,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC,CAyBzC"}

package/dist/resolve.js

@@ -0,0 +1,87 @@
+/**
+ * Find the file that actually holds a drifted locator.
+ *
+ * Healing used to require `--constants` because the first suite kept every
+ * selector in `*.constants.ts`. Suites also inline literals in page objects
+ * and specs (`getByTestId('page-header')`). The engine walks configured globs
+ * and prefers the most reviewable target.
+ */
+import { readdir, readFile } from 'node:fs/promises';
+import { join, relative } from 'node:path';
+import { findConstant } from './patch.js';
+export const DEFAULT_HEAL_TARGET_GLOBS = [
+    'src/**/*.constants.ts',
+    'src/**/*.page.ts',
+    'src/**/*.section.ts',
+    'tests/**/*.spec.ts',
+    'tests/**/*.test.ts',
+];
+const KIND_RANK = {
+    constants: 0,
+    'page-object': 1,
+    spec: 2,
+};
+const SKIP_DIRS = new Set(['node_modules', 'dist', 'dist-cjs', '.git', 'test-results', 'playwright-report']);
+export function classifyHealTarget(file) {
+    const normalized = file.replace(/\\/g, '/');
+    if (/\.constants\.ts$/.test(normalized) || /\/constants\//.test(normalized))
+        return 'constants';
+    if (/\.(?:page|section)\.ts$/.test(normalized))
+        return 'page-object';
+    return 'spec';
+}
+export function globToRegExp(glob) {
+    const escaped = glob.replace(/[.+^${}()|[\]\\]/g, '\\$&');
+    const withBraces = escaped.replace(/\{([^}]+)\}/g, (_, inner) => {
+        const options = inner.split(',').map(part => part.trim()).join('|');
+        return `(?:${options})`;
+    });
+    const withDouble = withBraces.replace(/\*\*/g, '\u0000');
+    const withSingle = withDouble.replace(/\*/g, '[^/]*').replace(/\u0000/g, '.*');
+    return new RegExp(`^${withSingle}$`);
+}
+async function walkFiles(root) {
+    const out = [];
+    const entries = await readdir(root, { withFileTypes: true }).catch(() => []);
+    for (const entry of entries) {
+        if (entry.name.startsWith('.') && entry.name !== '.')
+            continue;
+        const path = join(root, entry.name);
+        if (entry.isDirectory()) {
+            if (SKIP_DIRS.has(entry.name))
+                continue;
+            out.push(...(await walkFiles(path)));
+            continue;
+        }
+        if (entry.isFile() && entry.name.endsWith('.ts'))
+            out.push(path);
+    }
+    return out;
+}
+export async function resolveSelectorSource(input) {
+    const globs = input.globs ?? DEFAULT_HEAL_TARGET_GLOBS;
+    const patterns = globs.map(globToRegExp);
+    const files = await walkFiles(input.cwd);
+    const matches = [];
+    for (const absolute of files) {
+        const relativePath = relative(input.cwd, absolute).split('\\').join('/');
+        if (!patterns.some(pattern => pattern.test(relativePath)))
+            continue;
+        const text = await readFile(absolute, 'utf8').catch(() => null);
+        if (text === null)
+            continue;
+        const hits = findConstant(text, relativePath, input.value);
+        if (hits.length === 0)
+            continue;
+        matches.push({
+            kind: classifyHealTarget(relativePath),
+            file: relativePath,
+            text,
+            hits,
+        });
+    }
+    if (matches.length === 0)
+        return null;
+    return [...matches].sort((a, b) => KIND_RANK[a.kind] - KIND_RANK[b.kind])[0] ?? null;
+}
+//# sourceMappingURL=resolve.js.map

package/dist/resolve.js.map

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

package/dist/validate.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Validation: Playwright decides, not the score.
+ *
+ * A candidate's score orders the queue. Whether a heal is ACCEPTED is settled
+ * by re-running the failing test with the patch applied — N times, plus the
+ * rest of the spec file. Confidence never authorises a change.
+ *
+ * The collateral check is the one that catches the seductive-but-wrong heal.
+ * Retargeting a constant to a container element can make one assertion pass
+ * while quietly breaking the other nine tests that read the same constant —
+ * and a patch that passes its own test while breaking its neighbours is
+ * exactly what an unattended healing loop would merrily commit.
+ */
+export type ValidationStatus = 'validated' | 'target-still-failing' | 'collateral-damage' | 'inconclusive';
+export interface ValidationRecord {
+    readonly status: ValidationStatus;
+    readonly runs: number;
+    readonly targetPassed: number;
+    readonly targetTotal: number;
+    readonly collateralPassed: number;
+    /** Tests that passed BEFORE the patch and fail after — the ones that matter. */
+    readonly collateralRegressed: readonly string[];
+    /** Tests already failing before the patch; not the patch's fault. */
+    readonly preexistingFailures: readonly string[];
+    readonly message: string;
+}
+export interface ValidateOptions {
+    readonly cwd: string;
+    /** Spec file containing the failing test. */
+    readonly specFile: string;
+    readonly testTitle: string;
+    /** File the patch rewrites (constants, page object, or spec). */
+    readonly patchFile: string;
+    readonly patchedText: string;
+    readonly config?: string | undefined;
+    readonly project?: string | undefined;
+    readonly runs: number;
+    readonly checkCollateral: boolean;
+    readonly timeoutMs?: number | undefined;
+}
+/**
+ * Apply the patch, run, restore — always.
+ *
+ * The original is moved aside rather than held in memory so that a crash
+ * mid-validation leaves a recoverable file on disk instead of a half-healed
+ * repository. Restoration runs in `finally`, and the backup is only removed
+ * once the original is definitely back.
+ */
+export declare function validateHeal(options: ValidateOptions): Promise<ValidationRecord>;
+//# sourceMappingURL=validate.d.ts.map

package/dist/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,MAAM,MAAM,gBAAgB,GACxB,WAAW,GACX,sBAAsB,GACtB,mBAAmB,GACnB,cAAc,CAAC;AAEnB,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,gFAAgF;IAChF,QAAQ,CAAC,mBAAmB,EAAE,SAAS,MAAM,EAAE,CAAC;IAChD,qEAAqE;IACrE,QAAQ,CAAC,mBAAmB,EAAE,SAAS,MAAM,EAAE,CAAC;IAChD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,6CAA6C;IAC7C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,iEAAiE;IACjE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACzC;AAID;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA+ItF"}

package/dist/validate.js

@@ -0,0 +1,157 @@
+/**
+ * Validation: Playwright decides, not the score.
+ *
+ * A candidate's score orders the queue. Whether a heal is ACCEPTED is settled
+ * by re-running the failing test with the patch applied — N times, plus the
+ * rest of the spec file. Confidence never authorises a change.
+ *
+ * The collateral check is the one that catches the seductive-but-wrong heal.
+ * Retargeting a constant to a container element can make one assertion pass
+ * while quietly breaking the other nine tests that read the same constant —
+ * and a patch that passes its own test while breaking its neighbours is
+ * exactly what an unattended healing loop would merrily commit.
+ */
+import { readFile, rename, unlink, writeFile } from 'node:fs/promises';
+import { runPlaywright } from '@aplaytest/runner-playwright';
+const BACKUP_SUFFIX = '.atest-backup';
+/**
+ * Apply the patch, run, restore — always.
+ *
+ * The original is moved aside rather than held in memory so that a crash
+ * mid-validation leaves a recoverable file on disk instead of a half-healed
+ * repository. Restoration runs in `finally`, and the backup is only removed
+ * once the original is definitely back.
+ */
+export async function validateHeal(options) {
+    const backupPath = `${options.patchFile}${BACKUP_SUFFIX}`;
+    const original = await readFile(options.patchFile, 'utf8');
+    // BASELINE FIRST, before the patch exists.
+    //
+    // Without it, any test already failing in this file — for reasons that have
+    // nothing to do with the selector — reads as damage the patch caused, and no
+    // heal in that file could ever be proposed. Only tests that PASSED before
+    // and fail after are the patch's doing. The cost is one extra run of the
+    // file, which is the honest price of not blaming a patch for what it did
+    // not break.
+    const baselineFailures = new Set();
+    if (options.checkCollateral) {
+        const baseline = await runPlaywright({
+            cwd: options.cwd,
+            config: options.config,
+            file: options.specFile,
+            project: options.project,
+            timeoutMs: options.timeoutMs,
+        });
+        for (const spec of baseline.specs) {
+            if (spec.failed > 0)
+                baselineFailures.add(spec.title);
+        }
+    }
+    await writeFile(backupPath, original, 'utf8');
+    await writeFile(options.patchFile, options.patchedText, 'utf8');
+    try {
+        const target = await runPlaywright({
+            cwd: options.cwd,
+            config: options.config,
+            file: options.specFile,
+            grepTitle: options.testTitle,
+            project: options.project,
+            repeatEach: options.runs,
+            timeoutMs: options.timeoutMs,
+        });
+        const targetSpecs = target.specs.filter(s => s.title === options.testTitle);
+        const targetPassed = targetSpecs.reduce((sum, s) => sum + s.passed, 0);
+        const targetFailed = targetSpecs.reduce((sum, s) => sum + s.failed, 0);
+        const targetTotal = targetPassed + targetFailed;
+        if (target.inconclusive || targetTotal === 0) {
+            return {
+                status: 'inconclusive',
+                runs: options.runs,
+                targetPassed: 0,
+                targetTotal: 0,
+                collateralPassed: 0,
+                collateralRegressed: [],
+                preexistingFailures: [...baselineFailures],
+                message: 'The target test did not run under the patch — check the title, file and project. ' +
+                    'An unverified patch is not a heal.',
+            };
+        }
+        // Must pass EVERY time. One flake here means the heal is unproven, not
+        // "mostly working" — and shipping an unproven heal is how a suite starts
+        // lying about what it tests.
+        if (targetPassed !== targetTotal) {
+            return {
+                status: 'target-still-failing',
+                runs: options.runs,
+                targetPassed,
+                targetTotal,
+                collateralPassed: 0,
+                collateralRegressed: [],
+                preexistingFailures: [...baselineFailures],
+                message: `The patched test passed ${targetPassed}/${targetTotal} times. A heal must pass every time.`,
+            };
+        }
+        if (!options.checkCollateral) {
+            return {
+                status: 'validated',
+                runs: options.runs,
+                targetPassed,
+                targetTotal,
+                collateralPassed: 0,
+                collateralRegressed: [],
+                preexistingFailures: [],
+                message: `Target passed ${targetPassed}/${targetTotal}. Collateral check skipped.`,
+            };
+        }
+        const whole = await runPlaywright({
+            cwd: options.cwd,
+            config: options.config,
+            file: options.specFile,
+            project: options.project,
+            timeoutMs: options.timeoutMs,
+        });
+        const others = whole.specs.filter(s => s.title !== options.testTitle);
+        const collateralPassed = others.reduce((sum, s) => sum + s.passed, 0);
+        // Only NEW failures are the patch's doing.
+        const regressed = others
+            .filter(s => s.failed > 0 && !baselineFailures.has(s.title))
+            .map(s => s.title);
+        const preexisting = others.filter(s => baselineFailures.has(s.title)).map(s => s.title);
+        if (regressed.length > 0) {
+            return {
+                status: 'collateral-damage',
+                runs: options.runs,
+                targetPassed,
+                targetTotal,
+                collateralPassed,
+                collateralRegressed: regressed,
+                preexistingFailures: preexisting,
+                message: `The patch fixes its own test but breaks ${regressed.length} that passed before it: ` +
+                    `${regressed.join(', ')}. Rejected.`,
+            };
+        }
+        return {
+            status: 'validated',
+            runs: options.runs,
+            targetPassed,
+            targetTotal,
+            collateralPassed,
+            collateralRegressed: [],
+            preexistingFailures: preexisting,
+            message: `Target passed ${targetPassed}/${targetTotal}; ${collateralPassed} neighbouring test ` +
+                `results unchanged` +
+                (preexisting.length > 0
+                    ? ` (${preexisting.length} were already failing before the patch and still are)`
+                    : ''),
+        };
+    }
+    finally {
+        await writeFile(options.patchFile, original, 'utf8').catch(async () => {
+            // Writing back failed — fall back to moving the backup into place rather
+            // than leaving the repository patched.
+            await rename(backupPath, options.patchFile).catch(() => undefined);
+        });
+        await unlink(backupPath).catch(() => undefined);
+    }
+}
+//# sourceMappingURL=validate.js.map

package/dist/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAEvE,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAoC7D,MAAM,aAAa,GAAG,eAAe,CAAC;AAEtC;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAAwB;IACzD,MAAM,UAAU,GAAG,GAAG,OAAO,CAAC,SAAS,GAAG,aAAa,EAAE,CAAC;IAC1D,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAE3D,2CAA2C;IAC3C,EAAE;IACF,4EAA4E;IAC5E,6EAA6E;IAC7E,0EAA0E;IAC1E,yEAAyE;IACzE,yEAAyE;IACzE,aAAa;IACb,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAU,CAAC;IAC3C,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC;YACnC,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,IAAI,EAAE,OAAO,CAAC,QAAQ;YACtB,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,SAAS,EAAE,OAAO,CAAC,SAAS;SAC7B,CAAC,CAAC;QACH,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;YAClC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;gBAAE,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;IAED,MAAM,SAAS,CAAC,UAAU,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC9C,MAAM,SAAS,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IAEhE,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC;YACjC,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,IAAI,EAAE,OAAO,CAAC,QAAQ;YACtB,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,UAAU,EAAE,OAAO,CAAC,IAAI;YACxB,SAAS,EAAE,OAAO,CAAC,SAAS;SAC7B,CAAC,CAAC;QAEH,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;QAC5E,MAAM,YAAY,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QACvE,MAAM,YAAY,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QACvE,MAAM,WAAW,GAAG,YAAY,GAAG,YAAY,CAAC;QAEhD,IAAI,MAAM,CAAC,YAAY,IAAI,WAAW,KAAK,CAAC,EAAE,CAAC;YAC7C,OAAO;gBACL,MAAM,EAAE,cAAc;gBACtB,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,YAAY,EAAE,CAAC;gBACf,WAAW,EAAE,CAAC;gBACd,gBAAgB,EAAE,CAAC;gBACnB,mBAAmB,EAAE,EAAE;gBACvB,mBAAmB,EAAE,CAAC,GAAG,gBAAgB,CAAC;gBAC1C,OAAO,EACL,mFAAmF;oBACnF,oCAAoC;aACvC,CAAC;QACJ,CAAC;QAED,uEAAuE;QACvE,yEAAyE;QACzE,6BAA6B;QAC7B,IAAI,YAAY,KAAK,WAAW,EAAE,CAAC;YACjC,OAAO;gBACL,MAAM,EAAE,sBAAsB;gBAC9B,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,YAAY;gBACZ,WAAW;gBACX,gBAAgB,EAAE,CAAC;gBACnB,mBAAmB,EAAE,EAAE;gBACvB,mBAAmB,EAAE,CAAC,GAAG,gBAAgB,CAAC;gBAC1C,OAAO,EAAE,2BAA2B,YAAY,IAAI,WAAW,sCAAsC;aACtG,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC;YAC7B,OAAO;gBACL,MAAM,EAAE,WAAW;gBACnB,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,YAAY;gBACZ,WAAW;gBACX,gBAAgB,EAAE,CAAC;gBACnB,mBAAmB,EAAE,EAAE;gBACvB,mBAAmB,EAAE,EAAE;gBACvB,OAAO,EAAE,iBAAiB,YAAY,IAAI,WAAW,6BAA6B;aACnF,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC;YAChC,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,IAAI,EAAE,OAAO,CAAC,QAAQ;YACtB,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,SAAS,EAAE,OAAO,CAAC,SAAS;SAC7B,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;QACtE,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QACtE,2CAA2C;QAC3C,MAAM,SAAS,GAAG,MAAM;aACrB,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;aAC3D,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QACrB,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAExF,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzB,OAAO;gBACL,MAAM,EAAE,mBAAmB;gBAC3B,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,YAAY;gBACZ,WAAW;gBACX,gBAAgB;gBAChB,mBAAmB,EAAE,SAAS;gBAC9B,mBAAmB,EAAE,WAAW;gBAChC,OAAO,EACL,2CAA2C,SAAS,CAAC,MAAM,0BAA0B;oBACrF,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa;aACvC,CAAC;QACJ,CAAC;QAED,OAAO;YACL,MAAM,EAAE,WAAW;YACnB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,YAAY;YACZ,WAAW;YACX,gBAAgB;YAChB,mBAAmB,EAAE,EAAE;YACvB,mBAAmB,EAAE,WAAW;YAChC,OAAO,EACL,iBAAiB,YAAY,IAAI,WAAW,KAAK,gBAAgB,qBAAqB;gBACtF,mBAAmB;gBACnB,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC;oBACrB,CAAC,CAAC,KAAK,WAAW,CAAC,MAAM,uDAAuD;oBAChF,CAAC,CAAC,EAAE,CAAC;SACV,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,MAAM,SAAS,CAAC,OAAO,CAAC,SAAS,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE;YACpE,yEAAyE;YACzE,uCAAuC;YACvC,MAAM,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QACrE,CAAC,CAAC,CAAC;QACH,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAClD,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@aplaytest/heal",
+  "version": "0.1.0",
+  "description": "Deterministic selector healing: candidates, validation, and constants patching",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc --build",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@aplaytest/core": "^0.1.0",
+    "@aplaytest/runner-playwright": "^0.1.0",
+    "ts-morph": "^28.0.0"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ianoflynnautomation/aplaytest.git",
+    "directory": "packages/heal"
+  },
+  "homepage": "https://github.com/ianoflynnautomation/aplaytest#readme",
+  "bugs": {
+    "url": "https://github.com/ianoflynnautomation/aplaytest/issues"
+  }
+}