server-skill

name	server-skill
description	Implement and operate Claude of Tanks signaling and dedicated authoritative multiplayer servers.

claude-of-tanks / server

Purpose

Provide bounded network coordination and dedicated ranked authority. The signaling server relays WebRTC descriptions/ICE only and never gameplay.

Mental model and invariants

• roomStore.js owns private-room rendezvous membership.
• signalingServer.js owns HTTP upgrade, origin/rate/payload gates, and relay.
• dedicatedMatchRegistry.js owns authenticated match lifecycle and reconnects.
• dedicatedMatchServer.js owns the authoritative WebSocket service boundary.
• rankedMatchmaker.js owns bounded queues, team balance, and match-ticket handoff; ratingStore.js owns bearer identities, persistent Elo, and idempotent results.
• dedicatedWorldCollision.js inflates match-local state from the generated sixteen-map collision manifest; do not hand-edit that manifest.
• A v1 browser-hosted room closes if its host leaves; never silently migrate a ranked authority to a player.
• Production signaling must run behind TLS with an explicit origin allowlist.
• TURN credentials come from deployment configuration and are never committed.
• Keep payloads, queues, rooms, rates, and lifetimes bounded.

Verification

Run node server/signaling.selftest.mjs and node server/dedicatedWorldCollision.selftest.mjs. Ranked changes additionally run the rating, matchmaker, HTTP, and real-WebSocket tests. Regenerate world manifests with tools/capture-world-collision-manifests.mjs after authored map collision changes. Any gameplay authority added here must also run the shared src/net tests, deterministic match tests, abuse cases, and real WebSocket soak/load tests.