@ia-qa/pal 0.2.0 → 0.4.0

package/README.md

@@ -2,7 +2,7 @@
 
 **A QA pal next to your team — not instead of it.**
 
-One command walks your web app, maps every page, checks it, and compares it with the last tour. Then it tells you four things, in the order you act on them: what is **broken**, what **needs a decision**, what is **ready to repair**, and what it **could not see**.
+One command walks your web app, maps every page, checks it, and compares it with the last tour — and, when you declare your end-to-end suite, reads it too. Then it tells you four things, in the order you act on them: what is **broken**, what **needs a decision**, what is **ready to repair**, and what it **could not see**.
 
 - **Local.** A headless browser on your machine. Nothing is uploaded, no account, no LLM.
 - **Deterministic.** Verdicts come from [`@ia-qa/self-healing`](https://www.npmjs.com/package/@ia-qa/self-healing) — the same engine as `ia-qa-heal diff` and `ia-qa-heal check`, so the two can never disagree.
@@ -23,7 +23,7 @@ npx playwright install chromium
 npx ia-qa-pal tour
 ```
 
-**Not set up yet?** In a terminal, the first `tour` asks two questions — where the app lives, and how it logs in — then reads its pages from `sitemap.xml` (or, without one, follows its links: same host, GET only, at most 50 pages), shows you exactly what it will write, and writes it only when you say yes. Nothing it asks takes a password.
+**Not set up yet?** In a terminal, the first `tour` asks where the app lives and how it logs in — and, when it finds a test suite in the project, whether to read it — then reads its pages from `sitemap.xml` (or, without one, follows its links: same host, GET only, at most 50 pages), shows you exactly what it will write, and writes it only when you say yes. Nothing it asks takes a password.
 
 From CI or an agent, the same setup with flags:
 
@@ -60,11 +60,54 @@ ia-qa-pal tour — https://app.example · level 1 (with a login)
 
 The time estimate only appears once a batch has been explored on your app: it is the pace measured there, never a constant.
 
+## What fails a tour, and what does not
+
+- **Drift on what a page shows when it loads** — a control lost, ambiguous, or a selector now reaching another element — fails the tour.
+- **Drift on what is reached only by clicking** — a profile opened from a ranking, a button that exists in one state of the app — is listed under *To decide* with the clicks that reached it, and does **not** fail the tour: on an app with live data it may simply depend on what the click landed on. `--strict` makes it fail too.
+- **A label that differs only by a number** (`Cart (3)` → `Cart (5)`, `Activity60` → `Activity30`) comes with the `nameMask` to paste into `.ia-qa/config.json`; the element stays under contract, only its label stops being compared.
+- **A change you intended**: review it, then make it the reference for those pages only —
+
+```bash
+npx ia-qa-pal accept settings checkout   # or --all: every page the last tour reported
+```
+
+## With your test suite
+
+Declare it at setup (`--tests tests/`, or answer yes when the tour finds it) and every tour also reads it:
+
+- **🔧 Ready to repair** — when a selector your tests write stops reaching its element while the element is still there, the rewrite is listed with `file:line` and the command that applies it after you review it. pal never edits your tests.
+- **⛔ To decide** — locator names your tests use that nothing on the mapped pages carries, and renamed labels your tests locate by name.
+- **🔍 Not seen** — `ia-qa-pal tour --suite` runs the `testCommand` from your config once, with the capture hook, and names the pages your suite **never visits**. The capture is kept apart from the tour's contracts. Your specs need the hook for this — one import:
+
+```js
+import { test, expect } from '@ia-qa/self-healing/capture';
+```
+
+Without it, the report says the suite ran but recorded no page — never that it visits nothing.
+
+## In the background, and for agents
+
+```bash
+npx ia-qa-pal tour --background   # returns at once
+npx ia-qa-pal status              # phase and progress, then the report
+```
+
+One tour runs per project; a second is refused while the first is alive, and a tour whose process died is reported as interrupted, never as running.
+
+`ia-qa-pal-mcp` is the same thing as a local stdio MCP server — `pal_project`, `pal_setup`, `pal_tour` (always in the background, so no client times out) and `pal_status`. No tool takes a command, and there is no login tool.
+
+```json
+{ "mcpServers": { "ia-qa-pal": { "command": "npx", "args": ["-y", "-p", "@ia-qa/pal", "ia-qa-pal-mcp"] } } }
+```
+
 ### Options
 
 | flag | |
 |---|---|
 | `--more` | explore the next batch in depth instead of a regression tour |
+| `--suite` | also run your test command once, with the capture hook |
+| `--background` | start detached and return at once |
+| `--strict` | also fail on drift reached only by clicking |
 | `--batch <n>` | pages per depth batch (default 10) |
 | `--json` | the whole report as one JSON document on stdout; progress stays on stderr |
 | `--session <file>` | a Playwright `storageState` to reuse |
@@ -74,9 +117,9 @@ The time estimate only appears once a batch has been explored on your app: it is
 
 | code | meaning |
 |---|---|
-| `0` | nothing needs a decision (warnings never fail a tour) |
-| `1` | a dead link, or drift that blocks (an element lost, ambiguous, or a selector now pointing at another element) |
-| `2` | could not answer: not set up, nothing could be mapped, or the tour refused to run |
+| `0` | nothing needs a decision (warnings and proposed repairs never fail a tour) |
+| `1` | a dead link, drift on what pages show on load (an element lost, ambiguous, or a selector now pointing at another element), a test about to act on the wrong element, or your suite failed when run with `--suite` |
+| `2` | could not answer: not set up, nothing could be mapped, the tour refused to run, or one is already running |
 
 Read `2` as "no answer", never as "the app is broken".
 
@@ -85,8 +128,5 @@ Read `2` as "no answer", never as "the app is broken".
 - **Only your app.** Its pages load whatever they load in any browser.
 - **Exploration is read-only.** While menus, tabs and dialogs are opened, every non-GET request is blocked, and controls named like actions (log out, delete, pay…) are never clicked.
 - **The link check** requests your app's own links with GET, skipping any URL that acts (`/logout`, `/delete`…).
-- **Files** live in `.ia-qa/`: contracts, baseline, and `pal/state.json` (pace and already-reported findings). A saved session there holds live cookies — it is gitignored and never leaves your machine.
-
-## Not yet
-
-Reading your test suite (coverage of what it does not test, repairs proposed as a patch), a local MCP server for agents, and background exploration are planned next.
+- **Your test command** runs only with `--suite` (or `suite: true` from an agent), and it is always the one in your config — never a string passed on the call.
+- **Files** live in `.ia-qa/`: contracts, baseline, `usage.json` (your suite's locators), and `pal/` (the measured pace, findings already reported, the current run and its log). A saved session there holds live cookies — it is gitignored and never leaves your machine.

package/TUTORIAL.md

@@ -33,10 +33,10 @@ In your project folder:
 npx ia-qa-pal tour
 ```
 
-The project is not set up yet, so the tour asks two questions first.
+The project is not set up yet, so the tour asks first: where the app lives, how it logs in, and — only when it finds a test suite in the folder — whether to read it (section 7).
 
 ```
-This project is not set up yet — two questions first.
+This project is not set up yet — a few questions first.
 
 Where does the app live? (https://…) https://www.ia-qa.com
 Does the app ask you to log in?
@@ -96,10 +96,10 @@ The report has at most four sections, and each one appears only when it holds so
 
 | section | what it holds | what you do |
 |---|---|---|
-| 🔴 **Broken in the app** | links your app itself answers with an error | fix the link |
-| ⛔ **To decide** | drift that blocks, and findings seen for the first time | a person looks |
-| 🔧 **Ready to repair** | *(coming with test-suite support)* | |
-| 🔍 **Not seen** | pages not explored, not mapped, only partly explored, links it could not verify | decide whether it matters |
+| 🔴 **Broken** | links your app itself answers with an error; your suite failing under `--suite` | fix it |
+| ⛔ **To decide** | drift, and findings seen for the first time | a person looks — then fixes, or `accept`s |
+| 🔧 **Ready to repair** | with your test suite declared: selector rewrites for your tests (section 7) | review, then apply with `ia-qa-heal fix` |
+| 🔍 **Not seen** | pages not explored, not mapped, not compared, only partly explored, links it could not verify, pages your suite never visits | decide whether it matters |
 
 Three things are worth knowing about this first report:
 
@@ -128,15 +128,47 @@ ia-qa-pal tour — https://www.nodemented.com · level 1 (with a login)
 
 Each page is captured again **the way its baseline was captured** — on the surface, or opened in depth — and compared with it. A finding already reported is counted, not listed again: a list that never shrinks stops being read by the third tour.
 
-When something moved (illustrative):
+When something moved — a real tour of a browser game with live data, five minutes after its baseline:
 
 ```
-⛔ BLOCK · 1937 ok · 0 renamed · 1 lost · 0 ambiguous · 0 rebound
+ia-qa-pal tour — https://project-1jpdv.vercel.app · level 2 (with your test suite)
+⛔ BLOCK · 1471 ok · 0 renamed · 2 lost · 0 ambiguous · 1 rebound
+   17 of 17 pages under contract · 10 explored in depth of 16 pages with closed controls
 
 ⛔ To decide
-   drift   settings: 1 lost · 0 ambiguous · 0 rebound
+   drift   jeu-journal: button "📡Activité60" rebound
+   behind  2 elements reached only by clicking changed — they may depend on the data the click lands on:
+           jeu-chantier: button "👽 Intercepter" lost, after "🌌Galaxie"
+           jeu-chantier: button "Reset" lost, after "🌌Galaxie"
+   If these changes are intended: ia-qa-pal accept jeu-journal jeu-chantier
+   61 warnings already reported — not listed again.
+
+💡 1 label differs only by a number — a counter or a clock that changes on its own, and it is holding the verdict.
+   e.g. "📡Activité60" → "📡Activité30". To stop comparing those labels (the element stays under contract), add to .ia-qa/config.json:
+   "nameMask": ["📡Activité*"]
 ```
 
+Two kinds of drift, and they do not weigh the same:
+
+- **What a page shows when it loads** fails the tour. Here, `📡Activité60` is a counter that moved on its own — the 💡 line gives the `nameMask` to paste once.
+- **What is reached only by clicking** is listed with the clicks that reached it and does **not** fail the tour. "Intercepter" exists only while the game has something to intercept: the tour did nothing wrong, the data changed. `--strict` makes these fail too.
+
+With the `nameMask` added, the next tour of the same game:
+
+```
+⚠️  Drift only behind interaction — not failing the tour (--strict would) · 1472 ok · 0 renamed · 2 lost · 0 ambiguous · 0 rebound
+```
+
+and it exits `0`, still listing the two buttons under *To decide*.
+
+When a change **is** intended — you renamed a button, removed a page section — review it and make it the reference for those pages only:
+
+```bash
+npx ia-qa-pal accept jeu-chantier     # or --all: every page the last tour reported
+```
+
+Nothing else in the baseline moves. An agent never runs this for you: accepting drift is the decision the report hands to a person.
+
 What the words mean:
 
 | word | meaning |
@@ -158,9 +190,9 @@ The control stays under contract; only its label is no longer compared.
 
 | code | meaning |
 |---|---|
-| `0` | nothing needs a decision — warnings never fail a tour |
-| `1` | a dead link, or drift that blocks |
-| `2` | no answer: not set up, nothing could be mapped, or the tour refused to run |
+| `0` | nothing needs a decision — warnings, proposed repairs and drift behind interaction never fail a tour |
+| `1` | a dead link, drift on what pages show on load, a test about to act on the wrong element, or your suite failed under `--suite` |
+| `2` | no answer: not set up, nothing could be mapped, the tour refused to run, or one is already running |
 
 Read `2` as "could not answer", never as "the app is broken".
 
@@ -179,7 +211,7 @@ npx ia-qa-pal tour --more
 
 `--more` explores the next batch and adds those pages to the baseline. Run it when you have the time — the estimate told you how much. `--batch <n>` changes the batch size.
 
-It **refuses** when the last tour ended on BLOCK:
+It **refuses** when the last tour ended on drift that fails (accept or fix it first — `ia-qa-pal accept` clears it):
 
 ```
 ⏸  Did not run — The last tour ended on BLOCK. Exploring now would promote those pages as they are today and accept that drift unseen — resolve it, then run `ia-qa-pal tour` again.
@@ -217,12 +249,78 @@ npx ia-qa-pal setup --url https://staging.shop.example --login session --session
 
 ---
 
-## 7. In CI
+## 7. With your test suite
+
+A tour already tells you what changed in the app. With your end-to-end suite declared, it also tells you what that change does to **your tests**.
+
+Declare it once — the setup offers it when it finds a `tests/`, `e2e/` or `cypress/e2e/` folder with specs, or with flags:
+
+```bash
+npx ia-qa-pal setup --url https://staging.shop.example --login none --tests tests --yes
+```
+
+The command that runs the suite is detected from `package.json` (`test:e2e`, `e2e`…) or a `playwright.config`; set it yourself with `--test-command "npm run test:e2e"`.
+
+From then on, every tour reads the suite's locators before capturing, and the report gains three things.
+
+**🔧 Ready to repair.** A selector your tests write stopped reaching its element — the class changed, a `data-testid` was added — while the element itself is still on the page (illustrative):
+
+```
+🔧 Ready to repair (1 replacement in 1 file)
+   tests/settings.spec.js:17   .btn-primary → #prefs > button:nth-of-type(1)
+   Apply after review: npx -p @ia-qa/self-healing ia-qa-heal fix   (pal never edits your tests)
+```
+
+pal only lists it. `ia-qa-heal fix` computes the same rewrite and applies it — review it with `git diff` before committing. A rewrite that could break a passing test (two pages wanting the same string to become two different things, an XPath inside `By.xpath`) is left out and named, never guessed.
+
+**⛔ To decide.** Locator names your tests use that nothing on the mapped pages carries — `getByRole('button', { name: 'Save' })` when no button is called Save anymore — with `file:line`. It is advisory: the name may live on a page or in a state the tour did not map. And when a label your tests locate by name was renamed, the tour says so.
+
+**🔍 Which pages your suite never visits.** This one needs the suite to run:
+
+```bash
+npx ia-qa-pal tour --suite
+```
+
+It runs the `testCommand` from your config once, with the capture hook armed, and keeps only the list of pages the suite really opened — its capture never mixes with the tour's contracts. The answer stays in the report until the next `--suite` (illustrative):
+
+```
+🔍 Not seen
+   your suite never visits 14 of 17 pages (run of 2026-09-15): faq, jeu-galaxie, jeu-classement, …
+```
+
+Your specs need the capture hook — one import, a drop-in for Playwright's own:
+
+```js
+import { test, expect } from '@ia-qa/self-healing/capture';
+```
+
+Without it, the report says the suite ran but recorded no page, and names the import. It never says your suite visits nothing. If the suite fails during `--suite`, the tour reports it under **Broken** and exits `1`.
+
+---
+
+## 8. In the background
+
+A tour on a large app takes a while. Start it and get your terminal back:
+
+```bash
+npx ia-qa-pal tour --background
+npx ia-qa-pal status
+```
+
+```
+⏳ A tour is running (pid 34136, since 2026-09-15T14:04:32Z) — depth 4/10 · jeu-planete
+```
+
+When it is done, `status` prints the report. Only one tour runs per project: a second is refused while the first is alive, because two tours would write the same contracts. A tour whose process died before finishing is reported as **interrupted** — never as still running, never as a result. Its output is in `.ia-qa/pal/run.log`.
+
+---
+
+## 9. In CI
 
 Build the baseline on your machine, commit it, and let CI compare.
 
 ```bash
-git add .ia-qa/config.json .ia-qa/baseline .ia-qa/pal
+git add .ia-qa/config.json .ia-qa/baseline .ia-qa/pal/state.json
 git commit -m "ia-qa-pal baseline"
 ```
 
@@ -241,13 +339,29 @@ Never commit `.ia-qa/session.json`.
 
 ---
 
-## 8. With an AI agent
+## 10. With an AI agent
 
-An agent can drive `ia-qa-pal` from a shell. Three rules it must follow — they are also in `ia-qa-pal --help`:
+An agent can drive `ia-qa-pal` from a shell, or through its local MCP server:
+
+```json
+{ "mcpServers": { "ia-qa-pal": { "command": "npx", "args": ["-y", "-p", "@ia-qa/pal", "ia-qa-pal-mcp"] } } }
+```
+
+| tool | what it does |
+|---|---|
+| `pal_project` | is the project set up, its level, its baseline, a tour running? |
+| `pal_setup` | writes the config from **your** answers — never overwrites one |
+| `pal_tour` | starts a tour in the background and returns at once, so no client times out |
+| `pal_status` | progress, then the full report |
+
+No tool takes a command — your test command comes from your config, which you wrote — and there is no login tool.
+
+The rules the agent must follow are also in `ia-qa-pal --help`:
 
 - **Read "Not seen".** A clean tour over part of an app is not a clean app, and the agent must say which part was not seen.
 - **A first tour is not a pass.** It established the baseline.
 - **Never answer a setup question for you, and never run `ia-qa-heal login`.** That command waits for a person at a browser; the agent gives it to you instead.
+- **Never apply a proposed repair without your review, and never add `--suite` without asking** — it runs your suite on your machine.
 
 Asked to tour a project that is not set up, `ia-qa-pal tour --json` answers with what is missing rather than guessing:
 
@@ -264,31 +378,34 @@ Asked to tour a project that is not set up, `ia-qa-pal tour --json` answers with
 
 ---
 
-## 9. What it touches
+## 11. What it touches
 
 - **Only your app.** Its pages load whatever they load in any browser (fonts, analytics…).
 - **Exploration is read-only.** While menus, tabs and dialogs are opened, every non-GET request is blocked, and controls named like actions (log out, delete, pay, send…) are never clicked.
 - **The link check** requests your app's own links with GET and skips any URL that acts.
-- **Files** live in `.ia-qa/`: `config.json`, `mapping/` (today), `baseline/` (the reference), `pal/state.json` (the measured pace and the findings already reported).
+- **Your test files are read, never written.** Your test command runs only with `--suite`.
+- **Files** live in `.ia-qa/`: `config.json`, `mapping/` (today), `baseline/` (the reference), `usage.json` (your suite's locators), `pal/state.json` (the measured pace, the findings already reported, the last `--suite` run), `pal/run.json` and `pal/run.log` (the current or last tour).
 
 ---
 
-## 10. When something looks wrong
+## 12. When something looks wrong
 
 **A page is "not mapped" with a timeout.** One slow page costs that page, not the tour. It stays in **Not seen**; if its drift is shown, the report marks it as an older capture.
 
-**Every page behind the login is "not mapped".** The session expired, or never worked. Log in again with `ia-qa-heal login`, then run the tour.
+**"N pages landed on a login page instead".** The session expired, or never worked. Log in again with `ia-qa-heal login`, then run the tour. Drift on those pages is from an older capture: it is not counted, and `accept` refuses them until a tour captures them again.
+
+**"not compared — its contract file cannot be read".** A file under `.ia-qa/baseline/` or `.ia-qa/mapping/` is corrupt. Restore it from git, or run the tour again to re-capture it.
 
-**`renamed` on a label you did not touch.** A counter, a date or generated content. Add a `nameMask` for it (section 4).
+**`renamed` or `rebound` on a label you did not touch.** A counter, a date or generated content. The report gives the `nameMask` to paste (section 4).
+
+**Drift behind interaction on every tour.** Those elements depend on the app's data. They never fail the tour unless you pass `--strict`; if they are noise you never want to read, `ia-qa-pal accept` the page after the data settles, or keep the page on the surface.
 
 **"only partly explored (click budget reached)".** The page has more closed controls than one exploration opens (150 clicks). Its contract covers part of the page, and the report says so.
 
----
+**"A tour is already running" but nothing is.** Run `ia-qa-pal status`: a tour whose process died shows as interrupted, and the next tour starts normally.
 
-## 11. Coming next
+**"your suite ran but recorded no page".** Your specs do not import the capture hook (section 7).
 
-- **Your test suite**: which pages it never visits, and repairs to its selectors proposed as a patch — never applied without you.
-- **A local MCP server** so agents call `tour` as a tool.
-- **Background exploration**, followed from the local console.
+---
 
 `ia-qa-pal` is built on [`@ia-qa/self-healing`](https://www.npmjs.com/package/@ia-qa/self-healing): the verdicts it prints are the ones `ia-qa-heal diff` and `ia-qa-heal check` compute, so the two never disagree.

package/dist/accept.d.ts

@@ -0,0 +1,20 @@
+/**
+ * A person looked at the drift and it is what they wanted: a new label, a removed button, data
+ * that moved. Only those pages' latest captures become the reference — nothing else in `mapping/`
+ * is promoted, and nothing is accepted that the last tour did not capture.
+ *
+ * Deliberately not an MCP tool: accepting drift is the decision the whole report hands to a person.
+ */
+export interface AcceptOutcome {
+    accepted: string[];
+    skipped: Array<{
+        page: string;
+        reason: string;
+    }>;
+    refused?: string;
+}
+/** The pages whose drift the last finished tour reported. */
+export declare function driftedPages(dir: string): string[];
+export declare function acceptPages(dirGiven: string, pagesGiven: string[], opts?: {
+    all?: boolean;
+}): Promise<AcceptOutcome>;

package/dist/accept.js

@@ -0,0 +1,119 @@
+"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.driftedPages = driftedPages;
+exports.acceptPages = acceptPages;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const self_healing_1 = require("@ia-qa/self-healing");
+const run_1 = require("./run");
+const state_1 = require("./state");
+/** The pages whose drift the last finished tour reported. */
+function driftedPages(dir) {
+    const drift = (0, run_1.readRun)(dir)?.report?.drift;
+    if (!drift)
+        return [];
+    return [...new Set([...drift.onLoad, ...drift.behindInteraction].map((f) => f.page).concat(drift.suitePages))];
+}
+async function acceptPages(dirGiven, pagesGiven, opts = {}) {
+    const dir = path.resolve(dirGiven);
+    if (!fs.existsSync(path.join(dir, '.ia-qa', 'config.json'))) {
+        return { accepted: [], skipped: [], refused: 'This project is not set up yet — there is no .ia-qa/config.json.' };
+    }
+    if ((0, run_1.activeRun)(dir))
+        return { accepted: [], skipped: [], refused: 'A tour is running on this project — accept after it finishes (ia-qa-pal status).' };
+    (0, self_healing_1.setBaseDir)(dir);
+    const configured = new Set((0, self_healing_1.loadConfig)().pages.map((p) => p.name));
+    const wanted = opts.all ? driftedPages(dir) : pagesGiven;
+    if (wanted.length === 0) {
+        return { accepted: [], skipped: [], refused: opts.all ? 'The last tour reported no drift to accept.' : 'Name the pages to accept, or --all for every page the last tour reported.' };
+    }
+    const ready = [];
+    const skipped = [];
+    const notRecaptured = new Set(((0, run_1.readRun)(dir)?.report?.pages.notMapped ?? []).map((m) => m.page));
+    for (const page of wanted) {
+        if (!configured.has(page)) {
+            skipped.push({ page, reason: 'not a configured page' });
+            continue;
+        }
+        if (notRecaptured.has(page)) {
+            skipped.push({ page, reason: 'the last tour could not re-capture it — accepting would promote an older capture; run a tour first' });
+            continue;
+        }
+        let current;
+        try {
+            current = (0, self_healing_1.loadMapping)(page, (0, self_healing_1.mappingDir)());
+        }
+        catch {
+            skipped.push({ page, reason: 'no capture yet — run a tour first' });
+            continue;
+        }
+        try {
+            if ((0, self_healing_1.loadMapping)(page, (0, self_healing_1.baselineDir)()).capturedAt === current.capturedAt) {
+                skipped.push({ page, reason: 'the baseline already is its latest capture' });
+                continue;
+            }
+        }
+        catch {
+            /* not in the baseline yet: accepting it adds it */
+        }
+        ready.push(page);
+    }
+    if (ready.length > 0) {
+        const { log, info, warn } = console;
+        console.log = console.info = console.warn = (...a) => console.error(...a);
+        const before = process.exitCode;
+        process.exitCode = undefined;
+        try {
+            await (0, self_healing_1.runBaseline)([], { pages: ready });
+            if (process.exitCode)
+                return { accepted: [], skipped, refused: `baseline refused to promote ${ready.join(', ')}` };
+        }
+        finally {
+            process.exitCode = before;
+            console.log = log;
+            console.info = info;
+            console.warn = warn;
+        }
+        const remaining = driftedPages(dir).filter((p) => !ready.includes(p));
+        const state = (0, state_1.loadState)();
+        if (state.lastVerdict === 'BLOCK' && remaining.length === 0) {
+            delete state.lastVerdict;
+            (0, state_1.saveState)(state);
+        }
+    }
+    return { accepted: ready, skipped };
+}
+//# sourceMappingURL=accept.js.map

package/dist/accept.js.map

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