@cubis/foundry 0.3.54 → 0.3.55

package/CHANGELOG.md

@@ -2,6 +2,21 @@
 
 All notable changes to this project are documented in this file.
 
+## [0.3.55] - 2026-03-05
+
+### Added
+
+- Added Postman workspace selection step to `cbx init` wizard:
+  - interactive workspace list from Postman API when key is available
+  - manual workspace ID fallback prompt when listing is unavailable.
+- Added non-interactive workspace flag for wizard:
+  - `cbx init --postman-workspace-id <id|null>`
+
+### Changed
+
+- Updated wizard execution mapping so selected Postman workspace is persisted through install flow.
+- Updated init wizard docs and TTY smoke test to validate the new workspace selection step.
+
 ## [0.3.54] - 2026-03-05
 
 ### Added

package/README.md

@@ -72,7 +72,7 @@ Wizard flow:
 - 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
-- Conditional Postman mode/key and Stitch key prompts
+- Conditional Postman mode/key/workspace and Stitch key prompts
 - Final summary + confirmation
 
 Non-interactive default mode:
@@ -95,6 +95,7 @@ cbx init \
   --mcps cubis-foundry,postman,stitch \
   --mcp-scope global \
   --postman-mode minimal \
+  --postman-workspace-id null \
   --mcp-runtime local
 ```
 

package/dist/cli/commands/register.js

@@ -21,6 +21,7 @@ export function registerCommands(deps) {
         .option("--mcp-scope <scope>", "scope for MCP config: global|project")
         .option("--mcps <items>", "comma-separated MCP selections: cubis-foundry,postman,stitch")
         .option("--postman-mode <mode>", "Postman mode: full|minimal")
+        .option("--postman-workspace-id <id|null>", "optional: set default Postman workspace ID (use 'null' for no default)")
         .option("--mcp-runtime <runtime>", "MCP runtime: docker|local")
         .option("--mcp-build-local", "when MCP runtime is docker, build image locally instead of pulling")
         .option("--no-banner", "skip init welcome banner")

package/dist/cli/commands/register.js.map

@@ -1 +1 @@
-{"version":3,"file":"register.js","sourceRoot":"","sources":["../../../src/cli/commands/register.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"register.js","sourceRoot":"","sources":["../../../src/cli/commands/register.ts"],"names":[],"mappings":"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"}

package/dist/cli/core.js

@@ -3808,6 +3808,69 @@ async function fetchPostmanWorkspaces({ apiKey, apiBaseUrl = POSTMAN_API_BASE_UR
         clearTimeout(timeout);
     }
 }
+async function promptPostmanWorkspaceSelection({ apiKey, defaultWorkspaceId = null, }) {
+    let selectedWorkspaceId = normalizePostmanWorkspaceId(defaultWorkspaceId);
+    let usedWorkspaceSelector = false;
+    const warnings = [];
+    const selectableApiKey = normalizePostmanApiKey(apiKey);
+    if (selectableApiKey) {
+        try {
+            const fetchedWorkspaces = await fetchPostmanWorkspaces({
+                apiKey: selectableApiKey,
+            });
+            if (fetchedWorkspaces.length > 0) {
+                usedWorkspaceSelector = true;
+                const sortedWorkspaces = [...fetchedWorkspaces].sort((a, b) => a.name.localeCompare(b.name));
+                const workspaceChoice = await select({
+                    message: "Choose default Postman workspace for this install:",
+                    choices: [
+                        { name: "No default workspace (null)", value: null },
+                        ...sortedWorkspaces.map((workspace) => {
+                            const details = [workspace.type, workspace.visibility]
+                                .filter(Boolean)
+                                .join(", ");
+                            const suffix = details ? ` - ${details}` : "";
+                            return {
+                                name: `${workspace.name} (${workspace.id})${suffix}`,
+                                value: workspace.id,
+                            };
+                        }),
+                        {
+                            name: "Enter workspace ID manually",
+                            value: POSTMAN_WORKSPACE_MANUAL_CHOICE,
+                        },
+                    ],
+                    default: selectedWorkspaceId,
+                });
+                if (workspaceChoice === POSTMAN_WORKSPACE_MANUAL_CHOICE) {
+                    const promptedWorkspaceId = await input({
+                        message: "Default Postman workspace ID (optional, leave blank for null):",
+                        default: selectedWorkspaceId || "",
+                    });
+                    selectedWorkspaceId =
+                        normalizePostmanWorkspaceId(promptedWorkspaceId);
+                }
+                else {
+                    selectedWorkspaceId = normalizePostmanWorkspaceId(workspaceChoice);
+                }
+            }
+        }
+        catch (error) {
+            warnings.push(`Could not load Postman workspaces for selection: ${error.message}`);
+        }
+    }
+    if (!usedWorkspaceSelector) {
+        const promptedWorkspaceId = await input({
+            message: "Default Postman workspace ID (optional, leave blank for null):",
+            default: selectedWorkspaceId || "",
+        });
+        selectedWorkspaceId = normalizePostmanWorkspaceId(promptedWorkspaceId);
+    }
+    return {
+        workspaceId: selectedWorkspaceId,
+        warnings,
+    };
+}
 function parseJsonLenient(raw) {
     try {
         return {
@@ -4203,63 +4266,12 @@ async function resolvePostmanInstallSelection({ platform, scope, options, cwd =
     const foundryMcpEnabled = options.foundryMcp !== false;
     const canPrompt = !options.yes && process.stdin.isTTY;
     if (postmanRequested && canPrompt && !hasWorkspaceOption) {
-        const selectableApiKey = normalizePostmanApiKey(envApiKey);
-        let usedWorkspaceSelector = false;
-        let selectedWorkspaceId = defaultWorkspaceId;
-        if (selectableApiKey) {
-            try {
-                const fetchedWorkspaces = await fetchPostmanWorkspaces({
-                    apiKey: selectableApiKey,
-                });
-                if (fetchedWorkspaces.length > 0) {
-                    usedWorkspaceSelector = true;
-                    const sortedWorkspaces = [...fetchedWorkspaces].sort((a, b) => a.name.localeCompare(b.name));
-                    const workspaceChoice = await select({
-                        message: "Choose default Postman workspace for this install:",
-                        choices: [
-                            { name: "No default workspace (null)", value: null },
-                            ...sortedWorkspaces.map((workspace) => {
-                                const details = [workspace.type, workspace.visibility]
-                                    .filter(Boolean)
-                                    .join(", ");
-                                const suffix = details ? ` - ${details}` : "";
-                                return {
-                                    name: `${workspace.name} (${workspace.id})${suffix}`,
-                                    value: workspace.id,
-                                };
-                            }),
-                            {
-                                name: "Enter workspace ID manually",
-                                value: POSTMAN_WORKSPACE_MANUAL_CHOICE,
-                            },
-                        ],
-                        default: null,
-                    });
-                    if (workspaceChoice === POSTMAN_WORKSPACE_MANUAL_CHOICE) {
-                        const promptedWorkspaceId = await input({
-                            message: "Default Postman workspace ID (optional, leave blank for null):",
-                            default: "",
-                        });
-                        selectedWorkspaceId =
-                            normalizePostmanWorkspaceId(promptedWorkspaceId);
-                    }
-                    else {
-                        selectedWorkspaceId = normalizePostmanWorkspaceId(workspaceChoice);
-                    }
-                }
-            }
-            catch (error) {
-                warnings.push(`Could not load Postman workspaces for selection: ${error.message}`);
-            }
-        }
-        if (!usedWorkspaceSelector) {
-            const promptedWorkspaceId = await input({
-                message: "Default Postman workspace ID (optional, leave blank for null):",
-                default: "",
-            });
-            selectedWorkspaceId = normalizePostmanWorkspaceId(promptedWorkspaceId);
-        }
-        defaultWorkspaceId = selectedWorkspaceId;
+        const workspaceSelection = await promptPostmanWorkspaceSelection({
+            apiKey: envApiKey,
+            defaultWorkspaceId,
+        });
+        defaultWorkspaceId = workspaceSelection.workspaceId;
+        warnings.push(...workspaceSelection.warnings);
         workspaceSelectionSource = "interactive";
     }
     if (canPrompt && !requestedMcpScope) {
@@ -8886,6 +8898,9 @@ async function runInitWizard(options) {
         const defaultMcpScope = normalizeMcpScope(options.mcpScope, defaultSkillsScope) === "global"
             ? "global"
             : "project";
+        const defaultPostmanWorkspaceId = options.postmanWorkspaceId !== undefined
+            ? normalizePostmanWorkspaceId(options.postmanWorkspaceId)
+            : null;
         const defaultMcpSelections = normalizeInitMcpSelections(options.mcps);
         const defaultPlatforms = normalizeInitPlatforms(options.platforms);
         const defaultMcpRuntime = normalizeMcpRuntime(options.mcpRuntime, defaultMcpSelections.some((item) => item === "postman" || item === "stitch")
@@ -8928,9 +8943,11 @@ async function runInitWizard(options) {
             postmanMode: options.postmanMode && normalizePostmanMode(options.postmanMode)
                 ? normalizePostmanMode(options.postmanMode)
                 : "full",
+            postmanWorkspaceId: defaultPostmanWorkspaceId,
             postmanApiKey: null,
             stitchApiKey: null,
         };
+        const initWarnings = [];
         if (selections.platforms.length === 0) {
             throw new Error("No platforms selected.");
         }
@@ -8951,6 +8968,15 @@ async function runInitWizard(options) {
         if (selections.selectedMcps.includes("postman") && isInteractive) {
             selections.postmanMode = await promptInitPostmanMode(selections.postmanMode);
             selections.postmanApiKey = await promptOptionalSecret("Postman API key (optional, leave blank to keep existing env/profile state):");
+            const postmanLookupApiKey = normalizePostmanApiKey(selections.postmanApiKey) ||
+                normalizePostmanApiKey(process.env[profileEnvVarAlias("postman", DEFAULT_CREDENTIAL_PROFILE_NAME)]) ||
+                normalizePostmanApiKey(process.env[POSTMAN_API_KEY_ENV_VAR]);
+            const postmanWorkspaceSelection = await promptPostmanWorkspaceSelection({
+                apiKey: postmanLookupApiKey,
+                defaultWorkspaceId: selections.postmanWorkspaceId,
+            });
+            selections.postmanWorkspaceId = postmanWorkspaceSelection.workspaceId;
+            initWarnings.push(...postmanWorkspaceSelection.warnings);
         }
         if (selections.selectedMcps.includes("stitch") && isInteractive) {
             selections.stitchApiKey = await promptOptionalSecret("Stitch API key (optional, leave blank to keep existing env/profile state):");
@@ -8969,6 +8995,12 @@ async function runInitWizard(options) {
             target: options.target,
         });
         const initSummary = formatInitSummary(selections);
+        if (initWarnings.length > 0) {
+            console.log("\nInit warnings:");
+            for (const warning of initWarnings) {
+                console.log(`- ${warning}`);
+            }
+        }
         if (!options.yes && isInteractive) {
             const proceed = await promptInitApplyConfirmation(initSummary);
             if (!proceed) {