# Changelog
All notable changes to **litchee** are documented in this file. It is generated
from [Conventional Commits](https://www.conventionalcommits.org) by
[git-cliff](https://git-cliff.org) — edit commit messages, not this file.
## [v0.1.6](https://github.com/obazin/litchee/releases/tag/v0.1.6) — 2026-07-16
Changes since [v0.1.5](https://github.com/obazin/litchee/releases/tag/v0.1.5).
### Fixes
- **changelog:** Stop git-cliff dropping dependency and spec commits
- **ci:** Run audit job on stable so cargo-audit compiles (#28)
### Dependencies & spec
- Sync Lichess API spec to v2.0.153 (add bookmark game endpoint) (#27)
- Bump reference/lichess-api from `a0f82d0` to `3033570` (#25)
- Bump bytes from 1.12.0 to 1.12.1 in the cargo-minor-patch group (#26)
## [v0.1.5](https://github.com/obazin/litchee/releases/tag/v0.1.5) — 2026-07-14
Changes since [v0.1.4](https://github.com/obazin/litchee/releases/tag/v0.1.4).
### Features
- **users:** Fully model PerfStat stat aggregate and Activity categories
- **users:** Expose autocomplete exists and object response variants
- **broadcasts:** Type round customScoring as structured points
- **external-engine:** Type analyse work as LichessExternalEngineWork
- **swiss:** Model roundInterval sentinels via SwissRoundInterval enum
- **puzzles:** Expose nb param and full solve response for solve_batch
### Fixes
- **external-engine:** Drop non-spec defaultDepth registration field
- **challenges:** Make start_clocks token2 optional for AI games
- **studies:** Type import_pgn mode as a spec-accurate enum
### Performance
- **stream:** Parse NDJSON lines without a per-line allocation
### Refactor
- **challenges:** Type accept color param as LichessColor
- **opening-explorer:** Type variant param as LichessVariantKey
- **studies:** Type import/create params with existing enums
- **puzzles:** Type puzzle color param as LichessColor
- **users:** Flatten LichessLightUser into LichessUserStatus
- **http:** Centralize text/plain bodies behind ApiRequest::text_body
- Drop needless allocations and dedup autocomplete request build
- **broadcasts:** Model round custom-scoring as value types with append_pairs
### Documentation
- Correct dev-shell description (standalone fenix flake, not chess-flake)
## [v0.1.4](https://github.com/obazin/litchee/releases/tag/v0.1.4) — 2026-07-09
Changes since [v0.1.3](https://github.com/obazin/litchee/releases/tag/v0.1.3).
### Features
- **broadcasts:** Tiebreaks (array) and grouping (nested) tour fields
- Bulk-pairing and study create form fields
- **challenges:** Remaining accept/cancel/create/open params
- POST form fields for tournament joins and board seek
- **broadcasts:** List/filter params for official/top/by_user/my_rounds
- **teams:** List/filter params for members, requests, and tournaments
- List/filter params for users, account, and puzzles
- List/filter query params for tournaments, tablebase, bot, games
- Add PgnExportOptions to study and broadcast PGN exports
- **broadcasts:** Full create/update form parity for tours and rounds
- **swiss:** Entry conditions + full create/edit form parity
- **arena:** Entry conditions + full create/update form parity
- **tv:** Full parameter parity for tvChannelGames
- **bulk-pairing:** Full parameter parity for bulkPairingIdGamesGet
- **swiss:** Full parameter parity for gamesBySwiss
- **arena:** Full parameter parity for gamesByTournament
- **games:** Full game-export parameter parity via GameExportOptions
- **model:** Add GameExportOptions cross-cutting export params
### Fixes
- **challenges:** Send Accept: x-ndjson on the keepAliveStream challenge
- **challenges:** KeepAliveStream returns an NDJSON stream, not one JSON
### Refactor
- **broadcasts:** Split broadcasts.rs into an oauth-style folder
- **http:** Consolidate game-export Accept media types into shared consts
- **games:** Split games.rs into an oauth-style folder
### Documentation
- Point broadcast tournament PGN export to streaming endpoints
- Fix stale README broadcasts().official() example
### Dependencies & spec
- **spec:** Bump lichess-api submodule to v2.0.152 (a0f82d0)
- Bump rand from 0.10.1 to 0.10.2 in the cargo-minor-patch group (#21)
## [v0.1.3](https://github.com/obazin/litchee/releases/tag/v0.1.3) — 2026-07-08
Changes since [v0.1.2](https://github.com/obazin/litchee/releases/tag/v0.1.2).
### Features
- **opening-explorer:** Complete masters + player parameter parity via builders
- **opening-explorer:** Filter the Lichess games query by speed + rating
## [v0.1.2](https://github.com/obazin/litchee/releases/tag/v0.1.2) — 2026-07-02
Changes since [v0.1.1](https://github.com/obazin/litchee/releases/tag/v0.1.1).
### Fixes
- Bump anyhow to 1.0.103 to resolve RUSTSEC-2026-0190 (#18)
### Dependencies & spec
- Sync client with Lichess API 2.0.151 (#16)
- Bump reference/lichess-api from `0d11023` to `5ec6ce5` (#17)
## [v0.1.1](https://github.com/obazin/litchee/releases/tag/v0.1.1) — 2026-06-27
Changes since [v0.1.0](https://github.com/obazin/litchee/releases/tag/v0.1.0).
### Features
- **games:** Add nbMyTurn to account/playing response
### Fixes
- **ci:** Run the stable job on stable, not the toml-pinned MSRV
- Stop Dependabot from bumping dtolnay/rust-toolchain (our MSRV pin)
### Dependencies & spec
- Bump reference/lichess-api from `1e03c61` to `0d11023` (#12)
- Bump actions/checkout from 6 to 7 in the github-actions group (#13)
- Bump bytes from 1.11.1 to 1.12.0 in the cargo-minor-patch group (#14)
- Bump quinn-proto 0.11.14 -> 0.11.15 (RUSTSEC-2026-0185)
- Bump sha2 from 0.10.9 to 0.11.0 (#9)
- Bump reference/lichess-api from `f38daa5` to `1e03c61` (#6)
- Bump CodeQL action to v4 (Node 24, clears deprecation warnings)
## [v0.1.0](https://github.com/obazin/litchee/releases/tag/v0.1.0) — 2026-06-15
### Features
- Add opt-in retry of rate-limited (429) requests
- Make the NDJSON line cap configurable; document it as a DoS guard
- Add a read timeout to detect stalled connections
- Add HEAD /api/study/{id}.pgn study metadata endpoint
### Fixes
- Raise default read timeout to 5 minutes
- Bound the NDJSON line buffer to avoid unbounded growth
- Map SwissUnauthorisedEdit 401 to a specific error variant
- Redact team entry password from Debug output
- Percent-encode user-supplied URL path segments
- Redact external-engine secrets from Debug output
- Redact bearer token from client Debug output
### Performance
- Return a Display adapter from http::segment to avoid an allocation
### Refactor
- Redact secrets via a Secret newtype instead of per-struct Debug
- Flatten each API concern into a single module file
### Documentation
- Record cargo-public-api nightly requirement in the API-freeze playbook
- Refresh README and PKCE guide for the OAuth example and recent features
- Add end-to-end PKCE OAuth example
- Add API-freeze playbook toward 1.0 (todo.md)
- Note why numeric path params skip percent-encoding
- Warn that a non-TLS base URL transmits the token in cleartext
- Add beginner PKCE flow guide and link it from the README
- Point repository URL at obazin/litchee
### Dependencies & spec
- Vendor lichess-api spec as a submodule at latest upstream
- Bump CI toolchain, raise MSRV to 1.95, and satisfy clippy