@claudinho/cli 0.8.12 → 0.8.14

package/README.md

@@ -2,6 +2,8 @@
 
 **The 2026 men's football tournament, right in your terminal.** Live scores, fixtures, group tables, and market signals — TZ-aware, localized, scriptable. No API key, no signup.
 
+> ⭐ 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.)
+
 ## Install
 
 ```bash
@@ -48,6 +50,7 @@ claudinho init-cursor-statusline  # (granular) wire just the Cursor CLI statusli
 claudinho hook              # live-score context for a Claude Code hook (silent off-match)
 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 ⭐)
 ```
 
 ### Examples

package/dist/index.js

@@ -4918,6 +4918,37 @@ function writeMarketCache(source, competition, attempted, fetched, now = Date.no
   }
 }
 
+// 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";
+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");
+}
+function shouldNudge(runCount, every = NUDGE_EVERY) {
+  return runCount > 0 && runCount % every === 0;
+}
+function bumpRunCount(path = counterPath()) {
+  try {
+    let count = 0;
+    try {
+      const raw = JSON.parse(readFileSync2(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");
+    return count;
+  } catch {
+    return void 0;
+  }
+}
+
 // src/clipboard.ts
 import { spawnSync } from "child_process";
 function clipboardTools(platform) {
@@ -4947,30 +4978,30 @@ function copyToClipboard(text, platform = process.platform) {
 // src/cache.ts
 import {
   closeSync,
-  mkdirSync as mkdirSync2,
+  mkdirSync as mkdirSync3,
   openSync,
-  readFileSync as readFileSync2,
+  readFileSync as readFileSync3,
   renameSync as renameSync2,
   rmSync,
   statSync,
   writeSync
 } from "fs";
-import { homedir as homedir2 } from "os";
-import { join as join2 } from "path";
+import { homedir as homedir3 } from "os";
+import { join as join3 } from "path";
 var LOCK_STALE_MS = 6e4;
 function cacheDir2() {
-  const base = process.env.XDG_CACHE_HOME || join2(homedir2(), ".cache");
-  return join2(base, "claudinho");
+  const base = process.env.XDG_CACHE_HOME || join3(homedir3(), ".cache");
+  return join3(base, "claudinho");
 }
 function cachePath2() {
-  return join2(cacheDir2(), "state.json");
+  return join3(cacheDir2(), "state.json");
 }
 function lockPath() {
-  return join2(cacheDir2(), "refresh.lock");
+  return join3(cacheDir2(), "refresh.lock");
 }
 function readState() {
   try {
-    return JSON.parse(readFileSync2(cachePath2(), "utf8"));
+    return JSON.parse(readFileSync3(cachePath2(), "utf8"));
   } catch {
     return void 0;
   }
@@ -4981,8 +5012,8 @@ function readCurrentState(source, competition) {
 }
 function writeState(state) {
   const dir = cacheDir2();
-  mkdirSync2(dir, { recursive: true });
-  const tmp = join2(dir, `state.${process.pid}.tmp`);
+  mkdirSync3(dir, { recursive: true });
+  const tmp = join3(dir, `state.${process.pid}.tmp`);
   writeFileSync_(tmp, JSON.stringify(state));
   renameSync2(tmp, cachePath2());
 }
@@ -5007,7 +5038,7 @@ function fixturesAgeMs(state, now = Date.now()) {
 function lockAgeMs(now = Date.now()) {
   const lp = lockPath();
   try {
-    const contents = readFileSync2(lp, "utf8");
+    const contents = readFileSync3(lp, "utf8");
     const written = Number.parseInt(contents.split(/\s+/)[1] ?? "", 10);
     if (Number.isFinite(written)) return now - written;
   } catch {
@@ -5023,7 +5054,7 @@ function isLockFresh(now = Date.now()) {
   return lockAgeMs(now) < LOCK_STALE_MS;
 }
 function acquireLock(now = Date.now()) {
-  mkdirSync2(cacheDir2(), { recursive: true });
+  mkdirSync3(cacheDir2(), { recursive: true });
   const lp = lockPath();
   try {
     const fd = openSync(lp, "wx");
@@ -5267,7 +5298,7 @@ function spawnRefresh(source) {
 }
 
 // src/cursorPayload.ts
-import { readFileSync as readFileSync3 } from "fs";
+import { readFileSync as readFileSync4 } from "fs";
 function parseCursorPayload(raw) {
   try {
     const trimmed = raw.trim();
@@ -5280,7 +5311,7 @@ function parseCursorPayload(raw) {
 function readCursorPayload() {
   try {
     if (process.stdin.isTTY) return void 0;
-    return parseCursorPayload(readFileSync3(0, "utf8"));
+    return parseCursorPayload(readFileSync4(0, "utf8"));
   } catch {
     return void 0;
   }
@@ -5323,17 +5354,17 @@ ${meta}`;
 import {
   copyFileSync,
   existsSync,
-  mkdirSync as mkdirSync3,
-  readFileSync as readFileSync4,
-  writeFileSync as writeFileSync2
+  mkdirSync as mkdirSync4,
+  readFileSync as readFileSync5,
+  writeFileSync as writeFileSync3
 } from "fs";
-import { homedir as homedir3 } from "os";
-import { dirname, join as join3 } from "path";
+import { homedir as homedir4 } from "os";
+import { dirname as dirname2, join as join4 } from "path";
 function claudeSettingsPath() {
-  return join3(homedir3(), ".claude", "settings.json");
+  return join4(homedir4(), ".claude", "settings.json");
 }
 function cursorCliConfigPath() {
-  return join3(homedir3(), ".cursor", "cli-config.json");
+  return join4(homedir4(), ".cursor", "cli-config.json");
 }
 function isSameCommand(configured, requested) {
   return configured === requested;
@@ -5364,7 +5395,7 @@ function restartMessage(target) {
 function readSettings(path, snippet) {
   if (!existsSync(path)) return {};
   try {
-    return JSON.parse(readFileSync4(path, "utf8"));
+    return JSON.parse(readFileSync5(path, "utf8"));
   } catch {
     return {
       action: "manual",
@@ -5395,8 +5426,8 @@ function initStatuslineFor(target, opts = {}) {
   }
   backupOnce(path);
   settings.statusLine = sl;
-  mkdirSync3(dirname(path), { recursive: true });
-  writeFileSync2(path, JSON.stringify(settings, null, 2) + "\n", "utf8");
+  mkdirSync4(dirname2(path), { recursive: true });
+  writeFileSync3(path, JSON.stringify(settings, null, 2) + "\n", "utf8");
   const surface = target === "cursor" ? "Cursor CLI statusline" : "Statusline";
   return {
     action: "written",
@@ -5442,8 +5473,8 @@ function initHook(opts = {}) {
   const hooks = settings.hooks;
   hooks[CLAUDE_HOOK_EVENT] ??= [];
   hooks[CLAUDE_HOOK_EVENT].push({ hooks: [{ type: "command", command }] });
-  mkdirSync3(dirname(path), { recursive: true });
-  writeFileSync2(path, JSON.stringify(settings, null, 2) + "\n", "utf8");
+  mkdirSync4(dirname2(path), { recursive: true });
+  writeFileSync3(path, JSON.stringify(settings, null, 2) + "\n", "utf8");
   return {
     action: "written",
     path,
@@ -5530,6 +5561,12 @@ function resolveTeamArg(team, usage) {
   if (!code) throw new InputError(usage);
   return code.toUpperCase();
 }
+var MEX_RALLY = "\xBFY si s\xED?";
+function mexRally(m, cfg, c) {
+  if (cfg.flavor === "off") return void 0;
+  if (m.home.code !== "MEX" && m.away.code !== "MEX") return void 0;
+  return c.green(MEX_RALLY);
+}
 async function cmdToday(date, ctx) {
   const { cfg, t: t2 } = ctx;
   precheck(cfg, t2, date);
@@ -5561,6 +5598,8 @@ async function cmdToday(date, ctx) {
       out(matchLine(m, cfg, t2, c, flags));
       const s = signals.get(m.id);
       if (s) out("    " + c.dim(marketLine(s, m)));
+      const rally = mexRally(m, cfg, c);
+      if (rally) out("    " + rally);
     }
   }
   out();
@@ -5568,6 +5607,7 @@ async function cmdToday(date, ctx) {
   const src = dataSource(source, cfg.lang, c);
   if (src) out(src);
   out(disclaimer(t2, c));
+  maybeStarNudge(ctx);
 }
 async function cmdLive(ctx) {
   const { cfg, t: t2 } = ctx;
@@ -5594,6 +5634,7 @@ async function cmdLive(ctx) {
   const src = dataSource(source, cfg.lang, c);
   if (src) out(src);
   out(disclaimer(t2, c));
+  maybeStarNudge(ctx);
 }
 async function cmdNext(team, ctx) {
   const { cfg, t: t2, now } = ctx;
@@ -5626,10 +5667,13 @@ async function cmdNext(team, ctx) {
       `${stage}${formatKickoff(fixture.kickoff, { tz: cfg.tz, locale: cfg.lang })} \xB7 ` + t2("next.in", { countdown: countdown(fixture.kickoff) })
     )
   );
+  const rally = mexRally(fixture, cfg, c);
+  if (rally) out("  " + rally);
   out();
   const src = dataSource(source, cfg.lang, c);
   if (src) out(src);
   out(disclaimer(t2, c));
+  maybeStarNudge(ctx);
 }
 async function cmdTable(group, ctx) {
   const { cfg, t: t2 } = ctx;
@@ -5692,6 +5736,7 @@ async function cmdTable(group, ctx) {
   const src = dataSource(source, cfg.lang, c);
   if (src) out(src);
   out(disclaimer(t2, c));
+  maybeStarNudge(ctx);
 }
 var BRACKET_STAGES = /* @__PURE__ */ new Set(["R32", "R16", "QF", "SF", "3P", "F"]);
 async function cmdBracket(stage, opts, ctx) {
@@ -5743,6 +5788,7 @@ async function cmdBracket(stage, opts, ctx) {
   const src = dataSource(source, cfg.lang, c);
   if (src) out(src);
   out(disclaimer(t2, c));
+  maybeStarNudge(ctx);
 }
 function cmdPrompt({ cfg }) {
   try {
@@ -5788,13 +5834,19 @@ function printInitResult(res, cfg) {
   out(`${mark} ${res.message}`);
 }
 function cmdInitStatusline(opts, { cfg }) {
-  printInitResult(initStatusline({ print: opts.print, command: opts.command }), cfg);
+  const res = initStatusline({ print: opts.print, command: opts.command });
+  printInitResult(res, cfg);
+  if (!opts.print && res.action === "written") printInitStarCta(cfg);
 }
 function cmdInitHook(opts, { cfg }) {
-  printInitResult(initHook({ print: opts.print, command: opts.command }), cfg);
+  const res = initHook({ print: opts.print, command: opts.command });
+  printInitResult(res, cfg);
+  if (!opts.print && res.action === "written") printInitStarCta(cfg);
 }
 function cmdInitCursorStatusline(opts, { cfg }) {
-  printInitResult(initCursorStatusline({ print: opts.print, command: opts.command }), cfg);
+  const res = initCursorStatusline({ print: opts.print, command: opts.command });
+  printInitResult(res, cfg);
+  if (!opts.print && res.action === "written") printInitStarCta(cfg);
 }
 var CURSOR_MCP_SNIPPET = `{
   "mcpServers": {
@@ -5819,6 +5871,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);
 }
 function cmdInitClaude(opts, { cfg }) {
   if (opts.print) {
@@ -5839,6 +5892,7 @@ function cmdInitClaude(opts, { cfg }) {
   out(`  ${CLAUDE_MCP_ONELINER}`);
   out("");
   out("\u2192 Restart Claude Code to see it.");
+  printInitStarCta(cfg);
 }
 async function cmdMatch(id, ctx) {
   const { cfg, t: t2 } = ctx;
@@ -5887,6 +5941,7 @@ async function cmdMatch(id, ctx) {
   const src = dataSource(liveSource, cfg.lang, c);
   if (src) out(src);
   out(disclaimer(t2, c));
+  maybeStarNudge(ctx);
 }
 var MARKET_INFO = "Prediction-market data is informational only.";
 function marketDisplayable(match, sig) {
@@ -6311,6 +6366,34 @@ function vibePool(todayLocal, fixtures = allFixtures()) {
   if (todayLocal === last) return [...VIBES, ...VIBES_FINAL];
   return VIBES;
 }
+function cmdStar(ctx) {
+  const { cfg } = ctx;
+  if (cfg.json) {
+    emitJson({ repo: REPO_URL, hashtag: "#VibingLaVidaLoca" });
+    return;
+  }
+  const c = painterFor(cfg);
+  out();
+  out("  " + c.bold("\u2B50 Star Claudinho on GitHub"));
+  out("  " + c.cyan(REPO_URL));
+  out();
+  out("  " + c.dim("Built for devs & fans \xB7 #VibingLaVidaLoca \u26BD"));
+  out("  " + c.dim("Live World Cup scores in your terminal, Claude Code & Cursor \u2014 no API keys."));
+  out();
+}
+function maybeStarNudge(ctx) {
+  if (ctx.cfg.json || !process.stdout.isTTY || process.env.CLAUDINHO_NO_STAR) return;
+  const n = bumpRunCount();
+  if (n === void 0 || !shouldNudge(n)) return;
+  const c = painterFor(ctx.cfg);
+  out();
+  out(c.dim(`  \u2B50 Enjoying Claudinho? Star it \u2192 ${REPO_URL}   (claudinho star)`));
+}
+function printInitStarCta(cfg) {
+  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}`));
+}
 function cmdVibe(ctx) {
   const { cfg } = ctx;
   const pool = vibePool(localDate((ctx.now ?? /* @__PURE__ */ new Date()).toISOString(), cfg.tz));
@@ -6344,7 +6427,7 @@ function handlePipeError(stream) {
 }
 handlePipeError(process.stdout);
 handlePipeError(process.stderr);
-var VERSION = "0.8.12";
+var VERSION = "0.8.14";
 var DISCLAIMER = "Claudinho is an independent fan project. Not affiliated with or endorsed by FIFA or Anthropic.";
 function ctxFrom(cmd) {
   let root = cmd;
@@ -6468,6 +6551,9 @@ program.command("init-hook").description("wire the live-score hook into Claude C
 program.command("vibe").description("print a matchday-coder one-liner (#VibingLaVidaLoca)").action((_opts, cmd) => {
   cmdVibe(ctxFrom(cmd));
 });
+program.command("star").description("how to support Claudinho \u2014 star the repo \u2B50").action((_opts, cmd) => {
+  cmdStar(ctxFrom(cmd));
+});
 var refreshCmd = new Command("_refresh").description("(internal) refresh the statusline cache").action(async (_opts, cmd) => {
   try {
     await cmdRefresh(ctxFrom(cmd));

package/package.json

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