v1.15.7 — Fix de legacy local sync import con sesiones huérfanas
Patch que resuelve el bug donde engram sync --import se trababa con dependencias huérfanas de prompts/observaciones en exports legacy de .engram/chunks mal formados — antes fallaba para siempre con un foreign key error.
Ahora el import escanea los chunks del manifest en busca de upserts reales de sesión antes de declarar la dependencia como faltante. Si la sesión no aparece ni en la DB local ni en ningún chunk, sintetiza un stub determinista marcado (recovered-missing-session). El comportamiento dependency-safe entre chunks se mantiene: las sesiones reales siempre ganan sobre los stubs recuperados.
v1.15.6 — Hardening de startup repair en Engram Cloud
Patch que blinda el startup repair de Engram Cloud contra schemas productivos viejos y filas de mutation históricas inválidas. Antes engram cloud serve caía en restart loops durante la materialización automática de mutations.
Ahora los backfills de migración de chunks legacy solo referencian columnas legacy si existen en el schema activo, y la repair de materialización reporta invalid_mutations y saltea filas históricas inválidas en vez de fallar todo el repair. Validado en VPS de HostGator con health OK y dashboard 200.
v1.15.5 — Recovery parity para mutation-backed state
Patch que cierra el gap de recovery parity en cloud: estado actual mutation-backed que se veía en cloud/dashboard pero faltaba al recuperar desde chunks/manifest fresco. Ojo con esto si dependés de fresh recovery — antes te perdías sesiones, observaciones y prompts entrados por la mutation path.
Ahora los pushes de mutation aceptados también crean payloads compatibles en cloud_chunks, y engram cloud serve materializa al startup las mutation-only rows existentes para cada ENGRAM_CLOUD_ALLOWED_PROJECTS. También se agrega el comando explícito engram cloud repair materialize-mutations --project <project> (--dry-run|--apply) para verificación manual y re-runs.
v1.25.6 — Guía multi-page del codebase + docs de agentes
Patch enfocado en docs: nueva guía definitiva en inglés del codebase para mantenedores y contributors en docs/CODEBASE-GUIDE.md, con páginas focalizadas bajo docs/codebase/.
También actualiza la documentación de agentes soportados (Kilo Code, Kimi Code, Kiro IDE, Cursor y comportamiento de overlay OpenCode/Kilo), alinea conteos, nombres, paths y flags readonly con los assets fuente, y suma .engram/engram.db y .engram/cloud.json al gitignore como runtime state local. Timeouts E2E extendidos para tolerar mirrors lentos en CI Linux.
v1.25.5 — Chained PRs target parent + bounded E2E timeouts
Patch que ajusta la guía de chained PRs para que los child PRs apunten al branch parent inmediato en vez del branch tracker, y refresca el lenguaje de SDD chain planning para que los review diffs queden focalizados y los child PRs nunca apunten directo a main.
También actualiza las expectativas del E2E skill bundle para el set ampliado de foundation skills, y agrega timeouts bornados al E2E para que el CI Docker no cuelgue indefinidamente sin diagnóstico. Verificado con 466 tests pasados, 0 fallos en Ubuntu/Arch/Fedora.
v1.15.7 — Legacy local sync import fix with orphan sessions
Patch fixing the bug where engram sync --import stalled on orphan prompt/observation dependencies in malformed legacy .engram/chunks exports — previously failing forever with a foreign key error.
Now the import scans manifest chunks for real session upserts before declaring a dependency truly missing. If the session is absent from both the local DB and every chunk, it synthesizes a deterministic stub flagged (recovered-missing-session). Cross-chunk dependency-safe behavior is preserved: real session chunks still win over recovered stubs.
v1.15.6 — Engram Cloud startup repair hardening
Patch hardening Engram Cloud startup repair against production schemas and historical invalid mutation rows. Previously engram cloud serve hit restart loops during automatic mutation materialization.
Legacy cloud chunk migration backfills now only reference legacy columns when they exist in the active schema, and mutation materialization repair reports invalid_mutations and skips invalid historical rows instead of failing the whole repair. Validated on the HostGator VPS with cloud health OK and dashboard HTTP 200.
v1.15.5 — Recovery parity for mutation-backed state
Patch closing the cloud recovery parity gap: mutation-backed current state visible in cloud/dashboard but missing from fresh chunk/manifest recovery. Watch this one if you rely on fresh recovery — before, you were losing sessions, observations and prompts that arrived through the mutation path.
Now accepted mutation pushes also create compatible payloads in cloud_chunks, and engram cloud serve materializes existing mutation-only rows at startup for each ENGRAM_CLOUD_ALLOWED_PROJECTS entry. Adds the explicit engram cloud repair materialize-mutations --project <project> (--dry-run|--apply) command for operator verification and re-runs.
v1.25.6 — Multi-page codebase guide + agent docs
Docs-focused patch: new definitive English codebase guide for maintainers and contributors at docs/CODEBASE-GUIDE.md, with focused pages under docs/codebase/.
Also updates supported-agent documentation (Kilo Code, Kimi Code, Kiro IDE, Cursor and OpenCode/Kilo overlay behavior), aligns counts, names, paths and readonly flags with source assets, and adds .engram/engram.db and .engram/cloud.json to gitignore as local runtime state. E2E CI timeouts extended to tolerate slow Linux package mirrors.
v1.25.5 — Chained PRs target parent + bounded E2E timeouts
Patch fixing chained PR guidance so child PRs target the immediate parent branch instead of the tracker branch, and refreshing SDD chain planning language so review diffs stay focused and child PRs never target main directly.
Also updates E2E skill bundle expectations for the expanded foundation skill set, and adds bounded E2E timeouts so Docker-based CI cannot hang indefinitely without diagnostics. Verified with 466 tests passed, 0 failures across Ubuntu/Arch/Fedora.
v1.15.7 — Correctif import local sync legacy avec sessions orphelines
Patch corrigeant le bug où engram sync --import bloquait sur des dépendances orphelines de prompts/observations dans des exports legacy .engram/chunks malformés — auparavant cela échouait pour toujours avec une erreur de foreign key.
L'import scanne maintenant les chunks du manifest pour de vrais upserts de session avant de déclarer une dépendance manquante. Si la session est absente de la DB locale et de tous les chunks, il synthétise un stub déterministe marqué (recovered-missing-session). Le comportement dependency-safe entre chunks est préservé.
v1.15.6 — Durcissement du startup repair Engram Cloud
Patch durcissant le startup repair d'Engram Cloud contre les schémas de production et les lignes de mutation historiques invalides. Auparavant engram cloud serve tombait en boucles de restart pendant la matérialisation automatique des mutations.
Les backfills de migration de chunks legacy ne référencent maintenant les colonnes legacy que si elles existent dans le schéma actif, et la repair de matérialisation rapporte invalid_mutations et saute les lignes invalides au lieu de tout faire échouer.
v1.15.5 — Parité de récupération pour l'état mutation-backed
Patch fermant le gap de parité de récupération cloud : l'état mutation-backed visible dans cloud/dashboard mais manquant lors de la récupération fraîche depuis chunks/manifest.
Les pushes de mutation acceptés créent maintenant aussi des payloads compatibles dans cloud_chunks, et engram cloud serve matérialise au startup les lignes mutation-only existantes pour chaque entrée ENGRAM_CLOUD_ALLOWED_PROJECTS. Ajoute la commande explicite engram cloud repair materialize-mutations --project <project> (--dry-run|--apply).
v1.25.6 — Guide multi-pages du codebase + docs agents
Patch focalisé docs : nouveau guide de référence anglais du codebase pour les mainteneurs et contributeurs dans docs/CODEBASE-GUIDE.md, avec des pages dédiées sous docs/codebase/.
Met aussi à jour la documentation des agents supportés (Kilo Code, Kimi Code, Kiro IDE, Cursor et comportement overlay OpenCode/Kilo), aligne comptes, noms, chemins et flags readonly avec les assets source, et ajoute .engram/engram.db et .engram/cloud.json au gitignore.
v1.25.5 — PRs chaînés ciblent le parent + timeouts E2E bornés
Patch ajustant la guidance des chained PRs pour que les child PRs ciblent la branche parent immédiate au lieu de la branche tracker, et rafraîchissant le langage du SDD chain planning pour que les diffs de review restent focalisés.
Met aussi à jour les attentes du E2E skill bundle pour le set foundation élargi, et ajoute des timeouts bornés au E2E pour que le CI Docker ne puisse pas rester bloqué indéfiniment. Vérifié avec 466 tests passés, 0 échecs sur Ubuntu/Arch/Fedora.