MIND-Mem Development
Package
- PyPI:
pip install mind-mem
- Source layout:
src/mind_mem/
- Tests: pytest, 3610 passing
- CI: GitHub Actions, 3 OS × 4 Python versions (16 matrix jobs)
Architecture
- BM25F retrieval with Porter stemming + RM3 query expansion
- Hybrid BM25+Vector search with RRF fusion (sqlite-vec)
- A-MEM block metadata evolution
- 9-type intent router with adaptive confidence weights
- ConnectionManager: thread-safe SQLite pool with WAL
- BlockStore protocol: decoupled block access
- Delta-based snapshot rollback
MCP Server (81 tools)
Grouped surfaces (full list in docs/api-reference.md and
src/mind_mem/mcp_server.py):
recall, hybrid_search, prefetch, propose_update, approve_apply,
rollback_proposal, scan, list_contradictions, reindex, index_stats,
create_snapshot, list_snapshots, restore_snapshot, briefing,
category_summary, cross_encoder_rerank, find_similar,
memory_evolution, delete_memory, export_memory, import_memory,
intent_classify, retrieval_diagnostics, get_mind_kernel,
list_mind_kernels, verify_chain, audit_replay, tier_decay_apply,
encrypt_status, alerts_subscribe, and more (57 total).
Key Files
src/mind_mem/mcp_server.py — MCP server (57 @mcp.tool entries)src/mind_mem/retrieval/ — search engine (bm25, vector, hybrid)src/mind_mem/governance/ — contradiction detection, drift analysissrc/mind_mem/blocks/ — block store, parser, evolutiontests/ — comprehensive test suite
Conventions
- Python 3.10+, type hints everywhere
- Docstrings: Google style
- No dynamic allocation in hot paths
- All SQL queries parameterized
- Config: mind-mem.json (not mem-os.json)
- Auth header: X-MindMem-Token
Source: star-ga/mind-mem — distributed by TomeVault.
1---2name: mind-mem-development3description: MIND-Mem Python development guide Use when this capability is needed.4---56# MIND-Mem Development78## Package9- PyPI: `pip install mind-mem`10- Source layout: `src/mind_mem/`11- Tests: pytest, 3610 passing12- CI: GitHub Actions, 3 OS × 4 Python versions (16 matrix jobs)1314## Architecture15- BM25F retrieval with Porter stemming + RM3 query expansion16- Hybrid BM25+Vector search with RRF fusion (sqlite-vec)17- A-MEM block metadata evolution18- 9-type intent router with adaptive confidence weights19- ConnectionManager: thread-safe SQLite pool with WAL20- BlockStore protocol: decoupled block access21- Delta-based snapshot rollback2223## MCP Server (81 tools)24Grouped surfaces (full list in `docs/api-reference.md` and25`src/mind_mem/mcp_server.py`):26recall, hybrid_search, prefetch, propose_update, approve_apply,27rollback_proposal, scan, list_contradictions, reindex, index_stats,28create_snapshot, list_snapshots, restore_snapshot, briefing,29category_summary, cross_encoder_rerank, find_similar,30memory_evolution, delete_memory, export_memory, import_memory,31intent_classify, retrieval_diagnostics, get_mind_kernel,32list_mind_kernels, verify_chain, audit_replay, tier_decay_apply,33encrypt_status, alerts_subscribe, and more (57 total).3435## Key Files36- `src/mind_mem/mcp_server.py` — MCP server (57 @mcp.tool entries)37- `src/mind_mem/retrieval/` — search engine (bm25, vector, hybrid)38- `src/mind_mem/governance/` — contradiction detection, drift analysis39- `src/mind_mem/blocks/` — block store, parser, evolution40- `tests/` — comprehensive test suite4142## Conventions43- Python 3.10+, type hints everywhere44- Docstrings: Google style45- No dynamic allocation in hot paths46- All SQL queries parameterized47- Config: mind-mem.json (not mem-os.json)48- Auth header: X-MindMem-Token4950---51> Source: [star-ga/mind-mem](https://github.com/star-ga/mind-mem) — distributed by [TomeVault](https://tomevault.io).52<!-- tomevault:4.0:skill_md:2026-05-22 -->
