/ adrs / 0003-protocol-versioning.md
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