@backtest-kit/cli 0.0.7 → 3.3.0

package/README.md

@@ -49,9 +49,9 @@ npm install @backtest-kit/cli
 ```json
 {
   "scripts": {
-    "backtest": "@backtest-kit/cli --backtest ./src/index.mjs",
-    "paper":    "@backtest-kit/cli --paper    ./src/index.mjs",
-    "start":    "@backtest-kit/cli --live     ./src/index.mjs"
+    "backtest": "npx @backtest-kit/cli --backtest ./src/index.mjs",
+    "paper":    "npx @backtest-kit/cli --paper    ./src/index.mjs",
+    "start":    "npx @backtest-kit/cli --live     ./src/index.mjs"
   },
   "dependencies": {
     "@backtest-kit/cli": "latest",
@@ -149,7 +149,7 @@ npm start -- --symbol BTCUSDT --ui
 ```json
 {
   "scripts": {
-    "backtest": "@backtest-kit/cli --backtest ./src/index.mjs"
+    "backtest": "npx @backtest-kit/cli --backtest ./src/index.mjs"
   }
 }
 ```
@@ -163,7 +163,7 @@ Runs the strategy against historical candle data using a registered `FrameSchema
 ```json
 {
   "scripts": {
-    "backtest": "@backtest-kit/cli --backtest --symbol ETHUSDT --strategy my-strategy --exchange binance --frame feb-2024 --cacheInterval \"1m, 15m, 1h, 4h\" ./src/index.mjs"
+    "backtest": "npx @backtest-kit/cli --backtest --symbol ETHUSDT --strategy my-strategy --exchange binance --frame feb-2024 --cacheInterval \"1m, 15m, 1h, 4h\" ./src/index.mjs"
   }
 }
 ```
@@ -181,7 +181,7 @@ Connects to the live exchange but does not place real orders. Identical code pat
 ```json
 {
   "scripts": {
-    "paper": "@backtest-kit/cli --paper --symbol BTCUSDT ./src/index.mjs"
+    "paper": "npx @backtest-kit/cli --paper --symbol BTCUSDT ./src/index.mjs"
   }
 }
 ```
@@ -197,7 +197,7 @@ Deploys a real trading bot. Requires exchange API keys configured in your `.env`
 ```json
 {
   "scripts": {
-    "start": "@backtest-kit/cli --live --ui --telegram --symbol BTCUSDT ./src/index.mjs"
+    "start": "npx @backtest-kit/cli --live --ui --telegram --symbol BTCUSDT ./src/index.mjs"
   }
 }
 ```
@@ -246,8 +246,8 @@ monorepo/
 ```json
 {
   "scripts": {
-    "backtest:oct": "@backtest-kit/cli --backtest ./strategies/oct_2025/index.mjs",
-    "backtest:dec": "@backtest-kit/cli --backtest ./strategies/dec_2025/index.mjs"
+    "backtest:oct": "npx @backtest-kit/cli --backtest ./strategies/oct_2025/index.mjs",
+    "backtest:dec": "npx @backtest-kit/cli --backtest ./strategies/dec_2025/index.mjs"
   },
   "dependencies": {
     "@backtest-kit/cli": "latest",
@@ -506,7 +506,7 @@ Markdown.disable();
 **✅ With @backtest-kit/cli (one script)**
 
 ```json
-{ "scripts": { "backtest": "@backtest-kit/cli --backtest --ui --telegram ./src/index.mjs" } }
+{ "scripts": { "backtest": "npx @backtest-kit/cli --backtest --ui --telegram ./src/index.mjs" } }
 ```
 
 ```bash

package/build/index.cjs

@@ -90,6 +90,10 @@ var stackTrace__namespace = /*#__PURE__*/_interopNamespaceDefault(stackTrace);
     backtestKit.NotificationLive.usePersist();
     backtestKit.NotificationBacktest.useMemory();
 }
+backtestKit.setConfig({
+    CC_MAX_NOTIFICATIONS: 5000,
+    CC_MAX_SIGNALS: 750,
+});
 
 const ERROR_HANDLER_INSTALLED = Symbol.for("error-handler-installed");
 function dumpStackTrace() {
@@ -1443,6 +1447,16 @@ class TelegramLogicService {
                 markdown,
             });
         };
+        this.notifyAverageBuy = async (event) => {
+            this.loggerService.log("telegramLogicService notifyAverageBuy", {
+                event,
+            });
+            const markdown = await this.telegramTemplateService.getAverageBuyMarkdown(event);
+            await this.telegramWebService.publishNotify({
+                symbol: event.symbol,
+                markdown,
+            });
+        };
         this.connect = functoolsKit.singleshot(() => {
             this.loggerService.log("telegramLogicService connect");
             const unRisk = backtestKit.listenRisk(async (event) => {
@@ -1487,6 +1501,10 @@ class TelegramLogicService {
                     await this.notifyPartialLoss(event);
                     return;
                 }
+                if (event.action === "average-buy") {
+                    await this.notifyAverageBuy(event);
+                    return;
+                }
             });
             const unConnect = () => this.connect.clear();
             const unListen = functoolsKit.compose(() => unRisk(), () => unSignal(), () => unCommit(), () => unConnect());
@@ -1578,6 +1596,12 @@ class TelegramTemplateService {
             });
             return await RENDER_TEMPLATE_FN("risk.mustache", event, this);
         };
+        this.getAverageBuyMarkdown = async (event) => {
+            this.loggerService.log("telegramTemplateService getAverageBuyMarkdown", {
+                event,
+            });
+            return await RENDER_TEMPLATE_FN("average-buy.mustache", event, this);
+        };
     }
 }
 
@@ -1737,6 +1761,15 @@ class LiveProviderService {
                 await instance.onRisk(event);
             }
         };
+        this.handleAverageBuy = async (event) => {
+            this.loggerService.log("liveProviderService handleAverageBuy", {
+                event,
+            });
+            const instance = await LOAD_INSTANCE_FN(this);
+            if (instance?.onAverageBuy) {
+                await instance.onAverageBuy(event);
+            }
+        };
         this.enable = functoolsKit.singleshot(() => {
             this.loggerService.log("liveProviderService enable");
             LOAD_INSTANCE_FN(this).then((module) => {
@@ -1789,6 +1822,10 @@ class LiveProviderService {
                     await this.handlePartialLoss(event);
                     return;
                 }
+                if (event.action === "average-buy") {
+                    await this.handleAverageBuy(event);
+                    return;
+                }
             });
             const unConnect = () => this.enable.clear();
             return functoolsKit.compose(() => unRisk(), () => unSignal(), () => unCommit(), () => unConnect());

package/build/index.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { Storage, Notification, Markdown, Report, StorageLive, StorageBacktest, NotificationLive, NotificationBacktest, listExchangeSchema, addExchangeSchema, roundTicks, listFrameSchema, addFrameSchema, listenDoneLive, listenDoneBacktest, listenSignal, listStrategySchema, overrideExchangeSchema, Backtest, Live, getCandles, checkCandles, warmCandles, listenRisk, listenStrategyCommit } from 'backtest-kit';
+import { Storage, Notification, Markdown, Report, StorageLive, StorageBacktest, NotificationLive, NotificationBacktest, setConfig, listExchangeSchema, addExchangeSchema, roundTicks, listFrameSchema, addFrameSchema, listenDoneLive, listenDoneBacktest, listenSignal, listStrategySchema, overrideExchangeSchema, Backtest, Live, getCandles, checkCandles, warmCandles, listenRisk, listenStrategyCommit } from 'backtest-kit';
 import { getErrorMessage, errorData, singleshot, str, BehaviorSubject, compose, execpool, queued, sleep, randomString, createAwaiter, TIMEOUT_SYMBOL, typo, retry, memoize, trycatch } from 'functools-kit';
 import fs, { constants } from 'fs';
 import * as stackTrace from 'stack-trace';
@@ -68,6 +68,10 @@ import Mustache from 'mustache';
     NotificationLive.usePersist();
     NotificationBacktest.useMemory();
 }
+setConfig({
+    CC_MAX_NOTIFICATIONS: 5000,
+    CC_MAX_SIGNALS: 750,
+});
 
 const ERROR_HANDLER_INSTALLED = Symbol.for("error-handler-installed");
 function dumpStackTrace() {
@@ -1421,6 +1425,16 @@ class TelegramLogicService {
                 markdown,
             });
         };
+        this.notifyAverageBuy = async (event) => {
+            this.loggerService.log("telegramLogicService notifyAverageBuy", {
+                event,
+            });
+            const markdown = await this.telegramTemplateService.getAverageBuyMarkdown(event);
+            await this.telegramWebService.publishNotify({
+                symbol: event.symbol,
+                markdown,
+            });
+        };
         this.connect = singleshot(() => {
             this.loggerService.log("telegramLogicService connect");
             const unRisk = listenRisk(async (event) => {
@@ -1465,6 +1479,10 @@ class TelegramLogicService {
                     await this.notifyPartialLoss(event);
                     return;
                 }
+                if (event.action === "average-buy") {
+                    await this.notifyAverageBuy(event);
+                    return;
+                }
             });
             const unConnect = () => this.connect.clear();
             const unListen = compose(() => unRisk(), () => unSignal(), () => unCommit(), () => unConnect());
@@ -1556,6 +1574,12 @@ class TelegramTemplateService {
             });
             return await RENDER_TEMPLATE_FN("risk.mustache", event, this);
         };
+        this.getAverageBuyMarkdown = async (event) => {
+            this.loggerService.log("telegramTemplateService getAverageBuyMarkdown", {
+                event,
+            });
+            return await RENDER_TEMPLATE_FN("average-buy.mustache", event, this);
+        };
     }
 }
 
@@ -1715,6 +1739,15 @@ class LiveProviderService {
                 await instance.onRisk(event);
             }
         };
+        this.handleAverageBuy = async (event) => {
+            this.loggerService.log("liveProviderService handleAverageBuy", {
+                event,
+            });
+            const instance = await LOAD_INSTANCE_FN(this);
+            if (instance?.onAverageBuy) {
+                await instance.onAverageBuy(event);
+            }
+        };
         this.enable = singleshot(() => {
             this.loggerService.log("liveProviderService enable");
             LOAD_INSTANCE_FN(this).then((module) => {
@@ -1767,6 +1800,10 @@ class LiveProviderService {
                     await this.handlePartialLoss(event);
                     return;
                 }
+                if (event.action === "average-buy") {
+                    await this.handleAverageBuy(event);
+                    return;
+                }
             });
             const unConnect = () => this.enable.clear();
             return compose(() => unRisk(), () => unSignal(), () => unCommit(), () => unConnect());

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@backtest-kit/cli",
-  "version": "0.0.7",
+  "version": "3.3.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",
@@ -58,7 +58,7 @@
     "default": "./build/index.cjs"
   },
   "devDependencies": {
-    "@backtest-kit/ui": "3.1.1",
+    "@backtest-kit/ui": "3.3.0",
     "markdown-it": "14.1.1",
     "@rollup/plugin-typescript": "11.1.6",
     "@types/image-size": "0.7.0",
@@ -66,7 +66,7 @@
     "@types/mustache": "4.2.6",
     "@types/node": "22.9.0",
     "@types/stack-trace": "0.0.33",
-    "backtest-kit": "3.1.1",
+    "backtest-kit": "3.3.1",
     "glob": "11.0.1",
     "rimraf": "6.0.1",
     "rollup": "3.29.5",
@@ -79,7 +79,8 @@
   },
   "peerDependencies": {
     "typescript": "^5.0.0",
-    "@backtest-kit/ui": "^3.1.1",
+    "@backtest-kit/ui": "^3.3.0",
+    "backtest-kit": "^3.3.1",
     "markdown-it": "^14.1.1"
   },
   "dependencies": {

package/template/average-buy.mustache

@@ -0,0 +1,16 @@
+**➗ Averaging Entry (DCA)**
+
+**Symbol:** `{{symbol}}` ({{position}})
+
+**Current:** `{{currentPrice}}`
+**New Avg Entry:** `{{effectivePriceOpen}}`
+**Orig Entry:** `{{originalPriceOpen}}`
+**DCA Entries:** `{{totalEntries}}`
+**Take Profit:** `{{priceTakeProfit}}`
+**Stop Loss:** `{{priceStopLoss}}`
+**Signal ID:** `{{signalId}}`
+**Time:** `{{timestamp}}`
+
+{{#backtest}}
+_🧪 Backtest_
+{{/backtest}}

package/template/breakeven.mustache

@@ -6,6 +6,8 @@
 **Entry:** `{{priceOpen}}`
 **Take Profit:** `{{priceTakeProfit}}`
 **Stop Loss:** `{{priceStopLoss}}`
+**Orig Entry:** `{{originalPriceOpen}}`
+**DCA Entries:** `{{totalEntries}}`
 **Signal ID:** `{{signalId}}`
 **Time:** `{{timestamp}}`
 

package/template/cancelled.mustache

@@ -5,6 +5,8 @@
 **Reason:** `{{reason}}`
 **Entry:** `{{signal.priceOpen}}`
 **Current:** `{{currentPrice}}`
+**Orig Entry:** `{{signal.originalPriceOpen}}`
+**DCA Entries:** `{{signal.totalEntries}}`
 **Signal ID:** `{{signal.id}}`
 {{#cancelId}}**Cancel ID:** `{{cancelId}}`
 {{/cancelId}}**Time:** `{{createdAt}}`

package/template/closed.mustache

@@ -6,6 +6,8 @@
 **Entry:** `{{pnl.priceOpen}}`
 **Exit:** `{{pnl.priceClose}}`
 **PnL:** {{pnl.pnlPercentage}}%
+**Orig Entry:** `{{signal.originalPriceOpen}}`
+**DCA Entries:** `{{signal.totalEntries}}`
 **Signal ID:** `{{signal.id}}`
 {{#closeId}}**Close ID:** `{{closeId}}`
 {{/closeId}}**Time:** `{{createdAt}}`

package/template/opened.mustache

@@ -6,6 +6,8 @@
 **Entry:** `{{signal.priceOpen}}`
 **Take Profit:** `{{signal.priceTakeProfit}}`
 **Stop Loss:** `{{signal.priceStopLoss}}`
+**Orig Entry:** `{{signal.originalPriceOpen}}`
+**DCA Entries:** `{{signal.totalEntries}}`
 **TTL:** {{signal.minuteEstimatedTime}} min
 **Signal ID:** `{{signal.id}}`
 **Time:** `{{createdAt}}`

package/template/partial-loss.mustache

@@ -7,6 +7,8 @@
 **Closed:** {{percentToClose}}%
 **Take Profit:** `{{priceTakeProfit}}`
 **Stop Loss:** `{{priceStopLoss}}`
+**Orig Entry:** `{{originalPriceOpen}}`
+**DCA Entries:** `{{totalEntries}}`
 **Signal ID:** `{{signalId}}`
 **Time:** `{{timestamp}}`
 

package/template/partial-profit.mustache

@@ -7,6 +7,8 @@
 **Closed:** {{percentToClose}}%
 **Take Profit:** `{{priceTakeProfit}}`
 **Stop Loss:** `{{priceStopLoss}}`
+**Orig Entry:** `{{originalPriceOpen}}`
+**DCA Entries:** `{{totalEntries}}`
 **Signal ID:** `{{signalId}}`
 **Time:** `{{timestamp}}`
 

package/template/risk.mustache

@@ -6,6 +6,8 @@
 **Entry:** `{{currentSignal.priceOpen}}`
 **Take Profit:** `{{currentSignal.priceTakeProfit}}`
 **Stop Loss:** `{{currentSignal.priceStopLoss}}`
+**Orig Entry:** `{{currentSignal.originalPriceOpen}}`
+**DCA Entries:** `{{currentSignal.totalEntries}}`
 **Active positions:** {{activePositionCount}}
 {{#rejectionId}}**Rejection ID:** `{{rejectionId}}`
 {{/rejectionId}}**Time:** `{{timestamp}}`

package/template/scheduled.mustache

@@ -6,6 +6,8 @@
 **Entry:** `{{signal.priceOpen}}`
 **Take Profit:** `{{signal.priceTakeProfit}}`
 **Stop Loss:** `{{signal.priceStopLoss}}`
+**Orig Entry:** `{{signal.originalPriceOpen}}`
+**DCA Entries:** `{{signal.totalEntries}}`
 **TTL:** {{signal.minuteEstimatedTime}} min
 **Signal ID:** `{{signal.id}}`
 **Time:** `{{createdAt}}`

package/template/trailing-stop.mustache

@@ -7,6 +7,8 @@
 **Take Profit:** `{{priceTakeProfit}}`
 **Old Stop Loss:** `{{originalPriceStopLoss}}`
 **New Stop Loss:** `{{priceStopLoss}}` ({{percentShift}}%)
+**Orig Entry:** `{{originalPriceOpen}}`
+**DCA Entries:** `{{totalEntries}}`
 **Signal ID:** `{{signalId}}`
 **Time:** `{{timestamp}}`
 

package/template/trailing-take.mustache

@@ -7,6 +7,8 @@
 **Old Take Profit:** `{{originalPriceTakeProfit}}`
 **New Take Profit:** `{{priceTakeProfit}}` ({{percentShift}}%)
 **Stop Loss:** `{{priceStopLoss}}`
+**Orig Entry:** `{{originalPriceOpen}}`
+**DCA Entries:** `{{totalEntries}}`
 **Signal ID:** `{{signalId}}`
 **Time:** `{{timestamp}}`
 

package/types.d.ts

@@ -1,5 +1,5 @@
 import * as functools_kit from 'functools-kit';
-import { CandleInterval, TrailingTakeCommit, TrailingStopCommit, BreakevenCommit, PartialProfitCommit, PartialLossCommit, IStrategyTickResultScheduled, IStrategyTickResultCancelled, IStrategyTickResultOpened, IStrategyTickResultClosed, RiskContract } from 'backtest-kit';
+import { CandleInterval, TrailingTakeCommit, TrailingStopCommit, BreakevenCommit, PartialProfitCommit, PartialLossCommit, IStrategyTickResultScheduled, IStrategyTickResultCancelled, IStrategyTickResultOpened, IStrategyTickResultClosed, RiskContract, AverageBuyCommit } from 'backtest-kit';
 import { Input } from 'telegraf';
 
 interface ILogger {
@@ -163,6 +163,7 @@ declare class TelegramLogicService {
     private notifyOpened;
     private notifyClosed;
     private notifyRisk;
+    private notifyAverageBuy;
     connect: (() => () => void) & functools_kit.ISingleshotClearable;
 }
 
@@ -179,6 +180,7 @@ declare class TelegramTemplateService {
     getOpenedMarkdown: (event: IStrategyTickResultOpened) => Promise<string>;
     getClosedMarkdown: (event: IStrategyTickResultClosed) => Promise<string>;
     getRiskMarkdown: (event: RiskContract) => Promise<string>;
+    getAverageBuyMarkdown: (event: AverageBuyCommit) => Promise<string>;
 }
 
 interface ILiveModule {
@@ -192,6 +194,7 @@ interface ILiveModule {
     onOpened(event: IStrategyTickResultOpened): Promise<void> | void;
     onClosed(event: IStrategyTickResultClosed): Promise<void> | void;
     onRisk(event: RiskContract): Promise<void> | void;
+    onAverageBuy(event: AverageBuyCommit): Promise<void> | void;
 }
 type LiveModule = Partial<ILiveModule>;
 type BaseModule = LiveModule;
@@ -216,6 +219,7 @@ declare class LiveProviderService {
     private handleOpened;
     private handleClosed;
     private handleRisk;
+    private handleAverageBuy;
     enable: (() => (...args: any[]) => any) & functools_kit.ISingleshotClearable;
     disable: () => void;
     connect: (() => Promise<() => void>) & functools_kit.ISingleshotClearable;