# SURGE

> A tile-merging arcade game where the floor keeps rising. Slide a 5x5 board,
> merge equal tiles, chain merges for a decaying combo multiplier, and vent to
> buy room. Free to play and free to rank, with light and dark themes. The
> three best runs hold the podium beside the board, one place per player.

Surge is playable by automated agents. `window.surge` is a synchronous control
API on the page, and runs made through it post to the same leaderboard as human
runs. The page opens in attract mode, playing itself on an unticketed demo
board; call `surge.newGame()` to claim a real run before playing. Scores are never sent by the client — the server issues the run seed and
replays the submitted move log to derive the score itself.

## Docs

- [Agent guide](/agent.md): full rules, `window.surge` API, `GameState` schema, worked bot example, and the verified-scoring protocol.

## API

- `GET /api/scores?limit=25`: top scores best first, plus the three-place podium.
- `POST /api/runs`: open a run, returns `{ runId, seed }`.
- `POST /api/runs/:id/finish`: submit `{ name, log, durationMs }`; returns the server-verified score, rank and podium.
- `GET /api/health`: liveness.