chore(hole): neteja de comentaris obsolets i notes sobre riscos latents

source/game/entities/concrete/hole.hpp

@@ -8,9 +8,12 @@
 //   - `collides_=false` + `triggers_on_overlap_=true`: rep `onPlayerContact`
 //     pel bucle de `EntityManager::checkPlayerCollisions` sense bloquejar
 //     el moviment del jugador.
-//   - `height_=0`: el filtre de col·lisió per altura existent deixa que
-//     un jugador AIRBORNE amb `jump_z_>0` el creui sense disparar res
-//     (saltar per damunt d'un forat).
+//   - `height_=0`: el filtre per altura del bucle (`jump_z > height`) NO
+//     s'activa amb height a zero, així que el bucle de contacte SÍ crida
+//     `onPlayerContact` també per a jugadors AIRBORNE. Qui rebutja els
+//     estats distints de GROUNDED (saltant, caient, HURT, DYING...) és el
+//     guard explícit dins de `Hole::onPlayerContact`. El filtre d'altura
+//     és una optimització ortogonal del bucle, no la defensa principal.
 //   - Damage 0: el contacte no publica `player_hit`. En lloc d'això,
 //     `onPlayerContact` invoca `Player::enterHoleFall`, que transiciona
 //     el jugador a AIRBORNE amb subestat `falling_through_hole_`.
@@ -32,3 +35,7 @@ class Hole : public StaticHazard {
     // jugador armi el clip rect a la Y de la base del forat.
     void onPlayerContact(Player* player) override;
 };
+
+// TODO(hole-feature): afegir reset de `falling_through_hole_` i `hole_clip_bottom_y_` a `Player::disable()` per simetria.
+// TODO(hole-feature): si apareix un quart callsite del càlcul "pixel→tile" o "tileRect", factoritzar a `Map::` (avui: Mummy::reactToCurrentTile, Mummy::isDecalAheadInDir, Player::integrateJump).
+// TODO(hole-feature): afegir tests dedicats del comportament de la mòmia amb forats (no requereixen Player real).