@claudinho/cli 0.4.3 → 0.5.0

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,50 @@ function formatShareSnippet(input, options = {}) {
       blocks.push(card.join("\n"));
     }
   }
+  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");
 }
 
@@ -3465,6 +3562,8 @@ var EN = {
   "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",
@@ -3495,6 +3594,8 @@ var ES = {
   "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",
@@ -3525,6 +3626,8 @@ var PT = {
   "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",
@@ -3555,6 +3658,8 @@ var FR = {
   "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",
@@ -4218,10 +4323,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 +4353,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 +4406,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));
@@ -4541,6 +4645,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 = {
@@ -4574,10 +4710,30 @@ async function cmdShare(target, team, opts, ctx) {
     );
     return;
   }
+  if (target === "table") {
+    precheck(cfg, t);
+    const group = team?.toUpperCase();
+    const { tables, degraded, source: source2 } = await getStandings(adapterFor(ctx), group);
+    emitShareTable(
+      ctx,
+      {
+        group,
+        tables,
+        // Degraded ⇒ a static roster, served by no live provider: no attribution.
+        source: degraded ? void 0 : source2,
+        degraded,
+        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;
@@ -4726,7 +4882,7 @@ function handlePipeError(stream) {
 }
 handlePipeError(process.stdout);
 handlePipeError(process.stderr);
-var VERSION = "0.4.3";
+var VERSION = "0.5.0";
 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 +4943,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.0",
   "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.0"
   },
   "scripts": {
     "build": "tsup",