Phase 5 plan replay backtest

README.md

@@ -222,7 +222,7 @@ Record the current commit as the last-known-good SHA before deploy. If any gate
 - `python3 scripts/run_signals.py` - generate bias and signals with structural `target_plan` selection; TP1 prefers IRL and TP2 prefers ERL, and signals are skipped when traceable structural targets are missing
 - `python3 scripts/run_execution.py` - run paper execution gating, require structural targets plus management rules for modeled signals, create an execution record, then auto-settle the latest execution for that signal
 - `python3 scripts/run_risk_governor.py` - run the independent market-state and risk governor pre-execution gate
-- `python3 scripts/run_backtest.py` - run backtest and write results, including target-source traceability and management rules in result meta
+- `python3 scripts/run_backtest.py` - run backtest as `plan_replay` by default, replay active-plan candidates from appearance to confirmation to entry/invalidation, and write target-source traceability plus management rules into result meta
 - `python3 scripts/run_autonomous_cycle.py` - run the unattended cycle: offline checks, database probe, readiness checks, then guarded pipeline when the database is available; prints `Next actions` for the next unattended step
 - `python3 scripts/run_database_readiness.py` - run read-only database readiness checks for connection, schema, seed data, and candle availability; prints `next_actions` and `action_plan` in JSON mode
 - `.venv/bin/python scripts/run_trading_delivery_rehearsal.py` - run the P0 trading delivery rehearsal as one scripted flow: checklist drift check, historical repair decision, readiness/auto-backfill, guarded pipeline, deploy/health-check, and post-deploy observe
@@ -258,6 +258,7 @@ Optional utility JSON output variables:
 - `TRADE_PLAN_CANDIDATES_OUTPUT_JSON`
 - `TRADING_PLANS_OUTPUT_JSON`
 - `TRADING_REHEARSAL_OUTPUT_JSON`
+- `BACKTEST_OUTPUT_JSON`
 
 Optional structure script JSON output variables:
 
@@ -402,6 +403,12 @@ Optional trading plan environment variables used by `run_trading_plans.py`:
 - `TRADING_PLAN_SETUP_TIMEFRAME`
 - `TRADING_PLAN_TRIGGER_TIMEFRAME`
 
+Optional backtest replay environment variables used by `run_backtest.py`:
+
+- `BACKTEST_SUBJECT_TYPE` - defaults to `plan_replay`; use `signal` only when you intentionally want the legacy signal-only backtest
+- `BACKTEST_TRADING_PLAN_ID` - optional plan scope for replay
+- `BACKTEST_CANDIDATE_MODEL_CODE` - optional candidate model filter such as `OSOK_DAILY_RANGE_SWEEP_MSS_FVG_RETRACE`
+
 Optional trade plan candidate environment variables used by `run_trade_plan_candidates.py`:
 
 - `TRADE_PLAN_CANDIDATES_OUTPUT_JSON` - set to `1`, `true`, `yes`, or `on` for machine-readable candidate output