@claudinho/cli 0.3.0 → 0.4.1

package/README.md

@@ -24,6 +24,7 @@ claudinho next <TEAM>       # a team's next fixture + countdown   (e.g. next MEX
 claudinho table [GROUP]     # group standings (default: all groups)
 claudinho match <id>        # a single match's detail
 claudinho markets [target]  # prediction-market odds: today | <date> | <id> | next <TEAM>
+claudinho share [target]    # copy-pasteable match snippet: today | live | <date> | <id> | next <TEAM>
 claudinho prompt            # one compact status line (for statusline/tmux/Starship)
 claudinho init-statusline   # wire it into the Claude Code statusline
 claudinho hook              # live-score context for a Claude Code hook (silent off-match)
@@ -39,6 +40,7 @@ claudinho next BRA --tz America/Sao_Paulo --lang pt
 claudinho table A
 claudinho live --json | jq '.matches[].status'
 claudinho today --flavor off               # just the facts, no commentary
+claudinho share next MEX --copy            # a shareable card, copied to your clipboard
 ```
 
 ## Global options
@@ -95,6 +97,71 @@ statusline and hook **never** show market data — it stays off the hot path.
 > nothing. For an offline preview, set `CLAUDINHO_MARKETS_SOURCE=fake` to render
 > clearly-labeled synthetic **"demo data"** odds.
 
+## Shareable snippets
+
+`claudinho share` prints a polished, **copy-pasteable** match card for chats,
+social posts, READMEs, and issue comments — your terminal football, ready to post:
+
+```bash
+claudinho share                   # today's matches
+claudinho share live              # matches in play
+claudinho share next MEX          # a team's next fixture (+ market read, when reliable)
+claudinho share 760415            # one match by id
+claudinho share next MEX --copy   # …and copy it straight to the clipboard
+```
+
+```text
+Next up for Mexico
+
+🇲🇽 Mexico vs South Africa 🇿🇦
+Jun 11 · 13:00 America/Mexico_City
+Estadio Banorte, Mexico City, Mexico
+
+Prediction markets slightly favor Mexico.
+Mexico 56% · Draw 25% · South Africa 19%
+Source: Polymarket · informational only
+
+#VibingLaVidaLoca · Independent fan project · not affiliated with FIFA or Anthropic.
+Try it: npx @claudinho/cli next MEX
+```
+
+Snippets are **plain text** (no color codes — they paste cleanly everywhere) and
+carry the non-affiliation disclaimer on every paste. The market line uses the
+same reliable gate as `today`/`match` (**informational only — never betting
+advice**) and disappears when no reliable market exists. Per-command options:
+
+| Flag | Description |
+|---|---|
+| `--style <social\|compact>` | `social` (default) is the full card; `compact` is one terse line per match |
+| `--copy` | also copy the snippet to the clipboard (best-effort: `pbcopy`/`clip`/`wl-copy`/`xclip`/`xsel`) |
+| `--no-hashtag` | omit the `#VibingLaVidaLoca` tag |
+| `--no-install-line` | omit the `Try it: …` run cue |
+
+`--json` returns the structured snippet (`{ kind, snippet, matches, marketSignals, … }`)
+for scripts and future reuse. No clipboard tool? `claudinho share … | pbcopy` works too.
+
+### Want an image?
+
+The snippet is plain text, so a **screenshot is your share card** — the disclaimer
+and emoji flags come along automatically. Grab it with your OS screenshot tool, or
+render a crisp terminal image with an existing tool (no Claudinho dependency, no
+account):
+
+```bash
+# capture the command's output directly (charmbracelet/freeze)
+freeze --execute "claudinho share next MEX" -o card.png
+
+# …or pipe the text into freeze / silicon
+claudinho share next MEX | freeze --language text -o card.png
+claudinho share next MEX | silicon -l txt -o card.png
+
+# …or paste it into a web tool like carbon.now.sh or ray.so
+```
+
+Claudinho stays text-first — it doesn't ship an image renderer, so there's nothing
+extra to install in the CLI and no fonts/licensing to worry about: whatever your
+terminal or the screenshot tool already draws (including the flags) is what you get.
+
 ## Statusline (Claude Code)
 
 ```bash

package/dist/index.js

@@ -311,6 +311,25 @@ function formatKickoff(iso, opts = {}) {
     timeZone: tz
   }).format(new Date(iso));
 }
+function formatDate(iso, opts = {}) {
+  const tz = resolveTz(opts.tz);
+  const locale = safeLocale(opts.locale);
+  return new Intl.DateTimeFormat(locale, {
+    month: "short",
+    day: "numeric",
+    timeZone: tz
+  }).format(new Date(iso));
+}
+function formatTime(iso, opts = {}) {
+  const tz = resolveTz(opts.tz);
+  const locale = safeLocale(opts.locale);
+  return new Intl.DateTimeFormat(locale, {
+    hour: "2-digit",
+    minute: "2-digit",
+    hour12: false,
+    timeZone: tz
+  }).format(new Date(iso));
+}
 function countdown(iso, from = /* @__PURE__ */ new Date()) {
   const ms = new Date(iso).getTime() - from.getTime();
   if (ms <= 0) return "now";
@@ -3269,6 +3288,87 @@ async function getMarketSignals(provider, matches, options) {
     return { signals: /* @__PURE__ */ new Map(), checked: /* @__PURE__ */ new Set() };
   }
 }
+var SHARE_HASHTAG = "#VibingLaVidaLoca";
+var SHARE_DISCLAIMER = "Independent fan project \xB7 not affiliated with FIFA or Anthropic.";
+function mid(m) {
+  return isLive(m.status) || m.status === "FT" ? scoreline(m) : "vs";
+}
+function statusTail(m) {
+  switch (m.status) {
+    case "LIVE":
+      return m.minute ? `${m.minute}'` : "LIVE";
+    case "HT":
+      return "HT";
+    case "FT":
+      return "FT";
+    case "POSTPONED":
+      return "postponed";
+    case "CANCELLED":
+      return "cancelled";
+    default:
+      return "";
+  }
+}
+function compactLine(m, input, single) {
+  const home = `${m.home.flag} ${m.home.code}`;
+  const away = `${m.away.code} ${m.away.flag}`;
+  const opts = { tz: input.tz, locale: input.locale };
+  let tail;
+  if (m.status === "SCHEDULED") {
+    const time = formatTime(m.kickoff, opts);
+    tail = single ? `${formatDate(m.kickoff, opts)} ${time}` : time;
+  } else {
+    tail = statusTail(m);
+  }
+  return `${home} ${mid(m)} ${away}${tail ? ` \xB7 ${tail}` : ""}`;
+}
+function socialCard(m, input) {
+  const lines = [];
+  const head = `${m.home.flag} ${m.home.name} ${mid(m)} ${m.away.name} ${m.away.flag}`;
+  if (m.status === "SCHEDULED") {
+    lines.push(head);
+    const date = formatDate(m.kickoff, { tz: input.tz, locale: input.locale });
+    const time = formatTime(m.kickoff, { tz: input.tz, locale: input.locale });
+    const zone = input.tz ? ` ${input.tz}` : "";
+    lines.push(`${date} \xB7 ${time}${zone}`);
+  } else {
+    const tail = statusTail(m);
+    lines.push(tail ? `${head} \xB7 ${tail}` : head);
+  }
+  const loc = matchLocation(m);
+  if (loc) lines.push(loc);
+  return lines;
+}
+function formatShareSnippet(input, options = {}) {
+  const style = options.style ?? "social";
+  const includeMarkets = options.includeMarkets !== false;
+  const includeHashtag = options.includeHashtag !== false;
+  const includeInstall = options.includeInstallLine !== false;
+  const signals = input.marketSignals ?? /* @__PURE__ */ new Map();
+  const single = input.matches.length === 1;
+  const blocks = [input.title];
+  if (input.matches.length === 0) {
+    if (input.emptyNote) blocks.push(input.emptyNote);
+  } else if (style === "compact") {
+    blocks.push(input.matches.map((m) => compactLine(m, input, single)).join("\n"));
+  } else {
+    for (const m of input.matches) {
+      const card = socialCard(m, input);
+      const sig = includeMarkets ? signals.get(m.id) : void 0;
+      if (sig) {
+        if (single) card.push("", ...marketBlock(sig, m));
+        else card.push(marketLine(sig, m));
+      }
+      blocks.push(card.join("\n"));
+    }
+  }
+  const footer = [];
+  if (input.source) footer.push(`Live data: ${liveSourceLabel(input.source)}`);
+  footer.push([includeHashtag ? SHARE_HASHTAG : "", SHARE_DISCLAIMER].filter(Boolean).join(" \xB7 "));
+  if (includeInstall && input.installLine) footer.push(`Try it: ${input.installLine}`);
+  blocks.push(footer.join("\n"));
+  return blocks.join("\n\n");
+}
 
 // src/config.ts
 var SUPPORTED_LANGS = ["en", "es", "pt", "fr"];
@@ -3494,8 +3594,8 @@ function statusToken(m, t, c) {
 function matchLine(m, cfg, t, c) {
   const home = `${m.home.flag} ${m.home.name}`;
   const away = `${m.away.name} ${m.away.flag}`;
-  const mid = isLive(m.status) || m.status === "FT" ? c.bold(scoreline(m)) : c.dim("vs");
-  const left = `${home.padEnd(22)} ${mid.padStart(3)}  ${away}`;
+  const mid2 = isLive(m.status) || m.status === "FT" ? c.bold(scoreline(m)) : c.dim("vs");
+  const left = `${home.padEnd(22)} ${mid2.padStart(3)}  ${away}`;
   let right = "";
   if (m.status === "SCHEDULED") {
     right = c.dim(
@@ -3572,6 +3672,32 @@ function writeMarketCache(source, competition, attempted, fetched, now = Date.no
   }
 }
 
+// src/clipboard.ts
+import { spawnSync } from "child_process";
+function clipboardTools(platform) {
+  if (platform === "darwin") return [{ cmd: "pbcopy", args: [] }];
+  if (platform === "win32") return [{ cmd: "clip", args: [] }];
+  return [
+    { cmd: "wl-copy", args: [] },
+    { cmd: "xclip", args: ["-selection", "clipboard"] },
+    { cmd: "xsel", args: ["--clipboard", "--input"] }
+  ];
+}
+function copyToClipboard(text, platform = process.platform) {
+  for (const { cmd, args } of clipboardTools(platform)) {
+    try {
+      const res = spawnSync(cmd, args, {
+        input: text,
+        stdio: ["pipe", "ignore", "ignore"],
+        timeout: 1e3
+      });
+      if (!res.error && res.status === 0) return true;
+    } catch {
+    }
+  }
+  return false;
+}
+
 // src/cache.ts
 import {
   closeSync,
@@ -4319,6 +4445,165 @@ async function cmdMarkets(target, team, ctx) {
   out(disclaimer(t, c));
   out(c.dim(MARKET_INFO));
 }
+function pickShareStyle(v) {
+  return v === "compact" ? "compact" : "social";
+}
+async function reliableShareSignals(ctx, matches) {
+  const raw = await reliableMarketSignals(ctx, matches);
+  const out2 = /* @__PURE__ */ new Map();
+  for (const [id, s] of raw) if (marketDisplayable(s)) out2.set(id, s);
+  return out2;
+}
+function emitShare(ctx, e, copy) {
+  const snippet = formatShareSnippet(e.input, e.options);
+  if (ctx.cfg.json) {
+    emitJson({
+      kind: e.kind,
+      target: e.target,
+      ...e.team ? { team: e.team } : {},
+      source: e.input.source ?? null,
+      informationalOnly: true,
+      style: e.options.style ?? "social",
+      snippet,
+      matches: e.input.matches,
+      marketSignals: Object.fromEntries(e.input.marketSignals ?? /* @__PURE__ */ new Map())
+    });
+  } else {
+    out(snippet);
+  }
+  if (copy) {
+    const ok = (ctx.copy ?? copyToClipboard)(snippet);
+    process.stderr.write(
+      (ok ? "Copied share snippet to clipboard." : "Clipboard unavailable; printed snippet instead.") + "\n"
+    );
+  }
+}
+async function cmdShare(target, team, opts, ctx) {
+  const { cfg, t } = ctx;
+  const baseOptions = {
+    style: pickShareStyle(opts.style),
+    includeMarkets: cfg.markets !== false,
+    includeHashtag: opts.hashtag !== false,
+    includeInstallLine: opts.installLine !== false
+  };
+  const copy = opts.copy === true;
+  if (target === "live") {
+    precheck(cfg, t);
+    const { matches, source: source2 } = await getLiveMatches(adapterFor(ctx));
+    emitShare(
+      ctx,
+      {
+        kind: "live",
+        target: "live",
+        input: {
+          title: "Live match pulse",
+          matches,
+          source: source2,
+          emptyNote: "No matches in play right now.",
+          installLine: "npx @claudinho/cli live",
+          tz: cfg.tz,
+          locale: cfg.lang
+        },
+        // Live snippets stay lean: no market enrichment (and no extra fetch).
+        options: { ...baseOptions, includeMarkets: false }
+      },
+      copy
+    );
+    return;
+  }
+  if (target === "next") {
+    precheck(cfg, t);
+    if (!team) throw new InputError("Usage: claudinho share next <team>");
+    const code = team.toUpperCase();
+    const fixture = nextFixtureForTeam(code);
+    const matches = fixture ? [fixture] : [];
+    const signals2 = await reliableShareSignals(ctx, matches);
+    const teamName = fixture ? fixture.home.code === code ? fixture.home.name : fixture.away.name : code;
+    emitShare(
+      ctx,
+      {
+        kind: "next",
+        target: "next",
+        team: code,
+        input: {
+          title: `Next up for ${teamName}`,
+          matches,
+          marketSignals: signals2,
+          emptyNote: `No upcoming fixture found for ${code}.`,
+          installLine: `npx @claudinho/cli next ${code}`,
+          tz: cfg.tz,
+          locale: cfg.lang
+        },
+        options: baseOptions
+      },
+      copy
+    );
+    return;
+  }
+  if (target && target !== "today" && !isValidDate(target)) {
+    precheck(cfg, t);
+    const adapter = adapterFor(ctx);
+    let match = allFixtures().find((m) => m.id === target);
+    let source2;
+    try {
+      if (match) {
+        const live = await adapter.fetchByDate(match.kickoff.slice(0, 10));
+        match = live.find((m) => m.id === target) ?? match;
+        source2 = adapter.name;
+      }
+    } catch {
+    }
+    const matches = match ? [match] : [];
+    const signals2 = await reliableShareSignals(ctx, matches);
+    emitShare(
+      ctx,
+      {
+        kind: "match",
+        target,
+        input: {
+          title: "Match pulse",
+          matches,
+          marketSignals: signals2,
+          source: source2,
+          emptyNote: `No match found with id ${target}.`,
+          installLine: `npx @claudinho/cli match ${target}`,
+          tz: cfg.tz,
+          locale: cfg.lang
+        },
+        options: baseOptions
+      },
+      copy
+    );
+    return;
+  }
+  const explicitDate = target && target !== "today" ? target : void 0;
+  precheck(cfg, t, explicitDate);
+  const date = explicitDate ?? localDate((/* @__PURE__ */ new Date()).toISOString(), cfg.tz);
+  const { matches: all, source } = await getMatchesForDate(adapterFor(ctx), date);
+  const todays = fixturesByDate(date, all, cfg.tz);
+  const signals = await reliableShareSignals(ctx, todays);
+  const human = formatDate(`${date}T12:00:00.000Z`, { tz: cfg.tz, locale: cfg.lang });
+  const title = explicitDate ? `Matches \xB7 ${human}` : `Today's matches \xB7 ${human}`;
+  emitShare(
+    ctx,
+    {
+      kind: "today",
+      target: date,
+      input: {
+        title,
+        matches: todays,
+        marketSignals: signals,
+        source,
+        emptyNote: `No matches scheduled for ${human}.`,
+        installLine: "npx @claudinho/cli today",
+        tz: cfg.tz,
+        locale: cfg.lang
+      },
+      options: baseOptions
+    },
+    copy
+  );
+}
 var VIBES = [
   "Shipping code, watching goals.",
   "Green tests, green pitch.",
@@ -4352,7 +4637,7 @@ function handlePipeError(stream) {
 }
 handlePipeError(process.stdout);
 handlePipeError(process.stderr);
-var VERSION = "0.3.0";
+var VERSION = "0.4.1";
 var DISCLAIMER = "Claudinho is an independent fan project. Not affiliated with or endorsed by FIFA or Anthropic.";
 function ctxFrom(cmd) {
   const root = cmd.parent ?? cmd;
@@ -4411,6 +4696,13 @@ program.command("markets").description("show prediction-market signals (read-onl
     fail(e);
   }
 });
+program.command("share").description("print a shareable, copy-pasteable match snippet (#VibingLaVidaLoca)").argument("[target]", '"today" (default), "live", a date, a match id, or "next"').argument("[team]", 'team code when target is "next" (e.g. MEX)').option("--style <style>", "snippet style: social (default) or compact").option("--copy", "also copy the snippet to the clipboard (best-effort)").option("--no-hashtag", "omit the #VibingLaVidaLoca tag").option("--no-install-line", "omit the install/run cue").action(async (target, team, opts, cmd) => {
+  try {
+    await cmdShare(target, team, opts, ctxFrom(cmd));
+  } catch (e) {
+    fail(e);
+  }
+});
 program.command("prompt").description("print a one-line status (Claude Code statusline, tmux, Starship, \u2026)").action((_opts, cmd) => {
   cmdPrompt(ctxFrom(cmd));
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@claudinho/cli",
-  "version": "0.3.0",
+  "version": "0.4.1",
   "description": "Claudinho CLI — the 2026 men's football tournament in your terminal: live scores, fixtures, group tables, prediction-market odds. Not affiliated with FIFA or Anthropic.",
   "type": "module",
   "license": "MIT",
@@ -48,7 +48,7 @@
     "tsup": "^8.0.0",
     "typescript": "^5.7.0",
     "vitest": "^4.1.0",
-    "@claudinho/core": "0.3.0"
+    "@claudinho/core": "0.4.1"
   },
   "scripts": {
     "build": "tsup",