openspec-playwright 0.3.43 → 0.3.45

package/dist/shared/mcp.js

@@ -1,81 +1,45 @@
-/**
- * Shared MCP (Model Context Protocol) utilities.
- * Centralizes claude mcp check / install / remove logic.
- */
-import { execFileSync } from "node:child_process";
-import { TIMEOUT } from "./constants.js";
-import { needsShell } from "./platform.js";
-function outputIncludesPlaywright(output) {
-    return String(output ?? "").includes("playwright");
+/** Check if the named MCP server is installed in this editor. */
+export function isMcpInstalled(adapter, serverName) {
+    return adapter.isMcpInstalled(process.cwd(), serverName);
 }
-/**
- * Check if Playwright MCP server is installed in Claude Code.
- * Returns true if "playwright" appears in `claude mcp list` output.
- *
- * Note: `claude mcp list` may exit non-zero if another MCP server is
- * pending approval or unhealthy, while still printing the list. In that
- * case, read stdout/stderr from the thrown error before returning false.
- */
-export function isPlaywrightMcpInstalled() {
-    try {
-        const output = execFileSync("claude", ["mcp", "list"], {
-            encoding: "utf-8",
-            timeout: TIMEOUT.MCP_LIST,
-            stdio: ["pipe", "pipe", "pipe"],
-            shell: needsShell,
-        });
-        return outputIncludesPlaywright(output);
-    }
-    catch (err) {
-        const e = err;
-        return outputIncludesPlaywright(e.stdout) || outputIncludesPlaywright(e.stderr);
-    }
-}
-/**
- * Ensure Playwright MCP server is installed globally.
- * Prints status messages. Throws on failure.
- */
-export function ensurePlaywrightMcp() {
-    if (isPlaywrightMcpInstalled()) {
-        console.log("  ✓ Playwright MCP already installed");
+/** Install an MCP server in this editor. Throws on failure. */
+export function ensureMcp(adapter, serverName, command) {
+    if (isMcpInstalled(adapter, serverName)) {
+        console.log(`  ✓ ${adapter.label}: ${serverName} MCP already installed`);
         return;
     }
     try {
-        execFileSync("claude", ["mcp", "add", "playwright", "npx", "@playwright/mcp@latest"], {
-            encoding: "utf-8",
-            timeout: TIMEOUT.MCP_LIST,
-            stdio: ["pipe", "pipe", "pipe"],
-            shell: needsShell,
-        });
-        console.log("  ✓ Playwright MCP installed globally");
+        adapter.installMcp(process.cwd(), serverName, command);
+        console.log(`  ✓ ${adapter.label}: ${serverName} MCP installed`);
     }
-    catch {
-        console.warn("  ⚠ Failed to install Playwright MCP");
-        console.log("  Run manually: claude mcp add playwright npx @playwright/mcp@latest");
-        throw new Error("MCP installation failed");
+    catch (err) {
+        console.warn(`  ⚠ ${adapter.label}: failed to install ${serverName} MCP`);
+        throw err;
     }
 }
-/**
- * Remove Playwright MCP server from Claude Code.
- * Prints status messages. Does not throw if already absent.
- */
-export function removePlaywrightMcp() {
-    if (!isPlaywrightMcpInstalled()) {
-        console.log("  ✓ Playwright MCP not installed (nothing to remove)");
+/** Remove an MCP server from this editor. Does not throw if missing. */
+export function removeMcp(adapter, serverName) {
+    if (!isMcpInstalled(adapter, serverName)) {
+        console.log(`  - ${adapter.label}: ${serverName} MCP not installed (nothing to remove)`);
         return;
     }
     try {
-        execFileSync("claude", ["mcp", "remove", "playwright"], {
-            encoding: "utf-8",
-            timeout: TIMEOUT.MCP_LIST,
-            stdio: ["pipe", "pipe", "pipe"],
-            shell: needsShell,
-        });
-        console.log("  ✓ Playwright MCP removed");
+        adapter.removeMcp(process.cwd(), serverName);
+        console.log(`  ✓ ${adapter.label}: ${serverName} MCP removed`);
     }
     catch {
-        console.warn("  ⚠ Failed to remove Playwright MCP");
-        console.log("  Run manually: claude mcp remove playwright");
+        console.warn(`  ⚠ ${adapter.label}: failed to remove ${serverName} MCP`);
     }
 }
+// ─── Playwright MCP conveniences ────────────────────────────────────────
+const PLAYWRIGHT_MCP_COMMAND = ["npx", "@playwright/mcp@latest"];
+export function isPlaywrightMcpInstalled(adapter) {
+    return isMcpInstalled(adapter, "playwright");
+}
+export function ensurePlaywrightMcp(adapter) {
+    ensureMcp(adapter, "playwright", PLAYWRIGHT_MCP_COMMAND);
+}
+export function removePlaywrightMcp(adapter) {
+    removeMcp(adapter, "playwright");
+}
 //# sourceMappingURL=mcp.js.map

package/dist/shared/mcp.js.map

@@ -1 +1 @@
-{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../src/shared/mcp.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C,SAAS,wBAAwB,CAAC,MAAe;IAC/C,OAAO,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;AACrD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,wBAAwB;IACtC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,YAAY,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE;YACrD,QAAQ,EAAE,OAAO;YACjB,OAAO,EAAE,OAAO,CAAC,QAAQ;YACzB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;YAC/B,KAAK,EAAE,UAAU;SAClB,CAAC,CAAC;QACH,OAAO,wBAAwB,CAAC,MAAM,CAAC,CAAC;IAC1C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,GAAG,GAA6C,CAAC;QACxD,OAAO,wBAAwB,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,wBAAwB,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IAClF,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB;IACjC,IAAI,wBAAwB,EAAE,EAAE,CAAC;QAC/B,OAAO,CAAC,GAAG,CAAC,sCAAsC,CAAC,CAAC;QACpD,OAAO;IACT,CAAC;IAED,IAAI,CAAC;QACH,YAAY,CACV,QAAQ,EACR,CAAC,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,wBAAwB,CAAC,EAC7D;YACE,QAAQ,EAAE,OAAO;YACjB,OAAO,EAAE,OAAO,CAAC,QAAQ;YACzB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;YAC/B,KAAK,EAAE,UAAU;SAClB,CACF,CAAC;QACF,OAAO,CAAC,GAAG,CAAC,uCAAuC,CAAC,CAAC;IACvD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;QACrD,OAAO,CAAC,GAAG,CAAC,sEAAsE,CAAC,CAAC;QACpF,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC7C,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB;IACjC,IAAI,CAAC,wBAAwB,EAAE,EAAE,CAAC;QAChC,OAAO,CAAC,GAAG,CAAC,sDAAsD,CAAC,CAAC;QACpE,OAAO;IACT,CAAC;IAED,IAAI,CAAC;QACH,YAAY,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,YAAY,CAAC,EAAE;YACtD,QAAQ,EAAE,OAAO;YACjB,OAAO,EAAE,OAAO,CAAC,QAAQ;YACzB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;YAC/B,KAAK,EAAE,UAAU;SAClB,CAAC,CAAC;QACH,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC;QACpD,OAAO,CAAC,GAAG,CAAC,8CAA8C,CAAC,CAAC;IAC9D,CAAC;AACH,CAAC"}
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../src/shared/mcp.ts"],"names":[],"mappings":"AAUA,iEAAiE;AACjE,MAAM,UAAU,cAAc,CAAC,OAAsB,EAAE,UAAkB;IACvE,OAAO,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,UAAU,CAAC,CAAC;AAC3D,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,SAAS,CACvB,OAAsB,EACtB,UAAkB,EAClB,OAAiB;IAEjB,IAAI,cAAc,CAAC,OAAO,EAAE,UAAU,CAAC,EAAE,CAAC;QACxC,OAAO,CAAC,GAAG,CAAC,OAAO,OAAO,CAAC,KAAK,KAAK,UAAU,wBAAwB,CAAC,CAAC;QACzE,OAAO;IACT,CAAC;IACD,IAAI,CAAC;QACH,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;QACvD,OAAO,CAAC,GAAG,CAAC,OAAO,OAAO,CAAC,KAAK,KAAK,UAAU,gBAAgB,CAAC,CAAC;IACnE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,IAAI,CAAC,OAAO,OAAO,CAAC,KAAK,uBAAuB,UAAU,MAAM,CAAC,CAAC;QAC1E,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,SAAS,CAAC,OAAsB,EAAE,UAAkB;IAClE,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,UAAU,CAAC,EAAE,CAAC;QACzC,OAAO,CAAC,GAAG,CAAC,OAAO,OAAO,CAAC,KAAK,KAAK,UAAU,wCAAwC,CAAC,CAAC;QACzF,OAAO;IACT,CAAC;IACD,IAAI,CAAC;QACH,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,UAAU,CAAC,CAAC;QAC7C,OAAO,CAAC,GAAG,CAAC,OAAO,OAAO,CAAC,KAAK,KAAK,UAAU,cAAc,CAAC,CAAC;IACjE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,IAAI,CAAC,OAAO,OAAO,CAAC,KAAK,sBAAsB,UAAU,MAAM,CAAC,CAAC;IAC3E,CAAC;AACH,CAAC;AAED,2EAA2E;AAE3E,MAAM,sBAAsB,GAAG,CAAC,KAAK,EAAE,wBAAwB,CAAC,CAAC;AAEjE,MAAM,UAAU,wBAAwB,CAAC,OAAsB;IAC7D,OAAO,cAAc,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,OAAsB;IACxD,SAAS,CAAC,OAAO,EAAE,YAAY,EAAE,sBAAsB,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,OAAsB;IACxD,SAAS,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;AACnC,CAAC"}

package/employee-standards.md

@@ -1,4 +1,4 @@
-# Claude Code Employee-Grade Standards
+# AI Coding Assistant Employee-Grade Standards
 
 > 员工级行为规范。
 
@@ -6,7 +6,7 @@
 
 ## 0. 适用范围
 
-本规范适用于 OpenSpec + openspec-playwright 项目（Claude Code 作为开发工具）。
+本规范适用于 OpenSpec + openspec-playwright 项目（使用 AI 编码助手，如 Claude Code 或 OpenCode）。
 
 **项目规范**：动手前读 `openspec/config.yaml`（技术栈、结构、约定、约束等），无内容则忽略。
 
@@ -72,8 +72,22 @@
 
 按需叠加的评审：`/plan-ceo-review`（产品战略）/ `/plan-eng-review`（架构）/ `/plan-design-review`（UX）。
 
-阶段命令即触发器：`/opsx:propose` → `/opsx:apply` → `/opsx:verify` → `/opsx:e2e` → `/opsx:archive`。**所有阶段由用户手动触发，AI 不自动进入下一阶段**（详见 §2 阶段隔离）。
+阶段命令即触发器：`/opsx:propose` → `/opsx:apply` → `/opsx:verify` → e2e 命令（Claude Code 用 `/opsx:e2e`，OpenCode 用 `/opsx-e2e`）→ `/opsx:archive`。**所有阶段由用户手动触发，AI 不自动进入下一阶段**（详见 §2 阶段隔离）。
 
 可用 `npx openspec --help` 查看更多 OpenSpec 命令。
 
 方向不明时可用 `/office-hours` 做创意验证。**Healer 需要 Playwright 环境**；非 Node.js 项目请参考各自语言的 OpenSpec 测试集成。
+
+## 6. 禁止编撰数据
+
+无论前后端一体还是纯前端项目，AI 助手**严禁**主动编撰任何数据填充代码，除非用户明确同意。
+
+**适用范围**：mock 用户 / 邮箱 / 手机号；编造的测试期望值（"期望返回 `{ success: true }`" 等）；凭空出现的配置默认值（API URL、feature flag、密钥）；假装存在的接口 / 字段 / 枚举值。
+
+**强制流程**：
+1. 遇需数据的代码位 → **必须**显式询问用户
+2. 用户同意占位 → 用 `TODO(user)` 标注并附问询上下文
+3. 用户提供数据 → 使用真实数据
+4. 用户拒绝提供 → 用 stub / `throw` / `return null` 让代码显式失败，**禁止**静默编造值
+
+**纯前端项目**：若存在 OpenAPI / 接口文档 / MCP 暴露的接口，必须查阅真实定义后引用，并标注来源（例如 `// 来源: docs/api/openapi.yaml#/paths/...`），禁止凭印象编造 endpoint / path / 字段名。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openspec-playwright",
-  "version": "0.3.43",
+  "version": "0.3.45",
   "description": "OpenSpec + Playwright E2E verification setup tool for Claude Code",
   "type": "module",
   "bin": {
@@ -22,8 +22,9 @@
     "chalk": "^5.3.0",
     "commander": "^12.1.0",
     "glob": "^13.0.6",
+    "jsonc-parser": "^3.3.1",
     "playwright": "^1.50.0",
-    "tar": "^7.5.13"
+    "tar": "^7.5.16"
   },
   "devDependencies": {
     "@types/glob": "^8.1.0",
@@ -37,6 +38,9 @@
     "typescript": "^5.6.0",
     "vitest": "^4.1.2"
   },
+  "overrides": {
+    "vite": "^8.0.16"
+  },
   "engines": {
     "node": ">=20"
   },

package/templates/e2e-command.md

@@ -666,6 +666,8 @@ if (cachedSelectors && cachedSelectors.length > 0) {
 
 **Test coverage — empty states**: For list/detail pages, explore the empty state. If the app shows a "no data" UI when the list is empty, generate a test to verify it. Empty states are often missing from specs but are real user paths.
 
+**Test data fabrication**: never invent user accounts, product lists, or API responses. Follow §6 of the employee standards — explicitly ask the user for test data; use `TODO(user)` markers for approved placeholders; fail loudly rather than fabricate.
+
 **Test coverage — special elements**: Check `app-exploration.md` → **Special Elements Detected** table. For each special element, generate tests using the following strategies:
 - Canvas: screenshot + boundingBox → dimensions > 0, or 2D pixel verification
 - WebGL: screenshot only (no pixel comparison — rendering varies)