v1.15.1 v1.15.2

Name: engram
Author: Gentleman-Programming

medium risk

Gentleman-Programming/engramApr 30, 2026 → May 3, 20262 days between releases

What's New

Adds safe recovery for ambiguous directories and strict project validation in MCP tools

Breaking Changes

Strict project validation now rejects normalized collisions like 'foo-bar' matching 'foo--bar'

New Features

Safe recovery mechanism for ambiguous project directories requiring user selection
Strict project validation to prevent normalized collisions

Improvements

Improved error messages for invalid project choices
Documentation for agent setup flow

Bug Fixes

Fixed `ambiguous_project` errors to allow retry with user-selected project
Corrected project metadata reporting to include 'project_source'

Upgrade Notes

Users must ensure project names match exactly after whitespace trimming to avoid validation errors. The MCP tools now require explicit user selection when starting from ambiguous directories. Check error types for `invalid_project_choice` when upgrading.

The Two Releases

v1.15.1

Apr 30, 2026· 6 months ago

This patch fixes local import reliability, implements canonical project write locking, and stabilizes TUI ordering for sessions and observations.

Full release notes

v1.15.2

May 3, 2026· 6 months ago

Engram now provides a safe recovery path when MCP write tools start from an ambiguous parent directory with multiple repositories, requiring user selection.

Full release notes