roampal-ai/roampal-core

Highlights

• Event loop unblocking: embed_text() wrapped in asyncio.to_thread() — fixes the root cause of "not responding" errors on Linux
• Performance caps: _search_all capped at 1,000/collection, BM25 index rebuild at 2,000 docs — prevents OOM on memory-constrained systems
• Sidecar-only scoring on OpenCode: score_memories tool hidden from MCP, no main LLM fallback — eliminates double-scoring
• Timezone fix: _humanize_age() now shows correct memory ages on non-UTC systems

What's Changed

Critical

• embed_text() / embed_texts() use asyncio.to_thread() for CPU-bound encode

High

• MCP server restart timeout bumped 3s → 15s with return value check
• _search_all fetch limit capped at 1,000 per collection
• Graceful sentence-transformers import failure with clear error message
• Server lifespan() error handling with "what failed + how to fix" guidance
• BM25 index rebuild capped at 2,000 documents

Medium

• XDG_DATA_HOME respected on Linux in all 3 path resolution sites
• Atomic _completion_state.json writes via os.replace()
• Removed ChromaDBAdapter.__del__(), explicit cleanup on lifespan shutdown
• User-friendly "Roampal: restarting server..." messages (replaces alarming stderr)
• Fixed _humanize_age() timezone offset — memories showed wrong ages on non-UTC systems

Low

• Removed dead cross-encoder reranking code (~80 lines)
• Normalized macOS detection to sys.platform
• OpenCode: sidecar-only scoring architecture — score_memories hidden from MCP tool list

Verification

526 tests passing. 0 failures.

Full release notes: dev/docs/releases/v0.4.1/RELEASE_NOTES.md

Install / Upgrade

pip install --upgrade roampal