@claudinho/cli 0.8.19 → 0.9.0

package/dist/index.js

@@ -381,7 +381,8 @@ function normalizeLang(lang) {
 }
 function t(lang, key, vars) {
   const dict = CATALOGS[normalizeLang(lang)];
-  let s = dict[key] ?? EN[key] ?? key;
+  const en = EN;
+  let s = dict[key] ?? en[key] ?? key;
   if (vars) {
     for (const [k, v] of Object.entries(vars)) s = s.replaceAll(`{${k}}`, v);
   }
@@ -2943,11 +2944,27 @@ function rosterAtZero(matches) {
 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 USER_AGENT = `claudinho/${"0.9.0"} (+https://github.com/arturogarrido/claudinho)`;
 var MAX_RESPONSE_BYTES = 5 * 1024 * 1024;
 function competitionBase(slug) {
   return `${ESPN_SOCCER}/${slug}`;
 }
+var DEFAULT_TIMEOUT_MS = 6e3;
+var STANDINGS_SHARE_MS = 3e4;
+var ProviderError = class extends Error {
+  kind;
+  status;
+  constructor(message, kind, status) {
+    super(message);
+    this.name = "ProviderError";
+    this.kind = kind;
+    this.status = status;
+  }
+  /** 429/403 — the upstream is refusing us; retrying at the live cadence makes it worse. */
+  get throttled() {
+    return this.kind === "http" && (this.status === 429 || this.status === 403);
+  }
+};
 function mapStatus(st) {
   const name = (st?.type?.name ?? "").toUpperCase();
   const state = st?.type?.state ?? "";
@@ -3089,6 +3106,20 @@ var EspnAdapter = class {
   capabilities = { push: false, latencyHintSec: 45 };
   /** Cached team-code -> group-letter map (built lazily from standings). */
   groupMap;
+  /**
+   * One in-flight/recent standings fetch shared by fetchStandings and
+   * fetchGroupMap, so a command like `bracket` hits the endpoint once instead
+   * of twice, and a long-lived MCP server stays fresh (short TTL). A rejected
+   * fetch clears the slot — a transient failure is never cached.
+   */
+  standingsShared;
+  /**
+   * The most recent request failure (best-effort under concurrency; cleared
+   * when a new request starts). A post-hoc hint for callers whose result path
+   * fails closed to `degraded` booleans but who still need to distinguish a
+   * throttle (persist a backoff) from an ordinary blip.
+   */
+  lastError;
   async fetchByDate(dateISO) {
     return this.fetchScoreboard(toEspnDate(dateISO));
   }
@@ -3110,37 +3141,58 @@ var EspnAdapter = class {
     const base = this.opts.baseUrl ?? DEFAULT_BASE;
     return `${base.replace("/apis/site/v2/", "/apis/v2/")}/standings`;
   }
+  /** The shared standings fetch (see {@link standingsShared}). */
+  sharedStandings() {
+    const now = Date.now();
+    if (this.standingsShared && now - this.standingsShared.at < STANDINGS_SHARE_MS) {
+      return this.standingsShared.promise;
+    }
+    const promise = this.get(this.standingsUrl()).then(
+      (d) => parseStandings(d)
+    );
+    this.standingsShared = { at: now, promise };
+    promise.catch(() => {
+      if (this.standingsShared?.promise === promise) this.standingsShared = void 0;
+    });
+    return promise;
+  }
   /**
    * 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()));
+    return this.sharedStandings();
   }
   /**
    * Build (and cache) a team-code -> group-letter map from the standings
-   * endpoint. Best-effort: returns {} if standings are unavailable. Reuses the
-   * same parse as {@link fetchStandings}, so the two never drift.
+   * endpoint. Best-effort: returns {} if standings are unavailable — but a
+   * transient failure is NOT cached (only a successful parse pins the map), so
+   * one blip can't silently drop group letters for the adapter's lifetime.
+   * Reuses the same parse/fetch as {@link fetchStandings}, so the two never
+   * drift and one command never fetches standings twice.
    */
   async fetchGroupMap(force = false) {
     if (this.groupMap && !force) return this.groupMap;
-    const map = {};
     try {
-      const tables = parseStandings(await this.get(this.standingsUrl()));
+      const tables = await this.sharedStandings();
+      const map = {};
       for (const t2 of tables) for (const r of t2.rows) map[r.team.code] = t2.group;
+      this.groupMap = map;
+      return map;
     } catch {
+      return {};
     }
-    this.groupMap = map;
-    return map;
   }
   async fetchScoreboard(dates) {
     const base = this.opts.baseUrl ?? DEFAULT_BASE;
     const url = new URL(`${base}/scoreboard`);
     url.searchParams.set("limit", "300");
     if (dates) url.searchParams.set("dates", dates);
-    const groupByTeam = this.opts.enrichGroups === false ? {} : await this.fetchGroupMap();
-    const data = await this.get(url.toString());
+    const [groupByTeam, data] = await Promise.all([
+      this.opts.enrichGroups === false ? Promise.resolve({}) : this.fetchGroupMap(),
+      this.get(url.toString())
+    ]);
     return (data.events ?? []).map((ev) => mapEspnEvent(ev, { groupByTeam }));
   }
   async get(url) {
@@ -3148,24 +3200,51 @@ var EspnAdapter = class {
     const controller = new AbortController();
     const timer = setTimeout(
       () => controller.abort(),
-      this.opts.timeoutMs ?? 15e3
+      this.opts.timeoutMs ?? DEFAULT_TIMEOUT_MS
     );
+    this.lastError = void 0;
     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 }
-      });
+      let res;
+      try {
+        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 }
+        });
+      } catch (e) {
+        throw e?.name === "AbortError" ? new ProviderError(`ESPN request timed out: ${url}`, "timeout") : new ProviderError(`ESPN request failed: ${e?.message ?? e}`, "http");
+      }
       if (!res.ok) {
-        throw new Error(`ESPN request failed: ${res.status} ${res.statusText}`);
+        throw new ProviderError(
+          `ESPN request failed: ${res.status} ${res.statusText}`,
+          "http",
+          res.status
+        );
       }
       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`);
+        throw new ProviderError(`ESPN response too large: ${length} bytes`, "parse");
+      }
+      try {
+        return await res.json();
+      } catch (e) {
+        throw new ProviderError(
+          `ESPN response unparseable: ${e?.message ?? e}`,
+          "parse"
+        );
+      }
+    } catch (e) {
+      const pe = e instanceof ProviderError ? e : new ProviderError(String(e?.message ?? e), "http");
+      this.lastError = pe;
+      if (typeof process !== "undefined" && process.env?.CLAUDINHO_DEBUG) {
+        process.stderr.write(
+          `claudinho: espn ${pe.kind}${pe.status ? ` ${pe.status}` : ""}: ${url}
+`
+        );
       }
-      return await res.json();
+      throw pe;
     } finally {
       clearTimeout(timer);
     }
@@ -3889,13 +3968,18 @@ function resolveCompetition(explicit) {
   }
   return DEFAULT_COMPETITION;
 }
+var KNOWN_SOURCES = ["espn"];
 function makeAdapter(source = "espn") {
   switch (source) {
-    default: {
+    case "espn": {
       const competition = resolveCompetition();
       const baseUrl = competition === DEFAULT_COMPETITION ? void 0 : competitionBase(competition);
       return new EspnAdapter({ baseUrl });
     }
+    default:
+      throw new Error(
+        `Unknown data source "${source}" (available: ${KNOWN_SOURCES.join(", ")})`
+      );
   }
 }
 function mergeLive(base, live) {
@@ -3933,8 +4017,16 @@ async function getStandings(adapter, group) {
   const tables = letters.map((g) => ({ group: g, rows: rosterAtZero(fixturesByGroup(g)) })).filter((t2) => t2.rows.length > 0);
   return { tables, degraded: true };
 }
-var KNOCKOUT_WINDOW_START = "20260628";
-var KNOCKOUT_WINDOW_END = "20260719";
+var knockoutWindowMemo;
+function knockoutWindow() {
+  if (knockoutWindowMemo !== void 0) return knockoutWindowMemo;
+  const days = allFixtures().filter((m) => m.stage !== "GROUP" && m.stage !== "FRIENDLY").map((m) => m.kickoff.slice(0, 10).replace(/-/g, "")).filter((d) => d.length === 8);
+  knockoutWindowMemo = days.length ? {
+    start: days.reduce((a, b) => a < b ? a : b),
+    end: days.reduce((a, b) => a > b ? a : b)
+  } : null;
+  return knockoutWindowMemo;
+}
 async function getBracket(adapter, opts = {}) {
   const topology = loadBracketTopology();
   const base = allFixtures().filter((m) => m.stage !== "GROUP" && m.stage !== "FRIENDLY");
@@ -3942,7 +4034,8 @@ async function getBracket(adapter, opts = {}) {
   let liveDegraded = true;
   let source;
   try {
-    const live = adapter.fetchWindow ? await adapter.fetchWindow(KNOCKOUT_WINDOW_START, KNOCKOUT_WINDOW_END) : [];
+    const win = knockoutWindow();
+    const live = adapter.fetchWindow && win ? await adapter.fetchWindow(win.start, win.end) : [];
     matches = mergeLive(base, live);
     liveDegraded = false;
     source = adapter.name;
@@ -3975,8 +4068,9 @@ async function marketFixtureForTeam(adapter, code, now = /* @__PURE__ */ new Dat
   let fixtures = allFixtures();
   let overlayFailed = false;
   try {
-    if (adapter.fetchWindow) {
-      fixtures = mergeLive(fixtures, await adapter.fetchWindow(KNOCKOUT_WINDOW_START, KNOCKOUT_WINDOW_END));
+    const win = knockoutWindow();
+    if (adapter.fetchWindow && win) {
+      fixtures = mergeLive(fixtures, await adapter.fetchWindow(win.start, win.end));
     }
   } catch {
     overlayFailed = true;
@@ -3999,7 +4093,8 @@ async function getNextFixtureForTeam(adapter, code, now = /* @__PURE__ */ new Da
   let degraded = true;
   let liveById;
   try {
-    const live = adapter.fetchWindow ? await adapter.fetchWindow(KNOCKOUT_WINDOW_START, KNOCKOUT_WINDOW_END) : [];
+    const win = knockoutWindow();
+    const live = adapter.fetchWindow && win ? await adapter.fetchWindow(win.start, win.end) : [];
     matches = mergeLive(base, live);
     degraded = false;
     liveById = new Set(live.map((m) => m.id));
@@ -4010,10 +4105,11 @@ async function getNextFixtureForTeam(adapter, code, now = /* @__PURE__ */ new Da
   return { fixture, degraded, source };
 }
 async function getKnockoutFixtures(adapter, now = /* @__PURE__ */ new Date()) {
-  if (!adapter.fetchWindow) return { fixtures: [], degraded: true };
+  const win = knockoutWindow();
+  if (!adapter.fetchWindow || !win) return { fixtures: [], degraded: true };
   let live;
   try {
-    live = await adapter.fetchWindow(KNOCKOUT_WINDOW_START, KNOCKOUT_WINDOW_END);
+    live = await adapter.fetchWindow(win.start, win.end);
   } catch {
     return { fixtures: [], degraded: true };
   }
@@ -4261,7 +4357,7 @@ var mapping_2026_default = {
 var DEFAULT_BASE2 = "https://gamma-api.polymarket.com";
 var ALLOWED_HOSTS = /* @__PURE__ */ new Set(["gamma-api.polymarket.com"]);
 var USER_AGENT2 = "claudinho/0.0 (+https://github.com/arturogarrido/claudinho)";
-var DEFAULT_TIMEOUT_MS = 8e3;
+var DEFAULT_TIMEOUT_MS2 = 8e3;
 var WC_SERIES_SLUG = "soccer-fifwc";
 var WC_SPORT = "fifwc";
 var KICKOFF_TOLERANCE_MS = 6 * 60 * 6e4;
@@ -4299,7 +4395,7 @@ var PolymarketProvider = class {
     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;
+    const configured = options?.timeoutMs ?? this.opts.timeoutMs ?? DEFAULT_TIMEOUT_MS2;
     try {
       for (const slug of slugs) {
         const remaining = deadline - Date.now();
@@ -4319,7 +4415,7 @@ var PolymarketProvider = class {
     const url = `${base}/events?slug=${encodeURIComponent(slug)}`;
     const doFetch = this.opts.fetchImpl ?? fetch;
     const res = await doFetch(url, {
-      signal: AbortSignal.timeout(timeoutMs ?? this.opts.timeoutMs ?? DEFAULT_TIMEOUT_MS),
+      signal: AbortSignal.timeout(timeoutMs ?? this.opts.timeoutMs ?? DEFAULT_TIMEOUT_MS2),
       // Gamma never legitimately redirects; following one would sidestep the
       // host allow-list (it only validates the base URL), so reject redirects.
       redirect: "error",
@@ -4810,6 +4906,82 @@ function resolveConfig(opts) {
   };
 }
 
+// src/cursorPayload.ts
+import { readFileSync } from "fs";
+function parseCursorPayload(raw) {
+  try {
+    const trimmed = raw.trim();
+    if (!trimmed) return void 0;
+    return JSON.parse(trimmed);
+  } catch {
+    return void 0;
+  }
+}
+function readCursorPayload() {
+  try {
+    if (process.stdin.isTTY) return void 0;
+    return parseCursorPayload(readFileSync(0, "utf8"));
+  } catch {
+    return void 0;
+  }
+}
+function readCursorPayloadBounded(timeoutMs = 100, stdin = process.stdin) {
+  if (stdin.isTTY) return Promise.resolve(void 0);
+  return new Promise((resolve) => {
+    const chunks = [];
+    const done = () => {
+      clearTimeout(timer);
+      stdin.off("data", onData);
+      stdin.off("end", done);
+      stdin.off("error", done);
+      stdin.pause();
+      resolve(parseCursorPayload(Buffer.concat(chunks).toString("utf8")));
+    };
+    const onData = (c) => {
+      chunks.push(c);
+    };
+    const timer = setTimeout(done, timeoutMs);
+    timer.unref?.();
+    stdin.on("data", onData);
+    stdin.once("end", done);
+    stdin.once("error", done);
+    stdin.resume();
+  });
+}
+function looksLikeCursorPayload(payload) {
+  return !!(payload.model?.display_name || payload.context_window != null || payload.render_width_chars != null || payload.worktree?.name || payload.vim?.mode);
+}
+function cursorMetaEnabled(payload) {
+  const v = (process.env.CLAUDINHO_CURSOR_META ?? "").toLowerCase();
+  if (v === "0" || v === "false" || v === "no") return false;
+  if (v === "1" || v === "true" || v === "yes") return !!payload;
+  if (v === "auto") return !!payload && looksLikeCursorPayload(payload);
+  return false;
+}
+function renderCursorMetaLine(payload) {
+  const parts = [];
+  const model = payload.model?.display_name;
+  if (model) {
+    let label = model;
+    if (payload.model?.param_summary) label += ` ${payload.model.param_summary}`;
+    parts.push(label);
+  }
+  const pct2 = payload.context_window?.used_percentage;
+  if (typeof pct2 === "number" && Number.isFinite(pct2)) {
+    parts.push(`ctx ${Math.floor(pct2)}%`);
+  }
+  if (payload.worktree?.name) parts.push(`wt ${payload.worktree.name}`);
+  if (payload.vim?.mode) parts.push(payload.vim.mode);
+  if (parts.length === 0) return void 0;
+  return `\x1B[90m${parts.join("  ")}\x1B[0m`;
+}
+function renderPromptOutput(scoreLine, payload) {
+  const meta = payload && cursorMetaEnabled(payload) ? renderCursorMetaLine(payload) : void 0;
+  if (meta) return `${scoreLine}
+${meta}`;
+  return scoreLine;
+}
+
 // src/i18n.ts
 var EN2 = {
   "today.title": "Today's matches",
@@ -4844,6 +5016,7 @@ var EN2 = {
   "col.gd": "GD",
   "col.pts": "Pts",
   "err.date": "Invalid date {date}. Use YYYY-MM-DD.",
+  "err.source": "Unknown data source {source}. Available: {sources}.",
   "warn.tz": "Unknown timezone {tz}; using system timezone.",
   "warn.lang": "Unsupported language {lang}; using English. (supported: en, es, pt, fr)",
   disclaimer: "Not affiliated with FIFA or Anthropic."
@@ -4881,6 +5054,7 @@ var ES2 = {
   "col.gd": "DG",
   "col.pts": "Pts",
   "err.date": "Fecha inv\xE1lida {date}. Usa AAAA-MM-DD.",
+  "err.source": "Fuente de datos desconocida {source}. Disponibles: {sources}.",
   "warn.tz": "Zona horaria desconocida {tz}; usando la del sistema.",
   "warn.lang": "Idioma no soportado {lang}; usando ingl\xE9s. (disponibles: en, es, pt, fr)",
   disclaimer: "No afiliado a FIFA ni Anthropic."
@@ -4918,6 +5092,7 @@ var PT2 = {
   "col.gd": "SG",
   "col.pts": "Pts",
   "err.date": "Data inv\xE1lida {date}. Use AAAA-MM-DD.",
+  "err.source": "Fonte de dados desconhecida {source}. Dispon\xEDveis: {sources}.",
   "warn.tz": "Fuso hor\xE1rio desconhecido {tz}; usando o do sistema.",
   "warn.lang": "Idioma n\xE3o suportado {lang}; usando ingl\xEAs. (dispon\xEDveis: en, es, pt, fr)",
   disclaimer: "N\xE3o afiliado \xE0 FIFA nem \xE0 Anthropic."
@@ -4955,6 +5130,7 @@ var FR2 = {
   "col.gd": "Diff",
   "col.pts": "Pts",
   "err.date": "Date invalide {date}. Utilisez AAAA-MM-JJ.",
+  "err.source": "Source de donn\xE9es inconnue {source}. Disponibles : {sources}.",
   "warn.tz": "Fuseau horaire inconnu {tz} ; utilisation du fuseau syst\xE8me.",
   "warn.lang": "Langue non prise en charge {lang} ; utilisation de l\u2019anglais. (disponibles : en, es, pt, fr)",
   disclaimer: "Non affili\xE9 \xE0 la FIFA ni \xE0 Anthropic."
@@ -4962,8 +5138,9 @@ var FR2 = {
 var CATALOGS2 = { en: EN2, es: ES2, pt: PT2, fr: FR2 };
 function makeT(lang) {
   const dict = CATALOGS2[lang] ?? EN2;
+  const en = EN2;
   return (key, vars) => {
-    let s = dict[key] ?? EN2[key] ?? key;
+    let s = dict[key] ?? en[key] ?? key;
     if (vars) for (const [k, v] of Object.entries(vars)) s = s.replaceAll(`{${k}}`, v);
     return s;
   };
@@ -5048,21 +5225,38 @@ function dataSource(source, lang, c) {
 }
 
 // src/marketCache.ts
-import { mkdirSync, readFileSync, renameSync, writeFileSync } from "fs";
+import { readFileSync as readFileSync2 } from "fs";
+import { join as join2 } from "path";
+
+// src/paths.ts
+import { closeSync, mkdirSync, openSync, renameSync, writeSync } from "fs";
 import { homedir } from "os";
-import { join } from "path";
-var POSITIVE_TTL_MS = 10 * 6e4;
-var NEGATIVE_TTL_MS = 3 * 6e4;
+import { dirname, join } from "path";
 function cacheDir() {
   const base = process.env.XDG_CACHE_HOME || join(homedir(), ".cache");
   return join(base, "claudinho");
 }
+function writeFileAtomic(path, data) {
+  mkdirSync(dirname(path), { recursive: true });
+  const tmp = `${path}.${process.pid}.tmp`;
+  const fd = openSync(tmp, "w");
+  try {
+    writeSync(fd, data);
+  } finally {
+    closeSync(fd);
+  }
+  renameSync(tmp, path);
+}
+
+// src/marketCache.ts
+var POSITIVE_TTL_MS = 10 * 6e4;
+var NEGATIVE_TTL_MS = 3 * 6e4;
 function cachePath() {
-  return join(cacheDir(), "market-signals.json");
+  return join2(cacheDir(), "market-signals.json");
 }
 function readFile() {
   try {
-    return JSON.parse(readFileSync(cachePath(), "utf8"));
+    return JSON.parse(readFileSync2(cachePath(), "utf8"));
   } catch {
     return void 0;
   }
@@ -5093,23 +5287,18 @@ function writeMarketCache(source, competition, attempted, fetched, now = Date.no
     for (const id of attempted) {
       base.entries[id] = { fetchedAt, signal: fetched.get(id) ?? null };
     }
-    mkdirSync(cacheDir(), { recursive: true });
-    const tmp = join(cacheDir(), `market-signals.${process.pid}.tmp`);
-    writeFileSync(tmp, JSON.stringify(base));
-    renameSync(tmp, cachePath());
+    writeFileAtomic(cachePath(), JSON.stringify(base));
   } catch {
   }
 }
 
 // src/starNudge.ts
-import { mkdirSync as mkdirSync2, readFileSync as readFileSync2, writeFileSync as writeFileSync2 } from "fs";
-import { homedir as homedir2 } from "os";
-import { dirname, join as join2 } from "path";
+import { readFileSync as readFileSync3 } from "fs";
+import { join as join3 } from "path";
 var REPO_URL = "https://github.com/arturogarrido/claudinho";
 var NUDGE_EVERY = 5;
 function counterPath() {
-  const base = process.env.XDG_CACHE_HOME || join2(homedir2(), ".cache");
-  return join2(base, "claudinho", "runs.json");
+  return join3(cacheDir(), "runs.json");
 }
 function shouldNudge(runCount, every = NUDGE_EVERY) {
   return runCount > 0 && runCount % every === 0;
@@ -5118,14 +5307,13 @@ function bumpRunCount(path = counterPath()) {
   try {
     let count = 0;
     try {
-      const raw = JSON.parse(readFileSync2(path, "utf8"));
+      const raw = JSON.parse(readFileSync3(path, "utf8"));
       if (typeof raw.count === "number" && Number.isFinite(raw.count)) count = raw.count;
     } catch {
       count = 0;
     }
     count += 1;
-    mkdirSync2(dirname(path), { recursive: true });
-    writeFileSync2(path, JSON.stringify({ count }), "utf8");
+    writeFileAtomic(path, JSON.stringify({ count }));
     return count;
   } catch {
     return void 0;
@@ -5160,53 +5348,56 @@ function copyToClipboard(text, platform = process.platform) {
 
 // src/cache.ts
 import {
-  closeSync,
-  mkdirSync as mkdirSync3,
-  openSync,
-  readFileSync as readFileSync3,
-  renameSync as renameSync2,
+  closeSync as closeSync2,
+  mkdirSync as mkdirSync2,
+  openSync as openSync2,
+  readFileSync as readFileSync4,
   rmSync,
   statSync,
-  writeSync
+  writeSync as writeSync2
 } from "fs";
-import { homedir as homedir3 } from "os";
-import { join as join3 } from "path";
+import { join as join4 } from "path";
+var CACHE_VERSION = 2;
 var LOCK_STALE_MS = 6e4;
-function cacheDir2() {
-  const base = process.env.XDG_CACHE_HOME || join3(homedir3(), ".cache");
-  return join3(base, "claudinho");
-}
-function cachePath2() {
-  return join3(cacheDir2(), "state.json");
+function cachePath2(source = "espn", competition = DEFAULT_COMPETITION) {
+  if (source === "espn" && competition === DEFAULT_COMPETITION) {
+    return join4(cacheDir(), "state.json");
+  }
+  const slug = `${source}.${competition}`.replace(/[^a-zA-Z0-9._-]/g, "_");
+  return join4(cacheDir(), `state.${slug}.json`);
 }
 function lockPath() {
-  return join3(cacheDir2(), "refresh.lock");
+  return join4(cacheDir(), "refresh.lock");
 }
-function readState() {
+function readState(source = "espn", competition = DEFAULT_COMPETITION) {
   try {
-    return JSON.parse(readFileSync3(cachePath2(), "utf8"));
+    const s = JSON.parse(
+      readFileSync4(cachePath2(source, competition), "utf8")
+    );
+    return s.version === CACHE_VERSION ? s : void 0;
   } catch {
     return void 0;
   }
 }
 function readCurrentState(source, competition) {
-  const s = readState();
+  const s = readState(source, competition);
   return s && s.source === source && s.competition === competition ? s : void 0;
 }
 function writeState(state) {
-  const dir = cacheDir2();
-  mkdirSync3(dir, { recursive: true });
-  const tmp = join3(dir, `state.${process.pid}.tmp`);
-  writeFileSync_(tmp, JSON.stringify(state));
-  renameSync2(tmp, cachePath2());
-}
-function writeFileSync_(path, data) {
-  const fd = openSync(path, "w");
-  try {
-    writeSync(fd, data);
-  } finally {
-    closeSync(fd);
-  }
+  writeFileAtomic(
+    cachePath2(state.source, state.competition),
+    JSON.stringify({ ...state, version: CACHE_VERSION })
+  );
+}
+function backoffActive(state, now = Date.now()) {
+  if (!state?.backoffUntil) return false;
+  const t2 = Date.parse(state.backoffUntil);
+  return Number.isFinite(t2) && now < t2;
+}
+function fixturesAttemptAgeMs(state, now = Date.now()) {
+  if (!state?.fixturesAttemptedAt) return Infinity;
+  const t2 = Date.parse(state.fixturesAttemptedAt);
+  return Number.isFinite(t2) ? now - t2 : Infinity;
 }
 function ageMs(state, now = Date.now()) {
   if (!state) return Infinity;
@@ -5221,7 +5412,7 @@ function fixturesAgeMs(state, now = Date.now()) {
 function lockAgeMs(now = Date.now()) {
   const lp = lockPath();
   try {
-    const contents = readFileSync3(lp, "utf8");
+    const contents = readFileSync4(lp, "utf8");
     const written = Number.parseInt(contents.split(/\s+/)[1] ?? "", 10);
     if (Number.isFinite(written)) return now - written;
   } catch {
@@ -5237,14 +5428,14 @@ function isLockFresh(now = Date.now()) {
   return lockAgeMs(now) < LOCK_STALE_MS;
 }
 function acquireLock(now = Date.now()) {
-  mkdirSync3(cacheDir2(), { recursive: true });
+  mkdirSync2(cacheDir(), { recursive: true });
   const lp = lockPath();
   try {
-    const fd = openSync(lp, "wx");
+    const fd = openSync2(lp, "wx");
     try {
-      writeSync(fd, `${process.pid} ${now}`);
+      writeSync2(fd, `${process.pid} ${now}`);
     } finally {
-      closeSync(fd);
+      closeSync2(fd);
     }
     return true;
   } catch {
@@ -5255,11 +5446,11 @@ function acquireLock(now = Date.now()) {
         return false;
       }
       try {
-        const fd = openSync(lp, "wx");
+        const fd = openSync2(lp, "wx");
         try {
-          writeSync(fd, `${process.pid} ${now}`);
+          writeSync2(fd, `${process.pid} ${now}`);
         } finally {
-          closeSync(fd);
+          closeSync2(fd);
         }
         return true;
       } catch {
@@ -5393,9 +5584,12 @@ import { spawn } from "child_process";
 var MIN_REFRESH_MS = 12e3;
 var FIXTURES_TTL_MS = 15 * 6e4;
 var FIXTURES_EMPTY_TTL_MS = 6e4;
+var BACKOFF_MS = 5 * 6e4;
+var BACKOFF_JITTER_MS = 6e4;
 function fixturesStale(state, now) {
   const ttl = (state?.fixtures?.length ?? 0) > 0 ? FIXTURES_TTL_MS : FIXTURES_EMPTY_TTL_MS;
-  return fixturesAgeMs(state, now) > ttl;
+  if (fixturesAgeMs(state, now) <= ttl) return false;
+  return fixturesAttemptAgeMs(state, now) > FIXTURES_EMPTY_TTL_MS;
 }
 function nextStaticUpcoming(nowMs) {
   return [...allFixtures()].sort(byKickoff).find((m) => Date.parse(m.kickoff) >= nowMs);
@@ -5409,24 +5603,57 @@ function liveWindowActive(nowMs) {
   if (resolveCompetition() !== DEFAULT_COMPETITION) return true;
   return inLiveWindow(nowMs);
 }
-function liveAdapter() {
+function liveAdapter(source) {
   const competition = resolveCompetition();
-  if (competition === DEFAULT_COMPETITION) {
+  if (source === "espn" && competition === DEFAULT_COMPETITION) {
     return new EspnAdapter({ enrichGroups: false });
   }
-  return makeAdapter("espn");
+  return makeAdapter(source);
 }
 async function runRefresh(opts = {}) {
   const now = opts.now ?? /* @__PURE__ */ new Date();
   const nowMs = now.getTime();
   const source = opts.source ?? "espn";
   const competition = resolveCompetition();
-  const cached = readState();
+  if (!KNOWN_SOURCES.includes(source)) {
+    if (!readState(source, competition) && acquireLock()) {
+      try {
+        writeState({
+          updatedAt: now.toISOString(),
+          live: [],
+          degraded: true,
+          // no live provider served this scope — never claim otherwise
+          source,
+          competition
+        });
+      } finally {
+        releaseLock();
+      }
+    }
+    return;
+  }
+  const cached = readState(source, competition);
   const sameScope = !!cached && cached.source === source && cached.competition === competition;
   const base = sameScope ? cached : void 0;
-  const needLive = liveWindowActive(nowMs) && (!base || ageMs(base, nowMs) >= MIN_REFRESH_MS);
-  const needFixtures = inKnockoutPhase(nowMs) && fixturesStale(base, nowMs);
-  if (!needLive && !needFixtures) return;
+  const inBackoff = backoffActive(base, nowMs);
+  const needLive = !inBackoff && liveWindowActive(nowMs) && (!base || ageMs(base, nowMs) >= MIN_REFRESH_MS);
+  const needFixtures = !inBackoff && inKnockoutPhase(nowMs) && fixturesStale(base, nowMs);
+  if (!needLive && !needFixtures) {
+    if (!base && acquireLock()) {
+      try {
+        writeState({
+          updatedAt: now.toISOString(),
+          live: [],
+          degraded: false,
+          source,
+          competition
+        });
+      } finally {
+        releaseLock();
+      }
+    }
+    return;
+  }
   if (!acquireLock()) return;
   try {
     let live = base?.live ?? [];
@@ -5434,9 +5661,12 @@ async function runRefresh(opts = {}) {
     let updatedAt = base?.updatedAt ?? now.toISOString();
     let fixtures = base?.fixtures;
     let fixturesUpdatedAt = base?.fixturesUpdatedAt;
+    let fixturesAttemptedAt = base?.fixturesAttemptedAt;
+    let backoffUntil = base?.backoffUntil;
+    const adapter = liveAdapter(source);
     if (needLive) {
       try {
-        const r = await getLiveMatches(liveAdapter(), now);
+        const r = await getLiveMatches(adapter, now);
         live = r.matches;
         degraded = r.degraded;
       } catch {
@@ -5445,8 +5675,9 @@ async function runRefresh(opts = {}) {
       updatedAt = now.toISOString();
     }
     if (needFixtures) {
+      fixturesAttemptedAt = now.toISOString();
       try {
-        const r = await getKnockoutFixtures(liveAdapter(), now);
+        const r = await getKnockoutFixtures(adapter, now);
         if (!r.degraded) {
           fixtures = r.fixtures;
           fixturesUpdatedAt = now.toISOString();
@@ -5454,6 +5685,13 @@ async function runRefresh(opts = {}) {
       } catch {
       }
     }
+    if (adapter.lastError?.throttled) {
+      backoffUntil = new Date(
+        nowMs + BACKOFF_MS + Math.floor(Math.random() * BACKOFF_JITTER_MS)
+      ).toISOString();
+    } else if (backoffUntil && Date.parse(backoffUntil) <= nowMs) {
+      backoffUntil = void 0;
+    }
     writeState({
       updatedAt,
       live,
@@ -5461,19 +5699,23 @@ async function runRefresh(opts = {}) {
       source,
       competition,
       ...fixtures ? { fixtures } : {},
-      ...fixturesUpdatedAt ? { fixturesUpdatedAt } : {}
+      ...fixturesUpdatedAt ? { fixturesUpdatedAt } : {},
+      ...fixturesAttemptedAt ? { fixturesAttemptedAt } : {},
+      ...backoffUntil ? { backoffUntil } : {}
     });
   } finally {
     releaseLock();
   }
 }
-function shouldRefresh(now = Date.now()) {
+function shouldRefresh(now = Date.now(), state = readState("espn", resolveCompetition())) {
   if (!liveWindowActive(now)) return false;
+  if (backoffActive(state, now)) return false;
   if (isLockFresh(now)) return false;
-  return ageMs(readState(), now) > LIVE_TTL_MS;
+  return ageMs(state, now) > LIVE_TTL_MS;
 }
-function shouldRefreshFixtures(now = Date.now(), state = readState()) {
+function shouldRefreshFixtures(now = Date.now(), state = readState("espn", resolveCompetition())) {
   if (!inKnockoutPhase(now)) return false;
+  if (backoffActive(state, now)) return false;
   if (isLockFresh(now)) return false;
   return fixturesStale(state, now);
 }
@@ -5493,74 +5735,15 @@ function spawnRefresh(source) {
   }
 }
 
-// src/cursorPayload.ts
-import { readFileSync as readFileSync4 } from "fs";
-function parseCursorPayload(raw) {
-  try {
-    const trimmed = raw.trim();
-    if (!trimmed) return void 0;
-    return JSON.parse(trimmed);
-  } catch {
-    return void 0;
-  }
-}
-function readCursorPayload() {
-  try {
-    if (process.stdin.isTTY) return void 0;
-    return parseCursorPayload(readFileSync4(0, "utf8"));
-  } catch {
-    return void 0;
-  }
-}
-function looksLikeCursorPayload(payload) {
-  return !!(payload.model?.display_name || payload.context_window != null || payload.render_width_chars != null || payload.worktree?.name || payload.vim?.mode);
-}
-function cursorMetaEnabled(payload) {
-  const v = (process.env.CLAUDINHO_CURSOR_META ?? "").toLowerCase();
-  if (v === "0" || v === "false" || v === "no") return false;
-  if (v === "1" || v === "true" || v === "yes") return !!payload;
-  if (v === "auto") return !!payload && looksLikeCursorPayload(payload);
-  return false;
-}
-function renderCursorMetaLine(payload) {
-  const parts = [];
-  const model = payload.model?.display_name;
-  if (model) {
-    let label = model;
-    if (payload.model?.param_summary) label += ` ${payload.model.param_summary}`;
-    parts.push(label);
-  }
-  const pct2 = payload.context_window?.used_percentage;
-  if (typeof pct2 === "number" && Number.isFinite(pct2)) {
-    parts.push(`ctx ${Math.floor(pct2)}%`);
-  }
-  if (payload.worktree?.name) parts.push(`wt ${payload.worktree.name}`);
-  if (payload.vim?.mode) parts.push(payload.vim.mode);
-  if (parts.length === 0) return void 0;
-  return `\x1B[90m${parts.join("  ")}\x1B[0m`;
-}
-function renderPromptOutput(scoreLine, payload) {
-  const meta = payload && cursorMetaEnabled(payload) ? renderCursorMetaLine(payload) : void 0;
-  if (meta) return `${scoreLine}
-${meta}`;
-  return scoreLine;
-}
-
 // src/install.ts
-import {
-  copyFileSync,
-  existsSync,
-  mkdirSync as mkdirSync4,
-  readFileSync as readFileSync5,
-  writeFileSync as writeFileSync3
-} from "fs";
-import { homedir as homedir4 } from "os";
-import { dirname as dirname2, join as join4 } from "path";
+import { copyFileSync, existsSync, readFileSync as readFileSync5 } from "fs";
+import { homedir as homedir2 } from "os";
+import { join as join5 } from "path";
 function claudeSettingsPath() {
-  return join4(homedir4(), ".claude", "settings.json");
+  return join5(homedir2(), ".claude", "settings.json");
 }
 function cursorCliConfigPath() {
-  return join4(homedir4(), ".cursor", "cli-config.json");
+  return join5(homedir2(), ".cursor", "cli-config.json");
 }
 function isSameCommand(configured, requested) {
   return configured === requested;
@@ -5622,8 +5805,7 @@ function initStatuslineFor(target, opts = {}) {
   }
   backupOnce(path);
   settings.statusLine = sl;
-  mkdirSync4(dirname2(path), { recursive: true });
-  writeFileSync3(path, JSON.stringify(settings, null, 2) + "\n", "utf8");
+  writeFileAtomic(path, JSON.stringify(settings, null, 2) + "\n");
   const surface = target === "cursor" ? "Cursor CLI statusline" : "Statusline";
   return {
     action: "written",
@@ -5669,8 +5851,7 @@ function initHook(opts = {}) {
   const hooks = settings.hooks;
   hooks[CLAUDE_HOOK_EVENT] ??= [];
   hooks[CLAUDE_HOOK_EVENT].push({ hooks: [{ type: "command", command }] });
-  mkdirSync4(dirname2(path), { recursive: true });
-  writeFileSync3(path, JSON.stringify(settings, null, 2) + "\n", "utf8");
+  writeFileAtomic(path, JSON.stringify(settings, null, 2) + "\n");
   return {
     action: "written",
     path,
@@ -5741,6 +5922,11 @@ function precheck(cfg, t2, date) {
   if (cfg.tz && !isValidTimeZone(cfg.tz)) {
     process.stderr.write(t2("warn.tz", { tz: cfg.tz }) + "\n");
   }
+  if (!KNOWN_SOURCES.includes(cfg.source)) {
+    throw new InputError(
+      t2("err.source", { source: cfg.source, sources: KNOWN_SOURCES.join(", ") })
+    );
+  }
   const competition = resolveCompetition();
   if (competition !== DEFAULT_COMPETITION) {
     process.stderr.write(
@@ -6021,9 +6207,9 @@ async function cmdBracket(stage, opts, ctx) {
   out(disclaimer(t2, c));
   maybeStarNudge(ctx);
 }
-function cmdPrompt({ cfg }) {
+function cmdPrompt({ cfg }, io = {}) {
   try {
-    const payload = readCursorPayload();
+    const payload = "cursor" in io ? io.cursor : readCursorPayload();
     const team = resolveEnvTeam(process.env.CLAUDINHO_TEAM);
     const compact = !["0", "false", "no"].includes(
       (process.env.CLAUDINHO_COMPACT ?? "").toLowerCase()
@@ -6033,7 +6219,7 @@ function cmdPrompt({ cfg }) {
     const state = readCurrentState(cfg.source, resolveCompetition());
     const scoreLine = renderPrompt(state, { team, compact, max, flags: flagsEnabled() });
     out(renderPromptOutput(scoreLine, payload));
-    if (!state || shouldRefresh() || shouldRefreshFixtures(Date.now(), state)) {
+    if (!state && !isLockFresh() || shouldRefresh(Date.now(), state) || shouldRefreshFixtures(Date.now(), state)) {
       spawnRefresh(cfg.source);
     }
   } catch {
@@ -6046,7 +6232,7 @@ function cmdHook({ cfg }) {
     const state = readCurrentState(cfg.source, resolveCompetition());
     const ctx = renderHook(state, { team, flags: flagsEnabled() });
     if (ctx) out(ctx);
-    if (!state || shouldRefresh() || shouldRefreshFixtures(Date.now(), state)) {
+    if (!state && !isLockFresh() || shouldRefresh(Date.now(), state) || shouldRefreshFixtures(Date.now(), state)) {
       spawnRefresh(cfg.source);
     }
   } catch {
@@ -6663,7 +6849,7 @@ function handlePipeError(stream) {
 }
 handlePipeError(process.stdout);
 handlePipeError(process.stderr);
-var VERSION = "0.8.19";
+var VERSION = "0.9.0";
 var DISCLAIMER = "Claudinho is an independent fan project. Not affiliated with or endorsed by FIFA or Anthropic.";
 function ctxFrom(cmd) {
   let root = cmd;
@@ -6749,8 +6935,9 @@ program.command("share").description("print a shareable, copy-pasteable match sn
     fail(e);
   }
 });
-program.command("prompt").description("print a status line (Claude Code / Cursor CLI statusline, tmux, Starship, \u2026)").action((_opts, cmd) => {
-  cmdPrompt(ctxFrom(cmd));
+program.command("prompt").description("print a status line (Claude Code / Cursor CLI statusline, tmux, Starship, \u2026)").action(async (_opts, cmd) => {
+  const cursor = await readCursorPayloadBounded();
+  cmdPrompt(ctxFrom(cmd), { cursor });
 });
 var init = program.command("init").description("one-step setup for your agent: `init cursor` or `init claude`");
 init.command("cursor").description("set up claudinho for the Cursor CLI (statusline + MCP config)").option("--print", "print the config snippets for manual install instead of writing them").action((opts, cmd) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@claudinho/cli",
-  "version": "0.8.19",
+  "version": "0.9.0",
   "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",
@@ -58,10 +58,11 @@
   },
   "devDependencies": {
     "@types/node": "^22.20.0",
+    "@vitest/coverage-v8": "^4.1.9",
     "tsup": "^8.0.0",
     "typescript": "^5.7.0",
     "vitest": "^4.1.9",
-    "@claudinho/core": "0.8.19"
+    "@claudinho/core": "0.9.0"
   },
   "scripts": {
     "build": "tsup",