What's New
Gentle AI v2.1.6 publishes gentle-ai.review-integration/v1, an explicitly negotiated provider contract for consumers such as Gentle Pi. Integrations can now discover review capabilities outside a repository, reconcile failures without guessing mutation state, and reconstruct the exact review target safely after restart.
Changes
Review Integration Contract
- Repository-independent capabilities:
gentle-ai review capabilities --contract gentle-ai.review-integration/v1reports supported operations, gates, projections, schemas, features, build identity, and the compatibility window without mutating authority. - Uniform failure envelope: Negotiated operations report mutation outcome, replayability, authority applicability, required inputs, and one safe next action while preserving nonzero failure exits.
- Target-scoped status and projection: Consumers receive deterministic
current_target,unrelated,ambiguous, orcorruptedapplicability plus safe restart projection data instead of inferring lifecycle state from provider storage. - Legacy-v1 read-only compatibility: Applicable historical receipts remain evaluable, ordinary legacy mutation fails closed as read-only, and unrelated valid v1 history no longer blocks compact-v2 authority. (#1310, closes #1307 and #1242)
Review Delivery Safety
- Exact correction and publication boundaries: Correction-created paths outside frozen authority are rejected, while staged and published candidates are bound to exact index, commit, and path evidence with final authorization revalidation. (#1306)
- Compatible final-scope narrowing: Approved final candidates can narrow to a subset of frozen genesis paths without losing their receipt identity; non-genesis paths still fail closed. (#1305)
Contract Distribution
- Packaged integration surface: Every release archive includes the versioned schemas, conformance fixtures, and review integration guide used to verify consumer compatibility.
Upgrade
brew upgrade gentle-ai && gentle-ai sync