v3.4.0 — review assess cierra el loop con los work-unit commits, y chau RTK
Este es el minor mas cargado de la tanda. Despues de cada work-unit commit, gentle-ai review assess ahora reporta candidate.consumed, review_due y un review_due_reason concreto: high_risk, slice_budget_reached, passive, under_budget o already_reviewed. Cuando hay review pendiente te devuelve ademas el next_transition con la invocacion exacta de review status --next-transition para los mismos selectores. Traduccion: el orquestador ya no reconstruye la regla desde prosa, la corre tal cual — una review que corresponde deja de ser algo que se puede saltear en silencio.
Los roles de reviewer en pi pasan a ser host-mediated. Antes Go spawneaba pi --print --no-extensions por su cuenta, que no veia los providers registrados por extensiones (Model not found) y se comia las API keys del entorno. Ahora review status renderiza capture-refuter y capture-validation como --materialize=true mas un descriptor submission, gentle-pi corre el modelo in-process con su propio registry y devuelve por --input. El adapter de pi en Go se elimina.
Y algo que dolia: el contexto del reviewer ahora se acota ANTES de que exista autoridad. START antes solo chequeaba el techo de 4 MiB de Git, asi que un candidate gigante congelaba autoridad y despues fallaba cada capture con Prompt is too long, sin salida. Ahora START prueba que la evidencia frozen entra en un presupuesto de 200 KiB por runtime para cada rol antes de persistir nada.
Breaking: se retira la integracion RTK Community Tool de la superficie activa. Ojo con esto: los presets existentes ya no seleccionan community tools por default, y una seleccion RTK no soportada reporta la tool como no disponible en vez de intentar usarla. Tus binarios y config de RTK en disco no se tocan.
Entre los fixes: cap de scrape size en VictoriaMetrics (el 18/09 la exposicion de /metrics paso los 16 MiB en produccion y el dashboard runtime y el open-data publico leian 0), retencion propia para la tabla de dedup del collector (crecia como un millon de filas por dia), y el Gentle Logo que configuraba OpenCode aunque nunca lo hubieras seleccionado.
v3.3.0 — La integracion con OpenCode ahora es version-aware y soporta V2 beta
Minor con una sola feature, pero de las que importan si usas OpenCode: el componente ahora elige su comportamiento segun la major version que reporta el ejecutable opencode instalado. Las instalaciones V2 reciben manejo nativo de config, modelos y MCP con preservacion ordenada de permisos (o sea: tus restricciones de permisos sobreviven a las actualizaciones de reglas generadas), un set propio de plugins V2 gestionados (telemetria, catalog, registry, SDD y un relay opaco de review en staging), y un label OpenCode V2 (beta) en la TUI con aviso de integration testing.
Las instalaciones V1 siguen exactamente igual, los assets V1 se mantienen, y los plugins de comunidad no soportados se rechazan en V2. Ojo: esto es integracion beta parcial testeada contra el SDK 2.0.4 publicado, no coexistencia de primera clase con opencode2 ni certificacion completa del runtime. Las versiones de runtime desconocidas fallan closed, y la review nativa en V2 sigue no disponible.
Honestidad del release notes, que se agradece: al momento de publicar, el Windows Full Suite falla en este commit en TestOpenCodeV2CatalogAndRegistry, introducido por el mismo PR y no verde cuando se empujo el tag. El fix llega en el release siguiente.
v3.2.1 — Telemetria runtime en VictoriaMetrics y delegacion obligatoria en ODD
Primer estable desde v3.1.0. La telemetria de runtime ahora se expone como counters de Prometheus y se guarda en VictoriaMetrics con retencion ilimitada en vez de filas crudas de SQLite. El deploy kit instala VictoriaMetrics, provisiona el datasource de Grafana, hace backfill de las tablas existentes y mueve los paneles del dashboard runtime.
La parte que te toca si laburas con el orquestador: la delegacion en Organic Driven Development pasa de sugerida a obligatoria. Hay una tabla de triggers que elige la ruta de ejecucion — mapping a partir de 4 archivos, un writer a partir de 2 archivos no triviales, lecturas de preparacion delegadas junto con el write — cada task declara su ruta en el feature document (asi una delegacion salteada queda observable en vez de silenciosa), y hay un backstop de sesion larga que frena la ejecucion monolitica despues de unas 20 tool calls, 5 lecturas exploratorias o 2 ediciones no mecanicas sin delegar nada.
Ojo con esto: corre gentle-ai sync despues de actualizar. Los triggers viven en la guidance instalada del orquestador, asi que una instalacion sin sincronizar se queda con el texto viejo que decia que era opcional.
Del lado de los fixes, el collector de telemetria: base en WAL para que los lectores read-only (Grafana, el export de open data) no bloqueen al unico writer, mantenimiento diario anclado a las 00:05 UTC con catch-up al arrancar en vez de 24hs despues del start, y una base ocupada ahora reporta storage_busy en vez de un storage_unavailable generico. Ademas: produccion venia keyeando el rate limit de TODOS los clientes en el literal (null) porque el vhost renderizaba X-Forwarded-For desde una variable de entorno vacia. En review, dos arreglos: un target ya consumido ya no se puede re-reviewar (se rechaza con target_already_acknowledged), y el status activo ahora exige assets gestionados frescos.
v3.4.0 — review assess closes the loop with work-unit commits, and RTK is gone
The heaviest minor of the batch. After every work-unit commit, gentle-ai review assess now reports candidate.consumed, review_due, and a specific review_due_reason: high_risk, slice_budget_reached, passive, under_budget, or already_reviewed. When a review is due it also returns next_transition carrying the exact review status --next-transition invocation for the same selectors. The orchestrator runs that command verbatim instead of reconstructing the rule from prose, so a due review is no longer something it can silently skip.
Pi's reviewer roles become host-mediated. Go used to spawn pi --print --no-extensions itself, which could not see providers registered by pi extensions (Model not found) and stripped env-provided API keys. Now review status renders capture-refuter and capture-validation as --materialize=true plus a submission descriptor, gentle-pi runs the model in-process through its own live registry, and submits via --input. The Go-owned pi adapter is deleted.
Reviewer context is now bounded BEFORE authority exists. START previously checked only against the 4 MiB Git ceiling, so an oversized candidate could freeze review authority and then fail every capture with Prompt is too long, with no way out. START now proves the frozen evidence fits a 200 KiB per-runtime budget for every role before persisting anything.
Breaking: the RTK Community Tool integration is removed from the active product surface. Two behavior changes follow: existing presets no longer select community tools by default, and an unsupported RTK selection reports the tool as unavailable instead of attempting to use it. User-owned RTK binaries and config on disk are untouched.
Among the fixes: a VictoriaMetrics scrape-size cap (on 2026-09-18 the collector's /metrics exposition crossed 16 MiB in production and the runtime dashboard plus the public open-data window read 0), dedicated retention for the collector's dedup table (growing roughly a million rows a day), and the Gentle Logo component that configured OpenCode even when it was never selected.
v3.3.0 — The OpenCode integration is now version-aware with V2 beta support
A minor with a single feature, but one that matters if you use OpenCode: the component now selects its behavior by the major version the installed opencode executable reports. V2 installs get native config, model, and MCP handling with ordered permission preservation (your permission restrictions survive generated-rule updates), a separate set of managed V2 plugins (telemetry, catalog, registry, SDD, and a staged opaque review relay), and an OpenCode V2 (beta) label in the TUI with an integration-testing notice.
V1 installs keep working unchanged, V1 assets are retained, and unsupported community plugins are refused on V2. Note this is partial beta integration tested against the released 2.0.4 SDK, not first-class opencode2 coexistence or complete runtime certification. Unknown runtime versions fail closed, and native V2 review remains unavailable.
Credit where it is due on honesty: at publication the Windows Full Suite fails on this commit in TestOpenCodeV2CatalogAndRegistry, introduced by the same PR and not green when the tag was pushed. The fix ships in the next release.
v3.2.1 — VictoriaMetrics runtime telemetry and mandatory delegation in ODD
First stable since v3.1.0. Runtime telemetry is now exposed as Prometheus counters and stored in VictoriaMetrics with unlimited retention instead of raw SQLite rows. The deploy kit installs VictoriaMetrics, provisions its Grafana datasource, backfills the existing raw runtime tables, and moves the runtime dashboard panels over.
The part that touches you if you work with the orchestrator: delegation in Organic Driven Development goes from advisory to mandatory. A trigger table selects the execution route — mapping at 4+ files, one writer at 2+ non-trivial files, preparation reads delegated with the write — each task declares its route in the feature document so a skipped delegation is observable instead of silent, and a long-session backstop pauses monolithic execution after roughly 20 tool calls, 5 exploratory reads, or 2 non-mechanical edits without any delegation.
Run gentle-ai sync after upgrading: the triggers live in the installed orchestrator guidance, so an un-synced install keeps the old advisory wording.
On the fix side, the telemetry collector: the database runs in WAL so read-only consumers (Grafana, the open-data export) never block the single writer, daily maintenance is anchored to 00:05 UTC with catch-up on start instead of 24 hours after process start, and a busy database reports storage_busy instead of a generic storage_unavailable. Also: production had been keying every client's rate limit on the literal (null) because the vhost rendered X-Forwarded-For from an empty environment variable. Two review fixes: an already-acknowledged target can no longer be re-reviewed (refused with target_already_acknowledged), and active status now requires fresh managed assets.
v3.4.0 — review assess boucle avec les work-unit commits, et RTK disparait
Le minor le plus charge du lot. Apres chaque work-unit commit, gentle-ai review assess rapporte desormais candidate.consumed, review_due et un review_due_reason precis : high_risk, slice_budget_reached, passive, under_budget ou already_reviewed. Quand une review est due, il renvoie aussi next_transition avec l'invocation exacte de review status --next-transition pour les memes selecteurs. L'orchestrateur execute cette commande telle quelle au lieu de reconstruire la regle depuis la prose.
Les roles de reviewer sur pi deviennent host-mediated. Go lancait auparavant pi --print --no-extensions lui-meme, ce qui ne voyait pas les providers enregistres par les extensions (Model not found) et supprimait les cles API de l'environnement. Desormais review status rend capture-refuter et capture-validation sous forme de --materialize=true plus un descripteur submission, et gentle-pi execute le modele in-process. L'adaptateur pi cote Go est supprime.
Le contexte du reviewer est maintenant borne AVANT que l'autorite n'existe. START ne verifiait que le plafond Git de 4 MiB, si bien qu'un candidate trop gros gelait l'autorite puis faisait echouer chaque capture avec Prompt is too long. START prouve maintenant que l'evidence gelee tient dans un budget de 200 KiB par runtime pour chaque role avant de rien persister.
Breaking : l'integration RTK Community Tool est retiree de la surface active. Deux consequences : les presets existants ne selectionnent plus de community tools par defaut, et une selection RTK non supportee signale l'outil comme indisponible. Les binaires et configurations RTK sur disque ne sont pas touches.
Parmi les correctifs : un plafond de scrape size VictoriaMetrics (le 18/09 l'exposition /metrics a depasse 16 MiB en production et le dashboard runtime lisait 0), une retention dediee pour la table de dedup du collector, et le Gentle Logo qui configurait OpenCode sans qu'il soit selectionne.
v3.3.0 — L'integration OpenCode devient version-aware avec support V2 beta
Un minor avec une seule fonctionnalite, mais qui compte si vous utilisez OpenCode : le composant choisit desormais son comportement selon la version majeure rapportee par l'executable opencode installe. Les installations V2 obtiennent une gestion native de la config, des modeles et de MCP avec preservation ordonnee des permissions, un ensemble dedie de plugins V2 geres (telemetrie, catalog, registry, SDD et un relais de review opaque en staging), et un label OpenCode V2 (beta) dans la TUI.
Les installations V1 restent inchangees et les plugins communautaires non supportes sont refuses sur V2. Il s'agit d'une integration beta partielle testee contre le SDK 2.0.4 publie, pas d'une coexistence de premier plan avec opencode2. Les versions de runtime inconnues echouent fermees et la review native V2 reste indisponible.
Note d'honnetete des release notes : a la publication, la Windows Full Suite echoue sur ce commit dans TestOpenCodeV2CatalogAndRegistry. Le correctif arrive au release suivant.
v3.2.1 — Telemetrie runtime VictoriaMetrics et delegation obligatoire dans ODD
Premiere stable depuis v3.1.0. La telemetrie runtime est desormais exposee en compteurs Prometheus et stockee dans VictoriaMetrics avec retention illimitee au lieu de lignes SQLite brutes. Le deploy kit installe VictoriaMetrics, provisionne son datasource Grafana et fait le backfill des tables existantes.
Le point qui vous concerne cote orchestrateur : la delegation dans Organic Driven Development passe d'indicative a obligatoire. Une table de declencheurs choisit la route d'execution — mapping a partir de 4 fichiers, un writer a partir de 2 fichiers non triviaux, lectures de preparation deleguees avec l'ecriture — chaque tache declare sa route dans le feature document, et un garde-fou de session longue interrompt l'execution monolithique apres environ 20 appels d'outils, 5 lectures exploratoires ou 2 editions non mecaniques sans delegation.
Executez gentle-ai sync apres la mise a jour : les declencheurs vivent dans la guidance installee de l'orchestrateur.
Cote correctifs, le collector de telemetrie : base en WAL pour que les lecteurs read-only ne bloquent pas l'unique writer, maintenance quotidienne ancree a 00:05 UTC avec rattrapage au demarrage, et une base occupee rapporte storage_busy au lieu d'un storage_unavailable generique. Par ailleurs, la production keyait la limite de debit de chaque client sur le litteral (null) car le vhost rendait X-Forwarded-For depuis une variable d'environnement vide. Deux correctifs review : un target deja acquitte ne peut plus etre re-review, et le statut actif exige des assets geres a jour.