v1.15.12

Gentleman-Programming/engramv1.15.12May 14, 2026by github-actions[bot]

Upgrading?

Release notes summary

Focuses on agent reliability, introducing `engram setup pi`, safer MCP project selection, and autosync safety checks.

Key Highlights

  • `engram setup pi` is now a one-command installation
  • MCP project overrides work for hosted agents
  • Autosync acks are validated before acking local mutations

New Features

  • One-command Pi setup
  • MCP project override for hosted agents
  • Autosync validation
  • Cloud relation mutations unblock sync
  • Claude/OpenCode save nudges restored

Full Release Notes

Engram v1.15.12 focuses on agent reliability: Pi setup is now first-class, MCP project selection is safer for long-lived hosts, cloud sync validates persistence before acking, and plugin memory flows survive compaction with clearer UI.

## Highlights

- **Pi setup is now one command**: `engram setup pi` installs `gentle-engram`, installs `pi-mcp-adapter`, and writes Pi MCP config without overwriting an existing Engram server.
- **MCP project overrides work for hosted agents**: `engram mcp --project <name>` and `ENGRAM_PROJECT` are trusted process-level defaults for current-project, read, and write resolution while keeping explicit per-call validation strict.
- **Autosync acks are safer**: Engram now validates cloud `accepted_seqs` before acking local mutations, preventing local data from being marked synced when the server did not confirm the whole batch.
- **Claude/OpenCode save nudges are restored**: compatibility endpoints for latest observations and session lookup now match existing plugin hook behavior.
- **Cloud relation mutations unblock sync**: `relation/upsert` mutations are accepted, canonicalized, validated, and retained in cloud mutation chunks.

## Contribution highlights

Thanks to the issue reports that shaped this release:

- @yvolchkov and @ardelperal helped tighten the setup path with `engram setup pi` and the OpenCode auto-start copy.
- @deliriumlabs flagged the broken save-nudge hook, which led to the restored observation/session compatibility endpoints.
- @AshrafAKRahman reported the `mem_save` content-loss bug, now fixed with stricter validation and backward-compatible payload handling.
- @alexandervazquez98 and @quirozino surfaced the autosync ack safety gap, now guarded by accepted-seq validation.
- @ricardoarz-dev, @aleka, and @samuelcooke-cpu drove the MCP project override work for long-lived agent hosts.
- @parraletz helped unblock cloud relation mutation sync, with @IrrealV and @forNerzul surfacing adjacent repair/local-sync follow-up areas.
- @gabrielizalo helped identify an external OpenCode TUI plugin failure mode and clarify the recovery path.

## Pi companion updates

- Published `gentle-engram@0.1.4`.
- Added compact memory tool chrome for Pi memory calls.
- Added private-block redaction and compaction recovery helpers.
- Kept Engram-specific memory UI in `gentle-engram`, not in core Pi.

## Fixes included

- `mem_save` now preserves observation content and accepts the backward-compatible `observation` alias while rejecting empty saves.
- Claude Code plugin context no longer includes bilingual trigger noise.
- OpenCode setup no longer tells users to manually run `engram serve &`; the plugin auto-starts the HTTP server when needed.

## Changelog

- #372 `chore(pi): release v0.1.4`
- #370 `feat(pi): add compact memory tool chrome`
- #368 `feat(pi): add compaction recovery redaction`
- #376 `feat(setup): add pi integration setup`
- #374 `fix(mcp): preserve mem_save observation content`
- #378 `fix(mcp): trust process project override`
- #373 `fix(plugin): remove bilingual triggers from claude-code session context`
- #377 `fix(server): add observations compatibility endpoint`
- #379 `fix(sync): accept cloud relation mutations`
- #375 `fix(sync): validate autosync accepted seqs`

Related Repositories