claudial 0.6.4 → 0.7.1

package/dist/index.js

@@ -2,7 +2,9 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { render } from 'ink';
 import { App } from './ui/App.js';
-import { resolveSeasonId } from './api/espn.js';
+import { readFileSync } from 'node:fs';
+import { FOLLOW_COMMANDS, USAGE } from './cli/follow.js';
+import { resolveSeasonId } from './api/backend.js';
 // exit quietly when the consumer of a pipe closes early (e.g. `claudial | head`)
 process.stdout.on('error', (err) => {
     if (err.code === 'EPIPE')
@@ -22,8 +24,31 @@ function readStdin() {
         process.stdin.on('error', () => resolve(data));
     });
 }
+const HELP = `claudial: live football in your terminal and Claude Code's status bar
+
+  claudial                             the live dashboard (keys: f follow · r refresh · q quit)
+  claudial --ticker                    a 4-line strip for slim split panes
+  claudial | cat                       plain snapshot for pipes and scripts
+  claudial setup                       install the Claude Code status line and pick your teams
+  claudial setup --statusline --yes    install the status line only, no prompts
+${USAGE.replace(/^usage:\n/, '')}
+
+  CLAUDIAL_API_URL=<url>               use another claudial server`;
 async function main() {
     const args = process.argv.slice(2);
+    if (args.includes('--help') || args.includes('-h') || args[0] === 'help') {
+        console.log(HELP);
+        process.exit(0);
+    }
+    if (args.includes('--version') || args.includes('-v')) {
+        const pkg = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8'));
+        console.log(pkg.version);
+        process.exit(0);
+    }
+    if (args[0] && FOLLOW_COMMANDS.includes(args[0])) {
+        const { runFollow } = await import('./cli/follow.js');
+        process.exit(await runFollow(args));
+    }
     if (args[0] === 'setup') {
         const { runSetup } = await import('./setup/index.js');
         await runSetup(args.slice(1));
@@ -54,7 +79,7 @@ async function main() {
     }
     if (args.includes('--mock-redcard')) {
         const { makeCache } = await import('./statusline/cache.js');
-        makeCache().armRedCard({ player: 'Otamendi', homeCode: 'ARG', awayCode: 'ENG' });
+        makeCache().armRedCard({ player: 'Otamendi', homeCode: 'ARG', awayCode: 'ENG', homeName: 'Argentina', awayName: 'England' });
         process.stdout.write('🟥 RED armed — the Claude Code status bar flashes a red card (ARG—ENG) for 15s.\n');
         process.exit(0);
     }
@@ -82,7 +107,7 @@ async function main() {
         seasonId = await resolveSeasonId();
     }
     catch {
-        console.error('claudial: could not reach ESPN. Check your connection and try again.');
+        console.error('claudial: could not reach the claudial server. Check your connection and try again.');
         process.exit(1);
     }
     if (!process.stdout.isTTY) {
@@ -94,6 +119,6 @@ async function main() {
     render(_jsx(App, { seasonId: seasonId, mode: mode }));
 }
 main().catch(() => {
-    console.error('claudial: could not reach ESPN. Check your connection and try again.');
+    console.error('claudial: could not reach the claudial server. Check your connection and try again.');
     process.exit(1);
 });

package/dist/predictions/client.js

@@ -2,17 +2,16 @@ import { mkdirSync, readFileSync, writeFileSync, renameSync, statSync, existsSyn
 import { tmpdir } from 'node:os';
 import { join } from 'node:path';
 const ENV = 'CLAUDIAL_PREDICTIONS_URL';
-// Shipped default so predictions work out of the box from the published package.
-// Override with CLAUDIAL_PREDICTIONS_URL (e.g. your own backend, or to disable
-// by pointing it elsewhere).
-const DEFAULT_PREDICTIONS_URL = 'http://161.97.67.12:8000/api/predictions/';
+// Betting predictions are OFF unless the user opts in by setting
+// CLAUDIAL_PREDICTIONS_URL. They show stakes and bookmaker odds, which is
+// gambling content: never on by default, and only for adults (README).
 // Predictions only change every few hours server-side, so poll gently.
 const CACHE_TTL_MS = 30 * 60 * 1000;
-/** Resolve the API URL: explicit env var wins, else the shipped default. */
+/** The predictions API URL, or '' when the user has not opted in. */
 export function predictionsUrl(env = process.env) {
-    return env[ENV] || DEFAULT_PREDICTIONS_URL;
+    return env[ENV] || '';
 }
-/** A URL is always resolvable now (shipped default), so predictions are on. */
+/** Predictions are opt-in: on only when CLAUDIAL_PREDICTIONS_URL is set. */
 export function predictionsEnabled(env = process.env) {
     return !!predictionsUrl(env);
 }

package/dist/setup/index.js

@@ -60,4 +60,15 @@ export async function runSetup(args) {
         }));
         waitUntilExit().then(() => resolve());
     });
+    // Second step: what to follow. Skippable with esc; `claudial follow` reopens it.
+    if (process.stdin.isTTY) {
+        const { runPicker } = await import('../ui/picker/run.js');
+        const r = await runPicker('Last step: pick your leagues and teams. Type a team name to find it.');
+        if (!r?.saved) {
+            const following = r && r.settings.leagues.length + r.settings.teams.length > 0;
+            console.log(following
+                ? 'Keeping what you follow. Change it any time: claudial follow'
+                : 'You can pick your teams any time: claudial follow');
+        }
+    }
 }

package/dist/snapshot.js

@@ -1,17 +1,21 @@
-import { fetchLive, fetchRecent, fetchUpcoming } from './api/espn.js';
-import { formatKickoff } from './ui/UpcomingSection.js';
-import { homeTag, awayTag } from './ui/flags.js';
+import { fetchLive, fetchRecent, fetchUpcoming, followsNothing } from './api/backend.js';
+import { kickoffColumn } from './ui/UpcomingSection.js';
+import { homeName, awayName } from './ui/flags.js';
 function line(m) {
     if (m.status === 'upcoming')
-        return `o ${formatKickoff(m.startTimestamp).padEnd(13)} ${homeTag(m.home.code)} - ${awayTag(m.away.code)}`;
+        return `o ${kickoffColumn(m.startTimestamp)}${homeName(m.home)} - ${awayName(m.away)}`;
     const label = m.status === 'finished' ? 'FT' : m.status === 'halftime' ? 'HT' : `${m.minute ?? '?'}'`;
-    return `* ${label.padEnd(4)} ${homeTag(m.home.code)} ${m.homeScore ?? '-'} - ${m.awayScore ?? '-'} ${awayTag(m.away.code)}`;
+    return `* ${label.padEnd(4)} ${homeName(m.home)} ${m.homeScore ?? '-'} - ${m.awayScore ?? '-'} ${awayName(m.away)}`;
 }
 export async function printSnapshot(seasonId) {
     const [live, upcoming, recent] = await Promise.all([
         fetchLive(), fetchUpcoming(seasonId), fetchRecent(seasonId),
     ]);
-    console.log('claudial - WORLD CUP 2026');
+    console.log('claudial - LIVE FOOTBALL');
+    if (await followsNothing().catch(() => false))
+        console.log('You follow nothing yet. Run: claudial follow');
+    else if (live.length + upcoming.length + recent.length === 0)
+        console.log('No upcoming matches for what you follow yet.');
     const liveIds = new Set(live.map((m) => m.id));
     for (const m of [...live, ...recent.filter((r) => !liveIds.has(r.id))])
         console.log(line(m));

package/dist/statusline/cache.js

@@ -1,7 +1,7 @@
 import { mkdirSync, openSync, closeSync, writeFileSync, readFileSync, renameSync, statSync, existsSync, unlinkSync, utimesSync, futimesSync, } from 'node:fs';
 import { tmpdir } from 'node:os';
 import { join } from 'node:path';
-import { homeTag, awayTag } from '../ui/flags.js';
+import { homeName, awayName } from '../ui/flags.js';
 export const TTL_MS = 10_000;
 export const GOAL_WINDOW_MS = 15_000;
 const LOCK_STALE_MS = 30_000;
@@ -11,10 +11,12 @@ const GOAL_CLOSE = '\x1b[0m';
 // RED #E5484D — the red-card flash.
 const RED_OPEN = '\x1b[1;38;2;229;72;77m';
 function goalText(m) {
-    return `${GOAL_OPEN}⚽ G O O O L  ·  ${homeTag(m.home.code)} ${m.homeScore ?? 0}—${m.awayScore ?? 0} ${awayTag(m.away.code)}${GOAL_CLOSE}`;
+    return `${GOAL_OPEN}⚽ G O O O L  ·  ${homeName(m.home)} ${m.homeScore ?? 0}—${m.awayScore ?? 0} ${awayName(m.away)}${GOAL_CLOSE}`;
 }
 function redCardText(rc) {
-    return `${RED_OPEN}🟥 R E D  ·  ${rc.player.toUpperCase()}  ·  ${homeTag(rc.homeCode)} — ${awayTag(rc.awayCode)}${GOAL_CLOSE}`;
+    const home = homeName({ name: rc.homeName ?? rc.homeCode, code: rc.homeCode, national: rc.national });
+    const away = awayName({ name: rc.awayName ?? rc.awayCode, code: rc.awayCode, national: rc.national });
+    return `${RED_OPEN}🟥 R E D  ·  ${rc.player.toUpperCase()}  ·  ${home} — ${away}${GOAL_CLOSE}`;
 }
 export function makeCache(dir = join(tmpdir(), 'claudial-statusline')) {
     mkdirSync(dir, { recursive: true });

package/dist/statusline/line.js

@@ -1,5 +1,5 @@
 import { formatKickoff } from '../ui/UpcomingSection.js';
-import { homeTag, awayTag } from '../ui/flags.js';
+import { homeName, awayName } from '../ui/flags.js';
 import { matchPrediction } from '../predictions/match.js';
 import { headline } from '../predictions/format.js';
 // Assumed wall-clock length of a match (kickoff → ~full time). ESPN exposes no
@@ -10,18 +10,18 @@ export function liveLine(match) {
     const clock = match.status === 'halftime' ? ' HT'
         : match.minute != null ? ` ${match.minute}'`
             : '';
-    return `⚽ ${homeTag(match.home.code)} ${match.homeScore ?? 0}—${match.awayScore ?? 0} ${awayTag(match.away.code)}${clock}`;
+    return `⚽ ${homeName(match.home)} ${match.homeScore ?? 0}—${match.awayScore ?? 0} ${awayName(match.away)}${clock}`;
 }
 /** A finished match with its result: "⚽ QAT 🇶🇦 2—1 🇨🇭 SUI FT". */
 export function finishedLine(match) {
-    return `⚽ ${homeTag(match.home.code)} ${match.homeScore ?? 0}—${match.awayScore ?? 0} ${awayTag(match.away.code)} FT`;
+    return `⚽ ${homeName(match.home)} ${match.homeScore ?? 0}—${match.awayScore ?? 0} ${awayName(match.away)} FT`;
 }
 /**
  * The next kickoff: "○ BRA 🇧🇷 — 🇲🇦 MAR Sun 01:00", with a prediction headline
  * appended when one is available: "… · 🔮 BRA win 64% · 2-1".
  */
 function upcomingLine(match, now, preds) {
-    const base = `○ ${homeTag(match.home.code)} — ${awayTag(match.away.code)} ${formatKickoff(match.startTimestamp, now)}`;
+    const base = `○ ${homeName(match.home)} — ${awayName(match.away)} ${formatKickoff(match.startTimestamp, now)}`;
     const pred = matchPrediction(match, preds);
     return pred ? `${base} · ${headline(pred)}` : base;
 }

package/dist/statusline/run.js

@@ -1,10 +1,19 @@
 import { execFileSync } from 'node:child_process';
-import { fetchLive as realFetchLive, fetchRecent as realFetchRecent, fetchUpcoming as realFetchUpcoming, fetchLiveRedCards as realFetchLiveRedCards } from '../api/espn.js';
+import { fetchLive as realFetchLive, fetchRecent as realFetchRecent, fetchUpcoming as realFetchUpcoming, fetchLiveRedCards as realFetchLiveRedCards } from '../api/backend.js';
 import { scoreLine } from './line.js';
+import { followsNothing } from '../api/backend.js';
 import { makeCache, TTL_MS } from './cache.js';
 import { goalKickFrame } from './anim.js';
 import { fetchPredictions as realFetchPredictions } from '../predictions/client.js';
 const PLACEHOLDER = '⚽ claudial · warming up';
+/** Shown until the user follows something: a new device starts with nothing. */
+export const FOLLOW_HINT = '⚽ claudial · run `claudial follow` to pick your teams';
+/** Following something, but nothing is scheduled for it yet (e.g. an international break). */
+export const NO_MATCHES = '⚽ claudial · no upcoming matches for your teams yet';
+/** The server has not answered for a while (or ever, on this machine). */
+export const OFFLINE = "⚽ claudial · can't reach the server, retrying";
+/** How long a failing server may keep showing the last good line before OFFLINE replaces it. */
+export const OFFLINE_AFTER_MS = 120_000;
 function withTimeout(p, ms) {
     let id;
     const timer = new Promise((_, reject) => {
@@ -20,16 +29,21 @@ export async function runStatusline(input, deps, now = Date.now()) {
     if (!fresh && cache.tryLock(now)) {
         try {
             const [liveM, recentM, upcomingM, redsM, predsM] = await withTimeout(Promise.all([deps.fetchLive(), deps.fetchRecent(), deps.fetchUpcoming(2026), deps.fetchRedCards(), deps.fetchPredictions()]), deps.timeoutMs);
-            const next = scoreLine(liveM, recentM, upcomingM, now, predsM);
+            let next = scoreLine(liveM, recentM, upcomingM, now, predsM);
+            // Nothing to show: say why, so the bar never looks stuck.
+            if (!next)
+                next = (await withTimeout(deps.followsNothing(), deps.timeoutMs)) ? FOLLOW_HINT : NO_MATCHES;
             cache.updateGoalState(liveM, now);
             cache.updateRedCards(redsM, now);
-            if (next) {
-                cache.write(next, now);
-                line = next;
-            }
+            cache.write(next, now);
+            line = next;
         }
         catch {
-            // keep last good cache (line already set)
+            // Keep the last good line through a short outage; after that, say so.
+            if (!line || (cached && cached.ageMs > OFFLINE_AFTER_MS)) {
+                line = OFFLINE;
+                cache.write(OFFLINE, now);
+            }
         }
         finally {
             cache.unlock();
@@ -71,6 +85,7 @@ export function defaultDeps() {
         fetchPredictions: () => realFetchPredictions(),
         cache: makeCache(),
         branchOf: defaultBranchOf,
+        followsNothing,
         timeoutMs: 3000,
     };
 }

package/dist/ui/App.js

@@ -1,17 +1,19 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { useEffect, useReducer, useRef } from 'react';
-import { Box, useApp, useInput } from 'ink';
+import { useEffect, useReducer, useRef, useState } from 'react';
+import { Box, Text, useApp, useInput } from 'ink';
 import { initialState, reducer } from '../state.js';
 import { startPoller } from '../engine/poller.js';
-import { fetchIncidents, fetchLive, fetchRecent, fetchUpcoming } from '../api/espn.js';
+import { fetchIncidents, fetchLive, fetchRecent, fetchUpcoming, followsNothing, invalidateState, subscribeEvents } from '../api/backend.js';
 import { fetchPredictions } from '../predictions/client.js';
-import { Header } from './Header.js';
+import { ACCENT, Header } from './Header.js';
 import { DaySection } from './DaySection.js';
 import { partitionByDay } from './fixtures.js';
 import { UpcomingSection } from './UpcomingSection.js';
 import { Footer } from './Footer.js';
 import { TakeoverView } from './TakeoverView.js';
 import { Ticker } from './Ticker.js';
+import { Picker } from './picker/Picker.js';
+import { boardNotice } from './notice.js';
 function dedupeById(matches) {
     const seen = new Set();
     const out = [];
@@ -26,6 +28,15 @@ export function App({ seasonId, mode = 'board' }) {
     const [state, dispatch] = useReducer(reducer, initialState);
     const { exit } = useApp();
     const pollerRef = useRef(null);
+    const [picking, setPicking] = useState(false);
+    // Bumped after the picker saves: the event stream reads settings at connect
+    // time, so it has to reconnect to see the new subscriptions.
+    const [streamGen, setStreamGen] = useState(0);
+    // A new device follows nothing: the board says how to start instead of staying blank.
+    const [followsNone, setFollowsNone] = useState(false);
+    useEffect(() => {
+        followsNothing().then(setFollowsNone, () => { });
+    }, [streamGen]);
     useEffect(() => {
         const deps = {
             fetchLive,
@@ -40,12 +51,23 @@ export function App({ seasonId, mode = 'board' }) {
         pollerRef.current = startPoller(deps);
         return () => pollerRef.current?.stop();
     }, [seasonId]);
+    // Push: any server event (goal, card, kickoff...) triggers an immediate refresh,
+    // so takeovers fire within a second instead of on the next 15 s poll.
+    useEffect(() => {
+        const unsubscribe = subscribeEvents(() => {
+            invalidateState();
+            pollerRef.current?.refreshNow();
+        });
+        return unsubscribe;
+    }, [streamGen]);
     useInput((input) => {
         if (input === 'q')
             exit();
         if (input === 'r')
             pollerRef.current?.refreshNow();
-    });
+        if (input === 'f' && mode === 'board')
+            setPicking(true);
+    }, { isActive: !picking });
     const compact = mode === 'board' && (process.stdout.columns ?? 80) < 70;
     const playing = state.takeovers[0] ?? null;
     useEffect(() => {
@@ -54,6 +76,16 @@ export function App({ seasonId, mode = 'board' }) {
         const t = setTimeout(() => dispatch({ type: 'takeoverDone' }), 4_000);
         return () => clearTimeout(t);
     }, [playing]);
+    if (picking) {
+        return (_jsx(Picker, { onDone: (r) => {
+                setPicking(false);
+                if (r.saved) {
+                    invalidateState();
+                    pollerRef.current?.refreshNow();
+                    setStreamGen((g) => g + 1);
+                }
+            } }));
+    }
     if (playing && mode === 'board')
         return _jsx(TakeoverView, { takeover: playing });
     if (mode === 'ticker') {
@@ -61,5 +93,6 @@ export function App({ seasonId, mode = 'board' }) {
     }
     const all = dedupeById([...state.live, ...state.recent, ...state.upcoming]);
     const { yesterday, today, future } = partitionByDay(all, Date.now());
-    return (_jsxs(Box, { flexDirection: "column", paddingX: 1, paddingY: 1, children: [_jsx(Header, { stale: state.stale, lastUpdated: state.lastUpdated }), _jsx(DaySection, { label: "TODAY", matches: today, incidents: state.incidents, compact: compact }), _jsx(DaySection, { label: "YESTERDAY", matches: yesterday, incidents: state.incidents, compact: compact }), _jsx(UpcomingSection, { matches: future, compact: compact, predictions: state.predictions }), _jsx(Footer, {})] }));
+    const notice = boardNotice({ followsNone, stale: state.stale, lastUpdated: state.lastUpdated, matchCount: all.length });
+    return (_jsxs(Box, { flexDirection: "column", paddingX: 1, paddingY: 1, children: [_jsx(Header, { stale: state.stale, lastUpdated: state.lastUpdated }), notice ? (_jsxs(Box, { marginBottom: 1, children: [notice === 'offline' ? _jsx(Text, { children: "Can't reach the claudial server. Retrying\u2026" }) : null, notice === 'follow-nothing' ? (_jsxs(Text, { children: ["You don't follow anything yet. Press ", _jsx(Text, { bold: true, color: ACCENT, children: "f" }), " to pick your leagues and teams."] })) : null, notice === 'no-matches' ? (_jsxs(Text, { children: ["No upcoming matches for what you follow yet. They show up here as soon as they're scheduled. ", _jsxs(Text, { dimColor: true, children: ["(", _jsx(Text, { bold: true, color: ACCENT, children: "f" }), " to follow more)"] })] })) : null] })) : null, _jsx(DaySection, { label: "TODAY", matches: today, incidents: state.incidents, compact: compact }), _jsx(DaySection, { label: "YESTERDAY", matches: yesterday, incidents: state.incidents, compact: compact }), _jsx(UpcomingSection, { matches: future, compact: compact, predictions: state.predictions }), _jsx(Footer, {})] }));
 }

package/dist/ui/Footer.js

@@ -1,5 +1,5 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { Text } from 'ink';
 export function Footer() {
-    return _jsx(Text, { dimColor: true, children: "r refresh \u00B7 q quit" });
+    return _jsx(Text, { dimColor: true, children: "r refresh \u00B7 f follow teams \u00B7 q quit" });
 }

package/dist/ui/Header.js

@@ -6,5 +6,5 @@ export function Header({ stale, lastUpdated }) {
     const updated = lastUpdated
         ? new Date(lastUpdated).toLocaleTimeString(undefined, { hour: '2-digit', minute: '2-digit', second: '2-digit' })
         : '—';
-    return (_jsxs(Box, { marginBottom: 1, children: [_jsx(Text, { bold: true, color: ACCENT, children: "claudial" }), _jsx(Text, { dimColor: true, children: " \u00B7 WORLD CUP 2026" }), _jsxs(Text, { dimColor: true, children: ['  ', "\u273B ", stale ? 'stale · retrying' : `updated ${updated}`] })] }));
+    return (_jsxs(Box, { marginBottom: 1, children: [_jsx(Text, { bold: true, color: ACCENT, children: "claudial" }), _jsx(Text, { dimColor: true, children: " \u00B7 LIVE FOOTBALL" }), _jsxs(Text, { dimColor: true, children: ['  ', "\u273B ", stale ? 'stale · retrying' : `updated ${updated}`] })] }));
 }

package/dist/ui/MatchRow.js

@@ -1,24 +1,31 @@
 import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
 import { Box, Text } from 'ink';
 import { ACCENT } from './Header.js';
-import { formatKickoff } from './UpcomingSection.js';
-import { homeTag, awayTag } from './flags.js';
+import { formatKickoff, kickoffColumn } from './UpcomingSection.js';
+import { homeName, awayName } from './flags.js';
+/** One side's goals grouped by scorer, in order of their first goal: "43' 50' C. Gakpo · 47' D. Núñez". */
+export function scorers(goals) {
+    const byPlayer = new Map();
+    for (const g of goals) {
+        const who = g.playerShort ?? '?';
+        byPlayer.set(who, [...(byPlayer.get(who) ?? []), `${g.minute ?? '?'}'`]);
+    }
+    return [...byPlayer].map(([who, mins]) => `${mins.join(' ')} ${who}`).join(' · ');
+}
 export function ScorerLine({ incidents }) {
     const goals = incidents.filter((i) => i.kind === 'goal');
     if (goals.length === 0)
         return null;
-    const fmt = (g) => `${g.minute ?? '?'}' ${g.playerShort ?? '?'}`;
-    const home = goals.filter((g) => g.isHome).map(fmt).join(' · ');
-    const away = goals.filter((g) => !g.isHome).map(fmt).join(' · ');
+    const home = scorers(goals.filter((g) => g.isHome));
+    const away = scorers(goals.filter((g) => !g.isHome));
     return _jsxs(Text, { dimColor: true, children: ['   ', "\u26BD ", [home, away].filter(Boolean).join(' | ')] });
 }
 export function FeedLine({ incidents }) {
-    const feed = incidents.filter((i) => i.kind === 'yellowCard' || i.kind === 'substitution');
+    const feed = incidents.filter((i) => i.kind === 'yellowCard' || i.kind === 'redCard' || i.kind === 'substitution');
     if (feed.length === 0)
         return null;
-    const fmt = (i) => i.kind === 'yellowCard'
-        ? `${i.minute ?? '?'}' 🟨 ${i.playerShort ?? '?'}`
-        : `${i.minute ?? '?'}' ⇄ ${i.playerShort ?? '?'}`;
+    const mark = { yellowCard: '🟨', redCard: '🟥' };
+    const fmt = (i) => `${i.minute ?? '?'}' ${mark[i.kind] ?? '⇄'} ${i.playerShort ?? '?'}`;
     // last 4 only — the feed is a pulse, not a log
     return _jsxs(Text, { dimColor: true, children: ['   ', "\u25AA ", feed.slice(-4).map(fmt).join(' · ')] });
 }
@@ -33,12 +40,12 @@ function statusLabel(m) {
 export function MatchRow({ m, incidents, compact }) {
     if (m.status === 'upcoming') {
         if (compact) {
-            return _jsxs(Text, { dimColor: true, children: ["\u25CB ", homeTag(m.home.code), " \u2014 ", awayTag(m.away.code), " ", formatKickoff(m.startTimestamp)] });
+            return _jsxs(Text, { dimColor: true, children: ["\u25CB ", homeName(m.home), " \u2014 ", awayName(m.away), " ", formatKickoff(m.startTimestamp)] });
         }
-        return (_jsxs(Text, { children: [_jsxs(Text, { dimColor: true, children: ["\u25CB ", formatKickoff(m.startTimestamp).padEnd(13)] }), homeTag(m.home.code), " \u2014 ", awayTag(m.away.code), m.group ? _jsxs(Text, { dimColor: true, children: ["  \u00B7  ", m.group] }) : null] }));
+        return (_jsxs(Text, { children: [_jsxs(Text, { dimColor: true, children: ["\u25CB ", kickoffColumn(m.startTimestamp)] }), homeName(m.home), " \u2014 ", awayName(m.away), m.group ? _jsxs(Text, { dimColor: true, children: ["  \u00B7  ", m.group] }) : null] }));
     }
     if (compact) {
-        return (_jsxs(Text, { children: [_jsx(Text, { color: m.status === 'finished' ? undefined : ACCENT, children: "\u23FA" }), _jsxs(Text, { dimColor: true, children: [" ", statusLabel(m), " "] }), homeTag(m.home.code), " ", _jsxs(Text, { bold: true, color: ACCENT, children: [m.homeScore ?? '–', "\u2014", m.awayScore ?? '–'] }), " ", awayTag(m.away.code), m.varInProgress ? _jsx(Text, { dimColor: true, children: " \u2696" }) : null] }));
+        return (_jsxs(Text, { children: [_jsx(Text, { color: m.status === 'finished' ? undefined : ACCENT, children: "\u23FA" }), _jsxs(Text, { dimColor: true, children: [" ", statusLabel(m), " "] }), homeName(m.home), " ", _jsxs(Text, { bold: true, color: ACCENT, children: [m.homeScore ?? '–', "\u2014", m.awayScore ?? '–'] }), " ", awayName(m.away), m.varInProgress ? _jsx(Text, { dimColor: true, children: " \u2696" }) : null] }));
     }
-    return (_jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [_jsxs(Text, { children: [_jsx(Text, { color: m.status === 'finished' ? undefined : ACCENT, children: "\u23FA" }), _jsxs(Text, { bold: m.status !== 'finished', dimColor: m.status === 'finished', children: [" ", statusLabel(m)] }), m.group ? _jsxs(Text, { dimColor: true, children: ["  \u00B7  ", m.group] }) : null, m.varInProgress ? _jsx(Text, { dimColor: true, children: "  \u00B7  \u2696 VAR" }) : null] }), _jsxs(Text, { children: ['   ', homeTag(m.home.code), "  ", _jsxs(Text, { bold: true, color: ACCENT, children: [m.homeScore ?? '–', " \u2014 ", m.awayScore ?? '–'] }), "  ", awayTag(m.away.code)] }), _jsx(ScorerLine, { incidents: incidents }), _jsx(FeedLine, { incidents: incidents })] }));
+    return (_jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [_jsxs(Text, { children: [_jsx(Text, { color: m.status === 'finished' ? undefined : ACCENT, children: "\u23FA" }), _jsxs(Text, { bold: m.status !== 'finished', dimColor: m.status === 'finished', children: [" ", statusLabel(m)] }), m.group ? _jsxs(Text, { dimColor: true, children: ["  \u00B7  ", m.group] }) : null, m.varInProgress ? _jsx(Text, { dimColor: true, children: "  \u00B7  \u2696 VAR" }) : null] }), _jsxs(Text, { children: ['   ', homeName(m.home), "  ", _jsxs(Text, { bold: true, color: ACCENT, children: [m.homeScore ?? '–', " \u2014 ", m.awayScore ?? '–'] }), "  ", awayName(m.away)] }), _jsx(ScorerLine, { incidents: incidents }), _jsx(FeedLine, { incidents: incidents })] }));
 }

package/dist/ui/TakeoverView.js

@@ -2,7 +2,7 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Box, Text } from 'ink';
 import { GOAL_ART, VAR_ART, RED_CARD_ART, spacedCaps } from '../banner.js';
 import { ACCENT, RED } from './Header.js';
-import { homeTag, awayTag } from './flags.js';
+import { homeName, awayName } from './flags.js';
 const ART = {
     goal: { art: GOAL_ART, color: ACCENT, caption: null },
     redcard: { art: RED_CARD_ART, color: RED, caption: 'R E D   C A R D' },
@@ -17,7 +17,7 @@ export function TakeoverView({ takeover }) {
     const rows = process.stdout.rows ?? 24;
     if (rows < 14) {
         const label = kind === 'goal' ? 'G O A L' : kind === 'redcard' ? 'R E D   C A R D' : 'V A R';
-        return (_jsxs(Box, { flexDirection: "column", alignItems: "center", justifyContent: "center", height: rows - 1, children: [_jsx(Text, { bold: true, color: color, wrap: "truncate", children: label }), _jsxs(Text, { bold: true, wrap: "truncate", children: [spacedCaps(fallback), takeover.minute != null ? _jsxs(Text, { dimColor: true, children: ["  \u00B7  ", takeover.minute, "'"] }) : null] }), takeover.detail ? _jsx(Text, { dimColor: true, wrap: "truncate", children: takeover.detail }) : null, _jsxs(Text, { wrap: "truncate", children: [_jsxs(Text, { dimColor: true, children: [homeTag(match.home.code), "  "] }), _jsxs(Text, { bold: true, color: ACCENT, children: [takeover.homeScore, " \u2014 ", takeover.awayScore] }), _jsxs(Text, { dimColor: true, children: ["  ", awayTag(match.away.code)] })] })] }));
+        return (_jsxs(Box, { flexDirection: "column", alignItems: "center", justifyContent: "center", height: rows - 1, children: [_jsx(Text, { bold: true, color: color, wrap: "truncate", children: label }), _jsxs(Text, { bold: true, wrap: "truncate", children: [spacedCaps(fallback), takeover.minute != null ? _jsxs(Text, { dimColor: true, children: ["  \u00B7  ", takeover.minute, "'"] }) : null] }), takeover.detail ? _jsx(Text, { dimColor: true, wrap: "truncate", children: takeover.detail }) : null, _jsxs(Text, { wrap: "truncate", children: [_jsxs(Text, { color: "gray", children: [homeName(match.home), "  "] }), _jsxs(Text, { bold: true, color: ACCENT, children: [takeover.homeScore, " \u2014 ", takeover.awayScore] }), _jsxs(Text, { color: "gray", children: ["  ", awayName(match.away)] })] })] }));
     }
-    return (_jsxs(Box, { flexDirection: "column", alignItems: "center", justifyContent: "center", height: rows - 1, children: [art.map((line, i) => (_jsx(Text, { bold: true, color: color, wrap: "truncate", children: line }, i))), caption ? (_jsx(Box, { marginTop: 1, children: _jsx(Text, { bold: true, color: color, wrap: "truncate", children: caption }) })) : null, _jsx(Box, { marginTop: 1, children: _jsxs(Text, { bold: true, children: [spacedCaps(fallback), takeover.minute != null ? _jsxs(Text, { dimColor: true, children: ["  \u00B7  ", takeover.minute, "'"] }) : null] }) }), takeover.detail ? (_jsx(Box, { marginTop: 1, children: _jsx(Text, { dimColor: true, children: takeover.detail }) })) : null, _jsxs(Box, { marginTop: 1, children: [_jsxs(Text, { dimColor: true, children: [homeTag(match.home.code), "  "] }), _jsxs(Text, { bold: true, color: ACCENT, children: [takeover.homeScore, " \u2014 ", takeover.awayScore] }), _jsxs(Text, { dimColor: true, children: ["  ", awayTag(match.away.code)] })] })] }));
+    return (_jsxs(Box, { flexDirection: "column", alignItems: "center", justifyContent: "center", height: rows - 1, children: [art.map((line, i) => (_jsx(Text, { bold: true, color: color, wrap: "truncate", children: line }, i))), caption ? (_jsx(Box, { marginTop: 1, children: _jsx(Text, { bold: true, color: color, wrap: "truncate", children: caption }) })) : null, _jsx(Box, { marginTop: 1, children: _jsxs(Text, { bold: true, children: [spacedCaps(fallback), takeover.minute != null ? _jsxs(Text, { dimColor: true, children: ["  \u00B7  ", takeover.minute, "'"] }) : null] }) }), takeover.detail ? (_jsx(Box, { marginTop: 1, children: _jsx(Text, { dimColor: true, children: takeover.detail }) })) : null, _jsxs(Box, { marginTop: 1, children: [_jsxs(Text, { color: "gray", children: [homeName(match.home), "  "] }), _jsxs(Text, { bold: true, color: ACCENT, children: [takeover.homeScore, " \u2014 ", takeover.awayScore] }), _jsxs(Text, { color: "gray", children: ["  ", awayName(match.away)] })] })] }));
 }

package/dist/ui/Ticker.js

@@ -3,14 +3,14 @@ import { Box, Text } from 'ink';
 import { formatKickoff } from './UpcomingSection.js';
 import { ACCENT, RED } from './Header.js';
 import { spacedCaps } from '../banner.js';
-import { homeTag, awayTag } from './flags.js';
+import { homeName, awayName } from './flags.js';
 function TickerTakeover({ t }) {
     const color = t.kind === 'redcard' ? RED : ACCENT;
     const label = t.kind === 'goal' ? 'G O A L' : t.kind === 'redcard' ? 'R E D' : 'V A R';
-    return (_jsxs(Text, { bold: true, color: color, wrap: "truncate", children: [label, " \u00B7 ", t.who ? spacedCaps(t.who) : t.detail ?? '', " \u00B7 ", homeTag(t.match.home.code), " ", t.homeScore, "\u2014", t.awayScore, " ", awayTag(t.match.away.code)] }));
+    return (_jsxs(Text, { bold: true, color: color, wrap: "truncate", children: [label, " \u00B7 ", t.who ? spacedCaps(t.who) : t.detail ?? '', " \u00B7 ", homeName(t.match.home), " ", t.homeScore, "\u2014", t.awayScore, " ", awayName(t.match.away)] }));
 }
 export function Ticker({ live, upcoming, takeover }) {
     if (takeover)
         return _jsx(TickerTakeover, { t: takeover });
-    return (_jsxs(Box, { flexDirection: "column", children: [live.slice(0, 3).map((m) => (_jsxs(Text, { wrap: "truncate", children: [_jsx(Text, { color: ACCENT, children: "\u23FA" }), _jsxs(Text, { dimColor: true, children: [" ", m.minute != null ? `${m.minute}'` : m.status === 'halftime' ? 'HT' : m.status === 'finished' ? 'FT' : '', " "] }), homeTag(m.home.code), " ", _jsxs(Text, { bold: true, color: ACCENT, children: [m.homeScore ?? '–', "\u2014", m.awayScore ?? '–'] }), " ", awayTag(m.away.code), m.varInProgress ? _jsx(Text, { dimColor: true, children: " \u2696" }) : null] }, m.id))), upcoming[0] ? (_jsxs(Text, { dimColor: true, wrap: "truncate", children: ["\u25CB ", homeTag(upcoming[0].home.code), " \u2014 ", awayTag(upcoming[0].away.code), " ", formatKickoff(upcoming[0].startTimestamp)] })) : null] }));
+    return (_jsxs(Box, { flexDirection: "column", children: [live.slice(0, 3).map((m) => (_jsxs(Text, { wrap: "truncate", children: [_jsx(Text, { color: ACCENT, children: "\u23FA" }), _jsxs(Text, { dimColor: true, children: [" ", m.minute != null ? `${m.minute}'` : m.status === 'halftime' ? 'HT' : m.status === 'finished' ? 'FT' : '', " "] }), homeName(m.home), " ", _jsxs(Text, { bold: true, color: ACCENT, children: [m.homeScore ?? '–', "\u2014", m.awayScore ?? '–'] }), " ", awayName(m.away), m.varInProgress ? _jsx(Text, { dimColor: true, children: " \u2696" }) : null] }, m.id))), upcoming[0] ? (_jsxs(Text, { dimColor: true, wrap: "truncate", children: ["\u25CB ", homeName(upcoming[0].home), " \u2014 ", awayName(upcoming[0].away), " ", formatKickoff(upcoming[0].startTimestamp)] })) : null] }));
 }

package/dist/ui/UpcomingSection.js

@@ -1,6 +1,6 @@
 import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
 import { Box, Text } from 'ink';
-import { homeTag, awayTag } from './flags.js';
+import { homeName, awayName } from './flags.js';
 import { matchPrediction } from '../predictions/match.js';
 import { fullSlate, headline } from '../predictions/format.js';
 export function formatKickoff(ts, now = Date.now()) {
@@ -9,22 +9,31 @@ export function formatKickoff(ts, now = Date.now()) {
     const sameDay = d.toDateString() === new Date(now).toDateString();
     if (sameDay)
         return time;
-    const day = d.toLocaleDateString(undefined, { weekday: 'short' });
+    // Within the week a weekday is enough; further out (fixtures reach ~3 weeks) add the date.
+    const soon = ts * 1000 - now < 6 * 86_400_000;
+    const day = d.toLocaleDateString(undefined, soon ? { weekday: 'short' } : { weekday: 'short', day: 'numeric', month: 'short' });
     return `${day} ${time}`;
 }
+/** The kickoff padded to `width` (default: fits the longest date format), always followed by a space. */
+export function kickoffColumn(ts, now = Date.now(), width = 22) {
+    const k = formatKickoff(ts, now);
+    return k.length >= width - 1 ? `${k} ` : k.padEnd(width);
+}
 export function UpcomingSection({ matches, compact, predictions = [], }) {
     const shown = matches.slice(0, compact ? 1 : 8);
     if (shown.length === 0)
         return null;
+    // One column for the whole list: as wide as its longest kickoff, plus a gap.
+    const width = Math.max(...shown.map((m) => formatKickoff(m.startTimestamp).length)) + 2;
     if (compact) {
         const m = shown[0];
         const pred = matchPrediction(m, predictions);
-        return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { dimColor: true, children: ["\u25CB ", homeTag(m.home.code), " \u2014 ", awayTag(m.away.code), " ", formatKickoff(m.startTimestamp)] }), pred ? _jsx(Text, { color: "yellow", children: headline(pred) }) : null] }));
+        return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { dimColor: true, children: ["\u25CB ", homeName(m.home), " \u2014 ", awayName(m.away), " ", formatKickoff(m.startTimestamp)] }), pred ? _jsx(Text, { color: "yellow", children: headline(pred) }) : null] }));
     }
     // Every fixture shows its pick; the NEXT one (shown[0]) gets the full slate.
     return (_jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [_jsx(Text, { dimColor: true, children: "UPCOMING" }), shown.map((m, i) => {
                 const pred = matchPrediction(m, predictions);
-                return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { children: [_jsxs(Text, { dimColor: true, children: ["\u25CB ", formatKickoff(m.startTimestamp).padEnd(13)] }), homeTag(m.home.code), " \u2014 ", awayTag(m.away.code), m.group ? _jsxs(Text, { dimColor: true, children: ["  \u00B7  ", m.group] }) : null] }), pred && i === 0
+                return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { children: [_jsxs(Text, { dimColor: true, children: ["\u25CB ", kickoffColumn(m.startTimestamp, Date.now(), width)] }), homeName(m.home), " \u2014 ", awayName(m.away), m.group ? _jsxs(Text, { dimColor: true, children: ["  \u00B7  ", m.group] }) : null] }), pred && i === 0
                             ? fullSlate(pred).map((ln, j) => _jsx(Text, { color: "yellow", children: ln }, j))
                             : pred
                                 ? _jsxs(Text, { color: "yellow", children: ["   ", headline(pred)] })

package/dist/ui/flags.js

@@ -1,4 +1,4 @@
-// Country flag emoji for a team, keyed on ESPN's 3-letter abbreviation
+// Country flag emoji for a national team, keyed on its 3-letter abbreviation
 // (verified against the live FIFA World Cup feed — note ESPN uses MAR for
 // Morocco). Bracket placeholders (1A, QFW1, RD16 W1, …) have no flag.
 // ESPN abbreviation → ISO 3166-1 alpha-2.
@@ -31,13 +31,27 @@ export function flagFor(code) {
         return subdivisionFlag(sub);
     return '';
 }
-/** Home side: "QAT 🇶🇦" (flag trails the code), or just the code if unmapped. */
-export function homeTag(code) {
-    const f = flagFor(code);
+/**
+ * Home side: "QAT 🇶🇦" (flag trails the code), or just the code if unmapped.
+ * Clubs (`national === false`) never get a flag: their codes collide with
+ * countries (PAN is Panetolikos, not Panama).
+ */
+export function homeTag(code, national = true) {
+    const f = national ? flagFor(code) : '';
     return f ? `${code} ${f}` : code;
 }
-/** Away side: "🇨🇭 SUI" (flag leads the code), or just the code if unmapped. */
-export function awayTag(code) {
-    const f = flagFor(code);
+/** Away side: "🇨🇭 SUI" (flag leads the code), or just the code if unmapped. Clubs get no flag. */
+export function awayTag(code, national = true) {
+    const f = national ? flagFor(code) : '';
     return f ? `${f} ${code}` : code;
 }
+/** Home side by full name, for the roomy views: "Qatar 🇶🇦", or "Arsenal" for a club. */
+export function homeName(t) {
+    const f = t.national !== false ? flagFor(t.code) : '';
+    return f ? `${t.name} ${f}` : t.name;
+}
+/** Away side by full name: "🇨🇭 Switzerland", or "Liverpool" for a club. */
+export function awayName(t) {
+    const f = t.national !== false ? flagFor(t.code) : '';
+    return f ? `${f} ${t.name}` : t.name;
+}

package/dist/ui/notice.js

@@ -0,0 +1,9 @@
+export function boardNotice(s) {
+    if (s.stale && s.lastUpdated == null)
+        return 'offline'; // never reached the server
+    if (s.followsNone)
+        return 'follow-nothing';
+    if (s.lastUpdated != null && s.matchCount === 0)
+        return 'no-matches';
+    return null;
+}