npm - @tradejs/types - Versions diffs - 2.0.19 → 2.0.20 - Mend

@tradejs/types 2.0.19 → 2.0.20

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (5) hide show

package/dist/index.d.mts CHANGED Viewed

@@ -114,6 +114,7 @@ interface TradingAccountRef {
 interface RuntimeDeploymentStrategy {
     strategyName: string;
     policyProfileId: string;
+    releaseCompositionId?: string;
     enabled?: boolean;
     config?: Record<string, unknown>;
 }
@@ -856,6 +857,7 @@ interface RuntimeAiAnalysisSnapshot {
 type SignalOrderStatus = 'completed' | 'failed' | 'skipped' | 'canceled';
 interface RuntimeLineage {
     schemaVersion: 1;
+    compositionId?: string | null;
     gitSha: string | null;
     gitDirty: boolean | null;
     gateFingerprint: string;
@@ -1065,6 +1067,7 @@ interface Test extends BacktestRunConfig {
     ai?: boolean;
     fast?: boolean;
     collectReplaySignalEvaluations?: boolean;
+    researchTrace?: boolean;
     chunkId?: string;
     backtestRunId?: string;
     backtestTestKey?: string;
@@ -1089,12 +1092,55 @@ declare const BACKTEST_WARNING_CODES: {
 };
 type BacktestWarningCode = (typeof BACKTEST_WARNING_CODES)[keyof typeof BACKTEST_WARNING_CODES];
 type BacktestWarningCounts = Partial<Record<BacktestWarningCode, number>>;
+type CoreResearchTraceEvent = {
+    schema: 'tradejs-core-research-trace/v1';
+    event: 'signal_emitted' | 'entry_rejected' | 'entry_executed';
+    timestamp: number;
+    strategy: string;
+    symbol: string;
+    direction: Direction;
+    setupIdentity: string;
+    setupIdentitySource: 'strategy-context' | 'signal-time-fallback';
+    signalId: string;
+    configId?: string;
+    backtestRunId?: string;
+    backtestTestKey?: string;
+} | {
+    schema: 'tradejs-core-research-trace/v1';
+    event: 'position_exited';
+    timestamp: number;
+    strategy: string;
+    symbol: string;
+    direction: Direction;
+    setupIdentity: string;
+    setupIdentitySource: 'strategy-context' | 'signal-time-fallback';
+    signalId: string;
+    configId?: string;
+    backtestRunId?: string;
+    backtestTestKey?: string;
+    netProfit: number;
+    exitReason: TestTradeExitReason;
+} | {
+    schema: 'tradejs-core-research-trace/v1';
+    event: 'skip_summary';
+    timestamp: number;
+    strategy: string;
+    symbol: string;
+    configId?: string;
+    backtestRunId?: string;
+    backtestTestKey?: string;
+    skipCounts: Record<string, number>;
+};
 interface TestingBoxResult {
     orderLogId: string;
     stat: MinimalStat;
     inlineOrderLog?: OrderLogData;
     inlinePositionLog?: PositionLogData;
     inlineReplaySignalEvaluations?: RuntimeSignalEvaluationRecord[];
+    researchTraceSummary?: {
+        events: Record<string, number>;
+        skipCounts: Record<string, number>;
+    };
     executionCostModel?: ExecutionCostModel;
     warningCounts?: BacktestWarningCounts;
 }
@@ -2524,6 +2570,11 @@ interface AiDatasetRow {
     backtestRunId?: string;
     backtestTestKey?: string;
     backtestChunkId?: string;
+    research?: {
+        schema: 'tradejs-core-research-row/v1';
+        setupIdentity: string;
+        setupIdentitySource: 'strategy-context' | 'signal-time-fallback';
+    };
 }
 type StrategyChartMetricTone = 'default' | 'neutral' | 'success' | 'warning' | 'error';
@@ -2605,4 +2656,262 @@ interface Item<T = Record<string, string | number | boolean>> {
 }
 type Items = Item[];
-export { type AIChatHistory, type AIChatMessage, type AggTrade, type AggTradesRequest, type AiDatasetRow, type AiPayload, type AiPromptPair, type AssetClass, BACKTEST_WARNING_CODES, type BacktestDetectorOptimizedStrategy, type BacktestPriceMode, type BacktestRunConfig, type BacktestWarningCode, type BacktestWarningCounts, type BaseContextGateFeatures, type BaseGateFeatureApproveBias, type BaseGateFeatureConfirmation, type BaseGateFeatureConflict, type BaseGateFeatureEntryLocation, type BaseGateFeaturePrimaryIssue, type BaseGateFeatureRiskLevel, type BaseGateFeatureScoreKey, type BaseHyperliquidWhaleFlowContext, type BaseIndicatorsHistorySnapshot, type BaseMarketBreadthContext, type BaseMarketBreadthsContext, type BaseMarketTradeFlowContext, type BaseMultiTimeframeContext, type BaseParticipationContext, type BasePsychologicalLevelAssetContext, type BasePsychologicalLevelWindowContext, type BaseRawIndicatorSnapshot, type BaseRegimeContext, type BaseRelativeContext, type BaseStrategyContextSnapshot, type BaseStructureContext, type Bot, type BotConfig, type BotResults, type BotStatus, type BuildStrategySignalDraft, type BuildStrategySignalParams, type Candle, type ChartColor, type ClosedPnlRecord, type CmcExchangeLiquidityRegime, type CmcFearGreedClassification, type CmcFearGreedRegime, type CompletedTest, type Connector, type ConnectorCapabilities, type ConnectorConfig, type ConnectorCreator, type ConnectorPluginDefinition, type ConnectorRegistryEntry, type CreateStrategyCore, type CreateStrategyCoreParams, DEFAULT_MARKET_UNIVERSE, type DerivativesContext, type DerivativesContextRiskFlag, type DerivativesInterval, type DerivativesIntervalContext, type DerivativesPressure, type DerivativesPriceOiDivergenceType, type DerivativesRow, type DerivativesSymbolContext, type DerivativesTargetDerivedContext, type Direction, type EOMPoint, type ExchangeEntryRecord, type ExecutionCostModel, type ExecutionCostQuality, type ExecutionCostSource, type Filters, type FundingRateHistoryRequest, type FundingRatePoint, type GetAggTrades, type GetClosedPnlParams, type GetFundingRateHistory, type GetOrderBookDepth, type GetTickers, type GetTopOfBookTicker, type GetTradingFeeRate, HYPERLIQUID_WHALE_DATA_MODEL_VERSION, type HyperliquidPositionAction, type HyperliquidWhaleCoverageRow, type HyperliquidWhaleFlowRow, type HyperliquidWhaleTradeEventRow, type Indicator, type IndicatorPluginComputeParams, type IndicatorPluginDefinition, type IndicatorPluginEntry, type IndicatorPluginFigureRenderer, type IndicatorPluginRenderer, type IndicatorSnapshot, type Indicators, type IndicatorsHistorySnapshot, type InstrumentDescriptor, type InstrumentKind, type InstrumentQuery, type InstrumentStatus, type Interval, type Item, type Items, type Kline, type KlineChartData, type KlineChartItem, type KlineRequest, type ListInstruments, type MarketBreadthRow, type MarketCmcExchangeLiquidityContextRow, type MarketCmcFearGreedContextRow, type MarketCmcIndexConstituent, type MarketCmcIndexContextRow, type MarketCmcIndexSlug, type MarketDataCapability, type MarketFeatureInterval, type MarketGlobalContextRow, type MarketGlobalContextSource, type MarketKlineEvent, type MarketReferenceAssetContextRow, type MarketTradeFlowRow, type MarketUniverse, type MetricThreshold, type Metrics, type MinimalStat, type MlCandleIndicatorsSnapshot, type MonthlyEquityStats, type OnChangeCompare, type Order, type OrderBookDepth, type OrderBookDepthRequest, type OrderLog, type OrderLogData, type OrderPositionIntent, type OrderType, type Position, type PositionLog, type PositionLogData, type PositionPnlSnapshot, type Provider, type RuntimeAiAnalysisSnapshot, type RuntimeDeployment, type RuntimeDeploymentHeartbeat, type RuntimeDeploymentStrategy, type RuntimeLineage, type RuntimeSignalEvaluationRecord, type RuntimeSignalEvaluationStatus, type RuntimeStrategyCloseNotification, type RuntimeStrategyConfigSnapshot, type RuntimeTradeExitType, type RuntimeTradeFillSource, type RuntimeTradeRecord, type RuntimeTradeStatus, type RuntimeTradeTelemetryQuality, type Signal, type SignalAnalysis, type SignalOrderStatus, type SimpleOrderLogData, type Sl, type SpreadRow, type Strategy, type StrategyAPI, type StrategyAPIEntryParams, type StrategyAPIExitParams, type StrategyAPIProtectParams, type StrategyAdditionalIndicatorsMap, type StrategyAiAdapter, type StrategyAiMode, type StrategyChartDetail, type StrategyChartMetric, type StrategyChartMetricTone, type StrategyChartOrder, type StrategyChartSnapshot, type StrategyChartsSnapshotResponse, type StrategyClosePlan, type StrategyConfig, type StrategyConfigGrid, type StrategyCoreRunner, type StrategyCreator, type StrategyCreatorParams, type StrategyDecision, type StrategyDecisionPriceContext, type StrategyDirectionalTpSlParams, type StrategyDirectionalTpSlResult, type StrategyEntryBaseParams, type StrategyEntryModelFigures, type StrategyEntryOrderPlan, type StrategyEntryRuntimeBaseParams, type StrategyEntryRuntimeBuilderParams, type StrategyEntryRuntimeOptions, type StrategyEntrySignalContext, type StrategyEntrySignalDecisionBuilderParams, type StrategyEntryTakeProfitsParams, type StrategyFigureAnnotation, type StrategyFigureLine, type StrategyFigurePoint, type StrategyFigurePoints, type StrategyFigureZone, type StrategyHookAfterAiContext, type StrategyHookAfterDecisionContext, type StrategyHookAfterPlaceOrderContext, type StrategyHookAiContext, type StrategyHookAiSkippedReason, type StrategyHookBarContext, type StrategyHookBeforeCloseContext, type StrategyHookBeforeEntryGateContext, type StrategyHookBeforePlaceOrderContext, type StrategyHookCtx, type StrategyHookEnrichContext, type StrategyHookEntryContext, type StrategyHookErrorContext, type StrategyHookErrorPayload, type StrategyHookGateResult, type StrategyHookInitContext, type StrategyHookMarketContext, type StrategyHookMlContext, type StrategyHookMlSkippedReason, type StrategyHookOrderContext, type StrategyHookPolicyContext, type StrategyHookSkipContext, type StrategyHookStage, type StrategyIndicatorsContext, type StrategyIndicatorsMap, type StrategyIndicatorsState, type StrategyLastTradeController, type StrategyLastTradeControllerParams, type StrategyManifest, type StrategyMarketContextSource, type StrategyMlAdapter, type StrategyPluginDefinition, type StrategyPolicyProfile, type StrategyProtectPlan, type StrategyRegistryEntry, type StrategyResultConfig, type StrategyResultEntry, type StrategyResults, type StrategyRuntimeAiOptions, type StrategyRuntimeMlOptions, type StrategySharedReplayStateGetter, type StrategySignalMetaParams, type StrategySignalPriceParams, type StrategyStateController, type StrategyStateControllerOptions, type Test, type TestClosedSignalResult, type TestCompare, type TestCompareList, type TestConnector, type TestConnectorContext, type TestConnectorCreator, type TestResult, type TestStat, type TestSuite, type TestThresholds, type TestThresholdsKey, type TestTradeExitReason, type TestTradeResult, type TestWorkerResult, type TestingBox, type TestingBoxResult, type TestingOptions, type ThresholdLevel, type Ticker, type TickerQuery, type TopOfBookTicker, type Tp, type TradingAccountRef, type TradingFeeRate, type Trend, type TrendLine, type TrendLineMode, type TrendLineOptions, isMarketUniverse, resolveConnectorUniverse };
+declare const STRATEGY_RELEASE_SCHEMA: "tradejs-strategy-release/v1";
+declare const STRATEGY_EVIDENCE_MARKERS_SCHEMA: "tradejs-strategy-evidence-markers/v1";
+declare const STRATEGY_LIVE_DIAGNOSIS_SCHEMA: "tradejs-strategy-live-diagnosis/v1";
+type StrategyReleaseVerdict = 'READY_FOR_RUNTIME' | 'UNSUITABLE_FOR_CURRENT_MARKET' | 'INSUFFICIENT_EVIDENCE';
+type StrategyReleaseResearchDecisionAction = 'REPAIR_RECENT_DIRECTION' | 'START_MICRO_FORWARD' | 'MICRO_FORWARD_READY' | 'FORWARD_BLOCKED' | 'STOP_RESEARCH';
+type StrategyReleaseResearchDecisionBlocker = 'HISTORICAL_MATRIX_INCOMPLETE' | 'HISTORICAL_EDGE_FAILED' | 'CANDIDATE_NOT_IMPLEMENTED' | 'FULL_PERIOD_CHART_MISSING' | 'FORWARD_NOT_AUTHORIZED' | 'RUNTIME_TARGET_UNRESOLVED' | 'FORWARD_RISK_MUST_BE_ONE';
+type StrategyReleaseHistoricalWindow = {
+    days: number;
+    coveredDays?: number;
+    pnl: number;
+    profitFactor: number;
+    long: {
+        pnl: number;
+        profitFactor: number;
+    };
+    short: {
+        pnl: number;
+        profitFactor: number;
+    };
+};
+type StrategyReleaseResearchDecisionInput = {
+    strategy: string;
+    historicalWindows: StrategyReleaseHistoricalWindow[];
+    candidateImplemented: boolean;
+    exposedEvaluation: boolean;
+    chartArtifact: {
+        path: string;
+        sha256: string;
+    } | null;
+    recentFailure: {
+        days: number;
+        direction: 'LONG' | 'SHORT';
+        closedTrades: number;
+        causalMechanismIdentified: boolean;
+        repairRoundsUsed: number;
+    } | null;
+    forwardTest: {
+        authorized: boolean;
+        runtimeTarget: {
+            userName: string;
+            deploymentId: string;
+            accountId: string;
+            strategyConfigName: string;
+        } | null;
+        maxLossValue: number;
+    };
+};
+type StrategyReleaseResearchDecision = {
+    strategy: string;
+    action: StrategyReleaseResearchDecisionAction;
+    repairAllowed: boolean;
+    targetDirection: 'LONG' | 'SHORT' | null;
+    maxLossValue: 1 | null;
+    blockers: StrategyReleaseResearchDecisionBlocker[];
+    summary: string;
+};
+type StrategyReleaseReason = 'NO_VERIFIED_CORE_EDGE' | 'AI_GATE_ADDS_NO_VALUE' | 'CURRENT_REGIME_UNSUITABLE' | 'RUNTIME_PARITY_BLOCKED' | 'EXECUTION_MODEL_UNSAFE' | 'RESEARCH_BUDGET_EXHAUSTED' | 'EVIDENCE_INCOMPLETE';
+type StrategyEvidenceMarkerType = 'G' | 'L' | 'E' | 'D' | 'P' | 'R';
+type StrategyEvidenceMarker = {
+    id: string;
+    type: StrategyEvidenceMarkerType;
+    timestamp: number;
+    label: string;
+    summary: string;
+    artifactId: string;
+    artifactSha256: string;
+    compositionId?: string;
+    gitSha?: string;
+    gateFingerprint?: string;
+    configFingerprint?: string;
+    contextFingerprint?: string;
+    maxLossValue?: number;
+    severity?: 'info' | 'warning' | 'blocking';
+    coverage?: {
+        startTime: number;
+        endTime: number;
+    };
+};
+type StrategyEvidenceTimeline = {
+    status: 'verified' | 'missing' | 'invalid';
+    observedFrom: number | null;
+    markers: StrategyEvidenceMarker[];
+};
+type StrategyEvidenceTimelineSelector = {
+    strategy: string;
+    compositionId?: string | null;
+    gitSha?: string | null;
+    gateFingerprint?: string | null;
+    configFingerprint?: string | null;
+    contextFingerprint?: string | null;
+    maxLossValue?: number | null;
+    requireCompleteLineage?: boolean;
+};
+type StrategyEvidenceMarkerPayload = {
+    strategy: string;
+    createdAt: number;
+    markers: StrategyEvidenceMarker[];
+    sourceArtifacts: Array<{
+        artifactId: string;
+        sha256: string;
+        path?: string;
+    }>;
+};
+type StrategyEvidenceMarkerEnvelope = {
+    schema: typeof STRATEGY_EVIDENCE_MARKERS_SCHEMA;
+    artifactId: string;
+    payloadSha256: string;
+    payload: StrategyEvidenceMarkerPayload;
+};
+type StrategyReleaseEvidenceReference = {
+    kind: 'core_research' | 'ai_gate' | 'runtime_parity' | 'execution_calibration' | 'runtime_evidence' | 'runtime_scorecard';
+    artifactId: string;
+    path: string;
+    sha256: string;
+    verified: boolean;
+    lineage?: {
+        strategy: string | null;
+        gitSha: string | null;
+        gitDirty: boolean | null;
+        coreConfigSha256: string | null;
+        gateConfigIdsFingerprint: string | null;
+        gateFingerprint: string | null;
+        runtimeConfigFingerprint: string | null;
+        gateContextFingerprint: string | null;
+        runtimeContextFingerprint: string | null;
+        maxLossValue: number | null;
+        sourceSha256s: string[];
+    };
+    releaseAssertions?: Partial<{
+        coreEdgeVerified: boolean;
+        aiGateAddsValue: boolean;
+        currentMarketSuitable: boolean;
+        runtimeParityVerified: boolean;
+        executionModelVerified: boolean;
+    }>;
+};
+type StrategyReleaseManifest = {
+    schema: typeof STRATEGY_RELEASE_SCHEMA;
+    releaseId: string;
+    strategy: string;
+    createdAt: number;
+    composition: {
+        compositionId: string;
+        gitSha: string;
+        coreConfigSha256: string;
+        coreExportSha256: string;
+        gateConfigIdsFingerprint: string;
+        runtimeConfigFingerprint: string;
+        gateFingerprint: string;
+        gateContextFingerprint: string;
+        runtimeContextFingerprint: string;
+        maxLossValue: number;
+        longEnabled: boolean;
+        shortEnabled: boolean;
+    };
+    marketWindow: {
+        startTime: number;
+        endTime: number;
+        universeSha256: string;
+        symbols: number;
+        cacheOnly: true;
+        terminalDays: number[];
+    };
+    researchBudget: {
+        hypothesisFamilies: number;
+        maximumVariantsPerFamily: number;
+        isolatedLongFinalists: number;
+        aiGateTuningRounds: number;
+    };
+    evidence: StrategyReleaseEvidenceReference[];
+    gates: {
+        coreEdgeVerified: boolean;
+        aiGateAddsValue: boolean;
+        currentMarketSuitable: boolean;
+        runtimeParityVerified: boolean;
+        executionModelVerified: boolean;
+    };
+    monitoring: {
+        minimumProspectiveClosedTrades: number;
+        minimumParityRatio: number;
+        maximumOrderFailureRate: number;
+        drawdownEnvelopes: Array<{
+            days: number;
+            p95: number;
+            maximum: number;
+        }>;
+        rawCoreExpectancy: number | null;
+        aiGateExpectancy: number | null;
+        minimumRegimeCoverage: number;
+        overfitProbability: number | null;
+    };
+    verdict: {
+        status: StrategyReleaseVerdict;
+        reasons: StrategyReleaseReason[];
+        summary: string;
+    };
+    prospective: {
+        status: 'not_started' | 'incubating' | 'sufficient' | 'blocked';
+        evidenceBooks: Array<'micro_live' | 'shadow_composition' | 'shadow_raw_core' | 'gate_comparison'>;
+        llmComparatorPolicy: 'ai_approved_only' | 'all_core_candidates' | 'disabled';
+    };
+};
+type StrategyReleaseEnvelope = {
+    schema: 'tradejs-strategy-release-envelope/v1';
+    releaseId: string;
+    manifestSha256: string;
+    manifest: StrategyReleaseManifest;
+};
+type StrategyLiveDiagnosisVerdict = 'RUNTIME_DIVERGENCE' | 'EXPECTED_DRAWDOWN' | 'GENERALIZATION_FAILURE' | 'INSUFFICIENT_EVIDENCE';
+type StrategyLiveDiagnosis = {
+    schema: typeof STRATEGY_LIVE_DIAGNOSIS_SCHEMA;
+    strategy: string;
+    compositionId: string;
+    createdAt: number;
+    verdict: StrategyLiveDiagnosisVerdict;
+    subtype: 'RAW_CORE_DECAY' | 'AI_GATE_FAILURE' | 'REGIME_SHIFT' | 'SUSPECTED_HISTORICAL_OVERFIT' | null;
+    confidence: 'low' | 'medium' | 'high';
+    evidence: {
+        lineageComparable: boolean;
+        riskScaleComparable: boolean;
+        releaseMaxLossValue: number | null;
+        runtimeMaxLossValue: number | null;
+        riskScaleRatio: number | null;
+        parityRatio: number | null;
+        orderFailureRate: number | null;
+        observedDrawdown: number | null;
+        normalizedObservedDrawdown: number | null;
+        historicalDrawdownP95: number | null;
+        historicalDrawdownMaximum: number | null;
+        closedTrades: number;
+        rawCoreExpectancyDelta: number | null;
+        aiGateAddedValue: number | null;
+        regimeCoverage: number | null;
+        overfitProbability: number | null;
+    };
+    explanation: string;
+    recommendations: string[];
+};
+type StrategyLiveDiagnosisEnvelope = {
+    schema: 'tradejs-strategy-live-diagnosis-envelope/v1';
+    diagnosisId: string;
+    diagnosisSha256: string;
+    diagnosis: StrategyLiveDiagnosis;
+};
+type StrategyEvidenceRetentionEntry = {
+    path: string;
+    kind: 'operational_redis' | 'verbose_payload' | 'verified_runtime_bundle' | 'compact_ledger';
+    createdAt: number;
+    verified: boolean;
+    aggregated: boolean;
+    bytes: number;
+};
+type StrategyEvidenceRetentionPlan = {
+    keep: StrategyEvidenceRetentionEntry[];
+    delete: StrategyEvidenceRetentionEntry[];
+    bytesReclaimable: number;
+};
+export { type AIChatHistory, type AIChatMessage, type AggTrade, type AggTradesRequest, type AiDatasetRow, type AiPayload, type AiPromptPair, type AssetClass, BACKTEST_WARNING_CODES, type BacktestDetectorOptimizedStrategy, type BacktestPriceMode, type BacktestRunConfig, type BacktestWarningCode, type BacktestWarningCounts, type BaseContextGateFeatures, type BaseGateFeatureApproveBias, type BaseGateFeatureConfirmation, type BaseGateFeatureConflict, type BaseGateFeatureEntryLocation, type BaseGateFeaturePrimaryIssue, type BaseGateFeatureRiskLevel, type BaseGateFeatureScoreKey, type BaseHyperliquidWhaleFlowContext, type BaseIndicatorsHistorySnapshot, type BaseMarketBreadthContext, type BaseMarketBreadthsContext, type BaseMarketTradeFlowContext, type BaseMultiTimeframeContext, type BaseParticipationContext, type BasePsychologicalLevelAssetContext, type BasePsychologicalLevelWindowContext, type BaseRawIndicatorSnapshot, type BaseRegimeContext, type BaseRelativeContext, type BaseStrategyContextSnapshot, type BaseStructureContext, type Bot, type BotConfig, type BotResults, type BotStatus, type BuildStrategySignalDraft, type BuildStrategySignalParams, type Candle, type ChartColor, type ClosedPnlRecord, type CmcExchangeLiquidityRegime, type CmcFearGreedClassification, type CmcFearGreedRegime, type CompletedTest, type Connector, type ConnectorCapabilities, type ConnectorConfig, type ConnectorCreator, type ConnectorPluginDefinition, type ConnectorRegistryEntry, type CoreResearchTraceEvent, type CreateStrategyCore, type CreateStrategyCoreParams, DEFAULT_MARKET_UNIVERSE, type DerivativesContext, type DerivativesContextRiskFlag, type DerivativesInterval, type DerivativesIntervalContext, type DerivativesPressure, type DerivativesPriceOiDivergenceType, type DerivativesRow, type DerivativesSymbolContext, type DerivativesTargetDerivedContext, type Direction, type EOMPoint, type ExchangeEntryRecord, type ExecutionCostModel, type ExecutionCostQuality, type ExecutionCostSource, type Filters, type FundingRateHistoryRequest, type FundingRatePoint, type GetAggTrades, type GetClosedPnlParams, type GetFundingRateHistory, type GetOrderBookDepth, type GetTickers, type GetTopOfBookTicker, type GetTradingFeeRate, HYPERLIQUID_WHALE_DATA_MODEL_VERSION, type HyperliquidPositionAction, type HyperliquidWhaleCoverageRow, type HyperliquidWhaleFlowRow, type HyperliquidWhaleTradeEventRow, type Indicator, type IndicatorPluginComputeParams, type IndicatorPluginDefinition, type IndicatorPluginEntry, type IndicatorPluginFigureRenderer, type IndicatorPluginRenderer, type IndicatorSnapshot, type Indicators, type IndicatorsHistorySnapshot, type InstrumentDescriptor, type InstrumentKind, type InstrumentQuery, type InstrumentStatus, type Interval, type Item, type Items, type Kline, type KlineChartData, type KlineChartItem, type KlineRequest, type ListInstruments, type MarketBreadthRow, type MarketCmcExchangeLiquidityContextRow, type MarketCmcFearGreedContextRow, type MarketCmcIndexConstituent, type MarketCmcIndexContextRow, type MarketCmcIndexSlug, type MarketDataCapability, type MarketFeatureInterval, type MarketGlobalContextRow, type MarketGlobalContextSource, type MarketKlineEvent, type MarketReferenceAssetContextRow, type MarketTradeFlowRow, type MarketUniverse, type MetricThreshold, type Metrics, type MinimalStat, type MlCandleIndicatorsSnapshot, type MonthlyEquityStats, type OnChangeCompare, type Order, type OrderBookDepth, type OrderBookDepthRequest, type OrderLog, type OrderLogData, type OrderPositionIntent, type OrderType, type Position, type PositionLog, type PositionLogData, type PositionPnlSnapshot, type Provider, type RuntimeAiAnalysisSnapshot, type RuntimeDeployment, type RuntimeDeploymentHeartbeat, type RuntimeDeploymentStrategy, type RuntimeLineage, type RuntimeSignalEvaluationRecord, type RuntimeSignalEvaluationStatus, type RuntimeStrategyCloseNotification, type RuntimeStrategyConfigSnapshot, type RuntimeTradeExitType, type RuntimeTradeFillSource, type RuntimeTradeRecord, type RuntimeTradeStatus, type RuntimeTradeTelemetryQuality, STRATEGY_EVIDENCE_MARKERS_SCHEMA, STRATEGY_LIVE_DIAGNOSIS_SCHEMA, STRATEGY_RELEASE_SCHEMA, type Signal, type SignalAnalysis, type SignalOrderStatus, type SimpleOrderLogData, type Sl, type SpreadRow, type Strategy, type StrategyAPI, type StrategyAPIEntryParams, type StrategyAPIExitParams, type StrategyAPIProtectParams, type StrategyAdditionalIndicatorsMap, type StrategyAiAdapter, type StrategyAiMode, type StrategyChartDetail, type StrategyChartMetric, type StrategyChartMetricTone, type StrategyChartOrder, type StrategyChartSnapshot, type StrategyChartsSnapshotResponse, type StrategyClosePlan, type StrategyConfig, type StrategyConfigGrid, type StrategyCoreRunner, type StrategyCreator, type StrategyCreatorParams, type StrategyDecision, type StrategyDecisionPriceContext, type StrategyDirectionalTpSlParams, type StrategyDirectionalTpSlResult, type StrategyEntryBaseParams, type StrategyEntryModelFigures, type StrategyEntryOrderPlan, type StrategyEntryRuntimeBaseParams, type StrategyEntryRuntimeBuilderParams, type StrategyEntryRuntimeOptions, type StrategyEntrySignalContext, type StrategyEntrySignalDecisionBuilderParams, type StrategyEntryTakeProfitsParams, type StrategyEvidenceMarker, type StrategyEvidenceMarkerEnvelope, type StrategyEvidenceMarkerPayload, type StrategyEvidenceMarkerType, type StrategyEvidenceRetentionEntry, type StrategyEvidenceRetentionPlan, type StrategyEvidenceTimeline, type StrategyEvidenceTimelineSelector, type StrategyFigureAnnotation, type StrategyFigureLine, type StrategyFigurePoint, type StrategyFigurePoints, type StrategyFigureZone, type StrategyHookAfterAiContext, type StrategyHookAfterDecisionContext, type StrategyHookAfterPlaceOrderContext, type StrategyHookAiContext, type StrategyHookAiSkippedReason, type StrategyHookBarContext, type StrategyHookBeforeCloseContext, type StrategyHookBeforeEntryGateContext, type StrategyHookBeforePlaceOrderContext, type StrategyHookCtx, type StrategyHookEnrichContext, type StrategyHookEntryContext, type StrategyHookErrorContext, type StrategyHookErrorPayload, type StrategyHookGateResult, type StrategyHookInitContext, type StrategyHookMarketContext, type StrategyHookMlContext, type StrategyHookMlSkippedReason, type StrategyHookOrderContext, type StrategyHookPolicyContext, type StrategyHookSkipContext, type StrategyHookStage, type StrategyIndicatorsContext, type StrategyIndicatorsMap, type StrategyIndicatorsState, type StrategyLastTradeController, type StrategyLastTradeControllerParams, type StrategyLiveDiagnosis, type StrategyLiveDiagnosisEnvelope, type StrategyLiveDiagnosisVerdict, type StrategyManifest, type StrategyMarketContextSource, type StrategyMlAdapter, type StrategyPluginDefinition, type StrategyPolicyProfile, type StrategyProtectPlan, type StrategyRegistryEntry, type StrategyReleaseEnvelope, type StrategyReleaseEvidenceReference, type StrategyReleaseHistoricalWindow, type StrategyReleaseManifest, type StrategyReleaseReason, type StrategyReleaseResearchDecision, type StrategyReleaseResearchDecisionAction, type StrategyReleaseResearchDecisionBlocker, type StrategyReleaseResearchDecisionInput, type StrategyReleaseVerdict, type StrategyResultConfig, type StrategyResultEntry, type StrategyResults, type StrategyRuntimeAiOptions, type StrategyRuntimeMlOptions, type StrategySharedReplayStateGetter, type StrategySignalMetaParams, type StrategySignalPriceParams, type StrategyStateController, type StrategyStateControllerOptions, type Test, type TestClosedSignalResult, type TestCompare, type TestCompareList, type TestConnector, type TestConnectorContext, type TestConnectorCreator, type TestResult, type TestStat, type TestSuite, type TestThresholds, type TestThresholdsKey, type TestTradeExitReason, type TestTradeResult, type TestWorkerResult, type TestingBox, type TestingBoxResult, type TestingOptions, type ThresholdLevel, type Ticker, type TickerQuery, type TopOfBookTicker, type Tp, type TradingAccountRef, type TradingFeeRate, type Trend, type TrendLine, type TrendLineMode, type TrendLineOptions, isMarketUniverse, resolveConnectorUniverse };

package/dist/index.d.ts CHANGED Viewed

@@ -114,6 +114,7 @@ interface TradingAccountRef {
 interface RuntimeDeploymentStrategy {
     strategyName: string;
     policyProfileId: string;
+    releaseCompositionId?: string;
     enabled?: boolean;
     config?: Record<string, unknown>;
 }
@@ -856,6 +857,7 @@ interface RuntimeAiAnalysisSnapshot {
 type SignalOrderStatus = 'completed' | 'failed' | 'skipped' | 'canceled';
 interface RuntimeLineage {
     schemaVersion: 1;
+    compositionId?: string | null;
     gitSha: string | null;
     gitDirty: boolean | null;
     gateFingerprint: string;
@@ -1065,6 +1067,7 @@ interface Test extends BacktestRunConfig {
     ai?: boolean;
     fast?: boolean;
     collectReplaySignalEvaluations?: boolean;
+    researchTrace?: boolean;
     chunkId?: string;
     backtestRunId?: string;
     backtestTestKey?: string;
@@ -1089,12 +1092,55 @@ declare const BACKTEST_WARNING_CODES: {
 };
 type BacktestWarningCode = (typeof BACKTEST_WARNING_CODES)[keyof typeof BACKTEST_WARNING_CODES];
 type BacktestWarningCounts = Partial<Record<BacktestWarningCode, number>>;
+type CoreResearchTraceEvent = {
+    schema: 'tradejs-core-research-trace/v1';
+    event: 'signal_emitted' | 'entry_rejected' | 'entry_executed';
+    timestamp: number;
+    strategy: string;
+    symbol: string;
+    direction: Direction;
+    setupIdentity: string;
+    setupIdentitySource: 'strategy-context' | 'signal-time-fallback';
+    signalId: string;
+    configId?: string;
+    backtestRunId?: string;
+    backtestTestKey?: string;
+} | {
+    schema: 'tradejs-core-research-trace/v1';
+    event: 'position_exited';
+    timestamp: number;
+    strategy: string;
+    symbol: string;
+    direction: Direction;
+    setupIdentity: string;
+    setupIdentitySource: 'strategy-context' | 'signal-time-fallback';
+    signalId: string;
+    configId?: string;
+    backtestRunId?: string;
+    backtestTestKey?: string;
+    netProfit: number;
+    exitReason: TestTradeExitReason;
+} | {
+    schema: 'tradejs-core-research-trace/v1';
+    event: 'skip_summary';
+    timestamp: number;
+    strategy: string;
+    symbol: string;
+    configId?: string;
+    backtestRunId?: string;
+    backtestTestKey?: string;
+    skipCounts: Record<string, number>;
+};
 interface TestingBoxResult {
     orderLogId: string;
     stat: MinimalStat;
     inlineOrderLog?: OrderLogData;
     inlinePositionLog?: PositionLogData;
     inlineReplaySignalEvaluations?: RuntimeSignalEvaluationRecord[];
+    researchTraceSummary?: {
+        events: Record<string, number>;
+        skipCounts: Record<string, number>;
+    };
     executionCostModel?: ExecutionCostModel;
     warningCounts?: BacktestWarningCounts;
 }
@@ -2524,6 +2570,11 @@ interface AiDatasetRow {
     backtestRunId?: string;
     backtestTestKey?: string;
     backtestChunkId?: string;
+    research?: {
+        schema: 'tradejs-core-research-row/v1';
+        setupIdentity: string;
+        setupIdentitySource: 'strategy-context' | 'signal-time-fallback';
+    };
 }
 type StrategyChartMetricTone = 'default' | 'neutral' | 'success' | 'warning' | 'error';
@@ -2605,4 +2656,262 @@ interface Item<T = Record<string, string | number | boolean>> {
 }
 type Items = Item[];
-export { type AIChatHistory, type AIChatMessage, type AggTrade, type AggTradesRequest, type AiDatasetRow, type AiPayload, type AiPromptPair, type AssetClass, BACKTEST_WARNING_CODES, type BacktestDetectorOptimizedStrategy, type BacktestPriceMode, type BacktestRunConfig, type BacktestWarningCode, type BacktestWarningCounts, type BaseContextGateFeatures, type BaseGateFeatureApproveBias, type BaseGateFeatureConfirmation, type BaseGateFeatureConflict, type BaseGateFeatureEntryLocation, type BaseGateFeaturePrimaryIssue, type BaseGateFeatureRiskLevel, type BaseGateFeatureScoreKey, type BaseHyperliquidWhaleFlowContext, type BaseIndicatorsHistorySnapshot, type BaseMarketBreadthContext, type BaseMarketBreadthsContext, type BaseMarketTradeFlowContext, type BaseMultiTimeframeContext, type BaseParticipationContext, type BasePsychologicalLevelAssetContext, type BasePsychologicalLevelWindowContext, type BaseRawIndicatorSnapshot, type BaseRegimeContext, type BaseRelativeContext, type BaseStrategyContextSnapshot, type BaseStructureContext, type Bot, type BotConfig, type BotResults, type BotStatus, type BuildStrategySignalDraft, type BuildStrategySignalParams, type Candle, type ChartColor, type ClosedPnlRecord, type CmcExchangeLiquidityRegime, type CmcFearGreedClassification, type CmcFearGreedRegime, type CompletedTest, type Connector, type ConnectorCapabilities, type ConnectorConfig, type ConnectorCreator, type ConnectorPluginDefinition, type ConnectorRegistryEntry, type CreateStrategyCore, type CreateStrategyCoreParams, DEFAULT_MARKET_UNIVERSE, type DerivativesContext, type DerivativesContextRiskFlag, type DerivativesInterval, type DerivativesIntervalContext, type DerivativesPressure, type DerivativesPriceOiDivergenceType, type DerivativesRow, type DerivativesSymbolContext, type DerivativesTargetDerivedContext, type Direction, type EOMPoint, type ExchangeEntryRecord, type ExecutionCostModel, type ExecutionCostQuality, type ExecutionCostSource, type Filters, type FundingRateHistoryRequest, type FundingRatePoint, type GetAggTrades, type GetClosedPnlParams, type GetFundingRateHistory, type GetOrderBookDepth, type GetTickers, type GetTopOfBookTicker, type GetTradingFeeRate, HYPERLIQUID_WHALE_DATA_MODEL_VERSION, type HyperliquidPositionAction, type HyperliquidWhaleCoverageRow, type HyperliquidWhaleFlowRow, type HyperliquidWhaleTradeEventRow, type Indicator, type IndicatorPluginComputeParams, type IndicatorPluginDefinition, type IndicatorPluginEntry, type IndicatorPluginFigureRenderer, type IndicatorPluginRenderer, type IndicatorSnapshot, type Indicators, type IndicatorsHistorySnapshot, type InstrumentDescriptor, type InstrumentKind, type InstrumentQuery, type InstrumentStatus, type Interval, type Item, type Items, type Kline, type KlineChartData, type KlineChartItem, type KlineRequest, type ListInstruments, type MarketBreadthRow, type MarketCmcExchangeLiquidityContextRow, type MarketCmcFearGreedContextRow, type MarketCmcIndexConstituent, type MarketCmcIndexContextRow, type MarketCmcIndexSlug, type MarketDataCapability, type MarketFeatureInterval, type MarketGlobalContextRow, type MarketGlobalContextSource, type MarketKlineEvent, type MarketReferenceAssetContextRow, type MarketTradeFlowRow, type MarketUniverse, type MetricThreshold, type Metrics, type MinimalStat, type MlCandleIndicatorsSnapshot, type MonthlyEquityStats, type OnChangeCompare, type Order, type OrderBookDepth, type OrderBookDepthRequest, type OrderLog, type OrderLogData, type OrderPositionIntent, type OrderType, type Position, type PositionLog, type PositionLogData, type PositionPnlSnapshot, type Provider, type RuntimeAiAnalysisSnapshot, type RuntimeDeployment, type RuntimeDeploymentHeartbeat, type RuntimeDeploymentStrategy, type RuntimeLineage, type RuntimeSignalEvaluationRecord, type RuntimeSignalEvaluationStatus, type RuntimeStrategyCloseNotification, type RuntimeStrategyConfigSnapshot, type RuntimeTradeExitType, type RuntimeTradeFillSource, type RuntimeTradeRecord, type RuntimeTradeStatus, type RuntimeTradeTelemetryQuality, type Signal, type SignalAnalysis, type SignalOrderStatus, type SimpleOrderLogData, type Sl, type SpreadRow, type Strategy, type StrategyAPI, type StrategyAPIEntryParams, type StrategyAPIExitParams, type StrategyAPIProtectParams, type StrategyAdditionalIndicatorsMap, type StrategyAiAdapter, type StrategyAiMode, type StrategyChartDetail, type StrategyChartMetric, type StrategyChartMetricTone, type StrategyChartOrder, type StrategyChartSnapshot, type StrategyChartsSnapshotResponse, type StrategyClosePlan, type StrategyConfig, type StrategyConfigGrid, type StrategyCoreRunner, type StrategyCreator, type StrategyCreatorParams, type StrategyDecision, type StrategyDecisionPriceContext, type StrategyDirectionalTpSlParams, type StrategyDirectionalTpSlResult, type StrategyEntryBaseParams, type StrategyEntryModelFigures, type StrategyEntryOrderPlan, type StrategyEntryRuntimeBaseParams, type StrategyEntryRuntimeBuilderParams, type StrategyEntryRuntimeOptions, type StrategyEntrySignalContext, type StrategyEntrySignalDecisionBuilderParams, type StrategyEntryTakeProfitsParams, type StrategyFigureAnnotation, type StrategyFigureLine, type StrategyFigurePoint, type StrategyFigurePoints, type StrategyFigureZone, type StrategyHookAfterAiContext, type StrategyHookAfterDecisionContext, type StrategyHookAfterPlaceOrderContext, type StrategyHookAiContext, type StrategyHookAiSkippedReason, type StrategyHookBarContext, type StrategyHookBeforeCloseContext, type StrategyHookBeforeEntryGateContext, type StrategyHookBeforePlaceOrderContext, type StrategyHookCtx, type StrategyHookEnrichContext, type StrategyHookEntryContext, type StrategyHookErrorContext, type StrategyHookErrorPayload, type StrategyHookGateResult, type StrategyHookInitContext, type StrategyHookMarketContext, type StrategyHookMlContext, type StrategyHookMlSkippedReason, type StrategyHookOrderContext, type StrategyHookPolicyContext, type StrategyHookSkipContext, type StrategyHookStage, type StrategyIndicatorsContext, type StrategyIndicatorsMap, type StrategyIndicatorsState, type StrategyLastTradeController, type StrategyLastTradeControllerParams, type StrategyManifest, type StrategyMarketContextSource, type StrategyMlAdapter, type StrategyPluginDefinition, type StrategyPolicyProfile, type StrategyProtectPlan, type StrategyRegistryEntry, type StrategyResultConfig, type StrategyResultEntry, type StrategyResults, type StrategyRuntimeAiOptions, type StrategyRuntimeMlOptions, type StrategySharedReplayStateGetter, type StrategySignalMetaParams, type StrategySignalPriceParams, type StrategyStateController, type StrategyStateControllerOptions, type Test, type TestClosedSignalResult, type TestCompare, type TestCompareList, type TestConnector, type TestConnectorContext, type TestConnectorCreator, type TestResult, type TestStat, type TestSuite, type TestThresholds, type TestThresholdsKey, type TestTradeExitReason, type TestTradeResult, type TestWorkerResult, type TestingBox, type TestingBoxResult, type TestingOptions, type ThresholdLevel, type Ticker, type TickerQuery, type TopOfBookTicker, type Tp, type TradingAccountRef, type TradingFeeRate, type Trend, type TrendLine, type TrendLineMode, type TrendLineOptions, isMarketUniverse, resolveConnectorUniverse };
+declare const STRATEGY_RELEASE_SCHEMA: "tradejs-strategy-release/v1";
+declare const STRATEGY_EVIDENCE_MARKERS_SCHEMA: "tradejs-strategy-evidence-markers/v1";
+declare const STRATEGY_LIVE_DIAGNOSIS_SCHEMA: "tradejs-strategy-live-diagnosis/v1";
+type StrategyReleaseVerdict = 'READY_FOR_RUNTIME' | 'UNSUITABLE_FOR_CURRENT_MARKET' | 'INSUFFICIENT_EVIDENCE';
+type StrategyReleaseResearchDecisionAction = 'REPAIR_RECENT_DIRECTION' | 'START_MICRO_FORWARD' | 'MICRO_FORWARD_READY' | 'FORWARD_BLOCKED' | 'STOP_RESEARCH';
+type StrategyReleaseResearchDecisionBlocker = 'HISTORICAL_MATRIX_INCOMPLETE' | 'HISTORICAL_EDGE_FAILED' | 'CANDIDATE_NOT_IMPLEMENTED' | 'FULL_PERIOD_CHART_MISSING' | 'FORWARD_NOT_AUTHORIZED' | 'RUNTIME_TARGET_UNRESOLVED' | 'FORWARD_RISK_MUST_BE_ONE';
+type StrategyReleaseHistoricalWindow = {
+    days: number;
+    coveredDays?: number;
+    pnl: number;
+    profitFactor: number;
+    long: {
+        pnl: number;
+        profitFactor: number;
+    };
+    short: {
+        pnl: number;
+        profitFactor: number;
+    };
+};
+type StrategyReleaseResearchDecisionInput = {
+    strategy: string;
+    historicalWindows: StrategyReleaseHistoricalWindow[];
+    candidateImplemented: boolean;
+    exposedEvaluation: boolean;
+    chartArtifact: {
+        path: string;
+        sha256: string;
+    } | null;
+    recentFailure: {
+        days: number;
+        direction: 'LONG' | 'SHORT';
+        closedTrades: number;
+        causalMechanismIdentified: boolean;
+        repairRoundsUsed: number;
+    } | null;
+    forwardTest: {
+        authorized: boolean;
+        runtimeTarget: {
+            userName: string;
+            deploymentId: string;
+            accountId: string;
+            strategyConfigName: string;
+        } | null;
+        maxLossValue: number;
+    };
+};
+type StrategyReleaseResearchDecision = {
+    strategy: string;
+    action: StrategyReleaseResearchDecisionAction;
+    repairAllowed: boolean;
+    targetDirection: 'LONG' | 'SHORT' | null;
+    maxLossValue: 1 | null;
+    blockers: StrategyReleaseResearchDecisionBlocker[];
+    summary: string;
+};
+type StrategyReleaseReason = 'NO_VERIFIED_CORE_EDGE' | 'AI_GATE_ADDS_NO_VALUE' | 'CURRENT_REGIME_UNSUITABLE' | 'RUNTIME_PARITY_BLOCKED' | 'EXECUTION_MODEL_UNSAFE' | 'RESEARCH_BUDGET_EXHAUSTED' | 'EVIDENCE_INCOMPLETE';
+type StrategyEvidenceMarkerType = 'G' | 'L' | 'E' | 'D' | 'P' | 'R';
+type StrategyEvidenceMarker = {
+    id: string;
+    type: StrategyEvidenceMarkerType;
+    timestamp: number;
+    label: string;
+    summary: string;
+    artifactId: string;
+    artifactSha256: string;
+    compositionId?: string;
+    gitSha?: string;
+    gateFingerprint?: string;
+    configFingerprint?: string;
+    contextFingerprint?: string;
+    maxLossValue?: number;
+    severity?: 'info' | 'warning' | 'blocking';
+    coverage?: {
+        startTime: number;
+        endTime: number;
+    };
+};
+type StrategyEvidenceTimeline = {
+    status: 'verified' | 'missing' | 'invalid';
+    observedFrom: number | null;
+    markers: StrategyEvidenceMarker[];
+};
+type StrategyEvidenceTimelineSelector = {
+    strategy: string;
+    compositionId?: string | null;
+    gitSha?: string | null;
+    gateFingerprint?: string | null;
+    configFingerprint?: string | null;
+    contextFingerprint?: string | null;
+    maxLossValue?: number | null;
+    requireCompleteLineage?: boolean;
+};
+type StrategyEvidenceMarkerPayload = {
+    strategy: string;
+    createdAt: number;
+    markers: StrategyEvidenceMarker[];
+    sourceArtifacts: Array<{
+        artifactId: string;
+        sha256: string;
+        path?: string;
+    }>;
+};
+type StrategyEvidenceMarkerEnvelope = {
+    schema: typeof STRATEGY_EVIDENCE_MARKERS_SCHEMA;
+    artifactId: string;
+    payloadSha256: string;
+    payload: StrategyEvidenceMarkerPayload;
+};
+type StrategyReleaseEvidenceReference = {
+    kind: 'core_research' | 'ai_gate' | 'runtime_parity' | 'execution_calibration' | 'runtime_evidence' | 'runtime_scorecard';
+    artifactId: string;
+    path: string;
+    sha256: string;
+    verified: boolean;
+    lineage?: {
+        strategy: string | null;
+        gitSha: string | null;
+        gitDirty: boolean | null;
+        coreConfigSha256: string | null;
+        gateConfigIdsFingerprint: string | null;
+        gateFingerprint: string | null;
+        runtimeConfigFingerprint: string | null;
+        gateContextFingerprint: string | null;
+        runtimeContextFingerprint: string | null;
+        maxLossValue: number | null;
+        sourceSha256s: string[];
+    };
+    releaseAssertions?: Partial<{
+        coreEdgeVerified: boolean;
+        aiGateAddsValue: boolean;
+        currentMarketSuitable: boolean;
+        runtimeParityVerified: boolean;
+        executionModelVerified: boolean;
+    }>;
+};
+type StrategyReleaseManifest = {
+    schema: typeof STRATEGY_RELEASE_SCHEMA;
+    releaseId: string;
+    strategy: string;
+    createdAt: number;
+    composition: {
+        compositionId: string;
+        gitSha: string;
+        coreConfigSha256: string;
+        coreExportSha256: string;
+        gateConfigIdsFingerprint: string;
+        runtimeConfigFingerprint: string;
+        gateFingerprint: string;
+        gateContextFingerprint: string;
+        runtimeContextFingerprint: string;
+        maxLossValue: number;
+        longEnabled: boolean;
+        shortEnabled: boolean;
+    };
+    marketWindow: {
+        startTime: number;
+        endTime: number;
+        universeSha256: string;
+        symbols: number;
+        cacheOnly: true;
+        terminalDays: number[];
+    };
+    researchBudget: {
+        hypothesisFamilies: number;
+        maximumVariantsPerFamily: number;
+        isolatedLongFinalists: number;
+        aiGateTuningRounds: number;
+    };
+    evidence: StrategyReleaseEvidenceReference[];
+    gates: {
+        coreEdgeVerified: boolean;
+        aiGateAddsValue: boolean;
+        currentMarketSuitable: boolean;
+        runtimeParityVerified: boolean;
+        executionModelVerified: boolean;
+    };
+    monitoring: {
+        minimumProspectiveClosedTrades: number;
+        minimumParityRatio: number;
+        maximumOrderFailureRate: number;
+        drawdownEnvelopes: Array<{
+            days: number;
+            p95: number;
+            maximum: number;
+        }>;
+        rawCoreExpectancy: number | null;
+        aiGateExpectancy: number | null;
+        minimumRegimeCoverage: number;
+        overfitProbability: number | null;
+    };
+    verdict: {
+        status: StrategyReleaseVerdict;
+        reasons: StrategyReleaseReason[];
+        summary: string;
+    };
+    prospective: {
+        status: 'not_started' | 'incubating' | 'sufficient' | 'blocked';
+        evidenceBooks: Array<'micro_live' | 'shadow_composition' | 'shadow_raw_core' | 'gate_comparison'>;
+        llmComparatorPolicy: 'ai_approved_only' | 'all_core_candidates' | 'disabled';
+    };
+};
+type StrategyReleaseEnvelope = {
+    schema: 'tradejs-strategy-release-envelope/v1';
+    releaseId: string;
+    manifestSha256: string;
+    manifest: StrategyReleaseManifest;
+};
+type StrategyLiveDiagnosisVerdict = 'RUNTIME_DIVERGENCE' | 'EXPECTED_DRAWDOWN' | 'GENERALIZATION_FAILURE' | 'INSUFFICIENT_EVIDENCE';
+type StrategyLiveDiagnosis = {
+    schema: typeof STRATEGY_LIVE_DIAGNOSIS_SCHEMA;
+    strategy: string;
+    compositionId: string;
+    createdAt: number;
+    verdict: StrategyLiveDiagnosisVerdict;
+    subtype: 'RAW_CORE_DECAY' | 'AI_GATE_FAILURE' | 'REGIME_SHIFT' | 'SUSPECTED_HISTORICAL_OVERFIT' | null;
+    confidence: 'low' | 'medium' | 'high';
+    evidence: {
+        lineageComparable: boolean;
+        riskScaleComparable: boolean;
+        releaseMaxLossValue: number | null;
+        runtimeMaxLossValue: number | null;
+        riskScaleRatio: number | null;
+        parityRatio: number | null;
+        orderFailureRate: number | null;
+        observedDrawdown: number | null;
+        normalizedObservedDrawdown: number | null;
+        historicalDrawdownP95: number | null;
+        historicalDrawdownMaximum: number | null;
+        closedTrades: number;
+        rawCoreExpectancyDelta: number | null;
+        aiGateAddedValue: number | null;
+        regimeCoverage: number | null;
+        overfitProbability: number | null;
+    };
+    explanation: string;
+    recommendations: string[];
+};
+type StrategyLiveDiagnosisEnvelope = {
+    schema: 'tradejs-strategy-live-diagnosis-envelope/v1';
+    diagnosisId: string;
+    diagnosisSha256: string;
+    diagnosis: StrategyLiveDiagnosis;
+};
+type StrategyEvidenceRetentionEntry = {
+    path: string;
+    kind: 'operational_redis' | 'verbose_payload' | 'verified_runtime_bundle' | 'compact_ledger';
+    createdAt: number;
+    verified: boolean;
+    aggregated: boolean;
+    bytes: number;
+};
+type StrategyEvidenceRetentionPlan = {
+    keep: StrategyEvidenceRetentionEntry[];
+    delete: StrategyEvidenceRetentionEntry[];
+    bytesReclaimable: number;
+};
+export { type AIChatHistory, type AIChatMessage, type AggTrade, type AggTradesRequest, type AiDatasetRow, type AiPayload, type AiPromptPair, type AssetClass, BACKTEST_WARNING_CODES, type BacktestDetectorOptimizedStrategy, type BacktestPriceMode, type BacktestRunConfig, type BacktestWarningCode, type BacktestWarningCounts, type BaseContextGateFeatures, type BaseGateFeatureApproveBias, type BaseGateFeatureConfirmation, type BaseGateFeatureConflict, type BaseGateFeatureEntryLocation, type BaseGateFeaturePrimaryIssue, type BaseGateFeatureRiskLevel, type BaseGateFeatureScoreKey, type BaseHyperliquidWhaleFlowContext, type BaseIndicatorsHistorySnapshot, type BaseMarketBreadthContext, type BaseMarketBreadthsContext, type BaseMarketTradeFlowContext, type BaseMultiTimeframeContext, type BaseParticipationContext, type BasePsychologicalLevelAssetContext, type BasePsychologicalLevelWindowContext, type BaseRawIndicatorSnapshot, type BaseRegimeContext, type BaseRelativeContext, type BaseStrategyContextSnapshot, type BaseStructureContext, type Bot, type BotConfig, type BotResults, type BotStatus, type BuildStrategySignalDraft, type BuildStrategySignalParams, type Candle, type ChartColor, type ClosedPnlRecord, type CmcExchangeLiquidityRegime, type CmcFearGreedClassification, type CmcFearGreedRegime, type CompletedTest, type Connector, type ConnectorCapabilities, type ConnectorConfig, type ConnectorCreator, type ConnectorPluginDefinition, type ConnectorRegistryEntry, type CoreResearchTraceEvent, type CreateStrategyCore, type CreateStrategyCoreParams, DEFAULT_MARKET_UNIVERSE, type DerivativesContext, type DerivativesContextRiskFlag, type DerivativesInterval, type DerivativesIntervalContext, type DerivativesPressure, type DerivativesPriceOiDivergenceType, type DerivativesRow, type DerivativesSymbolContext, type DerivativesTargetDerivedContext, type Direction, type EOMPoint, type ExchangeEntryRecord, type ExecutionCostModel, type ExecutionCostQuality, type ExecutionCostSource, type Filters, type FundingRateHistoryRequest, type FundingRatePoint, type GetAggTrades, type GetClosedPnlParams, type GetFundingRateHistory, type GetOrderBookDepth, type GetTickers, type GetTopOfBookTicker, type GetTradingFeeRate, HYPERLIQUID_WHALE_DATA_MODEL_VERSION, type HyperliquidPositionAction, type HyperliquidWhaleCoverageRow, type HyperliquidWhaleFlowRow, type HyperliquidWhaleTradeEventRow, type Indicator, type IndicatorPluginComputeParams, type IndicatorPluginDefinition, type IndicatorPluginEntry, type IndicatorPluginFigureRenderer, type IndicatorPluginRenderer, type IndicatorSnapshot, type Indicators, type IndicatorsHistorySnapshot, type InstrumentDescriptor, type InstrumentKind, type InstrumentQuery, type InstrumentStatus, type Interval, type Item, type Items, type Kline, type KlineChartData, type KlineChartItem, type KlineRequest, type ListInstruments, type MarketBreadthRow, type MarketCmcExchangeLiquidityContextRow, type MarketCmcFearGreedContextRow, type MarketCmcIndexConstituent, type MarketCmcIndexContextRow, type MarketCmcIndexSlug, type MarketDataCapability, type MarketFeatureInterval, type MarketGlobalContextRow, type MarketGlobalContextSource, type MarketKlineEvent, type MarketReferenceAssetContextRow, type MarketTradeFlowRow, type MarketUniverse, type MetricThreshold, type Metrics, type MinimalStat, type MlCandleIndicatorsSnapshot, type MonthlyEquityStats, type OnChangeCompare, type Order, type OrderBookDepth, type OrderBookDepthRequest, type OrderLog, type OrderLogData, type OrderPositionIntent, type OrderType, type Position, type PositionLog, type PositionLogData, type PositionPnlSnapshot, type Provider, type RuntimeAiAnalysisSnapshot, type RuntimeDeployment, type RuntimeDeploymentHeartbeat, type RuntimeDeploymentStrategy, type RuntimeLineage, type RuntimeSignalEvaluationRecord, type RuntimeSignalEvaluationStatus, type RuntimeStrategyCloseNotification, type RuntimeStrategyConfigSnapshot, type RuntimeTradeExitType, type RuntimeTradeFillSource, type RuntimeTradeRecord, type RuntimeTradeStatus, type RuntimeTradeTelemetryQuality, STRATEGY_EVIDENCE_MARKERS_SCHEMA, STRATEGY_LIVE_DIAGNOSIS_SCHEMA, STRATEGY_RELEASE_SCHEMA, type Signal, type SignalAnalysis, type SignalOrderStatus, type SimpleOrderLogData, type Sl, type SpreadRow, type Strategy, type StrategyAPI, type StrategyAPIEntryParams, type StrategyAPIExitParams, type StrategyAPIProtectParams, type StrategyAdditionalIndicatorsMap, type StrategyAiAdapter, type StrategyAiMode, type StrategyChartDetail, type StrategyChartMetric, type StrategyChartMetricTone, type StrategyChartOrder, type StrategyChartSnapshot, type StrategyChartsSnapshotResponse, type StrategyClosePlan, type StrategyConfig, type StrategyConfigGrid, type StrategyCoreRunner, type StrategyCreator, type StrategyCreatorParams, type StrategyDecision, type StrategyDecisionPriceContext, type StrategyDirectionalTpSlParams, type StrategyDirectionalTpSlResult, type StrategyEntryBaseParams, type StrategyEntryModelFigures, type StrategyEntryOrderPlan, type StrategyEntryRuntimeBaseParams, type StrategyEntryRuntimeBuilderParams, type StrategyEntryRuntimeOptions, type StrategyEntrySignalContext, type StrategyEntrySignalDecisionBuilderParams, type StrategyEntryTakeProfitsParams, type StrategyEvidenceMarker, type StrategyEvidenceMarkerEnvelope, type StrategyEvidenceMarkerPayload, type StrategyEvidenceMarkerType, type StrategyEvidenceRetentionEntry, type StrategyEvidenceRetentionPlan, type StrategyEvidenceTimeline, type StrategyEvidenceTimelineSelector, type StrategyFigureAnnotation, type StrategyFigureLine, type StrategyFigurePoint, type StrategyFigurePoints, type StrategyFigureZone, type StrategyHookAfterAiContext, type StrategyHookAfterDecisionContext, type StrategyHookAfterPlaceOrderContext, type StrategyHookAiContext, type StrategyHookAiSkippedReason, type StrategyHookBarContext, type StrategyHookBeforeCloseContext, type StrategyHookBeforeEntryGateContext, type StrategyHookBeforePlaceOrderContext, type StrategyHookCtx, type StrategyHookEnrichContext, type StrategyHookEntryContext, type StrategyHookErrorContext, type StrategyHookErrorPayload, type StrategyHookGateResult, type StrategyHookInitContext, type StrategyHookMarketContext, type StrategyHookMlContext, type StrategyHookMlSkippedReason, type StrategyHookOrderContext, type StrategyHookPolicyContext, type StrategyHookSkipContext, type StrategyHookStage, type StrategyIndicatorsContext, type StrategyIndicatorsMap, type StrategyIndicatorsState, type StrategyLastTradeController, type StrategyLastTradeControllerParams, type StrategyLiveDiagnosis, type StrategyLiveDiagnosisEnvelope, type StrategyLiveDiagnosisVerdict, type StrategyManifest, type StrategyMarketContextSource, type StrategyMlAdapter, type StrategyPluginDefinition, type StrategyPolicyProfile, type StrategyProtectPlan, type StrategyRegistryEntry, type StrategyReleaseEnvelope, type StrategyReleaseEvidenceReference, type StrategyReleaseHistoricalWindow, type StrategyReleaseManifest, type StrategyReleaseReason, type StrategyReleaseResearchDecision, type StrategyReleaseResearchDecisionAction, type StrategyReleaseResearchDecisionBlocker, type StrategyReleaseResearchDecisionInput, type StrategyReleaseVerdict, type StrategyResultConfig, type StrategyResultEntry, type StrategyResults, type StrategyRuntimeAiOptions, type StrategyRuntimeMlOptions, type StrategySharedReplayStateGetter, type StrategySignalMetaParams, type StrategySignalPriceParams, type StrategyStateController, type StrategyStateControllerOptions, type Test, type TestClosedSignalResult, type TestCompare, type TestCompareList, type TestConnector, type TestConnectorContext, type TestConnectorCreator, type TestResult, type TestStat, type TestSuite, type TestThresholds, type TestThresholdsKey, type TestTradeExitReason, type TestTradeResult, type TestWorkerResult, type TestingBox, type TestingBoxResult, type TestingOptions, type ThresholdLevel, type Ticker, type TickerQuery, type TopOfBookTicker, type Tp, type TradingAccountRef, type TradingFeeRate, type Trend, type TrendLine, type TrendLineMode, type TrendLineOptions, isMarketUniverse, resolveConnectorUniverse };

package/dist/index.js CHANGED Viewed

@@ -23,6 +23,9 @@ __export(index_exports, {
   BACKTEST_WARNING_CODES: () => BACKTEST_WARNING_CODES,
   DEFAULT_MARKET_UNIVERSE: () => DEFAULT_MARKET_UNIVERSE,
   HYPERLIQUID_WHALE_DATA_MODEL_VERSION: () => HYPERLIQUID_WHALE_DATA_MODEL_VERSION,
+  STRATEGY_EVIDENCE_MARKERS_SCHEMA: () => STRATEGY_EVIDENCE_MARKERS_SCHEMA,
+  STRATEGY_LIVE_DIAGNOSIS_SCHEMA: () => STRATEGY_LIVE_DIAGNOSIS_SCHEMA,
+  STRATEGY_RELEASE_SCHEMA: () => STRATEGY_RELEASE_SCHEMA,
   isMarketUniverse: () => isMarketUniverse,
   resolveConnectorUniverse: () => resolveConnectorUniverse
 });
@@ -51,11 +54,19 @@ var resolveConnectorUniverse = (capabilities, requested) => {
   }
   return requested;
 };
+// src/strategyRelease.ts
+var STRATEGY_RELEASE_SCHEMA = "tradejs-strategy-release/v1";
+var STRATEGY_EVIDENCE_MARKERS_SCHEMA = "tradejs-strategy-evidence-markers/v1";
+var STRATEGY_LIVE_DIAGNOSIS_SCHEMA = "tradejs-strategy-live-diagnosis/v1";
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   BACKTEST_WARNING_CODES,
   DEFAULT_MARKET_UNIVERSE,
   HYPERLIQUID_WHALE_DATA_MODEL_VERSION,
+  STRATEGY_EVIDENCE_MARKERS_SCHEMA,
+  STRATEGY_LIVE_DIAGNOSIS_SCHEMA,
+  STRATEGY_RELEASE_SCHEMA,
   isMarketUniverse,
   resolveConnectorUniverse
 });

package/dist/index.mjs CHANGED Viewed

@@ -21,10 +21,18 @@ var resolveConnectorUniverse = (capabilities, requested) => {
   }
   return requested;
 };
+// src/strategyRelease.ts
+var STRATEGY_RELEASE_SCHEMA = "tradejs-strategy-release/v1";
+var STRATEGY_EVIDENCE_MARKERS_SCHEMA = "tradejs-strategy-evidence-markers/v1";
+var STRATEGY_LIVE_DIAGNOSIS_SCHEMA = "tradejs-strategy-live-diagnosis/v1";
 export {
   BACKTEST_WARNING_CODES,
   DEFAULT_MARKET_UNIVERSE,
   HYPERLIQUID_WHALE_DATA_MODEL_VERSION,
+  STRATEGY_EVIDENCE_MARKERS_SCHEMA,
+  STRATEGY_LIVE_DIAGNOSIS_SCHEMA,
+  STRATEGY_RELEASE_SCHEMA,
   isMarketUniverse,
   resolveConnectorUniverse
 };

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@tradejs/types",
-  "version": "2.0.19",
+  "version": "2.0.20",
   "description": "MIT-licensed shared TypeScript contracts for the TradeJS framework.",
   "keywords": [
     "tradejs",