Skip to content

GoneBy v1.0.0

Choose a tag to compare

@rahlquist rahlquist released this 11 Nov 17:35
· 31 commits to main since this release

GoneBy v1.0.0 — first stable release

Retroactive project memory for LLM agents: capture everything cheaply now,
learn what actually mattered at project close, remember it forever.

What's in this release

Core pipeline (all four phases)

  • Encrypted per-project write-ahead log — ChaCha20-Poly1305, per-entry nonce,
    append-only, corruption-tolerant reads
  • Backward walk: retrospective filtering judged against the shipped product —
    verification, not prediction. Fails open; an unparseable judge never
    destroys evidence
  • Embed + vector store with content-hash IDs: idempotent re-indexing,
    Matryoshka truncation (1024→512 default) with unit-normalized storage
  • Semantic retrieval, project-scoped by default, cross-project opt-in

Integration surfaces

  • Hermes plugin: automatic per-turn capture via pre_llm_call, per-project
    WAL naming resolved from session context (git repo root), recall injection
    (opt-in), /goneby slash command, 7 agent tools, coexists with any memory
    provider
  • MCP server (goneby serve) — any MCP client, no Hermes required; dual
    support for mcp SDK 1.x and 2.x
  • CLI: generate-key, append, read, status, serve, project,
    mode, platform, gate

Capture policy — full user control

  • Default: capture on everywhere
  • Master gate, per-gateway platform kills (e.g. a Telegram gateway),
    per-project .goneby.json markers, personal user overrides, and a global
    opt-in mode for disable-by-default operation
  • Everything persisted in ~/.goneby/config.json; status surfaces the
    effective verdict and why

Verified

  • 158 tests pass (WAL crypto, store, scoping, walk, policy decision table,
    plugin surface against a fake Hermes ctx, CLI, state.db resolution)
  • scripts/smoke_test.py proves a live stack end-to-end: embedder reach,
    real-model ranking (related/unrelated cosine 0.67/0.25 with
    Qwen3-Embedding-0.6B Q8_0 on llama.cpp), store round trip, project
    isolation, WAL ciphertext-at-rest — with full cleanup
  • ruff clean; secret scan across all tracked files: zero hits

Docs

  • docs/SETUP.md — full stack from zero: library, key, llama.cpp acquisition
    • model URL, serve/verify commands, valkey or Qdrant, MCP client config,
      Hermes plugin install, troubleshooting table
  • docs/OVERVIEW.md — mechanism, benefits, every option, honest limits
  • docs/architecture.png / .html — the four-phase diagram

Install

git clone https://github.com/rahlquist/goneby && cd goneby
uv venv .venv && uv pip install --python .venv/bin/python -e ".[mcp,valkey]"

Or pip the attached wheel: pip install goneby-1.0.0-py3-none-any.whl[mcp,valkey]
(sdist also attached). Full instructions: docs/SETUP.md.