Skip to content

v4.6.0 — Authorized Work Keeps Moving, Windows Installs Improve

Latest

Choose a tag to compare

@github-actions github-actions released this 18 Nov 17:15
Immutable release. Only release title and notes can be modified.
08317b9

Gentle AI v4.6.0 is a minor release that keeps authorized work moving, makes the orchestrator responsible for what happens when a worker runs out of corrections, and improves Gentle Shell's Windows installation and uninstall paths. The review provider contract advances to 1.6.0.

Provenance

  • Previous stable: v4.5.0 → f2f7d7b16c2cf1afe5e07f717cf8265946ac3feb
  • Release target: v4.6.0 → 08317b9589598f99ebcc00498c39a60f352f05e4
  • Release workflow: run 44354559703
  • Verification: preflight, release, and verify jobs all succeeded.
  • Provider contract: 1.6.0

What's new

Authorized work keeps moving

Managed guidance now distinguishes a pending worker from a genuine blocker. When evidence is missing, the affected work stays partial and independent authorized work can continue. The orchestrator uses a decision tool when a real human choice fits it, and decides proposed edit-surface additions itself only when they stay within the same objective, repository, and authority. Routine phase labels and delivery formatting no longer interrupt the work, and responses no longer require a Key Learnings block.

Included work: #6145 (issue #6144).

Windows keeps the newest owned uninstall backup

After a successful Windows uninstall, the installer keeps the backup it just created and prunes older backups only when it can prove that it owns them. It preserves and reports ambiguous directories instead of deleting them.

Included work: #6168 (issue #6162).

Windows signing pilot stays out of production

An isolated SignPath pilot tests Authenticode signatures for Windows fixtures without publishing artifacts to stable releases. Production Minisign distribution stays in place; this does not resume public Windows binary or Scoop distribution.

Included work: #6161 (issue #6160).

Breaking changes

No user-facing CLI or Go module-path break is declared for v4.6.0; the module stays at /v4. The provider contract is not byte-frozen: it advances to 1.6.0, including revised orchestration and routing guidance. Consumers that pin the contract identity must recognize the new version before upgrading. Gentle AI no longer installs the older Claude Code and Codex delegation modules. Install and sync retire copies that Gentle AI still owns, while preserving modified copies. Run gentle-ai sync to update the managed guidance.

Included work: #6145 (issue #6144).

Upgrade now

brew upgrade gentle-ai
gentle-ai sync

Windows and other source installs:

go install github.com/gentleman-programming/gentle-ai/v4/cmd/gentle-ai@v4.6.0
gentle-ai sync

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

What was fixed

The orchestrator owns recovery after worker exhaustion

Exhausting a worker's correction budget ends that worker's cycle, not the whole task. The worker returns a diagnosed partial result, and the orchestrator can take another scoped step only with a new hypothesis; it does not repeat a failed attempt or ask the human to make a routine technical decision.

Included work: #6159 (issue #6158).

Windows Main-channel installs accept the supported Node range and resolve a bounded revision

The Windows overlay now recognizes caret ranges and || alternatives in the declared Node requirement, while still rejecting unknown syntax. Main-channel acquisition asks GitHub for just the revision SHA, so large commit descriptions and patches no longer overflow the response limit. On Node 24.22, rollback also restores the shared prefix's previous contents into the dependency root that the installer kept.

Included work: #6147 (issue #6135), #6149 (issue #5987).

Windows installs remove non-runtime dependency files

The managed install prunes eligible TypeScript declarations and source maps from the Windows dependency prefix, leaving fewer files for Defender to scan on first launch. It protects the Gentle Shell and TypeScript packages and warns rather than failing the install if pruning cannot complete.

Included work: #6166 (issue #6165).

CI reports failures more reliably

The OpenCode v2 catalog test waits for the refresh to complete before reopening the catalog, removing a test-harness race without changing production behavior. Linux installer qualification adds a readable guest verdict to the existing encoded output; that improves diagnosis, but does not fix the underlying qualification issue (#6170).

Included work: #6164 (issue #6163), #6171 (issue #6169).

Numbers

12 non-merge commits, 9 merged pull requests, and 2 unique GitHub PR authors since v4.5.0.

Install

brew install Gentleman-Programming/tap/gentle-ai

or

go install github.com/gentleman-programming/gentle-ai/v4/cmd/gentle-ai@v4.6.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. The release also includes the versioned provider contract bundle and release provenance bundle.

Full changelog: v4.5.0...v4.6.0