1 files changed, 11 insertions, 3 deletions

diff --git a/CONTEXT.md b/CONTEXT.md
index 737a6b2..7a1ee33 100644
--- a/CONTEXT.md
+++ b/CONTEXT.md
@@ -258,6 +258,15 @@ vocabulary / decisions.
   assist deliberately writes only `m_vecAbsVelocity`; `SetAbsVelocity` syncs
   `m_vecVelocity` after the command.
 
+## Logging
+
+- `/tmp/hl2hake.log` is opened once at startup with `"w"` (so it only contains
+  the current session), line-buffered, and closed via `atexit`.
+- `logf` is always on: lifecycle, warnings/errors, config, GUI open/close and
+  item-crate detections.
+- `logd` is off unless `HL2H_DEBUG=1`; it carries per-scan ESP/NPC/item-prop,
+  aimbot-target, bone and netvar noise. Run `HL2H_DEBUG=1 ./play.sh` to enable.
+
 ## Gotchas / lessons
 
 - Never pipe-mask build failures:
@@ -275,9 +284,8 @@ vocabulary / decisions.
 - Scans the client entity list every 100 ms and tags health, ammo, armor/suit,
   world weapon pickups, the two supply-crate models and generic items.
 - Each tag is a colored marker with a name and optional distance, filtered by
-  category toggles and a max-distance slider (default 5000 units). Supply
-  crates ignore the distance limit. Drawn through walls and independently of
-  the hostile NPC ESP.
+  category toggles and a max-distance slider (default 5000 units). Drawn
+  through walls and independently of the hostile NPC ESP.
 - Ammo labels are specific where the model is known: pistol, SMG, AR2, .357,
   crossbow, shotgun, sniper, flares, AR2 grenade, RPG rocket, plus ammo-crate
   variants. Unknown ammo falls back to "Ammo".