Skip to content

0035. Keep the wire format a stable contract

  • Status: Accepted
  • Date: 2026-10-09
  • Source: PR #64 (commit cc59a32), recorded as D-35 in DESIGN_DECISIONS.md

Decision

Wire kinds and error codes are never renamed. A breaking change to an envelope raises WireVersion, and readers reject versions they do not know. New fields are optional and omitted when empty, so an older reader still decodes a newer envelope of the same version. A marker carries its interrupt on the wire, so a remote client can reply by interrupt ID and see the deadline. A persisted tree carries its own format version, tree.TreeFormatVersion, under the same rule. A tree saved before the field existed reads as version 1.