@claudinho/cli 0.8.16 → 0.8.18

package/README.md

@@ -35,10 +35,11 @@ All 104 fixtures ship bundled, so the schedule works offline; only live scores h
 ```bash
 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 next [TEAM]       # a team's next fixture + countdown — TEAM is a name OR code (Mexico | MEX | "DR Congo"); default $CLAUDINHO_TEAM
 claudinho table [GROUP]     # live cumulative group standings (default: all groups)
 claudinho bracket [STAGE]   # knockout bracket (R32, R16, QF, SF, 3P, F); --tree for ASCII tree
 claudinho match <id>        # a single match's detail
+claudinho team <query>      # resolve a name/code to its FIFA code, flag, and group (e.g. team "DR Congo")
 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 snippet: today | live | <date> | <id> | next <TEAM> | table <GROUP> | bracket [STAGE]

package/dist/index.js

@@ -2808,6 +2808,60 @@ function groups(fixtures = SCHEDULE) {
   for (const m of fixtures) if (m.group) set.add(m.group);
   return [...set].sort();
 }
+function norm2(s) {
+  return s.toLowerCase().normalize("NFD").replace(/[̀-ͯ]/g, "").replace(/[^a-z]/g, "");
+}
+function allTeams(fixtures = allFixtures()) {
+  const seen = /* @__PURE__ */ new Map();
+  for (const m of fixtures) {
+    if (m.stage !== "GROUP") continue;
+    for (const t2 of [m.home, m.away]) {
+      if (!/^[A-Z]{3}$/.test(t2.code) || t2.flag === "\u{1F3F3}\uFE0F") continue;
+      if (!seen.has(t2.code)) seen.set(t2.code, { ...t2, group: m.group ?? void 0 });
+    }
+  }
+  return [...seen.values()].sort((a, b) => a.name.localeCompare(b.name));
+}
+var TEAM_ALIASES = {
+  turkey: "TUR",
+  holland: "NED",
+  korea: "KOR",
+  skorea: "KOR",
+  korearepublic: "KOR",
+  republicofkorea: "KOR",
+  czechrepublic: "CZE",
+  congo: "COD",
+  drcongo: "COD",
+  drc: "COD",
+  democraticrepublicofcongo: "COD",
+  democraticrepublicofthecongo: "COD",
+  cotedivoire: "CIV",
+  caboverde: "CPV",
+  bosnia: "BIH",
+  bosniaandherzegovina: "BIH",
+  us: "USA",
+  america: "USA",
+  unitedstatesofamerica: "USA"
+};
+function lookupTeam(query, fixtures = allFixtures()) {
+  const roster = allTeams(fixtures);
+  const q = norm2(query);
+  if (!q) return { query, team: null, matches: [] };
+  const byCode = roster.find((t2) => norm2(t2.code) === q);
+  if (byCode) return { query, team: byCode, matches: [byCode] };
+  const byName = roster.find((t2) => norm2(t2.name) === q);
+  if (byName) return { query, team: byName, matches: [byName] };
+  const aliasCode = TEAM_ALIASES[q];
+  if (aliasCode) {
+    const t2 = roster.find((r) => r.code === aliasCode);
+    if (t2) return { query, team: t2, matches: [t2] };
+  }
+  if (q.length < 3) return { query, team: null, matches: [] };
+  const prefix = roster.filter((t2) => norm2(t2.name).startsWith(q));
+  const substr = roster.filter((t2) => norm2(t2.name).includes(q) && !prefix.includes(t2));
+  const matches = [...prefix, ...substr];
+  return { query, team: matches.length === 1 ? matches[0] : null, matches };
+}
 function blankRow(team) {
   return {
     team,
@@ -4149,7 +4203,8 @@ var PolymarketProvider = class {
   opts;
   name = "polymarket";
   async findSignal(match, options) {
-    return (await this.resolveOne(match, options)).signal;
+    const deadline = options?.deadlineMs != null ? Date.now() + options.deadlineMs : Number.POSITIVE_INFINITY;
+    return (await this.resolveOne(match, options, deadline)).signal;
   }
   async findSignals(matches, options) {
     const signals = /* @__PURE__ */ new Map();
@@ -4157,7 +4212,7 @@ var PolymarketProvider = class {
     const deadline = options?.deadlineMs != null ? Date.now() + options.deadlineMs : Number.POSITIVE_INFINITY;
     for (const m of matches) {
       if (Date.now() >= deadline) break;
-      const r = await this.resolveOne(m, options);
+      const r = await this.resolveOne(m, options, deadline);
       if (r.checked) checked.add(m.id);
       if (r.signal) signals.set(m.id, r.signal);
     }
@@ -4169,13 +4224,16 @@ var PolymarketProvider = class {
    * provider/network error — so transient failures are retried, not
    * negative-cached.
    */
-  async resolveOne(match, options) {
+  async resolveOne(match, options, deadline = Number.POSITIVE_INFINITY) {
     const entry = (this.opts.mapping ?? BUNDLED_MAPPING)[match.id];
     const slugs = entry?.eventSlug ? [entry.eventSlug] : deriveEventSlugs(match);
     if (slugs.length === 0) return { checked: true };
+    const configured = options?.timeoutMs ?? this.opts.timeoutMs ?? DEFAULT_TIMEOUT_MS;
     try {
       for (const slug of slugs) {
-        const event = await this.fetchEvent(slug, options?.timeoutMs);
+        const remaining = deadline - Date.now();
+        if (remaining <= 0) return { checked: false };
+        const event = await this.fetchEvent(slug, Math.min(configured, remaining));
         const signal = event ? this.toSignal(match, slug, event, options) : void 0;
         if (signal) return { signal, checked: true };
       }
@@ -4255,6 +4313,27 @@ var PolymarketProvider = class {
     return signal.ambiguous ? void 0 : signal;
   }
 };
+var POLYMARKET_TOKEN = {
+  SUI: "che",
+  // Switzerland
+  NED: "nld",
+  // Netherlands
+  URU: "ury",
+  // Uruguay
+  POR: "prt",
+  // Portugal
+  CRO: "hrv",
+  // Croatia
+  COD: "cdr",
+  // DR Congo
+  CPV: "cvi"
+  // Cabo Verde
+};
+function pmTokens(code) {
+  const c = code.toLowerCase();
+  const alias = POLYMARKET_TOKEN[code.toUpperCase()];
+  return alias && alias !== c ? [alias, c] : [c];
+}
 function deriveEventSlugs(match) {
   const home = match.home.code.toLowerCase();
   const away = match.away.code.toLowerCase();
@@ -4262,10 +4341,18 @@ function deriveEventSlugs(match) {
   if (!/^[a-z]{3}$/.test(home) || !/^[a-z]{3}$/.test(away)) return [];
   const utcDate = match.kickoff.slice(0, 10);
   if (!/^\d{4}-\d{2}-\d{2}$/.test(utcDate)) return [];
-  return [
-    `fifwc-${home}-${away}-${utcDate}`,
-    `fifwc-${home}-${away}-${shiftUtcDate(utcDate, -1)}`
-  ];
+  const dates = [utcDate, shiftUtcDate(utcDate, -1)];
+  const homeToks = pmTokens(match.home.code);
+  const awayToks = pmTokens(match.away.code);
+  const slugs = [];
+  for (const d of dates) {
+    for (const h of homeToks) {
+      for (const a of awayToks) {
+        slugs.push(`fifwc-${h}-${a}-${d}`);
+      }
+    }
+  }
+  return [...new Set(slugs)];
 }
 function slugToken(m) {
   return (m.slug ?? "").toLowerCase().split("-").pop() ?? "";
@@ -4274,10 +4361,10 @@ function isDrawMarket(m) {
   return slugToken(m) === "draw" || (m.groupItemTitle ?? "").trim().toLowerCase().startsWith("draw");
 }
 function pickMarket(markets, teamCode, teamName) {
-  const code = teamCode.toLowerCase();
+  const tokens = pmTokens(teamCode);
   const name = teamName.trim().toLowerCase();
   const teamMarkets = markets.filter((m) => !isDrawMarket(m));
-  const bySlug = teamMarkets.find((m) => slugToken(m) === code);
+  const bySlug = teamMarkets.find((m) => tokens.includes(slugToken(m)));
   if (bySlug) return bySlug;
   return teamMarkets.find((m) => (m.groupItemTitle ?? "").trim().toLowerCase() === name);
 }
@@ -4657,6 +4744,10 @@ var EN2 = {
   "next.none": "No upcoming fixture found for {team}.",
   "next.label": "Next up for {team}",
   "next.in": "in {countdown}",
+  "team.group": "Group {group}",
+  "team.ambiguous": '"{query}" is ambiguous. Did you mean:',
+  "team.none": 'No team found for "{query}". Try a nation name or 3-letter code (e.g. Mexico, MEX).',
+  "team.usage": "Usage: claudinho team <name or code> (e.g. claudinho team Mexico)",
   "table.title": "Group {group}",
   "table.none": "No group found for {group}.",
   "table.degraded": "Live standings unavailable \u2014 showing the group roster.",
@@ -4691,6 +4782,10 @@ var ES2 = {
   "next.none": "No se encontr\xF3 pr\xF3ximo partido para {team}.",
   "next.label": "Pr\xF3ximo partido de {team}",
   "next.in": "en {countdown}",
+  "team.group": "Grupo {group}",
+  "team.ambiguous": '"{query}" es ambiguo. \xBFQuisiste decir:',
+  "team.none": 'No se encontr\xF3 ning\xFAn equipo para "{query}". Prueba un nombre de pa\xEDs o un c\xF3digo de 3 letras (p. ej. Mexico, MEX).',
+  "team.usage": "Uso: claudinho team <nombre o c\xF3digo> (p. ej. claudinho team Mexico)",
   "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.",
@@ -4725,6 +4820,10 @@ var PT2 = {
   "next.none": "Nenhum pr\xF3ximo jogo encontrado para {team}.",
   "next.label": "Pr\xF3ximo jogo de {team}",
   "next.in": "em {countdown}",
+  "team.group": "Grupo {group}",
+  "team.ambiguous": '"{query}" \xE9 amb\xEDguo. Voc\xEA quis dizer:',
+  "team.none": 'Nenhuma sele\xE7\xE3o encontrada para "{query}". Tente um nome de pa\xEDs ou um c\xF3digo de 3 letras (ex. Mexico, MEX).',
+  "team.usage": "Uso: claudinho team <nome ou c\xF3digo> (ex. claudinho team Mexico)",
   "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.",
@@ -4759,6 +4858,10 @@ var FR2 = {
   "next.none": "Aucun prochain match trouv\xE9 pour {team}.",
   "next.label": "Prochain match de {team}",
   "next.in": "dans {countdown}",
+  "team.group": "Groupe {group}",
+  "team.ambiguous": '"{query}" est ambigu. Vouliez-vous dire :',
+  "team.none": 'Aucune \xE9quipe trouv\xE9e pour "{query}". Essayez un nom de pays ou un code \xE0 3 lettres (p. ex. Mexico, MEX).',
+  "team.usage": "Usage : claudinho team <nom ou code> (p. ex. claudinho team Mexico)",
   "table.title": "Groupe {group}",
   "table.none": "Groupe {group} introuvable.",
   "table.degraded": "Classement en direct indisponible \u2014 affichage de la composition du groupe.",
@@ -5563,9 +5666,17 @@ function precheck(cfg, t2, date) {
   }
 }
 function resolveTeamArg(team, usage) {
-  const code = team ?? process.env.CLAUDINHO_TEAM;
-  if (!code) throw new InputError(usage);
-  return code.toUpperCase();
+  const raw = team ?? process.env.CLAUDINHO_TEAM;
+  if (!raw) throw new InputError(usage);
+  const { team: hit, matches } = lookupTeam(raw);
+  if (hit) return hit.code;
+  if (matches.length > 1) {
+    throw new InputError(
+      `"${raw}" is ambiguous \u2014 did you mean ${matches.map((m) => `${m.name} (${m.code})`).join(", ")}? Use the 3-letter code.`
+    );
+  }
+  if (/^[A-Za-z]{3}$/.test(raw)) return raw.toUpperCase();
+  throw new InputError(`No team found for "${raw}". Use a nation name or 3-letter code (e.g. Mexico, MEX).`);
 }
 async function cmdToday(date, ctx) {
   const { cfg, t: t2 } = ctx;
@@ -5671,6 +5782,37 @@ async function cmdNext(team, ctx) {
   out(disclaimer(t2, c));
   maybeStarNudge(ctx);
 }
+function cmdTeam(query, ctx) {
+  const { cfg, t: t2 } = ctx;
+  precheck(cfg, t2);
+  const q = (query ?? "").trim();
+  const { team, matches } = lookupTeam(q);
+  if (cfg.json) {
+    emitJson({ query: q, team: team ?? null, matches, count: matches.length });
+    return;
+  }
+  const c = painterFor(cfg);
+  const flags = flagsEnabled();
+  const label = (tm) => {
+    const flag = flags ? `${tm.flag} ` : "";
+    const grp = tm.group ? ` \xB7 ${t2("team.group", { group: tm.group })}` : "";
+    return `  ${flag}${c.bold(tm.name)}  ${c.dim(tm.code + grp)}`;
+  };
+  out();
+  if (!q) {
+    out("  " + c.dim(t2("team.usage")));
+  } else if (team) {
+    out(label(team));
+  } else if (matches.length > 0) {
+    out("  " + c.dim(t2("team.ambiguous", { query: q })));
+    for (const m of matches) out(label(m));
+  } else {
+    out("  " + c.dim(t2("team.none", { query: q })));
+  }
+  out();
+  out(disclaimer(t2, c));
+  maybeStarNudge(ctx);
+}
 async function cmdTable(group, ctx) {
   const { cfg, t: t2 } = ctx;
   precheck(cfg, t2);
@@ -6423,7 +6565,7 @@ function handlePipeError(stream) {
 }
 handlePipeError(process.stdout);
 handlePipeError(process.stderr);
-var VERSION = "0.8.16";
+var VERSION = "0.8.18";
 var DISCLAIMER = "Claudinho is an independent fan project. Not affiliated with or endorsed by FIFA or Anthropic.";
 function ctxFrom(cmd) {
   let root = cmd;
@@ -6457,13 +6599,20 @@ program.command("live").description("show matches in play right now").action(asy
     fail(e);
   }
 });
-program.command("next").description("show a team's next fixture").argument("[team]", "team code, e.g. MEX (default: $CLAUDINHO_TEAM)").action(async (team, _opts, cmd) => {
+program.command("next").description("show a team's next fixture").argument("[team]", "team name or code, e.g. Mexico or MEX (default: $CLAUDINHO_TEAM)").action(async (team, _opts, cmd) => {
   try {
     await cmdNext(team, ctxFrom(cmd));
   } catch (e) {
     fail(e);
   }
 });
+program.command("team").description("resolve a nation name or code to its FIFA code, flag, and group").argument("<query>", 'team name or 3-letter code, e.g. Mexico, MEX, "DR Congo"').action((query, _opts, cmd) => {
+  try {
+    cmdTeam(query, ctxFrom(cmd));
+  } catch (e) {
+    fail(e);
+  }
+});
 program.command("table").description("show group standings (default: all groups)").argument("[group]", "group letter A-L").action(async (group, _opts, cmd) => {
   try {
     await cmdTable(group, ctxFrom(cmd));
@@ -6485,7 +6634,7 @@ program.command("match").description("show a single match by id").argument("<id>
     fail(e);
   }
 });
-program.command("markets").description("show prediction-market signals (read-only, informational only)").argument("[target]", 'date (YYYY-MM-DD), match id, "today", or "next"').argument("[team]", 'team code when target is "next" (default: $CLAUDINHO_TEAM)').action(async (target, team, _opts, cmd) => {
+program.command("markets").description("show prediction-market signals (read-only, informational only)").argument("[target]", 'date (YYYY-MM-DD), match id, "today", or "next"').argument("[team]", 'team name or code when target is "next", e.g. Mexico or MEX (default: $CLAUDINHO_TEAM)').action(async (target, team, _opts, cmd) => {
   try {
     await cmdMarkets(target, team, ctxFrom(cmd));
   } catch (e) {
@@ -6494,7 +6643,7 @@ program.command("markets").description("show prediction-market signals (read-onl
 });
 program.command("share").description("print a shareable, copy-pasteable match snippet (#VibingLaVidaLoca)").argument("[target]", '"today" (default), "live", a date, a match id, "next", "table", or "bracket"').argument(
   "[team]",
-  'team code for "next" (default: $CLAUDINHO_TEAM), group letter for "table", or stage for "bracket"'
+  'team name or code for "next" (default: $CLAUDINHO_TEAM), group letter for "table", or stage for "bracket"'
 ).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));

package/package.json

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