v3.0.0 — Event Sourcing, Brain Index Generator, Retrieval-Led Reasoning

What's New

Event Helpers

• Pydantic-validated event creation with factory methods (create_field_update, create_relationship_event, create_status_change)
• Automatic event compaction (preserves first + recent events, summarizes middle)
• EventHelper.append_to_frontmatter() for easy integration

Event Query

• Query entity timelines, recent activity, and event statistics
• CLI commands: pmos-brain events timeline, pmos-brain events recent, pmos-brain events stats

Brain Index Generator

• Compressed BRAIN.md entity index for passive agent context
• Two-tier architecture: Team (Tier 1) with full relationships, Connected (Tier 2) compact format
• Pipe-delimited format keeps index under ~8KB for any context window

Retrieval-Led Reasoning

• Documented recommended usage pattern for AI agent integration
• Based on research showing passive context achieves 100% vs 53% task pass rate compared to tool-based retrieval

Installation

pip install pmos-brain

Full Changelog

See README.md for complete documentation.