# calibration_labels.json — schema

Used by `atm validate-calibration` to check that the current color calibration
classifies known-good screenshots correctly before a live session.

## 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

```bash
atm validate-calibration samples/calibration_labels.json
```

Exit codes:
- `0` — every sample PASS
- `1` — one or more FAIL
- `2` — label file missing or malformed JSON

## Adding new samples

1. Find a screenshot in `logs/fires/` whose dot color you can verify by eye.
2. Append an entry with `path`, `expected`, and an optional `note`.
3. 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`.