@ia-qa/self-healing 1.7.10 → 1.7.13

package/dist/cli/args.js

@@ -15,13 +15,13 @@ exports.rejectUnknownFlags = rejectUnknownFlags;
  * leading dash is enough to tell a flag from a positional.
  */
 exports.KNOWN_FLAGS = {
-    init: [],
+    init: ['--yes', '--base-url', '--pages', '--discover', '--tests', '--test-command', '--bootstrap'],
     discover: ['--sitemap', '--crawl', '--no-reveal', '--strict-host', '--apply', '--max', '--depth', '--session'],
     login: ['--url', '--session'],
-    map: ['--screenshots', '--session'],
-    baseline: [],
+    map: ['--screenshots', '--session', '--deep', '--depth', '--deep-budget'],
+    baseline: ['--dry-run'],
     diff: ['--strict', '--json', '--junit', '--dir', '--report', '--open'],
-    fix: ['--dry-run', '--locators', '--dir'],
+    fix: ['--dry-run', '--locators', '--dir', '--json'],
     ingest: ['--json'],
     audit: ['--strict', '--json'],
     explain: ['--junit', '--message', '--strict', '--json'],
@@ -30,6 +30,7 @@ exports.KNOWN_FLAGS = {
     run: ['--yes', '--no-verify', '--locators', '--report', '--junit', '--json', '--open'],
     skill: ['--install', '--user', '--dir', '--print', '--force'],
     history: ['--json', '--limit'],
+    'exit-codes': ['--json'],
     ui: ['--port', '--no-open', '--shortcut', '--keep-alive', '--forget', '--offline'],
 };
 function rejectUnknownFlags(command, args) {

package/dist/cli/args.js.map

@@ -1 +1 @@
-{"version":3,"file":"args.js","sourceRoot":"","sources":["../../src/cli/args.ts"],"names":[],"mappings":";;;AA+BA,gDAeC;AA9CD;;;;;;;;;;;GAWG;AACU,QAAA,WAAW,GAAsC;IAC5D,IAAI,EAAE,EAAE;IACR,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,GAAG,EAAE,CAAC,eAAe,EAAE,WAAW,CAAC;IACnC,QAAQ,EAAE,EAAE;IACZ,IAAI,EAAE,CAAC,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,CAAC;IACtE,GAAG,EAAE,CAAC,WAAW,EAAE,YAAY,EAAE,OAAO,CAAC;IACzC,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,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":";;;AAgCA,gDAeC;AA/CD;;;;;;;;;;;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,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"}

package/dist/cli/baseline.js

@@ -60,6 +60,11 @@ const summary_1 = require("./summary");
  * silently goes stale, and twice the diff to review on every promotion.
  */
 async function runBaseline(args = []) {
+    // The one destructive thing this verb does is DELETE: a baseline file the new mapping no
+    // longer produces is removed, on purpose, because keeping it diffs against nothing
+    // forever. That is right and it is also the step worth being able to preview — a page
+    // dropped from config.json by accident looks exactly like one dropped on purpose.
+    const dryRun = args.includes('--dry-run');
     (0, captureMerge_1.mergeCapturesAnnounced)();
     const from = (0, config_1.mappingDir)();
     const to = (0, config_1.baselineDir)();
@@ -87,6 +92,23 @@ async function runBaseline(args = []) {
     const staleFiles = jsonFilesIn(to).filter((f) => !pages.includes(f));
     const staleLayouts = jsonFilesIn(path.join(to, config_1.LAYOUT_DIRNAME)).filter((f) => !layouts.includes(f));
     const staleResolved = jsonFilesIn(path.join(to, config_1.RESOLVED_DIRNAME)).filter((f) => !resolved.includes(f));
+    if (dryRun) {
+        const doomed = [...staleFiles, ...staleLayouts, ...staleResolved];
+        console.log('\n📌 Baseline promotion — dry run, nothing written.');
+        console.log(`   would promote ${pages.length} page${pages.length === 1 ? '' : 's'}` +
+            (layouts.length > 0 ? ` · ${layouts.length} layout${layouts.length === 1 ? '' : 's'}` : '') +
+            (resolved.length > 0 ? ` · ${resolved.length} with selector bindings` : ''));
+        if (doomed.length > 0) {
+            console.log(`   would DELETE ${doomed.length} baseline file${doomed.length === 1 ? '' : 's'} the current mapping no longer produces:`);
+            for (const f of doomed.slice(0, 10))
+                console.log(`      ${f}`);
+            if (doomed.length > 10)
+                console.log(`      +${doomed.length - 10} more`);
+            console.log('   A page dropped from config.json by accident looks exactly like one dropped on purpose.');
+        }
+        (0, summary_1.summaryLine)('baseline', 'info', `dry run · ${pages.length + layouts.length} would be promoted`, [doomed.length > 0 ? `${doomed.length} would be deleted` : '']);
+        return;
+    }
     fs.mkdirSync(to, { recursive: true });
     for (const file of pages) {
         fs.copyFileSync(path.join(from, file), path.join(to, file));

package/dist/cli/baseline.js.map

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

package/dist/cli/diff.d.ts

@@ -3,6 +3,7 @@ import { BindingDrift } from '../resolution';
 import { Usage } from '../ingest';
 import { NameDriftFinding } from '../nameDrift';
 import { FixOutcome, ReportEvidence } from '../htmlReport';
+import { SystemicOutcome } from '../systemicDelta';
 /**
  * `ia-qa-heal diff [baseline] [current] [--strict] [--json] [--dir]`
  *
@@ -77,6 +78,20 @@ export declare function runDiff(args: string[]): Promise<void>;
  * its author believes it does — and in the `referenced-by-tests` case, believing it
  * would mean believing a green gate over a suite that is about to go red.
  */
+/**
+ * The cross-page section: what moved everywhere at once.
+ *
+ * It leads with the shape of the fact ("2 elements, on all 142 pages") because that
+ * shape is the diagnosis — an app does not usually delete the same control from every
+ * page between two runs, and a reader who sees the count immediately stops reading it
+ * as 288 separate problems.
+ *
+ * The remedy is always printed, and it differs by policy: when the group is held out
+ * the reader needs to know a decision was made *for* them and how to see it; when it
+ * is still in the verdict they need the two candidate causes, in the order that costs
+ * least to check.
+ */
+export declare function printSystemic(outcome: SystemicOutcome): void;
 export declare function printNameMasks(outcome: MaskOutcome | undefined): void;
 /**
  * The name-drift section of a human verdict.
@@ -101,6 +116,27 @@ export interface DirDiffCollection {
     }>;
     /** Pairs where both sides came out of the same `map` run — incapable of showing drift. */
     stale: string[];
+    /**
+     * Elements that moved on every page at once — one fact about the capture, not one
+     * per page. Present on every cross-page walk; `groups` is empty when nothing
+     * qualifies, which is the ordinary case and costs nothing.
+     */
+    systemic: SystemicOutcome;
+    /**
+     * The two sides were explored to different depths (`map --deep`), when either declares one.
+     *
+     * A deep baseline diffed against a shallow capture reports every element behind a menu as
+     * `lost` — a BLOCK over an app where nothing changed, manufactured entirely by how the two
+     * contracts were captured. It is the same class as `run`'s source mismatch, and it is worse:
+     * a deep contract can hold more elements behind interaction than in front of it, so the
+     * false verdict is not a handful of rows but most of the page.
+     *
+     * `null` when both sides agree (including both absent — two shallow contracts).
+     */
+    depthMismatch: {
+        baseline: number;
+        current: number;
+    } | null;
 }
 /**
  * A broken binding whose element survived is repairable — FIX. Everything else is a
@@ -138,6 +174,20 @@ export interface DirReport {
     nameDrift?: NameDriftFinding[];
     /** `config.nameMask`'s effect across the walk — applied patterns and refusals, unioned. */
     nameMask?: MaskOutcome;
+    /**
+     * 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.
+     */
+    next_command?: string | null;
+    /** Why, in one sentence. */
+    next?: string;
+    /**
+     * Elements that moved on every page at once. Set only when a group was found, so a
+     * consumer that never meets one sees the document it always saw. When `policy` is
+     * `held-out` the counts above no longer include these rows — the group is the record
+     * of what left, which is why it is emitted rather than merely printed.
+     */
+    systemic?: SystemicOutcome;
     /**
      * Selector strings from the suite whose binding to a contracted element broke.
      * Present only once `ingest` has inventoried the tests **and** `map` has resolved

package/dist/cli/diff.js

@@ -41,6 +41,7 @@ exports.pageShotMap = pageShotMap;
 exports.buildEvidence = buildEvidence;
 exports.writeDriftReport = writeDriftReport;
 exports.runDiff = runDiff;
+exports.printSystemic = printSystemic;
 exports.printNameMasks = printNameMasks;
 exports.printNameDrift = printNameDrift;
 exports.driftSummaryLine = driftSummaryLine;
@@ -63,6 +64,8 @@ const htmlReport_1 = require("../htmlReport");
 const evidence_1 = require("../evidence");
 const summary_1 = require("./summary");
 const emit_1 = require("./emit");
+const systemicDelta_1 = require("../systemicDelta");
+const nextStep_1 = require("../nextStep");
 /**
  * `ia-qa-heal diff [baseline] [current] [--strict] [--json] [--dir]`
  *
@@ -408,6 +411,50 @@ async function runDiff(args) {
  * its author believes it does — and in the `referenced-by-tests` case, believing it
  * would mean believing a green gate over a suite that is about to go red.
  */
+/**
+ * The cross-page section: what moved everywhere at once.
+ *
+ * It leads with the shape of the fact ("2 elements, on all 142 pages") because that
+ * shape is the diagnosis — an app does not usually delete the same control from every
+ * page between two runs, and a reader who sees the count immediately stops reading it
+ * as 288 separate problems.
+ *
+ * The remedy is always printed, and it differs by policy: when the group is held out
+ * the reader needs to know a decision was made *for* them and how to see it; when it
+ * is still in the verdict they need the two candidate causes, in the order that costs
+ * least to check.
+ */
+function printSystemic(outcome) {
+    if (outcome.groups.length === 0)
+        return;
+    const widest = outcome.groups[0].pages.length;
+    const n = outcome.groups.length;
+    const icon = outcome.policy === 'held-out' ? '🧭' : '⛔';
+    console.log(`\n   ${icon} ${n} element${n === 1 ? '' : 's'} moved on every page at once ` +
+        `(${widest} page${widest === 1 ? '' : 's'}) — one fact, not ${n * widest} findings:`);
+    for (const g of outcome.groups) {
+        const verb = g.kind === 'lost' ? 'gone from' : 'new on';
+        console.log(`      ${g.role} ${JSON.stringify(g.name)}  ·  ${verb} ${g.pages.length}/${g.seenOn} pages`);
+    }
+    if (outcome.policy === 'held-out') {
+        console.log(`\n      Held out of the verdict: the two captures ran under different browser state\n` +
+            `      (baseline ${outcome.baselineState?.summary ?? 'unknown'} → current ${outcome.currentState?.summary ?? 'unknown'}).\n` +
+            `      A banner dismissed, a flag stored, a tour completed — the app did not move,\n` +
+            `      the state it was read under did. The elements stay in the contract.`);
+        return;
+    }
+    // Still red, and the reader has to arbitrate. Both causes are named because the
+    // rows cannot tell them apart, and saying only one would be a guess wearing a
+    // verdict's clothes.
+    console.log(outcome.state === 'unknown'
+        ? `\n      Still in the verdict — the baseline predates capture-state fingerprints, so\n` +
+            `      "your app removed these" and "these captures ran in different browser state"\n` +
+            `      cannot be told apart here. Two ways out:\n` +
+            `        · they really are gone      → fix or delete the tests that name them\n` +
+            `        · a banner/flag/tour differs → re-map and re-baseline; the next diff can tell`
+        : `\n      Still in the verdict — both captures ran under the same browser state, so the\n` +
+            `      app itself no longer renders these. Fix or delete the tests that name them.`);
+}
 function printNameMasks(outcome) {
     if (!outcome)
         return;
@@ -472,7 +519,7 @@ function driftSummaryLine(verb, verdict, c, nameDrift = [], bindingDrift = []) {
         ? `${bindingFixable} test selector${bindingFixable === 1 ? '' : 's'} to rewrite`
         : c.healable === 0 && nameFixable > 0
             ? `${nameFixable} renamed label${nameFixable === 1 ? '' : 's'}`
-            : `${c.healable} healable`;
+            : `${c.healable} drifted`;
     const headline = verdict === 'PASS'
         ? 'PASS · no drift, suite safe'
         : verdict === 'FIX'
@@ -500,7 +547,7 @@ async function runDirDiff(baselineDir, currentDir, opts) {
         console.error(`❌ "${currentDir}" is not a directory.`);
         process.exit(2);
     }
-    const { reports, stale } = collectDirDiff(baselineDir, currentDir);
+    const { reports, stale, systemic, depthMismatch } = collectDirDiff(baselineDir, currentDir);
     if (reports.length === 0 && stale.length > 0) {
         refuseToCompare('same-capture', `❌ Nothing to compare: ${stale.length === 1 ? 'the only pair is' : `all ${stale.length} pairs are`} ` +
             `the same capture on both sides.\n\n` +
@@ -515,16 +562,37 @@ async function runDirDiff(baselineDir, currentDir, opts) {
         refuseToCompare('no-pairs', `❌ No matching mapping pairs found between ${rel(baselineDir)} and ${rel(currentDir)}.`, 'Mapping files are paired by filename — run `ia-qa-heal map` so both directories hold the same pages.', opts.json);
         return;
     }
+    // Printed BEFORE the verdict, not after it. A depth mismatch does not colour a few rows —
+    // it can invent the entire BLOCK, because everything the deep side found behind a menu is
+    // simply absent from the shallow side and reads as `lost`. Someone who meets the verdict
+    // first will start hand-repairing drift that never happened.
+    if (depthMismatch) {
+        const deeper = depthMismatch.baseline > depthMismatch.current ? 'baseline' : 'current capture';
+        const shallower = deeper === 'baseline' ? 'current capture' : 'baseline';
+        console.error(`\n⚠️  Exploration depth mismatch — the ${deeper} was captured with \`map --deep\`, the ` +
+            `${shallower} was not\n   (depth ${depthMismatch.baseline} vs ${depthMismatch.current}). ` +
+            `A deep contract holds the elements behind menus, tabs and dialogs;\n   a shallow one ` +
+            `cannot, so those elements read as \`lost\` here. Most of what follows is probably that,\n` +
+            `   not drift in your app.\n` +
+            `   Capture both sides the same way: \`ia-qa-heal map --deep\` before diffing, or re-baseline` +
+            ` without it.`);
+    }
     // Aggregate verdict
     const aggregate = aggregateReports(reports);
     if (stale.length > 0)
         aggregate.staleExcluded = stale;
+    if (systemic.groups.length > 0)
+        aggregate.systemic = systemic;
+    Object.assign(aggregate, (0, nextStep_1.nextStepFor)(aggregate.verdict, {
+        systemicUnresolved: systemic.groups.length > 0 && systemic.policy === 'in-verdict',
+    }));
     const usage = (0, ingest_1.loadUsage)();
     if (opts.json) {
-        console.log(JSON.stringify(aggregate, null, 2));
+        console.log(JSON.stringify({ schema: nextStep_1.SCHEMA_VERSION, ...aggregate }, null, 2));
     }
     else {
         printAggregate(aggregate, reports, baselineDir, currentDir, usage);
+        printSystemic(systemic);
         printNameMasks(aggregate.nameMask);
         printNameDrift(aggregate.nameDrift);
     }
@@ -605,7 +673,18 @@ function escalateBindingVerdict(verdict, drift) {
  * diff each pair. Reporting and exit codes stay with the callers.
  */
 function collectDirDiff(baselineDir, currentDir) {
-    const reports = [];
+    let reports = [];
+    // The state each side was captured under. Stamped per page by the same `map` run, so
+    // the first pair read settles it for the walk; a baseline written before this field
+    // existed leaves it undefined, which `compareCaptureState` reports as *unknown* and
+    // never as a match.
+    let baselineState;
+    let currentState;
+    // Exploration depth, settled the same way and for the same reason. Absent means the loaded
+    // state only, which is depth 0 — a real value here, not unknown: every contract written
+    // before `--deep` existed describes exactly one state, and that is knowable.
+    let baselineDepth = 0;
+    let currentDepth = 0;
     // 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 = [];
@@ -614,6 +693,10 @@ function collectDirDiff(baselineDir, currentDir) {
     const usage = (0, ingest_1.loadUsage)();
     const masks = (0, nameMask_1.loadNameMasks)();
     const assess = (baseline, current, baselineFile, currentFile, page) => {
+        baselineState ??= baseline.captureState;
+        currentState ??= current.captureState;
+        baselineDepth = Math.max(baselineDepth, baseline.exploredDepth ?? 0);
+        currentDepth = Math.max(currentDepth, current.exploredDepth ?? 0);
         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);
@@ -667,7 +750,18 @@ function collectDirDiff(baselineDir, currentDir) {
             console.error(`⚠ Skipping ${name}: ${e instanceof Error ? e.message : String(e)}`);
         }
     }
-    return { reports, stale };
+    // Last, over the finished walk: a cross-page fact cannot be known page by page.
+    // `applySystemic` is a no-op unless the state comparison licenses holding a group
+    // out, so a project with no systemic delta — or with one the state cannot explain —
+    // gets exactly the reports it got before.
+    const systemic = (0, systemicDelta_1.assessSystemic)(reports, baselineState, currentState);
+    reports = (0, systemicDelta_1.applySystemic)(reports, systemic);
+    return {
+        reports,
+        stale,
+        systemic,
+        depthMismatch: baselineDepth === currentDepth ? null : { baseline: baselineDepth, current: currentDepth },
+    };
 }
 function aggregateReports(reports) {
     const layoutReports = reports.filter((r) => r.isLayout);
@@ -716,7 +810,16 @@ function aggregateReports(reports) {
             verdict: r.report.verdict,
             counts: r.report.counts,
             healableMappings: r.report.counts.healable > 0
-                ? r.report.rows.filter((row) => row.status === 'healable').map((row) => ({ from: row.selector, to: row.healedSelector }))
+                ? r.report.rows
+                    .filter((row) => row.status === 'healable')
+                    .map((row) => ({
+                    from: row.selector,
+                    to: row.healedSelector,
+                    // Carried per rewrite rather than per report: an agent applies one edit at a
+                    // time, and "3 of these are exact and 1 is a fuzzy guess" is unrecoverable
+                    // from a single verdict word.
+                    confidence: (0, nextStep_1.confidenceFor)(row),
+                }))
                 : undefined,
         })),
         totals,
@@ -732,14 +835,14 @@ function printAggregate(agg, reports, baselineDir, currentDir, usage) {
         console.log(against);
     console.log(`   ${path.basename(baselineDir)} → ${path.basename(currentDir)}`);
     console.log(`   ${reports.length} ${reports.length === 1 ? 'file' : 'files'} diffed`);
-    console.log(`   ${agg.totals.ok} ok · ${agg.totals.renamed} renamed · ${agg.totals.healable} healable · ` +
+    console.log(`   ${agg.totals.ok} ok · ${agg.totals.renamed} renamed · ${agg.totals.healable} drifted · ` +
         `${agg.totals.ambiguous} ambiguous · ${agg.totals.lost} lost · ${agg.totals.rebound} rebound · ${agg.totals.added} new`);
     // Layout section
     if (agg.layoutVerdict) {
         const li = agg.layoutVerdict === 'PASS' ? '✅' : agg.layoutVerdict === 'FIX' ? '🔧' : '⛔';
         console.log(`\n   📐 Layouts  ${li} ${agg.layoutVerdict}`);
         if (agg.layoutCounts) {
-            console.log(`      ${agg.layoutCounts.ok} ok · ${agg.layoutCounts.healable} healable · ` +
+            console.log(`      ${agg.layoutCounts.ok} ok · ${agg.layoutCounts.healable} drifted · ` +
                 `${agg.layoutCounts.lost} lost · ${agg.layoutCounts.added} new`);
         }
     }
@@ -759,7 +862,7 @@ function printAggregate(agg, reports, baselineDir, currentDir, usage) {
         const counts = [
             `${pr.counts.ok} ok`,
             pr.counts.renamed > 0 ? `${pr.counts.renamed} renamed` : null,
-            `${pr.counts.healable} heal`,
+            `${pr.counts.healable} drifted`,
             pr.counts.ambiguous > 0 ? `${pr.counts.ambiguous} ambiguous` : null,
             `${pr.counts.lost} lost`,
             `${pr.counts.added} new`,
@@ -986,7 +1089,7 @@ function printHuman(report, files, usage) {
     const icon = verdict === 'PASS' ? '✅' : verdict === 'FIX' ? '🔧' : '⛔';
     console.log(`\n${icon}  ${verdict}`);
     console.log(`   ${path.basename(files[0])} → ${path.basename(files[1])}  ·  ` +
-        `${counts.ok} ok · ${counts.renamed} renamed · ${counts.healable} healable · ` +
+        `${counts.ok} ok · ${counts.renamed} renamed · ${counts.healable} drifted · ` +
         `${counts.ambiguous} ambiguous · ${counts.lost} lost · ${counts.rebound} rebound · ${counts.added} new\n`);
     const drift = rows.filter((r) => r.status !== 'ok');
     for (const r of drift) {
@@ -994,7 +1097,7 @@ function printHuman(report, files, usage) {
         if (r.status === 'healable') {
             const how = r.matchType === 'exact' ? 'exact name' : `fuzzy ${Math.round((r.score ?? 0) * 100)}%`;
             const by = r.disambiguatedBy === 'context' ? `, by context "${r.context}"` : '';
-            console.log(`   🔧 healable   ${label(r)}\n               ${r.selector}  →  ${r.healedSelector}  (${how}${by})${note}`);
+            console.log(`   🔧 drifted    ${label(r)}\n               ${r.selector}  →  ${r.healedSelector}  (${how}${by})${note}`);
         }
         else if (r.status === 'renamed') {
             console.log(`   ✏️  renamed    ${label(r)}\n               name "${r.name}" → "${r.newName}"  ·  selector still valid: ${r.selector}${note}`);