@backtest-kit/cli 7.3.1 → 7.5.0

package/build/index.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import * as BacktestKit from 'backtest-kit';
-import { setConfig, Log, listExchangeSchema, addExchangeSchema, roundTicks, listFrameSchema, addFrameSchema, listenDoneLive, listenDoneBacktest, shutdown, listenSignal, Notification, Recent, Storage, Markdown, Report, Dump, Memory, StorageLive, StorageBacktest, RecentLive, RecentBacktest, NotificationLive, NotificationBacktest, MarkdownWriter, ReportWriter, PersistSignalAdapter, PersistRiskAdapter, PersistScheduleAdapter, PersistPartialAdapter, PersistBreakevenAdapter, PersistCandleAdapter, PersistStorageAdapter, PersistNotificationAdapter, PersistLogAdapter, PersistMeasureAdapter, PersistIntervalAdapter, PersistMemoryAdapter, PersistRecentAdapter, listStrategySchema, overrideExchangeSchema, Backtest, Session, Cache, Interval, alignToInterval, addWalkerSchema, overrideWalkerSchema, Walker, listenDoneWalker, Live, getCandles, checkCandles, warmCandles, listenRisk, listenStrategyCommit, listenSync, listenSignalNotify, Exchange } from 'backtest-kit';
+import { setConfig, Log, listExchangeSchema, addExchangeSchema, roundTicks, listFrameSchema, addFrameSchema, listenDoneLive, listenDoneBacktest, shutdown, listenSignal, Notification, Recent, Storage, Markdown, Report, Dump, State, Memory, StorageLive, StorageBacktest, RecentLive, RecentBacktest, NotificationLive, NotificationBacktest, MemoryLive, MemoryBacktest, StateLive, StateBacktest, MarkdownWriter, ReportWriter, PersistSignalAdapter, PersistRiskAdapter, PersistScheduleAdapter, PersistPartialAdapter, PersistBreakevenAdapter, PersistCandleAdapter, PersistStorageAdapter, PersistNotificationAdapter, PersistLogAdapter, PersistMeasureAdapter, PersistIntervalAdapter, PersistMemoryAdapter, PersistRecentAdapter, PersistStateAdapter, listStrategySchema, overrideExchangeSchema, Backtest, Session, Cache, Interval, alignToInterval, addWalkerSchema, overrideWalkerSchema, Walker, listenDoneWalker, Live, getCandles, checkCandles, warmCandles, listenRisk, listenStrategyCommit, listenSync, listenSignalNotify, Exchange } from 'backtest-kit';
 import { getErrorMessage, errorData, singleshot, str, BehaviorSubject, compose, createAwaiter, execpool, queued, sleep, randomString, TIMEOUT_SYMBOL, typo, retry, trycatch, memoize, isObject } from 'functools-kit';
 import fs, { constants } from 'fs';
 import * as stackTrace from 'stack-trace';
@@ -545,6 +545,22 @@ const getArgs = singleshot(() => {
                 type: "boolean",
                 default: false,
             },
+            pnldebug: {
+                type: "boolean",
+                default: false,
+            },
+            priceopen: {
+                type: "string",
+                default: "",
+            },
+            direction: {
+                type: "string",
+                default: "",
+            },
+            minutes: {
+                type: "string",
+                default: "",
+            },
             init: {
                 type: "boolean",
                 default: false,
@@ -691,11 +707,11 @@ class SetupUtils {
                 Markdown.enable();
                 Report.enable();
                 Dump.enable();
+                State.enable();
                 Memory.enable();
             }
             {
                 Dump.useMarkdown();
-                Memory.usePersist();
             }
             {
                 StorageLive.usePersist();
@@ -709,6 +725,18 @@ class SetupUtils {
                 NotificationLive.usePersist();
                 NotificationBacktest.useMemory();
             }
+            {
+                RecentLive.usePersist();
+                RecentBacktest.useMemory();
+            }
+            {
+                MemoryLive.usePersist();
+                MemoryBacktest.useLocal();
+            }
+            {
+                StateLive.usePersist();
+                StateBacktest.useLocal();
+            }
             {
                 Markdown.useDummy();
                 Log.useJsonl();
@@ -751,6 +779,7 @@ class SetupUtils {
                 PersistIntervalAdapter.clear();
                 PersistMemoryAdapter.clear();
                 PersistRecentAdapter.clear();
+                PersistStateAdapter.clear();
             }
             {
                 Dump.clear();
@@ -1904,6 +1933,9 @@ class TelegramLogicService {
                 event,
             });
             const markdown = await this.telegramTemplateService.getTrailingTakeMarkdown(event);
+            if (!markdown) {
+                return;
+            }
             await this.telegramWebService.publishNotify({
                 symbol: event.symbol,
                 markdown,
@@ -1914,6 +1946,9 @@ class TelegramLogicService {
                 event,
             });
             const markdown = await this.telegramTemplateService.getTrailingStopMarkdown(event);
+            if (!markdown) {
+                return;
+            }
             await this.telegramWebService.publishNotify({
                 symbol: event.symbol,
                 markdown,
@@ -1924,6 +1959,9 @@ class TelegramLogicService {
                 event,
             });
             const markdown = await this.telegramTemplateService.getBreakevenMarkdown(event);
+            if (!markdown) {
+                return;
+            }
             await this.telegramWebService.publishNotify({
                 symbol: event.symbol,
                 markdown,
@@ -1934,6 +1972,9 @@ class TelegramLogicService {
                 event,
             });
             const markdown = await this.telegramTemplateService.getPartialProfitMarkdown(event);
+            if (!markdown) {
+                return;
+            }
             await this.telegramWebService.publishNotify({
                 symbol: event.symbol,
                 markdown,
@@ -1944,6 +1985,9 @@ class TelegramLogicService {
                 event,
             });
             const markdown = await this.telegramTemplateService.getPartialLossMarkdown(event);
+            if (!markdown) {
+                return;
+            }
             await this.telegramWebService.publishNotify({
                 symbol: event.symbol,
                 markdown,
@@ -1954,6 +1998,9 @@ class TelegramLogicService {
                 event,
             });
             const markdown = await this.telegramTemplateService.getScheduledMarkdown(event);
+            if (!markdown) {
+                return;
+            }
             await this.telegramWebService.publishNotify({
                 symbol: event.symbol,
                 markdown,
@@ -1964,6 +2011,9 @@ class TelegramLogicService {
                 event,
             });
             const markdown = await this.telegramTemplateService.getCancelledMarkdown(event);
+            if (!markdown) {
+                return;
+            }
             await this.telegramWebService.publishNotify({
                 symbol: event.symbol,
                 markdown,
@@ -1974,6 +2024,9 @@ class TelegramLogicService {
                 event,
             });
             const markdown = await this.telegramTemplateService.getOpenedMarkdown(event);
+            if (!markdown) {
+                return;
+            }
             await this.telegramWebService.publishNotify({
                 symbol: event.symbol,
                 markdown,
@@ -1984,6 +2037,9 @@ class TelegramLogicService {
                 event,
             });
             const markdown = await this.telegramTemplateService.getClosedMarkdown(event);
+            if (!markdown) {
+                return;
+            }
             await this.telegramWebService.publishNotify({
                 symbol: event.symbol,
                 markdown,
@@ -1994,6 +2050,9 @@ class TelegramLogicService {
                 event,
             });
             const markdown = await this.telegramTemplateService.getRiskMarkdown(event);
+            if (!markdown) {
+                return;
+            }
             await this.telegramWebService.publishNotify({
                 symbol: event.symbol,
                 markdown,
@@ -2004,6 +2063,9 @@ class TelegramLogicService {
                 event,
             });
             const markdown = await this.telegramTemplateService.getAverageBuyMarkdown(event);
+            if (!markdown) {
+                return;
+            }
             await this.telegramWebService.publishNotify({
                 symbol: event.symbol,
                 markdown,
@@ -2014,6 +2076,9 @@ class TelegramLogicService {
                 event,
             });
             const markdown = await this.telegramTemplateService.getSignalOpenMarkdown(event);
+            if (!markdown) {
+                return;
+            }
             await this.telegramWebService.publishNotify({
                 symbol: event.symbol,
                 markdown,
@@ -2024,6 +2089,9 @@ class TelegramLogicService {
                 event,
             });
             const markdown = await this.telegramTemplateService.getSignalCloseMarkdown(event);
+            if (!markdown) {
+                return;
+            }
             await this.telegramWebService.publishNotify({
                 symbol: event.symbol,
                 markdown,
@@ -2034,6 +2102,9 @@ class TelegramLogicService {
                 event,
             });
             const markdown = await this.telegramTemplateService.getSignalInfoMarkdown(event);
+            if (!markdown) {
+                return;
+            }
             await this.telegramWebService.publishNotify({
                 symbol: event.symbol,
                 markdown,
@@ -2044,6 +2115,9 @@ class TelegramLogicService {
                 event,
             });
             const markdown = await this.telegramTemplateService.getCancelScheduledMarkdown(event);
+            if (!markdown) {
+                return;
+            }
             await this.telegramWebService.publishNotify({
                 symbol: event.symbol,
                 markdown,
@@ -2054,6 +2128,9 @@ class TelegramLogicService {
                 event,
             });
             const markdown = await this.telegramTemplateService.getClosePendingMarkdown(event);
+            if (!markdown) {
+                return;
+            }
             await this.telegramWebService.publishNotify({
                 symbol: event.symbol,
                 markdown,
@@ -2155,104 +2232,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);
         };
     }
@@ -2810,14 +2965,14 @@ const cli = {
 };
 init();
 
-const MODES = ["backtest", "walker", "paper", "live", "pine", "editor", "dump", "flush", "init", "help", "version"];
+const MODES = ["backtest", "walker", "paper", "live", "pine", "editor", "dump", "pnldebug", "flush", "init", "help", "version"];
 const ENTRY_PATH$1 = "./node_modules/@backtest-kit/cli/build/index.mjs";
 const HELP_TEXT$1 = `
 Example:
 
   node ${ENTRY_PATH$1} --help
 `.trimStart();
-const main$d = async () => {
+const main$e = async () => {
     if (!getEntry(import.meta.url)) {
         return;
     }
@@ -2825,14 +2980,14 @@ const main$d = async () => {
     if (MODES.some((mode) => values[mode])) {
         return;
     }
-    process.stdout.write(`@backtest-kit/cli ${"7.3.1"}\n`);
+    process.stdout.write(`@backtest-kit/cli ${"7.5.0"}\n`);
     process.stdout.write("\n");
     process.stdout.write(`Run with --help to see available commands.\n`);
     process.stdout.write("\n");
     process.stdout.write(HELP_TEXT$1);
     process.exit(0);
 };
-main$d();
+main$e();
 
 const notifyShutdown = singleshot(async () => {
     console.log("Graceful shutdown initiated. Press Ctrl+C again to force quit.");
@@ -2848,7 +3003,7 @@ const flush = async (entryPoint) => {
         console.log(`Removed: ${target}`);
     }
 };
-const main$c = async () => {
+const main$d = async () => {
     if (!getEntry(import.meta.url)) {
         return;
     }
@@ -2865,7 +3020,7 @@ const main$c = async () => {
     }
     process.exit(0);
 };
-main$c();
+main$d();
 
 const BEFORE_EXIT_FN$5 = singleshot(async () => {
     process.off("SIGINT", BEFORE_EXIT_FN$5);
@@ -2887,7 +3042,7 @@ const BEFORE_EXIT_FN$5 = singleshot(async () => {
 const listenGracefulShutdown$5 = singleshot(() => {
     process.on("SIGINT", BEFORE_EXIT_FN$5);
 });
-const main$b = async () => {
+const main$c = async () => {
     if (!getEntry(import.meta.url)) {
         return;
     }
@@ -2902,7 +3057,7 @@ const main$b = async () => {
     await cli.backtestMainService.connect();
     listenGracefulShutdown$5();
 };
-main$b();
+main$c();
 
 const BEFORE_EXIT_FN$4 = singleshot(async () => {
     process.off("SIGINT", BEFORE_EXIT_FN$4);
@@ -2920,7 +3075,7 @@ const BEFORE_EXIT_FN$4 = singleshot(async () => {
 const listenGracefulShutdown$4 = singleshot(() => {
     process.on("SIGINT", BEFORE_EXIT_FN$4);
 });
-const main$a = async () => {
+const main$b = async () => {
     if (!getEntry(import.meta.url)) {
         return;
     }
@@ -2936,7 +3091,7 @@ const main$a = async () => {
     listenGracefulShutdown$4();
     await cli.walkerMainService.connect();
 };
-main$a();
+main$b();
 
 const BEFORE_EXIT_FN$3 = singleshot(async () => {
     process.off("SIGINT", BEFORE_EXIT_FN$3);
@@ -2957,7 +3112,7 @@ const BEFORE_EXIT_FN$3 = singleshot(async () => {
 const listenGracefulShutdown$3 = singleshot(() => {
     process.on("SIGINT", BEFORE_EXIT_FN$3);
 });
-const main$9 = async () => {
+const main$a = async () => {
     if (!getEntry(import.meta.url)) {
         return;
     }
@@ -2968,7 +3123,7 @@ const main$9 = async () => {
     cli.paperMainService.connect();
     listenGracefulShutdown$3();
 };
-main$9();
+main$a();
 
 const BEFORE_EXIT_FN$2 = singleshot(async () => {
     process.off("SIGINT", BEFORE_EXIT_FN$2);
@@ -2989,7 +3144,7 @@ const BEFORE_EXIT_FN$2 = singleshot(async () => {
 const listenGracefulShutdown$2 = singleshot(() => {
     process.on("SIGINT", BEFORE_EXIT_FN$2);
 });
-const main$8 = async () => {
+const main$9 = async () => {
     if (!getEntry(import.meta.url)) {
         return;
     }
@@ -3000,7 +3155,7 @@ const main$8 = async () => {
     await cli.liveMainService.connect();
     listenGracefulShutdown$2();
 };
-main$8();
+main$9();
 
 const BEFORE_EXIT_FN$1 = singleshot(async () => {
     process.off("SIGINT", BEFORE_EXIT_FN$1);
@@ -3010,7 +3165,7 @@ const BEFORE_EXIT_FN$1 = singleshot(async () => {
 const listenGracefulShutdown$1 = singleshot(() => {
     process.on("SIGINT", BEFORE_EXIT_FN$1);
 });
-const main$7 = async () => {
+const main$8 = async () => {
     if (!getEntry(import.meta.url)) {
         return;
     }
@@ -3020,7 +3175,7 @@ const main$7 = async () => {
     }
     listenGracefulShutdown$1();
 };
-main$7();
+main$8();
 
 const BEFORE_EXIT_FN = singleshot(async () => {
     process.off("SIGINT", BEFORE_EXIT_FN);
@@ -3030,7 +3185,7 @@ const BEFORE_EXIT_FN = singleshot(async () => {
 const listenGracefulShutdown = singleshot(() => {
     process.on("SIGINT", BEFORE_EXIT_FN);
 });
-const main$6 = async () => {
+const main$7 = async () => {
     if (!getEntry(import.meta.url)) {
         return;
     }
@@ -3040,7 +3195,7 @@ const main$6 = async () => {
     }
     listenGracefulShutdown();
 };
-main$6();
+main$7();
 
 const EXTRACT_ROWS_FN = (plots, schema) => {
     const keys = Object.keys(schema);
@@ -3062,7 +3217,7 @@ const EXTRACT_ROWS_FN = (plots, schema) => {
     }
     return rows;
 };
-const main$5 = async () => {
+const main$6 = async () => {
     if (!getEntry(import.meta.url)) {
         return;
     }
@@ -3142,9 +3297,9 @@ const main$5 = async () => {
     console.log(await toMarkdown(signalId, plots, signalSchema));
     process.exit(0);
 };
-main$5();
+main$6();
 
-const main$4 = async () => {
+const main$5 = async () => {
     if (!getEntry(import.meta.url)) {
         return;
     }
@@ -3179,9 +3334,9 @@ const main$4 = async () => {
     };
     process.on("SIGINT", beforeExit);
 };
-main$4();
+main$5();
 
-const main$3 = async () => {
+const main$4 = async () => {
     if (!getEntry(import.meta.url)) {
         return;
     }
@@ -3242,6 +3397,102 @@ const main$3 = async () => {
     console.log(JSON.stringify(candles, null, 2));
     process.exit(0);
 };
+main$4();
+
+const main$3 = async () => {
+    if (!getEntry(import.meta.url)) {
+        return;
+    }
+    const { values } = getArgs();
+    if (!values.pnldebug) {
+        return;
+    }
+    await cli.moduleConnectionService.loadModule("./pnldebug.module");
+    {
+        await cli.exchangeSchemaService.addSchema();
+        await cli.symbolSchemaService.addSchema();
+    }
+    const [defaultExchangeName = null] = await listExchangeSchema();
+    const exchangeName = values.exchange || defaultExchangeName?.exchangeName;
+    const symbol = values.symbol || "BTCUSDT";
+    const priceOpenStr = values.priceopen;
+    if (!priceOpenStr) {
+        console.error("Error: --priceopen is required");
+        process.exit(1);
+    }
+    const priceOpen = parseFloat(priceOpenStr);
+    if (isNaN(priceOpen)) {
+        console.error(`Error: --priceopen must be a number, got: ${priceOpenStr}`);
+        process.exit(1);
+    }
+    const direction = (values.direction || "long").toLowerCase();
+    if (direction !== "long" && direction !== "short") {
+        console.error(`Error: --direction must be 'long' or 'short', got: ${direction}`);
+        process.exit(1);
+    }
+    const whenStr = values.when || Date.now().toString();
+    const whenStamp = Date.parse(whenStr);
+    const when = isNaN(whenStamp) ? new Date() : new Date(whenStamp);
+    const timestamp = alignToInterval(when, "1m").getTime();
+    const minutesStr = values.minutes || "60";
+    const minutesNum = parseInt(minutesStr);
+    const minutes = isNaN(minutesNum) ? 60 : minutesNum;
+    const candles = await Exchange.getRawCandles(symbol, "1m", { exchangeName }, minutes, undefined, timestamp);
+    if (candles.length === 0) {
+        console.error("Error: no candles returned for the given parameters");
+        process.exit(1);
+    }
+    let peak = 0;
+    let drawdown = 0;
+    const rows = candles.map((c, i) => {
+        const pnl = direction === "short"
+            ? (priceOpen - c.close) / priceOpen * 100
+            : (c.close - priceOpen) / priceOpen * 100;
+        if (pnl > peak)
+            peak = pnl;
+        if (pnl < drawdown)
+            drawdown = pnl;
+        return { min: i + 1, timestamp: c.timestamp, close: c.close, pnl, peak, drawdown };
+    });
+    const dumpName = values.output || `${symbol}_${direction}_${priceOpen}_${timestamp}`;
+    const dumpDir = join(process.cwd(), "dump");
+    if (values.json) {
+        const filePath = resolve(dumpDir, `${dumpName}.json`);
+        await mkdir(dumpDir, { recursive: true });
+        await writeFile(filePath, JSON.stringify(rows, null, 2), "utf-8");
+        console.log(`Saved: ${filePath}`);
+        process.exit(0);
+    }
+    if (values.jsonl) {
+        const filePath = resolve(dumpDir, `${dumpName}.jsonl`);
+        await mkdir(dumpDir, { recursive: true });
+        await writeFile(filePath, rows.map((r) => JSON.stringify(r)).join("\n"), "utf-8");
+        console.log(`Saved: ${filePath}`);
+        process.exit(0);
+    }
+    if (values.markdown) {
+        const header = `| min | timestamp | close | pnl% | peak% | drawdown% |\n| --- | --- | --- | --- | --- | --- |`;
+        const mdRows = rows.map((r) => `| ${r.min} | ${new Date(r.timestamp).toISOString()} | ${r.close.toFixed(2)} | ${(r.pnl >= 0 ? "+" : "") + r.pnl.toFixed(2)}% | +${r.peak.toFixed(2)}% | ${r.drawdown.toFixed(2)}% |`);
+        const filePath = resolve(dumpDir, `${dumpName}.md`);
+        await mkdir(dumpDir, { recursive: true });
+        await writeFile(filePath, [header, ...mdRows].join("\n"), "utf-8");
+        console.log(`Saved: ${filePath}`);
+        process.exit(0);
+    }
+    console.log(`Symbol: ${symbol} | Direction: ${direction} | PriceOpen: ${priceOpen} | From: ${new Date(timestamp).toISOString()} | Minutes: ${minutes}\n`);
+    console.log(`${"min".padStart(5)} | ${"timestamp".padEnd(24)} | ${"close".padStart(12)} | ${"pnl%".padStart(8)} | ${"peak%".padStart(8)} | ${"drawdown%".padStart(10)}`);
+    console.log("-".repeat(83));
+    for (const r of rows) {
+        const min = String(r.min).padStart(5);
+        const ts = new Date(r.timestamp).toISOString().padEnd(24);
+        const close = r.close.toFixed(2).padStart(12);
+        const pnlStr = (r.pnl >= 0 ? "+" : "") + r.pnl.toFixed(2) + "%";
+        const peakStr = "+" + r.peak.toFixed(2) + "%";
+        const drawdownStr = r.drawdown.toFixed(2) + "%";
+        console.log(`${min} | ${ts} | ${close} | ${pnlStr.padStart(8)} | ${peakStr.padStart(8)} | ${drawdownStr.padStart(10)}`);
+    }
+    process.exit(0);
+};
 main$3();
 
 const __filename = fileURLToPath(import.meta.url);
@@ -3360,6 +3611,7 @@ Modes:
   --pine     <entry>    Execute a local .pine indicator file
   --editor              Open the Pine Script visual editor in the browser
   --dump                Fetch and save raw OHLCV candles
+  --pnldebug            Simulate PnL per minute for a given entry price and direction
   --flush  <entry...>   Delete report/log/markdown/agent folders from strategy dump dir
   --init                Scaffold a new project in the current directory
   --help                Print this help message
@@ -3432,6 +3684,21 @@ Candle dump flags (--dump):
 
   Module file ./modules/dump.module is loaded automatically if it exists.
 
+PnL debug flags (--pnldebug):
+
+  --symbol      <string>   Trading pair (default: BTCUSDT)
+  --priceopen   <number>   Entry price (required)
+  --direction   <string>   Position direction: long or short (default: long)
+  --when        <string>   Start timestamp — ISO 8601 or Unix ms (default: now)
+  --minutes     <string>   Number of 1m candles to simulate (default: 60)
+  --exchange    <string>   Exchange name (default: first registered)
+  --output      <string>   Output file base name (default: {SYMBOL}_{DIRECTION}_{PRICEOPEN}_{TIMESTAMP})
+  --json                   Save as JSON array to ./dump/<output>.json
+  --jsonl                  Save as JSONL to ./dump/<output>.jsonl
+  --markdown               Save as Markdown table to ./dump/<output>.md
+
+  Module file ./modules/pnldebug.module is loaded automatically if it exists.
+
 Flush flags (--flush):
 
   One or more positional entry points. For each entry point the following
@@ -3454,6 +3721,7 @@ Module hooks (loaded automatically by each mode):
   modules/pine.module       --pine       Exchange schema for PineScript runs
   modules/editor.module     --editor     Exchange schema for the visual Pine editor
   modules/dump.module       --dump       Exchange schema for candle dumps
+  modules/pnldebug.module   --pnldebug   Exchange schema for PnL debug runs
 
   --flush has no associated module. It only removes dump subdirectories.
 
@@ -3477,6 +3745,8 @@ Examples:
   node ${ENTRY_PATH} --pine ./math/feb_2026.pine --timeframe 15m --limit 500 --jsonl
   node ${ENTRY_PATH} --editor
   node ${ENTRY_PATH} --dump --symbol BTCUSDT --timeframe 15m --limit 500 --jsonl
+  node ${ENTRY_PATH} --pnldebug --symbol BTCUSDT --priceopen 64069.50 --direction short --when "2025-02-25" --minutes 120
+  node ${ENTRY_PATH} --pnldebug --priceopen 67956.73 --direction long --when 1772064000000 --minutes 60 --markdown
   node ${ENTRY_PATH} --flush ./content/feb_2026.strategy/feb_2026.strategy.ts
   node ${ENTRY_PATH} --flush ./content/feb_2026.strategy/feb_2026.strategy.ts ./content/feb_2026.strategy/feb_2026.test.ts
   node ${ENTRY_PATH} --init --output my-trading-bot
@@ -3489,7 +3759,7 @@ const main$1 = async () => {
     if (!values.help) {
         return;
     }
-    process.stdout.write(`@backtest-kit/cli ${"7.3.1"}\n\n`);
+    process.stdout.write(`@backtest-kit/cli ${"7.5.0"}\n\n`);
     process.stdout.write(HELP_TEXT);
     process.exit(0);
 };
@@ -3503,7 +3773,7 @@ const main = async () => {
     if (!values.version) {
         return;
     }
-    process.stdout.write(`@backtest-kit/cli ${"7.3.1"}\n`);
+    process.stdout.write(`@backtest-kit/cli ${"7.5.0"}\n`);
     process.exit(0);
 };
 main();