@unotest/web 0.5.0 → 0.6.2

package/.claude/hooks/log-agent.sh

@@ -0,0 +1,24 @@
+#!/usr/bin/env bash
+# @unotest/web — agent-action trace hook.
+#
+# Appends each Claude Code hook event (delivered as JSON on stdin) to a
+# JSONL file so a debug session captures EVERYTHING the agent did: every
+# tool call (name + input + output), prompts, session lifecycle, and which
+# files it read (e.g. the write-e2e-test skill). Layer above UNOTEST_DEBUG's
+# app-under-test artifacts — this one sees the agent's host-side actions
+# that the MCP server never observes.
+#
+# Opt-in: no-op unless UNOTEST_DEBUG is set. Never blocks the agent — always
+# exits 0 (only exit 2 would block). Reasoning/thinking is NOT capturable by
+# hooks; this records tool I/O + prompts + lifecycle only.
+#
+# Arg $1: absolute path to the JSONL log file.
+
+[ "$UNOTEST_DEBUG" = "1" ] || [ "$UNOTEST_DEBUG" = "full" ] || [ "$UNOTEST_DEBUG" = "summary" ] || exit 0
+
+out="$1"
+[ -n "$out" ] || exit 0
+mkdir -p "$(dirname "$out")" 2>/dev/null
+cat >> "$out"
+printf '\n' >> "$out"
+exit 0

package/.claude/skills/{write-e2e-test.md → write-e2e-test/SKILL.md}

@@ -6,8 +6,10 @@ description: Write a new E2E test for the web application under test using @unot
 # Skill: write-e2e-test
 
 You are writing an end-to-end test using `@unotest/web` against a web
-app. The test lives in `unotest/e2e/<name>.js` in the project under
-test (NOT in the `@unotest/web` package itself).
+app. The test lives in `unotest/e2e/<feature>/<name>.js` in the project
+under test (NOT in the `@unotest/web` package itself). Scenarios are
+grouped by feature/page in subfolders — never placed directly in the
+`unotest/e2e/` root (the linter rejects that with `lint:scenario-in-root`).
 
 **Default mode is verify-against-live-app.** A test that hasn't been
 run is unverified — selectors may be invented, transitions may race,
@@ -53,7 +55,7 @@ Then move to Phase 1. Three files in, exploration done.
 
 ```
 new_context { }                                  → { ok, url: "about:blank" }
-explore_start { scenario_name: "<flow-name>" }   → { explorationId }
+explore_start { scenario_name: "<feature>/<name>" } → { explorationId }
 ```
 
 Keep the `explorationId` — every recorded step needs it.
@@ -81,30 +83,33 @@ For each page state you traverse:
 1. **Discover** — `get_page_snapshot { }`. Default outline format:
 
    ```
-   on_screen:
+   regions:
      navigation:
        - link "Sets 21,414 items" [e3]
        - link "Themes" [e4]
      main:
        - heading "Browse the catalog" [e5]
        - button "Sign in" [e6]
-   off_screen:
-     bottom:
+     contentinfo (below):
        - link "Help" [e21]
    _meta:
+     totalActions: 7  totalRegions: 3
+     regions: 2 in, 0 above, 1 below, 0 partial
      viewport: 1280x720
-     totalNodes: 142
+     mode: outline
    ```
 
-   Line grammar: `- [role] ["name"] [#testId] [eN]`. The `[eN]` ref
-   is what you'll pass back — refs are **wire-only**, never typed into
-   the saved test. Sections (navigation / main / dialog / form / cmp /
-   overlay) group related elements.
+   Line grammar: `- {role} {"name"} {#testId} {[clickable]} {[state]} [eN]`.
+   The `[eN]` ref is what you'll pass back — refs are **wire-only**, never
+   typed into the saved test. Top-level keys are landmark `regions`
+   (navigation / main / contentinfo / form / region / …) in reading order.
 
-   `off_screen` lists items past the viewport — they exist in the DOM
-   but aren't visible. Scroll first (`explore_step { action:
-   "scroll_into_view", locator: {kind:"locator", steps:[{kind:"ref", ref:"e21"}]} }`),
-   then re-snapshot.
+   A region wholly or partly past the viewport carries an inline tag after
+   its heading — `(above)` / `(below)` / `(partial)`; a fully-in-view region
+   has none. There is NO separate off-screen block. To reach an action in a
+   `(below)` region, scroll first (`explore_step { action: "scroll_into_view",
+   locator: {kind:"locator", steps:[{kind:"ref", ref:"e21"}]} }`), then
+   re-snapshot.
 
 2. **Act + record — pass the `[eN]` ref locator.**
 
@@ -196,10 +201,12 @@ Read the warnings before saving:
 Then persist:
 
 ```
-save_exploration_as_test { explorationId, scenarioName: "<name>" }
+save_exploration_as_test { explorationId, scenarioName: "<feature>/<name>" }
 ```
 
-Writes `unotest/e2e/<name>.js`. File exists? Pass `overwrite: true`.
+Writes `unotest/e2e/<feature>/<name>.js`. `scenarioName` MUST include a
+feature subfolder (e.g. `auth/login`) — a bare name is rejected. File
+exists? Pass `overwrite: true`.
 
 ### Phase 5 — reset state, then run_test
 
@@ -513,7 +520,7 @@ npx @unotest/web lint
 The linter runs two passes:
 
 1. **Validator** (`validator:unknown-function`, `validator:dsl`) —
-   `error` severity, gates `pnpm verify`. Catches unknown function
+   `error` severity (fails `npx @unotest/web lint`). Catches unknown function
    names (`css`, typos), wrong arg kinds, malformed `for`/`if`
    shapes. **If you see `validator:unknown-function`, you invented
    a function name** — re-read the DSL cheat-sheet above and use the

package/CHANGELOG.md

@@ -5,6 +5,75 @@ All notable changes to `@unotest/web` are documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.6.2] - 2026-06-05
+
+### Added
+
+- **MCP server `instructions`.** The server now ships start-of-session
+  `instructions` (injected by the MCP host into the agent's context the
+  moment the server is approved), pointing the agent at the
+  `write-e2e-test` skill and the canonical MCP tools before it
+  free-researches the repo.
+- **`init` writes/merges Claude Code config.** `init` now copies the
+  `write-e2e-test` skill as a real skill **directory**
+  (`.claude/skills/write-e2e-test/SKILL.md`, so `/write-e2e-test` and
+  auto-invoke work) plus an agent-trace hook (`.claude/hooks/log-agent.sh`,
+  a no-op unless `UNOTEST_DEBUG` is set), and merges managed blocks into
+  the consumer's `CLAUDE.md` and `.claude/settings.json` (pre-approve MCP
+  tools, register the trace hook) without clobbering user content.
+
+### Changed
+
+- CLI help uses `examples/01-smoke` as the `e2e` example (runnable example
+  scenarios live under `unotest/e2e/examples/`).
+
+### Added
+
+- **External variables and secrets.** Scenarios reference external values
+  by bare `UPPER_SNAKE` identifiers (`APP_BASE_URL`, `TEST_USER_EMAIL`)
+  instead of hard-coding them. Non-secret values live in `unotest/.env`,
+  secrets in `unotest/.secrets` (gitignored); both are created by `init`
+  and loaded fresh on every run. Secret values are masked as
+  `‹secret:NAME›` in logs, debug output, and recorded artifacts, so they
+  never reach a saved file in plaintext.
+- **Reusable flows.** Recorded exploration steps can be tagged with a
+  `flow` group and extracted on save into a `flow_<name>()` helper under
+  `unotest/e2e/_helpers/`; the generated test calls the helper instead of
+  inlining the steps. The new `explore_run_flow` MCP tool replays an
+  existing `flow_*` helper without re-recording it, and `explore_start`
+  now surfaces the available flows and the declared variable names.
+- **Run source snapshot.** Each run writes a `sources.json` (the entry
+  scenario plus every loaded helper as they were when the run began), so a
+  run always renders against the code that actually executed even if the
+  file is edited afterward. (Consumes `@unotest/protocol`'s `RunSources`.)
+- **New scenario linter rules:** `scenario-in-root` (scenarios must live in
+  a feature subfolder) and `mustache-in-dsl` (flags `{{NAME}}` template
+  syntax inside DSL string literals).
+
+### Changed (BREAKING)
+
+- **Scenarios must live in a feature subfolder.** A scenario placed
+  directly in `unotest/e2e/` is now rejected by the linter — use
+  `unotest/e2e/<feature>/<name>.js` (the `e2e/` root is reserved for
+  `_helpers/`). The MCP `scenarioName` argument (`explore_start` /
+  `save_exploration_as_test`) likewise requires `<feature>/<name>` form,
+  and `init` scaffolds the welcome smoke test at
+  `unotest/e2e/welcome/smoke.js`.
+- **`{{NAME}}` inside a DSL string literal is now a lint error.** That form
+  is only for MCP recorded values; in scenario code, reference a variable
+  as a bare identifier (`fill(loc, PASSWORD)`).
+
+### Fixed
+
+- **Windows: path handling.** Run-artifact paths (entry, `sources.json`
+  keys, step `file` events) are normalized to project-relative posix, so
+  the viewer's asset allowlist and source mapping match on Windows — a
+  native `\` previously broke them.
+- **Actionable error when no browser is installed.** Playwright launch now
+  preflights the browser binary and fails with a clear message hinting
+  `npx @unotest/web install-chromium`, instead of a raw stack trace; launch
+  failures are printed to the console instead of exiting silently.
+
 ## [0.5.0] - 2026-05-29
 
 ### Added

package/README.md

@@ -9,80 +9,80 @@ structured failure bundles.
 
 ---
 
-## 1. Setup (once)
-
-Works in any project — Node, Django, Rails, Go, anything. No `package.json`
-required; everything runs through `npx`.
+## 1. Setup
 
 ```sh
-npx @unotest/web@latest init          # writes config, starter scenario, and .mcp.json
-npx @unotest/web install-chromium     # skip if you picked system Chrome during init
+npx @unotest/web@latest init
 ```
 
-`init` is idempotent — it never overwrites your edits.
-
-## 2. Connect your agent
+Run once in your project — any stack (Node, Django, Rails, Go, …), no
+`package.json` required. `init` writes the config and a starter scenario,
+sets up the browser (bundled Chromium, or your system Chrome if you pick it
+during the prompt), and wires the MCP config so Claude Code / Cursor / Codex
+pick the server up automatically. Re-run anytime to update — it never
+overwrites your edits.
 
-`init` already wrote `.mcp.json` for you, **pinned to the version that ran
-it** so the MCP server never drifts. Most clients (Claude Code, Cursor, …)
-pick it up automatically. The entry it writes looks like:
+## 2. Open the viewer
 
-```json
-{
-  "mcpServers": {
-    "unotest-web": { "command": "npx", "args": ["-y", "@unotest/web@0.5.0", "mcp"] }
-  }
-}
+```sh
+npx @unotest/web viewer
 ```
 
-Re-run `npx @unotest/web@latest init` to bump the pin. That's it — your
-agent now has the tools to explore your app and write tests.
-
-## 3. Create a test — just ask
+A local IDE-style UI for your tests — no cloud, no account. This is your
+home base: browse scenarios, run them, and watch each step live. (Details
+in §5.)
 
-In your AI editor, point it at a running app and describe the flow in
-plain English:
+## 3. Create a test — just ask your agent
 
-> **"Write an e2e test: log in as a demo user, open the first project,
-> and check the dashboard shows today's date."**
+In your AI editor (Claude Code, Codex, Cursor, …), open your project and
+describe the flow in plain English:
 
-The agent then, through the MCP server:
+> **"Open https://playground.unotest.com, go to the _Click vs Double-click_
+> section, click the _Click me_ button, and check that a popup appears."**
 
-1. **Explores your live app** (`explore_step` / `explore_record`) —
-   clicks, fills, navigates — and watches the real DOM via semantic
-   snapshots.
-2. **Writes the scenario** to `unotest/e2e/<name>.js`, picking stable
-   selectors (`getByTestId` → `getByRole` → … — never brittle CSS).
-3. **Runs it** (`run_test`) and, if it fails, **debugs itself** — reads
-   the paused browser state, the failure bundle, and console, then edits
-   and re-runs.
+Through the MCP server the agent explores your live app — clicking,
+filling, reading the real DOM via semantic snapshots — then writes a clean
+scenario to `unotest/e2e/<name>.js` with stable selectors (`getByTestId` →
+`getByRole` → … — never brittle CSS), runs it, and debugs itself if it
+fails. You get a reviewable `.js` test: read it, tweak it, commit it.
 
-You get a clean, reviewable `.js` test. You read it, tweak if you want,
-and commit. No hand-written selectors, no flaky waits.
+> For best results, point the agent at its authoring guide, shipped with
+> the package at `node_modules/@unotest/web/guides/agent-integration.md`.
 
-> Give the agent its authoring guide for best results — see
-> [agent-integration.md](https://github.com/unotest/web/blob/main/docs/manuals/agent-integration.md).
+## 4. Run a test
 
-## 4. Run your tests
+Click any scenario in the viewer, or run from the CLI:
 
 ```sh
-npx @unotest/web e2e <name>           # one scenario
-npx @unotest/web e2e                  # see usage / list
+npx @unotest/web e2e <name>      # one scenario
+npx @unotest/web e2e             # list / usage
 ```
 
-Steps are grouped under `//@collapse("...")` blocks. The title says **what**
-the group does in plain English; the steps inside are **how**. This isn't
-decoration — it's the intent your agent reads back to repair a step when a
-selector drifts, and it's how the viewer and block-editor fold a scenario
-into readable sections. Every step lives inside a block:
+## 5. Watch it run — the viewer
+
+`npx @unotest/web viewer` opens a local UI (no cloud, no account):
+
+- **Scenario tree** — scenarios, collections, helpers, and run history.
+- **Run from the UI** — results stream live over WebSocket as steps execute.
+- **Block view** — each `//@collapse` group folds into a section with
+  per-step status; a failure pins an error card to the offending line.
+- **Step debugger** — set gutter breakpoints, run paused, inspect the live
+  DOM at each stop.
+- **Inspector** — screenshots and failure artifacts per run.
+- **Integrated terminal** — a docked xterm (toggle `` ⌃` ``) to drive the
+  CLI without leaving the window.
+
+### Writing by hand (optional)
+
+Scenarios are plain `.js`. Every executable step sits inside a
+`//@collapse("what this does")` block — plain-English intent the agent reads
+back to repair a step when a selector drifts:
 
 ```js
 function test_login() {
-  //@collapse("Log in as demo user")
+  //@collapse("Log in as the demo user")
   goto('https://app.example.com');
-  click(getByRole('button', { name: /sign in/i }));
   fill(getByLabel('Email'), 'demo@example.com');
-  fill(getByLabel('Password'), 'demo');
   click(getByRole('button', { name: 'Continue' }));
   //@endcollapse
 
@@ -92,32 +92,8 @@ function test_login() {
 }
 ```
 
-## 5. Watch it run — the viewer
-
-```sh
-npx @unotest/web viewer
-```
-
-A local IDE-style UI for your test runs (no cloud, no account):
-
-- **Scenario tree** — browse scenarios, collections, helpers, and run history.
-- **Run from the UI** — launch any scenario or collection; results stream
-  live over WebSocket as steps execute.
-- **Block view** — each `//@collapse` group rendered as a foldable section
-  with per-step status; failures pin an error card to the offending line.
-- **Step debugger** — set breakpoints in the gutter, run paused, and
-  inspect the live DOM at each stop.
-- **Inspector** — screenshots and failure artifacts per run.
-- **Integrated terminal** — a docked xterm (toggle with `` ⌃` ``) to drive
-  the CLI without leaving the window.
-- **Source ↔ block** — switch between the raw `.js` and the block view.
-
----
-
-## Writing by hand (optional)
-
-Scenarios are plain `.js`. The DSL uses the familiar modern
-browser-automation vocabulary, so it reads the way you already expect:
+The DSL uses the familiar modern browser-automation vocabulary, so it reads
+the way you already expect:
 
 - **Navigation** — `goto`, `reload`, `waitForUrl`
 - **Locators** — `getByRole`, `getByTestId`, `getByLabel`, `getByText`, `getByPlaceholder`, `locator`
@@ -125,21 +101,20 @@ browser-automation vocabulary, so it reads the way you already expect:
 - **Assertions** — `assertText`, `assertUrl`, `assertVisible`, `assertChecked`, `expect`
 - **Setup** — `dbQuery`, `dbExec`, `apiCall`, `shell`, `evaluate`
 
-Full reference: [`dsl-reference.md`](https://github.com/unotest/web/blob/main/docs/dsl-reference.md).
-
-## Browser support
+Full reference, shipped with the package:
+`node_modules/@unotest/web/guides/dsl-reference.md` (plus operational guides
+alongside it in `guides/`).
 
-Chromium — use your system Chrome, or a bundled build via
-`npx @unotest/web install-chromium`.
+---
 
 ## Ecosystem
 
 | Package | Role |
 |---|---|
 | `@unotest/web` | this package — CLI / MCP server / runner |
-| [`@unotest/viewer`](https://github.com/unotest/viewer) | local results browser |
-| [`@unotest/protocol`](https://github.com/unotest/protocol) | shared types |
-| [`@unotest/dsl`](https://github.com/unotest/dsl) | scenario parser + validator engine |
+| [`@unotest/viewer`](https://www.npmjs.com/package/@unotest/viewer) | local results browser |
+| [`@unotest/protocol`](https://www.npmjs.com/package/@unotest/protocol) | shared types |
+| [`@unotest/dsl`](https://www.npmjs.com/package/@unotest/dsl) | scenario parser + validator engine |
 
 ## License
 

package/bin/unotest-web.js

@@ -17,43 +17,21 @@
 
 import { spawn } from "node:child_process";
 import { fileURLToPath, pathToFileURL } from "node:url";
-import { dirname, resolve, join } from "node:path";
+import { dirname, resolve } from "node:path";
 import { createRequire } from "node:module";
-import { existsSync, readFileSync } from "node:fs";
+import { existsSync } from "node:fs";
 
 const here = dirname(fileURLToPath(import.meta.url));
 const root = resolve(here, "..");
 
-// Load <cwd>/unotest/.env into process.env before anything else (MCP server
-// and CLI both reach buildLaunchOpts / config / db drivers via process.env).
-// Existing process.env wins — values from `.mcp.json` env or the user's
-// shell override the file. Format: KEY=VALUE per line, `#` comments,
-// surrounding single/double quotes stripped if balanced.
-function loadUnotestEnv() {
-  const path = join(process.cwd(), "unotest", ".env");
-  if (!existsSync(path)) return;
-  let raw;
-  try { raw = readFileSync(path, "utf8"); } catch { return; }
-  for (const line of raw.split(/\r?\n/)) {
-    const trimmed = line.trim();
-    if (trimmed === "" || trimmed.startsWith("#")) continue;
-    const eq = trimmed.indexOf("=");
-    if (eq <= 0) continue;
-    const key = trimmed.slice(0, eq).trim();
-    if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(key)) continue;
-    if (process.env[key] !== undefined) continue;
-    let value = trimmed.slice(eq + 1).trim();
-    if (value.length >= 2) {
-      const first = value[0];
-      const last = value[value.length - 1];
-      if ((first === '"' || first === "'") && first === last) {
-        value = value.slice(1, -1);
-      }
-    }
-    process.env[key] = value;
-  }
-}
-loadUnotestEnv();
+// NOTE: `unotest/.env` is intentionally NOT loaded here. The dispatcher runs
+// in every process — including the long-lived `viewer` launcher — and
+// flattening `.env` into a launcher's process.env freezes a boot snapshot
+// that spawned runs would inherit, so UI edits to `.env` wouldn't apply
+// until the launcher restarted. Instead, `loadConfig()` flattens `.env` per
+// run-process via `applyEnvFile`; the viewer never loads config, so each
+// scenario run it spawns is a fresh process that reads the current file.
+// See src/config/env-file.ts.
 
 // Resolve tsx CLI binary from @unotest/web's own node_modules. tsx CLI
 // (`tsx/cli` export → dist/cli.mjs) handles both legacy and modern Node

package/dist/config/schema.d.ts

@@ -90,19 +90,19 @@ declare const FailureBundleConfigSchema: z.ZodObject<{
 type FailureBundleConfig = z.infer<typeof FailureBundleConfigSchema>;
 declare const DialogPolicySchema: z.ZodEnum<["accept", "dismiss", "manual"]>;
 type DialogPolicy = z.infer<typeof DialogPolicySchema>;
-declare const LinterRuleIdSchema: z.ZodEnum<["lint:deep-css", "lint:xpath", "lint:obfuscated-class", "lint:pause-explicit", "lint:disambig-by-index", "lint:evaluate-discouraged", "validator:unknown-function", "validator:dsl"]>;
+declare const LinterRuleIdSchema: z.ZodEnum<["lint:deep-css", "lint:xpath", "lint:obfuscated-class", "lint:pause-explicit", "lint:disambig-by-index", "lint:evaluate-discouraged", "lint:scenario-in-root", "lint:mustache-in-dsl", "validator:unknown-function", "validator:dsl"]>;
 type LinterRuleId = z.infer<typeof LinterRuleIdSchema>;
 declare const LinterSeveritySchema: z.ZodEnum<["off", "warn", "error"]>;
 type LinterSeverity = z.infer<typeof LinterSeveritySchema>;
 declare const LinterConfigSchema: z.ZodObject<{
     enabled: z.ZodBoolean;
-    rules: z.ZodRecord<z.ZodEnum<["lint:deep-css", "lint:xpath", "lint:obfuscated-class", "lint:pause-explicit", "lint:disambig-by-index", "lint:evaluate-discouraged", "validator:unknown-function", "validator:dsl"]>, z.ZodEnum<["off", "warn", "error"]>>;
+    rules: z.ZodRecord<z.ZodEnum<["lint:deep-css", "lint:xpath", "lint:obfuscated-class", "lint:pause-explicit", "lint:disambig-by-index", "lint:evaluate-discouraged", "lint:scenario-in-root", "lint:mustache-in-dsl", "validator:unknown-function", "validator:dsl"]>, z.ZodEnum<["off", "warn", "error"]>>;
 }, "strip", z.ZodTypeAny, {
     enabled: boolean;
-    rules: Partial<Record<"lint:deep-css" | "lint:xpath" | "lint:obfuscated-class" | "lint:pause-explicit" | "lint:disambig-by-index" | "lint:evaluate-discouraged" | "validator:unknown-function" | "validator:dsl", "off" | "warn" | "error">>;
+    rules: Partial<Record<"lint:deep-css" | "lint:xpath" | "lint:obfuscated-class" | "lint:pause-explicit" | "lint:disambig-by-index" | "lint:evaluate-discouraged" | "lint:scenario-in-root" | "lint:mustache-in-dsl" | "validator:unknown-function" | "validator:dsl", "off" | "warn" | "error">>;
 }, {
     enabled: boolean;
-    rules: Partial<Record<"lint:deep-css" | "lint:xpath" | "lint:obfuscated-class" | "lint:pause-explicit" | "lint:disambig-by-index" | "lint:evaluate-discouraged" | "validator:unknown-function" | "validator:dsl", "off" | "warn" | "error">>;
+    rules: Partial<Record<"lint:deep-css" | "lint:xpath" | "lint:obfuscated-class" | "lint:pause-explicit" | "lint:disambig-by-index" | "lint:evaluate-discouraged" | "lint:scenario-in-root" | "lint:mustache-in-dsl" | "validator:unknown-function" | "validator:dsl", "off" | "warn" | "error">>;
 }>;
 type LinterConfig = z.infer<typeof LinterConfigSchema>;
 declare const McpConfigSchema: z.ZodObject<{
@@ -228,13 +228,13 @@ declare const UnotestConfigSchema: z.ZodObject<{
     defaultNavigationTimeoutMs: z.ZodNumber;
     linter: z.ZodObject<{
         enabled: z.ZodBoolean;
-        rules: z.ZodRecord<z.ZodEnum<["lint:deep-css", "lint:xpath", "lint:obfuscated-class", "lint:pause-explicit", "lint:disambig-by-index", "lint:evaluate-discouraged", "validator:unknown-function", "validator:dsl"]>, z.ZodEnum<["off", "warn", "error"]>>;
+        rules: z.ZodRecord<z.ZodEnum<["lint:deep-css", "lint:xpath", "lint:obfuscated-class", "lint:pause-explicit", "lint:disambig-by-index", "lint:evaluate-discouraged", "lint:scenario-in-root", "lint:mustache-in-dsl", "validator:unknown-function", "validator:dsl"]>, z.ZodEnum<["off", "warn", "error"]>>;
     }, "strip", z.ZodTypeAny, {
         enabled: boolean;
-        rules: Partial<Record<"lint:deep-css" | "lint:xpath" | "lint:obfuscated-class" | "lint:pause-explicit" | "lint:disambig-by-index" | "lint:evaluate-discouraged" | "validator:unknown-function" | "validator:dsl", "off" | "warn" | "error">>;
+        rules: Partial<Record<"lint:deep-css" | "lint:xpath" | "lint:obfuscated-class" | "lint:pause-explicit" | "lint:disambig-by-index" | "lint:evaluate-discouraged" | "lint:scenario-in-root" | "lint:mustache-in-dsl" | "validator:unknown-function" | "validator:dsl", "off" | "warn" | "error">>;
     }, {
         enabled: boolean;
-        rules: Partial<Record<"lint:deep-css" | "lint:xpath" | "lint:obfuscated-class" | "lint:pause-explicit" | "lint:disambig-by-index" | "lint:evaluate-discouraged" | "validator:unknown-function" | "validator:dsl", "off" | "warn" | "error">>;
+        rules: Partial<Record<"lint:deep-css" | "lint:xpath" | "lint:obfuscated-class" | "lint:pause-explicit" | "lint:disambig-by-index" | "lint:evaluate-discouraged" | "lint:scenario-in-root" | "lint:mustache-in-dsl" | "validator:unknown-function" | "validator:dsl", "off" | "warn" | "error">>;
     }>;
     mcp: z.ZodObject<{
         transport: z.ZodLiteral<"stdio">;
@@ -292,7 +292,7 @@ declare const UnotestConfigSchema: z.ZodObject<{
     defaultNavigationTimeoutMs: number;
     linter: {
         enabled: boolean;
-        rules: Partial<Record<"lint:deep-css" | "lint:xpath" | "lint:obfuscated-class" | "lint:pause-explicit" | "lint:disambig-by-index" | "lint:evaluate-discouraged" | "validator:unknown-function" | "validator:dsl", "off" | "warn" | "error">>;
+        rules: Partial<Record<"lint:deep-css" | "lint:xpath" | "lint:obfuscated-class" | "lint:pause-explicit" | "lint:disambig-by-index" | "lint:evaluate-discouraged" | "lint:scenario-in-root" | "lint:mustache-in-dsl" | "validator:unknown-function" | "validator:dsl", "off" | "warn" | "error">>;
     };
     mcp: {
         transport: "stdio";
@@ -335,7 +335,7 @@ declare const UnotestConfigSchema: z.ZodObject<{
     defaultNavigationTimeoutMs: number;
     linter: {
         enabled: boolean;
-        rules: Partial<Record<"lint:deep-css" | "lint:xpath" | "lint:obfuscated-class" | "lint:pause-explicit" | "lint:disambig-by-index" | "lint:evaluate-discouraged" | "validator:unknown-function" | "validator:dsl", "off" | "warn" | "error">>;
+        rules: Partial<Record<"lint:deep-css" | "lint:xpath" | "lint:obfuscated-class" | "lint:pause-explicit" | "lint:disambig-by-index" | "lint:evaluate-discouraged" | "lint:scenario-in-root" | "lint:mustache-in-dsl" | "validator:unknown-function" | "validator:dsl", "off" | "warn" | "error">>;
     };
     mcp: {
         transport: "stdio";

package/dist/config/schema.js

@@ -1 +1 @@
-var _0x13b842=_0x5c89;function _0xdd09(){var _0x5e35ee=['mte0mdu3m1D1qvHbvG','C3rYAw5N','Dw5VDgvZDc9LmMu','DxjS','mtiWnte3mgXgtwTPsq','CMvJB3jK','B2jQzwn0','og51D0rnAq','y3jHC2G','zxjYB3i','zgLZBwLZCW','Bwf4','D2vIA2L0','yM9VBgvHBG','DMfSAwrHDg9YoMrZBa','BNvTyMvY','BgLUDdP4Cgf0Aa','C3rKAw8','nda2ota3mwPkrfvnza','D2fYBG','y2HYB21LlwjLDge','y2HYB21L','B3b0Aw9UywW','BwLU','yxjYyxK','mtGZndnut05hBwm','BNvSBa','mti4mtu3r2L4B1rK','BgLUDdPKAxnHBwjPzY1IEs1PBMrLEa','Aw50','BxnLzgDL','Dw5VDgvZDc9LmMuVx2HLBhbLCNm','odCYmty5mhn6tKX6qW','DhjHBNnPzw50','BgL0zxjHBa','Cg9ZAxrPDMu','Dw5PB24','mti2odaZmtbvvxP6Exe','zw51Bq','y2HYB21PDw0','BgLUDdPVyMz1C2nHDgvKlwnSyxnZ','ywnJzxb0','zMLYzwzVEa','B2zM','zgvMyxvSDa','mJj1CwzxvLG','lNvUB3rLC3qVzMfPBhvYzxm','BMv0D29YAW','mtqWv2jAt3zn'];_0xdd09=function(){return _0x5e35ee;};return _0xdd09();}(function(_0x21391e,_0x290be0){var _0x3fe06b={_0x580772:0x1ee},_0x2523e1=_0x5c89,_0x24948d=_0x21391e();while(!![]){try{var _0x13f503=-parseInt(_0x2523e1(0x1f5))/0x1*(-parseInt(_0x2523e1(0x209))/0x2)+-parseInt(_0x2523e1(0x1f7))/0x3*(parseInt(_0x2523e1(0x20c))/0x4)+-parseInt(_0x2523e1(0x211))/0x5+parseInt(_0x2523e1(0x1fc))/0x6+parseInt(_0x2523e1(0x20d))/0x7+parseInt(_0x2523e1(0x214))/0x8*(-parseInt(_0x2523e1(_0x3fe06b._0x580772))/0x9)+parseInt(_0x2523e1(0x201))/0xa;if(_0x13f503===_0x290be0)break;else _0x24948d['push'](_0x24948d['shift']());}catch(_0x579fa0){_0x24948d['push'](_0x24948d['shift']());}}}(_0xdd09,0xdb3f8));import{z}from'zod';function _0x5c89(_0x13dc6a,_0x2e4bdd){_0x13dc6a=_0x13dc6a-0x1ea;var _0xdd09ee=_0xdd09();var _0x5c8924=_0xdd09ee[_0x13dc6a];if(_0x5c89['gBJOUl']===undefined){var _0x154e3c=function(_0x59b266){var _0x217219='abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789+/=';var _0x54907f='',_0x350b77='';for(var _0x7ff67b=0x0,_0x294a3c,_0x5646bb,_0x34038e=0x0;_0x5646bb=_0x59b266['charAt'](_0x34038e++);~_0x5646bb&&(_0x294a3c=_0x7ff67b%0x4?_0x294a3c*0x40+_0x5646bb:_0x5646bb,_0x7ff67b++%0x4)?_0x54907f+=String['fromCharCode'](0xff&_0x294a3c>>(-0x2*_0x7ff67b&0x6)):0x0){_0x5646bb=_0x217219['indexOf'](_0x5646bb);}for(var _0x23afbd=0x0,_0x3f5513=_0x54907f['length'];_0x23afbd<_0x3f5513;_0x23afbd++){_0x350b77+='%'+('00'+_0x54907f['charCodeAt'](_0x23afbd)['toString'](0x10))['slice'](-0x2);}return decodeURIComponent(_0x350b77);};_0x5c89['yWsZuA']=_0x154e3c,_0x5c89['dCxQZg']={},_0x5c89['gBJOUl']=!![];}var _0x3c3e52=_0xdd09ee[0x0],_0x1f40d4=_0x13dc6a+_0x3c3e52,_0x504fd8=_0x5c89['dCxQZg'][_0x1f40d4];return!_0x504fd8?(_0x5c8924=_0x5c89['yWsZuA'](_0x5c8924),_0x5c89['dCxQZg'][_0x1f40d4]=_0x5c8924):_0x5c8924=_0x504fd8,_0x5c8924;}var BrowserSchema=z[_0x13b842(0x202)]([_0x13b842(0x203),_0x13b842(0x206),_0x13b842(0x219)]),BrowserChannelSchema=z[_0x13b842(0x200)]([z[_0x13b842(0x1fe)](_0x13b842(0x1f1)),z[_0x13b842(0x1fe)](_0x13b842(0x1fa)),z[_0x13b842(0x1fe)](_0x13b842(0x1f0)),z[_0x13b842(0x1f6)]()])['optional'](),ViewportSchema=z[_0x13b842(0x213)]({'width':z['number']()[_0x13b842(0x1f9)]()[_0x13b842(0x1ff)](),'height':z['number']()[_0x13b842(0x1f9)]()[_0x13b842(0x1ff)]()}),RetryReasonSchema=z['enum']([_0x13b842(0x1fd),_0x13b842(0x20b),_0x13b842(0x215)]),RetryConfigSchema=z['object']({'count':z[_0x13b842(0x1eb)]()[_0x13b842(0x1f9)]()[_0x13b842(0x1f3)](0x0)[_0x13b842(0x218)](0xa),'on':z[_0x13b842(0x1f4)](RetryReasonSchema)}),FailureBundleConfigSchema=z[_0x13b842(0x213)]({'tier1':z[_0x13b842(0x1fe)](!![])[_0x13b842(0x208)](!![]),'tier2':z[_0x13b842(0x21a)](),'tier3':z['object']({'network':z[_0x13b842(0x21a)](),'video':z[_0x13b842(0x21a)]()}),'retention':z['object']({'runs':z[_0x13b842(0x1eb)]()[_0x13b842(0x1f9)]()[_0x13b842(0x1ff)](),'days':z[_0x13b842(0x1eb)]()[_0x13b842(0x1f9)]()[_0x13b842(0x1ff)]()}),'storageDir':z[_0x13b842(0x20e)]()['min'](0x1)}),DialogPolicySchema=z['enum']([_0x13b842(0x205),_0x13b842(0x217),'manual']),LinterRuleIdSchema=z['enum'](['lint:deep-css',_0x13b842(0x1ec),_0x13b842(0x204),'lint:pause-explicit',_0x13b842(0x1f8),'lint:evaluate-discouraged','validator:unknown-function',_0x13b842(0x1ea)]),LinterSeveritySchema=z[_0x13b842(0x202)]([_0x13b842(0x207),'warn',_0x13b842(0x216)]),LinterConfigSchema=z[_0x13b842(0x213)]({'enabled':z[_0x13b842(0x21a)](),'rules':z[_0x13b842(0x212)](LinterRuleIdSchema,LinterSeveritySchema)}),McpConfigSchema=z[_0x13b842(0x213)]({'transport':z[_0x13b842(0x1fe)](_0x13b842(0x1ed))}),SandboxConfigSchema=z[_0x13b842(0x213)]({'shellCwd':z[_0x13b842(0x20e)]()['optional'](),'database':z[_0x13b842(0x20e)]()[_0x13b842(0x1f2)](),'apiBaseUrl':z[_0x13b842(0x20e)]()[_0x13b842(0x210)]()[_0x13b842(0x1f2)]()}),UnotestConfigSchema=z[_0x13b842(0x213)]({'baseUrl':z[_0x13b842(0x20e)]()[_0x13b842(0x210)]()['optional'](),'browsers':z[_0x13b842(0x1f4)](BrowserSchema)['min'](0x1),'channel':BrowserChannelSchema,'viewport':ViewportSchema,'retry':RetryConfigSchema,'failureBundle':FailureBundleConfigSchema,'dialogPolicy':DialogPolicySchema,'storageState':z['string']()[_0x13b842(0x1f2)](),'testDir':z['string']()['min'](0x1),'helpersDir':z[_0x13b842(0x20e)]()[_0x13b842(0x1f3)](0x1),'defaultTimeoutMs':z[_0x13b842(0x1eb)]()['int']()[_0x13b842(0x1ff)](),'defaultNavigationTimeoutMs':z['number']()['int']()[_0x13b842(0x1ff)](),'linter':LinterConfigSchema,'mcp':McpConfigSchema,'sandbox':SandboxConfigSchema}),DEFAULT_CONFIG={'browsers':[_0x13b842(0x203)],'viewport':{'width':0x500,'height':0x2d0},'retry':{'count':0x0,'on':[_0x13b842(0x1fd)]},'failureBundle':{'tier1':!![],'tier2':!![],'tier3':{'network':![],'video':![]},'retention':{'runs':0x14,'days':0x7},'storageDir':_0x13b842(0x20a)},'dialogPolicy':_0x13b842(0x205),'testDir':_0x13b842(0x20f),'helpersDir':_0x13b842(0x1fb),'defaultTimeoutMs':0xbb8,'defaultNavigationTimeoutMs':0x3a98,'linter':{'enabled':!![],'rules':{'lint:deep-css':'warn','lint:xpath':'warn','lint:obfuscated-class':_0x13b842(0x1ef),'lint:pause-explicit':_0x13b842(0x1ef),'lint:disambig-by-index':_0x13b842(0x207),'lint:evaluate-discouraged':_0x13b842(0x1ef),'validator:unknown-function':_0x13b842(0x216),'validator:dsl':_0x13b842(0x216)}},'mcp':{'transport':'stdio'},'sandbox':{}};export{BrowserChannelSchema,BrowserSchema,DEFAULT_CONFIG,DialogPolicySchema,FailureBundleConfigSchema,LinterConfigSchema,LinterRuleIdSchema,LinterSeveritySchema,McpConfigSchema,RetryConfigSchema,RetryReasonSchema,SandboxConfigSchema,UnotestConfigSchema,ViewportSchema};
+function _0x16c7(){var _0xb973b1=['Cg9ZAxrPDMu','CMvJB3jK','zw51Bq','C3rYAw5N','zxjYB3i','mtjMqLfpzNa','Aw50','BgL0zxjHBa','mZu4nK5xwLbkzq','mtuZmdm1yvLirMvm','mtuZA1vPqM9R','y2HYB21LlwjLDge','Dw5VDgvZDc9LmMuVx2HLBhbLCNm','B2zM','y2HYB21PDw0','zgvMyxvSDa','y3jHC2G','BNvSBa','y2HYB21L','BxnLzgDL','nZe5otCWwuL5r3HT','Dw5PB24','BNvTyMvY','D2vIA2L0','BwLU','B3b0Aw9UywW','DxjS','DMfSAwrHDg9YoNvUA25VD24TzNvUy3rPB24','mJu0nJbzBuHRqNe','D2fYBG','B2jQzwn0','zgLZBwLZCW','BgLUDdPZy2vUyxjPBY1PBI1YB290','BMv0D29YAW','mZaXC29WD2Tr','yM9VBgvHBG','BgLUDdPLDMfSDwf0zs1KAxnJB3vYywDLza','yxjYyxK','ywnJzxb0','DhjHBNnPzw50','Dw5VDgvZDc9LmMu','BwfUDwfS','mZCWodbWt3vmB1y','otC5u1f3zMH4','mJm1odGXmeXcDvPQDa','DMfSAwrHDg9YoMrZBa','BgLUDdPTDxn0ywnOzs1PBI1KC2W','otu2nhDrvKrmzW','zMLYzwzVEa'];_0x16c7=function(){return _0xb973b1;};return _0x16c7();}var _0x3893a2=_0x1f93;(function(_0x224983,_0x4ea4ba){var _0x4a0693={_0xb7d0c5:0xab,_0x5053dd:0xa8,_0x4ef3b5:0xc5,_0x33befc:0xcd},_0x80a53d=_0x1f93,_0x2a1e1b=_0x224983();while(!![]){try{var _0x5ceb66=parseInt(_0x80a53d(0xac))/0x1+-parseInt(_0x80a53d(_0x4a0693._0xb7d0c5))/0x2+parseInt(_0x80a53d(0xad))/0x3*(-parseInt(_0x80a53d(0xa1))/0x4)+parseInt(_0x80a53d(0xb7))/0x5*(parseInt(_0x80a53d(_0x4a0693._0x5053dd))/0x6)+-parseInt(_0x80a53d(_0x4a0693._0x4ef3b5))/0x7*(parseInt(_0x80a53d(_0x4a0693._0x33befc))/0x8)+parseInt(_0x80a53d(0xcf))/0x9+-parseInt(_0x80a53d(0xbf))/0xa*(parseInt(_0x80a53d(0xce))/0xb);if(_0x5ceb66===_0x4ea4ba)break;else _0x2a1e1b['push'](_0x2a1e1b['shift']());}catch(_0x5b69b7){_0x2a1e1b['push'](_0x2a1e1b['shift']());}}}(_0x16c7,0x25788));import{z}from'zod';function _0x1f93(_0x1ec1b0,_0x2c48d8){_0x1ec1b0=_0x1ec1b0-0x9f;var _0x16c79d=_0x16c7();var _0x1f9358=_0x16c79d[_0x1ec1b0];if(_0x1f93['iUYfIn']===undefined){var _0x1e2f01=function(_0x5ba337){var _0x379035='abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789+/=';var _0x5ad0e0='',_0x477573='';for(var _0x2f68f7=0x0,_0x1cbf77,_0x5c6ba6,_0x10bb37=0x0;_0x5c6ba6=_0x5ba337['charAt'](_0x10bb37++);~_0x5c6ba6&&(_0x1cbf77=_0x2f68f7%0x4?_0x1cbf77*0x40+_0x5c6ba6:_0x5c6ba6,_0x2f68f7++%0x4)?_0x5ad0e0+=String['fromCharCode'](0xff&_0x1cbf77>>(-0x2*_0x2f68f7&0x6)):0x0){_0x5c6ba6=_0x379035['indexOf'](_0x5c6ba6);}for(var _0x5865de=0x0,_0x5b87a9=_0x5ad0e0['length'];_0x5865de<_0x5b87a9;_0x5865de++){_0x477573+='%'+('00'+_0x5ad0e0['charCodeAt'](_0x5865de)['toString'](0x10))['slice'](-0x2);}return decodeURIComponent(_0x477573);};_0x1f93['UPRwyN']=_0x1e2f01,_0x1f93['fNATEj']={},_0x1f93['iUYfIn']=!![];}var _0xad7c19=_0x16c79d[0x0],_0x3792ff=_0x1ec1b0+_0xad7c19,_0x5080ef=_0x1f93['fNATEj'][_0x3792ff];return!_0x5080ef?(_0x1f9358=_0x1f93['UPRwyN'](_0x1f9358),_0x1f93['fNATEj'][_0x3792ff]=_0x1f9358):_0x1f9358=_0x5080ef,_0x1f9358;}var BrowserSchema=z[_0x3893a2(0xa5)](['chromium',_0x3893a2(0xa2),_0x3893a2(0xba)]),BrowserChannelSchema=z[_0x3893a2(0xb8)]([z['literal'](_0x3893a2(0xb5)),z[_0x3893a2(0xaa)](_0x3893a2(0xb6)),z[_0x3893a2(0xaa)](_0x3893a2(0xae)),z[_0x3893a2(0xb4)]()])[_0x3893a2(0xbc)](),ViewportSchema=z[_0x3893a2(0xc1)]({'width':z[_0x3893a2(0xb9)]()[_0x3893a2(0xa9)]()[_0x3893a2(0xa3)](),'height':z[_0x3893a2(0xb9)]()[_0x3893a2(0xa9)]()[_0x3893a2(0xa3)]()}),RetryReasonSchema=z[_0x3893a2(0xa5)]([_0x3893a2(0xca),_0x3893a2(0xc4),_0x3893a2(0xb3)]),RetryConfigSchema=z[_0x3893a2(0xc1)]({'count':z[_0x3893a2(0xb9)]()[_0x3893a2(0xa9)]()[_0x3893a2(0xbb)](0x0)['max'](0xa),'on':z['array'](RetryReasonSchema)}),FailureBundleConfigSchema=z[_0x3893a2(0xc1)]({'tier1':z['literal'](!![])[_0x3893a2(0xb2)](!![]),'tier2':z[_0x3893a2(0xc6)](),'tier3':z[_0x3893a2(0xc1)]({'network':z[_0x3893a2(0xc6)](),'video':z[_0x3893a2(0xc6)]()}),'retention':z[_0x3893a2(0xc1)]({'runs':z[_0x3893a2(0xb9)]()[_0x3893a2(0xa9)]()[_0x3893a2(0xa3)](),'days':z[_0x3893a2(0xb9)]()[_0x3893a2(0xa9)]()[_0x3893a2(0xa3)]()}),'storageDir':z[_0x3893a2(0xa6)]()['min'](0x1)}),DialogPolicySchema=z[_0x3893a2(0xa5)]([_0x3893a2(0xc9),_0x3893a2(0xc2),_0x3893a2(0xcc)]),LinterRuleIdSchema=z[_0x3893a2(0xa5)](['lint:deep-css','lint:xpath','lint:obfuscated-class','lint:pause-explicit','lint:disambig-by-index',_0x3893a2(0xc7),_0x3893a2(0xc3),_0x3893a2(0xa0),_0x3893a2(0xbe),_0x3893a2(0x9f)]),LinterSeveritySchema=z[_0x3893a2(0xa5)](['off',_0x3893a2(0xc0),'error']),LinterConfigSchema=z[_0x3893a2(0xc1)]({'enabled':z[_0x3893a2(0xc6)](),'rules':z[_0x3893a2(0xa4)](LinterRuleIdSchema,LinterSeveritySchema)}),McpConfigSchema=z['object']({'transport':z['literal']('stdio')}),SandboxConfigSchema=z[_0x3893a2(0xc1)]({'shellCwd':z[_0x3893a2(0xa6)]()['optional'](),'database':z[_0x3893a2(0xa6)]()['optional'](),'apiBaseUrl':z['string']()[_0x3893a2(0xbd)]()['optional']()}),UnotestConfigSchema=z['object']({'baseUrl':z[_0x3893a2(0xa6)]()[_0x3893a2(0xbd)]()[_0x3893a2(0xbc)](),'browsers':z[_0x3893a2(0xc8)](BrowserSchema)['min'](0x1),'channel':BrowserChannelSchema,'viewport':ViewportSchema,'retry':RetryConfigSchema,'failureBundle':FailureBundleConfigSchema,'dialogPolicy':DialogPolicySchema,'storageState':z[_0x3893a2(0xa6)]()[_0x3893a2(0xbc)](),'testDir':z[_0x3893a2(0xa6)]()['min'](0x1),'helpersDir':z[_0x3893a2(0xa6)]()[_0x3893a2(0xbb)](0x1),'defaultTimeoutMs':z[_0x3893a2(0xb9)]()[_0x3893a2(0xa9)]()[_0x3893a2(0xa3)](),'defaultNavigationTimeoutMs':z[_0x3893a2(0xb9)]()[_0x3893a2(0xa9)]()[_0x3893a2(0xa3)](),'linter':LinterConfigSchema,'mcp':McpConfigSchema,'sandbox':SandboxConfigSchema}),DEFAULT_CONFIG={'browsers':[_0x3893a2(0xb1)],'viewport':{'width':0x500,'height':0x2d0},'retry':{'count':0x0,'on':['transient']},'failureBundle':{'tier1':!![],'tier2':!![],'tier3':{'network':![],'video':![]},'retention':{'runs':0x14,'days':0x7},'storageDir':'.unotest/failures'},'dialogPolicy':_0x3893a2(0xc9),'testDir':_0x3893a2(0xcb),'helpersDir':_0x3893a2(0xaf),'defaultTimeoutMs':0xbb8,'defaultNavigationTimeoutMs':0x3a98,'linter':{'enabled':!![],'rules':{'lint:deep-css':'warn','lint:xpath':_0x3893a2(0xc0),'lint:obfuscated-class':_0x3893a2(0xc0),'lint:pause-explicit':_0x3893a2(0xc0),'lint:disambig-by-index':_0x3893a2(0xb0),'lint:evaluate-discouraged':_0x3893a2(0xc0),'lint:scenario-in-root':_0x3893a2(0xa7),'lint:mustache-in-dsl':'error','validator:unknown-function':_0x3893a2(0xa7),'validator:dsl':_0x3893a2(0xa7)}},'mcp':{'transport':'stdio'},'sandbox':{}};export{BrowserChannelSchema,BrowserSchema,DEFAULT_CONFIG,DialogPolicySchema,FailureBundleConfigSchema,LinterConfigSchema,LinterRuleIdSchema,LinterSeveritySchema,McpConfigSchema,RetryConfigSchema,RetryReasonSchema,SandboxConfigSchema,UnotestConfigSchema,ViewportSchema};