From 2d40aea50912f567fe18757df211ae20d5c0b8c2 Mon Sep 17 00:00:00 2001 From: Levi Neuwirth Date: Wed, 12 Aug 2026 22:56:41 +0200 Subject: [PATCH] docs: state the PanelPointer pin's blast radius exactly The comment claimed every v6-v23 daemon decodes the variants before `PanelPointer` on every session. False on both counts: `PanelPointer` arrived at v21 and is gated, so a wedge before it shifts its discriminant and breaks v21-v23 PANEL traffic --- not v6-v20, and not every session. The pin itself is unchanged and still fires (15 -> 16). What was wrong was the justification, and an inflated one is not harmless: it sends the next reader hunting a larger blast radius than exists, and it teaches the wrong rule about which populations an insertion actually reaches. Co-Authored-By: Claude Opus 5 Claude-Session: https://claude.ai/code/session_016bqGA6s9tTUFzYpbeW3tai --- src/protocol.rs | 11 ++++++++--- 1 file changed, 8 insertions(+), 3 deletions(-) diff --git a/src/protocol.rs b/src/protocol.rs index ede6caf..474473b 100644 --- a/src/protocol.rs +++ b/src/protocol.rs @@ -1981,9 +1981,14 @@ mod tests { // only they can witness the shift. // // `PanelPointer` was the last `FrontendEvent` variant at v23. - // Every v6–v23 daemon decodes the variants below it on every - // session, so a variant inserted anywhere earlier is a silent - // wire break for all of them. + // Inserting anything before it shifts its discriminant and + // breaks **v21–v23 panel traffic** — `PanelPointer` arrived at + // v21 and is gated, so that is its whole population, not every + // peer and not every session. Stated exactly rather than + // dramatically: an earlier version of this comment claimed + // every v6–v23 daemon on every session, which is false and + // would send the next reader hunting a larger blast radius than + // exists. let ev = FrontendEvent::PanelPointer { frontend_id: FrontendId(2), geometry_epoch: 1,