@backtest-kit/cli 6.1.4 → 6.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@backtest-kit/cli",
-  "version": "6.1.4",
+  "version": "6.2.0",
   "description": "Zero-boilerplate CLI runner for backtest-kit strategies. Run backtests, paper trading, and live bots with candle cache warming, web dashboard, and Telegram notifications — no setup code required.",
   "author": {
     "name": "Petr Tripolsky",
@@ -61,11 +61,11 @@
   "devDependencies": {
     "@babel/plugin-transform-modules-umd": "7.27.1",
     "@babel/standalone": "7.29.1",
-    "@backtest-kit/ui": "6.1.1",
-    "@backtest-kit/graph": "6.1.1",
-    "@backtest-kit/ollama": "6.1.1",
-    "@backtest-kit/pinets": "6.1.1",
-    "@backtest-kit/signals": "6.1.1",
+    "@backtest-kit/ui": "6.2.0",
+    "@backtest-kit/graph": "6.2.0",
+    "@backtest-kit/ollama": "6.2.0",
+    "@backtest-kit/pinets": "6.2.0",
+    "@backtest-kit/signals": "6.2.0",
     "@rollup/plugin-replace": "6.0.3",
     "@rollup/plugin-typescript": "11.1.6",
     "@types/image-size": "0.7.0",
@@ -73,7 +73,7 @@
     "@types/mustache": "4.2.6",
     "@types/node": "22.9.0",
     "@types/stack-trace": "0.0.33",
-    "backtest-kit": "6.1.1",
+    "backtest-kit": "6.2.0",
     "glob": "11.0.1",
     "markdown-it": "14.1.1",
     "rimraf": "6.0.1",
@@ -88,12 +88,12 @@
   "peerDependencies": {
     "@babel/plugin-transform-modules-umd": "^7.27.1",
     "@babel/standalone": "^7.29.1",
-    "@backtest-kit/ui": "^6.1.1",
-    "@backtest-kit/graph": "^6.1.1",
-    "@backtest-kit/ollama": "^6.1.1",
-    "@backtest-kit/pinets": "^6.1.1",
-    "@backtest-kit/signals": "^6.1.1",
-    "backtest-kit": "^6.1.1",
+    "@backtest-kit/ui": "^6.2.0",
+    "@backtest-kit/graph": "^6.2.0",
+    "@backtest-kit/ollama": "^6.2.0",
+    "@backtest-kit/pinets": "^6.2.0",
+    "@backtest-kit/signals": "^6.2.0",
+    "backtest-kit": "^6.2.0",
     "markdown-it": "^14.1.1",
     "typescript": "^5.0.0"
   },

package/template/project/README.md

@@ -87,6 +87,34 @@ npm start -- --live --symbol BTCUSDT --ui --telegram ./content/feb_2026.strategy
 
 Module file `./modules/live.module.ts` is loaded automatically if it exists. Use it to register a `Broker` adapter that intercepts every trade mutation before internal state changes — exchange rejection rolls back the operation atomically.
 
+## 🚶 Walker — A/B Strategy Comparison (`--walker`)
+
+Runs the same historical period across multiple strategy files and prints a ranked comparison report. Use it to pick the best variant before committing to a single strategy.
+
+```bash
+npm start -- --walker --symbol BTCUSDT --noCache \
+  ./content/feb_2026_v1.strategy.ts \
+  ./content/feb_2026_v2.strategy.ts \
+  ./content/feb_2026_v3.strategy.ts
+```
+
+Each positional argument is a separate strategy file. All files are loaded without changing `process.cwd()` — `.env` is always read from the project root. `addWalkerSchema` is called automatically using the exchange and frame registered by the strategy files. If no frame is registered, the CLI falls back to the last 31 days from `Date.now()` with a warning.
+
+| Flag | Type | Default | Description |
+|------|------|---------|-------------|
+| `--walker` | boolean | — | Enable walker comparison mode |
+| `--symbol` | string | `BTCUSDT` | Trading pair |
+| `--cacheInterval` | string | `1m, 15m, 30m, 1h, 4h` | Comma-separated intervals to pre-cache |
+| `--noCache` | boolean | `false` | Skip candle cache warming |
+| `--verbose` | boolean | `false` | Log candle fetches and per-strategy progress |
+| `--output` | string | `walker_{SYMBOL}_{TIMESTAMP}` | Output file base name (no extension) |
+| `--json` | boolean | `false` | Save results as JSON to `./dump/<output>.json` |
+| `--markdown` | boolean | `false` | Save report as Markdown to `./dump/<output>.md` |
+
+Output file is created at `./dump/<output>.md` (or `.json`). Without `--json`/`--markdown` the report is printed to stdout.
+
+Module file `./modules/walker.module.ts` is loaded automatically before comparison starts (shared for all strategy files in the run).
+
 ## 🌲 Running PineScript Indicators (`--pine`)
 
 Executes a local `.pine` file against a real exchange and prints the output as a Markdown table or saves it to a file.
@@ -148,6 +176,7 @@ Module file `./modules/dump.module.ts` is loaded automatically. The project incl
 | File | Loaded by mode | Purpose |
 |------|----------------|---------|
 | `modules/backtest.module.ts` | `--backtest` | Register a `Broker` adapter for backtest |
+| `modules/walker.module.ts` | `--walker` | Shared config loaded before walker comparison starts |
 | `modules/paper.module.ts` | `--paper` | Register a `Broker` adapter for paper trading |
 | `modules/live.module.ts` | `--live` | Register a `Broker` adapter for live trading |
 | `modules/pine.module.ts` | `--pine` | Register an exchange schema for PineScript runs |

package/template/project/package.mustache

@@ -12,12 +12,12 @@
   "license": "ISC",
   "type": "commonjs",
   "dependencies": {
-    "@backtest-kit/cli": "^6.1.4",
-    "@backtest-kit/graph": "^6.1.1",
-    "@backtest-kit/pinets": "^6.1.1",
-    "@backtest-kit/ui": "^6.1.1",
+    "@backtest-kit/cli": "^6.2.0",
+    "@backtest-kit/graph": "^6.2.0",
+    "@backtest-kit/pinets": "^6.2.0",
+    "@backtest-kit/ui": "^6.2.0",
     "agent-swarm-kit": "^1.3.0",
-    "backtest-kit": "^6.1.1",
+    "backtest-kit": "^6.2.0",
     "functools-kit": "^1.0.95",
     "garch": "^1.2.3",
     "get-moment-stamp": "^1.1.2",

package/types.d.ts

@@ -77,6 +77,26 @@ declare class BacktestMainService {
     connect: (() => Promise<void>) & functools_kit.ISingleshotClearable;
 }
 
+declare class WalkerMainService {
+    private loggerService;
+    private resolveService;
+    private exchangeSchemaService;
+    private symbolSchemaService;
+    private cacheLogicService;
+    private moduleConnectionService;
+    run: ((payload: {
+        entryPoints: string[];
+        symbol: string;
+        output: string;
+        cacheInterval: CandleInterval[];
+        json: boolean;
+        markdown: boolean;
+        verbose: boolean;
+        noCache: boolean;
+    }) => Promise<void>) & functools_kit.ISingleshotClearable;
+    connect: (() => Promise<void>) & functools_kit.ISingleshotClearable;
+}
+
 declare class ExchangeSchemaService {
     readonly loggerService: LoggerService;
     addSchema: (() => Promise<void>) & functools_kit.ISingleshotClearable;
@@ -104,6 +124,7 @@ declare class ResolveService {
     readonly OVERRIDE_MODULES_DIR: string;
     getIsLaunched: () => boolean;
     attachPine: (pinePath: string) => Promise<string>;
+    attachStrategy: (jsPath: string) => Promise<void>;
     attachJavascript: (jsPath: string) => Promise<void>;
 }
 
@@ -232,6 +253,7 @@ declare const cli: {
     cacheLogicService: CacheLogicService;
     telegramLogicService: TelegramLogicService;
     backtestMainService: BacktestMainService;
+    walkerMainService: WalkerMainService;
     paperMainService: PaperMainService;
     liveMainService: LiveMainService;
     moduleConnectionService: ModuleConnectionService;