waygraph 0.15.16 → 0.15.18

package/README.md

@@ -412,6 +412,36 @@ engine.defineFlow([start, NavHomeBlock, AddItemBlock, AssertItemAddedBlock, Clea
 Live reference: `templates/scaffold/src/map/(app_base)/home/_methods/assert-item-added.method.block.ts`,
 wired into `shop.flow.ts`.
 
+**An assert Block also names a feature *state*, not just a result or static content.** A
+submit button greyed out until required fields are filled, a "Save" button re-enabling
+after a successful edit, a field-level validation error appearing under one specific input
+- these are conditions the UI is *in*, worth a nameable Checkpoint of their own the same way
+`AssertItemAddedBlock` names "did add-item work." There's no built-in `Trait.disabled` -
+write the state check as a custom Trait against the real DOM condition (`isDisabled()`, a
+class, an `aria-disabled` attribute - whatever the app actually uses), the same pattern as
+`removeButtonVisibleForSelectedItem` above:
+
+```typescript
+const submitGatedUntilFieldsComplete: Trait = {
+  name: "submit-gated-until-fields-complete",
+  async check(page) {
+    return page.locator(CheckoutSel.submitButton).isDisabled();
+  },
+};
+
+export const AssertSubmitGatedBlock = defineAssertBlock<CheckoutInfoPage>({
+  name: "assert-submit-gated",
+  checkpoint: "CheckoutInfoPage",
+  verify: [submitGatedUntilFieldsComplete],
+});
+
+// wired right after the fields that gate it, before the ones that clear the gate:
+engine.defineFlow([start, NavCheckoutInfoBlock, AssertSubmitGatedBlock, FillFirstNameBlock, ...])
+```
+
+Same rule as any other assert Block: give it an explicit type argument when it sits
+mid-chain (see above), and keep the selector in a `*Sel` object, never inlined in the Trait.
+
 **`methods/` folder:** on-page work lives next to the route, not free-floating.
 
 **`*Sel`:** DOM selectors only (static strings + `(id) => ...` for item-no-1 style). Mem
@@ -748,6 +778,22 @@ actually shows. Doesn't crash or corrupt anything if you never need it - it's a
 gap (confirmed by reading the exact code path, `src/auto-session.ts`'s `currentMenu()`), fixed
 outright rather than left as a caveat.
 
+**Coverage gaps `waygraph check`/`graph` can't see, because there's no Block to scan yet.**
+Static tools only find gaps in Blocks that already exist - a real link or button on the live
+page with *no Block written for it at all* has nothing in source to catch it. Every live
+`auto`/`browser`/`pilot` session watches the real page instead and warns (once per element,
+via `console.warn`) on a same-origin `<a href>` no `defineNavBlock` covers, or a visible
+`button`/`[role=button]`/submit input no Method/NavClick Block selector matches:
+
+```text
+[waygraph] unmapped nav link on this page: /settings - no NavBlock covers this URL; add defineNavBlock
+[waygraph] unmapped button on this page: #save-draft - no Method/NavClick Block selector matches; consider defineMethodBlock or defineNavClickBlock
+```
+
+Read them back with `auto console <sessionId>` - the same channel real console/network errors
+already come through, not a separate command (`src/coverage-gap.ts`, wired into every session
+in `src/auto-session.ts`).
+
 **On-page indicator.** A headful (`--non-headless`) session looks like an ordinary browser
 tab otherwise - no sign anything is driving it, which matters once a human might be watching
 or co-driving the same visible session. Every session injects a small badge (bottom-right
@@ -1045,7 +1091,12 @@ suite - it forwards to the local `node_modules/.bin/playwright` (falling back to
 exactly like `playwright test`, and anything after it (`--grep`, a spec path, `--headed`, …)
 passes straight through. `waygraph test ui` (or `waygraph test --ui`) launches Playwright's
 interactive UI Mode the same way. Scaffolded projects (`waygraph init`/`create-waygraph`)
-wire this up as `npm test` / `npm run test:ui`.
+wire this up as `npm test` / `npm run test:ui`, and ship `trace: "retain-on-failure"` plus
+the `html` reporter in `playwright.config.ts`, so a failing `waygraph test` already has a
+trace waiting - `waygraph test report` opens the HTML report, and
+`waygraph test show-trace <trace.zip>` opens one trace directly (both forward to Playwright's
+own `show-report`/`show-trace`, which live outside `playwright test`, so they're handled
+before the `test` forward rather than passed through it).
 
 Flows are files (0.10.5+):
 
@@ -1079,6 +1130,8 @@ Flows are files (0.10.5+):
 | Scope either to one element | `waygraph auto dom <sessionId> --selector ".inventory_list"` |
 | Detached session with a real visible browser | `waygraph auto --cli --detach --non-headless` |
 | Read the session's Checkpoint/Block history | `waygraph auto trace <sessionId>` |
+| Read real console/network errors + coverage-gap warnings | `waygraph auto console <sessionId>` |
+| Read localStorage/sessionStorage + service workers | `waygraph auto storage <sessionId>` |
 | Whole-project nav-escape + inline-selector + orphan sweep | `waygraph check [project]` |
 | `tsc --noEmit` + bad-practice warnings | `waygraph typecheck [project]` (`--no-practices` to skip scan) |
 | Waygraph Map enforcement (verbatim url-vs-folder, exits 1 on a violation) | `waygraph map [project]` |
@@ -1088,6 +1141,8 @@ Flows are files (0.10.5+):
 | One-shot temp-dir demo | `waygraph try demo` / `waygraph try auto` / `waygraph try auto:cli` |
 | Run the project's `@playwright/test` suite | `waygraph test` |
 | Same suite, Playwright's interactive UI Mode | `waygraph test ui` (or `--ui`) |
+| Open the last HTML report | `waygraph test report` |
+| Open one trace in the trace viewer | `waygraph test show-trace <trace.zip>` |
 
 `--blocks` / positional accepts a Flow export, a `.flow.ts` path, or `"a then b"`.
 `auto <file.flow.ts>` **runs** that flow (same as `run`); bare `auto` still explores.

package/dist/cli.js

@@ -7341,7 +7341,12 @@ Primary (less is more):
                                            thin wrapper: forwards to the local playwright
                                            binary (or npx playwright as a fallback)
                  test ui  /  test --ui     Playwright UI Mode (interactive, watch + trace)
+                 test report [dir]         Open the last HTML report (playwright show-report)
+                 test show-trace <file>    Open one trace.zip in the trace viewer
                  <any other args>          Forwarded verbatim (--grep, a spec path, --headed, …)
+                                           Scaffolds ship trace: "retain-on-failure" + the
+                                           html reporter, so a failed waygraph test already
+                                           has a trace - test report opens it.
 
 Also:
   waygraph list | nav | validate | check | typecheck | graph | init <name>
@@ -7475,17 +7480,31 @@ async function main() {
         }
         case "test": {
             const rest = args.slice(1);
+            const proj = process.cwd();
+            const localPlaywrightBin = join(proj, "node_modules", ".bin", "playwright");
+            const runPw = (pwArgs) => existsSync(localPlaywrightBin)
+                ? runInherited(localPlaywrightBin, pwArgs, proj)
+                : runInherited("npx", ["--yes", "playwright", ...pwArgs], proj);
+            // report/show-trace are separate top-level `playwright` commands, not
+            // `playwright test` subcommands - handled before the `test` forward below.
+            if (rest[0] === "report") {
+                process.exitCode = await runPw(["show-report", ...rest.slice(1)]);
+                break;
+            }
+            if (rest[0] === "show-trace") {
+                if (!rest[1]) {
+                    console.error("waygraph test show-trace: missing <trace.zip> (or a test-results/ dir)");
+                    process.exit(1);
+                }
+                process.exitCode = await runPw(["show-trace", ...rest.slice(1)]);
+                break;
+            }
             const wantsUi = rest[0] === "ui" || rest.includes("--ui");
             const forwarded = rest[0] === "ui" ? rest.slice(1) : rest;
             const pwArgs = wantsUi && !forwarded.includes("--ui")
                 ? ["test", "--ui", ...forwarded]
                 : ["test", ...forwarded];
-            const proj = process.cwd();
-            const localPlaywrightBin = join(proj, "node_modules", ".bin", "playwright");
-            const code = existsSync(localPlaywrightBin)
-                ? await runInherited(localPlaywrightBin, pwArgs, proj)
-                : await runInherited("npx", ["--yes", "playwright", ...pwArgs], proj);
-            process.exitCode = code;
+            process.exitCode = await runPw(pwArgs);
             break;
         }
         case "init": {

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 export type { Checkpoint, Instruction, Block, DefinedBlock, Start, WaygraphInstanceOption } from "./types.js";
 export { connect, checkpoint } from "./types.js";
 export { MemKey, MemPage, key, keyGroup } from "./mem-page.js";
-export { Trait, urlMatches, textEquals, visible, frameVisible, frameTextEquals, frameContainsText } from "./trait.js";
+export { Trait, urlMatches, textEquals, visible, disabled, enabled, frameVisible, frameTextEquals, frameContainsText, } from "./trait.js";
 export { runGraph, spawnTab, narrate, Engine, start, end, branch, withVerify, modVerify, modVerifyAll, defineBlock, defineNavBlock, defineNavClickBlock, defineMethodBlock, defineActionBlock, defineAssertBlock, definePageBlock, defineEffectBlock, defineMemEffectBlock, defineMemNavBlock, locate, composeBlock, fastForwardComposeBlock, isFastForwardBlock, preflight, withSessionReset, withTitle, withDemoPace, withBlockPace, withHighlightStyle, withExpectedFailure, withHighlightFixtures, withStubBefore, withStubAfter, withStubOnError, chainFlow, defineLayout, map, MapBuilder, } from "./engine.js";
 export { resolveHighlightSlots, resolveSlides, runStubPhase, resolveFixtureDwellMs, resolveSlideDwellMs, formatHighlightCaption, hasAuthoredStubAfter, hasAuthoredStubOnError, normalizeHighlightTone, normalizeDemoPace, normalizeHighlightSize, normalizeHighlightWeight, applyHighlightStyleDefaults, toneIconPrefix, resolveStepDemoPace, demoPaceScale, demoPaceIsBlitz, demoPaceIsFast, demoPaceIsSlow, demoPaceGateMs, formatDemoPaceBadge, formatDemoPaceLabel, normalizeTodos, normalizeTodoPos, normalizeTodoStyle, buildTodoDock, applyTodoPhase, advanceTodoDock, completeSequentialTodoDock, applyDevicePhase, resolveDeviceState, normalizeDevicePreset, normalizeDeviceOrientation, applyOrientation, orientationFromViewport, DEVICE_PRESETS, resolveTodoDockUi, FIXTURE_DURATION_MS_DEFAULT, FIXTURE_DURATION_FAST_MS_DEFAULT, FIXTURE_DURATION_SLOW_MS_DEFAULT, SLIDE_DURATION_MS_DEFAULT, SLIDE_DURATION_FAST_MS_DEFAULT, WAYGRAPH_RING_CSS, } from "./highlights.js";
 export type { WaygraphHighlightStub, WaygraphHighlightFixture, WaygraphSlide, WaygraphTodoItem, WaygraphTodoInput, WaygraphTodoGroup, WaygraphTodoGroupInput, WaygraphTodosOpts, TodoDockUiOpts, TodoDockUiResolved, TodoDockState, TodoListStyle, FixtureDurationFields, HighlightStubPhase, HighlightStubPhaseName, HighlightFixtureMap, ResolvedHighlight, WaygraphHighlight, HighlightTone, HighlightSize, HighlightWeight, HighlightStyleDefaults, DemoPace, DemoPaceName, StubCtx, StubLifecycleFn, StubPhaseResult, StubPhaseFixtures, DevicePreset, DeviceViewport, DeviceState, DeviceOrientation, } from "./highlights.js";

package/dist/index.js

@@ -1,6 +1,6 @@
 export { connect, checkpoint } from "./types.js";
 export { MemKey, MemPage, key, keyGroup } from "./mem-page.js";
-export { Trait, urlMatches, textEquals, visible, frameVisible, frameTextEquals, frameContainsText } from "./trait.js";
+export { Trait, urlMatches, textEquals, visible, disabled, enabled, frameVisible, frameTextEquals, frameContainsText, } from "./trait.js";
 export { runGraph, spawnTab, narrate, Engine, start, end, branch, withVerify, modVerify, modVerifyAll, defineBlock, defineNavBlock, defineNavClickBlock, defineMethodBlock, defineActionBlock, defineAssertBlock, definePageBlock, defineEffectBlock, defineMemEffectBlock, defineMemNavBlock, locate, composeBlock, fastForwardComposeBlock, isFastForwardBlock, preflight, withSessionReset, withTitle, withDemoPace, withBlockPace, withHighlightStyle, withExpectedFailure, withHighlightFixtures, withStubBefore, withStubAfter, withStubOnError, chainFlow, defineLayout, map, MapBuilder, } from "./engine.js";
 export { resolveHighlightSlots, resolveSlides, runStubPhase, resolveFixtureDwellMs, resolveSlideDwellMs, formatHighlightCaption, hasAuthoredStubAfter, hasAuthoredStubOnError, normalizeHighlightTone, normalizeDemoPace, normalizeHighlightSize, normalizeHighlightWeight, applyHighlightStyleDefaults, toneIconPrefix, resolveStepDemoPace, demoPaceScale, demoPaceIsBlitz, demoPaceIsFast, demoPaceIsSlow, demoPaceGateMs, formatDemoPaceBadge, formatDemoPaceLabel, normalizeTodos, normalizeTodoPos, normalizeTodoStyle, buildTodoDock, applyTodoPhase, advanceTodoDock, completeSequentialTodoDock, applyDevicePhase, resolveDeviceState, normalizeDevicePreset, normalizeDeviceOrientation, applyOrientation, orientationFromViewport, DEVICE_PRESETS, resolveTodoDockUi, FIXTURE_DURATION_MS_DEFAULT, FIXTURE_DURATION_FAST_MS_DEFAULT, FIXTURE_DURATION_SLOW_MS_DEFAULT, SLIDE_DURATION_MS_DEFAULT, SLIDE_DURATION_FAST_MS_DEFAULT, WAYGRAPH_RING_CSS, } from "./highlights.js";
 export { discoverGraph, toMermaid, findOrphanBlocks, findBlockPath } from "./graph.js";

package/dist/trait.d.ts

@@ -40,6 +40,20 @@ export declare function textEquals(selector: string, expected: string): Trait;
  * "something matching is visible", not "the selector is unambiguous".
  */
 export declare function visible(selector: string): Trait;
+/**
+ * Passes when at least one element matching `selector` is currently disabled -
+ * a submit button greyed out until required fields are filled, a "Save" not
+ * yet re-enabled after a pending edit. A real, nameable feature *state*, not
+ * just static content or an action's result. Uses `.first()` for the same
+ * reason `visible` does. A point-in-time read via Playwright's own
+ * `isDisabled()` - no wait built in, so pair it with `Trait.visible` (or rely
+ * on `verify`'s own natural timing right after `resolve`) if the element
+ * itself might not be on the page yet.
+ * @example Trait.disabled(CheckoutSel.submitButton)
+ */
+export declare function disabled(selector: string): Trait;
+/** The complement of {@link disabled} - passes once `selector` is enabled. */
+export declare function enabled(selector: string): Trait;
 /**
  * `visible`, scoped to a frame (e.g. a mail catcher's message-preview iframe)
  * instead of the top-level page. `page.locator(selector)` alone never reaches
@@ -73,6 +87,8 @@ export declare const Trait: {
     url: typeof urlMatches;
     text: typeof textEquals;
     visible: typeof visible;
+    disabled: typeof disabled;
+    enabled: typeof enabled;
     frameVisible: typeof frameVisible;
     frameText: typeof frameTextEquals;
     frameContains: typeof frameContainsText;

package/dist/trait.js

@@ -65,6 +65,34 @@ export function visible(selector) {
         },
     };
 }
+/**
+ * Passes when at least one element matching `selector` is currently disabled -
+ * a submit button greyed out until required fields are filled, a "Save" not
+ * yet re-enabled after a pending edit. A real, nameable feature *state*, not
+ * just static content or an action's result. Uses `.first()` for the same
+ * reason `visible` does. A point-in-time read via Playwright's own
+ * `isDisabled()` - no wait built in, so pair it with `Trait.visible` (or rely
+ * on `verify`'s own natural timing right after `resolve`) if the element
+ * itself might not be on the page yet.
+ * @example Trait.disabled(CheckoutSel.submitButton)
+ */
+export function disabled(selector) {
+    return {
+        name: `disabled(${selector})`,
+        async check(page) {
+            return page.locator(selector).first().isDisabled();
+        },
+    };
+}
+/** The complement of {@link disabled} - passes once `selector` is enabled. */
+export function enabled(selector) {
+    return {
+        name: `enabled(${selector})`,
+        async check(page) {
+            return page.locator(selector).first().isEnabled();
+        },
+    };
+}
 /**
  * `visible`, scoped to a frame (e.g. a mail catcher's message-preview iframe)
  * instead of the top-level page. `page.locator(selector)` alone never reaches
@@ -121,6 +149,8 @@ export const Trait = {
     url: urlMatches,
     text: textEquals,
     visible,
+    disabled,
+    enabled,
     frameVisible,
     frameText: frameTextEquals,
     frameContains: frameContainsText,

package/examples/routed-demo/playwright.config.ts

@@ -8,10 +8,11 @@ export default defineConfig({
   fullyParallel: false,
   workers: 1,
   timeout: 30_000,
-  reporter: "list",
+  reporter: [["list"], ["html", { open: "never" }]],
   use: {
     headless: true,
     baseURL: process.env.WAYGRAPH_BASE_URL || `http://${HOST}:${PORT}`,
+    trace: "retain-on-failure",
     launchOptions: {
       executablePath: process.env.CHROME_PATH || process.env.CHROMIUM_PATH,
       args: ["--no-sandbox", "--disable-dev-shm-usage"],

package/examples/saucedemo/package-lock.json

@@ -16,29 +16,424 @@
         "typescript": "^5.6.0"
       }
     },
-    "../..": {
-      "version": "0.12.47",
+    "node_modules/@esbuild/aix-ppc64": {
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/aix-ppc64/-/aix-ppc64-0.28.2.tgz",
+      "integrity": "sha512-XExcO+dvLKvVtNTibSTBej1NCAbaGhWn9Ww1ZPx80qsahhPFe/8jgWP0IchNe0F3HwkU7n8ejhH8bjonqht8mQ==",
+      "cpu": [
+        "ppc64"
+      ],
       "license": "MIT",
-      "dependencies": {
-        "tsx": "^4.0.0"
-      },
-      "bin": {
-        "waygraph": "bin/waygraph"
-      },
-      "devDependencies": {
-        "@playwright/test": "^1.63.0",
-        "@types/node": "^26.0.0",
-        "typescript": "^5.6.0"
-      },
-      "peerDependencies": {
-        "@playwright/test": "^1.40.0"
+      "optional": true,
+      "os": [
+        "aix"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/android-arm": {
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/android-arm/-/android-arm-0.28.2.tgz",
+      "integrity": "sha512-kXXoiPVVGQcnIYGOeaovwOURpniDBpSq4A03qkQ+BMQqtGG6HYap3xne9C1O1yo4TR3qxlCX5IqqmX6fFo2Lqg==",
+      "cpu": [
+        "arm"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/android-arm64": {
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/android-arm64/-/android-arm64-0.28.2.tgz",
+      "integrity": "sha512-5YfKeeI8qWfBZIX+u2xZC3Zlb3Os/gLS2sbEKM+I4ZOcsWmHS2WLysCcQZDAFRslDUU5Oiq44gf6PYN1vGwG5A==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/android-x64": {
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/android-x64/-/android-x64-0.28.2.tgz",
+      "integrity": "sha512-O387ite7SzUyCcy3JQX4P4bLtEA7bLLkx+esve5JHnyYfNTxcVpXZo9jhdB0lTKN44gztELTdU7nS8Nr16Fs1Q==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/darwin-arm64": {
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/darwin-arm64/-/darwin-arm64-0.28.2.tgz",
+      "integrity": "sha512-n4KqkOQrraxHJcgjM1RvwbigfQKIKJVpM7xp+KsxiyUSrRdIXnt73VhrPAx0fV44hgfmIVKjxMN9J1t5jySVkw==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/darwin-x64": {
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/darwin-x64/-/darwin-x64-0.28.2.tgz",
+      "integrity": "sha512-uq6suIWYP37qzGddBKPw5QEQPi6HiLGsO7UmkpfyaYNQ3D+rN6w6WfwH+nuqcGXWvawGwxOEroO4YGnFh95azw==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/freebsd-arm64": {
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/freebsd-arm64/-/freebsd-arm64-0.28.2.tgz",
+      "integrity": "sha512-n+I0BTSRIoy+d6RPKnEVwql5UwBJolytvY4mAOIEJorKlqgPII8ix6slVVrfZ5Tnj7glIZvloylbB/EJPMWEXw==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "freebsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/freebsd-x64": {
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/freebsd-x64/-/freebsd-x64-0.28.2.tgz",
+      "integrity": "sha512-78XJTJkvPs0kz2w61301PJjXl4g7q3JqiYMZ/M/yVI73EHBrCRTgkhu9oqG7vPqq+a/yadEW8aD+agKlk5xrmg==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "freebsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-arm": {
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-arm/-/linux-arm-0.28.2.tgz",
+      "integrity": "sha512-XlDnu2q5yoqems+xay6wSAcg9DDD7K9RLKZEBOMZm3ckNpJBvOX20tSfby8KfrrhINDyv9V2YVZKY/SpoGJI8w==",
+      "cpu": [
+        "arm"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-arm64": {
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-arm64/-/linux-arm64-0.28.2.tgz",
+      "integrity": "sha512-pW4AC0P3it8c7do9MVM4p51FzHzdM/TZrerurgRcHJ2WTa1VQ1CIq18xncfpBJw4ojkiZZrKW2yIBWBP92j6Ug==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-ia32": {
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-ia32/-/linux-ia32-0.28.2.tgz",
+      "integrity": "sha512-CYbnj78HsIeA+DhgUKgFCfvNsTHFhMMrinUrMZpDXJXKN8T3XViTZ/+wtHeVxEWY8ewSzTFN+nRmSwO2tZaLUQ==",
+      "cpu": [
+        "ia32"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-loong64": {
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-loong64/-/linux-loong64-0.28.2.tgz",
+      "integrity": "sha512-buwkd8nsph4R+ajRvw0qM5Hja/TXQow3ptzWO2EbG/cqcIkHloRrdlBtQlshyYGTNFvfkfJ5tpPLVkY4DtsPfQ==",
+      "cpu": [
+        "loong64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-mips64el": {
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-mips64el/-/linux-mips64el-0.28.2.tgz",
+      "integrity": "sha512-ZVykbDyk7519VwiNb9Lcj9m8XM6v5V9uKPvrEMkkEedVewf+0itkhahp4HDpgERXhwLRpWFypsGbG/J8s0QjJA==",
+      "cpu": [
+        "mips64el"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-ppc64": {
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-ppc64/-/linux-ppc64-0.28.2.tgz",
+      "integrity": "sha512-CAXl+Dtd9UUuJd8pKKdwh6MLm3MUMiqMPmhZ3tTSXPqfyQ3vDl6R5hZdZ/kYojK4ofXtdfSv1tFq8XzWx3heNQ==",
+      "cpu": [
+        "ppc64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-riscv64": {
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-riscv64/-/linux-riscv64-0.28.2.tgz",
+      "integrity": "sha512-GeXCej4IQtU1B+QlDV8W/RRvbzI3O/Stss+/bCXv4lZls5WGRtu2a+3JkA3i4qIUlMXpcHebWpF8AkJhATowuA==",
+      "cpu": [
+        "riscv64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-s390x": {
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-s390x/-/linux-s390x-0.28.2.tgz",
+      "integrity": "sha512-3H1weTYZPxt/WOhByszQZybS9w5lKzUn1FDMsgEChbHWQwHYQQRfBxgCcZvPhjHfKyJjIievvMmEUawJrdY9Dg==",
+      "cpu": [
+        "s390x"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-x64": {
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-x64/-/linux-x64-0.28.2.tgz",
+      "integrity": "sha512-4xTZr1FUmSoQW4XIWmit3tzQrUTZM+N3P0XV8xROKYF50XfI7xeO90+1bZvNwxIufQ9hDQVRJH5YhgPVF8A/HQ==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/netbsd-arm64": {
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/netbsd-arm64/-/netbsd-arm64-0.28.2.tgz",
+      "integrity": "sha512-sSATRjPeDBg3pdgHoQfoYBob11Kk1FGa9lui5RIHZCoCkJa9QKlvl3/vKz2usCmYYjs7ymJR/2Nnsqe+Hjt5nw==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "netbsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/netbsd-x64": {
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/netbsd-x64/-/netbsd-x64-0.28.2.tgz",
+      "integrity": "sha512-lqnzCV+mM0gIADaKihiCg6ifgfU2L3h5E33rNQBN1Y4MaVGnzryzmvvf7UHxprpQdE8hpqLolJ9Rl+SkIRDpyw==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "netbsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/openbsd-arm64": {
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/openbsd-arm64/-/openbsd-arm64-0.28.2.tgz",
+      "integrity": "sha512-AL2qJILH7lNjrDmCQDvdxMfAUIv8KMNZOvrwAQ8i8//ntL9FflhOyMJ8OZSMBb8/AWXe3/5v5S20y3zCoZWKoQ==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openbsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/openbsd-x64": {
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/openbsd-x64/-/openbsd-x64-0.28.2.tgz",
+      "integrity": "sha512-QtiuPytchRyC4rwUKhexJdQKvDuZ6hWloi3igqPQNUJCS1/v9EiO3UTOXR6A3FoMo4fnAKbWJdqaIwhOzh8qEw==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openbsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/openharmony-arm64": {
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/openharmony-arm64/-/openharmony-arm64-0.28.2.tgz",
+      "integrity": "sha512-WkhYDmpTjLvGlScA1rwjRUmhl4k8oXR3cIbtqWmELgU/dFeHHlEllxDvdWcNJV9rbzCexB5vz8gtNewWLgCT7Q==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openharmony"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/sunos-x64": {
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/sunos-x64/-/sunos-x64-0.28.2.tgz",
+      "integrity": "sha512-GPMSkTOtMnv2U2F8gxe4Io6qmVs+YKyp832Etqqxr0hFngmXQ3rzwytelm3GIn7T4VviRUlf3sOgBOiTdvaf7g==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "sunos"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/win32-arm64": {
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/win32-arm64/-/win32-arm64-0.28.2.tgz",
+      "integrity": "sha512-PIhhEkE9uPBleRBrQEJpUn7MBnibZzbGzYWPmY3x+YoVg/95zbjB4CxPPOQ8l5tYYM4mMaCthF8/1DIfBQQyWQ==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/win32-ia32": {
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/win32-ia32/-/win32-ia32-0.28.2.tgz",
+      "integrity": "sha512-YmJbfTlvU7Sdn9BB+4PRES4oB6pxgS37MAONj+hBr/cpXS1aBPKXxNnDbu+QCWPj0o9dgyxeq79g6c5P8KeuYA==",
+      "cpu": [
+        "ia32"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/win32-x64": {
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/@esbuild/win32-x64/-/win32-x64-0.28.2.tgz",
+      "integrity": "sha512-5ebpxr3nWMzrL/rnUI755Jkuee0bHL/Gq0WTF9lvcpv73wAp5eu8MfBUgWK9bhWvZjj7yX8etf/8tI8Ney695g==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">=18"
       }
     },
     "node_modules/@playwright/test": {
       "version": "1.63.0",
-      "resolved": "https://registry.npmjs.org/@playwright/test/-/test-1.63.0.tgz",
-      "integrity": "sha512-oxMK4vllB9RK5NQ2l1pq1IfOf2AvnEuj/vYGDj0H2nMtmtZpKtCwt/l00GEO6xjGfpBNAvjovvYdCm50dRQkpQ==",
-      "dev": true,
       "license": "Apache-2.0",
       "dependencies": {
         "playwright": "1.63.0"
@@ -52,19 +447,69 @@
     },
     "node_modules/@types/node": {
       "version": "26.6.1",
-      "resolved": "https://registry.npmjs.org/@types/node/-/node-26.6.1.tgz",
-      "integrity": "sha512-VqGJBMCtdhqkBUCcBLvywI0NJ+KLuVzgNnlBUNFOQjqVxzo2lxLUNg1DSey8+u2u6ktswSAxg+s68QLzWHNOuA==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
         "undici-types": "~8.9.0"
       }
     },
+    "node_modules/esbuild": {
+      "version": "0.28.2",
+      "resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.28.2.tgz",
+      "integrity": "sha512-HKVLS8dvII+xoKW9kmqxbRKrnWEXfJJr/FZhhJmiqIB0e053QNYFqOBouTMO/k5sID4MvCiUCvv8b9M4h32wIA==",
+      "hasInstallScript": true,
+      "license": "MIT",
+      "bin": {
+        "esbuild": "bin/esbuild"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "optionalDependencies": {
+        "@esbuild/aix-ppc64": "0.28.2",
+        "@esbuild/android-arm": "0.28.2",
+        "@esbuild/android-arm64": "0.28.2",
+        "@esbuild/android-x64": "0.28.2",
+        "@esbuild/darwin-arm64": "0.28.2",
+        "@esbuild/darwin-x64": "0.28.2",
+        "@esbuild/freebsd-arm64": "0.28.2",
+        "@esbuild/freebsd-x64": "0.28.2",
+        "@esbuild/linux-arm": "0.28.2",
+        "@esbuild/linux-arm64": "0.28.2",
+        "@esbuild/linux-ia32": "0.28.2",
+        "@esbuild/linux-loong64": "0.28.2",
+        "@esbuild/linux-mips64el": "0.28.2",
+        "@esbuild/linux-ppc64": "0.28.2",
+        "@esbuild/linux-riscv64": "0.28.2",
+        "@esbuild/linux-s390x": "0.28.2",
+        "@esbuild/linux-x64": "0.28.2",
+        "@esbuild/netbsd-arm64": "0.28.2",
+        "@esbuild/netbsd-x64": "0.28.2",
+        "@esbuild/openbsd-arm64": "0.28.2",
+        "@esbuild/openbsd-x64": "0.28.2",
+        "@esbuild/openharmony-arm64": "0.28.2",
+        "@esbuild/sunos-x64": "0.28.2",
+        "@esbuild/win32-arm64": "0.28.2",
+        "@esbuild/win32-ia32": "0.28.2",
+        "@esbuild/win32-x64": "0.28.2"
+      }
+    },
+    "node_modules/fsevents": {
+      "version": "2.3.3",
+      "resolved": "https://registry.npmjs.org/fsevents/-/fsevents-2.3.3.tgz",
+      "integrity": "sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==",
+      "hasInstallScript": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": "^8.16.0 || ^10.6.0 || >=11.0.0"
+      }
+    },
     "node_modules/playwright": {
       "version": "1.63.0",
-      "resolved": "https://registry.npmjs.org/playwright/-/playwright-1.63.0.tgz",
-      "integrity": "sha512-+7ziBLidS4NaNCdt57SUDT+wYmmd5fmiQejUic/kb+YsYSCPyOOE9sebzMjNmQrsnNpDJqd4WHvV/8lfKfUDUg==",
-      "dev": true,
       "license": "Apache-2.0",
       "dependencies": {
         "playwright-core": "1.63.0"
@@ -78,9 +523,6 @@
     },
     "node_modules/playwright-core": {
       "version": "1.63.0",
-      "resolved": "https://registry.npmjs.org/playwright-core/-/playwright-core-1.63.0.tgz",
-      "integrity": "sha512-rYCsBF/M5HjUch52bbtVONEFjv6Xu8sm8h72dNlR5bzIE1fvC/bxgspzkjSfU+MweEMmPM8KJebG6nnyxo5mCg==",
-      "dev": true,
       "license": "Apache-2.0",
       "bin": {
         "playwright-core": "cli.js"
@@ -89,10 +531,26 @@
         "node": ">=20"
       }
     },
+    "node_modules/tsx": {
+      "version": "4.23.15",
+      "resolved": "https://registry.npmjs.org/tsx/-/tsx-4.23.15.tgz",
+      "integrity": "sha512-Yiex1Ovn8z2xPpOWckIiysV1SSyRMY9BkLF++q0yKiDxCqRhosKfMg3janKkiLBwZ5c/YryloKwGZcrEmtwxKw==",
+      "license": "MIT",
+      "dependencies": {
+        "esbuild": "~0.28.0"
+      },
+      "bin": {
+        "tsx": "dist/cli.mjs"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      },
+      "optionalDependencies": {
+        "fsevents": "~2.3.3"
+      }
+    },
     "node_modules/typescript": {
       "version": "5.9.3",
-      "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.9.3.tgz",
-      "integrity": "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw==",
       "dev": true,
       "license": "Apache-2.0",
       "bin": {
@@ -105,14 +563,22 @@
     },
     "node_modules/undici-types": {
       "version": "8.9.0",
-      "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-8.9.0.tgz",
-      "integrity": "sha512-KTDyRTYX8sWmKXAikPHHSyc63CRPETMctyjKFupcC6OBLXT3xsN0e9aF7m+mIXutFWpUXuedtowG7iLOzp0kQg==",
       "dev": true,
       "license": "MIT"
     },
     "node_modules/waygraph": {
-      "resolved": "../..",
-      "link": true
+      "version": "0.15.17",
+      "resolved": "file:../..",
+      "license": "MIT",
+      "dependencies": {
+        "tsx": "^4.0.0"
+      },
+      "bin": {
+        "waygraph": "bin/waygraph"
+      },
+      "peerDependencies": {
+        "@playwright/test": "^1.40.0"
+      }
     }
   }
 }

package/examples/saucedemo/playwright.config.ts

@@ -5,10 +5,11 @@ export default defineConfig({
   fullyParallel: false,
   workers: 1,
   timeout: 30_000,
-  reporter: "list",
+  reporter: [["list"], ["html", { open: "never" }]],
   use: {
     headless: true,
     baseURL: "https://www.saucedemo.com",
+    trace: "retain-on-failure",
     launchOptions: {
       // Canonical Chromium on this machine is the Flatpak install - never let
       // Playwright download its own bundled binary. See .agent/manager-agent.md.

package/examples/saucedemo/tests/auto-graph.spec.ts

@@ -5,7 +5,7 @@ import { dirname, join } from "node:path";
 
 const projectDir = join(dirname(fileURLToPath(import.meta.url)), "..");
 
-test("waygraph auto discovers the decomposed saucedemo graph with zero skipped Blocks", async () => {
+test("waygraph auto discovers the decomposed saucedemo graph, skipping only the FFCompose auth step", async () => {
   const graph = await discoverGraph(projectDir);
 
   expect(graph.nodes.map((n) => n.checkpoint).sort()).toEqual(
@@ -20,8 +20,12 @@ test("waygraph auto discovers the decomposed saucedemo graph with zero skipped B
       "OrderComplete",
     ].sort(),
   );
-  // +2 vs pre-remove: remove-from-cart branches * → ItemInCart | LoggedIn
-  expect(graph.edges.length).toBe(15);
+  // 24 vs the earlier 15: checkout-info split into fill-first-name/
+  // fill-last-name/fill-postal-code (+2 net) plus the atomic login Blocks
+  // (fill-username/fill-password/submit-login's 2 branches) that static
+  // discovery still sees even though checkoutFlow itself now drives them
+  // through the ff-owner-auth composition below.
+  expect(graph.edges.length).toBe(24);
   const removeEdges = graph.edges.filter((e) => e.block === "remove-from-cart");
   expect(removeEdges).toEqual(
     expect.arrayContaining([
@@ -32,7 +36,15 @@ test("waygraph auto discovers the decomposed saucedemo graph with zero skipped B
 
   const loginFail = graph.edges.find((e) => e.block === "submit-login" && e.to === "LoginPage");
   expect(loginFail).toMatchObject({ from: "LoginPage", to: "LoginPage", kind: "action" });
-  expect(graph.skipped.length).toBe(0);
+
+  // ff-owner-auth (fastForwardComposeBlock) collapses nav-login + fill-username
+  // + fill-password + submit-login into one opaque demo/run step - discoverGraph
+  // only understands plain defineMethodBlock/defineEffectBlock<In, Out> generic
+  // calls, so this one Block is expected to be skipped by static discovery even
+  // though it's a real, used step (see src/blocks/saucedemo-web/ff-owner-auth.block.ts).
+  expect(graph.skipped).toEqual([
+    expect.objectContaining({ block: "ff-owner-auth" }),
+  ]);
 
   const logout = graph.edges.find((e) => e.block === "submit-logout");
   expect(logout).toMatchObject({ from: "LoggedIn", to: "LoginPage", kind: "action" });

package/examples/saucedemo/tests/chain-flow-episodes.spec.ts

@@ -29,10 +29,15 @@ test("each episode's title survives chaining, and blocks() reports the flattened
 
   expect(blocks.map((b) => b.name)).toEqual([
     "nav-login",
+    "fill-username",
+    "fill-password",
     "submit-login",
     "add-to-cart",
     "nav-cart",
     "nav-checkout-info",
+    "fill-first-name",
+    "fill-last-name",
+    "fill-postal-code",
     "submit-checkout-info",
     "finish-order",
   ]);

package/examples/saucedemo/tests/flow-block-verify.spec.ts

@@ -1,7 +1,7 @@
 import { test, expect } from "@playwright/test";
 import { MemPage, checkpoint, Trait } from "waygraph";
 import { checkoutFlow } from "../src/flows/checkout.flow.js";
-import { SubmitLoginBlock } from "../src/blocks/saucedemo-web/methods/submit-login.method.block.js";
+import { FfOwnerAuthBlock } from "../src/blocks/saucedemo-web/ff-owner-auth.block.js";
 import { LoginCreds, SelectedItem } from "../src/states/checkout.mem-keys.js";
 
 // checkoutFlow.withBlockVerify/modBlockVerify - a spec that only imports the
@@ -31,9 +31,12 @@ test("withBlockVerify: replacing login's verify with an extra real check still p
   mem.set(LoginCreds({ username: "standard_user", password: "secret_sauce" }));
   mem.set(SelectedItem({ id: "sauce-labs-backpack", name: "Sauce Labs Backpack" }));
 
-  // Addressed by the actual SubmitLoginBlock reference - the preferred
-  // form: no typo risk, refactor-safe, jump-to-definition works.
-  const patched = checkoutFlow.withBlockVerify(SubmitLoginBlock, [
+  // Addressed by the actual FfOwnerAuthBlock reference - the preferred
+  // form: no typo risk, refactor-safe, jump-to-definition works. checkoutFlow
+  // drives login through the ff-owner-auth FFCompose step (collapsed
+  // nav-login + fill-username + fill-password + submit-login), not a bare
+  // SubmitLoginBlock reference, so that's the Block whose verify this patches.
+  const patched = checkoutFlow.withBlockVerify(FfOwnerAuthBlock, [
     Trait.url({ pathname: "/inventory.html" }),
     Trait.visible(".inventory_list"),
   ]);

package/package.json

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

package/templates/quickstart/playwright.config.ts

@@ -5,10 +5,11 @@ export default defineConfig({
   fullyParallel: false,
   workers: 1,
   timeout: 30_000,
-  reporter: "list",
+  reporter: [["list"], ["html", { open: "never" }]],
   use: {
     headless: true,
     baseURL: "https://www.saucedemo.com",
+    trace: "retain-on-failure",
     launchOptions: {
       // Canonical Chromium on this machine is the Flatpak install - never let
       // Playwright download its own bundled binary. See .agent/manager-agent.md.

package/templates/scaffold/playwright.config.ts

@@ -7,9 +7,10 @@ const FIXTURE_ORIGIN = `http://${FIXTURE_HOST}:${FIXTURE_PORT}`;
 export default defineConfig({
   testDir: "./tests",
   fullyParallel: true,
-  reporter: "list",
+  reporter: [["list"], ["html", { open: "never" }]],
   use: {
     baseURL: FIXTURE_ORIGIN,
+    trace: "retain-on-failure",
     launchOptions: {
       executablePath: process.env.CHROME_PATH || process.env.CHROMIUM_PATH,
     },

package/templates/skills/waygraph-convention.skill.md

@@ -22,6 +22,11 @@ against a live site, use `--skill-pilot-blind`.
    inline selector literals in `Trait.visible` / `Trait.text`.
 4. **Assert-only = `defineAssertBlock`.** Self-loop, no hand-written `act`/`resolve`. Pass
    an explicit type argument when it sits between two specifically-typed Blocks in a Flow.
+   Not just static content or an action's result - it also names a *feature state* worth a
+   Checkpoint of its own (a submit button greyed out until required fields are filled, a
+   field error under one input, a stale "Save" re-enabling). No built-in `Trait.disabled` -
+   write the state condition as a custom Trait (`isDisabled()`, a class, `aria-disabled`),
+   same as any other Trait: real DOM check, no inline selector.
 5. **`requires` = externally supplied.** A key an earlier Block in the same chain produces
    is never listed under `requires` - preflight checks the whole chain up front.
 6. **Keep Checkpoints typed — never `Checkpoint<string>`.** Block helpers take concrete
@@ -105,6 +110,22 @@ npm run typecheck             # when the consumer has it
 are still runnable in Pilot's live menu - orphan status only blocks
 `auto --blocks <From> <To>` pathfinding.
 
+**Static tools above only find gaps in Blocks that already exist.** A real link/button on
+the live page with *no Block written for it at all* has nothing in source for `check`/
+`graph` to scan - the only way to find that is to actually run the app. Every live
+`auto`/`browser`/`pilot` session watches the real page and warns (once per element) on
+anything with no matching Block:
+
+```text
+[waygraph] unmapped nav link on this page: /settings - no NavBlock covers this URL; add defineNavBlock
+[waygraph] unmapped button on this page: #save-draft - no Method/NavClick Block selector matches; consider defineMethodBlock or defineNavClickBlock
+```
+
+Read them back with `auto console <sessionId>` (same channel as real console/network
+errors) - see `--skill-pilot`'s "Coverage gaps on the live page" section for the full
+detection rules (same-origin `<a href>` only, visible clickables only, one warning per
+element per session).
+
 ## Related skills (print via CLI)
 
 ```bash

package/examples/routed-demo/test-results/.last-run.json

@@ -1,4 +0,0 @@
-{
-  "status": "passed",
-  "failedTests": []
-}