@claudinho/core 0.11.1 → 0.12.0

package/dist/index.js

@@ -332,6 +332,13 @@ var EN = {
   "status.fullTime": "full-time",
   "status.postponed": "postponed",
   "status.cancelled": "cancelled",
+  // A timeline row's kind word (core `timelineRows`).
+  "event.goal": "Goal",
+  "event.ownGoal": "Own goal",
+  "event.penalty": "Penalty",
+  "event.yellow": "Yellow card",
+  "event.red": "Red card",
+  "event.sub": "Substitution",
   "live.title": "Live now",
   "today.title": "Today's matches",
   "today.on": "Matches",
@@ -340,6 +347,23 @@ var EN = {
   "next.in": "in {countdown}",
   // A kickoff that has passed, where the countdown would say "in" (core `countdownPhrase`).
   "countdown.now": "now",
+  // The ambient line's syncing phrase (`claudinho ambient --json` alone; the
+  // statusline's own `prompt` stays English).
+  "ambient.syncing": "live \xB7 syncing\u2026",
+  // The plugin's moment words, sent by `claudinho ambient --json` as `words`
+  // (`{team}` a template the plugin fills with the record's own names). Each
+  // at most 40 characters; `{team}` once in `moment.goalFor` and `moment.win`
+  // and nowhere else, or the plugin falls back to its English words.
+  "moment.goal": "GOAL!",
+  "moment.ownGoal": "Own goal",
+  "moment.ownGoalDetail": "own goal",
+  "moment.goalFor": "Goal for {team}",
+  "moment.goals": "Goals",
+  "moment.scoreUpdated": "Score updated",
+  "moment.penalties": "Penalties",
+  "moment.fullTime": "Full time",
+  "moment.win": "{team} win",
+  "moment.draw": "Draw",
   // A title that introduces the lines below it (the MCP text).
   heading: "{title}:",
   // A list's empty state and the outage lines: the CLI's sentences, the MCP
@@ -351,6 +375,7 @@ var EN = {
   "feed.earlierRecord": "Live state could not be refreshed \u2014 showing the provider's earlier record.",
   "next.none": "No upcoming fixture found for {team}.",
   "match.none": "No match found with id {id}.",
+  "match.kickoff": "Kickoff",
   // The MCP text's own sentences for these states (the CLI says `live.degraded`
   // there): they keep the team or the id the answer is about.
   "next.unreachable": "Couldn't reach the data provider \u2014 no upcoming fixture confirmed for {team}.",
@@ -428,6 +453,12 @@ var ES = {
   "status.fullTime": "finalizado",
   "status.postponed": "aplazado",
   "status.cancelled": "cancelado",
+  "event.goal": "Gol",
+  "event.ownGoal": "Gol en contra",
+  "event.penalty": "Penal",
+  "event.yellow": "Tarjeta amarilla",
+  "event.red": "Tarjeta roja",
+  "event.sub": "Cambio",
   "live.title": "En vivo",
   "today.title": "Partidos de hoy",
   "today.on": "Partidos",
@@ -435,6 +466,17 @@ var ES = {
   "next.label": "Pr\xF3ximo partido de {team}",
   "next.in": "en {countdown}",
   "countdown.now": "ahora",
+  "ambient.syncing": "en vivo \xB7 sincronizando\u2026",
+  "moment.goal": "\xA1GOL!",
+  "moment.ownGoal": "Gol en contra",
+  "moment.ownGoalDetail": "gol en contra",
+  "moment.goalFor": "Gol de {team}",
+  "moment.goals": "Goles",
+  "moment.scoreUpdated": "Marcador corregido",
+  "moment.penalties": "Penales",
+  "moment.fullTime": "Final",
+  "moment.win": "Gana {team}",
+  "moment.draw": "Empate",
   heading: "{title}:",
   "today.none": "No hay partidos para esta fecha.",
   "live.none": "No hay partidos en juego ahora mismo.",
@@ -443,6 +485,7 @@ var ES = {
   "feed.earlierRecord": "No se pudo actualizar el estado en vivo \u2014 se muestra el registro anterior del proveedor.",
   "next.none": "No se encontr\xF3 pr\xF3ximo partido para {team}.",
   "match.none": "No se encontr\xF3 partido con id {id}.",
+  "match.kickoff": "Inicio",
   "next.unreachable": "No se pudo contactar al proveedor de datos \u2014 ning\xFAn pr\xF3ximo partido confirmado para {team}.",
   "match.unreachable": "No se pudo contactar al proveedor de datos \u2014 no se pudo consultar el partido {id}.",
   "team.ambiguous": '"{query}" es ambiguo. \xBFQuisiste decir:',
@@ -517,6 +560,12 @@ var PT = {
   "status.fullTime": "encerrado",
   "status.postponed": "adiado",
   "status.cancelled": "cancelado",
+  "event.goal": "Gol",
+  "event.ownGoal": "Gol contra",
+  "event.penalty": "P\xEAnalti",
+  "event.yellow": "Cart\xE3o amarelo",
+  "event.red": "Cart\xE3o vermelho",
+  "event.sub": "Substitui\xE7\xE3o",
   "live.title": "Ao vivo",
   "today.title": "Jogos de hoje",
   "today.on": "Jogos",
@@ -524,6 +573,17 @@ var PT = {
   "next.label": "Pr\xF3ximo jogo de {team}",
   "next.in": "em {countdown}",
   "countdown.now": "agora",
+  "ambient.syncing": "ao vivo \xB7 sincronizando\u2026",
+  "moment.goal": "GOL!",
+  "moment.ownGoal": "Gol contra",
+  "moment.ownGoalDetail": "gol contra",
+  "moment.goalFor": "Gol \xB7 {team}",
+  "moment.goals": "Gols",
+  "moment.scoreUpdated": "Placar corrigido",
+  "moment.penalties": "P\xEAnaltis",
+  "moment.fullTime": "Fim de jogo",
+  "moment.win": "{team} vence",
+  "moment.draw": "Empate",
   heading: "{title}:",
   "today.none": "Nenhum jogo para esta data.",
   "live.none": "Nenhum jogo em andamento agora.",
@@ -532,6 +592,7 @@ var PT = {
   "feed.earlierRecord": "N\xE3o foi poss\xEDvel atualizar o estado ao vivo \u2014 mostrando o registro anterior do provedor.",
   "next.none": "Nenhum pr\xF3ximo jogo encontrado para {team}.",
   "match.none": "Nenhum jogo encontrado com id {id}.",
+  "match.kickoff": "In\xEDcio",
   "next.unreachable": "N\xE3o foi poss\xEDvel contatar o provedor de dados \u2014 nenhum pr\xF3ximo jogo confirmado para {team}.",
   "match.unreachable": "N\xE3o foi poss\xEDvel contatar o provedor de dados \u2014 o jogo {id} n\xE3o p\xF4de ser consultado.",
   "team.ambiguous": '"{query}" \xE9 amb\xEDguo. Voc\xEA quis dizer:',
@@ -606,6 +667,12 @@ var FR = {
   "status.fullTime": "termin\xE9",
   "status.postponed": "report\xE9",
   "status.cancelled": "annul\xE9",
+  "event.goal": "But",
+  "event.ownGoal": "But contre son camp",
+  "event.penalty": "Penalty",
+  "event.yellow": "Carton jaune",
+  "event.red": "Carton rouge",
+  "event.sub": "Remplacement",
   "live.title": "En direct",
   "today.title": "Matchs d'aujourd'hui",
   "today.on": "Matchs",
@@ -613,6 +680,17 @@ var FR = {
   "next.label": "Prochain match de {team}",
   "next.in": "dans {countdown}",
   "countdown.now": "maintenant",
+  "ambient.syncing": "en direct \xB7 synchronisation\u2026",
+  "moment.goal": "BUT !",
+  "moment.ownGoal": "But contre son camp",
+  "moment.ownGoalDetail": "contre son camp",
+  "moment.goalFor": "But pour {team}",
+  "moment.goals": "Buts",
+  "moment.scoreUpdated": "Score corrig\xE9",
+  "moment.penalties": "Tirs au but",
+  "moment.fullTime": "Fin du match",
+  "moment.win": "{team} gagne",
+  "moment.draw": "Match nul",
   heading: "{title} :",
   "today.none": "Aucun match pr\xE9vu pour cette date.",
   "live.none": "Aucun match en cours pour l'instant.",
@@ -621,6 +699,7 @@ var FR = {
   "feed.earlierRecord": "L\u2019\xE9tat en direct n\u2019a pas pu \xEAtre actualis\xE9 \u2014 affichage de l\u2019enregistrement pr\xE9c\xE9dent du fournisseur.",
   "next.none": "Aucun prochain match trouv\xE9 pour {team}.",
   "match.none": "Aucun match trouv\xE9 avec id {id}.",
+  "match.kickoff": "Coup d\u2019envoi",
   "next.unreachable": "Impossible de joindre le fournisseur de donn\xE9es \u2014 aucun prochain match confirm\xE9 pour {team}.",
   "match.unreachable": "Impossible de joindre le fournisseur de donn\xE9es \u2014 le match {id} n\u2019a pas pu \xEAtre consult\xE9.",
   "team.ambiguous": '"{query}" est ambigu. Vouliez-vous dire :',
@@ -654,6 +733,20 @@ function t(lang, key, vars) {
     (whole, name) => Object.hasOwn(vars, name) ? vars[name] : whole
   );
 }
+function momentWords(lang) {
+  return {
+    goal: t(lang, "moment.goal"),
+    ownGoal: t(lang, "moment.ownGoal"),
+    ownGoalDetail: t(lang, "moment.ownGoalDetail"),
+    goalFor: t(lang, "moment.goalFor"),
+    goals: t(lang, "moment.goals"),
+    scoreUpdated: t(lang, "moment.scoreUpdated"),
+    penalties: t(lang, "moment.penalties"),
+    fullTime: t(lang, "moment.fullTime"),
+    win: t(lang, "moment.win"),
+    draw: t(lang, "moment.draw")
+  };
+}
 var STAGE_KEYS = Object.freeze({
   GROUP: "stage.groupStage",
   R32: "stage.r32",
@@ -763,7 +856,7 @@ function formatTime(iso, opts = {}) {
   }).format(when);
 }
 var COUNTDOWN_NOW = "now";
-function countdown(iso, from = /* @__PURE__ */ new Date()) {
+function countdown(iso, from) {
   const when = parsedDate(iso);
   if (!when) return UNKNOWN_TIME;
   const ms = when.getTime() - from.getTime();
@@ -776,7 +869,7 @@ function countdown(iso, from = /* @__PURE__ */ new Date()) {
   if (hours > 0) return `${hours}h${mins}m`;
   return `${mins}m`;
 }
-function countdownPhrase(lang, iso, from = /* @__PURE__ */ new Date()) {
+function countdownPhrase(lang, iso, from) {
   const left = countdown(iso, from);
   return left === COUNTDOWN_NOW ? t(lang, "countdown.now") : t(lang, "next.in", { countdown: left });
 }
@@ -842,6 +935,70 @@ function withFlag(text, flag2, side) {
   return side === "home" ? `${flag2} ${text}` : `${text} ${flag2}`;
 }
 
+// src/timeline.ts
+var KIND_KEYS = Object.freeze({
+  GOAL: "event.goal",
+  OWN_GOAL: "event.ownGoal",
+  PEN: "event.penalty",
+  YELLOW: "event.yellow",
+  RED: "event.red",
+  SUB: "event.sub"
+});
+var KIND_MARKS = Object.freeze({
+  GOAL: "\u26BD",
+  OWN_GOAL: "\u26BD",
+  PEN: "\u26BD",
+  YELLOW: "\u{1F7E8}",
+  RED: "\u{1F7E5}",
+  SUB: "\u{1F504}"
+});
+function timelineParts(match, opts) {
+  const events = match.events ?? [];
+  if (events.length === 0) return [];
+  const cells = events.map((e) => {
+    const team = e.side === "home" ? match.home : match.away;
+    return {
+      minute: e.added !== void 0 ? `${e.minute}+${e.added}'` : `${e.minute}'`,
+      mark: KIND_MARKS[e.type],
+      kind: t(opts.lang, KIND_KEYS[e.type]),
+      label: withFlag(team.code, opts.flags ? team.flag : void 0, e.side),
+      player: e.player
+    };
+  });
+  const widest = (pick2) => Math.max(...cells.map((c) => displayWidth(pick2(c))));
+  const minuteW = widest((c) => c.minute);
+  const kindW = widest((c) => c.kind);
+  const labelW = widest((c) => c.label);
+  return cells.map((c) => {
+    const columns = `  ${padVisible(c.minute, minuteW)}  ${c.mark} ${padVisible(c.kind, kindW)}  ${padVisible(c.label, labelW)}`;
+    if (!c.player) return [{ text: columns.trimEnd() }];
+    return [{ text: `${columns}  ` }, { text: c.player, style: "strong" }];
+  });
+}
+function timelineRows(match, opts) {
+  return timelineParts(match, opts).map((row) => row.map((p) => p.text).join(""));
+}
+var SCORING = /* @__PURE__ */ new Set(["GOAL", "OWN_GOAL", "PEN"]);
+function provenLastGoal(match) {
+  const score = match.score;
+  if (!score) return null;
+  let home = 0;
+  let away = 0;
+  let last = null;
+  const identities = /* @__PURE__ */ new Set();
+  for (const e of match.events ?? []) {
+    if (!SCORING.has(e.type)) continue;
+    const identity = JSON.stringify([e.type, e.minute, e.added ?? 0, e.side, e.player ?? null]);
+    if (identities.has(identity)) return null;
+    identities.add(identity);
+    if (e.side === "home") home++;
+    else if (e.side === "away") away++;
+    else continue;
+    last = e;
+  }
+  return last !== null && home === score.home && away === score.away ? last : null;
+}
+
 // src/normalize.ts
 function outcomeFromScore(home, away) {
   if (home > away) return "H";
@@ -1132,18 +1289,33 @@ function sealScorePair(raw) {
   const away = count(v.away, MAX_GOALS);
   return home !== void 0 && away !== void 0 ? { home, away } : void 0;
 }
+var MAX_ADDED_MINUTES = 30;
+var SIDES = /* @__PURE__ */ new Set(["home", "away"]);
 function sealEvent(raw) {
-  if (!raw || typeof raw !== "object") return void 0;
+  if (!raw || typeof raw !== "object") return null;
   const e = raw;
   const type = member(e.type, EVENT_TYPES);
-  if (!type) return void 0;
+  if (!type) return null;
   const minute = count(e.minute, MAX_MINUTE);
-  if (minute === void 0) return void 0;
-  const out = { type, minute, teamCode: humanLabel(e.teamCode, TEAM_CODE_COLUMNS) };
+  if (minute === void 0) return null;
+  let added;
+  if (e.added !== void 0) {
+    added = count(e.added, MAX_ADDED_MINUTES);
+    if (added === void 0 || added < 1) return null;
+  }
+  const side = member(e.side, SIDES);
+  if (!side) return null;
+  const out = { type, minute };
+  if (added !== void 0) out.added = added;
+  out.side = side;
+  out.teamCode = humanLabel(e.teamCode, TEAM_CODE_COLUMNS);
   const player = humanLabel(e.player);
   if (player) out.player = player;
   return out;
 }
+function byClock(a, b) {
+  return a.minute - b.minute || (a.added ?? 0) - (b.added ?? 0);
+}
 function sealMatch(parts, opts = {}) {
   if (!parts || typeof parts !== "object") return malformed("match is not an object");
   const id = opaqueId(parts.id, ESPN_ID);
@@ -1188,7 +1360,8 @@ function sealMatch(parts, opts = {}) {
       winnerCode = claimedWinner;
     }
   }
-  const events = opts.events === false ? [] : takeBounded(parts.events, MAX_MATCH_EVENTS).map(sealEvent).filter((e) => !!e);
+  const timelined = status === "LIVE" || status === "HT" || status === "FT";
+  const events = opts.events === false || !timelined ? [] : takeBounded(parts.events, MAX_MATCH_EVENTS).map(sealEvent).filter((e) => !!e).sort(byClock);
   const out = { id, stage };
   if (stageLabel2) out.stageLabel = stageLabel2;
   if (group) out.group = group;
@@ -4446,6 +4619,75 @@ function parseMinute(st) {
   }
   return void 0;
 }
+var DETAIL_FLAGS = ["scoringPlay", "yellowCard", "redCard", "penaltyKick", "ownGoal", "shootout"];
+var DETAIL_MINUTE = /^(\d{1,3})'$/;
+var DETAIL_MINUTE_ADDED = /^(\d{1,3})'\+(\d{1,2})'$/;
+function detailKind(d) {
+  const f = {};
+  for (const name of DETAIL_FLAGS) {
+    const v = flag(d[name]);
+    if (v === void 0) return void 0;
+    f[name] = v;
+  }
+  if (f.shootout) return void 0;
+  const { scoringPlay: s, yellowCard: y, redCard: r, penaltyKick: p, ownGoal: o } = f;
+  if (s && !y && !r) {
+    if (!p && !o) return "GOAL";
+    if (o && !p) return "OWN_GOAL";
+    if (p && !o) return "PEN";
+    return void 0;
+  }
+  if (p || o || s) return void 0;
+  if (y && !r) return "YELLOW";
+  if (r && !y) return "RED";
+  return void 0;
+}
+function detailMinute(clock) {
+  if (!clock || typeof clock !== "object") return void 0;
+  const dv = clock.displayValue;
+  if (typeof dv !== "string") return void 0;
+  const plain = DETAIL_MINUTE.exec(dv);
+  if (plain) return { minute: Number(plain[1]) };
+  const extra = DETAIL_MINUTE_ADDED.exec(dv);
+  if (!extra) return void 0;
+  return { minute: Number(extra[1]), added: Number(extra[2]) };
+}
+function rawTeamId(holder) {
+  if (!holder || typeof holder !== "object") return void 0;
+  const team = holder.team;
+  if (!team || typeof team !== "object") return void 0;
+  return opaqueId(team.id, ESPN_ID);
+}
+function detailEvents(details, sides) {
+  const out = [];
+  for (const raw of takeBounded(details, MAX_MATCH_EVENTS)) {
+    if (!raw || typeof raw !== "object" || Array.isArray(raw)) continue;
+    const d = raw;
+    const type = detailKind(d);
+    if (!type) continue;
+    const when = detailMinute(d.clock);
+    if (!when) continue;
+    const teamId = rawTeamId(d);
+    const side = teamId === void 0 ? void 0 : teamId === sides.homeId ? "home" : teamId === sides.awayId ? "away" : void 0;
+    if (!side) continue;
+    const event = { type, minute: when.minute };
+    if (when.added !== void 0) event.added = when.added;
+    event.side = side;
+    event.teamCode = side === "home" ? sides.homeCode : sides.awayCode;
+    const player = detailPlayer(d.athletesInvolved, type === "OWN_GOAL" ? side === "home" ? sides.awayId : sides.homeId : teamId);
+    if (player) event.player = player;
+    out.push(event);
+  }
+  return out;
+}
+function detailPlayer(athletes, expectedTeamId) {
+  if (!Array.isArray(athletes) || athletes.length !== 1 || expectedTeamId === void 0) return void 0;
+  const a = athletes[0];
+  if (rawTeamId(a) !== expectedTeamId) return void 0;
+  const name = a.displayName;
+  if (!isHumanLabel(name)) return void 0;
+  return humanLabel(name) || void 0;
+}
 var MAX_SLUG_UNITS2 = 64;
 var SLUG = /^[a-z0-9-]+$/;
 var EXACT_STAGE = Object.freeze({
@@ -4567,7 +4809,14 @@ function parseEspnEvent(raw, ctx = {}) {
       status,
       winnerCode,
       updatedAt: (/* @__PURE__ */ new Date()).toISOString(),
-      events: ev.events
+      // The goals and cards: ESPN's `details`, read by the detail grammar; the
+      // seal keeps them only on a status that holds a score.
+      events: detailEvents(comp?.details, {
+        homeId: rawTeamId(homeRaw),
+        awayId: rawTeamId(awayRaw),
+        homeCode: home.code,
+        awayCode: away.code
+      })
     },
     // The final reseal states the same kind the competitors were built with.
     { teamKind: kind }
@@ -4890,7 +5139,7 @@ function fetchMeta(result) {
 // src/adapters/espn.ts
 var ESPN_SOCCER = "https://site.api.espn.com/apis/site/v2/sports/soccer";
 var DEFAULT_COMPETITION = BUNDLED_SLUG;
-var USER_AGENT = `claudinho/${"0.11.1"} (+https://github.com/arturogarrido/claudinho)`;
+var USER_AGENT = `claudinho/${"0.12.0"} (+https://github.com/arturogarrido/claudinho)`;
 var MAX_RESPONSE_BYTES = 5 * 1024 * 1024;
 var DEFAULT_COOLDOWN_MS = 5 * 6e4;
 var MAX_COOLDOWN_MS = 15 * 6e4;
@@ -6606,6 +6855,9 @@ function mergeLive(base, live) {
 function clockOf(adapter) {
   return new Date(adapter.now?.() ?? Date.now());
 }
+function requestClock(adapter, given) {
+  return given ?? clockOf(adapter);
+}
 function providerDayOf(adapter, instant) {
   if (Number.isNaN(instant.getTime())) return "";
   return adapter.bucketDay?.(instant) || instant.toISOString().slice(0, 10);
@@ -6780,7 +7032,7 @@ async function marketFixtureForTeam(adapter, code, now = /* @__PURE__ */ new Dat
   });
   let refreshRead = {};
   if (candidate) {
-    const { partial, served: _served, ...r } = await getMatchById(adapter, candidate.id);
+    const { partial, served: _served, ...r } = await getMatchById(adapter, candidate.id, now);
     refreshRead = partial ? { partial } : {};
     const m = r.degraded ? candidate : r.match ?? candidate;
     if (!isFinished(m.status)) return { ...r, match: m, ...bothReads(windowRead, refreshRead) };
@@ -7013,10 +7265,19 @@ async function getScheduleAhead(adapter, now = /* @__PURE__ */ new Date()) {
   };
 }
 async function getLiveMatches(adapter, now = /* @__PURE__ */ new Date()) {
-  const { complete: _complete, ...result } = await getLiveRead(adapter, now);
+  const { complete: _complete, finished: _finished, finishedTruncated: _truncated, ...result } = await getLiveRead(adapter, now);
   return result;
 }
-async function getLiveRead(adapter, now = /* @__PURE__ */ new Date()) {
+var MAX_LIVE_FINISHED = 64;
+function finishedOf(records, seen) {
+  const wanted = new Set(takeBounded(seen, MAX_LIVE_FINISHED));
+  const done = records.filter((m) => m.status === "FT" && m.score !== void 0);
+  const first = done.filter((m) => wanted.has(m.id));
+  const rest = done.filter((m) => !wanted.has(m.id));
+  const all = [...first, ...rest];
+  return { finished: all.slice(0, MAX_LIVE_FINISHED), truncated: all.length > MAX_LIVE_FINISHED };
+}
+async function getLiveRead(adapter, now = /* @__PURE__ */ new Date(), seen = []) {
   try {
     const day = now.toISOString().slice(0, 10);
     const fetched = adapter.fetchWindow ? await adapter.fetchWindow(shiftUtcDate(day, -1), shiftUtcDate(day, 1), { acrossSeasons: true }) : await adapter.fetchLive();
@@ -7024,6 +7285,7 @@ async function getLiveRead(adapter, now = /* @__PURE__ */ new Date()) {
     const season = meta?.season;
     const matches = fetched.filter((m) => isLive(m.status));
     const between = betweenEditionsOf(adapter, meta, fetched, providerDayOf(adapter, now));
+    const done = finishedOf(fetched, seen);
     return {
       matches,
       degraded: false,
@@ -7035,10 +7297,12 @@ async function getLiveRead(adapter, now = /* @__PURE__ */ new Date()) {
       // boolean below is the refresher's, unchanged: false for that, for an
       // adapter that said nothing, and for a failed read alike.
       ...partialOfRead(meta),
-      complete: meta?.complete === true
+      complete: meta?.complete === true,
+      finished: done.finished,
+      finishedTruncated: done.truncated
     };
   } catch {
-    return { matches: [], degraded: true, complete: false };
+    return { matches: [], degraded: true, complete: false, finished: [], finishedTruncated: false };
   }
 }
 
@@ -7288,15 +7552,22 @@ function sealMarketSignal(raw, options = {}) {
   if (sourceMarketId) out.sourceMarketId = sourceMarketId;
   out.asOf = canonicalTimestamp(s.asOf) ?? "";
   out.fetchedAt = canonicalTimestamp(s.fetchedAt) ?? "";
+  const judgedAt = options.now ?? /* @__PURE__ */ new Date();
+  const fetchedMs = Date.parse(out.fetchedAt);
+  if (out.fetchedAt === "" || !Number.isFinite(fetchedMs)) {
+    return malformed("signal carries no readable fetch time");
+  }
+  if (fetchedMs > judgedAt.getTime()) {
+    return unresolved("signal was fetched after the clock it is judged by");
+  }
   out.outcomes = outcomes;
   const isAmbiguous = s.ambiguous !== false;
   const favorite = isAmbiguous ? void 0 : deriveFavorite(outcomes);
   if (favorite) out.favorite = favorite;
   if (liquidity !== void 0) out.liquidity = liquidity;
   if (volume24h !== void 0) out.volume24h = volume24h;
-  out.stale = s.stale !== false;
+  out.stale = isStaleSignal(out, { now: judgedAt, maxAgeMs: options.maxAgeMs });
   out.ambiguous = isAmbiguous || out.source === "";
-  out.stale = out.stale || isStaleSignal(out, { now: options.now, maxAgeMs: options.maxAgeMs });
   return valid(out);
 }
 function parseCachedMarketSignal(raw, options = {}) {
@@ -7305,7 +7576,7 @@ function parseCachedMarketSignal(raw, options = {}) {
 
 // src/markets/normalize.ts
 var DEFAULT_MAX_AGE_MS = 15 * 6e4;
-function marketRelevant(match, now = /* @__PURE__ */ new Date()) {
+function marketRelevant(match, now) {
   if (isLive(match.status)) return true;
   if (isFinished(match.status)) return false;
   const k = Date.parse(match.kickoff);
@@ -7394,12 +7665,13 @@ function buildMarketSignal(input) {
   const outcomes = normalizeOutcomes(input.outcomes);
   const ambiguous2 = input.ambiguous === true || !mapsCleanly(input.match, outcomes);
   const favorite = ambiguous2 ? void 0 : deriveFavorite(outcomes);
+  const clock = input.now ?? /* @__PURE__ */ new Date();
   const signal = {
     matchId: input.match.id,
     source: input.source,
     sourceMarketId: input.sourceMarketId,
     asOf: input.asOf,
-    fetchedAt: input.fetchedAt ?? (/* @__PURE__ */ new Date()).toISOString(),
+    fetchedAt: input.fetchedAt ?? clock.toISOString(),
     outcomes,
     favorite,
     liquidity: input.liquidity,
@@ -7407,8 +7679,8 @@ function buildMarketSignal(input) {
     stale: false,
     ambiguous: ambiguous2
   };
-  signal.stale = isStaleSignal(signal, { now: input.now, maxAgeMs: input.maxAgeMs });
-  const sealed = sealMarketSignal(signal, { now: input.now, maxAgeMs: input.maxAgeMs });
+  signal.stale = isStaleSignal(signal, { now: clock, maxAgeMs: input.maxAgeMs });
+  const sealed = sealMarketSignal(signal, { now: clock, maxAgeMs: input.maxAgeMs });
   if (sealed.kind !== "valid") {
     return { ...signal, outcomes: [], favorite: void 0, stale: true, ambiguous: true };
   }
@@ -8684,6 +8956,7 @@ export {
   MAX_CONFIG_BYTES,
   MAX_COOLDOWN_MS,
   MAX_LABEL_COLUMNS,
+  MAX_LIVE_FINISHED,
   MAX_RESPONSE_BYTES,
   MAX_SCHEDULE_INDEX,
   NO_BRACKET,
@@ -8833,6 +9106,7 @@ export {
   matchWindowSentence,
   mergeLive,
   modeLine,
+  momentWords,
   nationArg,
   nationToFlag,
   nationToRegion,
@@ -8854,11 +9128,13 @@ export {
   parsedValue,
   pinUnder,
   productFlag,
+  provenLastGoal,
   rallyCryFor,
   rallyEntryFor,
   readJsonBounded,
   readSmallFile,
   readUserConfig,
+  requestClock,
   resolveClub,
   resolveCompetition,
   resolveMarketSource,
@@ -8871,6 +9147,7 @@ export {
   scheduleEntryOf,
   scheduleSpan,
   scoreline,
+  sealEvent,
   sealMarketSignal,
   sealMatch,
   sealScheduleEntry,
@@ -8890,7 +9167,10 @@ export {
   tableKeyArg,
   tableShareCard,
   tableTitle,
+  takeBounded,
   teamKind,
+  timelineParts,
+  timelineRows,
   truncateVisible,
   unresolved,
   unservedSentence,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@claudinho/core",
-  "version": "0.11.1",
+  "version": "0.12.0",
   "description": "The engine behind Claudinho: the domain model, the provider adapters (ESPN), live scores and standings for the competition you follow (16 supported), the bundled 2026 World Cup schedule with its knockout bracket and read-only Polymarket sidecar. Independent fan project. Not affiliated with FIFA, any confederation, league or club, or Anthropic.",
   "type": "module",
   "license": "MIT",
@@ -67,7 +67,7 @@
     "club-world-cup"
   ],
   "devDependencies": {
-    "@types/node": "^22.20.4",
+    "@types/node": "^22.20.5",
     "@vitest/coverage-v8": "^5.0.3",
     "tsup": "^8.0.0",
     "tsx": "^4.23.15",