@claudinho/cli 0.11.1 → 0.11.2

package/README.md

@@ -1,6 +1,6 @@
 # @claudinho/cli ⚽
 
-**Live football scores, fixtures and standings in your terminal and your Claude Code and Cursor CLI statusline, for the competition you follow: the World Cup, the Premier League, LALIGA, the Champions League and 12 more.** The `claudinho` command: TZ-aware, localized, scriptable, with read-only market signals for the World Cup. No API key, no signup. It ran the 2026 World Cup from the opener to the final.
+**Live football scores, fixtures and standings in your terminal and your Claude Code and Cursor CLI statusline (and, for a program, `claudinho ambient --json`: the statusline and the hook as one JSON object), for the competition you follow: the World Cup, the Premier League, LALIGA, the Champions League and 12 more.** The `claudinho` command: TZ-aware, localized, scriptable, with read-only market signals for the World Cup. No API key, no signup. It ran the 2026 World Cup from the opener to the final.
 
 > ⭐ Installing via `npx` or globally? **[Star the repo](https://github.com/arturogarrido/claudinho)**: a fan project runs on stars. (`claudinho star` shows you how anytime.)
 
@@ -53,9 +53,11 @@ claudinho share [target]    # copy-pasteable snippet: today | live | <date> | <i
 claudinho prompt            # one compact status line (for statusline/tmux/Starship)
 claudinho init cursor       # one-step Cursor setup: statusline + MCP paste (--print for snippets)
 claudinho init claude       # one-step Claude Code setup: statusline + hook + MCP one-liner
+claudinho init plugin       # remove the statusline and hook init claude wrote, for the Claude Code plugin
 claudinho init-statusline   # (granular) wire just the Claude Code statusline
 claudinho init-cursor-statusline  # (granular) wire just the Cursor CLI statusline
 claudinho hook              # live-score context for a Claude Code hook (silent off-match)
+claudinho ambient --json    # the statusline and the hook as one JSON object, for a program (--columns N)
 claudinho init-hook         # (granular) make Claude itself score-aware (UserPromptSubmit)
 claudinho vibe              # a matchday-coder one-liner (#VibingLaVidaLoca)
 claudinho star              # how to support the project (star the repo ⭐)
@@ -109,7 +111,7 @@ CLAUDINHO_COMPETITION=laliga claudinho table          # the environment works to
 | `--tz <zone>` | IANA timezone, e.g. `America/Mexico_City` (also `CLAUDINHO_TZ`; default: system). Kickoff times **and** which day a fixture falls on are computed in this zone: a late-night-UTC match shows on the day you actually watch it. |
 | `--json` | machine-readable output for scripting |
 | `--no-color` | disable ANSI color (also honors `NO_COLOR`; auto-off when piped) |
-| `-c, --competition <alias\|slug>` | the competition: an alias such as `premier-league` (the sixteen competitions are listed in the [root README](https://github.com/arturogarrido/claudinho#competitions)), or an ESPN slug such as `eng.1` (any other lower-case dotted ESPN slug works too, labelled experimental). Also `CLAUDINHO_COMPETITION` (an alias or a slug), which the statusline and the hook follow, and the choice `claudinho follow <alias>` saves: the flag, then the environment, then the saved choice; with none, a command says so (exit 1; `--json` prints `{ "competition": null, "noCompetition": true }`), the statusline reads `⚽ claudinho follow`, and the hook stays silent. Every answer names its competition on a line after its header (`Premier League · from the command line`; first where an answer has none; `table` once, before its tables) and in `--json` as `competition`; `share` prints no such line: its card's title names the competition and its run cue selects it; `team` names the World Cup roster it reads. An unknown value is refused with the list. |
+| `-c, --competition <alias\|slug>` | the competition: an alias such as `premier-league` (the sixteen competitions are listed in the [root README](https://github.com/arturogarrido/claudinho#competitions)), or an ESPN slug such as `eng.1` (any other lower-case dotted ESPN slug works too, labelled experimental). Also `CLAUDINHO_COMPETITION` (an alias or a slug), which the statusline, the hook and `ambient --json` follow, and the choice `claudinho follow <alias>` saves: the flag, then the environment, then the saved choice; with none, a command says so (exit 1; `--json` prints `{ "competition": null, "noCompetition": true }`), the statusline reads `⚽ claudinho follow` (`ambient --json` prints it as `line` beside `competition: null`), and the hook stays silent. Every answer names its competition on a line after its header (`Premier League · from the command line`; first where an answer has none; `table` once, before its tables) and in `--json` as `competition`; `share` prints no such line: its card's title names the competition and its run cue selects it; `team` names the World Cup roster it reads. An unknown value is refused with the list. |
 | `--source <name>` | live data provider (advanced; sensible default) |
 | `--flavor <level>` | commentary flair: `off`, `subtle`, `full` (default: `full`; also `CLAUDINHO_FLAVOR`) |
 | `--no-markets` | hide prediction-market signals in `today`/`match` (also `CLAUDINHO_MARKETS=off`) |
@@ -271,6 +273,24 @@ Wires `claudinho hook` into Claude Code's `UserPromptSubmit`. During a match,
 the live score is injected into Claude's context so it can mention it naturally;
 off-match it's silent (zero added tokens). Restart Claude Code to activate.
 
+**Moving to the Claude Code plugin?** `claudinho init plugin` removes the statusline
+(`claudinho prompt`) and the live-score hook (`claudinho hook`) that `init claude` wrote to
+`~/.claude/settings.json`, keeps every other setting, then prints the plugin's install line and the
+MCP one-liner; an edited command (a wrapper, `npx -y @claudinho/cli hook`) stays, and it names it.
+The plugin itself (the band above the prompt, the score toasts, the prompt context) installs from the
+repository: see the [Claude Code plugin](https://github.com/arturogarrido/claudinho#claude-code-plugin) section.
+
+### For a program: `claudinho ambient --json`
+
+`claudinho ambient --json [--columns N]` prints the statusline and the hook as one JSON object on
+one line, for a program that draws them itself: `line` (what `claudinho prompt` prints, fitted to N
+columns with the `+N` count kept; N a positive integer), `context` (the hook's block, or `null`),
+`live` (the live matches, each marked `picked` and `pinned`), `current` (an empty list means nothing
+is on only when this is true), `next`, `pick`, `competition`, `degraded`, `source`, `updatedAt`,
+`staleAfter` and `disclaimer` (the non-affiliation sentence). Beside `line` the view says what the line is, `idle` (the edition-complete line, however narrow it was fitted) and `empty` (nothing known), read before the fit so a program never reads a pace or a visibility off the text; and each live record carries `line`, the hook's own line for it with its flags and roster names, which a program says and never composes. It reads only the local cache, never
+the network; the command itself exits 0 whatever the cache holds, and any other `--columns` value is
+refused by the option parser, as a wrong option is for every command.
+
 ## Statusline (Cursor CLI)
 
 ```bash

package/dist/index.js

@@ -762,7 +762,7 @@ function formatTime(iso, opts = {}) {
   }).format(when);
 }
 var COUNTDOWN_NOW = "now";
-function countdown(iso, from = /* @__PURE__ */ new Date()) {
+function countdown(iso, from) {
   const when = parsedDate(iso);
   if (!when) return UNKNOWN_TIME;
   const ms = when.getTime() - from.getTime();
@@ -775,7 +775,7 @@ function countdown(iso, from = /* @__PURE__ */ new Date()) {
   if (hours > 0) return `${hours}h${mins}m`;
   return `${mins}m`;
 }
-function countdownPhrase(lang, iso, from = /* @__PURE__ */ new Date()) {
+function countdownPhrase(lang, iso, from) {
   const left = countdown(iso, from);
   return left === COUNTDOWN_NOW ? t(lang, "countdown.now") : t(lang, "next.in", { countdown: left });
 }
@@ -4745,7 +4745,7 @@ function fetchMeta(result) {
 }
 var ESPN_SOCCER = "https://site.api.espn.com/apis/site/v2/sports/soccer";
 var DEFAULT_COMPETITION = BUNDLED_SLUG;
-var USER_AGENT = `claudinho/${"0.11.1"} (+https://github.com/arturogarrido/claudinho)`;
+var USER_AGENT = `claudinho/${"0.11.2"} (+https://github.com/arturogarrido/claudinho)`;
 var MAX_RESPONSE_BYTES = 5 * 1024 * 1024;
 var DEFAULT_COOLDOWN_MS = 5 * 6e4;
 var MAX_COOLDOWN_MS = 15 * 6e4;
@@ -6237,6 +6237,9 @@ function mergeLive(base, live) {
 function clockOf(adapter) {
   return new Date(adapter.now?.() ?? Date.now());
 }
+function requestClock(adapter, given) {
+  return given ?? clockOf(adapter);
+}
 function providerDayOf(adapter, instant) {
   if (Number.isNaN(instant.getTime())) return "";
   return adapter.bucketDay?.(instant) || instant.toISOString().slice(0, 10);
@@ -6411,7 +6414,7 @@ async function marketFixtureForTeam(adapter, code, now = /* @__PURE__ */ new Dat
   });
   let refreshRead = {};
   if (candidate) {
-    const { partial, served: _served, ...r } = await getMatchById(adapter, candidate.id);
+    const { partial, served: _served, ...r } = await getMatchById(adapter, candidate.id, now);
     refreshRead = partial ? { partial } : {};
     const m = r.degraded ? candidate : r.match ?? candidate;
     if (!isFinished(m.status)) return { ...r, match: m, ...bothReads(windowRead, refreshRead) };
@@ -8730,6 +8733,14 @@ function makeT(lang) {
   };
 }
 
+// src/options.ts
+import { InvalidArgumentError } from "commander";
+function positiveInteger(value) {
+  const n = /^\d+$/.test(value) ? Number.parseInt(value, 10) : 0;
+  if (!(n > 0)) throw new InvalidArgumentError("a positive integer");
+  return n;
+}
+
 // src/tagline.ts
 var NAMED = ["the World Cup", "the Premier League", "LALIGA", "the Champions League"];
 var TAGLINE = `Live football scores, fixtures and standings in your terminal and your Claude Code and Cursor CLI statusline, for the competition you follow: ${NAMED.join(", ")} and ${SUPPORTED.length - NAMED.length} more.`;
@@ -8969,7 +8980,9 @@ function readState(source, competition) {
     const bytes = readSmallFile(cachePath(source, competition), MAX_STATE_BYTES);
     if (!bytes) return void 0;
     const parsed = JSON.parse(bytes.toString("utf8"));
-    return isCacheState(parsed) ? parsed : void 0;
+    if (!isCacheState(parsed)) return void 0;
+    if (parsed.liveComplete !== void 0 && typeof parsed.liveComplete !== "boolean") delete parsed.liveComplete;
+    return parsed;
   } catch {
     return void 0;
   }
@@ -9448,6 +9461,7 @@ function applyDiscovery(prev, answer, now) {
 // src/statusline.ts
 var DISPLAY_STALE_MS = 5 * 6e4;
 var TOURNAMENT_COMPLETE_LINE = "\u26BD World Cup 2026 is complete \xB7 claudinho follow --list";
+var NOTHING_KNOWN_LINE = "\u26BD \u2014";
 var FIRST_RUN_LINE = "\u26BD claudinho follow";
 function pickAmbientMatch(matches, pick2) {
   if (!pick2) return [...matches];
@@ -9577,7 +9591,11 @@ function liveMatchesFromCache(state, nowMs, kind) {
 var DEFAULT_MAX_SEGMENTS = 8;
 var MAX_LINE_COLUMNS = 200;
 function renderPrompt(state, opts = {}) {
-  return truncateVisible(renderPromptLine(state, opts), MAX_LINE_COLUMNS);
+  return promptLine(state, opts).line;
+}
+function promptLine(state, opts = {}) {
+  const unfitted = renderPromptLine(state, opts);
+  return { line: truncateVisible(unfitted, lineColumns(opts)), unfitted };
 }
 function renderPromptLine(state, opts = {}) {
   const now = opts.now ?? /* @__PURE__ */ new Date();
@@ -9589,52 +9607,77 @@ function renderPromptLine(state, opts = {}) {
   const kind = opts.teamKind ?? defaultTeamKind(defaultCompetition);
   const liveList = liveMatchesFromCache(state, nowMs, kind);
   const live = liveList.items;
-  const cachedFixtureList = sealFixtures(defaultCompetition ? state?.fixtures : state?.schedule?.fixtures, kind);
-  const cachedFixtures = defaultCompetition ? [...cachedFixtureList.items] : cachedFixtureList.items.filter((m) => hasLiveWindow(m.status));
-  const bundle = defaultCompetition ? allFixtures() : [];
-  const schedule = cachedFixtures.length ? mergeLive(bundle, cachedFixtures) : defaultCompetition ? void 0 : [];
+  const { cachedFixtures, schedule } = countdownSchedule(state, defaultCompetition, kind);
+  const width = lineColumns(opts);
   if (live.length > 0) {
     const ordered = pickAmbientMatch(live, pick2);
     const picked = ordered[0] !== void 0 && isPicked(ordered[0], pick2);
     const max = picked ? 1 : opts.max && opts.max > 0 ? Math.min(opts.max, DEFAULT_MAX_SEGMENTS) : DEFAULT_MAX_SEGMENTS;
     const shown = ordered.slice(0, max);
     const overflow = live.length - shown.length;
-    const marker = !liveList.complete ? " +more" : overflow > 0 ? ` +${overflow}` : "";
-    const body = "\u26BD " + shown.map((m) => matchSegment(m, compact, flags)).join(" \xB7 ");
-    return truncateVisible(body, MAX_LINE_COLUMNS - displayWidth(marker)) + marker;
+    return fitLiveLine(shown.map((m) => matchSegment(m, compact, flags)), overflow, liveList.complete, width);
   }
-  const cacheFresh = !!state && state.degraded !== true && ageMs(state, nowMs) < DISPLAY_STALE_MS;
-  if ((!cacheFresh || !liveList.complete) && !defaultCompetition) {
-    if (scheduleGateOpen(scheduleView(state?.schedule, nowMs), nowMs, { probe: false })) {
-      const win = pickAmbientMatch(
-        cachedFixtures.filter((m) => {
-          const k = Date.parse(m.kickoff);
-          return k <= nowMs && nowMs < k + LIVE_WINDOW_MS;
-        }).sort(byKickoff),
-        pick2
-      );
-      const first = win[0];
-      const matchup = first && isResolvedFixture(first) ? `${teamTok(first.home, flags)} vs ${teamTok(first.away, flags)} ` : "";
-      const more = win.length - 1;
-      return `\u26BD ${matchup}live \xB7 syncing\u2026` + (more > 0 ? ` +${more}` : "");
-    }
-  } else if (!cacheFresh || !liveList.complete) {
-    const win = pickAmbientMatch(fixturesInLiveWindow(nowMs, schedule), pick2);
+  const win = syncingWindow(state, nowMs, liveWhole(liveList.complete, state), defaultCompetition, cachedFixtures, schedule, pick2);
+  if (win) {
     const first = win[0];
-    if (first) {
-      const more = win.length - 1;
-      const matchup = isResolvedFixture(first) ? `${teamTok(first.home, flags)} vs ${teamTok(first.away, flags)} ` : "";
-      return `\u26BD ${matchup}live \xB7 syncing\u2026` + (more > 0 ? ` +${more}` : "");
-    }
+    const matchup = first && isResolvedFixture(first) ? `${teamTok(first.home, flags)} vs ${teamTok(first.away, flags)} ` : "";
+    const more = win.length - 1;
+    return fitWithMarker(`\u26BD ${matchup}live \xB7 syncing\u2026`, more > 0 ? ` +${more}` : "", width);
   }
-  const next = pickAmbientMatch(upcomingResolved(nowMs, schedule), pick2)[0];
+  const next = countdownFixture(nowMs, schedule, pick2);
   if (next) {
     return `${teamTok(next.home, flags)} vs ${teamTok(next.away, flags)} in ${countdown(next.kickoff, now)}`;
   }
   if (defaultCompetition && isTournamentWindowOver(nowMs, schedule)) {
     return TOURNAMENT_COMPLETE_LINE;
   }
-  return "\u26BD \u2014";
+  return NOTHING_KNOWN_LINE;
+}
+function lineColumns(opts) {
+  const c = opts.columns;
+  return typeof c === "number" && c >= 1 ? Math.min(Math.floor(c), MAX_LINE_COLUMNS) : MAX_LINE_COLUMNS;
+}
+function fitWithMarker(body, marker, width) {
+  const markerWidth = displayWidth(marker);
+  if (markerWidth > width) return truncateVisible(marker, width);
+  const room = width - markerWidth;
+  return (room < 1 ? "" : truncateVisible(body, room)) + marker;
+}
+function fitLiveLine(segments, overflow, complete, width) {
+  const markerFor = (dropped) => !complete ? " +more" : overflow + dropped > 0 ? ` +${overflow + dropped}` : "";
+  const bodyOf = (kept2) => "\u26BD " + segments.slice(0, kept2).join(" \xB7 ");
+  let kept = segments.length;
+  while (kept > 1 && displayWidth(bodyOf(kept)) + displayWidth(markerFor(segments.length - kept)) > width) kept--;
+  return fitWithMarker(bodyOf(kept), markerFor(segments.length - kept), width);
+}
+function countdownSchedule(state, defaultCompetition, kind) {
+  const cachedFixtureList = sealFixtures(defaultCompetition ? state?.fixtures : state?.schedule?.fixtures, kind);
+  const cachedFixtures = defaultCompetition ? [...cachedFixtureList.items] : cachedFixtureList.items.filter((m) => hasLiveWindow(m.status));
+  const bundle = defaultCompetition ? allFixtures() : [];
+  const schedule = cachedFixtures.length ? mergeLive(bundle, cachedFixtures) : defaultCompetition ? void 0 : [];
+  return { cachedFixtures, schedule };
+}
+function liveWhole(scanComplete, state) {
+  return scanComplete && state?.liveComplete !== false;
+}
+function syncingWindow(state, nowMs, liveComplete, defaultCompetition, cachedFixtures, schedule, pick2) {
+  const cacheFresh = !!state && state.degraded !== true && ageMs(state, nowMs) < DISPLAY_STALE_MS;
+  if (cacheFresh && liveComplete) return void 0;
+  if (!defaultCompetition) {
+    if (!scheduleGateOpen(scheduleView(state?.schedule, nowMs), nowMs, { probe: false })) return void 0;
+    return pickAmbientMatch(
+      cachedFixtures.filter((m) => {
+        const k = Date.parse(m.kickoff);
+        return k <= nowMs && nowMs < k + LIVE_WINDOW_MS;
+      }).sort(byKickoff),
+      pick2
+    );
+  }
+  const win = pickAmbientMatch(fixturesInLiveWindow(nowMs, schedule), pick2);
+  return win.length > 0 ? win : void 0;
+}
+function countdownFixture(nowMs, schedule, pick2) {
+  return pickAmbientMatch(upcomingResolved(nowMs, schedule), pick2)[0];
 }
 
 // src/hook.ts
@@ -9652,7 +9695,8 @@ function rosterPinned(t2, pin) {
   const { team } = lookupTeam(t2.code);
   return team ? { ...t2, name: team.name, flag: team.flag } : t2;
 }
-function line(m, flags, pin) {
+function hookLine(m, opts) {
+  const { flags, pin } = opts;
   const minute = m.status === "HT" ? "half-time" : m.minute ? `${m.minute}'` : "live";
   const h = rosterPinned(m.home, pin);
   const a = rosterPinned(m.away, pin);
@@ -9670,13 +9714,51 @@ function renderHook(state, opts = {}) {
   const live = pickAmbientMatch(liveList.items, opts.pick);
   const shown = live.slice(0, MAX_HOOK_MATCHES);
   const overflow = live.length - shown.length;
-  const lines = shown.map((mm) => line(mm, flags, pin)).join("\n");
+  const lines = shown.map((mm) => hookLine(mm, { flags, pin })).join("\n");
   const more = !liveList.complete ? "\n(more live matches may not be shown)" : overflow > 0 ? `
 (+${overflow} more not shown)` : "";
   return boundContext(`[Claudinho \u2014 live football scores right now]
 ${lines}`, more);
 }
 
+// src/ambient.ts
+function ambientView(state, opts = {}) {
+  const now = opts.now ?? /* @__PURE__ */ new Date();
+  const nowMs = now.getTime();
+  const defaultCompetition = opts.defaultCompetition ?? true;
+  const kind = opts.teamKind ?? defaultTeamKind(opts.defaultCompetition);
+  const pin = opts.pin ?? (opts.pick && "team" in opts.pick ? opts.pick.team : void 0);
+  const read = { ...opts, now };
+  const hookOpts = { flags: opts.flags ?? true, pin: defaultCompetition };
+  const list = liveMatchesFromCache(state, nowMs, kind);
+  const items = pickAmbientMatch(list.items, opts.pick).map((m) => ({
+    ...m,
+    picked: isPicked(m, opts.pick),
+    pinned: pin !== void 0 && (isPinnedSide(m.home, pin) || isPinnedSide(m.away, pin)),
+    line: hookLine(m, hookOpts)
+  }));
+  const prompt = promptLine(state, read);
+  const context = renderHook(state, read);
+  const { cachedFixtures, schedule } = countdownSchedule(state, defaultCompetition, kind);
+  const age = stampAgeMs(state?.updatedAt, nowMs);
+  const stamp = state && Number.isFinite(age) ? Date.parse(state.updatedAt) : void 0;
+  const staleAt = stamp === void 0 ? void 0 : new Date(stamp + DISPLAY_STALE_MS);
+  const syncing = list.items.length === 0 && syncingWindow(state, nowMs, liveWhole(list.complete, state), defaultCompetition, cachedFixtures, schedule, opts.pick) !== void 0;
+  return {
+    line: prompt.line,
+    idle: prompt.unfitted === TOURNAMENT_COMPLETE_LINE,
+    empty: prompt.unfitted === NOTHING_KNOWN_LINE,
+    context: context === "" ? null : context,
+    live: { items, total: list.total, shown: list.shown, truncated: list.truncated, complete: list.complete },
+    current: stamp !== void 0 && age < DISPLAY_STALE_MS && state?.degraded !== true && state?.liveComplete === true && !syncing,
+    next: countdownFixture(nowMs, schedule, opts.pick) ?? null,
+    degraded: state?.degraded === true,
+    source: typeof state?.source === "string" ? state.source : null,
+    updatedAt: stamp === void 0 ? null : new Date(stamp).toISOString(),
+    staleAfter: staleAt === void 0 || Number.isNaN(staleAt.getTime()) ? null : staleAt.toISOString()
+  };
+}
+
 // src/refresh.ts
 import { spawn } from "child_process";
 var MIN_REFRESH_MS = 12e3;
@@ -9721,6 +9803,8 @@ async function runRefresh(opts) {
               {
                 updatedAt: now.toISOString(),
                 live: [],
+                liveComplete: false,
+                // nothing was read
                 degraded: true,
                 // no live provider served this scope — never claim otherwise
                 source,
@@ -9754,6 +9838,8 @@ async function runRefresh(opts) {
         {
           updatedAt: now.toISOString(),
           live: [],
+          liveComplete: false,
+          // nothing was read
           degraded: until !== void 0,
           source,
           competition,
@@ -9796,6 +9882,7 @@ async function runRefresh(opts) {
     const { needLive, needFixtures } = plan(base);
     if (!needLive && !needFixtures) return;
     let live = base?.live ?? [];
+    let liveComplete = base ? base.liveComplete : false;
     let degraded = base?.degraded ?? false;
     let updatedAt = base?.updatedAt ?? now.toISOString();
     let fixtures = base?.fixtures;
@@ -9808,11 +9895,13 @@ async function runRefresh(opts) {
     const adapter = liveAdapter(source, competition, clock);
     if (needLive) {
       try {
-        const r = await getLiveMatches(adapter, now);
+        const r = await getLiveRead(adapter, now);
         live = r.matches;
+        liveComplete = r.complete === true;
         degraded = r.degraded;
         if (!r.degraded) season = r.season;
       } catch {
+        liveComplete = false;
         degraded = true;
       }
       updatedAt = now.toISOString();
@@ -9847,6 +9936,7 @@ async function runRefresh(opts) {
         {
           updatedAt,
           live,
+          ...liveComplete !== void 0 ? { liveComplete } : {},
           degraded,
           source,
           competition,
@@ -9935,6 +10025,7 @@ async function refreshOffBundle(c) {
     const clock = () => nowMs + (Date.now() - realStart);
     const adapter = liveAdapter(source, competition, clock);
     let live = base?.live ?? [];
+    let liveComplete = base ? base.liveComplete : false;
     let degraded = base?.degraded ?? false;
     let updatedAt = base?.updatedAt ?? NEVER;
     let season = sealSeason(base?.season);
@@ -9951,6 +10042,7 @@ async function refreshOffBundle(c) {
     const snapshot = (backoffUntil2) => ({
       updatedAt,
       live,
+      ...liveComplete !== void 0 ? { liveComplete } : {},
       degraded,
       source,
       competition,
@@ -10006,11 +10098,13 @@ async function refreshOffBundle(c) {
         try {
           const r = await getLiveRead(adapter, now);
           live = r.matches;
+          liveComplete = r.complete === true;
           degraded = r.degraded;
           if (!r.degraded) season = r.season;
           if (r.matches.length > 0) inPlayUntil = raiseInPlay(inPlayUntil, r.matches, nowMs);
           else if (!r.degraded && r.complete) inPlayUntil = void 0;
         } catch {
+          liveComplete = false;
           degraded = true;
         }
         updatedAt = new Date(liveAt).toISOString();
@@ -10127,6 +10221,9 @@ function manual(path, snippet, why) {
 ${snippet}` };
 }
 function readSettings(path, snippet) {
+  return readSettingsOr(path, (why) => manual(path, snippet, why));
+}
+function readSettingsOr(path, refuse) {
   let entry;
   try {
     entry = lstatSync3(path);
@@ -10134,15 +10231,15 @@ function readSettings(path, snippet) {
     return {};
   }
   if (entry.isSymbolicLink() && !existsSync(path)) {
-    return manual(path, snippet, "Settings path is a symlink to a missing file:");
+    return refuse("Settings path is a symlink to a missing file:");
   }
   let parsed;
   try {
     parsed = JSON.parse(readFileSync2(path, "utf8"));
   } catch {
-    return manual(path, snippet, "Could not parse");
+    return refuse("Could not parse");
   }
-  if (!isSettingsObject(parsed)) return manual(path, snippet, "Not a JSON settings object:");
+  if (!isSettingsObject(parsed)) return refuse("Not a JSON settings object:");
   return parsed;
 }
 function isInitResult(v) {
@@ -10233,6 +10330,86 @@ function initHook(opts = {}) {
     message: `Live-score hook configured in ${path}. Restart Claude Code; during matches, the score is injected into context on each prompt.`
   };
 }
+var PLUGIN_INSTALL_LINE = "/plugin install claudinho --marketplace arturogarrido/claudinho";
+var CLAUDE_MCP_ONELINER = "claude mcp add claudinho -- npx -y @claudinho/mcp";
+var PLUGIN_NEXT = `Install the plugin (in Claude Code), and the MCP tools (in a shell):
+${PLUGIN_INSTALL_LINE}
+${CLAUDE_MCP_ONELINER}`;
+var RUNS_CLAUDINHO = /claudinho/i;
+function initPlugin(opts = {}) {
+  const path = opts.path ?? claudeSettingsPath();
+  const refuse = (why) => ({
+    action: "manual",
+    path,
+    message: `${why} ${path}. Nothing was changed: remove the "statusLine" whose command is "${DEFAULT_PROMPT_COMMAND}" and the "hooks.${CLAUDE_HOOK_EVENT}" command "${HOOK_COMMAND}" yourself, if they are there.
+${PLUGIN_NEXT}`
+  });
+  const parsed = readSettingsOr(path, refuse);
+  if (isInitResult(parsed)) return parsed;
+  const settings = parsed;
+  if (settings.hooks !== void 0 && !isSettingsObject(settings.hooks)) {
+    return refuse('Unexpected "hooks" shape in');
+  }
+  const hooks = settings.hooks;
+  const eventSlot = hooks?.[CLAUDE_HOOK_EVENT];
+  if (eventSlot !== void 0 && (!Array.isArray(eventSlot) || !validHookMatchers(eventSlot))) {
+    return refuse(`Unexpected "hooks.${CLAUDE_HOOK_EVENT}" shape in`);
+  }
+  const left = /* @__PURE__ */ new Set();
+  const removed = [];
+  const statusLine = settings.statusLine;
+  if (isSettingsObject(statusLine) && typeof statusLine.command === "string") {
+    if (statusLine.command === DEFAULT_PROMPT_COMMAND) {
+      delete settings.statusLine;
+      removed.push("the statusline");
+    } else if (RUNS_CLAUDINHO.test(statusLine.command)) {
+      left.add(statusLine.command);
+    }
+  }
+  if (hooks && Array.isArray(eventSlot)) {
+    let dropped = 0;
+    const matchers = [];
+    for (const matcher of eventSlot) {
+      const commands = matcher.hooks;
+      if (!commands) {
+        matchers.push(matcher);
+        continue;
+      }
+      const kept = commands.filter((h) => h.command !== HOOK_COMMAND);
+      for (const h of kept) if (typeof h.command === "string" && RUNS_CLAUDINHO.test(h.command)) left.add(h.command);
+      dropped += commands.length - kept.length;
+      if (kept.length === commands.length) matchers.push(matcher);
+      else if (kept.length > 0) matchers.push({ ...matcher, hooks: kept });
+    }
+    if (dropped > 0) {
+      removed.push("the live-score hook");
+      if (matchers.length > 0) hooks[CLAUDE_HOOK_EVENT] = matchers;
+      else {
+        delete hooks[CLAUDE_HOOK_EVENT];
+        if (Object.keys(hooks).length === 0) delete settings.hooks;
+      }
+    }
+  }
+  const named = left.size ? `
+Left in place (not the commands init claude writes; remove them yourself if the plugin replaces them):
+${[...left].map((c) => `  ${c}`).join("\n")}` : "";
+  if (removed.length === 0) {
+    return {
+      action: "already",
+      path,
+      message: `Nothing init claude wrote is in ${path}; nothing was changed.${named}
+${PLUGIN_NEXT}`
+    };
+  }
+  backupOnce(path);
+  writeFileAtomic(path, JSON.stringify(settings, null, 2) + "\n", SETTINGS_WRITE);
+  return {
+    action: "written",
+    path,
+    message: `Removed ${removed.join(" and ")} that init claude wrote from ${path}.${named}
+${PLUGIN_NEXT}`
+  };
+}
 
 // src/providerBackoff.ts
 function persistBackoff(source, competition, until, nowMs) {
@@ -10357,8 +10534,8 @@ async function reliableMarketSignalFor(ctx, match) {
   const result = await reliableMarketSignals(ctx, [match]);
   return { signal: result.signals.get(match.id), complete: result.complete };
 }
-function out(line2 = "") {
-  process.stdout.write(line2 + "\n");
+function out(line = "") {
+  process.stdout.write(line + "\n");
 }
 function emitJson(data) {
   out(JSON.stringify(data, null, 2));
@@ -10443,13 +10620,16 @@ async function nextAsked(ctx, team, usage) {
   const { cfg, t: t2 } = ctx;
   const asked = teamAsked(team, cfg);
   if (!asked) throw new InputError(usage);
-  const now = ctx.now ?? /* @__PURE__ */ new Date();
   if ("pin" in asked) {
     const code2 = bundleApplies(cfg.competition) ? asked.pin.code : asked.pin.name;
-    return { code: code2, next: await nextFixtureForPin(adapterFor(ctx), asked.pin, now) };
+    const adapter2 = adapterFor(ctx);
+    const now2 = requestClock(adapter2, ctx.now);
+    return { code: code2, next: await nextFixtureForPin(adapter2, asked.pin, now2), now: now2 };
   }
   const code = teamQuery(asked.query, usage, t2, cfg.competition);
-  return { code, next: await getNextFixtureForTeam(adapterFor(ctx), code, now) };
+  const adapter = adapterFor(ctx);
+  const now = requestClock(adapter, ctx.now);
+  return { code, next: await getNextFixtureForTeam(adapter, code, now), now };
 }
 function nextEmptySentence(next, code, label2, cfg, t2) {
   return verdictNotice(next, cfg.lang) ?? nextHorizonSentence(next, code, cfg.lang) ?? nextNoneReadSentence(next, code, cfg.lang) ?? (next.degraded ? t2("live.degraded") : t2("next.none", { team: label2 }));
@@ -10463,12 +10643,23 @@ function resolveEnvTeam(raw, competition) {
   return /^[A-Za-z]{3}$/.test(raw) ? raw.toUpperCase() : void 0;
 }
 function ambientPick(cfg) {
+  return ambientPreference(cfg).pick;
+}
+function ambientPreference(cfg) {
   const raw = process.env.CLAUDINHO_TEAM;
   if (raw) {
     const code = resolveEnvTeam(raw, cfg.competition);
-    return code ? { code } : void 0;
+    return code ? { pick: { code }, unreadable: false } : { pick: void 0, unreadable: true };
   }
-  return cfg.pin ? { team: cfg.pin } : void 0;
+  return { pick: cfg.pin ? { team: cfg.pin } : void 0, unreadable: false };
+}
+function promptLineEnv() {
+  const compact = !["0", "false", "no"].includes(
+    (process.env.CLAUDINHO_COMPACT ?? "").toLowerCase()
+  );
+  const maxRaw = Number.parseInt(process.env.CLAUDINHO_MAX ?? "", 10);
+  const max = Number.isFinite(maxRaw) && maxRaw > 0 ? maxRaw : void 0;
+  return { compact, max };
 }
 async function cmdToday(date, ctx) {
   const { cfg, t: t2 } = ctx;
@@ -10569,7 +10760,7 @@ async function cmdLive(ctx) {
 async function cmdNext(team, ctx) {
   const { cfg, t: t2 } = ctx;
   precheck(cfg, t2);
-  const { code, next } = await nextAsked(ctx, team, teamUsage("next", cfg));
+  const { code, next, now } = await nextAsked(ctx, team, teamUsage("next", cfg));
   const { fixture, degraded, source } = next;
   const label2 = next.team?.name ?? next.query ?? code;
   if (cfg.json) {
@@ -10615,7 +10806,7 @@ async function cmdNext(team, ctx) {
   out(
     "  " + c.dim(
       joinSegments(
-        isLive(fixture.status) ? [stage, when] : [stage, when, countdownPhrase(cfg.lang, fixture.kickoff)]
+        isLive(fixture.status) ? [stage, when] : [stage, when, countdownPhrase(cfg.lang, fixture.kickoff, now)]
       )
     )
   );
@@ -10822,11 +11013,7 @@ function cmdPrompt({ cfg, now }, io = {}) {
       out(renderPromptOutput("\u26BD \u2014", payload));
       return;
     }
-    const compact = !["0", "false", "no"].includes(
-      (process.env.CLAUDINHO_COMPACT ?? "").toLowerCase()
-    );
-    const maxRaw = Number.parseInt(process.env.CLAUDINHO_MAX ?? "", 10);
-    const max = Number.isFinite(maxRaw) && maxRaw > 0 ? maxRaw : void 0;
+    const { compact, max } = promptLineEnv();
     const state = readCurrentState(cfg.source, cfg.competition);
     const scoreLine = renderPrompt(state, {
       // CLAUDINHO_TEAM by code (offline lookup — hot-path safe), else the saved pin.
@@ -10873,6 +11060,67 @@ function cmdHook({ cfg, now }) {
   } catch {
   }
 }
+var AMBIENT_EMPTY = JSON.stringify({ line: NOTHING_KNOWN_LINE, empty: true });
+function cmdAmbient({ cfg, now }, opts = {}) {
+  let printed = false;
+  try {
+    if (cfg.selection.kind === "none") {
+      out(
+        JSON.stringify({
+          ...selectionExtras(cfg.selection),
+          ...verdictExtras(selectionVerdict(cfg.selection)),
+          line: FIRST_RUN_LINE
+        })
+      );
+      return;
+    }
+    if (cfg.selection.kind !== "selected") {
+      out(AMBIENT_EMPTY);
+      return;
+    }
+    const { compact, max } = promptLineEnv();
+    const preference = ambientPreference(cfg);
+    const state = readCurrentState(cfg.source, cfg.competition);
+    const read = ambientView(state, {
+      pick: preference.pick,
+      // The SAVED pin, for each record's `pinned` (whatever CLAUDINHO_TEAM picks).
+      pin: cfg.pin,
+      compact,
+      max,
+      flags: flagsEnabled(),
+      defaultCompetition: bundleApplies(cfg.competition),
+      teamKind: teamKind(cfg.competition),
+      now,
+      columns: opts.columns
+    });
+    const pick2 = preference.pick;
+    const view = {
+      line: read.line,
+      idle: read.idle,
+      empty: read.empty,
+      context: read.context,
+      live: read.live,
+      current: read.current,
+      next: read.next,
+      pick: pick2 === void 0 ? null : "code" in pick2 ? { code: pick2.code } : pick2.team,
+      ...preference.unreadable ? { pickUnreadable: true } : {},
+      // A selected competition: core's key is present (see `selectionExtras`).
+      ...selectionExtras(cfg.selection),
+      degraded: read.degraded,
+      source: read.source,
+      updatedAt: read.updatedAt,
+      staleAfter: read.staleAfter,
+      disclaimer: DISCLAIMER
+    };
+    out(JSON.stringify(view));
+    printed = true;
+    if (refreshWanted(now?.getTime() ?? Date.now(), state, cfg.competition, cfg.source)) {
+      spawnRefresh(cfg.source, cfg.competition);
+    }
+  } catch {
+    if (!printed) out(AMBIENT_EMPTY);
+  }
+}
 async function cmdRefresh({ cfg }) {
   if (cfg.selection.kind !== "selected") return;
   await runRefresh({ source: cfg.source, competition: cfg.competition });
@@ -10911,7 +11159,6 @@ var CURSOR_MCP_SNIPPET = `{
     "claudinho": { "command": "npx", "args": ["-y", "@claudinho/mcp"] }
   }
 }`;
-var CLAUDE_MCP_ONELINER = "claude mcp add claudinho -- npx -y @claudinho/mcp";
 function cmdInitCursor(opts, { cfg }) {
   if (opts.print) {
     out("# 1) Cursor CLI statusline  \u2192  ~/.cursor/cli-config.json");
@@ -10957,12 +11204,17 @@ function cmdInitClaude(opts, { cfg }) {
   printInitChoose(cfg);
   if (statusRes.action === "written" || hookRes.action === "written") printInitStarCta(cfg);
 }
+function cmdInitPlugin({ cfg }) {
+  printInitResult(initPlugin(), cfg);
+}
 async function cmdMatch(id, ctx) {
   const { cfg, t: t2 } = ctx;
   precheck(cfg, t2);
-  const found = await getMatchById(adapterFor(ctx), id, ctx.now);
+  const adapter = adapterFor(ctx);
+  const now = requestClock(adapter, ctx.now);
+  const found = await getMatchById(adapter, id, now);
   const { match, degraded, source: liveSource } = found;
-  const market = match ? await reliableMarketSignalFor(ctx, match) : { signal: void 0, complete: true };
+  const market = match ? await reliableMarketSignalFor({ ...ctx, now }, match) : { signal: void 0, complete: true };
   if (cfg.json) {
     emitJson({
       degraded,
@@ -11040,7 +11292,7 @@ function noSignalLine(m, now, competition) {
   return isFinished(m.status) ? "Match has finished \u2014 market signals are pre-match and in-play reads." : "Match appears to have finished \u2014 market signals are pre-match and in-play reads.";
 }
 function printMarketBlock(m, sig, c) {
-  for (const line2 of marketBlock(sig, m)) out("    " + c.dim(line2));
+  for (const line of marketBlock(sig, m)) out("    " + c.dim(line));
 }
 async function cmdMarkets(target, team, ctx) {
   const { cfg, t: t2 } = ctx;
@@ -11097,7 +11349,6 @@ async function cmdMarkets(target, team, ctx) {
   }
   if (target && target !== "today" && !isValidDate(target)) {
     precheck(cfg, t2);
-    const now2 = ctx.now ?? /* @__PURE__ */ new Date();
     const scope = marketScopeVerdict(cfg.competition, 0);
     const outOfScope = verdictNotice(scope, cfg.lang);
     if (outOfScope !== void 0) {
@@ -11121,7 +11372,9 @@ async function cmdMarkets(target, team, ctx) {
       out(c3.dim(MARKET_INFO));
       return;
     }
-    const found = await getMatchById(adapterFor(ctx), target);
+    const adapter = adapterFor(ctx);
+    const now2 = requestClock(adapter, ctx.now);
+    const found = await getMatchById(adapter, target, now2);
     const { match } = found;
     const market = match && marketRelevant(match, now2) ? await marketSignalsFor(ctx, [match], MARKETS_CMD_OPTS) : { signals: /* @__PURE__ */ new Map(), complete: true };
     const sig = match ? market.signals.get(match.id) : void 0;
@@ -11356,15 +11609,17 @@ async function cmdShare(target, team, opts, ctx) {
   }
   if (target === "next") {
     precheck(cfg, t2);
-    const { code, next } = await nextAsked(ctx, team, teamUsage("share next", cfg));
-    const market2 = await reliableShareSignals(ctx, next.fixture ? [next.fixture] : []);
+    const { code, next, now } = await nextAsked(ctx, team, teamUsage("share next", cfg));
+    const market2 = await reliableShareSignals({ ...ctx, now }, next.fixture ? [next.fixture] : []);
     emitMatchCard(ctx, nextShareCard(next, code, market2, where), baseOptions, copy);
     return;
   }
   if (target && target !== "today" && !isValidDate(target)) {
     precheck(cfg, t2);
-    const found = await getMatchById(adapterFor(ctx), target, ctx.now);
-    const market2 = await reliableShareSignals(ctx, found.match ? [found.match] : []);
+    const adapter = adapterFor(ctx);
+    const now = requestClock(adapter, ctx.now);
+    const found = await getMatchById(adapter, target, now);
+    const market2 = await reliableShareSignals({ ...ctx, now }, found.match ? [found.match] : []);
     emitMatchCard(ctx, matchShareCard(found, target, market2, where), baseOptions, copy);
     return;
   }
@@ -11681,7 +11936,7 @@ function cmdVibe(ctx) {
   const { cfg } = ctx;
   const bundled = cfg.selection.kind === "selected" && bundleApplies(cfg.competition);
   const pool = vibePool(localDate((ctx.now ?? /* @__PURE__ */ new Date()).toISOString(), cfg.tz), bundled);
-  const line2 = pool[Math.floor(Math.random() * pool.length)];
+  const line = pool[Math.floor(Math.random() * pool.length)];
   let liveSeg;
   try {
     if (cfg.selection.kind !== "selected") throw new Error("no competition");
@@ -11695,12 +11950,12 @@ function cmdVibe(ctx) {
   } catch {
   }
   if (cfg.json) {
-    emitJson({ vibe: line2, tag: "#VibingLaVidaLoca", ...liveSeg ? { live: liveSeg } : {} });
+    emitJson({ vibe: line, tag: "#VibingLaVidaLoca", ...liveSeg ? { live: liveSeg } : {} });
     return;
   }
   const c = painterFor(cfg);
   out();
-  out("  \u26BD " + (liveSeg ? `${liveSeg} \u2014 ` : "") + c.bold(line2 ?? ""));
+  out("  \u26BD " + (liveSeg ? `${liveSeg} \u2014 ` : "") + c.bold(line ?? ""));
   out("  " + c.cyan("#VibingLaVidaLoca"));
   out();
 }
@@ -11714,7 +11969,7 @@ function handlePipeError(stream) {
 }
 handlePipeError(process.stdout);
 handlePipeError(process.stderr);
-var VERSION = "0.11.1";
+var VERSION = "0.11.2";
 var DISCLAIMER2 = `Claudinho is an ${FAN_PROJECT.toLowerCase()}. ${DISCLAIMER}`;
 function ctxFrom(cmd) {
   let root = cmd;
@@ -11813,7 +12068,10 @@ program.command("prompt").description("print a status line (Claude Code / Cursor
   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`");
+program.command("ambient").description("print the statusline and hook as one JSON object (for a program: the Claude Code plugin)").option("--columns <n>", "fit the line to this many display columns (a positive integer)", positiveInteger).action((opts, cmd) => {
+  cmdAmbient(ctxFrom(cmd), { columns: opts.columns });
+});
+var init = program.command("init").description("one-step setup for your agent: `init cursor` or `init claude`; `init plugin` for the Claude Code plugin");
 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) => {
   try {
     cmdInitCursor(opts, ctxFrom(cmd));
@@ -11828,6 +12086,13 @@ init.command("claude").description("set up claudinho for Claude Code (statusline
     fail(e);
   }
 });
+init.command("plugin").description("remove the statusline and hook that init claude wrote, for the Claude Code plugin").action((_opts, cmd) => {
+  try {
+    cmdInitPlugin(ctxFrom(cmd));
+  } catch (e) {
+    fail(e);
+  }
+});
 program.command("init-statusline").description("configure the Claude Code statusline to use claudinho").option("--print", "print the settings snippet instead of writing it").option("--command <cmd>", "command to run (default: claudinho prompt)").action((opts, cmd) => {
   try {
     cmdInitStatusline(opts, ctxFrom(cmd));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@claudinho/cli",
-  "version": "0.11.1",
+  "version": "0.11.2",
   "description": "Live football scores, fixtures and standings in your terminal and your Claude Code and Cursor CLI statusline, for the competition you follow: the World Cup, the Premier League, LALIGA, the Champions League and 12 more. No API key. Independent fan project. Not affiliated with FIFA, any confederation, league or club, or Anthropic.",
   "type": "module",
   "license": "MIT",
@@ -76,7 +76,7 @@
     "tsup": "^8.0.0",
     "typescript": "^5.7.0",
     "vitest": "^5.0.3",
-    "@claudinho/core": "0.11.1"
+    "@claudinho/core": "0.11.2"
   },
   "scripts": {
     "build": "tsup",