@pcamarajr/scout 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Pedro Camara Junior
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,188 @@
+# 🔭 Scout
+
+Self-healing browser QA. Scenarios written in **natural language**, verified by an **AI agent** in a real browser (Playwright), and recorded as a **deterministic script** that runs cheaply and quickly in CI — AI only kicks in when the script breaks.
+
+> Status: functional POC.
+
+## Why not just Playwright? Why not just AI?
+
+| | Pure Playwright | Pure AI | Scout (hybrid) |
+|---|---|---|---|
+| Authoring | expensive (code + selectors) | cheap (1 sentence) | cheap (1 sentence) |
+| Cost per CI run | ~zero | $$ + slow | ~zero (replay) |
+| Resilience to UI changes | breaks | adapts | breaks → AI re-verifies and re-records |
+| Judges behavior ("paywall MUST NOT appear") | only what was coded | yes | yes |
+
+**Scenario lifecycle:**
+
+```
+scout create "Paywall free" -c "Open ep 3 of series X without login; paywall should appear with signup CTA"
+        │
+        ▼
+scout go  ──── 1st run: AI agent runs in browser, judges (verified/failed/partial/blocked)
+        │       and records .scout/scripts/paywall-free.json (deterministic steps + assertions)
+        ▼
+CI / subsequent runs: pure Playwright replay, no LLM, seconds per scenario
+        │
+        ▼
+UI changed and replay broke? ── AI re-runs, re-judges, re-records the script (self-healing)
+                                (`--no-heal` disables this, e.g. in CI without API key)
+```
+
+## Quickstart
+
+```bash
+npm install @pcamarajr/scout       # or npm link during POC
+npx playwright install chromium    # browser engine
+
+scout init                         # creates scout.config.json + .scout/
+scout create "Login with Google" \
+  -c "On logged-out home, click Sign In; login page should show Google and email/password options" \
+  -p anon
+scout go                           # 1st run = AI (requires Anthropic credentials)
+scout go                           # subsequent runs = deterministic replay
+scout report                       # markdown ready to embed in PR body
+```
+
+### AI runner credentials
+
+- **Local:** if you use Claude Code, the Agent SDK reuses your machine credentials — zero config.
+- **CI/headless:** export `ANTHROPIC_API_KEY`. The SDK is self-contained (Claude Code CLI not required).
+- Deterministic replay **does not use LLM** — in CI without a key, use `scout go --no-heal` (failure becomes ❌ in the report instead of healing).
+
+## Auth profiles (storageState)
+
+Authenticated flows use sessions captured once per environment:
+
+```jsonc
+// scout.config.json
+{
+  "baseUrl": "http://localhost:3000",
+  "model": "claude-sonnet-4-6",
+  "profiles": {
+    "anon": { "description": "Logged-out session" },
+    "subscriber": { "description": "User with active subscription", "env": ["QA_SUB_EMAIL", "QA_SUB_PASSWORD"] },
+    "free-no-coins": { "description": "Free user with no coin balance" }
+  }
+}
+```
+
+```bash
+scout login subscriber   # opens headed browser, log in, press Enter → saves .scout/state/subscriber.json (gitignored)
+```
+
+In CI, generate the storageState in a setup step (login via script) or let the agent log in using `$ENV:QA_SUB_EMAIL` / `$ENV:QA_SUB_PASSWORD` — placeholders are resolved from the environment at runtime; **secrets never enter the committed script or pass through the LLM**.
+
+## Worktrees and environments
+
+Everything is relative to the project directory and the target comes from env — two worktrees run in parallel without colliding:
+
+```bash
+SCOUT_BASE_URL=http://localhost:3001 scout go     # worktree B pointing to a different port
+SCOUT_BASE_URL=https://staging.myapp.com scout go --no-heal   # against staging
+```
+
+- `.scout/scenarios.json` and `.scout/scripts/` are **committed** — the suite travels with the branch.
+- `.scout/runs/` and `.scout/state/` are **gitignored** — artifacts and sessions are per-machine.
+
+## Per-run artifacts
+
+Each run records in `.scout/runs/<timestamp>-<slug>/`:
+
+| File | What |
+|---|---|
+| `trace.zip` | Playwright trace — screenshots, DOM snapshots, network, console (`npx playwright show-trace trace.zip`) |
+| `*.png` | Evidence screenshots (captured by the agent or at the end of replay/failure) |
+| `report.md` | Verdict + reason + recorded script + evidence |
+| `result.json` | Structured result (consumable by automation) |
+| `transcript.md` | Agent reasoning (AI runs only) |
+
+## MCP — usage by coding agents (Claude Code, cloud sessions)
+
+Scout's main flow is to be called **by the agent that developed the feature**: the agent writes the scenario (in NL — never the script; the script is born from the verified execution) and triggers the verification.
+
+```jsonc
+// .mcp.json of the target project
+{
+  "mcpServers": {
+    "scout": { "command": "npx", "args": ["scout", "mcp"] }
+  }
+}
+```
+
+Exposed tools: `scout_list_scenarios`, `scout_create_scenario`, `scout_run`, `scout_report`, `scout_get_run_report`.
+
+## CI (GitHub Actions)
+
+```yaml
+qa-browser:
+  runs-on: ubuntu-latest
+  steps:
+    - uses: actions/checkout@v4
+    - uses: actions/setup-node@v4
+      with: { node-version: 24 }
+    - run: npm ci && npx playwright install --with-deps chromium
+    - run: npm run start:test-server &        # app running
+    - run: npx scout go --no-heal             # pure replay, no LLM, exit 1 on failure
+      env: { SCOUT_BASE_URL: "http://localhost:3000" }
+    - run: npx scout report >> "$GITHUB_STEP_SUMMARY"
+      if: always()
+    - uses: actions/upload-artifact@v4        # traces + screenshots in the action run
+      if: always()
+      with: { name: scout-runs, path: .scout/runs/ }
+```
+
+With heal in CI: add `ANTHROPIC_API_KEY` and switch to `npx scout go` — when the UI changes legitimately, the job re-records the script and the `.scout/scripts/` diff shows up for commit (e.g. via PR bot).
+
+## Full CLI
+
+```
+scout init                      # bootstrap in the project
+scout create <name> -c <scenario> [-p profile] [-n notes]
+scout list                      # scenarios + status + 📜 if cached script exists
+scout go [-s id|slug] [--ai] [--no-heal] [--headed]
+scout report                    # markdown suite summary
+scout login <profile>           # capture storageState in headed browser
+scout mcp                       # MCP server stdio
+```
+
+## Verdicts
+
+| | Meaning |
+|---|---|
+| ✅ `verified` | All expected behavior confirmed by assertions |
+| ❌ `failed` | Broken behavior (the reason says exactly what) |
+| ⚠️ `partial` | Partially verified |
+| 🚫 `blocked` | Couldn't reach the flow (app down, login broken) |
+
+## Architecture
+
+```
+src/
+├── cli.ts                  # commander CLI
+├── engine.ts               # orchestrates: replay → (failed?) → AI heal → re-record
+├── config.ts               # scout.config.json + env overrides
+├── store.ts                # .scout/ (scenarios, scripts, runs)
+├── report.ts               # per-run markdown + suite summary
+├── runner/
+│   ├── browser.ts          # Playwright wrapper: snapshot with refs, trace, screenshots,
+│   │                       #   ref→locator resolution (getByRole when unique, CSS fallback)
+│   ├── ai-runner.ts        # Claude Agent SDK + in-process browser tools; records steps
+│   └── script-runner.ts    # deterministic step replay
+└── mcp/server.ts           # MCP interface (stdio)
+```
+
+Design decisions:
+
+- **The agent never writes test code.** It acts in the browser; the script is recorded from actions that actually worked (`getByRole` + accessible name when unique on the page, CSS path as fallback). Eliminates hallucinated selectors.
+- **Assertions are tools.** The agent registers each expectation via `browser_assert` — that's what makes the replay a real test, not just a click macro.
+- **Trace > video.** Playwright's trace.zip gives per-action screenshots, DOM, network, and console in a single navigable artifact. Raw video stays as an optional enhancement.
+- **No server/dashboard.** State is the filesystem in the target repo; report is markdown. Pluggable into any project with `npm i` + 2 files.
+
+## Known POC limitations
+
+- Replay runs sequentially (no sharding/parallelism).
+- Snapshot covers interactive elements + text; canvas/video are verified indirectly (element presence, surrounding UI state).
+- Flows that depend on reading email are not verifiable — covers UI + redirects.
+- Heal re-records the script locally; committing the updated script is manual (intentional: script diff is reviewable).
+- Fixed mobile viewport (390×844) — multi-viewport is a simple enhancement (per-scenario variant).

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,157 @@
+#!/usr/bin/env node
+import fs from "node:fs";
+import path from "node:path";
+import readline from "node:readline";
+import { Command } from "commander";
+import { chromium } from "playwright";
+import { CONFIG_FILE, SCOUT_DIR, loadConfig } from "./config.js";
+import { runScenario } from "./engine.js";
+import { renderSummary } from "./report.js";
+import { Store } from "./store.js";
+// Rejeições fora da cadeia de await (SDK/Playwright em subprocesso) não podem
+// derrubar a suíte inteira — logar e deixar o cenário corrente falhar sozinho.
+process.on("unhandledRejection", (reason) => {
+    console.error(`\n⚠ unhandled rejection: ${reason instanceof Error ? reason.message : String(reason)}`);
+});
+const program = new Command();
+program
+    .name("scout")
+    .description("Self-healing browser QA — natural-language scenarios, deterministic replay in CI")
+    .version("0.1.0");
+program
+    .command("init")
+    .description("Creates scout.config.json and .scout/ in the current project")
+    .action(() => {
+    const store = new Store();
+    store.init();
+    const configPath = path.join(process.cwd(), CONFIG_FILE);
+    if (!fs.existsSync(configPath)) {
+        fs.writeFileSync(configPath, JSON.stringify({
+            baseUrl: "http://localhost:3000",
+            model: "claude-sonnet-4-6",
+            headless: true,
+            maxTurns: 40,
+            locale: "pt-BR",
+            profiles: {
+                anon: { description: "Logged-out session" },
+            },
+        }, null, 2) + "\n");
+        console.log(`✓ ${CONFIG_FILE} created — adjust baseUrl and profiles.`);
+    }
+    console.log(`✓ ${SCOUT_DIR}/ initialized.`);
+});
+program
+    .command("create <name>")
+    .description("Creates a verification scenario")
+    .requiredOption("-c, --scenario <text>", "Scenario in natural language: flow + expected behavior")
+    .option("-p, --profile <profile>", "Auth profile (from scout.config.json)")
+    .option("-n, --notes <notes>", "Extra notes for the agent")
+    .action((name, opts) => {
+    const store = new Store();
+    if (!store.exists()) {
+        console.error("Run `scout init` first.");
+        process.exit(1);
+    }
+    const scenario = store.addScenario({
+        name,
+        scenario: opts.scenario,
+        profile: opts.profile,
+        notes: opts.notes,
+    });
+    console.log(`✓ Scenario #${scenario.id} created: ${scenario.slug}`);
+});
+program
+    .command("list")
+    .description("Lists scenarios and status")
+    .action(() => {
+    const store = new Store();
+    for (const s of store.listScenarios()) {
+        const script = store.loadSteps(s.slug) ? "📜" : "  ";
+        console.log(`#${s.id} ${script} [${s.status.padEnd(8)}] ${s.name} (${s.profile ?? "anonymous"})`);
+    }
+});
+program
+    .command("go")
+    .description("Runs scenarios: cached script replay; AI on first run or when the script breaks")
+    .option("-s, --scenario <idOrSlug>", "Run a single scenario")
+    .option("--ai", "Force AI-driven run (re-records the script)", false)
+    .option("--no-heal", "Do not fall back to AI when replay fails (cheap CI)")
+    .option("--headed", "Visible browser (local debug)", false)
+    .action(async (opts) => {
+    const store = new Store();
+    const config = loadConfig();
+    const all = store.listScenarios();
+    const targets = opts.scenario
+        ? all.filter((s) => s.id === Number(opts.scenario) || s.slug === opts.scenario)
+        : all;
+    if (!targets.length) {
+        console.error(opts.scenario ? `Scenario "${opts.scenario}" not found.` : "No scenarios. Use `scout create`.");
+        process.exit(1);
+    }
+    let failed = 0;
+    for (const scenario of targets) {
+        process.stdout.write(`▶ #${scenario.id} ${scenario.name} ... `);
+        try {
+            const result = await runScenario(store, scenario, config, {
+                forceAi: opts.ai,
+                heal: opts.heal,
+                headed: opts.headed,
+            });
+            const icon = result.verdict === "verified" ? "✅" : result.verdict === "partial" ? "⚠️" : "❌";
+            console.log(`${icon} ${result.verdict} [${result.mode}${result.healed ? "+heal" : ""}] ${(result.durationMs / 1000).toFixed(1)}s`);
+            if (result.verdict !== "verified") {
+                console.log(`   ↳ ${result.reason}`);
+                failed++;
+            }
+            console.log(`   ↳ artifacts: ${path.relative(process.cwd(), result.runDir)}`);
+        }
+        catch (error) {
+            console.log(`💥 error: ${error instanceof Error ? error.message : error}`);
+            failed++;
+        }
+    }
+    process.exit(failed ? 1 : 0);
+});
+program
+    .command("report")
+    .description("Prints the suite summary in markdown (embeddable in PR)")
+    .action(() => {
+    const store = new Store();
+    console.log(renderSummary(store.listScenarios(), store.latestRuns()));
+});
+program
+    .command("login <profile>")
+    .description("Opens headed browser to capture a profile session (storageState)")
+    .action(async (profileName) => {
+    const config = loadConfig();
+    if (!config.profiles[profileName]) {
+        console.error(`Profile "${profileName}" does not exist in ${CONFIG_FILE}. Add it first.`);
+        process.exit(1);
+    }
+    const statePath = path.resolve(config.profiles[profileName].storageState ?? path.join(SCOUT_DIR, "state", `${profileName}.json`));
+    fs.mkdirSync(path.dirname(statePath), { recursive: true });
+    const browser = await chromium.launch({ headless: false });
+    const context = await browser.newContext({ locale: config.locale ?? "pt-BR" });
+    const page = await context.newPage();
+    await page.goto(config.baseUrl);
+    console.log(`\nLog in as "${profileName}" in the opened browser.`);
+    await new Promise((resolve) => {
+        const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+        rl.question("Press Enter when done... ", () => {
+            rl.close();
+            resolve();
+        });
+    });
+    await context.storageState({ path: statePath });
+    await browser.close();
+    console.log(`✓ Session saved to ${statePath} (gitignored).`);
+});
+program
+    .command("mcp")
+    .description("Starts the MCP server (stdio) — for Claude Code and cloud coding sessions")
+    .action(async () => {
+    const { startMcpServer } = await import("./mcp/server.js");
+    await startMcpServer();
+});
+program.parseAsync();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,31 @@
+export interface ScoutProfile {
+    /** Shown to the AI agent so it knows what kind of session this is */
+    description?: string;
+    /**
+     * Playwright storageState JSON path. Defaults to .scout/state/<name>.json
+     * (created by `scout login <name>`). Gitignored — each env captures its own.
+     */
+    storageState?: string;
+    /**
+     * Env var names the agent may reference as $ENV:NAME when filling forms
+     * (e.g. credentials for login flows). Values never reach the LLM.
+     */
+    env?: string[];
+}
+export interface ScoutConfig {
+    /** Target app. Override per worktree/CI with SCOUT_BASE_URL. */
+    baseUrl: string;
+    /** Model for AI runs. Override with SCOUT_MODEL. */
+    model: string;
+    /** Headless by default; SCOUT_HEADED=1 or --headed for local debugging. */
+    headless: boolean;
+    /** Max agent turns per AI run */
+    maxTurns: number;
+    /** Locale forced on the browser context */
+    locale?: string;
+    profiles: Record<string, ScoutProfile>;
+}
+export declare const CONFIG_FILE = "scout.config.json";
+export declare const SCOUT_DIR = ".scout";
+export declare function loadConfig(cwd?: string): ScoutConfig;
+export declare function resolveStorageState(profileName: string | undefined, config: ScoutConfig, cwd?: string): string | undefined;

package/dist/config.js

@@ -0,0 +1,47 @@
+import fs from "node:fs";
+import path from "node:path";
+export const CONFIG_FILE = "scout.config.json";
+export const SCOUT_DIR = ".scout";
+const DEFAULTS = {
+    baseUrl: "http://localhost:3000",
+    model: "claude-sonnet-4-6",
+    headless: true,
+    maxTurns: 40,
+    locale: "pt-BR",
+    profiles: {},
+};
+export function loadConfig(cwd = process.cwd()) {
+    const file = path.join(cwd, CONFIG_FILE);
+    let fromFile = {};
+    if (fs.existsSync(file)) {
+        fromFile = JSON.parse(fs.readFileSync(file, "utf8"));
+    }
+    const merged = { ...DEFAULTS, ...fromFile };
+    if (process.env.SCOUT_BASE_URL)
+        merged.baseUrl = process.env.SCOUT_BASE_URL;
+    if (process.env.SCOUT_MODEL)
+        merged.model = process.env.SCOUT_MODEL;
+    if (process.env.SCOUT_HEADED === "1")
+        merged.headless = false;
+    return merged;
+}
+export function resolveStorageState(profileName, config, cwd = process.cwd()) {
+    if (!profileName)
+        return undefined;
+    const profile = config.profiles[profileName];
+    if (!profile) {
+        throw new Error(`Profile "${profileName}" não existe no ${CONFIG_FILE}. Profiles: ${Object.keys(config.profiles).join(", ") || "(nenhum)"}`);
+    }
+    const statePath = path.resolve(cwd, profile.storageState ?? path.join(SCOUT_DIR, "state", `${profileName}.json`));
+    if (!fs.existsSync(statePath)) {
+        // Caminho explícito configurado e ausente = erro do usuário.
+        // Caminho default ausente = contexto fresh — cobre profiles logged-out
+        // e profiles que logam dentro do cenário via $ENV.
+        if (profile.storageState) {
+            throw new Error(`storageState do profile "${profileName}" não encontrado em ${statePath} (caminho configurado em ${CONFIG_FILE}). Rode: scout login ${profileName}`);
+        }
+        return undefined;
+    }
+    return statePath;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AA+B7B,MAAM,CAAC,MAAM,WAAW,GAAG,mBAAmB,CAAC;AAC/C,MAAM,CAAC,MAAM,SAAS,GAAG,QAAQ,CAAC;AAElC,MAAM,QAAQ,GAAgB;IAC5B,OAAO,EAAE,uBAAuB;IAChC,KAAK,EAAE,mBAAmB;IAC1B,QAAQ,EAAE,IAAI;IACd,QAAQ,EAAE,EAAE;IACZ,MAAM,EAAE,OAAO;IACf,QAAQ,EAAE,EAAE;CACb,CAAC;AAEF,MAAM,UAAU,UAAU,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE;IAC5C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;IACzC,IAAI,QAAQ,GAAyB,EAAE,CAAC;IACxC,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;IACvD,CAAC;IACD,MAAM,MAAM,GAAgB,EAAE,GAAG,QAAQ,EAAE,GAAG,QAAQ,EAAE,CAAC;IACzD,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc;QAAE,MAAM,CAAC,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;IAC5E,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW;QAAE,MAAM,CAAC,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;IACpE,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,KAAK,GAAG;QAAE,MAAM,CAAC,QAAQ,GAAG,KAAK,CAAC;IAC9D,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,WAA+B,EAC/B,MAAmB,EACnB,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE;IAEnB,IAAI,CAAC,WAAW;QAAE,OAAO,SAAS,CAAC;IACnC,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IAC7C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,YAAY,WAAW,mBAAmB,WAAW,eAAe,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,UAAU,EAAE,CAC5H,CAAC;IACJ,CAAC;IACD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAC5B,GAAG,EACH,OAAO,CAAC,YAAY,IAAI,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,EAAE,GAAG,WAAW,OAAO,CAAC,CAC7E,CAAC;IACF,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9B,6DAA6D;QAC7D,uEAAuE;QACvE,mDAAmD;QACnD,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CACb,4BAA4B,WAAW,uBAAuB,SAAS,4BAA4B,WAAW,wBAAwB,WAAW,EAAE,CACpJ,CAAC;QACJ,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/engine.d.ts

@@ -0,0 +1,20 @@
+import { type ScoutConfig } from "./config.js";
+import { Store } from "./store.js";
+import { describeStep } from "./runner/script-runner.js";
+import type { RunResult, Scenario } from "./types.js";
+export interface RunOptions {
+    /** Skip the cached script and force an AI run (re-record) */
+    forceAi?: boolean;
+    /** When the cached script fails, re-verify with the AI agent (default true) */
+    heal?: boolean;
+    headed?: boolean;
+}
+/**
+ * Core run logic shared by CLI and MCP server:
+ *   cached script exists?  → replay (no LLM)
+ *     → pass               → verified
+ *     → fail + heal        → AI run; if verified, re-record the script
+ *   no script / --ai       → AI run; if verified, record the script
+ */
+export declare function runScenario(store: Store, scenario: Scenario, config?: ScoutConfig, opts?: RunOptions): Promise<RunResult>;
+export { describeStep };

package/dist/engine.js

@@ -0,0 +1,139 @@
+import fs from "node:fs";
+import path from "node:path";
+import { loadConfig, resolveStorageState } from "./config.js";
+import { renderRunReport } from "./report.js";
+import { BrowserSession } from "./runner/browser.js";
+import { runWithAgent } from "./runner/ai-runner.js";
+import { describeStep, replaySteps } from "./runner/script-runner.js";
+function aiAvailable() {
+    return Boolean(process.env.ANTHROPIC_API_KEY ||
+        process.env.CLAUDE_CODE_OAUTH_TOKEN ||
+        fs.existsSync(path.join(process.env.HOME ?? "", ".claude")));
+}
+/**
+ * Core run logic shared by CLI and MCP server:
+ *   cached script exists?  → replay (no LLM)
+ *     → pass               → verified
+ *     → fail + heal        → AI run; if verified, re-record the script
+ *   no script / --ai       → AI run; if verified, record the script
+ */
+export async function runScenario(store, scenario, config = loadConfig(), opts = {}) {
+    const heal = opts.heal ?? true;
+    const startedAt = new Date().toISOString();
+    const start = Date.now();
+    const runDir = store.newRunDir(scenario.slug);
+    const storageState = resolveStorageState(scenario.profile, config);
+    const cached = opts.forceAi ? undefined : store.loadSteps(scenario.slug);
+    const launch = () => BrowserSession.launch({
+        baseUrl: config.baseUrl,
+        headless: opts.headed ? false : config.headless,
+        storageState,
+        locale: config.locale,
+        runDir,
+    });
+    let result;
+    if (cached?.length) {
+        const session = await launch();
+        const replay = await replaySteps(session, cached);
+        const trace = await session.close();
+        if (replay.passed) {
+            result = {
+                scenarioId: scenario.id,
+                slug: scenario.slug,
+                mode: "replay",
+                verdict: "verified",
+                reason: `Deterministic script passed (${cached.length} steps).`,
+                stepCount: cached.length,
+                runDir,
+                startedAt,
+                durationMs: Date.now() - start,
+                screenshots: session.screenshots,
+                trace,
+            };
+        }
+        else if (heal && aiAvailable()) {
+            // cached script broke — re-verify with the agent and re-record
+            const aiResult = await runAi(scenario, config, store, runDir, storageState, opts);
+            result = {
+                ...aiResult,
+                healed: true,
+                reason: `Cached script broke at step ${replay.failedIndex + 1} (${replay.failedStep}: ${replay.error}). Re-verified by AI: ${aiResult.reason}`,
+                startedAt,
+                durationMs: Date.now() - start,
+            };
+        }
+        else {
+            result = {
+                scenarioId: scenario.id,
+                slug: scenario.slug,
+                mode: "replay",
+                verdict: "failed",
+                reason: `Step ${replay.failedIndex + 1} failed: ${replay.failedStep} — ${replay.error}${heal ? " (AI heal unavailable: no Anthropic credentials)" : " (heal disabled)"}`,
+                stepCount: cached.length,
+                failedStep: replay.failedStep,
+                runDir,
+                startedAt,
+                durationMs: Date.now() - start,
+                screenshots: session.screenshots,
+                trace,
+            };
+        }
+    }
+    else {
+        if (!aiAvailable()) {
+            throw new Error(`Scenario "${scenario.slug}" has no recorded script and no Anthropic credentials (ANTHROPIC_API_KEY) for the initial AI run.`);
+        }
+        const aiResult = await runAi(scenario, config, store, runDir, storageState, opts);
+        result = { ...aiResult, startedAt, durationMs: Date.now() - start };
+    }
+    store.saveRunResult(result);
+    store.updateScenario(scenario.id, { status: result.verdict, lastRun: result.startedAt });
+    fs.writeFileSync(path.join(runDir, "report.md"), renderRunReport(result, scenario, store.loadSteps(scenario.slug)));
+    return result;
+}
+async function runAi(scenario, config, store, runDir, storageState, opts) {
+    const startedAt = new Date().toISOString();
+    const start = Date.now();
+    const session = await BrowserSession.launch({
+        baseUrl: config.baseUrl,
+        headless: opts.headed ? false : config.headless,
+        storageState,
+        locale: config.locale,
+        runDir,
+    });
+    let outcome;
+    try {
+        outcome = await runWithAgent(session, scenario, config);
+    }
+    finally {
+        await session.screenshot("final-state").catch(() => { });
+    }
+    const trace = await session.close();
+    fs.writeFileSync(path.join(runDir, "transcript.md"), outcome.transcript.join("\n\n---\n\n"));
+    if (outcome.verdict === "verified" && outcome.steps.length) {
+        store.saveSteps(scenario.slug, pruneSteps(outcome.steps));
+    }
+    return {
+        scenarioId: scenario.id,
+        slug: scenario.slug,
+        mode: "ai",
+        verdict: outcome.verdict,
+        reason: outcome.reason,
+        stepCount: outcome.steps.length,
+        runDir,
+        startedAt,
+        durationMs: Date.now() - start,
+        screenshots: session.screenshots,
+        trace,
+    };
+}
+/**
+ * Cleans the recorded trace before caching: drops exploratory snapshots the
+ * agent took that produced no action (they're not steps) — currently steps
+ * are only recorded on success, so this is a hook for future pruning rules.
+ */
+function pruneSteps(steps) {
+    return steps;
+}
+export { describeStep };
+//# sourceMappingURL=engine.js.map

package/dist/engine.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { loadConfig, type ScoutConfig, type ScoutProfile } from "./config.js";
+export { runScenario, type RunOptions } from "./engine.js";
+export { renderRunReport, renderSummary } from "./report.js";
+export { Store } from "./store.js";
+export type { RunResult, Scenario, Step, Target, Verdict } from "./types.js";

package/dist/index.js

@@ -0,0 +1,5 @@
+export { loadConfig } from "./config.js";
+export { runScenario } from "./engine.js";
+export { renderRunReport, renderSummary } from "./report.js";
+export { Store } from "./store.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAuC,MAAM,aAAa,CAAC;AAC9E,OAAO,EAAE,WAAW,EAAmB,MAAM,aAAa,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC"}