# PROGRESS: Milestone M4 Fog of War & Minimap HUD

Last visited: 2026-10-01T21:45:00Z
Agent: worker_m4_1

## Status: COMPLETED

### Completed Steps:
- [x] Initialized workspace and reviewed DISPATCH.md and ORIGINAL_REQUEST.md (§R4).
- [x] Investigated blueprints and handoffs from explorer_m4_1, explorer_m4_2, explorer_m4_3.
- [x] Verified baselines: test_mobile_webapp_config (15/15), test_tile_collision (11/11), test_poe2_map_system_e2e (81/81), map_render_benchmark (0 re-bakes, PASS), check_code_and_doc_hygiene (0 violations).
- [x] Implemented `client/webapp/js/ui/war_fog.js` (exactly 300 lines, zero-heap 3-state reveal/decay, < 2 KB bit-pack persistence, backwards-compatible modal simulator with 'BỊ CHẶN BỞI RÀO CẢN').
- [x] Implemented `client/webapp/js/ui/war_fog_renderer.js` (exactly 192 lines, 2-pass batched shroud + radial vignette falloff).
- [x] Wired entity suppression:
  - `client/webapp/js/engine/world_renderer.js` (473 lines <= 480): loot drops outside visible tiles suppressed; waypoints & boss gate suppressed until discovered (fogState >= 1); WarFogRenderer.render hook wired.
  - `client/webapp/js/engine/entity_renderer.js` (440 lines <= 450): active monsters and NPCs suppressed when fogState !== 2; unrevealed props suppressed when fogState === 0; fogged props dimmed.
  - `client/webapp/js/engine/monster_system.js` (486 lines <= 490): getBestCombatTarget ignores monsters on non-visible tiles (fogState !== 2).
  - `client/webapp/js/engine/canvas_renderer.js` (332 lines <= 350): updatePlayerVision and MinimapHUD.update frame hooks.
  - `client/webapp/js/engine/tile_grid_loader.js` (163 lines <= 350): initFog and MinimapHUD.setMap on map load.
- [x] Created `client/webapp/js/ui/minimap_hud.js` (261 lines <= 280): dedicated 120x80 px canvas, uniform aspect-ratio projection, dual-layer baseCanvas caching, 30 Hz throttling, dynamic markers.
- [x] Updated `client/webapp/index.html` (199 lines <= 200): #minimap-container and minimap_hud.js script import.
- [x] Created `tests/unit/test_fog_and_minimap.py` (198 lines <= 300): 11 tests covering all M4 requirements.
- [x] Verified all test suites:
  - `pytest tests/unit/test_fog_and_minimap.py -v`: 11/11 PASS
  - `pytest tests/unit/test_tile_collision.py -v`: 11/11 PASS
  - `pytest tests/unit/test_mobile_webapp_config.py -v`: 15/15 PASS
  - `pytest tests/e2e/test_poe2_map_system_e2e.py -v`: 81/81 PASS
  - `node tools/perf/map_render_benchmark.js`: PASS (0 stationary re-bakes, approved)
  - `pytest tests/unit/ -q`: 960 passed with zero regressions
  - `python tools/lint/check_code_and_doc_hygiene.py --strict`: 0 violations