Migration uncovered older consumers assuming fields such as timestamp or duration, while CLI-backed records use interval-style fields such as start_date, end_date, and value.
This is particularly important for:
- Sleep stages, where interval duration matters.
- Blood oxygen saturation, where consumers need to know whether values are 0-1 or 0-100.
- Cumulative metrics such as steps/calories, where consumers need sum vs max vs average guidance.
Suggested fix:
- Add metric-level unit metadata to
catalog.
- Document common aggregation rules by metric class: discrete, cumulative, interval/stage.
- Add examples for sleep, SpO2, steps, HR, HRV, workouts, and calendar.
Migration uncovered older consumers assuming fields such as
timestamporduration, while CLI-backed records use interval-style fields such asstart_date,end_date, andvalue.This is particularly important for:
Suggested fix:
catalog.