mind-mem-developmentlisted
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