1.0 KiB
ADR 0012: Testing Gates for Protocol-Visible Change
Status
Proposed
Context
FreeDMR behaviour was validated through real global servers, RF links, and community use. Protocol-visible changes can affect repeaters, terminals, dashboards, and peer servers.
Decision
Protocol-visible changes require deterministic, UDP, and live RF validation according to release gates.
Rationale
Deterministic tests catch state and rewrite errors. UDP black-box tests catch transport/subprocess/protocol integration issues. Live RF catches terminal/repeater quirks that harnesses cannot prove.
Consequences
Some changes take longer to release. The risk of breaking real deployments is reduced.
Compatibility
FreeDMR 1.x remains live while FreeDMR 2 behaviour is validated. Changes can be staged behind compatibility adapters.
Testing Requirements
Level 0 unit/support tests, Level 1 deterministic harness, Level 2 UDP black-box harness, and Level 3 live RF validation are required according to the risk and protocol visibility of the change.