Prepare and publish a release
Release through GitHub Actions or a manual workflow, and recover from partial failures.
GitHub Actions
For repositories using the generated GitHub Actions workflow:
- Create a changeset and check the plan with
smif status. - Merge the change into the configured base branch.
smif ciprepares and maintains the release pull request. - Review and merge the release pull request. CI publishes the prepared versions.
This workflow handles versioning and publishing in CI. ci runs only in GitHub Actions and skips branches other than the configured base branch. Pending changesets select release pull request preparation; no pending changesets select publishing. The rendered release branch must differ from the base branch.
Manual release
For repositories using a manual release workflow:
- Check configured hooks, pre-checks, and the worktree diff.
- Preview
smif version --dry-run, then runsmif version. This updates package versions, eligible internal requirements, and changelogs, and consumes changesets. - Review the generated diff, run repository checks, and commit the version changes.
- Preview
smif publish --dry-run, then runsmif publish.
--allow-dirty includes existing worktree changes in the operation. Dry-run-enabled configured commands can execute during previews, and publish preflight can access registries.
Recover a failed release
- A planning or validation failure during version preparation leaves package files and changesets unchanged. A post-version hook failure can leave applied edits and retained changesets. Review the diff, fix the hook, and follow the reported recovery steps before retrying.
- Publishing uses versioned manifests and changelogs. Check each package's
succeeded,failed,skipped, ornot-startedstatus and its failed stage. Existing registry versions skip registry publishing. With GitHub Releases enabled, a missing Release may still be created; existing Releases do not receive missing assets automatically on retry. - For a CI failure, check the reported preparation, push, or release pull request stage and the corresponding files or remote results before retrying.
- Status comment-write and changelog metadata failures can be warnings. Release pull request and publishing failures stop the corresponding operation.
See versioning, publishing, CI, and status for detailed command behavior.