backtest-kit 9.8.0 → 9.8.1

package/build/index.cjs

@@ -37412,7 +37412,19 @@ class BrokerProxy {
  */
 class BrokerAdapter {
     constructor() {
-        this._brokerInstance = null;
+        /** Factory producing the active `BrokerProxy` instance */
+        this._brokerFactory = () => null;
+        /**
+         * Lazily constructs the `BrokerProxy` from the registered factory and
+         * memoizes the result via `singleshot`.
+         *
+         * The proxy is built on the first call and cached for all subsequent calls.
+         * Returns `null` when no adapter has been registered via `useBrokerAdapter()`.
+         *
+         * Reset via `clear()` so the next call rebuilds from the current factory
+         * (e.g. when `process.cwd()` changes between strategy iterations).
+         */
+        this.getInstance = functoolsKit.singleshot(() => this._brokerFactory());
         /**
          * Forwards a signal-open event to the registered broker adapter.
          *
@@ -37446,7 +37458,10 @@ class BrokerAdapter {
             if (payload.backtest) {
                 return;
             }
-            await this._brokerInstance?.onSignalOpenCommit(payload);
+            const instance = this.getInstance();
+            if (instance) {
+                await instance.onSignalOpenCommit(payload);
+            }
         };
         /**
          * Forwards a signal-close event to the registered broker adapter.
@@ -37484,7 +37499,10 @@ class BrokerAdapter {
             if (payload.backtest) {
                 return;
             }
-            await this._brokerInstance?.onSignalCloseCommit(payload);
+            const instance = this.getInstance();
+            if (instance) {
+                await instance.onSignalCloseCommit(payload);
+            }
         };
         /**
          * Intercepts a partial-profit close before DI-core mutation.
@@ -37520,7 +37538,10 @@ class BrokerAdapter {
             if (payload.backtest) {
                 return;
             }
-            await this._brokerInstance?.onPartialProfitCommit(payload);
+            const instance = this.getInstance();
+            if (instance) {
+                await instance.onPartialProfitCommit(payload);
+            }
         };
         /**
          * Intercepts a partial-loss close before DI-core mutation.
@@ -37556,7 +37577,10 @@ class BrokerAdapter {
             if (payload.backtest) {
                 return;
             }
-            await this._brokerInstance?.onPartialLossCommit(payload);
+            const instance = this.getInstance();
+            if (instance) {
+                await instance.onPartialLossCommit(payload);
+            }
         };
         /**
          * Intercepts a trailing stop-loss update before DI-core mutation.
@@ -37592,7 +37616,10 @@ class BrokerAdapter {
             if (payload.backtest) {
                 return;
             }
-            await this._brokerInstance?.onTrailingStopCommit(payload);
+            const instance = this.getInstance();
+            if (instance) {
+                await instance.onTrailingStopCommit(payload);
+            }
         };
         /**
          * Intercepts a trailing take-profit update before DI-core mutation.
@@ -37628,7 +37655,10 @@ class BrokerAdapter {
             if (payload.backtest) {
                 return;
             }
-            await this._brokerInstance?.onTrailingTakeCommit(payload);
+            const instance = this.getInstance();
+            if (instance) {
+                await instance.onTrailingTakeCommit(payload);
+            }
         };
         /**
          * Intercepts a breakeven operation before DI-core mutation.
@@ -37665,7 +37695,10 @@ class BrokerAdapter {
             if (payload.backtest) {
                 return;
             }
-            await this._brokerInstance?.onBreakevenCommit(payload);
+            const instance = this.getInstance();
+            if (instance) {
+                await instance.onBreakevenCommit(payload);
+            }
         };
         /**
          * Intercepts a DCA average-buy entry before DI-core mutation.
@@ -37701,7 +37734,10 @@ class BrokerAdapter {
             if (payload.backtest) {
                 return;
             }
-            await this._brokerInstance?.onAverageBuyCommit(payload);
+            const instance = this.getInstance();
+            if (instance) {
+                await instance.onAverageBuyCommit(payload);
+            }
         };
         /**
          * Registers a broker adapter instance or constructor to receive commit* callbacks.
@@ -37725,11 +37761,12 @@ class BrokerAdapter {
         this.useBrokerAdapter = (broker) => {
             backtest.loggerService.info(BROKER_METHOD_NAME_USE_BROKER_ADAPTER, {});
             if (typeof broker === "function") {
-                const instance = Reflect.construct(broker, []);
-                this._brokerInstance = new BrokerProxy(instance);
-                return;
+                this._brokerFactory = () => new BrokerProxy(Reflect.construct(broker, []));
+            }
+            else {
+                this._brokerFactory = () => new BrokerProxy(broker);
             }
-            this._brokerInstance = new BrokerProxy(broker);
+            this.getInstance.clear();
         };
         /**
          * Activates the broker: subscribes to syncSubject for signal-open / signal-close routing.
@@ -37756,7 +37793,8 @@ class BrokerAdapter {
          */
         this.enable = functoolsKit.singleshot(() => {
             backtest.loggerService.info(BROKER_METHOD_NAME_ENABLE, {});
-            if (!this._brokerInstance) {
+            const instance = this.getInstance();
+            if (!instance) {
                 this.enable.clear();
                 throw new Error("No broker instance provided. Call Broker.useBrokerAdapter first.");
             }
@@ -37844,7 +37882,7 @@ class BrokerAdapter {
          */
         this.clear = () => {
             backtest.loggerService.info(BROKER_METHOD_NAME_CLEAR, {});
-            this._brokerInstance = null;
+            this.getInstance.clear();
             this.enable.clear();
         };
     }
@@ -48864,8 +48902,16 @@ class RecentMemoryLiveUtils {
  */
 class RecentBacktestAdapter {
     constructor() {
-        /** Internal storage utils instance */
-        this._recentBacktestUtils = new RecentMemoryBacktestUtils();
+        /** Factory producing the active storage utils instance */
+        this._recentBacktestFactory = () => new RecentMemoryBacktestUtils();
+        /**
+         * Lazily constructs the storage utils from the registered factory and memoizes
+         * the result via `singleshot`.
+         *
+         * The instance is built on the first call and cached for all subsequent calls.
+         * Reset via `clear()` so the next call rebuilds from the current factory.
+         */
+        this.getInstance = functoolsKit.singleshot(() => this._recentBacktestFactory());
         /**
          * Handles active ping event.
          * Proxies call to the underlying storage adapter.
@@ -48875,7 +48921,7 @@ class RecentBacktestAdapter {
             backtest.loggerService.info(RECENT_BACKTEST_ADAPTER_METHOD_NAME_HANDLE_ACTIVE_PING, {
                 signalId: event.data.id,
             });
-            return await this._recentBacktestUtils.handleActivePing(event);
+            return await this.getInstance().handleActivePing(event);
         };
         /**
          * Retrieves the latest signal for the given context.
@@ -48896,7 +48942,7 @@ class RecentBacktestAdapter {
                 frameName,
                 backtest: backtest$1,
             });
-            return await this._recentBacktestUtils.getLatestSignal(symbol, strategyName, exchangeName, frameName, backtest$1, when);
+            return await this.getInstance().getLatestSignal(symbol, strategyName, exchangeName, frameName, backtest$1, when);
         };
         /**
          * Returns the number of whole minutes elapsed since the latest signal's creation timestamp.
@@ -48920,7 +48966,7 @@ class RecentBacktestAdapter {
                 backtest: backtest$1,
                 timestamp,
             });
-            const signal = await this._recentBacktestUtils.getLatestSignal(symbol, strategyName, exchangeName, frameName, backtest$1, new Date(timestamp));
+            const signal = await this.getInstance().getLatestSignal(symbol, strategyName, exchangeName, frameName, backtest$1, new Date(timestamp));
             if (!signal) {
                 return null;
             }
@@ -48933,7 +48979,8 @@ class RecentBacktestAdapter {
          */
         this.useRecentAdapter = (Ctor) => {
             backtest.loggerService.info(RECENT_BACKTEST_ADAPTER_METHOD_NAME_USE_ADAPTER);
-            this._recentBacktestUtils = Reflect.construct(Ctor, []);
+            this._recentBacktestFactory = () => Reflect.construct(Ctor, []);
+            this.getInstance.clear();
         };
         /**
          * Switches to persistent storage adapter.
@@ -48941,7 +48988,8 @@ class RecentBacktestAdapter {
          */
         this.usePersist = () => {
             backtest.loggerService.info(RECENT_BACKTEST_ADAPTER_METHOD_NAME_USE_PERSIST);
-            this._recentBacktestUtils = new RecentPersistBacktestUtils();
+            this._recentBacktestFactory = () => new RecentPersistBacktestUtils();
+            this.getInstance.clear();
         };
         /**
          * Switches to in-memory storage adapter (default).
@@ -48949,14 +48997,17 @@ class RecentBacktestAdapter {
          */
         this.useMemory = () => {
             backtest.loggerService.info(RECENT_BACKTEST_ADAPTER_METHOD_NAME_USE_MEMORY);
-            this._recentBacktestUtils = new RecentMemoryBacktestUtils();
+            this._recentBacktestFactory = () => new RecentMemoryBacktestUtils();
+            this.getInstance.clear();
         };
         /**
-         * Clears the cached utils instance by resetting to the default in-memory adapter.
+         * Clears the memoized utils instance.
+         * Call this when process.cwd() changes between strategy iterations
+         * so a new instance is created with the updated base path.
          */
         this.clear = () => {
             backtest.loggerService.info(RECENT_BACKTEST_ADAPTER_METHOD_NAME_CLEAR);
-            this._recentBacktestUtils = new RecentMemoryBacktestUtils();
+            this.getInstance.clear();
         };
     }
 }
@@ -48971,8 +49022,16 @@ class RecentBacktestAdapter {
  */
 class RecentLiveAdapter {
     constructor() {
-        /** Internal storage utils instance */
-        this._recentLiveUtils = new RecentPersistLiveUtils();
+        /** Factory producing the active storage utils instance */
+        this._recentLiveFactory = () => new RecentPersistLiveUtils();
+        /**
+         * Lazily constructs the storage utils from the registered factory and memoizes
+         * the result via `singleshot`.
+         *
+         * The instance is built on the first call and cached for all subsequent calls.
+         * Reset via `clear()` so the next call rebuilds from the current factory.
+         */
+        this.getInstance = functoolsKit.singleshot(() => this._recentLiveFactory());
         /**
          * Handles active ping event.
          * Proxies call to the underlying storage adapter.
@@ -48982,7 +49041,7 @@ class RecentLiveAdapter {
             backtest.loggerService.info(RECENT_LIVE_ADAPTER_METHOD_NAME_HANDLE_ACTIVE_PING, {
                 signalId: event.data.id,
             });
-            return await this._recentLiveUtils.handleActivePing(event);
+            return await this.getInstance().handleActivePing(event);
         };
         /**
          * Retrieves the latest signal for the given context.
@@ -49003,7 +49062,7 @@ class RecentLiveAdapter {
                 frameName,
                 backtest: backtest$1,
             });
-            return await this._recentLiveUtils.getLatestSignal(symbol, strategyName, exchangeName, frameName, backtest$1, when);
+            return await this.getInstance().getLatestSignal(symbol, strategyName, exchangeName, frameName, backtest$1, when);
         };
         /**
          * Returns the number of whole minutes elapsed since the latest signal's creation timestamp.
@@ -49027,7 +49086,7 @@ class RecentLiveAdapter {
                 backtest: backtest$1,
                 timestamp,
             });
-            const signal = await this._recentLiveUtils.getLatestSignal(symbol, strategyName, exchangeName, frameName, backtest$1, new Date(timestamp));
+            const signal = await this.getInstance().getLatestSignal(symbol, strategyName, exchangeName, frameName, backtest$1, new Date(timestamp));
             if (!signal) {
                 return null;
             }
@@ -49040,7 +49099,8 @@ class RecentLiveAdapter {
          */
         this.useRecentAdapter = (Ctor) => {
             backtest.loggerService.info(RECENT_LIVE_ADAPTER_METHOD_NAME_USE_ADAPTER);
-            this._recentLiveUtils = Reflect.construct(Ctor, []);
+            this._recentLiveFactory = () => Reflect.construct(Ctor, []);
+            this.getInstance.clear();
         };
         /**
          * Switches to persistent storage adapter (default).
@@ -49048,7 +49108,8 @@ class RecentLiveAdapter {
          */
         this.usePersist = () => {
             backtest.loggerService.info(RECENT_LIVE_ADAPTER_METHOD_NAME_USE_PERSIST);
-            this._recentLiveUtils = new RecentPersistLiveUtils();
+            this._recentLiveFactory = () => new RecentPersistLiveUtils();
+            this.getInstance.clear();
         };
         /**
          * Switches to in-memory storage adapter.
@@ -49056,14 +49117,17 @@ class RecentLiveAdapter {
          */
         this.useMemory = () => {
             backtest.loggerService.info(RECENT_LIVE_ADAPTER_METHOD_NAME_USE_MEMORY);
-            this._recentLiveUtils = new RecentMemoryLiveUtils();
+            this._recentLiveFactory = () => new RecentMemoryLiveUtils();
+            this.getInstance.clear();
         };
         /**
-         * Clears the cached utils instance by resetting to the default persistent adapter.
+         * Clears the memoized utils instance.
+         * Call this when process.cwd() changes between strategy iterations
+         * so a new instance is created with the updated base path.
          */
         this.clear = () => {
             backtest.loggerService.info(RECENT_LIVE_ADAPTER_METHOD_NAME_CLEAR);
-            this._recentLiveUtils = new RecentPersistLiveUtils();
+            this.getInstance.clear();
         };
     }
 }
@@ -54388,16 +54452,26 @@ class LogDummyUtils {
  */
 class LogAdapter {
     constructor() {
-        /** Internal log utils instance */
-        this._log = new LogMemoryUtils();
+        /** Factory producing the active log utils instance */
+        this._logFactory = () => new LogMemoryUtils();
+        /**
+         * Lazily constructs the log utils from the registered factory and memoizes
+         * the result via `singleshot`.
+         *
+         * The instance is built on the first call and cached for all subsequent calls.
+         * Reset via `clear()` so the next call rebuilds from the current factory
+         * (e.g. when `process.cwd()` changes between strategy iterations).
+         */
+        this.getInstance = functoolsKit.singleshot(() => this._logFactory());
         /**
          * Lists all stored log entries.
          * Proxies call to the underlying log adapter.
          * @returns Array of all log entries
          */
         this.getList = async () => {
-            if (this._log.getList) {
-                return await this._log.getList();
+            const log = this.getInstance();
+            if (log.getList) {
+                return await log.getList();
             }
             return [];
         };
@@ -54408,8 +54482,9 @@ class LogAdapter {
          * @param args - Additional arguments
          */
         this.log = (topic, ...args) => {
-            if (this._log.log) {
-                this._log.log(topic, ...args);
+            const log = this.getInstance();
+            if (log.log) {
+                log.log(topic, ...args);
             }
         };
         /**
@@ -54419,8 +54494,9 @@ class LogAdapter {
          * @param args - Additional arguments
          */
         this.debug = (topic, ...args) => {
-            if (this._log.debug) {
-                this._log.debug(topic, ...args);
+            const log = this.getInstance();
+            if (log.debug) {
+                log.debug(topic, ...args);
             }
         };
         /**
@@ -54430,8 +54506,9 @@ class LogAdapter {
          * @param args - Additional arguments
          */
         this.info = (topic, ...args) => {
-            if (this._log.info) {
-                this._log.info(topic, ...args);
+            const log = this.getInstance();
+            if (log.info) {
+                log.info(topic, ...args);
             }
         };
         /**
@@ -54441,8 +54518,9 @@ class LogAdapter {
          * @param args - Additional arguments
          */
         this.warn = (topic, ...args) => {
-            if (this._log.warn) {
-                this._log.warn(topic, ...args);
+            const log = this.getInstance();
+            if (log.warn) {
+                log.warn(topic, ...args);
             }
         };
         /**
@@ -54452,7 +54530,8 @@ class LogAdapter {
          */
         this.useLogger = (Ctor) => {
             backtest.loggerService.info(LOG_ADAPTER_METHOD_NAME_USE_LOGGER);
-            this._log = Reflect.construct(Ctor, []);
+            this._logFactory = () => Reflect.construct(Ctor, []);
+            this.getInstance.clear();
         };
         /**
          * Switches to persistent log adapter.
@@ -54460,7 +54539,8 @@ class LogAdapter {
          */
         this.usePersist = () => {
             backtest.loggerService.info(LOG_ADAPTER_METHOD_NAME_USE_PERSIST);
-            this._log = new LogPersistUtils();
+            this._logFactory = () => new LogPersistUtils();
+            this.getInstance.clear();
         };
         /**
          * Switches to in-memory log adapter (default).
@@ -54468,7 +54548,8 @@ class LogAdapter {
          */
         this.useMemory = () => {
             backtest.loggerService.info(LOG_ADAPTER_METHOD_NAME_USE_MEMORY);
-            this._log = new LogMemoryUtils();
+            this._logFactory = () => new LogMemoryUtils();
+            this.getInstance.clear();
         };
         /**
          * Switches to dummy log adapter.
@@ -54476,7 +54557,8 @@ class LogAdapter {
          */
         this.useDummy = () => {
             backtest.loggerService.info(LOG_ADAPTER_METHOD_NAME_USE_DUMMY);
-            this._log = new LogDummyUtils();
+            this._logFactory = () => new LogDummyUtils();
+            this.getInstance.clear();
         };
         /**
          * Switches to JSONL file log adapter.
@@ -54486,18 +54568,22 @@ class LogAdapter {
          * @param fileName - Base file name without extension (default: "log")
          * @param dirName - Directory for the JSONL file (default: ./dump/log)
          */
-        this.useJsonl = (fileName = "log.jsonl", dirName = path.join(process.cwd(), "./dump/log")) => {
+        this.useJsonl = (fileName = "log.jsonl", dirName) => {
             backtest.loggerService.info(LOG_ADAPTER_METHOD_NAME_USE_JSONL);
-            this._log = new LogJsonlUtils(fileName, dirName);
+            this._logFactory = () => {
+                const dir = dirName || path.join(process.cwd(), "./dump/log");
+                return new LogJsonlUtils(fileName, dir);
+            };
+            this.getInstance.clear();
         };
         /**
-         * Clears the cached log instance by resetting to the default in-memory adapter.
+         * Clears the memoized log instance.
          * Call this when process.cwd() changes between strategy iterations
          * so a new adapter instance is created with the updated base path.
          */
         this.clear = () => {
             backtest.loggerService.info(LOG_ADAPTER_METHOD_NAME_CLEAR);
-            this._log = new LogMemoryUtils();
+            this.getInstance.clear();
         };
     }
 }
@@ -58389,15 +58475,23 @@ class StorageDummyLiveUtils {
  */
 class StorageBacktestAdapter {
     constructor() {
-        /** Internal storage utils instance */
-        this._signalBacktestUtils = new StorageMemoryBacktestUtils();
+        /** Factory producing the active storage utils instance */
+        this._signalBacktestFactory = () => new StorageMemoryBacktestUtils();
+        /**
+         * Lazily constructs the storage utils from the registered factory and memoizes
+         * the result via `singleshot`.
+         *
+         * The instance is built on the first call and cached for all subsequent calls.
+         * Reset via `clear()` so the next call rebuilds from the current factory.
+         */
+        this.getInstance = functoolsKit.singleshot(() => this._signalBacktestFactory());
         /**
          * Handles signal opened event.
          * Proxies call to the underlying storage adapter.
          * @param tick - The opened signal tick data
          */
         this.handleOpened = async (tick) => {
-            return await this._signalBacktestUtils.handleOpened(tick);
+            return await this.getInstance().handleOpened(tick);
         };
         /**
          * Handles signal closed event.
@@ -58405,7 +58499,7 @@ class StorageBacktestAdapter {
          * @param tick - The closed signal tick data
          */
         this.handleClosed = async (tick) => {
-            return await this._signalBacktestUtils.handleClosed(tick);
+            return await this.getInstance().handleClosed(tick);
         };
         /**
          * Handles signal scheduled event.
@@ -58413,7 +58507,7 @@ class StorageBacktestAdapter {
          * @param tick - The scheduled signal tick data
          */
         this.handleScheduled = async (tick) => {
-            return await this._signalBacktestUtils.handleScheduled(tick);
+            return await this.getInstance().handleScheduled(tick);
         };
         /**
          * Handles signal cancelled event.
@@ -58421,7 +58515,7 @@ class StorageBacktestAdapter {
          * @param tick - The cancelled signal tick data
          */
         this.handleCancelled = async (tick) => {
-            return await this._signalBacktestUtils.handleCancelled(tick);
+            return await this.getInstance().handleCancelled(tick);
         };
         /**
          * Finds a signal by its ID.
@@ -58430,7 +58524,7 @@ class StorageBacktestAdapter {
          * @returns The signal row or null if not found
          */
         this.findById = async (id) => {
-            return await this._signalBacktestUtils.findById(id);
+            return await this.getInstance().findById(id);
         };
         /**
          * Lists all stored signals.
@@ -58438,13 +58532,13 @@ class StorageBacktestAdapter {
          * @returns Array of all signal rows
          */
         this.list = async () => {
-            return await this._signalBacktestUtils.list();
+            return await this.getInstance().list();
         };
         this.handleActivePing = async (event) => {
-            return await this._signalBacktestUtils.handleActivePing(event);
+            return await this.getInstance().handleActivePing(event);
         };
         this.handleSchedulePing = async (event) => {
-            return await this._signalBacktestUtils.handleSchedulePing(event);
+            return await this.getInstance().handleSchedulePing(event);
         };
         /**
          * Sets the storage adapter constructor.
@@ -58454,7 +58548,8 @@ class StorageBacktestAdapter {
          */
         this.useStorageAdapter = (Ctor) => {
             backtest.loggerService.info(STORAGE_BACKTEST_ADAPTER_METHOD_NAME_USE_ADAPTER);
-            this._signalBacktestUtils = Reflect.construct(Ctor, []);
+            this._signalBacktestFactory = () => Reflect.construct(Ctor, []);
+            this.getInstance.clear();
         };
         /**
          * Switches to dummy storage adapter.
@@ -58462,7 +58557,8 @@ class StorageBacktestAdapter {
          */
         this.useDummy = () => {
             backtest.loggerService.info(STORAGE_BACKTEST_ADAPTER_METHOD_NAME_USE_DUMMY);
-            this._signalBacktestUtils = new StorageDummyBacktestUtils();
+            this._signalBacktestFactory = () => new StorageDummyBacktestUtils();
+            this.getInstance.clear();
         };
         /**
          * Switches to persistent storage adapter (default).
@@ -58470,7 +58566,8 @@ class StorageBacktestAdapter {
          */
         this.usePersist = () => {
             backtest.loggerService.info(STORAGE_BACKTEST_ADAPTER_METHOD_NAME_USE_PERSIST);
-            this._signalBacktestUtils = new StoragePersistBacktestUtils();
+            this._signalBacktestFactory = () => new StoragePersistBacktestUtils();
+            this.getInstance.clear();
         };
         /**
          * Switches to in-memory storage adapter.
@@ -58478,16 +58575,17 @@ class StorageBacktestAdapter {
          */
         this.useMemory = () => {
             backtest.loggerService.info(STORAGE_BACKTEST_ADAPTER_METHOD_NAME_USE_MEMORY);
-            this._signalBacktestUtils = new StorageMemoryBacktestUtils();
+            this._signalBacktestFactory = () => new StorageMemoryBacktestUtils();
+            this.getInstance.clear();
         };
         /**
-         * Clears the cached utils instance by resetting to the default in-memory adapter.
+         * Clears the memoized utils instance.
          * Call this when process.cwd() changes between strategy iterations
          * so a new instance is created with the updated base path.
          */
         this.clear = () => {
             backtest.loggerService.info(STORAGE_BACKTEST_ADAPTER_METHOD_NAME_CLEAR);
-            this._signalBacktestUtils = new StorageMemoryBacktestUtils();
+            this.getInstance.clear();
         };
     }
 }
@@ -58502,15 +58600,23 @@ class StorageBacktestAdapter {
  */
 class StorageLiveAdapter {
     constructor() {
-        /** Internal storage utils instance */
-        this._signalLiveUtils = new StoragePersistLiveUtils();
+        /** Factory producing the active storage utils instance */
+        this._signalLiveFactory = () => new StoragePersistLiveUtils();
+        /**
+         * Lazily constructs the storage utils from the registered factory and memoizes
+         * the result via `singleshot`.
+         *
+         * The instance is built on the first call and cached for all subsequent calls.
+         * Reset via `clear()` so the next call rebuilds from the current factory.
+         */
+        this.getInstance = functoolsKit.singleshot(() => this._signalLiveFactory());
         /**
          * Handles signal opened event.
          * Proxies call to the underlying storage adapter.
          * @param tick - The opened signal tick data
          */
         this.handleOpened = async (tick) => {
-            return await this._signalLiveUtils.handleOpened(tick);
+            return await this.getInstance().handleOpened(tick);
         };
         /**
          * Handles signal closed event.
@@ -58518,7 +58624,7 @@ class StorageLiveAdapter {
          * @param tick - The closed signal tick data
          */
         this.handleClosed = async (tick) => {
-            return await this._signalLiveUtils.handleClosed(tick);
+            return await this.getInstance().handleClosed(tick);
         };
         /**
          * Handles signal scheduled event.
@@ -58526,7 +58632,7 @@ class StorageLiveAdapter {
          * @param tick - The scheduled signal tick data
          */
         this.handleScheduled = async (tick) => {
-            return await this._signalLiveUtils.handleScheduled(tick);
+            return await this.getInstance().handleScheduled(tick);
         };
         /**
          * Handles signal cancelled event.
@@ -58534,7 +58640,7 @@ class StorageLiveAdapter {
          * @param tick - The cancelled signal tick data
          */
         this.handleCancelled = async (tick) => {
-            return await this._signalLiveUtils.handleCancelled(tick);
+            return await this.getInstance().handleCancelled(tick);
         };
         /**
          * Finds a signal by its ID.
@@ -58543,7 +58649,7 @@ class StorageLiveAdapter {
          * @returns The signal row or null if not found
          */
         this.findById = async (id) => {
-            return await this._signalLiveUtils.findById(id);
+            return await this.getInstance().findById(id);
         };
         /**
          * Lists all stored signals.
@@ -58551,13 +58657,13 @@ class StorageLiveAdapter {
          * @returns Array of all signal rows
          */
         this.list = async () => {
-            return await this._signalLiveUtils.list();
+            return await this.getInstance().list();
         };
         this.handleActivePing = async (event) => {
-            return await this._signalLiveUtils.handleActivePing(event);
+            return await this.getInstance().handleActivePing(event);
         };
         this.handleSchedulePing = async (event) => {
-            return await this._signalLiveUtils.handleSchedulePing(event);
+            return await this.getInstance().handleSchedulePing(event);
         };
         /**
          * Sets the storage adapter constructor.
@@ -58567,7 +58673,8 @@ class StorageLiveAdapter {
          */
         this.useStorageAdapter = (Ctor) => {
             backtest.loggerService.info(STORAGE_LIVE_ADAPTER_METHOD_NAME_USE_ADAPTER);
-            this._signalLiveUtils = Reflect.construct(Ctor, []);
+            this._signalLiveFactory = () => Reflect.construct(Ctor, []);
+            this.getInstance.clear();
         };
         /**
          * Switches to dummy storage adapter.
@@ -58575,7 +58682,8 @@ class StorageLiveAdapter {
          */
         this.useDummy = () => {
             backtest.loggerService.info(STORAGE_LIVE_ADAPTER_METHOD_NAME_USE_DUMMY);
-            this._signalLiveUtils = new StorageDummyLiveUtils();
+            this._signalLiveFactory = () => new StorageDummyLiveUtils();
+            this.getInstance.clear();
         };
         /**
          * Switches to persistent storage adapter (default).
@@ -58583,7 +58691,8 @@ class StorageLiveAdapter {
          */
         this.usePersist = () => {
             backtest.loggerService.info(STORAGE_LIVE_ADAPTER_METHOD_NAME_USE_PERSIST);
-            this._signalLiveUtils = new StoragePersistLiveUtils();
+            this._signalLiveFactory = () => new StoragePersistLiveUtils();
+            this.getInstance.clear();
         };
         /**
          * Switches to in-memory storage adapter.
@@ -58591,16 +58700,17 @@ class StorageLiveAdapter {
          */
         this.useMemory = () => {
             backtest.loggerService.info(STORAGE_LIVE_ADAPTER_METHOD_NAME_USE_MEMORY);
-            this._signalLiveUtils = new StorageMemoryLiveUtils();
+            this._signalLiveFactory = () => new StorageMemoryLiveUtils();
+            this.getInstance.clear();
         };
         /**
-         * Clears the cached utils instance by resetting to the default persistent adapter.
+         * Clears the memoized utils instance.
          * Call this when process.cwd() changes between strategy iterations
          * so a new instance is created with the updated base path.
          */
         this.clear = () => {
             backtest.loggerService.info(STORAGE_LIVE_ADAPTER_METHOD_NAME_CLEAR);
-            this._signalLiveUtils = new StoragePersistLiveUtils();
+            this.getInstance.clear();
         };
     }
 }
@@ -60716,18 +60826,26 @@ class NotificationPersistLiveUtils {
  */
 class NotificationBacktestAdapter {
     constructor() {
-        /** Internal notification utils instance */
-        this._notificationBacktestUtils = new NotificationMemoryBacktestUtils();
+        /** Factory producing the active notification utils instance */
+        this._notificationBacktestFactory = () => new NotificationMemoryBacktestUtils();
+        /**
+         * Lazily constructs the notification utils from the registered factory and
+         * memoizes the result via `singleshot`.
+         *
+         * The instance is built on the first call and cached for all subsequent calls.
+         * Reset via `clear()` so the next call rebuilds from the current factory.
+         */
+        this.getInstance = functoolsKit.singleshot(() => this._notificationBacktestFactory());
         /**
          * Handles signal events.
          * Proxies call to the underlying notification adapter.
          * @param data - The strategy tick result data
          */
         this.handleSignal = async (data) => {
-            return await this._notificationBacktestUtils.handleSignal(data);
+            return await this.getInstance().handleSignal(data);
         };
         this.handleSignalNotify = async (data) => {
-            return await this._notificationBacktestUtils.handleSignalNotify(data);
+            return await this.getInstance().handleSignalNotify(data);
         };
         /**
          * Handles partial profit availability event.
@@ -60735,7 +60853,7 @@ class NotificationBacktestAdapter {
          * @param data - The partial profit contract data
          */
         this.handlePartialProfit = async (data) => {
-            return await this._notificationBacktestUtils.handlePartialProfit(data);
+            return await this.getInstance().handlePartialProfit(data);
         };
         /**
          * Handles partial loss availability event.
@@ -60743,7 +60861,7 @@ class NotificationBacktestAdapter {
          * @param data - The partial loss contract data
          */
         this.handlePartialLoss = async (data) => {
-            return await this._notificationBacktestUtils.handlePartialLoss(data);
+            return await this.getInstance().handlePartialLoss(data);
         };
         /**
          * Handles breakeven availability event.
@@ -60751,7 +60869,7 @@ class NotificationBacktestAdapter {
          * @param data - The breakeven contract data
          */
         this.handleBreakeven = async (data) => {
-            return await this._notificationBacktestUtils.handleBreakeven(data);
+            return await this.getInstance().handleBreakeven(data);
         };
         /**
          * Handles strategy commit events.
@@ -60759,7 +60877,7 @@ class NotificationBacktestAdapter {
          * @param data - The strategy commit contract data
          */
         this.handleStrategyCommit = async (data) => {
-            return await this._notificationBacktestUtils.handleStrategyCommit(data);
+            return await this.getInstance().handleStrategyCommit(data);
         };
         /**
          * Handles signal sync events (signal-open, signal-close).
@@ -60767,7 +60885,7 @@ class NotificationBacktestAdapter {
          * @param data - The signal sync contract data
          */
         this.handleSync = functoolsKit.trycatch(async (data) => {
-            return await this._notificationBacktestUtils.handleSync(data);
+            return await this.getInstance().handleSync(data);
         }, {
             defaultValue: null,
         });
@@ -60777,7 +60895,7 @@ class NotificationBacktestAdapter {
          * @param data - The risk contract data
          */
         this.handleRisk = async (data) => {
-            return await this._notificationBacktestUtils.handleRisk(data);
+            return await this.getInstance().handleRisk(data);
         };
         /**
          * Handles error event.
@@ -60785,7 +60903,7 @@ class NotificationBacktestAdapter {
          * @param error - The error object
          */
         this.handleError = async (error) => {
-            return await this._notificationBacktestUtils.handleError(error);
+            return await this.getInstance().handleError(error);
         };
         /**
          * Handles critical error event.
@@ -60793,7 +60911,7 @@ class NotificationBacktestAdapter {
          * @param error - The error object
          */
         this.handleCriticalError = async (error) => {
-            return await this._notificationBacktestUtils.handleCriticalError(error);
+            return await this.getInstance().handleCriticalError(error);
         };
         /**
          * Handles validation error event.
@@ -60801,7 +60919,7 @@ class NotificationBacktestAdapter {
          * @param error - The error object
          */
         this.handleValidationError = async (error) => {
-            return await this._notificationBacktestUtils.handleValidationError(error);
+            return await this.getInstance().handleValidationError(error);
         };
         /**
          * Gets all stored notifications.
@@ -60809,14 +60927,14 @@ class NotificationBacktestAdapter {
          * @returns Array of all notification models
          */
         this.getData = async () => {
-            return await this._notificationBacktestUtils.getData();
+            return await this.getInstance().getData();
         };
         /**
          * Clears all stored notifications.
          * Proxies call to the underlying notification adapter.
          */
         this.dispose = async () => {
-            return await this._notificationBacktestUtils.dispose();
+            return await this.getInstance().dispose();
         };
         /**
          * Sets the notification adapter constructor.
@@ -60826,7 +60944,8 @@ class NotificationBacktestAdapter {
          */
         this.useNotificationAdapter = (Ctor) => {
             backtest.loggerService.info(NOTIFICATION_BACKTEST_ADAPTER_METHOD_NAME_USE_ADAPTER);
-            this._notificationBacktestUtils = Reflect.construct(Ctor, []);
+            this._notificationBacktestFactory = () => Reflect.construct(Ctor, []);
+            this.getInstance.clear();
         };
         /**
          * Switches to dummy notification adapter.
@@ -60834,7 +60953,8 @@ class NotificationBacktestAdapter {
          */
         this.useDummy = () => {
             backtest.loggerService.info(NOTIFICATION_BACKTEST_ADAPTER_METHOD_NAME_USE_DUMMY);
-            this._notificationBacktestUtils = new NotificationDummyBacktestUtils();
+            this._notificationBacktestFactory = () => new NotificationDummyBacktestUtils();
+            this.getInstance.clear();
         };
         /**
          * Switches to in-memory notification adapter (default).
@@ -60842,7 +60962,8 @@ class NotificationBacktestAdapter {
          */
         this.useMemory = () => {
             backtest.loggerService.info(NOTIFICATION_BACKTEST_ADAPTER_METHOD_NAME_USE_MEMORY);
-            this._notificationBacktestUtils = new NotificationMemoryBacktestUtils();
+            this._notificationBacktestFactory = () => new NotificationMemoryBacktestUtils();
+            this.getInstance.clear();
         };
         /**
          * Switches to persistent notification adapter.
@@ -60850,16 +60971,17 @@ class NotificationBacktestAdapter {
          */
         this.usePersist = () => {
             backtest.loggerService.info(NOTIFICATION_BACKTEST_ADAPTER_METHOD_NAME_USE_PERSIST);
-            this._notificationBacktestUtils = new NotificationPersistBacktestUtils();
+            this._notificationBacktestFactory = () => new NotificationPersistBacktestUtils();
+            this.getInstance.clear();
         };
         /**
-         * Resets the cached utils instance to the default in-memory adapter.
+         * Clears the memoized utils instance.
          * Call this when process.cwd() changes between strategy iterations
          * so a new instance is created with the updated base path.
          */
         this.clear = () => {
             backtest.loggerService.info(NOTIFICATION_BACKTEST_ADAPTER_METHOD_NAME_CLEAR);
-            this._notificationBacktestUtils = new NotificationMemoryBacktestUtils();
+            this.getInstance.clear();
         };
     }
 }
@@ -60874,18 +60996,26 @@ class NotificationBacktestAdapter {
  */
 class NotificationLiveAdapter {
     constructor() {
-        /** Internal notification utils instance */
-        this._notificationLiveUtils = new NotificationMemoryLiveUtils();
+        /** Factory producing the active notification utils instance */
+        this._notificationLiveFactory = () => new NotificationMemoryLiveUtils();
+        /**
+         * Lazily constructs the notification utils from the registered factory and
+         * memoizes the result via `singleshot`.
+         *
+         * The instance is built on the first call and cached for all subsequent calls.
+         * Reset via `clear()` so the next call rebuilds from the current factory.
+         */
+        this.getInstance = functoolsKit.singleshot(() => this._notificationLiveFactory());
         /**
          * Handles signal events.
          * Proxies call to the underlying notification adapter.
          * @param data - The strategy tick result data
          */
         this.handleSignal = async (data) => {
-            return await this._notificationLiveUtils.handleSignal(data);
+            return await this.getInstance().handleSignal(data);
         };
         this.handleSignalNotify = async (data) => {
-            return await this._notificationLiveUtils.handleSignalNotify(data);
+            return await this.getInstance().handleSignalNotify(data);
         };
         /**
          * Handles partial profit availability event.
@@ -60893,7 +61023,7 @@ class NotificationLiveAdapter {
          * @param data - The partial profit contract data
          */
         this.handlePartialProfit = async (data) => {
-            return await this._notificationLiveUtils.handlePartialProfit(data);
+            return await this.getInstance().handlePartialProfit(data);
         };
         /**
          * Handles partial loss availability event.
@@ -60901,7 +61031,7 @@ class NotificationLiveAdapter {
          * @param data - The partial loss contract data
          */
         this.handlePartialLoss = async (data) => {
-            return await this._notificationLiveUtils.handlePartialLoss(data);
+            return await this.getInstance().handlePartialLoss(data);
         };
         /**
          * Handles breakeven availability event.
@@ -60909,7 +61039,7 @@ class NotificationLiveAdapter {
          * @param data - The breakeven contract data
          */
         this.handleBreakeven = async (data) => {
-            return await this._notificationLiveUtils.handleBreakeven(data);
+            return await this.getInstance().handleBreakeven(data);
         };
         /**
          * Handles strategy commit events.
@@ -60917,7 +61047,7 @@ class NotificationLiveAdapter {
          * @param data - The strategy commit contract data
          */
         this.handleStrategyCommit = async (data) => {
-            return await this._notificationLiveUtils.handleStrategyCommit(data);
+            return await this.getInstance().handleStrategyCommit(data);
         };
         /**
          * Handles signal sync events (signal-open, signal-close).
@@ -60925,7 +61055,7 @@ class NotificationLiveAdapter {
          * @param data - The signal sync contract data
          */
         this.handleSync = functoolsKit.trycatch(async (data) => {
-            return await this._notificationLiveUtils.handleSync(data);
+            return await this.getInstance().handleSync(data);
         }, {
             defaultValue: null,
         });
@@ -60935,7 +61065,7 @@ class NotificationLiveAdapter {
          * @param data - The risk contract data
          */
         this.handleRisk = async (data) => {
-            return await this._notificationLiveUtils.handleRisk(data);
+            return await this.getInstance().handleRisk(data);
         };
         /**
          * Handles error event.
@@ -60943,7 +61073,7 @@ class NotificationLiveAdapter {
          * @param error - The error object
          */
         this.handleError = async (error) => {
-            return await this._notificationLiveUtils.handleError(error);
+            return await this.getInstance().handleError(error);
         };
         /**
          * Handles critical error event.
@@ -60951,7 +61081,7 @@ class NotificationLiveAdapter {
          * @param error - The error object
          */
         this.handleCriticalError = async (error) => {
-            return await this._notificationLiveUtils.handleCriticalError(error);
+            return await this.getInstance().handleCriticalError(error);
         };
         /**
          * Handles validation error event.
@@ -60959,7 +61089,7 @@ class NotificationLiveAdapter {
          * @param error - The error object
          */
         this.handleValidationError = async (error) => {
-            return await this._notificationLiveUtils.handleValidationError(error);
+            return await this.getInstance().handleValidationError(error);
         };
         /**
          * Gets all stored notifications.
@@ -60967,14 +61097,14 @@ class NotificationLiveAdapter {
          * @returns Array of all notification models
          */
         this.getData = async () => {
-            return await this._notificationLiveUtils.getData();
+            return await this.getInstance().getData();
         };
         /**
          * Clears all stored notifications.
          * Proxies call to the underlying notification adapter.
          */
         this.dispose = async () => {
-            return await this._notificationLiveUtils.dispose();
+            return await this.getInstance().dispose();
         };
         /**
          * Sets the notification adapter constructor.
@@ -60984,7 +61114,8 @@ class NotificationLiveAdapter {
          */
         this.useNotificationAdapter = (Ctor) => {
             backtest.loggerService.info(NOTIFICATION_LIVE_ADAPTER_METHOD_NAME_USE_ADAPTER);
-            this._notificationLiveUtils = Reflect.construct(Ctor, []);
+            this._notificationLiveFactory = () => Reflect.construct(Ctor, []);
+            this.getInstance.clear();
         };
         /**
          * Switches to dummy notification adapter.
@@ -60992,7 +61123,8 @@ class NotificationLiveAdapter {
          */
         this.useDummy = () => {
             backtest.loggerService.info(NOTIFICATION_LIVE_ADAPTER_METHOD_NAME_USE_DUMMY);
-            this._notificationLiveUtils = new NotificationDummyLiveUtils();
+            this._notificationLiveFactory = () => new NotificationDummyLiveUtils();
+            this.getInstance.clear();
         };
         /**
          * Switches to in-memory notification adapter (default).
@@ -61000,7 +61132,8 @@ class NotificationLiveAdapter {
          */
         this.useMemory = () => {
             backtest.loggerService.info(NOTIFICATION_LIVE_ADAPTER_METHOD_NAME_USE_MEMORY);
-            this._notificationLiveUtils = new NotificationMemoryLiveUtils();
+            this._notificationLiveFactory = () => new NotificationMemoryLiveUtils();
+            this.getInstance.clear();
         };
         /**
          * Switches to persistent notification adapter.
@@ -61008,16 +61141,17 @@ class NotificationLiveAdapter {
          */
         this.usePersist = () => {
             backtest.loggerService.info(NOTIFICATION_LIVE_ADAPTER_METHOD_NAME_USE_PERSIST);
-            this._notificationLiveUtils = new NotificationPersistLiveUtils();
+            this._notificationLiveFactory = () => new NotificationPersistLiveUtils();
+            this.getInstance.clear();
         };
         /**
-         * Resets the cached utils instance to the default in-memory adapter.
+         * Clears the memoized utils instance.
          * Call this when process.cwd() changes between strategy iterations
          * so a new instance is created with the updated base path.
          */
         this.clear = () => {
             backtest.loggerService.info(NOTIFICATION_LIVE_ADAPTER_METHOD_NAME_CLEAR);
-            this._notificationLiveUtils = new NotificationMemoryLiveUtils();
+            this.getInstance.clear();
         };
     }
 }