@backtest-kit/cli 5.9.0 → 5.10.0

package/README.md

@@ -436,6 +436,169 @@ For projects that compile to or use CommonJS. Loaded via `require()`:
 }
 ```
 
+## 🌲 Running Local PineScript Indicators
+
+`@backtest-kit/cli` can execute any local `.pine` file against a real exchange and print the results as a Markdown table — no TradingView account required.
+
+### CLI Flags
+
+| Flag | Type | Description |
+|------|------|-------------|
+| `--pine` | boolean | Enable PineScript execution mode |
+| `--symbol` | string | Trading pair (default: `"BTCUSDT"`) |
+| `--timeframe` | string | Candle interval (default: `"15m"`) |
+| `--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`) |
+
+**Important:** `limit` must cover indicator warmup bars — rows before warmup completes will show `N/A` 
+
+**Positional argument:** path to the `.pine` file.
+
+### Exchange via `pine.module`
+
+By default the CLI registers CCXT Binance automatically. To use a different exchange — or to configure API keys, custom rate limits, or a non-spot market — create a `modules/pine.module.ts` file. The CLI loads it automatically before running the script.
+
+The CLI looks for `modules/pine.module` in two locations (first match wins):
+
+1. **Next to the `.pine` file** — `<pine-file-dir>/modules/pine.module.ts`
+2. **Project root** — `<cwd>/modules/pine.module.ts`
+
+```
+my-project/
+├── math/
+│   ├── master_trend_15m.pine         ← indicator
+│   └── modules/
+│       └── pine.module.ts            ← loaded first (next to .pine file)
+├── modules/
+│   └── pine.module.ts                ← fallback (project root)
+└── package.json
+```
+
+Inside `pine.module.ts` call `addExchangeSchema` from `backtest-kit` and give the exchange a name:
+
+```typescript
+// modules/pine.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),
+});
+```
+
+### Environment variables (`.env`)
+
+Before loading `pine.module`, the CLI loads `.env` files in the same order as for strategy modules — project root first, then the `.pine` file directory (overrides root):
+
+```
+my-project/
+├── math/
+│   ├── .env                          ← loaded second (overrides root)
+│   └── master_trend_15m.pine
+├── .env                              ← loaded first
+└── package.json
+```
+
+Use this to store API keys without hardcoding them:
+
+```env
+# .env
+BYBIT_API_KEY=xxx
+BYBIT_API_SECRET=yyy
+```
+
+```typescript
+// modules/pine.module.ts
+addExchangeSchema({
+  exchangeName: "my-exchange",
+  getCandles: async (symbol, interval, since, limit) => {
+    const exchange = new ccxt.bybit({
+      apiKey: process.env.BYBIT_API_KEY,
+      secret: process.env.BYBIT_API_SECRET,
+      enableRateLimit: true,
+    });
+    // ...
+  },
+});
+```
+
+Then run:
+
+```bash
+npx @backtest-kit/cli --pine ./math/master_trend_15m.pine \
+  --exchange my-exchange \
+  --symbol BTCUSDT \
+  --timeframe 15m \
+  --limit 180 \
+  --when "2025-09-24T12:00:00.000Z"
+```
+
+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"
+  }
+}
+```
+
+```bash
+npm run pine
+```
+
+### PineScript Requirements
+
+The CLI reads all `plot()` calls that use `display=display.data_window` as output columns. Every other `plot()` is ignored. Name each output plot explicitly:
+
+```pine
+//@version=5
+indicator("MyIndicator", overlay=true)
+
+// ... computation ...
+
+plot(close,    "Close",    display=display.data_window)
+plot(position, "Position", display=display.data_window)
+```
+
+The column names in the output Markdown table are taken directly from those plot names — no manual schema definition needed.
+
+### Output
+
+The CLI prints a Markdown table to stdout:
+
+```
+# PineScript Technical Analysis Dump
+
+**Signal ID**: CLI execution 2025-09-24T12:00:00.000Z
+
+| Close | Position | timestamp |
+| --- | --- | --- |
+| 112871.28 | -1.0000 | 2025-09-22T15:00:00.000Z |
+| 112666.69 | -1.0000 | 2025-09-22T15:15:00.000Z |
+| 112736.00 |  0.0000 | 2025-09-22T18:30:00.000Z |
+| 112653.90 |  1.0000 | 2025-09-22T22:15:00.000Z |
+```
+
+Redirect to a file to save the report:
+
+```bash
+npm run pine > report.md
+```
+
 ## 🌍 Environment Variables
 
 Create a `.env` file in your project root:
@@ -474,7 +637,6 @@ When your strategy module does not register an exchange, frame, or strategy name
 
 > **Note:** The default exchange schema **does not support order book fetching in backtest mode**. If your strategy calls `getOrderBook()` during backtest, you must register a custom exchange schema with your own snapshot storage.
 
-
 ## 🔧 Programmatic API
 
 In addition to the CLI, `@backtest-kit/cli` can be used as a library — call `run()` directly from your own script without spawning a child process or parsing CLI flags.

package/build/index.cjs

@@ -93,6 +93,8 @@ var BacktestKitSignals__namespace = /*#__PURE__*/_interopNamespaceDefault(Backte
 {
     BacktestKit.Markdown.enable();
     BacktestKit.Report.enable();
+    BacktestKit.Dump.enable();
+    BacktestKit.Memory.enable();
 }
 {
     BacktestKit.Dump.useMarkdown();
@@ -296,12 +298,31 @@ class ResolveService {
             this.loggerService.log("resolveService getIsLaunched");
             return _is_launched;
         };
-        this.attachEntryPoint = async (entryPoint) => {
-            this.loggerService.log("resolveService attachEntryPoint");
+        this.attachPine = async (pinePath) => {
+            this.loggerService.log("resolveService attachPine");
             if (_is_launched) {
                 throw new Error("Entry point is already attached. Multiple entry points are not allowed.");
             }
-            const absolutePath = path.resolve(entryPoint);
+            const absolutePath = path.resolve(pinePath);
+            await fs$1.access(absolutePath, fs.constants.F_OK | fs.constants.R_OK);
+            const pineDir = path.dirname(absolutePath);
+            {
+                const cwd = process.cwd();
+                process.chdir(pineDir);
+                dotenv.config({ path: path.join(cwd, '.env'), override: true, quiet: true });
+                dotenv.config({ path: path.join(pineDir, '.env'), override: true, quiet: true });
+            }
+            _is_launched = true;
+            return await fs$1.readFile(absolutePath, "utf-8");
+        };
+        this.attachJavascript = async (jsPath) => {
+            this.loggerService.log("resolveService attachJavascript", {
+                jsPath
+            });
+            if (_is_launched) {
+                throw new Error("Entry point is already attached. Multiple entry points are not allowed.");
+            }
+            const absolutePath = path.resolve(jsPath);
             await fs$1.access(absolutePath, fs.constants.F_OK | fs.constants.R_OK);
             const moduleRoot = path.dirname(absolutePath);
             {
@@ -428,6 +449,7 @@ const getArgs = functoolsKit.singleshot(() => {
     const { values, positionals } = util.parseArgs({
         args: process.argv,
         options: {
+            // backtest entry
             symbol: {
                 type: "string",
                 default: "",
@@ -480,6 +502,35 @@ const getArgs = functoolsKit.singleshot(() => {
                 type: "string",
                 default: "1m, 15m, 30m, 4h",
             },
+            // pinescript entry
+            pine: {
+                type: "boolean",
+                default: false,
+            },
+            timeframe: {
+                type: "string",
+                default: "",
+            },
+            limit: {
+                type: "string",
+                default: "",
+            },
+            when: {
+                type: "string",
+                default: "",
+            },
+            json: {
+                type: "string",
+                default: "",
+            },
+            jsonl: {
+                type: "string",
+                default: "",
+            },
+            markdown: {
+                type: "string",
+                default: "",
+            },
         },
         strict: false,
         allowPositionals: true,
@@ -621,7 +672,7 @@ class BacktestMainService {
                 this.frontendProviderService.connect();
                 this.telegramProviderService.connect();
             }
-            await this.resolveService.attachEntryPoint(payload.entryPoint);
+            await this.resolveService.attachJavascript(payload.entryPoint);
             {
                 this.exchangeSchemaService.addSchema();
                 this.symbolSchemaService.addSchema();
@@ -714,7 +765,7 @@ class LiveMainService {
                 this.frontendProviderService.connect();
                 this.telegramProviderService.connect();
             }
-            await this.resolveService.attachEntryPoint(payload.entryPoint);
+            await this.resolveService.attachJavascript(payload.entryPoint);
             {
                 this.exchangeSchemaService.addSchema();
                 this.symbolSchemaService.addSchema();
@@ -787,7 +838,7 @@ class PaperMainService {
                 this.frontendProviderService.connect();
                 this.telegramProviderService.connect();
             }
-            await this.resolveService.attachEntryPoint(payload.entryPoint);
+            await this.resolveService.attachJavascript(payload.entryPoint);
             {
                 this.exchangeSchemaService.addSchema();
                 this.symbolSchemaService.addSchema();
@@ -2147,7 +2198,7 @@ const BEFORE_EXIT_FN$4 = functoolsKit.singleshot(async () => {
 const listenGracefulShutdown$4 = functoolsKit.singleshot(() => {
     process.on("SIGINT", BEFORE_EXIT_FN$4);
 });
-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;
     }
@@ -2158,7 +2209,7 @@ const main$4 = async () => {
     await cli.backtestMainService.connect();
     listenGracefulShutdown$4();
 };
-main$4();
+main$5();
 
 const BEFORE_EXIT_FN$3 = functoolsKit.singleshot(async () => {
     process.off("SIGINT", BEFORE_EXIT_FN$3);
@@ -2179,7 +2230,7 @@ const BEFORE_EXIT_FN$3 = functoolsKit.singleshot(async () => {
 const listenGracefulShutdown$3 = functoolsKit.singleshot(() => {
     process.on("SIGINT", BEFORE_EXIT_FN$3);
 });
-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;
     }
@@ -2190,7 +2241,7 @@ const main$3 = async () => {
     cli.paperMainService.connect();
     listenGracefulShutdown$3();
 };
-main$3();
+main$4();
 
 const BEFORE_EXIT_FN$2 = functoolsKit.singleshot(async () => {
     process.off("SIGINT", BEFORE_EXIT_FN$2);
@@ -2211,7 +2262,7 @@ const BEFORE_EXIT_FN$2 = functoolsKit.singleshot(async () => {
 const listenGracefulShutdown$2 = functoolsKit.singleshot(() => {
     process.on("SIGINT", BEFORE_EXIT_FN$2);
 });
-const main$2 = async () => {
+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;
     }
@@ -2222,7 +2273,7 @@ const main$2 = async () => {
     await cli.liveMainService.connect();
     listenGracefulShutdown$2();
 };
-main$2();
+main$3();
 
 const BEFORE_EXIT_FN$1 = functoolsKit.singleshot(async () => {
     process.off("SIGINT", BEFORE_EXIT_FN$1);
@@ -2232,7 +2283,7 @@ const BEFORE_EXIT_FN$1 = functoolsKit.singleshot(async () => {
 const listenGracefulShutdown$1 = functoolsKit.singleshot(() => {
     process.on("SIGINT", BEFORE_EXIT_FN$1);
 });
-const main$1 = async () => {
+const main$2 = 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;
     }
@@ -2242,7 +2293,7 @@ const main$1 = async () => {
     }
     listenGracefulShutdown$1();
 };
-main$1();
+main$2();
 
 const BEFORE_EXIT_FN = functoolsKit.singleshot(async () => {
     process.off("SIGINT", BEFORE_EXIT_FN);
@@ -2252,7 +2303,7 @@ const BEFORE_EXIT_FN = functoolsKit.singleshot(async () => {
 const listenGracefulShutdown = functoolsKit.singleshot(() => {
     process.on("SIGINT", BEFORE_EXIT_FN);
 });
-const main = async () => {
+const main$1 = 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;
     }
@@ -2262,6 +2313,92 @@ const main = async () => {
     }
     listenGracefulShutdown();
 };
+main$1();
+
+const EXTRACT_ROWS_FN = (plots, schema) => {
+    const keys = Object.keys(schema);
+    const dataLength = keys
+        .map((k) => plots[k]?.data?.length ?? 0)
+        .reduce((acm, cur) => Math.max(acm, cur), 0);
+    const rows = [];
+    for (let i = 0; i < dataLength; i++) {
+        const row = {};
+        for (const key of keys) {
+            const point = plots[key]?.data?.[i];
+            row[key] = point?.value ?? null;
+        }
+        const point = plots[keys[0]]?.data?.[i];
+        if (point?.time) {
+            row.timestamp = new Date(point.time).toISOString();
+        }
+        rows.push(row);
+    }
+    return rows;
+};
+const main = 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, positionals } = getArgs();
+    if (!values.pine) {
+        return;
+    }
+    const [entryPoint = null] = positionals.slice(-1);
+    if (!entryPoint) {
+        return;
+    }
+    const source = await cli.resolveService.attachPine(entryPoint);
+    await cli.moduleConnectionService.loadModule("./pine.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 timeframe = values.timeframe || "15m";
+    const limitStr = values.limit || "250";
+    const limitNum = parseInt(limitStr);
+    const limit = isNaN(limitNum) ? 250 : limitNum;
+    const whenStr = values.when || Date.now().toString();
+    const whenStamp = Date.parse(whenStr);
+    const when = isNaN(whenStamp) ? new Date() : new Date(whenStamp);
+    const plots = await BacktestKitPinets.run(BacktestKitPinets.Code.fromString(source), {
+        symbol,
+        timeframe: timeframe,
+        limit,
+    }, exchangeName, when);
+    const signalId = `CLI execution ${new Date().toISOString()}`;
+    const signalSchema = Object.fromEntries(Object.keys(plots)
+        .filter((key) => plots[key].data.some((v) => {
+        if (typeof v?.value !== "number") {
+            return false;
+        }
+        if (!isFinite(v.value)) {
+            return false;
+        }
+        return true;
+    }))
+        .map((key) => [key, key]));
+    const jsonPath = values.json;
+    if (jsonPath) {
+        const rows = EXTRACT_ROWS_FN(plots, signalSchema);
+        await fs$1.writeFile(jsonPath, JSON.stringify(rows, null, 2), "utf-8");
+        return;
+    }
+    const jsonlPath = values.jsonl;
+    if (jsonlPath) {
+        const rows = EXTRACT_ROWS_FN(plots, signalSchema);
+        await fs$1.writeFile(jsonlPath, 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");
+        return;
+    }
+    console.log(await BacktestKitPinets.toMarkdown(signalId, plots, signalSchema));
+};
 main();
 
 function setLogger(logger) {

package/build/index.mjs

@@ -5,7 +5,7 @@ import { getErrorMessage, errorData, singleshot, str, BehaviorSubject, compose,
 import fs, { constants } from 'fs';
 import * as stackTrace from 'stack-trace';
 import path from 'path';
-import fs$1, { access } from 'fs/promises';
+import fs$1, { access, readFile, writeFile } from 'fs/promises';
 import dotenv from 'dotenv';
 import { createActivator } from 'di-kit';
 import { fileURLToPath } from 'url';
@@ -28,6 +28,7 @@ import { createRequire } from 'module';
 import * as BacktestKitGraph from '@backtest-kit/graph';
 import * as BacktestKitOllama from '@backtest-kit/ollama';
 import * as BacktestKitPinets from '@backtest-kit/pinets';
+import { run as run$1, Code, toMarkdown } from '@backtest-kit/pinets';
 import * as BacktestKitSignals from '@backtest-kit/signals';
 
 /**
@@ -67,6 +68,8 @@ import * as BacktestKitSignals from '@backtest-kit/signals';
 {
     Markdown.enable();
     Report.enable();
+    Dump.enable();
+    Memory.enable();
 }
 {
     Dump.useMarkdown();
@@ -270,12 +273,31 @@ class ResolveService {
             this.loggerService.log("resolveService getIsLaunched");
             return _is_launched;
         };
-        this.attachEntryPoint = async (entryPoint) => {
-            this.loggerService.log("resolveService attachEntryPoint");
+        this.attachPine = async (pinePath) => {
+            this.loggerService.log("resolveService attachPine");
             if (_is_launched) {
                 throw new Error("Entry point is already attached. Multiple entry points are not allowed.");
             }
-            const absolutePath = path.resolve(entryPoint);
+            const absolutePath = path.resolve(pinePath);
+            await access(absolutePath, constants.F_OK | constants.R_OK);
+            const pineDir = path.dirname(absolutePath);
+            {
+                const cwd = process.cwd();
+                process.chdir(pineDir);
+                dotenv.config({ path: path.join(cwd, '.env'), override: true, quiet: true });
+                dotenv.config({ path: path.join(pineDir, '.env'), override: true, quiet: true });
+            }
+            _is_launched = true;
+            return await readFile(absolutePath, "utf-8");
+        };
+        this.attachJavascript = async (jsPath) => {
+            this.loggerService.log("resolveService attachJavascript", {
+                jsPath
+            });
+            if (_is_launched) {
+                throw new Error("Entry point is already attached. Multiple entry points are not allowed.");
+            }
+            const absolutePath = path.resolve(jsPath);
             await access(absolutePath, constants.F_OK | constants.R_OK);
             const moduleRoot = path.dirname(absolutePath);
             {
@@ -402,6 +424,7 @@ const getArgs = singleshot(() => {
     const { values, positionals } = parseArgs({
         args: process.argv,
         options: {
+            // backtest entry
             symbol: {
                 type: "string",
                 default: "",
@@ -454,6 +477,35 @@ const getArgs = singleshot(() => {
                 type: "string",
                 default: "1m, 15m, 30m, 4h",
             },
+            // pinescript entry
+            pine: {
+                type: "boolean",
+                default: false,
+            },
+            timeframe: {
+                type: "string",
+                default: "",
+            },
+            limit: {
+                type: "string",
+                default: "",
+            },
+            when: {
+                type: "string",
+                default: "",
+            },
+            json: {
+                type: "string",
+                default: "",
+            },
+            jsonl: {
+                type: "string",
+                default: "",
+            },
+            markdown: {
+                type: "string",
+                default: "",
+            },
         },
         strict: false,
         allowPositionals: true,
@@ -595,7 +647,7 @@ class BacktestMainService {
                 this.frontendProviderService.connect();
                 this.telegramProviderService.connect();
             }
-            await this.resolveService.attachEntryPoint(payload.entryPoint);
+            await this.resolveService.attachJavascript(payload.entryPoint);
             {
                 this.exchangeSchemaService.addSchema();
                 this.symbolSchemaService.addSchema();
@@ -688,7 +740,7 @@ class LiveMainService {
                 this.frontendProviderService.connect();
                 this.telegramProviderService.connect();
             }
-            await this.resolveService.attachEntryPoint(payload.entryPoint);
+            await this.resolveService.attachJavascript(payload.entryPoint);
             {
                 this.exchangeSchemaService.addSchema();
                 this.symbolSchemaService.addSchema();
@@ -761,7 +813,7 @@ class PaperMainService {
                 this.frontendProviderService.connect();
                 this.telegramProviderService.connect();
             }
-            await this.resolveService.attachEntryPoint(payload.entryPoint);
+            await this.resolveService.attachJavascript(payload.entryPoint);
             {
                 this.exchangeSchemaService.addSchema();
                 this.symbolSchemaService.addSchema();
@@ -2117,7 +2169,7 @@ const BEFORE_EXIT_FN$4 = singleshot(async () => {
 const listenGracefulShutdown$4 = singleshot(() => {
     process.on("SIGINT", BEFORE_EXIT_FN$4);
 });
-const main$4 = async () => {
+const main$5 = async () => {
     if (!getEntry(import.meta.url)) {
         return;
     }
@@ -2128,7 +2180,7 @@ const main$4 = async () => {
     await cli.backtestMainService.connect();
     listenGracefulShutdown$4();
 };
-main$4();
+main$5();
 
 const BEFORE_EXIT_FN$3 = singleshot(async () => {
     process.off("SIGINT", BEFORE_EXIT_FN$3);
@@ -2149,7 +2201,7 @@ const BEFORE_EXIT_FN$3 = singleshot(async () => {
 const listenGracefulShutdown$3 = singleshot(() => {
     process.on("SIGINT", BEFORE_EXIT_FN$3);
 });
-const main$3 = async () => {
+const main$4 = async () => {
     if (!getEntry(import.meta.url)) {
         return;
     }
@@ -2160,7 +2212,7 @@ const main$3 = async () => {
     cli.paperMainService.connect();
     listenGracefulShutdown$3();
 };
-main$3();
+main$4();
 
 const BEFORE_EXIT_FN$2 = singleshot(async () => {
     process.off("SIGINT", BEFORE_EXIT_FN$2);
@@ -2181,7 +2233,7 @@ const BEFORE_EXIT_FN$2 = singleshot(async () => {
 const listenGracefulShutdown$2 = singleshot(() => {
     process.on("SIGINT", BEFORE_EXIT_FN$2);
 });
-const main$2 = async () => {
+const main$3 = async () => {
     if (!getEntry(import.meta.url)) {
         return;
     }
@@ -2192,7 +2244,7 @@ const main$2 = async () => {
     await cli.liveMainService.connect();
     listenGracefulShutdown$2();
 };
-main$2();
+main$3();
 
 const BEFORE_EXIT_FN$1 = singleshot(async () => {
     process.off("SIGINT", BEFORE_EXIT_FN$1);
@@ -2202,7 +2254,7 @@ const BEFORE_EXIT_FN$1 = singleshot(async () => {
 const listenGracefulShutdown$1 = singleshot(() => {
     process.on("SIGINT", BEFORE_EXIT_FN$1);
 });
-const main$1 = async () => {
+const main$2 = async () => {
     if (!getEntry(import.meta.url)) {
         return;
     }
@@ -2212,7 +2264,7 @@ const main$1 = async () => {
     }
     listenGracefulShutdown$1();
 };
-main$1();
+main$2();
 
 const BEFORE_EXIT_FN = singleshot(async () => {
     process.off("SIGINT", BEFORE_EXIT_FN);
@@ -2222,7 +2274,7 @@ const BEFORE_EXIT_FN = singleshot(async () => {
 const listenGracefulShutdown = singleshot(() => {
     process.on("SIGINT", BEFORE_EXIT_FN);
 });
-const main = async () => {
+const main$1 = async () => {
     if (!getEntry(import.meta.url)) {
         return;
     }
@@ -2232,6 +2284,92 @@ const main = async () => {
     }
     listenGracefulShutdown();
 };
+main$1();
+
+const EXTRACT_ROWS_FN = (plots, schema) => {
+    const keys = Object.keys(schema);
+    const dataLength = keys
+        .map((k) => plots[k]?.data?.length ?? 0)
+        .reduce((acm, cur) => Math.max(acm, cur), 0);
+    const rows = [];
+    for (let i = 0; i < dataLength; i++) {
+        const row = {};
+        for (const key of keys) {
+            const point = plots[key]?.data?.[i];
+            row[key] = point?.value ?? null;
+        }
+        const point = plots[keys[0]]?.data?.[i];
+        if (point?.time) {
+            row.timestamp = new Date(point.time).toISOString();
+        }
+        rows.push(row);
+    }
+    return rows;
+};
+const main = async () => {
+    if (!getEntry(import.meta.url)) {
+        return;
+    }
+    const { values, positionals } = getArgs();
+    if (!values.pine) {
+        return;
+    }
+    const [entryPoint = null] = positionals.slice(-1);
+    if (!entryPoint) {
+        return;
+    }
+    const source = await cli.resolveService.attachPine(entryPoint);
+    await cli.moduleConnectionService.loadModule("./pine.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 timeframe = values.timeframe || "15m";
+    const limitStr = values.limit || "250";
+    const limitNum = parseInt(limitStr);
+    const limit = isNaN(limitNum) ? 250 : limitNum;
+    const whenStr = values.when || Date.now().toString();
+    const whenStamp = Date.parse(whenStr);
+    const when = isNaN(whenStamp) ? new Date() : new Date(whenStamp);
+    const plots = await run$1(Code.fromString(source), {
+        symbol,
+        timeframe: timeframe,
+        limit,
+    }, exchangeName, when);
+    const signalId = `CLI execution ${new Date().toISOString()}`;
+    const signalSchema = Object.fromEntries(Object.keys(plots)
+        .filter((key) => plots[key].data.some((v) => {
+        if (typeof v?.value !== "number") {
+            return false;
+        }
+        if (!isFinite(v.value)) {
+            return false;
+        }
+        return true;
+    }))
+        .map((key) => [key, key]));
+    const jsonPath = values.json;
+    if (jsonPath) {
+        const rows = EXTRACT_ROWS_FN(plots, signalSchema);
+        await writeFile(jsonPath, JSON.stringify(rows, null, 2), "utf-8");
+        return;
+    }
+    const jsonlPath = values.jsonl;
+    if (jsonlPath) {
+        const rows = EXTRACT_ROWS_FN(plots, signalSchema);
+        await writeFile(jsonlPath, 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");
+        return;
+    }
+    console.log(await toMarkdown(signalId, plots, signalSchema));
+};
 main();
 
 function setLogger(logger) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@backtest-kit/cli",
-  "version": "5.9.0",
+  "version": "5.10.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",
@@ -45,7 +45,8 @@
     "url": "https://github.com/tripolskypetr/backtest-kit/issues"
   },
   "scripts": {
-    "build": "rollup -c"
+    "build": "rollup -c",
+    "start": "npm run build && node build/index.mjs math/master_trend_15m.pine --pine --symbol BTCUSDT --timeframe 15m --limit 180"
   },
   "main": "build/index.cjs",
   "module": "build/index.mjs",
@@ -60,11 +61,11 @@
   "devDependencies": {
     "@babel/plugin-transform-modules-umd": "7.27.1",
     "@babel/standalone": "7.29.1",
-    "@backtest-kit/ui": "5.9.0",
-    "@backtest-kit/graph": "5.9.0",
-    "@backtest-kit/ollama": "5.9.0",
-    "@backtest-kit/pinets": "5.9.0",
-    "@backtest-kit/signals": "5.9.0",
+    "@backtest-kit/ui": "5.10.0",
+    "@backtest-kit/graph": "5.10.0",
+    "@backtest-kit/ollama": "5.10.0",
+    "@backtest-kit/pinets": "5.10.0",
+    "@backtest-kit/signals": "5.10.0",
     "@rollup/plugin-replace": "6.0.3",
     "@rollup/plugin-typescript": "11.1.6",
     "@types/image-size": "0.7.0",
@@ -72,7 +73,7 @@
     "@types/mustache": "4.2.6",
     "@types/node": "22.9.0",
     "@types/stack-trace": "0.0.33",
-    "backtest-kit": "5.9.0",
+    "backtest-kit": "5.10.0",
     "glob": "11.0.1",
     "markdown-it": "14.1.1",
     "rimraf": "6.0.1",
@@ -87,12 +88,12 @@
   "peerDependencies": {
     "@babel/plugin-transform-modules-umd": "^7.27.1",
     "@babel/standalone": "^7.29.1",
-    "@backtest-kit/ui": "^5.9.0",
-    "@backtest-kit/graph": "^5.9.0",
-    "@backtest-kit/ollama": "^5.9.0",
-    "@backtest-kit/pinets": "^5.9.0",
-    "@backtest-kit/signals": "^5.9.0",
-    "backtest-kit": "^5.9.0",
+    "@backtest-kit/ui": "^5.10.0",
+    "@backtest-kit/graph": "^5.10.0",
+    "@backtest-kit/ollama": "^5.10.0",
+    "@backtest-kit/pinets": "^5.10.0",
+    "@backtest-kit/signals": "^5.10.0",
+    "backtest-kit": "^5.10.0",
     "markdown-it": "^14.1.1",
     "typescript": "^5.0.0"
   },

package/types.d.ts

@@ -103,7 +103,8 @@ declare class ResolveService {
     readonly OVERRIDE_TEMPLATE_DIR: string;
     readonly OVERRIDE_MODULES_DIR: string;
     getIsLaunched: () => boolean;
-    attachEntryPoint: (entryPoint: string) => Promise<void>;
+    attachPine: (pinePath: string) => Promise<string>;
+    attachJavascript: (jsPath: string) => Promise<void>;
 }
 
 declare class ErrorService {