@ia-qa/self-healing 1.19.1 → 1.23.0

package/README.md

@@ -422,8 +422,63 @@ rewrites the literal in your files. Four outcomes, one repaired automatically:
 | reaches **nothing**, and its element is still there | 🔧 rewritten |
 | reaches a **different** element | ⛔ never rewritten — your test passes and acts on the wrong thing |
 | reaches **several** elements | ⛔ a coin flip |
+| reached **several** and now reaches **none** | ⛔ the candidates are named, none is chosen for you |
 | its element is **gone** | ⛔ nothing to rewrite towards |
 
+That fourth row is the one a route migration produces — every `a[href="/index.php/cart"]`
+becoming `a[href="/cart"]` in one commit. The string used to match two links and now matches
+neither, so your suite is red; what it could have meant is still on the page and is listed with
+its new address. No rewrite is offered, and that is not timidity: the binding was already
+ambiguous, so which of the two your test meant was never established. Picking one would be a
+coin flip wearing a fix's clothes.
+
+### A link that leads somewhere else
+
+`href` is a **destination**, not an address. Because `stableSelector` prefers `a[href="…"]`,
+a link whose route moved shows up as a moved selector — reported, until now, on the same line
+as a button that slid one slot down the DOM:
+
+```
+🧭 2 links now lead somewhere else (the element is the same — its destination is not):
+   • Write a contract in the browser →   [home]
+      /devtools/eval-contract-runner  →  /qatools/eval-contract
+   • ?   [mcp-server]
+      /devtools/eval-contract-runner  →  /qatools/eval-contract
+   Not failing the run — no test navigates to these. Check the ones you reach by URL.
+```
+
+It **does not fail your run on its own**: an app is allowed to reorganise its URLs, and a gate
+that goes red on that is a gate someone switches off. It fails only when your suite navigates
+to the route that moved — `ingest` now inventories `page.goto`, `cy.visit`, `driver.get` and
+`browser.url`, so that case arrives with its `file:line`. No `ingest`, no escalation.
+
+Nothing here is ever rewritten. A `page.goto` is not a locator, and the new route may be the
+same page renamed or a different page entirely — you can tell in a second from two URLs, and
+the tool cannot tell at all.
+
+Measured across two real captures of a 142-page app: **2 findings over 4 563 named links**, and
+zero on a second corpus. Details, including the false positives the first measurement produced,
+are in `SPEC-route-drift.md`.
+
+### When a page you declared has moved
+
+`map` already notices that the browser landed somewhere other than the URL in `config.json`.
+It now offers the correction, and `--fix-redirects` writes it:
+
+```
+↪️  1 declared page is no longer at the URL config.json declares:
+   articles:  /articles  →  /resources
+   Run `ia-qa-heal map --fix-redirects` to write these, or edit config.json yourself.
+```
+
+Left uncorrected, the contract for `/resources` is written under the name `articles`, which is
+the same wrong-identity problem two apps sharing a `/login` produce.
+
+**It refuses when several declared pages land on the same place.** That is not a migration —
+it is an expired session, a redirect to sign-in, or an outage, and applying it would rewrite
+your whole page list to point at the login screen. The group is named and skipped, a genuine
+single move in the same run still applies, and the message sends you to `session --check`.
+
 **Your app may already carry the answer.** The contract holds interactive elements only, so a
 selector on a status div, a cell or an alert is not in it. Usually that stays quiet — such an
 element has no identity independent of what drifts, so nothing could be repaired anyway. But

package/TUTORIAL.md

@@ -558,6 +558,28 @@ the `file:line` the error message never carried.
 > **cannot tell which locator the failure is about**, that's not a pass — usually the failing
 > file was never `ingest`ed, or the locator is built at runtime from a variable.
 
+> 🧭 **A locator can be fine and the page still wrong.** If a link's *destination* moved —
+> `/devtools/eval-contract-runner` → `/qatools/eval-contract` — the element is untouched, so
+> every locator check passes. `explain` used to answer PASS there, which is true and sends you
+> to look at timing and test data instead of at the route. It now intersects the failure text
+> with the URLs your suite navigates to and answers **BLOCK**, naming both routes and the line
+> that goes to the old one. `diff` reports the same thing under *"N links now lead somewhere else"*, with
+> the page each is on. It does not fail your run unless your suite navigates to the old route,
+> which it knows because `ingest` inventories `page.goto`, `cy.visit`, `driver.get` and
+> `browser.url`. Nothing there is ever rewritten: only you can say whether the new route is the
+> same page renamed or a different page. And when it is a page *you declared* that moved,
+> `ia-qa-heal map --fix-redirects` updates `config.json` — refusing if several pages landed in
+> the same place, because that is an expired session, not a migration.
+
+> 🐛 **Fixed in 1.20.0, and worth knowing if you are on an older version.** `explain` used to
+> answer *"this string reached nothing at either moment — it is not drift"* about locators that
+> had reached something at baseline. It read only the current capture and phrased the verdict as
+> if it had read both. That is the worst place in this tool for a false negative: "not drift" is
+> the sentence that sends you away from the selectors and off to look at timing and test data.
+> It now reads `baseline/_resolved/` too, and a locator that resolved then and resolves no longer
+> comes back as drift, with `never-bound` kept for what it always meant — probed at both moments,
+> reached nothing at either.
+
 Read-only: it opens no browser, re-runs nothing, and edits nothing. Repairs still go through
 `fix`, below.
 

package/dist/aom.d.ts

@@ -132,5 +132,25 @@ export declare function depthMismatchMessage(m: {
     current: number;
 }): string;
 export declare function extractInteractiveElements(page: Page): Promise<MappedElement[]>;
+/**
+ * The `.json` files in a contract directory that are **contracts**.
+ *
+ * A leading underscore is how this codebase spells "not a page" — `_exercised.json`,
+ * `_resolved/`, `_layouts/`. The rule was written down as *"every consumer that enumerates
+ * contracts already filters it out"*, and it was true of three of them and false of two.
+ *
+ * What that cost, reproduced end to end: `run` writes `mapping/_exercised.json`, `baseline`
+ * promotes it (this directory is copied wholesale, which is right — the record belongs to the
+ * moment), and then **`diff --dir` and `fix --dir` both read it as a page named `_exercised`**,
+ * fail on `has no "elements" array`, put it in `unreadable` and refuse the entire comparison
+ * with exit 2. The remedy they printed — *restore the file from git, or re-capture it* — could
+ * not work: re-capturing writes the same file again. A tool breaking its own documented loop
+ * with a file it wrote itself, and telling the user to fix it by hand.
+ *
+ * So the rule lives here now, in the module that knows what a contract is, and the five call
+ * sites share it. Three of them already agreed; the point is that agreeing by coincidence is
+ * what produced this.
+ */
+export declare function contractFilesIn(dir: string): string[];
 export declare function saveMapping(mapping: PageMapping, dir?: string): string;
 export declare function loadMapping(pageName: string, dir?: string): PageMapping;

package/dist/aom.js

@@ -37,6 +37,7 @@ exports.isSameCapture = isSameCapture;
 exports.depthMismatch = depthMismatch;
 exports.depthMismatchMessage = depthMismatchMessage;
 exports.extractInteractiveElements = extractInteractiveElements;
+exports.contractFilesIn = contractFilesIn;
 exports.saveMapping = saveMapping;
 exports.loadMapping = loadMapping;
 const fs = __importStar(require("fs"));
@@ -112,6 +113,30 @@ function depthMismatchMessage(m) {
 async function extractInteractiveElements(page) {
     return page.evaluate(extract_1.extractInPage);
 }
+/**
+ * The `.json` files in a contract directory that are **contracts**.
+ *
+ * A leading underscore is how this codebase spells "not a page" — `_exercised.json`,
+ * `_resolved/`, `_layouts/`. The rule was written down as *"every consumer that enumerates
+ * contracts already filters it out"*, and it was true of three of them and false of two.
+ *
+ * What that cost, reproduced end to end: `run` writes `mapping/_exercised.json`, `baseline`
+ * promotes it (this directory is copied wholesale, which is right — the record belongs to the
+ * moment), and then **`diff --dir` and `fix --dir` both read it as a page named `_exercised`**,
+ * fail on `has no "elements" array`, put it in `unreadable` and refuse the entire comparison
+ * with exit 2. The remedy they printed — *restore the file from git, or re-capture it* — could
+ * not work: re-capturing writes the same file again. A tool breaking its own documented loop
+ * with a file it wrote itself, and telling the user to fix it by hand.
+ *
+ * So the rule lives here now, in the module that knows what a contract is, and the five call
+ * sites share it. Three of them already agreed; the point is that agreeing by coincidence is
+ * what produced this.
+ */
+function contractFilesIn(dir) {
+    if (!fs.existsSync(dir))
+        return [];
+    return fs.readdirSync(dir).filter((f) => f.endsWith('.json') && !f.startsWith('.') && !f.startsWith('_'));
+}
 function saveMapping(mapping, dir = (0, config_1.mappingDir)()) {
     fs.mkdirSync(dir, { recursive: true });
     const file = (0, config_1.mappingPath)(mapping.page, dir);

package/dist/aom.js.map

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

package/dist/browser/resolve.js

@@ -157,7 +157,10 @@ function resolveSelectors(args) {
             out[pom] = anchor ? { status: 'anchored', selector: anchor } : { status: 'outside' };
         }
         else {
-            out[pom] = { status: 'ambiguous', count: nodes.length };
+            // `mapped` is every contracted element this string could have meant. Recording it is
+            // what lets the next capture ask whether they survived: without it an ambiguous
+            // binding is a dead end, and the drift it hides is invisible to every other check.
+            out[pom] = { status: 'ambiguous', count: nodes.length, selectors: mapped };
         }
     }
     return out;

package/dist/browser/resolve.js.map

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

package/dist/cli/args.js

@@ -20,7 +20,7 @@ exports.KNOWN_FLAGS = {
     login: ['--url', '--session'],
     secret: ['--json'],
     session: ['--check', '--offline', '--url', '--session', '--json'],
-    map: ['--screenshots', '--session', '--deep', '--depth', '--deep-budget'],
+    map: ['--screenshots', '--session', '--deep', '--depth', '--deep-budget', '--fix-redirects'],
     baseline: ['--dry-run'],
     diff: ['--strict', '--json', '--junit', '--dir', '--report', '--open'],
     fix: ['--dry-run', '--locators', '--dir', '--json'],

package/dist/cli/args.js.map

@@ -1 +1 @@
-{"version":3,"file":"args.js","sourceRoot":"","sources":["../../src/cli/args.ts"],"names":[],"mappings":";;;AAkCA,gDAeC;AAjDD;;;;;;;;;;;GAWG;AACU,QAAA,WAAW,GAAsC;IAC5D,IAAI,EAAE,CAAC,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,SAAS,EAAE,gBAAgB,EAAE,aAAa,CAAC;IAClG,QAAQ,EAAE,CAAC,WAAW,EAAE,SAAS,EAAE,aAAa,EAAE,eAAe,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,WAAW,CAAC;IAC9G,KAAK,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC;IAC7B,MAAM,EAAE,CAAC,QAAQ,CAAC;IAClB,OAAO,EAAE,CAAC,SAAS,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,CAAC;IACjE,GAAG,EAAE,CAAC,eAAe,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,eAAe,CAAC;IACzE,QAAQ,EAAE,CAAC,WAAW,CAAC;IACvB,IAAI,EAAE,CAAC,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,CAAC;IACtE,GAAG,EAAE,CAAC,WAAW,EAAE,YAAY,EAAE,OAAO,EAAE,QAAQ,CAAC;IACnD,MAAM,EAAE,CAAC,QAAQ,CAAC;IAClB,KAAK,EAAE,CAAC,UAAU,EAAE,QAAQ,CAAC;IAC7B,OAAO,EAAE,CAAC,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,QAAQ,CAAC;IACvD,KAAK,EAAE,CAAC,UAAU,EAAE,QAAQ,EAAE,WAAW,EAAE,eAAe,CAAC;IAC3D,KAAK,EAAE,CAAC,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAC;IAChD,GAAG,EAAE,CAAC,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,CAAC;IACtF,KAAK,EAAE,CAAC,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,CAAC;IAC7D,OAAO,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC;IAC9B,YAAY,EAAE,CAAC,QAAQ,CAAC;IACxB,EAAE,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,WAAW,CAAC;CACnF,CAAC;AAEF,SAAgB,kBAAkB,CAAC,OAAe,EAAE,IAAc;IAChE,MAAM,KAAK,GAAG,mBAAW,CAAC,OAAO,CAAC,CAAC;IACnC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO;IAChC,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACrB,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QACjC,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;YAAE,SAAS;QAChC,IAAI,CAAC,KAAK,MAAM,IAAI,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YAC1C,MAAM,IAAI,KAAK,CACb,eAAe,OAAO,0FAA0F;gBAC9G,4GAA4G;gBAC5G,8FAA8F,CACjG,CAAC;QACJ,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,qBAAqB,OAAO,8CAA8C,CAAC,CAAC;IAChH,CAAC;AACH,CAAC"}
+{"version":3,"file":"args.js","sourceRoot":"","sources":["../../src/cli/args.ts"],"names":[],"mappings":";;;AAkCA,gDAeC;AAjDD;;;;;;;;;;;GAWG;AACU,QAAA,WAAW,GAAsC;IAC5D,IAAI,EAAE,CAAC,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,SAAS,EAAE,gBAAgB,EAAE,aAAa,CAAC;IAClG,QAAQ,EAAE,CAAC,WAAW,EAAE,SAAS,EAAE,aAAa,EAAE,eAAe,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,WAAW,CAAC;IAC9G,KAAK,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC;IAC7B,MAAM,EAAE,CAAC,QAAQ,CAAC;IAClB,OAAO,EAAE,CAAC,SAAS,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,CAAC;IACjE,GAAG,EAAE,CAAC,eAAe,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,eAAe,EAAE,iBAAiB,CAAC;IAC5F,QAAQ,EAAE,CAAC,WAAW,CAAC;IACvB,IAAI,EAAE,CAAC,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,CAAC;IACtE,GAAG,EAAE,CAAC,WAAW,EAAE,YAAY,EAAE,OAAO,EAAE,QAAQ,CAAC;IACnD,MAAM,EAAE,CAAC,QAAQ,CAAC;IAClB,KAAK,EAAE,CAAC,UAAU,EAAE,QAAQ,CAAC;IAC7B,OAAO,EAAE,CAAC,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,QAAQ,CAAC;IACvD,KAAK,EAAE,CAAC,UAAU,EAAE,QAAQ,EAAE,WAAW,EAAE,eAAe,CAAC;IAC3D,KAAK,EAAE,CAAC,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAC;IAChD,GAAG,EAAE,CAAC,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,CAAC;IACtF,KAAK,EAAE,CAAC,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,CAAC;IAC7D,OAAO,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC;IAC9B,YAAY,EAAE,CAAC,QAAQ,CAAC;IACxB,EAAE,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,WAAW,CAAC;CACnF,CAAC;AAEF,SAAgB,kBAAkB,CAAC,OAAe,EAAE,IAAc;IAChE,MAAM,KAAK,GAAG,mBAAW,CAAC,OAAO,CAAC,CAAC;IACnC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO;IAChC,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACrB,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QACjC,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;YAAE,SAAS;QAChC,IAAI,CAAC,KAAK,MAAM,IAAI,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YAC1C,MAAM,IAAI,KAAK,CACb,eAAe,OAAO,0FAA0F;gBAC9G,4GAA4G;gBAC5G,8FAA8F,CACjG,CAAC;QACJ,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,qBAAqB,OAAO,8CAA8C,CAAC,CAAC;IAChH,CAAC;AACH,CAAC"}

package/dist/cli/diff.d.ts

@@ -2,6 +2,7 @@ import { PageMapping } from '../aom';
 import { MaskOutcome } from '../nameMask';
 import { BindingDrift } from '../resolution';
 import { Usage } from '../ingest';
+import { RouteChange } from '../routeDrift';
 import { NameDriftFinding } from '../nameDrift';
 import { FixOutcome, ReportEvidence } from '../htmlReport';
 import { SystemicOutcome } from '../systemicDelta';
@@ -284,6 +285,12 @@ export interface DirReport {
     nameDrift?: NameDriftFinding[];
     /** `config.nameMask`'s effect across the walk — applied patterns and refusals, unioned. */
     nameMask?: MaskOutcome;
+    /**
+     * Links whose **destination** changed while their identity held. Reported beside the
+     * `healable` row, never instead of it: the row's promise holds at the element level and
+     * breaks at the navigation level. Absent when nothing moved. See SPEC-route-drift.md.
+     */
+    routeDrift?: RouteChange[];
     /**
      * What to run next, or `null` when the next step is not a command this caller should
      * run. See `nextStep.ts` — BLOCK is deliberately null.
@@ -387,6 +394,12 @@ export interface Report {
      * refused with the reason. Absent when no mask is configured.
      */
     nameMask?: MaskOutcome;
+    /**
+     * Links whose **destination** changed while their identity held. Reported beside the
+     * `healable` row, never instead of it: the row's promise holds at the element level and
+     * breaks at the navigation level. Absent when nothing moved. See SPEC-route-drift.md.
+     */
+    routeDrift?: RouteChange[];
     /**
      * Selector strings from the suite whose binding to a contracted element broke.
      * Present only once `ingest` has inventoried the tests **and** the capture has
@@ -420,3 +433,52 @@ export interface BindingCoverage {
     inventoried: number;
     side: 'baseline' | 'current' | 'both';
 }
+/**
+ * Re-attach link destinations from the baseline elements onto the diff rows.
+ * Done here rather than in `match.js`: href is not element identity (it never
+ * feeds matching), and `browser/` ships twice — once on npm, once served by the
+ * web tool — so it stays dependency-free and untouched.
+ */
+/**
+ * A link that now goes somewhere else — computed once, applied at every door.
+ *
+ * Sits beside `attachBaselineHrefs` because it is the same fact about the same field, and
+ * outside `match.js` for the same stated reason: href is not identity, and that file ships
+ * three times. See `SPEC-route-drift.md`.
+ *
+ * It raises the verdict **only** when the suite navigates to the old route. An app is allowed
+ * to reorganise its URLs; a gate that goes red on that is a gate someone switches off. With
+ * `usage.routes` absent — an old inventory, or a project that never ran `ingest` — nothing
+ * escalates and the report is byte-identical to before.
+ */
+export declare function attachRouteDrift(report: Report, baseline: PageMapping, current: PageMapping, usage: Usage | null): Report;
+/**
+ * What happened to the selector strings the suite actually writes.
+ *
+ * This is the half a CSS-anchored Page Object suite could never see: the contract stores
+ * a synthesized selector, the suite writes its own, and until the two are bound every
+ * drift row reads `not referenced by your tests`. Printed with the test sites so the
+ * reader goes straight to the line, exactly like the name-drift findings.
+ *
+ * Never prints what did not break. A Page Object is mostly selectors for rows, cells and
+ * containers — real elements the contract does not hold — and listing those as findings
+ * is the wall of false positives this whole feature is designed around.
+ */
+/**
+ * Exported for its test only. Two rows here carry `status: 'ambiguous'` and describe
+ * opposite facts, and the sentence that tells them apart is derived rather than stored —
+ * the kind of thing that can be wrong for a release without anyone noticing, because both
+ * outputs look plausible.
+ */
+export declare function bindingDriftNote(drift: BindingDrift[] | undefined, usage: Usage | null): void;
+/**
+ * Links that now lead somewhere else.
+ *
+ * Its own section, and that is the whole feature: these lines were already in the report,
+ * rendered as `🔧 drifted` beside a button that slid down the DOM. Same icon, same list, and
+ * one of them means the user ends up on a different page.
+ *
+ * Exported for its test: the sentence is derived, and a wrong one here is well-formed prose
+ * describing a fact that did not happen.
+ */
+export declare function routeDriftNote(changes: RouteChange[] | undefined): void;

package/dist/cli/diff.js

@@ -57,6 +57,9 @@ exports.dirDiffAggregate = dirDiffAggregate;
 exports.aggregateReports = aggregateReports;
 exports.printAggregate = printAggregate;
 exports.readMapping = readMapping;
+exports.attachRouteDrift = attachRouteDrift;
+exports.bindingDriftNote = bindingDriftNote;
+exports.routeDriftNote = routeDriftNote;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const aom_1 = require("../aom");
@@ -67,6 +70,7 @@ const config_2 = require("../config");
 const ingest_1 = require("../ingest");
 const captureMerge_1 = require("../captureMerge");
 const nameHint_1 = require("../nameHint");
+const routeDrift_1 = require("../routeDrift");
 const nameDrift_1 = require("../nameDrift");
 const htmlReport_1 = require("../htmlReport");
 const evidence_1 = require("../evidence");
@@ -285,7 +289,7 @@ function isDirectory(p) {
 }
 function capturedAtOf(dir) {
     try {
-        const file = fs.readdirSync(dir).find((f) => f.endsWith('.json') && !f.startsWith('.') && !f.startsWith('_'));
+        const file = (0, aom_1.contractFilesIn)(dir)[0];
         if (!file)
             return undefined;
         const parsed = JSON.parse(fs.readFileSync(path.join(dir, file), 'utf8'));
@@ -402,6 +406,7 @@ async function runDiff(args) {
     // raised here rather than inside the shared matcher.
     report.nameDrift = (0, nameDrift_1.assessNameDrift)(report.rows, current.elements, usage);
     report.verdict = (0, nameDrift_1.escalateVerdict)(report.verdict, report.nameDrift);
+    attachRouteDrift(report, baseline, current, usage);
     if (json) {
         console.log(JSON.stringify(report, null, 2));
     }
@@ -921,6 +926,7 @@ opts = {}) {
         const report = attachBaselineHrefs((0, nameMask_1.diffWithMasks)(baseline, current, masks, usage), baseline);
         report.nameDrift = (0, nameDrift_1.assessNameDrift)(report.rows, current.elements, usage);
         report.verdict = (0, nameDrift_1.escalateVerdict)(report.verdict, report.nameDrift);
+        attachRouteDrift(report, baseline, current, usage);
         return attachBindingDrift(report, baselineFile, currentFile, page, baseline, current);
     };
     const layoutsDir = path.join(baselineDir, '_layouts');
@@ -950,8 +956,7 @@ opts = {}) {
             }
         }
     }
-    const baselineFiles = fs.readdirSync(baselineDir)
-        .filter((f) => f.endsWith('.json') && !f.startsWith('.'));
+    const baselineFiles = (0, aom_1.contractFilesIn)(baselineDir);
     const scope = opts.pages ? new Set(opts.pages) : null;
     const outOfScope = [];
     for (const file of baselineFiles) {
@@ -1060,6 +1065,9 @@ function aggregateReports(reports) {
     // inherits the raise for free — this only collects the findings for reporting.
     const nameDrift = (0, nameDrift_1.mergeFindings)(reports.map((r) => r.report.nameDrift ?? []));
     const bindingDrift = reports.flatMap((r) => r.report.bindingDrift ?? []);
+    // Collected like the rest: a finding that exists per page and vanishes from the total is
+    // a finding nobody sees, since --dir is how a whole app is judged.
+    const routeChanges = reports.flatMap((r) => r.report.routeDrift ?? []);
     const nameMask = (0, nameMask_1.mergeMaskOutcomes)(reports.map((r) => r.report.nameMask));
     const depthUnmeasured = (0, depthDelta_1.mergeDepthUnmeasured)(reports.map((r) => r.report.depthUnmeasured));
     // One fact about the run, not one per page: every page shares the same _resolved/ dir.
@@ -1068,6 +1076,7 @@ function aggregateReports(reports) {
         verdict,
         ...(nameDrift.length > 0 ? { nameDrift } : {}),
         ...(bindingDrift.length > 0 ? { bindingDrift } : {}),
+        ...(routeChanges.length > 0 ? { routeDrift: routeChanges } : {}),
         ...(nameMask ? { nameMask } : {}),
         ...(depthUnmeasured ? { depthUnmeasured } : {}),
         ...(bindingCoverage ? { bindingCoverage } : {}),
@@ -1180,6 +1189,7 @@ function printAggregate(agg, reports, baselineDir, currentDir, usage) {
         nameDriftNote(reports.flatMap((r) => r.report.rows));
     }
     bindingDriftNote(reports.flatMap((r) => r.report.bindingDrift ?? []), (0, ingest_1.loadUsage)());
+    routeDriftNote(reports.flatMap((r) => r.report.routeDrift ?? []));
     console.log('');
 }
 function statusIcon(status) {
@@ -1239,6 +1249,33 @@ function readMapping(file) {
  * feeds matching), and `browser/` ships twice — once on npm, once served by the
  * web tool — so it stays dependency-free and untouched.
  */
+/**
+ * A link that now goes somewhere else — computed once, applied at every door.
+ *
+ * Sits beside `attachBaselineHrefs` because it is the same fact about the same field, and
+ * outside `match.js` for the same stated reason: href is not identity, and that file ships
+ * three times. See `SPEC-route-drift.md`.
+ *
+ * It raises the verdict **only** when the suite navigates to the old route. An app is allowed
+ * to reorganise its URLs; a gate that goes red on that is a gate someone switches off. With
+ * `usage.routes` absent — an old inventory, or a project that never ran `ingest` — nothing
+ * escalates and the report is byte-identical to before.
+ */
+function attachRouteDrift(report, baseline, current, usage) {
+    const changes = (0, routeDrift_1.routeDrift)({
+        rows: report.rows,
+        before: baseline.elements,
+        after: current.elements,
+        baseUrl: (0, config_2.configuredBaseUrl)() ?? undefined,
+        usage,
+        page: current.page || baseline.page,
+    });
+    if (changes.length > 0)
+        report.routeDrift = changes;
+    if ((0, routeDrift_1.routeDriftBlocks)(changes).length > 0)
+        report.verdict = 'BLOCK';
+    return report;
+}
 function attachBaselineHrefs(report, baseline) {
     const hrefBySelector = new Map(baseline.elements.filter((e) => e.href).map((e) => [e.selector, e.href]));
     for (const row of report.rows) {
@@ -1291,6 +1328,12 @@ const MAX_HINT_GROUPS = 6;
  * containers — real elements the contract does not hold — and listing those as findings
  * is the wall of false positives this whole feature is designed around.
  */
+/**
+ * Exported for its test only. Two rows here carry `status: 'ambiguous'` and describe
+ * opposite facts, and the sentence that tells them apart is derived rather than stored —
+ * the kind of thing that can be wrong for a release without anyone noticing, because both
+ * outputs look plausible.
+ */
 function bindingDriftNote(drift, usage) {
     if (!drift || drift.length === 0)
         return;
@@ -1313,17 +1356,73 @@ function bindingDriftNote(drift, usage) {
         site(d, usage);
     }
     for (const d of rest) {
+        // Two opposite facts share the word `ambiguous`, and the discriminator is structural:
+        // a baseline that BOUND one element carries `was`, so the ambiguity is new (it now
+        // matches several). Without `was` the ambiguity is the *baseline's* — it matched
+        // several and now matches none. Printing the first sentence over the second case
+        // would describe the exact opposite of what happened.
+        const lostFromAmbiguous = d.status === 'ambiguous' && !d.was;
         const why = d.status === 'gone'
             ? 'the element it named is gone — nothing to rewrite towards'
             : d.status === 'dangling'
                 ? 'it matched an element the contract does not hold, and now matches nothing —\n' +
                     '         the test is red, and there is no recorded identity to rewrite towards'
-                : 'it now matches several elements — a coin flip, not a repair';
+                : lostFromAmbiguous
+                    ? 'it used to match several elements and now matches none — the test is red'
+                    : 'it now matches several elements — a coin flip, not a repair';
         console.log(`      ⛔ ${d.selector}${d.was ? `  (was ${d.was})` : ''}`);
         console.log(`         ${why}.`);
+        if (lostFromAmbiguous) {
+            // Named, never offered as a rewrite: the baseline never established which of them
+            // the test meant, so choosing is the reader's job and the tool says so out loud.
+            if (d.candidates && d.candidates.length > 0) {
+                console.log(`         what it could have meant is still on the page, now at:`);
+                for (const c of d.candidates)
+                    console.log(`           ${c}`);
+                console.log(`         pick the one your test meant — no rewrite is offered for a coin flip.`);
+            }
+            else {
+                console.log(`         none of what it could have meant is still on the page.`);
+            }
+        }
         site(d, usage);
     }
 }
+/**
+ * Links that now lead somewhere else.
+ *
+ * Its own section, and that is the whole feature: these lines were already in the report,
+ * rendered as `🔧 drifted` beside a button that slid down the DOM. Same icon, same list, and
+ * one of them means the user ends up on a different page.
+ *
+ * Exported for its test: the sentence is derived, and a wrong one here is well-formed prose
+ * describing a fact that did not happen.
+ */
+function routeDriftNote(changes) {
+    if (!changes || changes.length === 0)
+        return;
+    const n = changes.length;
+    console.log(`\n   🧭 ${n} link${n === 1 ? '' : 's'} now lead${n === 1 ? 's' : ''} somewhere else ` +
+        `(the element is the same — its destination is not):`);
+    for (const c of changes) {
+        const gating = (c.usedAt?.length ?? 0) > 0;
+        console.log(`      ${gating ? '⛔' : '•'} ${c.name || '(no name)'}${c.page ? `   [${c.page}]` : ''}`);
+        console.log(`         ${c.from}  →  ${c.to}`);
+        if (gating) {
+            // The only thing that makes this more than a remark: the suite goes to the old route,
+            // so it is red now and the tool can prove it.
+            const shown = c.usedAt.slice(0, 3).map((s) => `${s.file}:${s.line}`).join(', ');
+            const more = c.usedAt.length > 3 ? ` (+${c.usedAt.length - 3} more)` : '';
+            console.log(`         your suite navigates to the old one: ${shown}${more}`);
+        }
+    }
+    if (!changes.some((c) => (c.usedAt?.length ?? 0) > 0)) {
+        // Said out loud rather than implied by the absence of a line: an app is allowed to
+        // reorganise its URLs, and a reader who cannot tell "not gating" from "not checked"
+        // will treat the next one the same way.
+        console.log(`      Not failing the run — no test navigates to these. Check the ones you reach by URL.`);
+    }
+}
 /** Where that string is written, so the reader opens the file instead of grepping. */
 function site(d, usage) {
     const sites = usage?.selectors?.[d.selector];
@@ -1427,6 +1526,7 @@ function printHuman(report, files, usage) {
         nameDriftNote(rows);
     }
     bindingDriftNote(report.bindingDrift, usage ?? null);
+    routeDriftNote(report.routeDrift);
     if (verdict === 'PASS' && counts.renamed === 0) {
         console.log('   ✅ No drift — your suite is safe to run.');
     }