DOX sistem

tests/AGENTS.md

@@ -0,0 +1,37 @@
+# tests — Test Suite
+
+## Purpose
+
+230+ teste: unit pe fiecare modul + 8 scenarii de regresie FSM pe imagini reale +
+env loader. Rulează headless pe Linux/WSL (de aceea FSM & config nu importă cv2).
+
+## Ownership
+
+Tot `tests/`. Fiecare `test_<modul>.py` oglindește un modul din `src/atm/`.
+
+## Local Contracts
+
+- Un modul nou în `src/atm/` ⇒ un `test_<modul>.py` corespondent.
+- **`test_scenarios_regression.py`** rulează FSM-ul peste secvențele din
+  `calibration/scenarios.json` pe frame-uri reale. Schimbi FSM ⇒ adaugă/actualizează
+  scenariu acolo (vezi `calibration/AGENTS.md`).
+- **`test_env_loader.py`** monkeypatchează env-ul; păstrează regula „shell wins"
+  din `config._ensure_env_loaded`.
+- Testele nu trebuie să atingă rețeaua reală (Telegram/Discord) — mock-uiește.
+
+## Work Guidance
+
+- Rulează suita completă înainte de orice commit care atinge `src/atm/`.
+- Dacă un test cere Pillow/OpenCV pe checkout-ul Windows, folosește venv-ul repo
+  (vezi `scripts/AGENTS.md`).
+
+## Verification
+
+```bash
+pytest -q                                       # toată suita
+pytest tests/test_scenarios_regression.py -v    # FSM pe imagini reale
+```
+
+## Child DOX Index
+
+(none — leaf)