[Foundry P1] Connection status: one holder with handoff, last seen, and a lasting indicator in Foundry

rbrooks commented

2026-06-23 00:42:32 +00:00

Owner

Rewritten 2026-11-07 for the module design (D333–D338, #4). A "Test connection" can't reach a world that isn't open, so status is what the socket reports.

The contract: docs/design/foundry-connection.md (branch feat/5-foundry-connect).

Scope

One holder per campaign across both uvicorn workers, through a Redis DB 0 key with a 30 s TTL refreshed every 10 s. Other GMs' browsers wait on standby and take over within 2 s of a clean close, or within 30 s of a crash (the test's handoff, now across workers).
Heartbeat: a token check every 10 s, so an unpair closes the socket. A ping every 30 s. last_seen_at is written at most once a minute.
Quest Board: Settings → Foundry shows "Connected (Ryan's browser)", or "Not connected: open your world in Foundry", with last seen, and how many GMs are waiting behind the holder.
Foundry: a lasting indicator under the players list for GMs (Connected / Waiting (held by …) / Not connected), the same in the module's form (#4 finding 2). Reconnect backoff from 1 s up to 30 s, and none after an unpair.
Chat whispers to GMs (the comment below) are a question for the owner; they mostly belong to slice 2, with commands.

Done when

On foundry-dev, with two GMs in The Amberwake Accord, only one holds the link, closing it hands over, and Settings → Foundry shows the holder and last seen. Restarting the backend reconnects without input.

**Rewritten 2026-11-07 for the module design** (D333–D338, #4). A "Test connection" can't reach a world that isn't open, so status is what the socket reports. **The contract:** `docs/design/foundry-connection.md` (branch `feat/5-foundry-connect`). ## Scope - **One holder per campaign** across both uvicorn workers, through a Redis DB 0 key with a 30 s TTL refreshed every 10 s. Other GMs' browsers wait on standby and take over within 2 s of a clean close, or within 30 s of a crash (the test's handoff, now across workers). - **Heartbeat:** a token check every 10 s, so an unpair closes the socket. A ping every 30 s. `last_seen_at` is written at most once a minute. - **Quest Board:** Settings → Foundry shows "Connected (Ryan's browser)", or "Not connected: open your world in Foundry", with last seen, and how many GMs are waiting behind the holder. - **Foundry:** a lasting indicator under the players list for GMs (Connected / Waiting (held by …) / Not connected), the same in the module's form (#4 finding 2). Reconnect backoff from 1 s up to 30 s, and none after an unpair. - **Chat whispers to GMs** (the comment below) are a question for the owner; they mostly belong to slice 2, with commands. ## Done when On foundry-dev, with two GMs in The Amberwake Accord, only one holds the link, closing it hands over, and Settings → Foundry shows the holder and last seen. Restarting the backend reconnects without input.

rbrooks added this to the v5.0.0 - Foundry: Connect & Push milestone

2026-06-23 00:42:32 +00:00

rbrooks added the

backend

enhancement

frontend

labels

2026-06-23 00:42:32 +00:00

rbrooks referenced this issue

2026-06-24 04:21:51 +00:00

[Foundry] Bidirectional integration — architecture & design reference #24