@claudinho/cli 0.8.17 → 0.8.19

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]
@@ -185,7 +186,7 @@ The statusline reads from a local micro-cache and **never blocks on the
 network** (<150ms). When several matches are live it shows them all inline:
 `⚽ 🇳🇴 1–1 🇫🇷 87' · 🇸🇳 1–2 🇮🇶 86'`. Customize via env:
 
-- `CLAUDINHO_TEAM=MEX` — show only your team's match; also the default team for `next`, `markets next`, and `share next` when the argument is omitted
+- `CLAUDINHO_TEAM=MEX` — show only your team's match (a nation name works too, e.g. `CLAUDINHO_TEAM=mexico`); also the default team for `next`, `markets next`, and `share next` when the argument is omitted
 - `CLAUDINHO_MAX=2` — cap how many live matches show inline (rest collapse to `+N`; default: all)
 - `CLAUDINHO_COMPACT=0` — show 3-letter codes alongside flags
 - `CLAUDINHO_FLAGS=off` — drop emoji flags for 3-letter codes (statusline) / plain names (`today`, `live`, `table`, `next`, hook); already automatic on terminals that can't render flag emoji, e.g. Warp

package/dist/index.js

@@ -500,6 +500,63 @@ 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);
 }
+var FEED_TEXT_MAX = 100;
+function sanitizeFeedText(value, max = FEED_TEXT_MAX) {
+  let out2 = "";
+  let count = 0;
+  for (const ch of String(value)) {
+    const cp = ch.codePointAt(0) ?? 0;
+    const isWhitespaceControl = cp === 9 || cp === 10 || cp === 13;
+    if ((cp <= 31 || cp >= 127 && cp <= 159) && !isWhitespaceControl) continue;
+    if (count >= max) break;
+    out2 += isWhitespaceControl ? " " : ch;
+    count++;
+  }
+  return out2;
+}
+function sanitizeTeam(t2) {
+  return {
+    ...t2 ?? {},
+    code: sanitizeFeedText(t2?.code ?? ""),
+    name: sanitizeFeedText(t2?.name ?? ""),
+    flag: sanitizeFeedText(t2?.flag ?? "")
+  };
+}
+function finiteOrUndefined(v) {
+  return typeof v === "number" && Number.isFinite(v) ? v : void 0;
+}
+function sanitizeScorePair(v) {
+  const home = finiteOrUndefined(v?.home);
+  const away = finiteOrUndefined(v?.away);
+  return home !== void 0 && away !== void 0 ? { home, away } : void 0;
+}
+function sanitizeMatchStrings(m) {
+  const score = sanitizeScorePair(m.score);
+  return {
+    ...m,
+    venue: sanitizeFeedText(m.venue ?? ""),
+    city: m.city == null ? m.city : sanitizeFeedText(m.city),
+    country: m.country == null ? m.country : sanitizeFeedText(m.country),
+    home: sanitizeTeam(m.home),
+    away: sanitizeTeam(m.away),
+    score,
+    shootout: score ? sanitizeScorePair(m.shootout) : void 0,
+    minute: finiteOrUndefined(m.minute)
+  };
+}
+var segmenter = new Intl.Segmenter();
+var WIDE_CLUSTER = new RegExp("^(?:\\p{Regional_Indicator}|\\p{Extended_Pictographic})", "u");
+function displayWidth(s) {
+  let w = 0;
+  for (const { segment } of segmenter.segment(s)) {
+    w += WIDE_CLUSTER.test(segment) ? 2 : 1;
+  }
+  return w;
+}
+function padVisible(s, width) {
+  const w = displayWidth(s);
+  return w >= width ? s : s + " ".repeat(width - w);
+}
 function outcomeFromScore(home, away) {
   if (home > away) return "H";
   if (home < away) return "A";
@@ -2808,6 +2865,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,
@@ -2833,6 +2944,7 @@ var ESPN_SOCCER = "https://site.api.espn.com/apis/site/v2/sports/soccer";
 var DEFAULT_COMPETITION = "fifa.world";
 var DEFAULT_BASE = `${ESPN_SOCCER}/${DEFAULT_COMPETITION}`;
 var USER_AGENT = "claudinho/0.0 (+https://github.com/arturogarrido/claudinho)";
+var MAX_RESPONSE_BYTES = 5 * 1024 * 1024;
 function competitionBase(slug) {
   return `${ESPN_SOCCER}/${slug}`;
 }
@@ -2876,9 +2988,15 @@ function toInt(s) {
   return Number.isFinite(n) ? n : void 0;
 }
 function toTeam(t2) {
-  const name = t2?.displayName ?? t2?.name ?? t2?.location ?? t2?.shortDisplayName ?? "TBD";
-  const code = (t2?.abbreviation ?? name.slice(0, 3)).toUpperCase();
-  return { code, name, flag: nationToFlag(t2?.displayName ?? t2?.abbreviation ?? name) };
+  const name = sanitizeFeedText(
+    t2?.displayName ?? t2?.name ?? t2?.location ?? t2?.shortDisplayName ?? "TBD"
+  );
+  const code = sanitizeFeedText(t2?.abbreviation ?? name.slice(0, 3)).toUpperCase();
+  return {
+    code,
+    name,
+    flag: nationToFlag(sanitizeFeedText(t2?.displayName ?? t2?.abbreviation ?? name))
+  };
 }
 function mapEspnEvent(ev, ctx = {}) {
   const comp = ev.competitions?.[0];
@@ -2909,9 +3027,9 @@ function mapEspnEvent(ev, ctx = {}) {
     stage,
     group,
     kickoff: ev.date,
-    venue: comp?.venue?.fullName ?? "",
-    city: comp?.venue?.address?.city || void 0,
-    country: comp?.venue?.address?.country || void 0,
+    venue: sanitizeFeedText(comp?.venue?.fullName ?? ""),
+    city: sanitizeFeedText(comp?.venue?.address?.city ?? "") || void 0,
+    country: sanitizeFeedText(comp?.venue?.address?.country ?? "") || void 0,
     home,
     away,
     score: hasScore ? { home: hs, away: as } : void 0,
@@ -3035,11 +3153,18 @@ var EspnAdapter = class {
     try {
       const res = await doFetch(url, {
         signal: controller.signal,
+        // ESPN never legitimately redirects; following one would sidestep the
+        // fixed-host guarantee, so treat any redirect as a failure (degraded).
+        redirect: "error",
         headers: { Accept: "application/json", "User-Agent": USER_AGENT }
       });
       if (!res.ok) {
         throw new Error(`ESPN request failed: ${res.status} ${res.statusText}`);
       }
+      const length = Number(res.headers?.get?.("content-length"));
+      if (Number.isFinite(length) && length > MAX_RESPONSE_BYTES) {
+        throw new Error(`ESPN response too large: ${length} bytes`);
+      }
       return await res.json();
     } finally {
       clearTimeout(timer);
@@ -4195,12 +4320,19 @@ var PolymarketProvider = class {
     const doFetch = this.opts.fetchImpl ?? fetch;
     const res = await doFetch(url, {
       signal: AbortSignal.timeout(timeoutMs ?? this.opts.timeoutMs ?? DEFAULT_TIMEOUT_MS),
+      // Gamma never legitimately redirects; following one would sidestep the
+      // host allow-list (it only validates the base URL), so reject redirects.
+      redirect: "error",
       headers: { Accept: "application/json", "User-Agent": USER_AGENT2 }
     });
     if (res.status === 404) return void 0;
     if (!res.ok) {
       throw new Error(`Polymarket request failed: ${res.status} ${res.statusText}`);
     }
+    const length = Number(res.headers?.get?.("content-length"));
+    if (Number.isFinite(length) && length > MAX_RESPONSE_BYTES) {
+      throw new Error(`Polymarket response too large: ${length} bytes`);
+    }
     const data = await res.json();
     const event = Array.isArray(data) ? data[0] : data;
     return event && typeof event === "object" ? event : void 0;
@@ -4690,12 +4822,15 @@ 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.",
   "table.empty": "No standings available.",
   "match.none": "No match found with id {id}.",
-  "status.scheduled": "scheduled",
   "status.live": "LIVE",
   "status.ht": "HT",
   "status.ft": "FT",
@@ -4724,12 +4859,15 @@ 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.",
   "table.empty": "No hay clasificaci\xF3n disponible.",
   "match.none": "No se encontr\xF3 partido con id {id}.",
-  "status.scheduled": "programado",
   "status.live": "EN VIVO",
   "status.ht": "DESC",
   "status.ft": "FIN",
@@ -4758,12 +4896,15 @@ 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.",
   "table.empty": "Classifica\xE7\xE3o indispon\xEDvel.",
   "match.none": "Nenhum jogo encontrado com id {id}.",
-  "status.scheduled": "agendado",
   "status.live": "AO VIVO",
   "status.ht": "INT",
   "status.ft": "FIM",
@@ -4792,12 +4933,15 @@ 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.",
   "table.empty": "Aucun classement disponible.",
   "match.none": "Aucun match trouv\xE9 avec id {id}.",
-  "status.scheduled": "pr\xE9vu",
   "status.live": "DIRECT",
   "status.ht": "MT",
   "status.ft": "FIN",
@@ -4820,7 +4964,7 @@ function makeT(lang) {
   const dict = CATALOGS2[lang] ?? EN2;
   return (key, vars) => {
     let s = dict[key] ?? EN2[key] ?? key;
-    if (vars) for (const [k, v] of Object.entries(vars)) s = s.replace(`{${k}}`, v);
+    if (vars) for (const [k, v] of Object.entries(vars)) s = s.replaceAll(`{${k}}`, v);
     return s;
   };
 }
@@ -4879,7 +5023,7 @@ function matchLine(m, cfg, t2, c, flags = true) {
   const home = flags ? `${m.home.flag} ${m.home.name}` : m.home.name;
   const away = flags ? `${m.away.name} ${m.away.flag}` : m.away.name;
   const mid2 = isLive(m.status) || m.status === "FT" ? c.bold(scoreline(m)) : c.dim("vs");
-  const left = `${home.padEnd(22)} ${mid2.padStart(3)}  ${away}`;
+  const left = `${padVisible(home, 22)} ${mid2.padStart(3)}  ${away}`;
   let right = "";
   if (m.status === "SCHEDULED") {
     right = c.dim(
@@ -5148,6 +5292,10 @@ function inLiveWindow(now = Date.now(), fixtures = allFixtures()) {
 function isResolvedFixture(m) {
   return isResolvedNation(m.home) && isResolvedNation(m.away);
 }
+function isMatchShaped(m) {
+  const x = m;
+  return !!x && typeof x === "object" && typeof x.id === "string" && typeof x.kickoff === "string" && !!x.home?.code && !!x.away?.code;
+}
 function nextOverall(now, fixtures = allFixtures()) {
   return [...fixtures].sort(byKickoff).find((m) => Date.parse(m.kickoff) >= now && isResolvedFixture(m));
 }
@@ -5168,7 +5316,7 @@ function liveMatchesFromCache(state, nowMs = Date.now()) {
   const liveArr = fresh && Array.isArray(state?.live) ? state.live : [];
   return liveArr.filter(
     (m) => !!m && typeof m === "object" && isLive(m.status) && !!m.home?.code && !!m.away?.code
-  );
+  ).map(sanitizeMatchStrings);
 }
 function renderPrompt(state, opts = {}) {
   const now = opts.now ?? /* @__PURE__ */ new Date();
@@ -5177,7 +5325,7 @@ function renderPrompt(state, opts = {}) {
   const flags = opts.flags ?? true;
   const team = opts.team?.toUpperCase();
   const live = liveMatchesFromCache(state, nowMs);
-  const cachedFixtures = Array.isArray(state?.fixtures) ? state.fixtures : [];
+  const cachedFixtures = Array.isArray(state?.fixtures) ? state.fixtures.filter(isMatchShaped).map(sanitizeMatchStrings) : [];
   const schedule = cachedFixtures.length ? mergeLive(allFixtures(), cachedFixtures) : void 0;
   if (team) {
     const mine = live.find((m) => m.home?.code === team || m.away?.code === team);
@@ -5210,10 +5358,16 @@ function renderPrompt(state, opts = {}) {
 }
 
 // src/hook.ts
+function rosterPinned(t2) {
+  const { team } = lookupTeam(t2.code);
+  return team ? { ...t2, name: team.name, flag: team.flag } : t2;
+}
 function line(m, flags) {
   const minute = m.status === "HT" ? "half-time" : m.minute ? `${m.minute}'` : "live";
-  const home = flags ? `${m.home.flag} ${m.home.name}` : m.home.name;
-  const away = flags ? `${m.away.name} ${m.away.flag}` : m.away.name;
+  const h = rosterPinned(m.home);
+  const a = rosterPinned(m.away);
+  const home = flags ? `${h.flag} ${h.name}` : h.name;
+  const away = flags ? `${a.name} ${a.flag}` : a.name;
   return `${home} ${scoreline(m)} ${away} (${minute})`;
 }
 function renderHook(state, opts = {}) {
@@ -5329,7 +5483,10 @@ function spawnRefresh(source) {
     if (!entry) return;
     const child = spawn(process.execPath, [entry, "_refresh", "--source", source], {
       detached: true,
-      stdio: "ignore"
+      stdio: "ignore",
+      // Windows: a detached child gets its own console window without this —
+      // the statusline would flash one every ~12–15s during live matches.
+      windowsHide: true
     });
     child.unref();
   } catch {
@@ -5595,10 +5752,24 @@ function precheck(cfg, t2, date) {
     throw new InputError(t2("err.date", { date }));
   }
 }
-function resolveTeamArg(team, usage) {
-  const code = team ?? process.env.CLAUDINHO_TEAM;
-  if (!code) throw new InputError(usage);
-  return code.toUpperCase();
+function resolveTeamArg(team, usage, t2) {
+  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(
+      `${t2("team.ambiguous", { query: raw })} ${matches.map((m) => `${m.name} (${m.code})`).join(", ")}`
+    );
+  }
+  if (/^[A-Za-z]{3}$/.test(raw)) return raw.toUpperCase();
+  throw new InputError(t2("team.none", { query: raw }));
+}
+function resolveEnvTeam(raw) {
+  if (!raw) return void 0;
+  const { team } = lookupTeam(raw);
+  if (team) return team.code;
+  return /^[A-Za-z]{3}$/.test(raw) ? raw.toUpperCase() : void 0;
 }
 async function cmdToday(date, ctx) {
   const { cfg, t: t2 } = ctx;
@@ -5670,7 +5841,7 @@ async function cmdLive(ctx) {
 async function cmdNext(team, ctx) {
   const { cfg, t: t2, now } = ctx;
   precheck(cfg, t2);
-  const code = resolveTeamArg(team, "Usage: claudinho next <team> (or set CLAUDINHO_TEAM)");
+  const code = resolveTeamArg(team, "Usage: claudinho next <team> (or set CLAUDINHO_TEAM)", t2);
   const { fixture, degraded, source } = await getNextFixtureForTeam(
     adapterFor(ctx),
     code,
@@ -5692,7 +5863,7 @@ async function cmdNext(team, ctx) {
   out(header(t2("next.label", { team: code }), c));
   out();
   out(matchLine(fixture, cfg, t2, c, flags));
-  const stage = fixture.stage !== "GROUP" ? `${stageLabel(fixture)} \xB7 ` : "";
+  const stage = fixture.stage !== "GROUP" ? `${stageLabelI18n(cfg.lang, fixture.stage)} \xB7 ` : "";
   out(
     "  " + c.dim(
       `${stage}${formatKickoff(fixture.kickoff, { tz: cfg.tz, locale: cfg.lang })} \xB7 ` + t2("next.in", { countdown: countdown(fixture.kickoff) })
@@ -5704,6 +5875,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);
@@ -5822,7 +6024,7 @@ async function cmdBracket(stage, opts, ctx) {
 function cmdPrompt({ cfg }) {
   try {
     const payload = readCursorPayload();
-    const team = process.env.CLAUDINHO_TEAM;
+    const team = resolveEnvTeam(process.env.CLAUDINHO_TEAM);
     const compact = !["0", "false", "no"].includes(
       (process.env.CLAUDINHO_COMPACT ?? "").toLowerCase()
     );
@@ -5840,7 +6042,7 @@ function cmdPrompt({ cfg }) {
 }
 function cmdHook({ cfg }) {
   try {
-    const team = process.env.CLAUDINHO_TEAM;
+    const team = resolveEnvTeam(process.env.CLAUDINHO_TEAM);
     const state = readCurrentState(cfg.source, resolveCompetition());
     const ctx = renderHook(state, { team, flags: flagsEnabled() });
     if (ctx) out(ctx);
@@ -5892,7 +6094,8 @@ function cmdInitCursor(opts, { cfg }) {
     out(CURSOR_MCP_SNIPPET);
     return;
   }
-  printInitResult(initCursorStatusline(), cfg);
+  const res = initCursorStatusline();
+  printInitResult(res, cfg);
   out("");
   out("Optional \u2014 live MCP tools in Cursor: add to ~/.cursor/mcp.json (or project .cursor/mcp.json):");
   out(CURSOR_MCP_SNIPPET);
@@ -5900,7 +6103,7 @@ function cmdInitCursor(opts, { cfg }) {
   out("Tip: export CLAUDINHO_CURSOR_META=auto for a model + context line below the score.");
   out("");
   out("\u2192 Restart your agent session to see it.");
-  printInitStarCta(cfg);
+  if (res.action === "written") printInitStarCta(cfg);
 }
 function cmdInitClaude(opts, { cfg }) {
   if (opts.print) {
@@ -5914,14 +6117,16 @@ function cmdInitClaude(opts, { cfg }) {
     out(CLAUDE_MCP_ONELINER);
     return;
   }
-  printInitResult(initStatusline(), cfg);
-  printInitResult(initHook(), cfg);
+  const statusRes = initStatusline();
+  const hookRes = initHook();
+  printInitResult(statusRes, cfg);
+  printInitResult(hookRes, cfg);
   out("");
   out("Next \u2014 add the MCP server:");
   out(`  ${CLAUDE_MCP_ONELINER}`);
   out("");
   out("\u2192 Restart Claude Code to see it.");
-  printInitStarCta(cfg);
+  if (statusRes.action === "written" || hookRes.action === "written") printInitStarCta(cfg);
 }
 async function cmdMatch(id, ctx) {
   const { cfg, t: t2 } = ctx;
@@ -5945,7 +6150,7 @@ async function cmdMatch(id, ctx) {
     out(disclaimer(t2, c));
     return;
   }
-  const stageLabelText = stageLabel(match);
+  const stageLabelText = stageLabelI18n(cfg.lang, match.stage, match.group ?? void 0);
   out(header(`${match.home.name} ${scoreline(match)} ${match.away.name}`, c));
   out("  " + c.dim(`${stageLabelText} \xB7 ${matchLocation(match)}`));
   out(
@@ -5991,7 +6196,7 @@ async function cmdMarkets(target, team, ctx) {
   const { cfg, t: t2 } = ctx;
   if (target === "next") {
     precheck(cfg, t2);
-    const code = resolveTeamArg(team, "Usage: claudinho markets next <team> (or set CLAUDINHO_TEAM)");
+    const code = resolveTeamArg(team, "Usage: claudinho markets next <team> (or set CLAUDINHO_TEAM)", t2);
     const now2 = ctx.now ?? /* @__PURE__ */ new Date();
     const { match: fixture, degraded } = await marketFixtureForTeam(adapterFor(ctx), code, now2);
     const sig = fixture && marketRelevant(fixture, now2) ? (await marketSignalsFor(ctx, [fixture], MARKETS_CMD_OPTS)).get(fixture.id) : void 0;
@@ -6267,7 +6472,7 @@ async function cmdShare(target, team, opts, ctx) {
   }
   if (target === "next") {
     precheck(cfg, t2);
-    const code = resolveTeamArg(team, "Usage: claudinho share next <team> (or set CLAUDINHO_TEAM)");
+    const code = resolveTeamArg(team, "Usage: claudinho share next <team> (or set CLAUDINHO_TEAM)", t2);
     const { fixture, degraded: degraded2, source: source2 } = await getNextFixtureForTeam(
       adapterFor(ctx),
       code,
@@ -6419,6 +6624,7 @@ function maybeStarNudge(ctx) {
   out(c.dim(`  \u2B50 Enjoying Claudinho? Star it \u2192 ${REPO_URL}   (claudinho star)`));
 }
 function printInitStarCta(cfg) {
+  if (cfg.json || !process.stdout.isTTY || process.env.CLAUDINHO_NO_STAR) return;
   const c = painterFor(cfg);
   out("");
   out(c.dim(`\u2B50 If this keeps you in the flow during the match, star the repo \u2192 ${REPO_URL}`));
@@ -6432,7 +6638,8 @@ function cmdVibe(ctx) {
     const state = readCurrentState(cfg.source, resolveCompetition());
     liveSeg = vibeLiveSegment(
       liveMatchesFromCache(state, (ctx.now ?? /* @__PURE__ */ new Date()).getTime()),
-      process.env.CLAUDINHO_TEAM
+      // Name-or-code, matching the statusline/hook (offline lookup).
+      resolveEnvTeam(process.env.CLAUDINHO_TEAM)
     );
   } catch {
   }
@@ -6456,7 +6663,7 @@ function handlePipeError(stream) {
 }
 handlePipeError(process.stdout);
 handlePipeError(process.stderr);
-var VERSION = "0.8.17";
+var VERSION = "0.8.19";
 var DISCLAIMER = "Claudinho is an independent fan project. Not affiliated with or endorsed by FIFA or Anthropic.";
 function ctxFrom(cmd) {
   let root = cmd;
@@ -6490,13 +6697,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));
@@ -6518,7 +6732,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) {
@@ -6527,7 +6741,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.17",
+  "version": "0.8.19",
   "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.17"
+    "@claudinho/core": "0.8.19"
   },
   "scripts": {
     "build": "tsup",