Memory Forest 0.2.0
Memory Forest 0.2.0
Memory Forest is a local-first protocol for structured, inspectable memory. Version 0.2.0 adds a bounded root-first retrieval contract while preserving the explicit body-access boundary.
Highlights
- Adds deterministic
retrieveoutput with validatedXLTM -> LTM -> MTM -> STMtrails. - Keeps retrieval metadata-only and never returns memory bodies through
retrieve. - Adds a strict query-only QueryPlan protocol for caller-supplied multilingual expansion.
- Preserves original-query-first ranking so untrusted probes cannot outrank a direct match.
- Defines a provider-neutral OAuth/API gateway boundary without embedding credentials or network access in the local core.
- Adds English and Korean documentation, a fictional multi-domain fixture, multiscript tests, and a derived retrieval diagram.
Compatibility
- Canonical forest schema remains version 1.
- Existing
routeandsearchbehavior remains compatible after rebuilding the derived index. - The local index advances to schema 2 and older indexes must be rebuilt with
memory-forest index ROOT.
Verification
- 46 tests pass.
- Public release audit passes for 67 files with zero findings.
- CI passes on macOS and Ubuntu across Python 3.11 through 3.14.
- Release wheel SHA-256 is
576ecd22925213695d0a8eec28881203cfa9d7e0261dc6a2e9f7de8a84189383.
Important boundary
This release performs bounded lexical ranking and materializes a root-first canonical trail. It does not claim universal semantic or cross-language retrieval. Language bridging depends on caller-provided, validated query probes.