DOX sistem

configs/AGENTS.md

@@ -0,0 +1,53 @@
+# configs — TOML Configs
+
+## Purpose
+
+Configurațiile de rulare (ROI-uri, paletă, canary baseline, operating-hours,
+alerts). Schema e definită și validată în `src/atm/config.py` (fail fast la load).
+
+## Ownership
+
+`*.toml` + `current.txt` (pointer la config-ul activ) + `example.toml` (template).
+
+## Local Contracts
+
+- **`current.txt`** — o singură linie: numele fișierului TOML activ. `atm run`
+  fără `--config` îl folosește pe acesta.
+- Secretele **NU** stau în TOML — vin din env (`.env`). Vezi `notifier/AGENTS.md`.
+- Schema (dataclass-uri în `config.py`): `dot_roi`, `colors{name→{rgb,tolerance}}`,
+  `canary{roi, baseline_phash}`, y-axis calib, `[options.operating_hours]`,
+  `[options.alerts]`. Modifici schema în `config.py` ⇒ actualizezi `example.toml`
+  + acest doc în același commit.
+
+### `[options.operating_hours]`
+
+`enabled`, `timezone` (NYSE local, ex. `America/New_York`), `weekdays`,
+`start_hhmm`, `stop_hhmm`. Timezone validat la load; `_tz_cache` reutilizat per
+tick. Boundary crossings logează `market_open`/`market_closed` și notifică o dată.
+Startup in-window e silent.
+
+### `[options.alerts]`
+
+`fire_on_phase_skip = true` (default) — tranziția ARMED→light_* directă (dark_*
+ratat) emite totuși un `⚠️ PHASE SKIP`, cu FSM lockout ca să suprime spam-ul.
+
+### `canary.baseline_phash`
+
+Re-anchor prin comanda `/rebase confirm` (rescrie automat aici, păstrând
+comentariile). Nu edita manual decât dacă știi exact ce faci.
+
+## Work Guidance
+
+- Config nou = copiezi `example.toml`, numești `{data}-{tag}.toml`, pui numele în
+  `current.txt`. Nu șterge config-urile vechi (audit trail al recalibrărilor).
+
+## Verification
+
+```bash
+atm validate-calibration calibration/calibration_labels.json
+atm debug --delay 5     # confirmă că config-ul activ încarcă & detectează
+```
+
+## Child DOX Index
+
+(none — leaf)