waygraph 0.12.12 → 0.12.13

package/README.md

@@ -218,10 +218,15 @@ so it drops straight into `defineFlow([start, ..., composed, ..., end])` like an
 `fastForwardComposeBlock(name, steps)` is the same shape marked for **wall-clock
 fast-forward**: one opaque demo step that **blitzes** (no per-inner gate, no smooth
 cursor theater, Playwright slowMo off for that flow unless `WAYGRAPH_SLOWMO` is set)
-unless `waygraph demo --ff-expand`. Put **several** FF units in one Flow when you need
-to race past auth, then a heavy dashboard settle, then watch the interesting middle.
-Saucedemo `checkoutFlow` uses `ff-owner-auth` for the login prefix; `loginFlow` stays
-expanded for Sign In narration. See `docs/proposals/traverse-ffcompose-rfc.md`.
+unless expanded. Put **several** FF units in one Flow when you need to race past auth,
+then a heavy dashboard settle, then watch the interesting middle.
+
+**Dispute / disable FF:** `waygraph demo --ff-disabled` (alias `--no-ff`) expands every
+FFCompose into its inner Blocks so a broken login step is visible as its own panel row.
+Former FF inners keep blitz pacing so wall-clock stays comparable to opaque FF (same
+real acts). `--ff-expand` is the older expand-only flag (same flatten). Saucedemo
+`checkoutFlow` uses `ff-owner-auth` for the login prefix; `loginFlow` stays expanded for
+Sign In narration. See `docs/proposals/traverse-ffcompose-rfc.md`.
 `spawnTab(entry, page, mem)` drives a genuinely separate second tab through its own
 Block/Flow, in the same browser context an existing `page` already belongs to - the
 pattern `observe()` could already reach for (it's the only phase allowed to touch

package/dist/auto-explore.js

@@ -251,6 +251,8 @@ export async function buildExploreMenu(page, graph, library, here) {
         if (!(await navRunnable(page, entry)))
             continue;
         if (here === null) {
+            // Bootstrap only: URL deep-links as "Start here". Click-nav needs a live
+            // control so it cannot seed an unknown page.
             if (!isUrlNav(entry))
                 continue;
             push(navigate, edge);
@@ -258,6 +260,12 @@ export async function buildExploreMenu(page, graph, library, here) {
         }
         if (edge.to === here)
             continue;
+        // Known screen: do NOT dump every defineNavBlock({ url }) under Navigate.
+        // Graph still marks NavBlocks from:"*" for pathfinding/traverse; auto menu
+        // only offers click-nav whose control is visible on this page (navRunnable).
+        // Otherwise LoginForm lists every app route + mailpit as if legal moves.
+        if (isUrlNav(entry))
+            continue;
         if (isBackEdge(edge) && (edge.from === here || edge.from === "*")) {
             push(back, edge);
         }

package/dist/cli.d.ts

@@ -4,7 +4,7 @@
  *
  * Primary verbs (less is more):
  *   auto   Explore picker; `.flow.ts` / `--blocks From To` = run that path
- *   demo   Watch (step overlay); `--blocks` `--data` `--auto-next` `--fast` `--full` `--ff-expand`
+ *   demo   Watch (step overlay); `--blocks` `--data` `--auto-next` `--fast` `--full` `--ff-expand` `--ff-disabled`
  *   run    Execute; `--blocks` `--data` `--non-headless` `--video`
  *
  * Also: list / nav / validate / check / graph / init / agent-dive / traverse / try

package/dist/cli.js

@@ -4,7 +4,7 @@
  *
  * Primary verbs (less is more):
  *   auto   Explore picker; `.flow.ts` / `--blocks From To` = run that path
- *   demo   Watch (step overlay); `--blocks` `--data` `--auto-next` `--fast` `--full` `--ff-expand`
+ *   demo   Watch (step overlay); `--blocks` `--data` `--auto-next` `--fast` `--full` `--ff-expand` `--ff-disabled`
  *   run    Execute; `--blocks` `--data` `--non-headless` `--video`
  *
  * Also: list / nav / validate / check / graph / init / agent-dive / traverse / try
@@ -2170,11 +2170,11 @@ async function runStepMode(engine, start, end, context, page, mem, resolved, slo
     if ((clearSession || r.resetSession) && i > 0) {
       await resetPageState(context, page, baseURL);
     }
-    // gatesFast: --fast (whole run) or FFCompose opaque steps (one short gate).
-    // skipTheater: WAYGRAPH_FAST_BLOCKS **or** FFCompose — wall-clock blitz
-    // (overlay delays). --fast alone never sets skipTheater.
-    pacing.gatesFast = demoFast || !!r.block.fastForward;
-    pacing.skipTheater = fastBlockNames.has(r.block.name) || !!r.block.fastForward;
+    // gatesFast / skipTheater: opaque FF, former-FF inners (--ff-disabled/--ff-expand),
+    // or WAYGRAPH_FAST_BLOCKS. --fast alone = shorter gates only (keeps theater).
+    pacing.gatesFast = demoFast || !!r.block.fastForward || !!r.wasFastForward;
+    pacing.skipTheater =
+      fastBlockNames.has(r.block.name) || !!r.block.fastForward || !!r.wasFastForward;
     const fixtures = r.highlightFixtures;
     stubBeforeRef.current = resolveHighlightSlots(r.block, "stubBefore", { fixtures });
     const isNavBlock = r.block.__waygraphKind === "nav";
@@ -2484,7 +2484,9 @@ async function main() {
   // truly unexpected failure outside runJsonReportMode's own try/catch)
   // reaches stdout.
   const jsonReport = process.env.WAYGRAPH_JSON === "1";
-  const ffExpand = process.env.WAYGRAPH_FF_EXPAND === "1";
+  const ffExpand =
+    process.env.WAYGRAPH_FF_EXPAND === "1" || process.env.WAYGRAPH_FF_DISABLED === "1";
+  const ffDisabled = process.env.WAYGRAPH_FF_DISABLED === "1";
   /** Expand or keep fastForwardComposeBlock units for demo/run step lists. */
   const flattenBlockInfos = (blockInfos) => {
     const out = [];
@@ -2497,6 +2499,10 @@ async function main() {
             block: step.block,
             ...(step.routes ? { routes: step.routes } : {}),
             ...(bi.resetSessionBefore ? { resetSessionBefore: true } : {}),
+            // Dispute / --ff-disabled: keep blitz pacing on former FF inners so
+            // wall-clock stays comparable to opaque FF (same real acts).
+            wasFastForward: true,
+            ffSource: b.name,
           });
         }
       } else {
@@ -2529,14 +2535,20 @@ async function main() {
           flow.expectedFailureReason && idx === blockInfos.length - 1
             ? flow.expectedFailureReason
             : undefined,
+        ...(bi.wasFastForward ? { wasFastForward: true, ffSource: bi.ffSource } : {}),
       }));
       chainFlows = [flow];
       if (!jsonReport) {
         console.log(
-          "waygraph: running existing flow \\"" + bareRef + "\\" - " +
+          'waygraph: running existing flow "' + bareRef + '" - ' +
             resolved.map((r) => r.block.name).join(" -> ") + " (" + resolved.length + " block" +
             (resolved.length === 1 ? "" : "s") + ", no chain spec needed)",
         );
+        if (ffDisabled) {
+          console.error(
+            "waygraph demo: --ff-disabled - FFCompose expanded to inners (dispute / step locus); blitz pacing kept on former FF steps",
+          );
+        }
       }
     }
   }
@@ -2623,6 +2635,7 @@ async function main() {
         expectedFailureReason:
           meta.expectedFailureReason && remainingInFlow === 1 ? meta.expectedFailureReason : undefined,
         seedMem: isFirstOfSegment ? meta.seedMem : undefined,
+        ...(bi.wasFastForward ? { wasFastForward: true, ffSource: bi.ffSource } : {}),
       };
       remainingInFlow -= 1;
       isFirstOfSegment = false;
@@ -2644,21 +2657,27 @@ async function main() {
   // nobody has to watch a live window for it to be right).
   const headed =
     process.env.WAYGRAPH_HEADED === "0" ? false : process.env.WAYGRAPH_HEADED === "1" || step;
-  // Step mode defaults to a visible Playwright pace (slowMo 350) UNLESS the
-  // flow has an opaque fastForwardComposeBlock — then default slowMo 0 so FF
-  // auth/seed actually blitzes (<10s target) instead of only hiding the cursor
-  // while every click still pays 350ms. Non-FF steps keep overlay theater
-  // (cursor/pop) for watchability. Explicit WAYGRAPH_SLOWMO always wins.
-  const hasOpaqueFf = resolved.some(
-    (r) => r && r.block && r.block.fastForward === true,
+  // Step mode: blitz Playwright slowMo when any opaque FF **or** former-FF
+  // inners (--ff-disabled) are in the resolved list. Explicit WAYGRAPH_SLOWMO wins.
+  const hasFfBlitz = resolved.some(
+    (r) =>
+      r &&
+      ((r.block && r.block.fastForward === true) || r.wasFastForward === true),
   );
   const slowMo = process.env.WAYGRAPH_SLOWMO !== undefined
     ? Number(process.env.WAYGRAPH_SLOWMO)
     : step
-      ? hasOpaqueFf
+      ? hasFfBlitz
         ? 0
         : 350
       : undefined;
+  if (step && hasFfBlitz && process.env.WAYGRAPH_SLOWMO === undefined && !jsonReport) {
+    console.error(
+      ffDisabled
+        ? "waygraph demo: --ff-disabled (expanded) → Playwright slowMo=0 on former FF steps (blitz; same acts as opaque FF)"
+        : "waygraph demo: opaque FFCompose in flow → Playwright slowMo=0 (blitz); set WAYGRAPH_SLOWMO to override",
+    );
+  }
   const baseURL = process.env.WAYGRAPH_BASE_URL;
   const title = process.env.WAYGRAPH_TITLE;
   // Comma-separated Block names (their real .name, e.g. "login") that
@@ -3355,6 +3374,10 @@ function parseRunFlags(argv) {
         else if (a === "--ff-expand") {
             out.ffExpand = true;
         }
+        else if (a === "--ff-disabled" || a === "--no-ff") {
+            out.ffDisabled = true;
+            out.ffExpand = true;
+        }
         else if (a === "--non-headless") {
             out.nonHeadless = true;
         }
@@ -3516,6 +3539,10 @@ function applyRunFlags(flags, opts) {
     if (flags.ffExpand) {
         process.env.WAYGRAPH_FF_EXPAND = "1";
     }
+    if (flags.ffDisabled) {
+        process.env.WAYGRAPH_FF_DISABLED = "1";
+        process.env.WAYGRAPH_FF_EXPAND = "1";
+    }
 }
 /**
  * BASE_URL when neither --base-url nor WAYGRAPH_BASE_URL is set:
@@ -3674,6 +3701,7 @@ Primary (less is more):
                  --fast                    Shorter auto-next / Next gates (keeps smooth cursor)
                  --full                    Classic wrap-all block chips (default: carousel)
                  --ff-expand               Expand fastForwardComposeBlock inners as separate steps
+                 --ff-disabled             Dispute: expand FF (alias --no-ff); blitz kept on those inners
                  --auto-play-video         Unattended + recorded: --auto-next + --video (+ step); headless by default
                  --auto-play-video-head    Same, but keep the browser visible (--non-headless)
                  --video-viewport WxH       Recording size (default demo: 1920x1080)
@@ -3684,6 +3712,7 @@ Primary (less is more):
                  --video [dir]             Record .webm
                  --video-viewport WxH       Recording size (default run: 1280x720)
                  --ff-expand               Same as demo (expand FFCompose inners)
+                 --ff-disabled             Same as demo (dispute: expand FF)
 
 Also:
   waygraph list | nav | validate | check | graph | init <name>
@@ -4006,7 +4035,7 @@ Agents shipped: waygraph-planner, waygraph-author, waygraph-healer.
                 console.error("waygraph demo: missing flow/spec — e.g.\n" +
                     "  waygraph demo src/flows/shop.flow.ts\n" +
                     "  waygraph demo --blocks shopFlow\n" +
-                    "  Flags: --blocks --data --auto-next --fast --full --ff-expand --auto-play-video --title --base-url --video");
+                    "  Flags: --blocks --data --auto-next --fast --full --ff-expand --ff-disabled --auto-play-video --title --base-url --video");
                 process.exit(1);
             }
             const proj = flags.blocks

package/package.json

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