backtest-kit 1.5.38 → 1.5.39

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "backtest-kit",
-  "version": "1.5.38",
+  "version": "1.5.39",
   "description": "A TypeScript library for trading system backtest",
   "author": {
     "name": "Petr Tripolsky",

package/types.d.ts

@@ -1112,359 +1112,6 @@ interface WalkerStatisticsModel extends WalkerCompleteContract {
     strategyResults: IStrategyResult[];
 }
 
-/**
- * Unified scheduled signal event data for report generation.
- * Contains all information about scheduled, opened and cancelled events.
- */
-interface ScheduledEvent {
-    /** Event timestamp in milliseconds (scheduledAt for scheduled/cancelled events) */
-    timestamp: number;
-    /** Event action type */
-    action: "scheduled" | "opened" | "cancelled";
-    /** Trading pair symbol */
-    symbol: string;
-    /** Signal ID */
-    signalId: string;
-    /** Position type */
-    position: string;
-    /** Signal note */
-    note?: string;
-    /** Current market price */
-    currentPrice: number;
-    /** Scheduled entry price */
-    priceOpen: number;
-    /** Take profit price */
-    takeProfit: number;
-    /** Stop loss price */
-    stopLoss: number;
-    /** Close timestamp (only for cancelled) */
-    closeTimestamp?: number;
-    /** Duration in minutes (only for cancelled/opened) */
-    duration?: number;
-}
-/**
- * Statistical data calculated from scheduled signals.
- *
- * Provides metrics for scheduled signal tracking, activation and cancellation analysis.
- *
- * @example
- * ```typescript
- * const stats = await Schedule.getData("my-strategy");
- *
- * console.log(`Total events: ${stats.totalEvents}`);
- * console.log(`Scheduled signals: ${stats.totalScheduled}`);
- * console.log(`Opened signals: ${stats.totalOpened}`);
- * console.log(`Cancelled signals: ${stats.totalCancelled}`);
- * console.log(`Cancellation rate: ${stats.cancellationRate}%`);
- *
- * // Access raw event data (includes scheduled, opened, cancelled)
- * stats.eventList.forEach(event => {
- *   if (event.action === "cancelled") {
- *     console.log(`Cancelled signal: ${event.signalId}`);
- *   }
- * });
- * ```
- */
-interface ScheduleStatisticsModel {
-    /** Array of all scheduled/opened/cancelled events with full details */
-    eventList: ScheduledEvent[];
-    /** Total number of all events (includes scheduled, opened, cancelled) */
-    totalEvents: number;
-    /** Total number of scheduled signals */
-    totalScheduled: number;
-    /** Total number of opened signals (activated from scheduled) */
-    totalOpened: number;
-    /** Total number of cancelled signals */
-    totalCancelled: number;
-    /** Cancellation rate as percentage (0-100), null if no scheduled signals. Lower is better. */
-    cancellationRate: number | null;
-    /** Activation rate as percentage (0-100), null if no scheduled signals. Higher is better. */
-    activationRate: number | null;
-    /** Average waiting time for cancelled signals in minutes, null if no cancelled signals */
-    avgWaitTime: number | null;
-    /** Average waiting time for opened signals in minutes, null if no opened signals */
-    avgActivationTime: number | null;
-}
-
-/**
- * Risk rejection event data for report generation.
- * Contains all information about rejected signals due to risk limits.
- */
-interface RiskEvent {
-    /** Event timestamp in milliseconds */
-    timestamp: number;
-    /** Trading pair symbol */
-    symbol: string;
-    /** Pending signal details */
-    pendingSignal: ISignalDto;
-    /** Strategy name */
-    strategyName: string;
-    /** Exchange name */
-    exchangeName: string;
-    /** Current market price */
-    currentPrice: number;
-    /** Number of active positions at rejection time */
-    activePositionCount: number;
-    /** Rejection reason from validation note */
-    comment: string;
-    /** Whether this event is from backtest mode (true) or live mode (false) */
-    backtest: boolean;
-}
-/**
- * Statistical data calculated from risk rejection events.
- *
- * Provides metrics for risk management tracking.
- *
- * @example
- * ```typescript
- * const stats = await Risk.getData("BTCUSDT", "my-strategy");
- *
- * console.log(`Total rejections: ${stats.totalRejections}`);
- * console.log(`Rejections by symbol:`, stats.bySymbol);
- * ```
- */
-interface RiskStatisticsModel {
-    /** Array of all risk rejection events with full details */
-    eventList: RiskEvent[];
-    /** Total number of risk rejections */
-    totalRejections: number;
-    /** Rejections grouped by symbol */
-    bySymbol: Record<string, number>;
-    /** Rejections grouped by strategy */
-    byStrategy: Record<string, number>;
-}
-
-/**
- * Performance metric types tracked by the system.
- *
- * Backtest metrics:
- * - backtest_total: Total backtest duration from start to finish
- * - backtest_timeframe: Duration to process a single timeframe iteration
- * - backtest_signal: Duration to process a signal (tick + getNextCandles + backtest)
- *
- * Live metrics:
- * - live_tick: Duration of a single live tick iteration
- */
-type PerformanceMetricType = "backtest_total" | "backtest_timeframe" | "backtest_signal" | "live_tick";
-/**
- * Contract for performance tracking events.
- *
- * Emitted during execution to track performance metrics for various operations.
- * Useful for profiling and identifying bottlenecks.
- *
- * @example
- * ```typescript
- * import { listenPerformance } from "backtest-kit";
- *
- * listenPerformance((event) => {
- *   console.log(`${event.metricType}: ${event.duration.toFixed(2)}ms`);
- *   console.log(`${event.strategyName} @ ${event.exchangeName}`);
- * });
- * ```
- */
-interface PerformanceContract {
-    /** Timestamp when the metric was recorded (milliseconds since epoch) */
-    timestamp: number;
-    /** Timestamp of the previous event (milliseconds since epoch, null for first event) */
-    previousTimestamp: number | null;
-    /** Type of operation being measured */
-    metricType: PerformanceMetricType;
-    /** Duration of the operation in milliseconds */
-    duration: number;
-    /** Strategy name associated with this metric */
-    strategyName: string;
-    /** Exchange name associated with this metric */
-    exchangeName: string;
-    /** Trading symbol associated with this metric */
-    symbol: string;
-    /** Whether this metric is from backtest mode (true) or live mode (false) */
-    backtest: boolean;
-}
-
-/**
- * Aggregated statistics for a specific metric type.
- */
-interface MetricStats {
-    /** Type of metric */
-    metricType: PerformanceMetricType;
-    /** Number of recorded samples */
-    count: number;
-    /** Total duration across all samples (ms) */
-    totalDuration: number;
-    /** Average duration (ms) */
-    avgDuration: number;
-    /** Minimum duration (ms) */
-    minDuration: number;
-    /** Maximum duration (ms) */
-    maxDuration: number;
-    /** Standard deviation of duration (ms) */
-    stdDev: number;
-    /** Median duration (ms) */
-    median: number;
-    /** 95th percentile duration (ms) */
-    p95: number;
-    /** 99th percentile duration (ms) */
-    p99: number;
-    /** Average wait time between events (ms) */
-    avgWaitTime: number;
-    /** Minimum wait time between events (ms) */
-    minWaitTime: number;
-    /** Maximum wait time between events (ms) */
-    maxWaitTime: number;
-}
-/**
- * Performance statistics aggregated by strategy.
- */
-interface PerformanceStatisticsModel {
-    /** Strategy name */
-    strategyName: string;
-    /** Total number of performance events recorded */
-    totalEvents: number;
-    /** Total execution time across all metrics (ms) */
-    totalDuration: number;
-    /** Statistics grouped by metric type */
-    metricStats: Record<string, MetricStats>;
-    /** All raw performance events */
-    events: PerformanceContract[];
-}
-
-/**
- * Unified partial profit/loss event data for report generation.
- * Contains all information about profit and loss level milestones.
- */
-interface PartialEvent {
-    /** Event timestamp in milliseconds */
-    timestamp: number;
-    /** Event action type (profit or loss) */
-    action: "profit" | "loss";
-    /** Trading pair symbol */
-    symbol: string;
-    /** Strategy name */
-    strategyName: string;
-    /** Signal ID */
-    signalId: string;
-    /** Position type */
-    position: string;
-    /** Current market price */
-    currentPrice: number;
-    /** Profit/loss level reached (10, 20, 30, etc) */
-    level: PartialLevel;
-    /** True if backtest mode, false if live mode */
-    backtest: boolean;
-}
-/**
- * Statistical data calculated from partial profit/loss events.
- *
- * Provides metrics for partial profit/loss milestone tracking.
- *
- * @example
- * ```typescript
- * const stats = await Partial.getData("BTCUSDT", "my-strategy");
- *
- * console.log(`Total events: ${stats.totalEvents}`);
- * console.log(`Profit events: ${stats.totalProfit}`);
- * console.log(`Loss events: ${stats.totalLoss}`);
- * ```
- */
-interface PartialStatisticsModel {
-    /** Array of all profit/loss events with full details */
-    eventList: PartialEvent[];
-    /** Total number of all events (includes profit, loss) */
-    totalEvents: number;
-    /** Total number of profit events */
-    totalProfit: number;
-    /** Total number of loss events */
-    totalLoss: number;
-}
-
-/**
- * Unified tick event data for report generation.
- * Contains all information about a tick event regardless of action type.
- */
-interface TickEvent {
-    /** Event timestamp in milliseconds (pendingAt for opened/closed events) */
-    timestamp: number;
-    /** Event action type */
-    action: "idle" | "opened" | "active" | "closed";
-    /** Trading pair symbol (only for non-idle events) */
-    symbol?: string;
-    /** Signal ID (only for opened/active/closed) */
-    signalId?: string;
-    /** Position type (only for opened/active/closed) */
-    position?: string;
-    /** Signal note (only for opened/active/closed) */
-    note?: string;
-    /** Current price */
-    currentPrice: number;
-    /** Open price (only for opened/active/closed) */
-    openPrice?: number;
-    /** Take profit price (only for opened/active/closed) */
-    takeProfit?: number;
-    /** Stop loss price (only for opened/active/closed) */
-    stopLoss?: number;
-    /** Percentage progress towards take profit (only for active) */
-    percentTp?: number;
-    /** Percentage progress towards stop loss (only for active) */
-    percentSl?: number;
-    /** PNL percentage (only for closed) */
-    pnl?: number;
-    /** Close reason (only for closed) */
-    closeReason?: string;
-    /** Duration in minutes (only for closed) */
-    duration?: number;
-}
-/**
- * Statistical data calculated from live trading results.
- *
- * All numeric values are null if calculation is unsafe (NaN, Infinity, etc).
- * Provides comprehensive metrics for live trading performance analysis.
- *
- * @example
- * ```typescript
- * const stats = await Live.getData("my-strategy");
- *
- * console.log(`Total events: ${stats.totalEvents}`);
- * console.log(`Closed signals: ${stats.totalClosed}`);
- * console.log(`Win rate: ${stats.winRate}%`);
- * console.log(`Sharpe Ratio: ${stats.sharpeRatio}`);
- *
- * // Access raw event data (includes idle, opened, active, closed)
- * stats.eventList.forEach(event => {
- *   if (event.action === "closed") {
- *     console.log(`Closed signal: ${event.pnl}%`);
- *   }
- * });
- * ```
- */
-interface LiveStatisticsModel {
-    /** Array of all events (idle, opened, active, closed) with full details */
-    eventList: TickEvent[];
-    /** Total number of all events (includes idle, opened, active, closed) */
-    totalEvents: number;
-    /** Total number of closed signals only */
-    totalClosed: number;
-    /** Number of winning closed signals (PNL > 0) */
-    winCount: number;
-    /** Number of losing closed signals (PNL < 0) */
-    lossCount: number;
-    /** Win rate as percentage (0-100) based on closed signals, null if unsafe. Higher is better. */
-    winRate: number | null;
-    /** Average PNL per closed signal as percentage, null if unsafe. Higher is better. */
-    avgPnl: number | null;
-    /** Cumulative PNL across all closed signals as percentage, null if unsafe. Higher is better. */
-    totalPnl: number | null;
-    /** Standard deviation of returns (volatility metric), null if unsafe. Lower is better. */
-    stdDev: number | null;
-    /** Sharpe Ratio (risk-adjusted return = avgPnl / stdDev), null if unsafe. Higher is better. */
-    sharpeRatio: number | null;
-    /** Annualized Sharpe Ratio (sharpeRatio × √365), null if unsafe. Higher is better. */
-    annualizedSharpeRatio: number | null;
-    /** Certainty Ratio (avgWin / |avgLoss|), null if unsafe. Higher is better. */
-    certaintyRatio: number | null;
-    /** Expected yearly returns based on average trade duration and PNL, null if unsafe. Higher is better. */
-    expectedYearlyReturns: number | null;
-}
-
 declare const GLOBAL_CONFIG: {
     /**
      * Time to wait for scheduled signal to activate (in minutes)
@@ -3068,12 +2715,59 @@ interface ProgressOptimizerContract {
     optimizerName: string;
     /** symbol - Trading symbol (e.g., "BTCUSDT") */
     symbol: string;
-    /** totalSources - Total number of sources to process */
-    totalSources: number;
-    /** processedSources - Number of sources processed so far */
-    processedSources: number;
-    /** progress - Completion percentage from 0.0 to 1.0 */
-    progress: number;
+    /** totalSources - Total number of sources to process */
+    totalSources: number;
+    /** processedSources - Number of sources processed so far */
+    processedSources: number;
+    /** progress - Completion percentage from 0.0 to 1.0 */
+    progress: number;
+}
+
+/**
+ * Performance metric types tracked by the system.
+ *
+ * Backtest metrics:
+ * - backtest_total: Total backtest duration from start to finish
+ * - backtest_timeframe: Duration to process a single timeframe iteration
+ * - backtest_signal: Duration to process a signal (tick + getNextCandles + backtest)
+ *
+ * Live metrics:
+ * - live_tick: Duration of a single live tick iteration
+ */
+type PerformanceMetricType = "backtest_total" | "backtest_timeframe" | "backtest_signal" | "live_tick";
+/**
+ * Contract for performance tracking events.
+ *
+ * Emitted during execution to track performance metrics for various operations.
+ * Useful for profiling and identifying bottlenecks.
+ *
+ * @example
+ * ```typescript
+ * import { listenPerformance } from "backtest-kit";
+ *
+ * listenPerformance((event) => {
+ *   console.log(`${event.metricType}: ${event.duration.toFixed(2)}ms`);
+ *   console.log(`${event.strategyName} @ ${event.exchangeName}`);
+ * });
+ * ```
+ */
+interface PerformanceContract {
+    /** Timestamp when the metric was recorded (milliseconds since epoch) */
+    timestamp: number;
+    /** Timestamp of the previous event (milliseconds since epoch, null for first event) */
+    previousTimestamp: number | null;
+    /** Type of operation being measured */
+    metricType: PerformanceMetricType;
+    /** Duration of the operation in milliseconds */
+    duration: number;
+    /** Strategy name associated with this metric */
+    strategyName: string;
+    /** Exchange name associated with this metric */
+    exchangeName: string;
+    /** Trading symbol associated with this metric */
+    symbol: string;
+    /** Whether this metric is from backtest mode (true) or live mode (false) */
+    backtest: boolean;
 }
 
 /**
@@ -4342,123 +4036,429 @@ declare function getMode(): Promise<"backtest" | "live">;
  *       { role: "assistant", content: "Structure analyzed" }
  *     );
  *
- *     // Request signal
- *     messages.push({
- *       role: "user",
- *       content: "Generate trading signal. Use position: 'wait' if uncertain."
- *     });
+ *     // Request signal
+ *     messages.push({
+ *       role: "user",
+ *       content: "Generate trading signal. Use position: 'wait' if uncertain."
+ *     });
+ *
+ *     const resultId = uuid();
+ *     const signal = await llmRequest(messages);
+ *
+ *     // Save conversation and result for debugging
+ *     await dumpSignal(resultId, messages, signal);
+ *
+ *     return signal;
+ *   }
+ * });
+ *
+ * // Creates: ./dump/strategy/{uuid}/00_system_prompt.md
+ * //          ./dump/strategy/{uuid}/01_user_message.md (1h analysis)
+ * //          ./dump/strategy/{uuid}/02_assistant_message.md
+ * //          ./dump/strategy/{uuid}/03_user_message.md (5m analysis)
+ * //          ./dump/strategy/{uuid}/04_assistant_message.md
+ * //          ./dump/strategy/{uuid}/05_user_message.md (signal request)
+ * //          ./dump/strategy/{uuid}/06_llm_output.md (final signal)
+ * ```
+ */
+declare function dumpSignal(signalId: string | number, history: MessageModel[], signal: ISignalDto, outputDir?: string): Promise<void>;
+
+/**
+ * Portfolio heatmap statistics for a single symbol.
+ * Aggregated metrics across all strategies for one trading pair.
+ */
+interface IHeatmapRow {
+    /** Trading pair symbol (e.g., "BTCUSDT") */
+    symbol: string;
+    /** Total profit/loss percentage across all closed trades */
+    totalPnl: number | null;
+    /** Risk-adjusted return (Sharpe Ratio) */
+    sharpeRatio: number | null;
+    /** Maximum drawdown percentage (largest peak-to-trough decline) */
+    maxDrawdown: number | null;
+    /** Total number of closed trades */
+    totalTrades: number;
+    /** Number of winning trades */
+    winCount: number;
+    /** Number of losing trades */
+    lossCount: number;
+    /** Win rate percentage */
+    winRate: number | null;
+    /** Average PNL per trade */
+    avgPnl: number | null;
+    /** Standard deviation of PNL */
+    stdDev: number | null;
+    /** Profit factor: sum of wins / sum of losses */
+    profitFactor: number | null;
+    /** Average profit percentage on winning trades */
+    avgWin: number | null;
+    /** Average loss percentage on losing trades */
+    avgLoss: number | null;
+    /** Maximum consecutive winning trades */
+    maxWinStreak: number;
+    /** Maximum consecutive losing trades */
+    maxLossStreak: number;
+    /** Expectancy: (winRate * avgWin) - (lossRate * avgLoss) */
+    expectancy: number | null;
+}
+
+/**
+ * Column configuration for markdown table generation.
+ * Generic interface that defines how to extract and format data from any data type.
+ *
+ * @template T - The data type that this column will format
+ *
+ * @example
+ * ```typescript
+ * // Column for formatting signal data
+ * const signalColumn: ColumnModel<IStrategyTickResultClosed> = {
+ *   key: "pnl",
+ *   label: "PNL",
+ *   format: (signal) => `${signal.pnl.pnlPercentage.toFixed(2)}%`,
+ *   isVisible: () => true
+ * };
+ *
+ * // Column for formatting heatmap rows
+ * const heatmapColumn: ColumnModel<IHeatmapRow> = {
+ *   key: "symbol",
+ *   label: "Symbol",
+ *   format: (row) => row.symbol,
+ *   isVisible: () => true
+ * };
+ * ```
+ */
+interface ColumnModel<T extends object = any> {
+    /** Unique column identifier */
+    key: string;
+    /** Display label for column header */
+    label: string;
+    /** Formatting function to convert data to string */
+    format: (data: T, index: number) => string | Promise<string>;
+    /** Function to determine if column should be visible */
+    isVisible: () => boolean | Promise<boolean>;
+}
+
+/**
+ * Unified tick event data for report generation.
+ * Contains all information about a tick event regardless of action type.
+ */
+interface TickEvent {
+    /** Event timestamp in milliseconds (pendingAt for opened/closed events) */
+    timestamp: number;
+    /** Event action type */
+    action: "idle" | "opened" | "active" | "closed";
+    /** Trading pair symbol (only for non-idle events) */
+    symbol?: string;
+    /** Signal ID (only for opened/active/closed) */
+    signalId?: string;
+    /** Position type (only for opened/active/closed) */
+    position?: string;
+    /** Signal note (only for opened/active/closed) */
+    note?: string;
+    /** Current price */
+    currentPrice: number;
+    /** Open price (only for opened/active/closed) */
+    openPrice?: number;
+    /** Take profit price (only for opened/active/closed) */
+    takeProfit?: number;
+    /** Stop loss price (only for opened/active/closed) */
+    stopLoss?: number;
+    /** Percentage progress towards take profit (only for active) */
+    percentTp?: number;
+    /** Percentage progress towards stop loss (only for active) */
+    percentSl?: number;
+    /** PNL percentage (only for closed) */
+    pnl?: number;
+    /** Close reason (only for closed) */
+    closeReason?: string;
+    /** Duration in minutes (only for closed) */
+    duration?: number;
+}
+/**
+ * Statistical data calculated from live trading results.
+ *
+ * All numeric values are null if calculation is unsafe (NaN, Infinity, etc).
+ * Provides comprehensive metrics for live trading performance analysis.
+ *
+ * @example
+ * ```typescript
+ * const stats = await Live.getData("my-strategy");
+ *
+ * console.log(`Total events: ${stats.totalEvents}`);
+ * console.log(`Closed signals: ${stats.totalClosed}`);
+ * console.log(`Win rate: ${stats.winRate}%`);
+ * console.log(`Sharpe Ratio: ${stats.sharpeRatio}`);
+ *
+ * // Access raw event data (includes idle, opened, active, closed)
+ * stats.eventList.forEach(event => {
+ *   if (event.action === "closed") {
+ *     console.log(`Closed signal: ${event.pnl}%`);
+ *   }
+ * });
+ * ```
+ */
+interface LiveStatisticsModel {
+    /** Array of all events (idle, opened, active, closed) with full details */
+    eventList: TickEvent[];
+    /** Total number of all events (includes idle, opened, active, closed) */
+    totalEvents: number;
+    /** Total number of closed signals only */
+    totalClosed: number;
+    /** Number of winning closed signals (PNL > 0) */
+    winCount: number;
+    /** Number of losing closed signals (PNL < 0) */
+    lossCount: number;
+    /** Win rate as percentage (0-100) based on closed signals, null if unsafe. Higher is better. */
+    winRate: number | null;
+    /** Average PNL per closed signal as percentage, null if unsafe. Higher is better. */
+    avgPnl: number | null;
+    /** Cumulative PNL across all closed signals as percentage, null if unsafe. Higher is better. */
+    totalPnl: number | null;
+    /** Standard deviation of returns (volatility metric), null if unsafe. Lower is better. */
+    stdDev: number | null;
+    /** Sharpe Ratio (risk-adjusted return = avgPnl / stdDev), null if unsafe. Higher is better. */
+    sharpeRatio: number | null;
+    /** Annualized Sharpe Ratio (sharpeRatio × √365), null if unsafe. Higher is better. */
+    annualizedSharpeRatio: number | null;
+    /** Certainty Ratio (avgWin / |avgLoss|), null if unsafe. Higher is better. */
+    certaintyRatio: number | null;
+    /** Expected yearly returns based on average trade duration and PNL, null if unsafe. Higher is better. */
+    expectedYearlyReturns: number | null;
+}
+
+/**
+ * Portfolio heatmap statistics structure.
+ * Contains aggregated data for all symbols in the portfolio.
+ */
+interface HeatmapStatisticsModel {
+    /** Array of symbol statistics */
+    symbols: IHeatmapRow[];
+    /** Total number of symbols tracked */
+    totalSymbols: number;
+    /** Portfolio-wide total PNL */
+    portfolioTotalPnl: number | null;
+    /** Portfolio-wide Sharpe Ratio */
+    portfolioSharpeRatio: number | null;
+    /** Portfolio-wide total trades */
+    portfolioTotalTrades: number;
+}
+
+/**
+ * Unified scheduled signal event data for report generation.
+ * Contains all information about scheduled, opened and cancelled events.
+ */
+interface ScheduledEvent {
+    /** Event timestamp in milliseconds (scheduledAt for scheduled/cancelled events) */
+    timestamp: number;
+    /** Event action type */
+    action: "scheduled" | "opened" | "cancelled";
+    /** Trading pair symbol */
+    symbol: string;
+    /** Signal ID */
+    signalId: string;
+    /** Position type */
+    position: string;
+    /** Signal note */
+    note?: string;
+    /** Current market price */
+    currentPrice: number;
+    /** Scheduled entry price */
+    priceOpen: number;
+    /** Take profit price */
+    takeProfit: number;
+    /** Stop loss price */
+    stopLoss: number;
+    /** Close timestamp (only for cancelled) */
+    closeTimestamp?: number;
+    /** Duration in minutes (only for cancelled/opened) */
+    duration?: number;
+}
+/**
+ * Statistical data calculated from scheduled signals.
+ *
+ * Provides metrics for scheduled signal tracking, activation and cancellation analysis.
  *
- *     const resultId = uuid();
- *     const signal = await llmRequest(messages);
+ * @example
+ * ```typescript
+ * const stats = await Schedule.getData("my-strategy");
  *
- *     // Save conversation and result for debugging
- *     await dumpSignal(resultId, messages, signal);
+ * console.log(`Total events: ${stats.totalEvents}`);
+ * console.log(`Scheduled signals: ${stats.totalScheduled}`);
+ * console.log(`Opened signals: ${stats.totalOpened}`);
+ * console.log(`Cancelled signals: ${stats.totalCancelled}`);
+ * console.log(`Cancellation rate: ${stats.cancellationRate}%`);
  *
- *     return signal;
+ * // Access raw event data (includes scheduled, opened, cancelled)
+ * stats.eventList.forEach(event => {
+ *   if (event.action === "cancelled") {
+ *     console.log(`Cancelled signal: ${event.signalId}`);
  *   }
  * });
- *
- * // Creates: ./dump/strategy/{uuid}/00_system_prompt.md
- * //          ./dump/strategy/{uuid}/01_user_message.md (1h analysis)
- * //          ./dump/strategy/{uuid}/02_assistant_message.md
- * //          ./dump/strategy/{uuid}/03_user_message.md (5m analysis)
- * //          ./dump/strategy/{uuid}/04_assistant_message.md
- * //          ./dump/strategy/{uuid}/05_user_message.md (signal request)
- * //          ./dump/strategy/{uuid}/06_llm_output.md (final signal)
  * ```
  */
-declare function dumpSignal(signalId: string | number, history: MessageModel[], signal: ISignalDto, outputDir?: string): Promise<void>;
+interface ScheduleStatisticsModel {
+    /** Array of all scheduled/opened/cancelled events with full details */
+    eventList: ScheduledEvent[];
+    /** Total number of all events (includes scheduled, opened, cancelled) */
+    totalEvents: number;
+    /** Total number of scheduled signals */
+    totalScheduled: number;
+    /** Total number of opened signals (activated from scheduled) */
+    totalOpened: number;
+    /** Total number of cancelled signals */
+    totalCancelled: number;
+    /** Cancellation rate as percentage (0-100), null if no scheduled signals. Lower is better. */
+    cancellationRate: number | null;
+    /** Activation rate as percentage (0-100), null if no scheduled signals. Higher is better. */
+    activationRate: number | null;
+    /** Average waiting time for cancelled signals in minutes, null if no cancelled signals */
+    avgWaitTime: number | null;
+    /** Average waiting time for opened signals in minutes, null if no opened signals */
+    avgActivationTime: number | null;
+}
 
 /**
- * Portfolio heatmap statistics for a single symbol.
- * Aggregated metrics across all strategies for one trading pair.
+ * Aggregated statistics for a specific metric type.
  */
-interface IHeatmapRow {
-    /** Trading pair symbol (e.g., "BTCUSDT") */
-    symbol: string;
-    /** Total profit/loss percentage across all closed trades */
-    totalPnl: number | null;
-    /** Risk-adjusted return (Sharpe Ratio) */
-    sharpeRatio: number | null;
-    /** Maximum drawdown percentage (largest peak-to-trough decline) */
-    maxDrawdown: number | null;
-    /** Total number of closed trades */
-    totalTrades: number;
-    /** Number of winning trades */
-    winCount: number;
-    /** Number of losing trades */
-    lossCount: number;
-    /** Win rate percentage */
-    winRate: number | null;
-    /** Average PNL per trade */
-    avgPnl: number | null;
-    /** Standard deviation of PNL */
-    stdDev: number | null;
-    /** Profit factor: sum of wins / sum of losses */
-    profitFactor: number | null;
-    /** Average profit percentage on winning trades */
-    avgWin: number | null;
-    /** Average loss percentage on losing trades */
-    avgLoss: number | null;
-    /** Maximum consecutive winning trades */
-    maxWinStreak: number;
-    /** Maximum consecutive losing trades */
-    maxLossStreak: number;
-    /** Expectancy: (winRate * avgWin) - (lossRate * avgLoss) */
-    expectancy: number | null;
+interface MetricStats {
+    /** Type of metric */
+    metricType: PerformanceMetricType;
+    /** Number of recorded samples */
+    count: number;
+    /** Total duration across all samples (ms) */
+    totalDuration: number;
+    /** Average duration (ms) */
+    avgDuration: number;
+    /** Minimum duration (ms) */
+    minDuration: number;
+    /** Maximum duration (ms) */
+    maxDuration: number;
+    /** Standard deviation of duration (ms) */
+    stdDev: number;
+    /** Median duration (ms) */
+    median: number;
+    /** 95th percentile duration (ms) */
+    p95: number;
+    /** 99th percentile duration (ms) */
+    p99: number;
+    /** Average wait time between events (ms) */
+    avgWaitTime: number;
+    /** Minimum wait time between events (ms) */
+    minWaitTime: number;
+    /** Maximum wait time between events (ms) */
+    maxWaitTime: number;
+}
+/**
+ * Performance statistics aggregated by strategy.
+ */
+interface PerformanceStatisticsModel {
+    /** Strategy name */
+    strategyName: string;
+    /** Total number of performance events recorded */
+    totalEvents: number;
+    /** Total execution time across all metrics (ms) */
+    totalDuration: number;
+    /** Statistics grouped by metric type */
+    metricStats: Record<string, MetricStats>;
+    /** All raw performance events */
+    events: PerformanceContract[];
 }
 
 /**
- * Column configuration for markdown table generation.
- * Generic interface that defines how to extract and format data from any data type.
+ * Unified partial profit/loss event data for report generation.
+ * Contains all information about profit and loss level milestones.
+ */
+interface PartialEvent {
+    /** Event timestamp in milliseconds */
+    timestamp: number;
+    /** Event action type (profit or loss) */
+    action: "profit" | "loss";
+    /** Trading pair symbol */
+    symbol: string;
+    /** Strategy name */
+    strategyName: string;
+    /** Signal ID */
+    signalId: string;
+    /** Position type */
+    position: string;
+    /** Current market price */
+    currentPrice: number;
+    /** Profit/loss level reached (10, 20, 30, etc) */
+    level: PartialLevel;
+    /** True if backtest mode, false if live mode */
+    backtest: boolean;
+}
+/**
+ * Statistical data calculated from partial profit/loss events.
  *
- * @template T - The data type that this column will format
+ * Provides metrics for partial profit/loss milestone tracking.
  *
  * @example
  * ```typescript
- * // Column for formatting signal data
- * const signalColumn: ColumnModel<IStrategyTickResultClosed> = {
- *   key: "pnl",
- *   label: "PNL",
- *   format: (signal) => `${signal.pnl.pnlPercentage.toFixed(2)}%`,
- *   isVisible: () => true
- * };
+ * const stats = await Partial.getData("BTCUSDT", "my-strategy");
  *
- * // Column for formatting heatmap rows
- * const heatmapColumn: ColumnModel<IHeatmapRow> = {
- *   key: "symbol",
- *   label: "Symbol",
- *   format: (row) => row.symbol,
- *   isVisible: () => true
- * };
+ * console.log(`Total events: ${stats.totalEvents}`);
+ * console.log(`Profit events: ${stats.totalProfit}`);
+ * console.log(`Loss events: ${stats.totalLoss}`);
  * ```
  */
-interface ColumnModel<T extends object = any> {
-    /** Unique column identifier */
-    key: string;
-    /** Display label for column header */
-    label: string;
-    /** Formatting function to convert data to string */
-    format: (data: T, index: number) => string | Promise<string>;
-    /** Function to determine if column should be visible */
-    isVisible: () => boolean | Promise<boolean>;
+interface PartialStatisticsModel {
+    /** Array of all profit/loss events with full details */
+    eventList: PartialEvent[];
+    /** Total number of all events (includes profit, loss) */
+    totalEvents: number;
+    /** Total number of profit events */
+    totalProfit: number;
+    /** Total number of loss events */
+    totalLoss: number;
 }
 
 /**
- * Portfolio heatmap statistics structure.
- * Contains aggregated data for all symbols in the portfolio.
+ * Risk rejection event data for report generation.
+ * Contains all information about rejected signals due to risk limits.
  */
-interface HeatmapStatisticsModel {
-    /** Array of symbol statistics */
-    symbols: IHeatmapRow[];
-    /** Total number of symbols tracked */
-    totalSymbols: number;
-    /** Portfolio-wide total PNL */
-    portfolioTotalPnl: number | null;
-    /** Portfolio-wide Sharpe Ratio */
-    portfolioSharpeRatio: number | null;
-    /** Portfolio-wide total trades */
-    portfolioTotalTrades: number;
+interface RiskEvent {
+    /** Event timestamp in milliseconds */
+    timestamp: number;
+    /** Trading pair symbol */
+    symbol: string;
+    /** Pending signal details */
+    pendingSignal: ISignalDto;
+    /** Strategy name */
+    strategyName: string;
+    /** Exchange name */
+    exchangeName: string;
+    /** Current market price */
+    currentPrice: number;
+    /** Number of active positions at rejection time */
+    activePositionCount: number;
+    /** Rejection reason from validation note */
+    comment: string;
+    /** Whether this event is from backtest mode (true) or live mode (false) */
+    backtest: boolean;
+}
+/**
+ * Statistical data calculated from risk rejection events.
+ *
+ * Provides metrics for risk management tracking.
+ *
+ * @example
+ * ```typescript
+ * const stats = await Risk.getData("BTCUSDT", "my-strategy");
+ *
+ * console.log(`Total rejections: ${stats.totalRejections}`);
+ * console.log(`Rejections by symbol:`, stats.bySymbol);
+ * ```
+ */
+interface RiskStatisticsModel {
+    /** Array of all risk rejection events with full details */
+    eventList: RiskEvent[];
+    /** Total number of risk rejections */
+    totalRejections: number;
+    /** Rejections grouped by symbol */
+    bySymbol: Record<string, number>;
+    /** Rejections grouped by strategy */
+    byStrategy: Record<string, number>;
 }
 
 declare const BASE_WAIT_FOR_INIT_SYMBOL: unique symbol;
@@ -10778,4 +10778,4 @@ declare const backtest: {
     loggerService: LoggerService;
 };
 
-export { Backtest, type BacktestStatisticsModel, Cache, type CandleInterval, type ColumnConfig, type ColumnModel, Constant, type DoneContract, type EntityId, Exchange, ExecutionContextService, type FrameInterval, type GlobalConfig, Heat, type HeatmapStatisticsModel, type ICandleData, type IExchangeSchema, type IFrameSchema, type IHeatmapRow, type IOptimizerCallbacks, type IOptimizerData, type IOptimizerFetchArgs, type IOptimizerFilterArgs, type IOptimizerRange, type IOptimizerSchema, type IOptimizerSource, type IOptimizerStrategy, type IOptimizerTemplate, type IPersistBase, type IPositionSizeATRParams, type IPositionSizeFixedPercentageParams, type IPositionSizeKellyParams, type IRiskActivePosition, type IRiskCheckArgs, type IRiskSchema, type IRiskValidation, type IRiskValidationFn, type IRiskValidationPayload, type IScheduledSignalRow, type ISignalDto, type ISignalRow, type ISizingCalculateParams, type ISizingCalculateParamsATR, type ISizingCalculateParamsFixedPercentage, type ISizingCalculateParamsKelly, type ISizingSchema, type ISizingSchemaATR, type ISizingSchemaFixedPercentage, type ISizingSchemaKelly, type IStrategyPnL, type IStrategySchema, type IStrategyTickResult, type IStrategyTickResultActive, type IStrategyTickResultCancelled, type IStrategyTickResultClosed, type IStrategyTickResultIdle, type IStrategyTickResultOpened, type IStrategyTickResultScheduled, type IWalkerResults, type IWalkerSchema, type IWalkerStrategyResult, Live, type LiveStatisticsModel, type MessageModel, type MessageRole, MethodContextService, Optimizer, Partial$1 as Partial, type PartialData, type PartialLossContract, type PartialProfitContract, type PartialStatisticsModel, Performance, type PerformanceContract, type PerformanceMetricType, type PerformanceStatisticsModel, PersistBase, PersistPartialAdapter, PersistRiskAdapter, PersistScheduleAdapter, PersistSignalAdapter, PositionSize, type ProgressBacktestContract, type ProgressOptimizerContract, type ProgressWalkerContract, Risk, type RiskContract, type RiskData, type RiskStatisticsModel, Schedule, type ScheduleData, type ScheduleStatisticsModel, type SignalData, type SignalInterval, type TPersistBase, type TPersistBaseCtor, Walker, type WalkerCompleteContract, type WalkerContract, type WalkerMetric, type WalkerStatisticsModel, addExchange, addFrame, addOptimizer, addRisk, addSizing, addStrategy, addWalker, dumpSignal, emitters, formatPrice, formatQuantity, getAveragePrice, getCandles, getColumns, getConfig, getDate, getDefaultColumns, getDefaultConfig, getMode, hasTradeContext, backtest as lib, listExchanges, listFrames, listOptimizers, listRisks, listSizings, listStrategies, listWalkers, listenBacktestProgress, listenDoneBacktest, listenDoneBacktestOnce, listenDoneLive, listenDoneLiveOnce, listenDoneWalker, listenDoneWalkerOnce, listenError, listenExit, listenOptimizerProgress, listenPartialLoss, listenPartialLossOnce, listenPartialProfit, listenPartialProfitOnce, listenPerformance, listenRisk, listenRiskOnce, listenSignal, listenSignalBacktest, listenSignalBacktestOnce, listenSignalLive, listenSignalLiveOnce, listenSignalOnce, listenValidation, listenWalker, listenWalkerComplete, listenWalkerOnce, listenWalkerProgress, setColumns, setConfig, setLogger };
+export { Backtest, type BacktestStatisticsModel, Cache, type CandleInterval, type ColumnConfig, type ColumnModel, Constant, type DoneContract, type EntityId, Exchange, ExecutionContextService, type FrameInterval, type GlobalConfig, Heat, type HeatmapStatisticsModel, type ICandleData, type IExchangeSchema, type IFrameSchema, type IHeatmapRow, type IOptimizerCallbacks, type IOptimizerData, type IOptimizerFetchArgs, type IOptimizerFilterArgs, type IOptimizerRange, type IOptimizerSchema, type IOptimizerSource, type IOptimizerStrategy, type IOptimizerTemplate, type IPersistBase, type IPositionSizeATRParams, type IPositionSizeFixedPercentageParams, type IPositionSizeKellyParams, type IRiskActivePosition, type IRiskCheckArgs, type IRiskSchema, type IRiskValidation, type IRiskValidationFn, type IRiskValidationPayload, type IScheduledSignalRow, type ISignalDto, type ISignalRow, type ISizingCalculateParams, type ISizingCalculateParamsATR, type ISizingCalculateParamsFixedPercentage, type ISizingCalculateParamsKelly, type ISizingSchema, type ISizingSchemaATR, type ISizingSchemaFixedPercentage, type ISizingSchemaKelly, type IStrategyPnL, type IStrategyResult, type IStrategySchema, type IStrategyTickResult, type IStrategyTickResultActive, type IStrategyTickResultCancelled, type IStrategyTickResultClosed, type IStrategyTickResultIdle, type IStrategyTickResultOpened, type IStrategyTickResultScheduled, type IWalkerResults, type IWalkerSchema, type IWalkerStrategyResult, Live, type LiveStatisticsModel, type MessageModel, type MessageRole, MethodContextService, type MetricStats, Optimizer, Partial$1 as Partial, type PartialData, type PartialEvent, type PartialLossContract, type PartialProfitContract, type PartialStatisticsModel, Performance, type PerformanceContract, type PerformanceMetricType, type PerformanceStatisticsModel, PersistBase, PersistPartialAdapter, PersistRiskAdapter, PersistScheduleAdapter, PersistSignalAdapter, PositionSize, type ProgressBacktestContract, type ProgressOptimizerContract, type ProgressWalkerContract, Risk, type RiskContract, type RiskData, type RiskEvent, type RiskStatisticsModel, Schedule, type ScheduleData, type ScheduleStatisticsModel, type ScheduledEvent, type SignalData, type SignalInterval, type TPersistBase, type TPersistBaseCtor, type TickEvent, Walker, type WalkerCompleteContract, type WalkerContract, type WalkerMetric, type WalkerStatisticsModel, addExchange, addFrame, addOptimizer, addRisk, addSizing, addStrategy, addWalker, dumpSignal, emitters, formatPrice, formatQuantity, getAveragePrice, getCandles, getColumns, getConfig, getDate, getDefaultColumns, getDefaultConfig, getMode, hasTradeContext, backtest as lib, listExchanges, listFrames, listOptimizers, listRisks, listSizings, listStrategies, listWalkers, listenBacktestProgress, listenDoneBacktest, listenDoneBacktestOnce, listenDoneLive, listenDoneLiveOnce, listenDoneWalker, listenDoneWalkerOnce, listenError, listenExit, listenOptimizerProgress, listenPartialLoss, listenPartialLossOnce, listenPartialProfit, listenPartialProfitOnce, listenPerformance, listenRisk, listenRiskOnce, listenSignal, listenSignalBacktest, listenSignalBacktestOnce, listenSignalLive, listenSignalLiveOnce, listenSignalOnce, listenValidation, listenWalker, listenWalkerComplete, listenWalkerOnce, listenWalkerProgress, setColumns, setConfig, setLogger };