Phase 2 market state risk governor

README.md

@@ -220,6 +220,7 @@ Record the current commit as the last-known-good SHA before deploy. If any gate
 - `python3 scripts/run_trading_plans.py` - generate today's structured BTC/ETH trading plans before signal generation; active plans require a Draw and at least one Invalidation
 - `python3 scripts/run_signals.py` - generate bias and signals
 - `python3 scripts/run_execution.py` - run paper execution gating, 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
 - `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
@@ -252,6 +253,7 @@ Optional utility JSON output variables:
 - `MIGRATION_CHECKS_OUTPUT_JSON`
 - `SCRIPT_CHECKS_OUTPUT_JSON`
 - `SHOW_MODELS_OUTPUT_JSON`
+- `RISK_GOVERNOR_OUTPUT_JSON`
 - `TRADING_PLANS_OUTPUT_JSON`
 - `TRADING_REHEARSAL_OUTPUT_JSON`
 
@@ -371,6 +373,20 @@ Optional account risk environment variables used by `run_execution.py` and `run_
 - `EXECUTION_MAX_OPEN_POSITIONS`
 - `EXECUTION_MAX_SAME_SIDE_POSITIONS`
 
+Optional market-state and risk governor environment variables used by `run_risk_governor.py`:
+
+- `RISK_GOVERNOR_OUTPUT_JSON`
+- `RISK_INSTRUMENT_ID`
+- `RISK_TIMEFRAME`
+- `RISK_EXECUTION_MODE`
+- `MARKET_STATE_MAX_CANDLE_AGE_SECONDS`
+- `NEWS_WINDOW_ACTIVE`
+- `NEWS_WINDOW_ID`
+- `NEWS_WINDOW_MINUTES_BEFORE`
+- `NEWS_WINDOW_MINUTES_AFTER`
+- `OPENING_VOLATILITY_GUARD_MINUTES`
+- `BLOCK_OPENING_VOLATILITY`
+
 Optional signal quality environment variables used by `run_signals.py` and `run_pipeline.py`:
 
 - `SIGNALS_OUTPUT_JSON` - set to `1`, `true`, `yes`, or `on` for machine-readable `run_signals.py` output