backtest-kit 8.4.0 → 9.0.0

package/README.md

@@ -51,11 +51,11 @@ Sidekick generates a project where the exchange adapter, frame definitions, risk
 ```bash
 npx @backtest-kit/cli --docker
 cd backtest-kit-docker
-MODE=live SYMBOL=TRXUSDT UI=1 docker-compose up -d
+MODE=live SYMBOL=TRXUSDT STRATEGY_FILE=./content/feb_2026/feb_2026.strategy.ts docker-compose up -d
 docker-compose logs -f
 ```
 
-CLI can create a ready-to-use Docker workspace: self-contained directory with `docker-compose.yaml` and a strategy entry point. 
+CLI can create a ready-to-use Docker workspace: self-contained directory with `docker-compose.yaml` and a strategy entry point. CLI supports [Multiple Symbol in Parallel](https://www.npmjs.com/package/@backtest-kit/cli#-multiple-symbol-parallel) for powerusers.
 
 ### 📦 Manual Installation
 
@@ -78,7 +78,7 @@ Install the core library and peer dependencies manually. Use this approach when
 - 🛡️ **Risk Management**: Custom rules for position limits, time windows, and multi-strategy coordination.
 - 🔌 **Pluggable**: Custom data sources (CCXT), persistence (file/Redis), and sizing calculators.
 - 🗃️ **Transactional Live Orders**: Broker adapter intercepts every trade mutation before internal state changes — exchange rejection rolls back the operation atomically.
-- 🧪 **Tested**: 515+ unit/integration tests for validation, recovery, and events.
+- 🧪 **Tested**: 520+ unit/integration tests for validation, recovery, and events.
 - 🔓 **Self hosted**: Zero dependency on third-party node_modules or platforms; run entirely in your own environment.
 
 ## 📋 Supported Order Types
@@ -361,6 +361,8 @@ These three functions work together to dynamically manage the position. To reduc
   ```
 </details>
 
+#### Internals
+
 **`priceOpen`** is the harmonic mean of all accepted DCA entries. After each partial close (`commitPartialProfit` or `commitPartialLoss`), the remaining cost basis is carried forward into the harmonic mean calculation for subsequent entries — so `priceOpen` shifts after every partial, which in turn changes whether the next `commitAverageBuy` call will be accepted.
 
 ### 🔍 How Broker Transactional Integrity Works
@@ -1261,6 +1263,8 @@ Broker.enable();
 
 </details>
 
+#### Internals
+
 Signal open/close events are routed automatically via an internal event bus once `Broker.enable()` is called. **No manual wiring needed.** All other operations (`partialProfit`, `trailingStop`, `breakeven`, `averageBuy`) are intercepted explicitly before the corresponding state mutation.
 
 ### 🔍 How getCandles Works
@@ -1436,6 +1440,8 @@ Aggregated trades fetching uses the same look-ahead bias protection as candles -
 
 </details>
 
+#### Aggregated Trades Timestamp Convention:
+
 **Compatible with:** [garch](https://www.npmjs.com/package/garch) for volatility modelling and [volume-anomaly](https://www.npmjs.com/package/volume-anomaly) for detecting abnormal trade volume — both accept the same `from`/`to` time range format that `getAggregatedTrades` produces.
 
 ### 🔬 Technical Details: Timestamp Alignment
@@ -1807,7 +1813,7 @@ Python-based (WASI) strategy that uses EMA(9) and EMA(21) crossover signals exec
 
 ## ✅ Tested & Reliable
 
-515+ tests cover validation, recovery, reports, and events.
+520+ tests cover validation, recovery, reports, and events.
 
 ## 🤝 Contribute