Make Game-Mode lever hints locate, inspect, and simulate on click

[marota]

Summary

In Game Mode, the beginner-assistance "most-used levers" panel previously only pre-filled the Inspect field when a lever was clicked — it did not center on the asset, did not open the substation SLD, and offered no way to act on a lever. This makes each lever fully actionable:

• Single-click → locate & inspect: fills the Inspect field, centers the NAD on the element (resolving an injection or coupling switch to its home voltage level), and opens that substation's SLD so the beginner can inspect it.
• Double-click → simulate: runs the mapped action directly — a catalogue branch disco/reco or a coupling maneuver at the resolved VL — producing a card in the feed.
• Magnitude-free injection / PST levers carry no self-contained action (the amount differs per retained solution), so a double-click degrades to inspect with a hint to set the amount in the SLD.

The single-click action is deferred (250 ms) so a double-click pre-empts it, mirroring the existing VL-disk interaction convention.

Changes

Backend

• NetworkService.get_element_voltage_levels now also resolves generators, loads, and switches to their home voltage level (single-VL equipment). This is what lets an injection or coupling lever be located and its SLD opened. Existing branch/VL resolution keeps precedence; the switch probe is defensive (tolerates a missing column, a blank/non-string VL, or a backend that raises).

Frontend

• game/solutionLog.ts: buildLeverInteraction maps a lever signature to a workspace-agnostic LeverInteraction (inspect target + category + optional simulate spec).
• game/gameBridge.ts: replaces the inspect-only hook with a registerLeverHandler / requestLeverInteraction pair.
• game/GameHintsPanel.tsx: single-click (deferred) / double-click wiring on each lever.
• hooks/useLeverInteraction.ts (new): the App-side handler (VL resolution + centering + SLD open + simulate dispatch), kept out of App.tsx to stay under the hub size ceiling.
• hooks/useManualSimulation.ts: adds handleSimulateLever for coupling maneuvers, sharing a new streamSimulateToCard helper with the existing overview-pin flow.
• api.ts / types.ts: getElementVoltageLevels method + LeverCategory / LeverInteraction types.

App.tsx still never imports game internals beyond the bridge / solutionLog helpers.

Tests

• Backend (test_network_service.py, +10): generator / load / switch resolution, plus switch-probe robustness (blank / non-string VL, get_switches raising, missing column) and branch precedence.
• Frontend (+20): gameBridge.test.ts (new — the lever handler pair), buildLeverInteraction signature mapping, GameHintsPanel single/double-click, useLeverInteraction (all inspect/simulate branches, VL-resolution fallback, overflow-tab remap), and useManualSimulation.handleSimulateLever (stream + error paths).

Full suite green: frontend 1893 passed / 3 skipped, backend test_network_service.py 41 passed, code-quality gate OK, ESLint + ruff clean.

Docs

Updated frontend/CLAUDE.md and docs/features/game-mode-codabench.md to describe the new single-click / double-click behavior and the useLeverInteraction hook.

🤖 Generated with Claude Code