@cubis/foundry 0.3.65 → 0.3.67

package/CHANGELOG.md

@@ -14,6 +14,16 @@ All notable changes to this project are documented in this file.
   - Postman CLI is the recommended secondary path after direct MCP execution fails
   - monitor quota, API rate limits, and runtime timeouts are documented as separate failure classes.
 
+## [0.3.67] - 2026-03-08
+
+### Fixed
+
+- `cbx init` now keeps MCP runtime selection available when `cubis-foundry` is the only MCP selected.
+- Foundry MCP install/config patching now respects the selected runtime:
+  - local runtime keeps the `cbx mcp serve` stdio registration
+  - docker runtime points supported clients at the local Docker MCP endpoint
+- `cbx workflows config --mcp-runtime ...` now reapplies managed MCP target wiring so runtime changes update the platform config.
+
 ## [0.3.62] - 2026-03-05
 
 ### Fixed
@@ -262,3 +272,5 @@ All notable changes to this project are documented in this file.
 - Added centralized Postman config via `cbx_config.json`.
 - Added MCP scope controls (`project/workspace/global/user`) with platform-aware runtime placement.
 - Kept rules/engineering artifacts in workspace scope while defaulting skills/powers install to global scope.
+
+

package/README.md

@@ -81,7 +81,7 @@ Wizard flow:
 - Skills profile selection (`core`, `web-backend`, `full`)
 - MCP selection (`Cubis Foundry`, `Postman`, `Stitch`)
 - Separate scope selection for Skills and MCP (`project` or `global`)
-- MCP runtime selection (`cbx mcp serve` local, Docker pull, Docker local build) when Postman/Stitch is enabled
+- MCP runtime selection (`cbx mcp serve` local, Docker pull, Docker local build) when any MCP integration is enabled
 - Conditional Postman mode/key/workspace and Stitch key prompts
 - Final summary + confirmation
 
@@ -354,6 +354,7 @@ Codex:
 - Project MCP runtime target: `<workspace>/.vscode/mcp.json`
 - Foundry side-by-side server id: `cubis-foundry` (command: `cbx mcp serve --transport stdio --scope <global|project>`)
   - Install now pins scope explicitly (`global` or `project`) in this command.
+  - When MCP runtime is set to `docker`, install points `cubis-foundry` at the local Docker endpoint (`http://127.0.0.1:3310/mcp`) instead of the stdio command.
 
 Antigravity:
 

package/dist/cli/core.js

@@ -3755,7 +3755,17 @@ function buildFoundryServeArgs({ scope = "auto" } = {}) {
         : "auto";
     return ["mcp", "serve", "--transport", "stdio", "--scope", normalizedScope];
 }
-function buildVsCodeFoundryServer({ scope = "auto" } = {}) {
+function buildFoundryDockerUrl({ port = DEFAULT_MCP_DOCKER_HOST_PORT } = {}) {
+    return `http://127.0.0.1:${normalizePortNumber(port, DEFAULT_MCP_DOCKER_HOST_PORT)}/mcp`;
+}
+function buildVsCodeFoundryServer({ scope = "auto", runtime = "local", dockerPort = DEFAULT_MCP_DOCKER_HOST_PORT, } = {}) {
+    if (runtime === "docker") {
+        return {
+            type: "http",
+            url: buildFoundryDockerUrl({ port: dockerPort }),
+            headers: {},
+        };
+    }
     return {
         type: "stdio",
         command: FOUNDRY_MCP_COMMAND,
@@ -3773,7 +3783,15 @@ function buildCopilotCliPostmanServer({ apiKeyEnvVar = POSTMAN_API_KEY_ENV_VAR,
         tools: ["*"],
     };
 }
-function buildCopilotCliFoundryServer({ scope = "auto" } = {}) {
+function buildCopilotCliFoundryServer({ scope = "auto", runtime = "local", dockerPort = DEFAULT_MCP_DOCKER_HOST_PORT, } = {}) {
+    if (runtime === "docker") {
+        return {
+            type: "http",
+            url: buildFoundryDockerUrl({ port: dockerPort }),
+            headers: {},
+            tools: ["*"],
+        };
+    }
     return {
         type: "stdio",
         command: FOUNDRY_MCP_COMMAND,
@@ -3790,7 +3808,13 @@ function buildGeminiPostmanServer({ apiKeyEnvVar = POSTMAN_API_KEY_ENV_VAR, apiK
         },
     };
 }
-function buildGeminiFoundryServer({ scope = "auto" } = {}) {
+function buildGeminiFoundryServer({ scope = "auto", runtime = "local", dockerPort = DEFAULT_MCP_DOCKER_HOST_PORT, } = {}) {
+    if (runtime === "docker") {
+        return {
+            httpUrl: buildFoundryDockerUrl({ port: dockerPort }),
+            headers: {},
+        };
+    }
     return {
         command: FOUNDRY_MCP_COMMAND,
         args: buildFoundryServeArgs({ scope }),
@@ -4215,12 +4239,27 @@ async function removeGeneratedArtifactIfExists({ targetPath, dryRun = false }) {
         path: targetPath,
     };
 }
-async function applyPostmanMcpForPlatform({ platform, mcpScope, apiKeyEnvVar, mcpUrl, includePostmanMcp = true, stitchApiKeyEnvVar, stitchMcpUrl, includeStitchMcp = false, includeFoundryMcp = true, dryRun = false, cwd = process.cwd(), }) {
+async function applyPostmanMcpForPlatform({ platform, mcpScope, apiKeyEnvVar, mcpUrl, includePostmanMcp = true, stitchApiKeyEnvVar, stitchMcpUrl, includeStitchMcp = false, includeFoundryMcp = true, foundryRuntime = "local", dryRun = false, cwd = process.cwd(), }) {
     const workspaceRoot = findWorkspaceRoot(cwd);
     const warnings = [];
     const foundryScope = mcpScope === "global" ? "global" : "project";
+    const normalizedFoundryRuntime = normalizeMcpRuntime(foundryRuntime, "local");
     const resolvedPostmanApiKey = normalizePostmanApiKey(process.env[apiKeyEnvVar || POSTMAN_API_KEY_ENV_VAR]);
     const resolvedStitchApiKey = normalizePostmanApiKey(process.env[stitchApiKeyEnvVar || STITCH_API_KEY_ENV_VAR]);
+    let foundryDockerPort = DEFAULT_MCP_DOCKER_HOST_PORT;
+    if (includeFoundryMcp && normalizedFoundryRuntime === "docker") {
+        const runningPort = await resolveDockerContainerHostPort({
+            name: DEFAULT_MCP_DOCKER_CONTAINER_NAME,
+            containerPort: MCP_DOCKER_CONTAINER_PORT,
+            cwd,
+        });
+        if (runningPort) {
+            foundryDockerPort = runningPort;
+        }
+        else {
+            warnings.push(`Foundry MCP is configured for Docker runtime at ${buildFoundryDockerUrl({ port: foundryDockerPort })}. Start it with 'cbx mcp runtime up --scope ${mcpScope}'.`);
+        }
+    }
     if (platform === "antigravity") {
         const settingsPath = mcpScope === "global"
             ? path.join(os.homedir(), ".gemini", "settings.json")
@@ -4244,6 +4283,8 @@ async function applyPostmanMcpForPlatform({ platform, mcpScope, apiKeyEnvVar, mc
                 if (includeFoundryMcp) {
                     mcpServers[FOUNDRY_MCP_SERVER_ID] = buildGeminiFoundryServer({
                         scope: foundryScope,
+                        runtime: normalizedFoundryRuntime,
+                        dockerPort: foundryDockerPort,
                     });
                 }
                 else {
@@ -4293,6 +4334,8 @@ async function applyPostmanMcpForPlatform({ platform, mcpScope, apiKeyEnvVar, mc
                     if (includeFoundryMcp) {
                         mcpServers[FOUNDRY_MCP_SERVER_ID] = buildCopilotCliFoundryServer({
                             scope: foundryScope,
+                            runtime: normalizedFoundryRuntime,
+                            dockerPort: foundryDockerPort,
                         });
                     }
                     else {
@@ -4316,6 +4359,8 @@ async function applyPostmanMcpForPlatform({ platform, mcpScope, apiKeyEnvVar, mc
                 if (includeFoundryMcp) {
                     servers[FOUNDRY_MCP_SERVER_ID] = buildVsCodeFoundryServer({
                         scope: foundryScope,
+                        runtime: normalizedFoundryRuntime,
+                        dockerPort: foundryDockerPort,
                     });
                 }
                 else {
@@ -4364,6 +4409,8 @@ async function applyPostmanMcpForPlatform({ platform, mcpScope, apiKeyEnvVar, mc
                     if (includeFoundryMcp) {
                         servers[FOUNDRY_MCP_SERVER_ID] = buildVsCodeFoundryServer({
                             scope: foundryScope,
+                            runtime: normalizedFoundryRuntime,
+                            dockerPort: foundryDockerPort,
                         });
                     }
                     else {
@@ -4444,14 +4491,25 @@ async function applyPostmanMcpForPlatform({ platform, mcpScope, apiKeyEnvVar, mc
         }
         if (includeFoundryMcp) {
             try {
-                await execFile("codex", [
-                    "mcp",
-                    "add",
-                    FOUNDRY_MCP_SERVER_ID,
-                    "--",
-                    FOUNDRY_MCP_COMMAND,
-                    ...buildFoundryServeArgs({ scope: foundryScope }),
-                ], { cwd });
+                if (normalizedFoundryRuntime === "docker") {
+                    await execFile("codex", [
+                        "mcp",
+                        "add",
+                        FOUNDRY_MCP_SERVER_ID,
+                        "--url",
+                        buildFoundryDockerUrl({ port: foundryDockerPort }),
+                    ], { cwd });
+                }
+                else {
+                    await execFile("codex", [
+                        "mcp",
+                        "add",
+                        FOUNDRY_MCP_SERVER_ID,
+                        "--",
+                        FOUNDRY_MCP_COMMAND,
+                        ...buildFoundryServeArgs({ scope: foundryScope }),
+                    ], { cwd });
+                }
             }
             catch (error) {
                 warnings.push(`Failed to register ${FOUNDRY_MCP_SERVER_ID} MCP via Codex CLI. Ensure 'cbx' and 'codex' are installed and rerun. (${error.message})`);
@@ -4880,6 +4938,7 @@ async function configurePostmanInstallArtifacts({ platform, scope, profilePaths,
             stitchMcpUrl: effectiveStitchMcpUrl,
             includeStitchMcp: shouldInstallStitch,
             includeFoundryMcp: postmanSelection.foundryMcpEnabled,
+            foundryRuntime: postmanSelection.effectiveMcpRuntime || "local",
             dryRun,
             cwd,
         });
@@ -4969,6 +5028,7 @@ async function applyPostmanConfigArtifacts({ platform, mcpScope, configValue, dr
     const stitchEnabled = Boolean(stitchState);
     const stitchApiKeyEnvVar = normalizePostmanApiKey(stitchState?.apiKeyEnvVar) || STITCH_API_KEY_ENV_VAR;
     const stitchMcpUrl = stitchState?.mcpUrl || STITCH_MCP_URL;
+    const foundryRuntime = normalizeMcpRuntime(configValue?.mcp?.effectiveRuntime || configValue?.mcp?.runtime, "local");
     const resolvedPostmanApiKey = normalizePostmanApiKey(process.env[postmanApiKeyEnvVar]);
     const resolvedStitchApiKey = normalizePostmanApiKey(process.env[stitchApiKeyEnvVar]);
     const mcpDefinitionPath = resolvePostmanMcpDefinitionPath({
@@ -5018,6 +5078,7 @@ async function applyPostmanConfigArtifacts({ platform, mcpScope, configValue, dr
             stitchMcpUrl,
             includeStitchMcp: stitchEnabled,
             includeFoundryMcp: true,
+            foundryRuntime,
             dryRun,
             cwd,
         });
@@ -5773,7 +5834,7 @@ function printPostmanSetupSummary({ postmanSetup }) {
     console.log(`- MCP build local: ${postmanSetup.mcpBuildLocal ? "yes" : "no"}`);
     console.log(`- MCP image prepare: ${postmanSetup.dockerImageAction}`);
     console.log(`- MCP tool sync: ${postmanSetup.mcpToolSync ? "enabled" : "disabled"}`);
-    console.log(`- Foundry MCP side-by-side: ${postmanSetup.foundryMcpEnabled ? "enabled" : "disabled"}`);
+    console.log(`- Foundry MCP side-by-side: ${postmanSetup.foundryMcpEnabled ? postmanSetup.effectiveMcpRuntime === "docker" ? "enabled (docker endpoint)" : "enabled (cbx mcp serve)" : "disabled"}`);
     if (postmanSetup.postmanEnabled) {
         console.log(`- Postman API key source: ${postmanSetup.apiKeySource}`);
     }
@@ -8162,7 +8223,7 @@ async function runWorkflowConfig(options) {
         const effectivePostmanState = ensureCredentialServiceState(next, "postman");
         const effectivePostmanMode = resolvePostmanModeFromUrl(effectivePostmanState.mcpUrl, DEFAULT_POSTMAN_CONFIG_MODE);
         let postmanArtifacts = null;
-        if (hasPostmanModeOption) {
+        if (hasPostmanModeOption || hasMcpRuntimeOption) {
             const mcpScope = resolveMcpScopeFromConfigDocument(next, scope);
             let platform = null;
             const explicitPlatform = normalizePlatform(opts.platform);
@@ -9411,9 +9472,8 @@ async function runInitWizard(options) {
         if (selections.platforms.length === 0) {
             throw new Error("No platforms selected.");
         }
-        const remoteMcpSelected = selections.selectedMcps.includes("postman") ||
-            selections.selectedMcps.includes("stitch");
-        if (remoteMcpSelected && isInteractive) {
+        const runtimeSelectableMcp = selections.selectedMcps.length > 0;
+        if (runtimeSelectableMcp && isInteractive) {
             const runtimeSelection = await promptInitMcpRuntime({
                 defaultRuntime: selections.mcpRuntime,
                 defaultBuildLocal: selections.mcpBuildLocal,
@@ -9421,7 +9481,7 @@ async function runInitWizard(options) {
             selections.mcpRuntime = runtimeSelection.mcpRuntime;
             selections.mcpBuildLocal = runtimeSelection.mcpBuildLocal;
         }
-        else if (!remoteMcpSelected) {
+        else if (!runtimeSelectableMcp) {
             selections.mcpRuntime = "local";
             selections.mcpBuildLocal = false;
         }