54 lines
1.8 KiB
Markdown
54 lines
1.8 KiB
Markdown
# 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)
|