# 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)
