Files
atm/configs/AGENTS.md
Marius Mutu daf6965ba7 feat(lifecycle): alive doar la deschidere/închidere, /window persistent, /status cu fereastra
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
2026-09-11 17:17:00 +03:00

2.1 KiB

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

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

Child DOX Index

(none — leaf)