docs: Update documentation for v3.1.13 release

- Updated CHANGELOG.md with comprehensive v3.1.13 release notes
- Updated CLAUDE.md project status to v3.1.13
- Updated README.md version to v3.1.13
- Documented all fixes: event system, type annotations, stability improvements
- Highlighted critical bracket order fill detection fix
- Added test coverage improvements (30% to 93%)

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>

Author: TexasCoding

CHANGELOG.md

@@ -14,37 +14,51 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Migration guides will be provided for all breaking changes
 - Semantic versioning (MAJOR.MINOR.PATCH) is strictly followed
 
-## [Unreleased] - patching_v4 branch
+## [3.1.13] - 2025-08-15
 
 ### Fixed
-- **🔧 Bracket Order Fill Detection**: OrderManager now properly detects entry order fills
-  - Fixed initialization of OrderManager with realtime client for WebSocket callbacks
-  - Bracket orders now correctly wait for entry fills before placing protective orders
-  - OCO (One-Cancels-Other) linking properly implemented for stop/target pairs
-
-- **🔄 Circular Dependencies**: Resolved circular dependency between PositionManager and RiskManager
-  - Made cross-references optional during initialization
-  - Proper initialization sequence in TradingSuite
-
-- **🎯 RiskManager Integration**: Fixed RiskManager position manager references
-  - Now correctly sets both `positions` and `position_manager` attributes
-  - Ensures all risk methods work properly with PositionManager
+- **🎯 Event System Data Structure Mismatches**: Fixed critical order fill detection issues
+  - Bracket orders now properly detect fills without timing out
+  - Event handlers now correctly handle both `order_id` and nested `order` object structures
+  - Added backward compatibility for different event payload formats
+  - ManagedTrade now listens to correct events (ORDER_FILLED vs ORDER_MODIFIED)
+
+- **📝 Type Annotations for SignalR Connections**: Improved IDE support and type safety
+  - Created HubConnection type alias for BaseHubConnection
+  - Fixed market_connection and user_connection from Any to proper types
+  - IDEs now recognize connection methods (send, on, start, stop)
+  - Updated ProjectXRealtimeClientProtocol to match implementation
+
+- **🔧 Real-time Connection Improvements**: Enhanced WebSocket stability
+  - Added circuit breaker pattern to BatchedWebSocketHandler
+  - Improved subscription handling with proper event waiting
+  - Fixed asyncio deprecation warnings (get_event_loop → get_running_loop)
+  - Better error handling and recovery mechanisms
 
 ### Improved
-- **✅ Type Safety**: Full mypy compliance with 0 errors
-  - Added comprehensive protocol definitions for all manager interfaces
-  - Fixed all async method return type annotations
-  - Proper type hints for event handlers
-
-- **🧪 Test Suite**: Enhanced test mocking for cross-component dependencies
-  - Bracket order tests now properly mock all required methods
-  - Fixed test isolation for mixin testing
+- **📊 Data Storage Robustness**: Major improvements to mmap_storage module
+  - Fixed critical bug causing data overwrite on initialization
+  - Implemented binary search for read_window (significant performance boost)
+  - Added thread-safe operations with RLock
+  - Fixed file corruption bug in _resize_file
+  - Replaced print statements with proper logging
+
+- **🧪 Test Coverage**: Dramatically improved client module testing
+  - Client module coverage increased from 30% to 93%
+  - Added 70+ comprehensive test cases across all client components
+  - Fixed bug in _select_best_contract method
+  - Full test coverage for base.py (100%) and trading.py (98%)
+
+- **🏗️ Order and Position Management**: Enhanced tracking and stability
+  - Improved order tracking with better event handling
+  - More robust position manager logic
+  - Better error recovery in order chains
+  - Enhanced TradingSuite configuration options
 
 ### Documentation
-- Added comprehensive Features documentation to README
-- Updated CLAUDE.md with architectural changes
-- Clarified RiskManager feature flag requirements
-- Documented available TradingSuite features and their usage
+- Updated CHANGELOG.md with comprehensive v3.1.13 changes
+- Updated CLAUDE.md Recent Changes section
+- Added detailed commit messages for all fixes
 
 ## [3.1.12] - 2025-08-15
 

CLAUDE.md

@@ -2,7 +2,7 @@
 
 This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
 
-## Project Status: v3.1.9 - Stable Production Release
+## Project Status: v3.1.13 - Stable Production Release
 
 **IMPORTANT**: This project uses a fully asynchronous architecture. All APIs are async-only, optimized for high-performance futures trading.
 
@@ -300,15 +300,20 @@ async with ProjectX.from_env() as client:
 
 ## Recent Changes
 
-### v3.1.13 - Current Development (patching_v4)
-- **Fixed**: Bracket order fill detection through proper WebSocket callback initialization
-- **Fixed**: Circular dependencies between PositionManager and RiskManager
-- **Fixed**: RiskManager integration now properly sets both `positions` and `position_manager` attributes
-- **Enhanced**: Full mypy type checking compliance with 0 errors
-- **Added**: Comprehensive protocol definitions for all manager interfaces
-- **Updated**: Test suite to properly mock cross-component dependencies
-
-### v3.1.12 - Latest Release
+### v3.1.13 - Latest Release
+- **Fixed**: Event system data structure mismatches causing order fill detection failures
+  - Bracket orders now properly detect fills without 60-second timeouts
+  - Event handlers handle both `order_id` and nested `order` object structures
+  - ManagedTrade correctly listens to ORDER_FILLED instead of ORDER_MODIFIED
+- **Fixed**: Type annotations for SignalR hub connections
+  - Created HubConnection type alias for proper IDE support
+  - market_connection and user_connection now have proper types instead of Any
+- **Improved**: Real-time connection stability with circuit breaker pattern
+- **Improved**: Data storage robustness with thread-safety and performance optimizations
+- **Enhanced**: Test coverage increased from 30% to 93% for client module
+- **Fixed**: Multiple asyncio deprecation warnings
+
+### v3.1.12
 - **Enhanced**: Significantly improved `01_events_with_on.py` real-time data example
   - Added CSV export functionality with interactive prompts
   - Plotly-based candlestick chart generation

README.md

@@ -21,9 +21,9 @@ A **high-performance async Python SDK** for the [ProjectX Trading Platform](http
 
 This Python SDK acts as a bridge between your trading strategies and the ProjectX platform, handling all the complex API interactions, data processing, and real-time connectivity.
 
-## 🚀 v3.1.11 - Stable Production Release
+## 🚀 v3.1.13 - Stable Production Release
 
-**Latest Version**: v3.1.11 - Fixed ManagedTrade market price fetching for risk-managed trades. See [CHANGELOG.md](CHANGELOG.md) for full release history.
+**Latest Version**: v3.1.13 - Fixed critical event system issues affecting bracket order fill detection and improved real-time connection stability. See [CHANGELOG.md](CHANGELOG.md) for full release history.
 
 ### 📦 Production Stability Guarantee