@backtest-kit/cli 5.6.0 → 5.9.0

package/README.md

@@ -302,11 +302,11 @@ Requires `CC_TELEGRAM_TOKEN` and `CC_TELEGRAM_CHANNEL` in your environment.
 
 The CLI supports **mode-specific module files** that are loaded as side-effect imports before the strategy starts. Each file is expected to call `Broker.useBrokerAdapter()` from `backtest-kit` to register a broker adapter.
 
-| Mode          | Module file                     | Loaded before               |
-|---------------|---------------------------------|-----------------------------|
-| `--live`      | `./modules/live.module.mjs`     | `Live.background()`         |
-| `--paper`     | `./modules/paper.module.mjs`    | `Live.background()` (paper) |
-| `--backtest`  | `./modules/backtest.module.mjs` | `Backtest.background()`     |
+| Command Line Args | Module file                     | Loaded before               |
+|-------------------|---------------------------------|-----------------------------|
+| `--live`          | `./modules/live.module.mjs`     | `Live.background()`         |
+| `--paper`         | `./modules/paper.module.mjs`    | `Live.background()` (paper) |
+| `--backtest`      | `./modules/backtest.module.mjs` | `Backtest.background()`     |
 
 > File is resolved relative to `cwd` (the strategy directory). All of `.mjs`, `.cjs`, `.ts` extensions are tried automatically. Missing module is a soft warning — not an error.
 

package/build/index.cjs

@@ -94,6 +94,10 @@ var BacktestKitSignals__namespace = /*#__PURE__*/_interopNamespaceDefault(Backte
     BacktestKit.Markdown.enable();
     BacktestKit.Report.enable();
 }
+{
+    BacktestKit.Dump.useMarkdown();
+    BacktestKit.Memory.usePersist();
+}
 {
     BacktestKit.StorageLive.usePersist();
     BacktestKit.StorageBacktest.useMemory();
@@ -116,6 +120,25 @@ BacktestKit.setConfig({
 BacktestKit.setConfig({
     CC_MAX_SIGNAL_GENERATION_SECONDS: 15 * 60,
 });
+BacktestKit.setConfig({
+    CC_MAX_BACKTEST_MARKDOWN_ROWS: 1000,
+    CC_MAX_BREAKEVEN_MARKDOWN_ROWS: 1000,
+    CC_MAX_HEATMAP_MARKDOWN_ROWS: 1000,
+    CC_MAX_HIGHEST_PROFIT_MARKDOWN_ROWS: 1000,
+    CC_MAX_LIVE_MARKDOWN_ROWS: 1000,
+    CC_MAX_PARTIAL_MARKDOWN_ROWS: 1000,
+    CC_MAX_RISK_MARKDOWN_ROWS: 1000,
+    CC_MAX_SCHEDULE_MARKDOWN_ROWS: 1000,
+    CC_MAX_STRATEGY_MARKDOWN_ROWS: 1000,
+    CC_MAX_SYNC_MARKDOWN_ROWS: 1000,
+    CC_MAX_PERFORMANCE_MARKDOWN_ROWS: 1000,
+});
+BacktestKit.setConfig({
+    CC_MAX_SIGNAL_LIFETIME_MINUTES: Infinity,
+});
+BacktestKit.setConfig({
+    CC_WALKER_MARKDOWN_TOP_N: 10,
+});
 BacktestKit.Log.useJsonl();
 
 const ERROR_HANDLER_INSTALLED = Symbol.for("error-handler-installed");
@@ -266,8 +289,13 @@ class ResolveService {
         this.loggerService = inject(TYPES.loggerService);
         this.loaderService = inject(TYPES.loaderService);
         this.DEFAULT_TEMPLATE_DIR = path.resolve(__dirname$1, '..', 'template');
+        this.DEFAULT_MODULES_DIR = path.resolve(__dirname$1, '..', 'modules');
         this.OVERRIDE_TEMPLATE_DIR = path.resolve(process.cwd(), 'template');
         this.OVERRIDE_MODULES_DIR = path.resolve(process.cwd(), 'modules');
+        this.getIsLaunched = () => {
+            this.loggerService.log("resolveService getIsLaunched");
+            return _is_launched;
+        };
         this.attachEntryPoint = async (entryPoint) => {
             this.loggerService.log("resolveService attachEntryPoint");
             if (_is_launched) {
@@ -1719,25 +1747,36 @@ class TelegramTemplateService {
     }
 }
 
+const GET_MODULE_VARIANTS_FN = (fileName, self) => {
+    const result = [];
+    result.push({
+        filePath: path.join(process.cwd(), "modules", fileName),
+        baseDir: path.join(process.cwd(), "modules")
+    });
+    result.push({
+        filePath: path.join(self.resolveService.OVERRIDE_MODULES_DIR, fileName),
+        baseDir: self.resolveService.OVERRIDE_MODULES_DIR,
+    });
+    result.push({
+        filePath: path.join(self.resolveService.DEFAULT_MODULES_DIR, fileName),
+        baseDir: self.resolveService.DEFAULT_MODULES_DIR,
+    });
+    return result;
+};
 const LOAD_MODULE_MODULE_FN = async (fileName, self) => {
-    const overridePath = path.join(self.resolveService.OVERRIDE_MODULES_DIR, fileName);
-    const targetPath = path.join(process.cwd(), "modules", fileName);
-    const hasOverride = await fs$1
-        .access(overridePath, fs.constants.F_OK | fs.constants.R_OK)
-        .then(() => true)
-        .catch(() => false);
-    const resolvedFile = hasOverride ? overridePath : targetPath;
-    try {
-        if (self.loaderService.check(resolvedFile)) {
-            self.loaderService.import(resolvedFile);
-            return true;
+    for (const { filePath, baseDir } of GET_MODULE_VARIANTS_FN(fileName, self)) {
+        try {
+            if (await self.loaderService.check(filePath, baseDir)) {
+                self.loaderService.import(filePath, baseDir);
+                return true;
+            }
+        }
+        catch {
+            console.warn(`Module module import failed filePath=${filePath} baseDir=${baseDir}`);
+            process.exit(-1);
         }
-        return false;
-    }
-    catch {
-        console.warn(`Module module import failed for file: ${resolvedFile}`);
-        return false;
     }
+    return false;
 };
 class ModuleConnectionService {
     constructor() {
@@ -2231,6 +2270,9 @@ function setLogger(logger) {
 
 let _is_started = false;
 async function run(mode, args) {
+    if (cli.resolveService.getIsLaunched()) {
+        throw new Error("Entry point is already attached. Multiple entry points are not allowed.");
+    }
     {
         if (_is_started) {
             throw new Error("Should be called only once");

package/build/index.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import * as BacktestKit from 'backtest-kit';
-import { Storage, Notification, Markdown, Report, StorageLive, StorageBacktest, NotificationLive, NotificationBacktest, setConfig, Log, listExchangeSchema, addExchangeSchema, roundTicks, listFrameSchema, addFrameSchema, listenDoneLive, listenDoneBacktest, shutdown, listenSignal, listStrategySchema, overrideExchangeSchema, Backtest, Live, getCandles, checkCandles, warmCandles, listenRisk, listenStrategyCommit, listenSync } from 'backtest-kit';
+import { Storage, Notification, Markdown, Report, Dump, Memory, StorageLive, StorageBacktest, NotificationLive, NotificationBacktest, setConfig, Log, listExchangeSchema, addExchangeSchema, roundTicks, listFrameSchema, addFrameSchema, listenDoneLive, listenDoneBacktest, shutdown, listenSignal, listStrategySchema, overrideExchangeSchema, Backtest, Live, getCandles, checkCandles, warmCandles, listenRisk, listenStrategyCommit, listenSync } from 'backtest-kit';
 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';
@@ -68,6 +68,10 @@ import * as BacktestKitSignals from '@backtest-kit/signals';
     Markdown.enable();
     Report.enable();
 }
+{
+    Dump.useMarkdown();
+    Memory.usePersist();
+}
 {
     StorageLive.usePersist();
     StorageBacktest.useMemory();
@@ -90,6 +94,25 @@ setConfig({
 setConfig({
     CC_MAX_SIGNAL_GENERATION_SECONDS: 15 * 60,
 });
+setConfig({
+    CC_MAX_BACKTEST_MARKDOWN_ROWS: 1000,
+    CC_MAX_BREAKEVEN_MARKDOWN_ROWS: 1000,
+    CC_MAX_HEATMAP_MARKDOWN_ROWS: 1000,
+    CC_MAX_HIGHEST_PROFIT_MARKDOWN_ROWS: 1000,
+    CC_MAX_LIVE_MARKDOWN_ROWS: 1000,
+    CC_MAX_PARTIAL_MARKDOWN_ROWS: 1000,
+    CC_MAX_RISK_MARKDOWN_ROWS: 1000,
+    CC_MAX_SCHEDULE_MARKDOWN_ROWS: 1000,
+    CC_MAX_STRATEGY_MARKDOWN_ROWS: 1000,
+    CC_MAX_SYNC_MARKDOWN_ROWS: 1000,
+    CC_MAX_PERFORMANCE_MARKDOWN_ROWS: 1000,
+});
+setConfig({
+    CC_MAX_SIGNAL_LIFETIME_MINUTES: Infinity,
+});
+setConfig({
+    CC_WALKER_MARKDOWN_TOP_N: 10,
+});
 Log.useJsonl();
 
 const ERROR_HANDLER_INSTALLED = Symbol.for("error-handler-installed");
@@ -240,8 +263,13 @@ class ResolveService {
         this.loggerService = inject(TYPES.loggerService);
         this.loaderService = inject(TYPES.loaderService);
         this.DEFAULT_TEMPLATE_DIR = path.resolve(__dirname, '..', 'template');
+        this.DEFAULT_MODULES_DIR = path.resolve(__dirname, '..', 'modules');
         this.OVERRIDE_TEMPLATE_DIR = path.resolve(process.cwd(), 'template');
         this.OVERRIDE_MODULES_DIR = path.resolve(process.cwd(), 'modules');
+        this.getIsLaunched = () => {
+            this.loggerService.log("resolveService getIsLaunched");
+            return _is_launched;
+        };
         this.attachEntryPoint = async (entryPoint) => {
             this.loggerService.log("resolveService attachEntryPoint");
             if (_is_launched) {
@@ -1693,25 +1721,36 @@ class TelegramTemplateService {
     }
 }
 
+const GET_MODULE_VARIANTS_FN = (fileName, self) => {
+    const result = [];
+    result.push({
+        filePath: path.join(process.cwd(), "modules", fileName),
+        baseDir: path.join(process.cwd(), "modules")
+    });
+    result.push({
+        filePath: path.join(self.resolveService.OVERRIDE_MODULES_DIR, fileName),
+        baseDir: self.resolveService.OVERRIDE_MODULES_DIR,
+    });
+    result.push({
+        filePath: path.join(self.resolveService.DEFAULT_MODULES_DIR, fileName),
+        baseDir: self.resolveService.DEFAULT_MODULES_DIR,
+    });
+    return result;
+};
 const LOAD_MODULE_MODULE_FN = async (fileName, self) => {
-    const overridePath = path.join(self.resolveService.OVERRIDE_MODULES_DIR, fileName);
-    const targetPath = path.join(process.cwd(), "modules", fileName);
-    const hasOverride = await fs$1
-        .access(overridePath, constants.F_OK | constants.R_OK)
-        .then(() => true)
-        .catch(() => false);
-    const resolvedFile = hasOverride ? overridePath : targetPath;
-    try {
-        if (self.loaderService.check(resolvedFile)) {
-            self.loaderService.import(resolvedFile);
-            return true;
+    for (const { filePath, baseDir } of GET_MODULE_VARIANTS_FN(fileName, self)) {
+        try {
+            if (await self.loaderService.check(filePath, baseDir)) {
+                self.loaderService.import(filePath, baseDir);
+                return true;
+            }
+        }
+        catch {
+            console.warn(`Module module import failed filePath=${filePath} baseDir=${baseDir}`);
+            process.exit(-1);
         }
-        return false;
-    }
-    catch {
-        console.warn(`Module module import failed for file: ${resolvedFile}`);
-        return false;
     }
+    return false;
 };
 class ModuleConnectionService {
     constructor() {
@@ -2201,6 +2240,9 @@ function setLogger(logger) {
 
 let _is_started = false;
 async function run(mode, args) {
+    if (cli.resolveService.getIsLaunched()) {
+        throw new Error("Entry point is already attached. Multiple entry points are not allowed.");
+    }
     {
         if (_is_started) {
             throw new Error("Should be called only once");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@backtest-kit/cli",
-  "version": "5.6.0",
+  "version": "5.9.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",
@@ -60,11 +60,11 @@
   "devDependencies": {
     "@babel/plugin-transform-modules-umd": "7.27.1",
     "@babel/standalone": "7.29.1",
-    "@backtest-kit/ui": "5.6.0",
-    "@backtest-kit/graph": "5.6.0",
-    "@backtest-kit/ollama": "5.6.0",
-    "@backtest-kit/pinets": "5.6.0",
-    "@backtest-kit/signals": "5.6.0",
+    "@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",
     "@rollup/plugin-replace": "6.0.3",
     "@rollup/plugin-typescript": "11.1.6",
     "@types/image-size": "0.7.0",
@@ -72,7 +72,7 @@
     "@types/mustache": "4.2.6",
     "@types/node": "22.9.0",
     "@types/stack-trace": "0.0.33",
-    "backtest-kit": "5.6.0",
+    "backtest-kit": "5.9.0",
     "glob": "11.0.1",
     "markdown-it": "14.1.1",
     "rimraf": "6.0.1",
@@ -87,12 +87,12 @@
   "peerDependencies": {
     "@babel/plugin-transform-modules-umd": "^7.27.1",
     "@babel/standalone": "^7.29.1",
-    "@backtest-kit/ui": "^5.6.0",
-    "@backtest-kit/graph": "^5.6.0",
-    "@backtest-kit/ollama": "^5.6.0",
-    "@backtest-kit/pinets": "^5.6.0",
-    "@backtest-kit/signals": "^5.6.0",
-    "backtest-kit": "^5.6.0",
+    "@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",
     "markdown-it": "^14.1.1",
     "typescript": "^5.0.0"
   },

package/types.d.ts

@@ -99,8 +99,10 @@ declare class ResolveService {
     readonly loggerService: LoggerService;
     readonly loaderService: LoaderService;
     readonly DEFAULT_TEMPLATE_DIR: string;
+    readonly DEFAULT_MODULES_DIR: string;
     readonly OVERRIDE_TEMPLATE_DIR: string;
     readonly OVERRIDE_MODULES_DIR: string;
+    getIsLaunched: () => boolean;
     attachEntryPoint: (entryPoint: string) => Promise<void>;
 }