@ia-qa/self-healing 1.5.7 → 1.6.1

package/dist/cli/check.js

@@ -0,0 +1,329 @@
+"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.runCheck = runCheck;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const config_1 = require("../config");
+const safety_1 = require("../discovery/safety");
+const checks_1 = require("../checks");
+const summary_1 = require("./summary");
+/**
+ * `ia-qa-heal check [--strict] [--json] [--offline]` — is the app you mapped sound?
+ *
+ * `diff` answers "what moved since the baseline?". This answers the question a
+ * diff structurally cannot: "is the current contract healthy at all?" — a green
+ * diff over a page whose every link 404s is still a green diff.
+ *
+ * Four checks, each admitted under one rule: it must be able to fail for a reason
+ * a contract diff would not already catch. "The button still exists" is rejected
+ * by that rule — `diff` proves it better and without a browser. What survives:
+ *
+ *   dead links     the app answered 4xx/5xx  (needs the network — see below)
+ *   unnamed        an interactive element with no accessible name
+ *   ambiguous      two elements sharing role + name: locators for them are a coin flip
+ *   orphans        a mapped page nothing links to
+ *
+ * **Network.** The link check requests URLs from your own `baseUrl` and nothing
+ * else — same site only, GET only, and never a URL that *acts* (`/logout`,
+ * `/orders/1/delete`…): the denylist is the one `discover --crawl` already uses,
+ * because a GET on those is not a check, it is a logout or a deletion. The run
+ * announces the host and the count before the first request, and `--offline`
+ * drops that half entirely for a purely local run.
+ *
+ * Exit codes: 0 — PASS, or WARN without `--strict`; 1 — FAIL (a dead link), or
+ * WARN with `--strict`; 2 — nothing to check.
+ */
+const CONCURRENCY = 6;
+const TIMEOUT_MS = 10_000;
+function readMappings(dir) {
+    const out = [];
+    const read = (file, page, isLayout) => {
+        let parsed;
+        try {
+            parsed = JSON.parse(fs.readFileSync(file, 'utf8'));
+        }
+        catch {
+            return;
+        }
+        if (!parsed || !Array.isArray(parsed.elements))
+            return;
+        out.push({ page, url: parsed.url, elements: parsed.elements, isLayout });
+    };
+    for (const f of fs.readdirSync(dir)) {
+        if (!f.endsWith('.json') || f.startsWith('.') || f.startsWith('_'))
+            continue;
+        read(path.join(dir, f), f.replace(/\.json$/, ''), false);
+    }
+    const layouts = path.join(dir, '_layouts');
+    if (fs.existsSync(layouts)) {
+        for (const f of fs.readdirSync(layouts).filter((x) => x.endsWith('.json'))) {
+            read(path.join(layouts, f), `_layouts/${f.replace(/\.json$/, '')}`, true);
+        }
+    }
+    return out;
+}
+/** GET the URL and report its status. A transport error is a finding too. */
+async function probe(url) {
+    const ac = new AbortController();
+    const timer = setTimeout(() => ac.abort(), TIMEOUT_MS);
+    try {
+        // GET, not HEAD: too many app servers answer HEAD with 405 while the page is
+        // perfectly fine, and a false dead link is the one thing this must not emit.
+        const res = await fetch(url, { method: 'GET', redirect: 'follow', signal: ac.signal });
+        return { status: res.status };
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        return { status: null, error: ac.signal.aborted ? `no response in ${TIMEOUT_MS / 1000}s` : msg };
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+async function probeAll(targets, onTick) {
+    const dead = [];
+    let index = 0;
+    let done = 0;
+    const worker = async () => {
+        for (;;) {
+            const i = index++;
+            if (i >= targets.length)
+                return;
+            const t = targets[i];
+            const { status, error } = await probe(t.url);
+            if (status === null || (0, checks_1.isDeadStatus)(status)) {
+                dead.push({ ...t, status, error });
+            }
+            onTick(++done);
+        }
+    };
+    await Promise.all(Array.from({ length: Math.min(CONCURRENCY, targets.length) }, worker));
+    return dead.sort((a, b) => (b.from.length - a.from.length) || a.url.localeCompare(b.url));
+}
+async function runCheck(args) {
+    const strict = args.includes('--strict');
+    const json = args.includes('--json');
+    const offline = args.includes('--offline');
+    const dir = (0, config_1.mappingDir)();
+    if (!fs.existsSync(dir) || !fs.statSync(dir).isDirectory()) {
+        console.error(`❌ Nothing to check — ${path.resolve(dir)} does not exist.\n\n` +
+            `   \`check\` reads one capture of the app and asks whether it is sound.\n` +
+            `   Capture it first:  ia-qa-heal map`);
+        process.exitCode = 2;
+        return;
+    }
+    const pages = readMappings(dir);
+    const realPages = pages.filter((p) => !p.isLayout);
+    if (realPages.length === 0) {
+        console.error(`❌ No page contracts in ${path.resolve(dir)} — run \`ia-qa-heal map\` first.`);
+        process.exitCode = 2;
+        return;
+    }
+    let baseUrl = '';
+    try {
+        baseUrl = (0, config_1.loadConfig)().baseUrl ?? '';
+    }
+    catch {
+        /* a missing config only costs the network half; the static checks stand */
+    }
+    const skipped = [];
+    const elementCount = pages.reduce((s, p) => s + p.elements.length, 0);
+    const unnamed = (0, checks_1.findUnnamed)(pages);
+    const ambiguous = (0, checks_1.findAmbiguousNames)(pages);
+    if (!baseUrl) {
+        skipped.push({ check: 'orphans', why: 'no baseUrl in .ia-qa/config.json — hrefs cannot be resolved to pages' });
+    }
+    const orphans = baseUrl
+        ? (0, checks_1.findOrphanPages)(pages, (href) => {
+            try {
+                return (0, safety_1.normalizedPath)(href, baseUrl);
+            }
+            catch {
+                return null;
+            }
+        })
+        : [];
+    let deadLinks = [];
+    let linksChecked = 0;
+    let linksSkipped = 0;
+    if (offline) {
+        skipped.push({ check: 'dead links', why: '--offline' });
+    }
+    else if (!baseUrl) {
+        skipped.push({ check: 'dead links', why: 'no baseUrl in .ia-qa/config.json' });
+    }
+    if (!offline && baseUrl) {
+        const { targets, skipped } = (0, checks_1.collectLinkTargets)(pages, (href) => {
+            const verdict = (0, safety_1.classifyUrl)(href, baseUrl);
+            if (!verdict.ok)
+                return null;
+            try {
+                return new URL(href, baseUrl).toString();
+            }
+            catch {
+                return null;
+            }
+        });
+        linksSkipped = skipped;
+        linksChecked = targets.length;
+        if (targets.length > 0) {
+            // Rule 1 of this project: a flow that leaves the machine announces itself
+            // without being asked. Said before the first request, not after.
+            const host = (() => {
+                try {
+                    return new URL(baseUrl).host;
+                }
+                catch {
+                    return baseUrl;
+                }
+            })();
+            if (!json) {
+                console.log(`\n🔗 Requesting ${targets.length} distinct link${targets.length === 1 ? '' : 's'} on ${host} —` +
+                    ` GET only, same site only, action URLs skipped.` +
+                    (skipped > 0 ? ` ${skipped} href${skipped === 1 ? '' : 's'} left alone.` : ''));
+            }
+            deadLinks = await probeAll(targets, () => undefined);
+        }
+    }
+    const report = {
+        pagesChecked: realPages.length,
+        elements: elementCount,
+        unnamed,
+        ambiguous,
+        orphans,
+        deadLinks,
+        linksChecked,
+        linksSkipped,
+        offline: offline || !baseUrl,
+        skipped,
+    };
+    const verdict = (0, checks_1.checkVerdict)(report);
+    if (json) {
+        console.log(JSON.stringify({ verdict, ...report }, null, 2));
+        process.exitCode = verdict === 'FAIL' || (strict && verdict === 'WARN') ? 1 : 0;
+        return;
+    }
+    printCheck(report, verdict, strict);
+    (0, summary_1.summaryLine)('check', verdict === 'PASS' ? 'ok' : verdict === 'WARN' ? 'fix' : 'block', verdict === 'PASS'
+        ? `PASS · ${report.pagesChecked} pages · ${(0, checks_1.checkCoverage)(report).ran}/${(0, checks_1.checkCoverage)(report).total} checks ran`
+        : verdict === 'FAIL'
+            ? `FAIL · ${deadLinks.length} dead link${deadLinks.length === 1 ? '' : 's'}`
+            : `WARN · ${unnamed.length} unnamed · ${ambiguous.length} ambiguous · ${orphans.length} orphan`, [
+        `${report.elements} elements`,
+        report.offline ? 'offline' : `${linksChecked} links`,
+        skipped.length > 0 ? `${skipped.length} check${skipped.length === 1 ? '' : 's'} skipped` : undefined,
+    ]);
+    process.exitCode = verdict === 'FAIL' || (strict && verdict === 'WARN') ? 1 : 0;
+}
+/**
+ * Where a finding lives. An element repeated by the shared shell is ONE thing to
+ * fix on N pages, not N findings — saying "142 pages" instead of printing it 142
+ * times is the difference between a report someone reads and one they mute.
+ */
+function where(pages) {
+    if (pages.length === 1)
+        return pages[0];
+    if (pages.length <= 3)
+        return pages.join(', ');
+    return `${pages.length} pages (shared shell — ${pages.slice(0, 2).join(', ')}…)`;
+}
+function printCheck(r, verdict, strict) {
+    const icon = verdict === 'PASS' ? '✅' : verdict === 'WARN' ? '⚠️ ' : '⛔';
+    console.log(`\n${icon} ${verdict}  ia-qa-heal check — is the app you mapped sound?`);
+    console.log(`   ${r.pagesChecked} page${r.pagesChecked === 1 ? '' : 's'} · ${r.elements} elements · ` +
+        (r.offline ? 'links not requested (offline)' : `${r.linksChecked} distinct link${r.linksChecked === 1 ? '' : 's'} requested`));
+    if (r.deadLinks.length > 0) {
+        console.log(`\n   ⛔ ${r.deadLinks.length} dead link${r.deadLinks.length === 1 ? '' : 's'}:`);
+        for (const d of r.deadLinks.slice(0, 15)) {
+            const what = d.status === null ? (d.error ?? 'no response') : `HTTP ${d.status}`;
+            const from = d.from.slice(0, 2).map((f) => `${f.page} "${f.name}"`).join(', ');
+            const more = d.from.length > 2 ? ` +${d.from.length - 2} more` : '';
+            console.log(`      ${what.padEnd(10)} ${d.url}`);
+            console.log(`                 linked from ${from}${more}`);
+        }
+        if (r.deadLinks.length > 15)
+            console.log(`      … and ${r.deadLinks.length - 15} more.`);
+    }
+    if (r.ambiguous.length > 0) {
+        console.log(`\n   ❓ ${r.ambiguous.length} name${r.ambiguous.length === 1 ? '' : 's'} that cannot identify one element:`);
+        for (const a of r.ambiguous.slice(0, 10)) {
+            console.log(`      ${a.count}× ${a.role} "${a.name}"  ·  ${where(a.pages)}`);
+        }
+        if (r.ambiguous.length > 10)
+            console.log(`      … and ${r.ambiguous.length - 10} more.`);
+        console.log(`      Any getByRole/cy.findByRole for these is a coin flip — Playwright raises a` +
+            `\n      strict-mode violation and the healer reports \`ambiguous\` and refuses.` +
+            `\n      A data-testid on one of them settles it. This is drift that has not happened yet.`);
+    }
+    if (r.unnamed.length > 0) {
+        const occurrences = r.unnamed.reduce((acc, u) => acc + u.pages.length, 0);
+        console.log(`
+   👻 ${r.unnamed.length} interactive element${r.unnamed.length === 1 ? '' : 's'} with no accessible name` +
+            (occurrences > r.unnamed.length ? ` (${occurrences} occurrences — shared shell counted once)` : '') +
+            ':');
+        for (const u of r.unnamed.slice(0, 8)) {
+            console.log(`      ${u.role.padEnd(8)} ${u.selector}`);
+            console.log(`               ${where(u.pages)}`);
+        }
+        if (r.unnamed.length > 8)
+            console.log(`      … and ${r.unnamed.length - 8} more.`);
+        console.log(`      A screen reader announces nothing, getByRole cannot target it, and healing` +
+            `\n      cannot recover it after a move — identity here IS role + name.`);
+    }
+    if (r.orphans.length > 0) {
+        console.log(`\n   🔌 ${r.orphans.length} mapped page${r.orphans.length === 1 ? '' : 's'} nothing links to:`);
+        for (const o of r.orphans.slice(0, 10))
+            console.log(`      ${o.page}  (${o.url})`);
+        if (r.orphans.length > 10)
+            console.log(`      … and ${r.orphans.length - 10} more.`);
+        console.log(`      Either the navigation lost a link, or they are deep-link-only. Worth one look.`);
+    }
+    if (r.skipped.length > 0) {
+        const cov = (0, checks_1.checkCoverage)(r);
+        console.log(`
+   ⏸  ${cov.ran} of ${cov.total} checks ran. NOT checked:`);
+        for (const sk of r.skipped)
+            console.log(`      ${sk.check.padEnd(12)} ${sk.why}`);
+        console.log(`      A verdict cannot speak for a question it never asked — whatever those` +
+            `
+      would have found is invisible above, PASS included.`);
+    }
+    if (verdict === 'WARN' && !strict) {
+        console.log(`\n   Advisory — exits 0. Add --strict to fail the pipeline on these too.`);
+    }
+    console.log('');
+}
+//# sourceMappingURL=check.js.map

package/dist/cli/check.js.map

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

package/dist/cli/diff.d.ts

@@ -1,4 +1,5 @@
 import { Usage } from '../ingest';
+import { NameDriftFinding } from '../nameDrift';
 import { FixOutcome } from '../htmlReport';
 /**
  * `ia-qa-heal diff [baseline] [current] [--strict] [--json] [--dir]`
@@ -42,13 +43,21 @@ export declare function writeDriftReport(reportPath: string, agg: DirReport, rep
     isLayout: boolean;
 }>, baselineDirPath: string, currentDirPath: string, usage?: Usage | null, open?: boolean, outcome?: FixOutcome): void;
 export declare function runDiff(args: string[]): Promise<void>;
+/**
+ * The name-drift section of a human verdict.
+ *
+ * Deliberately loud: this is the class of drift that used to exit 0 while the
+ * suite went red, so it prints the failing call sites — file:line — rather than
+ * a count. A count would be one more thing to eyeball; a file:line is a fix.
+ */
+export declare function printNameDrift(findings: NameDriftFinding[] | undefined): void;
 /**
  * The `diff`/`run` verdict compressed to the one greppable receipt line. Placed after
  * the detail block so a `tail` catches the takeaway even when the rows scrolled past —
  * and never in `--json` mode, where it would corrupt the machine-readable payload.
  * Shared with `run`, which ends on the same verdict.
  */
-export declare function driftSummaryLine(verb: string, verdict: 'PASS' | 'FIX' | 'BLOCK', c: Report['counts']): void;
+export declare function driftSummaryLine(verb: string, verdict: 'PASS' | 'FIX' | 'BLOCK', c: Report['counts'], nameDrift?: NameDriftFinding[]): void;
 export interface DirDiffCollection {
     reports: Array<{
         name: string;
@@ -80,6 +89,11 @@ export interface DirReport {
     totals: Report['counts'];
     /** Pairs left out of the verdict: same capture on both sides, so incapable of showing drift. */
     staleExcluded?: string[];
+    /**
+     * Renamed labels the suite locates by name, de-duped across pages — a shared
+     * header renames once, not once per page that carries it.
+     */
+    nameDrift?: NameDriftFinding[];
 }
 export declare function aggregateReports(reports: Array<{
     name: string;
@@ -129,4 +143,9 @@ export interface Report {
     };
     rows: DiffRow[];
     added: DiffRow[];
+    /**
+     * Renames the suite locates by name. Present only once `ia-qa-heal ingest` has
+     * inventoried the tests — absent means "not measured", never "none".
+     */
+    nameDrift?: NameDriftFinding[];
 }

package/dist/cli/diff.js

@@ -37,6 +37,7 @@ exports.takeReportFlag = takeReportFlag;
 exports.openInBrowser = openInBrowser;
 exports.writeDriftReport = writeDriftReport;
 exports.runDiff = runDiff;
+exports.printNameDrift = printNameDrift;
 exports.driftSummaryLine = driftSummaryLine;
 exports.collectDirDiff = collectDirDiff;
 exports.aggregateReports = aggregateReports;
@@ -48,6 +49,8 @@ const match_1 = require("../browser/match");
 const config_1 = require("../config");
 const ingest_1 = require("../ingest");
 const captureMerge_1 = require("../captureMerge");
+const nameHint_1 = require("../nameHint");
+const nameDrift_1 = require("../nameDrift");
 const htmlReport_1 = require("../htmlReport");
 const summary_1 = require("./summary");
 /**
@@ -172,21 +175,48 @@ async function runDiff(args) {
         refuseToCompare('same-capture', sameCaptureMessage(baseline.capturedAt), 'Change the app and run `ia-qa-heal map` again, so the two sides are different moments.', json);
         return;
     }
+    const usage = (0, ingest_1.loadUsage)();
     const report = attachBaselineHrefs((0, match_1.diffMappings)(baseline, current), baseline);
+    // A rename is harmless to a CSS-anchored suite and fatal to a name-anchored
+    // one. Only the test inventory can tell the two apart, so the verdict is
+    // 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);
     if (json) {
         console.log(JSON.stringify(report, null, 2));
     }
     else {
-        printHuman(report, files, (0, ingest_1.loadUsage)());
+        printHuman(report, files, usage);
+        printNameDrift(report.nameDrift);
     }
     if (reportPath) {
         const single = [{ name: path.basename(files[1]).replace(/\.json$/, ''), report, isLayout: false }];
-        writeDriftReport(reportPath, aggregateReports(single), single, files[0], files[1], (0, ingest_1.loadUsage)(), open);
+        writeDriftReport(reportPath, aggregateReports(single), single, files[0], files[1], usage, open);
     }
     const failing = report.verdict === 'BLOCK' || (strict && report.verdict === 'FIX');
     process.exitCode = failing ? 1 : 0;
     if (!json)
-        driftSummaryLine('diff', report.verdict, report.counts);
+        driftSummaryLine('diff', report.verdict, report.counts, report.nameDrift);
+}
+/**
+ * The name-drift section of a human verdict.
+ *
+ * Deliberately loud: this is the class of drift that used to exit 0 while the
+ * suite went red, so it prints the failing call sites — file:line — rather than
+ * a count. A count would be one more thing to eyeball; a file:line is a fix.
+ */
+function printNameDrift(findings) {
+    if (!findings || findings.length === 0)
+        return;
+    const fixable = findings.filter((f) => f.fixable);
+    const manual = findings.filter((f) => !f.fixable);
+    console.log(`\n   🏷  ${findings.length} renamed label${findings.length === 1 ? '' : 's'} your tests locate by name` +
+        ` — a selector diff alone would have called this PASS.`);
+    for (const f of [...manual, ...fixable])
+        console.log((0, nameDrift_1.formatFinding)(f));
+    if (fixable.length > 0) {
+        console.log(`\n      ${fixable.length} of them are deterministic: \`ia-qa-heal fix\` rewrites the call.`);
+    }
 }
 /**
  * The `diff`/`run` verdict compressed to the one greppable receipt line. Placed after
@@ -194,16 +224,28 @@ async function runDiff(args) {
  * and never in `--json` mode, where it would corrupt the machine-readable payload.
  * Shared with `run`, which ends on the same verdict.
  */
-function driftSummaryLine(verb, verdict, c) {
+function driftSummaryLine(verb, verdict, c, nameDrift = []) {
     const kind = verdict === 'PASS' ? 'ok' : verdict === 'FIX' ? 'fix' : 'block';
+    const nameFixable = nameDrift.filter((f) => f.fixable).length;
+    const nameManual = nameDrift.length - nameFixable;
+    // Name drift can be the *only* reason for the verdict, and a headline reading
+    // "BLOCK · 0 lost · 0 ambiguous · 0 rebound" would send someone hunting for a
+    // selector that never broke. Name the actual cause first.
+    const blockCause = c.lost + c.ambiguous + c.rebound === 0 && nameManual > 0
+        ? `${nameManual} renamed label${nameManual === 1 ? '' : 's'} your tests use`
+        : `${c.lost} lost · ${c.ambiguous} ambiguous · ${c.rebound} rebound`;
+    const fixCause = c.healable === 0 && nameFixable > 0
+        ? `${nameFixable} renamed label${nameFixable === 1 ? '' : 's'}`
+        : `${c.healable} healable`;
     const headline = verdict === 'PASS'
         ? 'PASS · no drift, suite safe'
         : verdict === 'FIX'
-            ? `FIX · ${c.healable} healable → \`fix\``
-            : `BLOCK · ${c.lost} lost · ${c.ambiguous} ambiguous · ${c.rebound} rebound — human needed`;
+            ? `FIX · ${fixCause} → \`fix\``
+            : `BLOCK · ${blockCause} — human needed`;
     (0, summary_1.summaryLine)(verb, kind, headline, [
         `${c.ok} ok`,
         c.renamed > 0 ? `${c.renamed} renamed` : undefined,
+        nameDrift.length > 0 ? `${nameDrift.length} name-drift` : undefined,
         c.added > 0 ? `${c.added} new` : undefined,
     ]);
 }
@@ -246,6 +288,7 @@ async function runDirDiff(baselineDir, currentDir, opts) {
     }
     else {
         printAggregate(aggregate, reports, baselineDir, currentDir, usage);
+        printNameDrift(aggregate.nameDrift);
     }
     if (opts.reportPath) {
         writeDriftReport(opts.reportPath, aggregate, reports, baselineDir, currentDir, usage, opts.open);
@@ -253,7 +296,7 @@ async function runDirDiff(baselineDir, currentDir, opts) {
     const failing = aggregate.verdict === 'BLOCK' || (opts.strict && aggregate.verdict === 'FIX');
     process.exitCode = failing ? 1 : 0;
     if (!opts.json)
-        driftSummaryLine('diff', aggregate.verdict, aggregate.totals);
+        driftSummaryLine('diff', aggregate.verdict, aggregate.totals, aggregate.nameDrift);
 }
 /**
  * The collection half of a directory diff, shared with `ia-qa-heal run`: walk two
@@ -265,6 +308,15 @@ function collectDirDiff(baselineDir, currentDir) {
     // Kept out of the verdict rather than counted as `ok` — N ok that were never
     // compared is exactly the false green this guard exists to stop.
     const stale = [];
+    // Read once for the whole walk: `run` and `diff --dir` both come through here,
+    // so name drift is assessed on every path that produces a directory verdict.
+    const usage = (0, ingest_1.loadUsage)();
+    const assess = (baseline, current) => {
+        const report = attachBaselineHrefs((0, match_1.diffMappings)(baseline, current), baseline);
+        report.nameDrift = (0, nameDrift_1.assessNameDrift)(report.rows, current.elements, usage);
+        report.verdict = (0, nameDrift_1.escalateVerdict)(report.verdict, report.nameDrift);
+        return report;
+    };
     const layoutsDir = path.join(baselineDir, '_layouts');
     if (fs.existsSync(layoutsDir)) {
         const layoutFiles = fs.readdirSync(layoutsDir).filter((f) => f.endsWith('.json'));
@@ -281,7 +333,7 @@ function collectDirDiff(baselineDir, currentDir) {
                     stale.push(`_layouts/${name}`);
                     continue;
                 }
-                const report = attachBaselineHrefs((0, match_1.diffMappings)(baseline, current), baseline);
+                const report = assess(baseline, current);
                 reports.push({ name: `_layouts/${name}`, report, isLayout: true });
             }
             catch (e) {
@@ -306,7 +358,7 @@ function collectDirDiff(baselineDir, currentDir) {
                 stale.push(name);
                 continue;
             }
-            const report = attachBaselineHrefs((0, match_1.diffMappings)(baseline, current), baseline);
+            const report = assess(baseline, current);
             reports.push({ name, report, isLayout: false });
         }
         catch (e) {
@@ -345,8 +397,12 @@ function aggregateReports(reports) {
         return 'PASS';
     };
     const verdict = reports.reduce((acc, r) => worstV(acc, r.report.verdict), 'PASS');
+    // Per-page verdicts are already escalated by `collectDirDiff`, so the aggregate
+    // inherits the raise for free — this only collects the findings for reporting.
+    const nameDrift = (0, nameDrift_1.mergeFindings)(reports.map((r) => r.report.nameDrift ?? []));
     return {
         verdict,
+        ...(nameDrift.length > 0 ? { nameDrift } : {}),
         layoutVerdict,
         layoutCounts,
         pageReports: pageReports.map((r) => ({
@@ -443,6 +499,9 @@ function printAggregate(agg, reports, baselineDir, currentDir, usage) {
     if (agg.totals.healable > 0) {
         console.log('   🔧 Healable selectors can be auto-fixed with `ia-qa-heal fix --dir`.');
     }
+    if (agg.totals.renamed > 0) {
+        nameDriftNote(reports.flatMap((r) => r.report.rows));
+    }
     console.log('');
 }
 function statusIcon(status) {
@@ -517,6 +576,43 @@ function volatileNote(rows) {
     console.log(`      lists) that is usually content churn, not UI drift. If ${n === 1 ? 'it rotates' : 'they rotate'} by design, keep`);
     console.log(`      ${n === 1 ? 'it' : 'them'} out of the contract: "volatile": ["href:*source=rss*"] in .ia-qa/config.json.`);
 }
+/**
+ * The variable-label hint. Sibling of `volatileNote`, and display-only for the same
+ * reason: only the user knows what rotates by design, so this names what it saw and the
+ * one action that exists today — it never filters a row or moves a verdict.
+ *
+ * It points at `volatile` and states its cost out loud (the element leaves the contract),
+ * because that cost is the whole decision. Nothing here suggests a config key that the
+ * loader would accept and then ignore: an ignored declaration is exactly the silent
+ * failure this hint exists to end.
+ */
+const MAX_HINT_GROUPS = 6;
+function nameDriftNote(rows) {
+    const groups = (0, nameHint_1.groupNumericRenames)(rows);
+    if (groups.length === 0)
+        return;
+    const total = groups.reduce((n, g) => n + g.count, 0);
+    console.log(`   💡 ${total} renamed ${total === 1 ? 'label differs' : 'labels differ'} only by a number — a counter, total or`);
+    console.log(`      clock drifts on its own, so ${total === 1 ? 'this row comes' : 'these rows come'} back every run. If they rotate by`);
+    console.log(`      design, keep them out of the contract with "volatile" in .ia-qa/config.json`);
+    console.log(`      (which drops the element from the gate entirely, coverage included):`);
+    // A pattern with no stable part would match every label in the app, so those groups
+    // are offered by selector instead — never as a `*` that silently masks everything.
+    const shown = groups.slice(0, MAX_HINT_GROUPS);
+    const entries = shown.map((g) => ({
+        key: g.pattern ? `"name:${g.pattern}"` : `"selector:${g.examples[0].selector}"`,
+        group: g,
+    }));
+    const width = Math.max(...entries.map((e) => e.key.length));
+    for (const { key, group } of entries) {
+        const e = group.examples[0];
+        const why = group.pattern ? '' : '  (no stable part left in the label)';
+        console.log(`         ${key.padEnd(width)}  ${group.count} row${group.count === 1 ? ' ' : 's'}  e.g. "${e.from}" → "${e.to}"${why}`);
+    }
+    if (groups.length > shown.length) {
+        console.log(`         … and ${groups.length - shown.length} more group${groups.length - shown.length === 1 ? '' : 's'} (see the renamed rows above).`);
+    }
+}
 function printHuman(report, files, usage) {
     const { verdict, counts, rows, added } = report;
     const icon = verdict === 'PASS' ? '✅' : verdict === 'FIX' ? '🔧' : '⛔';
@@ -565,6 +661,7 @@ function printHuman(report, files, usage) {
     }
     if (counts.renamed > 0) {
         console.log('   ✏️  Renamed elements still pass (selector valid) but the label changed — check it is intended, not a regression.');
+        nameDriftNote(rows);
     }
     if (verdict === 'PASS' && counts.renamed === 0) {
         console.log('   ✅ No drift — your suite is safe to run.');