From 3bef5ea660314ad209208a5d6cfdcfee48ab0729 Mon Sep 17 00:00:00 2001
From: Ryan McGuire <rmcguire@libretechconsulting.com>
Date: Tue, 23 Jun 2026 22:51:28 -0400
Subject: [PATCH] add changelog

---
 AGENTS.md    |  8 ++++++++
 CHANGELOG.md | 45 +++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 53 insertions(+)
 create mode 100644 CHANGELOG.md

diff --git a/AGENTS.md b/AGENTS.md
index 5525133..35f777b 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -62,3 +62,11 @@ with `curl` when fields change; never hand-edit `testdata/` payloads.
   - `alt_baro` may be the string `"ground"` instead of a number → `readsb.AltBaro`.
   - readsb timestamps are fractional-second Unix floats → `readsb.UnixTime`.
   - `outline.json` points are `[lat, lon, altFeet]` tuples → `readsb.RangePoint`.
+
+## Changelog
+
+`CHANGELOG.md` follows [Keep a Changelog](https://keepachangelog.com/) and
+SemVer. Record every user-facing change under `## [Unreleased]` as part of the
+change itself — don't defer it to release time. When tagging a release, rename
+`[Unreleased]` to the new version with the date and add a fresh empty
+`[Unreleased]` section plus its compare link at the bottom.
diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000..351dd46
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,45 @@
+# Changelog
+
+All notable changes to this project are documented here.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.2.1] - 2026-06-23
+
+### Added
+
+- `MinSpeed`/`MaxSpeed` aircraft filters in `pkg/types/readsb`, selectable
+  between ground speed and true airspeed via the `SpeedSource` type. `MaxSpeed`
+  drops aircraft with no speed reading.
+
+## [0.2.0] - 2026-06-23
+
+### Added
+
+- Client retry configuration with exponential backoff (`RetryConfig`,
+  `WithRetry`). Retries transport errors and 5xx responses; never retries 4xx or
+  context cancellation.
+- String-typed enums for readsb message type and emitter category.
+
+## [0.1.1] - 2026-06-22
+
+### Added
+
+- License.
+
+## [0.1.0] - 2026-06-22
+
+### Added
+
+- Initial release: `pkg/types/readsb` and `pkg/types/wingbits` decode types,
+  the `pkg/client` HTTP client with one-shot queries and channel/iterator
+  polling for every endpoint, the `cmd/wingbits` CLI, and a README.
+
+[Unreleased]: https://gitea.libretechconsulting.com/rmcguire/wingbits/compare/v0.2.1...HEAD
+[0.2.1]: https://gitea.libretechconsulting.com/rmcguire/wingbits/compare/v0.2.0...v0.2.1
+[0.2.0]: https://gitea.libretechconsulting.com/rmcguire/wingbits/compare/v0.1.1...v0.2.0
+[0.1.1]: https://gitea.libretechconsulting.com/rmcguire/wingbits/compare/v0.1.0...v0.1.1
+[0.1.0]: https://gitea.libretechconsulting.com/rmcguire/wingbits/releases/tag/v0.1.0