A credibility pass over ee5690e..HEAD: traffic.py parses each request once and counts visits one way, the deploy notes and skills agree with the scripts, and a few edit leftovers in the hall are tidied

traffic.py gives identical counts before and after over 41 days of the
host's access logs.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01GwFKMuQnPAEHJ5yA1q4orh

src/lib/components/Announcement.svelte

@@ -16,6 +16,13 @@
 		until?: string;
 	}
 
+	/** An empty file, `{}`, is how the keeper takes an announcement down. */
+	function isAnnouncement(a: unknown): a is Announcement {
+		if (!a || typeof a !== 'object') return false;
+		const { id, text } = a as Partial<Announcement>;
+		return typeof id === 'string' && typeof text === 'string' && text !== '';
+	}
+
 	const SOURCE = '/hall/announcement.json';
 	const CHECK_MS = 5 * 60_000;
 	const DISMISSED = 'hall:dismissed';
@@ -28,7 +35,7 @@
 		try {
 			const res = await fetch(SOURCE, { cache: 'no-store' });
 			const a: unknown = res.ok ? await res.json() : null;
-			current = a && typeof a === 'object' && typeof (a as Announcement).text === 'string' && (a as Announcement).text && typeof (a as Announcement).id === 'string' ? (a as Announcement) : null;
+			current = isAnnouncement(a) ? a : null;
 		} catch {
 			// No announcement reachable: none shown.
 		}
@@ -68,7 +75,7 @@
 	});
 
 	function dismiss() {
-		// Taken first: once dismissed, nothing is shown.
+		// Read before dismissing: once dismissed, nothing is shown.
 		const id = shown?.id;
 		if (!id) return;
 		dismissed = id;

src/lib/components/Hall.svelte

@@ -2,6 +2,7 @@
 	// The hall: the landing page every game in the kit shares. Name, play the
 	// bot, open a table, join by code, the ledger of your tables, and the
 	// about panel with the rules, the guide and a way to reach the keeper.
+	import { onMount } from 'svelte';
 	import { goto } from '$app/navigation';
 	import { loadFamily, type FamilyGame } from '$lib/family';
 	import About from './About.svelte';
@@ -29,7 +30,7 @@
 	let seats = $state(allSeats());
 	let games = $state<Record<string, RoomView<State> | null>>({});
 	let aboutOpen = $state(false);
-	$effect(() => {
+	onMount(() => {
 		if (location.hash === '#about') aboutOpen = true;
 	});
 	/** The ledgers' tally, fetched when the about panel opens. */
@@ -43,21 +44,20 @@
 	const told = $derived.by(() => {
 		const t = tally;
 		if (!t) return null;
-		
 		const headline = [
 			{ n: t.gamesFinished, label: t.gamesFinished === 1 ? 'game played to a finish' : 'games played to a finish' },
 			{ n: t.byGame["won by the king's escape"] ?? 0, label: "won by the king's escape" },
 			{ n: t.byGame['won by taking the king'] ?? 0, label: 'won by taking the king' },
 			{ n: hours(t.minutesAtTable), label: 'at the table' }
 		];
-		const told = new Set<string>(["won by the king's escape", 'won by taking the king']);
+		const onCards = new Set<string>(["won by the king's escape", 'won by taking the king']);
 		const details = [
 			{ n: t.gamesBegun, label: `games begun, at ${t.tablesOpened} ${t.tablesOpened === 1 ? 'table' : 'tables'}` },
 			{ n: t.namesSeated, label: t.namesSeated === 1 ? 'name has taken a seat' : 'names have taken a seat' },
 			{ n: t.turnsPlayed, label: `turns recorded; ${t.longestGameTurns} in the longest game` },
-			{ n: t.gamesWithBot, label: `games with a housecarl seated` },
+			{ n: t.gamesWithBot, label: t.gamesWithBot === 1 ? 'game with a housecarl seated' : 'games with a housecarl seated' },
 			...(t.talkLines ? [{ n: t.talkLines, label: t.talkLines === 1 ? 'line of table talk' : 'lines of table talk' }] : []),
-			...Object.entries(t.byGame).filter(([label]) => !told.has(label)).map(([label, n]) => ({ n, label }))
+			...Object.entries(t.byGame).filter(([label]) => !onCards.has(label)).map(([label, n]) => ({ n, label }))
 		];
 		const first = t.firstGameAt ? `The first game began ${new Date(t.firstGameAt).toLocaleDateString(undefined, { year: 'numeric', month: 'long', day: 'numeric' })}. ` : '';
 		return { headline, details, note: `${first}Names are counted, not people: one player under two names is two here. Table time counts only the minutes between moves, so a game left open overnight adds nothing for the night.` };
@@ -627,5 +627,4 @@
 		margin: 0 auto;
 		border-radius: 4px;
 	}
-
 </style>

src/lib/components/Tally.svelte

@@ -10,7 +10,7 @@
 	// What the ledgers add up to: a few counts that are the game's own story,
 	// large, on cards; then the rest in a column of figures; then the fine
 	// print. Each game chooses its counts and words.
-	let { headline, details, note, title = 'How much love the table is getting' }: { headline: TallyLine[]; details: TallyLine[]; note?: string; title?: string } =
+	let { headline, details, note, title }: { headline: TallyLine[]; details: TallyLine[]; note?: string; title: string } =
 		$props();
 
 	const shown = (n: number | string) => (typeof n === 'number' ? n.toLocaleString() : n);

src/lib/family.ts

@@ -1,7 +1,7 @@
 // The other games of Kestrel's Hall, from the family list the kit keeps
-// (family.json, one copy shipped with every game), so a player who liked one
-// table can find the next, and the hall's front door. This game is left out
-// of its own list.
+// (family.json, one copy shipped with every game): the hall's front door, and
+// the next table for a player who liked this one. This game is left out of its
+// own list.
 
 export interface FamilyGame {
 	slug: string;
@@ -18,13 +18,15 @@ export interface Family {
 	games: FamilyGame[];
 }
 
+const NONE: Family = { hall: '', games: [] };
+
 export async function loadFamily(self: string): Promise<Family> {
 	try {
 		const res = await fetch('/family.json', { cache: 'no-cache' });
-		if (!res.ok) return { hall: '', games: [] };
+		if (!res.ok) return NONE;
 		const data = (await res.json()) as { hall?: string; games?: FamilyGame[] };
 		return { hall: data.hall ?? '', games: (data.games ?? []).filter((g) => g.slug !== self) };
 	} catch {
-		return { hall: '', games: [] };
+		return NONE;
 	}
 }