Skip to content

Tree Ring Memory v0.13.0

Latest
Latest

Choose a tag to compare

View all tags
@TerminallyLazy TerminallyLazy released this 23 Jul 21:07
v0.13.0
167bc65
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Tree Ring Memory v0.13.0

Tree Ring Memory v0.13.0 adds a bounded same-host multi-agent contract and an
optional coordinator policy for shared publication and lifecycle changes.

What Ships

  • Agent, workflow, session, operation, and source correlation through the Rust
    API and CLI.
  • Exact-retry idempotency with conflict detection.
  • Real multi-process acceptance coverage with eight concurrent CLI workers.
  • Opt-in Coordinated mode: ordinary workers can create only matching
    non-heartwood agent-scoped memory.
  • Coordinator-only shared/non-agent writes, heartwood, import, persisted
    adapters and consolidation, lifecycle changes, and applied maintenance.
  • One-time coordinator capabilities supplied only through
    TREE_RING_COORDINATOR_TOKEN, stored as hashes, and blocked from memory and
    audit/status metadata.
  • Transactional protected-write audit records with unsafe targets hashed and
    terminal-safe human output.
  • SQLite schema v3 with forward-version rejection and a fence for memory
    inserts, updates, and deletes from old writers.
  • Read-only policy status and audit commands that never create or migrate a
    store.
  • Agent-aware TUI writes and visible, nonfatal authorization denials.

Supported Boundary

The concurrency and authorization evidence covers cooperative Tree Ring Rust
and CLI processes sharing a SQLite store on one host and a local filesystem. It
does not establish a read ACL, cross-host coordination, network-filesystem
safety, or protection from an adversary who controls the database files or
process environment.

Upgrade From v0.12

Schema v3 is a coordinated upgrade:

  1. Stop every Tree Ring CLI, TUI, plugin, and bundled worker using the root.
  2. Checkpoint SQLite WAL state and make a verified complete store backup.
  3. Upgrade every CLI, plugin, and bundled worker to a v0.13-compatible build.
  4. Reopen the root with v0.13 to migrate it.

Do not run v0.12 against an upgraded store. Memory inserts, updates, and deletes
from old writers are fenced; all mixed-version operation is unsupported,
including older maintenance. Roll back only by stopping all processes and
restoring the complete pre-upgrade backup.

Install

Source install (requires Rust and Cargo):

curl -fsSL https://raw.githubusercontent.com/TerminallyLazy/Tree-Ring-Memory/main/install.sh | sh

Linux x86_64 prebuilt install (glibc 2.36 or newer):

curl -fsSL https://raw.githubusercontent.com/TerminallyLazy/Tree-Ring-Memory/main/install.sh | sh -s -- \
  --archive-url https://github.com/TerminallyLazy/Tree-Ring-Memory/releases/download/v0.13.0/tree-ring-memory-0.13.0-linux-x86_64.tar.gz \
  --archive-sha256 76966ec89990c0d10ab933733b1d0f601beec343cb90b64ee7f0655672b10a6a

The Homebrew formula is pinned to the verified v0.13.0 macOS ARM64 artifact.

Binary Compatibility

  • macOS ARM64 archive SHA-256:
    24305a4045732db4755b72b8f7a453ebfb6178394bd1bdd26671dd8121ac0dcd
  • Linux x86_64 archive SHA-256:
    76966ec89990c0d10ab933733b1d0f601beec343cb90b64ee7f0655672b10a6a
  • The Linux archive is built and smoke-tested on Debian Bookworm (glibc 2.36).
    Systems with an older glibc must build from source.

Verify

tree-ring --version
tree-ring policy --help

Expected version: tree-ring 0.13.0.

Assets 6
Loading