@brunosps00/dev-workflow 1.1.1 → 1.1.2

package/README.md

@@ -26,7 +26,7 @@ npx @brunosps00/dev-workflow install-deps
 
 ## Commands
 
-dev-workflow v1.1.1 ships **31 commands** organized into four tiers. Most users only invoke Tier 1 + Tier 2.
+dev-workflow v1.1.2 ships **31 commands** organized into four tiers. Most users only invoke Tier 1 + Tier 2.
 
 ### Tier 1 — Gateway (3)
 
@@ -310,7 +310,7 @@ npx @brunosps00/dev-workflow list-installed                # Show managed instal
 npx @brunosps00/dev-workflow doctor                        # Check wrappers, agents, skills, MCPs, gates
 npx @brunosps00/dev-workflow repair                        # Reconcile managed files from recorded install state
 npx @brunosps00/dev-workflow install-deps                  # Install Playwright, react-doctor; check security scanners + Docker
-npx @brunosps00/dev-workflow setup-wsl-browser             # WSL NAT: build CDP relay + add Hyper-V firewall rule
+npx @brunosps00/dev-workflow setup-wsl-browser             # WSL NAT: install prebuilt CDP relay + add Hyper-V firewall rule
 npx @brunosps00/dev-workflow install-azure-skills          # Opt-in: Azure skills + Microsoft Learn MCP
 npx @brunosps00/dev-workflow install-azure-skills --products=azure-aks,azure-openai  # Subset override
 npx @brunosps00/dev-workflow install-aws-skills            # Opt-in: AWS skills + AWS MCP Server (needs uv + aws cli + creds)

package/bin/dev-workflow.js

@@ -47,7 +47,7 @@ const HELP_TEXT = `
     repair                 Reconcile managed files using the recorded install state
     subtask                Create, complete, consume, and list local subagent handoffs
     install-deps           Install system dependencies (Playwright browsers, MCP servers)
-    setup-wsl-browser      (WSL) Build the CDP relay on Windows + add the Hyper-V firewall rule so flows can drive the real Windows browser
+    setup-wsl-browser      (WSL) Install the prebuilt CDP relay + add the Hyper-V firewall rule so flows can drive the real Windows browser
     install-azure-skills   Opt-in: clone curated Azure skills from MicrosoftDocs/Agent-Skills
                            into .agents/skills/azure/ and register the Microsoft Learn MCP
                            server (HTTP, no-auth). Interactive category selection.

package/lib/install-deps.js

@@ -172,8 +172,8 @@ function printBrowserGuidance() {
   if (mirrored) {
     console.log('    Mirrored networking detected — connects to the Windows browser on 127.0.0.1 directly.');
   } else {
-    console.log('    NAT networking — run `npx @brunosps00/dev-workflow setup-wsl-browser` once to build the');
-    console.log('    cdp-relay.exe (needs Rust on Windows) and add the Hyper-V firewall rule. Otherwise flows');
+    console.log('    NAT networking — run `npx @brunosps00/dev-workflow setup-wsl-browser` once to install the');
+    console.log('    bundled cdp-relay.exe and add the Hyper-V firewall rule. Otherwise flows');
     console.log('    fall back to the local headless Chromium (faithful video, no Windows browser).');
   }
   console.log('    Details: .dw/skills/dw-testing-discipline/references/playwright-recipes.md ("Browser on WSL").');

package/lib/setup-wsl-browser.js

@@ -1,17 +1,19 @@
-const { execSync, spawnSync } = require('child_process');
+const { execSync } = require('child_process');
 const fs = require('fs');
 const path = require('path');
 
-// Builds the Rust CDP relay (cdp-relay.exe) on Windows and adds the one-time Hyper-V firewall
-// rule so WSL (NAT networking) can drive the real Windows browser over CDP. Idempotent.
+// Installs the prebuilt CDP relay (cdp-relay.exe) on Windows and adds the one-time
+// Hyper-V firewall rule so WSL (NAT networking) can drive the real Windows browser over CDP.
+// Idempotent.
 //
 // Why: Chromium binds its debug port to Windows loopback only, and the WSL Hyper-V firewall
 // defaults inbound to Block. A fixed-port relay + one Hyper-V allow rule bridges WSL -> browser.
-// The relay is a tiny static .exe — no Node/Python/PowerShell runtime dependency at run time.
+// The relay is a tiny prebuilt .exe — no Rust/Node/Python runtime dependency on the Windows target.
 
 const RELAY_PORT = 39222;
 const WSL_VM_CREATOR_ID = '{40E0AC32-46A5-438A-A0B2-2B479E8F2E90}'; // standard WSL VM creator id
 const RULE_NAME = 'dw-cdp-relay';
+const RELAY_EXE_SRC = path.join(__dirname, '..', 'scaffold', 'scripts', 'cdp-relay', 'bin', 'cdp-relay.exe');
 
 function isWsl() {
   if (process.env.WSL_DISTRO_NAME) return true;
@@ -31,27 +33,6 @@ function winEnv(name) {
   }
 }
 
-function findWindowsCargo() {
-  try {
-    const line = execSync('cmd.exe /c where cargo', { stdio: 'pipe' })
-      .toString()
-      .split(/\r?\n/)
-      .map((s) => s.trim())
-      .find((s) => /cargo\.exe$/i.test(s));
-    if (!line) return null;
-    const wsl = execSync(`wslpath -u "${line}"`, { stdio: 'pipe' }).toString().trim();
-    return fs.existsSync(wsl) ? { winPath: line, wslPath: wsl } : null;
-  } catch {
-    return null;
-  }
-}
-
-function copyCrate(srcDir, destWslDir) {
-  fs.mkdirSync(path.join(destWslDir, 'src'), { recursive: true });
-  fs.copyFileSync(path.join(srcDir, 'Cargo.toml'), path.join(destWslDir, 'Cargo.toml'));
-  fs.copyFileSync(path.join(srcDir, 'src', 'main.rs'), path.join(destWslDir, 'src', 'main.rs'));
-}
-
 function run() {
   console.log('\n  dev-workflow setup-wsl-browser');
   console.log(`  ${'='.repeat(40)}\n`);
@@ -68,32 +49,18 @@ function run() {
   }
   const destWin = `${localAppData}\\dev-workflow`;
   const destWsl = execSync(`wslpath -u "${destWin}"`, { stdio: 'pipe' }).toString().trim();
-  const srcWslDir = `${destWsl}/cdp-relay-src`;
-  const srcWinDir = `${destWin}\\cdp-relay-src`;
-
-  // 1) Build the relay with the Windows Rust toolchain.
-  const cargo = findWindowsCargo();
-  if (!cargo) {
-    console.log('  \x1b[33m—\x1b[0m No Windows `cargo` found (where cargo). Install Rust on Windows: https://rustup.rs');
-    console.log('    Without the relay, WSL flows fall back to the local headless Chromium (faithful, no Windows browser).');
-    return;
-  }
 
-  const crateSrc = path.join(__dirname, '..', 'scaffold', 'scripts', 'cdp-relay');
-  if (!fs.existsSync(path.join(crateSrc, 'Cargo.toml'))) {
-    console.log(`  \x1b[31m✗\x1b[0m Relay crate source not found at ${crateSrc}`);
+  // 1) Install the prebuilt Windows relay bundled in the npm package.
+  if (!fs.existsSync(RELAY_EXE_SRC)) {
+    console.log(`  \x1b[31m✗\x1b[0m Prebuilt relay not found at ${RELAY_EXE_SRC}`);
+    console.log('    The dev-workflow package is incomplete. Reinstall or update @brunosps00/dev-workflow.');
     return;
   }
 
-  process.stdout.write('  Building cdp-relay.exe (Windows cargo, release)...');
+  process.stdout.write('  Installing cdp-relay.exe (prebuilt Windows x64)...');
   try {
     fs.mkdirSync(destWsl, { recursive: true });
-    copyCrate(crateSrc, srcWslDir);
-    execSync(`"${cargo.wslPath}" build --release --manifest-path "${srcWinDir}\\Cargo.toml"`, {
-      stdio: 'pipe',
-      timeout: 180000,
-    });
-    fs.copyFileSync(path.join(srcWslDir, 'target', 'release', 'cdp-relay.exe'), path.join(destWsl, 'cdp-relay.exe'));
+    fs.copyFileSync(RELAY_EXE_SRC, path.join(destWsl, 'cdp-relay.exe'));
     console.log(' \x1b[32m✓\x1b[0m');
     console.log(`    ${destWin}\\cdp-relay.exe`);
   } catch (err) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@brunosps00/dev-workflow",
-  "version": "1.1.1",
+  "version": "1.1.2",
   "description": "AI-driven development workflow commands for any project. Scaffolds a complete PRD-to-PR pipeline with multi-platform AI assistant support.",
   "bin": {
     "dev-workflow": "./bin/dev-workflow.js"

package/scaffold/en/commands/dw-functional-doc.md

@@ -298,7 +298,7 @@ The runner drives Playwright via the Node API and records video with `page.scree
 mechanism that works over CDP). It generates `scripts/<slug>.flow.mjs` — a plain ESM module exporting
 `async function flow({ page, context, expect, baseURL, step, shot })` — not a `@playwright/test` spec,
 so it needs no project `playwright.config.*`. The browser is chosen by `.dw/scripts/lib/resolve-browser.mjs`
-(WSL-resilient: full headless Chromium by default; set `BROWSER_TEST` to a Windows browser exe to drive it over CDP — in NAT run `npx @brunosps00/dev-workflow setup-wsl-browser` once for the cdp-relay.exe + Hyper-V rule, mirrored networking works directly);
+(WSL-resilient: full headless Chromium by default; set `BROWSER_TEST` to a Windows browser exe to drive it over CDP — in NAT run `npx @brunosps00/dev-workflow setup-wsl-browser` once to install the prebuilt cdp-relay.exe + Hyper-V rule, mirrored networking works directly);
 see the "Browser on WSL" section of `dw-testing-discipline/references/playwright-recipes.md`. Chromium
 only — `screencast`/CDP do not support Firefox/WebKit.
 

package/scaffold/en/commands/dw-help.md

@@ -124,7 +124,7 @@ Match the keyword and suggest:
 | `docker`, `compose`, `container` | `/dw-dockerize` |
 | `new project`, `bootstrap`, `scaffold` | `/dw-new-project` |
 | `functional doc`, `screen map`, `e2e doc` | `/dw-functional-doc` |
-| `wsl`, `browser`, `playwright browser`, `cdp` | `npx @brunosps00/dev-workflow setup-wsl-browser` when WSL NAT must drive the real Windows browser |
+| `wsl`, `browser`, `playwright browser`, `cdp` | `npx @brunosps00/dev-workflow setup-wsl-browser` installs the prebuilt relay when WSL NAT must drive the real Windows browser |
 | `azure`, `microsoft learn`, `azure skills` | `/dw-install-azure-skills` |
 | `aws`, `aws mcp`, `aws skills` | `/dw-install-aws-skills` |
 | `incident`, `outage`, `postmortem`, `sev-1`, `sev-2` | (Skill `dw-incident-response` auto-invoked from `/dw-bugfix` for prod-critical) |

package/scaffold/pt-br/commands/dw-functional-doc.md

@@ -298,7 +298,7 @@ O runner dirige o Playwright pela API Node e grava vídeo com `page.screencast`
 funciona via CDP). Ele gera `scripts/<slug>.flow.mjs` — um módulo ESM simples que exporta
 `async function flow({ page, context, expect, baseURL, step, shot })`, não um spec `@playwright/test`,
 então dispensa o `playwright.config.*` do projeto. O browser é escolhido por `.dw/scripts/lib/resolve-browser.mjs`
-(resiliente no WSL: Chromium headless full por padrão; defina `BROWSER_TEST` com o caminho do exe do browser do Windows para dirigi-lo via CDP — em NAT rode `npx @brunosps00/dev-workflow setup-wsl-browser` uma vez para o cdp-relay.exe + regra Hyper-V, em mirrored funciona direto);
+(resiliente no WSL: Chromium headless full por padrão; defina `BROWSER_TEST` com o caminho do exe do browser do Windows para dirigi-lo via CDP — em NAT rode `npx @brunosps00/dev-workflow setup-wsl-browser` uma vez para instalar o cdp-relay.exe precompilado + regra Hyper-V, em mirrored funciona direto);
 veja a seção "Browser on WSL" de `dw-testing-discipline/references/playwright-recipes.md`. Só Chromium —
 `screencast`/CDP não suportam Firefox/WebKit.
 

package/scaffold/pt-br/commands/dw-help.md

@@ -120,7 +120,7 @@ Auto-invocados por comandos primários mas disponíveis standalone.
 | `docker`, `compose`, `container` | `/dw-dockerize` |
 | `new project`, `bootstrap`, `scaffold` | `/dw-new-project` |
 | `functional doc`, `screen map` | `/dw-functional-doc` |
-| `wsl`, `browser`, `playwright browser`, `cdp` | `npx @brunosps00/dev-workflow setup-wsl-browser` quando WSL NAT precisa dirigir o browser real do Windows |
+| `wsl`, `browser`, `playwright browser`, `cdp` | `npx @brunosps00/dev-workflow setup-wsl-browser` instala o relay precompilado quando WSL NAT precisa dirigir o browser real do Windows |
 | `azure`, `microsoft learn`, `azure skills` | `/dw-install-azure-skills` |
 | `aws`, `aws mcp`, `aws skills` | `/dw-install-aws-skills` |
 | `incident`, `outage`, `postmortem`, `sev-1` | (Skill `dw-incident-response` auto-invocada de `/dw-bugfix`) |

package/scaffold/scripts/cdp-relay/Cargo.lock

@@ -0,0 +1,7 @@
+# This file is automatically @generated by Cargo.
+# It is not intended for manual editing.
+version = 4
+
+[[package]]
+name = "cdp-relay"
+version = "0.1.0"

package/scaffold/scripts/cdp-relay/Cargo.toml

@@ -2,7 +2,7 @@
 name = "cdp-relay"
 version = "0.1.0"
 edition = "2021"
-description = "Tiny TCP forwarder so WSL can reach a Windows browser's CDP debug port in NAT mode. Built on Windows by dev-workflow; no runtime dependency."
+description = "Tiny TCP forwarder so WSL can reach a Windows browser's CDP debug port in NAT mode. Source for the prebuilt dev-workflow relay; no runtime dependency."
 
 [[bin]]
 name = "cdp-relay"

package/scaffold/scripts/cdp-relay/src/main.rs

@@ -3,7 +3,8 @@
 //! Listens on 0.0.0.0:<listen> and forwards every connection to 127.0.0.1:<target>.
 //! dev-workflow runs this on the Windows side so WSL (NAT networking) can reach a Windows
 //! browser's CDP remote-debugging port, which Chromium binds to loopback only. std-only:
-//! no crates, no runtime — a single static .exe built with the user's Windows `cargo`.
+//! no crates, no runtime. dev-workflow ships a prebuilt Windows x64 .exe; this source is
+//! kept for maintainers who need to rebuild it.
 
 use std::env;
 use std::io;

package/scaffold/scripts/lib/resolve-browser.mjs

@@ -21,7 +21,7 @@
 // networking mode WSL shares that loopback, so 127.0.0.1 connects directly. In NAT mode the
 // helper starts the prebuilt cdp-relay.exe on Windows (0.0.0.0:<fixed port> -> 127.0.0.1:debug)
 // and connects via the Windows host gateway. That needs the one-time setup performed by
-// `npx @brunosps00/dev-workflow setup-wsl-browser` (builds the relay + adds the Hyper-V firewall
+// `npx @brunosps00/dev-workflow setup-wsl-browser` (installs the prebuilt relay + adds the Hyper-V firewall
 // rule). Without it, the helper falls back to the local headless Chromium.
 
 import fs from "node:fs";
@@ -207,7 +207,7 @@ function relayPort(projectRoot) {
   return DEFAULT_RELAY_PORT;
 }
 
-// The prebuilt Rust relay (cdp-relay.exe), built on Windows by `setup-wsl-browser`. Order:
+// The prebuilt Windows relay (cdp-relay.exe), installed by `setup-wsl-browser`. Order:
 // .dw/config.json relayExe -> %LOCALAPPDATA%\dev-workflow\cdp-relay.exe. Returns { winPath, wslPath } or null.
 function findRelayExe(projectRoot) {
   const candidates = [];
@@ -293,7 +293,7 @@ async function launchWindowsBrowser(exePath, { headless, projectRoot }) {
       await cleanup();
       throw new Error(
         "WSL is in NAT mode; reaching the Windows browser needs cdp-relay.exe. Run " +
-          "`npx @brunosps00/dev-workflow setup-wsl-browser` (builds the relay on Windows and adds the " +
+          "`npx @brunosps00/dev-workflow setup-wsl-browser` (installs the prebuilt relay and adds the " +
           "Hyper-V firewall rule). Alternatively enable mirrored networking or set BROWSER_TEST to a CDP URL.",
       );
     }

package/scaffold/skills/dw-testing-discipline/references/playwright-recipes.md

@@ -288,8 +288,8 @@ Resolution order: `BROWSER_TEST` env → `.dw/config.json` (`browserTest`) → d
   Tries `127.0.0.1` first, then the Windows host (default-route gateway) for NAT.
 - **`BROWSER_TEST` = Windows exe** (e.g. `/mnt/c/.../msedge.exe`): launches it with a temp profile in
   remote-debugging mode (`--remote-allow-origins=*`) and connects over CDP. **Works in both WSL2 modes:**
-  in mirrored networking it connects to `127.0.0.1` directly; in NAT mode it starts the prebuilt
-  **`cdp-relay.exe`** (a tiny Rust binary, no runtime) on Windows — `0.0.0.0:39222` → `127.0.0.1:<debug>` —
+  in mirrored networking it connects to `127.0.0.1` directly; in NAT mode it starts the bundled
+  **`cdp-relay.exe`** (a tiny prebuilt Windows x64 binary, no runtime) on Windows — `0.0.0.0:39222` → `127.0.0.1:<debug>` —
   and connects via the Windows host gateway. Falls back to headless Chromium if the relay/rule is absent.
 - **`BROWSER_TEST` = channel** (`chrome` | `msedge` | `chromium`): launches that channel locally.
 
@@ -300,8 +300,8 @@ binds its debug port to loopback only):
 npx @brunosps00/dev-workflow setup-wsl-browser
 ```
 
-This builds `cdp-relay.exe` with the Windows Rust toolchain (`rustup` on Windows) and adds a Hyper-V
-firewall inbound allow rule for TCP 39222 (one UAC prompt). After that, the *real* Windows browser is
+This installs the `cdp-relay.exe` bundled with dev-workflow and adds a Hyper-V firewall inbound allow
+rule for TCP 39222 (one UAC prompt). No Rust toolchain is required on the Windows target. After that, the *real* Windows browser is
 driven from WSL — including `page.screencast` video — under NAT. The launched browser and relay use a
 throwaway profile and are killed on exit.