@tradejs/cli 1.0.10 → 1.0.11

package/README.md

@@ -19,7 +19,16 @@ Official CLI for the TradeJS open-source framework.
 
 ## Standard External Install Flow
 
-For a normal external project with CLI + runtime + UI:
+For a new external project with CLI + runtime + UI:
+
+```bash
+npx create-tradejs
+```
+
+The generator installs the packages, starts local infra, and opens the install
+page. The user chooses the local `root` password before entering the dashboard.
+
+For manual integration into an existing project:
 
 ```bash
 npm i @tradejs/app @tradejs/core @tradejs/node @tradejs/types @tradejs/base @tradejs/cli
@@ -34,7 +43,7 @@ import { basePreset } from '@tradejs/base';
 export default defineConfig(basePreset);
 ```
 
-## First Commands In A Fresh Project
+## Manual Setup Commands
 
 ```bash
 npx @tradejs/cli infra-init
@@ -43,10 +52,10 @@ npx @tradejs/cli doctor
 npx @tradejs/cli user-add -u root -p 'StrongPassword123!'
 ```
 
-After that you can run:
+After saving a backtest config, you can run:
 
 ```bash
-npx @tradejs/cli backtest
+npx @tradejs/cli backtest --config MaStrategy:base
 npx @tradejs/cli backtest --ai
 npx @tradejs/cli ai-export
 npx @tradejs/cli ai-train -n 50 --minQuality 4

package/dist/cli.js

@@ -9425,7 +9425,7 @@ var init_derivativesContextBackfill = __esm({
 });
 
 // src/lib/coinMarketCapContextBackfill.ts
-var import_chalk8, import_async2, import_timescale3, import_userSettings3, DAY_MS7, SOURCE_GLOBAL_DAILY, SOURCE_REFERENCE, SOURCE_EXCHANGE_LIQUIDITY, SOURCE_FEAR_GREED, SOURCE_INDEX, COVERAGE_SCOPE_ALL, REFERENCE_ASSETS, CMC_INDEXES, DEFAULT_EXCHANGE_SLUGS, lastRequestTs2, asInt3, parseEnabledFlag2, getBaseUrl, getRequestDelayMs2, getMaxRetries, getMaxBackfillDays, getHistoricalAccessMonths, isExchangeLiquidityBackfillEnabled, isFearGreedBackfillEnabled, isVerboseRequestLoggingEnabled, getFearGreedPageSize, getExchangeSlugs, toFiniteNumberOrNull, toIntOrNull, getRecord, getNestedRecord, safeDivide2, sumFinite, toExchangeLiquidityRegime, normalizeFearGreedClassification, toFearGreedRegime, dayStartUtc, toIsoDate, subtractUtcMonths, nextUtcDayStart, resolveCoinMarketCapBackfillWindow, hasIntervalCoverage, hasDailyCoverage, coverageKey2, isMarketContextBackfillCoverageDataBearing, coverageRowsToKeySet, hasBackfillCoverage, formatCoverageRange, formatReferenceCoverage, resolveBackfillStatus, formatSourceStatus, createCoinMarketCapFetchStats, getCoinMarketCapPathLabel, recordCoinMarketCapFetchStats, formatCoinMarketCapFetchStats, formatRowTimeRange, logBackfillSourceDone, markBackfillCoverage, coinMarketCapFetch, fetchCoinMarketCapIndexRows, coinMarketCapGlobalPayloadToRows, normalizeAssetDataItems, coinMarketCapHistoricalQuotesPayloadToRows, coinMarketCapExchangeQuotesPayloadToLiquidityRows, coinMarketCapFearGreedPayloadToRows, toCmcIndexWeightPct, coinMarketCapIndexPayloadToRows, shouldBackfillCoinMarketCapContextForMode, shouldBackfillCoinMarketCapContextForBacktest, shouldBackfillCoinMarketCapContextForReplay, shouldBackfillCoinMarketCapContextForSignals, skippedResult, backfillCoinMarketCapContext, backfillCoinMarketCapContextForBacktest, backfillCoinMarketCapContextForReplay, backfillCoinMarketCapContextForSignals;
+var import_chalk8, import_async2, import_timescale3, import_userSettings3, DAY_MS7, DEFAULT_CONTEXT_MAX_AGE_MS, DEFAULT_FEAR_GREED_STALE_RETRY_MS, SOURCE_GLOBAL_DAILY, SOURCE_REFERENCE, SOURCE_EXCHANGE_LIQUIDITY, SOURCE_FEAR_GREED, SOURCE_INDEX, COVERAGE_SCOPE_ALL, REFERENCE_ASSETS, CMC_INDEXES, DEFAULT_EXCHANGE_SLUGS, lastRequestTs2, asInt3, parseEnabledFlag2, getBaseUrl, getRequestDelayMs2, getMaxRetries, getMaxBackfillDays, getHistoricalAccessMonths, isExchangeLiquidityBackfillEnabled, isFearGreedBackfillEnabled, isVerboseRequestLoggingEnabled, getFearGreedPageSize, getContextMaxAgeMs, getFearGreedStaleRetryMs, getExchangeSlugs, toFiniteNumberOrNull, toIntOrNull, getRecord, getNestedRecord, safeDivide2, sumFinite, toExchangeLiquidityRegime, normalizeFearGreedClassification, toFearGreedRegime, dayStartUtc, toIsoDate, subtractUtcMonths, nextUtcDayStart, resolveCoinMarketCapBackfillWindow, hasIntervalCoverage, hasDailyCoverage, coverageKey2, isMarketContextBackfillCoverageDataBearing, coverageRowsToKeySet, hasBackfillCoverage, hasRecentBackfillCoverage, formatCoverageRange, formatReferenceCoverage, resolveBackfillStatus, formatSourceStatus, createCoinMarketCapFetchStats, getCoinMarketCapPathLabel, recordCoinMarketCapFetchStats, formatCoinMarketCapFetchStats, formatRowTimeRange, logBackfillSourceDone, markBackfillCoverage, coinMarketCapFetch, fetchCoinMarketCapIndexRows, coinMarketCapGlobalPayloadToRows, normalizeAssetDataItems, coinMarketCapHistoricalQuotesPayloadToRows, coinMarketCapExchangeQuotesPayloadToLiquidityRows, coinMarketCapFearGreedPayloadToRows, toCmcIndexWeightPct, coinMarketCapIndexPayloadToRows, shouldBackfillCoinMarketCapContextForMode, shouldBackfillCoinMarketCapContextForBacktest, shouldBackfillCoinMarketCapContextForReplay, shouldBackfillCoinMarketCapContextForSignals, skippedResult, backfillCoinMarketCapContext, backfillCoinMarketCapContextForBacktest, backfillCoinMarketCapContextForReplay, backfillCoinMarketCapContextForSignals;
 var init_coinMarketCapContextBackfill = __esm({
   "src/lib/coinMarketCapContextBackfill.ts"() {
     "use strict";
@@ -9434,6 +9434,8 @@ var init_coinMarketCapContextBackfill = __esm({
     import_timescale3 = require("@tradejs/infra/timescale");
     import_userSettings3 = require("@tradejs/infra/userSettings");
     DAY_MS7 = 864e5;
+    DEFAULT_CONTEXT_MAX_AGE_MS = 48 * 60 * 6e4;
+    DEFAULT_FEAR_GREED_STALE_RETRY_MS = 60 * 6e4;
     SOURCE_GLOBAL_DAILY = "coinmarketcap_global";
     SOURCE_REFERENCE = "coinmarketcap_reference_asset";
     SOURCE_EXCHANGE_LIQUIDITY = "coinmarketcap_exchange_liquidity";
@@ -9479,6 +9481,14 @@ var init_coinMarketCapContextBackfill = __esm({
     isFearGreedBackfillEnabled = () => parseEnabledFlag2(process.env.COINMARKETCAP_CONTEXT_FEAR_GREED_ENABLED, true);
     isVerboseRequestLoggingEnabled = () => parseEnabledFlag2(process.env.COINMARKETCAP_CONTEXT_VERBOSE_REQUESTS, false);
     getFearGreedPageSize = () => asInt3(process.env.COINMARKETCAP_CONTEXT_FEAR_GREED_PAGE_SIZE, 500);
+    getContextMaxAgeMs = () => asInt3(
+      process.env.COINMARKETCAP_CONTEXT_MAX_AGE_MS,
+      DEFAULT_CONTEXT_MAX_AGE_MS
+    );
+    getFearGreedStaleRetryMs = () => asInt3(
+      process.env.COINMARKETCAP_CONTEXT_FEAR_GREED_STALE_RETRY_MS,
+      DEFAULT_FEAR_GREED_STALE_RETRY_MS
+    );
     getExchangeSlugs = () => {
       const raw = process.env.COINMARKETCAP_CONTEXT_EXCHANGE_SLUGS;
       const values = String(raw ?? "").split(",").map((item) => item.trim().toLowerCase()).filter(Boolean);
@@ -9599,6 +9609,23 @@ var init_coinMarketCapContextBackfill = __esm({
       )
     );
     hasBackfillCoverage = (coverageKeys, params) => coverageKeys.has(coverageKey2(params));
+    hasRecentBackfillCoverage = (rows, params) => {
+      const key = coverageKey2(params);
+      return rows.some((row) => {
+        if (!isMarketContextBackfillCoverageDataBearing(row)) return false;
+        if (coverageKey2({
+          source: row.source,
+          scope: row.scope,
+          interval: row.interval,
+          fromMs: row.fromMs,
+          toMs: row.toMs
+        }) !== key) {
+          return false;
+        }
+        const checkedAtMs = Number(row.checkedAtMs);
+        return Number.isFinite(checkedAtMs) && Math.max(0, params.atMs - checkedAtMs) <= params.maxAgeMs;
+      });
+    };
     formatCoverageRange = (coverage) => {
       if (!coverage) return "coverage=none";
       return `coverage=${new Date(coverage.firstMs).toISOString()}..${new Date(
@@ -10126,13 +10153,24 @@ var init_coinMarketCapContextBackfill = __esm({
           toMs
         }
       );
-      const fearGreedBackfillCovered = hasBackfillCoverage(fearGreedBackfillKeys, {
+      const fearGreedBackfillParams = {
         source: SOURCE_FEAR_GREED,
         scope: COVERAGE_SCOPE_ALL,
         interval: "1d",
         fromMs,
         toMs
-      });
+      };
+      const fearGreedBackfillWasCovered = hasBackfillCoverage(
+        fearGreedBackfillKeys,
+        fearGreedBackfillParams
+      );
+      const fearGreedLatestAgeMs = fearGreedCoverage == null ? Number.POSITIVE_INFINITY : Math.max(0, params.endMs - fearGreedCoverage.lastMs);
+      const refreshStaleFearGreed = params.refreshStaleFearGreed === true && fearGreedLatestAgeMs > getContextMaxAgeMs();
+      const fearGreedBackfillCovered = fearGreedBackfillWasCovered && (!refreshStaleFearGreed || hasRecentBackfillCoverage(fearGreedBackfillCoverage, {
+        ...fearGreedBackfillParams,
+        atMs: params.endMs,
+        maxAgeMs: getFearGreedStaleRetryMs()
+      }));
       const indexesBackfillCovered = CMC_INDEXES.every(
         (index) => hasBackfillCoverage(indexBackfillKeys, {
           source: SOURCE_INDEX,
@@ -10449,7 +10487,7 @@ var init_coinMarketCapContextBackfill = __esm({
     };
     backfillCoinMarketCapContextForBacktest = backfillCoinMarketCapContext;
     backfillCoinMarketCapContextForReplay = backfillCoinMarketCapContext;
-    backfillCoinMarketCapContextForSignals = backfillCoinMarketCapContext;
+    backfillCoinMarketCapContextForSignals = (params) => backfillCoinMarketCapContext({ ...params, refreshStaleFearGreed: true });
   }
 });
 
@@ -11173,6 +11211,11 @@ var init_runEnvironment = __esm({
           assetClasses
         })
       );
+      if (!loadedTickers.length) {
+        throw new Error(
+          `No tickers available for ${connectorName}. Check connector market-data access or select tickers explicitly.`
+        );
+      }
       if (showTickersList) {
         console.log(import_chalk12.default.gray(JSON.stringify(loadedTickers.sort(), null, 2)));
         return null;
@@ -11224,7 +11267,7 @@ var init_runEnvironment = __esm({
           log: (message) => console.log(import_chalk12.default.gray(message))
         });
         const backtestExecutionInterval = resolveBacktestExecutionPreloadInterval(interval5);
-        if (backtestExecutionInterval && String(backtestExecutionInterval) !== String(interval5)) {
+        if (import_constants6.BACKTEST_LOWER_TIMEFRAME_EXECUTION_ENABLED && backtestExecutionInterval && String(backtestExecutionInterval) !== String(interval5)) {
           await timeOperation2(
             `update ${connectorName} execution`,
             () => (0, import_cli4.update)(
@@ -12083,12 +12126,9 @@ var init_runnerCore = __esm({
         Number.isFinite(requestedTestsLimit) ? testsSkip + requestedTestsLimit : void 0
       );
       if (!preparedSuite.length) {
-        console.log(
-          import_chalk14.default.yellow(
-            `No tests selected (skip=${testsSkip}, limit=${Number.isFinite(requestedTestsLimit) ? requestedTestsLimit : "all"}).`
-          )
+        throw new Error(
+          `No backtest tests selected (available=${testSuite.length}, skip=${testsSkip}, limit=${Number.isFinite(requestedTestsLimit) ? requestedTestsLimit : "all"}).`
         );
-        return null;
       }
       await prepareMarketContextForRun({
         mode: "backtest",
@@ -20114,7 +20154,7 @@ var init_executionCalibration = __esm({
         );
       }
       notes.push(
-        "Delay risk bps is disabled; signal-to-arrival latency is modeled by delayed lower-timeframe backtest fills."
+        "Delay risk bps is disabled; signal-to-arrival latency is modeled by next-bar-open backtest fills."
       );
       return {
         confidence: fullTelemetrySamples.length >= 50 ? "high" : fullTelemetrySamples.length >= 20 ? "medium" : "low",
@@ -20311,13 +20351,12 @@ var init_infraCommon = __esm({
     DEV_COMPOSE_TEMPLATE = `services:
   timescale:
     image: timescale/timescaledb:latest-pg16
-    container_name: tradejs-timescale
     environment:
       POSTGRES_USER: \${PG_USER:-app}
       POSTGRES_PASSWORD: \${PG_PASSWORD:-app}
       POSTGRES_DB: \${PG_DB:-app}
     ports:
-      - "5432:5432"
+      - "\${PG_PORT:-5432}:5432"
     command:
       - postgres
       - -c
@@ -20337,14 +20376,18 @@ var init_infraCommon = __esm({
 
   redis:
     image: redis/redis-stack:latest
-    container_name: tradejs-redis
     environment:
       REDIS_ARGS: --save "" --appendonly no --stop-writes-on-bgsave-error no
     ports:
-      - "6379:6379"
-      - "5540:8001"
+      - "\${REDIS_PORT:-6379}:6379"
+      - "\${REDIS_INSIGHT_PORT:-5540}:8001"
     volumes:
       - tradejs_redisdata:/data
+    healthcheck:
+      test: ["CMD", "redis-cli", "ping"]
+      interval: 5s
+      timeout: 3s
+      retries: 10
     restart: unless-stopped
 
 volumes:
@@ -20442,8 +20485,16 @@ var init_infraUp = __esm({
     main19 = async () => {
       const composePath = requireDevComposeFile();
       console.log(import_chalk27.default.cyan("Starting dev infra (timescale, redis)..."));
-      runDockerCompose(composePath, ["up", "-d", "timescale", "redis"]);
-      console.log(import_chalk27.default.green("Dev infra is up."));
+      runDockerCompose(composePath, [
+        "up",
+        "-d",
+        "--wait",
+        "--wait-timeout",
+        "120",
+        "timescale",
+        "redis"
+      ]);
+      console.log(import_chalk27.default.green("Dev infra is ready."));
     };
   }
 });

package/dist/lib/coinMarketCapContextBackfill.js

@@ -52,6 +52,8 @@ var import_async = require("@tradejs/core/async");
 var import_timescale = require("@tradejs/infra/timescale");
 var import_userSettings = require("@tradejs/infra/userSettings");
 var DAY_MS = 864e5;
+var DEFAULT_CONTEXT_MAX_AGE_MS = 48 * 60 * 6e4;
+var DEFAULT_FEAR_GREED_STALE_RETRY_MS = 60 * 6e4;
 var SOURCE_GLOBAL_DAILY = "coinmarketcap_global";
 var SOURCE_REFERENCE = "coinmarketcap_reference_asset";
 var SOURCE_EXCHANGE_LIQUIDITY = "coinmarketcap_exchange_liquidity";
@@ -97,6 +99,14 @@ var isExchangeLiquidityBackfillEnabled = () => parseEnabledFlag(
 var isFearGreedBackfillEnabled = () => parseEnabledFlag(process.env.COINMARKETCAP_CONTEXT_FEAR_GREED_ENABLED, true);
 var isVerboseRequestLoggingEnabled = () => parseEnabledFlag(process.env.COINMARKETCAP_CONTEXT_VERBOSE_REQUESTS, false);
 var getFearGreedPageSize = () => asInt(process.env.COINMARKETCAP_CONTEXT_FEAR_GREED_PAGE_SIZE, 500);
+var getContextMaxAgeMs = () => asInt(
+  process.env.COINMARKETCAP_CONTEXT_MAX_AGE_MS,
+  DEFAULT_CONTEXT_MAX_AGE_MS
+);
+var getFearGreedStaleRetryMs = () => asInt(
+  process.env.COINMARKETCAP_CONTEXT_FEAR_GREED_STALE_RETRY_MS,
+  DEFAULT_FEAR_GREED_STALE_RETRY_MS
+);
 var getExchangeSlugs = () => {
   const raw = process.env.COINMARKETCAP_CONTEXT_EXCHANGE_SLUGS;
   const values = String(raw ?? "").split(",").map((item) => item.trim().toLowerCase()).filter(Boolean);
@@ -217,6 +227,23 @@ var coverageRowsToKeySet = (rows) => new Set(
   )
 );
 var hasBackfillCoverage = (coverageKeys, params) => coverageKeys.has(coverageKey(params));
+var hasRecentBackfillCoverage = (rows, params) => {
+  const key = coverageKey(params);
+  return rows.some((row) => {
+    if (!isMarketContextBackfillCoverageDataBearing(row)) return false;
+    if (coverageKey({
+      source: row.source,
+      scope: row.scope,
+      interval: row.interval,
+      fromMs: row.fromMs,
+      toMs: row.toMs
+    }) !== key) {
+      return false;
+    }
+    const checkedAtMs = Number(row.checkedAtMs);
+    return Number.isFinite(checkedAtMs) && Math.max(0, params.atMs - checkedAtMs) <= params.maxAgeMs;
+  });
+};
 var formatCoverageRange = (coverage) => {
   if (!coverage) return "coverage=none";
   return `coverage=${new Date(coverage.firstMs).toISOString()}..${new Date(
@@ -744,13 +771,24 @@ var backfillCoinMarketCapContext = async (params) => {
       toMs
     }
   );
-  const fearGreedBackfillCovered = hasBackfillCoverage(fearGreedBackfillKeys, {
+  const fearGreedBackfillParams = {
     source: SOURCE_FEAR_GREED,
     scope: COVERAGE_SCOPE_ALL,
     interval: "1d",
     fromMs,
     toMs
-  });
+  };
+  const fearGreedBackfillWasCovered = hasBackfillCoverage(
+    fearGreedBackfillKeys,
+    fearGreedBackfillParams
+  );
+  const fearGreedLatestAgeMs = fearGreedCoverage == null ? Number.POSITIVE_INFINITY : Math.max(0, params.endMs - fearGreedCoverage.lastMs);
+  const refreshStaleFearGreed = params.refreshStaleFearGreed === true && fearGreedLatestAgeMs > getContextMaxAgeMs();
+  const fearGreedBackfillCovered = fearGreedBackfillWasCovered && (!refreshStaleFearGreed || hasRecentBackfillCoverage(fearGreedBackfillCoverage, {
+    ...fearGreedBackfillParams,
+    atMs: params.endMs,
+    maxAgeMs: getFearGreedStaleRetryMs()
+  }));
   const indexesBackfillCovered = CMC_INDEXES.every(
     (index) => hasBackfillCoverage(indexBackfillKeys, {
       source: SOURCE_INDEX,
@@ -1067,7 +1105,7 @@ var backfillCoinMarketCapContext = async (params) => {
 };
 var backfillCoinMarketCapContextForBacktest = backfillCoinMarketCapContext;
 var backfillCoinMarketCapContextForReplay = backfillCoinMarketCapContext;
-var backfillCoinMarketCapContextForSignals = backfillCoinMarketCapContext;
+var backfillCoinMarketCapContextForSignals = (params) => backfillCoinMarketCapContext({ ...params, refreshStaleFearGreed: true });
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   backfillCoinMarketCapContext,

package/dist/lib/executionCalibration.js

@@ -619,7 +619,7 @@ var buildRecommendation = (samples) => {
     );
   }
   notes.push(
-    "Delay risk bps is disabled; signal-to-arrival latency is modeled by delayed lower-timeframe backtest fills."
+    "Delay risk bps is disabled; signal-to-arrival latency is modeled by next-bar-open backtest fills."
   );
   return {
     confidence: fullTelemetrySamples.length >= 50 ? "high" : fullTelemetrySamples.length >= 20 ? "medium" : "low",

package/dist/lib/marketContextPrepare.js

@@ -3257,6 +3257,8 @@ var import_async2 = require("@tradejs/core/async");
 var import_timescale3 = require("@tradejs/infra/timescale");
 var import_userSettings2 = require("@tradejs/infra/userSettings");
 var DAY_MS3 = 864e5;
+var DEFAULT_CONTEXT_MAX_AGE_MS = 48 * 60 * 6e4;
+var DEFAULT_FEAR_GREED_STALE_RETRY_MS = 60 * 6e4;
 var SOURCE_GLOBAL_DAILY = "coinmarketcap_global";
 var SOURCE_REFERENCE = "coinmarketcap_reference_asset";
 var SOURCE_EXCHANGE_LIQUIDITY = "coinmarketcap_exchange_liquidity";
@@ -3302,6 +3304,14 @@ var isExchangeLiquidityBackfillEnabled = () => parseEnabledFlag2(
 var isFearGreedBackfillEnabled = () => parseEnabledFlag2(process.env.COINMARKETCAP_CONTEXT_FEAR_GREED_ENABLED, true);
 var isVerboseRequestLoggingEnabled = () => parseEnabledFlag2(process.env.COINMARKETCAP_CONTEXT_VERBOSE_REQUESTS, false);
 var getFearGreedPageSize = () => asInt3(process.env.COINMARKETCAP_CONTEXT_FEAR_GREED_PAGE_SIZE, 500);
+var getContextMaxAgeMs = () => asInt3(
+  process.env.COINMARKETCAP_CONTEXT_MAX_AGE_MS,
+  DEFAULT_CONTEXT_MAX_AGE_MS
+);
+var getFearGreedStaleRetryMs = () => asInt3(
+  process.env.COINMARKETCAP_CONTEXT_FEAR_GREED_STALE_RETRY_MS,
+  DEFAULT_FEAR_GREED_STALE_RETRY_MS
+);
 var getExchangeSlugs = () => {
   const raw = process.env.COINMARKETCAP_CONTEXT_EXCHANGE_SLUGS;
   const values = String(raw ?? "").split(",").map((item) => item.trim().toLowerCase()).filter(Boolean);
@@ -3422,6 +3432,23 @@ var coverageRowsToKeySet = (rows) => new Set(
   )
 );
 var hasBackfillCoverage = (coverageKeys, params) => coverageKeys.has(coverageKey2(params));
+var hasRecentBackfillCoverage = (rows, params) => {
+  const key = coverageKey2(params);
+  return rows.some((row) => {
+    if (!isMarketContextBackfillCoverageDataBearing(row)) return false;
+    if (coverageKey2({
+      source: row.source,
+      scope: row.scope,
+      interval: row.interval,
+      fromMs: row.fromMs,
+      toMs: row.toMs
+    }) !== key) {
+      return false;
+    }
+    const checkedAtMs = Number(row.checkedAtMs);
+    return Number.isFinite(checkedAtMs) && Math.max(0, params.atMs - checkedAtMs) <= params.maxAgeMs;
+  });
+};
 var formatCoverageRange = (coverage) => {
   if (!coverage) return "coverage=none";
   return `coverage=${new Date(coverage.firstMs).toISOString()}..${new Date(
@@ -3949,13 +3976,24 @@ var backfillCoinMarketCapContext = async (params) => {
       toMs
     }
   );
-  const fearGreedBackfillCovered = hasBackfillCoverage(fearGreedBackfillKeys, {
+  const fearGreedBackfillParams = {
     source: SOURCE_FEAR_GREED,
     scope: COVERAGE_SCOPE_ALL,
     interval: "1d",
     fromMs,
     toMs
-  });
+  };
+  const fearGreedBackfillWasCovered = hasBackfillCoverage(
+    fearGreedBackfillKeys,
+    fearGreedBackfillParams
+  );
+  const fearGreedLatestAgeMs = fearGreedCoverage == null ? Number.POSITIVE_INFINITY : Math.max(0, params.endMs - fearGreedCoverage.lastMs);
+  const refreshStaleFearGreed = params.refreshStaleFearGreed === true && fearGreedLatestAgeMs > getContextMaxAgeMs();
+  const fearGreedBackfillCovered = fearGreedBackfillWasCovered && (!refreshStaleFearGreed || hasRecentBackfillCoverage(fearGreedBackfillCoverage, {
+    ...fearGreedBackfillParams,
+    atMs: params.endMs,
+    maxAgeMs: getFearGreedStaleRetryMs()
+  }));
   const indexesBackfillCovered = CMC_INDEXES.every(
     (index) => hasBackfillCoverage(indexBackfillKeys, {
       source: SOURCE_INDEX,
@@ -4272,7 +4310,7 @@ var backfillCoinMarketCapContext = async (params) => {
 };
 var backfillCoinMarketCapContextForBacktest = backfillCoinMarketCapContext;
 var backfillCoinMarketCapContextForReplay = backfillCoinMarketCapContext;
-var backfillCoinMarketCapContextForSignals = backfillCoinMarketCapContext;
+var backfillCoinMarketCapContextForSignals = (params) => backfillCoinMarketCapContext({ ...params, refreshStaleFearGreed: true });
 
 // src/lib/runFormatting.ts
 var import_date_fns = require("date-fns");

package/dist/lib/runEnvironment.js

@@ -2163,6 +2163,11 @@ var prepareRunEnvironment = async ({
       assetClasses
     })
   );
+  if (!loadedTickers.length) {
+    throw new Error(
+      `No tickers available for ${connectorName}. Check connector market-data access or select tickers explicitly.`
+    );
+  }
   if (showTickersList) {
     console.log(import_chalk3.default.gray(JSON.stringify(loadedTickers.sort(), null, 2)));
     return null;
@@ -2214,7 +2219,7 @@ var prepareRunEnvironment = async ({
       log: (message) => console.log(import_chalk3.default.gray(message))
     });
     const backtestExecutionInterval = resolveBacktestExecutionPreloadInterval(interval);
-    if (backtestExecutionInterval && String(backtestExecutionInterval) !== String(interval)) {
+    if (import_constants.BACKTEST_LOWER_TIMEFRAME_EXECUTION_ENABLED && backtestExecutionInterval && String(backtestExecutionInterval) !== String(interval)) {
       await timeOperation2(
         `update ${connectorName} execution`,
         () => (0, import_cli3.update)(

package/dist/scripts/backtest.js

@@ -3318,6 +3318,8 @@ var import_async2 = require("@tradejs/core/async");
 var import_timescale3 = require("@tradejs/infra/timescale");
 var import_userSettings2 = require("@tradejs/infra/userSettings");
 var DAY_MS3 = 864e5;
+var DEFAULT_CONTEXT_MAX_AGE_MS = 48 * 60 * 6e4;
+var DEFAULT_FEAR_GREED_STALE_RETRY_MS = 60 * 6e4;
 var SOURCE_GLOBAL_DAILY = "coinmarketcap_global";
 var SOURCE_REFERENCE = "coinmarketcap_reference_asset";
 var SOURCE_EXCHANGE_LIQUIDITY = "coinmarketcap_exchange_liquidity";
@@ -3363,6 +3365,14 @@ var isExchangeLiquidityBackfillEnabled = () => parseEnabledFlag2(
 var isFearGreedBackfillEnabled = () => parseEnabledFlag2(process.env.COINMARKETCAP_CONTEXT_FEAR_GREED_ENABLED, true);
 var isVerboseRequestLoggingEnabled = () => parseEnabledFlag2(process.env.COINMARKETCAP_CONTEXT_VERBOSE_REQUESTS, false);
 var getFearGreedPageSize = () => asInt3(process.env.COINMARKETCAP_CONTEXT_FEAR_GREED_PAGE_SIZE, 500);
+var getContextMaxAgeMs = () => asInt3(
+  process.env.COINMARKETCAP_CONTEXT_MAX_AGE_MS,
+  DEFAULT_CONTEXT_MAX_AGE_MS
+);
+var getFearGreedStaleRetryMs = () => asInt3(
+  process.env.COINMARKETCAP_CONTEXT_FEAR_GREED_STALE_RETRY_MS,
+  DEFAULT_FEAR_GREED_STALE_RETRY_MS
+);
 var getExchangeSlugs = () => {
   const raw = process.env.COINMARKETCAP_CONTEXT_EXCHANGE_SLUGS;
   const values = String(raw ?? "").split(",").map((item) => item.trim().toLowerCase()).filter(Boolean);
@@ -3483,6 +3493,23 @@ var coverageRowsToKeySet = (rows) => new Set(
   )
 );
 var hasBackfillCoverage = (coverageKeys, params) => coverageKeys.has(coverageKey2(params));
+var hasRecentBackfillCoverage = (rows, params) => {
+  const key = coverageKey2(params);
+  return rows.some((row) => {
+    if (!isMarketContextBackfillCoverageDataBearing(row)) return false;
+    if (coverageKey2({
+      source: row.source,
+      scope: row.scope,
+      interval: row.interval,
+      fromMs: row.fromMs,
+      toMs: row.toMs
+    }) !== key) {
+      return false;
+    }
+    const checkedAtMs = Number(row.checkedAtMs);
+    return Number.isFinite(checkedAtMs) && Math.max(0, params.atMs - checkedAtMs) <= params.maxAgeMs;
+  });
+};
 var formatCoverageRange = (coverage) => {
   if (!coverage) return "coverage=none";
   return `coverage=${new Date(coverage.firstMs).toISOString()}..${new Date(
@@ -4010,13 +4037,24 @@ var backfillCoinMarketCapContext = async (params) => {
       toMs
     }
   );
-  const fearGreedBackfillCovered = hasBackfillCoverage(fearGreedBackfillKeys, {
+  const fearGreedBackfillParams = {
     source: SOURCE_FEAR_GREED,
     scope: COVERAGE_SCOPE_ALL,
     interval: "1d",
     fromMs,
     toMs
-  });
+  };
+  const fearGreedBackfillWasCovered = hasBackfillCoverage(
+    fearGreedBackfillKeys,
+    fearGreedBackfillParams
+  );
+  const fearGreedLatestAgeMs = fearGreedCoverage == null ? Number.POSITIVE_INFINITY : Math.max(0, params.endMs - fearGreedCoverage.lastMs);
+  const refreshStaleFearGreed = params.refreshStaleFearGreed === true && fearGreedLatestAgeMs > getContextMaxAgeMs();
+  const fearGreedBackfillCovered = fearGreedBackfillWasCovered && (!refreshStaleFearGreed || hasRecentBackfillCoverage(fearGreedBackfillCoverage, {
+    ...fearGreedBackfillParams,
+    atMs: params.endMs,
+    maxAgeMs: getFearGreedStaleRetryMs()
+  }));
   const indexesBackfillCovered = CMC_INDEXES.every(
     (index) => hasBackfillCoverage(indexBackfillKeys, {
       source: SOURCE_INDEX,
@@ -4333,7 +4371,7 @@ var backfillCoinMarketCapContext = async (params) => {
 };
 var backfillCoinMarketCapContextForBacktest = backfillCoinMarketCapContext;
 var backfillCoinMarketCapContextForReplay = backfillCoinMarketCapContext;
-var backfillCoinMarketCapContextForSignals = backfillCoinMarketCapContext;
+var backfillCoinMarketCapContextForSignals = (params) => backfillCoinMarketCapContext({ ...params, refreshStaleFearGreed: true });
 
 // src/lib/marketContextPrepare.ts
 var shouldPrepareDerivativesContextForRun = (params) => {
@@ -4936,6 +4974,11 @@ var prepareRunEnvironment = async ({
       assetClasses
     })
   );
+  if (!loadedTickers.length) {
+    throw new Error(
+      `No tickers available for ${connectorName}. Check connector market-data access or select tickers explicitly.`
+    );
+  }
   if (showTickersList) {
     console.log(import_chalk7.default.gray(JSON.stringify(loadedTickers.sort(), null, 2)));
     return null;
@@ -4987,7 +5030,7 @@ var prepareRunEnvironment = async ({
       log: (message) => console.log(import_chalk7.default.gray(message))
     });
     const backtestExecutionInterval = resolveBacktestExecutionPreloadInterval(interval2);
-    if (backtestExecutionInterval && String(backtestExecutionInterval) !== String(interval2)) {
+    if (import_constants2.BACKTEST_LOWER_TIMEFRAME_EXECUTION_ENABLED && backtestExecutionInterval && String(backtestExecutionInterval) !== String(interval2)) {
       await timeOperation2(
         `update ${connectorName} execution`,
         () => (0, import_cli3.update)(
@@ -5936,12 +5979,9 @@ var buildPreparedTestSuite = async ({
     Number.isFinite(requestedTestsLimit) ? testsSkip + requestedTestsLimit : void 0
   );
   if (!preparedSuite.length) {
-    console.log(
-      import_chalk9.default.yellow(
-        `No tests selected (skip=${testsSkip}, limit=${Number.isFinite(requestedTestsLimit) ? requestedTestsLimit : "all"}).`
-      )
+    throw new Error(
+      `No backtest tests selected (available=${testSuite.length}, skip=${testsSkip}, limit=${Number.isFinite(requestedTestsLimit) ? requestedTestsLimit : "all"}).`
     );
-    return null;
   }
   await prepareMarketContextForRun({
     mode: "backtest",

package/dist/scripts/executionCalibration.js

@@ -636,7 +636,7 @@ var buildRecommendation = (samples) => {
     );
   }
   notes.push(
-    "Delay risk bps is disabled; signal-to-arrival latency is modeled by delayed lower-timeframe backtest fills."
+    "Delay risk bps is disabled; signal-to-arrival latency is modeled by next-bar-open backtest fills."
   );
   return {
     confidence: fullTelemetrySamples.length >= 50 ? "high" : fullTelemetrySamples.length >= 20 ? "medium" : "low",

package/dist/scripts/infraCommon.js

@@ -60,13 +60,12 @@ var resolveProjectRoot = () => {
 var DEV_COMPOSE_TEMPLATE = `services:
   timescale:
     image: timescale/timescaledb:latest-pg16
-    container_name: tradejs-timescale
     environment:
       POSTGRES_USER: \${PG_USER:-app}
       POSTGRES_PASSWORD: \${PG_PASSWORD:-app}
       POSTGRES_DB: \${PG_DB:-app}
     ports:
-      - "5432:5432"
+      - "\${PG_PORT:-5432}:5432"
     command:
       - postgres
       - -c
@@ -86,14 +85,18 @@ var DEV_COMPOSE_TEMPLATE = `services:
 
   redis:
     image: redis/redis-stack:latest
-    container_name: tradejs-redis
     environment:
       REDIS_ARGS: --save "" --appendonly no --stop-writes-on-bgsave-error no
     ports:
-      - "6379:6379"
-      - "5540:8001"
+      - "\${REDIS_PORT:-6379}:6379"
+      - "\${REDIS_INSIGHT_PORT:-5540}:8001"
     volumes:
       - tradejs_redisdata:/data
+    healthcheck:
+      test: ["CMD", "redis-cli", "ping"]
+      interval: 5s
+      timeout: 3s
+      retries: 10
     restart: unless-stopped
 
 volumes:

package/dist/scripts/infraInit.js

@@ -60,13 +60,12 @@ var resolveProjectRoot = () => {
 var DEV_COMPOSE_TEMPLATE = `services:
   timescale:
     image: timescale/timescaledb:latest-pg16
-    container_name: tradejs-timescale
     environment:
       POSTGRES_USER: \${PG_USER:-app}
       POSTGRES_PASSWORD: \${PG_PASSWORD:-app}
       POSTGRES_DB: \${PG_DB:-app}
     ports:
-      - "5432:5432"
+      - "\${PG_PORT:-5432}:5432"
     command:
       - postgres
       - -c
@@ -86,14 +85,18 @@ var DEV_COMPOSE_TEMPLATE = `services:
 
   redis:
     image: redis/redis-stack:latest
-    container_name: tradejs-redis
     environment:
       REDIS_ARGS: --save "" --appendonly no --stop-writes-on-bgsave-error no
     ports:
-      - "6379:6379"
-      - "5540:8001"
+      - "\${REDIS_PORT:-6379}:6379"
+      - "\${REDIS_INSIGHT_PORT:-5540}:8001"
     volumes:
       - tradejs_redisdata:/data
+    healthcheck:
+      test: ["CMD", "redis-cli", "ping"]
+      interval: 5s
+      timeout: 3s
+      retries: 10
     restart: unless-stopped
 
 volumes:

package/dist/scripts/infraUp.js

@@ -83,8 +83,16 @@ var runDockerCompose = (composePath, args) => {
 var main = async () => {
   const composePath = requireDevComposeFile();
   console.log(import_chalk2.default.cyan("Starting dev infra (timescale, redis)..."));
-  runDockerCompose(composePath, ["up", "-d", "timescale", "redis"]);
-  console.log(import_chalk2.default.green("Dev infra is up."));
+  runDockerCompose(composePath, [
+    "up",
+    "-d",
+    "--wait",
+    "--wait-timeout",
+    "120",
+    "timescale",
+    "redis"
+  ]);
+  console.log(import_chalk2.default.green("Dev infra is ready."));
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/scripts/replay.js

@@ -2217,6 +2217,11 @@ var prepareRunEnvironment = async ({
       assetClasses
     })
   );
+  if (!loadedTickers.length) {
+    throw new Error(
+      `No tickers available for ${connectorName}. Check connector market-data access or select tickers explicitly.`
+    );
+  }
   if (showTickersList) {
     console.log(import_chalk3.default.gray(JSON.stringify(loadedTickers.sort(), null, 2)));
     return null;
@@ -2268,7 +2273,7 @@ var prepareRunEnvironment = async ({
       log: (message) => console.log(import_chalk3.default.gray(message))
     });
     const backtestExecutionInterval = resolveBacktestExecutionPreloadInterval(interval);
-    if (backtestExecutionInterval && String(backtestExecutionInterval) !== String(interval)) {
+    if (import_constants.BACKTEST_LOWER_TIMEFRAME_EXECUTION_ENABLED && backtestExecutionInterval && String(backtestExecutionInterval) !== String(interval)) {
       await timeOperation2(
         `update ${connectorName} execution`,
         () => (0, import_cli3.update)(
@@ -3924,6 +3929,8 @@ var import_async2 = require("@tradejs/core/async");
 var import_timescale3 = require("@tradejs/infra/timescale");
 var import_userSettings2 = require("@tradejs/infra/userSettings");
 var DAY_MS3 = 864e5;
+var DEFAULT_CONTEXT_MAX_AGE_MS = 48 * 60 * 6e4;
+var DEFAULT_FEAR_GREED_STALE_RETRY_MS = 60 * 6e4;
 var SOURCE_GLOBAL_DAILY = "coinmarketcap_global";
 var SOURCE_REFERENCE = "coinmarketcap_reference_asset";
 var SOURCE_EXCHANGE_LIQUIDITY = "coinmarketcap_exchange_liquidity";
@@ -3969,6 +3976,14 @@ var isExchangeLiquidityBackfillEnabled = () => parseEnabledFlag2(
 var isFearGreedBackfillEnabled = () => parseEnabledFlag2(process.env.COINMARKETCAP_CONTEXT_FEAR_GREED_ENABLED, true);
 var isVerboseRequestLoggingEnabled = () => parseEnabledFlag2(process.env.COINMARKETCAP_CONTEXT_VERBOSE_REQUESTS, false);
 var getFearGreedPageSize = () => asInt3(process.env.COINMARKETCAP_CONTEXT_FEAR_GREED_PAGE_SIZE, 500);
+var getContextMaxAgeMs = () => asInt3(
+  process.env.COINMARKETCAP_CONTEXT_MAX_AGE_MS,
+  DEFAULT_CONTEXT_MAX_AGE_MS
+);
+var getFearGreedStaleRetryMs = () => asInt3(
+  process.env.COINMARKETCAP_CONTEXT_FEAR_GREED_STALE_RETRY_MS,
+  DEFAULT_FEAR_GREED_STALE_RETRY_MS
+);
 var getExchangeSlugs = () => {
   const raw = process.env.COINMARKETCAP_CONTEXT_EXCHANGE_SLUGS;
   const values = String(raw ?? "").split(",").map((item) => item.trim().toLowerCase()).filter(Boolean);
@@ -4089,6 +4104,23 @@ var coverageRowsToKeySet = (rows) => new Set(
   )
 );
 var hasBackfillCoverage = (coverageKeys, params) => coverageKeys.has(coverageKey2(params));
+var hasRecentBackfillCoverage = (rows, params) => {
+  const key = coverageKey2(params);
+  return rows.some((row) => {
+    if (!isMarketContextBackfillCoverageDataBearing(row)) return false;
+    if (coverageKey2({
+      source: row.source,
+      scope: row.scope,
+      interval: row.interval,
+      fromMs: row.fromMs,
+      toMs: row.toMs
+    }) !== key) {
+      return false;
+    }
+    const checkedAtMs = Number(row.checkedAtMs);
+    return Number.isFinite(checkedAtMs) && Math.max(0, params.atMs - checkedAtMs) <= params.maxAgeMs;
+  });
+};
 var formatCoverageRange = (coverage) => {
   if (!coverage) return "coverage=none";
   return `coverage=${new Date(coverage.firstMs).toISOString()}..${new Date(
@@ -4616,13 +4648,24 @@ var backfillCoinMarketCapContext = async (params) => {
       toMs
     }
   );
-  const fearGreedBackfillCovered = hasBackfillCoverage(fearGreedBackfillKeys, {
+  const fearGreedBackfillParams = {
     source: SOURCE_FEAR_GREED,
     scope: COVERAGE_SCOPE_ALL,
     interval: "1d",
     fromMs,
     toMs
-  });
+  };
+  const fearGreedBackfillWasCovered = hasBackfillCoverage(
+    fearGreedBackfillKeys,
+    fearGreedBackfillParams
+  );
+  const fearGreedLatestAgeMs = fearGreedCoverage == null ? Number.POSITIVE_INFINITY : Math.max(0, params.endMs - fearGreedCoverage.lastMs);
+  const refreshStaleFearGreed = params.refreshStaleFearGreed === true && fearGreedLatestAgeMs > getContextMaxAgeMs();
+  const fearGreedBackfillCovered = fearGreedBackfillWasCovered && (!refreshStaleFearGreed || hasRecentBackfillCoverage(fearGreedBackfillCoverage, {
+    ...fearGreedBackfillParams,
+    atMs: params.endMs,
+    maxAgeMs: getFearGreedStaleRetryMs()
+  }));
   const indexesBackfillCovered = CMC_INDEXES.every(
     (index) => hasBackfillCoverage(indexBackfillKeys, {
       source: SOURCE_INDEX,
@@ -4939,7 +4982,7 @@ var backfillCoinMarketCapContext = async (params) => {
 };
 var backfillCoinMarketCapContextForBacktest = backfillCoinMarketCapContext;
 var backfillCoinMarketCapContextForReplay = backfillCoinMarketCapContext;
-var backfillCoinMarketCapContextForSignals = backfillCoinMarketCapContext;
+var backfillCoinMarketCapContextForSignals = (params) => backfillCoinMarketCapContext({ ...params, refreshStaleFearGreed: true });
 
 // src/lib/marketContextPrepare.ts
 var shouldPrepareDerivativesContextForRun = (params) => {

package/dist/scripts/replayRunner.js

@@ -2220,6 +2220,11 @@ var prepareRunEnvironment = async ({
       assetClasses
     })
   );
+  if (!loadedTickers.length) {
+    throw new Error(
+      `No tickers available for ${connectorName}. Check connector market-data access or select tickers explicitly.`
+    );
+  }
   if (showTickersList) {
     console.log(import_chalk3.default.gray(JSON.stringify(loadedTickers.sort(), null, 2)));
     return null;
@@ -2271,7 +2276,7 @@ var prepareRunEnvironment = async ({
       log: (message) => console.log(import_chalk3.default.gray(message))
     });
     const backtestExecutionInterval = resolveBacktestExecutionPreloadInterval(interval);
-    if (backtestExecutionInterval && String(backtestExecutionInterval) !== String(interval)) {
+    if (import_constants.BACKTEST_LOWER_TIMEFRAME_EXECUTION_ENABLED && backtestExecutionInterval && String(backtestExecutionInterval) !== String(interval)) {
       await timeOperation2(
         `update ${connectorName} execution`,
         () => (0, import_cli3.update)(
@@ -3927,6 +3932,8 @@ var import_async2 = require("@tradejs/core/async");
 var import_timescale3 = require("@tradejs/infra/timescale");
 var import_userSettings2 = require("@tradejs/infra/userSettings");
 var DAY_MS3 = 864e5;
+var DEFAULT_CONTEXT_MAX_AGE_MS = 48 * 60 * 6e4;
+var DEFAULT_FEAR_GREED_STALE_RETRY_MS = 60 * 6e4;
 var SOURCE_GLOBAL_DAILY = "coinmarketcap_global";
 var SOURCE_REFERENCE = "coinmarketcap_reference_asset";
 var SOURCE_EXCHANGE_LIQUIDITY = "coinmarketcap_exchange_liquidity";
@@ -3972,6 +3979,14 @@ var isExchangeLiquidityBackfillEnabled = () => parseEnabledFlag2(
 var isFearGreedBackfillEnabled = () => parseEnabledFlag2(process.env.COINMARKETCAP_CONTEXT_FEAR_GREED_ENABLED, true);
 var isVerboseRequestLoggingEnabled = () => parseEnabledFlag2(process.env.COINMARKETCAP_CONTEXT_VERBOSE_REQUESTS, false);
 var getFearGreedPageSize = () => asInt3(process.env.COINMARKETCAP_CONTEXT_FEAR_GREED_PAGE_SIZE, 500);
+var getContextMaxAgeMs = () => asInt3(
+  process.env.COINMARKETCAP_CONTEXT_MAX_AGE_MS,
+  DEFAULT_CONTEXT_MAX_AGE_MS
+);
+var getFearGreedStaleRetryMs = () => asInt3(
+  process.env.COINMARKETCAP_CONTEXT_FEAR_GREED_STALE_RETRY_MS,
+  DEFAULT_FEAR_GREED_STALE_RETRY_MS
+);
 var getExchangeSlugs = () => {
   const raw = process.env.COINMARKETCAP_CONTEXT_EXCHANGE_SLUGS;
   const values = String(raw ?? "").split(",").map((item) => item.trim().toLowerCase()).filter(Boolean);
@@ -4092,6 +4107,23 @@ var coverageRowsToKeySet = (rows) => new Set(
   )
 );
 var hasBackfillCoverage = (coverageKeys, params) => coverageKeys.has(coverageKey2(params));
+var hasRecentBackfillCoverage = (rows, params) => {
+  const key = coverageKey2(params);
+  return rows.some((row) => {
+    if (!isMarketContextBackfillCoverageDataBearing(row)) return false;
+    if (coverageKey2({
+      source: row.source,
+      scope: row.scope,
+      interval: row.interval,
+      fromMs: row.fromMs,
+      toMs: row.toMs
+    }) !== key) {
+      return false;
+    }
+    const checkedAtMs = Number(row.checkedAtMs);
+    return Number.isFinite(checkedAtMs) && Math.max(0, params.atMs - checkedAtMs) <= params.maxAgeMs;
+  });
+};
 var formatCoverageRange = (coverage) => {
   if (!coverage) return "coverage=none";
   return `coverage=${new Date(coverage.firstMs).toISOString()}..${new Date(
@@ -4619,13 +4651,24 @@ var backfillCoinMarketCapContext = async (params) => {
       toMs
     }
   );
-  const fearGreedBackfillCovered = hasBackfillCoverage(fearGreedBackfillKeys, {
+  const fearGreedBackfillParams = {
     source: SOURCE_FEAR_GREED,
     scope: COVERAGE_SCOPE_ALL,
     interval: "1d",
     fromMs,
     toMs
-  });
+  };
+  const fearGreedBackfillWasCovered = hasBackfillCoverage(
+    fearGreedBackfillKeys,
+    fearGreedBackfillParams
+  );
+  const fearGreedLatestAgeMs = fearGreedCoverage == null ? Number.POSITIVE_INFINITY : Math.max(0, params.endMs - fearGreedCoverage.lastMs);
+  const refreshStaleFearGreed = params.refreshStaleFearGreed === true && fearGreedLatestAgeMs > getContextMaxAgeMs();
+  const fearGreedBackfillCovered = fearGreedBackfillWasCovered && (!refreshStaleFearGreed || hasRecentBackfillCoverage(fearGreedBackfillCoverage, {
+    ...fearGreedBackfillParams,
+    atMs: params.endMs,
+    maxAgeMs: getFearGreedStaleRetryMs()
+  }));
   const indexesBackfillCovered = CMC_INDEXES.every(
     (index) => hasBackfillCoverage(indexBackfillKeys, {
       source: SOURCE_INDEX,
@@ -4942,7 +4985,7 @@ var backfillCoinMarketCapContext = async (params) => {
 };
 var backfillCoinMarketCapContextForBacktest = backfillCoinMarketCapContext;
 var backfillCoinMarketCapContextForReplay = backfillCoinMarketCapContext;
-var backfillCoinMarketCapContextForSignals = backfillCoinMarketCapContext;
+var backfillCoinMarketCapContextForSignals = (params) => backfillCoinMarketCapContext({ ...params, refreshStaleFearGreed: true });
 
 // src/lib/marketContextPrepare.ts
 var shouldPrepareDerivativesContextForRun = (params) => {

package/dist/scripts/runtimeParity.js

@@ -3937,6 +3937,8 @@ var import_async2 = require("@tradejs/core/async");
 var import_timescale3 = require("@tradejs/infra/timescale");
 var import_userSettings2 = require("@tradejs/infra/userSettings");
 var DAY_MS3 = 864e5;
+var DEFAULT_CONTEXT_MAX_AGE_MS = 48 * 60 * 6e4;
+var DEFAULT_FEAR_GREED_STALE_RETRY_MS = 60 * 6e4;
 var SOURCE_GLOBAL_DAILY = "coinmarketcap_global";
 var SOURCE_REFERENCE = "coinmarketcap_reference_asset";
 var SOURCE_EXCHANGE_LIQUIDITY = "coinmarketcap_exchange_liquidity";
@@ -3982,6 +3984,14 @@ var isExchangeLiquidityBackfillEnabled = () => parseEnabledFlag2(
 var isFearGreedBackfillEnabled = () => parseEnabledFlag2(process.env.COINMARKETCAP_CONTEXT_FEAR_GREED_ENABLED, true);
 var isVerboseRequestLoggingEnabled = () => parseEnabledFlag2(process.env.COINMARKETCAP_CONTEXT_VERBOSE_REQUESTS, false);
 var getFearGreedPageSize = () => asInt3(process.env.COINMARKETCAP_CONTEXT_FEAR_GREED_PAGE_SIZE, 500);
+var getContextMaxAgeMs = () => asInt3(
+  process.env.COINMARKETCAP_CONTEXT_MAX_AGE_MS,
+  DEFAULT_CONTEXT_MAX_AGE_MS
+);
+var getFearGreedStaleRetryMs = () => asInt3(
+  process.env.COINMARKETCAP_CONTEXT_FEAR_GREED_STALE_RETRY_MS,
+  DEFAULT_FEAR_GREED_STALE_RETRY_MS
+);
 var getExchangeSlugs = () => {
   const raw = process.env.COINMARKETCAP_CONTEXT_EXCHANGE_SLUGS;
   const values = String(raw ?? "").split(",").map((item) => item.trim().toLowerCase()).filter(Boolean);
@@ -4102,6 +4112,23 @@ var coverageRowsToKeySet = (rows) => new Set(
   )
 );
 var hasBackfillCoverage = (coverageKeys, params) => coverageKeys.has(coverageKey2(params));
+var hasRecentBackfillCoverage = (rows, params) => {
+  const key = coverageKey2(params);
+  return rows.some((row) => {
+    if (!isMarketContextBackfillCoverageDataBearing(row)) return false;
+    if (coverageKey2({
+      source: row.source,
+      scope: row.scope,
+      interval: row.interval,
+      fromMs: row.fromMs,
+      toMs: row.toMs
+    }) !== key) {
+      return false;
+    }
+    const checkedAtMs = Number(row.checkedAtMs);
+    return Number.isFinite(checkedAtMs) && Math.max(0, params.atMs - checkedAtMs) <= params.maxAgeMs;
+  });
+};
 var formatCoverageRange = (coverage) => {
   if (!coverage) return "coverage=none";
   return `coverage=${new Date(coverage.firstMs).toISOString()}..${new Date(
@@ -4629,13 +4656,24 @@ var backfillCoinMarketCapContext = async (params) => {
       toMs
     }
   );
-  const fearGreedBackfillCovered = hasBackfillCoverage(fearGreedBackfillKeys, {
+  const fearGreedBackfillParams = {
     source: SOURCE_FEAR_GREED,
     scope: COVERAGE_SCOPE_ALL,
     interval: "1d",
     fromMs,
     toMs
-  });
+  };
+  const fearGreedBackfillWasCovered = hasBackfillCoverage(
+    fearGreedBackfillKeys,
+    fearGreedBackfillParams
+  );
+  const fearGreedLatestAgeMs = fearGreedCoverage == null ? Number.POSITIVE_INFINITY : Math.max(0, params.endMs - fearGreedCoverage.lastMs);
+  const refreshStaleFearGreed = params.refreshStaleFearGreed === true && fearGreedLatestAgeMs > getContextMaxAgeMs();
+  const fearGreedBackfillCovered = fearGreedBackfillWasCovered && (!refreshStaleFearGreed || hasRecentBackfillCoverage(fearGreedBackfillCoverage, {
+    ...fearGreedBackfillParams,
+    atMs: params.endMs,
+    maxAgeMs: getFearGreedStaleRetryMs()
+  }));
   const indexesBackfillCovered = CMC_INDEXES.every(
     (index) => hasBackfillCoverage(indexBackfillKeys, {
       source: SOURCE_INDEX,
@@ -4952,7 +4990,7 @@ var backfillCoinMarketCapContext = async (params) => {
 };
 var backfillCoinMarketCapContextForBacktest = backfillCoinMarketCapContext;
 var backfillCoinMarketCapContextForReplay = backfillCoinMarketCapContext;
-var backfillCoinMarketCapContextForSignals = backfillCoinMarketCapContext;
+var backfillCoinMarketCapContextForSignals = (params) => backfillCoinMarketCapContext({ ...params, refreshStaleFearGreed: true });
 
 // src/lib/marketContextPrepare.ts
 var shouldPrepareDerivativesContextForRun = (params) => {

package/dist/scripts/signals.js

@@ -3433,6 +3433,8 @@ var import_async2 = require("@tradejs/core/async");
 var import_timescale3 = require("@tradejs/infra/timescale");
 var import_userSettings2 = require("@tradejs/infra/userSettings");
 var DAY_MS3 = 864e5;
+var DEFAULT_CONTEXT_MAX_AGE_MS = 48 * 60 * 6e4;
+var DEFAULT_FEAR_GREED_STALE_RETRY_MS = 60 * 6e4;
 var SOURCE_GLOBAL_DAILY = "coinmarketcap_global";
 var SOURCE_REFERENCE = "coinmarketcap_reference_asset";
 var SOURCE_EXCHANGE_LIQUIDITY = "coinmarketcap_exchange_liquidity";
@@ -3478,6 +3480,14 @@ var isExchangeLiquidityBackfillEnabled = () => parseEnabledFlag2(
 var isFearGreedBackfillEnabled = () => parseEnabledFlag2(process.env.COINMARKETCAP_CONTEXT_FEAR_GREED_ENABLED, true);
 var isVerboseRequestLoggingEnabled = () => parseEnabledFlag2(process.env.COINMARKETCAP_CONTEXT_VERBOSE_REQUESTS, false);
 var getFearGreedPageSize = () => asInt3(process.env.COINMARKETCAP_CONTEXT_FEAR_GREED_PAGE_SIZE, 500);
+var getContextMaxAgeMs = () => asInt3(
+  process.env.COINMARKETCAP_CONTEXT_MAX_AGE_MS,
+  DEFAULT_CONTEXT_MAX_AGE_MS
+);
+var getFearGreedStaleRetryMs = () => asInt3(
+  process.env.COINMARKETCAP_CONTEXT_FEAR_GREED_STALE_RETRY_MS,
+  DEFAULT_FEAR_GREED_STALE_RETRY_MS
+);
 var getExchangeSlugs = () => {
   const raw = process.env.COINMARKETCAP_CONTEXT_EXCHANGE_SLUGS;
   const values = String(raw ?? "").split(",").map((item) => item.trim().toLowerCase()).filter(Boolean);
@@ -3598,6 +3608,23 @@ var coverageRowsToKeySet = (rows) => new Set(
   )
 );
 var hasBackfillCoverage = (coverageKeys, params) => coverageKeys.has(coverageKey2(params));
+var hasRecentBackfillCoverage = (rows, params) => {
+  const key = coverageKey2(params);
+  return rows.some((row) => {
+    if (!isMarketContextBackfillCoverageDataBearing(row)) return false;
+    if (coverageKey2({
+      source: row.source,
+      scope: row.scope,
+      interval: row.interval,
+      fromMs: row.fromMs,
+      toMs: row.toMs
+    }) !== key) {
+      return false;
+    }
+    const checkedAtMs = Number(row.checkedAtMs);
+    return Number.isFinite(checkedAtMs) && Math.max(0, params.atMs - checkedAtMs) <= params.maxAgeMs;
+  });
+};
 var formatCoverageRange = (coverage) => {
   if (!coverage) return "coverage=none";
   return `coverage=${new Date(coverage.firstMs).toISOString()}..${new Date(
@@ -4125,13 +4152,24 @@ var backfillCoinMarketCapContext = async (params) => {
       toMs
     }
   );
-  const fearGreedBackfillCovered = hasBackfillCoverage(fearGreedBackfillKeys, {
+  const fearGreedBackfillParams = {
     source: SOURCE_FEAR_GREED,
     scope: COVERAGE_SCOPE_ALL,
     interval: "1d",
     fromMs,
     toMs
-  });
+  };
+  const fearGreedBackfillWasCovered = hasBackfillCoverage(
+    fearGreedBackfillKeys,
+    fearGreedBackfillParams
+  );
+  const fearGreedLatestAgeMs = fearGreedCoverage == null ? Number.POSITIVE_INFINITY : Math.max(0, params.endMs - fearGreedCoverage.lastMs);
+  const refreshStaleFearGreed = params.refreshStaleFearGreed === true && fearGreedLatestAgeMs > getContextMaxAgeMs();
+  const fearGreedBackfillCovered = fearGreedBackfillWasCovered && (!refreshStaleFearGreed || hasRecentBackfillCoverage(fearGreedBackfillCoverage, {
+    ...fearGreedBackfillParams,
+    atMs: params.endMs,
+    maxAgeMs: getFearGreedStaleRetryMs()
+  }));
   const indexesBackfillCovered = CMC_INDEXES.every(
     (index) => hasBackfillCoverage(indexBackfillKeys, {
       source: SOURCE_INDEX,
@@ -4448,7 +4486,7 @@ var backfillCoinMarketCapContext = async (params) => {
 };
 var backfillCoinMarketCapContextForBacktest = backfillCoinMarketCapContext;
 var backfillCoinMarketCapContextForReplay = backfillCoinMarketCapContext;
-var backfillCoinMarketCapContextForSignals = backfillCoinMarketCapContext;
+var backfillCoinMarketCapContextForSignals = (params) => backfillCoinMarketCapContext({ ...params, refreshStaleFearGreed: true });
 
 // src/lib/marketContextPrepare.ts
 var shouldPrepareDerivativesContextForRun = (params) => {

package/dist/scripts/signalsDaemon.js

@@ -3431,6 +3431,8 @@ var import_async2 = require("@tradejs/core/async");
 var import_timescale3 = require("@tradejs/infra/timescale");
 var import_userSettings2 = require("@tradejs/infra/userSettings");
 var DAY_MS3 = 864e5;
+var DEFAULT_CONTEXT_MAX_AGE_MS = 48 * 60 * 6e4;
+var DEFAULT_FEAR_GREED_STALE_RETRY_MS = 60 * 6e4;
 var SOURCE_GLOBAL_DAILY = "coinmarketcap_global";
 var SOURCE_REFERENCE = "coinmarketcap_reference_asset";
 var SOURCE_EXCHANGE_LIQUIDITY = "coinmarketcap_exchange_liquidity";
@@ -3476,6 +3478,14 @@ var isExchangeLiquidityBackfillEnabled = () => parseEnabledFlag2(
 var isFearGreedBackfillEnabled = () => parseEnabledFlag2(process.env.COINMARKETCAP_CONTEXT_FEAR_GREED_ENABLED, true);
 var isVerboseRequestLoggingEnabled = () => parseEnabledFlag2(process.env.COINMARKETCAP_CONTEXT_VERBOSE_REQUESTS, false);
 var getFearGreedPageSize = () => asInt3(process.env.COINMARKETCAP_CONTEXT_FEAR_GREED_PAGE_SIZE, 500);
+var getContextMaxAgeMs = () => asInt3(
+  process.env.COINMARKETCAP_CONTEXT_MAX_AGE_MS,
+  DEFAULT_CONTEXT_MAX_AGE_MS
+);
+var getFearGreedStaleRetryMs = () => asInt3(
+  process.env.COINMARKETCAP_CONTEXT_FEAR_GREED_STALE_RETRY_MS,
+  DEFAULT_FEAR_GREED_STALE_RETRY_MS
+);
 var getExchangeSlugs = () => {
   const raw = process.env.COINMARKETCAP_CONTEXT_EXCHANGE_SLUGS;
   const values = String(raw ?? "").split(",").map((item) => item.trim().toLowerCase()).filter(Boolean);
@@ -3596,6 +3606,23 @@ var coverageRowsToKeySet = (rows) => new Set(
   )
 );
 var hasBackfillCoverage = (coverageKeys, params) => coverageKeys.has(coverageKey2(params));
+var hasRecentBackfillCoverage = (rows, params) => {
+  const key = coverageKey2(params);
+  return rows.some((row) => {
+    if (!isMarketContextBackfillCoverageDataBearing(row)) return false;
+    if (coverageKey2({
+      source: row.source,
+      scope: row.scope,
+      interval: row.interval,
+      fromMs: row.fromMs,
+      toMs: row.toMs
+    }) !== key) {
+      return false;
+    }
+    const checkedAtMs = Number(row.checkedAtMs);
+    return Number.isFinite(checkedAtMs) && Math.max(0, params.atMs - checkedAtMs) <= params.maxAgeMs;
+  });
+};
 var formatCoverageRange = (coverage) => {
   if (!coverage) return "coverage=none";
   return `coverage=${new Date(coverage.firstMs).toISOString()}..${new Date(
@@ -4123,13 +4150,24 @@ var backfillCoinMarketCapContext = async (params) => {
       toMs
     }
   );
-  const fearGreedBackfillCovered = hasBackfillCoverage(fearGreedBackfillKeys, {
+  const fearGreedBackfillParams = {
     source: SOURCE_FEAR_GREED,
     scope: COVERAGE_SCOPE_ALL,
     interval: "1d",
     fromMs,
     toMs
-  });
+  };
+  const fearGreedBackfillWasCovered = hasBackfillCoverage(
+    fearGreedBackfillKeys,
+    fearGreedBackfillParams
+  );
+  const fearGreedLatestAgeMs = fearGreedCoverage == null ? Number.POSITIVE_INFINITY : Math.max(0, params.endMs - fearGreedCoverage.lastMs);
+  const refreshStaleFearGreed = params.refreshStaleFearGreed === true && fearGreedLatestAgeMs > getContextMaxAgeMs();
+  const fearGreedBackfillCovered = fearGreedBackfillWasCovered && (!refreshStaleFearGreed || hasRecentBackfillCoverage(fearGreedBackfillCoverage, {
+    ...fearGreedBackfillParams,
+    atMs: params.endMs,
+    maxAgeMs: getFearGreedStaleRetryMs()
+  }));
   const indexesBackfillCovered = CMC_INDEXES.every(
     (index) => hasBackfillCoverage(indexBackfillKeys, {
       source: SOURCE_INDEX,
@@ -4446,7 +4484,7 @@ var backfillCoinMarketCapContext = async (params) => {
 };
 var backfillCoinMarketCapContextForBacktest = backfillCoinMarketCapContext;
 var backfillCoinMarketCapContextForReplay = backfillCoinMarketCapContext;
-var backfillCoinMarketCapContextForSignals = backfillCoinMarketCapContext;
+var backfillCoinMarketCapContextForSignals = (params) => backfillCoinMarketCapContext({ ...params, refreshStaleFearGreed: true });
 
 // src/lib/marketContextPrepare.ts
 var shouldPrepareDerivativesContextForRun = (params) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tradejs/cli",
-  "version": "1.0.10",
+  "version": "1.0.11",
   "description": "Official CLI for the TradeJS open-source framework: infra setup, backtests, signals, bots, and ML workflows.",
   "keywords": [
     "tradejs",
@@ -29,14 +29,14 @@
     "tradejs": "dist/cli.js"
   },
   "dependencies": {
-    "@tradejs/base": "^1.0.10",
-    "@tradejs/connectors": "^1.0.10",
-    "@tradejs/core": "^1.0.10",
-    "@tradejs/indicators": "^1.0.10",
-    "@tradejs/infra": "^1.0.10",
-    "@tradejs/node": "^1.0.10",
-    "@tradejs/strategies": "^1.0.10",
-    "@tradejs/types": "^1.0.10",
+    "@tradejs/base": "^1.0.11",
+    "@tradejs/connectors": "^1.0.11",
+    "@tradejs/core": "^1.0.11",
+    "@tradejs/indicators": "^1.0.11",
+    "@tradejs/infra": "^1.0.11",
+    "@tradejs/node": "^1.0.11",
+    "@tradejs/strategies": "^1.0.11",
+    "@tradejs/types": "^1.0.11",
     "args": "^5.0.3",
     "bcryptjs": "^2.4.3",
     "chalk": "4.1.2",