@postman-cse/onboarding-bootstrap 0.9.1 → 0.11.0

package/dist/index.cjs

@@ -22777,6 +22777,7 @@ var require_stringify = __commonJS({
         nullStr: "null",
         simpleKeys: false,
         singleQuote: null,
+        trailingComma: false,
         trueStr: "true",
         verifyAliasOrder: true
       }, doc.schema.toStringOptions, options);
@@ -23294,12 +23295,19 @@ ${indent}${line}` : "\n";
         if (comment)
           reqNewline = true;
         let str = stringify2.stringify(item, itemCtx, () => comment = null);
-        if (i < items.length - 1)
+        reqNewline || (reqNewline = lines.length > linesAtValue || str.includes("\n"));
+        if (i < items.length - 1) {
           str += ",";
+        } else if (ctx.options.trailingComma) {
+          if (ctx.options.lineWidth > 0) {
+            reqNewline || (reqNewline = lines.reduce((sum, line) => sum + line.length + 2, 2) + (str.length + 2) > ctx.options.lineWidth);
+          }
+          if (reqNewline) {
+            str += ",";
+          }
+        }
         if (comment)
           str += stringifyComment.lineComment(str, itemIndent, commentString(comment));
-        if (!reqNewline && (lines.length > linesAtValue || str.includes("\n")))
-          reqNewline = true;
         lines.push(str);
         linesAtValue = lines.length;
       }
@@ -26313,17 +26321,22 @@ var require_compose_node = __commonJS({
         case "block-map":
         case "block-seq":
         case "flow-collection":
-          node = composeCollection.composeCollection(CN, ctx, token, props, onError);
-          if (anchor)
-            node.anchor = anchor.source.substring(1);
+          try {
+            node = composeCollection.composeCollection(CN, ctx, token, props, onError);
+            if (anchor)
+              node.anchor = anchor.source.substring(1);
+          } catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            onError(token, "RESOURCE_EXHAUSTION", message);
+          }
           break;
         default: {
           const message = token.type === "error" ? token.message : `Unsupported token (type: ${token.type})`;
           onError(token, "UNEXPECTED_TOKEN", message);
-          node = composeEmptyNode(ctx, token.offset, void 0, null, props, onError);
           isSrcToken = false;
         }
       }
+      node ?? (node = composeEmptyNode(ctx, token.offset, void 0, null, props, onError));
       if (anchor && node.anchor === "")
         onError(anchor, "BAD_ALIAS", "Anchor cannot be an empty string");
       if (atKey && ctx.options.stringKeys && (!identity.isScalar(node) || typeof node.value !== "string" || node.tag && node.tag !== "tag:yaml.org,2002:str")) {
@@ -28671,7 +28684,6 @@ var index_exports = {};
 __export(index_exports, {
   createBootstrapDependencies: () => createBootstrapDependencies,
   createPlannedOutputs: () => createPlannedOutputs,
-  extractRepositorySlug: () => extractRepositorySlug,
   getInput: () => getInput,
   lintSpecViaCli: () => lintSpecViaCli,
   normalizeSpecDocument: () => normalizeSpecDocument,
@@ -28684,6 +28696,7 @@ module.exports = __toCommonJS(index_exports);
 var core = __toESM(require_core(), 1);
 var exec = __toESM(require_exec(), 1);
 var io = __toESM(require_io(), 1);
+var import_node_fs = require("node:fs");
 var import_yaml = __toESM(require_dist(), 1);
 
 // src/contracts.ts
@@ -28711,6 +28724,28 @@ var openAlphaActionContract = {
       description: "Existing contract collection ID.",
       required: false
     },
+    "sync-examples": {
+      description: "Whether linked spec/collection relations should enable example syncing.",
+      required: false,
+      default: "true",
+      allowedValues: ["true", "false"]
+    },
+    "collection-sync-mode": {
+      description: "Collection lifecycle policy: reuse existing collections, refresh them from the latest spec, or version them by release label.",
+      required: false,
+      default: "refresh",
+      allowedValues: ["reuse", "refresh", "version"]
+    },
+    "spec-sync-mode": {
+      description: "Spec lifecycle policy: update the canonical spec or create/reuse a versioned spec for the resolved release label.",
+      required: false,
+      default: "update",
+      allowedValues: ["update", "version"]
+    },
+    "release-label": {
+      description: "Optional release label. When omitted for versioned sync, the action derives one from GitHub ref metadata.",
+      required: false
+    },
     "project-name": {
       description: "Service project name.",
       required: true
@@ -28731,20 +28766,14 @@ var openAlphaActionContract = {
       description: "Comma-separated workspace admin user ids.",
       required: false
     },
+    "workspace-team-id": {
+      description: "Numeric sub-team ID for org-mode workspace creation.",
+      required: false
+    },
     "spec-url": {
       description: "HTTPS URL to the OpenAPI document.",
       required: true
     },
-    "environments-json": {
-      description: "JSON array of environment slugs to preserve in bootstrap outputs.",
-      required: false,
-      default: '["prod"]'
-    },
-    "system-env-map-json": {
-      description: "JSON map of environment slug to system environment id.",
-      required: false,
-      default: "{}"
-    },
     "governance-mapping-json": {
       description: "JSON map of business domain to governance group name.",
       required: false,
@@ -28758,19 +28787,6 @@ var openAlphaActionContract = {
       description: "Postman access token used for governance and workspace mutations.",
       required: false
     },
-    "github-token": {
-      description: "GitHub token for repository variable persistence.",
-      required: false
-    },
-    "gh-fallback-token": {
-      description: "Fallback token for repository variable APIs.",
-      required: false
-    },
-    "github-auth-mode": {
-      description: "GitHub auth mode for repository variable APIs.",
-      required: false,
-      default: "github_token_first"
-    },
     "integration-backend": {
       description: "Integration backend for downstream workspace connectivity.",
       required: false,
@@ -28816,8 +28832,8 @@ var openAlphaActionContract = {
     "OpenAPI operation summary normalization before upload (missing or oversized summaries)",
     "spec linting by UID",
     "baseline, smoke, and contract collection generation",
+    "collection refresh and versioning policies",
     "collection tagging",
-    "GitHub repository variable persistence for downstream sync steps",
     "workspace, spec, and collection outputs"
   ],
   removedBehavior: [
@@ -28908,189 +28924,6 @@ function sanitizeHeaders(headers, secretValues) {
   return sanitized;
 }
 
-// src/lib/github/github-api-client.ts
-function buildErrorMessage(method, path, response, body, masker) {
-  const status = `${response.status}${response.statusText ? ` ${response.statusText}` : ""}`;
-  const sanitizedBody = masker(body || "");
-  return sanitizedBody ? masker(`${method} ${path} failed with ${status} - ${sanitizedBody}`) : masker(`${method} ${path} failed with ${status} - [REDACTED]`);
-}
-var GitHubApiClient = class {
-  apiBase;
-  authMode;
-  appToken;
-  fallbackToken;
-  fetchImpl;
-  owner;
-  repo;
-  repository;
-  secretMasker;
-  token;
-  constructor(options) {
-    this.apiBase = String(options.apiBase || "https://api.github.com").replace(
-      /\/+$/,
-      ""
-    );
-    this.appToken = String(options.appToken || "").trim();
-    this.authMode = options.authMode || "github_token_first";
-    this.fallbackToken = String(options.fallbackToken || "").trim();
-    this.fetchImpl = options.fetch ?? fetch;
-    this.repository = options.repository;
-    const [owner, repo] = options.repository.split("/");
-    this.owner = owner;
-    this.repo = repo;
-    this.token = String(options.token || "").trim();
-    this.secretMasker = options.secretMasker ?? createSecretMasker([this.token, this.fallbackToken, this.appToken]);
-  }
-  getTokenOrder() {
-    const ordered = [];
-    if (this.authMode === "app_token") {
-      if (this.appToken) ordered.push(this.appToken);
-      if (this.token && this.token !== this.appToken) ordered.push(this.token);
-      if (this.fallbackToken && this.fallbackToken !== this.appToken && this.fallbackToken !== this.token) {
-        ordered.push(this.fallbackToken);
-      }
-      return ordered;
-    }
-    if (this.authMode === "fallback_pat_first") {
-      if (this.fallbackToken) ordered.push(this.fallbackToken);
-      if (this.token && this.token !== this.fallbackToken) ordered.push(this.token);
-      return ordered;
-    }
-    if (this.token) ordered.push(this.token);
-    if (this.fallbackToken && this.fallbackToken !== this.token) {
-      ordered.push(this.fallbackToken);
-    }
-    return ordered;
-  }
-  isVariablesEndpoint(path) {
-    return path.startsWith(`/repos/${this.owner}/${this.repo}/actions/variables`);
-  }
-  canUseFallback(path) {
-    return this.isVariablesEndpoint(path) || path.includes(`/repos/${this.owner}/${this.repo}/contents`) || path.includes("/dispatches");
-  }
-  rateLimitDelayMs(response, attempt) {
-    const retryAfter = Number(response.headers.get("retry-after") || "");
-    if (Number.isFinite(retryAfter) && retryAfter > 0) {
-      return Math.min(retryAfter * 1e3, 12e4);
-    }
-    const resetAtSeconds = Number(response.headers.get("x-ratelimit-reset") || "");
-    if (Number.isFinite(resetAtSeconds) && resetAtSeconds > 0) {
-      const delta = resetAtSeconds * 1e3 - Date.now();
-      if (delta > 0) {
-        return Math.min(delta + 250, 12e4);
-      }
-    }
-    const base = Math.min(5e3 * Math.pow(2, attempt), 12e4);
-    const jitter = Math.floor(Math.random() * 250);
-    return Math.min(base + jitter, 12e4);
-  }
-  async requestWithToken(path, init, token) {
-    const MAX_RETRIES = 5;
-    const normalizedToken = String(token || "").trim();
-    if (!normalizedToken) {
-      throw new Error(`Missing GitHub auth token for request ${path}`);
-    }
-    for (let attempt = 0; ; attempt++) {
-      const response = await this.fetchImpl(`${this.apiBase}${path}`, {
-        ...init,
-        headers: {
-          Accept: "application/vnd.github+json",
-          Authorization: `Bearer ${normalizedToken}`,
-          "Content-Type": "application/json",
-          ...init.headers || {}
-        }
-      });
-      if (attempt < MAX_RETRIES && (response.status === 403 || response.status === 429)) {
-        const body = await response.clone().text().catch(() => "");
-        if (isRateLimitedResponse(response, body)) {
-          const delay = this.rateLimitDelayMs(response, attempt);
-          console.log(
-            `GitHub API rate limited, retrying in ${Math.ceil(delay / 1e3)}s (attempt ${attempt + 1}/${MAX_RETRIES})...`
-          );
-          await new Promise((r) => setTimeout(r, delay));
-          continue;
-        }
-      }
-      return response;
-    }
-  }
-  async request(path, init = {}) {
-    const orderedTokens = this.getTokenOrder();
-    if (orderedTokens.length === 0) {
-      throw new Error("No GitHub auth token configured");
-    }
-    const first = await this.requestWithToken(path, init, orderedTokens[0]);
-    if (orderedTokens.length < 2 || !this.canUseFallback(path)) {
-      return first;
-    }
-    const isVariableGet404 = first.status === 404 && (!init.method || init.method === "GET") && this.isVariablesEndpoint(path);
-    if (first.status !== 403 && !isVariableGet404) {
-      return first;
-    }
-    return this.requestWithToken(path, init, orderedTokens[1]);
-  }
-  async setRepositoryVariable(name, value) {
-    if (!value) {
-      throw new Error(`Repo variable ${name} is empty`);
-    }
-    const path = `/repos/${this.repository}/actions/variables`;
-    const body = JSON.stringify({ name, value: String(value) });
-    const createResponse = await this.request(path, {
-      method: "POST",
-      body
-    });
-    if (createResponse.ok || createResponse.status === 201) {
-      return;
-    }
-    if (createResponse.status === 409 || createResponse.status === 422) {
-      const updatePath = `/repos/${this.repository}/actions/variables/${name}`;
-      const updateResponse = await this.request(updatePath, {
-        method: "PATCH",
-        body
-      });
-      if (updateResponse.ok) {
-        return;
-      }
-      const text2 = await updateResponse.text().catch(() => "");
-      throw new Error(
-        buildErrorMessage("PATCH", updatePath, updateResponse, text2, this.secretMasker)
-      );
-    }
-    const text = await createResponse.text().catch(() => "");
-    throw new Error(
-      buildErrorMessage("POST", path, createResponse, text, this.secretMasker)
-    );
-  }
-  async getRepositoryVariable(name) {
-    const path = `/repos/${this.repository}/actions/variables/${name}`;
-    const response = await this.request(path, {
-      method: "GET"
-    });
-    if (response.status === 404) {
-      return "";
-    }
-    if (!response.ok) {
-      const text = await response.text().catch(() => "");
-      throw new Error(
-        buildErrorMessage("GET", path, response, text, this.secretMasker)
-      );
-    }
-    const data = await response.json();
-    return String(data.value || "");
-  }
-};
-function isRateLimitedResponse(response, body) {
-  if (response.status !== 403 && response.status !== 429) return false;
-  const remaining = response.headers.get("x-ratelimit-remaining");
-  const retryAfter = response.headers.get("retry-after");
-  if (remaining === "0") return true;
-  if (retryAfter) return true;
-  const message = body.toLowerCase();
-  if (message.includes("secondary rate limit")) return true;
-  if (message.includes("api rate limit exceeded")) return true;
-  return response.status === 429;
-}
-
 // src/lib/http-error.ts
 function truncate(value, limit) {
   if (value.length <= limit) {
@@ -29273,6 +29106,16 @@ var PostmanAssetsClient = class {
     }
     return void 0;
   }
+  async getTeams() {
+    const data = await this.request("/teams");
+    const teams = data?.data ?? [];
+    return Array.isArray(teams) ? teams.filter((t) => t?.id && t?.name).map((t) => ({
+      id: Number(t.id),
+      name: String(t.name),
+      handle: String(t.handle || ""),
+      ...t.organizationId != null ? { organizationId: Number(t.organizationId) } : {}
+    })) : [];
+  }
   async request(path, init = {}) {
     const url = path.startsWith("http") ? path : `${this.baseUrl}${path}`;
     const response = await this.fetchImpl(url, {
@@ -29301,13 +29144,14 @@ var PostmanAssetsClient = class {
       return null;
     }
   }
-  async createWorkspace(name, about) {
+  async createWorkspace(name, about, targetTeamId) {
     return retry(async () => {
       const payload = {
         workspace: {
           about,
           name,
-          type: "team"
+          type: "team",
+          ...targetTeamId != null && !Number.isNaN(targetTeamId) ? { teamId: targetTeamId } : {}
         }
       };
       let created;
@@ -29319,7 +29163,7 @@ var PostmanAssetsClient = class {
       } catch (err) {
         if (err instanceof Error && err.message.includes("Only personal workspaces")) {
           throw new Error(
-            "Workspace creation failed: Your team may have Org Mode enabled. Org-level workspaces require a different API request schema which is currently unsupported in this alpha version."
+            "Workspace creation failed: This may be an Org-mode account that requires a workspace-team-id input. The Postman API does not allow creating team workspaces at the organization level. Use the workspace-team-id input to specify which sub-team should own this workspace."
           );
         }
         throw err;
@@ -29338,7 +29182,11 @@ var PostmanAssetsClient = class {
       return {
         id: workspaceId
       };
-    }, { maxAttempts: 3, delayMs: 2e3 });
+    }, {
+      maxAttempts: 3,
+      delayMs: 2e3,
+      shouldRetry: (err) => !(err instanceof Error && err.message.includes("workspace-team-id"))
+    });
   }
   async listWorkspaces() {
     const data = await this.request("/workspaces");
@@ -29813,6 +29661,26 @@ var BifrostInternalIntegrationAdapter = class {
       options.workerBaseUrl || "https://catalog-admin.postman-account2009.workers.dev"
     ).replace(/\/+$/, "");
   }
+  async proxyRequest(service, method, requestPath, body) {
+    const url = "https://bifrost-premium-https-v4.gw.postman.com/ws/proxy";
+    const headers = {
+      "Content-Type": "application/json",
+      "x-access-token": this.accessToken
+    };
+    if (this.teamId) {
+      headers["x-entity-team-id"] = this.teamId;
+    }
+    return this.fetchImpl(url, {
+      method: "POST",
+      headers,
+      body: JSON.stringify({
+        service,
+        method,
+        path: requestPath,
+        ...body !== void 0 ? { body } : {}
+      })
+    });
+  }
   async assignWorkspaceToGovernanceGroup(workspaceId, domain, mappingJson) {
     let mapping;
     try {
@@ -29906,14 +29774,6 @@ var BifrostInternalIntegrationAdapter = class {
     }
   }
   async connectWorkspaceToRepository(workspaceId, repoUrl) {
-    const url = "https://bifrost-premium-https-v4.gw.postman.com/ws/proxy";
-    const headers = {
-      "Content-Type": "application/json",
-      "x-access-token": this.accessToken
-    };
-    if (this.teamId) {
-      headers["x-entity-team-id"] = this.teamId;
-    }
     const payload = {
       service: "workspaces",
       method: "POST",
@@ -29924,11 +29784,12 @@ var BifrostInternalIntegrationAdapter = class {
         versionControl: true
       }
     };
-    const response = await this.fetchImpl(url, {
-      method: "POST",
-      headers,
-      body: JSON.stringify(payload)
-    });
+    const response = await this.proxyRequest(
+      payload.service,
+      payload.method,
+      payload.path,
+      payload.body
+    );
     if (response.ok) return;
     if (response.status === 400) {
       const body = await response.text();
@@ -29945,29 +29806,68 @@ var BifrostInternalIntegrationAdapter = class {
     }
     throw await HttpError.fromResponse(response, {
       method: "POST",
-      requestHeaders: headers,
+      requestHeaders: {
+        "Content-Type": "application/json",
+        "x-access-token": this.accessToken,
+        ...this.teamId ? { "x-entity-team-id": this.teamId } : {}
+      },
       secretValues: [this.accessToken],
-      url
+      url: "https://bifrost-premium-https-v4.gw.postman.com/ws/proxy"
     });
   }
-  async getWorkspaceGitRepoUrl(workspaceId) {
-    const url = "https://bifrost-premium-https-v4.gw.postman.com/ws/proxy";
-    const headers = {
-      "Content-Type": "application/json",
-      "x-access-token": this.accessToken
-    };
-    if (this.teamId) {
-      headers["x-entity-team-id"] = this.teamId;
+  async linkCollectionsToSpecification(specificationId, collections) {
+    if (collections.length === 0) {
+      return;
     }
-    const response = await this.fetchImpl(url, {
+    const response = await this.proxyRequest(
+      "specification",
+      "put",
+      `/specifications/${specificationId}/collections`,
+      collections.map((collection) => ({
+        collectionId: collection.collectionId,
+        ...collection.syncOptions ? { syncOptions: collection.syncOptions } : {}
+      }))
+    );
+    if (response.ok) {
+      return;
+    }
+    throw await HttpError.fromResponse(response, {
       method: "POST",
-      headers,
-      body: JSON.stringify({
-        service: "workspaces",
-        method: "GET",
-        path: `/workspaces/${workspaceId}/filesystem`
-      })
+      requestHeaders: {
+        "Content-Type": "application/json",
+        "x-access-token": this.accessToken,
+        ...this.teamId ? { "x-entity-team-id": this.teamId } : {}
+      },
+      secretValues: [this.accessToken],
+      url: "https://bifrost-premium-https-v4.gw.postman.com/ws/proxy"
     });
+  }
+  async syncCollection(specificationId, collectionId) {
+    const response = await this.proxyRequest(
+      "specification",
+      "post",
+      `/specifications/${specificationId}/collections/${collectionId}/sync`
+    );
+    if (response.ok) {
+      return;
+    }
+    throw await HttpError.fromResponse(response, {
+      method: "POST",
+      requestHeaders: {
+        "Content-Type": "application/json",
+        "x-access-token": this.accessToken,
+        ...this.teamId ? { "x-entity-team-id": this.teamId } : {}
+      },
+      secretValues: [this.accessToken],
+      url: "https://bifrost-premium-https-v4.gw.postman.com/ws/proxy"
+    });
+  }
+  async getWorkspaceGitRepoUrl(workspaceId) {
+    const response = await this.proxyRequest(
+      "workspaces",
+      "GET",
+      `/workspaces/${workspaceId}/filesystem`
+    );
     if (response.status === 404) return null;
     if (!response.ok) return null;
     const body = await response.text();
@@ -30150,31 +30050,24 @@ function requireInput(actionCore, name) {
 function optionalInput(actionCore, name) {
   return normalizeInputValue(actionCore.getInput(name));
 }
-function parseJsonValue(raw, fallback, inputName) {
-  try {
-    return JSON.parse(raw || JSON.stringify(fallback)) ?? fallback;
-  } catch (error) {
-    throw new Error(
-      `Invalid JSON for ${inputName}: ${error instanceof Error ? error.message : String(error)}`
-    );
-  }
+function parseBooleanInput(value, defaultValue) {
+  const normalized = String(value || "").trim().toLowerCase();
+  if (!normalized) return defaultValue;
+  if (["true", "1", "yes", "on"].includes(normalized)) return true;
+  if (["false", "0", "no", "off"].includes(normalized)) return false;
+  return defaultValue;
 }
-function asStringArray(value, inputName) {
-  if (!Array.isArray(value)) {
-    throw new Error(`${inputName} must be a JSON array`);
+function parseCollectionSyncMode(value) {
+  if (value === "reuse" || value === "version") {
+    return value;
   }
-  return value.map((entry) => String(entry));
+  return "refresh";
 }
-function asStringMap(value, inputName) {
-  if (!value || typeof value !== "object" || Array.isArray(value)) {
-    throw new Error(`${inputName} must be a JSON object`);
-  }
-  return Object.fromEntries(
-    Object.entries(value).map(([key, entry]) => [
-      key,
-      String(entry)
-    ])
-  );
+function parseSpecSyncMode(value) {
+  if (value === "version") {
+    return value;
+  }
+  return "update";
 }
 function resolveInputs(env = process.env) {
   const repoContext = detectRepoContext(
@@ -30202,28 +30095,32 @@ function resolveInputs(env = process.env) {
     }
   }
   return {
-    projectName: getInput("project-name", env) ?? "",
+    projectName: getInput("project-name", env) ?? env.GITHUB_REPOSITORY?.split("/").pop() ?? env.CI_PROJECT_NAME ?? "",
     workspaceId: getInput("workspace-id", env),
     specId: getInput("spec-id", env),
     baselineCollectionId: getInput("baseline-collection-id", env),
     smokeCollectionId: getInput("smoke-collection-id", env),
     contractCollectionId: getInput("contract-collection-id", env),
+    syncExamples: parseBooleanInput(getInput("sync-examples", env), true),
+    collectionSyncMode: parseCollectionSyncMode(getInput("collection-sync-mode", env)),
+    specSyncMode: parseSpecSyncMode(getInput("spec-sync-mode", env)),
+    releaseLabel: getInput("release-label", env),
     domain: getInput("domain", env),
     domainCode: getInput("domain-code", env),
     requesterEmail: getInput("requester-email", env),
     workspaceAdminUserIds: getInput("workspace-admin-user-ids", env) || env.WORKSPACE_ADMIN_USER_IDS || "",
+    workspaceTeamId: getInput("workspace-team-id", env) || env.POSTMAN_WORKSPACE_TEAM_ID,
     teamId: getInput("team-id", env) || env.POSTMAN_TEAM_ID || "",
     repoUrl: repoContext.repoUrl || "",
     specUrl,
-    environmentsJson: getInput("environments-json", env) ?? openAlphaActionContract.inputs["environments-json"].default ?? '["prod"]',
-    systemEnvMapJson: getInput("system-env-map-json", env) ?? openAlphaActionContract.inputs["system-env-map-json"].default ?? "{}",
     governanceMappingJson: getInput("governance-mapping-json", env) ?? openAlphaActionContract.inputs["governance-mapping-json"].default ?? "{}",
     postmanApiKey: getInput("postman-api-key", env) ?? "",
     postmanAccessToken: getInput("postman-access-token", env),
-    githubToken: getInput("github-token", env),
-    ghFallbackToken: getInput("gh-fallback-token", env),
-    githubAuthMode: getInput("github-auth-mode", env) ?? openAlphaActionContract.inputs["github-auth-mode"].default ?? "github_token_first",
-    integrationBackend
+    integrationBackend,
+    githubRefName: env.GITHUB_REF_NAME,
+    githubHeadRef: env.GITHUB_HEAD_REF,
+    githubRef: env.GITHUB_REF,
+    githubSha: env.GITHUB_SHA
   };
 }
 function createPlannedOutputs(inputs) {
@@ -30254,12 +30151,8 @@ function readActionInputs(actionCore) {
   const specUrl = requireInput(actionCore, "spec-url");
   const postmanApiKey = requireInput(actionCore, "postman-api-key");
   const postmanAccessToken = optionalInput(actionCore, "postman-access-token");
-  const githubToken = optionalInput(actionCore, "github-token");
-  const ghFallbackToken = optionalInput(actionCore, "gh-fallback-token");
   actionCore.setSecret(postmanApiKey);
   if (postmanAccessToken) actionCore.setSecret(postmanAccessToken);
-  if (githubToken) actionCore.setSecret(githubToken);
-  if (ghFallbackToken) actionCore.setSecret(ghFallbackToken);
   const inputs = resolveInputs({
     ...process.env,
     INPUT_PROJECT_NAME: projectName,
@@ -30268,6 +30161,10 @@ function readActionInputs(actionCore) {
     INPUT_BASELINE_COLLECTION_ID: optionalInput(actionCore, "baseline-collection-id"),
     INPUT_SMOKE_COLLECTION_ID: optionalInput(actionCore, "smoke-collection-id"),
     INPUT_CONTRACT_COLLECTION_ID: optionalInput(actionCore, "contract-collection-id"),
+    INPUT_SYNC_EXAMPLES: optionalInput(actionCore, "sync-examples") ?? openAlphaActionContract.inputs["sync-examples"].default,
+    INPUT_COLLECTION_SYNC_MODE: optionalInput(actionCore, "collection-sync-mode") ?? openAlphaActionContract.inputs["collection-sync-mode"].default,
+    INPUT_SPEC_SYNC_MODE: optionalInput(actionCore, "spec-sync-mode") ?? openAlphaActionContract.inputs["spec-sync-mode"].default,
+    INPUT_RELEASE_LABEL: optionalInput(actionCore, "release-label"),
     INPUT_DOMAIN: optionalInput(actionCore, "domain"),
     INPUT_DOMAIN_CODE: optionalInput(actionCore, "domain-code"),
     INPUT_REQUESTER_EMAIL: optionalInput(actionCore, "requester-email"),
@@ -30275,17 +30172,13 @@ function readActionInputs(actionCore) {
       actionCore,
       "workspace-admin-user-ids"
     ),
+    INPUT_WORKSPACE_TEAM_ID: optionalInput(actionCore, "workspace-team-id") || process.env.POSTMAN_WORKSPACE_TEAM_ID,
     INPUT_TEAM_ID: optionalInput(actionCore, "postman-team-id") || process.env.POSTMAN_TEAM_ID,
     INPUT_REPO_URL: optionalInput(actionCore, "repo-url"),
     INPUT_SPEC_URL: specUrl,
-    INPUT_ENVIRONMENTS_JSON: optionalInput(actionCore, "environments-json") ?? openAlphaActionContract.inputs["environments-json"].default,
-    INPUT_SYSTEM_ENV_MAP_JSON: optionalInput(actionCore, "system-env-map-json") ?? openAlphaActionContract.inputs["system-env-map-json"].default,
     INPUT_GOVERNANCE_MAPPING_JSON: optionalInput(actionCore, "governance-mapping-json") ?? openAlphaActionContract.inputs["governance-mapping-json"].default,
     INPUT_POSTMAN_API_KEY: postmanApiKey,
     INPUT_POSTMAN_ACCESS_TOKEN: postmanAccessToken,
-    INPUT_GITHUB_TOKEN: githubToken,
-    INPUT_GH_FALLBACK_TOKEN: ghFallbackToken,
-    INPUT_GITHUB_AUTH_MODE: optionalInput(actionCore, "github-auth-mode") ?? openAlphaActionContract.inputs["github-auth-mode"].default,
     INPUT_INTEGRATION_BACKEND: optionalInput(actionCore, "integration-backend") ?? openAlphaActionContract.inputs["integration-backend"].default
   });
   return inputs;
@@ -30362,6 +30255,45 @@ async function fetchSpecDocument(specUrl, specFetcher) {
     }
   );
 }
+function normalizeReleaseLabel(value) {
+  const trimmed = String(value || "").trim();
+  if (!trimmed) {
+    return void 0;
+  }
+  return trimmed.replace(/^refs\/heads\//, "").replace(/^refs\/tags\//, "").replace(/^refs\/pull\//, "pull-").replace(/[^a-zA-Z0-9._-]+/g, "-").replace(/^-+|-+$/g, "") || void 0;
+}
+function deriveReleaseLabel(inputs) {
+  if (inputs.releaseLabel) {
+    return normalizeReleaseLabel(inputs.releaseLabel);
+  }
+  return normalizeReleaseLabel(inputs.githubRefName) ?? normalizeReleaseLabel(inputs.githubHeadRef) ?? normalizeReleaseLabel(inputs.githubRef);
+}
+function createAssetProjectName(inputs, releaseLabel) {
+  if (!releaseLabel) {
+    return inputs.projectName;
+  }
+  return `${inputs.projectName} ${releaseLabel}`;
+}
+function readResourcesState() {
+  try {
+    return (0, import_yaml.parse)((0, import_node_fs.readFileSync)(".postman/resources.yaml", "utf8"));
+  } catch {
+    return null;
+  }
+}
+function getFirstCloudResourceId(map) {
+  if (!map) {
+    return void 0;
+  }
+  return Object.values(map)[0];
+}
+function findCloudResourceId(map, matcher) {
+  if (!map) {
+    return void 0;
+  }
+  const match = Object.entries(map).find(([filePath]) => matcher(filePath));
+  return match?.[1];
+}
 var SPEC_SUMMARY_MAX_LEN = 200;
 var SPEC_HTTP_METHODS = /* @__PURE__ */ new Set([
   "get",
@@ -30450,122 +30382,28 @@ function validateSpecStructure(content) {
     throw new Error('Spec is missing "openapi" or "swagger" version field');
   }
 }
-function varName(projectName, baseName) {
-  const slug = projectName.toUpperCase().replace(/[^A-Z0-9]/g, "_");
-  return `POSTMAN_${slug}_${baseName}`;
-}
-async function readVariable(github, projectName, baseName) {
-  if (!github) {
-    return void 0;
-  }
-  const namespaced = await github.getRepositoryVariable(varName(projectName, baseName)).catch(() => void 0);
-  if (namespaced) {
-    return namespaced;
-  }
-  const legacy = await github.getRepositoryVariable(`POSTMAN_${baseName}`).catch(() => void 0);
-  return legacy || void 0;
-}
-async function persistVariable(github, name, value, actionCore) {
-  if (!github || !value) {
-    return;
-  }
-  try {
-    await github.setRepositoryVariable(name, value);
-  } catch (err) {
-    actionCore.warning(
-      `Failed to persist ${name}: ${err instanceof Error ? err.message : String(err)}`
-    );
-  }
-}
-async function writeVariable(github, projectName, baseName, value, actionCore) {
-  if (!github || !value) {
-    return;
-  }
-  await persistVariable(github, varName(projectName, baseName), value, actionCore);
-  await persistVariable(github, `POSTMAN_${baseName}`, value, actionCore);
-}
-async function persistBootstrapRepositoryVariables(github, projectName, outputs, systemEnvMap, environments, lintSummary, actionCore) {
-  await persistVariable(
-    github,
-    "LINT_WARNINGS",
-    String(lintSummary.lintWarnings),
-    actionCore
-  );
-  await persistVariable(
-    github,
-    "LINT_ERRORS",
-    String(lintSummary.lintErrors),
-    actionCore
-  );
-  await writeVariable(
-    github,
-    projectName,
-    "WORKSPACE_ID",
-    outputs["workspace-id"],
-    actionCore
-  );
-  await writeVariable(github, projectName, "SPEC_UID", outputs["spec-id"], actionCore);
-  await writeVariable(
-    github,
-    projectName,
-    "BASELINE_COLLECTION_UID",
-    outputs["baseline-collection-id"],
-    actionCore
-  );
-  await writeVariable(
-    github,
-    projectName,
-    "SMOKE_COLLECTION_UID",
-    outputs["smoke-collection-id"],
-    actionCore
-  );
-  await writeVariable(
-    github,
-    projectName,
-    "CONTRACT_COLLECTION_UID",
-    outputs["contract-collection-id"],
-    actionCore
-  );
-  for (const envName of environments) {
-    const systemEnvId = systemEnvMap[envName];
-    if (!systemEnvId) {
-      continue;
-    }
-    await writeVariable(
-      github,
-      projectName,
-      `SYSTEM_ENV_${envName.toUpperCase()}`,
-      systemEnvId,
-      actionCore
-    );
-  }
-}
 async function runBootstrap(inputs, dependencies) {
   const outputs = createPlannedOutputs(inputs);
-  const environments = asStringArray(
-    parseJsonValue(inputs.environmentsJson, ["prod"], "environments-json"),
-    "environments-json"
-  );
-  const systemEnvMap = asStringMap(
-    parseJsonValue(inputs.systemEnvMapJson, {}, "system-env-map-json"),
-    "system-env-map-json"
-  );
+  const requiresReleaseLabel = inputs.collectionSyncMode === "version" || inputs.specSyncMode === "version";
+  const releaseLabel = requiresReleaseLabel ? deriveReleaseLabel(inputs) : void 0;
+  if (requiresReleaseLabel && !releaseLabel) {
+    throw new Error(
+      "Versioned spec or collection sync requires a release-label or derivable GitHub ref metadata"
+    );
+  }
   const workspaceName = createWorkspaceName(inputs);
   const aboutText = `Auto-provisioned by Postman CS open-alpha for ${inputs.projectName}`;
   await runGroup(dependencies.core, "Install Postman CLI", async () => {
     await ensurePostmanCli(dependencies, inputs.postmanApiKey);
   });
-  const explicitWorkspaceId = inputs.workspaceId;
-  let repoWorkspaceId;
-  let workspaceId = explicitWorkspaceId;
-  if (!workspaceId && dependencies.github) {
-    repoWorkspaceId = await readVariable(
-      dependencies.github,
-      inputs.projectName,
-      "WORKSPACE_ID"
-    );
-    workspaceId = repoWorkspaceId;
+  const resourcesState = readResourcesState();
+  let explicitWorkspaceId = inputs.workspaceId;
+  if (!explicitWorkspaceId && resourcesState?.workspace?.id) {
+    explicitWorkspaceId = resourcesState.workspace.id;
+    dependencies.core.info("Resolved workspace-id from .postman/resources.yaml");
   }
+  const repoWorkspaceId = explicitWorkspaceId;
+  let workspaceId = explicitWorkspaceId;
   let teamId = inputs.teamId || "";
   if (!teamId) {
     teamId = await dependencies.postman.getAutoDerivedTeamId() || "";
@@ -30599,24 +30437,65 @@ async function runBootstrap(inputs, dependencies) {
   } else if (workspaceId) {
     dependencies.core.info(`Using existing workspace: ${workspaceId}`);
   }
+  let workspaceTeamId;
+  if (inputs.workspaceTeamId) {
+    workspaceTeamId = parseInt(inputs.workspaceTeamId, 10);
+    if (Number.isNaN(workspaceTeamId)) {
+      throw new Error(`workspace-team-id must be a numeric sub-team ID, got: ${inputs.workspaceTeamId}`);
+    }
+  }
+  if (!workspaceId && !workspaceTeamId) {
+    try {
+      const teams = await dependencies.postman.getTeams();
+      if (teams.length > 1 && teams.every((t) => t.organizationId == null)) {
+        dependencies.core.warning(
+          "GET /teams returned multiple teams but none include organizationId. Org-mode detection may be degraded due to an upstream API change. If workspace creation fails, set workspace-team-id explicitly."
+        );
+      }
+      const orgIds = new Set(teams.filter((t) => t.organizationId != null).map((t) => t.organizationId));
+      const meTeamId = parseInt(teamId, 10);
+      const isOrgMode = teams.length > 1 && orgIds.size === 1 && orgIds.has(meTeamId);
+      if (isOrgMode) {
+        const teamList = teams.map((t) => `  ${t.id}  ${t.name}`).join("\n");
+        throw new Error(
+          `Org-mode account detected. Workspace creation requires a specific sub-team ID.
+
+Available sub-teams:
+${teamList}
+
+To fix this, set the workspace-team-id input in your workflow:
+  workspace-team-id: '<id>'
+
+Or for reuse across runs, create a repository variable and reference it:
+  workspace-team-id: \${{ vars.POSTMAN_WORKSPACE_TEAM_ID }}
+
+For CLI usage, pass --workspace-team-id <id> or export POSTMAN_WORKSPACE_TEAM_ID=<id>.`
+        );
+      } else if (teams.length > 1) {
+        dependencies.core.warning(
+          `API key has access to ${teams.length} teams but org-mode could not be confirmed. Proceeding without teamId. If workspace creation fails, set workspace-team-id explicitly.`
+        );
+      }
+    } catch (err) {
+      if (err instanceof Error && err.message.includes("Org-mode account detected")) {
+        throw err;
+      }
+      dependencies.core.warning(
+        `Could not check for org-mode sub-teams: ${err instanceof Error ? err.message : String(err)}`
+      );
+    }
+  }
   if (!workspaceId) {
     const workspace = await runGroup(
       dependencies.core,
       "Create Postman Workspace",
-      async () => dependencies.postman.createWorkspace(workspaceName, aboutText)
+      async () => dependencies.postman.createWorkspace(workspaceName, aboutText, workspaceTeamId)
     );
     workspaceId = workspace.id;
   }
   outputs["workspace-id"] = workspaceId || "";
   outputs["workspace-url"] = `https://go.postman.co/workspace/${workspaceId}`;
   outputs["workspace-name"] = workspaceName;
-  await writeVariable(
-    dependencies.github,
-    inputs.projectName,
-    "WORKSPACE_ID",
-    outputs["workspace-id"],
-    dependencies.core
-  );
   if (inputs.domain && dependencies.internalIntegration) {
     await runGroup(
       dependencies.core,
@@ -30671,33 +30550,43 @@ async function runBootstrap(inputs, dependencies) {
     );
   }
   let specId = inputs.specId;
-  if (!specId && dependencies.github) {
-    specId = await readVariable(dependencies.github, inputs.projectName, "SPEC_UID");
+  if (!specId) {
+    specId = getFirstCloudResourceId(resourcesState?.cloudResources?.specs);
+    if (specId) {
+      dependencies.core.info("Resolved spec-id from .postman/resources.yaml");
+    }
   }
-  let baselineCollectionId = inputs.baselineCollectionId;
-  let smokeCollectionId = inputs.smokeCollectionId;
-  let contractCollectionId = inputs.contractCollectionId;
-  if (dependencies.github) {
+  let baselineCollectionId = inputs.collectionSyncMode === "refresh" ? void 0 : inputs.baselineCollectionId;
+  let smokeCollectionId = inputs.collectionSyncMode === "refresh" ? void 0 : inputs.smokeCollectionId;
+  let contractCollectionId = inputs.collectionSyncMode === "refresh" ? void 0 : inputs.contractCollectionId;
+  if (inputs.collectionSyncMode !== "refresh") {
+    const cloudCollections = resourcesState?.cloudResources?.collections;
     if (!baselineCollectionId) {
-      baselineCollectionId = await readVariable(
-        dependencies.github,
-        inputs.projectName,
-        "BASELINE_COLLECTION_UID"
+      baselineCollectionId = findCloudResourceId(
+        cloudCollections,
+        (filePath) => filePath.includes("[Baseline]")
       );
+      if (baselineCollectionId) {
+        dependencies.core.info("Resolved baseline-collection-id from .postman/resources.yaml");
+      }
     }
     if (!smokeCollectionId) {
-      smokeCollectionId = await readVariable(
-        dependencies.github,
-        inputs.projectName,
-        "SMOKE_COLLECTION_UID"
+      smokeCollectionId = findCloudResourceId(
+        cloudCollections,
+        (filePath) => filePath.includes("[Smoke]")
       );
+      if (smokeCollectionId) {
+        dependencies.core.info("Resolved smoke-collection-id from .postman/resources.yaml");
+      }
     }
     if (!contractCollectionId) {
-      contractCollectionId = await readVariable(
-        dependencies.github,
-        inputs.projectName,
-        "CONTRACT_COLLECTION_UID"
+      contractCollectionId = findCloudResourceId(
+        cloudCollections,
+        (filePath) => filePath.includes("[Contract]")
       );
+      if (contractCollectionId) {
+        dependencies.core.info("Resolved contract-collection-id from .postman/resources.yaml");
+      }
     }
   }
   if (specId) {
@@ -30721,7 +30610,10 @@ async function runBootstrap(inputs, dependencies) {
       } else {
         specId = await dependencies.postman.uploadSpec(
           workspaceId || "",
-          inputs.projectName,
+          createAssetProjectName(
+            inputs,
+            inputs.specSyncMode === "version" ? releaseLabel : void 0
+          ),
           document
         );
       }
@@ -30730,13 +30622,6 @@ async function runBootstrap(inputs, dependencies) {
     }
   );
   void specContent;
-  await writeVariable(
-    dependencies.github,
-    inputs.projectName,
-    "SPEC_UID",
-    outputs["spec-id"],
-    dependencies.core
-  );
   const lintSummary = await runGroup(
     dependencies.core,
     "Lint Spec via Postman CLI",
@@ -30774,13 +30659,15 @@ async function runBootstrap(inputs, dependencies) {
     dependencies.core,
     "Generate Collections from Spec",
     async () => {
-      outputs["baseline-collection-id"] = baselineCollectionId || "";
-      outputs["smoke-collection-id"] = smokeCollectionId || "";
-      outputs["contract-collection-id"] = contractCollectionId || "";
+      const shouldReuseCollections = inputs.collectionSyncMode !== "refresh";
+      const assetProjectName = inputs.collectionSyncMode === "version" ? createAssetProjectName(inputs, releaseLabel) : inputs.projectName;
+      outputs["baseline-collection-id"] = shouldReuseCollections ? baselineCollectionId || "" : "";
+      outputs["smoke-collection-id"] = shouldReuseCollections ? smokeCollectionId || "" : "";
+      outputs["contract-collection-id"] = shouldReuseCollections ? contractCollectionId || "" : "";
       if (!outputs["baseline-collection-id"]) {
         outputs["baseline-collection-id"] = await dependencies.postman.generateCollection(
           outputs["spec-id"],
-          inputs.projectName,
+          assetProjectName,
           "[Baseline]"
         );
       } else {
@@ -30788,17 +30675,10 @@ async function runBootstrap(inputs, dependencies) {
           `Using existing baseline collection: ${outputs["baseline-collection-id"]}`
         );
       }
-      await writeVariable(
-        dependencies.github,
-        inputs.projectName,
-        "BASELINE_COLLECTION_UID",
-        outputs["baseline-collection-id"],
-        dependencies.core
-      );
       if (!outputs["smoke-collection-id"]) {
         outputs["smoke-collection-id"] = await dependencies.postman.generateCollection(
           outputs["spec-id"],
-          inputs.projectName,
+          assetProjectName,
           "[Smoke]"
         );
       } else {
@@ -30806,17 +30686,10 @@ async function runBootstrap(inputs, dependencies) {
           `Using existing smoke collection: ${outputs["smoke-collection-id"]}`
         );
       }
-      await writeVariable(
-        dependencies.github,
-        inputs.projectName,
-        "SMOKE_COLLECTION_UID",
-        outputs["smoke-collection-id"],
-        dependencies.core
-      );
       if (!outputs["contract-collection-id"]) {
         outputs["contract-collection-id"] = await dependencies.postman.generateCollection(
           outputs["spec-id"],
-          inputs.projectName,
+          assetProjectName,
           "[Contract]"
         );
       } else {
@@ -30824,13 +30697,6 @@ async function runBootstrap(inputs, dependencies) {
           `Using existing contract collection: ${outputs["contract-collection-id"]}`
         );
       }
-      await writeVariable(
-        dependencies.github,
-        inputs.projectName,
-        "CONTRACT_COLLECTION_UID",
-        outputs["contract-collection-id"],
-        dependencies.core
-      );
     }
   );
   outputs["collections-json"] = JSON.stringify({
@@ -30868,26 +30734,47 @@ async function runBootstrap(inputs, dependencies) {
       ]);
     }
   );
-  if (dependencies.github) {
-    const github = dependencies.github;
-    await runGroup(
-      dependencies.core,
-      "Store Postman UIDs as Repo Variables",
-      async () => {
-        await persistBootstrapRepositoryVariables(
-          github,
-          inputs.projectName,
-          outputs,
-          systemEnvMap,
-          environments,
-          {
-            lintErrors: lintSummary.errors,
-            lintWarnings: lintSummary.warnings
-          },
-          dependencies.core
-        );
-      }
-    );
+  const linkedCollectionIds = [
+    outputs["baseline-collection-id"],
+    outputs["smoke-collection-id"],
+    outputs["contract-collection-id"]
+  ].filter(Boolean);
+  if (linkedCollectionIds.length > 0) {
+    if (dependencies.internalIntegration) {
+      await runGroup(
+        dependencies.core,
+        "Link Collections to Specification",
+        async () => {
+          await dependencies.internalIntegration?.linkCollectionsToSpecification(
+            outputs["spec-id"],
+            linkedCollectionIds.map((collectionId) => ({
+              collectionId,
+              syncOptions: {
+                syncExamples: inputs.syncExamples
+              }
+            }))
+          );
+        }
+      );
+      await runGroup(
+        dependencies.core,
+        "Sync Linked Collections",
+        async () => {
+          await Promise.all(
+            linkedCollectionIds.map(
+              (collectionId) => dependencies.internalIntegration.syncCollection(
+                outputs["spec-id"],
+                collectionId
+              )
+            )
+          );
+        }
+      );
+    } else {
+      dependencies.core.warning(
+        "Skipping cloud spec-to-collection linking and sync because postman-access-token is not configured"
+      );
+    }
   }
   for (const [name, value] of Object.entries(outputs)) {
     dependencies.core.setOutput(name, value);
@@ -30902,9 +30789,6 @@ async function runAction(actionCore = core, actionExec = exec, actionIo = io) {
     io: actionIo,
     specFetcher: fetch
   });
-  if (!dependencies.github) {
-    actionCore.info("GitHub repository variable persistence disabled for this run");
-  }
   if (inputs.domain && !dependencies.internalIntegration) {
     actionCore.warning(
       "Skipping governance assignment because postman-access-token is not configured"
@@ -30915,22 +30799,12 @@ async function runAction(actionCore = core, actionExec = exec, actionIo = io) {
 function createBootstrapDependencies(inputs, factories) {
   const secretMasker = createSecretMasker([
     inputs.postmanApiKey,
-    inputs.postmanAccessToken,
-    inputs.githubToken,
-    inputs.ghFallbackToken
+    inputs.postmanAccessToken
   ]);
   const postman = new PostmanAssetsClient({
     apiKey: inputs.postmanApiKey,
     secretMasker
   });
-  const repository = extractRepositorySlug(inputs.repoUrl);
-  const github = inputs.githubToken && inputs.repoUrl && repository ? new GitHubApiClient({
-    authMode: inputs.githubAuthMode,
-    fallbackToken: inputs.ghFallbackToken,
-    repository,
-    secretMasker,
-    token: inputs.githubToken
-  }) : void 0;
   const internalIntegration = inputs.postmanAccessToken ? createInternalIntegrationAdapter({
     accessToken: inputs.postmanAccessToken,
     backend: inputs.integrationBackend,
@@ -30940,30 +30814,12 @@ function createBootstrapDependencies(inputs, factories) {
   return {
     core: factories.core,
     exec: factories.exec,
-    github,
     io: factories.io,
     internalIntegration,
     postman,
     specFetcher: factories.specFetcher ?? fetch
   };
 }
-function extractRepositorySlug(repoUrl) {
-  const normalized = normalizeInputValue(repoUrl);
-  if (!normalized) {
-    return void 0;
-  }
-  try {
-    const parsed = new URL(normalized);
-    const pathname = parsed.pathname.replace(/^\/+|\/+$/g, "").replace(/\.git$/, "");
-    const segments = pathname.split("/").filter(Boolean);
-    if (segments.length >= 2) {
-      return `${segments[0]}/${segments[1]}`;
-    }
-    return void 0;
-  } catch {
-    return void 0;
-  }
-}
 var currentModulePath = typeof __filename === "string" ? __filename : "";
 var entrypoint = process.argv[1];
 if (entrypoint && currentModulePath === entrypoint) {
@@ -30979,7 +30835,6 @@ if (entrypoint && currentModulePath === entrypoint) {
 0 && (module.exports = {
   createBootstrapDependencies,
   createPlannedOutputs,
-  extractRepositorySlug,
   getInput,
   lintSpecViaCli,
   normalizeSpecDocument,