backtest-kit 6.1.1 → 6.3.0

package/build/index.cjs

@@ -908,26 +908,31 @@ const PERSIST_SIGNAL_UTILS_METHOD_NAME_READ_DATA = "PersistSignalUtils.readSigna
 const PERSIST_SIGNAL_UTILS_METHOD_NAME_WRITE_DATA = "PersistSignalUtils.writeSignalData";
 const PERSIST_SIGNAL_UTILS_METHOD_NAME_USE_JSON = "PersistSignalUtils.useJson";
 const PERSIST_SIGNAL_UTILS_METHOD_NAME_USE_DUMMY = "PersistSignalUtils.useDummy";
+const PERSIST_SIGNAL_UTILS_METHOD_NAME_CLEAR = "PersistSignalUtils.clear";
 const PERSIST_SCHEDULE_UTILS_METHOD_NAME_USE_PERSIST_SCHEDULE_ADAPTER = "PersistScheduleUtils.usePersistScheduleAdapter";
 const PERSIST_SCHEDULE_UTILS_METHOD_NAME_READ_DATA = "PersistScheduleUtils.readScheduleData";
 const PERSIST_SCHEDULE_UTILS_METHOD_NAME_WRITE_DATA = "PersistScheduleUtils.writeScheduleData";
 const PERSIST_SCHEDULE_UTILS_METHOD_NAME_USE_JSON = "PersistScheduleUtils.useJson";
 const PERSIST_SCHEDULE_UTILS_METHOD_NAME_USE_DUMMY = "PersistScheduleUtils.useDummy";
+const PERSIST_SCHEDULE_UTILS_METHOD_NAME_CLEAR = "PersistScheduleUtils.clear";
 const PERSIST_PARTIAL_UTILS_METHOD_NAME_USE_PERSIST_PARTIAL_ADAPTER = "PersistPartialUtils.usePersistPartialAdapter";
 const PERSIST_PARTIAL_UTILS_METHOD_NAME_READ_DATA = "PersistPartialUtils.readPartialData";
 const PERSIST_PARTIAL_UTILS_METHOD_NAME_WRITE_DATA = "PersistPartialUtils.writePartialData";
 const PERSIST_PARTIAL_UTILS_METHOD_NAME_USE_JSON = "PersistPartialUtils.useJson";
 const PERSIST_PARTIAL_UTILS_METHOD_NAME_USE_DUMMY = "PersistPartialUtils.useDummy";
+const PERSIST_PARTIAL_UTILS_METHOD_NAME_CLEAR = "PersistPartialUtils.clear";
 const PERSIST_BREAKEVEN_UTILS_METHOD_NAME_USE_PERSIST_BREAKEVEN_ADAPTER = "PersistBreakevenUtils.usePersistBreakevenAdapter";
 const PERSIST_BREAKEVEN_UTILS_METHOD_NAME_READ_DATA = "PersistBreakevenUtils.readBreakevenData";
 const PERSIST_BREAKEVEN_UTILS_METHOD_NAME_WRITE_DATA = "PersistBreakevenUtils.writeBreakevenData";
 const PERSIST_BREAKEVEN_UTILS_METHOD_NAME_USE_JSON = "PersistBreakevenUtils.useJson";
 const PERSIST_BREAKEVEN_UTILS_METHOD_NAME_USE_DUMMY = "PersistBreakevenUtils.useDummy";
+const PERSIST_BREAKEVEN_UTILS_METHOD_NAME_CLEAR = "PersistBreakevenUtils.clear";
 const PERSIST_RISK_UTILS_METHOD_NAME_USE_PERSIST_RISK_ADAPTER = "PersistRiskUtils.usePersistRiskAdapter";
 const PERSIST_RISK_UTILS_METHOD_NAME_READ_DATA = "PersistRiskUtils.readPositionData";
 const PERSIST_RISK_UTILS_METHOD_NAME_WRITE_DATA = "PersistRiskUtils.writePositionData";
 const PERSIST_RISK_UTILS_METHOD_NAME_USE_JSON = "PersistRiskUtils.useJson";
 const PERSIST_RISK_UTILS_METHOD_NAME_USE_DUMMY = "PersistRiskUtils.useDummy";
+const PERSIST_RISK_UTILS_METHOD_NAME_CLEAR = "PersistRiskUtils.clear";
 const PERSIST_BASE_METHOD_NAME_CTOR = "PersistBase.CTOR";
 const PERSIST_BASE_METHOD_NAME_WAIT_FOR_INIT = "PersistBase.waitForInit";
 const PERSIST_BASE_METHOD_NAME_READ_VALUE = "PersistBase.readValue";
@@ -938,22 +943,27 @@ const PERSIST_STORAGE_UTILS_METHOD_NAME_READ_DATA = "PersistStorageUtils.readSto
 const PERSIST_STORAGE_UTILS_METHOD_NAME_WRITE_DATA = "PersistStorageUtils.writeStorageData";
 const PERSIST_STORAGE_UTILS_METHOD_NAME_USE_JSON = "PersistStorageUtils.useJson";
 const PERSIST_STORAGE_UTILS_METHOD_NAME_USE_DUMMY = "PersistStorageUtils.useDummy";
+const PERSIST_STORAGE_UTILS_METHOD_NAME_CLEAR = "PersistStorageUtils.clear";
 const PERSIST_STORAGE_UTILS_METHOD_NAME_USE_PERSIST_STORAGE_ADAPTER = "PersistStorageUtils.usePersistStorageAdapter";
 const PERSIST_NOTIFICATION_UTILS_METHOD_NAME_READ_DATA = "PersistNotificationUtils.readNotificationData";
 const PERSIST_NOTIFICATION_UTILS_METHOD_NAME_WRITE_DATA = "PersistNotificationUtils.writeNotificationData";
 const PERSIST_NOTIFICATION_UTILS_METHOD_NAME_USE_JSON = "PersistNotificationUtils.useJson";
 const PERSIST_NOTIFICATION_UTILS_METHOD_NAME_USE_DUMMY = "PersistNotificationUtils.useDummy";
+const PERSIST_NOTIFICATION_UTILS_METHOD_NAME_CLEAR = "PersistNotificationUtils.clear";
 const PERSIST_NOTIFICATION_UTILS_METHOD_NAME_USE_PERSIST_NOTIFICATION_ADAPTER = "PersistNotificationUtils.usePersistNotificationAdapter";
 const PERSIST_LOG_UTILS_METHOD_NAME_READ_DATA = "PersistLogUtils.readLogData";
 const PERSIST_LOG_UTILS_METHOD_NAME_WRITE_DATA = "PersistLogUtils.writeLogData";
 const PERSIST_LOG_UTILS_METHOD_NAME_USE_JSON = "PersistLogUtils.useJson";
 const PERSIST_LOG_UTILS_METHOD_NAME_USE_DUMMY = "PersistLogUtils.useDummy";
 const PERSIST_LOG_UTILS_METHOD_NAME_USE_PERSIST_LOG_ADAPTER = "PersistLogUtils.usePersistLogAdapter";
+const PERSIST_LOG_UTILS_METHOD_NAME_CLEAR = "PersistLogUtils.clear";
 const PERSIST_MEASURE_UTILS_METHOD_NAME_READ_DATA = "PersistMeasureUtils.readMeasureData";
 const PERSIST_MEASURE_UTILS_METHOD_NAME_WRITE_DATA = "PersistMeasureUtils.writeMeasureData";
 const PERSIST_MEASURE_UTILS_METHOD_NAME_USE_JSON = "PersistMeasureUtils.useJson";
 const PERSIST_MEASURE_UTILS_METHOD_NAME_USE_DUMMY = "PersistMeasureUtils.useDummy";
+const PERSIST_MEASURE_UTILS_METHOD_NAME_CLEAR = "PersistMeasureUtils.clear";
 const PERSIST_MEASURE_UTILS_METHOD_NAME_USE_PERSIST_MEASURE_ADAPTER = "PersistMeasureUtils.usePersistMeasureAdapter";
+const PERSIST_CANDLE_UTILS_METHOD_NAME_CLEAR = "PersistCandleUtils.clear";
 const PERSIST_MEMORY_UTILS_METHOD_NAME_USE_PERSIST_MEMORY_ADAPTER = "PersistMemoryUtils.usePersistMemoryAdapter";
 const PERSIST_MEMORY_UTILS_METHOD_NAME_READ_DATA = "PersistMemoryUtils.readMemoryData";
 const PERSIST_MEMORY_UTILS_METHOD_NAME_WRITE_DATA = "PersistMemoryUtils.writeMemoryData";
@@ -961,6 +971,7 @@ const PERSIST_MEMORY_UTILS_METHOD_NAME_REMOVE_DATA = "PersistMemoryUtils.removeM
 const PERSIST_MEMORY_UTILS_METHOD_NAME_LIST_DATA = "PersistMemoryUtils.listMemoryData";
 const PERSIST_MEMORY_UTILS_METHOD_NAME_HAS_DATA = "PersistMemoryUtils.hasMemoryData";
 const PERSIST_MEMORY_UTILS_METHOD_NAME_CLEAR = "PersistMemoryUtils.clear";
+const PERSIST_MEMORY_UTILS_METHOD_NAME_DISPOSE = "PersistMemoryUtils.dispose";
 const BASE_WAIT_FOR_INIT_FN_METHOD_NAME = "PersistBase.waitForInitFn";
 const BASE_UNLINK_RETRY_COUNT = 5;
 const BASE_UNLINK_RETRY_DELAY = 1000;
@@ -1246,6 +1257,15 @@ class PersistSignalUtils {
         bt.loggerService.info(PERSIST_SIGNAL_UTILS_METHOD_NAME_USE_PERSIST_SIGNAL_ADAPTER);
         this.PersistSignalFactory = Ctor;
     }
+    /**
+     * Clears the memoized storage cache.
+     * Call this when process.cwd() changes between strategy iterations
+     * so new storage instances are created with the updated base path.
+     */
+    clear() {
+        bt.loggerService.log(PERSIST_SIGNAL_UTILS_METHOD_NAME_CLEAR);
+        this.getStorage.clear();
+    }
     /**
      * Switches to the default JSON persist adapter.
      * All future persistence writes will use JSON storage.
@@ -1359,6 +1379,15 @@ class PersistRiskUtils {
         bt.loggerService.info(PERSIST_RISK_UTILS_METHOD_NAME_USE_PERSIST_RISK_ADAPTER);
         this.PersistRiskFactory = Ctor;
     }
+    /**
+     * Clears the memoized storage cache.
+     * Call this when process.cwd() changes between strategy iterations
+     * so new storage instances are created with the updated base path.
+     */
+    clear() {
+        bt.loggerService.log(PERSIST_RISK_UTILS_METHOD_NAME_CLEAR);
+        this.getRiskStorage.clear();
+    }
     /**
      * Switches to the default JSON persist adapter.
      * All future persistence writes will use JSON storage.
@@ -1472,6 +1501,15 @@ class PersistScheduleUtils {
         bt.loggerService.info(PERSIST_SCHEDULE_UTILS_METHOD_NAME_USE_PERSIST_SCHEDULE_ADAPTER);
         this.PersistScheduleFactory = Ctor;
     }
+    /**
+     * Clears the memoized storage cache.
+     * Call this when process.cwd() changes between strategy iterations
+     * so new storage instances are created with the updated base path.
+     */
+    clear() {
+        bt.loggerService.log(PERSIST_SCHEDULE_UTILS_METHOD_NAME_CLEAR);
+        this.getScheduleStorage.clear();
+    }
     /**
      * Switches to the default JSON persist adapter.
      * All future persistence writes will use JSON storage.
@@ -1587,6 +1625,15 @@ class PersistPartialUtils {
         bt.loggerService.info(PERSIST_PARTIAL_UTILS_METHOD_NAME_USE_PERSIST_PARTIAL_ADAPTER);
         this.PersistPartialFactory = Ctor;
     }
+    /**
+     * Clears the memoized storage cache.
+     * Call this when process.cwd() changes between strategy iterations
+     * so new storage instances are created with the updated base path.
+     */
+    clear() {
+        bt.loggerService.log(PERSIST_PARTIAL_UTILS_METHOD_NAME_CLEAR);
+        this.getPartialStorage.clear();
+    }
     /**
      * Switches to the default JSON persist adapter.
      * All future persistence writes will use JSON storage.
@@ -1737,6 +1784,15 @@ class PersistBreakevenUtils {
         bt.loggerService.info(PERSIST_BREAKEVEN_UTILS_METHOD_NAME_USE_PERSIST_BREAKEVEN_ADAPTER);
         this.PersistBreakevenFactory = Ctor;
     }
+    /**
+     * Clears the memoized storage cache.
+     * Call this when process.cwd() changes between strategy iterations
+     * so new storage instances are created with the updated base path.
+     */
+    clear() {
+        bt.loggerService.log(PERSIST_BREAKEVEN_UTILS_METHOD_NAME_CLEAR);
+        this.getBreakevenStorage.clear();
+    }
     /**
      * Switches to the default JSON persist adapter.
      * All future persistence writes will use JSON storage.
@@ -1908,6 +1964,15 @@ class PersistCandleUtils {
         bt.loggerService.info("PersistCandleUtils.usePersistCandleAdapter");
         this.PersistCandlesFactory = Ctor;
     }
+    /**
+     * Clears the memoized storage cache.
+     * Call this when process.cwd() changes between strategy iterations
+     * so new storage instances are created with the updated base path.
+     */
+    clear() {
+        bt.loggerService.log(PERSIST_CANDLE_UTILS_METHOD_NAME_CLEAR);
+        this.getCandlesStorage.clear();
+    }
     /**
      * Switches to the default JSON persist adapter.
      * All future persistence writes will use JSON storage.
@@ -2014,6 +2079,15 @@ class PersistStorageUtils {
         bt.loggerService.info(PERSIST_STORAGE_UTILS_METHOD_NAME_USE_PERSIST_STORAGE_ADAPTER);
         this.PersistStorageFactory = Ctor;
     }
+    /**
+     * Clears the memoized storage cache.
+     * Call this when process.cwd() changes between strategy iterations
+     * so new storage instances are created with the updated base path.
+     */
+    clear() {
+        bt.loggerService.log(PERSIST_STORAGE_UTILS_METHOD_NAME_CLEAR);
+        this.getStorage.clear();
+    }
     /**
      * Switches to the default JSON persist adapter.
      * All future persistence writes will use JSON storage.
@@ -2109,6 +2183,15 @@ class PersistNotificationUtils {
         bt.loggerService.info(PERSIST_NOTIFICATION_UTILS_METHOD_NAME_USE_PERSIST_NOTIFICATION_ADAPTER);
         this.PersistNotificationFactory = Ctor;
     }
+    /**
+     * Clears the memoized storage cache.
+     * Call this when process.cwd() changes between strategy iterations
+     * so new storage instances are created with the updated base path.
+     */
+    clear() {
+        bt.loggerService.log(PERSIST_NOTIFICATION_UTILS_METHOD_NAME_CLEAR);
+        this.getNotificationStorage.clear();
+    }
     /**
      * Switches to the default JSON persist adapter.
      * All future persistence writes will use JSON storage.
@@ -2209,6 +2292,15 @@ class PersistLogUtils {
         bt.loggerService.info(PERSIST_LOG_UTILS_METHOD_NAME_USE_PERSIST_LOG_ADAPTER);
         this.PersistLogFactory = Ctor;
     }
+    /**
+     * Clears the cached storage instance.
+     * Call this when process.cwd() changes between strategy iterations
+     * so a new storage instance is created with the updated base path.
+     */
+    clear() {
+        bt.loggerService.log(PERSIST_LOG_UTILS_METHOD_NAME_CLEAR);
+        this._logStorage = null;
+    }
     /**
      * Switches to the default JSON persist adapter.
      * All future persistence writes will use JSON storage.
@@ -2297,6 +2389,15 @@ class PersistMeasureUtils {
         bt.loggerService.info(PERSIST_MEASURE_UTILS_METHOD_NAME_USE_PERSIST_MEASURE_ADAPTER);
         this.PersistMeasureFactory = Ctor;
     }
+    /**
+     * Clears the memoized storage cache.
+     * Call this when process.cwd() changes between strategy iterations
+     * so new storage instances are created with the updated base path.
+     */
+    clear() {
+        bt.loggerService.log(PERSIST_MEASURE_UTILS_METHOD_NAME_CLEAR);
+        this.getMeasureStorage.clear();
+    }
     /**
      * Switches to the default JSON persist adapter.
      */
@@ -2440,16 +2541,24 @@ class PersistMemoryUtils {
             }
         };
         /**
-         * Dispose persist adapter to prevent memory leak
+         * Clears the memoized storage cache.
+         * Call this when process.cwd() changes between strategy iterations
+         * so new storage instances are created with the updated base path.
+         */
+        this.clear = () => {
+            bt.loggerService.info(PERSIST_MEMORY_UTILS_METHOD_NAME_CLEAR);
+            this.getMemoryStorage.clear();
+        };
+        /**
+         * Disposes of the memory adapter and releases any resources.
+         * Call this when a signal is removed to clean up its associated storage.
          *
          * @param signalId - Signal identifier
          * @param bucketName - Bucket name
+         * @returns void
          */
-        this.clear = (signalId, bucketName) => {
-            bt.loggerService.info(PERSIST_MEMORY_UTILS_METHOD_NAME_CLEAR, {
-                signalId,
-                bucketName,
-            });
+        this.dispose = (signalId, bucketName) => {
+            bt.loggerService.info(PERSIST_MEMORY_UTILS_METHOD_NAME_DISPOSE);
             const key = `${signalId}:${bucketName}`;
             this.getMemoryStorage.clear(key);
         };
@@ -19398,6 +19507,22 @@ const walker_strategy_columns = [
             : "N/A",
         isVisible: () => true,
     },
+    {
+        key: "firstEventTime",
+        label: "First Event",
+        format: (data) => data.firstEventTime !== null
+            ? new Date(data.firstEventTime).toISOString()
+            : "N/A",
+        isVisible: () => true,
+    },
+    {
+        key: "lastEventTime",
+        label: "Last Event",
+        format: (data) => data.lastEventTime !== null
+            ? new Date(data.lastEventTime).toISOString()
+            : "N/A",
+        isVisible: () => true,
+    },
 ];
 /**
  * Column configuration for walker PNL table in markdown reports.
@@ -19538,6 +19663,7 @@ const MARKDOWN_METHOD_NAME_WRITE_DATA = "MarkdownAdapter.writeData";
 const MARKDOWN_METHOD_NAME_USE_MD = "MarkdownAdapter.useMd";
 const MARKDOWN_METHOD_NAME_USE_JSONL = "MarkdownAdapter.useJsonl";
 const MARKDOWN_METHOD_NAME_USE_DUMMY = "MarkdownAdapter.useDummy";
+const MARKDOWN_METHOD_NAME_CLEAR = "MarkdownAdapter.clear";
 /** Symbol key for the singleshot waitForInit function on MarkdownFileBase instances. */
 const WAIT_FOR_INIT_SYMBOL$2 = Symbol("wait-for-init");
 /** Symbol key for the timeout-protected write function on MarkdownFileBase instances. */
@@ -20009,6 +20135,15 @@ class MarkdownAdapter extends MarkdownUtils {
         bt.loggerService.debug(MARKDOWN_METHOD_NAME_USE_JSONL);
         this.useMarkdownAdapter(MarkdownFileBase);
     }
+    /**
+     * Clears the memoized storage cache.
+     * Call this when process.cwd() changes between strategy iterations
+     * so new storage instances are created with the updated base path.
+     */
+    clear() {
+        bt.loggerService.log(MARKDOWN_METHOD_NAME_CLEAR);
+        this.getMarkdownStorage.clear();
+    }
     /**
      * Switches to a dummy markdown adapter that discards all writes.
      * All future markdown writes will be no-ops.
@@ -22206,10 +22341,19 @@ let ReportStorage$6 = class ReportStorage {
         if (data.strategyName === data.bestStrategy) {
             this._bestStats = data.stats;
         }
+        const signals = data.stats.signalList;
+        const firstEventTime = signals.length > 0
+            ? signals.reduce((acc, s) => s.signal.pendingAt < acc ? s.signal.pendingAt : acc, signals[0].signal.pendingAt)
+            : null;
+        const lastEventTime = signals.length > 0
+            ? signals.reduce((acc, s) => s.closeTimestamp > acc ? s.closeTimestamp : acc, signals[0].closeTimestamp)
+            : null;
         this._strategyResults.unshift({
             strategyName: data.strategyName,
             stats: data.stats,
             metricValue: isUnsafe$1(data.metricValue) ? null : data.metricValue,
+            firstEventTime,
+            lastEventTime,
         });
     }
     /**
@@ -26801,6 +26945,7 @@ const REPORT_UTILS_METHOD_NAME_ENABLE = "ReportUtils.enable";
 const REPORT_UTILS_METHOD_NAME_DISABLE = "ReportUtils.disable";
 const REPORT_UTILS_METHOD_NAME_USE_DUMMY = "ReportUtils.useDummy";
 const REPORT_UTILS_METHOD_NAME_USE_JSONL = "ReportUtils.useJsonl";
+const REPORT_UTILS_METHOD_NAME_CLEAR = "ReportUtils.clear";
 /** Symbol key for the singleshot waitForInit function on ReportBase instances. */
 const WAIT_FOR_INIT_SYMBOL$1 = Symbol("wait-for-init");
 /** Symbol key for the timeout-protected write function on ReportBase instances. */
@@ -27210,6 +27355,15 @@ class ReportAdapter extends ReportUtils {
         bt.loggerService.info(REPORT_UTILS_METHOD_NAME_USE_REPORT_ADAPTER);
         this.ReportFactory = Ctor;
     }
+    /**
+     * Clears the memoized storage cache.
+     * Call this when process.cwd() changes between strategy iterations
+     * so new storage instances are created with the updated base path.
+     */
+    clear() {
+        bt.loggerService.log(REPORT_UTILS_METHOD_NAME_CLEAR);
+        this.getReportStorage.clear();
+    }
     /**
      * Switches to a dummy report adapter that discards all writes.
      * All future report writes will be no-ops.
@@ -28052,6 +28206,13 @@ class WalkerReportService {
          */
         this.tick = async (data) => {
             this.loggerService.log(WALKER_REPORT_METHOD_NAME_TICK, { data });
+            const signals = data.stats.signalList;
+            const firstEventTime = signals.length > 0
+                ? signals.reduce((acc, s) => s.signal.pendingAt < acc ? s.signal.pendingAt : acc, signals[0].signal.pendingAt)
+                : null;
+            const lastEventTime = signals.length > 0
+                ? signals.reduce((acc, s) => s.closeTimestamp > acc ? s.closeTimestamp : acc, signals[0].closeTimestamp)
+                : null;
             await Report.writeData("walker", {
                 timestamp: getContextTimestamp(),
                 walkerName: data.walkerName,
@@ -28076,6 +28237,8 @@ class WalkerReportService {
                 annualizedSharpeRatio: data.stats.annualizedSharpeRatio,
                 certaintyRatio: data.stats.certaintyRatio,
                 expectedYearlyReturns: data.stats.expectedYearlyReturns,
+                firstEventTime,
+                lastEventTime,
             }, {
                 symbol: data.symbol,
                 strategyName: data.strategyName,
@@ -33525,6 +33688,7 @@ const BROKER_METHOD_NAME_COMMIT_AVERAGE_BUY = "BrokerAdapter.commitAverageBuy";
 const BROKER_METHOD_NAME_USE_BROKER_ADAPTER = "BrokerAdapter.useBrokerAdapter";
 const BROKER_METHOD_NAME_ENABLE = "BrokerAdapter.enable";
 const BROKER_METHOD_NAME_DISABLE = "BrokerAdapter.disable";
+const BROKER_METHOD_NAME_CLEAR = "BrokerAdapter.clear";
 const BROKER_BASE_METHOD_NAME_WAIT_FOR_INIT = "BrokerBase.waitForInit";
 const BROKER_BASE_METHOD_NAME_ON_SIGNAL_OPEN = "BrokerBase.onSignalOpenCommit";
 const BROKER_BASE_METHOD_NAME_ON_SIGNAL_CLOSE = "BrokerBase.onSignalCloseCommit";
@@ -34124,6 +34288,16 @@ class BrokerAdapter {
                 lastSubscription();
             }
         };
+        /**
+         * Clears the cached broker instance and resets the enable singleshot.
+         * Call this when process.cwd() changes between strategy iterations
+         * so a new broker instance is created with the updated base path.
+         */
+        this.clear = () => {
+            bt.loggerService.info(BROKER_METHOD_NAME_CLEAR, {});
+            this._brokerInstance = null;
+            this.enable.clear();
+        };
     }
 }
 /**
@@ -43417,6 +43591,7 @@ const MEMORY_ADAPTER_METHOD_NAME_READ = "MemoryAdapter.readMemory";
 const MEMORY_ADAPTER_METHOD_NAME_USE_LOCAL = "MemoryAdapter.useLocal";
 const MEMORY_ADAPTER_METHOD_NAME_USE_PERSIST = "MemoryAdapter.usePersist";
 const MEMORY_ADAPTER_METHOD_NAME_USE_DUMMY = "MemoryAdapter.useDummy";
+const MEMORY_ADAPTER_METHOD_NAME_CLEAR = "MemoryAdapter.clear";
 /**
  * In-memory BM25 search index backed instance.
  * All data lives in the process memory only - no disk persistence.
@@ -43639,7 +43814,7 @@ class MemoryPersistInstance {
             signalId: this.signalId,
             bucketName: this.bucketName,
         });
-        PersistMemoryAdapter.clear(this.signalId, this.bucketName);
+        PersistMemoryAdapter.dispose(this.signalId, this.bucketName);
     }
 }
 /**
@@ -43877,6 +44052,15 @@ class MemoryAdapter {
             bt.loggerService.info(MEMORY_ADAPTER_METHOD_NAME_USE_DUMMY);
             this.MemoryFactory = MemoryDummyInstance;
         };
+        /**
+         * Clears the memoized instance cache.
+         * Call this when process.cwd() changes between strategy iterations
+         * so new instances are created with the updated base path.
+         */
+        this.clear = () => {
+            bt.loggerService.info(MEMORY_ADAPTER_METHOD_NAME_CLEAR);
+            this.getInstance.clear();
+        };
         /**
          * Releases resources held by this adapter.
          * Delegates to disable() to unsubscribe from signal lifecycle events.
@@ -44164,6 +44348,7 @@ const DUMP_ADAPTER_METHOD_NAME_USE_MEMORY = "DumpAdapter.useMemory";
 const DUMP_ADAPTER_METHOD_NAME_USE_DUMMY = "DumpAdapter.useDummy";
 const DUMP_ADAPTER_METHOD_NAME_USE_BOTH = "DumpAdapter.useMarkdownMemoryBoth";
 const DUMP_ADAPTER_METHOD_NAME_USE_ADAPTER = "DumpAdapter.useDumpAdapter";
+const DUMP_ADAPTER_METHOD_NAME_CLEAR = "DumpAdapter.clear";
 /**
  * Renders a single MessageModel as a markdown section.
  * tool_calls are rendered as a fenced JSON block.
@@ -44921,6 +45106,15 @@ class DumpAdapter {
             bt.loggerService.info(DUMP_ADAPTER_METHOD_NAME_USE_ADAPTER);
             this.DumpFactory = Ctor;
         };
+        /**
+         * Clears the memoized instance cache.
+         * Call this when process.cwd() changes between strategy iterations
+         * so new instances are created with the updated base path.
+         */
+        this.clear = () => {
+            bt.loggerService.info(DUMP_ADAPTER_METHOD_NAME_CLEAR);
+            this.getInstance.clear();
+        };
     }
 }
 const Dump = new DumpAdapter();
@@ -45241,6 +45435,7 @@ const LOG_ADAPTER_METHOD_NAME_USE_PERSIST = "LogAdapter.usePersist";
 const LOG_ADAPTER_METHOD_NAME_USE_MEMORY = "LogAdapter.useMemory";
 const LOG_ADAPTER_METHOD_NAME_USE_DUMMY = "LogAdapter.useDummy";
 const LOG_ADAPTER_METHOD_NAME_USE_JSONL = "LogAdapter.useJsonl";
+const LOG_ADAPTER_METHOD_NAME_CLEAR = "LogAdapter.clear";
 const LOG_JSONL_METHOD_NAME_LOG = "LogJsonlUtils.log";
 const LOG_JSONL_METHOD_NAME_DEBUG = "LogJsonlUtils.debug";
 const LOG_JSONL_METHOD_NAME_INFO = "LogJsonlUtils.info";
@@ -45862,6 +46057,15 @@ class LogAdapter {
             bt.loggerService.info(LOG_ADAPTER_METHOD_NAME_USE_JSONL);
             this._log = new LogJsonlUtils(fileName, dirName);
         };
+        /**
+         * Clears the cached log instance by resetting to the default in-memory adapter.
+         * Call this when process.cwd() changes between strategy iterations
+         * so a new adapter instance is created with the updated base path.
+         */
+        this.clear = () => {
+            bt.loggerService.info(LOG_ADAPTER_METHOD_NAME_CLEAR);
+            this._log = new LogMemoryUtils();
+        };
     }
 }
 /**
@@ -47589,10 +47793,12 @@ const STORAGE_BACKTEST_ADAPTER_METHOD_NAME_USE_ADAPTER = "StorageBacktestAdapter
 const STORAGE_BACKTEST_ADAPTER_METHOD_NAME_USE_DUMMY = "StorageBacktestAdapter.useDummy";
 const STORAGE_BACKTEST_ADAPTER_METHOD_NAME_USE_PERSIST = "StorageBacktestAdapter.usePersist";
 const STORAGE_BACKTEST_ADAPTER_METHOD_NAME_USE_MEMORY = "StorageBacktestAdapter.useMemory";
+const STORAGE_BACKTEST_ADAPTER_METHOD_NAME_CLEAR = "StorageBacktestAdapter.clear";
 const STORAGE_LIVE_ADAPTER_METHOD_NAME_USE_ADAPTER = "StorageLiveAdapter.useStorageAdapter";
 const STORAGE_LIVE_ADAPTER_METHOD_NAME_USE_DUMMY = "StorageLiveAdapter.useDummy";
 const STORAGE_LIVE_ADAPTER_METHOD_NAME_USE_PERSIST = "StorageLiveAdapter.usePersist";
 const STORAGE_LIVE_ADAPTER_METHOD_NAME_USE_MEMORY = "StorageLiveAdapter.useMemory";
+const STORAGE_LIVE_ADAPTER_METHOD_NAME_CLEAR = "StorageLiveAdapter.clear";
 /**
  * Persistent storage adapter for backtest signals.
  *
@@ -48579,6 +48785,15 @@ class StorageBacktestAdapter {
             bt.loggerService.info(STORAGE_BACKTEST_ADAPTER_METHOD_NAME_USE_MEMORY);
             this._signalBacktestUtils = new StorageMemoryBacktestUtils();
         };
+        /**
+         * Clears the cached utils instance by resetting to the default in-memory adapter.
+         * Call this when process.cwd() changes between strategy iterations
+         * so a new instance is created with the updated base path.
+         */
+        this.clear = () => {
+            bt.loggerService.info(STORAGE_BACKTEST_ADAPTER_METHOD_NAME_CLEAR);
+            this._signalBacktestUtils = new StorageMemoryBacktestUtils();
+        };
     }
 }
 /**
@@ -48683,6 +48898,15 @@ class StorageLiveAdapter {
             bt.loggerService.info(STORAGE_LIVE_ADAPTER_METHOD_NAME_USE_MEMORY);
             this._signalLiveUtils = new StorageMemoryLiveUtils();
         };
+        /**
+         * Clears the cached utils instance by resetting to the default persistent adapter.
+         * Call this when process.cwd() changes between strategy iterations
+         * so a new instance is created with the updated base path.
+         */
+        this.clear = () => {
+            bt.loggerService.info(STORAGE_LIVE_ADAPTER_METHOD_NAME_CLEAR);
+            this._signalLiveUtils = new StoragePersistLiveUtils();
+        };
     }
 }
 /**
@@ -49503,7 +49727,7 @@ const NOTIFICATION_MEMORY_BACKTEST_METHOD_NAME_HANDLE_ERROR = "NotificationMemor
 const NOTIFICATION_MEMORY_BACKTEST_METHOD_NAME_HANDLE_CRITICAL_ERROR = "NotificationMemoryBacktestUtils.handleCriticalError";
 const NOTIFICATION_MEMORY_BACKTEST_METHOD_NAME_HANDLE_VALIDATION_ERROR = "NotificationMemoryBacktestUtils.handleValidationError";
 const NOTIFICATION_MEMORY_BACKTEST_METHOD_NAME_GET_DATA = "NotificationMemoryBacktestUtils.getData";
-const NOTIFICATION_MEMORY_BACKTEST_METHOD_NAME_CLEAR = "NotificationMemoryBacktestUtils.clear";
+const NOTIFICATION_MEMORY_BACKTEST_METHOD_NAME_DISPOSE = "NotificationMemoryBacktestUtils.dispose";
 const NOTIFICATION_MEMORY_LIVE_METHOD_NAME_HANDLE_SIGNAL = "NotificationMemoryLiveUtils.handleSignal";
 const NOTIFICATION_MEMORY_LIVE_METHOD_NAME_HANDLE_PARTIAL_PROFIT = "NotificationMemoryLiveUtils.handlePartialProfit";
 const NOTIFICATION_MEMORY_LIVE_METHOD_NAME_HANDLE_PARTIAL_LOSS = "NotificationMemoryLiveUtils.handlePartialLoss";
@@ -49515,19 +49739,21 @@ const NOTIFICATION_MEMORY_LIVE_METHOD_NAME_HANDLE_ERROR = "NotificationMemoryLiv
 const NOTIFICATION_MEMORY_LIVE_METHOD_NAME_HANDLE_CRITICAL_ERROR = "NotificationMemoryLiveUtils.handleCriticalError";
 const NOTIFICATION_MEMORY_LIVE_METHOD_NAME_HANDLE_VALIDATION_ERROR = "NotificationMemoryLiveUtils.handleValidationError";
 const NOTIFICATION_MEMORY_LIVE_METHOD_NAME_GET_DATA = "NotificationMemoryLiveUtils.getData";
-const NOTIFICATION_MEMORY_LIVE_METHOD_NAME_CLEAR = "NotificationMemoryLiveUtils.clear";
+const NOTIFICATION_MEMORY_LIVE_METHOD_NAME_DISPOSE = "NotificationMemoryLiveUtils.clear";
 const NOTIFICATION_ADAPTER_METHOD_NAME_ENABLE = "NotificationAdapter.enable";
 const NOTIFICATION_ADAPTER_METHOD_NAME_DISABLE = "NotificationAdapter.disable";
 const NOTIFICATION_ADAPTER_METHOD_NAME_GET_DATA_BACKTEST = "NotificationAdapter.getDataBacktest";
-const NOTIFICATION_ADAPTER_METHOD_NAME_CLEAR_LIVE = "NotificationAdapter.clearLive";
+const NOTIFICATION_ADAPTER_METHOD_NAME_DISPOSE_LIVE = "NotificationAdapter.disposeLive";
 const NOTIFICATION_BACKTEST_ADAPTER_METHOD_NAME_USE_ADAPTER = "NotificationBacktestAdapter.useNotificationAdapter";
 const NOTIFICATION_BACKTEST_ADAPTER_METHOD_NAME_USE_DUMMY = "NotificationBacktestAdapter.useDummy";
 const NOTIFICATION_BACKTEST_ADAPTER_METHOD_NAME_USE_MEMORY = "NotificationBacktestAdapter.useMemory";
 const NOTIFICATION_BACKTEST_ADAPTER_METHOD_NAME_USE_PERSIST = "NotificationBacktestAdapter.usePersist";
+const NOTIFICATION_BACKTEST_ADAPTER_METHOD_NAME_CLEAR = "NotificationBacktestAdapter.clear";
 const NOTIFICATION_LIVE_ADAPTER_METHOD_NAME_USE_ADAPTER = "NotificationLiveAdapter.useNotificationAdapter";
 const NOTIFICATION_LIVE_ADAPTER_METHOD_NAME_USE_DUMMY = "NotificationLiveAdapter.useDummy";
 const NOTIFICATION_LIVE_ADAPTER_METHOD_NAME_USE_MEMORY = "NotificationLiveAdapter.useMemory";
 const NOTIFICATION_LIVE_ADAPTER_METHOD_NAME_USE_PERSIST = "NotificationLiveAdapter.usePersist";
+const NOTIFICATION_LIVE_ADAPTER_METHOD_NAME_CLEAR = "NotificationLiveAdapter.clear";
 const NOTIFICATION_PERSIST_BACKTEST_METHOD_NAME_WAIT_FOR_INIT = "NotificationPersistBacktestUtils.waitForInit";
 const NOTIFICATION_PERSIST_BACKTEST_METHOD_NAME_UPDATE_NOTIFICATIONS = "NotificationPersistBacktestUtils._updateNotifications";
 const NOTIFICATION_PERSIST_BACKTEST_METHOD_NAME_HANDLE_SIGNAL = "NotificationPersistBacktestUtils.handleSignal";
@@ -49541,7 +49767,7 @@ const NOTIFICATION_PERSIST_BACKTEST_METHOD_NAME_HANDLE_ERROR = "NotificationPers
 const NOTIFICATION_PERSIST_BACKTEST_METHOD_NAME_HANDLE_CRITICAL_ERROR = "NotificationPersistBacktestUtils.handleCriticalError";
 const NOTIFICATION_PERSIST_BACKTEST_METHOD_NAME_HANDLE_VALIDATION_ERROR = "NotificationPersistBacktestUtils.handleValidationError";
 const NOTIFICATION_PERSIST_BACKTEST_METHOD_NAME_GET_DATA = "NotificationPersistBacktestUtils.getData";
-const NOTIFICATION_PERSIST_BACKTEST_METHOD_NAME_CLEAR = "NotificationPersistBacktestUtils.clear";
+const NOTIFICATION_PERSIST_BACKTEST_METHOD_NAME_DISPOSE = "NotificationPersistBacktestUtils.clear";
 const NOTIFICATION_PERSIST_LIVE_METHOD_NAME_WAIT_FOR_INIT = "NotificationPersistLiveUtils.waitForInit";
 const NOTIFICATION_PERSIST_LIVE_METHOD_NAME_UPDATE_NOTIFICATIONS = "NotificationPersistLiveUtils._updateNotifications";
 const NOTIFICATION_PERSIST_LIVE_METHOD_NAME_HANDLE_SIGNAL = "NotificationPersistLiveUtils.handleSignal";
@@ -49555,7 +49781,7 @@ const NOTIFICATION_PERSIST_LIVE_METHOD_NAME_HANDLE_ERROR = "NotificationPersistL
 const NOTIFICATION_PERSIST_LIVE_METHOD_NAME_HANDLE_CRITICAL_ERROR = "NotificationPersistLiveUtils.handleCriticalError";
 const NOTIFICATION_PERSIST_LIVE_METHOD_NAME_HANDLE_VALIDATION_ERROR = "NotificationPersistLiveUtils.handleValidationError";
 const NOTIFICATION_PERSIST_LIVE_METHOD_NAME_GET_DATA = "NotificationPersistLiveUtils.getData";
-const NOTIFICATION_PERSIST_LIVE_METHOD_NAME_CLEAR = "NotificationPersistLiveUtils.clear";
+const NOTIFICATION_PERSIST_LIVE_METHOD_NAME_DISPOSE = "NotificationPersistLiveUtils.clear";
 /**
  * In-memory notification adapter for backtest signals.
  *
@@ -49698,8 +49924,8 @@ class NotificationMemoryBacktestUtils {
         /**
          * Clears all stored notifications.
          */
-        this.clear = async () => {
-            bt.loggerService.info(NOTIFICATION_MEMORY_BACKTEST_METHOD_NAME_CLEAR);
+        this.dispose = async () => {
+            bt.loggerService.info(NOTIFICATION_MEMORY_BACKTEST_METHOD_NAME_DISPOSE);
             this._notifications = [];
         };
     }
@@ -49788,7 +50014,7 @@ class NotificationDummyBacktestUtils {
         /**
          * No-op clear operation.
          */
-        this.clear = async () => {
+        this.dispose = async () => {
         };
     }
 }
@@ -49968,8 +50194,8 @@ class NotificationPersistBacktestUtils {
         /**
          * Clears all stored notifications.
          */
-        this.clear = async () => {
-            bt.loggerService.info(NOTIFICATION_PERSIST_BACKTEST_METHOD_NAME_CLEAR);
+        this.dispose = async () => {
+            bt.loggerService.info(NOTIFICATION_PERSIST_BACKTEST_METHOD_NAME_DISPOSE);
             await this.waitForInit();
             this._notifications.clear();
             await this._updateNotifications();
@@ -50150,8 +50376,8 @@ class NotificationMemoryLiveUtils {
         /**
          * Clears all stored notifications.
          */
-        this.clear = async () => {
-            bt.loggerService.info(NOTIFICATION_MEMORY_LIVE_METHOD_NAME_CLEAR);
+        this.dispose = async () => {
+            bt.loggerService.info(NOTIFICATION_MEMORY_LIVE_METHOD_NAME_DISPOSE);
             this._notifications = [];
         };
     }
@@ -50240,7 +50466,7 @@ class NotificationDummyLiveUtils {
         /**
          * No-op clear operation.
          */
-        this.clear = async () => {
+        this.dispose = async () => {
         };
     }
 }
@@ -50421,8 +50647,8 @@ class NotificationPersistLiveUtils {
         /**
          * Clears all stored notifications.
          */
-        this.clear = async () => {
-            bt.loggerService.info(NOTIFICATION_PERSIST_LIVE_METHOD_NAME_CLEAR);
+        this.dispose = async () => {
+            bt.loggerService.info(NOTIFICATION_PERSIST_LIVE_METHOD_NAME_DISPOSE);
             await this.waitForInit();
             this._notifications.clear();
             await this._updateNotifications();
@@ -50570,8 +50796,8 @@ class NotificationBacktestAdapter {
          * Clears all stored notifications.
          * Proxies call to the underlying notification adapter.
          */
-        this.clear = async () => {
-            return await this._notificationBacktestUtils.clear();
+        this.dispose = async () => {
+            return await this._notificationBacktestUtils.dispose();
         };
         /**
          * Sets the notification adapter constructor.
@@ -50607,6 +50833,15 @@ class NotificationBacktestAdapter {
             bt.loggerService.info(NOTIFICATION_BACKTEST_ADAPTER_METHOD_NAME_USE_PERSIST);
             this._notificationBacktestUtils = new NotificationPersistBacktestUtils();
         };
+        /**
+         * Resets the cached utils instance to the default in-memory adapter.
+         * Call this when process.cwd() changes between strategy iterations
+         * so a new instance is created with the updated base path.
+         */
+        this.clear = () => {
+            bt.loggerService.info(NOTIFICATION_BACKTEST_ADAPTER_METHOD_NAME_CLEAR);
+            this._notificationBacktestUtils = new NotificationMemoryBacktestUtils();
+        };
     }
 }
 /**
@@ -50716,8 +50951,8 @@ class NotificationLiveAdapter {
          * Clears all stored notifications.
          * Proxies call to the underlying notification adapter.
          */
-        this.clear = async () => {
-            return await this._notificationLiveUtils.clear();
+        this.dispose = async () => {
+            return await this._notificationLiveUtils.dispose();
         };
         /**
          * Sets the notification adapter constructor.
@@ -50753,6 +50988,15 @@ class NotificationLiveAdapter {
             bt.loggerService.info(NOTIFICATION_LIVE_ADAPTER_METHOD_NAME_USE_PERSIST);
             this._notificationLiveUtils = new NotificationPersistLiveUtils();
         };
+        /**
+         * Resets the cached utils instance to the default in-memory adapter.
+         * Call this when process.cwd() changes between strategy iterations
+         * so a new instance is created with the updated base path.
+         */
+        this.clear = () => {
+            bt.loggerService.info(NOTIFICATION_LIVE_ADAPTER_METHOD_NAME_CLEAR);
+            this._notificationLiveUtils = new NotificationMemoryLiveUtils();
+        };
     }
 }
 /**
@@ -50866,17 +51110,17 @@ class NotificationAdapter {
          *
          * @throws Error if NotificationAdapter is not enabled
          */
-        this.clear = async (isBacktest) => {
-            bt.loggerService.info(NOTIFICATION_ADAPTER_METHOD_NAME_CLEAR_LIVE, {
+        this.dispose = async (isBacktest) => {
+            bt.loggerService.info(NOTIFICATION_ADAPTER_METHOD_NAME_DISPOSE_LIVE, {
                 backtest: isBacktest,
             });
             if (!this.enable.hasValue()) {
                 throw new Error("NotificationAdapter is not enabled. Call enable() first.");
             }
             if (isBacktest) {
-                return await NotificationBacktest.clear();
+                return await NotificationBacktest.dispose();
             }
-            return await NotificationLive.clear();
+            return await NotificationLive.dispose();
         };
     }
 }