Gentleman-Programming/gentle-ai v3.0.1

v3.0.1 — Go Module Path /v3, Installable Again on Every Platform

on GitHub

Gentle AI v3.0.1 is a hotfix release that makes the v3 line installable through Go again. v3.0.0 was cut from the github.com/gentleman-programming/gentle-ai/v2 module, and Go refuses any v3.x.y version for a module path ending in /v2, so go install, install.ps1, source installs, the printed upgrade instruction, and the gentle-pi Windows installer could not install v3.0.0. Windows has no binary archives, so Windows users were locked out of the release. The module path now lives at /v3. Everything shipped in v3.0.0 (ODD as the default protocol, unified feature continuity with configured TDD, simplified SDD, and the three fixes) is unchanged.

Provenance

• Previous stable: v3.0.0 → 1a2f6775
• Release target: v3.0.1 → 2594581e
• Release workflow: run 35116944938
• Verification: preflight, release, and verify jobs all succeeded.
• Provider contract: 1.2.0

What's new

No new features are declared for v3.0.1. See the v3.0.0 notes for what the v3 line brings.

Breaking changes

• Go module path is now github.com/gentleman-programming/gentle-ai/v3. Anyone importing this module or installing from source must use the /v3 path. The go install line below is the new one; the /v2 form no longer resolves for v3.x. A gentle-ai v3.0.0 binary prints the old /v2 upgrade instruction, so upgrade that one binary with the command in the Install section once; every later upgrade prints the right path.

The provider contract stays byte-frozen at 1.2.0.

Upgrade now

brew upgrade gentle-ai
gentle-ai sync

Windows and other source installs:

go install github.com/gentleman-programming/gentle-ai/v3/cmd/gentle-ai@v3.0.1
gentle-ai sync

Run gentle-ai sync after upgrading so managed agent, reviewer, and runtime assets match the installed binary.

What was fixed

v3.x installable through go install on every platform

The module path moved from /v2 to /v3 across go.mod, every Go import, the GoReleaser ldflags symbol, scripts/install.sh, scripts/install.ps1, the upgrade instruction printed by gentle-ai upgrade, and the docs. The beta self-upgrade path built its go install target by appending a literal /v2; it now appends /v3, which the existing strategy and Windows distribution-policy tests caught. Historical release ledgers and archived planning artifacts keep their /v2 references on purpose.

Included work: #4683 (issue #4682).

Numbers

1 non-merge commit, 1 merged pull request, and 1 unique GitHub PR author since v3.0.0.

Install

brew install Gentleman-Programming/tap/gentle-ai

or

go install github.com/gentleman-programming/gentle-ai/v3/cmd/gentle-ai@v3.0.1

Windows 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.0...v3.0.1