@junejuly-lockstep/reconciler 0.1.0

package/dist/walk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"walk.d.ts","sourceRoot":"","sources":["../src/walk.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,YAAY,EACZ,cAAc,EACd,QAAQ,EAER,UAAU,EAEX,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAW,KAAK,WAAW,EAAE,KAAK,SAAS,EAAE,MAAM,WAAW,CAAC;AAUtE,uEAAuE;AACvE,eAAO,MAAM,eAAe,QAAkC,CAAC;AAC/D,eAAO,MAAM,QAAQ;;;CAAwC,CAAC;AAC9D,eAAO,MAAM,mBAAmB,IAAI,CAAC;AACrC,eAAO,MAAM,MAAM,UAAU,CAAC;AAC9B,eAAO,MAAM,QAAQ,QAAQ,CAAC;AAC9B,eAAO,MAAM,YAAY,UAAU,CAAC;AACpC,sGAAsG;AACtG,eAAO,MAAM,kBAAkB,QAWnB,CAAC;AACb;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,UASzB,CAAC;AACF,eAAO,MAAM,eAAe,QAAS,CAAC;AACtC,eAAO,MAAM,YAAY,IAAI,CAAC;AAsB9B,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,OAAO,CAAC,EAAE;QAChB,KAAK,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,QAAQ,GAAG,UAAU,CAAC;QACvD,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClB,KAAK,CAAC,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9B,KAAK,IAAI,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,IAAI,MAAM,CAAC;IACd,MAAM,IAAI,MAAM,CAAC;IACjB,QAAQ,IAAI,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,CACF,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,GAAG,kBAAkB,GAAG,aAAa,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GACtF,OAAO,CAAC,OAAO,CAAC,CAAC;IACpB,GAAG,IAAI,MAAM,CAAC;IACd,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,CAAC;IACvC,UAAU,CAAC,OAAO,EAAE;QAClB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,UAAU,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC;QAClC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC3B,KAAK,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAC;KAC1B,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACpB,gBAAgB,CACd,KAAK,CAAC,EAAE,MAAM,GAAG,kBAAkB,GAAG,aAAa,EACnD,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAC7B,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/C,WAAW,CAAC,OAAO,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7D,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,GAAG,OAAO,CAAC;IACxE,yFAAyF;IACzF,KAAK,CAAC,EAAE;QAAE,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,CAAC;IACtD,KAAK,EAAE;QACL,OAAO,CAAC,OAAO,CAAC,EAAE;YAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;SAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QACpE,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KAC3D,CAAC;IACF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,IAAI,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC7B,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,OAAO,EAAE;QACP,KAAK,CAAC,OAAO,CAAC,EAAE;YACd,WAAW,CAAC,EAAE,OAAO,CAAC;YACtB,SAAS,CAAC,EAAE,OAAO,CAAC;YACpB,OAAO,CAAC,EAAE,OAAO,CAAC;YAClB,KAAK,CAAC,EAAE,MAAM,CAAC;SAChB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAClB,IAAI,CAAC,OAAO,CAAC,EAAE;YAAE,IAAI,CAAC,EAAE,MAAM,CAAA;SAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KAClD,CAAC;IACF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,CAAC,OAAO,CAAC,EAAE;QACnB,QAAQ,CAAC,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC;QAC7C,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,aAAa,CAAC,EAAE,QAAQ,GAAG,eAAe,CAAC;QAC3C,WAAW,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;QAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACzB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,MAAM,WAAW,QAAQ;IACvB,MAAM,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC;IAC/B,IAAI,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;CAC7C;AAED,sFAAsF;AACtF,eAAO,MAAM,eAAe,EAAE,QAuB7B,CAAC;AAIF,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,aAAa,GAAG,MAAM,CAAC,CAAC;IACrD,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,6FAA6F;IAC7F,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,+DAA+D;IAC/D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iFAAiF;IACjF,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE7F;AAED,wBAAgB,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAEzF;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAGxF;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,iFAAiF;AACjF,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,EAAE,CAqC3D;AAwCD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAYnD;AAwCD;;;;GAIG;AACH,wBAAsB,IAAI,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAiEjE"}

package/dist/walk.js

@@ -0,0 +1,433 @@
+import path from 'node:path';
+import { bootApp } from './boot.js';
+import { InfrastructureError } from './errors.js';
+import { enumeratePaths } from './paths.js';
+import { ensureDir, safeSegment } from './util.js';
+/* ------------------------------------------------------------------------------------------
+ * Determinism constants. Everything here is part of the "same commit + same seed => identical
+ * bytes" guarantee; see README "Determinism rules". Change them only with a baseline reset.
+ * ---------------------------------------------------------------------------------------- */
+/** 2026-01-15T09:30:00.000Z. Every walk's `Date.now()` starts here. */
+export const FROZEN_EPOCH_MS = Date.UTC(2026, 0, 15, 9, 30, 0);
+export const VIEWPORT = { width: 1280, height: 800 };
+export const DEVICE_SCALE_FACTOR = 1;
+export const LOCALE = 'en-US';
+export const TIMEZONE = 'UTC';
+export const COLOR_SCHEME = 'light';
+/** Injected on every document: no animations, no transitions, no blinking caret, no smooth scroll. */
+export const DISABLE_MOTION_CSS = [
+    '*, *::before, *::after {',
+    '  animation: none !important;',
+    '  animation-duration: 0s !important;',
+    '  transition: none !important;',
+    '  transition-duration: 0s !important;',
+    '  caret-color: transparent !important;',
+    '  scroll-behavior: auto !important;',
+    '}',
+    'html { scroll-behavior: auto !important; }',
+    'video, canvas { visibility: hidden !important; }',
+].join('\n');
+/**
+ * Chromium flags that remove machine-dependent text rendering, plus `--disable-partial-raster`:
+ * with partial raster on, a tile whose content changed after first paint (a page that renders its
+ * state root once its data arrived) is re-rastered only inside the damage rect, and the
+ * anti-aliasing along that rect's edges differs by a unit from a full raster of the same pixels,
+ * depending on whether a frame was produced in between. Invisible, but not byte-identical.
+ */
+export const CHROMIUM_ARGS = [
+    '--font-render-hinting=none',
+    '--disable-font-subpixel-positioning',
+    '--disable-lcd-text',
+    '--force-color-profile=srgb',
+    '--disable-gpu',
+    '--disable-partial-raster',
+    '--hide-scrollbars',
+    '--disable-skia-runtime-opts',
+];
+export const STEP_TIMEOUT_MS = 15_000;
+export const MAX_ATTEMPTS = 2;
+/** Script injected before any page script: adds the motion-killing stylesheet as soon as there is a head. */
+const INIT_SCRIPT = `(() => {
+  const css = ${JSON.stringify(DISABLE_MOTION_CSS)};
+  const add = () => {
+    if (!document.head || document.getElementById('__lockstep_motion')) return;
+    const s = document.createElement('style');
+    s.id = '__lockstep_motion';
+    s.textContent = css;
+    document.head.appendChild(s);
+  };
+  if (document.readyState !== 'loading') add();
+  else document.addEventListener('DOMContentLoaded', add, { once: true });
+  new MutationObserver(add).observe(document, { childList: true, subtree: true });
+})();`;
+/** Default deps: real Playwright Chromium (imported lazily) and the real app boot. */
+export const defaultWalkDeps = {
+    async launch() {
+        let pw;
+        try {
+            pw = await import('playwright');
+        }
+        catch (err) {
+            throw new InfrastructureError('playwright is not installed; run `npx playwright install --with-deps chromium`', err);
+        }
+        try {
+            return (await pw.chromium.launch({ headless: true, args: CHROMIUM_ARGS }));
+        }
+        catch (err) {
+            throw new InfrastructureError('could not launch Chromium; run `npx playwright install --with-deps chromium`', err);
+        }
+    },
+    boot: bootApp,
+};
+export function screenshotPath(journeyKey, stateKey, scenario) {
+    return `shots/${safeSegment(journeyKey)}/${safeSegment(stateKey)}/${safeSegment(scenario)}.png`;
+}
+export function tracePath(journeyKey, scenario, pathIndex) {
+    return `traces/${safeSegment(journeyKey)}/${safeSegment(scenario)}/${String(pathIndex).padStart(3, '0')}.zip`;
+}
+export function triggerTestId(journey, from, event) {
+    const binding = journey.meta.bindings.find((b) => b.from === from && b.event === event);
+    return binding?.testId ?? event.toLowerCase();
+}
+export function testIdSelector(testId) {
+    return `[data-testid="${testId.replace(/"/g, '\\"')}"]`;
+}
+/** Pull GraphQL operation names out of a request whose path ends in /graphql. */
+export function operationNamesOf(req) {
+    let url;
+    try {
+        url = new URL(req.url());
+    }
+    catch {
+        return [];
+    }
+    if (!/\/graphql\/?$/.test(url.pathname) && !url.pathname.includes('/graphql'))
+        return [];
+    const names = [];
+    const fromDoc = (doc) => {
+        if (!doc || typeof doc !== 'object')
+            return;
+        const d = doc;
+        if (typeof d.operationName === 'string' && d.operationName) {
+            names.push(d.operationName);
+            return;
+        }
+        if (typeof d.query === 'string') {
+            const m = /\b(query|mutation|subscription)\s+([A-Za-z_][A-Za-z0-9_]*)/.exec(d.query);
+            if (m)
+                names.push(m[2]);
+        }
+    };
+    if (req.method() === 'GET') {
+        const op = url.searchParams.get('operationName');
+        if (op)
+            names.push(op);
+        else
+            fromDoc({ query: url.searchParams.get('query') ?? undefined });
+        return names;
+    }
+    const body = req.postData();
+    if (!body)
+        return names;
+    try {
+        const parsed = JSON.parse(body);
+        if (Array.isArray(parsed))
+            parsed.forEach(fromDoc);
+        else
+            fromDoc(parsed);
+    }
+    catch {
+        /* not JSON */
+    }
+    return names;
+}
+async function settle(page, timeout) {
+    await page.waitForLoadState('networkidle', { timeout }).catch(() => { });
+    await page.addStyleTag({ content: DISABLE_MOTION_CSS }).catch(() => { });
+    await page
+        .evaluate('(document.fonts && document.fonts.ready ? document.fonts.ready : Promise.resolve()).then(() => true)')
+        .catch(() => { });
+    // Two frames so layout settles after fonts swap in.
+    await page
+        .evaluate('new Promise((r) => requestAnimationFrame(() => requestAnimationFrame(() => r(true))))')
+        .catch(() => { });
+}
+/**
+ * The state root may appear only after `settle` ran (an app that fetches through a mock worker
+ * renders its root once the data is in). A shot taken in the very frames after a large layout
+ * change can catch tiles rasterised during the change, which differ by a unit or two of
+ * anti-aliasing from the steady state: not visible, but not byte-identical either. So the walker
+ * settles once more after the root is visible: network idle, fonts, two frames, and two more
+ * frames after that.
+ */
+async function settleVisible(page, timeout) {
+    await settle(page, timeout);
+    await page
+        .evaluate('new Promise((r) => requestAnimationFrame(() => requestAnimationFrame(() => r(true))))')
+        .catch(() => { });
+}
+/** Park the pointer in the top-left corner so no hover state depends on where the last click landed. */
+async function park(page) {
+    await page.mouse?.move(0, 0).catch(() => { });
+}
+/**
+ * One line for the walk result and the verdict detail: Playwright's first line plus the call-log
+ * lines that say what it was waiting for or navigating to (the selector lives there, not in the
+ * first line). Anything else in the call log is noise for a card.
+ */
+export function summarizeError(err) {
+    const text = err instanceof Error ? err.message : String(err);
+    const lines = text
+        .split('\n')
+        .map((l) => l.trim().replace(/^-\s*/, ''))
+        .filter(Boolean);
+    const first = lines[0] ?? 'unknown error';
+    const context = lines
+        .slice(1)
+        .filter((l) => /^(waiting for|navigating to|locator resolved to)/i.test(l))
+        .slice(0, 2);
+    return [first, ...context].join(' ').replace(/\s+/g, ' ');
+}
+/**
+ * Playwright's message no longer carries the call log (what it was waiting for), so the walker
+ * attaches its own: the selector it waited for, the trigger it clicked, the route it was still on.
+ */
+async function describing(what, fn) {
+    try {
+        return await fn();
+    }
+    catch (err) {
+        throw new Error(`${summarizeError(err)} (${what()})`, { cause: err });
+    }
+}
+async function attemptStep(fn, log, label) {
+    let error = null;
+    for (let attempt = 0; attempt < MAX_ATTEMPTS; attempt++) {
+        try {
+            await fn(attempt);
+            return { status: 'pass', attempts: attempt + 1, error: null };
+        }
+        catch (err) {
+            error = summarizeError(err);
+            log(`  ${label}: attempt ${attempt + 1} failed: ${error}`);
+        }
+    }
+    return { status: 'fail', attempts: MAX_ATTEMPTS, error };
+}
+function pathnameOf(url) {
+    try {
+        return new URL(url).pathname;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Execute every enumerated path of every journey, per scenario, and record a `WalkResult`.
+ * Order: scenarios by name, journeys by key, paths by target state. Boot happens once per
+ * scenario so `LOCKSTEP_SCENARIO`/`LOCKSTEP_SEED` reach server-side mocks too.
+ */
+export async function walk(opts) {
+    const log = opts.log ?? (() => { });
+    const deps = opts.deps ?? defaultWalkDeps;
+    const timeout = opts.stepTimeoutMs ?? STEP_TIMEOUT_MS;
+    const baseUrl = (opts.baseUrl ?? `http://127.0.0.1:${opts.config.port}`).replace(/\/+$/, '');
+    const scenarios = [...opts.scenarios].sort((a, b) => a.name.localeCompare(b.name));
+    const journeys = [...opts.journeys].sort((a, b) => a.key.localeCompare(b.key));
+    const enumerated = new Map(journeys.map((j) => [j.key, enumeratePaths(j.machine)]));
+    const paths = [];
+    for (const scenario of scenarios) {
+        log(`scenario ${scenario.name} (seed ${scenario.seed})`);
+        const app = opts.noBoot
+            ? null
+            : await deps.boot({
+                command: opts.config.bootCommand,
+                port: opts.config.port,
+                cwd: opts.rootDir,
+                env: {
+                    LOCKSTEP_SCENARIO: scenario.name,
+                    LOCKSTEP_SEED: String(scenario.seed),
+                    TZ: TIMEZONE,
+                },
+                log,
+            });
+        let browser = null;
+        try {
+            browser = await deps.launch();
+            for (const journey of journeys) {
+                const journeyPaths = enumerated.get(journey.key) ?? [];
+                log(`  journey ${journey.key}: ${journeyPaths.length} paths`);
+                for (let i = 0; i < journeyPaths.length; i++) {
+                    // A dead app is an infrastructure failure, not a row of failed transitions.
+                    if (app && !app.alive()) {
+                        const tail = app.output().slice(-10).join('\n');
+                        throw new InfrastructureError(`app under test exited during the walk (scenario ${scenario.name})${tail ? `\nlast output:\n${tail}` : ''}`);
+                    }
+                    paths.push(await walkPath({
+                        browser,
+                        journey,
+                        scenario,
+                        path: journeyPaths[i],
+                        index: i,
+                        baseUrl,
+                        timeout,
+                        log,
+                        artifactsDir: opts.artifactsDir,
+                    }));
+                }
+            }
+        }
+        catch (err) {
+            throw err instanceof InfrastructureError ? err : new InfrastructureError('walk failed', err);
+        }
+        finally {
+            await browser?.close().catch(() => { });
+            await app?.stop().catch(() => { });
+        }
+    }
+    return { viewport: { ...VIEWPORT }, frozenEpochMs: FROZEN_EPOCH_MS, paths };
+}
+async function walkPath(args) {
+    const { browser, journey, scenario, timeout, log } = args;
+    const context = await browser.newContext({
+        viewport: { ...VIEWPORT },
+        deviceScaleFactor: DEVICE_SCALE_FACTOR,
+        reducedMotion: 'reduce',
+        colorScheme: COLOR_SCHEME,
+        locale: LOCALE,
+        timezoneId: TIMEZONE,
+        hasTouch: false,
+        isMobile: false,
+    });
+    const traceRel = tracePath(journey.key, scenario.name, args.index);
+    const traceAbs = path.join(args.artifactsDir, traceRel);
+    ensureDir(path.dirname(traceAbs));
+    let traceKey = null;
+    const steps = [];
+    try {
+        await context.addInitScript(INIT_SCRIPT);
+        await context.tracing.start({
+            screenshots: true,
+            snapshots: true,
+            sources: false,
+            title: `${journey.key}/${scenario.name}/${args.index}`,
+        });
+        const page = await context.newPage();
+        await page.clock.install({ time: FROZEN_EPOCH_MS });
+        await page.clock.setFixedTime(FROZEN_EPOCH_MS);
+        const pendingOps = [];
+        page.on('request', (req) => pendingOps.push(...operationNamesOf(req)));
+        const drainOps = () => {
+            const ops = [...new Set(pendingOps)].sort();
+            pendingOps.length = 0;
+            return ops;
+        };
+        const shoot = async (stateKey) => {
+            const rel = screenshotPath(journey.key, stateKey, scenario.name);
+            const abs = path.join(args.artifactsDir, rel);
+            ensureDir(path.dirname(abs));
+            try {
+                await page.screenshot({
+                    path: abs,
+                    fullPage: true,
+                    animations: 'disabled',
+                    caret: 'hide',
+                    scale: 'css',
+                });
+                return rel;
+            }
+            catch (err) {
+                log(`  screenshot ${rel} failed: ${err instanceof Error ? err.message : String(err)}`);
+                return null;
+            }
+        };
+        // Step 0: land on the initial state.
+        const initial = journey.machine.initial;
+        const initialMeta = journey.meta.states[initial];
+        if (!initialMeta)
+            throw new InfrastructureError(`journey ${journey.key} has no meta for initial state ${initial}`);
+        const url = new URL(`${args.baseUrl}${initialMeta.route.startsWith('/') ? initialMeta.route : `/${initialMeta.route}`}`);
+        url.searchParams.set('lockstep_scenario', scenario.name);
+        url.searchParams.set('lockstep_seed', String(scenario.seed));
+        const initialSelector = testIdSelector(initialMeta.testId);
+        const first = await attemptStep(async () => {
+            await describing(() => `navigating to ${url.pathname}`, () => page.goto(url.toString(), { waitUntil: 'networkidle', timeout }));
+            await settle(page, timeout);
+            await describing(() => `waiting for ${initialSelector} on ${pathnameOf(page.url()) ?? url.pathname}`, () => page.locator(initialSelector).first().waitFor({ state: 'visible', timeout }));
+            await settleVisible(page, timeout);
+        }, log, `${journey.key}/${scenario.name} -> ${initial}`);
+        steps.push({
+            stateKey: initial,
+            transition: null,
+            status: first.status,
+            attempts: first.attempts,
+            error: first.error,
+            screenshotKey: first.status === 'pass' ? await shoot(initial) : null,
+            traceKey: null,
+            operations: drainOps(),
+            routeObserved: pathnameOf(page.url()),
+        });
+        let failed = first.status === 'fail';
+        for (const step of args.path.steps) {
+            const transition = { from: step.from, event: step.event, to: step.to };
+            if (failed) {
+                steps.push({
+                    stateKey: step.to,
+                    transition,
+                    status: 'skipped',
+                    attempts: 0,
+                    error: null,
+                    screenshotKey: null,
+                    traceKey: null,
+                    operations: [],
+                    routeObserved: null,
+                });
+                continue;
+            }
+            const targetMeta = journey.meta.states[step.to];
+            if (!targetMeta)
+                throw new InfrastructureError(`journey ${journey.key} has no meta for state ${step.to}`);
+            const trigger = testIdSelector(triggerTestId(journey, step.from, step.event));
+            const targetSelector = testIdSelector(targetMeta.testId);
+            const target = page.locator(targetSelector).first();
+            const result = await attemptStep(async (attempt) => {
+                // A retry after a click that did land must not click twice.
+                if (attempt > 0 && (await target.isVisible().catch(() => false)))
+                    return;
+                await describing(() => `clicking ${trigger} on ${pathnameOf(page.url()) ?? '?'}`, () => page.locator(trigger).first().click({ timeout }));
+                await park(page);
+                await settle(page, timeout);
+                await describing(() => `waiting for ${targetSelector} after clicking ${trigger}; still on ${pathnameOf(page.url()) ?? '?'}`, () => target.waitFor({ state: 'visible', timeout }));
+                await settleVisible(page, timeout);
+            }, log, `${journey.key}/${scenario.name} ${step.from} --${step.event}--> ${step.to}`);
+            steps.push({
+                stateKey: step.to,
+                transition,
+                status: result.status,
+                attempts: result.attempts,
+                error: result.error,
+                screenshotKey: result.status === 'pass' ? await shoot(step.to) : null,
+                traceKey: null,
+                operations: drainOps(),
+                routeObserved: pathnameOf(page.url()),
+            });
+            if (result.status === 'fail')
+                failed = true;
+        }
+        await page.close().catch(() => { });
+    }
+    finally {
+        try {
+            await context.tracing.stop({ path: traceAbs });
+            traceKey = traceRel;
+        }
+        catch (err) {
+            log(`  trace ${traceRel} failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        await context.close().catch(() => { });
+    }
+    for (const s of steps)
+        s.traceKey = traceKey;
+    return { journeyKey: journey.key, scenario: scenario.name, steps };
+}
+//# sourceMappingURL=walk.js.map

package/dist/walk.js.map

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

package/package.json

@@ -0,0 +1,78 @@
+{
+  "name": "@junejuly-lockstep/reconciler",
+  "version": "0.1.0",
+  "description": "Lockstep CI reconciler: extract the navigation graph, snapshot the GraphQL contract, walk journeys in Playwright against seeded mocks, diff screenshots, and post the run to the platform.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/JuneJulyHealth/lockstep.git",
+    "directory": "packages/reconciler"
+  },
+  "homepage": "https://github.com/JuneJulyHealth/lockstep/tree/main/packages/reconciler#readme",
+  "bugs": {
+    "url": "https://github.com/JuneJulyHealth/lockstep/issues"
+  },
+  "keywords": [
+    "lockstep",
+    "reconciler",
+    "ci",
+    "playwright",
+    "xstate",
+    "journey",
+    "visual-regression",
+    "graphql",
+    "msw"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "lockstep": "./dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "templates",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "provenance": false
+  },
+  "engines": {
+    "node": ">=20.18"
+  },
+  "dependencies": {
+    "@graphql-inspector/core": "^6.2.1",
+    "@xstate/graph": "^3.0.4",
+    "commander": "^13.1.0",
+    "fast-glob": "^3.3.3",
+    "graphql": "^16.10.0",
+    "jiti": "^2.4.2",
+    "pixelmatch": "^7.1.0",
+    "playwright": "^1.50.0",
+    "pngjs": "^7.0.0",
+    "ts-morph": "^25.0.1",
+    "xstate": "^5.19.4",
+    "zod": "^3.24.1",
+    "@junejuly-lockstep/model": "0.1.0",
+    "@junejuly-lockstep/sdk": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.2",
+    "@types/pngjs": "^6.0.5",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.typecheck.json --noEmit",
+    "lint": "eslint src",
+    "test": "vitest run"
+  }
+}

package/templates/example.journey.ts

@@ -0,0 +1,90 @@
+import { createMachine } from 'xstate';
+import type { JourneyMeta } from '@junejuly-lockstep/reconciler';
+
+/**
+ * Lockstep client contract, item 2: one file per journey exporting `machine` and `meta`.
+ * The file name gives the journey key (`book-a-visit.journey.ts` -> `book-a-visit`);
+ * export `key` / `name` to override.
+ *
+ * The app can execute this machine natively (XState v5). Lockstep reads only its config:
+ * flat states, `on` transitions, string guard names. Guard implementations stay here.
+ */
+export const name = 'Book a visit';
+
+export const machine = createMachine(
+  {
+    id: 'bookAVisit',
+    initial: 'start',
+    states: {
+      start: {
+        on: { BEGIN: 'pickTime' },
+      },
+      pickTime: {
+        on: {
+          CHOOSE: { target: 'confirm', guard: 'slotAvailable' },
+          BACK: 'start',
+        },
+      },
+      confirm: {
+        on: {
+          SUBMIT: 'done',
+          BACK: 'pickTime',
+        },
+      },
+      done: { type: 'final' },
+    },
+  },
+  {
+    guards: {
+      slotAvailable: () => true,
+    },
+  },
+);
+
+export const meta: JourneyMeta = {
+  narrative:
+    'Nora, an eligible patient with no visit history, books a visit in under a minute without talking to anyone.',
+  states: {
+    start: {
+      route: '/visits',
+      testId: 'visits-start',
+      intent: 'Entry point: one clear call to action to begin booking.',
+      rules: ['No more than one primary button on screen.'],
+    },
+    pickTime: {
+      route: '/visits/time',
+      testId: 'visits-time',
+      intent: 'Pick a slot from the next seven days; unavailable slots are visible but disabled.',
+      rules: [
+        'Slots render in the patient time zone.',
+        'At least three slots are shown when any exist.',
+      ],
+    },
+    confirm: {
+      route: '/visits/confirm',
+      testId: 'visits-confirm',
+      intent: 'Review the chosen slot and clinician; one tap confirms.',
+      rules: ['Shows date, time, clinician and location.', 'Back keeps the chosen slot selected.'],
+    },
+    done: {
+      route: '/visits/done',
+      testId: 'visits-done',
+      intent: 'Confirmation with the booking reference and a calendar link.',
+      rules: ['Booking reference is visible without scrolling.'],
+    },
+  },
+  /** Which element fires each transition. Missing bindings fall back to data-testid="<event lowercased>". */
+  bindings: [
+    { from: 'start', event: 'BEGIN', testId: 'cta-begin', label: 'Book a visit' },
+    {
+      from: 'pickTime',
+      event: 'CHOOSE',
+      testId: 'slot-first-available',
+      label: 'First available slot',
+    },
+    { from: 'pickTime', event: 'BACK', testId: 'nav-back' },
+    { from: 'confirm', event: 'SUBMIT', testId: 'cta-confirm', label: 'Confirm booking' },
+    { from: 'confirm', event: 'BACK', testId: 'nav-back' },
+  ],
+  assets: [],
+};