fast-replay 0.1.0

package/dist/mcp/index.js

@@ -0,0 +1,22 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { createReplayServer } from './server.js';
+/**
+ * stdio entry point. Nothing may be written to stdout except protocol frames,
+ * so any diagnostics go to stderr.
+ */
+/**
+ * Where `.repros/` lives. Defaults to the directory the client launched us in,
+ * which is wrong whenever the repros are kept outside the project being fixed.
+ */
+const root = process.env.REPLAY_ROOT ?? process.cwd();
+const { server, dispose } = createReplayServer(root);
+await server.connect(new StdioServerTransport());
+// The pooled browsers outlive individual calls, so they need an explicit exit.
+for (const signal of ['SIGINT', 'SIGTERM']) {
+    process.once(signal, () => {
+        void dispose().finally(() => process.exit(0));
+    });
+}
+process.stderr.write(`replay mcp server ready (repros: ${root})\n`);
+//# sourceMappingURL=index.js.map

package/dist/mcp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD;;;GAGG;AACH;;;GAGG;AACH,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;AACtD,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;AACrD,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAC;AAEjD,+EAA+E;AAC/E,KAAK,MAAM,MAAM,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAU,EAAE,CAAC;IACpD,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE;QACxB,KAAK,OAAO,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;AACL,CAAC;AACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,oCAAoC,IAAI,KAAK,CAAC,CAAC"}

package/dist/mcp/server.d.ts

@@ -0,0 +1,8 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export interface ReplayServer {
+    server: McpServer;
+    /** Closes the browsers held open across calls. */
+    dispose(): Promise<void>;
+}
+export declare function createServer(root?: string): McpServer;
+export declare function createReplayServer(root?: string): ReplayServer;

package/dist/mcp/server.js

@@ -0,0 +1,268 @@
+import { readFile } from 'node:fs/promises';
+import path from 'node:path';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod';
+import { list, readRepro, reproPaths, run } from '../api.js';
+import { BrowserPool } from '../browser.js';
+import { VERSION } from '../version.js';
+/**
+ * Replay as an MCP server: a deterministic eye that a coding agent looks
+ * through.
+ *
+ * Nothing here calls a model. The agent already has one — this exists to hand
+ * it what the browser actually did, in one call, in a form it can read *and
+ * see*. That is the whole difference from driving a browser through an agent
+ * step by step: re-verifying a fix costs one round trip instead of one per
+ * action, every time.
+ */
+/** Screenshots are returned inline, so the model sees the page rather than a path. */
+const MAX_INLINE_IMAGE_BYTES = 4 * 1024 * 1024;
+async function imageContent(file) {
+    if (!file)
+        return [];
+    try {
+        const bytes = await readFile(file);
+        if (bytes.byteLength > MAX_INLINE_IMAGE_BYTES) {
+            return [
+                {
+                    type: 'text',
+                    text: `Screenshot too large to inline (${Math.round(bytes.byteLength / 1024)} kB): ${file}`,
+                },
+            ];
+        }
+        return [{ type: 'image', data: bytes.toString('base64'), mimeType: 'image/png' }];
+    }
+    catch {
+        return [];
+    }
+}
+async function tail(file, lines) {
+    if (!file)
+        return '';
+    try {
+        const text = await readFile(file, 'utf8');
+        return text.split('\n').slice(-lines).join('\n').trim();
+    }
+    catch {
+        return '';
+    }
+}
+/** The one-screen summary an agent reads before deciding what to do next. */
+function summarize(result, expectFixed) {
+    const mode = expectFixed ? 'expect-fixed' : 'expect-bug';
+    const head = result.passed
+        ? `PASS (${mode}) — ${result.name}, ${result.timings.length}/${result.totalSteps} steps in ${(result.durationMs / 1000).toFixed(2)}s`
+        : `FAIL (${mode}) — ${result.name} after ${(result.durationMs / 1000).toFixed(2)}s`;
+    if (result.passed) {
+        return expectFixed
+            ? `${head}\nThe flow completed and the recorded bug did not occur. The fix holds.`
+            : `${head}\nThe recorded outcome still occurs, so the repro itself is sound.`;
+    }
+    const f = result.failure;
+    if (!f)
+        return head;
+    if (f.kind === 'infrastructure') {
+        return [
+            `COULD NOT VERIFY — ${result.name}`,
+            '',
+            'The replay could not drive the app, so this says nothing about whether the bug is fixed.',
+            `Failing step: ${f.stepId} (step ${f.stepIndex + 1} of ${result.totalSteps})`,
+            `What it does:  ${f.semantic}`,
+            `Observed:      ${f.observed}`,
+        ].join('\n');
+    }
+    return [
+        head,
+        ``,
+        `Failing step: ${f.stepId} (step ${f.stepIndex + 1} of ${result.totalSteps})`,
+        `What it does:  ${f.semantic}`,
+        `Expected:      ${f.expected}`,
+        `Observed:      ${f.observed}`,
+    ].join('\n');
+}
+export function createServer(root = process.cwd()) {
+    return createReplayServer(root).server;
+}
+export function createReplayServer(root = process.cwd()) {
+    const server = new McpServer({ name: 'replay', version: VERSION });
+    /**
+     * One browser, held open for the life of the server.
+     *
+     * A CLI invocation is one-shot and has nothing to amortise, but this process
+     * is long-lived: without a pool every verification launched a fresh Chromium
+     * with an empty V8 code cache, so a large app paid its full cold boot on
+     * every single call. Each run still gets its own context, so replays stay
+     * isolated from one another.
+     */
+    const pool = new BrowserPool();
+    server.registerTool('repro_run', {
+        title: 'Run a bug repro',
+        description: 'Replay a recorded bug reproduction against the running dev server and report what happened. ' +
+            'Deterministic and fast (a 10-step flow takes about 3 seconds) — call it after every code change to verify a fix. ' +
+            'Returns the pass/fail verdict, the failing step with a plain-language description of what it does, the console tail, ' +
+            'the network activity, and a screenshot of the resulting page. ' +
+            'Use expect_fixed=true while fixing a bug: it passes when the flow completes and the bug no longer occurs.',
+        inputSchema: {
+            name: z.string().describe('Name of the repro, as shown by repro_list.'),
+            expect_fixed: z
+                .boolean()
+                .optional()
+                .describe('True while verifying a fix: pass when the bug does NOT occur. False (default) asserts the bug still reproduces.'),
+            base_url: z.string().optional().describe('Override the recorded base URL.'),
+            headed: z
+                .boolean()
+                .optional()
+                .describe('Run in a visible browser. Required by apps that refuse headless sessions — without it those replays fail for reasons unrelated to the bug.'),
+            profile_dir: z
+                .string()
+                .optional()
+                .describe('Persistent Chromium profile directory, to reuse a login.'),
+            setup_command: z
+                .string()
+                .optional()
+                .describe('Shell command run before replay, to reset state the flow mutates.'),
+            timeout_scale: z
+                .number()
+                .optional()
+                .describe('Multiply every recorded wait. Raise it when replaying somewhere slower than the machine that recorded.'),
+        },
+    }, async ({ name, expect_fixed = false, base_url, headed, profile_dir, setup_command, timeout_scale }) => {
+        const result = await run({
+            name,
+            root,
+            expectFixed: expect_fixed,
+            captureFinalScreenshot: true,
+            // A persistent profile owns its own process and cannot share the pool.
+            ...(profile_dir ? {} : { browser: await pool.acquire(!headed) }),
+            ...(headed ? { headed: true } : {}),
+            ...(profile_dir ? { profileDir: profile_dir } : {}),
+            ...(setup_command ? { setupCommand: setup_command } : {}),
+            ...(timeout_scale ? { timeoutScale: timeout_scale } : {}),
+            ...(base_url ? { baseUrl: base_url } : {}),
+        });
+        const artifacts = result.failure?.artifacts ?? null;
+        const consoleTail = await tail(artifacts?.consoleLog ?? null, 50);
+        const networkLog = await tail(artifacts?.networkLog ?? null, 40);
+        const content = [{ type: 'text', text: summarize(result, expect_fixed) }];
+        // Notes carry the "this may be single-shot" warning, which is the only
+        // signal that a green verdict might mean nothing.
+        for (const note of result.notes)
+            content.push({ type: 'text', text: note });
+        if (consoleTail)
+            content.push({ type: 'text', text: `Console errors:\n${consoleTail}` });
+        if (networkLog)
+            content.push({ type: 'text', text: `Network since last step:\n${networkLog}` });
+        content.push(...(await imageContent(result.finalScreenshot)));
+        return {
+            content,
+            isError: !result.passed,
+            structuredContent: {
+                name: result.name,
+                passed: result.passed,
+                durationMs: result.durationMs,
+                totalSteps: result.totalSteps,
+                stepsRun: result.timings.length,
+                failure: result.failure
+                    ? {
+                        stepId: result.failure.stepId,
+                        stepIndex: result.failure.stepIndex,
+                        semantic: result.failure.semantic,
+                        expected: result.failure.expected,
+                        observed: result.failure.observed,
+                    }
+                    : null,
+                failureKind: result.failure?.kind ?? null,
+                invariantViolations: result.invariantViolations,
+                screenshot: result.finalScreenshot,
+            },
+        };
+    });
+    server.registerTool('repro_list', {
+        title: 'List bug repros',
+        description: 'List the recorded bug reproductions available in this project, with step count, age, and how each one last did.',
+        inputSchema: {},
+    }, async () => {
+        const repros = await list(root);
+        if (!repros.length) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: 'No repros recorded. A developer creates one with: repro record <name> --url <dev server>',
+                    },
+                ],
+                structuredContent: { repros: [] },
+            };
+        }
+        const lines = repros.map((r) => {
+            const last = r.lastResult
+                ? `${r.lastResult.status}${r.lastResult.failedStepId ? ` at ${r.lastResult.failedStepId}` : ''}`
+                : 'never run';
+            return `${r.name} — ${r.steps ?? '?'} steps, last run: ${last}${r.error ? ` (INVALID: ${r.error})` : ''}`;
+        });
+        return {
+            content: [{ type: 'text', text: lines.join('\n') }],
+            structuredContent: { repros },
+        };
+    });
+    server.registerTool('repro_artifacts', {
+        title: 'Inspect a repro',
+        description: 'Read the steps of a repro and the artifacts from its last failure: the failing step, its description, ' +
+            'the console tail, the network log, and the screenshot. Use this to understand a bug without re-running it.',
+        inputSchema: {
+            name: z.string().describe('Name of the repro.'),
+        },
+    }, async ({ name }) => {
+        const repro = await readRepro(name, root);
+        const paths = reproPaths(name, root);
+        const artifactsDir = paths.artifactsDir;
+        const steps = repro.steps
+            .map((s) => `  ${s.id}  ${s.action.padEnd(8)} ${s.target?.semantic ?? s.value ?? ''}`)
+            .join('\n');
+        const summaryFile = path.join(artifactsDir, 'failure.json');
+        let failure = null;
+        try {
+            failure = JSON.parse(await readFile(summaryFile, 'utf8'));
+        }
+        catch {
+            /* no recorded failure */
+        }
+        const content = [
+            {
+                type: 'text',
+                text: [
+                    `Repro: ${repro.name}`,
+                    `Base URL: ${repro.baseUrl}${repro.startPath}`,
+                    `Assertion mode: ${repro.assertion.mode}`,
+                    ``,
+                    `Steps:`,
+                    steps,
+                ].join('\n'),
+            },
+        ];
+        const observed = repro.assertion.observedAtRecord;
+        if (observed?.consoleErrors.length || observed?.failedRequests.length) {
+            content.push({
+                type: 'text',
+                text: [
+                    'The bug, as observed when this repro was recorded:',
+                    ...observed.consoleErrors.map((e) => `  console: ${e}`),
+                    ...observed.failedRequests.map((r) => `  network: ${r.method} ${r.urlPattern} -> ${r.status ?? 'aborted'}`),
+                ].join('\n'),
+            });
+        }
+        if (failure) {
+            content.push({ type: 'text', text: `Last failure:\n${JSON.stringify(failure, null, 2)}` });
+            const consoleTail = await tail(path.join(artifactsDir, 'console.log'), 50);
+            if (consoleTail)
+                content.push({ type: 'text', text: `Console:\n${consoleTail}` });
+            content.push(...(await imageContent(path.join(artifactsDir, 'screenshot.png'))));
+        }
+        return {
+            content,
+            structuredContent: { repro, failure, artifactsDir },
+        };
+    });
+    return { server, dispose: () => pool.dispose() };
+}
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

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

package/dist/noise.d.ts

@@ -0,0 +1,20 @@
+/**
+ * What counts as environment noise rather than evidence about the app.
+ *
+ * This lives in one module on purpose. Filtering only at record time produced a
+ * worse bug than not filtering at all: the compiler saw an empty error list,
+ * inferred "this app is clean", and switched the invariants to their strictest
+ * setting — while the replayer checked raw, unfiltered output. The same CORS
+ * error that was correctly ignored while recording became a hard failure on
+ * every replay. Both sides must agree on what noise is.
+ */
+export declare function isAmbientConsoleError(text: string): boolean;
+/**
+ * Requests that must never become a recorded wait.
+ *
+ * A content-hashed bundle breaks on the next deploy *and* on the very next
+ * replay, because the browser already has it cached and never re-requests it.
+ * Telemetry is unrelated to the app's behaviour by definition.
+ */
+export declare function isIncidentalRequest(url: string): boolean;
+export declare function isTransientIndicator(role: string | null, name: string): boolean;

package/dist/noise.js

@@ -0,0 +1,70 @@
+/**
+ * What counts as environment noise rather than evidence about the app.
+ *
+ * This lives in one module on purpose. Filtering only at record time produced a
+ * worse bug than not filtering at all: the compiler saw an empty error list,
+ * inferred "this app is clean", and switched the invariants to their strictest
+ * setting — while the replayer checked raw, unfiltered output. The same CORS
+ * error that was correctly ignored while recording became a hard failure on
+ * every replay. Both sides must agree on what noise is.
+ */
+/**
+ * Console output a production SPA emits regardless of what the user did:
+ * blocked third-party beacons, CORS preflights, DNS failures, CSP reports,
+ * extension chatter, framework advertising.
+ */
+const AMBIENT_CONSOLE_PATTERNS = [
+    /blocked by CORS policy/i,
+    /Access-Control-Allow-Origin/i,
+    /net::ERR_/i,
+    /ERR_NAME_NOT_RESOLVED/i,
+    /ERR_CONNECTION_REFUSED/i,
+    /Failed to load resource/i,
+    /chrome-extension:/i,
+    /Content Security Policy/i,
+    /favicon/i,
+    /ResizeObserver loop/i,
+    /Download the React DevTools/i,
+];
+export function isAmbientConsoleError(text) {
+    return AMBIENT_CONSOLE_PATTERNS.some((re) => re.test(text));
+}
+/** Telemetry and error-reporting hosts. Never evidence about the app's behaviour. */
+const TELEMETRY_HOSTS = /(^|\.)(sentry\.io|segment\.(io|com)|google-analytics\.com|googletagmanager\.com|datadoghq\.com|amplitude\.com|mixpanel\.com|intercom\.io|hotjar\.com|fullstory\.com|launchdarkly\.com|bugsnag\.com|newrelic\.com|pusher\.com)$/i;
+/** Build output and media. Cached on the second run, so never a reliable signal. */
+const STATIC_ASSET = /\.(js|mjs|cjs|css|map|png|jpe?g|gif|svg|webp|avif|ico|woff2?|ttf|eot)$/i;
+/**
+ * Requests that must never become a recorded wait.
+ *
+ * A content-hashed bundle breaks on the next deploy *and* on the very next
+ * replay, because the browser already has it cached and never re-requests it.
+ * Telemetry is unrelated to the app's behaviour by definition.
+ */
+export function isIncidentalRequest(url) {
+    try {
+        const parsed = new URL(url);
+        if (TELEMETRY_HOSTS.test(parsed.hostname))
+            return true;
+        if (STATIC_ASSET.test(parsed.pathname))
+            return true;
+        return false;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Elements whose whole job is to be temporary.
+ *
+ * A spinner recorded as a required `domAppeared` fails on every warm replay:
+ * the data is cached, the spinner never renders, and a healthy app is reported
+ * broken. It survives an "is it still there next action?" check on a cold run,
+ * so it has to be excluded by what it is rather than how long it lasted.
+ */
+const TRANSIENT_NAME = /\b(loading|spinner|progress|skeleton|please wait|submitting|saving)\b/i;
+export function isTransientIndicator(role, name) {
+    if (role === 'progressbar')
+        return true;
+    return TRANSIENT_NAME.test(name);
+}
+//# sourceMappingURL=noise.js.map

package/dist/noise.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"noise.js","sourceRoot":"","sources":["../src/noise.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;GAIG;AACH,MAAM,wBAAwB,GAAG;IAC/B,yBAAyB;IACzB,8BAA8B;IAC9B,YAAY;IACZ,wBAAwB;IACxB,yBAAyB;IACzB,0BAA0B;IAC1B,oBAAoB;IACpB,0BAA0B;IAC1B,UAAU;IACV,sBAAsB;IACtB,8BAA8B;CAC/B,CAAC;AAEF,MAAM,UAAU,qBAAqB,CAAC,IAAY;IAChD,OAAO,wBAAwB,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AAC9D,CAAC;AAED,qFAAqF;AACrF,MAAM,eAAe,GACnB,iOAAiO,CAAC;AAEpO,oFAAoF;AACpF,MAAM,YAAY,GAAG,yEAAyE,CAAC;AAE/F;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAW;IAC7C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;YAAE,OAAO,IAAI,CAAC;QACvD,IAAI,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;YAAE,OAAO,IAAI,CAAC;QACpD,OAAO,KAAK,CAAC;IACf,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,cAAc,GAAG,wEAAwE,CAAC;AAEhG,MAAM,UAAU,oBAAoB,CAAC,IAAmB,EAAE,IAAY;IACpE,IAAI,IAAI,KAAK,aAAa;QAAE,OAAO,IAAI,CAAC;IACxC,OAAO,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACnC,CAAC"}

package/dist/recorder/agent/capture.d.ts

@@ -0,0 +1,15 @@
+import type { AgentConfig } from './config.js';
+import type { RevealTracker } from './reveal-tracker.js';
+import type { Transport } from './transport.js';
+export interface CaptureContext {
+    config: AgentConfig;
+    transport: Transport;
+    reveals: RevealTracker;
+    /**
+     * Called just before each action is recorded, so the DOM observer can settle
+     * the previous action's reaction at the same moment replay would stop waiting
+     * for it.
+     */
+    beforeAction?: () => void;
+}
+export declare function installCapture(ctx: CaptureContext): void;