[codex] Expand smoke coverage and docs

README.md

@@ -320,6 +320,19 @@ pytest test_backtest_engine.py -v
 - [Emergency Procedures](docs/runbooks/emergency-procedures.md)
 - [Architecture Documentation](docs/architecture/overview.md)
 
+### Smoke Tests
+
+```bash
+# Run safety-critical smoke coverage
+python tests/run_all_smoke.py
+
+# Equivalent direct pytest command
+pytest -m smoke --no-cov
+```
+
+The smoke suite covers the safety-critical autonomous, execution, emergency,
+auth, broker-state, recovery, evidence-learning, and risk-lifecycle paths.
+
 ---
 
 ## 📚 Documentation Index
@@ -955,4 +968,4 @@ We love feature requests! Open an issue with the "enhancement" label.
 
 ---
 
-**Happy Trading! 📈**
+**Happy Trading! 📈**

docs/README.md

@@ -18,6 +18,9 @@ python scripts/run_web.py
 # Run tests (Prime Directive: 100% pass rate)
 pytest -v
 
+# Run safety-critical smoke tests
+python tests/run_all_smoke.py
+
 # Check coverage
 pytest --cov
 ```

docs/TESTING.md

@@ -254,6 +254,26 @@ pytest tests/test_strategy_registry.py::TestStrategyRegistry::test_initializatio
 pytest -k "test_signal"
 ```
 
+### Smoke Suite
+
+```bash
+# Run safety-critical smoke tests
+python tests/run_all_smoke.py
+
+# Equivalent direct pytest command
+pytest -m smoke --no-cov
+
+# Narrow the smoke suite while keeping the smoke marker
+python tests/run_all_smoke.py -k emergency -x
+```
+
+The smoke inventory is maintained in `tests/smoke_manifest.py` and applied as
+the `smoke` marker during pytest collection. It covers emergency stops, auth,
+config security, order execution, TWS bridge behavior, autonomous API/runner
+paths, live dry-run gates, order lifecycle, idempotency, recovery, replay,
+market-data health, evidence learning, risk lifecycle, and capital-promotion
+advisory behavior.
+
 ### Coverage Analysis
 
 ```bash