@backtest-kit/cli 7.4.0 → 7.5.0

package/README.md

@@ -44,6 +44,7 @@ Point the CLI at your strategy file, choose a mode, and it handles exchange conn
 | **PineScript**   | `--pine`                   | Run a local `.pine` indicator against exchange data |
 | **Pine Editor**  | `--editor`                 | Open the visual Pine Script editor in the browser   |
 | **Candle Dump**  | `--dump`                   | Fetch and save raw OHLCV candles to a file   |
+| **PnL Debug**    | `--pnldebug`               | Simulate per-minute PnL for a given entry price and direction |
 | **Flush**        | `--flush`                  | Delete report/log/markdown/agent folders from strategy dump dir |
 | **Init Project** | `--init`                   | Scaffold a new backtest-kit project          |
 
@@ -1065,6 +1066,110 @@ Or add it to `package.json`:
 npx @backtest-kit/cli --dump --symbol BTCUSDT --timeframe 15m --limit 500 --jsonl
 ```
 
+## 🐞 PnL Debug (`--pnldebug`)
+
+`@backtest-kit/cli` can simulate a hypothetical position minute by minute and print running PnL, peak profit, and maximum drawdown for each candle — without placing any trades or loading a strategy file.
+
+### CLI Flags
+
+| Flag | Type | Description |
+|------|------|-------------|
+| `--pnldebug` | boolean | Enable PnL debug mode |
+| `--priceopen` | number | Entry price (required) |
+| `--direction` | string | `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`) |
+| `--symbol` | string | Trading pair (default: `"BTCUSDT"`) |
+| `--exchange` | string | Exchange name (default: first registered, falls back to CCXT Binance) |
+| `--output` | string | Output file base name (default: `{SYMBOL}_{DIRECTION}_{PRICEOPEN}_{TIMESTAMP}`) |
+| `--json` | boolean | Save results as JSON array to `./dump/<output>.json` |
+| `--jsonl` | boolean | Save results as JSONL to `./dump/<output>.jsonl` |
+| `--markdown` | boolean | Save results as Markdown table to `./dump/<output>.md` |
+
+### Output columns
+
+| Column | Description |
+|--------|-------------|
+| `min` | Minute offset from start (1-based) |
+| `timestamp` | Candle timestamp (ISO 8601) |
+| `close` | Candle close price |
+| `pnl%` | Running PnL vs entry price (signed %) |
+| `peak%` | Highest PnL reached so far (always ≥ 0) |
+| `drawdown%` | Lowest PnL reached so far (always ≤ 0) |
+
+### Exchange via `pnldebug.module`
+
+By default the CLI registers CCXT Binance automatically. To use a different exchange, create a `modules/pnldebug.module.ts` file in the current working directory — the CLI loads it automatically before fetching candles.
+
+```typescript
+// modules/pnldebug.module.ts
+import { addExchangeSchema } from "backtest-kit";
+import ccxt from "ccxt";
+
+addExchangeSchema({
+  exchangeName: "my-exchange",
+  getCandles: async (symbol, interval, since, limit) => {
+    const exchange = new ccxt.bybit({ enableRateLimit: true });
+    const ohlcv = await exchange.fetchOHLCV(symbol, interval, since.getTime(), limit);
+    return ohlcv.map(([timestamp, open, high, low, close, volume]) => ({
+      timestamp, open, high, low, close, volume,
+    }));
+  },
+  formatPrice: (symbol, price) => price.toFixed(2),
+  formatQuantity: (symbol, quantity) => quantity.toFixed(8),
+});
+```
+
+### Usage
+
+Print to stdout (default table format):
+
+```bash
+npx @backtest-kit/cli --pnldebug --symbol BTCUSDT --priceopen 64069.50 --direction short --when "2025-02-25" --minutes 120
+```
+
+Save as Markdown:
+
+```bash
+npx @backtest-kit/cli --pnldebug --priceopen 67956.73 --direction long --when 1772064000000 --minutes 60 --markdown
+# → ./dump/BTCUSDT_long_67956.73_{timestamp}.md
+```
+
+Override the output file name with `--output`:
+
+```bash
+npx @backtest-kit/cli --pnldebug --priceopen 64069.50 --direction short --when "2025-02-25" --minutes 120 \
+  --jsonl --output feb25_short_debug
+# → ./dump/feb25_short_debug.jsonl
+```
+
+Or add it to `package.json`:
+
+```json
+{
+  "scripts": {
+    "pnldebug": "npx @backtest-kit/cli --pnldebug --symbol BTCUSDT --priceopen 64069.50 --direction short --when \"2025-02-25\" --minutes 120"
+  }
+}
+```
+
+```bash
+npm run pnldebug
+```
+
+### Example stdout output
+
+```
+Symbol: BTCUSDT | Direction: short | PriceOpen: 64069.50 | From: 2025-02-25T00:00:00.000Z | Minutes: 120
+
+  min | timestamp                 |        close  |    pnl%  |   peak%  | drawdown%
+-----------------------------------------------------------------------------------
+    1 | 2025-02-25T00:01:00.000Z  |      64020.10 |   +0.08% |   +0.08% |     0.00%
+    2 | 2025-02-25T00:02:00.000Z  |      64105.30 |   -0.06% |   +0.08% |    -0.06%
+  ...
+  120 | 2025-02-25T02:00:00.000Z  |      63200.00 |   +1.36% |   +1.36% |    -0.06%
+```
+
 ## 🗑️ Flushing Strategy Output (`--flush`)
 
 `@backtest-kit/cli` can delete generated output folders from one or more strategy dump directories without touching cached candle data.

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();
@@ -2965,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;
     }
@@ -2980,14 +3009,14 @@ const main$d = async () => {
     if (MODES.some((mode) => values[mode])) {
         return;
     }
-    process.stdout.write(`@backtest-kit/cli ${"7.4.0"}\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.");
@@ -3003,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;
     }
@@ -3020,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);
@@ -3042,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;
     }
@@ -3057,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);
@@ -3075,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;
     }
@@ -3091,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);
@@ -3112,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;
     }
@@ -3123,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);
@@ -3144,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;
     }
@@ -3155,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);
@@ -3165,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;
     }
@@ -3175,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);
@@ -3185,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;
     }
@@ -3195,7 +3224,7 @@ const main$6 = async () => {
     }
     listenGracefulShutdown();
 };
-main$6();
+main$7();
 
 const EXTRACT_ROWS_FN = (plots, schema) => {
     const keys = Object.keys(schema);
@@ -3217,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;
     }
@@ -3297,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;
     }
@@ -3334,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;
     }
@@ -3397,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)));
@@ -3515,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
@@ -3587,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
@@ -3609,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.
 
@@ -3632,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
@@ -3644,7 +3788,7 @@ const main$1 = async () => {
     if (!values.help) {
         return;
     }
-    process.stdout.write(`@backtest-kit/cli ${"7.4.0"}\n\n`);
+    process.stdout.write(`@backtest-kit/cli ${"7.5.0"}\n\n`);
     process.stdout.write(HELP_TEXT);
     process.exit(0);
 };
@@ -3658,7 +3802,7 @@ const main = async () => {
     if (!values.version) {
         return;
     }
-    process.stdout.write(`@backtest-kit/cli ${"7.4.0"}\n`);
+    process.stdout.write(`@backtest-kit/cli ${"7.5.0"}\n`);
     process.exit(0);
 };
 main();

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();
@@ -2936,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;
     }
@@ -2951,14 +2980,14 @@ const main$d = async () => {
     if (MODES.some((mode) => values[mode])) {
         return;
     }
-    process.stdout.write(`@backtest-kit/cli ${"7.4.0"}\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.");
@@ -2974,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;
     }
@@ -2991,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);
@@ -3013,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;
     }
@@ -3028,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);
@@ -3046,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;
     }
@@ -3062,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);
@@ -3083,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;
     }
@@ -3094,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);
@@ -3115,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;
     }
@@ -3126,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);
@@ -3136,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;
     }
@@ -3146,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);
@@ -3156,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;
     }
@@ -3166,7 +3195,7 @@ const main$6 = async () => {
     }
     listenGracefulShutdown();
 };
-main$6();
+main$7();
 
 const EXTRACT_ROWS_FN = (plots, schema) => {
     const keys = Object.keys(schema);
@@ -3188,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;
     }
@@ -3268,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;
     }
@@ -3305,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;
     }
@@ -3368,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);
@@ -3486,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
@@ -3558,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
@@ -3580,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.
 
@@ -3603,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
@@ -3615,7 +3759,7 @@ const main$1 = async () => {
     if (!values.help) {
         return;
     }
-    process.stdout.write(`@backtest-kit/cli ${"7.4.0"}\n\n`);
+    process.stdout.write(`@backtest-kit/cli ${"7.5.0"}\n\n`);
     process.stdout.write(HELP_TEXT);
     process.exit(0);
 };
@@ -3629,7 +3773,7 @@ const main = async () => {
     if (!values.version) {
         return;
     }
-    process.stdout.write(`@backtest-kit/cli ${"7.4.0"}\n`);
+    process.stdout.write(`@backtest-kit/cli ${"7.5.0"}\n`);
     process.exit(0);
 };
 main();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@backtest-kit/cli",
-  "version": "7.4.0",
+  "version": "7.5.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.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/graph": "7.5.0",
+    "@backtest-kit/ollama": "7.5.0",
+    "@backtest-kit/pinets": "7.5.0",
+    "@backtest-kit/signals": "7.5.0",
+    "@backtest-kit/ui": "7.5.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.4.0",
+    "backtest-kit": "7.5.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.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",
+    "@backtest-kit/graph": "^7.5.0",
+    "@backtest-kit/ollama": "^7.5.0",
+    "@backtest-kit/pinets": "^7.5.0",
+    "@backtest-kit/signals": "^7.5.0",
+    "@backtest-kit/ui": "^7.5.0",
+    "backtest-kit": "^7.5.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.4.0",
-    "@backtest-kit/graph": "^7.4.0",
-    "@backtest-kit/pinets": "^7.4.0",
-    "@backtest-kit/ui": "^7.4.0",
+    "@backtest-kit/cli": "^7.5.0",
+    "@backtest-kit/graph": "^7.5.0",
+    "@backtest-kit/pinets": "^7.5.0",
+    "@backtest-kit/ui": "^7.5.0",
     "agent-swarm-kit": "^2.6.0",
-    "backtest-kit": "^7.4.0",
+    "backtest-kit": "^7.5.0",
     "functools-kit": "^2.3.0",
     "garch": "^1.2.3",
     "get-moment-stamp": "^1.1.2",

package/template/signal-info.mustache

@@ -1,21 +1,21 @@
-**ℹ️ Signal Info**
-
-**Symbol:** `{{symbol}}` ({{data.position}})
-**Current:** `{{currentPrice}}`
-**Entry:** `{{data.priceOpen}}`
-**Orig Entry:** `{{data.originalPriceOpen}}`
-**DCA Entries:** `{{data.totalEntries}}`
-**Partials Done:** `{{data.totalPartials}}`
-**Take Profit:** `{{data.priceTakeProfit}}`
-**Stop Loss:** `{{data.priceStopLoss}}`
-**Orig TP:** `{{data.originalPriceTakeProfit}}`
-**Orig SL:** `{{data.originalPriceStopLoss}}`
-**PnL:** {{data.pnl.pnlPercentage}}% ({{data.pnl.pnlCost}} / {{data.pnl.pnlEntries}})
-**Peak Profit:** {{data.peakProfit.pnlPercentage}}% ({{data.peakProfit.pnlCost}} / {{data.peakProfit.pnlEntries}})
-**Max Drawdown:** {{data.maxDrawdown.pnlPercentage}}% ({{data.maxDrawdown.pnlCost}} / {{data.maxDrawdown.pnlEntries}})
-**Signal ID:** `{{data.id}}`
-**Time:** `{{timestamp}}`
-
-{{#backtest}}
-_🧪 Backtest_
+**ℹ️ Signal Info**
+
+**Symbol:** `{{symbol}}` ({{data.position}})
+**Current:** `{{currentPrice}}`
+**Entry:** `{{data.priceOpen}}`
+**Orig Entry:** `{{data.originalPriceOpen}}`
+**DCA Entries:** `{{data.totalEntries}}`
+**Partials Done:** `{{data.totalPartials}}`
+**Take Profit:** `{{data.priceTakeProfit}}`
+**Stop Loss:** `{{data.priceStopLoss}}`
+**Orig TP:** `{{data.originalPriceTakeProfit}}`
+**Orig SL:** `{{data.originalPriceStopLoss}}`
+**PnL:** {{data.pnl.pnlPercentage}}% ({{data.pnl.pnlCost}} / {{data.pnl.pnlEntries}})
+**Peak Profit:** {{data.peakProfit.pnlPercentage}}% ({{data.peakProfit.pnlCost}} / {{data.peakProfit.pnlEntries}})
+**Max Drawdown:** {{data.maxDrawdown.pnlPercentage}}% ({{data.maxDrawdown.pnlCost}} / {{data.maxDrawdown.pnlEntries}})
+**Signal ID:** `{{data.id}}`
+**Time:** `{{timestamp}}`
+
+{{#backtest}}
+_🧪 Backtest_
 {{/backtest}}