@ia-qa/self-healing 1.7.26 → 1.8.2

package/dist/testDepth.js

@@ -0,0 +1,174 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.computePageDepth = computePageDepth;
+exports.collectUnattributable = collectUnattributable;
+exports.computeTestDepth = computeTestDepth;
+exports.readTestDepth = readTestDepth;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const config_1 = require("./config");
+const ingest_1 = require("./ingest");
+const resolution_1 = require("./resolution");
+const nameLocators_1 = require("./nameLocators");
+const exercised_1 = require("./exercised");
+/** Does this name-anchored site designate an element of this role? */
+function siteMatchesRole(site, role) {
+    const roles = (0, nameLocators_1.candidateRoles)(site);
+    return roles !== null && roles.includes(role);
+}
+/**
+ * The contract selectors a test literal provably reaches, from one page's resolution.
+ *
+ * `bound` only. An `anchored` binding names an identity selector for an element the contract
+ * does **not** hold — it is a repair target, not evidence that a contracted element is
+ * covered — and `ambiguous` is a coin flip the suite created. Counting either as coverage
+ * would inflate the one number this file exists to state honestly.
+ */
+function boundSelectors(resolution) {
+    const out = new Set();
+    if (!resolution)
+        return out;
+    for (const binding of Object.values(resolution.bindings)) {
+        if (binding.status === 'bound' && binding.selector)
+            out.add(binding.selector);
+    }
+    return out;
+}
+function computePageDepth(mapping, usage, resolution) {
+    const bound = boundSelectors(resolution);
+    const files = new Set();
+    let named = 0;
+    for (const el of mapping.elements ?? []) {
+        let hit = false;
+        // A test writing the contract's own selector, and a test writing a different string
+        // that a browser proved reaches this element. The second is the common case in a
+        // legacy Page Object suite, and the whole reason `_resolved/` exists.
+        const literalSites = usage?.selectors?.[el.selector];
+        if (literalSites?.length) {
+            hit = true;
+            for (const s of literalSites)
+                files.add(s.file);
+        }
+        if (bound.has(el.selector))
+            hit = true;
+        // Name-anchored locators, credited only when the call's role can be this element's.
+        // `getByRole('button', {name:'Save'})` does not cover a link also called Save.
+        const nameSites = usage?.names?.[(0, nameLocators_1.normalizeName)(el.name)];
+        if (nameSites?.length) {
+            for (const site of nameSites) {
+                if (!(0, nameLocators_1.judgeable)(site) || !siteMatchesRole(site, el.role))
+                    continue;
+                hit = true;
+                files.add(site.file);
+            }
+        }
+        if (hit)
+            named += 1;
+    }
+    return {
+        page: mapping.page,
+        elements: (mapping.elements ?? []).length,
+        named,
+        files: Array.from(files).sort(),
+        ...(mapping.exploredDepth != null ? { exploredDepth: mapping.exploredDepth } : {}),
+    };
+}
+/**
+ * Which literals in the inventory cannot be attributed to any element, deduplicated by
+ * source position — one line of a test file is one finding, however many pages it fails to
+ * match.
+ */
+function collectUnattributable(usage) {
+    if (!usage?.names)
+        return [];
+    const seen = new Set();
+    const out = [];
+    for (const sites of Object.values(usage.names)) {
+        for (const site of sites) {
+            if ((0, nameLocators_1.judgeable)(site))
+                continue;
+            const key = `${site.file}:${site.line}`;
+            if (seen.has(key))
+                continue;
+            seen.add(key);
+            out.push({ text: site.text, file: site.file, line: site.line, shape: site.shape });
+        }
+    }
+    return out.sort((a, b) => (a.file === b.file ? a.line - b.line : a.file.localeCompare(b.file)));
+}
+function computeTestDepth(mappings, usage, resolutions) {
+    const measurable = !!usage && (Object.keys(usage.selectors ?? {}).length > 0 || Object.keys(usage.names ?? {}).length > 0);
+    const pages = mappings
+        .map((m) => computePageDepth(m, usage, resolutions.get(m.page) ?? null))
+        .sort((a, b) => a.page.localeCompare(b.page));
+    return {
+        measurable,
+        pages,
+        totals: {
+            pages: pages.length,
+            elements: pages.reduce((s, p) => s + p.elements, 0),
+            named: pages.reduce((s, p) => s + p.named, 0),
+        },
+        unattributable: collectUnattributable(usage),
+        shallowPages: pages.filter((p) => p.exploredDepth == null).length,
+    };
+}
+/**
+ * The same computation, reading `.ia-qa/` from disk.
+ *
+ * Kept apart from `computeTestDepth` so the rules above stay testable without a filesystem,
+ * and exported so `@ia-qa/qa-discovery` computes depth with **this** implementation rather
+ * than a second one — the coverage map and the healing summary must never be able to
+ * disagree about the same two files.
+ */
+function readTestDepth(dir = (0, config_1.mappingDir)(), resolved = (0, config_1.resolvedDir)()) {
+    const mappings = [];
+    for (const page of (0, exercised_1.contractPageNames)(dir)) {
+        try {
+            mappings.push(JSON.parse(fs.readFileSync(path.join(dir, `${page}.json`), 'utf8')));
+        }
+        catch {
+            // An unreadable contract is one page missing from the denominator, never a crash:
+            // the same restraint `map` applies per page. It is reported by nothing here because
+            // every other verb that reads the same directory already reports it.
+        }
+    }
+    const resolutions = new Map();
+    for (const r of (0, resolution_1.loadAllResolutions)(resolved))
+        resolutions.set(r.page, r);
+    return computeTestDepth(mappings, (0, ingest_1.loadUsage)(), resolutions);
+}
+//# sourceMappingURL=testDepth.js.map

package/dist/testDepth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testDepth.js","sourceRoot":"","sources":["../src/testDepth.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuGA,4CA2CC;AAOD,sDAcC;AAED,4CAuBC;AAUD,sCAcC;AAxND,uCAAyB;AACzB,2CAA6B;AAE7B,qCAAmD;AACnD,qCAAqC;AAErC,6CAAkD;AAElD,iDAA0E;AAE1E,2CAAgD;AAsEhD,sEAAsE;AACtE,SAAS,eAAe,CAAC,IAAc,EAAE,IAAY;IACnD,MAAM,KAAK,GAAG,IAAA,6BAAc,EAAC,IAAI,CAAC,CAAC;IACnC,OAAO,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAChD,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,cAAc,CAAC,UAAiC;IACvD,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,IAAI,CAAC,UAAU;QAAE,OAAO,GAAG,CAAC;IAC5B,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzD,IAAI,OAAO,CAAC,MAAM,KAAK,OAAO,IAAI,OAAO,CAAC,QAAQ;YAAE,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAChF,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAgB,gBAAgB,CAC9B,OAAoB,EACpB,KAAmB,EACnB,UAAiC;IAEjC,MAAM,KAAK,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;IACzC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,KAAK,MAAM,EAAE,IAAI,OAAO,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;QACxC,IAAI,GAAG,GAAG,KAAK,CAAC;QAEhB,oFAAoF;QACpF,iFAAiF;QACjF,sEAAsE;QACtE,MAAM,YAAY,GAAG,KAAK,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC;QACrD,IAAI,YAAY,EAAE,MAAM,EAAE,CAAC;YACzB,GAAG,GAAG,IAAI,CAAC;YACX,KAAK,MAAM,CAAC,IAAI,YAAY;gBAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAClD,CAAC;QACD,IAAI,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,QAAQ,CAAC;YAAE,GAAG,GAAG,IAAI,CAAC;QAEvC,oFAAoF;QACpF,+EAA+E;QAC/E,MAAM,SAAS,GAAG,KAAK,EAAE,KAAK,EAAE,CAAC,IAAA,4BAAa,EAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;QACzD,IAAI,SAAS,EAAE,MAAM,EAAE,CAAC;YACtB,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;gBAC7B,IAAI,CAAC,IAAA,wBAAS,EAAC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC;oBAAE,SAAS;gBAClE,GAAG,GAAG,IAAI,CAAC;gBACX,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACvB,CAAC;QACH,CAAC;QAED,IAAI,GAAG;YAAE,KAAK,IAAI,CAAC,CAAC;IACtB,CAAC;IAED,OAAO;QACL,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,QAAQ,EAAE,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,MAAM;QACzC,KAAK;QACL,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE;QAC/B,GAAG,CAAC,OAAO,CAAC,aAAa,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACnF,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,SAAgB,qBAAqB,CAAC,KAAmB;IACvD,IAAI,CAAC,KAAK,EAAE,KAAK;QAAE,OAAO,EAAE,CAAC;IAC7B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,GAAG,GAAyB,EAAE,CAAC;IACrC,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;QAC/C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,IAAA,wBAAS,EAAC,IAAI,CAAC;gBAAE,SAAS;YAC9B,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACxC,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,SAAS;YAC5B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACd,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;QACrF,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClG,CAAC;AAED,SAAgB,gBAAgB,CAC9B,QAAuB,EACvB,KAAmB,EACnB,WAAwC;IAExC,MAAM,UAAU,GACd,CAAC,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAE1G,MAAM,KAAK,GAAG,QAAQ;SACnB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,CAAC,EAAE,KAAK,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC;SACvE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAEhD,OAAO;QACL,UAAU;QACV,KAAK;QACL,MAAM,EAAE;YACN,KAAK,EAAE,KAAK,CAAC,MAAM;YACnB,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;YACnD,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;SAC9C;QACD,cAAc,EAAE,qBAAqB,CAAC,KAAK,CAAC;QAC5C,YAAY,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,IAAI,IAAI,CAAC,CAAC,MAAM;KAClE,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,aAAa,CAAC,MAAc,IAAA,mBAAU,GAAE,EAAE,WAAmB,IAAA,oBAAW,GAAE;IACxF,MAAM,QAAQ,GAAkB,EAAE,CAAC;IACnC,KAAK,MAAM,IAAI,IAAI,IAAA,6BAAiB,EAAC,GAAG,CAAC,EAAE,CAAC;QAC1C,IAAI,CAAC;YACH,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,OAAO,CAAC,EAAE,MAAM,CAAC,CAAgB,CAAC,CAAC;QACpG,CAAC;QAAC,MAAM,CAAC;YACP,kFAAkF;YAClF,oFAAoF;YACpF,qEAAqE;QACvE,CAAC;IACH,CAAC;IACD,MAAM,WAAW,GAAG,IAAI,GAAG,EAA0B,CAAC;IACtD,KAAK,MAAM,CAAC,IAAI,IAAA,+BAAkB,EAAC,QAAQ,CAAC;QAAE,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACzE,OAAO,gBAAgB,CAAC,QAAQ,EAAE,IAAA,kBAAS,GAAE,EAAE,WAAW,CAAC,CAAC;AAC9D,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ia-qa/self-healing",
-  "version": "1.7.26",
+  "version": "1.8.2",
   "description": "Your Playwright, Cypress or Selenium tests break when a selector moves — this finds the element again and rewrites the test. Deterministic: no LLM decides whether your build passes. Runs entirely on your machine, with a local MCP server for agents.",
   "keywords": [
     "self-healing",