1 files changed, 4 insertions, 0 deletions

diff --git a/CONTEXT.md b/CONTEXT.md
index a9b85b9..5f27572 100644
--- a/CONTEXT.md
+++ b/CONTEXT.md
@@ -283,6 +283,10 @@ vocabulary / decisions.
 - Never pipe-mask build failures:
   `./build.sh > /tmp/build.log 2>&1; echo rc=$?`.
 - `CHLClient` slot numbers: `CreateMove` 21, `FrameStageNotify` 35.
+- Networked EHANDLE values use an 11-bit entity index in the low bits; bits
+  11+ are the serial. Mask with `0x7FF`, not the local `CBaseHandle` 16-bit
+  mask. This caused active-weapon lookups to produce bogus indices after a
+  map change once the weapon serial was nonzero (melee killbot looked dead).
 - `ISurface` binary slot = SDK header slot + 4; see `src/ISURFACE_STATUS.md`.
 - Silent aim and ABH temporarily replace the usercmd view; silent aim preserves
   movement, ABH intentionally zeroes it for the jump tick.