waygraph 0.15.15 → 0.15.16

package/README.md

@@ -1039,6 +1039,14 @@ 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`.
+
 Flows are files (0.10.5+):
 
 | Want | Command |
@@ -1078,6 +1086,8 @@ 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`) |
 
 `--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 +1217,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,11 @@ 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)
+                 <any other args>          Forwarded verbatim (--grep, a spec path, --headed, …)
 
 Also:
   waygraph list | nav | validate | check | typecheck | graph | init <name>
@@ -7467,6 +7473,21 @@ async function main() {
             await runChain(proj, spec);
             break;
         }
+        case "test": {
+            const rest = args.slice(1);
+            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;
+            break;
+        }
         case "init": {
             initCommand(args[1] ?? "");
             break;

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

@@ -1,6 +1,6 @@
 {
   "name": "waygraph",
-  "version": "0.15.15",
+  "version": "0.15.16",
   "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/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",