roampal-ai/roampal-core

Cross-platform compatibility audit and backend data integrity fixes

Critical

• Fix ChromaDB hnsw:space metadata mismatch between query_vectors() and initialize()

High

• Fix search_books() calling nonexistent adapter method (was broken since launch)
• Write original_id metadata during all promotion paths so outcome scoring finds promoted docs
• Add _promotion_lock to handle_promotion to prevent race with batch promotion
• Use split('_', 1)[1] for promotion ID derivation instead of fragile .replace()
• Fix book_ vs books_ prefix mismatch with dual-prefix backward compatibility guard

Medium

• Stop hook reads last_assistant_message from input data (Claude Code v2.1+)
• Fix timezone-aware _calculate_age_hours (was silently returning 0 for TZ-aware timestamps)
• Batch promotion multi-key text fallback (text → metadata.content → doc.content)
• Synchronize Zen free model lists across sidecar and plugin

Low

• Pin mcp>=1.0.0,<2.0.0 to prevent breaking changes
• Remove invalid default: None from MCP tool schemas
• Use collection.update() instead of upsert() for metadata-only changes
• Fix books recency boost field (created_at not upload_timestamp)
• Fix error message: "archiving" → "deleting memory"

OpenCode Plugin

• Clean up sessionOnboarded set on session end (memory leak fix)
• Support XDG_CONFIG_HOME in config path lookup
• Replace fragile .replace() URL construction with ROAMPAL_API_URL constant

Docs

• Clean ARCHITECTURE.md for v0.4.0 (remove debug narratives, update deps, fix version refs)
• Add consulting contact to README

527 tests passing, 0 failures.

Full release notes: RELEASE_NOTES.md