docs: update all documentation to v3.0.2

- Updated README.md with v3.0.2 features and bug fixes
- Added comprehensive v3.0.2 section to CHANGELOG.md
- Updated CLAUDE.md to reflect current version
- Updated SECURITY.md supported versions (3.0.x is now supported)
- Updated all example files to reference SDK v3.0.2
- Version bump in pyproject.toml, __init__.py, and docs/conf.py

Key changes documented:
- Order lifecycle tracking fixes
- Order template instrument lookup fixes
- Comprehensive cleanup functionality
- Asyncio concurrency improvements

Author: TexasCoding

CHANGELOG.md

@@ -13,6 +13,33 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Old implementations are removed when improved
 - Clean, modern code architecture is prioritized
 
+## [3.0.2] - 2025-08-08
+
+### Fixed
+- **🐛 Order Lifecycle Tracking**: Fixed critical issues in order lifecycle tracking example
+  - Corrected asyncio.wait() usage by creating tasks instead of passing coroutines
+  - Fixed instrument lookup - recognized that suite.instrument is already an Instrument object
+  - Fixed Order field references (use `type` not `orderType`)
+  - Fixed Position field references (use `size` not `netQuantity`)
+  - Fixed cancel_order return type handling (returns bool not object)
+
+- **🔧 Order Templates**: Fixed instrument lookup issues
+  - Removed unnecessary async calls to get_instrument()
+  - suite.instrument is already resolved after TradingSuite initialization
+
+### Added
+- **🧹 Cleanup Functionality**: Comprehensive cleanup for demos and examples
+  - Automatic cancellation of all open orders at demo completion
+  - Automatic closing of all open positions
+  - Cleanup runs in finally block to ensure execution even on errors
+  - Prevents accumulation of test orders when running examples repeatedly
+
+### Improved
+- **📚 Documentation**: Updated all documentation to reflect v3.0.2
+  - Updated version references throughout
+  - Added clear documentation of breaking changes
+  - Improved migration guide clarity
+
 ## [3.0.1] - 2025-08-08
 
 ### Added

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.0.1 - Production-Ready Async Architecture
+## Project Status: v3.0.2 - Production-Ready Async Architecture
 
 **IMPORTANT**: This project uses a fully asynchronous architecture. All APIs are async-only, optimized for high-performance futures trading.
 
@@ -74,7 +74,7 @@ uv run python -m build       # Alternative build command
 
 ## Project Architecture
 
-### Core Components (v3.0.1 - Multi-file Packages)
+### Core Components (v3.0.2 - Multi-file Packages)
 
 **ProjectX Client (`src/project_x_py/client/`)**
 - Main async API client for TopStepX ProjectX Gateway
@@ -278,6 +278,12 @@ async with ProjectX.from_env() as client:
 
 ## Recent Changes
 
+### v3.0.2 - Bug Fixes and Improvements
+- **Order Lifecycle Tracking**: Fixed asyncio concurrency and field reference issues
+- **Order Templates**: Fixed instrument lookup to use cached object
+- **Cleanup Functionality**: Added comprehensive order/position cleanup
+- **Documentation**: Updated all docs to reflect current version
+
 ### v3.0.1 - Production Ready
 - **Performance Optimizations**: Enhanced connection pooling and caching
 - **Event Bus System**: Unified event handling across all components

README.md

@@ -21,19 +21,25 @@ 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.0.1 - TradingSuite Architecture
+## 🚀 v3.0.2 - Production-Ready Trading Suite
 
-**Latest Update (v3.0.1)**: Complete architectural upgrade with TradingSuite for simplified SDK usage, feature flags, and unified event handling.
+**Latest Update (v3.0.2)**: Bug fixes and improvements to order lifecycle tracking, comprehensive cleanup functionality, and enhanced error handling.
 
-### What's New in v3.0.1
+### What's New in v3.0.2
+
+- **Fixed Order Lifecycle Tracking**: Corrected asyncio concurrency issues and field references
+- **Automatic Cleanup**: Added comprehensive cleanup for orders and positions in examples
+- **Bug Fixes**: Fixed instrument lookup in order templates and improved error handling
+
+### Key Features from v3.0.1
 
 - **TradingSuite Class**: New unified entry point for simplified SDK usage
 - **One-line Initialization**: TradingSuite.create() handles all setup
 - **Feature Flags**: Easy enabling of optional components like orderbook and risk manager
 - **Context Manager Support**: Automatic cleanup with async with statements
 - **Unified Event Handling**: Built-in EventBus for all components
 
-**BREAKING CHANGE**: Version 3.0.1 replaces factory functions with TradingSuite. See migration guide below.
+**BREAKING CHANGE**: Version 3.0+ replaces factory functions with TradingSuite. See migration guide below.
 
 ### Why Async?
 
@@ -43,15 +49,15 @@ This Python SDK acts as a bridge between your trading strategies and the Project
 - **WebSocket Native**: Perfect for real-time trading applications
 - **Modern Python**: Leverages Python 3.12+ async features
 
-### Migration to v3.0.1
+### Migration to v3.0+
 
-If you're upgrading from v2.x or v3.0.0, key changes include TradingSuite replacing factories:
+If you're upgrading from v2.x, key changes include TradingSuite replacing factories:
 
 ```python
-# Old (v2.x/v3.0.0)
+# Old (v2.x)
 suite = await create_initialized_trading_suite(\"MNQ\", client)
 
-# New (v3.0.1)
+# New (v3.0+)
 suite = await TradingSuite.create(\"MNQ\")
 ```
 
@@ -120,7 +126,7 @@ if __name__ == \"__main__\":
     asyncio.run(main())
 ```
 
-### Trading Suite (NEW in v3.0.1)
+### Trading Suite (NEW in v3.0+)
 
 The easiest way to get started with a complete trading setup:
 

SECURITY.md

@@ -10,10 +10,11 @@ We currently provide security updates for the following versions:
 
 | Version | Supported          |
 | ------- | ------------------ |
-| 2.0.x   | :white_check_mark: |
+| 3.0.x   | :white_check_mark: |
+| 2.0.x   | :x:                |
 | 1.x.x   | :x:                |
 
-Note: Version 2.0.0 was a complete rewrite with an async-only architecture, and all previous synchronous APIs were removed.
+Note: Version 3.0.0 introduced the TradingSuite architecture, replacing all factory functions. Version 2.0.0 was a complete rewrite with an async-only architecture.
 
 ## Reporting a Vulnerability
 

docs/conf.py

@@ -23,8 +23,8 @@
 project = "project-x-py"
 copyright = "2025, Jeff West"
 author = "Jeff West"
-release = "3.0.1"
-version = "3.0.1"
+release = "3.0.2"
+version = "3.0.2"
 
 # -- General configuration ---------------------------------------------------
 

examples/10_unified_event_system.py

@@ -2,7 +2,7 @@
 """
 Example 10: Unified Event System with EventBus
 
-This example demonstrates the new unified event system in ProjectX SDK v3.0.0.
+This example demonstrates the new unified event system in ProjectX SDK v3.0.2.
 Instead of registering callbacks with individual components, all events flow
 through a single EventBus accessible via the TradingSuite.
 

examples/11_simplified_data_access.py

@@ -3,7 +3,7 @@
 Example: Simplified Data Access with v3.0.0
 
 This example demonstrates the new convenience methods for accessing market data
-in the ProjectX SDK v3.0.0. These methods provide a cleaner, more intuitive API
+in the ProjectX SDK v3.0.2. These methods provide a cleaner, more intuitive API
 for common data access patterns.
 
 Key improvements:
@@ -15,7 +15,7 @@
 - is_data_ready() - Check if enough data is loaded
 - get_bars_since() - Get data since a specific time
 
-Author: SDK v3.0.0 Examples
+Author: SDK v3.0.2 Examples
 """
 
 import asyncio
@@ -171,6 +171,6 @@ async def main() -> None:
 
 
 if __name__ == "__main__":
-    print("ProjectX SDK v3.0.0 - Simplified Data Access")
+    print("ProjectX SDK v3.0.2 - Simplified Data Access")
     print("=" * 50)
     asyncio.run(main())

examples/12_simplified_multi_timeframe.py

@@ -8,7 +8,7 @@
 
 Compare this with 06_multi_timeframe_strategy.py to see the improvements!
 
-Author: SDK v3.0.0 Examples
+Author: SDK v3.0.2 Examples
 """
 
 import asyncio
@@ -294,6 +294,6 @@ async def main() -> None:
 
 
 if __name__ == "__main__":
-    print("ProjectX SDK v3.0.0 - Simplified Multi-Timeframe Strategy")
+    print("ProjectX SDK v3.0.2 - Simplified Multi-Timeframe Strategy")
     print("=" * 60)
     asyncio.run(main())

examples/13_enhanced_models.py

@@ -9,7 +9,7 @@
 - Position: is_long, is_short, direction, symbol, signed_size, unrealized_pnl()
 - Order: is_open, is_filled, is_buy, is_sell, side_str, type_str, status_str, filled_percent
 
-Author: SDK v3.0.0 Examples
+Author: SDK v3.0.2 Examples
 """
 
 import asyncio
@@ -261,6 +261,6 @@ async def main():
 
 
 if __name__ == "__main__":
-    print("ProjectX SDK v3.0.0 - Enhanced Models Demo")
+    print("ProjectX SDK v3.0.2 - Enhanced Models Demo")
     print("=" * 50)
     asyncio.run(main())

examples/14_phase4_comprehensive_test.py

@@ -7,7 +7,7 @@
 - Enhanced model properties
 - Cleaner strategy implementation
 
-Author: SDK v3.0.0 Testing
+Author: SDK v3.0.2 Testing
 """
 
 import asyncio
@@ -326,7 +326,7 @@ async def demonstrate_phase4_improvements() -> None:
     async with await TradingSuite.create(
         "MNQ", timeframes=["1min", "5min", "15min"], initial_days=2
     ) as suite:
-        print("ProjectX SDK v3.0.0 - Phase 4 Comprehensive Test")
+        print("ProjectX SDK v3.0.2 - Phase 4 Comprehensive Test")
         print("=" * 60)
 
         strategy = CleanTradingStrategy(suite)