@postman-cse/onboarding-api 0.10.1 → 0.12.0

package/README.md

@@ -127,6 +127,7 @@ Even when reusing an existing `spec-id`, the composite action still requires `sp
 | `baseline-collection-id` | | Reuse an existing baseline collection. |
 | `smoke-collection-id` | | Reuse an existing smoke collection. |
 | `contract-collection-id` | | Reuse an existing contract collection. |
+| `sync-examples` | `true` | Whether linked spec/collection relations should enable example syncing during cloud linkage. |
 | `collection-sync-mode` | `refresh` | Collection lifecycle policy. `refresh` regenerates from latest spec (default), `reuse` keeps existing, `version` creates release-scoped collections. |
 | `spec-sync-mode` | `update` | Spec lifecycle policy. `update` keeps canonical spec current, `version` creates release-scoped spec. |
 | `release-label` | | Optional release label for versioned specs and collections. Derived from git tag/branch when omitted. |
@@ -142,6 +143,7 @@ Even when reusing an existing `spec-id`, the composite action still requires `sp
 | `workspace-admin-user-ids` | | Optional comma-separated workspace admin IDs. |
 | `workspace-team-id` | | Numeric sub-team ID for org-mode workspace creation. |
 | `spec-url` | | Required registry-backed OpenAPI document URL. |
+| `spec-path` | | Optional repo-root-relative path to the local spec file used for repo metadata generation. |
 | `environments-json` | `["prod"]` | Environment slugs to materialize downstream. |
 | `system-env-map-json` | `{}` | Map of environment slug to system environment ID. |
 | `governance-mapping-json` | `{}` | Map of domain to governance group name. |
@@ -232,7 +234,7 @@ The composite action wires:
 - `workspace-id`, `workspace-url`, `spec-id`, and `collections-json` from `bootstrap`.
 - `environment-uids-json`, `mock-url`, `monitor-id`, `repo-sync-summary-json`, and `commit-sha` from `repo_sync`.
 - Existing-service passthrough inputs to `bootstrap`: `workspace-id`, `spec-id`, `baseline-collection-id`, `smoke-collection-id`, and `contract-collection-id`.
-- Existing-repo passthrough inputs to `repo_sync`: `generate-ci-workflow` and `ci-workflow-path`.
+- Existing-repo passthrough inputs to `repo_sync`: `generate-ci-workflow`, `ci-workflow-path`, and `spec-path`.
 - When `enable-insights: true`, the Insights onboarding step runs after repo sync using the workspace ID from bootstrap plus the first environment from `environments-json` for `environment-id` and `system-env-map-json` lookup.
 - Insights outputs (`insights-status`, `insights-verification-token`, `insights-application-id`, `insights-discovered-service-id`, `insights-discovered-service-name`, `insights-collection-id`) are surfaced when `enable-insights: true`.
 

package/action.yml

@@ -17,6 +17,10 @@ inputs:
   contract-collection-id:
     description: Existing contract collection ID.
     required: false
+  sync-examples:
+    description: Whether linked spec/collection relations should enable example syncing.
+    required: false
+    default: 'true'
   collection-sync-mode:
     description: Collection lifecycle policy (reuse, refresh, or version). Default refresh ensures collections stay in sync with the spec.
     required: false
@@ -64,6 +68,9 @@ inputs:
   spec-url:
     description: URL to the OpenAPI document to bootstrap.
     required: true
+  spec-path:
+    description: Optional repo-root-relative path to the local spec file for repo metadata generation.
+    required: false
   environments-json:
     description: JSON array of environment slugs to materialize.
     required: false
@@ -201,6 +208,7 @@ runs:
         baseline-collection-id: ${{ inputs.baseline-collection-id }}
         smoke-collection-id: ${{ inputs.smoke-collection-id }}
         contract-collection-id: ${{ inputs.contract-collection-id }}
+        sync-examples: ${{ inputs.sync-examples }}
         collection-sync-mode: ${{ inputs.collection-sync-mode }}
         spec-sync-mode: ${{ inputs.spec-sync-mode }}
         release-label: ${{ inputs.release-label }}
@@ -251,6 +259,7 @@ runs:
         ssl-client-passphrase: ${{ inputs.ssl-client-passphrase }}
         ssl-extra-ca-certs: ${{ inputs.ssl-extra-ca-certs }}
         spec-id: ${{ steps.bootstrap.outputs.spec-id }}
+        spec-path: ${{ inputs.spec-path }}
     - id: insights_onboarding
       if: inputs.enable-insights == 'true'
       name: Onboard Postman Insights

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@postman-cse/onboarding-api",
-  "version": "0.10.1",
+  "version": "0.12.0",
   "description": "Public open-alpha composite Postman API onboarding GitHub Action.",
   "files": [
     "action.yml",