From 88fc344ed984629b335fc9c6ebd4bea7a7b1cca5 Mon Sep 17 00:00:00 2001
From: Jeroen Schweitzer <jpmschweitzer@gmail.com>
Date: Mon, 16 Feb 2026 01:08:29 +0100
Subject: [PATCH] docs(sprints): add protocol v7 bump requirement to client
 briefing

Server PR #23 bumped PROTOCOL_VERSION to 7 (pending_recognitions field).
Client must match before #431 fog entity visualization or joint testing.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
---
 docs/backups/settledreach.db.backup | Bin 311296 -> 311296 bytes
 docs/sprints/sprint-7/client.md     |  12 ++++++++++++
 2 files changed, 12 insertions(+)

diff --git a/docs/backups/settledreach.db.backup b/docs/backups/settledreach.db.backup
index 3eeb11b5047c4aa83c12252206b0761a5b12e26c..43ec85deb6c78b61ba69a43316f2ba65dd5b022f 100644
GIT binary patch
delta 853
zcmZuuO-NKx6u$SK^XAQ)QD<b{WLDZsDkzb3M$M+EM3aaLD~zZXy>v2ler$Xbg=J%t
z7!;8S-4+EUK@=^t2R=}uA1A|2SQr*11i5O_q6o4@b*Bjz(dvBX=brO@-%TVuiG*kH
z*BY97P>Kl{gPDGLFvwuW3=KxXCIMkIWqvf5WzjKHdOXCK{k=K-w43#>dp5z84JMAi
zVSmT?=c~BNbWY6KU<@OsJo%L|5r4dj(Z3T(W2)DfqLwkmF0Gdgs=_8NyJ0(TaKk}Q
zA%4PPyo=W{jtk)ebcyb`8=l&sRZ7VdV(elroYP>hlq(^;gO~UL2H-hf!J}{puAvis
z@DP5Qy4yv0mj|*+QVMukQ#2B!b@S-nJQ|rt<#3-k_z4fZrHlHi7x2xu0eMJ;{j{L3
zIzN-ns-V(hKBt0@NxONy3VBwo7p7&F{rykI%L^dI2+6c^3*npY&`Gwg?2r#o-Et>j
zCv_1*lHs%EE|N!&^>liz)@~T4d}9yTd2tdn*&pz)4frao-AQ<`1QubXCEo<U@Uc?J
z`a#oF6q>R`7%#>FA`MuMN$8XM>gBAYcD63PH+)X_T6bPUGv%jdse><_h9XRFwYE&d
zqpjj^6ie2y2N){-y1O&W3Hhue7&{(}iOt^S_~ih#S@s0B%FdkRY8UacZkc%b>0aE1
zX*2nYUMzNJm{w*U3R#xzJRSroeaL4uU%(qGj3`xtJ}#zAfTCNd+MN!_W3?rv<z?bj
z&0TzALzOn<a{C~zWVAtOTtUxtW3o1fcuAZr&L?@q@6R{%j<)KiCaoqKF@h0ePbl83
zHAchjf=tBFjznXch%LrRts~uu1v{dlxX}`g9M&7#Leb`Mu&E^;{&Ut>>Z>d%^_7%W
wXg+_SqAE~P_HRiMwTvojW(e0Sj#x4v=&)VFgQ8Jflks5R=>I&pJc{l38-PLfR{#J2

delta 651
zcmZXQT}V@L7{<^4yze<@A7^^THqutIQu^A3a}LTG6j%~bu?AgPiy33~p<8oy6UEV^
ztg@mt=pR^6(Tx!~J>b6@QJpdoFS1w|lpuH!bkR*W2~izMqUgPTp5OC4ud2FK)m8ji
zPhN}#Pz3`P3Q{qlcNJ5Rk682teT_^EU3fOi>ko}yzOZ>>nzww^@zr}?v~J}@j-y|$
z;YQs)wJ3stSzVg>%In|XW{7FmvgKU1Ojx$eUv3ue6BnGNk^+0kHyTyokjF37;Ab4i
zVZ4Do*oIXwXetcF1PL#tDSFWf{WXG9K==S}a31c!Bwoc1xQ=!V!V~y`ul2YRA#|Gy
zWO~5`lf*%NGPrs2n0B}!wo>MnPk~zgXxHI%CY8)2y1Pj$op(bOiPA+k1RXMX`S$pc
z<0n!{a*u8Cz=DLP@i&Y%u7-(!Bq1i$0BN_yI7i&NS85|Mrl_!w$XdEDRLQL%CkIY@
zS!XYd6B@V#cIwx_Ck4ZyhH#*PMKu^(1=YBnNw=VpHy4QfQX6DD?t<aRAx;=#wi(C^
zvbMgjb&1#6AFpK(-a(Ss{~AH7XJG?2G=)QK=PW$kWxmbBBp(hyA+DUK);hE^UmbpG
zBfu;w9+T`&ZBr%Z;d>>{OV8wRx3oN(PUq0?ST5L|$ec=Kn0O8kf?(2vO)NQxH{I~a
z+G18lFJX1J(QU~`9IRy+pNr@sa~0H5#C7JD5yIw1vDs?t(ZUsG)_yZ;Z3*lDL>(yo
K7j>nCY5WBym&C{b

diff --git a/docs/sprints/sprint-7/client.md b/docs/sprints/sprint-7/client.md
index 1c68cf14c..ff4a37f9d 100644
--- a/docs/sprints/sprint-7/client.md
+++ b/docs/sprints/sprint-7/client.md
@@ -237,6 +237,15 @@ Use `db/connectors/ticket show <id>` for full details.
 - Response options are buttons/selectable text, not just labels
 - Auto-pause integration: future sprint (single-player pause when dialogue active)
 
+## Protocol Version Bump (REQUIRED)
+
+Server PR #23 bumped `PROTOCOL_VERSION` from 6 to 7 (new `pending_recognitions` field in `ObserverSnapshot`). The client **must** update to match before the next joint test.
+
+**File:** `client/scripts/protocol/protocol.gd:14`
+**Change:** `const PROTOCOL_VERSION: int = 6` → `const PROTOCOL_VERSION: int = 7`
+
+This is a prerequisite for #431 (fog entity visualization), which reads `pending_recognitions` to render cognitive delay grey blobs. Without the bump, the client will reject server handshakes or silently corrupt snapshot data.
+
 ## Dependency Chain
 
 ```
@@ -252,6 +261,9 @@ Parallel standalone:
 
 Server dependency:
 #423 (server cognitive delay) → #431 (fog entity viz)
+
+Protocol sync (REQUIRED before joint test):
+Protocol v7 bump → #431 (fog entity viz)
 ```
 
 ## Sprint 7 Client Load