josh/electric-cherry
1
0
Fork 0
Code Issues 18 Pull Requests Actions Packages Projects Releases Wiki Activity

Add real time, match duration, and round context to chat

Browse Source
This commit is contained in:
josh
2026-10-02 13:21:55 -04:00
parent 65d3a99846
commit d7b3e124e6
8 changed files with 505 additions and 26 deletions
Download Patch File Download Diff File Expand all files Collapse all files
tests/unit/game-chat.test.ts
+119 -1
View File
@@ -1,5 +1,5 @@
import { describe, expect, it } from 'vitest';
import { parseGameChat, parseGameChatTimeline } from '../../src/lib/game-chat.js';
import { enrichGameChatTimeline, parseGameChat, parseGameChatTimeline, type ChatMatch, type ChatRoundReport } from '../../src/lib/game-chat.js';
describe('game chat', () => {
it('extracts say messages and ignores joins', () => {
@@ -78,3 +78,121 @@ describe('game chat', () => {
expect(entries.every(entry => entry.type === 'message')).toBe(true);
});
});
describe('chat time and round context', () => {
const at = (seconds: number) => new Date(Date.parse('2026-10-02T12:00:00Z') + seconds * 1000).toISOString();
const match = (start: number, end: number, overrides: Partial<ChatMatch> = {}): ChatMatch => ({
startedAt: at(start), endedAt: at(end), lastReceivedAt: at(end), status: 'completed', startObserved: true, ...overrides
});
const report = (seconds: number, round: number, overrides: Partial<ChatRoundReport> = {}): ChatRoundReport => ({
receivedAt: at(seconds), event: 'round_change', round, playerCount: 2, ...overrides
});
const say = (time: string, message = 'hello') => `${time} say;abc;0;Player;${message}`;
const unavailable = { realTime: null, matchElapsedMs: null, round: null };
it('anchors to the final log event and uses gameplay start, excluding engine idle time', () => {
const lines = ['60:00 InitGame:', say('62:07'), say('62:15'), '62:30 J;def;1;Other'];
const entries = enrichGameChatTimeline(lines, { mtime: at(150), matches: [match(120, 300)],
reports: [report(125, 3), report(130, 4)] });
expect(entries[1].context).toEqual({ realTime: at(127), matchElapsedMs: 7000, round: 3 });
expect(entries[2].context).toEqual({ realTime: at(135), matchElapsedMs: 15000, round: 4 });
expect(entries[0].context).toEqual({ realTime: at(0), matchElapsedMs: null, round: null });
});
it('associates messages with their own match when the engine clock continues across matches', () => {
const entries = enrichGameChatTimeline(['60:00 InitGame:', say('60:30', 'old'), '61:00 ExitLevel:',
'62:00 InitGame:', say('62:30', 'new')], { mtime: at(150), matches: [match(10, 60), match(130, 200)],
reports: [report(20, 8), report(140, 2)] });
expect(entries[1].context).toEqual({ realTime: at(30), matchElapsedMs: 20000, round: 8 });
expect(entries[4].context).toEqual({ realTime: at(150), matchElapsedMs: 20000, round: 2 });
});
it('does not carry wall time backward across a clock reset on a non-chat line', () => {
const entries = enrichGameChatTimeline([say('80:00', 'old'), '0:00 J;abc;0;Player', say('0:30', 'new')],
{ mtime: at(300), matches: [match(0, 500)], reports: [report(280, 10)] });
expect(entries[0].context).toEqual(unavailable);
// The preceding match cannot leak past the inferred new match at 12:04:30.
expect(entries[2].context).toEqual({ realTime: at(300), matchElapsedMs: null, round: null });
});
it('treats repeated zero-time InitGame and untimed lifecycle events as unanchored earlier sessions', () => {
for (const boundary of ['0:00 InitGame:', 'InitGame:', 'ShutdownGame:']) {
const entries = enrichGameChatTimeline([say('0:00', 'old'), boundary, say('0:30', 'new')],
{ mtime: at(300), matches: [], reports: [] });
expect(entries[0].context).toEqual(unavailable);
expect(entries.at(-1)?.context.realTime).toBe(at(300));
}
});
it('can enrich a tail without InitGame but never invents a start for a partially observed match', () => {
const options = { mtime: at(150), matches: [match(100, 300)], reports: [report(140, 8)] };
expect(enrichGameChatTimeline([say('800:00')], options)[0].context)
.toEqual({ realTime: at(150), matchElapsedMs: 50000, round: 8 });
options.matches[0].startObserved = false;
expect(enrichGameChatTimeline([say('800:00')], options)[0].context)
.toEqual({ realTime: at(150), matchElapsedMs: null, round: 8 });
});
it('does not treat old or future reports, game starts, or the highest round as the message round', () => {
for (const reports of [[report(29, 5)], [report(151, 10)],
[report(140, 0, { event: 'game_start', round: null })], []]) {
expect(enrichGameChatTimeline([say('62:30')], { mtime: at(150), matches: [match(0, 300)], reports })[0].context)
.toMatchObject({ realTime: at(150), round: null });
}
});
it('does not continue match context after an empty report, game end, or an unreported new log session', () => {
for (const change of [report(140, 8, { playerCount: 0 }), report(140, 8, { event: 'game_end' })]) {
expect(enrichGameChatTimeline([say('62:30')], { mtime: at(150), matches: [match(0, 300)],
reports: [report(130, 7), change] })[0].context)
.toEqual({ realTime: at(150), matchElapsedMs: null, round: null });
}
for (const boundary of ['62:00 InitGame:', '62:00 ExitLevel:', 'InitGame:']) {
expect(enrichGameChatTimeline([boundary, say('62:30')], { mtime: at(150), matches: [match(0, 300)],
reports: [report(130, 7)] }).at(-1)?.context)
.toEqual({ realTime: at(150), matchElapsedMs: null, round: null });
}
});
it('bounds active matches by recent evidence and interrupted matches by their last observation', () => {
for (const recorded of [match(0, 300, { status: 'active', endedAt: null, lastReceivedAt: at(29) }),
match(0, 300, { status: 'interrupted', endedAt: null, lastReceivedAt: at(140) })]) {
expect(enrichGameChatTimeline([say('62:30')], { mtime: at(150), matches: [recorded], reports: [report(29, 7)] })[0].context)
.toEqual({ realTime: at(150), matchElapsedMs: null, round: null });
}
});
it('keeps active context from fresh heartbeats even when leaderboard deduplication stopped its clock', () => {
expect(enrichGameChatTimeline([say('62:30')], { mtime: at(150),
matches: [match(0, 300, { status: 'active', endedAt: null, lastReceivedAt: at(10) })],
reports: [report(140, 7, { event: 'heartbeat' })] })[0].context)
.toEqual({ realTime: at(150), matchElapsedMs: 150000, round: 7 });
});
it('allows a start before the first observed event following an implicit clock reset', () => {
expect(enrichGameChatTimeline([say('80:00'), '0:05 J;abc;0;Player', say('0:20')], {
mtime: at(300), matches: [match(280, 400)], reports: [report(290, 1)]
}).at(-1)?.context).toEqual({ realTime: at(300), matchElapsedMs: 20000, round: 1 });
});
it('uses the same latest game_start as fleet when the leaderboard deduplicates start retries', () => {
const entries = enrichGameChatTimeline([say('62:00'), say('62:30')], { mtime: at(150),
matches: [match(0, 300)], reports: [report(0, 0, { event: 'game_start', round: null }),
report(130, 0, { event: 'game_start', round: null }), report(140, 1)] });
expect(entries[0].context.matchElapsedMs).toBe(120000);
expect(entries[1].context).toEqual({ realTime: at(150), matchElapsedMs: 20000, round: 1 });
expect(enrichGameChatTimeline(['62:00 InitGame:', say('62:30')], { mtime: at(150),
matches: [match(0, 300)], reports: [report(130, 0, { event: 'game_start', round: null }), report(140, 1)]
}).at(-1)?.context).toEqual({ realTime: at(150), matchElapsedMs: 20000, round: 1 });
});
it('leaves context unknown without a usable final write timestamp', () => {
for (const mtime of [null, 'bad date']) {
expect(enrichGameChatTimeline([say('62:30')], { mtime, matches: [match(0, 300)], reports: [report(140, 7)] })[0].context)
.toEqual(unavailable);
}
expect(enrichGameChatTimeline([say('62:30'), 'untimed write'], { mtime: at(150), matches: [], reports: [] })[0].context)
.toEqual(unavailable);
expect(enrichGameChatTimeline([], { mtime: at(150), matches: [], reports: [] })).toEqual([]);
});
});