MCP Agent Mail v0.2.0

Release Date: January 6, 2026

This release marks a major milestone: completion of all 30 beads in the testing-tasks-v2 initiative, bringing comprehensive test coverage to the MCP Agent Mail coordination server.

🎯 Highlights

424+ tests passing across all priority levels (P0-P4)
26 new test suites covering all major subsystems
11 bug fixes including critical race condition fixes
Zero breaking changes - drop-in upgrade from v0.1.x

📊 Test Coverage by Category

P0 Regression Tests (Critical Path)

test_datetime_regression.py - Naive/aware datetime handling for SQLite
test_session_context_regression.py - Session context persistence
test_agent_name_validation.py - Agent name validation

P1 Core Tests

test_contact_management_flow.py - Contact request/approval workflow
test_message_delivery_flow.py - End-to-end message delivery
test_file_reservation_lifecycle.py - File reservation CRUD
test_project_agent_setup.py - Project and agent initialization
test_mcp_resources.py - MCP resource read access

P2 Integration Tests

Subsystem	Tests	Coverage
CLI: Mail Commands	29	Inbox, send, search, acks
CLI: Archive Commands	24	Save, restore, list, verify
CLI: Guard Commands	20	Install, status, check
HTTP: Authentication	15	Bearer tokens, JWKS, sessions
HTTP: Rate Limiting	13	Token bucket, burst, recovery
HTTP: Server/Transport	12	Streaming, lifecycle, errors
Guards: Pre-commit	14	Conflict detection, bypass
Guards: Pre-push	20	Remote checks, multi-file
Errors: Database	10	Failures, recovery
Errors: Git Archive	21	Corruption, missing refs
Errors: Invalid Inputs	12	Validation, edge cases

P3 Non-Functional Tests

Security: Path traversal prevention, input sanitization
Concurrency: Multi-agent stress testing with 70% success thresholds
Performance: MCP tool latency benchmarks

P4 End-to-End Scenarios

test_e2e_multi_agent_workflow.py - Full multi-agent development simulation
test_e2e_disaster_recovery.py - Backup/restore cycle verification

🔧 Bug Fixes

fix(llm): Repair broken double-checked locking initialization - race condition that could cause duplicate LiteLLM setup
fix(datetime): Use naive UTC datetimes for SQLite compatibility
fix(app,http): Improve project identity and rate limit handling
fix: Improve LRU repo cache to prevent EMFILE errors under high concurrency
fix: Improve test robustness and document put() behavior
Multiple linter fixes and code review improvements

📈 Project Statistics

Metric	Value
Commits since v0.1.5	65
Beads completed	30/30
Average lead time	2.9 hours
Total tests	424+

🚀 Installation

# Using pip
pip install mcp-agent-mail==0.2.0

# Using uv
uv add mcp-agent-mail==0.2.0

# From source
git clone https://github.com/Dicklesworthstone/mcp_agent_mail
cd mcp_agent_mail
uv sync

📋 Requirements

Python 3.14+
SQLite 3.45+ or PostgreSQL 16+

🔗 Links

🤖 Generated with Claude Code

Dicklesworthstone/mcp_agent_mail v0.2.0 v0.2.0 - Comprehensive Test Coverage Milestone on GitHub