@tradejs/node 3.1.29-beta.288 → 3.1.29-beta.290

package/dist/mcp.js

@@ -781,6 +781,7 @@ __export(mcp_exports, {
   McpCursorError: () => McpCursorError,
   cancelMcpJob: () => cancelMcpJob,
   enqueueMcpJob: () => enqueueMcpJob,
+  formatMcpArtifactLogLine: () => formatMcpArtifactLogLine,
   isMcpRecord: () => isMcpRecord,
   mcpId: () => mcpId,
   mcpJobDirectory: () => mcpJobDirectory,
@@ -1066,13 +1067,210 @@ var assessSignalWithJev = async ({
 // src/strategyRuntime.ts
 var import_constants5 = require("@tradejs/core/constants");
 var import_strategies6 = require("@tradejs/core/strategies");
-var import_logger10 = require("@tradejs/infra/logger");
+var import_logger11 = require("@tradejs/infra/logger");
 
 // src/strategyHelpers/runtime.ts
-var import_logger8 = require("@tradejs/infra/logger");
+var import_logger9 = require("@tradejs/infra/logger");
 var import_constants3 = require("@tradejs/core/constants");
 var import_ml2 = require("@tradejs/infra/ml");
 
+// src/strategy/entrySubmissionValidation.ts
+var import_logger = require("@tradejs/infra/logger");
+
+// src/strategy/entryExecutionValidation.ts
+var EntrySubmissionValidationError = class extends Error {
+  constructor() {
+    super(...arguments);
+    this.name = "EntrySubmissionValidationError";
+  }
+};
+var resolveEntryExecutionLimits = (config, direction) => {
+  const side = config[direction];
+  const minimum = side && typeof side === "object" && "minRiskRatio" in side ? side.minRiskRatio : void 0;
+  const maximum = config.MAX_LOSS_VALUE;
+  if (minimum == null && maximum == null) return void 0;
+  const minimumNetRiskRatio = minimum == null ? void 0 : Number(minimum);
+  const maxLossValue = maximum == null ? void 0 : Number(maximum);
+  const feeRate = Number(config.RISK_FEE_RATE ?? 0);
+  const slippage = Number(config.RISK_SLIPPAGE_BPS ?? 0);
+  const impact = Number(config.RISK_MARKET_IMPACT_BPS ?? 0);
+  const slippageBps = slippage + impact;
+  if (minimumNetRiskRatio != null && (!Number.isFinite(minimumNetRiskRatio) || minimumNetRiskRatio < 0) || maxLossValue != null && (!Number.isFinite(maxLossValue) || maxLossValue <= 0) || !Number.isFinite(feeRate) || feeRate < 0 || feeRate >= 1 || !Number.isFinite(slippage) || slippage < 0 || !Number.isFinite(impact) || impact < 0 || !Number.isFinite(slippageBps) || slippageBps < 0 || slippageBps >= 1e4)
+    throw new Error("INVALID_ENTRY_EXECUTION_LIMITS");
+  return { minimumNetRiskRatio, maxLossValue, feeRate, slippageBps };
+};
+var validateEntryExecution = ({
+  direction,
+  price,
+  qty,
+  stopLossPrice,
+  takeProfitPrice,
+  limits
+}) => {
+  if (!Number.isFinite(price) || price <= 0 || !Number.isFinite(qty) || qty <= 0 || stopLossPrice == null || !Number.isFinite(stopLossPrice) || stopLossPrice <= 0 || !Number.isFinite(takeProfitPrice) || takeProfitPrice <= 0)
+    throw new EntrySubmissionValidationError(
+      "ENTRY_ECONOMICS_INPUTS_UNAVAILABLE"
+    );
+  const side = direction === "LONG" ? 1 : -1;
+  if (side * (price - stopLossPrice) <= 0 || side * (takeProfitPrice - price) <= 0)
+    throw new EntrySubmissionValidationError(
+      "INVALID_ENTRY_PROTECTION_AT_SUBMISSION"
+    );
+  const slippage = limits.slippageBps / 1e4;
+  const cost = (value, sign) => value * slippage + value * (1 + sign * slippage) * limits.feeRate;
+  const entryCost = cost(price, side);
+  const lossPerUnit = Math.abs(price - stopLossPrice) + entryCost + cost(stopLossPrice, -side);
+  const rewardPerUnit = Math.max(
+    0,
+    Math.abs(takeProfitPrice - price) - entryCost - cost(takeProfitPrice, -side)
+  );
+  const netRiskRatio = rewardPerUnit / lossPerUnit;
+  const plannedLossValue = qty * lossPerUnit;
+  if (!Number.isFinite(netRiskRatio) || !Number.isFinite(plannedLossValue))
+    throw new EntrySubmissionValidationError(
+      "ENTRY_ECONOMICS_INPUTS_UNAVAILABLE"
+    );
+  if (limits.minimumNetRiskRatio != null && netRiskRatio <= limits.minimumNetRiskRatio)
+    throw new EntrySubmissionValidationError(
+      "ENTRY_RR_BELOW_MIN_AT_SUBMISSION"
+    );
+  const riskExceeded = limits.maxLossValue != null && plannedLossValue > limits.maxLossValue * (1 + 1e-9);
+  return { netRiskRatio, plannedLossValue, riskExceeded };
+};
+
+// src/strategy/entrySubmissionValidation.ts
+var MAX_ENTRY_QUOTE_AGE_MS = 5e3;
+var toFiniteNumberOrNull = (value) => typeof value === "number" && Number.isFinite(value) ? value : null;
+var getOrderArrivalSnapshot = async ({
+  connector,
+  symbol,
+  requireTimestamp = false
+}) => {
+  if (typeof connector.getTopOfBookTicker !== "function") {
+    return {
+      arrivalSnapshotTime: Date.now(),
+      arrivalSource: "unavailable",
+      bid: null,
+      ask: null,
+      arrivalMid: null,
+      spreadBps: null
+    };
+  }
+  try {
+    const ticker = await connector.getTopOfBookTicker(symbol);
+    const arrivalSnapshotTime = toFiniteNumberOrNull(ticker?.timestamp);
+    const timestampUnavailable = requireTimestamp && arrivalSnapshotTime == null;
+    const bid = timestampUnavailable ? null : toFiniteNumberOrNull(ticker?.bidPrice);
+    const ask = timestampUnavailable ? null : toFiniteNumberOrNull(ticker?.askPrice);
+    const arrivalMid = bid != null && ask != null ? (bid + ask) / 2 : null;
+    const spreadBps = bid != null && ask != null && arrivalMid != null && arrivalMid > 0 ? (ask - bid) / arrivalMid * 1e4 : null;
+    return {
+      arrivalSnapshotTime: arrivalSnapshotTime ?? Date.now(),
+      arrivalSource: "top_of_book",
+      bid,
+      ask,
+      arrivalMid,
+      spreadBps
+    };
+  } catch (error) {
+    import_logger.logger.warn(
+      "runtime order arrival snapshot failed: %s %s",
+      symbol,
+      error?.message || String(error)
+    );
+    return {
+      arrivalSnapshotTime: Date.now(),
+      arrivalSource: "top_of_book_error",
+      bid: null,
+      ask: null,
+      arrivalMid: null,
+      spreadBps: null
+    };
+  }
+};
+var validateEntryProtectionAtArrival = ({
+  direction,
+  signalPrice,
+  bid,
+  ask,
+  arrivalMid,
+  takeProfits,
+  stopLossPrice
+}) => {
+  const entryReference = direction === "LONG" ? ask ?? arrivalMid ?? signalPrice : bid ?? arrivalMid ?? signalPrice;
+  const stopReference = direction === "LONG" ? bid ?? arrivalMid ?? signalPrice : ask ?? arrivalMid ?? signalPrice;
+  if (!Number.isFinite(entryReference) || entryReference <= 0 || !Number.isFinite(stopReference) || stopReference <= 0) {
+    throw new Error("INVALID_ENTRY_REFERENCE_AT_ARRIVAL");
+  }
+  for (const takeProfit of takeProfits) {
+    if (!Number.isFinite(takeProfit.price) || takeProfit.price <= 0 || (direction === "LONG" ? takeProfit.price <= entryReference : takeProfit.price >= entryReference)) {
+      throw new Error("TAKE_PROFIT_CROSSED_BEFORE_ENTRY");
+    }
+  }
+  if (stopLossPrice != null && (!Number.isFinite(stopLossPrice) || stopLossPrice <= 0 || (direction === "LONG" ? stopLossPrice >= stopReference : stopLossPrice <= stopReference))) {
+    throw new Error("STOP_LOSS_CROSSED_BEFORE_ENTRY");
+  }
+};
+var createEntrySubmissionValidation = ({
+  connector,
+  symbol,
+  direction,
+  takeProfits,
+  stopLossPrice,
+  limits,
+  onValidated
+}) => {
+  if (!limits) return void 0;
+  if (!connector.capabilities?.orderSubmissionValidation)
+    throw new EntrySubmissionValidationError(
+      "ENTRY_SUBMISSION_VALIDATION_UNSUPPORTED"
+    );
+  return async ({ qty, executionPrice }) => {
+    const simulated = Reflect.get(connector, "__tradejsTestConnector") === true;
+    const snapshot2 = simulated && executionPrice != null ? {
+      arrivalSnapshotTime: Date.now(),
+      arrivalSource: "simulation",
+      bid: executionPrice,
+      ask: executionPrice,
+      arrivalMid: executionPrice,
+      spreadBps: 0
+    } : await getOrderArrivalSnapshot({
+      connector,
+      symbol,
+      requireTimestamp: true
+    });
+    const age = Date.now() - snapshot2.arrivalSnapshotTime;
+    if (snapshot2.bid == null || snapshot2.ask == null || !Number.isFinite(snapshot2.bid) || !Number.isFinite(snapshot2.ask) || snapshot2.bid <= 0 || snapshot2.ask < snapshot2.bid)
+      throw new EntrySubmissionValidationError(
+        "ENTRY_QUOTE_UNAVAILABLE_AT_SUBMISSION"
+      );
+    if (!Number.isFinite(age) || age < -MAX_ENTRY_QUOTE_AGE_MS || age > MAX_ENTRY_QUOTE_AGE_MS)
+      throw new EntrySubmissionValidationError(
+        "ENTRY_QUOTE_STALE_AT_SUBMISSION"
+      );
+    const price = direction === "LONG" ? snapshot2.ask : snapshot2.bid;
+    validateEntryProtectionAtArrival({
+      direction,
+      signalPrice: price,
+      bid: snapshot2.bid,
+      ask: snapshot2.ask,
+      arrivalMid: snapshot2.arrivalMid,
+      takeProfits,
+      stopLossPrice
+    });
+    const prices = takeProfits.map((tp) => tp.price);
+    const economics2 = validateEntryExecution({
+      direction,
+      price,
+      qty,
+      stopLossPrice,
+      takeProfitPrice: direction === "LONG" ? Math.max(...prices) : Math.min(...prices),
+      limits
+    });
+    onValidated?.(snapshot2, economics2);
+  };
+};
+
 // src/ai.ts
 var import_aiLanguages2 = require("@tradejs/core/aiLanguages");
 var import_redis = require("@tradejs/infra/redis");
@@ -1657,7 +1855,7 @@ var import_fs = __toESM(require("fs"));
 var import_path = __toESM(require("path"));
 var import_url = require("url");
 var import_config = require("@tradejs/core/config");
-var import_logger = require("@tradejs/infra/logger");
+var import_logger2 = require("@tradejs/infra/logger");
 var CONFIG_FILE_NAMES = [
   "tradejs.config.ts",
   "tradejs.config.mts",
@@ -1924,11 +2122,11 @@ var loadTradejsConfig = async (cwd = getTradejsProjectCwd()) => {
     cachedByCwd.set(cwd, config);
     if (!announcedConfigFile.has(configFilePath)) {
       announcedConfigFile.add(configFilePath);
-      import_logger.logger.log("debug", "Loaded TradeJS config: %s", configFilePath);
+      import_logger2.logger.log("debug", "Loaded TradeJS config: %s", configFilePath);
     }
     return config;
   } catch (error) {
-    import_logger.logger.log(
+    import_logger2.logger.log(
       "warn",
       "Failed to load TradeJS config from %s: %s",
       configFilePath,
@@ -2895,7 +3093,7 @@ var import_node_crypto = require("crypto");
 var import_constants = require("@tradejs/core/constants");
 var import_time = require("@tradejs/core/time");
 var import_trade = require("@tradejs/core/trade");
-var import_logger2 = require("@tradejs/infra/logger");
+var import_logger3 = require("@tradejs/infra/logger");
 var import_redis2 = require("@tradejs/infra/redis");
 var now = () => Date.now();
 var toRandomOrderSuffix = () => (0, import_node_crypto.randomUUID)().replace(/-/g, "").slice(0, 12).toLowerCase();
@@ -2954,7 +3152,7 @@ var recordRuntimeTradeOpen = async (params) => {
       )
     ]);
   } catch (error) {
-    import_logger2.logger.error(
+    import_logger3.logger.error(
       "runtime trade open journal failed: %s %s",
       record.symbol,
       error?.message || String(error)
@@ -3022,7 +3220,7 @@ var recordRuntimeTradeIncrease = async (params) => {
       )
     ]);
   } catch (error) {
-    import_logger2.logger.error(
+    import_logger3.logger.error(
       "runtime trade increase journal failed: %s %s",
       symbol,
       error?.message || String(error)
@@ -3129,7 +3327,7 @@ var markRuntimeTradeClosed = async (params) => {
       )
     ]);
   } catch (error) {
-    import_logger2.logger.error(
+    import_logger3.logger.error(
       "runtime trade close journal failed: %s %s",
       symbol,
       error?.message || String(error)
@@ -3139,11 +3337,11 @@ var markRuntimeTradeClosed = async (params) => {
 };
 
 // src/strategyHelpers/marketContextStages.ts
-var import_logger7 = require("@tradejs/infra/logger");
+var import_logger8 = require("@tradejs/infra/logger");
 
 // src/strategyHelpers/binanceMarketContext.ts
 var import_marketContext = require("@tradejs/infra/timescale/marketContext");
-var import_logger3 = require("@tradejs/infra/logger");
+var import_logger4 = require("@tradejs/infra/logger");
 var import_strategies = require("@tradejs/core/strategies");
 
 // src/binanceBreadthUniverses.ts
@@ -3507,7 +3705,7 @@ var parseEnabledFlag = (value, env) => {
   if (normalized === "live") return env !== "BACKTEST";
   return false;
 };
-var toFiniteNumberOrNull = (value) => {
+var toFiniteNumberOrNull2 = (value) => {
   const numeric = typeof value === "number" ? value : Number(value);
   return Number.isFinite(numeric) ? numeric : null;
 };
@@ -3632,14 +3830,14 @@ var toTradeFlowContext = (row, interval) => row ? {
   asOfTs: row.ts.getTime(),
   ageMs: row.ageMs,
   stale: row.stale,
-  trades: toFiniteNumberOrNull(row.trades),
-  buyPressurePct: toFiniteNumberOrNull(row.buyPressurePct),
-  buyBaseVolume: toFiniteNumberOrNull(row.buyBaseVolume),
-  sellBaseVolume: toFiniteNumberOrNull(row.sellBaseVolume),
-  buyQuoteVolume: toFiniteNumberOrNull(row.buyQuoteVolume),
-  sellQuoteVolume: toFiniteNumberOrNull(row.sellQuoteVolume),
-  netBaseDelta: toFiniteNumberOrNull(row.netBaseDelta),
-  netQuoteDelta: toFiniteNumberOrNull(row.netQuoteDelta)
+  trades: toFiniteNumberOrNull2(row.trades),
+  buyPressurePct: toFiniteNumberOrNull2(row.buyPressurePct),
+  buyBaseVolume: toFiniteNumberOrNull2(row.buyBaseVolume),
+  sellBaseVolume: toFiniteNumberOrNull2(row.sellBaseVolume),
+  buyQuoteVolume: toFiniteNumberOrNull2(row.buyQuoteVolume),
+  sellQuoteVolume: toFiniteNumberOrNull2(row.sellQuoteVolume),
+  netBaseDelta: toFiniteNumberOrNull2(row.netBaseDelta),
+  netQuoteDelta: toFiniteNumberOrNull2(row.netQuoteDelta)
 } : null;
 var getCachedReferenceRows = ({
   referenceSymbols,
@@ -3728,16 +3926,16 @@ var toMarketBreadthContext = (breadth, interval) => ({
   asOfTs: breadth.ts.getTime(),
   ageMs: breadth.ageMs,
   stale: breadth.stale,
-  symbolsCount: toFiniteNumberOrNull(breadth.symbolsCount),
-  advancers: toFiniteNumberOrNull(breadth.advancers),
-  decliners: toFiniteNumberOrNull(breadth.decliners),
-  unchanged: toFiniteNumberOrNull(breadth.unchanged),
-  advanceDeclineRatio: toFiniteNumberOrNull(breadth.advanceDeclineRatio),
-  pctAboveMa20: toFiniteNumberOrNull(breadth.pctAboveMa20),
-  pctAboveMa50: toFiniteNumberOrNull(breadth.pctAboveMa50),
-  equalWeightedReturn: toFiniteNumberOrNull(breadth.equalWeightedReturn),
-  volumeWeightedReturn: toFiniteNumberOrNull(breadth.volumeWeightedReturn),
-  dispersion: toFiniteNumberOrNull(breadth.dispersion)
+  symbolsCount: toFiniteNumberOrNull2(breadth.symbolsCount),
+  advancers: toFiniteNumberOrNull2(breadth.advancers),
+  decliners: toFiniteNumberOrNull2(breadth.decliners),
+  unchanged: toFiniteNumberOrNull2(breadth.unchanged),
+  advanceDeclineRatio: toFiniteNumberOrNull2(breadth.advanceDeclineRatio),
+  pctAboveMa20: toFiniteNumberOrNull2(breadth.pctAboveMa20),
+  pctAboveMa50: toFiniteNumberOrNull2(breadth.pctAboveMa50),
+  equalWeightedReturn: toFiniteNumberOrNull2(breadth.equalWeightedReturn),
+  volumeWeightedReturn: toFiniteNumberOrNull2(breadth.volumeWeightedReturn),
+  dispersion: toFiniteNumberOrNull2(breadth.dispersion)
 });
 var enrichSignalWithBinanceMarketContext = async (params) => {
   const {
@@ -3838,46 +4036,46 @@ var enrichSignalWithBinanceMarketContext = async (params) => {
                 asOfTs: primaryBreadth.ts.getTime(),
                 ageMs: primaryBreadth.ageMs,
                 stale: primaryBreadth.stale,
-                btcReturn1h: toFiniteNumberOrNull(
+                btcReturn1h: toFiniteNumberOrNull2(
                   primaryBreadth.btcReturn1h
                 ),
-                btcReturn4h: toFiniteNumberOrNull(
+                btcReturn4h: toFiniteNumberOrNull2(
                   primaryBreadth.btcReturn4h
                 ),
-                btcReturn24h: toFiniteNumberOrNull(
+                btcReturn24h: toFiniteNumberOrNull2(
                   primaryBreadth.btcReturn24h
                 ),
-                altBasketReturn1h: toFiniteNumberOrNull(
+                altBasketReturn1h: toFiniteNumberOrNull2(
                   primaryBreadth.altBasketReturn1h
                 ),
-                altBasketReturn4h: toFiniteNumberOrNull(
+                altBasketReturn4h: toFiniteNumberOrNull2(
                   primaryBreadth.altBasketReturn4h
                 ),
-                altBasketReturn24h: toFiniteNumberOrNull(
+                altBasketReturn24h: toFiniteNumberOrNull2(
                   primaryBreadth.altBasketReturn24h
                 ),
-                btcVsAltReturn1h: toFiniteNumberOrNull(
+                btcVsAltReturn1h: toFiniteNumberOrNull2(
                   primaryBreadth.btcVsAltReturn1h
                 ),
-                btcVsAltReturn4h: toFiniteNumberOrNull(
+                btcVsAltReturn4h: toFiniteNumberOrNull2(
                   primaryBreadth.btcVsAltReturn4h
                 ),
-                btcVsAltReturn24h: toFiniteNumberOrNull(
+                btcVsAltReturn24h: toFiniteNumberOrNull2(
                   primaryBreadth.btcVsAltReturn24h
                 ),
-                btcTurnoverShare1h: toFiniteNumberOrNull(
+                btcTurnoverShare1h: toFiniteNumberOrNull2(
                   primaryBreadth.btcTurnoverShare1h
                 ),
-                btcTurnoverShare24h: toFiniteNumberOrNull(
+                btcTurnoverShare24h: toFiniteNumberOrNull2(
                   primaryBreadth.btcTurnoverShare24h
                 ),
-                btcTurnoverShareChange24h: toFiniteNumberOrNull(
+                btcTurnoverShareChange24h: toFiniteNumberOrNull2(
                   primaryBreadth.btcTurnoverShareChange24h
                 ),
-                altVolToBtcVol24h: toFiniteNumberOrNull(
+                altVolToBtcVol24h: toFiniteNumberOrNull2(
                   primaryBreadth.altVolToBtcVol24h
                 ),
-                altDispersion24h: toFiniteNumberOrNull(
+                altDispersion24h: toFiniteNumberOrNull2(
                   primaryBreadth.altDispersion24h
                 ),
                 regime: primaryBreadth.btcAltRegime ?? "unknown"
@@ -3894,7 +4092,7 @@ var enrichSignalWithBinanceMarketContext = async (params) => {
       throw error;
     }
     binanceMarketContextUnavailable = true;
-    import_logger3.logger.warn(
+    import_logger4.logger.warn(
       "Binance market context disabled after Timescale read failure: %s",
       String(error)
     );
@@ -3904,7 +4102,7 @@ var enrichSignalWithBinanceMarketContext = async (params) => {
 
 // src/strategyHelpers/coinMarketCapContext.ts
 var import_strategies2 = require("@tradejs/core/strategies");
-var import_logger4 = require("@tradejs/infra/logger");
+var import_logger5 = require("@tradejs/infra/logger");
 var import_marketContext2 = require("@tradejs/infra/timescale/marketContext");
 var DEFAULT_MAX_AGE_MS = 48 * 60 * 6e4;
 var SOURCE_GLOBAL_DAILY = "coinmarketcap_global";
@@ -3942,7 +4140,7 @@ var asInt = (value, fallback) => {
   const parsed = Number.parseInt(String(value ?? ""), 10);
   return Number.isFinite(parsed) && parsed > 0 ? parsed : fallback;
 };
-var toFiniteNumberOrNull2 = (value) => {
+var toFiniteNumberOrNull3 = (value) => {
   const numeric = typeof value === "number" ? value : typeof value === "string" && value.trim() ? Number(value) : Number.NaN;
   return Number.isFinite(numeric) ? numeric : null;
 };
@@ -4176,12 +4374,12 @@ var enrichSignalWithCoinMarketCapContext = async (params) => {
     const ethRow = references.get("ETHUSDT") ?? null;
     const previousBtcRow = previousReferences.get("BTCUSDT") ?? null;
     const previousEthRow = previousReferences.get("ETHUSDT") ?? null;
-    const btcMarketCapUsd = toFiniteNumberOrNull2(btcRow?.marketCapUsd);
-    const ethMarketCapUsd = toFiniteNumberOrNull2(ethRow?.marketCapUsd);
-    const previousBtcMarketCapUsd = toFiniteNumberOrNull2(
+    const btcMarketCapUsd = toFiniteNumberOrNull3(btcRow?.marketCapUsd);
+    const ethMarketCapUsd = toFiniteNumberOrNull3(ethRow?.marketCapUsd);
+    const previousBtcMarketCapUsd = toFiniteNumberOrNull3(
       previousBtcRow?.marketCapUsd
     );
-    const previousEthMarketCapUsd = toFiniteNumberOrNull2(
+    const previousEthMarketCapUsd = toFiniteNumberOrNull3(
       previousEthRow?.marketCapUsd
     );
     const ethBtcMarketCapRatio = safeDivide(ethMarketCapUsd, btcMarketCapUsd);
@@ -4190,16 +4388,16 @@ var enrichSignalWithCoinMarketCapContext = async (params) => {
       previousBtcMarketCapUsd
     );
     const ethBtcMarketCapRatioChange24hPct = ethBtcMarketCapRatio != null && previousEthBtcMarketCapRatio != null && previousEthBtcMarketCapRatio > 0 ? (ethBtcMarketCapRatio - previousEthBtcMarketCapRatio) / previousEthBtcMarketCapRatio : null;
-    const btcVolumeUsd = toFiniteNumberOrNull2(btcRow?.volumeUsd);
-    const ethVolumeUsd = toFiniteNumberOrNull2(ethRow?.volumeUsd);
+    const btcVolumeUsd = toFiniteNumberOrNull3(btcRow?.volumeUsd);
+    const ethVolumeUsd = toFiniteNumberOrNull3(ethRow?.volumeUsd);
     const referenceStale = btcRow?.stale === true || ethRow?.stale === true || !btcRow || !ethRow;
-    const btcDominanceChange24hPct = toFiniteNumberOrNull2(
+    const btcDominanceChange24hPct = toFiniteNumberOrNull3(
       globalRow?.btcDominanceChange24hPct
     );
-    const altMarketCapChange24hPct = toFiniteNumberOrNull2(
+    const altMarketCapChange24hPct = toFiniteNumberOrNull3(
       globalRow?.altMarketCapChange24hPct
     );
-    const altVolumeChange24hPct = toFiniteNumberOrNull2(
+    const altVolumeChange24hPct = toFiniteNumberOrNull3(
       globalRow?.altVolumeChange24hPct
     );
     const altLiquidityRegime = globalRow ? toAltLiquidityRegime({
@@ -4210,19 +4408,19 @@ var enrichSignalWithCoinMarketCapContext = async (params) => {
     }) : "unknown";
     const exchangeLiquidityRegime = exchangeLiquidityRow ? toExchangeLiquidityRegime({
       stale: exchangeLiquidityRow.stale,
-      totalVolumeChange24hPct: toFiniteNumberOrNull2(
+      totalVolumeChange24hPct: toFiniteNumberOrNull3(
         exchangeLiquidityRow.totalVolumeChange24hPct
       ),
       fallback: exchangeLiquidityRow.liquidityRegime ?? "unknown"
     }) : "unknown";
     const cmc100Row = indexRows.get("cmc100") ?? null;
     const cmc20Row = indexRows.get("cmc20") ?? null;
-    const cmc100Value = toFiniteNumberOrNull2(cmc100Row?.value);
-    const cmc20Value = toFiniteNumberOrNull2(cmc20Row?.value);
-    const cmc100Change24hPct = toFiniteNumberOrNull2(
+    const cmc100Value = toFiniteNumberOrNull3(cmc100Row?.value);
+    const cmc20Value = toFiniteNumberOrNull3(cmc20Row?.value);
+    const cmc100Change24hPct = toFiniteNumberOrNull3(
       cmc100Row?.valueChange24hPct
     );
-    const cmc20Change24hPct = toFiniteNumberOrNull2(cmc20Row?.valueChange24hPct);
+    const cmc20Change24hPct = toFiniteNumberOrNull3(cmc20Row?.valueChange24hPct);
     const cmc20ToCmc100Ratio = safeDivide(cmc20Value, cmc100Value);
     const cmc20ToCmc100RatioChange24hPct = cmc20Change24hPct != null && cmc100Change24hPct != null ? (1 + cmc20Change24hPct) / (1 + cmc100Change24hPct) - 1 : null;
     const indexStale = cmc100Row?.stale === true || cmc20Row?.stale === true || !cmc100Row || !cmc20Row;
@@ -4246,41 +4444,41 @@ var enrichSignalWithCoinMarketCapContext = async (params) => {
               asOfTs: globalRow.ts.getTime(),
               ageMs: globalRow.ageMs,
               stale: globalRow.stale,
-              totalMarketCapUsd: toFiniteNumberOrNull2(
+              totalMarketCapUsd: toFiniteNumberOrNull3(
                 globalRow.totalMarketCapUsd
               ),
-              totalVolumeUsd: toFiniteNumberOrNull2(
+              totalVolumeUsd: toFiniteNumberOrNull3(
                 globalRow.totalVolumeUsd
               ),
-              totalVolumeReportedUsd: toFiniteNumberOrNull2(
+              totalVolumeReportedUsd: toFiniteNumberOrNull3(
                 globalRow.totalVolumeReportedUsd
               ),
-              altMarketCapUsd: toFiniteNumberOrNull2(
+              altMarketCapUsd: toFiniteNumberOrNull3(
                 globalRow.altMarketCapUsd
               ),
-              altVolumeUsd: toFiniteNumberOrNull2(globalRow.altVolumeUsd),
-              altVolumeReportedUsd: toFiniteNumberOrNull2(
+              altVolumeUsd: toFiniteNumberOrNull3(globalRow.altVolumeUsd),
+              altVolumeReportedUsd: toFiniteNumberOrNull3(
                 globalRow.altVolumeReportedUsd
               ),
-              btcDominancePct: toFiniteNumberOrNull2(
+              btcDominancePct: toFiniteNumberOrNull3(
                 globalRow.btcDominancePct
               ),
-              ethDominancePct: toFiniteNumberOrNull2(
+              ethDominancePct: toFiniteNumberOrNull3(
                 globalRow.ethDominancePct
               ),
               btcDominanceChange24hPct,
-              ethDominanceChange24hPct: toFiniteNumberOrNull2(
+              ethDominanceChange24hPct: toFiniteNumberOrNull3(
                 globalRow.ethDominanceChange24hPct
               ),
               altMarketCapChange24hPct,
               altVolumeChange24hPct,
-              activeCryptocurrencies: toFiniteNumberOrNull2(
+              activeCryptocurrencies: toFiniteNumberOrNull3(
                 globalRow.activeCryptocurrencies
               ),
-              activeExchanges: toFiniteNumberOrNull2(
+              activeExchanges: toFiniteNumberOrNull3(
                 globalRow.activeExchanges
               ),
-              activeMarketPairs: toFiniteNumberOrNull2(
+              activeMarketPairs: toFiniteNumberOrNull3(
                 globalRow.activeMarketPairs
               ),
               altLiquidityRegime
@@ -4325,22 +4523,22 @@ var enrichSignalWithCoinMarketCapContext = async (params) => {
               asOfTs: exchangeLiquidityRow.ts.getTime(),
               ageMs: exchangeLiquidityRow.ageMs,
               stale: exchangeLiquidityRow.stale,
-              exchangesCount: toFiniteNumberOrNull2(
+              exchangesCount: toFiniteNumberOrNull3(
                 exchangeLiquidityRow.exchangesCount
               ),
-              totalVolumeUsd: toFiniteNumberOrNull2(
+              totalVolumeUsd: toFiniteNumberOrNull3(
                 exchangeLiquidityRow.totalVolumeUsd
               ),
-              totalVolumeChange24hPct: toFiniteNumberOrNull2(
+              totalVolumeChange24hPct: toFiniteNumberOrNull3(
                 exchangeLiquidityRow.totalVolumeChange24hPct
               ),
-              binanceVolumeUsd: toFiniteNumberOrNull2(
+              binanceVolumeUsd: toFiniteNumberOrNull3(
                 exchangeLiquidityRow.binanceVolumeUsd
               ),
-              binanceVolumeShare: toFiniteNumberOrNull2(
+              binanceVolumeShare: toFiniteNumberOrNull3(
                 exchangeLiquidityRow.binanceVolumeShare
               ),
-              topExchangeVolumeShare: toFiniteNumberOrNull2(
+              topExchangeVolumeShare: toFiniteNumberOrNull3(
                 exchangeLiquidityRow.topExchangeVolumeShare
               ),
               liquidityRegime: exchangeLiquidityRegime
@@ -4353,11 +4551,11 @@ var enrichSignalWithCoinMarketCapContext = async (params) => {
               asOfTs: fearGreedRow.ts.getTime(),
               ageMs: fearGreedRow.ageMs,
               stale: fearGreedRow.stale,
-              value: toFiniteNumberOrNull2(fearGreedRow.value),
-              valueChange24h: toFiniteNumberOrNull2(
+              value: toFiniteNumberOrNull3(fearGreedRow.value),
+              valueChange24h: toFiniteNumberOrNull3(
                 fearGreedRow.valueChange24h
               ),
-              valueChange7d: toFiniteNumberOrNull2(
+              valueChange7d: toFiniteNumberOrNull3(
                 fearGreedRow.valueChange7d
               ),
               classification: fearGreedRow.classification ?? "Unknown",
@@ -4377,13 +4575,13 @@ var enrichSignalWithCoinMarketCapContext = async (params) => {
               cmc100Value,
               cmc100Change24hPct,
               cmc100TopConstituentSymbol: cmc100Row?.topConstituentSymbol ?? null,
-              cmc100TopConstituentWeightPct: toFiniteNumberOrNull2(
+              cmc100TopConstituentWeightPct: toFiniteNumberOrNull3(
                 cmc100Row?.topConstituentWeightPct
               ),
               cmc20Value,
               cmc20Change24hPct,
               cmc20TopConstituentSymbol: cmc20Row?.topConstituentSymbol ?? null,
-              cmc20TopConstituentWeightPct: toFiniteNumberOrNull2(
+              cmc20TopConstituentWeightPct: toFiniteNumberOrNull3(
                 cmc20Row?.topConstituentWeightPct
               ),
               cmc20ToCmc100Ratio,
@@ -4401,7 +4599,7 @@ var enrichSignalWithCoinMarketCapContext = async (params) => {
       throw error;
     }
     coinMarketCapContextUnavailable = true;
-    import_logger4.logger.warn(
+    import_logger5.logger.warn(
       "CoinMarketCap context disabled after Timescale read failure: %s",
       String(error)
     );
@@ -4415,7 +4613,7 @@ var import_data2 = require("@tradejs/core/data");
 var import_strategies3 = require("@tradejs/core/strategies");
 var import_constants2 = require("@tradejs/core/constants");
 var import_derivatives = require("@tradejs/infra/timescale/derivatives");
-var import_logger5 = require("@tradejs/infra/logger");
+var import_logger6 = require("@tradejs/infra/logger");
 var STORED_INTERVALS = ["15m", "1h"];
 var CONTEXT_INTERVALS = ["15m", "1h"];
 var DEFAULT_LOOKBACK_HOURS = 48;
@@ -4470,7 +4668,7 @@ var resolvePrimaryReferenceSymbol2 = () => PRIMARY_DERIVATIVES_REFERENCE_SYMBOL;
 var resolveSecondaryReferenceSymbol = () => SECONDARY_DERIVATIVES_REFERENCE_SYMBOL;
 var getPrimaryIntervalContext = (context) => context?.intervals["15m"] ?? context?.intervals["1h"] ?? null;
 var hasDerivativesSymbolData = (context) => Object.keys(context.intervals).length > 0 && !context.summary.riskFlags.includes("missing_derivatives");
-var toFiniteNumberOrNull3 = (value) => {
+var toFiniteNumberOrNull4 = (value) => {
   if (typeof value === "number" && Number.isFinite(value)) return value;
   if (typeof value === "string" && value.trim()) {
     const parsed = Number(value);
@@ -4484,8 +4682,8 @@ var roundNullable = (value, digits = 4) => {
   return Math.round(value * multiplier) / multiplier;
 };
 var deltaNullable = (targetValue, referenceValue) => {
-  const target = toFiniteNumberOrNull3(targetValue);
-  const reference = toFiniteNumberOrNull3(referenceValue);
+  const target = toFiniteNumberOrNull4(targetValue);
+  const reference = toFiniteNumberOrNull4(referenceValue);
   return target == null || reference == null ? null : roundNullable(target - reference);
 };
 var buildTargetDerivedContext = (params) => {
@@ -4647,7 +4845,7 @@ var enrichSignalWithDerivativesContext = async (params) => {
       throw error;
     }
     derivativesContextUnavailable = true;
-    import_logger5.logger.warn(
+    import_logger6.logger.warn(
       "Derivatives context disabled after Timescale read failure: %s",
       String(error)
     );
@@ -4659,7 +4857,7 @@ var enrichSignalWithDerivativesContext = async (params) => {
 var import_data3 = require("@tradejs/core/data");
 var import_strategies4 = require("@tradejs/core/strategies");
 var import_hyperliquidWhales2 = require("@tradejs/infra/timescale/hyperliquidWhales");
-var import_logger6 = require("@tradejs/infra/logger");
+var import_logger7 = require("@tradejs/infra/logger");
 
 // src/hyperliquidWhaleUniverse.ts
 var import_node_crypto3 = require("crypto");
@@ -5179,7 +5377,7 @@ var loadHyperliquidWhaleFlowContext = async (params) => {
       throw error;
     }
     hyperliquidWhaleContextUnavailable = true;
-    import_logger6.logger.warn(
+    import_logger7.logger.warn(
       "Hyperliquid whale context disabled after Timescale read failure: %s",
       String(error)
     );
@@ -5262,7 +5460,7 @@ var runMarketContextStage = async ({
       elapsedMs: Date.now() - startedAt
     };
     if (status === "timed_out") {
-      import_logger7.logger.warn(
+      import_logger8.logger.warn(
         "Market context stage timed out: %s after %sms",
         stage,
         result.elapsedMs
@@ -5452,79 +5650,10 @@ var enrichSignalWithAi = async ({
     signal.aiAnalysis = analysis;
     return resolveAiQuality(analysis, direction);
   } catch (err) {
-    import_logger8.logger.error("AI analysis error: %s %s", symbol, formatAiError(err));
+    import_logger9.logger.error("AI analysis error: %s %s", symbol, formatAiError(err));
   }
   return void 0;
 };
-var toFiniteNumberOrNull4 = (value) => typeof value === "number" && Number.isFinite(value) ? value : null;
-var getOrderArrivalSnapshot = async ({
-  connector,
-  symbol
-}) => {
-  if (typeof connector.getTopOfBookTicker !== "function") {
-    return {
-      arrivalSnapshotTime: Date.now(),
-      arrivalSource: "unavailable",
-      bid: null,
-      ask: null,
-      arrivalMid: null,
-      spreadBps: null
-    };
-  }
-  try {
-    const ticker = await connector.getTopOfBookTicker(symbol);
-    const arrivalSnapshotTime = toFiniteNumberOrNull4(ticker?.timestamp);
-    const bid = toFiniteNumberOrNull4(ticker?.bidPrice);
-    const ask = toFiniteNumberOrNull4(ticker?.askPrice);
-    const arrivalMid = bid != null && ask != null ? (bid + ask) / 2 : null;
-    const spreadBps = bid != null && ask != null && arrivalMid != null && arrivalMid > 0 ? (ask - bid) / arrivalMid * 1e4 : null;
-    return {
-      arrivalSnapshotTime: arrivalSnapshotTime ?? Date.now(),
-      arrivalSource: "top_of_book",
-      bid,
-      ask,
-      arrivalMid,
-      spreadBps
-    };
-  } catch (error) {
-    import_logger8.logger.warn(
-      "runtime order arrival snapshot failed: %s %s",
-      symbol,
-      error?.message || String(error)
-    );
-    return {
-      arrivalSnapshotTime: Date.now(),
-      arrivalSource: "top_of_book_error",
-      bid: null,
-      ask: null,
-      arrivalMid: null,
-      spreadBps: null
-    };
-  }
-};
-var validateEntryProtectionAtArrival = ({
-  direction,
-  signalPrice,
-  bid,
-  ask,
-  arrivalMid,
-  takeProfits,
-  stopLossPrice
-}) => {
-  const entryReference = direction === "LONG" ? ask ?? arrivalMid ?? signalPrice : bid ?? arrivalMid ?? signalPrice;
-  const stopReference = direction === "LONG" ? bid ?? arrivalMid ?? signalPrice : ask ?? arrivalMid ?? signalPrice;
-  if (!Number.isFinite(entryReference) || entryReference <= 0 || !Number.isFinite(stopReference) || stopReference <= 0) {
-    throw new Error("INVALID_ENTRY_REFERENCE_AT_ARRIVAL");
-  }
-  for (const takeProfit of takeProfits) {
-    if (!Number.isFinite(takeProfit.price) || takeProfit.price <= 0 || (direction === "LONG" ? takeProfit.price <= entryReference : takeProfit.price >= entryReference)) {
-      throw new Error("TAKE_PROFIT_CROSSED_BEFORE_ENTRY");
-    }
-  }
-  if (stopLossPrice != null && (!Number.isFinite(stopLossPrice) || stopLossPrice <= 0 || (direction === "LONG" ? stopLossPrice >= stopReference : stopLossPrice <= stopReference))) {
-    throw new Error("STOP_LOSS_CROSSED_BEFORE_ENTRY");
-  }
-};
 var resolveRuntimeTelemetryQuality = ({
   signalClosePrice,
   arrivalMid,
@@ -5601,7 +5730,8 @@ var executeEntryOrder = async ({
   signal,
   beforePlaceOrder,
   recordRuntimeTrade = true,
-  leverage
+  leverage,
+  executionLimits
 }) => {
   await beforePlaceOrder?.();
   const previousPosition = positionIntent === "increase" ? await connector.getPosition(symbol) : null;
@@ -5612,23 +5742,57 @@ var executeEntryOrder = async ({
   signal.orderQty = qty;
   signal.orderValue = qty * currentPrice;
   signal.orderFailureReason = void 0;
-  const arrivalSnapshot = await getOrderArrivalSnapshot({ connector, symbol });
-  try {
-    validateEntryProtectionAtArrival({
-      direction,
-      signalPrice: currentPrice,
-      bid: arrivalSnapshot.bid,
-      ask: arrivalSnapshot.ask,
-      arrivalMid: arrivalSnapshot.arrivalMid,
-      takeProfits,
-      stopLossPrice
-    });
-  } catch (error) {
-    signal.orderStatus = "failed";
-    signal.orderFailureReason = error.message;
-    throw error;
+  let arrivalSnapshot = {
+    arrivalSnapshotTime: Date.now(),
+    arrivalSource: "unavailable",
+    bid: null,
+    ask: null,
+    arrivalMid: null,
+    spreadBps: null
+  };
+  let orderSubmitTime = Date.now();
+  const beforeSubmit = createEntrySubmissionValidation({
+    connector,
+    symbol,
+    direction,
+    takeProfits,
+    stopLossPrice,
+    limits: executionLimits,
+    onValidated: (snapshot2, economics2) => {
+      arrivalSnapshot = snapshot2;
+      orderSubmitTime = Date.now();
+      if (executionLimits?.maxLossValue != null) {
+        signal.riskDecision = {
+          stage: "order_plan",
+          status: economics2.riskExceeded ? "warning" : "approved",
+          reason: economics2.riskExceeded ? "ENTRY_RISK_EXCEEDS_MAX_LOSS_AT_SUBMISSION" : "PLANNED_LOSS_WITHIN_MAX_LOSS_VALUE",
+          plannedLossValue: economics2.plannedLossValue,
+          maxLossValue: executionLimits.maxLossValue,
+          limitUtilization: economics2.plannedLossValue / executionLimits.maxLossValue,
+          enforced: false
+        };
+      }
+    }
+  });
+  if (!beforeSubmit) {
+    arrivalSnapshot = await getOrderArrivalSnapshot({ connector, symbol });
+    try {
+      validateEntryProtectionAtArrival({
+        direction,
+        signalPrice: currentPrice,
+        bid: arrivalSnapshot.bid,
+        ask: arrivalSnapshot.ask,
+        arrivalMid: arrivalSnapshot.arrivalMid,
+        takeProfits,
+        stopLossPrice
+      });
+    } catch (error) {
+      signal.orderStatus = "failed";
+      signal.orderFailureReason = error.message;
+      throw error;
+    }
+    orderSubmitTime = Date.now();
   }
-  const orderSubmitTime = Date.now();
   const orderPlaced = await connector.placeOrder({
     symbol,
     qty,
@@ -5639,7 +5803,8 @@ var executeEntryOrder = async ({
     direction,
     ...typeof leverage === "number" && Number.isFinite(leverage) ? { leverage } : {},
     orderId,
-    signal
+    signal,
+    ...beforeSubmit ? { beforeSubmit } : {}
   });
   const orderAckTime = Date.now();
   const placedQty = typeof signal.orderQty === "number" && Number.isFinite(signal.orderQty) && signal.orderQty > 0 ? signal.orderQty : qty;
@@ -6468,7 +6633,7 @@ var canUseSharedReplayState = ({
 }) => (env === "BACKTEST" || env === "PARITY") && Boolean(sharedReplayKey);
 
 // src/strategy/runtimeExecution.ts
-var import_logger9 = require("@tradejs/infra/logger");
+var import_logger10 = require("@tradejs/infra/logger");
 var import_types = require("@tradejs/types");
 var buildExitOrderSignal = ({
   strategyName,
@@ -6520,7 +6685,7 @@ var handleExitDecision = async ({
         deploymentId: connector.deploymentId
       });
       if (!activeTrade) {
-        import_logger9.logger.warn(
+        import_logger10.logger.warn(
           "[%s] blocked closePosition for untracked runtime position: %s",
           strategyName ?? "unknown",
           symbol
@@ -6528,7 +6693,7 @@ var handleExitDecision = async ({
         return "CLOSE_BLOCKED_BY_UNTRACKED_POSITION";
       }
       if (!strategyName || activeTrade.strategy !== strategyName) {
-        import_logger9.logger.warn(
+        import_logger10.logger.warn(
           "[%s] blocked closePosition for foreign runtime position: %s ownedBy=%s",
           strategyName ?? "unknown",
           symbol,
@@ -6581,7 +6746,7 @@ var handleExitDecision = async ({
           exitType: closedTrade?.exitType ?? "exit"
         });
       } catch (notificationError) {
-        import_logger9.logger.error(
+        import_logger10.logger.error(
           "runtime close notification error: %s %s",
           symbol,
           notificationError
@@ -6595,7 +6760,7 @@ var handleExitDecision = async ({
       decision,
       market
     });
-    import_logger9.logger.error("close order error: %s %s", symbol, err);
+    import_logger10.logger.error("close order error: %s %s", symbol, err);
     return "ORDER_ERROR";
   }
   return decision.code;
@@ -6622,7 +6787,7 @@ var handleProtectDecision = async ({
       decision,
       market
     });
-    import_logger9.logger.error("protect position error: %s %s", symbol, err);
+    import_logger10.logger.error("protect position error: %s %s", symbol, err);
     return "ORDER_ERROR";
   }
   return decision.code;
@@ -6688,7 +6853,11 @@ var executeEntryDecision = async ({
         ...Number.isFinite(Number(hookCtx.strategyConfig.LEVERAGE)) ? { leverage: Number(hookCtx.strategyConfig.LEVERAGE) } : {},
         signal,
         beforePlaceOrder,
-        recordRuntimeTrade: recordRuntimeJournal
+        recordRuntimeTrade: recordRuntimeJournal,
+        executionLimits: resolveEntryExecutionLimits(
+          hookCtx.strategyConfig,
+          decision.entryContext.direction
+        )
       });
       await invokeStageHooks(
         "afterPlaceOrder",
@@ -6710,19 +6879,32 @@ var executeEntryDecision = async ({
       return signal;
     }
     await beforePlaceOrder();
-    const arrivalSnapshot = await getOrderArrivalSnapshot({
+    const beforeSubmit = createEntrySubmissionValidation({
       connector,
-      symbol
-    });
-    validateEntryProtectionAtArrival({
+      symbol,
       direction: decision.entryContext.direction,
-      signalPrice: decision.entryContext.prices.currentPrice,
-      bid: arrivalSnapshot.bid,
-      ask: arrivalSnapshot.ask,
-      arrivalMid: arrivalSnapshot.arrivalMid,
       takeProfits: decision.orderPlan.takeProfits,
-      stopLossPrice: decision.orderPlan.stopLossPrice
+      stopLossPrice: decision.orderPlan.stopLossPrice,
+      limits: resolveEntryExecutionLimits(
+        hookCtx.strategyConfig,
+        decision.entryContext.direction
+      )
     });
+    if (!beforeSubmit) {
+      const arrivalSnapshot = await getOrderArrivalSnapshot({
+        connector,
+        symbol
+      });
+      validateEntryProtectionAtArrival({
+        direction: decision.entryContext.direction,
+        signalPrice: decision.entryContext.prices.currentPrice,
+        bid: arrivalSnapshot.bid,
+        ask: arrivalSnapshot.ask,
+        arrivalMid: arrivalSnapshot.arrivalMid,
+        takeProfits: decision.orderPlan.takeProfits,
+        stopLossPrice: decision.orderPlan.stopLossPrice
+      });
+    }
     const orderPlaced = await connector.placeOrder({
       symbol,
       qty: decision.orderPlan.qty,
@@ -6730,6 +6912,7 @@ var executeEntryDecision = async ({
       timestamp: decision.entryContext.timestamp,
       direction: decision.entryContext.direction,
       positionIntent: decision.orderPlan.positionIntent,
+      ...beforeSubmit ? { beforeSubmit } : {},
       ...Number.isFinite(Number(hookCtx.strategyConfig.LEVERAGE)) ? { leverage: Number(hookCtx.strategyConfig.LEVERAGE) } : {}
     });
     if (!orderPlaced) {
@@ -6771,6 +6954,23 @@ var executeEntryDecision = async ({
       { decision, entry, market }
     );
   } catch (err) {
+    if (err instanceof EntrySubmissionValidationError) {
+      if (signal) {
+        signal.orderStatus = "skipped";
+        signal.orderSkipReason = err.message;
+        signal.allocatorDecision = {
+          stage: "runtime_admission",
+          status: "rejected",
+          reason: err.message
+        };
+      }
+      import_logger10.logger.warn(
+        "entry rejected before submission: %s %s",
+        symbol,
+        err.message
+      );
+      return signal ?? err.message;
+    }
     if (signal) {
       signal.orderStatus = "failed";
       if (typeof signal.orderFailureReason !== "string" || !signal.orderFailureReason.trim()) {
@@ -6785,9 +6985,9 @@ var executeEntryDecision = async ({
       market
     });
     if (err?.message === import_types.BACKTEST_WARNING_CODES.TAKE_PROFIT_CROSSED_BEFORE_ENTRY) {
-      import_logger9.logger.warn("order warning: %s %s", symbol, err);
+      import_logger10.logger.warn("order warning: %s %s", symbol, err);
     } else {
-      import_logger9.logger.error("order error: %s %s", symbol, err);
+      import_logger10.logger.error("order error: %s %s", symbol, err);
     }
     return signal ?? "ORDER_ERROR";
   }
@@ -6895,6 +7095,9 @@ var createStrategyRuntime = ({
     });
     const strategyPolicyProfile = getPolicyProfile();
     const indicatorPeriods = (0, import_strategies6.buildDefaultIndicatorPeriods)(config);
+    const strategyConfig = { ...config };
+    delete strategyConfig.RECORD_RUNTIME_TRADES;
+    delete strategyConfig.SIMULATE_ORDERS;
     const hookBase = {
       connector,
       strategyName,
@@ -6905,7 +7108,7 @@ var createStrategyRuntime = ({
       accountId,
       deploymentId,
       policyProfileId: strategyPolicyProfile?.id ?? requestedPolicyProfileId,
-      strategyConfig: config,
+      strategyConfig,
       env,
       isConfigFromBacktest
     };
@@ -6952,7 +7155,7 @@ var createStrategyRuntime = ({
         try {
           await projectHook(errorParams);
         } catch (hookError) {
-          import_logger10.logger.error(
+          import_logger11.logger.error(
             "project hook onRuntimeError failed: %s %s",
             strategyName,
             hookError
@@ -6966,21 +7169,21 @@ var createStrategyRuntime = ({
       try {
         await onRuntimeError(errorParams);
       } catch (hookError) {
-        import_logger10.logger.error(
+        import_logger11.logger.error(
           "runtime hook onRuntimeError failed: %s %s",
           strategyName,
           hookError
         );
       }
     };
-    const invokeHook = async (stage, hook, params, errorContext = {}) => {
+    const invokeHook = async (stage, hook, params, errorContext = {}, failureResult) => {
       if (!hook) {
         return void 0;
       }
       try {
         return await hook(params);
       } catch (error) {
-        import_logger10.logger.error(
+        import_logger11.logger.error(
           'strategy hook "%s" failed for %s: %s',
           stage,
           strategyName,
@@ -6993,17 +7196,18 @@ var createStrategyRuntime = ({
           entry: errorContext.entry,
           market: errorContext.market
         });
-        return void 0;
+        return failureResult;
       }
     };
-    const invokeProjectHooks = async (stage, params, errorContext = {}) => {
+    const invokeProjectHooks = async (stage, params, errorContext = {}, failureResult) => {
       const results = [];
       for (const hook of getProjectHookList(stage)) {
         const result = await invokeHook(
           stage,
           hook,
           params,
-          errorContext
+          errorContext,
+          failureResult
         );
         if (result !== void 0) {
           results.push(result);
@@ -7018,10 +7222,12 @@ var createStrategyRuntime = ({
       return invokeHook(stage, hook, params, errorContext);
     };
     const invokeGateHooks = async (stage, hook, params, errorContext = {}) => {
+      const failureResult = stage === "beforeEntryGate" ? { allow: false, reason: "ERROR" } : void 0;
       const projectResults = await invokeProjectHooks(
         stage,
         params,
-        errorContext
+        errorContext,
+        failureResult
       );
       const projectBlock = projectResults.find(
         (result) => result?.allow === false
@@ -7033,7 +7239,8 @@ var createStrategyRuntime = ({
         stage,
         hook,
         params,
-        errorContext
+        errorContext,
+        failureResult
       );
     };
     const applyProjectAfterCoreDecisionHooks = async ({
@@ -7179,11 +7386,8 @@ var createStrategyRuntime = ({
         return enrichedBaseContext;
       }
     });
-    const coreConfig = { ...config };
-    delete coreConfig.RECORD_RUNTIME_TRADES;
-    delete coreConfig.SIMULATE_ORDERS;
     const core = await createCore({
-      config: coreConfig,
+      config: strategyConfig,
       data,
       strategyApi,
       indicatorsState
@@ -7802,10 +8006,10 @@ var createStrategyRuntime = ({
 setStrategyRuntimeFactory(createStrategyRuntime);
 
 // src/connectorsRegistry.ts
-var import_logger13 = require("@tradejs/infra/logger");
+var import_logger14 = require("@tradejs/infra/logger");
 
 // src/connectorRuntime.ts
-var import_logger12 = require("@tradejs/infra/logger");
+var import_logger13 = require("@tradejs/infra/logger");
 var import_tradingAccounts = require("@tradejs/infra/tradingAccounts");
 
 // src/timescaleCachedKline.ts
@@ -7813,7 +8017,7 @@ var import_constants6 = require("@tradejs/core/constants");
 var import_data5 = require("@tradejs/core/data");
 var import_time2 = require("@tradejs/core/time");
 var import_async = require("@tradejs/core/async");
-var import_logger11 = require("@tradejs/infra/logger");
+var import_logger12 = require("@tradejs/infra/logger");
 var import_candles = require("@tradejs/infra/timescale/candles");
 var DEFAULT_LIMIT = 1e3;
 var DEFAULT_CACHE_FALLBACK_WINDOW = 1e3;
@@ -7923,7 +8127,7 @@ var createTimescaleCachedKline = ({
   }) => {
     const intMinutes = intervalToMinutes(interval);
     if (!intMinutes) {
-      import_logger11.logger.log("error", "refreshTail: invalid interval %s", interval);
+      import_logger12.logger.log("error", "refreshTail: invalid interval %s", interval);
       return;
     }
     const intervalMs = intervalMsOf(intMinutes);
@@ -7954,7 +8158,7 @@ var createTimescaleCachedKline = ({
   }) => {
     const intMinutes = intervalToMinutes(interval);
     if (!intMinutes) {
-      import_logger11.logger.log("error", "kline: invalid interval %s", interval);
+      import_logger12.logger.log("error", "kline: invalid interval %s", interval);
       return [];
     }
     if (defaultStart !== void 0 && defaultEnd !== void 0 && defaultEnd <= defaultStart) {
@@ -8063,7 +8267,7 @@ var createTimescaleCachedKline = ({
       if (warmOnly) {
         if (isTimescaleFallbackMode) {
           isTimescaleFallbackMode = false;
-          import_logger11.logger.log("info", "TimescaleDB connection restored for kline cache");
+          import_logger12.logger.log("info", "TimescaleDB connection restored for kline cache");
         }
         return [];
       }
@@ -8081,13 +8285,13 @@ var createTimescaleCachedKline = ({
       );
       if (isTimescaleFallbackMode) {
         isTimescaleFallbackMode = false;
-        import_logger11.logger.log("info", "TimescaleDB connection restored for kline cache");
+        import_logger12.logger.log("info", "TimescaleDB connection restored for kline cache");
       }
       return dbData;
     } catch (error) {
       if (!isTimescaleFallbackMode) {
         isTimescaleFallbackMode = true;
-        import_logger11.logger.log(
+        import_logger12.logger.log(
           "warn",
           "TimescaleDB unavailable for %s %s: %s. Falling back to exchange API.",
           symbol,
@@ -8111,7 +8315,7 @@ var createTimescaleCachedKline = ({
 
 // src/connectorRuntime.ts
 var connectorRuntime = {
-  logger: import_logger12.logger,
+  logger: import_logger13.logger,
   resolveTradingAccount: import_tradingAccounts.resolveTradingAccount,
   createCachedKline: createTimescaleCachedKline
 };
@@ -8172,7 +8376,7 @@ var normalizeProviders = (providers, connectorName) => {
 var registerProvider = (provider, connectorName, source, providerToConnectorName) => {
   const existing = providerToConnectorName.get(provider);
   if (existing && existing !== connectorName) {
-    import_logger13.logger.warn(
+    import_logger14.logger.warn(
       'Skip duplicate connector provider "%s" from %s: already mapped to %s',
       provider,
       source,
@@ -8185,11 +8389,11 @@ var registerProvider = (provider, connectorName, source, providerToConnectorName
 var registerEntry = (entry, source, state) => {
   const connectorName = String(entry?.name ?? "").trim();
   if (!connectorName) {
-    import_logger13.logger.warn("Skip connector entry without name from %s", source);
+    import_logger14.logger.warn("Skip connector entry without name from %s", source);
     return;
   }
   if (typeof entry.creator !== "function") {
-    import_logger13.logger.warn(
+    import_logger14.logger.warn(
       'Skip connector entry "%s" from %s: creator must be a function',
       connectorName,
       source
@@ -8201,7 +8405,7 @@ var registerEntry = (entry, source, state) => {
     state.connectorCreators
   );
   if (existingByName) {
-    import_logger13.logger.warn(
+    import_logger14.logger.warn(
       'Skip duplicate connector "%s" from %s: already registered as %s',
       connectorName,
       source,
@@ -8276,7 +8480,7 @@ var ensureConnectorPluginsLoaded = async (cwd = getTradejsProjectCwd()) => {
           );
           const pluginDefinition = extractConnectorPluginDefinition(moduleExport);
           if (!pluginDefinition) {
-            import_logger13.logger.warn(
+            import_logger14.logger.warn(
               'Skip connector plugin "%s": export { connectorEntries } is missing',
               moduleName
             );
@@ -8284,7 +8488,7 @@ var ensureConnectorPluginsLoaded = async (cwd = getTradejsProjectCwd()) => {
           }
           registerEntries2(pluginDefinition.connectorEntries, moduleName, state);
         } catch (error) {
-          import_logger13.logger.warn(
+          import_logger14.logger.warn(
             'Failed to load connector plugin "%s": %s',
             moduleName,
             String(error)
@@ -8850,6 +9054,7 @@ var loadResolvedRuntimeStrategies = async ({
 var import_node_crypto5 = require("crypto");
 var import_promises3 = require("fs/promises");
 var import_node_path3 = __toESM(require("path"));
+var import_node_util = require("util");
 var import_redis3 = require("@tradejs/infra/redis");
 var MCP_JOB_TTL = 7 * 86400;
 var hash = (value) => (0, import_node_crypto5.createHash)("sha256").update(value).digest("hex");
@@ -9015,10 +9220,29 @@ var readAuthorizedMcpJob = async (principal, id) => {
     throw new Error("Insufficient scope");
   return job;
 };
-var redactMcpJobLog = (line) => line.replace(/\u001b\[[0-9;]*m/g, "").replace(/\b(Bearer|Basic)\s+\S+/gi, "$1 [redacted]").replace(/([a-z][a-z0-9+.-]*:\/\/)[^\s/@]*:[^\s/@]+@/gi, "$1[redacted]@").replace(/((?:authorization|cookie)\s*:\s*)[^\r\n]+/gi, "$1[redacted]").replace(
+var redactMcpLogLine = (line) => line.replace(/\u001b\[[0-9;]*m/g, "").replace(/\b(Bearer|Basic)\s+\S+/gi, "$1 [redacted]").replace(/([a-z][a-z0-9+.-]*:\/\/)[^\s/@]*:[^\s/@]+@/gi, "$1[redacted]@").replace(/((?:authorization|cookie)\s*:\s*)[^\r\n]+/gi, "$1[redacted]").replace(
   /((?:[\w.-]*(?:secret|password|token|api[_-]?key|private[_-]?key|authorization|cookie|credential)[\w.-]*)["']?\s*[:=]\s*)(?:"[^"\r\n]*"|'[^'\r\n]*'|[^\s,;&}]+)/gi,
   "$1[redacted]"
-).slice(0, 1e3);
+);
+var MCP_LOG_LINE_LIMIT = 1e3;
+var redactMcpJobLog = (line) => redactMcpLogLine(line).slice(0, MCP_LOG_LINE_LIMIT);
+var formatMcpArtifactLogLine = (line) => {
+  const text = redactMcpLogLine(
+    (0, import_node_util.stripVTControlCharacters)(line).replace(/\r/g, "")
+  );
+  const fragments = [];
+  let start = 0;
+  while (start < text.length) {
+    let end = Math.min(start + MCP_LOG_LINE_LIMIT, text.length);
+    const lastCodeUnit = text.charCodeAt(end - 1);
+    if (end < text.length && lastCodeUnit >= 55296 && lastCodeUnit <= 56319) {
+      end -= 1;
+    }
+    fragments.push(redactMcpJobLog(text.slice(start, end)));
+    start = end;
+  }
+  return fragments.join("\n") + "\n";
+};
 var readMcpJobLogs = async (principal, id, offset = 0, limit = 50) => {
   if (!Number.isSafeInteger(offset) || offset < 0 || !Number.isSafeInteger(limit) || limit < 1 || limit > 100)
     throw new Error("Select a non-negative log offset and a limit of 1\u2013100");
@@ -9481,6 +9705,7 @@ var readMcpBacktestResult = async (userName, id, offset = 0, limit = 20) => {
   McpCursorError,
   cancelMcpJob,
   enqueueMcpJob,
+  formatMcpArtifactLogLine,
   isMcpRecord,
   mcpId,
   mcpJobDirectory,