@backtest-kit/cli 5.10.0 → 5.10.1

package/README.md

@@ -450,9 +450,10 @@ For projects that compile to or use CommonJS. Loaded via `require()`:
 | `--limit` | string | Number of candles to fetch (default: `250`) |
 | `--when` | string | End date for candle window — ISO 8601 or Unix ms (default: now) |
 | `--exchange` | string | Exchange name (default: first registered, falls back to CCXT Binance) |
-| `--json` | string | Write plots as a JSON array to a file (e.g. `--json=./output.json`) |
-| `--jsonl` | string | Write plots as JSONL (one row per line) to a file (e.g. `--jsonl=./output.jsonl`) |
-| `--markdown` | string | Write Markdown table to a file (e.g. `--markdown=./output.md`) |
+| `--output` | string | Output file base name without extension (default: `.pine` file name) |
+| `--json` | boolean | Write plots as a JSON array to `<pine-dir>/dump/{output}.json` |
+| `--jsonl` | boolean | Write plots as JSONL (one row per line) to `<pine-dir>/dump/{output}.jsonl` |
+| `--markdown` | boolean | Write Markdown table to `<pine-dir>/dump/{output}.md` |
 
 **Important:** `limit` must cover indicator warmup bars — rows before warmup completes will show `N/A` 
 
@@ -470,7 +471,7 @@ The CLI looks for `modules/pine.module` in two locations (first match wins):
 ```
 my-project/
 ├── math/
-│   ├── master_trend_15m.pine         ← indicator
+│   ├── impulse_trend_15m.pine         ← indicator
 │   └── modules/
 │       └── pine.module.ts            ← loaded first (next to .pine file)
 ├── modules/
@@ -507,7 +508,7 @@ Before loading `pine.module`, the CLI loads `.env` files in the same order as fo
 my-project/
 ├── math/
 │   ├── .env                          ← loaded second (overrides root)
-│   └── master_trend_15m.pine
+│   └── impulse_trend_15m.pine
 ├── .env                              ← loaded first
 └── package.json
 ```
@@ -538,7 +539,7 @@ addExchangeSchema({
 Then run:
 
 ```bash
-npx @backtest-kit/cli --pine ./math/master_trend_15m.pine \
+npx @backtest-kit/cli --pine ./math/impulse_trend_15m.pine \
   --exchange my-exchange \
   --symbol BTCUSDT \
   --timeframe 15m \
@@ -551,7 +552,7 @@ Or add it to `package.json`:
 ```json
 {
   "scripts": {
-    "pine": "npx @backtest-kit/cli --pine ./math/master_trend_15m.pine --symbol BTCUSDT --timeframe 15m --limit 180"
+    "pine": "npx @backtest-kit/cli --pine ./math/impulse_trend_15m.pine --symbol BTCUSDT --timeframe 15m --limit 180"
   }
 }
 ```
@@ -593,10 +594,23 @@ The CLI prints a Markdown table to stdout:
 | 112653.90 |  1.0000 | 2025-09-22T22:15:00.000Z |
 ```
 
-Redirect to a file to save the report:
+Save to `./math/dump/impulse_trend_15m.md` (uses `.pine` file name automatically, dump is created next to the `.pine` file):
 
 ```bash
-npm run pine > report.md
+npx @backtest-kit/cli --pine ./math/impulse_trend_15m.pine --markdown
+```
+
+Override the output name with `--output`:
+
+```bash
+npx @backtest-kit/cli --pine ./math/impulse_trend_15m.pine --jsonl --output feb2026_bb
+# → ./math/dump/feb2026_bb.jsonl
+```
+
+Print to stdout (no flag):
+
+```bash
+npx @backtest-kit/cli --pine ./math/impulse_trend_15m.pine
 ```
 
 ## 🌍 Environment Variables

package/build/index.cjs

@@ -519,17 +519,21 @@ const getArgs = functoolsKit.singleshot(() => {
                 type: "string",
                 default: "",
             },
-            json: {
+            output: {
                 type: "string",
                 default: "",
             },
+            json: {
+                type: "boolean",
+                default: false,
+            },
             jsonl: {
-                type: "string",
-                default: "",
+                type: "boolean",
+                default: false,
             },
             markdown: {
-                type: "string",
-                default: "",
+                type: "boolean",
+                default: false,
             },
         },
         strict: false,
@@ -2380,21 +2384,23 @@ const main = async () => {
         return true;
     }))
         .map((key) => [key, key]));
-    const jsonPath = values.json;
-    if (jsonPath) {
+    const dumpName = values.output || path.basename(entryPoint, path.extname(entryPoint));
+    const dumpDir = path.join(process.cwd(), "dump");
+    if (values.json) {
         const rows = EXTRACT_ROWS_FN(plots, signalSchema);
-        await fs$1.writeFile(jsonPath, JSON.stringify(rows, null, 2), "utf-8");
+        await fs$1.mkdir(dumpDir, { recursive: true });
+        await fs$1.writeFile(path.join(dumpDir, `${dumpName}.json`), JSON.stringify(rows, null, 2), "utf-8");
         return;
     }
-    const jsonlPath = values.jsonl;
-    if (jsonlPath) {
+    if (values.jsonl) {
         const rows = EXTRACT_ROWS_FN(plots, signalSchema);
-        await fs$1.writeFile(jsonlPath, rows.map((r) => JSON.stringify(r)).join("\n"), "utf-8");
+        await fs$1.mkdir(dumpDir, { recursive: true });
+        await fs$1.writeFile(path.join(dumpDir, `${dumpName}.jsonl`), rows.map((r) => JSON.stringify(r)).join("\n"), "utf-8");
         return;
     }
-    const markdownPath = values.markdown;
-    if (markdownPath) {
-        await fs$1.writeFile(markdownPath, await BacktestKitPinets.toMarkdown(signalId, plots, signalSchema), "utf-8");
+    if (values.markdown) {
+        await fs$1.mkdir(dumpDir, { recursive: true });
+        await fs$1.writeFile(path.join(dumpDir, `${dumpName}.md`), await BacktestKitPinets.toMarkdown(signalId, plots, signalSchema), "utf-8");
         return;
     }
     console.log(await BacktestKitPinets.toMarkdown(signalId, plots, signalSchema));

package/build/index.mjs

@@ -4,8 +4,8 @@ import { Storage, Notification, Markdown, Report, Dump, Memory, StorageLive, Sto
 import { getErrorMessage, errorData, singleshot, str, BehaviorSubject, compose, execpool, queued, sleep, randomString, createAwaiter, TIMEOUT_SYMBOL, typo, retry, trycatch, memoize } from 'functools-kit';
 import fs, { constants } from 'fs';
 import * as stackTrace from 'stack-trace';
-import path from 'path';
-import fs$1, { access, readFile, writeFile } from 'fs/promises';
+import path, { basename, extname, join } from 'path';
+import fs$1, { access, readFile, mkdir, writeFile } from 'fs/promises';
 import dotenv from 'dotenv';
 import { createActivator } from 'di-kit';
 import { fileURLToPath } from 'url';
@@ -494,17 +494,21 @@ const getArgs = singleshot(() => {
                 type: "string",
                 default: "",
             },
-            json: {
+            output: {
                 type: "string",
                 default: "",
             },
+            json: {
+                type: "boolean",
+                default: false,
+            },
             jsonl: {
-                type: "string",
-                default: "",
+                type: "boolean",
+                default: false,
             },
             markdown: {
-                type: "string",
-                default: "",
+                type: "boolean",
+                default: false,
             },
         },
         strict: false,
@@ -2351,21 +2355,23 @@ const main = async () => {
         return true;
     }))
         .map((key) => [key, key]));
-    const jsonPath = values.json;
-    if (jsonPath) {
+    const dumpName = values.output || basename(entryPoint, extname(entryPoint));
+    const dumpDir = join(process.cwd(), "dump");
+    if (values.json) {
         const rows = EXTRACT_ROWS_FN(plots, signalSchema);
-        await writeFile(jsonPath, JSON.stringify(rows, null, 2), "utf-8");
+        await mkdir(dumpDir, { recursive: true });
+        await writeFile(join(dumpDir, `${dumpName}.json`), JSON.stringify(rows, null, 2), "utf-8");
         return;
     }
-    const jsonlPath = values.jsonl;
-    if (jsonlPath) {
+    if (values.jsonl) {
         const rows = EXTRACT_ROWS_FN(plots, signalSchema);
-        await writeFile(jsonlPath, rows.map((r) => JSON.stringify(r)).join("\n"), "utf-8");
+        await mkdir(dumpDir, { recursive: true });
+        await writeFile(join(dumpDir, `${dumpName}.jsonl`), rows.map((r) => JSON.stringify(r)).join("\n"), "utf-8");
         return;
     }
-    const markdownPath = values.markdown;
-    if (markdownPath) {
-        await writeFile(markdownPath, await toMarkdown(signalId, plots, signalSchema), "utf-8");
+    if (values.markdown) {
+        await mkdir(dumpDir, { recursive: true });
+        await writeFile(join(dumpDir, `${dumpName}.md`), await toMarkdown(signalId, plots, signalSchema), "utf-8");
         return;
     }
     console.log(await toMarkdown(signalId, plots, signalSchema));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@backtest-kit/cli",
-  "version": "5.10.0",
+  "version": "5.10.1",
   "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",