@ia-qa/self-healing 1.7.25 → 1.7.26

package/README.md

@@ -568,13 +568,28 @@ interactive element by role and accessible name, for repairing broken locators.
 *surface* — pages, headings, inputs, API calls, for deciding what to test in the first place.
 Neither produces the other.
 
+**And `scan` is not `ia-qa-heal discover` either — this is the one people actually conflate.**
+Both crawl, and the names hide the difference. `discover` answers *"which routes are missing
+from my `config.pages`?"* and hands you `{ name, url }` candidates. `scan` answers *"what does
+this app take as input?"* and hands you what is behind each URL. Measured on the same four pages
+of ia-qa.com: `discover` returns 4 pairs; `scan` returns those pages plus 159 headings, 3 input
+fields with their captured labels, 9 observed API calls, and the finding that none of the three
+can be located durably.
+
+**So if you only want to fill `config.pages`, use `discover` and install nothing.** That is what
+it is for, and it is already here.
+
 They are built to hand off, though. `config.pages` has the same `{ name, url }` shape in both,
 and both resolve page names through the *same* function, so a page called `checkout` in one is
 `checkout` in the other — the artifacts line up 1:1. Sessions are interchangeable too, since
 both consume a Playwright `storageState`: `ia-qa-heal map --session .ia-qa-discovery/session.json`.
 
 And in the other direction: this package knows what your suite **covers**, discovery knows what
-**exists**. The gap between the two is your real coverage, which neither can tell you alone.
+**exists**. The gap between the two is your real coverage — and it is computed rather than
+described: run `ia-qa-discover scan` in a project that already has `.ia-qa/mapping/` and it ends
+by naming the pages that exist with no contract. It is not a verdict (a page may be out of scope
+on purpose), and a contracted page the scan did not reach is reported as a limit of the scan,
+never as a page that vanished.
 
 ## Going deeper
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ia-qa/self-healing",
-  "version": "1.7.25",
+  "version": "1.7.26",
   "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",