v3.1.0 — Historial de versiones de observaciones
Minor que te guarda la historia: cada upsert o update por topic_key ahora deja un snapshot, y mem_get_observation acepta include_history opt-in, con páginas de hasta 50 snapshots y history_cursor para seguir paginando. Ojo: la historia no se reconstruye para atrás, arranca desde que actualizás.
- Visibilidad del dashboard managed alineada con los grants de proyecto, incluso con nombres con espacios o
%. - El binding inicial de proyecto Git ya no adopta en silencio un scope distinto si hay evidencia histórica que choca.
- Publicación atómica de archivos de identidad en Linux sin hard links.
- Reparación de payloads de sync sin título y un servidor que se frena solo cuando detecta invalidación permanente de la generación de la base.
Antes de bumpear: backupeá la base y la config, y reiniciá los servidores y procesos MCP que tengas corriendo. No sale un gentle-engram nuevo en npm (sigue en 0.2.0).
v3.0.0 — expected_project obligatorio, módulo /v3 y OpenCode 2.x
Catch-up: esta major salió el 1 de octubre y no había entrado en ningún brief. Rompe tres cosas que tenés que mirar:
- Todo update y delete de observaciones exige un
expected_projectexplícito. - El módulo Go pasa a
github.com/Gentleman-Programming/engram/v3; actualizá tusgo install. - Claude Code, Codex y OpenCode confirman el registro de la sesión del host antes de bindear escrituras, y rechazan sesiones terminadas o que no coinciden.
Además: soporte OpenCode 2.x con un entrypoint dual, POST /sessions con resume: true que crea continuaciones :resume:N en vez de reabrir sesiones cerradas, engram projects merge con --dry-run/--apply, y nuevos chequeos de engram doctor para relaciones huérfanas y prompts vacíos legacy. engram setup codex deja de pisar las instrucciones built-in de Codex.
pi-v0.2.0 — gentle-engram 0.2.0 para Pi
Catch-up del 1 de octubre, el paquete Pi que acompaña a la v3.0.0 del core. Breaking: mem_update y mem_delete nativos de Pi exigen expected_project.
pi-engram initya no crea un registro MCP de Engram ni instalapi-mcp-adapter(Pi 0.99.0+ trae MCP built-in).- El arranque deja de importar en silencio los chunks de
.engram/manifest.jsonde un repo clonado; corréengram sync --importa mano. mem_contextaceptamax_bytes(tope 64 KiB) ycompact; la captura automática redacta bloques<private>.
Necesita Engram v3.0.0 o superior. Instalalo con pi install npm:[email protected] y reiniciá Pi.
v4.0.0 — ODD como único workflow y módulo /v4
Catch-up: la major salió el 1 de octubre y se nos había pasado. El cambio grande es de filosofía: Organic Driven Development (ODD) queda como el único workflow, y SDD y OpenSpec se retiran. La review nativa (RDD) y el test-first siguen; el TDD estricto ya viene por defecto. Las keys de SDD persistidas y tus archivos instalados se preservan.
- Módulo Go a
github.com/gentleman-programming/gentle-ai/v4; los instaladores derivan el/vNde la versión que instalan en vez de usar@latest. - OpenCode V2: plugins managed sobre
@opencode/plugin, provisión del SDK 2.0.4 con consentimiento aparte y review nativa (probada sólo en OpenCode 2.0.19 sobre macOS). - Pi usa su MCP built-in: se deja de provisionar
pi-mcp-adaptery sync migramcp-adapter.jsonamcp.json. Ojo si tenés Pi anterior a 0.99.0: perdés los servidores MCP hasta actualizar.
El contrato del provider sigue en 1.2.0.
v3.1.0 — Observation version history
Minor release that keeps history: every topic_key upsert or update now records a snapshot, and mem_get_observation accepts an opt-in include_history, paging up to 50 prior snapshots with a history_cursor. History is not reconstructed retroactively; it starts when you upgrade.
- Managed dashboard visibility aligned with project grants, including names with spaces or literal
%. - Initial Git project binding no longer silently adopts a different scope when historical directory evidence conflicts.
- Atomic identity-file publishing on Linux without hard-link support.
- Repair of titleless queued sync payloads, and a server that stops after permanent database-generation invalidation.
Before upgrading: back up the database and config, then restart long-running Engram servers and MCP processes. No new gentle-engram npm package ships with this tag (npm stays at 0.2.0).
v3.0.0 — Mandatory expected_project, /v3 module and OpenCode 2.x
Catch-up: this major shipped on October 1 and was not covered by any earlier brief. Three breaking changes to check:
- Every observation update and delete requires an explicit
expected_project. - The Go module moves to
github.com/Gentleman-Programming/engram/v3; update yourgo installpaths. - Claude Code, Codex and OpenCode confirm host-session registration before binding writes, and deny ended or mismatched sessions.
Also: OpenCode 2.x support through a dual-major entrypoint, POST /sessions with resume: true creating :resume:N continuations instead of reopening ended sessions, engram projects merge with --dry-run/--apply, and new engram doctor checks for orphaned relations and legacy empty prompts. engram setup codex no longer overrides Codex's built-in instructions.
pi-v0.2.0 — gentle-engram 0.2.0 for Pi
Catch-up from October 1: the Pi package paired with core v3.0.0. Breaking: Pi-native mem_update and mem_delete require expected_project.
pi-engram initno longer creates an Engram MCP registration or installspi-mcp-adapter(Pi 0.99.0+ ships built-in MCP).- Startup no longer silently imports tracked
.engram/manifest.jsonchunks from a cloned repo; runengram sync --importyourself. mem_contextacceptsmax_bytes(capped at 64 KiB) andcompact; automatic capture redacts<private>blocks.
Requires Engram v3.0.0 or later. Install with pi install npm:[email protected] and restart Pi.
v4.0.0 — ODD as the only workflow and /v4 module
Catch-up: this major shipped on October 1 and slipped past earlier briefs. The headline is a workflow shift: Organic Driven Development (ODD) becomes the only development workflow, and SDD and OpenSpec retire. Native review (RDD) and test-first development stay; strict TDD guidance is now installed by default. Persisted SDD keys and user-owned installed files are preserved.
- Go module moves to
github.com/gentleman-programming/gentle-ai/v4; installers derive/vNfrom the version they install instead of using@latest. - OpenCode V2: managed plugins on
@opencode/plugin, SDK 2.0.4 provisioning behind a separate consent, and native review (proven only on OpenCode 2.0.19 on macOS). - Pi uses its built-in MCP:
pi-mcp-adapteris no longer provisioned and sync migratesmcp-adapter.jsonintomcp.json. Hosts older than Pi 0.99.0 lose MCP servers until upgraded.
The provider contract stays at 1.2.0.
v3.1.0 — Historique des versions d'observations
Version mineure qui conserve l'historique : chaque upsert ou mise à jour par topic_key enregistre désormais un snapshot, et mem_get_observation accepte l'option include_history, avec des pages de 50 snapshots et un history_cursor. L'historique n'est pas reconstruit rétroactivement.
- Visibilité du dashboard managé alignée sur les droits par projet.
- Le rattachement initial d'un projet Git n'adopte plus silencieusement un autre périmètre.
- Publication atomique des fichiers d'identité sous Linux sans hard links.
- Réparation des payloads de sync sans titre et arrêt du serveur après invalidation permanente de la base.
Avant la mise à jour : sauvegardez la base et la config, puis redémarrez les serveurs Engram et processus MCP. Pas de nouveau paquet npm gentle-engram (toujours 0.2.0).
v3.0.0 — expected_project obligatoire, module /v3 et OpenCode 2.x
Rattrapage : cette version majeure est sortie le 1er octobre sans figurer dans un brief. Trois changements cassants :
- Chaque mise à jour ou suppression d'observation exige un
expected_projectexplicite. - Le module Go passe à
github.com/Gentleman-Programming/engram/v3. - Claude Code, Codex et OpenCode confirment l'enregistrement de la session hôte avant toute écriture.
Aussi : support d'OpenCode 2.x, POST /sessions avec resume: true, engram projects merge avec --dry-run/--apply, et de nouveaux contrôles engram doctor.
pi-v0.2.0 — gentle-engram 0.2.0 pour Pi
Rattrapage du 1er octobre : le paquet Pi associé au core v3.0.0. Changement cassant : mem_update et mem_delete exigent expected_project.
pi-engram initne crée plus d'enregistrement MCP et n'installe pluspi-mcp-adapter.- Le démarrage n'importe plus silencieusement les chunks de
.engram/manifest.json. mem_contextacceptemax_bytesetcompact.
Nécessite Engram v3.0.0 ou plus. Installation : pi install npm:[email protected].
v4.0.0 — ODD comme seul workflow et module /v4
Rattrapage : cette version majeure est sortie le 1er octobre. Le changement principal : Organic Driven Development (ODD) devient le seul workflow, SDD et OpenSpec sont retirés. La review native (RDD) et le test-first restent ; le TDD strict est installé par défaut.
- Module Go déplacé vers
github.com/gentleman-programming/gentle-ai/v4. - OpenCode V2 : plugins managés, provisionnement du SDK 2.0.4 et review native (validée seulement sur OpenCode 2.0.19 sous macOS).
- Pi utilise son MCP intégré :
pi-mcp-adaptern'est plus installé. Les versions de Pi antérieures à 0.99.0 perdent leurs serveurs MCP.
Le contrat provider reste en 1.2.0.