@backtest-kit/cli 9.3.0 → 9.4.0

package/README.md

@@ -732,6 +732,8 @@ Broker.enable();
 
 `@backtest-kit/cli` loads a `{projectRoot}/config/setup.config` file once before any module hooks or strategy code run. Use it to perform one-time initialization that must happen before the first persistence call — registering a custom storage backend, configuring a logger, seeding global state, or anything else the process needs before `backtest-kit` starts.
 
+**Important:** When `setup.config` is present, the CLI skips its own default adapter registration — it does **not** call `usePersist()` / `useLocal()` / `useMemory()` for any of the persistence slots. This means your config takes full ownership of the persistence layer: whatever adapters you register in `{projectRoot}/config/setup.config` are the ones `backtest-kit` uses, with no interference from the CLI defaults.
+
 ### Example: MongoDB + Redis persistence via `@backtest-kit/mongo`
 
 The most common use-case is swapping the default file-based persistence for a production-grade backend. Install `@backtest-kit/mongo` and call `setup()` — it registers all 15 persistence adapters in one call and reads connection parameters from environment variables:

package/build/index.cjs

@@ -24,7 +24,7 @@ var jsdom = require('jsdom');
 var Mustache = require('mustache');
 var standalone = require('@babel/standalone');
 var pluginUMD = require('@babel/plugin-transform-modules-umd');
-var module$1 = require('module');
+var Module = require('module');
 var BacktestKitGraph = require('@backtest-kit/graph');
 var BacktestKitOllama = require('@backtest-kit/ollama');
 var BacktestKitPinets = require('@backtest-kit/pinets');
@@ -266,6 +266,136 @@ const TYPES = {
 
 const entrySubject = new functoolsKit.BehaviorSubject();
 
+const SETUP_ADAPTER_FN = () => {
+    {
+        BacktestKit.Dump.useMarkdown();
+    }
+    {
+        BacktestKit.SessionLive.usePersist();
+        BacktestKit.SessionBacktest.useLocal();
+    }
+    {
+        BacktestKit.StorageLive.usePersist();
+        BacktestKit.StorageBacktest.useMemory();
+    }
+    {
+        BacktestKit.RecentLive.usePersist();
+        BacktestKit.RecentBacktest.useMemory();
+    }
+    {
+        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();
+    }
+};
+class SetupUtils {
+    constructor() {
+        this.enable = functoolsKit.singleshot(() => {
+            cli.loggerService.debug("SetupUtils enable");
+            {
+                const config = cli.configService.getNotificationConfig();
+                BacktestKit.Notification.enable(config);
+            }
+            {
+                BacktestKit.Recent.enable();
+                BacktestKit.Storage.enable();
+            }
+            {
+                BacktestKit.Markdown.enable();
+                BacktestKit.Report.enable();
+                BacktestKit.Dump.enable();
+                BacktestKit.State.enable();
+                BacktestKit.Memory.enable();
+            }
+            if (!cli.configConnectionService.hasConfig("setup.config")) {
+                SETUP_ADAPTER_FN();
+            }
+        });
+        this.clear = () => {
+            cli.loggerService.debug("SetupUtils clear");
+            if (!this.enable.hasValue()) {
+                return;
+            }
+            this.enable.clear();
+            {
+                BacktestKit.Recent.disable();
+                BacktestKit.Storage.disable();
+                BacktestKit.Notification.disable();
+            }
+            {
+                BacktestKit.Markdown.disable();
+                BacktestKit.Report.disable();
+                BacktestKit.Dump.disable();
+                BacktestKit.Memory.disable();
+            }
+            {
+                BacktestKit.Markdown.clear();
+                BacktestKit.Report.clear();
+                BacktestKit.MarkdownWriter.clear();
+                BacktestKit.ReportWriter.clear();
+            }
+            {
+                BacktestKit.PersistSignalAdapter.clear();
+                BacktestKit.PersistRiskAdapter.clear();
+                BacktestKit.PersistScheduleAdapter.clear();
+                BacktestKit.PersistPartialAdapter.clear();
+                BacktestKit.PersistBreakevenAdapter.clear();
+                BacktestKit.PersistCandleAdapter.clear();
+                BacktestKit.PersistStorageAdapter.clear();
+                BacktestKit.PersistNotificationAdapter.clear();
+                BacktestKit.PersistLogAdapter.clear();
+                BacktestKit.PersistMeasureAdapter.clear();
+                BacktestKit.PersistIntervalAdapter.clear();
+                BacktestKit.PersistMemoryAdapter.clear();
+                BacktestKit.PersistRecentAdapter.clear();
+                BacktestKit.PersistStateAdapter.clear();
+                BacktestKit.PersistSessionAdapter.clear();
+            }
+            {
+                BacktestKit.Dump.clear();
+                BacktestKit.Log.clear();
+                BacktestKit.Markdown.clear();
+            }
+            {
+                BacktestKit.StorageLive.clear();
+                BacktestKit.StorageBacktest.clear();
+            }
+            {
+                BacktestKit.NotificationLive.clear();
+                BacktestKit.NotificationBacktest.clear();
+            }
+            {
+                BacktestKit.RecentLive.clear();
+                BacktestKit.RecentBacktest.clear();
+            }
+        };
+        this.update = () => {
+            cli.loggerService.debug("SetupUtils update");
+            if (cli.configConnectionService.hasConfig("setup.config")) {
+                return;
+            }
+            BacktestKit.Log.useJsonl();
+            BacktestKit.Dump.useMarkdown();
+        };
+    }
+}
+const Setup = new SetupUtils();
+
 const __filename$3 = 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)));
 const __dirname$3 = path.dirname(__filename$3);
 let _is_launched = false;
@@ -327,7 +457,7 @@ class ResolveService {
             {
                 const cwd = process.cwd();
                 process.chdir(moduleRoot);
-                cwd !== moduleRoot && BacktestKit.Log.useJsonl();
+                cwd !== moduleRoot && Setup.update();
                 dotenv.config({ path: path.join(cwd, '.env'), override: true, quiet: true });
                 dotenv.config({ path: path.join(moduleRoot, '.env'), override: true, quiet: true });
                 this.loaderService.import(absolutePath);
@@ -753,123 +883,6 @@ const notifyVerbose = functoolsKit.singleshot(() => {
     });
 });
 
-class SetupUtils {
-    constructor() {
-        this.enable = functoolsKit.singleshot(() => {
-            cli.loggerService.debug("SetupUtils enable");
-            {
-                const config = cli.configService.getNotificationConfig();
-                BacktestKit.Notification.enable(config);
-            }
-            {
-                BacktestKit.Recent.enable();
-                BacktestKit.Storage.enable();
-            }
-            {
-                BacktestKit.Markdown.enable();
-                BacktestKit.Report.enable();
-                BacktestKit.Dump.enable();
-                BacktestKit.State.enable();
-                BacktestKit.Memory.enable();
-            }
-            {
-                BacktestKit.Dump.useMarkdown();
-            }
-            {
-                BacktestKit.SessionLive.usePersist();
-                BacktestKit.SessionBacktest.useLocal();
-            }
-            {
-                BacktestKit.StorageLive.usePersist();
-                BacktestKit.StorageBacktest.useMemory();
-            }
-            {
-                BacktestKit.RecentLive.usePersist();
-                BacktestKit.RecentBacktest.useMemory();
-            }
-            {
-                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();
-            }
-        });
-        this.clear = () => {
-            cli.loggerService.debug("SetupUtils clear");
-            if (!this.enable.hasValue()) {
-                return;
-            }
-            this.enable.clear();
-            {
-                BacktestKit.Recent.disable();
-                BacktestKit.Storage.disable();
-                BacktestKit.Notification.disable();
-            }
-            {
-                BacktestKit.Markdown.disable();
-                BacktestKit.Report.disable();
-                BacktestKit.Dump.disable();
-                BacktestKit.Memory.disable();
-            }
-            {
-                BacktestKit.Markdown.clear();
-                BacktestKit.Report.clear();
-                BacktestKit.MarkdownWriter.clear();
-                BacktestKit.ReportWriter.clear();
-            }
-            {
-                BacktestKit.PersistSignalAdapter.clear();
-                BacktestKit.PersistRiskAdapter.clear();
-                BacktestKit.PersistScheduleAdapter.clear();
-                BacktestKit.PersistPartialAdapter.clear();
-                BacktestKit.PersistBreakevenAdapter.clear();
-                BacktestKit.PersistCandleAdapter.clear();
-                BacktestKit.PersistStorageAdapter.clear();
-                BacktestKit.PersistNotificationAdapter.clear();
-                BacktestKit.PersistLogAdapter.clear();
-                BacktestKit.PersistMeasureAdapter.clear();
-                BacktestKit.PersistIntervalAdapter.clear();
-                BacktestKit.PersistMemoryAdapter.clear();
-                BacktestKit.PersistRecentAdapter.clear();
-                BacktestKit.PersistStateAdapter.clear();
-                BacktestKit.PersistSessionAdapter.clear();
-            }
-            {
-                BacktestKit.Dump.clear();
-                BacktestKit.Log.clear();
-                BacktestKit.Markdown.clear();
-            }
-            {
-                BacktestKit.StorageLive.clear();
-                BacktestKit.StorageBacktest.clear();
-            }
-            {
-                BacktestKit.NotificationLive.clear();
-                BacktestKit.NotificationBacktest.clear();
-            }
-            {
-                BacktestKit.RecentLive.clear();
-                BacktestKit.RecentBacktest.clear();
-            }
-        };
-    }
-}
-const Setup = new SetupUtils();
-
 const DEFAULT_CACHE_LIST$1 = ["1m", "15m", "30m", "1h", "4h"];
 const GET_CACHE_INTERVAL_LIST_FN$1 = () => {
     const { values } = getArgs();
@@ -897,6 +910,7 @@ class BacktestMainService {
             this.loggerService.log("backtestMainService run", {
                 payload,
             });
+            await this.configConnectionService.loadConfig("setup.config");
             {
                 await this.configService.waitForInit();
                 Setup.enable();
@@ -909,7 +923,6 @@ class BacktestMainService {
                 const cwd = process.cwd();
                 dotenv.config({ path: path.join(cwd, '.env'), override: true, quiet: true });
             }
-            await this.configConnectionService.loadConfig("setup.config");
             {
                 await this.resolveService.attachJavascript(payload.entryPoint);
                 await this.moduleConnectionService.loadModule("backtest.module");
@@ -1016,6 +1029,7 @@ class WalkerMainService {
         this.configConnectionService = inject(TYPES.configConnectionService);
         this.run = functoolsKit.singleshot(async (payload) => {
             this.loggerService.log("walkerMainService run", { payload });
+            await this.configConnectionService.loadConfig("setup.config");
             {
                 await this.configService.waitForInit();
                 Setup.enable();
@@ -1034,7 +1048,7 @@ class WalkerMainService {
                     Setup.enable();
                 }
                 {
-                    cwd !== moduleRoot && BacktestKit.Log.useJsonl();
+                    cwd !== moduleRoot && Setup.update();
                     dotenv.config({ path: path.join(cwd, '.env'), override: true, quiet: true });
                     dotenv.config({ path: path.join(moduleRoot, '.env'), override: true, quiet: true });
                 }
@@ -1053,7 +1067,6 @@ class WalkerMainService {
                 const cwd = process.cwd();
                 dotenv.config({ path: path.join(cwd, '.env'), override: true, quiet: true });
             }
-            await this.configConnectionService.loadConfig("setup.config");
             await this.moduleConnectionService.loadModule("walker.module");
             {
                 this.exchangeSchemaService.addSchema();
@@ -1110,7 +1123,7 @@ class WalkerMainService {
                     }
                     restoreSnapshot();
                     {
-                        cwd !== moduleRoot && BacktestKit.Log.useJsonl();
+                        cwd !== moduleRoot && Setup.update();
                         dotenv.config({ path: path.join(cwd, '.env'), override: true, quiet: true });
                         dotenv.config({ path: path.join(moduleRoot, '.env'), override: true, quiet: true });
                     }
@@ -1241,6 +1254,7 @@ class LiveMainService {
             this.loggerService.log("liveMainService run", {
                 payload,
             });
+            await this.configConnectionService.loadConfig("setup.config");
             {
                 await this.configService.waitForInit();
                 Setup.enable();
@@ -1253,7 +1267,6 @@ class LiveMainService {
                 const cwd = process.cwd();
                 dotenv.config({ path: path.join(cwd, '.env'), override: true, quiet: true });
             }
-            await this.configConnectionService.loadConfig("setup.config");
             {
                 await this.resolveService.attachJavascript(payload.entryPoint);
                 await this.moduleConnectionService.loadModule("live.module");
@@ -1327,6 +1340,7 @@ class PaperMainService {
         this.configConnectionService = inject(TYPES.configConnectionService);
         this.run = functoolsKit.singleshot(async (payload) => {
             this.loggerService.log("paperMainService init");
+            await this.configConnectionService.loadConfig("setup.config");
             {
                 await this.configService.waitForInit();
                 Setup.enable();
@@ -1339,7 +1353,6 @@ class PaperMainService {
                 const cwd = process.cwd();
                 dotenv.config({ path: path.join(cwd, '.env'), override: true, quiet: true });
             }
-            await this.configConnectionService.loadConfig("setup.config");
             {
                 await this.resolveService.attachJavascript(payload.entryPoint);
                 await this.moduleConnectionService.loadModule("paper.module");
@@ -2540,12 +2553,22 @@ class ModuleConnectionService {
         this.loggerService = inject(TYPES.loggerService);
         this.resolveService = inject(TYPES.resolveService);
         this.loaderService = inject(TYPES.loaderService);
-        this.loadModule = async (fileName) => {
-            this.loggerService.log("moduleConnectionService loadModule", {
+        this.hasModule = (fileName) => {
+            this.loggerService.log("moduleConnectionService hasModule", {
                 fileName,
             });
-            return await LOAD_MODULE_MODULE_FN(fileName, this);
+            return this.loadModule.has(fileName);
         };
+        this.loadModule = functoolsKit.memoize(([fileName]) => `${fileName}`, async (fileName) => {
+            this.loggerService.log("moduleConnectionService loadModule", {
+                fileName,
+            });
+            const module = await LOAD_MODULE_MODULE_FN(fileName, this);
+            if (!module) {
+                this.loadModule.clear(fileName);
+            }
+            return module;
+        });
     }
 }
 
@@ -2588,6 +2611,18 @@ class BabelService {
     }
 }
 
+const require$1 = Module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)));
+const ModuleWithCache = Module;
+function overrideModule(moduleName, newExports) {
+    const cache = ModuleWithCache._cache;
+    const key = require$1.resolve(moduleName);
+    if (!cache[key]) {
+        cache[key] = new ModuleWithCache(key);
+        cache[key].loaded = true;
+    }
+    cache[key].exports = newExports;
+}
+
 /**
  * This file is used to define any aliases for imports in the client code. This is useful for mocking modules during testing or for providing alternative implementations of certain modules.
  * For example, if we want to mock the "pinets" module during testing, we can add an entry to the IMPORT_ALIAS object that points to our mock implementation. Then, when the client code tries to import "pinets", it will receive our mock implementation instead of the actual "pinets" module.
@@ -2770,7 +2805,7 @@ class ClientLoader {
             this.params.logger.log("ClientLoader baseRequire", {
                 basePath: this.params.path,
             });
-            return module$1.createRequire(this.__filename);
+            return Module.createRequire(this.__filename);
         });
         this.__filename = path.join(params.path, "index.cjs");
         this.__dirname = path.dirname(this.__filename);
@@ -2824,6 +2859,13 @@ globalThis.BacktestKitGraph = BacktestKitGraph__namespace;
 globalThis.BacktestKitOllama = BacktestKitOllama__namespace;
 globalThis.BacktestKitPinets = BacktestKitPinets__namespace;
 globalThis.BacktestKitSignals = BacktestKitSignals__namespace;
+overrideModule('backtest-kit', BacktestKit__namespace);
+overrideModule('@backtest-kit/cli', BacktestKitCli);
+overrideModule('@backtest-kit/ui', BacktestKitUi__namespace);
+overrideModule('@backtest-kit/graph', BacktestKitGraph__namespace);
+overrideModule('@backtest-kit/ollama', BacktestKitOllama__namespace);
+overrideModule('@backtest-kit/pinets', BacktestKitPinets__namespace);
+overrideModule('@backtest-kit/signals', BacktestKitSignals__namespace);
 
 const GET_ALIAS_EXPORTS_FN = (self) => {
     const instance = self.getInstance(self.resolveService.OVERRIDE_CONFIG_DIR);
@@ -2831,9 +2873,7 @@ const GET_ALIAS_EXPORTS_FN = (self) => {
         return null;
     }
     const exports = instance.import("alias.config");
-    return "default" in exports
-        ? exports.default
-        : exports;
+    return "default" in exports ? exports.default : exports;
 };
 const INIT_ALIAS_FN = (self) => {
     const alias = GET_ALIAS_EXPORTS_FN(self);
@@ -2843,7 +2883,10 @@ const INIT_ALIAS_FN = (self) => {
     if (!functoolsKit.isObject(alias)) {
         return;
     }
-    Object.assign(IMPORT_ALIAS, alias);
+    {
+        Object.entries(alias).forEach(([name, module]) => overrideModule(name, module));
+        Object.assign(IMPORT_ALIAS, alias);
+    }
 };
 class LoaderService {
     constructor() {
@@ -2914,12 +2957,22 @@ class ConfigConnectionService {
         this.loggerService = inject(TYPES.loggerService);
         this.resolveService = inject(TYPES.resolveService);
         this.loaderService = inject(TYPES.loaderService);
-        this.loadConfig = (fileName) => {
-            this.loggerService.log("configConnectionService loadConfig", {
+        this.hasConfig = (fileName) => {
+            this.loggerService.log("configConnectionService hasConfig", {
                 fileName,
             });
-            return LOAD_CONFIG_CONFIG_FN(fileName, this);
+            return this.loadConfig.has(fileName);
         };
+        this.loadConfig = functoolsKit.memoize(([fileName]) => `${fileName}`, async (fileName) => {
+            this.loggerService.log("configConnectionService loadConfig", {
+                fileName,
+            });
+            const config = await LOAD_CONFIG_CONFIG_FN(fileName, this);
+            if (!config) {
+                this.loadConfig.clear(fileName);
+            }
+            return config;
+        });
     }
 }
 
@@ -3363,15 +3416,17 @@ const main$a = async () => {
     if (!values.noFlush) {
         await flush(entryPoint);
     }
-    await cli.configService.waitForInit();
-    Setup.enable();
+    await cli.configConnectionService.loadConfig("setup.config");
+    {
+        await cli.configService.waitForInit();
+        Setup.enable();
+    }
     cli.frontendProviderService.connect();
     cli.telegramProviderService.connect();
     {
         const cwd = process.cwd();
         dotenv.config({ path: path.join(cwd, '.env'), override: true, quiet: true });
     }
-    await cli.configConnectionService.loadConfig("setup.config");
     await cli.moduleConnectionService.loadModule(MODE_MODULE[mode]);
     listenFinish();
     createGracefulShutdown(mode)();
@@ -3538,6 +3593,7 @@ const main$6 = async () => {
         console.warn("--editor and --pine are mutually exclusive. Use one at a time.");
         process.exit(1);
     }
+    await cli.configConnectionService.loadConfig("setup.config");
     {
         await cli.configService.waitForInit();
         Setup.enable();
@@ -3546,7 +3602,6 @@ const main$6 = async () => {
         const cwd = process.cwd();
         dotenv.config({ path: path.join(cwd, '.env'), override: true, quiet: true });
     }
-    await cli.configConnectionService.loadConfig("setup.config");
     await cli.moduleConnectionService.loadModule("editor.module");
     {
         await cli.exchangeSchemaService.addSchema();

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, State, Memory, SessionLive, SessionBacktest, 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, PersistSessionAdapter, listStrategySchema, overrideExchangeSchema, Backtest, System, Cache, Interval, alignToInterval, addWalkerSchema, overrideWalkerSchema, Walker, listenDoneWalker, Live, getCandles, checkCandles, warmCandles, listenRisk, listenStrategyCommit, listenSync, listenSignalNotify, Exchange } from 'backtest-kit';
+import { setConfig, Notification, Recent, Storage, Markdown, Report, Dump, State, Memory, MarkdownWriter, ReportWriter, PersistSignalAdapter, PersistRiskAdapter, PersistScheduleAdapter, PersistPartialAdapter, PersistBreakevenAdapter, PersistCandleAdapter, PersistStorageAdapter, PersistNotificationAdapter, PersistLogAdapter, PersistMeasureAdapter, PersistIntervalAdapter, PersistMemoryAdapter, PersistRecentAdapter, PersistStateAdapter, PersistSessionAdapter, Log, StorageLive, StorageBacktest, NotificationLive, NotificationBacktest, RecentLive, RecentBacktest, SessionLive, SessionBacktest, MemoryLive, MemoryBacktest, StateLive, StateBacktest, listExchangeSchema, addExchangeSchema, roundTicks, listFrameSchema, addFrameSchema, listenDoneLive, listenDoneBacktest, shutdown, listenSignal, listStrategySchema, overrideExchangeSchema, Backtest, System, 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, realpathSync } from 'fs';
 import * as stackTrace from 'stack-trace';
@@ -24,7 +24,7 @@ import { JSDOM } from 'jsdom';
 import Mustache from 'mustache';
 import { registerPlugin, transform } from '@babel/standalone';
 import pluginUMD from '@babel/plugin-transform-modules-umd';
-import { createRequire } from 'module';
+import Module, { createRequire } from 'module';
 import * as BacktestKitGraph from '@backtest-kit/graph';
 import * as BacktestKitOllama from '@backtest-kit/ollama';
 import * as BacktestKitPinets from '@backtest-kit/pinets';
@@ -241,6 +241,136 @@ const TYPES = {
 
 const entrySubject = new BehaviorSubject();
 
+const SETUP_ADAPTER_FN = () => {
+    {
+        Dump.useMarkdown();
+    }
+    {
+        SessionLive.usePersist();
+        SessionBacktest.useLocal();
+    }
+    {
+        StorageLive.usePersist();
+        StorageBacktest.useMemory();
+    }
+    {
+        RecentLive.usePersist();
+        RecentBacktest.useMemory();
+    }
+    {
+        NotificationLive.usePersist();
+        NotificationBacktest.useMemory();
+    }
+    {
+        RecentLive.usePersist();
+        RecentBacktest.useMemory();
+    }
+    {
+        MemoryLive.usePersist();
+        MemoryBacktest.useLocal();
+    }
+    {
+        StateLive.usePersist();
+        StateBacktest.useLocal();
+    }
+    {
+        Markdown.useDummy();
+        Log.useJsonl();
+    }
+};
+class SetupUtils {
+    constructor() {
+        this.enable = singleshot(() => {
+            cli.loggerService.debug("SetupUtils enable");
+            {
+                const config = cli.configService.getNotificationConfig();
+                Notification.enable(config);
+            }
+            {
+                Recent.enable();
+                Storage.enable();
+            }
+            {
+                Markdown.enable();
+                Report.enable();
+                Dump.enable();
+                State.enable();
+                Memory.enable();
+            }
+            if (!cli.configConnectionService.hasConfig("setup.config")) {
+                SETUP_ADAPTER_FN();
+            }
+        });
+        this.clear = () => {
+            cli.loggerService.debug("SetupUtils clear");
+            if (!this.enable.hasValue()) {
+                return;
+            }
+            this.enable.clear();
+            {
+                Recent.disable();
+                Storage.disable();
+                Notification.disable();
+            }
+            {
+                Markdown.disable();
+                Report.disable();
+                Dump.disable();
+                Memory.disable();
+            }
+            {
+                Markdown.clear();
+                Report.clear();
+                MarkdownWriter.clear();
+                ReportWriter.clear();
+            }
+            {
+                PersistSignalAdapter.clear();
+                PersistRiskAdapter.clear();
+                PersistScheduleAdapter.clear();
+                PersistPartialAdapter.clear();
+                PersistBreakevenAdapter.clear();
+                PersistCandleAdapter.clear();
+                PersistStorageAdapter.clear();
+                PersistNotificationAdapter.clear();
+                PersistLogAdapter.clear();
+                PersistMeasureAdapter.clear();
+                PersistIntervalAdapter.clear();
+                PersistMemoryAdapter.clear();
+                PersistRecentAdapter.clear();
+                PersistStateAdapter.clear();
+                PersistSessionAdapter.clear();
+            }
+            {
+                Dump.clear();
+                Log.clear();
+                Markdown.clear();
+            }
+            {
+                StorageLive.clear();
+                StorageBacktest.clear();
+            }
+            {
+                NotificationLive.clear();
+                NotificationBacktest.clear();
+            }
+            {
+                RecentLive.clear();
+                RecentBacktest.clear();
+            }
+        };
+        this.update = () => {
+            cli.loggerService.debug("SetupUtils update");
+            if (cli.configConnectionService.hasConfig("setup.config")) {
+                return;
+            }
+            Log.useJsonl();
+            Dump.useMarkdown();
+        };
+    }
+}
+const Setup = new SetupUtils();
+
 const __filename$2 = fileURLToPath(import.meta.url);
 const __dirname$2 = path.dirname(__filename$2);
 let _is_launched = false;
@@ -302,7 +432,7 @@ class ResolveService {
             {
                 const cwd = process.cwd();
                 process.chdir(moduleRoot);
-                cwd !== moduleRoot && Log.useJsonl();
+                cwd !== moduleRoot && Setup.update();
                 dotenv.config({ path: path.join(cwd, '.env'), override: true, quiet: true });
                 dotenv.config({ path: path.join(moduleRoot, '.env'), override: true, quiet: true });
                 this.loaderService.import(absolutePath);
@@ -728,123 +858,6 @@ const notifyVerbose = singleshot(() => {
     });
 });
 
-class SetupUtils {
-    constructor() {
-        this.enable = singleshot(() => {
-            cli.loggerService.debug("SetupUtils enable");
-            {
-                const config = cli.configService.getNotificationConfig();
-                Notification.enable(config);
-            }
-            {
-                Recent.enable();
-                Storage.enable();
-            }
-            {
-                Markdown.enable();
-                Report.enable();
-                Dump.enable();
-                State.enable();
-                Memory.enable();
-            }
-            {
-                Dump.useMarkdown();
-            }
-            {
-                SessionLive.usePersist();
-                SessionBacktest.useLocal();
-            }
-            {
-                StorageLive.usePersist();
-                StorageBacktest.useMemory();
-            }
-            {
-                RecentLive.usePersist();
-                RecentBacktest.useMemory();
-            }
-            {
-                NotificationLive.usePersist();
-                NotificationBacktest.useMemory();
-            }
-            {
-                RecentLive.usePersist();
-                RecentBacktest.useMemory();
-            }
-            {
-                MemoryLive.usePersist();
-                MemoryBacktest.useLocal();
-            }
-            {
-                StateLive.usePersist();
-                StateBacktest.useLocal();
-            }
-            {
-                Markdown.useDummy();
-                Log.useJsonl();
-            }
-        });
-        this.clear = () => {
-            cli.loggerService.debug("SetupUtils clear");
-            if (!this.enable.hasValue()) {
-                return;
-            }
-            this.enable.clear();
-            {
-                Recent.disable();
-                Storage.disable();
-                Notification.disable();
-            }
-            {
-                Markdown.disable();
-                Report.disable();
-                Dump.disable();
-                Memory.disable();
-            }
-            {
-                Markdown.clear();
-                Report.clear();
-                MarkdownWriter.clear();
-                ReportWriter.clear();
-            }
-            {
-                PersistSignalAdapter.clear();
-                PersistRiskAdapter.clear();
-                PersistScheduleAdapter.clear();
-                PersistPartialAdapter.clear();
-                PersistBreakevenAdapter.clear();
-                PersistCandleAdapter.clear();
-                PersistStorageAdapter.clear();
-                PersistNotificationAdapter.clear();
-                PersistLogAdapter.clear();
-                PersistMeasureAdapter.clear();
-                PersistIntervalAdapter.clear();
-                PersistMemoryAdapter.clear();
-                PersistRecentAdapter.clear();
-                PersistStateAdapter.clear();
-                PersistSessionAdapter.clear();
-            }
-            {
-                Dump.clear();
-                Log.clear();
-                Markdown.clear();
-            }
-            {
-                StorageLive.clear();
-                StorageBacktest.clear();
-            }
-            {
-                NotificationLive.clear();
-                NotificationBacktest.clear();
-            }
-            {
-                RecentLive.clear();
-                RecentBacktest.clear();
-            }
-        };
-    }
-}
-const Setup = new SetupUtils();
-
 const DEFAULT_CACHE_LIST$1 = ["1m", "15m", "30m", "1h", "4h"];
 const GET_CACHE_INTERVAL_LIST_FN$1 = () => {
     const { values } = getArgs();
@@ -872,6 +885,7 @@ class BacktestMainService {
             this.loggerService.log("backtestMainService run", {
                 payload,
             });
+            await this.configConnectionService.loadConfig("setup.config");
             {
                 await this.configService.waitForInit();
                 Setup.enable();
@@ -884,7 +898,6 @@ class BacktestMainService {
                 const cwd = process.cwd();
                 dotenv.config({ path: path.join(cwd, '.env'), override: true, quiet: true });
             }
-            await this.configConnectionService.loadConfig("setup.config");
             {
                 await this.resolveService.attachJavascript(payload.entryPoint);
                 await this.moduleConnectionService.loadModule("backtest.module");
@@ -991,6 +1004,7 @@ class WalkerMainService {
         this.configConnectionService = inject(TYPES.configConnectionService);
         this.run = singleshot(async (payload) => {
             this.loggerService.log("walkerMainService run", { payload });
+            await this.configConnectionService.loadConfig("setup.config");
             {
                 await this.configService.waitForInit();
                 Setup.enable();
@@ -1009,7 +1023,7 @@ class WalkerMainService {
                     Setup.enable();
                 }
                 {
-                    cwd !== moduleRoot && Log.useJsonl();
+                    cwd !== moduleRoot && Setup.update();
                     dotenv.config({ path: path.join(cwd, '.env'), override: true, quiet: true });
                     dotenv.config({ path: path.join(moduleRoot, '.env'), override: true, quiet: true });
                 }
@@ -1028,7 +1042,6 @@ class WalkerMainService {
                 const cwd = process.cwd();
                 dotenv.config({ path: path.join(cwd, '.env'), override: true, quiet: true });
             }
-            await this.configConnectionService.loadConfig("setup.config");
             await this.moduleConnectionService.loadModule("walker.module");
             {
                 this.exchangeSchemaService.addSchema();
@@ -1085,7 +1098,7 @@ class WalkerMainService {
                     }
                     restoreSnapshot();
                     {
-                        cwd !== moduleRoot && Log.useJsonl();
+                        cwd !== moduleRoot && Setup.update();
                         dotenv.config({ path: path.join(cwd, '.env'), override: true, quiet: true });
                         dotenv.config({ path: path.join(moduleRoot, '.env'), override: true, quiet: true });
                     }
@@ -1216,6 +1229,7 @@ class LiveMainService {
             this.loggerService.log("liveMainService run", {
                 payload,
             });
+            await this.configConnectionService.loadConfig("setup.config");
             {
                 await this.configService.waitForInit();
                 Setup.enable();
@@ -1228,7 +1242,6 @@ class LiveMainService {
                 const cwd = process.cwd();
                 dotenv.config({ path: path.join(cwd, '.env'), override: true, quiet: true });
             }
-            await this.configConnectionService.loadConfig("setup.config");
             {
                 await this.resolveService.attachJavascript(payload.entryPoint);
                 await this.moduleConnectionService.loadModule("live.module");
@@ -1302,6 +1315,7 @@ class PaperMainService {
         this.configConnectionService = inject(TYPES.configConnectionService);
         this.run = singleshot(async (payload) => {
             this.loggerService.log("paperMainService init");
+            await this.configConnectionService.loadConfig("setup.config");
             {
                 await this.configService.waitForInit();
                 Setup.enable();
@@ -1314,7 +1328,6 @@ class PaperMainService {
                 const cwd = process.cwd();
                 dotenv.config({ path: path.join(cwd, '.env'), override: true, quiet: true });
             }
-            await this.configConnectionService.loadConfig("setup.config");
             {
                 await this.resolveService.attachJavascript(payload.entryPoint);
                 await this.moduleConnectionService.loadModule("paper.module");
@@ -2515,12 +2528,22 @@ class ModuleConnectionService {
         this.loggerService = inject(TYPES.loggerService);
         this.resolveService = inject(TYPES.resolveService);
         this.loaderService = inject(TYPES.loaderService);
-        this.loadModule = async (fileName) => {
-            this.loggerService.log("moduleConnectionService loadModule", {
+        this.hasModule = (fileName) => {
+            this.loggerService.log("moduleConnectionService hasModule", {
                 fileName,
             });
-            return await LOAD_MODULE_MODULE_FN(fileName, this);
+            return this.loadModule.has(fileName);
         };
+        this.loadModule = memoize(([fileName]) => `${fileName}`, async (fileName) => {
+            this.loggerService.log("moduleConnectionService loadModule", {
+                fileName,
+            });
+            const module = await LOAD_MODULE_MODULE_FN(fileName, this);
+            if (!module) {
+                this.loadModule.clear(fileName);
+            }
+            return module;
+        });
     }
 }
 
@@ -2563,6 +2586,18 @@ class BabelService {
     }
 }
 
+const require = createRequire(import.meta.url);
+const ModuleWithCache = Module;
+function overrideModule(moduleName, newExports) {
+    const cache = ModuleWithCache._cache;
+    const key = require.resolve(moduleName);
+    if (!cache[key]) {
+        cache[key] = new ModuleWithCache(key);
+        cache[key].loaded = true;
+    }
+    cache[key].exports = newExports;
+}
+
 /**
  * This file is used to define any aliases for imports in the client code. This is useful for mocking modules during testing or for providing alternative implementations of certain modules.
  * For example, if we want to mock the "pinets" module during testing, we can add an entry to the IMPORT_ALIAS object that points to our mock implementation. Then, when the client code tries to import "pinets", it will receive our mock implementation instead of the actual "pinets" module.
@@ -2795,6 +2830,13 @@ globalThis.BacktestKitGraph = BacktestKitGraph;
 globalThis.BacktestKitOllama = BacktestKitOllama;
 globalThis.BacktestKitPinets = BacktestKitPinets;
 globalThis.BacktestKitSignals = BacktestKitSignals;
+overrideModule('backtest-kit', BacktestKit);
+overrideModule('@backtest-kit/cli', BacktestKitCli);
+overrideModule('@backtest-kit/ui', BacktestKitUi);
+overrideModule('@backtest-kit/graph', BacktestKitGraph);
+overrideModule('@backtest-kit/ollama', BacktestKitOllama);
+overrideModule('@backtest-kit/pinets', BacktestKitPinets);
+overrideModule('@backtest-kit/signals', BacktestKitSignals);
 
 const GET_ALIAS_EXPORTS_FN = (self) => {
     const instance = self.getInstance(self.resolveService.OVERRIDE_CONFIG_DIR);
@@ -2802,9 +2844,7 @@ const GET_ALIAS_EXPORTS_FN = (self) => {
         return null;
     }
     const exports = instance.import("alias.config");
-    return "default" in exports
-        ? exports.default
-        : exports;
+    return "default" in exports ? exports.default : exports;
 };
 const INIT_ALIAS_FN = (self) => {
     const alias = GET_ALIAS_EXPORTS_FN(self);
@@ -2814,7 +2854,10 @@ const INIT_ALIAS_FN = (self) => {
     if (!isObject(alias)) {
         return;
     }
-    Object.assign(IMPORT_ALIAS, alias);
+    {
+        Object.entries(alias).forEach(([name, module]) => overrideModule(name, module));
+        Object.assign(IMPORT_ALIAS, alias);
+    }
 };
 class LoaderService {
     constructor() {
@@ -2885,12 +2928,22 @@ class ConfigConnectionService {
         this.loggerService = inject(TYPES.loggerService);
         this.resolveService = inject(TYPES.resolveService);
         this.loaderService = inject(TYPES.loaderService);
-        this.loadConfig = (fileName) => {
-            this.loggerService.log("configConnectionService loadConfig", {
+        this.hasConfig = (fileName) => {
+            this.loggerService.log("configConnectionService hasConfig", {
                 fileName,
             });
-            return LOAD_CONFIG_CONFIG_FN(fileName, this);
+            return this.loadConfig.has(fileName);
         };
+        this.loadConfig = memoize(([fileName]) => `${fileName}`, async (fileName) => {
+            this.loggerService.log("configConnectionService loadConfig", {
+                fileName,
+            });
+            const config = await LOAD_CONFIG_CONFIG_FN(fileName, this);
+            if (!config) {
+                this.loadConfig.clear(fileName);
+            }
+            return config;
+        });
     }
 }
 
@@ -3334,15 +3387,17 @@ const main$a = async () => {
     if (!values.noFlush) {
         await flush(entryPoint);
     }
-    await cli.configService.waitForInit();
-    Setup.enable();
+    await cli.configConnectionService.loadConfig("setup.config");
+    {
+        await cli.configService.waitForInit();
+        Setup.enable();
+    }
     cli.frontendProviderService.connect();
     cli.telegramProviderService.connect();
     {
         const cwd = process.cwd();
         dotenv.config({ path: path.join(cwd, '.env'), override: true, quiet: true });
     }
-    await cli.configConnectionService.loadConfig("setup.config");
     await cli.moduleConnectionService.loadModule(MODE_MODULE[mode]);
     listenFinish();
     createGracefulShutdown(mode)();
@@ -3509,6 +3564,7 @@ const main$6 = async () => {
         console.warn("--editor and --pine are mutually exclusive. Use one at a time.");
         process.exit(1);
     }
+    await cli.configConnectionService.loadConfig("setup.config");
     {
         await cli.configService.waitForInit();
         Setup.enable();
@@ -3517,7 +3573,6 @@ const main$6 = async () => {
         const cwd = process.cwd();
         dotenv.config({ path: path.join(cwd, '.env'), override: true, quiet: true });
     }
-    await cli.configConnectionService.loadConfig("setup.config");
     await cli.moduleConnectionService.loadModule("editor.module");
     {
         await cli.exchangeSchemaService.addSchema();

package/docker/package.json

@@ -15,17 +15,17 @@
     "@types/node": "25.6.0"
   },
   "dependencies": {
-    "@backtest-kit/cli": "9.3.0",
-    "@backtest-kit/graph": "9.3.0",
-    "@backtest-kit/pinets": "9.3.0",
-    "@backtest-kit/signals": "9.3.0",
-    "@backtest-kit/ui": "9.3.0",
+    "@backtest-kit/cli": "9.4.0",
+    "@backtest-kit/graph": "9.4.0",
+    "@backtest-kit/pinets": "9.4.0",
+    "@backtest-kit/signals": "9.4.0",
+    "@backtest-kit/ui": "9.4.0",
     "@tavily/core": "0.7.2",
     "@tensorflow/tfjs": "4.22.0",
     "@tensorflow/tfjs-backend-wasm": "4.22.0",
     "@tensorflow/tfjs-core": "4.22.0",
     "agent-swarm-kit": "2.6.0",
-    "backtest-kit": "9.3.0",
+    "backtest-kit": "9.4.0",
     "dayjs": "1.11.20",
     "functools-kit": "2.3.0",
     "garch": "1.2.3",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@backtest-kit/cli",
-  "version": "9.3.0",
+  "version": "9.4.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",
@@ -63,11 +63,11 @@
   "devDependencies": {
     "@babel/plugin-transform-modules-umd": "7.27.1",
     "@babel/standalone": "7.29.1",
-    "@backtest-kit/graph": "9.3.0",
-    "@backtest-kit/ollama": "9.3.0",
-    "@backtest-kit/pinets": "9.3.0",
-    "@backtest-kit/signals": "9.3.0",
-    "@backtest-kit/ui": "9.3.0",
+    "@backtest-kit/graph": "9.4.0",
+    "@backtest-kit/ollama": "9.4.0",
+    "@backtest-kit/pinets": "9.4.0",
+    "@backtest-kit/signals": "9.4.0",
+    "@backtest-kit/ui": "9.4.0",
     "@rollup/plugin-replace": "6.0.3",
     "@rollup/plugin-typescript": "11.1.6",
     "@types/image-size": "0.7.0",
@@ -75,7 +75,7 @@
     "@types/mustache": "4.2.6",
     "@types/node": "22.9.0",
     "@types/stack-trace": "0.0.33",
-    "backtest-kit": "9.3.0",
+    "backtest-kit": "9.4.0",
     "glob": "11.0.1",
     "markdown-it": "14.1.1",
     "rimraf": "6.0.1",
@@ -90,12 +90,12 @@
   "peerDependencies": {
     "@babel/plugin-transform-modules-umd": "^7.27.1",
     "@babel/standalone": "^7.29.1",
-    "@backtest-kit/graph": "^9.3.0",
-    "@backtest-kit/ollama": "^9.3.0",
-    "@backtest-kit/pinets": "^9.3.0",
-    "@backtest-kit/signals": "^9.3.0",
-    "@backtest-kit/ui": "^9.3.0",
-    "backtest-kit": "^9.3.0",
+    "@backtest-kit/graph": "^9.4.0",
+    "@backtest-kit/ollama": "^9.4.0",
+    "@backtest-kit/pinets": "^9.4.0",
+    "@backtest-kit/signals": "^9.4.0",
+    "@backtest-kit/ui": "^9.4.0",
+    "backtest-kit": "^9.4.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": "^9.3.0",
-    "@backtest-kit/graph": "^9.3.0",
-    "@backtest-kit/pinets": "^9.3.0",
-    "@backtest-kit/ui": "^9.3.0",
+    "@backtest-kit/cli": "^9.4.0",
+    "@backtest-kit/graph": "^9.4.0",
+    "@backtest-kit/pinets": "^9.4.0",
+    "@backtest-kit/ui": "^9.4.0",
     "agent-swarm-kit": "^2.6.0",
-    "backtest-kit": "^9.3.0",
+    "backtest-kit": "^9.4.0",
     "functools-kit": "^2.3.0",
     "garch": "^1.2.3",
     "get-moment-stamp": "^1.1.2",

package/types.d.ts

@@ -249,7 +249,8 @@ declare class ConfigConnectionService {
     readonly loggerService: LoggerService;
     readonly resolveService: ResolveService;
     readonly loaderService: LoaderService;
-    loadConfig: (fileName: string) => Promise<ModuleExports>;
+    hasConfig: (fileName: string) => boolean;
+    loadConfig: ((fileName: string) => Promise<ModuleExports>) & functools_kit.IClearableMemoize<string> & functools_kit.IControlMemoize<string, Promise<ModuleExports>>;
 }
 
 declare class FrontendProviderService {
@@ -381,7 +382,8 @@ declare class ModuleConnectionService {
     readonly loggerService: LoggerService;
     readonly resolveService: ResolveService;
     readonly loaderService: LoaderService;
-    loadModule: (fileName: string) => Promise<boolean>;
+    hasModule: (fileName: string) => boolean;
+    loadModule: ((fileName: string) => Promise<boolean>) & functools_kit.IClearableMemoize<string> & functools_kit.IControlMemoize<string, Promise<boolean>>;
 }
 
 declare class ConfigService {
@@ -420,6 +422,7 @@ declare const cli: {
 declare class SetupUtils {
     enable: (() => void) & functools_kit.ISingleshotClearable<() => void>;
     clear: () => void;
+    update: () => void;
 }
 declare const Setup: SetupUtils;