@eidra-umain/greenlight 0.1.0 → 0.3.0

package/README.md

@@ -10,7 +10,7 @@ No selectors. No XPaths. No test IDs, drivers or glue code. Just describe what a
 
 ---
 
-**[How it works](#how-it-works)** | **[Quick start](#quick-start)** | **[Project configuration](#project-configuration)** | **[CLI](#cli)** | **[Test syntax](#test-syntax)** | **[Cached plans](#cached-plans)** | **[LLM setup](#llm-setup)** | **[Architecture](#architecture)** | **[CI/CD](#cicd)**
+**[How it works](#how-it-works)** | **[Quick start](#quick-start)** | **[Project configuration](#project-configuration)** | **[CLI](#cli)** | **[Test syntax](#test-syntax)** | **[Cached plans](#cached-plans)** | **[LLM setup](#llm-setup)** | **[Architecture](#architecture)** | **[Avoiding side effects](#avoiding-side-effects-in-your-app)** | **[CI/CD](#cicd)**
 
 ---
 
@@ -34,7 +34,7 @@ tests:
       - check that you see "Thanks for your inquiry"
 ```
 
-GreenLight understands form wizards, custom dropdowns, autocomplete fields, and checkbox consent flows. It fills in forms with realistic test data, handles before/after value comparisons, and works with any UI framework.
+GreenLight understands form wizards, custom dropdowns, autocomplete fields, checkbox consent flows, and interactive maps. It fills in forms with realistic test data, handles before/after value comparisons, and works with any UI framework.
 
 The first run uses an LLM to discover the right actions (the **discovery run**). After that, GreenLight caches a concrete action plan and replays it without LLM calls — making subsequent runs fast and deterministic.
 
@@ -185,6 +185,7 @@ Tests are plain English. The Pilot interprets intent, so phrasing is flexible. C
 | Remember | `remember the number of search results` |
 | Compare | `check that the number of results is less than before` |
 | Assert | `check that page contains "Order Confirmed"` |
+| Map assert | `check that the map shows "Stockholm"` or `check that zoom level is at least 10` |
 | Multi-step | `Select Red - Green - Blue in the color picker` (auto-split into 3 clicks) |
 
 ### Form filling
@@ -202,6 +203,31 @@ steps:
   - check that the total has decreased
 ```
 
+### Map testing
+
+GreenLight has built-in support for testing pages with interactive WebGL maps. When a test step mentions maps, markers, layers, or zoom levels, GreenLight automatically detects the map library, attaches to its instance, and queries the map's rendered features and viewport state directly — bypassing the DOM entirely, since WebGL canvas content is invisible to the accessibility tree.
+
+Currently supported: **MapLibre GL JS**. The architecture is pluggable — Mapbox GL and Leaflet adapters can be added without changing test syntax.
+
+```yaml
+steps:
+  - navigate to the map view
+  - check that the map shows "Stockholm"
+  - check that the zoom level is at least 10
+  - check that the "hospitals" layer is visible on the map
+```
+
+**How it works:** When the planner sees map-related language in a step, it inserts a `MAP_DETECT` step that finds and attaches to the map instance. Subsequent map assertions query the map's actual rendered features (place names, road labels, etc. from vector tile data) and viewport state (center, zoom, bounds, layers). This means "check that the map shows Stockholm" searches for a feature with `name: "Stockholm"` among the thousands of features currently rendered on the canvas — it doesn't just check for the word in the page text.
+
+**Map instance detection** works automatically for most setups:
+
+1. **React apps** (react-map-gl, etc.) — walks the React fiber tree from the `.maplibregl-map` container to find the map instance in component refs and hook state
+2. **Vue apps** — checks `__vue_app__` (Vue 3) and `__vue__` (Vue 2) component trees
+3. **Global variables** — scans `window.map`, `window.mapInstance`, and similar common names
+4. **Explicit exposure** — for maximum reliability, set `window.__greenlight_map = map` in your app
+
+Map detection, state capture, and feature queries all work in both discovery and cached plan runs.
+
 ### Reusable steps
 
 Define common sequences at the suite level and invoke by name:
@@ -325,7 +351,7 @@ greenlight run --provider openai --llm-base-url http://localhost:11434/v1 --mode
 | Layer | Technology |
 |-------|-----------|
 | Browser automation | Playwright (Chromium) |
-| Page representation | Accessibility tree with stable element refs |
+| Page representation | Accessibility tree with stable element refs + map viewport state |
 | AI | OpenRouter (any OpenAI-compatible provider) |
 | Plan caching | SHA-256 hash-based invalidation, `.greenlight/plans/` |
 | Test definitions | YAML |
@@ -379,6 +405,43 @@ flowchart TD
 - [Specifications](docs/specifications.md) — full feature spec, technology decisions, MCP strategy
 - [Implementation Plan](docs/implementation.md) — step-by-step build plan
 
+## Avoiding side effects in your app
+
+GreenLight provides two signals that your application can use to detect when it's running under a test and suppress side effects like analytics, chat widgets, cookie banners, or third-party scripts that interfere with testing.
+
+### `window.__E2E_TEST__`
+
+A global boolean set to `true` on every page before any app JavaScript runs. Use it in your frontend code:
+
+```js
+if (!window.__E2E_TEST__) {
+  initAnalytics()
+  loadIntercom()
+  showCookieBanner()
+}
+```
+
+### `X-E2E-Test` HTTP header
+
+The header `X-E2E-Test: true` is sent on all same-origin requests (navigation, fetch, XHR). Use it server-side to skip side effects:
+
+```js
+// Express middleware example
+app.use((req, res, next) => {
+  if (req.headers['x-e2e-test'] === 'true') {
+    req.isE2ETest = true
+  }
+  next()
+})
+
+// Skip sending emails during E2E tests
+if (!req.isE2ETest) {
+  await sendConfirmationEmail(order)
+}
+```
+
+The header is only added to same-origin requests — cross-origin requests to CDNs, tile servers, and third-party APIs are not affected. This avoids triggering CORS preflight requests on external services.
+
 ## CI/CD
 
 ```yaml

package/dist/browser/browser.d.ts

@@ -13,12 +13,22 @@ export interface BrowserOptions {
 }
 /** Launch a Chromium browser instance. */
 export declare function launchBrowser(config: BrowserOptions): Promise<Browser>;
-/** Create an isolated browser context with configured viewport and test mode headers. */
+/** Create an isolated browser context with configured viewport. */
 export declare function createContext(browser: Browser, config: BrowserOptions): Promise<BrowserContext>;
+/**
+ * Launch a persistent browser context with the zoom extension loaded.
+ * Used in headed mode to get real 75% browser zoom.
+ * Returns a BrowserContext that the caller can create pages from.
+ */
+export declare function launchPersistentContextWithZoom(config: BrowserOptions): Promise<{
+    context: BrowserContext;
+}>;
 /** Create a new page within a browser context and inject test mode global. */
-export declare function createPage(context: BrowserContext): Promise<Page>;
-/** Close the browser and all its contexts. */
-export declare function closeBrowser(browser: Browser): Promise<void>;
+export declare function createPage(context: BrowserContext, options?: {
+    headed?: boolean;
+}): Promise<Page>;
+/** Close a browser or persistent context. */
+export declare function closeBrowser(browserOrContext: Browser | BrowserContext): Promise<void>;
 /** Extract browser options from RunConfig. */
 export declare function toBrowserOptions(config: RunConfig): BrowserOptions;
 //# sourceMappingURL=browser.d.ts.map

package/dist/browser/browser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../src/browser/browser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAY,KAAK,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,IAAI,EAAE,MAAM,YAAY,CAAA;AACnF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAE5C,MAAM,WAAW,cAAc;IAC9B,MAAM,EAAE,OAAO,CAAA;IACf,QAAQ,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;CAC3C;AAED,0CAA0C;AAC1C,wBAAsB,aAAa,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CAI5E;AAED,yFAAyF;AACzF,wBAAsB,aAAa,CAClC,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,cAAc,GACpB,OAAO,CAAC,cAAc,CAAC,CAOzB;AAED,8EAA8E;AAC9E,wBAAsB,UAAU,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAUvE;AAED,8CAA8C;AAC9C,wBAAsB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAElE;AAED,8CAA8C;AAC9C,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,GAAG,cAAc,CAKlE"}
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../src/browser/browser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAY,KAAK,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,IAAI,EAAE,MAAM,YAAY,CAAA;AACnF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAE5C,MAAM,WAAW,cAAc;IAC9B,MAAM,EAAE,OAAO,CAAA;IACf,QAAQ,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;CAC3C;AAeD,0CAA0C;AAC1C,wBAAsB,aAAa,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CAU5E;AAED,mEAAmE;AACnE,wBAAsB,aAAa,CAClC,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,cAAc,GACpB,OAAO,CAAC,cAAc,CAAC,CAIzB;AAgBD;;;;GAIG;AACH,wBAAsB,+BAA+B,CACpD,MAAM,EAAE,cAAc,GACpB,OAAO,CAAC;IAAE,OAAO,EAAE,cAAc,CAAA;CAAE,CAAC,CAsBtC;AAED,8EAA8E;AAC9E,wBAAsB,UAAU,CAC/B,OAAO,EAAE,cAAc,EACvB,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAC5B,OAAO,CAAC,IAAI,CAAC,CAyCf;AAED,6CAA6C;AAC7C,wBAAsB,YAAY,CAAC,gBAAgB,EAAE,OAAO,GAAG,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAE5F;AAED,8CAA8C;AAC9C,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,GAAG,cAAc,CAKlE"}

package/dist/browser/browser.js

@@ -2,24 +2,76 @@
  * Playwright browser lifecycle management.
  * Wraps launch, context creation, page creation, and cleanup.
  */
+import path from "path";
+import { createRequire } from "module";
 import { chromium } from "playwright";
+/** Zoom level applied in headed mode (75%). */
+const BROWSER_ZOOM = 75;
+/**
+ * Resolve the path to the playwright-zoom extension directory.
+ * Uses createRequire because playwright-zoom is a CJS package.
+ */
+function zoomExtensionPath() {
+    const require = createRequire(import.meta.url);
+    const pwZoomDir = path.dirname(require.resolve("playwright-zoom"));
+    return path.join(pwZoomDir, "lib", "zoom-extension");
+}
 /** Launch a Chromium browser instance. */
 export async function launchBrowser(config) {
     return chromium.launch({
         headless: !config.headed,
+        args: [
+            "--enable-webgl",
+            "--enable-webgl2-compute-context",
+            "--enable-gpu-rasterization",
+            "--ignore-gpu-blocklist",
+        ],
     });
 }
-/** Create an isolated browser context with configured viewport and test mode headers. */
+/** Create an isolated browser context with configured viewport. */
 export async function createContext(browser, config) {
     return browser.newContext({
         viewport: config.viewport,
-        extraHTTPHeaders: {
-            "X-E2E-Test": "true",
-        },
     });
 }
+/**
+ * Set browser zoom via the playwright-zoom extension.
+ * The extension's content script listens for a postMessage and relays
+ * it to its service worker which calls chrome.tabs.setZoom().
+ */
+async function applyBrowserZoom(page, zoom) {
+    await page.evaluate((browserZoom) => window.postMessage({ type: "setTabZoom", browserZoom }, "*"), zoom);
+    // Small delay for the extension round-trip
+    await page.waitForTimeout(200);
+}
+/**
+ * Launch a persistent browser context with the zoom extension loaded.
+ * Used in headed mode to get real 75% browser zoom.
+ * Returns a BrowserContext that the caller can create pages from.
+ */
+export async function launchPersistentContextWithZoom(config) {
+    const extPath = zoomExtensionPath();
+    const context = await chromium.launchPersistentContext("", {
+        headless: false,
+        viewport: config.viewport,
+        args: [
+            "--enable-webgl",
+            "--enable-webgl2-compute-context",
+            "--enable-gpu-rasterization",
+            "--ignore-gpu-blocklist",
+            `--disable-extensions-except=${extPath}`,
+            `--load-extension=${extPath}`,
+        ],
+    });
+    // The zoom extension opens a tab on load — close it
+    const existingPages = context.pages();
+    for (const p of existingPages) {
+        await p.close().catch(() => { });
+    }
+    return { context };
+}
 /** Create a new page within a browser context and inject test mode global. */
-export async function createPage(context) {
+export async function createPage(context, options) {
     const page = await context.newPage();
     await page.addInitScript(() => {
         Object.defineProperty(window, "__E2E_TEST__", {
@@ -28,11 +80,40 @@ export async function createPage(context) {
             configurable: false,
         });
     });
+    // IMPORTANT: Custom headers must ONLY be added to same-origin requests.
+    // Never use extraHTTPHeaders on the browser context — it adds headers
+    // to ALL requests including cross-origin tile/CDN fetches (e.g.
+    // DigitalOcean Spaces PMTiles). Non-standard headers trigger CORS
+    // preflight (OPTIONS) requests that tile servers don't handle,
+    // breaking map tile loading entirely.
+    await page.route("**/*", async (route) => {
+        const request = route.request();
+        if (request.isNavigationRequest() || request.resourceType() === "fetch" || request.resourceType() === "xhr") {
+            try {
+                const reqUrl = new URL(request.url());
+                const pageUrl = new URL(page.url());
+                if (reqUrl.origin === pageUrl.origin) {
+                    await route.continue({
+                        headers: { ...request.headers(), "X-E2E-Test": "true" },
+                    });
+                    return;
+                }
+            }
+            catch { /* page.url() can throw before first navigation */ }
+        }
+        await route.continue();
+    });
+    // Apply 75% zoom in headed mode after the first navigation
+    if (options?.headed) {
+        page.once("load", () => {
+            applyBrowserZoom(page, BROWSER_ZOOM).catch(() => { });
+        });
+    }
     return page;
 }
-/** Close the browser and all its contexts. */
-export async function closeBrowser(browser) {
-    await browser.close();
+/** Close a browser or persistent context. */
+export async function closeBrowser(browserOrContext) {
+    await browserOrContext.close();
 }
 /** Extract browser options from RunConfig. */
 export function toBrowserOptions(config) {

package/dist/browser/browser.js.map

@@ -1 +1 @@
-{"version":3,"file":"browser.js","sourceRoot":"","sources":["../../src/browser/browser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAgD,MAAM,YAAY,CAAA;AAQnF,0CAA0C;AAC1C,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,MAAsB;IACzD,OAAO,QAAQ,CAAC,MAAM,CAAC;QACtB,QAAQ,EAAE,CAAC,MAAM,CAAC,MAAM;KACxB,CAAC,CAAA;AACH,CAAC;AAED,yFAAyF;AACzF,MAAM,CAAC,KAAK,UAAU,aAAa,CAClC,OAAgB,EAChB,MAAsB;IAEtB,OAAO,OAAO,CAAC,UAAU,CAAC;QACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,gBAAgB,EAAE;YACjB,YAAY,EAAE,MAAM;SACpB;KACD,CAAC,CAAA;AACH,CAAC;AAED,8EAA8E;AAC9E,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,OAAuB;IACvD,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,CAAA;IACpC,MAAM,IAAI,CAAC,aAAa,CAAC,GAAG,EAAE;QAC7B,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,cAAc,EAAE;YAC7C,KAAK,EAAE,IAAI;YACX,QAAQ,EAAE,KAAK;YACf,YAAY,EAAE,KAAK;SACnB,CAAC,CAAA;IACH,CAAC,CAAC,CAAA;IACF,OAAO,IAAI,CAAA;AACZ,CAAC;AAED,8CAA8C;AAC9C,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAAgB;IAClD,MAAM,OAAO,CAAC,KAAK,EAAE,CAAA;AACtB,CAAC;AAED,8CAA8C;AAC9C,MAAM,UAAU,gBAAgB,CAAC,MAAiB;IACjD,OAAO;QACN,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ;KACzB,CAAA;AACF,CAAC"}
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../../src/browser/browser.ts"],"names":[],"mappings":"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"}

package/dist/cli/run.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/cli/run.ts"],"names":[],"mappings":"AA6BA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAuC5C,6DAA6D;AAC7D,wBAAsB,cAAc,CACnC,UAAU,EAAE,MAAM,EAAE,EACpB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,SAAS,GACf,OAAO,CAAC,IAAI,CAAC,CAgDf;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAC/B,MAAM,EAAE,SAAS,EACjB,aAAa,EAAE,MAAM,EAAE,GACrB,OAAO,CAAC,IAAI,CAAC,CAuQf"}
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/cli/run.ts"],"names":[],"mappings":"AA8BA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAsC5C,6DAA6D;AAC7D,wBAAsB,cAAc,CACnC,UAAU,EAAE,MAAM,EAAE,EACpB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,SAAS,GACf,OAAO,CAAC,IAAI,CAAC,CAgDf;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAC/B,MAAM,EAAE,SAAS,EACjB,aAAa,EAAE,MAAM,EAAE,GACrB,OAAO,CAAC,IAAI,CAAC,CAwSf"}

package/dist/cli/run.js

@@ -1,5 +1,5 @@
 import { loadSuite } from "../parser/loader.js";
-import { launchBrowser, createContext, createPage, closeBrowser, toBrowserOptions, } from "../browser/browser.js";
+import { launchBrowser, launchPersistentContextWithZoom, createContext, createPage, closeBrowser, toBrowserOptions, } from "../browser/browser.js";
 import { attachConsoleCollector, attachNetworkTracker, } from "../pilot/network.js";
 import { resolveLLMConfig, createLLMClient, } from "../pilot/llm.js";
 import { runTestCase } from "../pilot/pilot.js";
@@ -9,24 +9,23 @@ import { createPlanRecorder } from "../planner/plan-generator.js";
 import { runCachedPlan } from "../planner/plan-runner.js";
 import { resolveModelConfig } from "../types.js";
 import { globals } from "../globals.js";
-/** Print step-by-step results for a test case. */
-function printStepResults(result) {
-    for (const stepResult of result.steps) {
-        const icon = stepResult.status === "passed"
-            ? "\x1b[32m\u2713\x1b[0m"
-            : "\x1b[31m\u2717\x1b[0m";
-        const dur = `${String(Math.round(stepResult.duration))}ms`;
-        const t = stepResult.timing;
-        const phases = t
-            ? ` \x1b[90m[capture:${String(Math.round(t.capture))} llm:${String(Math.round(t.llm))} exec:${String(Math.round(t.execute))} post:${String(Math.round(t.postCapture))}ms]\x1b[0m`
-            : "";
-        console.log(`    ${icon} ${stepResult.step} (${dur})${phases}`);
-        if (stepResult.error) {
-            console.log(`      \x1b[31m${stepResult.error}\x1b[0m`);
-        }
-        if (globals.debug && stepResult.action) {
-            console.log(`      Action: ${JSON.stringify(stepResult.action)}`);
-        }
+import { LLMApiError } from "../pilot/providers/index.js";
+/** Print a single step result as it completes. */
+function printStepResult(stepResult) {
+    const icon = stepResult.status === "passed"
+        ? "\x1b[32m\u2713\x1b[0m"
+        : "\x1b[31m\u2717\x1b[0m";
+    const dur = `${String(Math.round(stepResult.duration))}ms`;
+    const t = stepResult.timing;
+    const phases = t
+        ? ` \x1b[90m[capture:${String(Math.round(t.capture))} llm:${String(Math.round(t.llm))} exec:${String(Math.round(t.execute))} post:${String(Math.round(t.postCapture))}ms]\x1b[0m`
+        : "";
+    console.log(`    ${icon} ${stepResult.step} (${dur})${phases}`);
+    if (stepResult.error) {
+        console.log(`      \x1b[31m${stepResult.error}\x1b[0m`);
+    }
+    if (globals.debug && stepResult.action) {
+        console.log(`      Action: ${JSON.stringify(stepResult.action)}`);
     }
 }
 /** Print pass/fail summary for a test case. */
@@ -132,11 +131,20 @@ export async function runCommand(config, resolvedFiles) {
             }
             return llm;
         }
-        // Launch browser
+        // Launch browser — in headed mode use a persistent context with the
+        // zoom extension for real 75% browser zoom. In headless mode use the
+        // normal browser + context flow.
         const browserOpts = toBrowserOptions(config);
-        let browser;
+        let browser = null;
+        let persistentContext = null;
         try {
-            browser = await launchBrowser(browserOpts);
+            if (browserOpts.headed) {
+                const result = await launchPersistentContextWithZoom(browserOpts);
+                persistentContext = result.context;
+            }
+            else {
+                browser = await launchBrowser(browserOpts);
+            }
         }
         catch (err) {
             const msg = err instanceof Error ? err.message : String(err);
@@ -150,127 +158,162 @@ export async function runCommand(config, resolvedFiles) {
                 ? suite.tests.filter((t) => t.name === config.testFilter)
                 : suite.tests;
             for (const test of tests) {
-                const testSlug = slugify(test.name);
-                const testHash = computeTestHash(test);
-                const hashKey = `${suiteSlug}/${testSlug}`;
-                const cachedHash = hashIndex[hashKey];
-                // Determine execution mode
-                let useCachedPlan = false;
-                let cachedPlan = null;
-                if (!config.discover && cachedHash === testHash) {
-                    cachedPlan = await loadPlan(cwd, suiteSlug, testSlug);
-                    if (cachedPlan) {
-                        useCachedPlan = true;
-                    }
-                }
-                const modeLabel = useCachedPlan
-                    ? "\x1b[36mcached\x1b[0m"
-                    : "\x1b[33mdiscovery\x1b[0m";
-                console.log(`\n  Test: ${test.name} [${modeLabel}]`);
-                if (!config.discover &&
-                    cachedHash &&
-                    cachedHash !== testHash) {
-                    console.log(`    \x1b[33mPlan stale, re-discovering\x1b[0m`);
-                }
-                // Fresh context per test case
-                const context = await createContext(browser, browserOpts);
-                const page = await createPage(context);
-                const { drain } = attachConsoleCollector(page);
-                const { waitForNetworkIdle } = attachNetworkTracker(page);
-                globals.trace.attachToPage(page);
                 try {
-                    globals.trace.log("goto", suite.base_url);
-                    await page.goto(suite.base_url);
-                }
-                catch (err) {
-                    const msg = err instanceof Error ? err.message : String(err);
-                    console.error(`\n  \x1b[31m\u2717\x1b[0m Failed to navigate to ${suite.base_url}: ${msg}`);
-                    globals.trace.detachFromPage(page);
-                    await context.close();
-                    continue;
-                }
-                let result;
-                if (useCachedPlan && cachedPlan) {
-                    // Fast run — replay cached plan
-                    result = await runCachedPlan(page, cachedPlan, test.name, { waitForNetworkIdle });
-                    // Handle plan drift
-                    if (result.drifted && config.onDrift === "rerun") {
-                        console.log(`    \x1b[33mPlan drift detected, re-running with LLM\x1b[0m`);
-                        // Close and re-create context for fresh state
+                    const testSlug = slugify(test.name);
+                    const testHash = computeTestHash(test);
+                    const hashKey = `${suiteSlug}/${testSlug}`;
+                    const cachedHash = hashIndex[hashKey];
+                    // Determine execution mode
+                    let useCachedPlan = false;
+                    let cachedPlan = null;
+                    if (!config.discover && cachedHash === testHash) {
+                        cachedPlan = await loadPlan(cwd, suiteSlug, testSlug);
+                        if (cachedPlan) {
+                            useCachedPlan = true;
+                        }
+                    }
+                    const modeLabel = useCachedPlan
+                        ? "\x1b[36mcached\x1b[0m"
+                        : "\x1b[33mdiscovery\x1b[0m";
+                    console.log(`\n  Test: ${test.name} [${modeLabel}]`);
+                    if (!config.discover &&
+                        cachedHash &&
+                        cachedHash !== testHash) {
+                        console.log(`    \x1b[33mPlan stale, re-discovering\x1b[0m`);
+                    }
+                    // Fresh context per test case (reuse persistent context in headed mode)
+                    // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+                    const context = persistentContext ?? await createContext(browser, browserOpts);
+                    const page = await createPage(context, { headed: browserOpts.headed });
+                    const { drain } = attachConsoleCollector(page);
+                    const { waitForNetworkIdle } = attachNetworkTracker(page);
+                    globals.trace.attachToPage(page);
+                    try {
+                        globals.trace.log("goto", suite.base_url);
+                        await page.goto(suite.base_url);
+                    }
+                    catch (err) {
+                        const msg = err instanceof Error ? err.message : String(err);
+                        console.error(`\n  \x1b[31m\u2717\x1b[0m Failed to navigate to ${suite.base_url}: ${msg}`);
                         globals.trace.detachFromPage(page);
-                        await context.close();
-                        const ctx2 = await createContext(browser, browserOpts);
-                        const page2 = await createPage(ctx2);
-                        const { drain: drain2 } = attachConsoleCollector(page2);
-                        const { waitForNetworkIdle: waitForNetworkIdle2 } = attachNetworkTracker(page2);
-                        globals.trace.attachToPage(page2);
-                        await page2.goto(suite.base_url);
-                        const modelLabel = typeof effectiveModel === "string"
+                        if (persistentContext) {
+                            // Persistent context is shared — close pages only
+                            for (const p of context.pages())
+                                await p.close().catch(() => { });
+                        }
+                        else {
+                            await context.close();
+                        }
+                        continue;
+                    }
+                    let result;
+                    if (useCachedPlan && cachedPlan) {
+                        // Fast run — replay cached plan
+                        result = await runCachedPlan(page, cachedPlan, test.name, { waitForNetworkIdle, onStepComplete: printStepResult });
+                        // Handle plan drift
+                        if (result.drifted && config.onDrift === "rerun") {
+                            console.log(`    \x1b[33mPlan drift detected, re-running with LLM\x1b[0m`);
+                            // Close and re-create context for fresh state
+                            globals.trace.detachFromPage(page);
+                            if (persistentContext) {
+                                // Persistent context is shared — close pages only
+                                for (const p of context.pages())
+                                    await p.close().catch(() => { });
+                            }
+                            else {
+                                await context.close();
+                            }
+                            const ctx2 = persistentContext ?? await createContext(
+                            // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+                            browser, browserOpts);
+                            const page2 = await createPage(ctx2, { headed: browserOpts.headed });
+                            const { drain: drain2 } = attachConsoleCollector(page2);
+                            const { waitForNetworkIdle: waitForNetworkIdle2 } = attachNetworkTracker(page2);
+                            globals.trace.attachToPage(page2);
+                            await page2.goto(suite.base_url);
+                            const modelLabel = typeof effectiveModel === "string"
+                                ? effectiveModel
+                                : `${effectiveModel.planner}/${effectiveModel.pilot}`;
+                            const recorder = createPlanRecorder(suiteSlug, testSlug, testHash, modelLabel);
+                            result = await runTestCase(page2, test, getOrCreateLLM(), {
+                                timeout: config.timeout,
+                                consoleDrain: drain2,
+                                recorder,
+                                waitForNetworkIdle: waitForNetworkIdle2,
+                                onStepComplete: printStepResult,
+                            });
+                            result.mode = "discovery";
+                            if (result.status === "passed") {
+                                const plan = recorder.finalize();
+                                await savePlan(cwd, plan);
+                                hashIndex[hashKey] = testHash;
+                                hashIndexDirty = true;
+                                await ensureGitignore(cwd);
+                                console.log(`    \x1b[32mCached plan updated\x1b[0m`);
+                            }
+                            globals.trace.detachFromPage(page2);
+                            await ctx2.close();
+                            printTestSummary(result);
+                            if (config.headed) {
+                                await new Promise((r) => setTimeout(r, 2000));
+                            }
+                            continue;
+                        }
+                    }
+                    else {
+                        // Discovery run — full LLM loop with recorder
+                        const discoveryModelLabel = typeof effectiveModel === "string"
                             ? effectiveModel
                             : `${effectiveModel.planner}/${effectiveModel.pilot}`;
-                        const recorder = createPlanRecorder(suiteSlug, testSlug, testHash, modelLabel);
-                        result = await runTestCase(page2, test, getOrCreateLLM(), {
+                        const recorder = createPlanRecorder(suiteSlug, testSlug, testHash, discoveryModelLabel);
+                        result = await runTestCase(page, test, getOrCreateLLM(), {
                             timeout: config.timeout,
-                            consoleDrain: drain2,
+                            consoleDrain: drain,
                             recorder,
-                            waitForNetworkIdle: waitForNetworkIdle2,
+                            waitForNetworkIdle,
+                            onStepComplete: printStepResult,
                         });
                         result.mode = "discovery";
+                        // Save plan only if the test passed
                         if (result.status === "passed") {
                             const plan = recorder.finalize();
                             await savePlan(cwd, plan);
                             hashIndex[hashKey] = testHash;
                             hashIndexDirty = true;
                             await ensureGitignore(cwd);
-                            console.log(`    \x1b[32mCached plan updated\x1b[0m`);
+                            console.log(`    \x1b[32mCached plan generated for: ${test.name}\x1b[0m`);
                         }
-                        globals.trace.detachFromPage(page2);
-                        await ctx2.close();
-                        printStepResults(result);
-                        printTestSummary(result);
-                        if (config.headed) {
-                            await new Promise((r) => setTimeout(r, 2000));
-                        }
-                        continue;
                     }
-                }
-                else {
-                    // Discovery run — full LLM loop with recorder
-                    const discoveryModelLabel = typeof effectiveModel === "string"
-                        ? effectiveModel
-                        : `${effectiveModel.planner}/${effectiveModel.pilot}`;
-                    const recorder = createPlanRecorder(suiteSlug, testSlug, testHash, discoveryModelLabel);
-                    result = await runTestCase(page, test, getOrCreateLLM(), {
-                        timeout: config.timeout,
-                        consoleDrain: drain,
-                        recorder,
-                        waitForNetworkIdle,
-                    });
-                    result.mode = "discovery";
-                    // Save plan only if the test passed
-                    if (result.status === "passed") {
-                        const plan = recorder.finalize();
-                        await savePlan(cwd, plan);
-                        hashIndex[hashKey] = testHash;
-                        hashIndexDirty = true;
-                        await ensureGitignore(cwd);
-                        console.log(`    \x1b[32mCached plan generated for: ${test.name}\x1b[0m`);
+                    printTestSummary(result);
+                    if (config.headed) {
+                        await new Promise((r) => setTimeout(r, 2000));
+                    }
+                    globals.trace.detachFromPage(page);
+                    if (persistentContext) {
+                        // Persistent context is shared — close pages only
+                        for (const p of context.pages())
+                            await p.close().catch(() => { });
+                    }
+                    else {
+                        await context.close();
                     }
                 }
-                printStepResults(result);
-                printTestSummary(result);
-                if (config.headed) {
-                    await new Promise((r) => setTimeout(r, 2000));
+                catch (err) {
+                    if (err instanceof LLMApiError) {
+                        console.error(`\n  \x1b[31mLLM API returned ${String(err.status)} — aborting test run.\x1b[0m`);
+                        console.error(`  ${err.message}\n`);
+                        break;
+                    }
+                    throw err;
                 }
-                globals.trace.detachFromPage(page);
-                await context.close();
             }
         }
         finally {
             if (hashIndexDirty) {
                 await saveHashIndex(cwd, hashIndex);
             }
-            await closeBrowser(browser);
+            // eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- browser is guaranteed non-null when persistentContext is null
+            await closeBrowser(persistentContext ?? browser);
         }
     }
 }