Add heartbeat telemetry support

src/lib/beta-evidence.ts

@@ -17,7 +17,7 @@ export function betaWaitingCondition(requirement: BetaRequirement, observation?:
         if (requirement.kind === 'matches') return requirement.minMinutes && !observation.matchStarted
             ? 'This match has no game-start report, so its duration cannot qualify. Waiting for a new game start and game end.'
             : `Waiting for game end${requirement.minRound ? ` after reaching round ${requirement.minRound}` : ''} with ${players}${requirement.minMinutes ? ` and at least ${requirement.minMinutes} minutes since game start` : ''}.`;
-        if (requirement.kind === 'round') return `Waiting for a round change or game end reporting round ${requirement.target} or higher with ${players}.`;
+        if (requirement.kind === 'round') return `Waiting for a round change, heartbeat, or game end reporting round ${requirement.target} or higher with ${players}.`;
         return `Time is credited when the next report arrives, with ${players} at both ends of the interval. It does not advance continuously between reports.`;
     }
     return 'Waiting for qualifying evidence.';
@@ -27,8 +27,8 @@ export function betaEvidenceSummary(event: BetaTestView['evidence'][number]): st
     let payload: Record<string, unknown>;
     try { payload = JSON.parse(event.payload); } catch { return event.kind.replaceAll('-', ' ').replaceAll('_', ' '); }
     if (!payload || typeof payload !== 'object') return event.kind;
-    if (['game_start', 'round_change', 'game_end'].includes(event.kind)) {
-        const label = event.kind === 'game_start' ? 'Game started' : event.kind === 'game_end' ? 'Game ended' : 'Round changed';
+    if (['game_start', 'round_change', 'heartbeat', 'game_end'].includes(event.kind)) {
+        const label = event.kind === 'game_start' ? 'Game started' : event.kind === 'game_end' ? 'Game ended' : event.kind === 'heartbeat' ? 'Heartbeat' : 'Round changed';
         return `${label}${typeof payload.round === 'number' ? ` at round ${payload.round}` : ''}${Array.isArray(payload.players) ? ` with ${payload.players.length} players` : ''}${typeof payload.map === 'string' ? ` on ${payload.map}` : ''}.`;
     }
     if (event.kind === 'manual-sign-off') return `${payload.requirement ?? 'Checklist'}: ${payload.note ?? 'Signed off'}`;

src/lib/fleet-overview.ts

@@ -64,7 +64,7 @@ export function fleetIdentity(server: FleetServer) {
 }
 
 export function currentRound(server: FleetServer, report: GameTelemetry | undefined, now: number): number | null {
-    if (!report || report.event !== 'round_change' || !freshServer(server, now) || !server.active_since || !server.game_started_at
+    if (!report || (report.event !== 'round_change' && report.event !== 'heartbeat') || !freshServer(server, now) || !server.active_since || !server.game_started_at
         || server.game_ended_at || (server.last_players ?? 0) === 0) return null;
     const received = Date.parse(report.receivedAt);
     const age = now - received;

src/lib/server/fleet/beta-tests.ts

@@ -75,7 +75,7 @@ export function testView(betaId: number): BetaTestView | null {
         servers: runs.map(run => {
             const metrics = readMetrics(run);
             const progress = evaluateRequirements(plan, metrics, run.phase);
-            const latest = db().prepare("SELECT received_at, kind, payload FROM beta_test_evidence WHERE run_id = ? AND kind IN ('game_start','round_change','game_end') ORDER BY id DESC LIMIT 1").get(run.id) as { received_at: string; kind: string; payload: string } | undefined;
+            const latest = db().prepare("SELECT received_at, kind, payload FROM beta_test_evidence WHERE run_id = ? AND kind IN ('game_start','round_change','heartbeat','game_end') ORDER BY id DESC LIMIT 1").get(run.id) as { received_at: string; kind: string; payload: string } | undefined;
             const event = latest ? JSON.parse(latest.payload) : null;
             return { server: run.server, phase: run.phase, passed: progress.every(r => r.passed), progress, observingAt: run.observing_at,
                 observation: { lastGameplayAt: latest?.received_at ?? null, lastEvent: latest?.kind ?? null,

src/lib/server/fleet/leaderboard-ingest.ts

@@ -60,7 +60,7 @@ export function recordLeaderboardTelemetry(handle: Database.Database, report: Ga
     const newMatch = !match || match.map_key !== identity.key
         || (isStart && (match.status !== 'active' || match.last_event !== 'game_start'))
         || (!isStart && round < match.highest_round)
-        || (report.event === 'round_change' && match.status !== 'active');
+        || ((report.event === 'round_change' || report.event === 'heartbeat') && match.status !== 'active');
 
     if (newMatch) {
         if (match?.status === 'active') {

src/lib/telemetry.ts

@@ -13,16 +13,16 @@ export interface TelemetryPlayerStats extends TelemetryPlayer {
 
 export type GameEvent = { server: string; map: string } & (
     | { event: 'game_start'; players: TelemetryPlayer[] }
-    | { event: 'round_change' | 'game_end'; round: number; players: TelemetryPlayerStats[] }
+    | { event: 'round_change' | 'heartbeat' | 'game_end'; round: number; players: TelemetryPlayerStats[] }
 );
 
 export type GameTelemetry = GameEvent & { receivedAt: string };
 
-/** Validate the three script payloads; beta state is never part of the protocol. */
+/** Validate the four script payloads; beta state is never part of the protocol. */
 export function parseGameEvent(value: unknown): GameEvent {
     if (!value || typeof value !== 'object' || Array.isArray(value)) throw new Error('Payload must be a JSON object');
     const body = value as Record<string, unknown>;
-    if (!['game_start', 'round_change', 'game_end'].includes(String(body.event))) throw new Error('event must be game_start, round_change, or game_end');
+    if (!['game_start', 'round_change', 'heartbeat', 'game_end'].includes(String(body.event))) throw new Error('event must be game_start, round_change, heartbeat, or game_end');
     for (const key of ['server', 'map'] as const) {
         if (typeof body[key] !== 'string' || !body[key].trim() || body[key].length > 255) throw new Error(`${key} must be a nonempty string (up to 255 characters)`);
     }
@@ -48,5 +48,5 @@ export function parseGameEvent(value: unknown): GameEvent {
     const common = { server: body.server as string, map: body.map as string };
     if (body.event === 'game_start') return { ...common, event: 'game_start', players };
     if (!Number.isSafeInteger(body.round) || (body.round as number) < 0) throw new Error('round must be a nonnegative integer');
-    return { ...common, event: body.event as 'round_change' | 'game_end', round: body.round as number, players: players as TelemetryPlayerStats[] };
+    return { ...common, event: body.event as 'round_change' | 'heartbeat' | 'game_end', round: body.round as number, players: players as TelemetryPlayerStats[] };
 }

src/lib/ui/components/BetaTestProgress.svelte

@@ -17,7 +17,7 @@
     const expired = $derived(test.outcome === 'inconclusive' || (!!deadline && test.outcome !== 'passed' && Date.parse(deadline) <= Date.now()));
     const ranked = $derived([...test.servers].sort((a,b) => (a.progress.some(r => r.failed) ? 0 : a.passed ? 2 : 1) - (b.progress.some(r => r.failed) ? 0 : b.passed ? 2 : 1) || a.server.localeCompare(b.server)));
     const filteredEvidence = $derived(test.evidence.filter(event => (!evidenceServer || event.server === evidenceServer)
-        && (!evidenceKind || (evidenceKind === 'gameplay' ? ['game_start','round_change','game_end'].includes(event.kind) : evidenceKind === 'health' ? ['health','status-sample'].includes(event.kind) : event.kind === evidenceKind))
+        && (!evidenceKind || (evidenceKind === 'gameplay' ? ['game_start','round_change','heartbeat','game_end'].includes(event.kind) : evidenceKind === 'health' ? ['health','status-sample'].includes(event.kind) : event.kind === evidenceKind))
         && (!evidenceQuery || `${betaEvidenceSummary(event)} ${event.payload}`.toLowerCase().includes(evidenceQuery.toLowerCase()))));
     $effect(() => { evidenceServer; evidenceKind; evidenceQuery; evidenceLimit = 25; });
     function reportAge(at:string) { const minutes=Math.max(0,Math.floor((Date.now()-Date.parse(at))/60000));return minutes<1?'less than a minute ago':minutes<60?`${minutes}m ago`:`${Math.floor(minutes/60)}h ${minutes%60}m ago`; }

src/lib/ui/components/PlayerScoreboard.svelte

@@ -94,7 +94,7 @@
         </div>
     {/if}
     <div class="scoreboard-footer">
-        <p class="note">{report.event === 'game_start' ? 'Player stats arrive with the next round report.' : report.event === 'game_end' ? 'Final stats from this game. The scoreboard resets when the next game starts.' : 'Stats update at each round change and game end.'}</p>
+        <p class="note">{report.event === 'game_start' ? 'Player stats arrive with the next round report or heartbeat.' : report.event === 'game_end' ? 'Final stats from this game. The scoreboard resets when the next game starts.' : 'Stats update at each round change, heartbeat, and game end.'}</p>
         <a href="/leaderboard">View lifetime leaderboard →</a>
     </div>
 {/if}

src/lib/ui/components/RoundTelemetry.svelte

@@ -8,7 +8,7 @@
         && (!since || Date.parse(report.receivedAt) >= Date.parse(since)));
 </script>
 
-{#if report && report.event === 'round_change' && fresh}
+{#if report && (report.event === 'round_change' || report.event === 'heartbeat') && fresh}
     <div class="round" aria-live="polite">
         <strong>Round {report.round}</strong>
         <span title={report.receivedAt}>Last reported {elapsedSince(report.receivedAt, $uiNow)} ago · {report.players.length} players</span>