waygraph 0.10.1 → 0.10.2

package/README.md

@@ -3,7 +3,7 @@
 A typed graph of reusable Blocks for driving a browser through E2E flows, in place of a
 flat pile of ad hoc helper functions.
 
-**Current:** `0.10.0` — CLI less-is-more (`auto` / `demo` / `run` + flags). Page hubs still as in 0.9.0.
+**Current:** `0.10.2` — CLI less-is-more (`auto` / `demo` / `run` + flags). Page hubs still as in 0.9.0.
 
 This repo is the `waygraph` npm package itself. The full live **Sauce Demo** example
 (Page inventory hub, Effect Add/Remove, MemNav Open details, `waygraph auto`) ships
@@ -262,7 +262,7 @@ Deliberately **not yet implemented** (tracked on the project board):
 Mermaid) is `waygraph graph [project]` (`--mermaid`). Unattended JSON execution is
 `chain` + `WAYGRAPH_JSON=1`.
 
-**Friendly demo / run / auto (0.10.0 — less is more):**
+**Friendly demo / run / auto (0.10.2 — less is more):**
 
 | Want | Command |
 |------|---------|

package/dist/auto-explore-run.js

@@ -538,8 +538,14 @@ export async function runAutoExplore(projectDir, options = {}) {
             if (cli)
                 console.error(`waygraph auto: ${menu.flat.length} move(s) available`);
             if (menu.flat.length === 0) {
+                const fromHere = graph.edges.filter((e) => e.from === here).map((e) => e.block);
+                const missing = [...new Set(fromHere)].filter((b) => !library.byName.has(b));
                 console.error(here
-                    ? `waygraph auto: no runnable Blocks on "${here}" - nothing on this page matches the graph.`
+                    ? `waygraph auto: no runnable Blocks on "${here}"` +
+                        (fromHere.length
+                            ? ` (graph has: ${[...new Set(fromHere)].join(", ")}${missing.length ? `; not loaded: ${missing.join(", ")}` : ""})`
+                            : " - nothing on this page matches the graph.") +
+                        (cli ? "" : " Tip: waygraph auto --cli")
                     : "waygraph auto: location unknown - pick nav-login (Start here) if shown.");
                 if (cli)
                     break;

package/dist/auto-explore.js

@@ -85,14 +85,18 @@ export async function loadBlockLibrary(projectDir) {
     const byName = new Map();
     const navBlocks = [];
     for (const file of walkDir(projectDir, /\.block\.ts$/)) {
+        const relFile = relative(projectDir, file);
         let mod;
         try {
             mod = await importModule(file);
         }
-        catch {
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            if (/second time|playwright/i.test(msg)) {
+                console.error(`waygraph auto: skip ${relFile}: ${msg.split("\n")[0]}`);
+            }
             continue;
         }
-        const relFile = relative(projectDir, file);
         for (const [exportName, exported] of Object.entries(mod)) {
             if (!isBlockLike(exported))
                 continue;
@@ -284,9 +288,40 @@ export async function buildExploreMenu(page, graph, library, here) {
         }
     }
     const flat = sections.flatMap((s) => s.edges);
+    // Stuck screen: graph knows actions from `here` but none made it into the menu
+    // (failed library load, empty instanceOptions, etc.). Surface them so LoginPage
+    // never shows a dead "No moves" when submit-login is in the graph.
+    if (here !== null && flat.length === 0) {
+        const rescue = [];
+        const rescued = new Set();
+        for (const edge of graph.edges) {
+            if (edge.kind !== "action" || edge.from !== here)
+                continue;
+            if (rescued.has(edge.block))
+                continue;
+            const entry = library.byName.get(edge.block);
+            if (!entry)
+                continue;
+            if (entry.block.instanceOptions)
+                continue; // still need live rows
+            rescued.add(edge.block);
+            rescue.push(edge);
+        }
+        if (rescue.length > 0) {
+            sections.push({
+                title: `Methods from ${here}`,
+                edges: rescue.sort((a, b) => a.block.localeCompare(b.block)),
+            });
+            return { here, sections, flat: sections.flatMap((s) => s.edges) };
+        }
+    }
     return { here, sections, flat };
 }
 export async function buildExploreContext(projectDir) {
-    const [graph, library] = await Promise.all([discoverGraph(projectDir), loadBlockLibrary(projectDir)]);
+    // Sequential: parallel import of the same *.block.ts tree raced Playwright's
+    // dual-copy guard in some installs and left graph edges without library entries
+    // (LoginPage → "No moves").
+    const library = await loadBlockLibrary(projectDir);
+    const graph = await discoverGraph(projectDir);
     return { graph, library };
 }

package/dist/cli.js

@@ -2548,24 +2548,41 @@ async function runTryDemo() {
         "Permanent full example in this package: examples/saucedemo\n" +
         "Keep a permanent scaffold in your tree: waygraph init my-app\n");
 }
+const TRY_AUTO_DATA = '{"saucedemo.credentials":{"username":"standard_user","password":"secret_sauce"}}';
 /**
- * `waygraph try auto` - same temp Sauce Demo as try demo, then headed
- * `waygraph auto` (same menus as `npm run auto:cli`).
+ * `waygraph try auto` / `try auto:cli` - temp Sauce Demo explore.
+ * Default is CLI menu (same as `npm run auto:cli`). Pass `--headed` for the browser panel.
+ *
+ * Runs as a child in the temp project so Block imports share that install's
+ * `@playwright/test`. In-process explore from the outer CLI against a packed
+ * `file:*.tgz` copy double-loads Playwright and silently yields 0 graph edges
+ * ("LoginPage / No moves").
  */
-async function runTryAuto() {
+async function runTryAuto(opts = { cli: true }) {
     const destDir = await prepareTryQuickstart("waygraph-try-auto");
     if (!destDir)
         return;
     process.env.WAYGRAPH_BASE_URL ??= "https://www.saucedemo.com";
-    console.log("waygraph try auto: headed explore on Sauce Demo (temp dir).\n" +
-        "  Prefer CLI next time: cd <temp> && npm run auto:cli\n" +
-        "  Pick LoginPage / submit-login (creds pre-seeded via --data on auto:cli).\n" +
-        "  On inventory: Add/Remove Effect rows + Open details MemNav.\n" +
-        "  Quit from the panel when done.\n");
-    await runAutoExplore(destDir, { baseURL: process.env.WAYGRAPH_BASE_URL });
+    const cli = opts.cli !== false;
+    console.log(cli
+        ? "waygraph try auto: CLI explore on Sauce Demo (temp dir).\n" +
+            "  Creds pre-seeded (saucedemo.credentials).\n" +
+            "  Pick [1] submit-login, then inventory Add/Remove / Open details.\n" +
+            "  Type q to quit. Headed panel: waygraph try auto --headed\n"
+        : "waygraph try auto: headed explore on Sauce Demo (temp dir).\n" +
+            "  Creds pre-seeded. Prefer CLI: waygraph try auto:cli\n" +
+            "  Pick submit-login, then inventory menus. Quit from the panel.\n");
+    const bin = join(destDir, "node_modules", ".bin", "waygraph");
+    const args = ["auto"];
+    if (cli)
+        args.push("--cli");
+    args.push("--data", TRY_AUTO_DATA);
+    const code = await runInherited(bin, args, destDir);
+    if (code !== 0)
+        process.exitCode = code;
     console.log("\nwaygraph try auto: explorer closed.\n\n" +
         `Temp project:\n  ${destDir}\n\n` +
-        "Run again (CLI first):\n" +
+        "Run again:\n" +
         `  cd ${destDir} && npm run auto:cli\n` +
         `  cd ${destDir} && npm run auto\n\n` +
         "In-package: examples/saucedemo\n" +
@@ -2781,6 +2798,9 @@ function parseRunFlags(argv) {
         else if (a === "--cli") {
             out.cli = true;
         }
+        else if (a === "--headed") {
+            out.headed = true;
+        }
         else if (a === "--mermaid") {
             out.mermaid = true;
         }
@@ -2971,10 +2991,12 @@ Primary (less is more):
 
 Also:
   waygraph list | nav | validate | check | graph | init <name>
-  waygraph try [demo|auto]                 One-shot saucedemo in a temp dir
+  waygraph try [demo|auto|auto:cli]        One-shot saucedemo in a temp dir
+                 try auto --headed         Browser panel instead of CLI
 
 Examples:
-  waygraph auto --cli
+  waygraph try auto:cli
+  waygraph auto --cli --data '{"saucedemo.credentials":{...}}'
   waygraph auto --blocks LoginPage OrderComplete
   waygraph demo --blocks shopFlow --auto-next
   waygraph demo --blocks cartBulkFlow --data '{"saucedemo.credentials":{...}}' --auto-play-video
@@ -3170,15 +3192,27 @@ async function main() {
         case "try": {
             const flags = parseRunFlags(args.slice(1));
             applyRunFlags(flags);
-            const mode = (flags.positionals[0] ?? "demo").toLowerCase();
-            if (mode === "auto") {
-                await runTryAuto();
+            const modeRaw = (flags.positionals[0] ?? "demo").toLowerCase();
+            // auto:cli / auto-cli = CLI explore; auto --headed = browser panel; auto = CLI default
+            const mode = modeRaw === "auto:cli" || modeRaw === "auto-cli"
+                ? "auto:cli"
+                : modeRaw === "auto"
+                    ? "auto"
+                    : modeRaw;
+            if (mode === "auto" || mode === "auto:cli") {
+                // CLI is the default for try auto (same menus as headed). --headed = panel.
+                const cli = mode === "auto:cli" || flags.cli === true
+                    ? true
+                    : flags.headed === true || flags.nonHeadless === true
+                        ? false
+                        : true;
+                await runTryAuto({ cli });
             }
             else if (mode === "demo" || mode === "") {
                 await runTryDemo();
             }
             else {
-                console.error(`waygraph try: unknown mode "${mode}" - use "demo" or "auto"`);
+                console.error(`waygraph try: unknown mode "${modeRaw}" - use "demo", "auto", or "auto:cli"`);
                 process.exitCode = 1;
             }
             break;

package/dist/graph.js

@@ -307,7 +307,12 @@ export async function discoverGraph(projectDir) {
         try {
             mod = await importModule(file);
         }
-        catch {
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            // Dual @playwright/test installs fail here - surface instead of empty graph.
+            if (/second time|playwright/i.test(msg)) {
+                console.error(`waygraph graph: skip ${relFile}: ${msg.split("\n")[0]}`);
+            }
             continue;
         }
         const src = readFileSync(file, "utf-8");

package/package.json

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

package/templates/quickstart/package.json

@@ -23,7 +23,7 @@
     "baseUrl": "https://www.saucedemo.com"
   },
   "dependencies": {
-    "waygraph": "^0.10.1"
+    "waygraph": "^0.10.2"
   },
   "devDependencies": {
     "@playwright/test": "^1.55.0",