Gentle AI v3.0.2 is a hotfix release that completes the /v3 module migration for the install scripts. v3.0.1 moved the Go module to github.com/gentleman-programming/gentle-ai/v3, but scripts/install.sh and scripts/install.ps1 still built their go install target on the /v2 path, so the stable script fallback silently installed v2.9.1 and the beta channel failed. Both scripts now install from /v3. A community member reported it on Discord. Everything else from v3.0.0 and v3.0.1 is unchanged.
Provenance
- Previous stable:
v3.0.1→2594581e - Release target:
v3.0.2→9bf454d4 - Release workflow: run 35128112836
- Verification: preflight, release, and verify jobs all succeeded.
- Provider contract:
1.2.0
What's new
No new features are declared for v3.0.2. See the v3.0.0 notes for what the v3 line brings.
Breaking changes
No breaking changes are declared for v3.0.2. The module path stays at /v3 as introduced in v3.0.1, and the provider contract remains byte-frozen at 1.2.0.
Upgrade now
brew upgrade gentle-ai
gentle-ai syncWindows and other source installs:
go install github.com/gentleman-programming/gentle-ai/v3/cmd/gentle-ai@v3.0.2
gentle-ai syncRun gentle-ai sync after upgrading so managed agent, reviewer, and runtime assets match the installed binary.
What was fixed
install.sh and install.ps1 install from the /v3 module
Both scripts assembled the go install package by interpolation (<owner>/<repo>/v2/cmd/gentle-ai@<version>), so the v3.0.1 rewrite of the literal module string missed them. The stable fallback resolved /v2@latest (v2.9.1) without any error, and GENTLE_AI_CHANNEL=beta resolved /v2@main, which fails because main is a /v3 module. Both now target /v3/cmd/gentle-ai, their comments describe v3.x tags, and a regression test derives the expected major from go.mod so the next migration fails in CI before it ships. The scripts are served raw from main, so curl ... | bash and the PowerShell one-liner already pick up the fix; this release makes the tag carry the corrected scripts as well.
Included work: #4686 (issue #4685).
Numbers
1 merged pull request (2 squashed commits) and 1 unique GitHub PR author since v3.0.1, with the residual reported by a community member on Discord.
Install
brew install Gentleman-Programming/tap/gentle-aior
go install github.com/gentleman-programming/gentle-ai/v3/cmd/gentle-ai@v3.0.2Windows remains supported through the Go installation path. Official Windows binary archives and Scoop publication remain unavailable; Windows upgrades fail closed to Go-based guidance rather than downloading unsigned binaries.
Signed platform archives below: linux_amd64, linux_arm64, darwin_amd64, darwin_arm64, with checksums.txt and its minisign signature.
Full changelog: v3.0.1...v3.0.2