Skip to content

Compartment 4.14.0

Latest

Choose a tag to compare

@github-actions github-actions released this 07 Nov 21:27
· 17 commits to main since this release

Compartment 4.14.0 upgrades associative memory recall and adds zero-effort encrypted vault backup and multi-machine merge across the macOS, Windows, and Linux GUIs and CLI — 100% offline, with zero network calls of any kind and zero plaintext ever touching disk.

Downloads

File For
Compartment-4.14.0.pkg macOS on Apple silicon, one click, with the menu bar app
Compartment-4.14.0.dmg macOS on Apple silicon, drag to Applications
Compartment-4.14.0-intel.pkg macOS on Intel, one click
Compartment-4.14.0-intel.dmg macOS on Intel, drag to Applications
compartment-4.14.0.mcpb Claude Desktop extension (attached a few minutes after publishing)
compartment-4.14.0-py3-none-any.whl pip and offline installs, any OS
compartment-4.14.0.tar.gz source
SHA256SUMS.txt checksums of all of the above
pipx install compartment && compartment init      # or: uv tool install compartment

What's New

One-Click Encrypted Backup & Lossless Multi-Machine Merge

  • One-click encrypted .vault backup in macOS, Windows, and Linux GUIs (Back up…) + CLI (compartment backup): Exports a verified FORMAT.md v1 encrypted image (NUCV, Argon2id + XChaCha20-Poly1305, Ed25519 manifest check when signed) while locked or unlocked, without prompting for a passphrase or writing plaintext to disk. Automatically strips any unacknowledged crashed journal tail, writes atomically at mode 0600 with fsync, and re-parses + SHA-256 verifies the finished file.
  • One-click lossless encrypted .vault merge in macOS, Windows, and Linux GUIs (Merge…) + CLI (compartment merge): Reconciles another machine's .vault backup strictly in RAM without modifying the backup file. Same-key backups merge with zero passphrase prompt; independent backups prompt via stdin only. Reuses stored vectors directly when model_sha256 matches (zero ONNX inference), re-embeds offline when models differ, skips duplicate starter memories in O(1), and merges affirmed timestamps, descriptive tags, importance, superseded_by tombstones, and relations.
  • Portable organic & graph JSONL (--organic-only, --include-relations): compartment export can exclude starter/pack records and include relations edges; compartment import restores relation edges, remaps src_id links, and preserves provenance.

Associative Recall & Multi-Project Relevance

  • 1-hop relation-graph spreading activation in search: Queries now probe indexed relations (rel_subject, rel_object, rel_src) within the caller's allowed namespaces and active [valid_from, valid_to] windows, surfacing memories linked via src_id, co-linked entities, or rare 1-hop neighbor entities even with zero lexical overlap — calibrated in log-probability space (W_GRAPH = 0.55) strictly below direct literal and saturated semantic matches.
  • Bidirectional camelCase / PascalCase ↔ snake_case identifier recall: FTS indexing and information_coverage match split and compound code identifiers in both directions (maxMemoryChars ↔ max_memory_chars ↔ max memory chars) without altering _tokens() or matching substrings inside ordinary words (key never matches keyboard).
  • Multi-query faceted search (queries): Vault.search and MCP memory_search accept optional decomposed queries: list[str], batch-embedding all facets in a single encoder/daemon pass (embed_queries) and fusing evidence by per-record maximum so multi-part prompts never dilute into one averaged vector.
  • Zero-config cross-OS git project context prior: Stores from the MCP server, CLI, and Claude hooks automatically detect normalized owner/repo slugs from .git/config (including worktrees and submodules, in pure Python with zero subprocesses) and apply a gentle ordering tie-break (W_PROJECT = 0.08) to fused scores when working inside the matching repository without inflating static membership floors.