@claudinho/cli 0.4.3 → 0.5.1

package/README.md

@@ -21,11 +21,11 @@ npx @claudinho/cli today
 claudinho today [date]      # a day's fixtures in your timezone (default: today), live scores inline
 claudinho live              # matches in play right now
 claudinho next [TEAM]       # a team's next fixture + countdown (default: $CLAUDINHO_TEAM)
-claudinho table [GROUP]     # group standings (default: all groups)
+claudinho table [GROUP]     # live cumulative group standings (default: all groups)
 claudinho match <id>        # a single match's detail
 claudinho markets [target]  # prediction-market signals: today | <date> | <id> | next <TEAM>
                             #   (next prefers the team's IN-PLAY match while one is live)
-claudinho share [target]    # copy-pasteable match snippet: today | live | <date> | <id> | next <TEAM>
+claudinho share [target]    # copy-pasteable snippet: today | live | <date> | <id> | next <TEAM> | table <GROUP>
 claudinho prompt            # one compact status line (for statusline/tmux/Starship)
 claudinho init-statusline   # wire it into the Claude Code statusline
 claudinho hook              # live-score context for a Claude Code hook (silent off-match)
@@ -108,6 +108,7 @@ social posts, READMEs, and issue comments — your terminal football, ready to p
 claudinho share                   # today's matches
 claudinho share live              # matches in play
 claudinho share next MEX          # a team's next fixture (+ market read, when reliable)
+claudinho share table A           # a group's standings card (facts only, no market line)
 claudinho share 760415            # one match by id
 claudinho share next MEX --copy   # …and copy it straight to the clipboard
 ```

package/dist/index.js

@@ -2762,6 +2762,43 @@ function mapEspnEvent(ev, ctx = {}) {
 function toEspnDate(d) {
   return d.replace(/\D/g, "").slice(0, 8);
 }
+function statVal(stats, name) {
+  const v = stats?.find((s) => s.name === name)?.value;
+  return typeof v === "number" && Number.isFinite(v) ? Math.round(v) : 0;
+}
+function entryToRow(e) {
+  return {
+    team: toTeam(e.team),
+    played: statVal(e.stats, "gamesPlayed"),
+    won: statVal(e.stats, "wins"),
+    drawn: statVal(e.stats, "ties"),
+    lost: statVal(e.stats, "losses"),
+    goalsFor: statVal(e.stats, "pointsFor"),
+    goalsAgainst: statVal(e.stats, "pointsAgainst"),
+    goalDiff: statVal(e.stats, "pointDifferential"),
+    points: statVal(e.stats, "points")
+  };
+}
+function parseStandings(data) {
+  const out2 = [];
+  for (const child of data.children ?? []) {
+    const letter = (child.name ?? child.abbreviation ?? "").match(/Group\s+([A-L])/i)?.[1]?.toUpperCase();
+    if (!letter) continue;
+    const ranked = (child.standings?.entries ?? []).map((e) => ({
+      row: entryToRow(e),
+      rank: statVal(e.stats, "rank")
+    }));
+    ranked.sort((a, b) => {
+      if (a.rank && b.rank && a.rank !== b.rank) return a.rank - b.rank;
+      const r = a.row;
+      const s = b.row;
+      return s.points - r.points || s.goalDiff - r.goalDiff || s.goalsFor - r.goalsFor || r.team.code.localeCompare(s.team.code);
+    });
+    out2.push({ group: letter, rows: ranked.map((x) => x.row) });
+  }
+  out2.sort((a, b) => a.group.localeCompare(b.group));
+  return out2;
+}
 var EspnAdapter = class {
   constructor(opts = {}) {
     this.opts = opts;
@@ -2781,25 +2818,30 @@ var EspnAdapter = class {
     const today = await this.fetchScoreboard();
     return today.filter((m) => m.status === "LIVE" || m.status === "HT");
   }
+  /** Standings endpoint URL (lives under apis/v2, not site/v2; derived from base). */
+  standingsUrl() {
+    const base = this.opts.baseUrl ?? DEFAULT_BASE;
+    return `${base.replace("/apis/site/v2/", "/apis/v2/")}/standings`;
+  }
+  /**
+   * Authoritative, cumulative group tables from the standings endpoint. Throws
+   * on fetch/parse failure (the caller decides the fallback). Group-stage only:
+   * non-group `children` are filtered out by {@link parseStandings}.
+   */
+  async fetchStandings() {
+    return parseStandings(await this.get(this.standingsUrl()));
+  }
   /**
    * Build (and cache) a team-code -> group-letter map from the standings
-   * endpoint. Best-effort: returns {} if standings are unavailable.
+   * endpoint. Best-effort: returns {} if standings are unavailable. Reuses the
+   * same parse as {@link fetchStandings}, so the two never drift.
    */
   async fetchGroupMap(force = false) {
     if (this.groupMap && !force) return this.groupMap;
-    const base = this.opts.baseUrl ?? DEFAULT_BASE;
-    const standingsUrl = `${base.replace("/apis/site/v2/", "/apis/v2/")}/standings`;
     const map = {};
     try {
-      const data = await this.get(standingsUrl);
-      for (const child of data.children ?? []) {
-        const letter = (child.name ?? child.abbreviation ?? "").match(/Group\s+([A-L])/i)?.[1]?.toUpperCase();
-        if (!letter) continue;
-        for (const e of child.standings?.entries ?? []) {
-          const code = e.team?.abbreviation?.toUpperCase();
-          if (code) map[code] = letter;
-        }
-      }
+      const tables = parseStandings(await this.get(this.standingsUrl()));
+      for (const t of tables) for (const r of t.rows) map[r.team.code] = t.group;
     } catch {
     }
     this.groupMap = map;
@@ -2870,6 +2912,22 @@ async function getMatchesForDate(adapter, dateISO) {
     return { matches: base, degraded: true };
   }
 }
+async function getStandings(adapter, group) {
+  const want = group?.toUpperCase();
+  if (adapter.fetchStandings) {
+    try {
+      const all = await adapter.fetchStandings();
+      const tables2 = (want ? all.filter((t) => t.group === want) : all).sort(
+        (a, b) => a.group.localeCompare(b.group)
+      );
+      return { tables: tables2, degraded: false, source: adapter.name };
+    } catch {
+    }
+  }
+  const letters = want ? [want] : groups();
+  const tables = letters.map((g) => ({ group: g, rows: computeStandings(fixturesByGroup(g)) })).filter((t) => t.rows.length > 0);
+  return { tables, degraded: true };
+}
 function shiftUtcDate(dateISO, days) {
   const [y, m, d] = dateISO.slice(0, 10).split("-").map(Number);
   return new Date(Date.UTC(y ?? 1970, (m ?? 1) - 1, (d ?? 1) + days)).toISOString().slice(0, 10);
@@ -3402,11 +3460,53 @@ function formatShareSnippet(input, options = {}) {
       blocks.push(card.join("\n"));
     }
   }
+  if (input.degraded && input.matches.length > 0) {
+    blocks.push("(Live data unavailable \u2014 showing the bundled schedule, not live scores.)");
+  }
+  blocks.push(
+    shareFooter({
+      source: input.source,
+      installLine: input.installLine,
+      includeHashtag,
+      includeInstall
+    })
+  );
+  return blocks.join("\n\n");
+}
+function shareFooter(opts) {
   const footer = [];
-  if (input.source) footer.push(`Live data: ${liveSourceLabel(input.source)}`);
-  footer.push([includeHashtag ? SHARE_HASHTAG : "", SHARE_DISCLAIMER].filter(Boolean).join(" \xB7 "));
-  if (includeInstall && input.installLine) footer.push(`Try it: ${input.installLine}`);
-  blocks.push(footer.join("\n"));
+  if (opts.source) footer.push(`Live data: ${liveSourceLabel(opts.source)}`);
+  footer.push(
+    [opts.includeHashtag ? SHARE_HASHTAG : "", SHARE_DISCLAIMER].filter(Boolean).join(" \xB7 ")
+  );
+  if (opts.includeInstall && opts.installLine) footer.push(`Try it: ${opts.installLine}`);
+  return footer.join("\n");
+}
+function gd(n) {
+  return n > 0 ? `+${n}` : `${n}`;
+}
+function tableRow(r, rank) {
+  return `${rank}. ${r.team.flag} ${r.team.code}  ${r.points} pts \xB7 ${r.won}-${r.drawn}-${r.lost} \xB7 ${gd(r.goalDiff)}`;
+}
+function formatShareTable(input, options = {}) {
+  const includeHashtag = options.includeHashtag !== false;
+  const includeInstall = options.includeInstallLine !== false;
+  const blocks = [];
+  if (input.tables.length === 0) {
+    blocks.push(input.emptyNote ?? "No standings available.");
+  } else {
+    for (const { group, rows } of input.tables) {
+      blocks.push(
+        [`Group ${group} \xB7 standings`, "", ...rows.map((r, i) => tableRow(r, i + 1))].join("\n")
+      );
+    }
+    if (input.degraded) {
+      blocks.push("(Live standings unavailable \u2014 group roster, not live results.)");
+    }
+  }
+  blocks.push(
+    shareFooter({ source: input.source, installLine: input.installLine, includeHashtag, includeInstall })
+  );
   return blocks.join("\n\n");
 }
 
@@ -3460,11 +3560,15 @@ var EN = {
   "today.none": "No matches scheduled for this date.",
   "live.title": "Live now",
   "live.none": "No matches in play right now.",
+  "live.degraded": "Live scores unavailable right now \u2014 couldn't reach the data provider.",
+  "feed.degraded": "Live scores unavailable \u2014 showing the bundled schedule.",
   "next.none": "No upcoming fixture found for {team}.",
   "next.label": "Next up for {team}",
   "next.in": "in {countdown}",
   "table.title": "Group {group}",
   "table.none": "No group found for {group}.",
+  "table.degraded": "Live standings unavailable \u2014 showing the group roster.",
+  "table.empty": "No standings available.",
   "match.none": "No match found with id {id}.",
   "status.scheduled": "scheduled",
   "status.live": "LIVE",
@@ -3490,11 +3594,15 @@ var ES = {
   "today.none": "No hay partidos para esta fecha.",
   "live.title": "En vivo",
   "live.none": "No hay partidos en juego ahora mismo.",
+  "live.degraded": "Marcadores en vivo no disponibles \u2014 no se pudo conectar con el proveedor de datos.",
+  "feed.degraded": "Marcadores en vivo no disponibles \u2014 mostrando el calendario.",
   "next.none": "No se encontr\xF3 pr\xF3ximo partido para {team}.",
   "next.label": "Pr\xF3ximo partido de {team}",
   "next.in": "en {countdown}",
   "table.title": "Grupo {group}",
   "table.none": "No se encontr\xF3 el grupo {group}.",
+  "table.degraded": "Tabla en vivo no disponible \u2014 mostrando la lista del grupo.",
+  "table.empty": "No hay clasificaci\xF3n disponible.",
   "match.none": "No se encontr\xF3 partido con id {id}.",
   "status.scheduled": "programado",
   "status.live": "EN VIVO",
@@ -3520,11 +3628,15 @@ var PT = {
   "today.none": "Nenhum jogo para esta data.",
   "live.title": "Ao vivo",
   "live.none": "Nenhum jogo em andamento agora.",
+  "live.degraded": "Placar ao vivo indispon\xEDvel \u2014 n\xE3o foi poss\xEDvel conectar ao provedor de dados.",
+  "feed.degraded": "Placar ao vivo indispon\xEDvel \u2014 mostrando a tabela de jogos.",
   "next.none": "Nenhum pr\xF3ximo jogo encontrado para {team}.",
   "next.label": "Pr\xF3ximo jogo de {team}",
   "next.in": "em {countdown}",
   "table.title": "Grupo {group}",
   "table.none": "Grupo {group} n\xE3o encontrado.",
+  "table.degraded": "Classifica\xE7\xE3o ao vivo indispon\xEDvel \u2014 mostrando os times do grupo.",
+  "table.empty": "Classifica\xE7\xE3o indispon\xEDvel.",
   "match.none": "Nenhum jogo encontrado com id {id}.",
   "status.scheduled": "agendado",
   "status.live": "AO VIVO",
@@ -3550,11 +3662,15 @@ var FR = {
   "today.none": "Aucun match pr\xE9vu pour cette date.",
   "live.title": "En direct",
   "live.none": "Aucun match en cours pour l'instant.",
+  "live.degraded": "Scores en direct indisponibles \u2014 impossible de joindre le fournisseur de donn\xE9es.",
+  "feed.degraded": "Scores en direct indisponibles \u2014 affichage du calendrier.",
   "next.none": "Aucun prochain match trouv\xE9 pour {team}.",
   "next.label": "Prochain match de {team}",
   "next.in": "dans {countdown}",
   "table.title": "Groupe {group}",
   "table.none": "Groupe {group} introuvable.",
+  "table.degraded": "Classement en direct indisponible \u2014 affichage de la composition du groupe.",
+  "table.empty": "Aucun classement disponible.",
   "match.none": "Aucun match trouv\xE9 avec id {id}.",
   "status.scheduled": "pr\xE9vu",
   "status.live": "DIRECT",
@@ -4191,6 +4307,7 @@ async function cmdToday(date, ctx) {
     }
   }
   out();
+  if (degraded) out(c.dim("  " + t("feed.degraded")));
   const src = dataSource(source, c);
   if (src) out(src);
   out(disclaimer(t, c));
@@ -4208,7 +4325,9 @@ async function cmdLive(ctx) {
   out();
   out(header(t("live.title"), c));
   out();
-  if (matches.length === 0) {
+  if (degraded) {
+    out(c.dim("  " + t("live.degraded")));
+  } else if (matches.length === 0) {
     out(c.dim("  " + t("live.none")));
   } else {
     for (const m of matches) out(matchLine(m, cfg, t, c));
@@ -4218,10 +4337,10 @@ async function cmdLive(ctx) {
   if (src) out(src);
   out(disclaimer(t, c));
 }
-async function cmdNext(team, { cfg, t }) {
+async function cmdNext(team, { cfg, t, now }) {
   precheck(cfg, t);
   const code = resolveTeamArg(team, "Usage: claudinho next <team> (or set CLAUDINHO_TEAM)");
-  const fixture = nextFixtureForTeam(code);
+  const fixture = nextFixtureForTeam(code, { from: now ?? /* @__PURE__ */ new Date() });
   if (cfg.json) {
     emitJson({ team: code, fixture: fixture ?? null });
     return;
@@ -4248,32 +4367,30 @@ async function cmdNext(team, { cfg, t }) {
 async function cmdTable(group, ctx) {
   const { cfg, t } = ctx;
   precheck(cfg, t);
-  const adapter = adapterFor(ctx);
-  const { matches, degraded, source } = await getMatchesForDate(
-    adapter,
-    localDate((/* @__PURE__ */ new Date()).toISOString(), cfg.tz)
-  );
-  const wanted = group ? [group.toUpperCase()] : groups(matches);
+  const { tables, degraded, source } = await getStandings(adapterFor(ctx), group);
   if (cfg.json) {
-    const tables = wanted.map((g) => ({
-      group: g,
-      standings: computeStandings(fixturesByGroup(g, matches))
-    }));
+    const json = tables.map((tb) => ({ group: tb.group, standings: tb.rows }));
     emitJson({
       degraded,
       source: source ?? null,
-      tables: group ? tables[0] ?? null : tables
+      tables: group ? json[0] ?? null : json
     });
     return;
   }
   const c = painterFor(cfg);
-  for (const g of wanted) {
-    const rows = computeStandings(fixturesByGroup(g, matches));
-    if (rows.length === 0) {
-      out();
-      out(c.dim("  " + t("table.none", { group: g })));
-      continue;
-    }
+  if (tables.length === 0) {
+    out();
+    out(
+      c.dim(
+        "  " + (group ? t("table.none", { group: group.toUpperCase() }) : t("table.empty"))
+      )
+    );
+    out();
+    if (degraded) out(c.dim("  " + t("table.degraded")));
+    out(disclaimer(t, c));
+    return;
+  }
+  for (const { group: g, rows } of tables) {
     out();
     out(header(t("table.title", { group: g }), c));
     const table = new Table({
@@ -4303,6 +4420,7 @@ async function cmdTable(group, ctx) {
     out(table.toString());
   }
   out();
+  if (degraded) out(c.dim("  " + t("table.degraded")));
   const src = dataSource(source, c);
   if (src) out(src);
   out(disclaimer(t, c));
@@ -4398,6 +4516,7 @@ async function cmdMatch(id, ctx) {
     for (const mline of marketBlock(marketSignal, match)) out("  " + c.dim(mline));
   }
   out();
+  if (degraded) out(c.dim("  " + t("feed.degraded")));
   const src = dataSource(liveSource, c);
   if (src) out(src);
   out(disclaimer(t, c));
@@ -4525,6 +4644,7 @@ function emitShare(ctx, e, copy) {
       target: e.target,
       ...e.team ? { team: e.team } : {},
       source: e.input.source ?? null,
+      degraded: e.input.degraded ?? false,
       informationalOnly: true,
       style: e.options.style ?? "social",
       snippet,
@@ -4541,6 +4661,38 @@ function emitShare(ctx, e, copy) {
     );
   }
 }
+function emitShareTable(ctx, e, copy) {
+  const snippet = formatShareTable(
+    {
+      tables: e.tables,
+      source: e.source,
+      installLine: e.installLine,
+      emptyNote: e.emptyNote,
+      degraded: e.degraded
+    },
+    e.options
+  );
+  if (ctx.cfg.json) {
+    emitJson({
+      kind: "table",
+      target: "table",
+      ...e.group ? { group: e.group } : {},
+      source: e.source ?? null,
+      degraded: e.degraded,
+      informationalOnly: true,
+      snippet,
+      tables: e.tables.map((tb) => ({ group: tb.group, standings: tb.rows }))
+    });
+  } else {
+    out(snippet);
+  }
+  if (copy) {
+    const ok = (ctx.copy ?? copyToClipboard)(snippet);
+    process.stderr.write(
+      (ok ? "Copied share snippet to clipboard." : "Clipboard unavailable; printed snippet instead.") + "\n"
+    );
+  }
+}
 async function cmdShare(target, team, opts, ctx) {
   const { cfg, t } = ctx;
   const baseOptions = {
@@ -4552,7 +4704,7 @@ async function cmdShare(target, team, opts, ctx) {
   const copy = opts.copy === true;
   if (target === "live") {
     precheck(cfg, t);
-    const { matches, source: source2 } = await getLiveMatches(adapterFor(ctx));
+    const { matches, degraded: degraded2, source: source2 } = await getLiveMatches(adapterFor(ctx));
     emitShare(
       ctx,
       {
@@ -4562,7 +4714,9 @@ async function cmdShare(target, team, opts, ctx) {
           title: "Live match pulse",
           matches,
           source: source2,
-          emptyNote: "No matches in play right now.",
+          degraded: degraded2,
+          // Degraded ⇒ feed down, not "nothing's on" — say so on the public card.
+          emptyNote: degraded2 ? "Live scores unavailable right now \u2014 couldn't reach the data provider." : "No matches in play right now.",
           installLine: "npx @claudinho/cli live",
           tz: cfg.tz,
           locale: cfg.lang
@@ -4574,10 +4728,30 @@ async function cmdShare(target, team, opts, ctx) {
     );
     return;
   }
+  if (target === "table") {
+    precheck(cfg, t);
+    const group = team?.toUpperCase();
+    const { tables, degraded: degraded2, source: source2 } = await getStandings(adapterFor(ctx), group);
+    emitShareTable(
+      ctx,
+      {
+        group,
+        tables,
+        // Degraded ⇒ a static roster, served by no live provider: no attribution.
+        source: degraded2 ? void 0 : source2,
+        degraded: degraded2,
+        installLine: group ? `npx @claudinho/cli table ${group}` : "npx @claudinho/cli table",
+        emptyNote: group ? `No group ${group}.` : "No standings available.",
+        options: baseOptions
+      },
+      copy
+    );
+    return;
+  }
   if (target === "next") {
     precheck(cfg, t);
     const code = resolveTeamArg(team, "Usage: claudinho share next <team> (or set CLAUDINHO_TEAM)");
-    const fixture = nextFixtureForTeam(code);
+    const fixture = nextFixtureForTeam(code, { from: ctx.now ?? /* @__PURE__ */ new Date() });
     const matches = fixture ? [fixture] : [];
     const signals2 = await reliableShareSignals(ctx, matches);
     const teamName = fixture ? fixture.home.code === code ? fixture.home.name : fixture.away.name : code;
@@ -4604,7 +4778,7 @@ async function cmdShare(target, team, opts, ctx) {
   }
   if (target && target !== "today" && !isValidDate(target)) {
     precheck(cfg, t);
-    const { match, source: source2 } = await getMatchById(adapterFor(ctx), target);
+    const { match, degraded: degraded2, source: source2 } = await getMatchById(adapterFor(ctx), target);
     const matches = match ? [match] : [];
     const signals2 = await reliableShareSignals(ctx, matches);
     emitShare(
@@ -4617,6 +4791,7 @@ async function cmdShare(target, team, opts, ctx) {
           matches,
           marketSignals: signals2,
           source: source2,
+          degraded: degraded2,
           emptyNote: `No match found with id ${target}.`,
           installLine: `npx @claudinho/cli match ${target}`,
           tz: cfg.tz,
@@ -4631,7 +4806,7 @@ async function cmdShare(target, team, opts, ctx) {
   const explicitDate = target && target !== "today" ? target : void 0;
   precheck(cfg, t, explicitDate);
   const date = explicitDate ?? localDate((/* @__PURE__ */ new Date()).toISOString(), cfg.tz);
-  const { matches: all, source } = await getMatchesForDate(adapterFor(ctx), date);
+  const { matches: all, degraded, source } = await getMatchesForDate(adapterFor(ctx), date);
   const todays = fixturesByDate(date, all, cfg.tz);
   const signals = await reliableShareSignals(ctx, todays);
   const human = formatDate(`${date}T12:00:00.000Z`, { tz: cfg.tz, locale: cfg.lang });
@@ -4646,6 +4821,7 @@ async function cmdShare(target, team, opts, ctx) {
         matches: todays,
         marketSignals: signals,
         source,
+        degraded,
         emptyNote: `No matches scheduled for ${human}.`,
         installLine: "npx @claudinho/cli today",
         tz: cfg.tz,
@@ -4726,7 +4902,7 @@ function handlePipeError(stream) {
 }
 handlePipeError(process.stdout);
 handlePipeError(process.stderr);
-var VERSION = "0.4.3";
+var VERSION = "0.5.1";
 var DISCLAIMER = "Claudinho is an independent fan project. Not affiliated with or endorsed by FIFA or Anthropic.";
 function ctxFrom(cmd) {
   const root = cmd.parent ?? cmd;
@@ -4787,7 +4963,10 @@ program.command("markets").description("show prediction-market signals (read-onl
     fail(e);
   }
 });
-program.command("share").description("print a shareable, copy-pasteable match snippet (#VibingLaVidaLoca)").argument("[target]", '"today" (default), "live", a date, a match id, or "next"').argument("[team]", 'team code when target is "next" (default: $CLAUDINHO_TEAM)').option("--style <style>", "snippet style: social (default) or compact").option("--copy", "also copy the snippet to the clipboard (best-effort)").option("--no-hashtag", "omit the #VibingLaVidaLoca tag").option("--no-install-line", "omit the install/run cue").action(async (target, team, opts, cmd) => {
+program.command("share").description("print a shareable, copy-pasteable match snippet (#VibingLaVidaLoca)").argument("[target]", '"today" (default), "live", a date, a match id, "next", or "table"').argument(
+  "[team]",
+  'team code for "next" (default: $CLAUDINHO_TEAM), or group letter for "table" (omit for all groups)'
+).option("--style <style>", "snippet style: social (default) or compact").option("--copy", "also copy the snippet to the clipboard (best-effort)").option("--no-hashtag", "omit the #VibingLaVidaLoca tag").option("--no-install-line", "omit the install/run cue").action(async (target, team, opts, cmd) => {
   try {
     await cmdShare(target, team, opts, ctxFrom(cmd));
   } catch (e) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@claudinho/cli",
-  "version": "0.4.3",
+  "version": "0.5.1",
   "description": "Live scores, fixtures, group tables, and read-only prediction-market signals for the 2026 men's football tournament — in your terminal and Claude Code statusline. No API keys. Not affiliated with FIFA or Anthropic.",
   "type": "module",
   "license": "MIT",
@@ -56,7 +56,7 @@
     "tsup": "^8.0.0",
     "typescript": "^5.7.0",
     "vitest": "^4.1.0",
-    "@claudinho/core": "0.4.3"
+    "@claudinho/core": "0.5.1"
   },
   "scripts": {
     "build": "tsup",