@webpresso/agent-kit 0.26.0 → 0.26.1

package/.claude-plugin/marketplace.json

@@ -6,7 +6,7 @@
   },
   "metadata": {
     "description": "Webpresso agent-kit Claude Code plugin: blueprints, skills, hooks, MCP server",
-    "version": "0.26.0"
+    "version": "0.26.1"
   },
   "plugins": [
     {
@@ -23,5 +23,5 @@
       ]
     }
   ],
-  "version": "0.26.0"
+  "version": "0.26.1"
 }

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "webpresso",
-  "version": "0.26.0",
+  "version": "0.26.1",
   "description": "Webpresso agent-kit: blueprints, skills, lore commit protocol, tech-debt lifecycle",
   "skills": "./skills",
   "commands": "./commands",

package/dist/esm/audit/toolchain-isolation.js

@@ -114,6 +114,11 @@ function shouldSkipDirectory(name) {
         '.omx',
         '.omc',
         '.codex',
+        // Gitignored Claude Code agent surface — agent worktree scratch under
+        // .claude/worktrees/* carries vendored package manifests that are not the
+        // repo's own packages; walking it produces false positives on local dev
+        // machines and in consumer repos that run agent worktrees.
+        '.claude',
     ].includes(name);
 }
 function readPackageJson(file) {

package/dist/esm/cli/commands/init/index.js

@@ -35,7 +35,7 @@ import { scaffoldAuditHooks } from './scaffolders/audit-hooks/index.js';
 import { ensureClaudeCodeUserPlugin } from './scaffolders/claude-plugin/index.js';
 import { scaffoldClaudeRules } from './scaffolders/claude-rules/index.js';
 import { ensureCodexCli } from './scaffolders/codex-cli/index.js';
-import { ensureCodexWebpressoMcp, ensureCodexPlaywrightMcp } from './scaffolders/codex-mcp/index.js';
+import { ensureCodexWebpressoMcp, ensureCodexPlaywrightMcp, ensureClaudePlaywrightMcp, } from './scaffolders/codex-mcp/index.js';
 import { scaffoldExampleSkill } from './scaffolders/example-skill/index.js';
 import { ensureGstack } from './scaffolders/gstack/index.js';
 import { scaffoldLoreCommits } from './scaffolders/lore-commits/index.js';
@@ -437,6 +437,24 @@ export async function runInit(flags) {
                     console.log('  codex playwright mcp: skipped (--dry-run)');
                     break;
             }
+            const claudePlaywrightMcpResult = ensureClaudePlaywrightMcp({
+                options,
+                repoRoot: consumer.repoRoot,
+            });
+            switch (claudePlaywrightMcpResult.kind) {
+                case 'claude-playwright-mcp-written':
+                    console.log(`  claude playwright mcp: ✓ ${claudePlaywrightMcpResult.path}`);
+                    break;
+                case 'claude-playwright-mcp-unchanged':
+                    console.log(`  claude playwright mcp: already configured at ${claudePlaywrightMcpResult.path}`);
+                    break;
+                case 'claude-playwright-mcp-skipped-dry-run':
+                    console.log('  claude playwright mcp: skipped (--dry-run)');
+                    break;
+                case 'claude-playwright-mcp-invalid-json':
+                    console.warn(`  claude playwright mcp: ⚠ ${claudePlaywrightMcpResult.path} is not valid JSON; left unchanged`);
+                    break;
+            }
         }
         if (presets.includes('omx')) {
             agentHooksResult = await scaffoldAgentHooks({

package/dist/esm/cli/commands/init/scaffolders/codex-cli/index.js

@@ -20,7 +20,11 @@ export function ensureCodexCli(input) {
         }
     }
     else if (!shouldSkipCodexRefresh()) {
-        spawn('vp', ['update', '-g', '@openai/codex'], { stdio: 'inherit' });
+        // `--latest` ignores the recorded semver range so the global is pulled to
+        // the absolute newest published release, matching the force-to-latest
+        // guarantee `vp install -g <bare>` gives the agent-kit self-update. Plain
+        // `vp update -g` is range-bound and can strand the global on an old major.
+        spawn('vp', ['update', '-g', '--latest', '@openai/codex'], { stdio: 'inherit' });
     }
     return { kind: 'codex-cli-ok', installed };
 }

package/dist/esm/cli/commands/init/scaffolders/codex-mcp/index.d.ts

@@ -1,7 +1,7 @@
 import type { MergeOptions } from '#cli/commands/init/merge';
 export declare const PLAYWRIGHT_MCP_SERVER_NAME = "playwright";
 export declare const PLAYWRIGHT_MCP_HEADER = "[mcp_servers.playwright]";
-export declare const PLAYWRIGHT_MCP_BLOCK = "[mcp_servers.playwright]\ncommand = \"vp\"\nargs = [\"dlx\", \"@playwright/mcp@latest\", \"--caps=testing,storage,network,devtools\"]\nenabled = true\nstartup_timeout_sec = 30\n";
+export declare const PLAYWRIGHT_MCP_BLOCK: string;
 export declare const WEBPRESSO_MCP_SERVER_NAME = "webpresso";
 export declare const WEBPRESSO_MCP_HEADER = "[mcp_servers.webpresso]";
 export interface EnsureCodexPlaywrightMcpInput {
@@ -21,6 +21,34 @@ export type EnsureCodexPlaywrightMcpResult = {
 };
 export declare function upsertPlaywrightMcpServer(raw: string): string;
 export declare function ensureCodexPlaywrightMcp(input: EnsureCodexPlaywrightMcpInput): EnsureCodexPlaywrightMcpResult;
+/**
+ * Upsert the `playwright` server into a `.mcp.json` document, preserving every
+ * other server (e.g. `context7`, `exa`) and any non-server top-level keys.
+ * Output is normalized to 2-space JSON with a trailing newline so repeated runs
+ * converge — idempotent after the first write.
+ */
+export declare function upsertClaudePlaywrightMcpServer(raw: string): string;
+export interface EnsureClaudePlaywrightMcpInput {
+    options: MergeOptions;
+    /** Project root whose `.mcp.json` is managed. */
+    repoRoot: string;
+    /** Test seam. Defaults to `<repoRoot>/.mcp.json`. */
+    configPath?: string;
+}
+export type EnsureClaudePlaywrightMcpResult = {
+    kind: 'claude-playwright-mcp-written';
+    path: string;
+} | {
+    kind: 'claude-playwright-mcp-unchanged';
+    path: string;
+} | {
+    kind: 'claude-playwright-mcp-skipped-dry-run';
+    path: string;
+} | {
+    kind: 'claude-playwright-mcp-invalid-json';
+    path: string;
+};
+export declare function ensureClaudePlaywrightMcp(input: EnsureClaudePlaywrightMcpInput): EnsureClaudePlaywrightMcpResult;
 export interface WebpressoInstallProbe {
     /** Test seam — override the candidate roots. Default: probe in fixed order. */
     candidates?: readonly string[];

package/dist/esm/cli/commands/init/scaffolders/codex-mcp/index.js

@@ -22,10 +22,27 @@ import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
 import { homedir } from 'node:os';
 import { dirname, join } from 'node:path';
 export const PLAYWRIGHT_MCP_SERVER_NAME = 'playwright';
+/**
+ * Single source of truth for how the Playwright MCP server is launched. Both
+ * the Codex TOML block and the Claude Code `.mcp.json` block render from these.
+ * The portable `vp dlx` facade fetches the npm-published server on demand, so
+ * there is no machine-specific bin path to rot — the failure mode a hand-
+ * authored `~/.bun/bin/playwright-mcp` entry hits the moment that global bin
+ * disappears (ENOENT on spawn).
+ */
+const PLAYWRIGHT_MCP_COMMAND = 'vp';
+const PLAYWRIGHT_MCP_ARGS = [
+    'dlx',
+    '@playwright/mcp@latest',
+    '--caps=testing,storage,network,devtools',
+];
+function tomlStringArray(values) {
+    return `[${values.map((value) => `"${value}"`).join(', ')}]`;
+}
 export const PLAYWRIGHT_MCP_HEADER = `[mcp_servers.${PLAYWRIGHT_MCP_SERVER_NAME}]`;
 export const PLAYWRIGHT_MCP_BLOCK = `${PLAYWRIGHT_MCP_HEADER}
-command = "vp"
-args = ["dlx", "@playwright/mcp@latest", "--caps=testing,storage,network,devtools"]
+command = "${PLAYWRIGHT_MCP_COMMAND}"
+args = ${tomlStringArray(PLAYWRIGHT_MCP_ARGS)}
 enabled = true
 startup_timeout_sec = 30
 `;
@@ -70,6 +87,59 @@ export function ensureCodexPlaywrightMcp(input) {
     writeFileSync(configPath, next, 'utf8');
     return { kind: 'codex-playwright-mcp-written', path: configPath };
 }
+function claudePlaywrightServer() {
+    return { command: PLAYWRIGHT_MCP_COMMAND, args: [...PLAYWRIGHT_MCP_ARGS] };
+}
+function isJsonRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function parseJson(raw) {
+    try {
+        return { ok: true, value: JSON.parse(raw) };
+    }
+    catch {
+        return { ok: false };
+    }
+}
+/**
+ * Upsert the `playwright` server into a `.mcp.json` document, preserving every
+ * other server (e.g. `context7`, `exa`) and any non-server top-level keys.
+ * Output is normalized to 2-space JSON with a trailing newline so repeated runs
+ * converge — idempotent after the first write.
+ */
+export function upsertClaudePlaywrightMcpServer(raw) {
+    const parsed = raw.trim().length > 0 ? parseJson(raw) : { ok: true, value: {} };
+    if (!parsed.ok) {
+        throw new Error('cannot upsert playwright into .mcp.json: existing file is not valid JSON');
+    }
+    const root = isJsonRecord(parsed.value) ? parsed.value : {};
+    const servers = isJsonRecord(root.mcpServers) ? root.mcpServers : {};
+    const next = {
+        ...root,
+        mcpServers: {
+            ...servers,
+            [PLAYWRIGHT_MCP_SERVER_NAME]: claudePlaywrightServer(),
+        },
+    };
+    return `${JSON.stringify(next, null, 2)}\n`;
+}
+export function ensureClaudePlaywrightMcp(input) {
+    const configPath = input.configPath ?? join(input.repoRoot, '.mcp.json');
+    if (input.options.dryRun) {
+        return { kind: 'claude-playwright-mcp-skipped-dry-run', path: configPath };
+    }
+    const existing = existsSync(configPath) ? readFileSync(configPath, 'utf8') : '';
+    if (existing.trim().length > 0 && !parseJson(existing).ok) {
+        return { kind: 'claude-playwright-mcp-invalid-json', path: configPath };
+    }
+    const next = upsertClaudePlaywrightMcpServer(existing);
+    if (next === existing) {
+        return { kind: 'claude-playwright-mcp-unchanged', path: configPath };
+    }
+    mkdirSync(dirname(configPath), { recursive: true });
+    writeFileSync(configPath, next, 'utf8');
+    return { kind: 'claude-playwright-mcp-written', path: configPath };
+}
 // ────────────────────────────────────────────────────────────────────────────
 // Agent-kit MCP server registration
 // ────────────────────────────────────────────────────────────────────────────

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webpresso/agent-kit",
-  "version": "0.26.0",
+  "version": "0.26.1",
   "private": false,
   "repository": {
     "type": "git",
@@ -710,10 +710,10 @@
     "@stryker-mutator/typescript-checker": "^9.6.1",
     "@playwright/test": "^1.55.0",
     "wrangler": "^4.50.0",
-    "@webpresso/agent-kit-runtime-darwin-arm64": "0.26.0",
-    "@webpresso/agent-kit-runtime-darwin-x64": "0.26.0",
-    "@webpresso/agent-kit-runtime-linux-x64": "0.26.0",
-    "@webpresso/agent-kit-runtime-linux-arm64": "0.26.0",
-    "@webpresso/agent-kit-runtime-windows-x64": "0.26.0"
+    "@webpresso/agent-kit-runtime-darwin-arm64": "0.26.1",
+    "@webpresso/agent-kit-runtime-darwin-x64": "0.26.1",
+    "@webpresso/agent-kit-runtime-linux-x64": "0.26.1",
+    "@webpresso/agent-kit-runtime-linux-arm64": "0.26.1",
+    "@webpresso/agent-kit-runtime-windows-x64": "0.26.1"
   }
 }