GifariKemalandClaude Sonnet 4.5
f36123ccaf
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>
142 lines
4.2 KiB
Markdown
142 lines
4.2 KiB
Markdown
# 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)
|