ledgermind Files

Release Notes - v2.1.0: The "Universal Persistence" Release

This release introduces the Universal PTY Runner, a major architectural milestone that allows any terminal-based AI agent to utilize the Agent Memory System with zero code modifications. We have also unified versioning across all components and significantly hardened the security layer.

🚀 New Component: Agent Memory Runner (am-run) The new agent-memory-runner package provides a PTY (Pseudo-Terminal) wrapper that intercepts terminal input/output to manage memory context autonomously.

• Zero-Fork Integration: Works with any CLI agent (gemini-cli, aichat, interpreter, bash) without modifying their source code.
• Environment Protocol: Automatically injects a system-level prelude to guide agents on memory usage.
• Hard Writeback: Intercepts MEMORY: {...} markers in real-time and commits them to Git/SQLite immediately.
• Heuristic Extraction: Automatically captures insights even when the agent doesn't use explicit markers.
• 100% UX Preservation: Full support for colors, TUI (curses), and interactive hotkeys.

🛡 Security & Hardened Auditing

• Comprehensive Audit Log: The AuditLogger is now fully integrated into the MCPServer. Every tool call, role, and source IP is recorded in audit.log.
• Isolation Rules: Implemented protection for human-created decisions. Agents are now restricted from superseding records that do not contain the [via MCP] or [PTY-RUNNER] signature.
• Capability Enforcement: Fixed issues with --capabilities flags in the CLI, ensuring strict adherence to the Principle of Least Privilege.

📊 Observability & Performance

• Prometheus Metrics: Added a dedicated metrics exporter. Monitor tool_calls_total, latency_seconds, and errors via port 9090.
• Threaded REST Gateway: Fixed the REST/WebSocket gateway to run in parallel with the MCP server using a non-blocking thread model.
• High-Throughput Search: Optimized SQLite metadata indexing, achieving ~4,000 OPS (operations per second) for knowledge retrieval.

🛠 Reliability Improvements

• Concurrency Fixes: Resolved race conditions during Git repository initialization.
• Git Backoff Logic: Improved exponential backoff for index.lock collisions, allowing multiple agents to commit simultaneously.
• ACID Rollbacks: Enhanced transaction safety; failed metadata updates now trigger automatic Git hard resets to maintain a clean state.

🔄 Project Unification

• Unified Versioning: All components (core, server, adapters, runner) are now synchronized to version 2.1.0.
• Installation: Simplified installation flow: pip install -e ./core -e ./mcp_server -e ./adapters -e ./runner.