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

atm validate-calibration calibration/calibration_labels.json
atm debug --delay 5     # confirmă că config-ul activ încarcă & detectează

Child DOX Index

(none — leaf)

1.8 KiB Raw Blame History