---
title: "Game State"
method: GET
path: "/chatrooms/{room_name}/games/state"
tags: ["games"]
---

# Game State

`GET /chatrooms/{room_name}/games/state`

The caller's view of the game, plus server-side catch-up.

The poll is the hottest path in the product: every client in the room hits
it every two seconds for the whole game. It must not take the row lock in
the common case, and until 19 Aug it took it on every single call.

The bug was the predicate, not the intent. `needs_work` read
`round_phase != PHASE_COMPLETE`, which is not "is there work to do", it is
"is the game still running" — true for every poll of every live game. So
N clients serialised on one lock, each holding a threadpool thread and a
pooled DB connection while it waited. Latency compounds from there: slower
responses leave more polls outstanding, more outstanding polls queue deeper
on the lock. On gamma with three people it went 2.9s -> 32s -> 122s, drained
the 50-connection pool, and took down everything that had nothing to do with
games (Deepgram transcript writes, reminders, the room cleanup task) before
/health stopped answering and kubelet killed the container.

So: run the catch-up speculatively on the UNLOCKED row. `auto_advance`
reports whether it changed anything, and for a live game the answer is no on
almost every poll — a turn timer has to expire, or a lap has to finish.
Only then do we discard the speculative work, re-read FOR UPDATE and do it
again for real. Asking the spec directly is what keeps this honest: a
hand-written "is it due yet" predicate beside six formats' `tick` methods is
exactly the thing that drifts back into locking on every call.

## Path parameters

- `room_name` string, required

## Headers

- `authorization` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/fluentea/apis/aurqa-language-learning-platform-refactored.md) · [All operations](https://skmtc.dev/fluentea/apis/aurqa-language-learning-platform-refactored/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/fluentea/aurqa-language-learning-platform-refactored/revisions/aea5e6e7d830/schema)