Simplify Workspace V2 Playwright gate to use installed dependencies only - PR_11_320

Author: DavidQ

docs/dev/codex_commands.md

@@ -215,3 +215,10 @@ PR_11_319
 ```bash
 npx @openai/codex run --model gpt-5.3-codex --reasoning medium "Implement PR_11_319: Add required Workspace V2 Playwright gate command with explicit pass/fail summary and non-zero failure handling."
 ```
+
+---
+PR_11_320
+
+```bash
+npx @openai/codex run --model gpt-5.3-codex --reasoning medium "Implement PR_11_320: Update Workspace V2 Playwright gate to execute installed Playwright command path only, preserving fail-fast and summary output."
+```

docs/dev/commit_comment.txt

@@ -1 +1 @@
-Promote Workspace V2 Playwright validation into required gate script with explicit non-zero failure handling - PR 11.319
+Update Workspace V2 Playwright gate to use installed command path while preserving fail-fast summary behavior - PR 11.320

docs/dev/reports/PR_11_320_report.md

@@ -0,0 +1,33 @@
+# PR_11_320 Report
+
+## Purpose
+Update Workspace V2 Playwright gate execution for installed Playwright command usage without install/bootstrap behaviors.
+
+## Files Changed
+- `package.json`
+- `scripts/run-workspace-v2-playwright-gate.mjs`
+- `docs/pr/PR_11_320_WORKSPACE_V2_GATE_UPDATE/PLAN_PR.md`
+- `docs/pr/PR_11_320_WORKSPACE_V2_GATE_UPDATE/BUILD_PR.md`
+- `docs/dev/reports/PR_11_320_report.md`
+- `docs/dev/codex_commands.md`
+- `docs/dev/commit_comment.txt`
+
+## Implementation Summary
+- Added explicit installed Playwright command script:
+  - `npm run test:workspace-v2:playwright`
+- Kept gate command:
+  - `npm run test:workspace-v2`
+- Gate runner now executes installed command path through Node/npm CLI path and preserves:
+  - fail-fast non-zero exit on any failure
+  - clear summary output:
+    - `Workspace V2 Playwright Gate Summary: passed=<n> failed=<n>`
+- Existing results/report behavior remains under `tests/results/**` from prior Playwright config.
+
+## Validation Commands
+- `node -e "const fs=require('fs'); JSON.parse(fs.readFileSync('package.json','utf8')); console.log('package.json parse: PASS');"` -> **PASS**
+- `node --check scripts/run-workspace-v2-playwright-gate.mjs` -> **PASS**
+- `npm run test:workspace-v2` -> **PASS**
+
+## Notes
+- No test logic changes.
+- No runtime/schema/tool behavior changes.

docs/pr/PR_11_320_WORKSPACE_V2_GATE_UPDATE/BUILD_PR.md

@@ -0,0 +1,21 @@
+# BUILD_PR_11_320
+
+## Implementation
+- Updated `package.json` scripts:
+  - added `test:workspace-v2:playwright`:
+    - `playwright test tests/ui/workspace-v2.asset-manager.spec.js`
+  - kept `test:workspace-v2` gate entry:
+    - `node ./scripts/run-workspace-v2-playwright-gate.mjs`
+- Updated `scripts/run-workspace-v2-playwright-gate.mjs`:
+  - executes installed Playwright command path via Node:
+    - preferred: `process.execPath + process.env.npm_execpath run --silent test:workspace-v2:playwright`
+    - fallback: local Playwright CLI path under `node_modules`
+  - preserves:
+    - streamed output
+    - clear gate summary
+    - non-zero exit on any failure condition
+
+## Validation
+- `node -e "const fs=require('fs'); JSON.parse(fs.readFileSync('package.json','utf8')); console.log('package.json parse: PASS');"`
+- `node --check scripts/run-workspace-v2-playwright-gate.mjs`
+- `npm run test:workspace-v2`

docs/pr/PR_11_320_WORKSPACE_V2_GATE_UPDATE/PLAN_PR.md

@@ -0,0 +1,18 @@
+# PLAN_PR_11_320
+
+## Purpose
+Update the Workspace V2 Playwright gate script to run the installed Playwright command path only, without install/bootstrap behaviors.
+
+## Scope
+- `package.json`
+- `scripts/run-workspace-v2-playwright-gate.mjs`
+- `docs/dev/reports/PR_11_320_report.md`
+- `docs/dev/codex_commands.md`
+- `docs/dev/commit_comment.txt`
+
+## Steps
+1. Add an explicit script for the installed Playwright command path.
+2. Update gate runner to execute that command through Node/npm CLI path (no install/bootstrap).
+3. Preserve fail-fast non-zero exit and pass/fail summary output.
+4. Keep results/report behavior under `tests/results/**` via existing Playwright config.
+5. Run required parse/syntax/test validations.

package.json

@@ -11,6 +11,7 @@
     "check:phase24-closeout-guard": "node tools/dev/checkPhase24CloseoutExecutionGuard.mjs",
     "check:style-system-guard": "node tools/dev/checkStyleSystemGuard.mjs",
     "check:games-template-contract": "node ./scripts/validate-games-template-contract.mjs",
+    "test:workspace-v2:playwright": "playwright test tests/ui/workspace-v2.asset-manager.spec.js",
     "test:workspace-v2": "node ./scripts/run-workspace-v2-playwright-gate.mjs",
     "test:launch-smoke": "node ./tests/runtime/LaunchSmokeAllEntries.test.mjs",
     "test:launch-smoke:games": "node ./tests/runtime/LaunchSmokeAllEntries.test.mjs --games",

scripts/run-workspace-v2-playwright-gate.mjs

@@ -11,12 +11,11 @@ import { fileURLToPath } from "node:url";
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 const repoRoot = path.resolve(__dirname, "..");
+const npmExecPath = typeof process.env.npm_execpath === "string" ? process.env.npm_execpath.trim() : "";
 const command = process.execPath;
-const args = [
-  path.join(repoRoot, "node_modules", "@playwright", "test", "cli.js"),
-  "test",
-  "tests/ui/workspace-v2.asset-manager.spec.js"
-];
+const args = npmExecPath
+  ? [npmExecPath, "run", "--silent", "test:workspace-v2:playwright"]
+  : [path.join(repoRoot, "node_modules", "@playwright", "test", "cli.js"), "test", "tests/ui/workspace-v2.asset-manager.spec.js"];
 
 const result = spawnSync(command, args, {
   cwd: repoRoot,