← ClaudeAtlas

mind-mem-developmentlisted

MIND-Mem Python development guide
star-ga/mind-mem · ★ 8 · AI & Automation · score 78
Install: claude install-skill star-ga/mind-mem
# 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 analysis - `src/mind_mem/blocks/` — block store, parser, evolution - `tests/` — comprehensive test suite ## Conventions - Python 3.10+, t