Schema changelog

Schema versions follow semver. The schemaVersion field inside each export tells you which version of this documentation applies.

1.0.0 — 2026-04-21

Initial export schema.

Known caveats this version does not address:

• No cross-skier comparisons (one skier per export).
• No “Compact” mode — exports are full-fat. Typical size: 100 KB – 2 MB.
• Display-cache fields (bestPassLineOffUs, bestPassSpeedMph, bestPassBuoyCount, bestDisplay) are included as-is. Analysts should derive best-pass metrics from the passes array to avoid stale caches.
• totalBuoys is SwerveNerd’s internal weighting (speedMph × buoyCount), not the AWSA or IWSF standard scoring formula. For standardised scoring, derive your own metric from speedMph, lineOffUs, and buoyCount.

Future schema changes will:

• Bump the schemaVersion field in the export.
• Add an entry to this file describing added, removed, or renamed fields.
• Keep the previous schema version’s docs accessible at a versioned URL once a new version ships.