waygraph 0.15.38 → 0.15.39

package/dist/cli/flags.d.ts

@@ -15,6 +15,10 @@ interface RunFlags {
     data?: string;
     /** Fill any requires key with no --data coverage from registerMemStub's registry (--mem-stub). */
     memStub?: boolean;
+    /** run only: explore every .branch() path (runBranchRegression), cloning the session at each branch point. */
+    allBranches?: boolean;
+    /** --all-branches only: one shared session (no cloning) - follows the single live-dispatch path instead. */
+    sharedSession?: boolean;
     /** Flow/chain spec from --blocks <spec>. */
     blocks?: string;
     /** auto path-find: --blocks <fromCheckpoint> <toCheckpoint>. */

package/dist/cli/flags.js

@@ -141,6 +141,12 @@ export function parseRunFlags(argv) {
         else if (a === "--mem-stub") {
             out.memStub = true;
         }
+        else if (a === "--all-branches") {
+            out.allBranches = true;
+        }
+        else if (a === "--shared-session") {
+            out.sharedSession = true;
+        }
         else if (a === "--video" || a.startsWith("--video=")) {
             if (a.startsWith("--video=")) {
                 out.video = a.slice("--video=".length);
@@ -271,6 +277,12 @@ export function applyRunFlags(flags, opts) {
     if (flags.memStub) {
         process.env.WAYGRAPH_MEM_STUB = "1";
     }
+    if (flags.allBranches) {
+        process.env.WAYGRAPH_ALL_BRANCHES = "1";
+    }
+    if (flags.sharedSession) {
+        process.env.WAYGRAPH_SHARED_SESSION = "1";
+    }
     if (flags.fast) {
         process.env.WAYGRAPH_DEMO_FAST = "1";
     }

package/dist/cli/usage.js

@@ -162,6 +162,11 @@ Primary (less is more):
   waygraph run   [--blocks <flow|file|spec>]  Execute (no overlay unless --step)
                  --data '{...}'
                  --mem-stub                Same as demo's --mem-stub
+                 --all-branches            Bare Flow ref only: explore every MapBuilder.branch()
+                                           path, cloning the session (storageState+URL) at each
+                                           branch point - see runBranchRegression()
+                 --shared-session          With --all-branches: one shared session instead of
+                                           cloning (follows only the live-dispatch path)
                  --non-headless            Show browser
                  --video [dir]             Record .webm
                  --video-viewport WxH       Recording size (default run: 1280x720)

package/dist/runner/main.js

@@ -8,7 +8,7 @@ import { isExpectedChainFailure, parseVideoViewport, runChainedFlows, runJsonRep
 import { runStepMode } from "./step-mode.js";
 import { connect } from "../types.js";
 import { MemPage } from "../mem-page.js";
-import { Engine, start, end, chainFlow, isFastForwardBlock } from "../engine.js";
+import { Engine, start, end, chainFlow, isFastForwardBlock, branchRoutes, runBranchRegression } from "../engine.js";
 
 async function main() {
   const projectDir = process.argv[2];
@@ -275,6 +275,9 @@ async function main() {
       if (r.seedMem) r.seedMem();
     }
   }
+  if (process.env.WAYGRAPH_ALL_BRANCHES === "1") {
+    return runAllBranchesMode(chainFlows, mem, baseURL, headed, engine);
+  }
   if (step || jsonReport || baseURL || videoDir) {
     const { chromium } = await import("@playwright/test");
     // --start-maximized (step mode only): viewport: null alone only made
@@ -389,6 +392,53 @@ async function main() {
   }
 }
 
+/**
+ * `waygraph run --blocks <flowName> --all-branches`: explore every path through that flow's own
+ * `.branch()` tree (see src/engine/branch-regression.ts), not just whichever one the live state
+ * would dispatch to. Needs a single, bare Flow reference - a multi-segment chain spec has no one
+ * Flow to walk. `--shared-session` opts out of session cloning (WAYGRAPH_SHARED_SESSION=1).
+ */
+async function runAllBranchesMode(chainFlows, mem, baseURL, headed, engine) {
+  if (!chainFlows || chainFlows.length !== 1) {
+    console.error(
+      "waygraph run --all-branches: needs a single Flow reference (e.g. --blocks loginFlow), " +
+        "not a multi-segment chain spec - nothing else has one branch tree to explore.",
+    );
+    process.exitCode = 1;
+    return;
+  }
+  const flow = chainFlows[0];
+  if (!branchRoutes(flow)) {
+    console.error(
+      "waygraph run --all-branches: this Flow was not built with MapBuilder.branch() - " +
+        "there is no branch tree to explore. Run it normally instead.",
+    );
+    process.exitCode = 1;
+    return;
+  }
+  const { chromium } = await import("@playwright/test");
+  const browser = await chromium.launch({ headless: !headed });
+  const cloneSession = process.env.WAYGRAPH_SHARED_SESSION !== "1";
+  try {
+    const context = await browser.newContext(baseURL ? { baseURL } : undefined);
+    const results = await runBranchRegression(flow, context, mem, { cloneSession });
+    for (const r of results) {
+      const line = `waygraph run --all-branches: ${r.path || "(root)"} -> ${r.status}` +
+        (r.result ? ` (${JSON.stringify(r.result)})` : "") +
+        (r.error ? ` - ${r.error}` : "");
+      console.log(line);
+    }
+    const failed = results.filter((r) => r.status === "failed");
+    if (failed.length) {
+      console.error(`waygraph run --all-branches: ${failed.length}/${results.length} path(s) failed`);
+      process.exitCode = 1;
+    }
+  } finally {
+    await browser.close();
+  }
+  void engine;
+}
+
 export function startRunner() {
   main().catch((err) => {
     console.error(err && err.stack ? err.stack : String(err));

package/examples/saucedemo/.waygraph-auto/aaae4fb0.log

@@ -0,0 +1,20 @@
+[11:12:59.725] waygraph pilot: stub.before ctx.title("Signing in · mobile")
+[11:12:59.725] waygraph pilot: stub.before ctx.todos n=6 index=0
+[11:12:59.725] waygraph pilot: stub.before ctx.device(mobile)
+[11:12:59.725] waygraph pilot: stub.before ctx.zoom(1.35)
+[11:12:59.725] waygraph pilot: stub.before ring #user-name tone=info label="Username"
+[11:13:00.015] waygraph pilot: stub.after ctx.todos n=6 index=1
+[11:13:01.590] waygraph pilot: stub.before ring #password tone=planned label="Password"
+[11:13:01.964] waygraph pilot: stub.after ctx.todos n=6 index=2
+[11:13:03.710] waygraph pilot: stub.before ring #login-button tone=warning label="Login"
+[11:13:03.904] waygraph pilot: stub.after ctx.title("Inventory · landscape")
+[11:13:03.904] waygraph pilot: stub.after ctx.todos n=6 index=3
+[11:13:03.904] waygraph pilot: stub.after ctx.device(mobile)
+[11:13:03.904] waygraph pilot: stub.after ring .inventory_list tone=success label="Product shelf"
+[11:13:06.313] waygraph pilot: stub.before ctx.title("Open cart · landscape")
+[11:13:06.313] waygraph pilot: stub.before ctx.todos n=6 index=5
+[11:13:06.313] waygraph pilot: stub.before ctx.device(mobile)
+[11:13:06.313] waygraph pilot: stub.before ctx.zoom(1.4)
+[11:13:06.313] waygraph pilot: stub.before ring .shopping_cart_link tone=planned label="Cart"
+[11:13:06.502] waygraph pilot: stub.after ctx.title("Your cart · desktop")
+[11:13:06.502] waygraph pilot: stub.after ring .cart_item tone=success label="Cart items"

package/examples/saucedemo/.waygraph-auto/b2d2dbb2.log

@@ -0,0 +1,22 @@
+[11:13:06.492] waygraph pilot: stub.before ctx.title("Signing in · mobile")
+[11:13:06.493] waygraph pilot: stub.before ctx.todos n=6 index=0
+[11:13:06.493] waygraph pilot: stub.before ctx.device(mobile)
+[11:13:06.493] waygraph pilot: stub.before ctx.zoom(1.35)
+[11:13:06.493] waygraph pilot: stub.before ring #user-name tone=info label="Username"
+[11:13:06.696] waygraph pilot: stub.after ctx.todos n=6 index=1
+[11:13:09.771] waygraph pilot: stub.before ring #password tone=planned label="Password"
+[11:13:09.947] waygraph pilot: stub.after ctx.todos n=6 index=2
+[11:13:12.614] waygraph pilot: stub.before ring #login-button tone=warning label="Login"
+[11:13:12.755] waygraph pilot: stub.after ctx.title("Inventory · landscape")
+[11:13:12.756] waygraph pilot: stub.after ctx.todos n=6 index=3
+[11:13:12.756] waygraph pilot: stub.after ctx.device(mobile)
+[11:13:12.756] waygraph pilot: stub.after ring .inventory_list tone=success label="Product shelf"
+[11:13:16.803] waygraph pilot: stub.before ctx.title("Pick a product · tablet")
+[11:13:16.803] waygraph pilot: stub.before ctx.todos n=6 index=3
+[11:13:16.803] waygraph pilot: stub.before ctx.device(tablet)
+[11:13:16.803] waygraph pilot: stub.before ctx.zoom(1.35)
+[11:13:16.803] waygraph pilot: stub.before ring div.inventory_item:has(button[data-test="add-to-cart-sauce-labs-backpack"], button[data-test="remove-sauce-labs-backpack"]) .inventory_item_name tone=info label="Sauce Labs Backpack"
+[11:13:16.803] waygraph pilot: stub.before ring [data-test="add-to-cart-sauce-labs-backpack"] tone=success label="Add to cart"
+[11:13:17.007] waygraph pilot: stub.after ctx.title("In the cart")
+[11:13:17.007] waygraph pilot: stub.after ctx.todos n=6 index=4
+[11:13:17.010] waygraph pilot: stub.after ring .shopping_cart_badge tone=success label="Cart badge"

package/examples/saucedemo/.waygraph-auto/c851cc53.log

@@ -0,0 +1,6 @@
+[11:12:58.813] waygraph pilot: stub.before ctx.title("Signing in · mobile")
+[11:12:58.815] waygraph pilot: stub.before ctx.todos n=6 index=0
+[11:12:58.816] waygraph pilot: stub.before ctx.device(mobile)
+[11:12:58.816] waygraph pilot: stub.before ctx.zoom(1.35)
+[11:12:58.816] waygraph pilot: stub.before ring #user-name tone=info label="Username"
+[11:12:59.236] waygraph pilot: stub.after ctx.todos n=6 index=1

package/examples/saucedemo/.waygraph-auto/ce584949.log

@@ -0,0 +1,5 @@
+[11:12:42.451] waygraph pilot: highlight ctx.todos n=3 index=0
+[11:12:42.451] waygraph pilot: highlight ring #user-name tone=planned label="Username"
+[11:12:42.452] waygraph pilot: highlight ring #password tone=info label="Password"
+[11:12:45.225] waygraph pilot: highlight ring #no-such-element-waygraph tone=danger label="Gone"
+[11:12:48.220] waygraph pilot: highlight ring #login-button tone=success label="Login"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "waygraph",
-  "version": "0.15.38",
+  "version": "0.15.39",
   "type": "module",
   "description": "A typed graph of reusable Blocks for driving a browser through E2E flows.",
   "license": "MIT",