waygraph 0.15.15 → 0.15.17

package/README.md

@@ -1039,6 +1039,19 @@ immediately - see "Waygraph Pilot" above for the full picture.
 when no Block covers that action yet, and `auto reload <sessionId>` picks up a Block just
 written to disk without restarting the session - see "Blind Pilot" above.
 
+**`waygraph test [...args]`** is a thin wrapper around the project's own `@playwright/test`
+suite - it forwards to the local `node_modules/.bin/playwright` (falling back to
+`npx playwright` if the project hasn't installed it locally yet), so `waygraph test` behaves
+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`, 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+):
 
 | Want | Command |
@@ -1078,6 +1091,10 @@ Flows are files (0.10.5+):
 | Coding-agent defs | `waygraph agent-dive --loop claude` |
 | Print packaged skills | `waygraph --skill` / `--skill-pilot` / `--skill-pilot-blind` / `--skill-convention` |
 | 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.
@@ -1207,7 +1224,8 @@ git clone git@github.com:deviate-dv8/waygraph.git
 cd waygraph
 npm install
 npm run typecheck   # waygraph typecheck . (tsc --noEmit + practice warnings)
-npm run test        # playwright test
+npm run test        # node --test tests/unit + playwright test
+npm run test:ui     # playwright test --ui
 npm run build       # tsc -p tsconfig.build.json, emits dist/
 ```
 

package/dist/cli.d.ts

@@ -6,6 +6,7 @@
  *   auto   Explore picker; `.flow.ts` / `--blocks From To` = run that path
  *   demo   Watch (step overlay); `--blocks` `--data` `--auto-next` `--fast` `--full` `--mini` `--ff-expand` `--ff-disabled`
  *   run    Execute; `--blocks` `--data` `--non-headless` `--video`
+ *   test   Runs the project's own @playwright/test suite; `test ui` / `--ui` = UI Mode
  *
  * Also: list / nav / validate / check / graph / init / agent-dive / traverse / try
  * Skills: --skill / --skill-pilot / --skill-pilot-blind / --skill-convention

package/dist/cli.js

@@ -6,6 +6,7 @@
  *   auto   Explore picker; `.flow.ts` / `--blocks From To` = run that path
  *   demo   Watch (step overlay); `--blocks` `--data` `--auto-next` `--fast` `--full` `--mini` `--ff-expand` `--ff-disabled`
  *   run    Execute; `--blocks` `--data` `--non-headless` `--video`
+ *   test   Runs the project's own @playwright/test suite; `test ui` / `--ui` = UI Mode
  *
  * Also: list / nav / validate / check / graph / init / agent-dive / traverse / try
  * Skills: --skill / --skill-pilot / --skill-pilot-blind / --skill-convention
@@ -7336,6 +7337,16 @@ Primary (less is more):
                  --video-viewport WxH       Recording size (default run: 1280x720)
                  --ff-expand               Same as demo (expand FFCompose inners)
                  --ff-disabled             Same as demo (dispute: expand FF)
+  waygraph test                            Runs the project's @playwright/test suite (cwd) -
+                                           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>
@@ -7467,6 +7478,35 @@ async function main() {
             await runChain(proj, spec);
             break;
         }
+        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];
+            process.exitCode = await runPw(pwArgs);
+            break;
+        }
         case "init": {
             initCommand(args[1] ?? "");
             break;

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.json

@@ -6,7 +6,8 @@
   "description": "Full Sauce Demo (saucedemo.com) example - Effect / MemNav / waygraph auto.",
   "scripts": {
     "typecheck": "tsc --noEmit",
-    "test": "playwright test",
+    "test": "waygraph test",
+    "test:ui": "waygraph test ui",
     "flows": "waygraph list",
     "demo": "waygraph demo --blocks \"loginFlow then shopFlow\" --data \"{\\\"saucedemo.credentials\\\":{\\\"username\\\":\\\"standard_user\\\",\\\"password\\\":\\\"secret_sauce\\\"},\\\"saucedemo.selectedItem\\\":{\\\"id\\\":\\\"sauce-labs-backpack\\\",\\\"name\\\":\\\"Sauce Labs Backpack\\\"}}\"",
     "demo:step": "waygraph demo --blocks \"loginFlow then shopFlow\" --title \"Shop demo\" --data \"{\\\"saucedemo.credentials\\\":{\\\"username\\\":\\\"standard_user\\\",\\\"password\\\":\\\"secret_sauce\\\"},\\\"saucedemo.selectedItem\\\":{\\\"id\\\":\\\"sauce-labs-backpack\\\",\\\"name\\\":\\\"Sauce Labs Backpack\\\"}}\"",

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "waygraph",
-  "version": "0.15.15",
+  "version": "0.15.17",
   "type": "module",
   "description": "A typed graph of reusable Blocks for driving a browser through E2E flows.",
   "license": "MIT",
@@ -36,7 +36,9 @@
   "scripts": {
     "build": "tsc -p tsconfig.build.json",
     "typecheck": "node bin/waygraph typecheck .",
-    "test": "playwright test",
+    "test": "npm run test:unit && playwright test",
+    "test:ui": "playwright test --ui",
+    "test:unit": "node --import tsx/esm --test tests/unit/*.spec.ts",
     "docs:preview": "python3 -m http.server 4173 --directory docs",
     "example:saucedemo:install": "npm --prefix examples/saucedemo install",
     "example:saucedemo:test": "npm --prefix examples/saucedemo test",

package/templates/quickstart/package.json

@@ -4,7 +4,8 @@
   "type": "module",
   "description": "Self-contained saucedemo quickstart (copied into a temp dir by `waygraph try demo`).",
   "scripts": {
-    "test": "playwright test",
+    "test": "waygraph test",
+    "test:ui": "waygraph test ui",
     "typecheck": "tsc --noEmit",
     "check": "waygraph check",
     "auto": "waygraph auto",

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/package.json

@@ -5,7 +5,8 @@
   "type": "module",
   "scripts": {
     "typecheck": "waygraph typecheck .",
-    "test": "playwright test",
+    "test": "waygraph test",
+    "test:ui": "waygraph test ui",
     "fixture": "node scripts/fixture-server.mjs",
     "list": "waygraph list",
     "check": "waygraph check",

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/examples/routed-demo/test-results/.last-run.json

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