Skip to content

v5.0.0 — Go Module v5 and Modern Review Authority

Latest

Choose a tag to compare

@github-actions github-actions released this 22 Nov 11:07
Immutable release. Only release title and notes can be modified.
4716b3c

Gentle AI v5.0.0 is a major release. It moves the Go module to /v5, removes legacy review authority, and improves recovery when Gentle Shell installs and updates fail. The managed provider bundle retains version 1.6.0, with updated routing and orchestration files. The review CLI changes below still apply.

Provenance

  • Previous stable: v4.6.0 → 08317b9589598f99ebcc00498c39a60f352f05e4
  • Release target: v5.0.0 → 4716b3cbca158c35c3b316dbd517f54e5f240f97
  • Release workflow: run 45014677938
  • Verification: preflight, release, and verify jobs all succeeded.
  • Provider contract: 1.6.0

What's new

A single review-due decision

The Stop hook reads the same review-due decision as the review entry path. An explicit escalation now reaches that entry decision instead of being dropped.

Included work: #6204 and #6214.

One abandonment route for stuck review lineages

gentle-ai review abandon covers stuck lineages through one route. It still requires the exact current revision (--expected-revision) and the maintainer authorization binding (--maintainer-authorization).

Included work: #6207.

Breaking changes

  • Go module: the module and command paths move from /v4 to /v5. Update imports, build scripts, and pinned go install commands when adopting v5. #6223 (issue #6222).
  • Review authority: legacy v1 review authority is removed. Integrations that still rely on it must use the supported review protocol. The capabilities/v2.6 payload changed without an identifier bump, so consumers should refresh their capability discovery rather than treating that identifier as proof of the old feature set. #6211.

Run gentle-ai sync after updating the binary so local integrations discover the current review behavior.

Upgrade now

brew upgrade gentle-ai
gentle-ai sync

Windows and other source installs:

go install github.com/gentleman-programming/gentle-ai/v5/cmd/gentle-ai@v5.0.0
gentle-ai sync

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

What was fixed

Safer Gentle Shell installs and updates

A failed Windows replacement restores the previous backup, and transient file locks no longer cause immediate failure. Downloads tolerate slow or flaky connections, and operations targeting the same installation are serialized. The TUI can exit the failure screen, cancel before publication, and recover from an update-check failure.

Included work: #6185, #6186, #6189, #6190, #6191, #6192, and #6205.

Version-correct update guidance

A beta install can recover from tagged releases without downgrading. On Windows, the stable Go install instruction uses the exact published tag and the module major that matches it. If stable metadata is unavailable or invalid, Gentle AI does not offer an unverified install command.

Included work: #6219 and #6223 (issue #6222).

Windows Hermes discovery and review STATUS

Windows Hermes discovery honors HERMES_HOME and %LOCALAPPDATA%. Base-ref review STATUS now answers an untracked-file declaration through its typed collect route.

Included work: #6206 and #6195.

Numbers

61 non-merge commits, 21 merged pull requests, and 3 unique GitHub PR authors since v4.6.0.

Install

brew install Gentleman-Programming/tap/gentle-ai

or

go install github.com/gentleman-programming/gentle-ai/v5/cmd/gentle-ai@v5.0.0

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: v4.6.0...v5.0.0