- calibration/frames/: 16 PNG-uri ground-truth numite {ts}_{color}.png,
copiate din logs/fires (izolate de samples/ și logs/fires/ care se pot goli)
- calibration/calibration_labels.json: mutat din samples/, curățat de entries
cu fișiere inexistente, extins la acoperire completă 7 culori → 16/16 PASS
- calibration/scenarios.json: 8 secvențe FSM (BUY/SELL full cycle, phase_skip,
catchup, post-fire suppression) pe frame-uri reale
- tests/test_scenarios_regression.py: parametrizat pe scenarios.json, asertează
color+state+reason+trigger+alerts+scheduler prin pipeline-ul
Detector → _handle_tick
- docs: README + CLAUDE reflectă noua structură, incidentul 2026-04-20/21
(pixel saturat UNKNOWN → FSM blocat în PRIMED → polling continuu) +
troubleshooting pentru trigger UNKNOWN
Pytest: 184 → 192 passed (+8 scenarii regresie).
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
calibration/ — frame corpus for validation & regression
Two artifacts, one frame pool:
calibration_labels.json— per-frame color labels. Used byatm validate-calibrationto check the current palette classifies known-good dots correctly before a live session.scenarios.json— ordered frame sequences per FSM scenario (full cycle, phase skip, catchup, post-fire suppression). Consumed bytests/test_scenarios_regression.pywhich runs each sequence through the fullDetector → _handle_tickpipeline and asserts color, FSM reason/state, emitted alerts, and scheduler on/off.
Frames live in calibration/frames/ and are self-contained: purging
logs/fires/ or samples/ does not break either artifact.
calibration_labels.json schema
Schema
A JSON array of entries. Each entry:
| Field | Type | Required | Description |
|---|---|---|---|
path |
string | yes | Path to a PNG frame (relative to CWD or absolute). |
expected |
string | yes | Expected color name: one of turquoise, yellow, dark_green, dark_red, light_green, light_red, gray. |
note |
string | no | Freeform annotation; shown in SUGGESTIONS output. |
Usage
atm validate-calibration calibration/calibration_labels.json
Exit codes:
0— every sample PASS1— one or more FAIL2— label file missing or malformed JSON
Adding new samples
- Find a screenshot in
logs/fires/whose dot color you can verify by eye. - Copy it into
calibration/frames/— this directory is self-contained sologs/fires/andsamples/can be emptied without breaking validation. - Append an entry with
path(pointing tocalibration/frames/...),expected, and an optionalnote. - Re-run validation. If it FAILs, the SUGGESTIONS section will tell you the
RGB distance between the observed pixel and the expected color's center —
use that as input for
atm calibrate.