0003-protocol-versioning.md
1 # ADR-0003 — Version the Protocol Separately From Package Version 2 3 Date: 2026-05-07 4 5 Status: Proposed 6 7 ## Context 8 9 The package can evolve independently from the wire protocol. A minor package release may contain documentation or server-only improvements without protocol changes. 10 11 ## Decision 12 13 Use `lightspeed` as the protocol name and maintain a separate integer protocol version. 14 15 ## Consequences 16 17 Easier: 18 19 - compatibility checks 20 - multi-version adapters 21 - explicit browser/server negotiation 22 23 Harder: 24 25 - maintainers must document two version axes 26 - tests must cover protocol compatibility separately 27 28 ## Alternatives considered 29 30 - use package semver as protocol version 31 - no explicit protocol version until beta