Memory Genome Engine v0.1.3

Explicit memory versioning and cleanup

v0.1.3 adds an explicit append-and-supersede workflow and safe physical cleanup for durable facts and decisions.

• mge supersede <cell-id> <replacement> appends a replacement without rewriting sealed pages.
• MGE records a typed old-to-new relation; default recall returns the current version.
• mge compact is a non-mutating dry run that reports reclaimable memory.
• mge compact --apply physically removes confirmed superseded, deprecated, and rejected cells.
• --archive <path> can preserve a complete binary pre-prune store before deletion.
• Temporary cells are only pruned when an explicit --temporary-older-than-days policy is supplied.
• Compaction is available through CLI, TUI, mge_compact, Python, and TypeScript.

Safety and compatibility

• Untyped or ambiguous superseded cells are retained unless a valid replacement relation exists.
• Compaction uses a recoverable transaction and deep-validates the rebuilt store before committing it.
• Encrypted stores and optional archives remain encrypted; a wrong key is rejected.
• Integration schema is now version 6; JSON-RPC protocol version is unchanged.
• Existing manifests remain readable through backward-compatible defaults.
• Binary page format, page codec, MarkerGenome, recall modes, CandidatePageIndex API, and the hot -> checkpoint -> seal -> recall lifecycle are unchanged.
• MGE does not infer semantic contradictions automatically. The caller decides when one memory supersedes another.
• Physical pruning is not guaranteed secure erasure on SSDs, snapshots, backups, or copied stores.

Measured evidence

A deliberately garbage-heavy local fixture with 100 sealed cells, including 50 confirmed obsolete versions, measured:

Metric	Before	After
Store size	385,732 B	6,956 B
Cells	100	50
Pages	3	1

That fixture reclaimed 98.2%; it demonstrates physical removal and is not a universal storage ratio. All 50 retained current cells remained recallable and deep validation passed.

A/B synthetic checks against the prior v0.1.3 source showed ordinary Exact focused/broad recall within about 3% run variance, with no systematic recall regression.

Verification

• 219 workspace Rust tests and 24 development eval tests passed locally.
• Strict Clippy, rustdoc warnings, Rust 1.95 MSRV, and package-version synchronization passed.
• GitHub CI passed on Ubuntu, Windows, and macOS.
• Release archives were built for Linux x86-64, Windows x86-64, macOS x86-64, and macOS Apple Silicon.
• Archive installers passed in GitHub Actions on Ubuntu, Windows, and macOS.
• All four downloaded archives matched SHA256SUMS; the Windows archive reported mge 0.1.3 and exposed the new compaction command.

Install

Download the archive for your platform and verify it with SHA256SUMS, or use the checksum-verifying release installers documented in Quickstart.

Full changelog: v0.1.2...v0.1.3

Contact

For commercial integration, support, collaboration, and partnership inquiries: