@cubis/foundry 0.3.22 → 0.3.24

package/CHANGELOG.md

@@ -0,0 +1,28 @@
+# Changelog
+
+All notable changes to this project are documented in this file.
+
+## [0.3.23] - 2026-02-26
+
+### Added
+
+- Added a root `CHANGELOG.md` and npm-visible changelog section in `README.md`.
+- Included `CHANGELOG.md` in published npm package files.
+
+## [0.3.22] - 2026-02-26
+
+### Added
+
+- Added Antigravity-only default `StitchMCP` runtime setup in Gemini settings.
+- Added `--stitch-api-key` and `STITCH_API_KEY` support for Stitch MCP config.
+- Added managed Stitch MCP definition output in `.cbx/mcp/antigravity/stitch.json`.
+- Added Stitch and Postman API key setup links and guidance in `README.md`.
+
+## [0.3.21] - 2026-02-26
+
+### Changed
+
+- Split Postman MCP management from skill folder into managed `.cbx/mcp/<platform>/postman.json`.
+- 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

@@ -9,6 +9,11 @@ Primary support in this release:
 - Codex
 - Copilot (VS Code Chat + Copilot CLI)
 
+## Changelog
+
+- Latest release notes are visible here on npm and tracked in [`CHANGELOG.md`](./CHANGELOG.md).
+- GitHub view: [CHANGELOG.md](https://github.com/CUBETIQ/cubis-foundry/blob/main/CHANGELOG.md)
+
 ## Install
 
 ```bash
@@ -54,6 +59,7 @@ cbx workflows install --platform antigravity --dry-run
 cbx workflows install --platform antigravity --terminal-integration --terminal-verifier codex
 cbx workflows install --platform codex --postman
 cbx workflows install --platform codex --postman --postman-workspace-id null
+cbx workflows install --platform codex --postman --postman-workspace-id "<workspace-id>"
 cbx workflows install --platform codex --postman --postman-api-key "<key>"
 cbx workflows install --platform codex --postman --mcp-scope global
 cbx workflows install --platform copilot --postman --mcp-scope project
@@ -78,6 +84,7 @@ Postman + Antigravity Stitch setup behavior:
 - Env-first auth is supported: when `POSTMAN_API_KEY` is set, generated settings keep `apiKey: null` and MCP config uses `Bearer ${POSTMAN_API_KEY}`.
 - Inline auth is supported with `--postman-api-key <key>`.
 - `--postman-workspace-id null` writes JSON `null` for `defaultWorkspaceId`.
+- If `POSTMAN_API_KEY` is available and install is interactive (no `--yes`) without `--postman-workspace-id`, `cbx` fetches your Postman workspaces and prompts you to pick one as default.
 - Antigravity gets an additional managed file at `.cbx/mcp/antigravity/stitch.json` (or `~/.cbx/mcp/antigravity/stitch.json` in global MCP scope).
 - Stitch key source priority for Antigravity: `--stitch-api-key` then `STITCH_API_KEY`; when unset, generated config keeps placeholder `X-Goog-Api-Key: ur stitch key`.
 - In project MCP scope, `cbx_config.json` and `.cbx/mcp/` are auto-added to `.gitignore` (no duplicate entries).

package/bin/cubis.js

@@ -127,11 +127,13 @@ const TERMINAL_VERIFIER_PROVIDERS = ["codex", "gemini"];
 const DEFAULT_TERMINAL_VERIFIER = "codex";
 const POSTMAN_API_KEY_ENV_VAR = "POSTMAN_API_KEY";
 const POSTMAN_MCP_URL = "https://mcp.postman.com/minimal";
+const POSTMAN_API_BASE_URL = "https://api.getpostman.com";
 const POSTMAN_SKILL_ID = "postman";
 const STITCH_MCP_SERVER_ID = "StitchMCP";
 const STITCH_API_KEY_ENV_VAR = "STITCH_API_KEY";
 const STITCH_MCP_URL = "https://stitch.googleapis.com/mcp";
 const STITCH_API_KEY_PLACEHOLDER = "ur stitch key";
+const POSTMAN_WORKSPACE_MANUAL_CHOICE = "__postman_workspace_manual__";
 const CBX_CONFIG_FILENAME = "cbx_config.json";
 const POSTMAN_SETTINGS_FILENAME = "postman_setting.json";
 const POSTMAN_API_KEY_MISSING_WARNING =
@@ -2428,6 +2430,57 @@ function parseStoredPostmanConfig(raw) {
   };
 }
 
+async function fetchPostmanWorkspaces({
+  apiKey,
+  apiBaseUrl = POSTMAN_API_BASE_URL,
+  timeoutMs = 12000
+}) {
+  if (!apiKey) return [];
+
+  const controller = new AbortController();
+  const timeout = setTimeout(() => controller.abort(), timeoutMs);
+  const endpoint = `${apiBaseUrl.replace(/\/$/, "")}/workspaces`;
+
+  try {
+    const response = await fetch(endpoint, {
+      method: "GET",
+      headers: {
+        "X-Api-Key": apiKey,
+        Accept: "application/json"
+      },
+      signal: controller.signal
+    });
+
+    const payload = await response.json().catch(() => null);
+    if (!response.ok) {
+      const message =
+        payload?.error?.message ||
+        payload?.error?.name ||
+        `Postman API request failed (${response.status} ${response.statusText}).`;
+      throw new Error(message);
+    }
+
+    const workspaces = Array.isArray(payload?.workspaces) ? payload.workspaces : [];
+    return workspaces
+      .map((workspace) => {
+        const id = normalizePostmanWorkspaceId(workspace?.id);
+        if (!id) return null;
+        const name = String(workspace?.name || "").trim() || id;
+        const type = String(workspace?.type || "").trim() || null;
+        const visibility = String(workspace?.visibility || "").trim() || null;
+        return { id, name, type, visibility };
+      })
+      .filter(Boolean);
+  } catch (error) {
+    if (error?.name === "AbortError") {
+      throw new Error("Postman workspace lookup timed out.");
+    }
+    throw error;
+  } finally {
+    clearTimeout(timeout);
+  }
+}
+
 function parseStoredStitchConfig(raw) {
   if (!raw || typeof raw !== "object") return null;
   const source = raw.stitch && typeof raw.stitch === "object" ? raw.stitch : null;
@@ -2762,11 +2815,59 @@ async function resolvePostmanInstallSelection({
   }
 
   if (canPrompt && !hasWorkspaceOption) {
-    const promptedWorkspaceId = await input({
-      message: "Default Postman workspace ID (optional, leave blank for null):",
-      default: ""
-    });
-    defaultWorkspaceId = normalizePostmanWorkspaceId(promptedWorkspaceId);
+    const selectableApiKey = normalizePostmanApiKey(apiKey || 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;
   }
 
   if (canPrompt && stitchEnabled && !hasStitchApiKeyOption && !stitchApiKey && !envStitchApiKey) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cubis/foundry",
-  "version": "0.3.22",
+  "version": "0.3.24",
   "description": "Cubis Foundry CLI for workflow-first AI agent environments",
   "type": "module",
   "bin": {
@@ -11,7 +11,8 @@
   "files": [
     "bin",
     "Ai Agent Workflow",
-    "README.md"
+    "README.md",
+    "CHANGELOG.md"
   ],
   "scripts": {
     "start": "node bin/cubis.js",