From c3ab6bb8c8e3934aa54763698ebcbc325dbb6232 Mon Sep 17 00:00:00 2001 From: matthew-pilot Date: Thu, 18 Jun 2026 11:29:45 +0000 Subject: [PATCH] docs: add version compatibility table to SPEC.md (PILOT-421) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Add a version compatibility table near the top of SPEC.md mapping spec versions (v0.1–v0.4 → code v1.0–v1.3.x, v0.5 → v1.4–v1.11.x) so developers can quickly determine which spec version corresponds to their software release. Closes PILOT-421 --- SPEC.md | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/SPEC.md b/SPEC.md index 8b9610f..c8c1b71 100644 --- a/SPEC.md +++ b/SPEC.md @@ -1,5 +1,16 @@ # Pilot Protocol Wire Specification v0.5 +## Version Compatibility + +The table below maps wire specification versions to corresponding Pilot Protocol software releases. Each spec version is backward-compatible within its minor series. + +| SPEC Version | Pilot Protocol Release(s) | Notable Changes | +|---|---|---| +| v0.1 – v0.4 | v1.0.0 – v1.3.x | Early spec iterations, pre-extraction. | +| v0.5 | v1.4.0 – v1.11.x | Current specification. Stable frame format, addressing, tunnel encapsulation, NAT traversal, and all transport layers (native UDP, compat WSS). | + +> **Note:** SPEC.md was extracted from the main `pilotprotocol` repository into its own `pilot-protocol/docs` repo. The current software version is determined by `git describe --tags` in the [pilotprotocol](https://github.com/TeoSlayer/pilotprotocol) repository. + ## 1. Addressing ### 1.1 Virtual Address Format