Gentleman-Programming/gentle-ai v2.2.2

on GitHub

What's New

Gentle AI v2.2.2 makes SDD close cleanly while the review kill switch is off, and corrects what RDD stands for across the product.

Turning reviews off was supposed to mean reviews do not exist. In practice a change could still be trapped: after apply, status routed to a review that review start was refused from producing. This release removes that deadlock at both ends of the cycle.

Changes

SDD under a disabled kill switch

• Pre-verify no longer creates an implicit review obligation: with the switch off, the SDD dispatcher still called the pre-verify review routing without knowing review was disabled, so it blocked verification and set nextRecommended: review. review start then correctly refused because the switch was off — a deadlock with no exit. Verification now stays reachable. (#1932, #1942)
• Archive accepts the disabled delivery state: the native gate already deferred correctly, reporting delivery: disabled/unmanaged rather than demanding a receipt that cannot be produced, but the agent-facing contract still required reviewGate.result: allow flatly — so the agent blocked archive exactly where the product had stopped blocking. The sdd-archive skill and the shared review-ledger contract now accept reviewGate.delivery: disabled/unmanaged as well.

Both relaxations remove only the implicit demand, and both are the native gate's decision rather than the agent's. An explicit review artifact that failed validation still blocks, allow is never manufactured, and re-enabling revalidates from the current state.

Naming

• RDD is Receipt-Driven Development: seventy-nine places across code, docs and tests used the wrong expansion — including user-facing strings like the kill-switch sentinel and the disabled-delivery reason — against eight that had it right. The name matters because a receipt is what the whole lifecycle converges on and what every delivery gate validates; "review-driven" names one step and drops the thing that governs delivery.

Documentation

• The README no longer calls RDD unstable or steers new users to pin v1.46.0. That guidance stopped being true at v2.2.0, which made Organic RDD the supported stable path; v1.46.0 predates the /v2 module path and every review, recovery and delivery fix since v1.47.0.
• The known-limitations paragraph is gone because both limitations it described are fixed by this release.

Validation

CI green on Linux, native macOS and native Windows lanes for the exact shipped commit, verified by the release preflight gate.

Recorded benchmark observations keep the previous wording on purpose: they are captures of runs that really happened, and rewriting a recorded measurement would falsify it.

Contributors

Thanks to the community contributor whose merged work is part of this release:

• @decode2 - honored the disabled review mode before pre-verify routing, removing the deadlock where SDD status required a review that review start was refused from producing. (#1942)

Upgrade

Homebrew:

brew upgrade gentle-ai && gentle-ai sync

Go 1.25.10+ on any supported platform, including Windows:

go install github.com/gentleman-programming/gentle-ai/v2/cmd/gentle-ai@v2.2.2
gentle-ai sync