# ManeshTrader Help

## What This Tool Does

The app classifies each closed candle as `real_bull`, `real_bear`, or `fake`, then tracks trend state from only the real bars.

- 2 consecutive real bullish bars: bullish trend active
- 2 consecutive real bearish bars: bearish trend active
- Reversal also requires 2 consecutive opposite real bars
- Fake bars do not reverse trend on their own

## Quick Start

1. Choose `Symbol` (example: `AAPL` or `BTC-USD`).
2. Start with `Timeframe = 1d` and `Period = 6mo`.
3. Keep `Ignore potentially live last bar` ON.
4. Enable these in `Training & Guidance`:
   - `Show live decision guide`
   - `Show past behavior examples`
   - `Overlay example entries/exits on chart`
   - `Focus chart on selected example` (recommended for learning)
5. Set `Max training examples` to 20.

## How To Use The New Training Features

### 1) Live Decision Guide (what to do now)

- Bias: Long, Short, or Stand Aside / Neutral.
- Signal Status: Fresh confirmation or no new confirmation.
- Latest Bar: How the newest closed candle was classified.
- Action + Invalidation: Practical rule for what to prefer and when to stop.

### 2) Past Behavior Examples (what would have happened)

Examples are hypothetical and use one rule: enter at trend-confirmation bar close, exit at opposite trend-confirmation bar close.

- `direction`: LONG (upside bias) or SHORT (downside bias)
- `entry_timestamp` / `exit_timestamp`: example start/end time
- `entry_price` / `exit_price`: example prices
- `bars_held`: number of candles held
- `pnl_pct`: percent gain/loss for that example
- `outcome`: Win, Loss, or Flat

### 3) Click A Row To Highlight It On Chart

1. Click any row in the Past Behavior Examples table.
2. The chart highlights that exact entry-to-exit window.
3. A path line shows the selected trade from entry price to exit price.
4. A plain-English explanation appears under the table for the selected row.
5. If `Focus chart on selected example` is ON, the chart zooms into that trade.

## Marker Legend

- Green triangle-up: real bullish bar
- Red triangle-down: real bearish bar
- Blue circle: example long entry
- Orange diamond: example short entry
- Green X: example winning exit
- Red X: example loss/flat exit
- Star path + highlighted window: currently selected example row

## Important Notes

- Analysis and training only. No trade execution.
- Educational examples are simplified and not financial advice.
- Use with risk controls before any real-money decision.