Releasing inferctl

The current public tag is v0.3.0. The next release version must be selected before this procedure starts. This release posture uses Go-toolchain installation only. Do not publish binaries, installers, Homebrew formulae, Scoop manifests, GoReleaser artifacts, or release archives.

GitHub Actions verification is intentionally manual-only for this phase. Treat local verification as the default release gate and use hosted Actions runs only when a specific cross-platform check is worth the extra churn.

RC Validation

Use this sequence to validate a local release candidate:

git status --short
go generate ./internal/contract
scripts/check-contract-goldens.sh
scripts/check-public-readiness.sh
go test ./...
go vet ./...
go build ./...
examples/demo-1-install-moment.sh
examples/demo-2-route-explained.sh
examples/demo-3-agent-loop.sh
examples/demo-4-agent-preflight-report.sh
git tag <version>-rc.1

If you push an RC tag, validate go install from a clean shell:

go install github.com/inferctl/inferctl/cmd/inferctl@<version>-rc.1
inferctl version --json | jq .data.tool_version

No platform archive, installer, Homebrew formula, or Scoop manifest is a release gate in this cycle.

The public install path is go install github.com/inferctl/inferctl/cmd/inferctl@latest.

The deterministic fixture helper remains cmd/infer-testserver by design in this cycle. It is an internal repo utility, not part of the user-facing naming surface.

Publish Source Tag

After the release version is approved, use a fresh reviewed commit and tag:

git status --short
go generate ./internal/contract
scripts/check-contract-goldens.sh
scripts/check-public-readiness.sh
go test ./...
go vet ./...
go build ./...
examples/demo-1-install-moment.sh
examples/demo-2-route-explained.sh
examples/demo-3-agent-loop.sh
examples/demo-4-agent-preflight-report.sh
git tag -a <version> -m "inferctl <version>"
git push origin main
git push origin <version>
go install github.com/inferctl/inferctl/cmd/inferctl@<version>
go install github.com/inferctl/inferctl/cmd/inferctl@latest

Do not run GoReleaser or upload release archives for this launch posture. The public install path is Go toolchain only.

Rollback

For a local-only RC tag:

git tag -d <version>-rc.1
rm -rf dist/

For a pushed public tag, delete only after deciding how to communicate the replacement release:

git push origin :refs/tags/<version>
git tag -d <version>