@cubis/foundry 0.3.69 → 0.3.70

package/mcp/src/upstream/passthrough.ts

@@ -10,11 +10,12 @@ import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
 import {
   parsePostmanState,
   parseStitchState,
+  parsePlaywrightState,
   readEffectiveConfig,
 } from "../cbxConfig/index.js";
 import type { CbxConfig, ConfigScope } from "../cbxConfig/types.js";
 
-type ServiceId = "postman" | "stitch";
+type ServiceId = "postman" | "stitch" | "playwright";
 
 export interface UpstreamToolInfo {
   name: string;
@@ -126,7 +127,10 @@ async function loadCachedCatalogTools({
   }
 }
 
-function getServiceAuth(config: CbxConfig, service: ServiceId): {
+function getServiceAuth(
+  config: CbxConfig,
+  service: ServiceId,
+): {
   mcpUrl: string | null;
   activeProfileName: string | null;
   envVar: string | null;
@@ -134,6 +138,17 @@ function getServiceAuth(config: CbxConfig, service: ServiceId): {
   configured: boolean;
   error?: string;
 } {
+  if (service === "playwright") {
+    const state = parsePlaywrightState(config);
+    return {
+      mcpUrl: state.mcpUrl,
+      activeProfileName: null,
+      envVar: null,
+      headers: {},
+      configured: Boolean(state.mcpUrl),
+    };
+  }
+
   if (service === "postman") {
     const state = parsePostmanState(config);
     const activeProfile = state.activeProfile;
@@ -214,9 +229,11 @@ function isCallToolResult(
   result: Awaited<ReturnType<Client["callTool"]>>,
 ): result is CallToolResult {
   return Array.isArray(
-    (result as {
-      content?: unknown;
-    }).content,
+    (
+      result as {
+        content?: unknown;
+      }
+    ).content,
   );
 }
 
@@ -275,6 +292,7 @@ export async function discoverUpstreamCatalogs(
 ): Promise<{
   postman: UpstreamCatalog;
   stitch: UpstreamCatalog;
+  playwright: UpstreamCatalog;
 }> {
   const effective = readEffectiveConfig(scope);
   if (!effective) {
@@ -291,9 +309,14 @@ export async function discoverUpstreamCatalogs(
       discoveryError: "cbx_config.json not found",
     };
     const missingStitch: UpstreamCatalog = { ...missing, service: "stitch" };
+    const missingPlaywright: UpstreamCatalog = {
+      ...missing,
+      service: "playwright",
+    };
     return {
       postman: missing,
       stitch: missingStitch,
+      playwright: missingPlaywright,
     };
   }
 
@@ -366,6 +389,7 @@ export async function discoverUpstreamCatalogs(
   return {
     postman: await discoverOne("postman"),
     stitch: await discoverOne("stitch"),
+    playwright: await discoverOne("playwright"),
   };
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cubis/foundry",
-  "version": "0.3.69",
+  "version": "0.3.70",
   "description": "Cubis Foundry CLI for workflow-first AI agent environments",
   "type": "module",
   "bin": {

package/src/cli/core.ts

@@ -217,6 +217,10 @@ const STITCH_SKILL_ID = "stitch";
 const STITCH_MCP_SERVER_ID = "StitchMCP";
 const STITCH_API_KEY_ENV_VAR = "STITCH_API_KEY_DEFAULT";
 const STITCH_MCP_URL = "https://stitch.googleapis.com/mcp";
+const PLAYWRIGHT_SKILL_ID = "playwright";
+const PLAYWRIGHT_MCP_SERVER_ID = "PlaywrightMCP";
+const PLAYWRIGHT_DEFAULT_PORT = 8931;
+const PLAYWRIGHT_MCP_URL = `http://localhost:${PLAYWRIGHT_DEFAULT_PORT}/mcp`;
 const POSTMAN_WORKSPACE_MANUAL_CHOICE = "__postman_workspace_manual__";
 const CBX_CONFIG_FILENAME = "cbx_config.json";
 const CBX_CREDENTIALS_ENV_FILENAME = "credentials.env";
@@ -4719,6 +4723,30 @@ function buildGeminiStitchServer({
   };
 }
 
+function buildVsCodePlaywrightServer({ mcpUrl = PLAYWRIGHT_MCP_URL } = {}) {
+  return {
+    type: "http",
+    url: mcpUrl,
+    headers: {},
+  };
+}
+
+function buildCopilotCliPlaywrightServer({ mcpUrl = PLAYWRIGHT_MCP_URL } = {}) {
+  return {
+    type: "http",
+    url: mcpUrl,
+    headers: {},
+    tools: ["*"],
+  };
+}
+
+function buildGeminiPlaywrightServer({ mcpUrl = PLAYWRIGHT_MCP_URL } = {}) {
+  return {
+    httpUrl: mcpUrl,
+    headers: {},
+  };
+}
+
 function getPostmanApiKeySource({ apiKey, envApiKey }) {
   if (apiKey) return "inline";
   if (envApiKey) return "env";
@@ -5210,6 +5238,7 @@ async function applyPostmanMcpForPlatform({
   stitchMcpUrl,
   includeStitchMcp = false,
   includeFoundryMcp = true,
+  includePlaywrightMcp = false,
   foundryRuntime = "local",
   dryRun = false,
   cwd = process.cwd(),
@@ -5278,6 +5307,9 @@ async function applyPostmanMcpForPlatform({
             mcpUrl: stitchMcpUrl,
           });
         }
+        if (includePlaywrightMcp) {
+          mcpServers[PLAYWRIGHT_MCP_SERVER_ID] = buildGeminiPlaywrightServer();
+        }
         next.mcpServers = mcpServers;
         return next;
       },
@@ -5324,6 +5356,10 @@ async function applyPostmanMcpForPlatform({
           } else {
             delete mcpServers[FOUNDRY_MCP_SERVER_ID];
           }
+          if (includePlaywrightMcp) {
+            mcpServers[PLAYWRIGHT_MCP_SERVER_ID] =
+              buildCopilotCliPlaywrightServer();
+          }
           next.mcpServers = mcpServers;
           return next;
         }
@@ -5350,6 +5386,9 @@ async function applyPostmanMcpForPlatform({
         } else {
           delete servers[FOUNDRY_MCP_SERVER_ID];
         }
+        if (includePlaywrightMcp) {
+          servers[PLAYWRIGHT_MCP_SERVER_ID] = buildVsCodePlaywrightServer();
+        }
         next.servers = servers;
         return next;
       },
@@ -5401,6 +5440,9 @@ async function applyPostmanMcpForPlatform({
           } else {
             delete servers[FOUNDRY_MCP_SERVER_ID];
           }
+          if (includePlaywrightMcp) {
+            servers[PLAYWRIGHT_MCP_SERVER_ID] = buildVsCodePlaywrightServer();
+          }
           next.servers = servers;
           return next;
         },
@@ -5529,6 +5571,57 @@ async function applyPostmanMcpForPlatform({
     };
   }
 
+  if (platform === "claude") {
+    const claudeConfigPath =
+      mcpScope === "global"
+        ? path.join(os.homedir(), ".claude", "mcp.json")
+        : path.join(workspaceRoot, ".mcp.json");
+    const result = await upsertJsonObjectFile({
+      targetPath: claudeConfigPath,
+      updater: (existing) => {
+        const next = { ...existing };
+        const mcpServers =
+          next.mcpServers &&
+          typeof next.mcpServers === "object" &&
+          !Array.isArray(next.mcpServers)
+            ? { ...next.mcpServers }
+            : {};
+        if (includeFoundryMcp) {
+          if (normalizedFoundryRuntime === "docker") {
+            mcpServers[FOUNDRY_MCP_SERVER_ID] = {
+              type: "url",
+              url: buildFoundryDockerUrl({ port: foundryDockerPort }),
+            };
+          } else {
+            mcpServers[FOUNDRY_MCP_SERVER_ID] = {
+              type: "stdio",
+              command: FOUNDRY_MCP_COMMAND,
+              args: buildFoundryServeArgs({ scope: foundryScope }),
+            };
+          }
+        } else {
+          delete mcpServers[FOUNDRY_MCP_SERVER_ID];
+        }
+        if (includePlaywrightMcp) {
+          mcpServers[PLAYWRIGHT_MCP_SERVER_ID] = {
+            type: "url",
+            url: PLAYWRIGHT_MCP_URL,
+          };
+        }
+        next.mcpServers = mcpServers;
+        return next;
+      },
+      dryRun,
+    });
+    return {
+      kind: "claude-mcp",
+      scope: mcpScope,
+      path: claudeConfigPath,
+      action: result.action,
+      warnings: [...warnings, ...result.warnings],
+    };
+  }
+
   return {
     kind: "unknown",
     scope: mcpScope,
@@ -5606,10 +5699,7 @@ async function resolvePostmanInstallSelection({
     : null;
   let workspaceSelectionSource = hasWorkspaceOption ? "option" : "none";
   const requestedMcpScope = options.mcpScope
-    ? coerceWorkspaceOnlyMcpScope(
-        options.mcpScope,
-        "--mcp-scope",
-      )
+    ? coerceWorkspaceOnlyMcpScope(options.mcpScope, "--mcp-scope")
     : null;
   let mcpScope = requestedMcpScope?.scope || "project";
   const warnings = [];
@@ -6057,6 +6147,7 @@ async function configurePostmanInstallArtifacts({
         stitchMcpUrl: effectiveStitchMcpUrl,
         includeStitchMcp: shouldInstallStitch,
         includeFoundryMcp: postmanSelection.foundryMcpEnabled,
+        includePlaywrightMcp: postmanSelection.playwrightEnabled ?? false,
         foundryRuntime: postmanSelection.effectiveMcpRuntime || "local",
         dryRun,
         cwd,
@@ -6167,6 +6258,7 @@ async function applyPostmanConfigArtifacts({
     POSTMAN_API_KEY_ENV_VAR;
   const postmanMcpUrl = postmanState.mcpUrl || POSTMAN_MCP_URL;
   const stitchEnabled = Boolean(stitchState);
+  const playwrightEnabled = Boolean(configValue?.playwright);
   const stitchApiKeyEnvVar =
     normalizePostmanApiKey(stitchState?.apiKeyEnvVar) || STITCH_API_KEY_ENV_VAR;
   const stitchMcpUrl = stitchState?.mcpUrl || STITCH_MCP_URL;
@@ -6239,6 +6331,7 @@ async function applyPostmanConfigArtifacts({
       stitchMcpUrl,
       includeStitchMcp: stitchEnabled,
       includeFoundryMcp: true,
+      includePlaywrightMcp: playwrightEnabled ?? false,
       foundryRuntime,
       dryRun,
       cwd,
@@ -8239,7 +8332,9 @@ async function performWorkflowInstall(
     cancelled: false,
     cwd,
     scope,
-    warnings: requestedInstallScope.warning ? [requestedInstallScope.warning] : [],
+    warnings: requestedInstallScope.warning
+      ? [requestedInstallScope.warning]
+      : [],
     ruleScope,
     dryRun,
     platform,

package/src/cli/init/execute.ts

@@ -23,12 +23,20 @@ export function buildInitExecutionPlan({
   const planItems: InitExecutionPlanItem[] = [];
   const wantsPostman = hasMcpSelection(selections.selectedMcps, "postman");
   const wantsStitch = hasMcpSelection(selections.selectedMcps, "stitch");
-  const wantsFoundry = hasMcpSelection(selections.selectedMcps, "cubis-foundry");
+  const wantsFoundry = hasMcpSelection(
+    selections.selectedMcps,
+    "cubis-foundry",
+  );
+  const wantsPlaywright = hasMcpSelection(
+    selections.selectedMcps,
+    "playwright",
+  );
 
   for (const platform of selections.platforms) {
     const stitchSupported = platform === "antigravity";
     const stitchEnabled = wantsStitch && stitchSupported;
-    const hasAnyMcp = wantsPostman || stitchEnabled || wantsFoundry;
+    const hasAnyMcp =
+      wantsPostman || stitchEnabled || wantsFoundry || wantsPlaywright;
     const warnings: string[] = [];
     if (wantsStitch && !stitchSupported) {
       warnings.push(
@@ -48,10 +56,11 @@ export function buildInitExecutionPlan({
       target,
       postman: wantsPostman,
       stitch: stitchEnabled,
+      playwright: wantsPlaywright,
       stitchDefaultForAntigravity: false,
       mcpScope: selections.mcpScope,
       foundryMcp: wantsFoundry,
-      mcpToolSync: wantsPostman || stitchEnabled,
+      mcpToolSync: wantsPostman || stitchEnabled || wantsPlaywright,
       mcpRuntime: hasAnyMcp ? selections.mcpRuntime : "local",
       mcpFallback: "local",
       mcpBuildLocal: hasAnyMcp ? selections.mcpBuildLocal : false,
@@ -83,9 +92,9 @@ export function formatInitSummary(selections: InitWizardSelections) {
     `- Skill profile: ${selections.skillProfile}`,
     `- Skills scope: ${selections.skillsScope}`,
     `- MCP scope: ${selections.mcpScope}`,
-    `- MCP runtime: ${selections.mcpRuntime}${selections.mcpRuntime === "docker" ? selections.mcpBuildLocal ? " (build local image)" : " (pull image)" : ""}`,
+    `- MCP runtime: ${selections.mcpRuntime}${selections.mcpRuntime === "docker" ? (selections.mcpBuildLocal ? " (build local image)" : " (pull image)") : ""}`,
     `- MCP selections: ${selections.selectedMcps.length > 0 ? selections.selectedMcps.join(", ") : "(none)"}`,
     `- Postman mode: ${postmanSelected ? selections.postmanMode : "(not selected)"}`,
-    `- Postman workspace: ${postmanSelected ? selections.postmanWorkspaceId === null ? "null" : selections.postmanWorkspaceId : "(not selected)"}`,
+    `- Postman workspace: ${postmanSelected ? (selections.postmanWorkspaceId === null ? "null" : selections.postmanWorkspaceId) : "(not selected)"}`,
   ].join("\n");
 }

package/src/cli/init/prompts.ts

@@ -90,6 +90,11 @@ export async function promptInitMcpSelection(defaultMcps: InitMcpId[]) {
         value: "stitch",
         checked: defaultMcps.includes("stitch"),
       },
+      {
+        name: "Playwright",
+        value: "playwright",
+        checked: defaultMcps.includes("playwright"),
+      },
     ],
   });
 }

package/src/cli/init/types.ts

@@ -1,6 +1,6 @@
 export type InitScope = "project" | "global";
 export type InitSkillProfile = "core" | "web-backend" | "full";
-export type InitMcpId = "cubis-foundry" | "postman" | "stitch";
+export type InitMcpId = "cubis-foundry" | "postman" | "stitch" | "playwright";
 export type InitPostmanMode = "full" | "minimal";
 export type InitPlatformId = "codex" | "antigravity" | "copilot" | "claude";
 export type InitMcpRuntime = "local" | "docker";