# Dispatch Assignment — Client Map Explorer

## Task Overview
Investigate client world renderer, isometric math, canvas renderer, mobile memory footprint, collision engine, fog of war, minimap HUD, and monster system in FreeExile.
Authoritative user request: `c:\Projects\FreeExile\.agents\teamwork\ORIGINAL_REQUEST.md` (section `## 2026-10-01T19:19:13Z`).

## Scope & Target Files
- `client/webapp/js/engine/world_renderer.js` (Current mathematical tile renderer, viewport drawing)
- `client/webapp/js/engine/collision_engine.js` (Boundary collision, wall sliding)
- `client/webapp/js/engine/iso_math.js` (worldToIso, isoToWorld, camera lerp)
- `client/webapp/js/engine/canvas_renderer.js` (Render loop, player update, viewport bounds)
- `client/webapp/js/engine/monster_system.js` (Monster init, AI update, pathfinding)
- `client/webapp/js/data/wilderness_zone_packs.js` (Current pack definitions)
- `client/webapp/index.html` (HUD, canvas setup, minimap container)

## Deliverables
Produce a comprehensive report at:
`c:\Projects\FreeExile\.agents\teamwork\explorer_survey_client\report.md`
and write `handoff.md` with findings, architecture recommendations, and exact file paths/line numbers.

## 2026-10-01T19:21:45Z
You are Client Map Explorer.
Your working directory is: c:\Projects\FreeExile\.agents\teamwork\explorer_survey_client
Your dispatch assignment is: c:\Projects\FreeExile\.agents\teamwork\explorer_survey_client\DISPATCH.md
MANDATORY: Read the authoritative user request at:
c:\Projects\FreeExile\.agents\teamwork\ORIGINAL_REQUEST.md (specifically section ## 2026-10-01T19:19:13Z).
Also consult c:\Projects\FreeExile\GEMINI.md and c:\Projects\FreeExile\AGENTS.md.

Investigate client-side rendering, collision, fog of war, minimap, and monster systems:
1. Examine client/webapp/js/engine/world_renderer.js (lines 1-461) to see how terrain is currently rendered via math formulas and how to replace it with tile grid rendering.
2. Examine client/webapp/js/engine/iso_math.js (worldToIso, isoToWorld, camera lerp, TILE_W=64, TILE_H=32).
3. Examine client/webapp/js/engine/canvas_renderer.js and entity_renderer.js for viewport bounds and layer ordering.
4. Examine client/webapp/js/engine/collision_engine.js to see current boundary clamp and wall sliding, and how to integrate tile lookup isPositionBlocked(wx, wy).
5. Examine client/webapp/js/engine/monster_system.js and client/webapp/js/data/wilderness_zone_packs.js to see how monsters are initialized and how to anchor them to encounter zone tiles.
6. Examine client/webapp/index.html for HUD structure, styles, and where to place the 120x80 Minimap canvas and boss gate popup.
7. Assess mobile performance implications: 16x16 chunk OffscreenCanvas caching, RAM consumption, draw calls, and benchmark tooling.

Write your comprehensive findings and recommendations to:
c:\Projects\FreeExile\.agents\teamwork\explorer_survey_client\report.md
and write a standard handoff.md in your directory.
Send a message back to parent when complete.
