WKL v2 — Prior Week Low Retest (Locked Spec)

//@version=5
strategy("WKL v2 — Prior Week Low Retest (Locked Spec)", overlay=true, 
     default_qty_type=strategy.percent_of_equity, default_qty_value=2,
     initial_capital=100000, commission_type=strategy.commission.cash_per_order, commission_value=0.5)

// ═══════════════════════════════════════════════════════════════════
// WKL v2 LOCKED SPEC — All params pinned from Python backtesting
// 114 trades | 87% WR | PF 9.83 | Net 2,057 pts
// With 15:00 cutoff: 88 trades | 92% WR | PF 14.32
// ═══════════════════════════════════════════════════════════════════

// ── PARAMETERS (all validated, do not tune without Python) ───────
tolerance   = input.float(5.0,  "Tolerance (USD pts)", tooltip="M15 bar low must be within this distance of PW low")
stopPts     = input.float(20.0, "Stop Loss (USD pts)", tooltip="Fixed 20 pts below entry. ~3.3x ATR14. Tested 15-25, 20 is PF peak.")
targetR     = input.float(2.25, "Target R-multiple", tooltip="TP = 45 pts (20 x 2.25). R=2.25 is PF peak. R=2.5 drops to 9.62.")
killHour    = input.int(20,     "Kill Hour (UTC)", minval=16, maxval=23, tooltip="Close open trades at this hour. 20:00 UTC = PF 9.83.")
sessStart   = input.int(7,      "Session Start (UTC)", minval=0, maxval=12, tooltip="Earliest entry hour. 07:00 = London open.")
sessCutoff  = input.int(15,     "Entry Cutoff (UTC)", minval=12, maxval=20, tooltip="No entries after this hour. 15:00 = PF 14.32. 17:00 = more trades but lower PF.")

// ── PRIOR WEEK LOW ───────────────────────────────────────────────
// [1] = completed prior week (not current). lookahead_on is correct 
// for historical reference data on higher timeframe.
pwLow = request.security(syminfo.tickerid, "W", low[1], lookahead=barmerge.lookahead_on)

// ── TIME FILTERS ─────────────────────────────────────────────────
utcHour   = hour(time, "UTC")
utcDay    = dayofweek(time, "UTC")

// Entry window: sessStart to sessCutoff, UTC
inSession = utcHour >= sessStart and utcHour < sessCutoff

// Monday filter: No entries on Monday (weekday=2 in Pine, Monday)
// Pine: dayofweek.monday = 2
isMonday = utcDay == dayofweek.monday

// Friday late: close positions, no new entries after kill hour
isFridayLate = utcDay == dayofweek.friday and utcHour >= 21

// ── ENTRY TRIGGER ────────────────────────────────────────────────
// Signal: M15 bar where LOW comes within tolerance of prior week low
// AND bar CLOSES ABOVE the prior week low.
//
// What this IS:
//   - Price retests prior week's support level
//   - Bar low touches/nears PW low (within 5 pts)
//   - Bar closes above (confirmation of hold)
//   - Long only (gold secular bull bias)
//
// What this is NOT:
//   - NOT requiring a bullish candle (close > open) — tested, marginal
//   - NOT requiring wick-through — tested, wick-throughs are WORSE (65% vs 91% WR)
//   - NOT requiring RSI/MA confluence for entry — confluence is for SIZING, not filtering
//
// Data: 100% of backtested entries naturally close above PW low.
// Wick-throughs (low pierces below, close above) = 15% of entries, worse performance.

nearPWLow   = (low <= pwLow + tolerance) and (low >= pwLow - tolerance)
closesAbove = close > pwLow

longCondition = nearPWLow and closesAbove and inSession and not isMonday and not isFridayLate and strategy.position_size == 0

// ── EXECUTE ──────────────────────────────────────────────────────
if longCondition
    ep = close
    sl = ep - stopPts
    tp = ep + (stopPts * targetR)
    
    strategy.entry("WKL", strategy.long)
    strategy.exit("WKL_TP_SL", "WKL", stop=sl, limit=tp)

// ── TIME EXIT ────────────────────────────────────────────────────
// If neither SL nor TP hit by kill hour, close at market.
// Kill 20:00 UTC = PF 9.83. Earlier kills (18-19) cut winners.
if strategy.position_size > 0 and utcHour >= killHour
    strategy.close("WKL", comment="Kill")

// Friday end-of-week: force close by 21:00 UTC
if strategy.position_size > 0 and utcDay == dayofweek.friday and utcHour >= 21
    strategy.close("WKL", comment="FriClose")

// ── VISUALS ──────────────────────────────────────────────────────
plot(pwLow, "Prior Week Low", color=color.new(color.blue, 20), linewidth=2, style=plot.style_stepline)

// Entry markers
plotshape(longCondition, "Entry Signal", shape.triangleup, location.belowbar, color.new(color.green, 0), size=size.small)

// Tolerance zone (light blue band around PW low)
pwUpper = pwLow + tolerance
pwLower = pwLow - tolerance
p1 = plot(pwUpper, "Tol Upper", color=color.new(color.blue, 90))
p2 = plot(pwLower, "Tol Lower", color=color.new(color.blue, 90))
fill(p1, p2, color=color.new(color.blue, 92), title="Tolerance Zone")

// Session background
bgcolor(inSession and not isMonday ? color.new(color.green, 96) : na, title="Active Session")
bgcolor(isMonday ? color.new(color.red, 96) : na, title="Monday (No Trade)")

// ═══════════════════════════════════════════════════════════════════
// SPEC REFERENCE (for future MQL5 port)
// ═══════════════════════════════════════════════════════════════════
// Level:         Prior completed week low
// Tolerance:     5 USD points
// Direction:     Long only
// Entry:         M15 close within tolerance above PW low
// Stop:          Fixed 20 USD pts below entry price
// Target:        Fixed 45 USD pts above entry (2.25R)
// Time exit:     20:00 UTC (close at market)
// Entry window:  07:00-15:00 UTC
// Day filter:    No Monday entries
// Trend filter:  None (long-only = embedded bull bias)
// Partial TP:    None in v1 (tested: half@1R works, save for v2)
//
// Confluence (for SIZING in v2, not entry filtering):
//   Size up when: RSI 60-70, Wednesday, low volume, huge Asian range
//   Size down when: RSI <30, 4+ consecutive down bars, after 15:00 UTC
// ═══════════════════════════════════════════════════════════════════