backtest-kit 9.7.0 → 9.8.1

package/build/index.mjs

@@ -3,7 +3,7 @@ import { scoped } from 'di-scoped';
 import { singleton } from 'di-singleton';
 import { Subject, makeExtendable, singleshot, getErrorMessage, memoize, not, errorData, trycatch, retry, queued, sleep, randomString, str, isObject, ToolRegistry, typo, and, Source, resolveDocuments, timeout, TIMEOUT_SYMBOL as TIMEOUT_SYMBOL$1, compose, BehaviorSubject, waitForNext, singlerun } from 'functools-kit';
 import * as fs from 'fs/promises';
-import fs__default, { stat, opendir, readFile } from 'fs/promises';
+import fs__default from 'fs/promises';
 import path, { join, dirname } from 'path';
 import crypto from 'crypto';
 import os from 'os';
@@ -36107,72 +36107,41 @@ const PRINT_PROGRESS_FN = (fetched, total, symbol, interval) => {
     }
 };
 /**
- * Checks cached candle timestamps for correct interval alignment.
- * Reads JSON files directly from persist storage without using abstractions.
+ * Checks cached candle presence via the persist adapter.
+ * Issues one ranged read; adapter-side `hasValue` covers each expected timestamp,
+ * so a single missing or unaligned candle yields a miss without loading the whole dataset.
  *
  * @param params - Validation parameters
  */
 async function checkCandles(params) {
-    const { symbol, exchangeName, interval, from, to, baseDir = "./dump/data/candle" } = params;
+    const { symbol, exchangeName, interval, from, to } = params;
     backtest.loggerService.info(CHECK_CANDLES_METHOD_NAME, params);
     const step = INTERVAL_MINUTES$3[interval];
     if (!step) {
         throw new Error(`checkCandles: unsupported interval=${interval}`);
     }
     const stepMs = step * MS_PER_MINUTE$3;
-    const dir = join(baseDir, exchangeName, symbol, interval);
     const fromTs = ALIGN_TO_INTERVAL_FN(from.getTime(), step);
     const toTs = ALIGN_TO_INTERVAL_FN(to.getTime(), step);
-    try {
-        await stat(dir);
-    }
-    catch {
-        throw new Error(`checkCandles: cache directory not found: ${dir}`);
-    }
-    // Collect only filenames (strings) in range via async iterator — no full readdir in memory
-    const files = [];
-    for await (const entry of await opendir(dir)) {
-        if (!entry.isFile() || !entry.name.endsWith(".json")) {
-            continue;
-        }
-        const ts = Number(entry.name.replace(".json", ""));
-        if (ts >= fromTs && ts < toTs) {
-            files.push(entry.name);
-        }
-    }
-    if (files.length === 0) {
-        throw new Error(`checkCandles: no cached candles in range [${fromTs}, ${toTs}) in ${dir}`);
+    const totalCandles = Math.floor((toTs - fromTs) / stepMs);
+    if (totalCandles <= 0) {
+        throw new Error(`checkCandles: empty range [${fromTs}, ${toTs}) for ${symbol} ${interval}`);
     }
-    files.sort();
-    let prevTimestamp = null;
-    let prevName = null;
-    PRINT_PROGRESS_FN(0, files.length, symbol, interval);
-    for (let i = 0; i < files.length; i++) {
-        const filePath = join(dir, files[i]);
-        const raw = await readFile(filePath, "utf-8");
-        let candle;
-        try {
-            candle = JSON.parse(raw);
-        }
-        catch {
-            throw new Error(`checkCandles: ${files[i]} contains invalid JSON`);
-        }
-        const { timestamp } = candle;
-        const aligned = ALIGN_TO_INTERVAL_FN(timestamp, step);
-        if (timestamp !== aligned) {
-            throw new Error(`checkCandles: ${files[i]} timestamp not aligned to ${interval} boundary (actual=${timestamp}, expected=${aligned})`);
-        }
-        if (prevTimestamp !== null) {
-            const gap = timestamp - prevTimestamp;
-            if (gap !== stepMs) {
-                throw new Error(`checkCandles: gap between ${prevName} and ${files[i]} (actual=${gap}ms, expected=${stepMs}ms)`);
-            }
+    let checked = 0;
+    let currentSince = fromTs;
+    PRINT_PROGRESS_FN(checked, totalCandles, symbol, interval);
+    while (checked < totalCandles) {
+        const chunkLimit = Math.min(totalCandles - checked, GLOBAL_CONFIG.CC_MAX_CANDLES_PER_REQUEST);
+        const chunkUntil = currentSince + chunkLimit * stepMs;
+        const candles = await PersistCandleAdapter.readCandlesData(symbol, interval, exchangeName, chunkLimit, currentSince, chunkUntil);
+        if (!candles) {
+            throw new Error(`checkCandles: cache miss for ${symbol} ${interval} [${currentSince}, ${chunkUntil})`);
         }
-        prevTimestamp = timestamp;
-        prevName = files[i];
-        PRINT_PROGRESS_FN(i + 1, files.length, symbol, interval);
+        checked += chunkLimit;
+        currentSince = chunkUntil;
+        PRINT_PROGRESS_FN(checked, totalCandles, symbol, interval);
     }
-    console.log(`checkCandles: OK ${files.length} candles ${symbol} ${interval}`);
+    console.log(`checkCandles: OK ${totalCandles} candles ${symbol} ${interval}`);
 }
 /**
  * Pre-caches candles for a date range into persist storage.
@@ -37423,7 +37392,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 = singleshot(() => this._brokerFactory());
         /**
          * Forwards a signal-open event to the registered broker adapter.
          *
@@ -37457,7 +37438,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.
@@ -37495,7 +37479,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.
@@ -37531,7 +37518,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.
@@ -37567,7 +37557,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.
@@ -37603,7 +37596,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.
@@ -37639,7 +37635,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.
@@ -37676,7 +37675,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.
@@ -37712,7 +37714,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.
@@ -37736,11 +37741,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.
@@ -37767,7 +37773,8 @@ class BrokerAdapter {
          */
         this.enable = 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.");
             }
@@ -37855,7 +37862,7 @@ class BrokerAdapter {
          */
         this.clear = () => {
             backtest.loggerService.info(BROKER_METHOD_NAME_CLEAR, {});
-            this._brokerInstance = null;
+            this.getInstance.clear();
             this.enable.clear();
         };
     }
@@ -48875,8 +48882,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 = singleshot(() => this._recentBacktestFactory());
         /**
          * Handles active ping event.
          * Proxies call to the underlying storage adapter.
@@ -48886,7 +48901,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.
@@ -48907,7 +48922,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.
@@ -48931,7 +48946,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;
             }
@@ -48944,7 +48959,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.
@@ -48952,7 +48968,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).
@@ -48960,14 +48977,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();
         };
     }
 }
@@ -48982,8 +49002,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 = singleshot(() => this._recentLiveFactory());
         /**
          * Handles active ping event.
          * Proxies call to the underlying storage adapter.
@@ -48993,7 +49021,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.
@@ -49014,7 +49042,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.
@@ -49038,7 +49066,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;
             }
@@ -49051,7 +49079,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).
@@ -49059,7 +49088,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.
@@ -49067,14 +49097,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();
         };
     }
 }
@@ -54399,16 +54432,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 = 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 [];
         };
@@ -54419,8 +54462,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);
             }
         };
         /**
@@ -54430,8 +54474,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);
             }
         };
         /**
@@ -54441,8 +54486,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);
             }
         };
         /**
@@ -54452,8 +54498,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);
             }
         };
         /**
@@ -54463,7 +54510,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.
@@ -54471,7 +54519,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).
@@ -54479,7 +54528,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.
@@ -54487,7 +54537,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.
@@ -54497,18 +54548,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 = 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 || 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();
         };
     }
 }
@@ -58400,15 +58455,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 = 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.
@@ -58416,7 +58479,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.
@@ -58424,7 +58487,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.
@@ -58432,7 +58495,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.
@@ -58441,7 +58504,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.
@@ -58449,13 +58512,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.
@@ -58465,7 +58528,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.
@@ -58473,7 +58537,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).
@@ -58481,7 +58546,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.
@@ -58489,16 +58555,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();
         };
     }
 }
@@ -58513,15 +58580,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 = 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.
@@ -58529,7 +58604,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.
@@ -58537,7 +58612,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.
@@ -58545,7 +58620,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.
@@ -58554,7 +58629,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.
@@ -58562,13 +58637,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.
@@ -58578,7 +58653,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.
@@ -58586,7 +58662,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).
@@ -58594,7 +58671,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.
@@ -58602,16 +58680,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();
         };
     }
 }
@@ -60727,18 +60806,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 = 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.
@@ -60746,7 +60833,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.
@@ -60754,7 +60841,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.
@@ -60762,7 +60849,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.
@@ -60770,7 +60857,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).
@@ -60778,7 +60865,7 @@ class NotificationBacktestAdapter {
          * @param data - The signal sync contract data
          */
         this.handleSync = trycatch(async (data) => {
-            return await this._notificationBacktestUtils.handleSync(data);
+            return await this.getInstance().handleSync(data);
         }, {
             defaultValue: null,
         });
@@ -60788,7 +60875,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.
@@ -60796,7 +60883,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.
@@ -60804,7 +60891,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.
@@ -60812,7 +60899,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.
@@ -60820,14 +60907,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.
@@ -60837,7 +60924,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.
@@ -60845,7 +60933,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).
@@ -60853,7 +60942,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.
@@ -60861,16 +60951,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();
         };
     }
 }
@@ -60885,18 +60976,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 = 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.
@@ -60904,7 +61003,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.
@@ -60912,7 +61011,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.
@@ -60920,7 +61019,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.
@@ -60928,7 +61027,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).
@@ -60936,7 +61035,7 @@ class NotificationLiveAdapter {
          * @param data - The signal sync contract data
          */
         this.handleSync = trycatch(async (data) => {
-            return await this._notificationLiveUtils.handleSync(data);
+            return await this.getInstance().handleSync(data);
         }, {
             defaultValue: null,
         });
@@ -60946,7 +61045,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.
@@ -60954,7 +61053,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.
@@ -60962,7 +61061,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.
@@ -60970,7 +61069,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.
@@ -60978,14 +61077,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.
@@ -60995,7 +61094,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.
@@ -61003,7 +61103,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).
@@ -61011,7 +61112,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.
@@ -61019,16 +61121,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();
         };
     }
 }