fast-replay 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mukhriddin Shakhriyorov
+
+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,126 @@
+# fast-replay
+
+Record a browser bug once. Verify the fix in seconds, with no model in the loop.
+
+```
+$ repro run sensor-delete-crash
+
+STEP  ACTION  ACT   WAIT   TOTAL  WHAT
+s1    fill    26ms  492ms  518ms  New sensor name textbox in the section labelled "Sensors"
+s5    click   7ms   25ms   32ms   Delete Sensor 2 button in the row containing "Sensor 2"
+s10   click   23ms  1.79s  1.81s  Generate report button
+
+✓ PASS  sensor-delete-crash — 10 steps in 2.84s
+```
+
+Repros are disposable. They live in `.repros/`, and you delete them when the bug is fixed.
+
+## Install
+
+```bash
+npm install -D fast-replay
+npx playwright install chromium
+```
+
+Node >= 20.
+
+## Use
+
+```bash
+repro record checkout-crash --url http://localhost:3000   # click the bug once
+repro run checkout-crash                                  # bug still reproduces?
+repro run checkout-crash --expect-fixed                   # did my fix work?
+repro list
+```
+
+Stop recording with **Ctrl/Cmd + Shift + X**, or just close the browser.
+
+Exit `0` on pass, `1` on fail. On failure you get the failing step, what it does in plain language, expected vs observed, and `.repros/<name>/artifacts/` with a screenshot, console tail and network log.
+
+| Flag | |
+|---|---|
+| `--expect-fixed` | pass when the bug no longer happens |
+| `--headed` | visible browser; some apps refuse headless |
+| `--storage-state <file>` / `--profile <dir>` | get past a login |
+| `--setup <cmd>` | reset state before replaying |
+| `--timeout-scale <n>` | multiply recorded waits, for a slower machine |
+
+## From a coding agent
+
+```json
+{ "mcpServers": { "replay": { "command": "npx", "args": ["repro-mcp"] } } }
+```
+
+`repro_run` returns the verdict, the failing step, console, network and **the page as an inline image** — in one call. Works with Claude Code, Codex, Gemini CLI, Cursor.
+
+## What makes it fast
+
+Replay never sleeps. Every wait is a signal the recording actually observed — a request settling, an element appearing or vanishing — so a step proceeds the instant the app reacts. Timeouts are derived from what was measured, not guessed.
+
+The recording is JSON, not generated code. It is meant to be read and hand-edited.
+
+```jsonc
+{
+  "id": "s5",
+  "action": "click",
+  "target": {
+    "candidates": ["role=button[name=\"Delete Sensor 2\"]", "[data-testid=\"sensor-row-2\"] > button"],
+    "semantic": "Delete Sensor 2 button in the row containing \"Sensor 2\""
+  },
+  "waitAfter": {
+    "network": [{ "urlPattern": "/api/sensors/*", "method": "DELETE" }],
+    "domGone": ["[data-testid=\"sensor-row-2\"]"],
+    "timeoutMs": 3000
+  }
+}
+```
+
+Selectors are a ladder: test id → `name` → ARIA role + accessible name → labelled ancestor → stable CSS path → text. Build-generated class names are skipped, and a path unique only by sibling position ranks below the text anchor.
+
+## Results
+
+Measured on one machine, same flow both ways.
+
+| | fast-replay | Playwright MCP |
+|---|---|---|
+| Per verification | **2.7 s** | ~24–32 s |
+| Tool calls | **1** | 3–14 |
+| Model calls | **0** | 1 per action |
+| Context added | ~120 tokens | ~700–2 000 |
+
+10-step flow: 20/20 consecutive replays, slowest 2.77 s.
+
+The sharper claim is not speed. In a real app it caught a **736–779 ms** window where a total failed to render — a state that heals before a snapshot returns, so a model-in-the-loop tool structurally cannot see it. Two independent first passes with Playwright MCP concluded "no bug" and were wrong.
+
+## Expectations
+
+Honest limits, from six benchmark rounds against two production codebases (React Native Web; React + Vite + Radix):
+
+- **If you already have a Playwright suite, keep using it.** Authoring a spec costs about what recording costs, and a spec is legible where an IR is not. This earns its keep for throwaway repros and agent loops, not as a test framework.
+- **Recording is a human clicking once.** Driving it programmatically means writing Playwright locators, which defeats the point. `repro auto` from a bug description is not built.
+- **A bug with no console error or failed request needs one hand-written line** — `assertion.expectedWhenFixed` — or `--expect-fixed` refuses to answer rather than return a green that checked nothing.
+- **A flow that mutates server state is single-shot.** Use `--setup` to reset, or `{{random:name}}` placeholders to make inputs unique.
+- Top frame only. No iframes. Drag-and-drop and file upload are untested.
+
+## Programmatic
+
+```ts
+import { record, run, list } from 'fast-replay';
+
+const result = await run({ name: 'my-bug', expectFixed: true });
+if (!result.passed) console.log(result.failure.semantic, result.failure.artifacts.screenshot);
+```
+
+The CLI and MCP server are both thin wrappers over these.
+
+## Develop
+
+```bash
+npm test          # 110 tests, unit + real-browser integration
+npm run stress    # records once, replays 20x, fails on a single flake
+npm run demo      # examples/demo-app
+```
+
+`src/recorder/agent/` runs inside the browser and is bundled by esbuild into `agent-bundle.generated.ts`. `npm run build:agent` regenerates it; a test fails if it goes stale.
+
+MIT.

package/dist/api.d.ts

@@ -0,0 +1,65 @@
+import type { Page } from 'playwright';
+import { type ReproSummary } from './ir/io.js';
+import { STOP_HOTKEY } from './recorder/launch.js';
+import { type RunOptions, type RunResult } from './replayer/run.js';
+import type { Repro } from './ir/schema.js';
+export interface RecordOptions {
+    name: string;
+    baseUrl: string;
+    startPath?: string;
+    viewport?: {
+        width: number;
+        height: number;
+    };
+    root?: string;
+    /** Seed cookies/localStorage/IndexedDB from an existing Playwright state file. */
+    storageStatePath?: string | null;
+    /** Use a persistent Chromium profile instead of a fresh context. */
+    profileDir?: string | null;
+    onReady?: () => void;
+    headless?: boolean;
+    /**
+     * Drive the browser programmatically instead of waiting for a human. The
+     * capture pipeline is identical either way — the seam Phase 1's `repro auto`
+     * hands to an LLM browser agent.
+     */
+    drive?: (page: Page) => Promise<void>;
+}
+export interface RecordResult {
+    repro: Repro;
+    irPath: string;
+    stopReason: string;
+}
+/**
+ * The driver failed part-way, but the steps captured before it did were written
+ * to disk anyway. Carries the path so the caller can inspect or resume.
+ */
+export declare class PartialRecordingError extends Error {
+    readonly cause: Error;
+    readonly irPath: string;
+    readonly repro: Repro;
+    constructor(cause: Error, irPath: string, repro: Repro);
+}
+/**
+ * Drive a real browser, capture the flow, compile it to IR on disk.
+ *
+ * This — not the CLI — is the product's entry point. `repro record` is a thin
+ * wrapper, and the Phase 1 MCP server will wrap this same function so an agent
+ * verifies a fix in one call with no per-step round trips.
+ */
+export declare function record(options: RecordOptions): Promise<RecordResult>;
+export interface RunReproOptions extends RunOptions {
+    name: string;
+}
+/** Replay a recorded repro. Reads and validates the IR, then drives the browser. */
+export declare function run(options: RunReproOptions): Promise<RunResult>;
+/** Every repro in `.repros/`, newest first. Never throws on a corrupt IR. */
+export declare function list(root?: string): Promise<ReproSummary[]>;
+export { createReplayServer, createServer } from './mcp/server.js';
+export { BrowserPool } from './browser.js';
+export { STOP_HOTKEY };
+export { deleteRepro, readRepro, reproPaths } from './ir/io.js';
+export { compile } from './compiler/compile.js';
+export * from './ir/schema.js';
+export type { RunResult, StepTiming, RunFailure } from './replayer/run.js';
+export type { ReproSummary } from './ir/io.js';

package/dist/api.js

@@ -0,0 +1,78 @@
+import path from 'node:path';
+import { compile } from './compiler/compile.js';
+import { listRepros, readRepro, reproPaths, writeFileAtomic, writeLastResult, writeRepro, } from './ir/io.js';
+import { launchRecording, STOP_HOTKEY } from './recorder/launch.js';
+import { runRepro } from './replayer/run.js';
+/**
+ * The driver failed part-way, but the steps captured before it did were written
+ * to disk anyway. Carries the path so the caller can inspect or resume.
+ */
+export class PartialRecordingError extends Error {
+    cause;
+    irPath;
+    repro;
+    constructor(cause, irPath, repro) {
+        super(`Recording stopped early after ${repro.steps.length} step(s): ${cause.message}\n` +
+            `The partial repro was still written to ${irPath}`);
+        this.cause = cause;
+        this.irPath = irPath;
+        this.repro = repro;
+        this.name = 'PartialRecordingError';
+    }
+}
+/**
+ * Drive a real browser, capture the flow, compile it to IR on disk.
+ *
+ * This — not the CLI — is the product's entry point. `repro record` is a thin
+ * wrapper, and the Phase 1 MCP server will wrap this same function so an agent
+ * verifies a fix in one call with no per-step round trips.
+ */
+export async function record(options) {
+    const root = options.root ?? process.cwd();
+    const paths = reproPaths(options.name, root);
+    const { trace, storageState, stopReason, driveError } = await launchRecording({
+        baseUrl: options.baseUrl,
+        startPath: options.startPath,
+        viewport: options.viewport,
+        storageStatePath: options.storageStatePath ?? null,
+        profileDir: options.profileDir ?? null,
+        onReady: options.onReady,
+        headless: options.headless,
+        drive: options.drive,
+    });
+    await writeFileAtomic(paths.storageState, storageState);
+    const repro = compile(trace, {
+        name: options.name,
+        storageStatePath: path.relative(root, paths.storageState),
+    });
+    // Written before any error is raised: a driver that failed on step 12 still
+    // captured eleven real steps, and throwing them away wastes the whole run.
+    await writeRepro(repro, paths);
+    if (driveError)
+        throw new PartialRecordingError(driveError, paths.ir, repro);
+    return { repro, irPath: paths.ir, stopReason };
+}
+/** Replay a recorded repro. Reads and validates the IR, then drives the browser. */
+export async function run(options) {
+    const root = options.root ?? process.cwd();
+    const repro = await readRepro(options.name, root);
+    const result = await runRepro(repro, options);
+    await writeLastResult(reproPaths(options.name, root), {
+        status: result.passed ? 'pass' : 'fail',
+        at: new Date().toISOString(),
+        durationMs: result.durationMs,
+        ...(result.failure ? { failedStepId: result.failure.stepId } : {}),
+    });
+    return result;
+}
+/** Every repro in `.repros/`, newest first. Never throws on a corrupt IR. */
+export async function list(root = process.cwd()) {
+    return listRepros(root);
+}
+export { createReplayServer, createServer } from './mcp/server.js';
+export { BrowserPool } from './browser.js';
+export { STOP_HOTKEY };
+export { deleteRepro, readRepro, reproPaths } from './ir/io.js';
+export { compile } from './compiler/compile.js';
+export * from './ir/schema.js';
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

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

package/dist/browser.d.ts

@@ -0,0 +1,67 @@
+import { type Browser, type BrowserContext, type Page } from 'playwright';
+/**
+ * Opening a browser is shared by recording and replay, and both need the same
+ * two ways of getting an authenticated session.
+ *
+ * Session seeding is the single thing that decides whether this tool works on a
+ * real app, because every target worth verifying is behind a login:
+ *
+ * - `storageStatePath` — a portable JSON snapshot. Isolated and deterministic:
+ *   every run starts from an identical session. Now includes IndexedDB, without
+ *   which offline-first apps (Onyx, Dexie, Firebase Auth) cannot be seeded at
+ *   all — their tokens never touch cookies or localStorage.
+ *
+ * - `profileDir` — a real Chromium profile directory. Everything persists:
+ *   IndexedDB, service workers, caches. It also sidesteps non-idempotent signup,
+ *   because you never sign up twice. The cost is isolation: state accumulates
+ *   across runs, so the tenth replay does not start where the first one did.
+ *
+ * Prefer storageState for repeatable verification; reach for a profile when the
+ * app's auth cannot be captured any other way, or to skip a slow cold boot.
+ */
+export interface OpenBrowserOptions {
+    headless: boolean;
+    viewport: {
+        width: number;
+        height: number;
+    };
+    storageStatePath?: string | null;
+    profileDir?: string | null;
+    /**
+     * Reuse an already-running browser instead of launching one.
+     *
+     * Every run otherwise pays a browser launch *and* a cold page load, because a
+     * newly launched Chromium has an empty V8 code cache. Keeping the process
+     * alive across runs leaves that cache warm, which on a large single-page app
+     * is worth far more than the launch itself. Each run still gets its own
+     * context, so isolation between replays is unchanged.
+     */
+    browser?: Browser | null;
+}
+export interface OpenedBrowser {
+    context: BrowserContext;
+    page: Page;
+    /** True when running against a persistent profile. */
+    persistent: boolean;
+    close(): Promise<void>;
+}
+export declare function openBrowser(options: OpenBrowserOptions): Promise<OpenedBrowser>;
+/**
+ * Keeps one browser per headless mode alive across runs.
+ *
+ * Owned by long-lived callers — the MCP server, a stress loop — and closed with
+ * `dispose`. A one-shot CLI invocation has nothing to amortise and does not use
+ * this.
+ */
+export declare class BrowserPool {
+    private readonly browsers;
+    acquire(headless: boolean): Promise<Browser>;
+    dispose(): Promise<void>;
+}
+/**
+ * Snapshot the session, including IndexedDB.
+ *
+ * Playwright omits IndexedDB by default, which silently produces a state file
+ * that looks fine and restores nothing for any app keeping its auth there.
+ */
+export declare function captureStorageState(context: BrowserContext): Promise<string>;

package/dist/browser.js

@@ -0,0 +1,77 @@
+import { chromium } from 'playwright';
+export async function openBrowser(options) {
+    const { headless, viewport } = options;
+    if (options.profileDir) {
+        const context = await chromium.launchPersistentContext(options.profileDir, {
+            headless,
+            viewport,
+        });
+        // A persistent context always opens with one page; reuse it so we do not
+        // leave a stray about:blank tab behind.
+        const page = context.pages()[0] ?? (await context.newPage());
+        return {
+            context,
+            page,
+            persistent: true,
+            close: async () => {
+                await context.close().catch(() => { });
+            },
+        };
+    }
+    const borrowed = Boolean(options.browser);
+    const browser = options.browser ?? (await chromium.launch({ headless }));
+    const context = await browser.newContext({
+        viewport,
+        ...(options.storageStatePath ? { storageState: options.storageStatePath } : {}),
+    });
+    const page = await context.newPage();
+    return {
+        context,
+        page,
+        persistent: false,
+        close: async () => {
+            await context.close().catch(() => { });
+            // A borrowed browser belongs to the caller and outlives this run.
+            if (!borrowed)
+                await browser.close().catch(() => { });
+        },
+    };
+}
+/**
+ * Keeps one browser per headless mode alive across runs.
+ *
+ * Owned by long-lived callers — the MCP server, a stress loop — and closed with
+ * `dispose`. A one-shot CLI invocation has nothing to amortise and does not use
+ * this.
+ */
+export class BrowserPool {
+    browsers = new Map();
+    async acquire(headless) {
+        let existing = this.browsers.get(headless);
+        if (existing) {
+            const browser = await existing;
+            if (browser.isConnected())
+                return browser;
+            this.browsers.delete(headless);
+            existing = undefined;
+        }
+        const launched = chromium.launch({ headless });
+        this.browsers.set(headless, launched);
+        return launched;
+    }
+    async dispose() {
+        const all = Array.from(this.browsers.values());
+        this.browsers.clear();
+        await Promise.all(all.map(async (p) => (await p).close().catch(() => { })));
+    }
+}
+/**
+ * Snapshot the session, including IndexedDB.
+ *
+ * Playwright omits IndexedDB by default, which silently produces a state file
+ * that looks fine and restores nothing for any app keeping its auth there.
+ */
+export async function captureStorageState(context) {
+    return JSON.stringify(await context.storageState({ indexedDB: true }));
+}
+//# sourceMappingURL=browser.js.map

package/dist/browser.js.map

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

package/dist/cli/format.d.ts

@@ -0,0 +1,12 @@
+export declare const bold: (s: string) => string;
+export declare const dim: (s: string) => string;
+export declare const red: (s: string) => string;
+export declare const green: (s: string) => string;
+export declare const yellow: (s: string) => string;
+export declare const cyan: (s: string) => string;
+export declare function ms(value: number): string;
+/** Compact relative age, e.g. "3m", "2h", "5d". */
+export declare function age(iso: string | null): string;
+export declare function truncate(s: string, max: number): string;
+/** Left-aligned columns sized to their content. */
+export declare function table(rows: string[][], gap?: number): string;

package/dist/cli/format.js

@@ -0,0 +1,55 @@
+const useColor = process.stdout.isTTY && !process.env.NO_COLOR;
+const ESC = '\u001b[';
+const wrap = (code) => (s) => (useColor ? `${ESC}${code}m${s}${ESC}0m` : s);
+export const bold = wrap(1);
+export const dim = wrap(2);
+export const red = wrap(31);
+export const green = wrap(32);
+export const yellow = wrap(33);
+export const cyan = wrap(36);
+export function ms(value) {
+    return value >= 1000 ? `${(value / 1000).toFixed(2)}s` : `${Math.round(value)}ms`;
+}
+/** Compact relative age, e.g. "3m", "2h", "5d". */
+export function age(iso) {
+    if (!iso)
+        return '?';
+    const then = Date.parse(iso);
+    if (Number.isNaN(then))
+        return '?';
+    const secs = Math.max(0, (Date.now() - then) / 1000);
+    if (secs < 60)
+        return `${Math.floor(secs)}s`;
+    if (secs < 3600)
+        return `${Math.floor(secs / 60)}m`;
+    if (secs < 86400)
+        return `${Math.floor(secs / 3600)}h`;
+    return `${Math.floor(secs / 86400)}d`;
+}
+export function truncate(s, max) {
+    return s.length <= max ? s : `${s.slice(0, max - 1)}…`;
+}
+/** Length ignoring ANSI escapes, so colored cells still align. */
+function visibleLength(s) {
+    // eslint-disable-next-line no-control-regex
+    return s.replace(/\u001b\[\d+m/g, '').length;
+}
+/** Left-aligned columns sized to their content. */
+export function table(rows, gap = 2) {
+    if (!rows.length)
+        return '';
+    const widths = [];
+    for (const row of rows) {
+        row.forEach((cell, i) => {
+            widths[i] = Math.max(widths[i] ?? 0, visibleLength(cell));
+        });
+    }
+    return rows
+        .map((row) => row
+        .map((cell, i) => i === row.length - 1
+        ? cell
+        : cell + ' '.repeat((widths[i] ?? 0) - visibleLength(cell) + gap))
+        .join(''))
+        .join('\n');
+}
+//# sourceMappingURL=format.js.map

package/dist/cli/format.js.map

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

package/dist/cli/index.d.ts

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