v0.4.0 — Maintenance mode: git snapshots + doctor + fool-proof install

The maturity release

agentbrain is now feature-complete for its core promise — a local, token-efficient, agent-shared long-term memory that you own as plain Markdown — and enters maintenance mode (bug fixes and compatibility only).

Git snapshots — point-in-time recovery for your memory

Every vault is now its own git repository (created automatically by agentbrain init, with repo-local identity — your global git config is never touched). Every content write is an auto-commit:

• memory_ingest → ingest: case-x-lesson-01
• agentbrain apply → apply: <proposal>
• lint / distill proposals, profile suggestions, index rebuilds — all committed

Any bad edit — yours, an agent's, or Obsidian's — rolls back with plain git. Query-driven use_count bumps deliberately ride along with the next content commit to keep history readable. Everything degrades gracefully: no git installed → snapshots silently disabled, zero impact.

agentbrain doctor — one command, whole picture

agentbrain 0.4.0 · Python 3.10.11
vault: C:\Users\you\agentbrain
lessons: 15 active
index: fresh
lock: acquire/release ok
snapshot: enabled · last: Fri Aug 21 16:14:17 2026 — index: rebuild
log: 18 entries

Everything looks healthy.

Plus a copy-paste MCP client config with your vault path already filled in (JSON-escaped on Windows).

Fool-proof install

README now opens with a 3-step quickstart: pip install agentbrain → agentbrain init → paste one JSON block into any MCP client. That's the whole setup.

Verification

• 74 tests (9 new: snapshot lifecycle, no-git / no-repo graceful paths, doctor healthy & stale-index detection, apply/init/suggest auto-commits)
• Wheel + sdist built, twine check PASSED (PyPI-ready)
• Live MCP stdio smoke: 6 tools + 3 resources, ingest auto-commits to the vault git history

PyPI publication is the remaining step — issue tracker open for bug reports.