- name
- release-sdk
- description
- Bump and release @macro-inc/sdk from this repository. Use when asked to bump the SDK version or release it to npm.
# Release the SDK
Read [the SDK release guide](../../../packages/sdk/RELEASING.md) and the root
`AGENTS.md`. Releasing is merging a version bump: `Release SDK` publishes on any
push to `main` that raises the version in `packages/sdk/package.json`. There is
no release tag to push by hand and no separate publish step to trigger.
## Scope
- "Bump" authorizes editing the version and validating it, in the PR that carries
the SDK change.
- Because merging publishes, authorization to merge a version bump to `main` is
authorization to publish. Do not merge a bump without it. Honor existing
session authorization without asking again.
- Creating or editing this skill or its documentation does not authorize a release.
## Execution
1. Inspect the worktree, current branch, `origin/main`, npm versions, and release
tags. Preserve unrelated changes. If a bump is already prepared on the branch,
resume it rather than bumping twice; if versions disagree or the base is a
prerelease, resolve that first.
2. Run `just bump` in `packages/sdk` (it takes `patch`, `minor`, `major`, or an
explicit version), then the guide's validation and package inspection. Commit
the bump alongside the SDK change. Do not hide failed checks.
3. After the merge, watch the `Release SDK` run for that commit, then verify the
npm version and dist-tag. A merged bump, a green job, or a pushed tag alone is
not proof of publication.
4. Use the guide's recovery path — the `sdk-v*` tag trigger on `Publish SDK` —
only when a merged release commit failed transiently and the version is still
unpublished. Never move an existing tag or re-publish a published version.
Return the old/new version, PR and release commit, tag, Actions run URL, and npm
verification. Clearly distinguish prepared, awaiting merge, publishing, failed,
and published states; include only artifacts that actually exist.
View on GitHub