Repository navigation
Engram v3.6.1
A core maintenance release focused on reliable memory synchronization, project attribution, Unicode handling, and local integration lifecycle fixes.
Highlights
- Safer deletion and synchronization: preserve soft deletes against stale local snapshots, stop re-journaling acknowledged hard-delete tombstones, enqueue sync mutations for isolated project-owned sessions, and bound legacy quarantine scanning (#2223, #2198, #2191, #2215).
- Search and Unicode: fold diacritics in trigram searches, preserve UTF-8 boundaries in passive observation titles, retain Unicode through Claude passive-capture stdin, and skip semantic pairs when snippet lookup fails (#2219, #2212, #2213, #2174).
- Project-scoped MCP context: attribute prompts using per-call workspace context and keep context-footer statistics within the effective project (#2218, #2217).
- Integration reliability: verify the local server identity before Claude write gating, capture SubagentHandback reports without reading transcripts, improve OpenCode identity-readiness diagnostics, and wait for the MCP stdio signal watcher during teardown (#2214, #2216, #2167, #2127).
- Windows and dashboard fixes: resolve curl without assuming a fixed Git installation layout, preserve Bash startup temporary-file lifetime, and refold only changed dashboard projects (#2162, #2199, #2220).
Verification and maintenance
This release also includes native Windows/macOS adapter test lanes, Linux race detection, PostgreSQL integration coverage, prerequisite-gated regression coverage, test-fixture lifecycle and performance improvements, and core-artifact lifecycle observation tooling. Contributor guidance and repository CI maintenance are included in the full changelog below.
The release commit passed all 19 jobs in push CI. The six staged binaries were checked against the candidate revision and manifest hashes. The release workflow completed successfully, including module metadata and published Pi companion checks. These checks do not claim an installed upgrade test in every environment.
Upgrade and release scope
-
This is Engram core v3.6.1. It reuses the existing pinned
gentle-engram@0.5.1companion. No new Pi npm version was published and the Pilatestchannel was not promoted as part of this release. Unreleased current-main Pi changes are not included in the existing npm package. -
Back up your Engram data and relevant configuration before upgrading; retain a known-good installation and validate your integrations afterward. See the release and rollback policy.
-
For existing Homebrew installations:
brew update brew upgrade engram engram version
-
Alternatively, download the archive for your OS and architecture below and verify it against
checksums.txt. Archives are available for macOS, Linux, and Windows on amd64 and arm64. See the installation guide.
Full changelog
- ff3c6a4 ci(postgres): execute database-backed integration suites (#2117)
- 85577ae ci: add full-suite Linux Go race detection (#2115)
- 02c7b41 docs(contributing): stage policy transition and compact PR guidance (#2125)
- 62374d4 docs(memory): align selective durable knowledge capture (#2128)
- f82c184 fix(mcp): wait for stdio signal watcher before teardown (#2127)
- 72e40df test(cli): reduce synthetic backup fixture lock wait (#2131)
- 7192931 fix(cloudstore): clean migration fixture before closing admin database (#2130)
- a5221de feat(release): observe owned Core artifact lifecycle (#2101)
- 523289f ci(policy): skip unrelated PR metadata evaluations (#2118)
- f15b94a fix(tools): respect Node prerequisites in artifact tests (#2135)
- 49a1c9d ci: close issues inactive for 3 weeks and their linked PRs (#2143)
- 29a4081 ci: preserve independently discovered technical contracts (#2151)
- 5f1aabe ci: bound verification jobs with accepted execution ceilings (#2153)
- 51bcdba ci(macos): add advisory native ARM64 source baseline (#2154)
- 9824739 ci(adapters): run existing source suites on native macOS ARM64 (#2161)
- 2ceda3c fix(plugin): resolve Windows curl without a fixed Git layout (#2162)
- 52cbdab fix(server): key caller host context test literals (#2168)
- a9bbeaa ci(windows): add observational full-module baseline wiring (#2156)
- ee1d5ad test(autosync): join runners before TLS fixture cleanup (#2171)
- b10056c fix(test): keep owned startup failure parent alive (#2173)
- cf7804b test(autosync): synchronize post-stop fixture startup (#2183)
- e89a6f3 fix(store): skip semantic pairs when snippet lookup fails (#2174)
- 322bedb test(sync): synchronize autosync fake-store pagination (#2189)
- 36c20bb fix(tests): isolate Codex session-end HTTP fixtures per case (#2178)
- a6f66c2 fix(opencode): diagnose local identity readiness failures (#2167)
- 7cf4ed2 ci(race): refresh compatible Go caches on trusted main (#2194)
- f616a7e perf(tests): reuse cached CLI for Windows prompt fixtures (#2195)
- 9b7afe3 fix(plugin): preserve Windows Bash startup temp lifetime (#2199)
- d1b5dcd perf(tests): reduce Codex fixture startup overhead (#2209)
- 366b729 fix(store): preserve UTF-8 boundaries in passive observation titles (#2212)
- b14b59b fix(store): enqueue sync mutations for isolated project-owned sessions (#2191)
- db23639 fix(claude): preserve passive capture Unicode through stdin (#2213)
- d7b6576 fix(sync): stop re-journaling acknowledged hard-delete tombstones on sync (#2198)
- 2b64002 fix(autosync): bound legacy quarantine scanning across cycles (#2215)
- 66258eb fix(claude): verify local server identity before write gating (#2214)
- b119630 fix(mcp): keep context footer statistics within the effective project (#2217)
- 23cf291 fix(mcp): attribute prompts using per-call workspace context (#2218)
- 41b08b5 fix(claude): capture SubagentHandback reports without reading transcripts (#2216)
- a536801 fix(store): fold diacritics in trigram memory searches (#2219)
- 34471bb fix(cloud): refold only changed dashboard projects (#2220)
- 3ead0c9 test(store): handle missing Windows symlink privilege (#2221)
- 99bd5b2 ci(coverage): exercise prerequisite-gated regressions (#2227)
- 24f43a1 fix(test): batch static handoff fixture path conversions (#2226)
- 27973b8 fix(store): preserve soft deletes against stale local snapshots (#2223)
- d33a14a ci: run existing Pi and OpenCode adapters on native Windows x64 (#2164)
Full comparison: v3.6.0...v3.6.1