Marius Mutu
daf6965ba7
Heartbeat-ul periodic (activ/IDLE la 30 min) e oprit implicit (heartbeat_min = 0). Semnalul „alive" devin alertele zilnice „🟢 Piața deschisă" / „🔴 Piața închisă", emise pe tranziția ferestrei (operating_hours AND /window) independent de pauză — body-ul spune dacă monitorizarea e pauzată manual sau pe drift. /window era doar în memorie și se pierdea la repornire (09-09), așa că programul revenea la 16:30–23:00 și trimitea mesaje înainte/după fereastra 19:30–22:00. Acum e persistat în logs/session_window.json și restaurat la pornire; /window off șterge fișierul. /status afișează blocul de fereastră: deschisă/închisă + următoarea deschidere/închidere (ora locală), /window, orele bursei cu echivalentul local, și config | heartbeat. Config activ: heartbeat_min = 0; include și baseline_phash rescris de auto-rebase-ul canary din 09-09. DOX pass: notifier + configs. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01Em4jtmh4pRpYMdyd9ueHYF
60 lines
2.1 KiB
Markdown
60 lines
2.1 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ă
|
|
(și când monitorizarea e pauzată — sunt semnalul zilnic „alive"). Startup
|
|
in-window e silent.
|
|
|
|
### `[options] heartbeat_min`
|
|
|
|
Default `0` = fără heartbeat periodic (alive = alertele de deschidere/închidere).
|
|
`N > 0` repornește heartbeat-ul la N minute, doar în fereastra de tranzacționare.
|
|
|
|
### `[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)
|