waygraph 0.15.16 → 0.15.17

package/README.md

@@ -1045,7 +1045,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+):
 
@@ -1088,6 +1093,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/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/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.16",
+  "version": "0.15.17",
   "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/examples/routed-demo/test-results/.last-run.json

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