sdk-shared-actions

Shared GitHub Actions and reusable workflows for the Phenoml SDK repos.

Actions

• bundle-openapi-spec — fetches the combined OpenAPI spec for an SDK's source commit and writes it to the working tree.
• extract-code-examples — parses a Fern-generated SDK and writes a code-examples.json manifest mapping HTTP method + path to SDK call source, request body, and response body.
• commit-artifacts — stages, commits, and pushes the given files back to the PR branch (rebasing + retrying on concurrent pushes). The shared "write it back" step for the generator actions above, which only produce files.
• verify-openapi-spec — fails an SDK's publish job if the bundled spec is missing or stale.

Reusable workflows

• sdk-release-gate — runs the shared pre-publish release gate for generated SDKs: extract the SDK version, report whether the release should publish, repair metadata, or skip, read Fern's originGitCommit, verify the bundled OpenAPI spec for new publishes, and validate the prefixed backend-origin/<originGitCommit> release tag name. Version tags, origin release tags, GitHub releases, package builds, and registry publish jobs stay in each SDK repo.
• sdk-release-finalize — reconciles release metadata after an SDK package publish succeeds: it ensures the normal SDK version tag/release, the Fern origin release tag, and, when Fern Replay is configured, the stable replay generation tag all exist and point at the expected commits.
• sync-fern-artifacts — runs bundle → extract → commit in a single ordered run, so the bundled spec and its derived code-examples.json are always generated together and land in one commit. SDK repos call this instead of separate bundle/extract workflows, which could race (extract reading a stale spec) and never self-heal. See the workflow header for inputs.