@backtest-kit/cli 7.3.1 → 7.5.0

package/build/index.cjs

@@ -570,6 +570,22 @@ const getArgs = functoolsKit.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,
@@ -716,11 +732,11 @@ class SetupUtils {
                 BacktestKit.Markdown.enable();
                 BacktestKit.Report.enable();
                 BacktestKit.Dump.enable();
+                BacktestKit.State.enable();
                 BacktestKit.Memory.enable();
             }
             {
                 BacktestKit.Dump.useMarkdown();
-                BacktestKit.Memory.usePersist();
             }
             {
                 BacktestKit.StorageLive.usePersist();
@@ -734,6 +750,18 @@ class SetupUtils {
                 BacktestKit.NotificationLive.usePersist();
                 BacktestKit.NotificationBacktest.useMemory();
             }
+            {
+                BacktestKit.RecentLive.usePersist();
+                BacktestKit.RecentBacktest.useMemory();
+            }
+            {
+                BacktestKit.MemoryLive.usePersist();
+                BacktestKit.MemoryBacktest.useLocal();
+            }
+            {
+                BacktestKit.StateLive.usePersist();
+                BacktestKit.StateBacktest.useLocal();
+            }
             {
                 BacktestKit.Markdown.useDummy();
                 BacktestKit.Log.useJsonl();
@@ -776,6 +804,7 @@ class SetupUtils {
                 BacktestKit.PersistIntervalAdapter.clear();
                 BacktestKit.PersistMemoryAdapter.clear();
                 BacktestKit.PersistRecentAdapter.clear();
+                BacktestKit.PersistStateAdapter.clear();
             }
             {
                 BacktestKit.Dump.clear();
@@ -1929,6 +1958,9 @@ class TelegramLogicService {
                 event,
             });
             const markdown = await this.telegramTemplateService.getTrailingTakeMarkdown(event);
+            if (!markdown) {
+                return;
+            }
             await this.telegramWebService.publishNotify({
                 symbol: event.symbol,
                 markdown,
@@ -1939,6 +1971,9 @@ class TelegramLogicService {
                 event,
             });
             const markdown = await this.telegramTemplateService.getTrailingStopMarkdown(event);
+            if (!markdown) {
+                return;
+            }
             await this.telegramWebService.publishNotify({
                 symbol: event.symbol,
                 markdown,
@@ -1949,6 +1984,9 @@ class TelegramLogicService {
                 event,
             });
             const markdown = await this.telegramTemplateService.getBreakevenMarkdown(event);
+            if (!markdown) {
+                return;
+            }
             await this.telegramWebService.publishNotify({
                 symbol: event.symbol,
                 markdown,
@@ -1959,6 +1997,9 @@ class TelegramLogicService {
                 event,
             });
             const markdown = await this.telegramTemplateService.getPartialProfitMarkdown(event);
+            if (!markdown) {
+                return;
+            }
             await this.telegramWebService.publishNotify({
                 symbol: event.symbol,
                 markdown,
@@ -1969,6 +2010,9 @@ class TelegramLogicService {
                 event,
             });
             const markdown = await this.telegramTemplateService.getPartialLossMarkdown(event);
+            if (!markdown) {
+                return;
+            }
             await this.telegramWebService.publishNotify({
                 symbol: event.symbol,
                 markdown,
@@ -1979,6 +2023,9 @@ class TelegramLogicService {
                 event,
             });
             const markdown = await this.telegramTemplateService.getScheduledMarkdown(event);
+            if (!markdown) {
+                return;
+            }
             await this.telegramWebService.publishNotify({
                 symbol: event.symbol,
                 markdown,
@@ -1989,6 +2036,9 @@ class TelegramLogicService {
                 event,
             });
             const markdown = await this.telegramTemplateService.getCancelledMarkdown(event);
+            if (!markdown) {
+                return;
+            }
             await this.telegramWebService.publishNotify({
                 symbol: event.symbol,
                 markdown,
@@ -1999,6 +2049,9 @@ class TelegramLogicService {
                 event,
             });
             const markdown = await this.telegramTemplateService.getOpenedMarkdown(event);
+            if (!markdown) {
+                return;
+            }
             await this.telegramWebService.publishNotify({
                 symbol: event.symbol,
                 markdown,
@@ -2009,6 +2062,9 @@ class TelegramLogicService {
                 event,
             });
             const markdown = await this.telegramTemplateService.getClosedMarkdown(event);
+            if (!markdown) {
+                return;
+            }
             await this.telegramWebService.publishNotify({
                 symbol: event.symbol,
                 markdown,
@@ -2019,6 +2075,9 @@ class TelegramLogicService {
                 event,
             });
             const markdown = await this.telegramTemplateService.getRiskMarkdown(event);
+            if (!markdown) {
+                return;
+            }
             await this.telegramWebService.publishNotify({
                 symbol: event.symbol,
                 markdown,
@@ -2029,6 +2088,9 @@ class TelegramLogicService {
                 event,
             });
             const markdown = await this.telegramTemplateService.getAverageBuyMarkdown(event);
+            if (!markdown) {
+                return;
+            }
             await this.telegramWebService.publishNotify({
                 symbol: event.symbol,
                 markdown,
@@ -2039,6 +2101,9 @@ class TelegramLogicService {
                 event,
             });
             const markdown = await this.telegramTemplateService.getSignalOpenMarkdown(event);
+            if (!markdown) {
+                return;
+            }
             await this.telegramWebService.publishNotify({
                 symbol: event.symbol,
                 markdown,
@@ -2049,6 +2114,9 @@ class TelegramLogicService {
                 event,
             });
             const markdown = await this.telegramTemplateService.getSignalCloseMarkdown(event);
+            if (!markdown) {
+                return;
+            }
             await this.telegramWebService.publishNotify({
                 symbol: event.symbol,
                 markdown,
@@ -2059,6 +2127,9 @@ class TelegramLogicService {
                 event,
             });
             const markdown = await this.telegramTemplateService.getSignalInfoMarkdown(event);
+            if (!markdown) {
+                return;
+            }
             await this.telegramWebService.publishNotify({
                 symbol: event.symbol,
                 markdown,
@@ -2069,6 +2140,9 @@ class TelegramLogicService {
                 event,
             });
             const markdown = await this.telegramTemplateService.getCancelScheduledMarkdown(event);
+            if (!markdown) {
+                return;
+            }
             await this.telegramWebService.publishNotify({
                 symbol: event.symbol,
                 markdown,
@@ -2079,6 +2153,9 @@ class TelegramLogicService {
                 event,
             });
             const markdown = await this.telegramTemplateService.getClosePendingMarkdown(event);
+            if (!markdown) {
+                return;
+            }
             await this.telegramWebService.publishNotify({
                 symbol: event.symbol,
                 markdown,
@@ -2180,104 +2257,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);
         };
     }
@@ -2839,14 +2994,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((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)))) {
         return;
     }
@@ -2854,14 +3009,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 = functoolsKit.singleshot(async () => {
     console.log("Graceful shutdown initiated. Press Ctrl+C again to force quit.");
@@ -2877,7 +3032,7 @@ const flush = async (entryPoint) => {
         console.log(`Removed: ${target}`);
     }
 };
-const main$c = async () => {
+const main$d = async () => {
     if (!getEntry((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)))) {
         return;
     }
@@ -2894,7 +3049,7 @@ const main$c = async () => {
     }
     process.exit(0);
 };
-main$c();
+main$d();
 
 const BEFORE_EXIT_FN$5 = functoolsKit.singleshot(async () => {
     process.off("SIGINT", BEFORE_EXIT_FN$5);
@@ -2916,7 +3071,7 @@ const BEFORE_EXIT_FN$5 = functoolsKit.singleshot(async () => {
 const listenGracefulShutdown$5 = functoolsKit.singleshot(() => {
     process.on("SIGINT", BEFORE_EXIT_FN$5);
 });
-const main$b = async () => {
+const main$c = async () => {
     if (!getEntry((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)))) {
         return;
     }
@@ -2931,7 +3086,7 @@ const main$b = async () => {
     await cli.backtestMainService.connect();
     listenGracefulShutdown$5();
 };
-main$b();
+main$c();
 
 const BEFORE_EXIT_FN$4 = functoolsKit.singleshot(async () => {
     process.off("SIGINT", BEFORE_EXIT_FN$4);
@@ -2949,7 +3104,7 @@ const BEFORE_EXIT_FN$4 = functoolsKit.singleshot(async () => {
 const listenGracefulShutdown$4 = functoolsKit.singleshot(() => {
     process.on("SIGINT", BEFORE_EXIT_FN$4);
 });
-const main$a = async () => {
+const main$b = async () => {
     if (!getEntry((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)))) {
         return;
     }
@@ -2965,7 +3120,7 @@ const main$a = async () => {
     listenGracefulShutdown$4();
     await cli.walkerMainService.connect();
 };
-main$a();
+main$b();
 
 const BEFORE_EXIT_FN$3 = functoolsKit.singleshot(async () => {
     process.off("SIGINT", BEFORE_EXIT_FN$3);
@@ -2986,7 +3141,7 @@ const BEFORE_EXIT_FN$3 = functoolsKit.singleshot(async () => {
 const listenGracefulShutdown$3 = functoolsKit.singleshot(() => {
     process.on("SIGINT", BEFORE_EXIT_FN$3);
 });
-const main$9 = async () => {
+const main$a = async () => {
     if (!getEntry((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)))) {
         return;
     }
@@ -2997,7 +3152,7 @@ const main$9 = async () => {
     cli.paperMainService.connect();
     listenGracefulShutdown$3();
 };
-main$9();
+main$a();
 
 const BEFORE_EXIT_FN$2 = functoolsKit.singleshot(async () => {
     process.off("SIGINT", BEFORE_EXIT_FN$2);
@@ -3018,7 +3173,7 @@ const BEFORE_EXIT_FN$2 = functoolsKit.singleshot(async () => {
 const listenGracefulShutdown$2 = functoolsKit.singleshot(() => {
     process.on("SIGINT", BEFORE_EXIT_FN$2);
 });
-const main$8 = async () => {
+const main$9 = async () => {
     if (!getEntry((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)))) {
         return;
     }
@@ -3029,7 +3184,7 @@ const main$8 = async () => {
     await cli.liveMainService.connect();
     listenGracefulShutdown$2();
 };
-main$8();
+main$9();
 
 const BEFORE_EXIT_FN$1 = functoolsKit.singleshot(async () => {
     process.off("SIGINT", BEFORE_EXIT_FN$1);
@@ -3039,7 +3194,7 @@ const BEFORE_EXIT_FN$1 = functoolsKit.singleshot(async () => {
 const listenGracefulShutdown$1 = functoolsKit.singleshot(() => {
     process.on("SIGINT", BEFORE_EXIT_FN$1);
 });
-const main$7 = async () => {
+const main$8 = async () => {
     if (!getEntry((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)))) {
         return;
     }
@@ -3049,7 +3204,7 @@ const main$7 = async () => {
     }
     listenGracefulShutdown$1();
 };
-main$7();
+main$8();
 
 const BEFORE_EXIT_FN = functoolsKit.singleshot(async () => {
     process.off("SIGINT", BEFORE_EXIT_FN);
@@ -3059,7 +3214,7 @@ const BEFORE_EXIT_FN = functoolsKit.singleshot(async () => {
 const listenGracefulShutdown = functoolsKit.singleshot(() => {
     process.on("SIGINT", BEFORE_EXIT_FN);
 });
-const main$6 = async () => {
+const main$7 = async () => {
     if (!getEntry((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)))) {
         return;
     }
@@ -3069,7 +3224,7 @@ const main$6 = async () => {
     }
     listenGracefulShutdown();
 };
-main$6();
+main$7();
 
 const EXTRACT_ROWS_FN = (plots, schema) => {
     const keys = Object.keys(schema);
@@ -3091,7 +3246,7 @@ const EXTRACT_ROWS_FN = (plots, schema) => {
     }
     return rows;
 };
-const main$5 = async () => {
+const main$6 = async () => {
     if (!getEntry((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)))) {
         return;
     }
@@ -3171,9 +3326,9 @@ const main$5 = async () => {
     console.log(await BacktestKitPinets.toMarkdown(signalId, plots, signalSchema));
     process.exit(0);
 };
-main$5();
+main$6();
 
-const main$4 = async () => {
+const main$5 = async () => {
     if (!getEntry((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)))) {
         return;
     }
@@ -3208,9 +3363,9 @@ const main$4 = async () => {
     };
     process.on("SIGINT", beforeExit);
 };
-main$4();
+main$5();
 
-const main$3 = async () => {
+const main$4 = async () => {
     if (!getEntry((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)))) {
         return;
     }
@@ -3271,6 +3426,102 @@ const main$3 = async () => {
     console.log(JSON.stringify(candles, null, 2));
     process.exit(0);
 };
+main$4();
+
+const main$3 = async () => {
+    if (!getEntry((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)))) {
+        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 BacktestKit.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 = BacktestKit.alignToInterval(when, "1m").getTime();
+    const minutesStr = values.minutes || "60";
+    const minutesNum = parseInt(minutesStr);
+    const minutes = isNaN(minutesNum) ? 60 : minutesNum;
+    const candles = await BacktestKit.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 = path.join(process.cwd(), "dump");
+    if (values.json) {
+        const filePath = path.resolve(dumpDir, `${dumpName}.json`);
+        await fs$1.mkdir(dumpDir, { recursive: true });
+        await fs$1.writeFile(filePath, JSON.stringify(rows, null, 2), "utf-8");
+        console.log(`Saved: ${filePath}`);
+        process.exit(0);
+    }
+    if (values.jsonl) {
+        const filePath = path.resolve(dumpDir, `${dumpName}.jsonl`);
+        await fs$1.mkdir(dumpDir, { recursive: true });
+        await fs$1.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 = path.resolve(dumpDir, `${dumpName}.md`);
+        await fs$1.mkdir(dumpDir, { recursive: true });
+        await fs$1.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$1 = url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)));
@@ -3389,6 +3640,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
@@ -3461,6 +3713,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
@@ -3483,6 +3750,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.
 
@@ -3506,6 +3774,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
@@ -3518,7 +3788,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);
 };
@@ -3532,7 +3802,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();