waygraph 0.16.0 → 0.16.2

package/dist/live/traverse/traverse.js

@@ -1,207 +1,13 @@
 import { Engine } from "../../engine/engine.js";
-import { buildFlow } from "../../engine/flow/flow.js";
+import { envFlag, envString } from "../../engine/env.js";
 import { MemPage } from "../../engine/mem/mem.js";
-import { buildExploreContext, buildExploreMenu, } from "../auto/explore.js";
-import { detectHere, memStubValue } from "../auto/auto.js";
+import { ignorePageGone, ignoreTimeout } from "../../engine/page-gone.js";
+import { chromiumExecutablePath } from "../../runtime/browser.js";
 import { resolveBaseUrl } from "../../runtime/waygraph-config.js";
-import { EdgeLeaseCoordinator } from "./lease.js";
+import { buildExploreContext, } from "../auto/explore.js";
 import { buildCoverageReport, collectGraphEdgeKeys, defaultCoverageOutPath, formatCoverageLine, writeCoverageReport, } from "./coverage.js";
-import { chromiumExecutablePath } from "../../runtime/browser.js";
-import { envFlag, envString } from "../../engine/env.js";
-import { ignorePageGone, ignoreTimeout } from "../../engine/page-gone.js";
-function seedMem(library, mem, dataJson) {
-    const raw = dataJson ?? envString("WAYGRAPH_DATA") ?? envString("WAYGRAPH_AUTO_MEM");
-    let envParsed = {};
-    if (raw) {
-        try {
-            envParsed = JSON.parse(raw);
-        }
-        catch {
-            throw new Error(`waygraph traverse: --data / WAYGRAPH_DATA is not valid JSON`);
-        }
-    }
-    for (const entry of library.values()) {
-        for (const k of entry.block.requires ?? []) {
-            if (mem.has(k))
-                continue;
-            if (k.name in envParsed) {
-                mem.set(k, envParsed[k.name]);
-                continue;
-            }
-            const def = memStubValue(k);
-            if (def !== undefined)
-                mem.set(k, def);
-        }
-    }
-}
-function snapshotMem(library, mem) {
-    const out = {};
-    for (const entry of library.values()) {
-        for (const k of entry.block.requires ?? []) {
-            if (mem.has(k) && !(k.name in out)) {
-                out[k.name] = mem.get(k);
-            }
-        }
-    }
-    return out;
-}
-function restoreMem(library, mem, snap, dataJson) {
-    seedMem(library, mem, dataJson);
-    for (const entry of library.values()) {
-        for (const k of entry.block.requires ?? []) {
-            if (k.name in snap) {
-                mem.set(k, snap[k.name]);
-            }
-        }
-    }
-}
-function missingMemKeys(entry, mem) {
-    return (entry.block.requires ?? []).filter((k) => !mem.has(k));
-}
-function ensureMem(entry, mem) {
-    const missing = missingMemKeys(entry, mem);
-    if (missing.length === 0)
-        return;
-    throw new Error(`Block "${entry.block.name}" needs Mem keys: ${missing.map((k) => k.name).join(", ")} ` +
-        `(pass --data '{...}' or WAYGRAPH_DATA)`);
-}
-function edgeKey(edge) {
-    const id = edge.instanceOption?.id;
-    return id ? `${edge.block}::${id}` : edge.block;
-}
-async function runOneBlock(engine, entry, context, page, mem) {
-    const flow = buildFlow([entry.block], engine.config);
-    const BLOCK_TIMEOUT_MS = 45_000;
-    let timer;
-    try {
-        const ran = await Promise.race([
-            flow.run(context, mem, { page, closeOnFinish: false }),
-            new Promise((_, reject) => {
-                timer = setTimeout(() => reject(new Error(`Block "${entry.block.name}" timed out after ${BLOCK_TIMEOUT_MS / 1000}s`)), BLOCK_TIMEOUT_MS);
-            }),
-        ]);
-        return ran.result;
-    }
-    finally {
-        if (timer)
-            clearTimeout(timer);
-    }
-}
-async function runTraverseWorker(opts) {
-    const { traverseId, workerIndex, parallel, maxSteps, maxVisitsPerNode, maxVisitsPerEdge, timeoutMs, graph, library, engine, context, mem, leases, } = opts;
-    let page = opts.page;
-    const startUrl = opts.startUrl;
-    const nodeVisits = new Map();
-    const edgeVisits = new Map();
-    const edgesHit = new Set();
-    let steps = 0;
-    const startedAt = Date.now();
-    let lastHere = opts.from ?? null;
-    let exitCode = 0;
-    let leaf;
-    try {
-        for (;;) {
-            if (Date.now() - startedAt > timeoutMs) {
-                console.log(`[Killed timeout[${traverseId}] node=${lastHere ?? "?"} wallMs=${timeoutMs}]`);
-                exitCode = 1;
-                break;
-            }
-            if (steps >= maxSteps) {
-                console.log(`[Killed max-steps[${traverseId}] node=${lastHere ?? "?"} steps=${steps} max=${maxSteps}]`);
-                exitCode = 1;
-                break;
-            }
-            if (page.isClosed()) {
-                page = await context.newPage();
-                if (startUrl) {
-                    await page.goto(startUrl, { waitUntil: "domcontentloaded" }).catch(ignorePageGone);
-                }
-            }
-            const detected = await detectHere(page, library.navBlocks);
-            const here = lastHere ?? detected ?? opts.from ?? null;
-            if (here && (nodeVisits.get(here) ?? 0) >= maxVisitsPerNode) {
-                console.log(`[Killed loop[${traverseId}] node=${here} visits=${nodeVisits.get(here)} max=${maxVisitsPerNode}]`);
-                exitCode = 1;
-                break;
-            }
-            const menu = await buildExploreMenu(page, graph, library, here);
-            const candidates = menu.flat.filter((edge) => {
-                const key = edgeKey(edge);
-                if ((edgeVisits.get(key) ?? 0) >= maxVisitsPerEdge)
-                    return false;
-                if (parallel > 1) {
-                    if (EdgeLeaseCoordinator.partitionIndex(key, parallel) !== workerIndex) {
-                        return false;
-                    }
-                }
-                return true;
-            });
-            if (candidates.length === 0) {
-                const label = here ?? detected ?? "unknown";
-                leaf = label;
-                console.log(`[Reached Leaf Node[${traverseId}] at=${label} steps=${steps}]`);
-                console.error(`waygraph traverse[${traverseId}]: PASS leaf edgesHit=${edgesHit.size} steps=${steps}`);
-                break;
-            }
-            const pick = [...candidates].sort((a, b) => {
-                const aWild = a.from === "*" ? 1 : 0;
-                const bWild = b.from === "*" ? 1 : 0;
-                if (aWild !== bWild)
-                    return aWild - bWild;
-                return edgeKey(a).localeCompare(edgeKey(b));
-            })[0];
-            const key = edgeKey(pick);
-            if (!leases.tryClaim(key, traverseId)) {
-                // Another worker won a race (instance fan-out); treat as unavailable.
-                edgeVisits.set(key, maxVisitsPerEdge);
-                continue;
-            }
-            const entry = library.byName.get(pick.block);
-            if (!entry) {
-                console.log(`[Broke at edge[${traverseId}] block=${pick.block} from=${here ?? "?"} to=${pick.to} reason=not-loaded]`);
-                exitCode = 1;
-                break;
-            }
-            const fromLabel = here ?? pick.from;
-            try {
-                if (pick.instanceOption) {
-                    mem.set(pick.instanceOption.key, pick.instanceOption.value);
-                }
-                ensureMem(entry, mem);
-                console.error(`waygraph traverse[${traverseId}]: step ${steps + 1} ${fromLabel} -[${pick.block}]-> ${pick.to}` +
-                    (pick.label ? ` (${pick.label})` : ""));
-                const out = await runOneBlock(engine, entry, context, page, mem);
-                const observed = typeof out === "object" && out && "__state" in out
-                    ? String(out.__state)
-                    : pick.to;
-                edgeVisits.set(key, (edgeVisits.get(key) ?? 0) + 1);
-                edgesHit.add(key);
-                if (here)
-                    nodeVisits.set(here, (nodeVisits.get(here) ?? 0) + 1);
-                lastHere = observed;
-                steps += 1;
-                if (observed !== pick.to && pick.to !== "*") {
-                    console.error(`waygraph traverse[${traverseId}]: WARN static to=${pick.to} observed=${observed}`);
-                }
-            }
-            catch (err) {
-                const msg = err instanceof Error ? err.message : String(err);
-                console.log(`[Broke at edge[${traverseId}] block=${pick.block} from=${fromLabel} to=${pick.to}] ${msg}`);
-                exitCode = 1;
-                break;
-            }
-        }
-    }
-    finally {
-        console.error(`waygraph traverse[${traverseId}]: done exit=${exitCode} steps=${steps} edgesHit=${edgesHit.size}`);
-    }
-    return {
-        exitCode,
-        steps,
-        edgesHit: [...edgesHit],
-        ...(leaf ? { leaf } : {}),
-    };
-}
+import { EdgeLeaseCoordinator } from "./lease.js";
+import { restoreMem, runTraverseWorker, seedMem, snapshotMem } from "./worker.js";
 /**
  * Serial or parallel graph crawl. Prints greppable PASS/FAIL + Coverage lines.
  * Exit: 0 leaf ok (+ coverage ok), 1 break/timeout, 2 coverage gate fail (Phase E).

package/dist/live/traverse/worker.d.ts

@@ -0,0 +1,37 @@
+import type { BrowserContext, Page } from "@playwright/test";
+import type { WaygraphGraph } from "../../analysis/graph.js";
+import type { Checkpoint } from "../../engine/checkpoint/checkpoint.js";
+import { Engine } from "../../engine/engine.js";
+import { MemPage, type MemKey } from "../../engine/mem/mem.js";
+import type { BlockEntry } from "../../manifest/project.js";
+import { buildExploreContext, type ExploreEdge } from "../auto/explore.js";
+import { EdgeLeaseCoordinator } from "./lease.js";
+import type { TraverseWorkerResult } from "./traverse.js";
+export declare function seedMem(library: Map<string, BlockEntry>, mem: MemPage, dataJson?: string): void;
+export declare function snapshotMem(library: Map<string, BlockEntry>, mem: MemPage): Record<string, unknown>;
+export declare function restoreMem(library: Map<string, BlockEntry>, mem: MemPage, snap: Record<string, unknown>, dataJson?: string): void;
+export declare function missingMemKeys(entry: BlockEntry, mem: MemPage): MemKey<unknown>[];
+export declare function ensureMem(entry: BlockEntry, mem: MemPage): void;
+export declare function edgeKey(edge: ExploreEdge): string;
+export declare function runOneBlock(engine: Engine, entry: BlockEntry, context: BrowserContext, page: Page, mem: MemPage): Promise<Checkpoint<string>>;
+export interface WorkerOpts {
+    traverseId: string;
+    workerIndex: number;
+    parallel: number;
+    maxSteps: number;
+    maxVisitsPerNode: number;
+    maxVisitsPerEdge: number;
+    timeoutMs: number;
+    from?: string;
+    startUrl?: string;
+    baseURL?: string;
+    data?: string;
+    graph: WaygraphGraph;
+    library: Awaited<ReturnType<typeof buildExploreContext>>["library"];
+    engine: Engine;
+    context: BrowserContext;
+    page: Page;
+    mem: MemPage;
+    leases: EdgeLeaseCoordinator;
+}
+export declare function runTraverseWorker(opts: WorkerOpts): Promise<TraverseWorkerResult>;

package/dist/live/traverse/worker.js

@@ -0,0 +1,200 @@
+import { envString } from "../../engine/env.js";
+import { buildFlow } from "../../engine/flow/flow.js";
+import { ignorePageGone } from "../../engine/page-gone.js";
+import { detectHere } from "../auto/auto.js";
+import { buildExploreMenu } from "../auto/explore.js";
+import { memStubValue } from "../auto/mem.js";
+import { EdgeLeaseCoordinator } from "./lease.js";
+export function seedMem(library, mem, dataJson) {
+    const raw = dataJson ?? envString("WAYGRAPH_DATA") ?? envString("WAYGRAPH_AUTO_MEM");
+    let envParsed = {};
+    if (raw) {
+        try {
+            envParsed = JSON.parse(raw);
+        }
+        catch {
+            throw new Error(`waygraph traverse: --data / WAYGRAPH_DATA is not valid JSON`);
+        }
+    }
+    for (const entry of library.values()) {
+        for (const k of entry.block.requires ?? []) {
+            if (mem.has(k))
+                continue;
+            if (k.name in envParsed) {
+                mem.set(k, envParsed[k.name]);
+                continue;
+            }
+            const def = memStubValue(k);
+            if (def !== undefined)
+                mem.set(k, def);
+        }
+    }
+}
+export function snapshotMem(library, mem) {
+    const out = {};
+    for (const entry of library.values()) {
+        for (const k of entry.block.requires ?? []) {
+            if (mem.has(k) && !(k.name in out)) {
+                out[k.name] = mem.get(k);
+            }
+        }
+    }
+    return out;
+}
+export function restoreMem(library, mem, snap, dataJson) {
+    seedMem(library, mem, dataJson);
+    for (const entry of library.values()) {
+        for (const k of entry.block.requires ?? []) {
+            if (k.name in snap) {
+                mem.set(k, snap[k.name]);
+            }
+        }
+    }
+}
+export function missingMemKeys(entry, mem) {
+    return (entry.block.requires ?? []).filter((k) => !mem.has(k));
+}
+export function ensureMem(entry, mem) {
+    const missing = missingMemKeys(entry, mem);
+    if (missing.length === 0)
+        return;
+    throw new Error(`Block "${entry.block.name}" needs Mem keys: ${missing.map((k) => k.name).join(", ")} ` +
+        `(pass --data '{...}' or WAYGRAPH_DATA)`);
+}
+export function edgeKey(edge) {
+    const id = edge.instanceOption?.id;
+    return id ? `${edge.block}::${id}` : edge.block;
+}
+export async function runOneBlock(engine, entry, context, page, mem) {
+    const flow = buildFlow([entry.block], engine.config);
+    const BLOCK_TIMEOUT_MS = 45000;
+    let timer;
+    try {
+        const ran = await Promise.race([
+            flow.run(context, mem, { page, closeOnFinish: false }),
+            new Promise((_, reject) => {
+                timer = setTimeout(() => reject(new Error(`Block "${entry.block.name}" timed out after ${BLOCK_TIMEOUT_MS / 1000}s`)), BLOCK_TIMEOUT_MS);
+            }),
+        ]);
+        return ran.result;
+    }
+    finally {
+        if (timer)
+            clearTimeout(timer);
+    }
+}
+export async function runTraverseWorker(opts) {
+    const { traverseId, workerIndex, parallel, maxSteps, maxVisitsPerNode, maxVisitsPerEdge, timeoutMs, graph, library, engine, context, mem, leases, } = opts;
+    let page = opts.page;
+    const startUrl = opts.startUrl;
+    const nodeVisits = new Map();
+    const edgeVisits = new Map();
+    const edgesHit = new Set();
+    let steps = 0;
+    const startedAt = Date.now();
+    let lastHere = opts.from ?? null;
+    let exitCode = 0;
+    let leaf;
+    try {
+        for (;;) {
+            if (Date.now() - startedAt > timeoutMs) {
+                console.log(`[Killed timeout[${traverseId}] node=${lastHere ?? "?"} wallMs=${timeoutMs}]`);
+                exitCode = 1;
+                break;
+            }
+            if (steps >= maxSteps) {
+                console.log(`[Killed max-steps[${traverseId}] node=${lastHere ?? "?"} steps=${steps} max=${maxSteps}]`);
+                exitCode = 1;
+                break;
+            }
+            if (page.isClosed()) {
+                page = await context.newPage();
+                if (startUrl) {
+                    await page.goto(startUrl, { waitUntil: "domcontentloaded" }).catch(ignorePageGone);
+                }
+            }
+            const detected = await detectHere(page, library.navBlocks);
+            const here = lastHere ?? detected ?? opts.from ?? null;
+            if (here && (nodeVisits.get(here) ?? 0) >= maxVisitsPerNode) {
+                console.log(`[Killed loop[${traverseId}] node=${here} visits=${nodeVisits.get(here)} max=${maxVisitsPerNode}]`);
+                exitCode = 1;
+                break;
+            }
+            const menu = await buildExploreMenu(page, graph, library, here);
+            const candidates = menu.flat.filter((edge) => {
+                const key = edgeKey(edge);
+                if ((edgeVisits.get(key) ?? 0) >= maxVisitsPerEdge)
+                    return false;
+                if (parallel > 1) {
+                    if (EdgeLeaseCoordinator.partitionIndex(key, parallel) !== workerIndex) {
+                        return false;
+                    }
+                }
+                return true;
+            });
+            if (candidates.length === 0) {
+                const label = here ?? detected ?? "unknown";
+                leaf = label;
+                console.log(`[Reached Leaf Node[${traverseId}] at=${label} steps=${steps}]`);
+                console.error(`waygraph traverse[${traverseId}]: PASS leaf edgesHit=${edgesHit.size} steps=${steps}`);
+                break;
+            }
+            const pick = [...candidates].sort((a, b) => {
+                const aWild = a.from === "*" ? 1 : 0;
+                const bWild = b.from === "*" ? 1 : 0;
+                if (aWild !== bWild)
+                    return aWild - bWild;
+                return edgeKey(a).localeCompare(edgeKey(b));
+            })[0];
+            const key = edgeKey(pick);
+            if (!leases.tryClaim(key, traverseId)) {
+                // Another worker won a race (instance fan-out); treat as unavailable.
+                edgeVisits.set(key, maxVisitsPerEdge);
+                continue;
+            }
+            const entry = library.byName.get(pick.block);
+            if (!entry) {
+                console.log(`[Broke at edge[${traverseId}] block=${pick.block} from=${here ?? "?"} to=${pick.to} reason=not-loaded]`);
+                exitCode = 1;
+                break;
+            }
+            const fromLabel = here ?? pick.from;
+            try {
+                if (pick.instanceOption) {
+                    mem.set(pick.instanceOption.key, pick.instanceOption.value);
+                }
+                ensureMem(entry, mem);
+                console.error(`waygraph traverse[${traverseId}]: step ${steps + 1} ${fromLabel} -[${pick.block}]-> ${pick.to}` +
+                    (pick.label ? ` (${pick.label})` : ""));
+                const out = await runOneBlock(engine, entry, context, page, mem);
+                const observed = typeof out === "object" && out && "__state" in out
+                    ? String(out.__state)
+                    : pick.to;
+                edgeVisits.set(key, (edgeVisits.get(key) ?? 0) + 1);
+                edgesHit.add(key);
+                if (here)
+                    nodeVisits.set(here, (nodeVisits.get(here) ?? 0) + 1);
+                lastHere = observed;
+                steps += 1;
+                if (observed !== pick.to && pick.to !== "*") {
+                    console.error(`waygraph traverse[${traverseId}]: WARN static to=${pick.to} observed=${observed}`);
+                }
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                console.log(`[Broke at edge[${traverseId}] block=${pick.block} from=${fromLabel} to=${pick.to}] ${msg}`);
+                exitCode = 1;
+                break;
+            }
+        }
+    }
+    finally {
+        console.error(`waygraph traverse[${traverseId}]: done exit=${exitCode} steps=${steps} edgesHit=${edgesHit.size}`);
+    }
+    return {
+        exitCode,
+        steps,
+        edgesHit: [...edgesHit],
+        ...(leaf ? { leaf } : {}),
+    };
+}

package/dist/runner/plan/find.js

@@ -32,11 +32,11 @@ export async function findBlock(projectDir, ref) {
     if (byRuntimeName.length === 1)
         return byRuntimeName[0];
     if (byRuntimeName.length > 1) {
-        throw new Error("waygraph chain: \"" + ref + "\" matches " + byRuntimeName.length + " Blocks by name - " +
+        throw new Error("waygraph run --blocks: \"" + ref + "\" matches " + byRuntimeName.length + " Blocks by name - " +
             byRuntimeName.map((b) => b.exportName + " (" + b.file + ")").join(", ") +
             ". Use the export name to disambiguate.");
     }
-    throw new Error("waygraph chain: no Block named \"" + ref + "\" found under " + projectDir);
+    throw new Error("waygraph run --blocks: no Block named \"" + ref + "\" found under " + projectDir);
 }
 /**
  * Finds an already-defined Flow by its export name (e.g. loginFlow) among

package/dist/runner/plan/plan.js

@@ -24,7 +24,7 @@ async function findBareFlow(projectDir, spec) {
 function parseSegments(spec) {
     const segments = parseChainSpec(spec);
     if (segments.length === 0)
-        throw new Error("waygraph chain: empty spec - give at least one block name");
+        throw new Error("waygraph run --blocks: empty spec - give at least one block name");
     return segments;
 }
 async function resolveSegment(projectDir, seg, mem, options) {

package/dist/runner/plan/seed-mem.js

@@ -4,7 +4,7 @@ const isRecord = (v) => v !== null && typeof v === "object" && !Array.isArray(v)
 function seedMemFromRequires(mem, requires, json, label, stubActive) {
     if (requires.length === 0) {
         if (json !== undefined) {
-            throw new Error("waygraph chain: \"" + label + "\" takes no input (empty requires) but got a payload: " + json);
+            throw new Error("waygraph run --blocks: \"" + label + "\" takes no input (empty requires) but got a payload: " + json);
         }
         return;
     }
@@ -22,7 +22,7 @@ function seedMemFromRequires(mem, requires, json, label, stubActive) {
             haveParsed = true;
         }
         catch (err) {
-            throw new Error("waygraph chain: \"" + label + "\" payload is not valid JSON - " + String(err));
+            throw new Error("waygraph run --blocks: \"" + label + "\" payload is not valid JSON - " + String(err));
         }
     }
     if (!haveParsed) {
@@ -30,7 +30,7 @@ function seedMemFromRequires(mem, requires, json, label, stubActive) {
         // this flow; when it is, fall through with an empty object so the
         // per-key loop below gets a chance to fill each one from the registry.
         if (!stubActive) {
-            throw new Error("waygraph chain: \"" + label + "\" requires " + requires.map((k) => k.name).join(", ") +
+            throw new Error("waygraph run --blocks: \"" + label + "\" requires " + requires.map((k) => k.name).join(", ") +
                 " - give a JSON payload (inline blockName({...}) or --data '{...}'), or enable --mem-stub" +
                 " with registerMemStub for these keys");
         }
@@ -54,7 +54,7 @@ function seedMemFromRequires(mem, requires, json, label, stubActive) {
         return;
     }
     if (!isRecord(parsed)) {
-        throw new Error("waygraph chain: \"" + label + "\" requires " + requires.length + " keys (" +
+        throw new Error("waygraph run --blocks: \"" + label + "\" requires " + requires.length + " keys (" +
             requires.map((k) => k.name).join(", ") + ") - payload must be an object keyed by each key's name");
     }
     const payload = parsed;
@@ -72,7 +72,7 @@ function seedMemFromRequires(mem, requires, json, label, stubActive) {
         stillMissing.push(k);
     }
     if (stillMissing.length > 0) {
-        throw new Error("waygraph chain: \"" + label + "\" payload is missing required key(s): " +
+        throw new Error("waygraph run --blocks: \"" + label + "\" payload is missing required key(s): " +
             stillMissing.map((k) => "\"" + k.name + "\"").join(", "));
     }
 }

package/dist/runner/plan/spec.js

@@ -8,7 +8,7 @@ export function parseChainSpec(spec) {
         .map((s) => {
         const m = /^([A-Za-z_$][\w-]*)\s*(?:\(([\s\S]*)\))?$/.exec(s);
         if (!m) {
-            throw new Error("waygraph chain: could not parse segment \"" + s + "\" - expected \"blockName\" or \"blockName({...json...})\"");
+            throw new Error("waygraph run --blocks: could not parse segment \"" + s + "\" - expected \"blockName\" or \"blockName({...json...})\"");
         }
         const ref = m[1];
         const json = m[2] ? m[2].trim() : undefined;

package/examples/saucedemo/src/blocks/saucedemo-web/checkout-step-two/methods/finish-order.method.block.ts

@@ -1,4 +1,4 @@
-import { defineMethodBlock, Trait, narrate } from "waygraph";
+import { defineMethodBlock, Trait } from "waygraph";
 import {
   CheckoutOverviewPage,
   OrderComplete,
@@ -21,9 +21,7 @@ export const FinishOrderBlock = defineMethodBlock({
   instruction: {
     async act(page) {
       const finishButton = page.locator(CheckoutOverviewSel.finishBtn);
-      await narrate(finishButton, "Placing the order", () =>
-        finishButton.click(),
-      );
+      await finishButton.click();
     },
     verify: [
       Trait.text(
@@ -31,35 +29,5 @@ export const FinishOrderBlock = defineMethodBlock({
         "Thank you for your order!",
       ),
     ],
-    // Shown AFTER act (order already placed) - selectors must match the
-    // completion page, not #finish on the overview.
-    slides: [
-      {
-        caption: "Checkout is a short pipeline",
-        detail: "Cart -> info -> overview -> done. You just placed the order.",
-        tag: "YAP",
-        tone: "info",
-        duration: true,
-      },
-      {
-        caption: "Completion page is the durable proof",
-        detail:
-          "tone: success - the thank-you header is what verify asserts on.",
-        tag: "YAP",
-        tone: "success",
-        selector: CheckoutOverviewSel.completeHeader,
-        duration: 2500,
-        fastMode: 700,
-      },
-      {
-        caption: "Episode continues after this yap",
-        detail: "Next step rings the same banner, then you move on.",
-        tag: "YAP",
-        tone: "planned",
-        selector: CheckoutOverviewSel.completeHeader,
-        duration: true,
-        fastMode: 500,
-      },
-    ],
   },
 });

package/examples/saucedemo/src/flows/checkout-then-browse-again.flow.ts

@@ -12,6 +12,7 @@ import { FillLastNameBlock } from "../blocks/saucedemo-web/checkout-step-one/met
 import { FillPostalCodeBlock } from "../blocks/saucedemo-web/checkout-step-one/methods/fill-postal-code.method.block.js";
 import { SubmitCheckoutInfoBlock } from "../blocks/saucedemo-web/checkout-step-one/methods/submit-checkout-info.method.block.js";
 import { FinishOrderBlock } from "../blocks/saucedemo-web/checkout-step-two/methods/finish-order.method.block.js";
+import { orderPlacedYap, placingOrder } from "../stubs/finish-order.js";
 import { NavBackToProductsBlock } from "../blocks/saucedemo-web/inventory-item/nav-back-to-products.block.js";
 
 /** Full checkout, then the "Back Home" click-based Nav Block returns to the catalogue. */
@@ -35,6 +36,6 @@ export const checkoutThenBrowseAgainFlow = engine
   .method(FillLastNameBlock)
   .method(FillPostalCodeBlock)
   .method(SubmitCheckoutInfoBlock)
-  .method(FinishOrderBlock)
+  .method(FinishOrderBlock.stubBefore(placingOrder).stubAfter(orderPlacedYap))
   .gotoPage(NavBackToProductsBlock)
   .end();

package/examples/saucedemo/src/flows/checkout.flow.ts

@@ -12,6 +12,7 @@ import { FillLastNameBlock } from "../blocks/saucedemo-web/checkout-step-one/met
 import { FillPostalCodeBlock } from "../blocks/saucedemo-web/checkout-step-one/methods/fill-postal-code.method.block.js";
 import { SubmitCheckoutInfoBlock } from "../blocks/saucedemo-web/checkout-step-one/methods/submit-checkout-info.method.block.js";
 import { FinishOrderBlock } from "../blocks/saucedemo-web/checkout-step-two/methods/finish-order.method.block.js";
+import { orderPlacedYap, placingOrder } from "../stubs/finish-order.js";
 import { LoginSel } from "../blocks/saucedemo-web/methods/login.sel.js";
 
 export const checkoutFlow = engine
@@ -80,5 +81,5 @@ export const checkoutFlow = engine
     }),
   )
   .method(SubmitCheckoutInfoBlock.stubBefore((ctx) => ctx.hideCaption()))
-  .method(FinishOrderBlock)
+  .method(FinishOrderBlock.stubBefore(placingOrder).stubAfter(orderPlacedYap))
   .end();

package/examples/saucedemo/src/flows/shop.flow.ts

@@ -8,6 +8,7 @@ import { FillLastNameBlock } from "../blocks/saucedemo-web/checkout-step-one/met
 import { FillPostalCodeBlock } from "../blocks/saucedemo-web/checkout-step-one/methods/fill-postal-code.method.block.js";
 import { SubmitCheckoutInfoBlock } from "../blocks/saucedemo-web/checkout-step-one/methods/submit-checkout-info.method.block.js";
 import { FinishOrderBlock } from "../blocks/saucedemo-web/checkout-step-two/methods/finish-order.method.block.js";
+import { orderPlacedYap, placingOrder } from "../stubs/finish-order.js";
 
 /** Add the selected item, check out and place the order. Starts signed in (run it after loginFlow). */
 export const shopFlow = engine
@@ -20,5 +21,5 @@ export const shopFlow = engine
   .method(FillLastNameBlock)
   .method(FillPostalCodeBlock)
   .method(SubmitCheckoutInfoBlock)
-  .method(FinishOrderBlock)
+  .method(FinishOrderBlock.stubBefore(placingOrder).stubAfter(orderPlacedYap))
   .end();