Skip to content

v0.2.0 - Initial public release

Choose a tag to compare

View all tags
@GoVanAI GoVanAI released this 04 Jul 22:14
· 6 commits to main since this release
v0.2.0
51eb8d7

v0.2.0 — Initial public release

Solo learning build exploring graph-relational memory as an MCP substrate. This is the first public commit.

What's in this release

  • 27 MCP tools across 6 groups (SQL, Orient, Search, Write, Graph, Import)
  • 108 vitest tests across 9 files, ~500ms total runtime
  • Layered memory model: 5 layers (working, episodic, procedural, semantic, partner) with layer-aware synaptic decay
  • Graph layer: [[wikilink]] syntax, BM25 auto-linking, spreading activation, decay matrix with access-based exemption
  • SQLite substrate (better-sqlite3 + FTS5, porter stemmer, 2/3-char prefix)
  • One-shot v1 to v2 migration tool (memory_import_from_mem_sol)

Schema at a glance

  • memories — relational layer with summary, confidence, boost, lifecycle, importance
  • synapses — graph edges, 3 connection types (wikilink, bm25_auto, parent_child), weights 0.0 to 5.0
  • memory_tag — junction table (no JSON tags)
  • memories_fts — FTS5 mirror kept in sync by triggers
  • decay_matrix — per layer-pair + connection-type decay rates, wildcard fallback

Bootstrap

On first launch into an empty DB, 4 bootstrap entries document purpose, design philosophy, schema reference, and an example wikilink exercise. Searchable via memory_search after install.

Install

Clone the repo, install deps, and start the server locally:

git clone https://github.com/GoVanAI/mem-graph
cd mem-graph
npm install
npm start

See the README's Install section for the MCP client registration snippet (Claude Code, opencode, or any MCP-compatible client).

Not in scope (yet)

  • Production hardening or peer-validated benchmarks
  • Plugin marketplace wrapping (MCP server only)
  • Auto-link-on-read semantics (write-time BM25 only)
  • cwd to project binding
  • Entry versioning beyond the basic memory_supersede tool

License

MIT - Copyright (c) 2026 GoVanAI

Assets 2
Loading