@ia-qa/self-healing 1.18.0 → 1.19.1

package/README.md

@@ -65,6 +65,7 @@ results rendered, nothing written.
 | show me the app's structure | `graph --format mermaid\|svg\|json\|markdown` |
 | is this getting better or worse? | `history` |
 | let me look and decide myself | `ui` — a local console |
+| where do I put my API key? | `secret set` — the OS store, so it stops living in your environment |
 | teach my AI agent to drive this | `skill` — installs the agent instructions into `.claude/skills/` |
 
 `ia-qa-heal <verb> --help` for flags. On a slow suite, note that `run` runs it **twice** (once
@@ -76,6 +77,12 @@ one of them. `ia-qa-heal-mcp` exposes `map_app`, `diff_mappings`, `fix_tests`, `
 `audit_suite`, `explain_failure`, `check_app`, `heal_history` and `suggest_heal`. `login` and
 `ui` are deliberately not tools: both wait for a person.
 
+**Any provider that speaks the OpenAI API** — `openai`, `anthropic`, `google`, or
+`openai-compatible` with a `baseUrl`: DeepSeek, Groq, Mistral, OpenRouter, Together, vLLM,
+or Ollama on your own machine, where the call never leaves it. `ia-qa-heal-ai models` lists
+the URLs. The egress notice always names the host it will really reach, and refuses to
+announce anything when a compatible endpoint has no URL configured.
+
 **Optional, with your own key** — `ia-qa-heal-ai` (`init`, `models`, `suggest`) proposes a match
 for the rows deterministic matching gave up on. It is a suggestion a human confirms, and it
 never touches the verdict.
@@ -175,6 +182,74 @@ session", which would capture the login page under your pages' names.
 `login` needs a terminal and refuses under CI. There, use `auth` (a form fill, secrets from
 env/SSM — see **Configuration**) or capture-during-run, where your own suite logs itself in.
 
+### Where the API key lives — `ia-qa-heal secret`
+
+A key exported in your shell is inherited by **everything you launch from it**, an AI agent
+included. Measured: a spawned process read the whole 164-character key straight out of
+`process.env`. Putting it in the machine's credential store stops it being ambient.
+
+```bash
+ia-qa-heal secret set OPENAI_KEY     # asks for the value; never an argument, never echoed
+ia-qa-heal secret check OPENAI_KEY   # does it resolve? yes or no — never the value
+ia-qa-heal secret list               # the names it holds
+```
+
+Then the config holds a reference, exactly like `env`:
+
+```json
+apiKey: { source: keychain, key: OPENAI_KEY }
+```
+
+| | |
+|---|---|
+| macOS | the keychain (`security`) |
+| Windows | DPAPI — encrypted for **this user account, on this machine** |
+| Linux | the desktop keyring (`secret-tool`) |
+| anywhere else, or no `secret-tool` | it **refuses** and points at `env` — no home-made vault |
+
+There is deliberately no `secret get`: a verb that prints a secret puts it in a scrollback, a
+log or an agent transcript, which is what this exists to avoid. `set` refuses without a
+terminal — a person types the value, an agent cannot do it for them. **In CI keep `env`**:
+there is no store and no person there, and the runner already holds the secret.
+
+**What it does not do**, said plainly: it is not a barrier against an agent that decides to
+read the key — it can run the same OS command. What changes is that the value stops being
+ambient, so obtaining it becomes an explicit, visible act instead of an inheritance.
+
+### Is the session still good? — `ia-qa-heal session --check`
+
+A wall has three possible causes, and "expired, rotated, or never covering this domain" is a
+list, not an answer. One of them means *log in again*; another means your `baseUrl` and your
+session are about **different applications**, which logging in will never fix.
+
+```bash
+npx ia-qa-heal session --check             # 0 it holds · 1 it does not · 2 could not tell
+npx ia-qa-heal session --check --offline   # answer from the file alone, open nothing
+```
+
+**Two of the three need no browser**, because a cookie carries its own expiry and its own
+domain:
+
+```
+🔑 .ia-qa/session.json
+   1 cookie, 0 origins with local storage  ·  staging.other.test
+   First cookie expires in 24 hours
+
+❌ Nothing in this session is scoped to app.example.com — its cookies are for staging.other.test.
+   The session and the baseUrl are about different applications, so logging in again will
+   produce the same file.
+```
+
+So the browser opens only for the question a request is the only witness to: the file is
+valid, correctly scoped and unexpired, and the app answers with a login anyway — the server
+dropped it. A navigation that fails is reported as **could not tell** (exit 2), never as a
+dead session: that distinction is the whole point of having the verb.
+
+Run it before a long `map`. And **`map` itself now stops at the first login wall when a
+session is in use** — a session is one credential for the whole app, so walking the remaining
+pages into the same wall only spends the run re-proving it. The pages it did not attempt keep
+their previous contracts and read `stale` in the next diff: not measured, not unchanged.
+
 ### Start from the failure — `ia-qa-heal explain`
 
 Every other verb starts from a contract. You start from a red build.
@@ -560,7 +635,7 @@ Everything else is optional:
 |---|---|
 | `session` | a Playwright `storageState` to reuse instead of logging in |
 | `locale` | accessible names are language-dependent — set it if your app is not the system default |
-| `volatile` | content that rotates by design (feed links, promos). Never enters a contract, so churn cannot read as drift |
+| `volatile` | content that rotates by design (feed links, promos). Never enters a contract, so churn cannot read as drift — and `map` names any excluded element your tests still use, with `file:line` (see below) |
 | `nameMask` | labels carrying a counter or a clock (`"Cart (*)"`). Only the **label** stops being compared; role, selector and href still gate |
 | `layouts` / `autoLayout` | shared shell extracted to `_layouts/`, diffed once instead of per page |
 | `ai` | the BYOK add-on (see below) |
@@ -569,6 +644,28 @@ Everything else is optional:
 monorepo. Every field is documented in full in the tutorial
 (`TUTORIAL.md`, shipped in this package).
 
+### When a declaration hides something your tests use
+
+`volatile` is the most destructive thing you can declare: a matching element never enters a
+contract at all, so **nothing will ever report it moving**. That is correct for a rotating
+feed item and a permanent blind spot for anything else — and a count (`40 volatile excluded`)
+cannot tell the two apart.
+
+So `map` crosses its own exclusions with the locator inventory `ingest` wrote:
+
+```
+⚠  1 element excluded by "volatile" is referenced by your tests:
+     button "Save"  —  excluded by `name:Save`, located by name
+       pom/MiniCartHeader.ts:14
+   A volatile element never enters a contract, so you will NEVER be told when one of
+   these moves, is renamed or disappears — the gate stays green and the test goes red.
+```
+
+It is silent when nothing overlaps, and — deliberately — it does **not** claim your tests are
+safe when there is no `usage.json`: with no inventory it says the overlap was *not measured*,
+which is a different sentence from *none*. Nothing is refused; the exclusion may be exactly
+what you wanted. The line exists so that it is a decision rather than a surprise.
+
 ## The console — `ia-qa-heal ui`
 
 [![The ia-qa-heal console: a BLOCK verdict, the one element the tool refused to guess, the verbs as buttons, the history as charts](https://www.ia-qa.com/media/heal-ui-poster.png)](https://www.ia-qa.com/media/heal-ui.mp4)

package/TUTORIAL.md

@@ -308,6 +308,33 @@ for a person — twice: at the browser, then at the keyboard), and it is **not a
 pipeline, use `auth` (secrets from env/SSM) or capture-during-run (Step 6.7), where your own suite
 logs itself in. An AI agent driving the CLI cannot perform this step — it will hand it to you.
 
+### Step 5.2a-bis — "It says login wall. But I *did* log in." — `session --check`
+
+Before you log in again, find out whether that would help. A session can fail three ways, and
+only one of them is fixed by logging in:
+
+```bash
+ia-qa-heal session --check
+```
+
+| What it says | What it means | What to do |
+|---|---|---|
+| `expired` | every cookie's date is in the past | log in again — nothing is wrong with your setup |
+| `wrong-host` | nothing in the file is scoped to your `baseUrl` | **logging in again produces the identical file.** Your session and your `baseUrl` are about different applications — fix one of them |
+| `rotated` | the file is valid and the app still answers a login | the server dropped it: a deploy, a rotation, a forced logout. Log in again |
+| *could not tell* (exit 2) | the app could not be opened | a fact about the network, not about your session |
+
+**The first two need no browser at all** — a cookie carries its own expiry and its own domain,
+so the answer is already in the file. Add `--offline` to stay entirely local. `www.` and the
+apex count as one host, and the port is ignored, so `localhost:3000` is never mistaken for
+another app.
+
+One consequence worth knowing: when a session is in use, `map` now **stops at the first login
+wall** instead of walking every remaining page into it. A session is one credential for the
+whole app — the second page would only re-prove what the first showed. You will see `N of M
+pages mapped`, and the pages it did not attempt keep their previous contracts: `stale` in the
+next diff, which means *not measured*, never *unchanged*.
+
 
 
 ### Step 5.2b — (optional) Find the pages you're *not* testing: `discover`
@@ -545,6 +572,20 @@ npx ia-qa-heal fix .ia-qa/baseline/checkout.json .ia-qa/mapping/checkout.json te
 npx ia-qa-heal fix .ia-qa/baseline/checkout.json .ia-qa/mapping/checkout.json tests/
 ```
 
+**If it repairs nothing, read which of three sentences it printed** — they are not the same
+news:
+
+| What it says | What it means |
+|---|---|
+| "…and your tests reference none of it" | it looked, and your suite does not use these elements |
+| "…**but your tests DO reference** N of these elements" | each one is listed with `file:line` and **why** it could not be repaired — two candidates share the name, the element is gone, the selector now reaches a different element. These need you; the tool can say what changed, not which element you meant |
+| "Whether your tests reference any of these is **NOT measured**" | there is no `usage.json`. Run `ia-qa-heal ingest` and this becomes one of the two answers above |
+
+The middle one is the case that used to be reported as the first — "no test file referenced
+any of the drifted selectors", printed over a Page Object that contained the selector
+verbatim. Absence of evidence is not evidence of absence, and the three states exist so the
+two can never be confused again.
+
 ### Step 6.5b — Stop fixing the same test twice (`--locators`)
 
 A repaired `nth-of-type(2)` is still an `nth-of-type(2)`: correct today, and wrong again the day someone inserts a button above it. If your suite is Playwright in `.js`/`.ts`, add `--locators`:
@@ -906,6 +947,23 @@ Two things it refuses to do, out loud:
 
 Rule of thumb: **`nameMask` when the label rotates, `volatile` when the element does.**
 
+**And `map` tells you when a `volatile` pattern is hiding something your tests use.** The
+pattern you write to silence a feed can match more than you meant — the element leaves the
+contract completely, so nothing will ever report it moving again. `map` crosses its own
+exclusions with the locators `ingest` inventoried and names the overlap:
+
+```
+⚠  1 element excluded by "volatile" is referenced by your tests:
+     button "Save"  —  excluded by `name:Save`, located by name
+       pom/MiniCartHeader.ts:14
+   A volatile element never enters a contract, so you will NEVER be told when one of
+   these moves, is renamed or disappears — the gate stays green and the test goes red.
+```
+
+Nothing is refused: the exclusion may be exactly what you wanted, and the message says so.
+It is silent when nothing overlaps — and when you have never run `ingest`, it says the
+overlap was **not measured** rather than pretending it found none.
+
 ---
 
 ## 11. FAQ

package/dist/ai/models.d.ts

@@ -20,8 +20,20 @@ export interface AiProviderInfo {
     /** Default env var the picker suggests for this provider's key (BYOK). */
     keyEnv: string;
     models: AiModelInfo[];
+    /**
+     * This provider has no fixed host: the project says where it lives (`ai.baseUrl`).
+     *
+     * The picker and every caller branch on this rather than on the id, so a second
+     * configurable provider needs no second special case.
+     */
+    needsBaseUrl?: true;
 }
 export declare const AI_PROVIDERS: AiProviderInfo[];
+/** The URL each well-known compatible endpoint serves — a hint for a picker, never a default. */
+export declare const COMPATIBLE_EXAMPLES: Array<{
+    label: string;
+    baseUrl: string;
+}>;
 export declare function findProvider(id: string): AiProviderInfo | undefined;
 /** Default env var name for a provider's key (falls back to a generic name). */
 export declare function defaultKeyEnv(provider: AiProvider): string;

package/dist/ai/models.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AI_PROVIDERS = void 0;
+exports.COMPATIBLE_EXAMPLES = exports.AI_PROVIDERS = void 0;
 exports.findProvider = findProvider;
 exports.defaultKeyEnv = defaultKeyEnv;
 exports.renderModelList = renderModelList;
@@ -42,6 +42,30 @@ exports.AI_PROVIDERS = [
             { id: 'gemini-1.5-pro', label: 'Gemini 1.5 Pro' },
         ],
     },
+    {
+        // A shape, not a vendor. DeepSeek, Groq, Mistral, OpenRouter, Together, vLLM and Ollama
+        // all serve `/v1/chat/completions`, so one entry reaches every one of them — and a model
+        // running on the user's own machine, where nothing leaves it at all.
+        //
+        // No model list on purpose: this endpoint's catalogue belongs to whoever runs it, and a
+        // list here would be wrong for most of them. The user pins the id, as they already can
+        // for the other three.
+        id: 'openai-compatible',
+        label: 'OpenAI-compatible endpoint (DeepSeek, Groq, Mistral, OpenRouter, Ollama, vLLM…)',
+        keyEnv: 'LLM_API_KEY',
+        needsBaseUrl: true,
+        models: [],
+    },
+];
+/** The URL each well-known compatible endpoint serves — a hint for a picker, never a default. */
+exports.COMPATIBLE_EXAMPLES = [
+    { label: 'DeepSeek', baseUrl: 'https://api.deepseek.com/v1' },
+    { label: 'Groq', baseUrl: 'https://api.groq.com/openai/v1' },
+    { label: 'Mistral', baseUrl: 'https://api.mistral.ai/v1' },
+    { label: 'OpenRouter', baseUrl: 'https://openrouter.ai/api/v1' },
+    { label: 'Together', baseUrl: 'https://api.together.xyz/v1' },
+    { label: 'Ollama (on this machine)', baseUrl: 'http://localhost:11434/v1' },
+    { label: 'vLLM (on this machine)', baseUrl: 'http://localhost:8000/v1' },
 ];
 function findProvider(id) {
     return exports.AI_PROVIDERS.find((p) => p.id === id);
@@ -58,6 +82,14 @@ function renderModelList() {
         for (const m of p.models) {
             lines.push(`    - ${m.id}${m.note ? `   — ${m.note}` : ''}`);
         }
+        if (p.needsBaseUrl) {
+            // An empty model list would otherwise read as "nothing supported here". What this
+            // provider needs is the URL, and the models are whatever that endpoint serves.
+            lines.push('    needs "baseUrl" — the endpoint decides the models, not this list:');
+            for (const e of exports.COMPATIBLE_EXAMPLES)
+                lines.push(`    - ${e.label.padEnd(26)} ${e.baseUrl}`);
+            lines.push('    A localhost URL means the call never leaves this machine.');
+        }
         lines.push('');
     }
     return lines.join('\n');

package/dist/ai/models.js.map

@@ -1 +1 @@
-{"version":3,"file":"models.js","sourceRoot":"","sources":["../../src/ai/models.ts"],"names":[],"mappings":";;;AAmEA,oCAEC;AAGD,sCAEC;AAGD,0CAUC;AA5DY,QAAA,YAAY,GAAqB;IAC5C;QACE,EAAE,EAAE,QAAQ;QACZ,KAAK,EAAE,QAAQ;QACf,MAAM,EAAE,gBAAgB;QACxB,MAAM,EAAE;YACN,EAAE,EAAE,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,+BAA+B,EAAE;YAClF,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE;YACjC,EAAE,EAAE,EAAE,cAAc,EAAE,KAAK,EAAE,cAAc,EAAE;YAC7C,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE;YACnC,EAAE,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,wBAAwB,EAAE;YACzE,EAAE,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE;YAC/D,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,4BAA4B,EAAE;YACnE,+EAA+E;YAC/E,4EAA4E;YAC5E,4EAA4E;SAC7E;KACF;IACD;QACE,EAAE,EAAE,WAAW;QACf,KAAK,EAAE,oBAAoB;QAC3B,MAAM,EAAE,mBAAmB;QAC3B,MAAM,EAAE;YACN,EAAE,EAAE,EAAE,kBAAkB,EAAE,KAAK,EAAE,kBAAkB,EAAE,IAAI,EAAE,+BAA+B,EAAE;YAC5F,EAAE,EAAE,EAAE,iBAAiB,EAAE,KAAK,EAAE,iBAAiB,EAAE;YACnD,EAAE,EAAE,EAAE,iBAAiB,EAAE,KAAK,EAAE,iBAAiB,EAAE,IAAI,EAAE,cAAc,EAAE;SAC1E;KACF;IACD;QACE,EAAE,EAAE,QAAQ;QACZ,KAAK,EAAE,iBAAiB;QACxB,MAAM,EAAE,gBAAgB;QACxB,MAAM,EAAE;YACN,EAAE,EAAE,EAAE,kBAAkB,EAAE,KAAK,EAAE,kBAAkB,EAAE,IAAI,EAAE,qBAAqB,EAAE;YAClF,EAAE,EAAE,EAAE,kBAAkB,EAAE,KAAK,EAAE,kBAAkB,EAAE;YACrD,EAAE,EAAE,EAAE,gBAAgB,EAAE,KAAK,EAAE,gBAAgB,EAAE;SAClD;KACF;CACF,CAAC;AAEF,SAAgB,YAAY,CAAC,EAAU;IACrC,OAAO,oBAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;AAC/C,CAAC;AAED,gFAAgF;AAChF,SAAgB,aAAa,CAAC,QAAoB;IAChD,OAAO,YAAY,CAAC,QAAQ,CAAC,EAAE,MAAM,IAAI,YAAY,CAAC;AACxD,CAAC;AAED,gFAAgF;AAChF,SAAgB,eAAe;IAC7B,MAAM,KAAK,GAAa,CAAC,8FAA8F,EAAE,EAAE,CAAC,CAAC;IAC7H,KAAK,MAAM,CAAC,IAAI,oBAAY,EAAE,CAAC;QAC7B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,iBAAiB,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;QACzE,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC;YACzB,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC/D,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../../src/ai/models.ts"],"names":[],"mappings":"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"}

package/dist/ai/resolver.d.ts

@@ -32,16 +32,37 @@ export interface AiResolveResult {
     confidence: number;
     candidateIndex: number;
 }
-export type AiProvider = 'anthropic' | 'openai' | 'google';
+/**
+ * `openai-compatible` is the fourth, and it is a *shape*, not a vendor: DeepSeek, Groq,
+ * Mistral, OpenRouter, Together, vLLM and Ollama all speak `/v1/chat/completions`. One entry
+ * opens the layer to every one of them — and to a model running on the user's own machine,
+ * which for a tool that calls itself local-first is not a detail.
+ */
+export type AiProvider = 'anthropic' | 'openai' | 'google' | 'openai-compatible';
 /**
  * Where each provider's request actually goes.
  *
- * Exported because the CLI must NAME the host before it sends anything — the
- * announcement and the request have to read the same constant. Two lists would be
- * a fourth transcription surface, and the one that drifts is the announcement:
- * a notice naming a host the code no longer calls is worse than no notice at all.
+ * Exported because the CLI must NAME the host before it sends anything — the announcement and
+ * the request have to read the same source. Two lists would be another transcription surface,
+ * and the one that drifts is the announcement: a notice naming a host the code no longer calls
+ * is worse than no notice at all.
+ *
+ * `null` means *the project configures it*, and it is deliberately not an empty string: every
+ * reader has to handle the case rather than concatenate nothing. `Record<AiProvider, …>` still
+ * makes a new provider a compile error, which is the guarantee this constant exists for —
+ * `egressHost` below is what keeps it once the host stops being a constant.
+ */
+export declare const PROVIDER_HOST: Record<AiProvider, string | null>;
+/**
+ * The host this call will really reach — refusing rather than guessing.
+ *
+ * The compile-time guarantee used to be "every provider has a stated host". With a
+ * configurable one it becomes "every call has a stated host, or it does not happen": a
+ * provider that needs a `baseUrl` and was given none throws here, *before* any request and
+ * before any announcement. An egress notice that printed `undefined` would be worse than
+ * none, because it would read as a checked fact.
  */
-export declare const PROVIDER_HOST: Record<AiProvider, string>;
+export declare function egressHost(provider: AiProvider, baseUrl?: string): string;
 export interface AiResolveOptions {
     provider: AiProvider;
     /** Pinned model id (determinism). */
@@ -54,6 +75,8 @@ export interface AiResolveOptions {
     topN?: number;
     /** Abort the request after this many ms. Default 15000. */
     timeoutMs?: number;
+    /** Required for `openai-compatible`: where that endpoint lives (e.g. `https://api.deepseek.com/v1`). */
+    baseUrl?: string;
     /** Pinned to 0 by default. */
     temperature?: number;
     /** Injected in tests so no real network is hit. Defaults to global fetch. */

package/dist/ai/resolver.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PROVIDER_HOST = void 0;
+exports.egressHost = egressHost;
 exports.aiResolve = aiResolve;
 exports.prefilter = prefilter;
 exports.buildPrompt = buildPrompt;
@@ -9,16 +10,46 @@ const match_1 = require("../browser/match");
 /**
  * Where each provider's request actually goes.
  *
- * Exported because the CLI must NAME the host before it sends anything — the
- * announcement and the request have to read the same constant. Two lists would be
- * a fourth transcription surface, and the one that drifts is the announcement:
- * a notice naming a host the code no longer calls is worse than no notice at all.
+ * Exported because the CLI must NAME the host before it sends anything — the announcement and
+ * the request have to read the same source. Two lists would be another transcription surface,
+ * and the one that drifts is the announcement: a notice naming a host the code no longer calls
+ * is worse than no notice at all.
+ *
+ * `null` means *the project configures it*, and it is deliberately not an empty string: every
+ * reader has to handle the case rather than concatenate nothing. `Record<AiProvider, …>` still
+ * makes a new provider a compile error, which is the guarantee this constant exists for —
+ * `egressHost` below is what keeps it once the host stops being a constant.
  */
 exports.PROVIDER_HOST = {
     anthropic: 'api.anthropic.com',
     openai: 'api.openai.com',
     google: 'generativelanguage.googleapis.com',
+    'openai-compatible': null,
 };
+/**
+ * The host this call will really reach — refusing rather than guessing.
+ *
+ * The compile-time guarantee used to be "every provider has a stated host". With a
+ * configurable one it becomes "every call has a stated host, or it does not happen": a
+ * provider that needs a `baseUrl` and was given none throws here, *before* any request and
+ * before any announcement. An egress notice that printed `undefined` would be worse than
+ * none, because it would read as a checked fact.
+ */
+function egressHost(provider, baseUrl) {
+    const fixed = exports.PROVIDER_HOST[provider];
+    if (fixed)
+        return fixed;
+    if (!baseUrl) {
+        throw new Error(`Provider "${provider}" has no fixed host: it needs "baseUrl" in the ai config, ` +
+            `e.g. "https://api.deepseek.com/v1" or "http://localhost:11434/v1".`);
+    }
+    try {
+        return new URL(baseUrl).host;
+    }
+    catch {
+        throw new Error(`ai.baseUrl is not a URL: ${baseUrl}`);
+    }
+}
 const DEFAULTS = { minConfidence: 0.7, topN: 15, timeoutMs: 15000, temperature: 0 };
 /**
  * Resolve a broken `target` to one of the live `candidates`, or null.
@@ -121,7 +152,7 @@ async function callModel(prompt, opts) {
 }
 /** One hardened round-trip. Returns the Response (even non-2xx, so the caller can see 400), or null on network/timeout. */
 async function attempt(fetchFn, opts, prompt, temperature, timeoutMs) {
-    const req = buildRequest(opts.provider, opts.model, opts.apiKey, prompt, temperature);
+    const req = buildRequest(opts.provider, opts.model, opts.apiKey, prompt, temperature, opts.baseUrl);
     const controller = new AbortController();
     const timer = setTimeout(() => controller.abort(), timeoutMs);
     try {
@@ -134,7 +165,7 @@ async function attempt(fetchFn, opts, prompt, temperature, timeoutMs) {
         clearTimeout(timer);
     }
 }
-function buildRequest(provider, model, apiKey, prompt, temperature) {
+function buildRequest(provider, model, apiKey, prompt, temperature, baseUrl) {
     if (provider === 'anthropic') {
         const body = { model, max_tokens: 512, messages: [{ role: 'user', content: prompt }] };
         if (temperature !== undefined)
@@ -160,11 +191,15 @@ function buildRequest(provider, model, apiKey, prompt, temperature) {
     if (temperature !== undefined)
         body.temperature = temperature;
     return {
-        url: `https://${exports.PROVIDER_HOST.openai}/v1/chat/completions`,
+        // The same shape serves OpenAI and every compatible endpoint. `baseUrl` is taken as
+        // given — trailing slash trimmed and nothing else invented — because a gateway that
+        // does not end in `/v1` is a real configuration, not a mistake to correct.
+        url: provider === 'openai-compatible' ? `${trimSlash(baseUrl)}/chat/completions` : `https://${exports.PROVIDER_HOST.openai}/v1/chat/completions`,
         headers: { 'content-type': 'application/json', authorization: `Bearer ${apiKey}` },
         body,
     };
 }
+const trimSlash = (u) => u.replace(/\/+$/, '');
 function extractText(provider, data) {
     if (provider === 'anthropic') {
         const block = Array.isArray(data?.content) ? data.content.find((b) => b?.type === 'text') : null;

package/dist/ai/resolver.js.map

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

package/dist/cli/args.js

@@ -18,6 +18,8 @@ exports.KNOWN_FLAGS = {
     init: ['--yes', '--base-url', '--pages', '--discover', '--tests', '--test-command', '--bootstrap'],
     discover: ['--sitemap', '--crawl', '--no-reveal', '--strict-host', '--apply', '--max', '--depth', '--session'],
     login: ['--url', '--session'],
+    secret: ['--json'],
+    session: ['--check', '--offline', '--url', '--session', '--json'],
     map: ['--screenshots', '--session', '--deep', '--depth', '--deep-budget'],
     baseline: ['--dry-run'],
     diff: ['--strict', '--json', '--junit', '--dir', '--report', '--open'],

package/dist/cli/args.js.map

@@ -1 +1 @@
-{"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"}
+{"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"}

package/dist/cli/diff.js

@@ -596,17 +596,41 @@ function printSystemic(outcome) {
             `      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`
+    // The conclusion has to follow the DIRECTION of the groups.
+    //
+    // It did not, and a real tour caught it: six `contentinfo`/`navigation`/footer-heading
+    // groups came back **new on 142/142 pages**, and the block told the reader "the app itself
+    // no longer renders these. Fix or delete the tests that name them." Backwards, and
+    // destructive — it advises deleting tests over elements that just appeared. The per-group
+    // lines said `new on` correctly; only the paragraph under them was written for one case.
+    const added = outcome.groups.filter((g) => g.kind === 'added').length;
+    const lost = outcome.groups.length - added;
+    const allAdded = lost === 0;
+    if (outcome.state === 'unknown') {
+        console.log(`\n      Still in the verdict — the baseline predates capture-state fingerprints, so\n` +
+            `      "the app changed" and "these captures ran in different browser state" cannot be\n` +
+            `      told apart here. Two ways out:\n` +
+            (allAdded
+                ? `        · the app really added them  → re-baseline, then the next diff is clean\n` +
+                    `        · a banner/flag/tour differs → re-map and re-baseline; the next diff can tell`
+                : `        · 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`));
+        return;
+    }
+    console.log(allAdded
+        ? `\n      Still in the verdict — both captures ran under the same browser state, so these\n` +
+            `      elements are genuinely on every page now and were on none before. An element\n` +
+            `      appearing everywhere at once is usually a shared shell (a nav, a footer) that\n` +
+            `      the baseline predates — including a baseline captured before this tool started\n` +
+            `      contracting headings, landmarks and live regions. Nothing in your tests is\n` +
+            `      broken by it: re-baseline once and the next diff is clean.\n` +
+            `        npx -p @ia-qa/pal ia-qa-pal rebaseline --all     (preview; --yes applies)`
         : `\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.`);
+            `      app itself no longer renders these. Fix or delete the tests that name them.` +
+            (added > 0
+                ? `\n      (${added} of these groups APPEARED rather than disappeared — those need a\n` +
+                    `      re-baseline, not a test edit.)`
+                : ''));
 }
 function printNameMasks(outcome) {
     if (!outcome)