@claudinho/cli 0.8.18 → 0.8.19

package/README.md

@@ -186,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";
@@ -2887,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}`;
 }
@@ -2930,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];
@@ -2963,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,
@@ -3089,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);
@@ -4249,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;
@@ -4753,7 +4831,6 @@ var EN2 = {
   "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",
@@ -4791,7 +4868,6 @@ var ES2 = {
   "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",
@@ -4829,7 +4905,6 @@ var PT2 = {
   "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",
@@ -4867,7 +4942,6 @@ var FR2 = {
   "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",
@@ -4890,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;
   };
 }
@@ -4949,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(
@@ -5218,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));
 }
@@ -5238,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();
@@ -5247,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);
@@ -5280,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 = {}) {
@@ -5399,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 {
@@ -5665,18 +5752,24 @@ function precheck(cfg, t2, date) {
     throw new InputError(t2("err.date", { date }));
   }
 }
-function resolveTeamArg(team, usage) {
+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(
-      `"${raw}" is ambiguous \u2014 did you mean ${matches.map((m) => `${m.name} (${m.code})`).join(", ")}? Use the 3-letter code.`
+      `${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(`No team found for "${raw}". Use a nation name or 3-letter code (e.g. Mexico, MEX).`);
+  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;
@@ -5748,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,
@@ -5770,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) })
@@ -5931,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()
     );
@@ -5949,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);
@@ -6001,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);
@@ -6009,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) {
@@ -6023,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;
@@ -6054,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(
@@ -6100,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;
@@ -6376,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,
@@ -6528,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}`));
@@ -6541,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 {
   }
@@ -6565,7 +6663,7 @@ function handlePipeError(stream) {
 }
 handlePipeError(process.stdout);
 handlePipeError(process.stderr);
-var VERSION = "0.8.18";
+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;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@claudinho/cli",
-  "version": "0.8.18",
+  "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.18"
+    "@claudinho/core": "0.8.19"
   },
   "scripts": {
     "build": "tsup",