mempalace/CHANGELOG.md

Changelog

All notable changes to MemPalace are documented in this file.

---

[3.2.0] — 2026-04-13

Packaging

• Remove chromadb<0.7 upper bound — unblocks installs against chromadb 1.x palaces (#690)
• Bump version to 3.2.0 across pyproject.toml, mempalace/version.py, README badge, and OpenClaw SKILL (#761)

Security

• Harden palace deletion, WAL redaction, and MCP search input handling (#739)
• Consistent input validation, argument whitelisting, concurrency safety, and WAL fixes (#647)
• Remove hardcoded credential paths from benchmark runners (#177)
• Remove global SSL verification bypass in convomem_bench (#176)

Bug Fixes

• Parse Claude.ai privacy export with messages key and sender field (#685, #677)
• Detect mtime changes in _get_client to prevent stale HNSW index (#757)
• Hash full content in tool_add_drawer drawer ID — stable re-mines (#716)
• Remove 10k drawer cap from status display (#707, #603)
• Correct typo in entity_detector interactive classification prompt (#755)
• Prevent convo_miner from re-processing 0-chunk files on every run (#732, #654)
• Remove silent 8-line AI response truncation in convo_miner (#708, #692)
• Store full AI response in convo_miner exchange chunking (#695)
• Fix mine --dry-run TypeError on files with room=None (#687, #586)
• Skip arg whitelist for handlers accepting **kwargs (#684, #572)
• Allow Unicode in sanitize_name() — Latvian, CJK, Cyrillic (#683, #637)
• Auto-repair BLOB seq_ids from chromadb 0.6→1.5 migration (#664)
• Remove no-op ORT_DISABLE_COREML env var (#653, #397)
• Disambiguate hook block reasons to name MemPalace explicitly (#666)
• Use epsilon comparison for mtime to prevent unnecessary re-mining (#610)
• Correct token count estimate in compress summary (#609)
• Implement MCP ping health checks (#600)
• Align cmd_compress dict keys with compression_stats() return values (#569)
• Skip unreachable reparse points in detect_rooms_from_folders on Windows (#558)
• Prevent HNSW index bloat from duplicate add() calls (#544, #525)
• Purge stale drawers before re-mine to avoid hnswlib segfault (#544)
• Mitigate system prompt contamination in search queries (#385, #333)
• Count Codex user_message turns in _count_human_messages (#373, #347)
• Paginate large collection reads and surface errors in MCP tools (#371, #339, #338)
• Expand ~ in split command directory argument (#361)
• Ignore wait_for_previous argument to support Gemini MCP clients (#322)
• Close KnowledgeGraph SQLite connections in test fixtures (#450)
• Remove duplicate cache variable declarations in mcp_server.py (#449)
• Add --yes flag to init instructions for non-interactive use (#682, #534)
• Add mcp command with setup guidance (#315)

Documentation

• Fix misaligned architecture diagram (#734, #733)

New Features

• i18n support — 8 languages (en, es, fr, de, ja, ko, zh-CN, zh-TW) (#718)
• New MCP tools: get/list/update drawer, hook settings, export (#667, #635)
• mempalace migrate — recover palaces from different ChromaDB versions (#502)
• Add OpenClaw/ClawHub skill (#491)
• Backend seam for pluggable storage backends (#413)

Improvements

• Disable broken auto-bump workflow (#414)
• Improve agent readiness — AGENTS.md, dependabot, CODEOWNERS, labels (#497)

Documentation

• Add CLAUDE.md and mission/principles to AGENTS.md (#720)
• Add VitePress documentation site (#439)
• Add warning about fake MemPalace websites (#598)
• Fix stale org URLs and PR branch target in contributor docs (#679)
• Add ROADMAP.md — v3.1.1 stability patch and v4.0.0-alpha plan

Internal

• ruff format convo_miner.py (#741)
• ruff format all Python files (#675)
• CI: trigger tests on develop branch PRs and pushes (#674)
• CI: fix GitHub Pages publishing (#691)

---

[3.1.0] — 2026-04-09

Security

• Harden inputs, fix shell injection, optimize DB access (#387)
• Sanitize SESSION_ID in save hook to prevent path traversal (#141)
• Sanitize error responses and remove sys.exit from library code (#139)
• Shell injection fix in hooks, Claude Code mining, chromadb pin (#114)

Bug Fixes

• MCP null args hang, repair infinite recursion, OOM on large files (#399)
• Release ChromaDB handles before rmtree on Windows (#392)
• Use os.utime in mtime test for Windows compatibility (#392)
• Negotiate MCP protocol version instead of hardcoding (#324)
• Use upsert and deterministic IDs to prevent data stagnation (#140)
• Make drawer_id deterministic for idempotent writes (#387)
• Honest AAAK stats — word-based token estimator, lossy labels (#147)
• Room detection checks keywords against folder paths (#145)
• Use actual detected room in mine summary stats (#165)
• Honour --palace flag in mcp_server (#264)
• Preserve default KG path when --palace not passed (#270)
• --yes flag skips all interactive prompts in init (#123)
• Repair command, split args, Claude export, room keywords (#119)
• Replace Unicode separator in convo_miner.py for Windows compatibility (#129)
• Coerce MCP integer arguments to native Python int (#84)
• Batch ChromaDB reads to avoid SQLite variable limit (#66)
• Respect nested .gitignore rules during mining (#78)
• Narrow bare except Exception to specific types where safe (#54)
• Mark MD5 as non-security in miner drawer ID generation (#53)
• Remove dead code and duplicate set items in entity_registry.py (#42)
• Silence ChromaDB telemetry warnings and CoreML segfault on Apple Silicon (#236)
• Unify package and MCP version reporting (#16)
• Fix broken AAAK Dialect link in README (#238)
• Update input prompt for entity confirmation (#83)
• Preserve CLI exit codes, log tracebacks, sanitize search errors (#139)
• Enable SQLite WAL mode and add consistent LIMIT to KG timeline (#136)
• Add limit=10000 safety cap to all unbounded ChromaDB .get() calls (#137)
• Re-mine modified files, idempotent add_drawer, cleanup ChromaDB handles (#140)
• Resolve formatting, regression logic, and pytest defaults (#270)
• Use parse_known_args to allow importing mcp_server during pytest (#270)

New Features

• Package MemPalace as standard Claude and Codex plugins (#270)
• Add OpenAI Codex CLI JSONL normalizer (#61)
• Add Codex plugin support with hooks, commands, and documentation (#270)
• Add command documentation for help, init, mine, search, and status (#270)

Improvements

• Cache ChromaDB PersistentClient instead of re-instantiating per call (#135)
• Tighten chromadb version range and add py.typed marker (#142)
• Consolidate split known-names config loading (#22)
• CI: add separate jobs for Windows and macOS testing
• CI: Upgrade GitHub Actions for Node 24 compatibility (#55)

Documentation

• Add Gemini CLI setup guide and integration section (#106)
• Add beginner-friendly hooks tutorial (#103)
• Align MCP setup examples with shipped server (#21)
• Honest README update — own the mistakes, fix the claims

Internal

• Expand test coverage from 20 to 92 tests, migrate to uv (#131)
• Add scale benchmark suite — 106 tests (#223)
• Increase test coverage from 30% to 85%, fix Windows encoding bugs (#281)
• Add WAL mode and entity timeline limit assertions
• Add coverage for file_already_mined mtime check

---

[3.0.0] — 2026-04-06

Initial public release.

• Palace architecture with day-based rooms, drawers (verbatim), and closets (searchable index)
• AAAK compression dialect for memory folding
• Knowledge graph with entity detection and timeline queries
• MCP server for Claude, Codex, and Gemini integration
• CLI: init, mine, search, status, compress, repair, split
• Benchmark suite with recall and scale tests
• README with MCP flow, local model flow, and specialist agent documentation