Implement Management Depth UI (agent roster, faction overview, focus management, heat maps)

[Copilot]

Adds Phase 12.2.1 Management Depth UI components for advanced simulation monitoring and interaction. Extends the existing terminal UI (Phase 12.1.1) with four new management views.

New Views

• Agent Roster (agent_view.py, 240 lines)

  • Displays all agents with expertise pips (●●●○○), stress meters, status indicators
  • Shows reliability scores, mission counts, current locations
  • Provides detailed agent inspection panel

• Faction Overview (faction_view.py, 244 lines)

  • Lists all factions with legitimacy/resource bars and trend indicators (↑↓→)
  • Displays territory control and faction relationships
  • Supports detailed faction inspection

• Focus Management (focus_view.py, 188 lines)

  • Shows current focus district and budget allocation
  • Visualizes ring vs global event distribution
  • Lists focus ring districts and archived event counts

• Heat Map Overlays (enhanced city_map.py)

  • Adds 5 overlay modes: unrest, pollution, security, prosperity, control
  • Color-coded metric visualization with smart thresholds
  • Legend display and keyboard shortcuts for mode switching

Example Usage

from gengine.echoes.cli.views import render_agent_roster, render_faction_overview

# Display agent roster
state = engine.get_state()
panel = render_agent_roster(state)
console.print(panel)  # Shows all agents with expertise, stress, status

# Show faction overview
faction_panel = render_faction_overview(state)
console.print(faction_panel)  # Lists factions with legitimacy bars

# Enable heat map on city map
city_map = CityMap(state, heat_map_mode='unrest')
city_map.render()  # City districts color-coded by unrest levels

Testing

Added 19 tests in test_management_ui.py covering all view renderers, heat map modes, and edge cases (empty states, missing data). All views extract live simulation state and maintain consistency with existing UI components.

All keyboard navigation hints integrated. Ready for EchoesShell integration in future PR.

Original prompt

"Issue 77 - Management Depth UI" to GameDev Agent

Created from Copilot CLI via the copilot delegate command.

---

💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.