gov_workflow_openenv_tests/README_TESTS.md

Gov Workflow OpenEnv -- Test Suite

Setup

pip install pytest pytest-cov fastapi httpx

Run All Tests (275+)

bash run_all_tests.sh

Run Individual Suites

pytest tests/test_phase1_models.py -v
pytest tests/test_phase1_sector_and_tasks.py -v
pytest tests/test_phase1_event_engine.py -v
pytest tests/test_phase1_signal_computer.py -v
pytest tests/test_phase2_env_integration.py -v
pytest tests/test_phase2_simulator.py -v
pytest tests/test_phase2_api.py -v
pytest tests/test_phase2_graders.py -v

Flags

bash run_all_tests.sh --unit-only   # Phase 1 only (models, sectors, events, signals)
bash run_all_tests.sh --api-only    # API + integration + grader tests only
bash run_all_tests.sh --fast        # Skip coverage report

File Map

File	Covers	Tests
test_phase1_models.py	Pydantic schemas, enums, SLA math	40+
test_phase1_sector_and_tasks.py	Sector profiles, task configs, seeds	45+
test_phase1_event_engine.py	Determinism, scenario scaling, event effects	35+
test_phase1_signal_computer.py	7 compressed state signals	30+
test_phase2_env_integration.py	reset/step/state API, action dispatch	40+
test_phase2_simulator.py	DaySimulator, case lifecycle, snapshots	25+
test_phase2_api.py	FastAPI endpoints via TestClient	40+
test_phase2_graders.py	Deterministic grading, score bounds [0,1]	20+