Releases: hyungchulc/memory-forest
Release list
Memory Forest 0.3.0
Memory Forest 0.3.0 turns the public package into a stricter, provenance-bound local memory writer while keeping the core network-free and dependency-free at runtime.
Highlights:
- integrated Daily and Structured write paths with frozen plans, forest identity checks, locking, rollback, and bounded receipts;
- strict retrieval/query-plan boundaries with metadata-first, root-first trails;
- clearer automation, recovery, WSL2 portability, and public/private separation guidance;
- GPL-3.0-only licensing recorded consistently across release metadata.
Verification:
- 99 unit and regression tests passed;
- public-release audit reported 0 findings across 86 files;
- GitHub Actions passed on macOS and Ubuntu across Python 3.11-3.14;
- the release wheel was clean-installed with no dependencies and completed a synthetic init/validate lifecycle.
Wheel SHA-256:
8eda89d19b36645c7ef90e3aa379f4a04c1db28b34b784db46fc5f02fd7559cc
Important boundaries:
- This remains an alpha release.
- Legacy forests without
forest_idremain read-only until an explicit migration/adoption contract is implemented. - WSL2 guidance describes a conservative Linux-filesystem posture; it is not a native Windows ACL support claim.
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.
Memory Forest v0.1.0
Initial public release of Memory Forest.
Highlights:
- seven-layer local memory contract from Life Archive through ISTM
- private-by-default macOS and Linux CLI
- structural validation and required parent wikilink audit
- local SQLite FTS5 route and search index
- route-only output by default with explicit fresh body reads
- synthetic reference forest, privacy audit, documentation, and companion Codex skill
The release contains no private Aria memory, prompts, logs, automation, or user data. The v0.1 CLI uses flat bounded FTS candidate routing; root-first hierarchy traversal remains part of the documented full method and roadmap.