feat: implement professional versioning system (v0.6.0)

Implement industrial-standard semantic versioning (SemVer 2.0.0) with automated feature detection and comprehensive changelog management. New Features: - VERSION file: Single source of truth for base version (0.0.0) - src/version.py: Centralized version manager with auto-detection - CHANGELOG.md: Keep a Changelog format for all changes - Auto-versioning: Features increment MINOR version automatically - Version display: Shows in startup banner and logs Predictive Intelligence (v6.3) Complete: - src/trajectory_predictor.py: Forecast profit 1-5 minutes ahead - src/momentum_persistence.py: Detect momentum continuation (0-1 score) - src/recovery_detector.py: Analyze recovery strength from losses - src/fuzzy_exit_logic.py: Fuzzy logic exit confidence (0-1) - src/kalman_filter.py: Kalman filter for velocity smoothing - src/kelly_position_scaler.py: Kelly criterion position scaling Version Calculation: Base 0.0.0 + Kalman(0.1) + Fuzzy(0.1) + Kelly(0.1) + Trajectory(0.1) + Momentum(0.1) + Recovery(0.1) = v0.6.0 Modified: - CLAUDE.md: Added comprehensive versioning documentation - main_live.py: Display version in startup banner - src/smart_risk_manager.py: Use centralized versioning Documentation: - CLAUDE.md: Full versioning guidelines (SemVer, workflows, examples) - CHANGELOG.md: Initial release documentation with feature tracking - VERSION: Base version 0.0.0 Benefits: - Professional version management (industry standard) - Automatic feature tracking and version updates - Complete change history with Keep a Changelog format - Clear upgrade paths (MAJOR.MINOR.PATCH) Version: v0.6.0 (Kalman + Fuzzy + Kelly + Predictive) Exit Strategy: v6.3 Predictive Intelligence Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-11 08:28:31 +07:00
parent cc6bfd48f2
commit f36123ccaf
12 changed files with 3879 additions and 176 deletions
@@ -0,0 +1,141 @@
+# Changelog
+
+All notable changes to XAUBot AI will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+### Added
+- Professional versioning system with semantic versioning (MAJOR.MINOR.PATCH)
+- Automated version detection based on enabled features
+- Centralized version management via `src/version.py`
+- Comprehensive changelog following Keep a Changelog format
+
+---
+
+## [0.0.0] - 2026-02-11
+
+### Initial Release
+Starting point for versioned releases. All previous development consolidated into v0.0.0 baseline.
+
+#### Core Features
+- **MT5 Integration**: Real-time connection to MetaTrader 5
+- **Smart Money Concepts (SMC)**: Order Blocks, Fair Value Gaps, BOS/CHoCH detection
+- **Machine Learning**: XGBoost model for trade signal prediction (37 features)
+- **HMM Regime Detection**: Market classification (trending/ranging/volatile)
+- **Risk Management**: Multi-tier capital modes (MICRO/SMALL/MEDIUM/LARGE)
+- **Session Filtering**: Sydney/London/NY session optimization
+- **Telegram Notifications**: Real-time trade alerts and commands
+
+#### Advanced Exit Systems
+- **v6.0 Kalman Intelligence**: Kalman filter for velocity smoothing
+- **v6.1 Profit-Tier Strategy**: Dynamic exit thresholds based on profit magnitude
+- **v6.2 Bug Fixes**: ExitReason.STOP_LOSS → POSITION_LIMIT correction
+- **v6.3 Predictive Intelligence**:
+  - Trajectory Predictor (profit forecasting 1-5min ahead)
+  - Momentum Persistence Detector (continuation probability)
+  - Recovery Strength Analyzer (loss recovery optimization)
+
+#### Technical Infrastructure
+- **Framework**: Python 3.11+, Polars (not Pandas), asyncio
+- **Models**: XGBoost (binary classification), HMM (regime detection)
+- **Database**: PostgreSQL for trade logging
+- **Dashboard**: Next.js web monitoring interface
+- **Deployment**: Docker support with multi-environment configs
+
+### Performance Metrics (Baseline)
+- Win Rate: 56-58%
+- Average Win: $2.78 (v6.2) → Target $6-8 (v6.3)
+- Peak Capture: 71% → Target 85%+
+- Daily Loss Limit: 5% of capital
+- Risk per Trade: 0.5-2% (capital-mode dependent)
+
+---
+
+## Version History Format
+
+### [MAJOR.MINOR.PATCH] - YYYY-MM-DD
+
+#### Added
+- New features that are backward compatible
+
+#### Changed
+- Changes in existing functionality
+
+#### Deprecated
+- Features that will be removed in future versions
+
+#### Removed
+- Features that have been removed
+
+#### Fixed
+- Bug fixes
+
+#### Security
+- Security vulnerability fixes
+
+---
+
+## Semantic Versioning Guidelines
+
+### MAJOR version (x.0.0)
+Increment when making incompatible API changes:
+- Breaking changes to core trading logic
+- Removal of major features
+- Database schema changes requiring migration
+- Configuration format changes
+
+Examples:
+- Switching from Pandas to Polars
+- Changing ML model architecture completely
+- Removing hard stop-loss system
+
+### MINOR version (0.x.0)
+Increment when adding functionality in a backward-compatible manner:
+- New exit strategies (e.g., v6.3 Predictive Intelligence)
+- New indicators or features
+- New filters or risk management modes
+- Enhanced logging or monitoring
+
+Examples:
+- Adding Trajectory Predictor
+- Adding new session filter
+- Implementing Kelly Criterion
+
+### PATCH version (0.0.x)
+Increment when making backward-compatible bug fixes:
+- Bug fixes that don't change behavior
+- Performance optimizations
+- Documentation updates
+- Code refactoring (no logic changes)
+
+Examples:
+- Fixing ExitReason.STOP_LOSS typo
+- Fixing variable scope errors
+- Correcting log messages
+
+---
+
+## Feature Tracking
+
+Current feature set determines version automatically:
+
+| Feature | Version Component | Impact |
+|---------|------------------|--------|
+| Basic Trading (SMC + ML + MT5) | 0.x.x | Core |
+| Exit v6.0 (Kalman) | 0.1.x | MINOR |
+| Exit v6.1 (Profit-Tier) | 0.2.x | MINOR |
+| Exit v6.2 (Bug Fixes) | 0.2.1 | PATCH |
+| Exit v6.3 (Predictive) | 0.3.x | MINOR |
+| Fuzzy Logic Controller | +0.1 | MINOR |
+| Kelly Criterion | +0.1 | MINOR |
+| Recovery Detector | +0.1 | MINOR |
+
+---
+
+## Links
+- [Repository](https://github.com/GifariKemal/xaubot-ai)
+- [Documentation](./docs/)
+- [Issues](https://github.com/GifariKemal/xaubot-ai/issues)