@backtest-kit/cli 7.3.0 → 7.4.0

package/README.md

@@ -509,6 +509,54 @@ Sends formatted HTML messages with 1m / 15m / 1h price charts to your Telegram c
 
 Requires `CC_TELEGRAM_TOKEN` and `CC_TELEGRAM_CHANNEL` in your environment.
 
+#### Telegram Message Adapter (`telegram.config`)
+
+By default messages are rendered from Mustache templates (`template/*.mustache`). To override rendering programmatically, create a `config/telegram.config` file and export an object with any subset of `get*Markdown` methods. Each method receives the event payload and must return a `Promise<string>` with the Markdown message body.
+
+Resolution order is the same as other configs (strategy dir → project root → package default).
+
+```ts
+// config/telegram.config.ts
+import {
+  IStrategyTickResultOpened,
+  IStrategyTickResultClosed,
+  RiskContract,
+} from "backtest-kit";
+
+export default {
+  async getOpenedMarkdown(event: IStrategyTickResultOpened): Promise<string> {
+    return `**Opened** ${event.symbol} at ${event.priceOpen}`;
+  },
+  async getClosedMarkdown(event: IStrategyTickResultClosed): Promise<string> {
+    return `**Closed** ${event.symbol} at ${event.priceClosed}`;
+  },
+  async getRiskMarkdown(event: RiskContract): Promise<string> {
+    return `**Risk rejected** ${event.symbol}`;
+  },
+};
+```
+
+All methods are optional — unimplemented ones fall back to the Mustache template.
+
+| Method | Event type |
+|--------|------------|
+| `getOpenedMarkdown` | `IStrategyTickResultOpened` |
+| `getClosedMarkdown` | `IStrategyTickResultClosed` |
+| `getScheduledMarkdown` | `IStrategyTickResultScheduled` |
+| `getCancelledMarkdown` | `IStrategyTickResultCancelled` |
+| `getRiskMarkdown` | `RiskContract` |
+| `getPartialProfitMarkdown` | `PartialProfitCommit` |
+| `getPartialLossMarkdown` | `PartialLossCommit` |
+| `getBreakevenMarkdown` | `BreakevenCommit` |
+| `getTrailingTakeMarkdown` | `TrailingTakeCommit` |
+| `getTrailingStopMarkdown` | `TrailingStopCommit` |
+| `getAverageBuyMarkdown` | `AverageBuyCommit` |
+| `getSignalOpenMarkdown` | `SignalOpenContract` |
+| `getSignalCloseMarkdown` | `SignalCloseContract` |
+| `getCancelScheduledMarkdown` | `CancelScheduledCommit` |
+| `getClosePendingMarkdown` | `ClosePendingCommit` |
+| `getSignalInfoMarkdown` | `SignalInfoContract` |
+
 ## 🧩 Module Hooks (Broker Adapter)
 
 The CLI supports **mode-specific module files** that are loaded as side-effect imports before the strategy starts. Each file is expected to call `Broker.useBrokerAdapter()` from `backtest-kit` to register a broker adapter.

package/build/index.cjs

@@ -1929,6 +1929,9 @@ class TelegramLogicService {
                 event,
             });
             const markdown = await this.telegramTemplateService.getTrailingTakeMarkdown(event);
+            if (!markdown) {
+                return;
+            }
             await this.telegramWebService.publishNotify({
                 symbol: event.symbol,
                 markdown,
@@ -1939,6 +1942,9 @@ class TelegramLogicService {
                 event,
             });
             const markdown = await this.telegramTemplateService.getTrailingStopMarkdown(event);
+            if (!markdown) {
+                return;
+            }
             await this.telegramWebService.publishNotify({
                 symbol: event.symbol,
                 markdown,
@@ -1949,6 +1955,9 @@ class TelegramLogicService {
                 event,
             });
             const markdown = await this.telegramTemplateService.getBreakevenMarkdown(event);
+            if (!markdown) {
+                return;
+            }
             await this.telegramWebService.publishNotify({
                 symbol: event.symbol,
                 markdown,
@@ -1959,6 +1968,9 @@ class TelegramLogicService {
                 event,
             });
             const markdown = await this.telegramTemplateService.getPartialProfitMarkdown(event);
+            if (!markdown) {
+                return;
+            }
             await this.telegramWebService.publishNotify({
                 symbol: event.symbol,
                 markdown,
@@ -1969,6 +1981,9 @@ class TelegramLogicService {
                 event,
             });
             const markdown = await this.telegramTemplateService.getPartialLossMarkdown(event);
+            if (!markdown) {
+                return;
+            }
             await this.telegramWebService.publishNotify({
                 symbol: event.symbol,
                 markdown,
@@ -1979,6 +1994,9 @@ class TelegramLogicService {
                 event,
             });
             const markdown = await this.telegramTemplateService.getScheduledMarkdown(event);
+            if (!markdown) {
+                return;
+            }
             await this.telegramWebService.publishNotify({
                 symbol: event.symbol,
                 markdown,
@@ -1989,6 +2007,9 @@ class TelegramLogicService {
                 event,
             });
             const markdown = await this.telegramTemplateService.getCancelledMarkdown(event);
+            if (!markdown) {
+                return;
+            }
             await this.telegramWebService.publishNotify({
                 symbol: event.symbol,
                 markdown,
@@ -1999,6 +2020,9 @@ class TelegramLogicService {
                 event,
             });
             const markdown = await this.telegramTemplateService.getOpenedMarkdown(event);
+            if (!markdown) {
+                return;
+            }
             await this.telegramWebService.publishNotify({
                 symbol: event.symbol,
                 markdown,
@@ -2009,6 +2033,9 @@ class TelegramLogicService {
                 event,
             });
             const markdown = await this.telegramTemplateService.getClosedMarkdown(event);
+            if (!markdown) {
+                return;
+            }
             await this.telegramWebService.publishNotify({
                 symbol: event.symbol,
                 markdown,
@@ -2019,6 +2046,9 @@ class TelegramLogicService {
                 event,
             });
             const markdown = await this.telegramTemplateService.getRiskMarkdown(event);
+            if (!markdown) {
+                return;
+            }
             await this.telegramWebService.publishNotify({
                 symbol: event.symbol,
                 markdown,
@@ -2029,6 +2059,9 @@ class TelegramLogicService {
                 event,
             });
             const markdown = await this.telegramTemplateService.getAverageBuyMarkdown(event);
+            if (!markdown) {
+                return;
+            }
             await this.telegramWebService.publishNotify({
                 symbol: event.symbol,
                 markdown,
@@ -2039,6 +2072,9 @@ class TelegramLogicService {
                 event,
             });
             const markdown = await this.telegramTemplateService.getSignalOpenMarkdown(event);
+            if (!markdown) {
+                return;
+            }
             await this.telegramWebService.publishNotify({
                 symbol: event.symbol,
                 markdown,
@@ -2049,6 +2085,9 @@ class TelegramLogicService {
                 event,
             });
             const markdown = await this.telegramTemplateService.getSignalCloseMarkdown(event);
+            if (!markdown) {
+                return;
+            }
             await this.telegramWebService.publishNotify({
                 symbol: event.symbol,
                 markdown,
@@ -2059,6 +2098,9 @@ class TelegramLogicService {
                 event,
             });
             const markdown = await this.telegramTemplateService.getSignalInfoMarkdown(event);
+            if (!markdown) {
+                return;
+            }
             await this.telegramWebService.publishNotify({
                 symbol: event.symbol,
                 markdown,
@@ -2069,6 +2111,9 @@ class TelegramLogicService {
                 event,
             });
             const markdown = await this.telegramTemplateService.getCancelScheduledMarkdown(event);
+            if (!markdown) {
+                return;
+            }
             await this.telegramWebService.publishNotify({
                 symbol: event.symbol,
                 markdown,
@@ -2079,6 +2124,9 @@ class TelegramLogicService {
                 event,
             });
             const markdown = await this.telegramTemplateService.getClosePendingMarkdown(event);
+            if (!markdown) {
+                return;
+            }
             await this.telegramWebService.publishNotify({
                 symbol: event.symbol,
                 markdown,
@@ -2180,104 +2228,182 @@ const RENDER_TEMPLATE_FN = async (fileName, event, self) => {
     const template = await READ_TEMPLATE_FN(fileName, self);
     return Mustache.render(template, event);
 };
+const GET_TELEGRAM_CONFIG_FN = async (self) => {
+    const exports = await self.configConnectionService.loadConfig("telegram.config");
+    if (!exports) {
+        return null;
+    }
+    return "default" in exports
+        ? exports.default
+        : exports;
+};
 class TelegramTemplateService {
     constructor() {
         this.loggerService = inject(TYPES.loggerService);
         this.resolveService = inject(TYPES.resolveService);
+        this.configConnectionService = inject(TYPES.configConnectionService);
+        this.getTelegramAdapter = functoolsKit.singleshot(async () => {
+            this.loggerService.log("telegramTemplateService getTelegramAdapter");
+            return await GET_TELEGRAM_CONFIG_FN(this);
+        });
         this.getTrailingTakeMarkdown = async (event) => {
             this.loggerService.log("telegramTemplateService getTrailingTakeMarkdown", {
                 event,
             });
+            const adapter = await this.getTelegramAdapter();
+            if (adapter?.getTrailingTakeMarkdown) {
+                return await adapter.getTrailingTakeMarkdown(event);
+            }
             return await RENDER_TEMPLATE_FN("trailing-take.mustache", event, this);
         };
         this.getTrailingStopMarkdown = async (event) => {
             this.loggerService.log("telegramTemplateService getTrailingStopMarkdown", {
                 event,
             });
+            const adapter = await this.getTelegramAdapter();
+            if (adapter?.getTrailingStopMarkdown) {
+                return await adapter.getTrailingStopMarkdown(event);
+            }
             return await RENDER_TEMPLATE_FN("trailing-stop.mustache", event, this);
         };
         this.getBreakevenMarkdown = async (event) => {
             this.loggerService.log("telegramTemplateService getBreakevenMarkdown", {
                 event,
             });
+            const adapter = await this.getTelegramAdapter();
+            if (adapter?.getBreakevenMarkdown) {
+                return await adapter.getBreakevenMarkdown(event);
+            }
             return await RENDER_TEMPLATE_FN("breakeven.mustache", event, this);
         };
         this.getPartialProfitMarkdown = async (event) => {
             this.loggerService.log("telegramTemplateService getPartialProfitMarkdown", {
                 event,
             });
+            const adapter = await this.getTelegramAdapter();
+            if (adapter?.getPartialProfitMarkdown) {
+                return await adapter.getPartialProfitMarkdown(event);
+            }
             return await RENDER_TEMPLATE_FN("partial-profit.mustache", event, this);
         };
         this.getPartialLossMarkdown = async (event) => {
             this.loggerService.log("telegramTemplateService getPartialLossMarkdown", {
                 event,
             });
+            const adapter = await this.getTelegramAdapter();
+            if (adapter?.getPartialLossMarkdown) {
+                return await adapter.getPartialLossMarkdown(event);
+            }
             return await RENDER_TEMPLATE_FN("partial-loss.mustache", event, this);
         };
         this.getScheduledMarkdown = async (event) => {
             this.loggerService.log("telegramTemplateService getScheduledMarkdown", {
                 event,
             });
+            const adapter = await this.getTelegramAdapter();
+            if (adapter?.getScheduledMarkdown) {
+                return await adapter.getScheduledMarkdown(event);
+            }
             return await RENDER_TEMPLATE_FN("scheduled.mustache", event, this);
         };
         this.getCancelledMarkdown = async (event) => {
             this.loggerService.log("telegramTemplateService getCancelledMarkdown", {
                 event,
             });
+            const adapter = await this.getTelegramAdapter();
+            if (adapter?.getCancelledMarkdown) {
+                return await adapter.getCancelledMarkdown(event);
+            }
             return await RENDER_TEMPLATE_FN("cancelled.mustache", event, this);
         };
         this.getOpenedMarkdown = async (event) => {
             this.loggerService.log("telegramTemplateService getOpenedMarkdown", {
                 event,
             });
+            const adapter = await this.getTelegramAdapter();
+            if (adapter?.getOpenedMarkdown) {
+                return await adapter.getOpenedMarkdown(event);
+            }
             return await RENDER_TEMPLATE_FN("opened.mustache", event, this);
         };
         this.getClosedMarkdown = async (event) => {
             this.loggerService.log("telegramTemplateService getClosedMarkdown", {
                 event,
             });
+            const adapter = await this.getTelegramAdapter();
+            if (adapter?.getClosedMarkdown) {
+                return await adapter.getClosedMarkdown(event);
+            }
             return await RENDER_TEMPLATE_FN("closed.mustache", event, this);
         };
         this.getRiskMarkdown = async (event) => {
             this.loggerService.log("telegramTemplateService getRiskMarkdown", {
                 event,
             });
+            const adapter = await this.getTelegramAdapter();
+            if (adapter?.getRiskMarkdown) {
+                return await adapter.getRiskMarkdown(event);
+            }
             return await RENDER_TEMPLATE_FN("risk.mustache", event, this);
         };
         this.getAverageBuyMarkdown = async (event) => {
             this.loggerService.log("telegramTemplateService getAverageBuyMarkdown", {
                 event,
             });
+            const adapter = await this.getTelegramAdapter();
+            if (adapter?.getAverageBuyMarkdown) {
+                return await adapter.getAverageBuyMarkdown(event);
+            }
             return await RENDER_TEMPLATE_FN("average-buy.mustache", event, this);
         };
         this.getSignalOpenMarkdown = async (event) => {
             this.loggerService.log("telegramTemplateService getSignalOpenMarkdown", {
                 event,
             });
+            const adapter = await this.getTelegramAdapter();
+            if (adapter?.getSignalOpenMarkdown) {
+                return await adapter.getSignalOpenMarkdown(event);
+            }
             return await RENDER_TEMPLATE_FN("signal-open.mustache", event, this);
         };
         this.getSignalCloseMarkdown = async (event) => {
             this.loggerService.log("telegramTemplateService getSignalCloseMarkdown", {
                 event,
             });
+            const adapter = await this.getTelegramAdapter();
+            if (adapter?.getSignalCloseMarkdown) {
+                return await adapter.getSignalCloseMarkdown(event);
+            }
             return await RENDER_TEMPLATE_FN("signal-close.mustache", event, this);
         };
         this.getCancelScheduledMarkdown = async (event) => {
             this.loggerService.log("telegramTemplateService getCancelScheduledMarkdown", {
                 event,
             });
+            const adapter = await this.getTelegramAdapter();
+            if (adapter?.getCancelScheduledMarkdown) {
+                return await adapter.getCancelScheduledMarkdown(event);
+            }
             return await RENDER_TEMPLATE_FN("cancel-scheduled.mustache", event, this);
         };
         this.getClosePendingMarkdown = async (event) => {
             this.loggerService.log("telegramTemplateService getClosePendingMarkdown", {
                 event,
             });
+            const adapter = await this.getTelegramAdapter();
+            if (adapter?.getClosePendingMarkdown) {
+                return await adapter.getClosePendingMarkdown(event);
+            }
             return await RENDER_TEMPLATE_FN("close-pending.mustache", event, this);
         };
         this.getSignalInfoMarkdown = async (event) => {
             this.loggerService.log("telegramTemplateService getSignalInfoMarkdown", {
                 event,
             });
+            const adapter = await this.getTelegramAdapter();
+            if (adapter?.getSignalInfoMarkdown) {
+                return await adapter.getSignalInfoMarkdown(event);
+            }
             return await RENDER_TEMPLATE_FN("signal-info.mustache", event, this);
         };
     }
@@ -2854,7 +2980,7 @@ const main$d = async () => {
     if (MODES.some((mode) => values[mode])) {
         return;
     }
-    process.stdout.write(`@backtest-kit/cli ${"7.3.0"}\n`);
+    process.stdout.write(`@backtest-kit/cli ${"7.4.0"}\n`);
     process.stdout.write("\n");
     process.stdout.write(`Run with --help to see available commands.\n`);
     process.stdout.write("\n");
@@ -3518,7 +3644,7 @@ const main$1 = async () => {
     if (!values.help) {
         return;
     }
-    process.stdout.write(`@backtest-kit/cli ${"7.3.0"}\n\n`);
+    process.stdout.write(`@backtest-kit/cli ${"7.4.0"}\n\n`);
     process.stdout.write(HELP_TEXT);
     process.exit(0);
 };
@@ -3532,7 +3658,7 @@ const main = async () => {
     if (!values.version) {
         return;
     }
-    process.stdout.write(`@backtest-kit/cli ${"7.3.0"}\n`);
+    process.stdout.write(`@backtest-kit/cli ${"7.4.0"}\n`);
     process.exit(0);
 };
 main();

package/build/index.mjs

@@ -1904,6 +1904,9 @@ class TelegramLogicService {
                 event,
             });
             const markdown = await this.telegramTemplateService.getTrailingTakeMarkdown(event);
+            if (!markdown) {
+                return;
+            }
             await this.telegramWebService.publishNotify({
                 symbol: event.symbol,
                 markdown,
@@ -1914,6 +1917,9 @@ class TelegramLogicService {
                 event,
             });
             const markdown = await this.telegramTemplateService.getTrailingStopMarkdown(event);
+            if (!markdown) {
+                return;
+            }
             await this.telegramWebService.publishNotify({
                 symbol: event.symbol,
                 markdown,
@@ -1924,6 +1930,9 @@ class TelegramLogicService {
                 event,
             });
             const markdown = await this.telegramTemplateService.getBreakevenMarkdown(event);
+            if (!markdown) {
+                return;
+            }
             await this.telegramWebService.publishNotify({
                 symbol: event.symbol,
                 markdown,
@@ -1934,6 +1943,9 @@ class TelegramLogicService {
                 event,
             });
             const markdown = await this.telegramTemplateService.getPartialProfitMarkdown(event);
+            if (!markdown) {
+                return;
+            }
             await this.telegramWebService.publishNotify({
                 symbol: event.symbol,
                 markdown,
@@ -1944,6 +1956,9 @@ class TelegramLogicService {
                 event,
             });
             const markdown = await this.telegramTemplateService.getPartialLossMarkdown(event);
+            if (!markdown) {
+                return;
+            }
             await this.telegramWebService.publishNotify({
                 symbol: event.symbol,
                 markdown,
@@ -1954,6 +1969,9 @@ class TelegramLogicService {
                 event,
             });
             const markdown = await this.telegramTemplateService.getScheduledMarkdown(event);
+            if (!markdown) {
+                return;
+            }
             await this.telegramWebService.publishNotify({
                 symbol: event.symbol,
                 markdown,
@@ -1964,6 +1982,9 @@ class TelegramLogicService {
                 event,
             });
             const markdown = await this.telegramTemplateService.getCancelledMarkdown(event);
+            if (!markdown) {
+                return;
+            }
             await this.telegramWebService.publishNotify({
                 symbol: event.symbol,
                 markdown,
@@ -1974,6 +1995,9 @@ class TelegramLogicService {
                 event,
             });
             const markdown = await this.telegramTemplateService.getOpenedMarkdown(event);
+            if (!markdown) {
+                return;
+            }
             await this.telegramWebService.publishNotify({
                 symbol: event.symbol,
                 markdown,
@@ -1984,6 +2008,9 @@ class TelegramLogicService {
                 event,
             });
             const markdown = await this.telegramTemplateService.getClosedMarkdown(event);
+            if (!markdown) {
+                return;
+            }
             await this.telegramWebService.publishNotify({
                 symbol: event.symbol,
                 markdown,
@@ -1994,6 +2021,9 @@ class TelegramLogicService {
                 event,
             });
             const markdown = await this.telegramTemplateService.getRiskMarkdown(event);
+            if (!markdown) {
+                return;
+            }
             await this.telegramWebService.publishNotify({
                 symbol: event.symbol,
                 markdown,
@@ -2004,6 +2034,9 @@ class TelegramLogicService {
                 event,
             });
             const markdown = await this.telegramTemplateService.getAverageBuyMarkdown(event);
+            if (!markdown) {
+                return;
+            }
             await this.telegramWebService.publishNotify({
                 symbol: event.symbol,
                 markdown,
@@ -2014,6 +2047,9 @@ class TelegramLogicService {
                 event,
             });
             const markdown = await this.telegramTemplateService.getSignalOpenMarkdown(event);
+            if (!markdown) {
+                return;
+            }
             await this.telegramWebService.publishNotify({
                 symbol: event.symbol,
                 markdown,
@@ -2024,6 +2060,9 @@ class TelegramLogicService {
                 event,
             });
             const markdown = await this.telegramTemplateService.getSignalCloseMarkdown(event);
+            if (!markdown) {
+                return;
+            }
             await this.telegramWebService.publishNotify({
                 symbol: event.symbol,
                 markdown,
@@ -2034,6 +2073,9 @@ class TelegramLogicService {
                 event,
             });
             const markdown = await this.telegramTemplateService.getSignalInfoMarkdown(event);
+            if (!markdown) {
+                return;
+            }
             await this.telegramWebService.publishNotify({
                 symbol: event.symbol,
                 markdown,
@@ -2044,6 +2086,9 @@ class TelegramLogicService {
                 event,
             });
             const markdown = await this.telegramTemplateService.getCancelScheduledMarkdown(event);
+            if (!markdown) {
+                return;
+            }
             await this.telegramWebService.publishNotify({
                 symbol: event.symbol,
                 markdown,
@@ -2054,6 +2099,9 @@ class TelegramLogicService {
                 event,
             });
             const markdown = await this.telegramTemplateService.getClosePendingMarkdown(event);
+            if (!markdown) {
+                return;
+            }
             await this.telegramWebService.publishNotify({
                 symbol: event.symbol,
                 markdown,
@@ -2155,104 +2203,182 @@ const RENDER_TEMPLATE_FN = async (fileName, event, self) => {
     const template = await READ_TEMPLATE_FN(fileName, self);
     return Mustache.render(template, event);
 };
+const GET_TELEGRAM_CONFIG_FN = async (self) => {
+    const exports = await self.configConnectionService.loadConfig("telegram.config");
+    if (!exports) {
+        return null;
+    }
+    return "default" in exports
+        ? exports.default
+        : exports;
+};
 class TelegramTemplateService {
     constructor() {
         this.loggerService = inject(TYPES.loggerService);
         this.resolveService = inject(TYPES.resolveService);
+        this.configConnectionService = inject(TYPES.configConnectionService);
+        this.getTelegramAdapter = singleshot(async () => {
+            this.loggerService.log("telegramTemplateService getTelegramAdapter");
+            return await GET_TELEGRAM_CONFIG_FN(this);
+        });
         this.getTrailingTakeMarkdown = async (event) => {
             this.loggerService.log("telegramTemplateService getTrailingTakeMarkdown", {
                 event,
             });
+            const adapter = await this.getTelegramAdapter();
+            if (adapter?.getTrailingTakeMarkdown) {
+                return await adapter.getTrailingTakeMarkdown(event);
+            }
             return await RENDER_TEMPLATE_FN("trailing-take.mustache", event, this);
         };
         this.getTrailingStopMarkdown = async (event) => {
             this.loggerService.log("telegramTemplateService getTrailingStopMarkdown", {
                 event,
             });
+            const adapter = await this.getTelegramAdapter();
+            if (adapter?.getTrailingStopMarkdown) {
+                return await adapter.getTrailingStopMarkdown(event);
+            }
             return await RENDER_TEMPLATE_FN("trailing-stop.mustache", event, this);
         };
         this.getBreakevenMarkdown = async (event) => {
             this.loggerService.log("telegramTemplateService getBreakevenMarkdown", {
                 event,
             });
+            const adapter = await this.getTelegramAdapter();
+            if (adapter?.getBreakevenMarkdown) {
+                return await adapter.getBreakevenMarkdown(event);
+            }
             return await RENDER_TEMPLATE_FN("breakeven.mustache", event, this);
         };
         this.getPartialProfitMarkdown = async (event) => {
             this.loggerService.log("telegramTemplateService getPartialProfitMarkdown", {
                 event,
             });
+            const adapter = await this.getTelegramAdapter();
+            if (adapter?.getPartialProfitMarkdown) {
+                return await adapter.getPartialProfitMarkdown(event);
+            }
             return await RENDER_TEMPLATE_FN("partial-profit.mustache", event, this);
         };
         this.getPartialLossMarkdown = async (event) => {
             this.loggerService.log("telegramTemplateService getPartialLossMarkdown", {
                 event,
             });
+            const adapter = await this.getTelegramAdapter();
+            if (adapter?.getPartialLossMarkdown) {
+                return await adapter.getPartialLossMarkdown(event);
+            }
             return await RENDER_TEMPLATE_FN("partial-loss.mustache", event, this);
         };
         this.getScheduledMarkdown = async (event) => {
             this.loggerService.log("telegramTemplateService getScheduledMarkdown", {
                 event,
             });
+            const adapter = await this.getTelegramAdapter();
+            if (adapter?.getScheduledMarkdown) {
+                return await adapter.getScheduledMarkdown(event);
+            }
             return await RENDER_TEMPLATE_FN("scheduled.mustache", event, this);
         };
         this.getCancelledMarkdown = async (event) => {
             this.loggerService.log("telegramTemplateService getCancelledMarkdown", {
                 event,
             });
+            const adapter = await this.getTelegramAdapter();
+            if (adapter?.getCancelledMarkdown) {
+                return await adapter.getCancelledMarkdown(event);
+            }
             return await RENDER_TEMPLATE_FN("cancelled.mustache", event, this);
         };
         this.getOpenedMarkdown = async (event) => {
             this.loggerService.log("telegramTemplateService getOpenedMarkdown", {
                 event,
             });
+            const adapter = await this.getTelegramAdapter();
+            if (adapter?.getOpenedMarkdown) {
+                return await adapter.getOpenedMarkdown(event);
+            }
             return await RENDER_TEMPLATE_FN("opened.mustache", event, this);
         };
         this.getClosedMarkdown = async (event) => {
             this.loggerService.log("telegramTemplateService getClosedMarkdown", {
                 event,
             });
+            const adapter = await this.getTelegramAdapter();
+            if (adapter?.getClosedMarkdown) {
+                return await adapter.getClosedMarkdown(event);
+            }
             return await RENDER_TEMPLATE_FN("closed.mustache", event, this);
         };
         this.getRiskMarkdown = async (event) => {
             this.loggerService.log("telegramTemplateService getRiskMarkdown", {
                 event,
             });
+            const adapter = await this.getTelegramAdapter();
+            if (adapter?.getRiskMarkdown) {
+                return await adapter.getRiskMarkdown(event);
+            }
             return await RENDER_TEMPLATE_FN("risk.mustache", event, this);
         };
         this.getAverageBuyMarkdown = async (event) => {
             this.loggerService.log("telegramTemplateService getAverageBuyMarkdown", {
                 event,
             });
+            const adapter = await this.getTelegramAdapter();
+            if (adapter?.getAverageBuyMarkdown) {
+                return await adapter.getAverageBuyMarkdown(event);
+            }
             return await RENDER_TEMPLATE_FN("average-buy.mustache", event, this);
         };
         this.getSignalOpenMarkdown = async (event) => {
             this.loggerService.log("telegramTemplateService getSignalOpenMarkdown", {
                 event,
             });
+            const adapter = await this.getTelegramAdapter();
+            if (adapter?.getSignalOpenMarkdown) {
+                return await adapter.getSignalOpenMarkdown(event);
+            }
             return await RENDER_TEMPLATE_FN("signal-open.mustache", event, this);
         };
         this.getSignalCloseMarkdown = async (event) => {
             this.loggerService.log("telegramTemplateService getSignalCloseMarkdown", {
                 event,
             });
+            const adapter = await this.getTelegramAdapter();
+            if (adapter?.getSignalCloseMarkdown) {
+                return await adapter.getSignalCloseMarkdown(event);
+            }
             return await RENDER_TEMPLATE_FN("signal-close.mustache", event, this);
         };
         this.getCancelScheduledMarkdown = async (event) => {
             this.loggerService.log("telegramTemplateService getCancelScheduledMarkdown", {
                 event,
             });
+            const adapter = await this.getTelegramAdapter();
+            if (adapter?.getCancelScheduledMarkdown) {
+                return await adapter.getCancelScheduledMarkdown(event);
+            }
             return await RENDER_TEMPLATE_FN("cancel-scheduled.mustache", event, this);
         };
         this.getClosePendingMarkdown = async (event) => {
             this.loggerService.log("telegramTemplateService getClosePendingMarkdown", {
                 event,
             });
+            const adapter = await this.getTelegramAdapter();
+            if (adapter?.getClosePendingMarkdown) {
+                return await adapter.getClosePendingMarkdown(event);
+            }
             return await RENDER_TEMPLATE_FN("close-pending.mustache", event, this);
         };
         this.getSignalInfoMarkdown = async (event) => {
             this.loggerService.log("telegramTemplateService getSignalInfoMarkdown", {
                 event,
             });
+            const adapter = await this.getTelegramAdapter();
+            if (adapter?.getSignalInfoMarkdown) {
+                return await adapter.getSignalInfoMarkdown(event);
+            }
             return await RENDER_TEMPLATE_FN("signal-info.mustache", event, this);
         };
     }
@@ -2825,7 +2951,7 @@ const main$d = async () => {
     if (MODES.some((mode) => values[mode])) {
         return;
     }
-    process.stdout.write(`@backtest-kit/cli ${"7.3.0"}\n`);
+    process.stdout.write(`@backtest-kit/cli ${"7.4.0"}\n`);
     process.stdout.write("\n");
     process.stdout.write(`Run with --help to see available commands.\n`);
     process.stdout.write("\n");
@@ -3489,7 +3615,7 @@ const main$1 = async () => {
     if (!values.help) {
         return;
     }
-    process.stdout.write(`@backtest-kit/cli ${"7.3.0"}\n\n`);
+    process.stdout.write(`@backtest-kit/cli ${"7.4.0"}\n\n`);
     process.stdout.write(HELP_TEXT);
     process.exit(0);
 };
@@ -3503,7 +3629,7 @@ const main = async () => {
     if (!values.version) {
         return;
     }
-    process.stdout.write(`@backtest-kit/cli ${"7.3.0"}\n`);
+    process.stdout.write(`@backtest-kit/cli ${"7.4.0"}\n`);
     process.exit(0);
 };
 main();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@backtest-kit/cli",
-  "version": "7.3.0",
+  "version": "7.4.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",
@@ -62,11 +62,11 @@
   "devDependencies": {
     "@babel/plugin-transform-modules-umd": "7.27.1",
     "@babel/standalone": "7.29.1",
-    "@backtest-kit/graph": "7.3.0",
-    "@backtest-kit/ollama": "7.3.0",
-    "@backtest-kit/pinets": "7.3.0",
-    "@backtest-kit/signals": "7.3.0",
-    "@backtest-kit/ui": "7.3.0",
+    "@backtest-kit/graph": "7.4.0",
+    "@backtest-kit/ollama": "7.4.0",
+    "@backtest-kit/pinets": "7.4.0",
+    "@backtest-kit/signals": "7.4.0",
+    "@backtest-kit/ui": "7.4.0",
     "@rollup/plugin-replace": "6.0.3",
     "@rollup/plugin-typescript": "11.1.6",
     "@types/image-size": "0.7.0",
@@ -74,7 +74,7 @@
     "@types/mustache": "4.2.6",
     "@types/node": "22.9.0",
     "@types/stack-trace": "0.0.33",
-    "backtest-kit": "7.3.0",
+    "backtest-kit": "7.4.0",
     "glob": "11.0.1",
     "markdown-it": "14.1.1",
     "rimraf": "6.0.1",
@@ -89,12 +89,12 @@
   "peerDependencies": {
     "@babel/plugin-transform-modules-umd": "^7.27.1",
     "@babel/standalone": "^7.29.1",
-    "@backtest-kit/graph": "^7.3.0",
-    "@backtest-kit/ollama": "^7.3.0",
-    "@backtest-kit/pinets": "^7.3.0",
-    "@backtest-kit/signals": "^7.3.0",
-    "@backtest-kit/ui": "^7.3.0",
-    "backtest-kit": "^7.3.0",
+    "@backtest-kit/graph": "^7.4.0",
+    "@backtest-kit/ollama": "^7.4.0",
+    "@backtest-kit/pinets": "^7.4.0",
+    "@backtest-kit/signals": "^7.4.0",
+    "@backtest-kit/ui": "^7.4.0",
+    "backtest-kit": "^7.4.0",
     "markdown-it": "^14.1.1",
     "typescript": "^5.0.0"
   },

package/template/project/package.mustache

@@ -13,12 +13,12 @@
   "license": "ISC",
   "type": "commonjs",
   "dependencies": {
-    "@backtest-kit/cli": "^7.2.0",
-    "@backtest-kit/graph": "^7.2.0",
-    "@backtest-kit/pinets": "^7.2.0",
-    "@backtest-kit/ui": "^7.2.0",
+    "@backtest-kit/cli": "^7.4.0",
+    "@backtest-kit/graph": "^7.4.0",
+    "@backtest-kit/pinets": "^7.4.0",
+    "@backtest-kit/ui": "^7.4.0",
     "agent-swarm-kit": "^2.6.0",
-    "backtest-kit": "^7.2.0",
+    "backtest-kit": "^7.4.0",
     "functools-kit": "^2.3.0",
     "garch": "^1.2.3",
     "get-moment-stamp": "^1.1.2",

package/types.d.ts

@@ -317,9 +317,43 @@ declare class TelegramLogicService {
     connect: (() => () => void) & functools_kit.ISingleshotClearable<() => () => void>;
 }
 
-declare class TelegramTemplateService {
+interface NotificationConfig {
+    signal: boolean;
+    risk: boolean;
+    info: boolean;
+    breakeven: boolean;
+    common_error: boolean;
+    critical_error: boolean;
+    validation_error: boolean;
+    partial_loss: boolean;
+    partial_profit: boolean;
+    signal_sync: boolean;
+    strategy_commit: boolean;
+}
+interface TelegramConfig {
+    getTrailingTakeMarkdown(event: TrailingTakeCommit): Promise<string>;
+    getTrailingStopMarkdown(event: TrailingStopCommit): Promise<string>;
+    getBreakevenMarkdown(event: BreakevenCommit): Promise<string>;
+    getPartialProfitMarkdown(event: PartialProfitCommit): Promise<string>;
+    getPartialLossMarkdown(event: PartialLossCommit): Promise<string>;
+    getScheduledMarkdown(event: IStrategyTickResultScheduled): Promise<string>;
+    getCancelledMarkdown(event: IStrategyTickResultCancelled): Promise<string>;
+    getOpenedMarkdown(event: IStrategyTickResultOpened): Promise<string>;
+    getClosedMarkdown(event: IStrategyTickResultClosed): Promise<string>;
+    getRiskMarkdown(event: RiskContract): Promise<string>;
+    getAverageBuyMarkdown(event: AverageBuyCommit): Promise<string>;
+    getSignalOpenMarkdown(event: SignalOpenContract): Promise<string>;
+    getSignalCloseMarkdown(event: SignalCloseContract): Promise<string>;
+    getCancelScheduledMarkdown(event: CancelScheduledCommit): Promise<string>;
+    getClosePendingMarkdown(event: ClosePendingCommit): Promise<string>;
+    getSignalInfoMarkdown(event: SignalInfoContract): Promise<string>;
+}
+
+declare class TelegramTemplateService implements TelegramConfig {
     readonly loggerService: LoggerService;
     readonly resolveService: ResolveService;
+    readonly configConnectionService: ConfigConnectionService;
+    private getTelegramAdapter;
     getTrailingTakeMarkdown: (event: TrailingTakeCommit) => Promise<string>;
     getTrailingStopMarkdown: (event: TrailingStopCommit) => Promise<string>;
     getBreakevenMarkdown: (event: BreakevenCommit) => Promise<string>;
@@ -345,20 +379,6 @@ declare class ModuleConnectionService {
     loadModule: (fileName: string) => Promise<boolean>;
 }
 
-interface NotificationConfig {
-    signal: boolean;
-    risk: boolean;
-    info: boolean;
-    breakeven: boolean;
-    common_error: boolean;
-    critical_error: boolean;
-    validation_error: boolean;
-    partial_loss: boolean;
-    partial_profit: boolean;
-    signal_sync: boolean;
-    strategy_commit: boolean;
-}
-
 declare class ConfigService {
     readonly loggerService: LoggerService;
     readonly configConnectionService: ConfigConnectionService;