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 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_016bqGA6s9tTUFzYpbeW3tai
This commit is contained in:
Levi Neuwirth 2026-08-12 22:56:41 +02:00
parent 69b9e6a41f
commit 2d40aea509
No known key found for this signature in database
1 changed files with 8 additions and 3 deletions

View File

@ -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,