docs/spec/

TL;DR. The normative phux wire protocol, split by tier per ADR-0015. Every file here is load-bearing for phux-protocol and any downstream consumer. SHALL / SHOULD / MAY language only inside this directory.

---

Files

File	Owns
proto.md	Framing, version negotiation, capabilities, flow control, transport
L1.md	Terminal substrate — the REQUIRED conformance tier
L2.md	Collection lifecycle — OPTIONAL
L3.md	Metadata storage — OPTIONAL
input.md	INPUT_KEY / INPUT_MOUSE / INPUT_FOCUS / INPUT_PASTE / INPUT_RAW
appendix-encoding.md	Encoding primitives (varints, strings, tagged unions, field-tag extensibility)
appendix-reserved.md	Reserved discriminant ranges
CHANGELOG.md	Wire-format change log, version-stamped

Version

The current protocol version lives in crates/phux-protocol/src/ (grep PROTOCOL_VERSION). The top entry in CHANGELOG.md must match it; CI gate spec-version-sync enforces this.