@tradejs/cli 2.0.16 → 2.0.18

package/dist/cli.js

@@ -3678,8 +3678,8 @@ var init_aiPocketSearch = __esm({
       "volumeusd",
       "vwap"
     ]);
-    classifyAiPocketFeaturePath = (path24) => {
-      const segments = (Array.isArray(path24) ? path24 : path24.split(".")).filter(
+    classifyAiPocketFeaturePath = (path25) => {
+      const segments = (Array.isArray(path25) ? path25 : path25.split(".")).filter(
         Boolean
       );
       const normalized = segments.map((segment) => segment.toLowerCase());
@@ -10868,27 +10868,27 @@ var init_coinMarketCapContextBackfill = __esm({
       totalCredits: 0,
       byPath: /* @__PURE__ */ new Map()
     });
-    getCoinMarketCapPathLabel = (path24) => {
-      if (path24.includes("global-metrics")) return "global";
-      if (path24.includes("cryptocurrency/quotes")) return "reference";
-      if (path24.includes("exchange/quotes")) return "exchangeLiquidity";
-      if (path24.includes("fear-and-greed")) return "fearGreed";
-      if (path24.includes("cmc100")) return "cmc100";
-      if (path24.includes("cmc20")) return "cmc20";
-      return path24;
-    };
-    recordCoinMarketCapFetchStats = (stats, path24, creditCount) => {
+    getCoinMarketCapPathLabel = (path25) => {
+      if (path25.includes("global-metrics")) return "global";
+      if (path25.includes("cryptocurrency/quotes")) return "reference";
+      if (path25.includes("exchange/quotes")) return "exchangeLiquidity";
+      if (path25.includes("fear-and-greed")) return "fearGreed";
+      if (path25.includes("cmc100")) return "cmc100";
+      if (path25.includes("cmc20")) return "cmc20";
+      return path25;
+    };
+    recordCoinMarketCapFetchStats = (stats, path25, creditCount) => {
       if (!stats) return;
-      const existing = stats.byPath.get(path24) ?? { requests: 0, credits: 0 };
+      const existing = stats.byPath.get(path25) ?? { requests: 0, credits: 0 };
       existing.requests += 1;
       existing.credits += creditCount ?? 0;
       stats.requests += 1;
       stats.totalCredits += creditCount ?? 0;
-      stats.byPath.set(path24, existing);
+      stats.byPath.set(path25, existing);
     };
     formatCoinMarketCapFetchStats = (stats) => {
       const byPath = [...stats.byPath.entries()].map(
-        ([path24, item]) => `${getCoinMarketCapPathLabel(path24)}=${item.requests}req/${item.credits}cr`
+        ([path25, item]) => `${getCoinMarketCapPathLabel(path25)}=${item.requests}req/${item.credits}cr`
       ).join(" ");
       return `apiRequests=${stats.requests} apiCredits=${stats.totalCredits}${byPath ? ` ${byPath}` : ""}`;
     };
@@ -11865,10 +11865,11 @@ var init_hyperliquidRateLimiter = __esm({
 });
 
 // src/lib/hyperliquidWhaleBackfill.ts
-var import_timescale4, import_strategies4, DEFAULT_BASE_URL, DEFAULT_CONCURRENCY, DEFAULT_RATE_LIMIT_WEIGHT, MAX_PAGE_SIZE, MAX_PAGES_PER_WHALE, REQUEST_WEIGHT, sleep3, positiveInt, minuteCeil, nextMinute, fetchHyperliquidUserFillsByTime, runConcurrent, backfillHyperliquidWhaleContext;
+var import_progress6, import_timescale4, import_strategies4, DEFAULT_BASE_URL, DEFAULT_CONCURRENCY, DEFAULT_RATE_LIMIT_WEIGHT, MAX_PAGE_SIZE, MAX_PAGES_PER_WHALE, REQUEST_WEIGHT, sleep3, positiveInt, minuteCeil, nextMinute, fetchHyperliquidUserFillsByTime, runConcurrent, backfillHyperliquidWhaleContext;
 var init_hyperliquidWhaleBackfill = __esm({
   "src/lib/hyperliquidWhaleBackfill.ts"() {
     "use strict";
+    import_progress6 = __toESM(require("progress"));
     import_timescale4 = require("@tradejs/infra/timescale");
     import_strategies4 = require("@tradejs/node/strategies");
     init_hyperliquidWhaleData();
@@ -12094,11 +12095,36 @@ var init_hyperliquidWhaleBackfill = __esm({
         toMs,
         ...identity
       });
+      const totalCoverageBuckets = Math.ceil(
+        (toMs - fromMs) / HYPERLIQUID_WHALE_BUCKET_MS
+      );
+      const coverageBar = new import_progress6.default(
+        "Hyperliquid coverage :current/:total [:bar][:percent] :eta(s) rows=:rows chunk=:chunk",
+        {
+          total: Math.max(1, totalCoverageBuckets),
+          width: 24
+        }
+      );
+      let displayedCoverageBuckets = 0;
       const coverageBuckets = await (0, import_timescale4.rebuildHyperliquidWhaleCoverageRows)({
         fromMs,
         toMs,
         expectedWhales: whales.addresses.length,
-        ...identity
+        ...identity,
+        onProgress: (progress) => {
+          const next = Math.max(
+            displayedCoverageBuckets,
+            Math.min(progress.completedBuckets, coverageBar.total)
+          );
+          const delta = next - displayedCoverageBuckets;
+          if (delta > 0) {
+            coverageBar.tick(delta, {
+              rows: progress.rows,
+              chunk: `${progress.chunkIndex}/${progress.totalChunks}`
+            });
+            displayedCoverageBuckets = next;
+          }
+        }
       });
       const result = {
         cached: false,
@@ -13490,14 +13516,31 @@ var init_runState = __esm({
 });
 
 // src/lib/backtest/workerPool.ts
-var import_progress6, import_child_process, import_chalk13, import_node_crypto3, executeBacktestWorkerPool;
+var import_progress7, import_child_process, import_chalk13, import_node_crypto3, DEFAULT_PG_POOL_MAX, FAST_AI_PG_CONNECTION_BUDGET, MIN_FAST_AI_WORKER_PG_POOL_MAX, resolveFastAiWorkerPgPoolMax, executeBacktestWorkerPool;
 var init_workerPool = __esm({
   "src/lib/backtest/workerPool.ts"() {
     "use strict";
-    import_progress6 = __toESM(require("progress"));
+    import_progress7 = __toESM(require("progress"));
     import_child_process = require("child_process");
     import_chalk13 = __toESM(require("chalk"));
     import_node_crypto3 = require("crypto");
+    DEFAULT_PG_POOL_MAX = 10;
+    FAST_AI_PG_CONNECTION_BUDGET = 18;
+    MIN_FAST_AI_WORKER_PG_POOL_MAX = 3;
+    resolveFastAiWorkerPgPoolMax = (testSuite, workerCount, configuredPoolMax) => {
+      if (configuredPoolMax?.trim() || workerCount <= 1 || testSuite.length === 0 || testSuite.some((test) => !test.fast || !test.ai)) {
+        return void 0;
+      }
+      return String(
+        Math.min(
+          DEFAULT_PG_POOL_MAX,
+          Math.max(
+            MIN_FAST_AI_WORKER_PG_POOL_MAX,
+            Math.floor(FAST_AI_PG_CONNECTION_BUDGET / workerCount)
+          )
+        )
+      );
+    };
     executeBacktestWorkerPool = async ({
       testSuite,
       userName: userName2,
@@ -13516,6 +13559,12 @@ var init_workerPool = __esm({
       totalTests
     }) => {
       const chunks = chunkTestSuite(testSuite);
+      const fastAiWorkerPgPoolMax = resolveFastAiWorkerPgPoolMax(
+        testSuite,
+        chunks.length,
+        process.env.PG_POOL_MAX
+      );
+      const workerEnv = fastAiWorkerPgPoolMax ? { ...process.env, PG_POOL_MAX: fastAiWorkerPgPoolMax } : void 0;
       const totalExpectedTests = Math.max(
         testSuite.length,
         totalTests ?? testSuite.length,
@@ -13573,7 +13622,7 @@ var init_workerPool = __esm({
         console.log(line);
       }
       console.log("");
-      const bar = new import_progress6.default(
+      const bar = new import_progress7.default(
         ":current/:total [:bar][:percent] avg :amount win :winRate trades :trades :eta(s)",
         {
           total: totalExpectedTests,
@@ -13601,6 +13650,7 @@ var init_workerPool = __esm({
         const chunkId = runId ? `${runId}-${attemptId}` : attemptId;
         const chunkWithId = chunk.map((test) => ({ ...test, chunkId }));
         const tester = (0, import_child_process.fork)(testerWorkerPath, [], {
+          ...workerEnv ? { env: workerEnv } : {},
           execArgv: testerNeedsTsRuntime ? [
             `--max-old-space-size=${workerHeapMb2}`,
             "-r",
@@ -16728,15 +16778,15 @@ var require_pg_connection_string = __commonJS({
       if (config.sslnegotiation === "direct" && config.ssl === void 0) {
         config.ssl = true;
       }
-      const fs23 = config.sslcert || config.sslkey || config.sslrootcert ? require("fs") : null;
+      const fs24 = config.sslcert || config.sslkey || config.sslrootcert ? require("fs") : null;
       if (config.sslcert) {
-        config.ssl.cert = fs23.readFileSync(config.sslcert).toString();
+        config.ssl.cert = fs24.readFileSync(config.sslcert).toString();
       }
       if (config.sslkey) {
-        config.ssl.key = fs23.readFileSync(config.sslkey).toString();
+        config.ssl.key = fs24.readFileSync(config.sslkey).toString();
       }
       if (config.sslrootcert) {
-        config.ssl.ca = fs23.readFileSync(config.sslrootcert).toString();
+        config.ssl.ca = fs24.readFileSync(config.sslrootcert).toString();
       }
       if (options.useLibpqCompat && config.uselibpqcompat) {
         throw new Error("Both useLibpqCompat and uselibpqcompat are set. Please use only one of them.");
@@ -18556,7 +18606,7 @@ var require_split2 = __commonJS({
 var require_helper = __commonJS({
   "../../node_modules/pgpass/lib/helper.js"(exports2, module2) {
     "use strict";
-    var path24 = require("path");
+    var path25 = require("path");
     var Stream = require("stream").Stream;
     var split = require_split2();
     var util = require("util");
@@ -18595,7 +18645,7 @@ var require_helper = __commonJS({
     };
     module2.exports.getFileName = function(rawEnv) {
       var env = rawEnv || process.env;
-      var file = env.PGPASSFILE || (isWin ? path24.join(env.APPDATA || "./", "postgresql", "pgpass.conf") : path24.join(env.HOME || "./", ".pgpass"));
+      var file = env.PGPASSFILE || (isWin ? path25.join(env.APPDATA || "./", "postgresql", "pgpass.conf") : path25.join(env.HOME || "./", ".pgpass"));
       return file;
     };
     module2.exports.usePgPass = function(stats, fname) {
@@ -18727,16 +18777,16 @@ var require_helper = __commonJS({
 var require_lib = __commonJS({
   "../../node_modules/pgpass/lib/index.js"(exports2, module2) {
     "use strict";
-    var path24 = require("path");
-    var fs23 = require("fs");
+    var path25 = require("path");
+    var fs24 = require("fs");
     var helper = require_helper();
     module2.exports = function(connInfo, cb) {
       var file = helper.getFileName();
-      fs23.stat(file, function(err, stat) {
+      fs24.stat(file, function(err, stat) {
         if (err || !helper.usePgPass(stat, file)) {
           return cb(void 0);
         }
-        var st = fs23.createReadStream(file);
+        var st = fs24.createReadStream(file);
         helper.getPassword(connInfo, st, cb);
       });
     };
@@ -20833,12 +20883,12 @@ var continuity_exports = {};
 __export(continuity_exports, {
   main: () => main13
 });
-var import_args12, import_progress7, import_chalk20, import_connectors10, import_cli8, import_constants11, import_time5, import_logger2, import_timescale7, flags12, interval2, intervalKey, projectRoot5, parseProviders, runContinuity, main13;
+var import_args12, import_progress8, import_chalk20, import_connectors10, import_cli8, import_constants11, import_time5, import_logger2, import_timescale7, flags12, interval2, intervalKey, projectRoot5, parseProviders, runContinuity, main13;
 var init_continuity2 = __esm({
   "src/scripts/continuity.ts"() {
     "use strict";
     import_args12 = __toESM(require("args"));
-    import_progress7 = __toESM(require("progress"));
+    import_progress8 = __toESM(require("progress"));
     import_chalk20 = __toESM(require("chalk"));
     import_connectors10 = require("@tradejs/node/connectors");
     import_cli8 = require("@tradejs/node/cli");
@@ -20895,7 +20945,7 @@ var init_continuity2 = __esm({
         void 0,
         { universe }
       );
-      const bar = new import_progress7.default(
+      const bar = new import_progress8.default(
         ":current/:total [:bar][:percent] broken::broken fixed::fixed :eta(s) :symbol",
         {
           total: tickers.length,
@@ -21149,14 +21199,14 @@ var derivativesIngestCoinalyzeAll_exports = {};
 __export(derivativesIngestCoinalyzeAll_exports, {
   main: () => main15
 });
-var import_config5, import_args14, import_chalk22, import_progress8, import_lodash2, import_connectors12, import_indicators3, import_async4, import_userSettings5, import_cli9, import_timescale9, coinalyzeIntervalMap2, flags14, asInt6, parseList2, coinalyzeBaseUrl, coinalyzeMaxRetries, lastRequestTs3, fetchJsonWithRateLimit2, fetchCoinalyzeMarkets2, selectBestMarket2, buildMatches2, normalizeMetricPoint2, toSeriesMap2, fetchMetricBatch2, main15;
+var import_config5, import_args14, import_chalk22, import_progress9, import_lodash2, import_connectors12, import_indicators3, import_async4, import_userSettings5, import_cli9, import_timescale9, coinalyzeIntervalMap2, flags14, asInt6, parseList2, coinalyzeBaseUrl, coinalyzeMaxRetries, lastRequestTs3, fetchJsonWithRateLimit2, fetchCoinalyzeMarkets2, selectBestMarket2, buildMatches2, normalizeMetricPoint2, toSeriesMap2, fetchMetricBatch2, main15;
 var init_derivativesIngestCoinalyzeAll = __esm({
   "src/scripts/derivativesIngestCoinalyzeAll.ts"() {
     "use strict";
     import_config5 = require("dotenv/config");
     import_args14 = __toESM(require("args"));
     import_chalk22 = __toESM(require("chalk"));
-    import_progress8 = __toESM(require("progress"));
+    import_progress9 = __toESM(require("progress"));
     import_lodash2 = __toESM(require("lodash"));
     import_connectors12 = require("@tradejs/connectors");
     import_indicators3 = require("@tradejs/core/indicators");
@@ -21433,7 +21483,7 @@ var init_derivativesIngestCoinalyzeAll = __esm({
       const symbolBatches = import_lodash2.default.chunk(matches, symbolBatchSize);
       const windowsPerPair = Math.ceil(days / batchDays);
       const totalWindows = symbolBatches.length * intervals.length * windowsPerPair;
-      const bar = new import_progress8.default(
+      const bar = new import_progress9.default(
         ":current/:total [:bar][:percent] :eta(s) :batch rows=:rows fail=:fail",
         {
           total: Math.max(1, totalWindows),
@@ -22731,11 +22781,11 @@ var migration_exports = {};
 __export(migration_exports, {
   main: () => main22
 });
-var import_progress9, import_chalk30, import_logger3, import_files, import_timescale11, DIR, re, BATCH, projectRoot7, migrateFile, main22;
+var import_progress10, import_chalk30, import_logger3, import_files, import_timescale11, DIR, re, BATCH, projectRoot7, migrateFile, main22;
 var init_migration = __esm({
   "src/scripts/migration.ts"() {
     "use strict";
-    import_progress9 = __toESM(require("progress"));
+    import_progress10 = __toESM(require("progress"));
     import_chalk30 = __toESM(require("chalk"));
     import_logger3 = require("@tradejs/infra/logger");
     import_files = require("@tradejs/infra/files");
@@ -22762,7 +22812,7 @@ var init_migration = __esm({
     };
     main22 = async () => {
       const files = await (0, import_files.getFiles)(DIR, projectRoot7);
-      const bar = new import_progress9.default(
+      const bar = new import_progress10.default(
         ":current/:total [:bar][:percent] :eta(s) :file",
         {
           total: files.length,
@@ -27365,7 +27415,7 @@ var init_replayRuntimeEvidence = __esm({
 });
 
 // src/lib/runtimeEvidenceArtifacts.ts
-var import_node_crypto5, import_promises15, import_node_path8, RUNTIME_EVIDENCE_MANIFEST_FILE, RUNTIME_EVIDENCE_PAYLOAD_FILE, RUNTIME_EVIDENCE_COMPLETE_FILE, asRecord4, sha256, isExistingDestinationError, safeSegment, compactTimestamp, dateParts, assertFiniteTimestamp, parseManifest, publishRuntimeEvidenceBundle, verifyRuntimeEvidenceBundle, discoverRuntimeEvidenceBundles;
+var import_node_crypto5, import_promises15, import_node_path8, RUNTIME_EVIDENCE_MANIFEST_FILE, RUNTIME_EVIDENCE_PAYLOAD_FILE, RUNTIME_EVIDENCE_COMPLETE_FILE, asRecord4, sha256, runtimeEvidenceIdentitySha256, isExistingDestinationError, safeSegment, compactTimestamp, dateParts, assertFiniteTimestamp, parseManifest, publishRuntimeEvidenceBundle, verifyRuntimeEvidenceBundle, discoverRuntimeEvidenceBundles;
 var init_runtimeEvidenceArtifacts = __esm({
   "src/lib/runtimeEvidenceArtifacts.ts"() {
     "use strict";
@@ -27377,6 +27427,17 @@ var init_runtimeEvidenceArtifacts = __esm({
     RUNTIME_EVIDENCE_COMPLETE_FILE = ".complete";
     asRecord4 = (value) => value && typeof value === "object" && !Array.isArray(value) ? value : null;
     sha256 = (value) => (0, import_node_crypto5.createHash)("sha256").update(value).digest("hex");
+    runtimeEvidenceIdentitySha256 = (artifact) => {
+      const identityArtifact = { ...artifact };
+      delete identityArtifact.generatedAt;
+      const runtime = asRecord4(identityArtifact.runtime);
+      if (runtime) {
+        const identityRuntime = { ...runtime };
+        delete identityRuntime.generatedAt;
+        identityArtifact.runtime = identityRuntime;
+      }
+      return sha256(JSON.stringify(identityArtifact));
+    };
     isExistingDestinationError = (error) => {
       const code = error.code;
       return code === "EEXIST" || code === "ENOTEMPTY";
@@ -27447,11 +27508,12 @@ var init_runtimeEvidenceArtifacts = __esm({
       const payload = `${JSON.stringify(artifact, null, 2)}
 `;
       const payloadSha256 = sha256(payload);
+      const identitySha256 = runtimeEvidenceIdentitySha256(artifact);
       const safeDeploymentId = safeSegment(deploymentId, "default");
       const artifactId = [
         compactTimestamp(startTime),
         compactTimestamp(endTime),
-        payloadSha256.slice(0, 16)
+        identitySha256.slice(0, 16)
       ].join("_");
       const createdAt = Date.now();
       const manifest = {
@@ -28858,21 +28920,21 @@ var init_serverHealth = __esm({
       }
       return `${minutes}m`;
     };
-    readDiskUsage = (path24) => {
+    readDiskUsage = (path25) => {
       try {
-        const stats = (0, import_node_fs2.statfsSync)(path24);
+        const stats = (0, import_node_fs2.statfsSync)(path25);
         const totalBlocks = Number(stats.blocks ?? 0);
         const availableBlocks = Number(stats.bavail ?? 0);
         if (totalBlocks <= 0) {
-          return { path: path24, usedPct: null };
+          return { path: path25, usedPct: null };
         }
         const usedPct = (totalBlocks - Math.max(0, availableBlocks)) / totalBlocks * 100;
         return {
-          path: path24,
+          path: path25,
           usedPct: Number.isFinite(usedPct) ? usedPct : null
         };
       } catch {
-        return { path: path24, usedPct: null };
+        return { path: path25, usedPct: null };
       }
     };
     parseMeminfoBytes = (value) => {
@@ -32232,13 +32294,13 @@ __export(signals_exports, {
   signalsConfiguredScopesOnce: () => signalsConfiguredScopesOnce,
   signalsDaemon: () => signalsDaemon
 });
-var import_config11, import_args31, import_progress10, import_chalk43, import_connectors16, import_cli12, import_async5, import_strategies13, import_constants16, import_strategies14, import_time8, import_logger10, import_tradingAccounts3, SLOW_SIGNALS_WARNING_MS, projectRoot14, flags30, interval4, intervalMs, formatDuration3, resolvePositiveInteger2, resolveNonNegativeInteger, resolveSignalsDaemonMaxLiveBars, isSignalsKlineWsEnabled, resolveSignalsKlineWsWaitMs, createDefaultSignalsLifecycle, timeOperation3, formatSlowSignalsWarning, resolveSignalsConnectorName, createSignalsSession, findSignals, signals, loadConfiguredSignalsScopes, hasExplicitSignalsScope, signalsConfiguredScopesOnce, signalsDaemon, main38;
+var import_config11, import_args31, import_progress11, import_chalk43, import_connectors16, import_cli12, import_async5, import_strategies13, import_constants16, import_strategies14, import_time8, import_logger10, import_tradingAccounts3, SLOW_SIGNALS_WARNING_MS, projectRoot14, flags30, interval4, intervalMs, formatDuration3, resolvePositiveInteger2, resolveNonNegativeInteger, resolveSignalsDaemonMaxLiveBars, isSignalsKlineWsEnabled, resolveSignalsKlineWsWaitMs, createDefaultSignalsLifecycle, timeOperation3, formatSlowSignalsWarning, resolveSignalsConnectorName, createSignalsSession, findSignals, signals, loadConfiguredSignalsScopes, hasExplicitSignalsScope, signalsConfiguredScopesOnce, signalsDaemon, main38;
 var init_signals = __esm({
   "src/scripts/signals.ts"() {
     "use strict";
     import_config11 = require("dotenv/config");
     import_args31 = __toESM(require("args"));
-    import_progress10 = __toESM(require("progress"));
+    import_progress11 = __toESM(require("progress"));
     import_chalk43 = __toESM(require("chalk"));
     import_connectors16 = require("@tradejs/node/connectors");
     import_cli12 = require("@tradejs/node/cli");
@@ -32885,7 +32947,7 @@ var init_signals = __esm({
           return;
         }
         const strategyStats = createStrategySkipStats(runtimeStrategies);
-        const bar = new import_progress10.default(
+        const bar = new import_progress11.default(
           ":current/:total [:bar][:percent] :found :eta(s) :symbol",
           {
             total: tickers.length,
@@ -33223,7 +33285,7 @@ var init_signalsDaemon = __esm({
 });
 
 // src/lib/replay/cliConfig.ts
-var import_args32, REPLAY_UNSUPPORTED_FLAGS, hasCliFlag2, assertNoUnsupportedReplayFlags, replayNormalizedArgv, replayFlags, replayInterval, replayUserName, replayProjectRoot, isReplayUpdateOnlyRun;
+var import_args32, REPLAY_UNSUPPORTED_FLAGS, hasCliFlag2, assertNoUnsupportedReplayFlags, replayNormalizedArgv, replayFlags, replayInterval, replayUserName, replayProjectRoot, replayRuntimeEvidencePath, isReplayUpdateOnlyRun;
 var init_cliConfig2 = __esm({
   "src/lib/replay/cliConfig.ts"() {
     "use strict";
@@ -33272,6 +33334,10 @@ var init_cliConfig2 = __esm({
     import_args32.default.option(["d", "days"], "Run replay only for the last N days");
     import_args32.default.option("startTime", "Explicit replay start timestamp (ms or seconds)");
     import_args32.default.option("endTime", "Explicit replay end timestamp (ms or seconds)");
+    import_args32.default.option(
+      "runtimeEvidence",
+      "Immutable runtime evidence JSON used for offline runtime comparison"
+    );
     import_args32.default.option(["u", "updateOnly"], "Only update tickers history", false);
     import_args32.default.option(["C", "cacheOnly"], "Do not update tickers history", false);
     import_args32.default.option(
@@ -33297,6 +33363,7 @@ var init_cliConfig2 = __esm({
     replayInterval = String(replayFlags.timeframe ?? 15);
     replayUserName = String(replayFlags.user ?? "root");
     replayProjectRoot = String(process.env.PROJECT_CWD || process.cwd()).trim() || process.cwd();
+    replayRuntimeEvidencePath = typeof replayFlags.runtimeEvidence === "string" && replayFlags.runtimeEvidence.trim() ? replayFlags.runtimeEvidence.trim() : null;
     isReplayUpdateOnlyRun = Boolean(replayFlags.updateOnly);
   }
 });
@@ -33712,12 +33779,12 @@ var init_portfolioReplayConnector = __esm({
 });
 
 // src/lib/replay/historicalSignalsReplay.ts
-var import_chalk44, import_progress11, import_backtest4, import_strategies15, import_time9, import_logger11, import_redis20, import_connectors17, import_cli13, import_strategies16, loadRuntimeStrategies2, loadReferenceConnector, buildPreparedData, buildAfterSignalsContext, buildSymbolSharedReplayKey, runHistoricalSignalsReplay;
+var import_chalk44, import_progress12, import_backtest4, import_strategies15, import_time9, import_logger11, import_redis20, import_connectors17, import_cli13, import_strategies16, loadRuntimeStrategies2, loadReferenceConnector, buildPreparedData, buildAfterSignalsContext, buildSymbolSharedReplayKey, runHistoricalSignalsReplay;
 var init_historicalSignalsReplay = __esm({
   "src/lib/replay/historicalSignalsReplay.ts"() {
     "use strict";
     import_chalk44 = __toESM(require("chalk"));
-    import_progress11 = __toESM(require("progress"));
+    import_progress12 = __toESM(require("progress"));
     import_backtest4 = require("@tradejs/core/backtest");
     import_strategies15 = require("@tradejs/core/strategies");
     import_time9 = require("@tradejs/core/time");
@@ -33897,7 +33964,7 @@ var init_historicalSignalsReplay = __esm({
       const sharedReplayKeyPrefixes = [];
       let preparedSymbols = 0;
       let skippedSymbols = 0;
-      const prepareBar = new import_progress11.default(
+      const prepareBar = new import_progress12.default(
         "prepare :current/:total [:bar][:percent] skipped=:skipped :etas(s) :symbol",
         {
           total: preparedRun.tickers.length,
@@ -34019,7 +34086,7 @@ var init_historicalSignalsReplay = __esm({
         interval: interval5
       });
       let abortedCycles = 0;
-      const cycleBar = new import_progress11.default(
+      const cycleBar = new import_progress12.default(
         "cycles  :current/:total [:bar][:percent] sig=:signals abort=:aborted :etas(s) :ts",
         {
           total: orderedTimestamps.length,
@@ -35324,6 +35391,121 @@ var init_runtimeParityDetails = __esm({
   }
 });
 
+// src/lib/replay/runtimeEvidenceSource.ts
+var import_promises20, import_node_path14, asRecord6, asFiniteNumber, unwrapRows2, buildRuntimeEvidenceLineageScopes, loadReplayRuntimeEvidenceSource;
+var init_runtimeEvidenceSource = __esm({
+  "src/lib/replay/runtimeEvidenceSource.ts"() {
+    "use strict";
+    import_promises20 = __toESM(require("fs/promises"));
+    import_node_path14 = __toESM(require("path"));
+    init_runtimeLineage();
+    asRecord6 = (value) => value && typeof value === "object" && !Array.isArray(value) ? value : null;
+    asFiniteNumber = (value) => typeof value === "number" && Number.isFinite(value) ? value : null;
+    unwrapRows2 = (value, field) => (Array.isArray(value) ? value : []).map((item) => {
+      const row = asRecord6(item);
+      return asRecord6(row?.[field]) ?? row;
+    }).filter((item) => item != null);
+    buildRuntimeEvidenceLineageScopes = ({
+      signals: signals2,
+      evaluations
+    }) => {
+      const scopes = /* @__PURE__ */ new Map();
+      const add = ({
+        strategy,
+        symbol,
+        runtimeConfigId,
+        timestamp,
+        lineage
+      }) => {
+        if (!lineage || !Number.isFinite(timestamp)) {
+          return;
+        }
+        const key = `${strategy}::${symbol}::${runtimeLineageKey(lineage)}`;
+        const existing = scopes.get(key);
+        scopes.set(key, {
+          strategy,
+          symbol,
+          ...runtimeConfigId ? { runtimeConfigId } : {},
+          lineage,
+          firstTimestamp: existing ? Math.min(existing.firstTimestamp, timestamp) : timestamp,
+          lastTimestamp: existing ? Math.max(existing.lastTimestamp, timestamp) : timestamp
+        });
+      };
+      for (const signal of signals2) {
+        add({
+          strategy: signal.strategy,
+          symbol: signal.symbol,
+          runtimeConfigId: signal.runtimeConfigId,
+          timestamp: signal.timestamp,
+          lineage: signal.runtimeLineage
+        });
+      }
+      for (const evaluation of evaluations) {
+        add({
+          strategy: evaluation.strategy,
+          symbol: evaluation.symbol,
+          runtimeConfigId: evaluation.runtimeConfigId,
+          timestamp: evaluation.timestamp,
+          lineage: evaluation.runtimeLineage
+        });
+      }
+      return [...scopes.values()].sort(
+        (left, right) => left.strategy.localeCompare(right.strategy) || left.symbol.localeCompare(right.symbol) || left.firstTimestamp - right.firstTimestamp
+      );
+    };
+    loadReplayRuntimeEvidenceSource = async ({
+      filePath,
+      projectRoot: projectRoot16,
+      expectedUserName,
+      expectedWindow
+    }) => {
+      const resolvedPath = import_node_path14.default.resolve(projectRoot16, filePath);
+      const root = asRecord6(
+        JSON.parse(await import_promises20.default.readFile(resolvedPath, "utf8"))
+      );
+      const runtime = asRecord6(root?.runtime) ?? root;
+      if (!root || !runtime) {
+        throw new Error(`Invalid runtime evidence JSON: ${resolvedPath}`);
+      }
+      const rootWindow = asRecord6(root.window);
+      const runtimeWindow2 = asRecord6(runtime.window);
+      const startTime = asFiniteNumber(rootWindow?.startTime) ?? asFiniteNumber(runtimeWindow2?.startTime);
+      const endTime = asFiniteNumber(rootWindow?.endTime) ?? asFiniteNumber(runtimeWindow2?.endTime);
+      const userName2 = String(root.userName ?? runtime.userName ?? "").trim();
+      if (!userName2 || userName2 !== expectedUserName) {
+        throw new Error(
+          `Runtime evidence user mismatch: expected=${expectedUserName}, actual=${userName2 || "missing"}`
+        );
+      }
+      const endTimeMatches = endTime === expectedWindow.end || endTime === expectedWindow.end + 1;
+      if (startTime !== expectedWindow.start || !endTimeMatches) {
+        throw new Error(
+          `Runtime evidence window mismatch: expected=${expectedWindow.start}..${expectedWindow.end}, actual=${startTime ?? "missing"}..${endTime ?? "missing"}`
+        );
+      }
+      const trades = unwrapRows2(runtime.trades, "trade");
+      const signals2 = unwrapRows2(runtime.signals, "signal");
+      const evaluations = unwrapRows2(
+        runtime.evaluations,
+        "evaluation"
+      );
+      return {
+        path: resolvedPath,
+        userName: userName2,
+        startTime,
+        endTime,
+        trades,
+        signals: signals2,
+        evaluations,
+        lineageScopes: buildRuntimeEvidenceLineageScopes({
+          signals: signals2,
+          evaluations
+        })
+      };
+    };
+  }
+});
+
 // src/lib/replay/runtimeComparison.ts
 var import_chalk46, import_time11, getReplayEntryTimestampCompareOffsetMs, buildReplaySignalEvaluations, lineageScopeKey, buildExpectedLineageByScope, hasExpectedLineage, filterReplayComparisonByLineage, formatDrilldownSummary, toFiniteNumberOrNull4, sumOptionalNumbers, firstFiniteNumber, firstString, summarizeBacktestPnlByStrategy, getExchangeExecutionMergeKey, mergeExchangeExecutionGroup, mergeExchangeEntryExecutions, loadExchangeEntryRows, buildPriceDeltaPct3, loadExchangeEntriesForComparison, compareExchangeEntriesToBacktest, findExchangeRuntimeOutcome, splitExchangeMatchesByRuntimeOrderStatus, saveAndPrintReplayExchangeComparison, saveAndPrintReplayRuntimeComparison;
 var init_runtimeComparison = __esm({
@@ -35340,6 +35522,7 @@ var init_runtimeComparison = __esm({
     init_runtimeParityDetails();
     init_runState();
     init_cliConfig2();
+    init_runtimeEvidenceSource();
     init_support();
     init_runtimeLineage();
     getReplayEntryTimestampCompareOffsetMs = () => {
@@ -36110,7 +36293,8 @@ var init_runtimeComparison = __esm({
       liveStrategySummaries,
       backtestEntries,
       replaySignals,
-      replayLineages
+      replayLineages,
+      runtimeEvidencePath
     }) => {
       const { connector, connectorName, window: window2 } = getRuntimeCompareContext();
       if (!connector || !window2) {
@@ -36120,12 +36304,23 @@ var init_runtimeComparison = __esm({
         liveStrategySummaries.map((summary) => summary.strategyName)
       );
       const replaySignalEvaluations = buildReplaySignalEvaluations(replaySignals);
+      const runtimeEvidence2 = runtimeEvidencePath ? await loadReplayRuntimeEvidenceSource({
+        filePath: runtimeEvidencePath,
+        projectRoot: replayProjectRoot,
+        expectedUserName: replayUserName,
+        expectedWindow: window2
+      }) : null;
       const [
         rawRuntimeTrades,
         runtimeSignals,
         runtimeSignalEvaluations,
         runtimeLineageScopes
-      ] = await Promise.all([
+      ] = runtimeEvidence2 ? [
+        runtimeEvidence2.trades,
+        runtimeEvidence2.signals,
+        runtimeEvidence2.evaluations,
+        runtimeEvidence2.lineageScopes
+      ] : await Promise.all([
         loadRuntimeTrades(replayUserName, {
           startTime: window2.start,
           endTime: window2.end
@@ -36143,7 +36338,14 @@ var init_runtimeComparison = __esm({
           endTime: window2.end
         })
       ]);
-      const syncedRuntimeTrades = await syncRuntimeTrades({
+      if (runtimeEvidence2) {
+        console.log(
+          import_chalk46.default.gray(
+            `runtime compare: using immutable evidence ${runtimeEvidence2.path}`
+          )
+        );
+      }
+      const syncedRuntimeTrades = runtimeEvidence2 ? rawRuntimeTrades : await syncRuntimeTrades({
         userName: replayUserName,
         connector,
         trades: rawRuntimeTrades,
@@ -36194,7 +36396,7 @@ var init_runtimeComparison = __esm({
       const windowRuntimeTrades = comparable.runtimeTrades.filter(
         (trade) => trade.entryTimestamp >= window2.start && trade.entryTimestamp < window2.end && relevantStrategies.has(trade.strategy)
       );
-      if (!windowRuntimeTrades.length) {
+      if (!windowRuntimeTrades.length && !runtimeEvidence2) {
         console.log("");
         console.log(
           import_chalk46.default.yellow(
@@ -36328,12 +36530,12 @@ var init_runtimeComparison = __esm({
 });
 
 // src/lib/replay/outputReport.ts
-var import_promises20, import_node_path14, import_data4, formatMsk, formatNumber5, formatMoney2, formatPct, tableCell, createMarkdownTable2, entryStrategy, entryKey, buildDrilldownMap, buildPerTradeAnalysis, renderMatchedRows, renderRuntimeOnlyRows, renderOrderFailedRows, renderBacktestOnlyRows, renderStrategyRows, renderLineageRows, writeReplayOutputReport;
+var import_promises21, import_node_path15, import_data4, formatMsk, formatNumber5, formatMoney2, formatPct, tableCell, createMarkdownTable2, entryStrategy, entryKey, buildDrilldownMap, buildPerTradeAnalysis, renderMatchedRows, renderRuntimeOnlyRows, renderOrderFailedRows, renderBacktestOnlyRows, renderStrategyRows, renderLineageRows, writeReplayOutputReport;
 var init_outputReport = __esm({
   "src/lib/replay/outputReport.ts"() {
     "use strict";
-    import_promises20 = __toESM(require("fs/promises"));
-    import_node_path14 = __toESM(require("path"));
+    import_promises21 = __toESM(require("fs/promises"));
+    import_node_path15 = __toESM(require("path"));
     import_data4 = require("@tradejs/core/data");
     init_support();
     formatMsk = (timestamp) => typeof timestamp === "number" && Number.isFinite(timestamp) ? new Intl.DateTimeFormat("ru-RU", {
@@ -36638,8 +36840,8 @@ var init_outputReport = __esm({
       strategySnapshot,
       runtimeComparison
     }) => {
-      const outputDir = import_node_path14.default.resolve(projectRoot16, "data/replay/output");
-      await import_promises20.default.mkdir(outputDir, { recursive: true });
+      const outputDir = import_node_path15.default.resolve(projectRoot16, "data/replay/output");
+      await import_promises21.default.mkdir(outputDir, { recursive: true });
       const perTradeAnalysis = buildPerTradeAnalysis(runtimeComparison);
       const report = {
         reportType: "replay-output",
@@ -36674,8 +36876,8 @@ var init_outputReport = __esm({
         runtimeComparison,
         perTradeAnalysis
       };
-      const markdownPath = import_node_path14.default.join(outputDir, `${timestamp}-replay-report.md`);
-      const jsonPath = import_node_path14.default.join(outputDir, `${timestamp}-replay-report.json`);
+      const markdownPath = import_node_path15.default.join(outputDir, `${timestamp}-replay-report.md`);
+      const jsonPath = import_node_path15.default.join(outputDir, `${timestamp}-replay-report.json`);
       const lines = [
         "# Replay Report",
         "",
@@ -36741,8 +36943,8 @@ var init_outputReport = __esm({
         ""
       ];
       await Promise.all([
-        import_promises20.default.writeFile(markdownPath, lines.join("\n"), "utf8"),
-        import_promises20.default.writeFile(jsonPath, `${(0, import_data4.toJson)(report, true)}
+        import_promises21.default.writeFile(markdownPath, lines.join("\n"), "utf8"),
+        import_promises21.default.writeFile(jsonPath, `${(0, import_data4.toJson)(report, true)}
 `, "utf8")
       ]);
       return {
@@ -36807,7 +37009,8 @@ var init_replayRunner = __esm({
         liveStrategySummaries: replayStrategySnapshot.summaries,
         backtestEntries: replayStrategySnapshot.backtestEntries,
         replaySignals: replayResult.signals,
-        replayLineages: replayResult.runtimeLineages
+        replayLineages: replayResult.runtimeLineages,
+        runtimeEvidencePath: replayRuntimeEvidencePath
       });
       const finishedAt = /* @__PURE__ */ new Date();
       const durationSeconds = Number(