@mauricode/token-derby 3.0.0 → 3.1.2

package/README.md

@@ -103,4 +103,9 @@ at usage you didn't produce.
 - `TOKEN_DERBY_API_BASE` — override the API base URL (default: `https://token-derby.mauricode.co.uk/api`)
 - `TOKEN_DERBY_HOME` — override the data directory (default: `~/.token-derby`)
 - `TOKEN_DERBY_CLAUDE_DIR` — override the transcripts directory (default: `~/.claude/projects`)
+- `CLAUDE_CONFIG_DIR` — Claude Code's own config override. When set, transcripts are read from `$CLAUDE_CONFIG_DIR/projects`. `TOKEN_DERBY_CLAUDE_DIR` still wins.
+
+Token Derby counts usage from this machine's filesystem only. If Claude Code runs
+in a container, over SSH, or on another machine, join the race from there — `join`
+warns before entering a race whose primary model has no transcripts to read.
 - **Top-5 conversations (primary):** a race can be created so that only each racer's **5 most-active conversations per heartbeat** count toward their **primary** model's score (secondaries unaffected). The race creator opts in at `token-derby create` (prompt) or, for organisation-scheduled races, via the "Primary top-5 cap" option on the schedule tab of `token-derby web`. Off by default (every conversation counts).

package/dist/bin.js

@@ -199,9 +199,31 @@ var HATS = [
   // Claim-only: awarded by an admin, never from a roll. Only the A channel cycles,
   // so the inset motif shifts colour while the cap body stays a static rust brown.
   // The body colour is kept out of the frame list so the motif never merges into it.
-  { id: "contributor_cap", name: "Contributor Cap", rarity: "legendary", width: 11, anchor_x: 23, rows: [".....Q.....", "....QQQ....", "...QQQQQ...", "..QAAAQQQ..", "..QQAQQQQ..", ".QQQAQAAQQ.", ".QQQAQAQAQ.", ".QQQQQAQAQ.", ".QQQQQAAQQ.", ".QQQQQQQQQ."], colors: { A: "#21138b", Q: "#6f2801" }, animation: { type: "cycle", frames: ["#FF8C42", "#E0457B", "#8B5CF6", "#3B82F6", "#22D3EE", "#34D399", "#A3E635", "#FBBF24"], fps: 6 }, rollable: false }
+  { id: "contributor_cap", name: "Contributor Cap", rarity: "legendary", width: 11, anchor_x: 23, rows: [".....Q.....", "....QQQ....", "...QQQQQ...", "..QAAAQQQ..", "..QQAQQQQ..", ".QQQAQAAQQ.", ".QQQAQAQAQ.", ".QQQQQAQAQ.", ".QQQQQAAQQ.", ".QQQQQQQQQ."], colors: { A: "#21138b", Q: "#6f2801" }, animation: { type: "cycle", frames: ["#FF8C42", "#E0457B", "#8B5CF6", "#3B82F6", "#22D3EE", "#34D399", "#A3E635", "#FBBF24"], fps: 6 }, rollable: false },
+  // ── LIMITED (6) ────────────────────────────────────────────────────────
+  // London series. Claim-only by construction: limited is absent from
+  // TIER_WEIGHTS, so no roll can reach this tier.
+  { id: "bearskin", name: "Bearskin", rarity: "limited", width: 11, anchor_x: 23, rows: ["...CCCCC.Q.", "..CAAAAACQ.", "..AAAAAACQ.", "..AAAAAAAQ.", "..AAAAAAA..", "..AAAAAAA..", "..AAAAAAA..", "..AAAAAAA..", "..DDDDDDD..", "..AAAAAAA.."], variants: [{ A: "#23232A", Q: "#C8102E", C: "#15151A", D: "#FFD300" }], rollable: false },
+  { id: "roundel_cap", name: "Roundel Cap", rarity: "limited", width: 11, anchor_x: 23, rows: ["...........", "..AAAAAA...", ".AAAAAAAA..", ".AAQQQQQAA.", ".AAQDDDQAA.", ".AFFFFFFFA.", ".AAQDDDQAA.", ".AAQQQQQAA.", ".AAAAAAAAA.", ".FFFFFFFFFF"], variants: [{ A: "#0B3B8C", Q: "#E32017", C: "#1050B8", D: "#F4F1E8", F: "#072A66" }], rollable: false },
+  { id: "union_topper", name: "Union Topper", rarity: "limited", width: 11, anchor_x: 23, rows: ["..CCCCCCC..", "..AQAAAQA..", "..AAQDQAA..", "..QQQDQQQ..", "..DDDDDDD..", "..QQQDQQQ..", "..AAQDQAA..", "..AQAAAQA..", ".CCCCCCCCC.", ".FFFFFFFFF."], variants: [{ A: "#0B2C6B", Q: "#F2F6FA", C: "#081F4D", D: "#C8102E", F: "#061838" }], rollable: false },
+  { id: "crown_jewels", name: "Crown Jewels", rarity: "limited", width: 11, anchor_x: 23, rows: ["...........", "....QQQ....", ".....Q.....", "..QQ.Q.QQ..", ".Q..QQQ..Q.", ".QCCCQCCCQ.", ".QCCCQCCCQ.", ".QQCCQCCQQ.", "..QQQQQQQ..", "..AAAAAAA.."], variants: [{ A: "#f5f5f5", Q: "#ffd700", C: "#5d0a8a" }], rollable: false },
+  { id: "black_cab", name: "Black Cab", rarity: "limited", width: 11, anchor_x: 22, rows: ["...........", "....CCC....", "..AAAAAA...", "..AQQAQA...", ".AAQQAQAAA.", ".AAAAAAAAAF", "AAAAAAAAAAF", "ADDAAAADDA.", ".DD....DD..", "..........."], variants: [{ A: "#141416", Q: "#8FB8D8", C: "#F5C518", D: "#3A3A40", F: "#D9DDE3" }], rollable: false },
+  { id: "london_bus", name: "London Bus", rarity: "limited", width: 11, anchor_x: 22, rows: ["...........", "...........", ".AAAAAAAAAA", "AAAAAAAAAAA", "ACCCACCCAAC", "AAAAAAAAACC", "ACCCACCCACC", "AAAAAAAAAAA", "AQQAAAAAQQA", ".QQ.....QQ."], variants: [{ A: "#e32402", Q: "#0d0c0c", C: "#dcaf09" }], rollable: false }
 ];
 
+// ../shared/dist/hat-shape.js
+function isAnimatedHat(hat) {
+  return "animation" in hat;
+}
+function hatColors(hat, variantIdx = 0) {
+  if (isAnimatedHat(hat))
+    return hat.colors;
+  return hat.variants[variantIdx] ?? hat.variants[0];
+}
+function channelColor(colors, ch) {
+  return colors[ch] ?? colors.A;
+}
+
 // ../shared/dist/series-transform.js
 var PACE_WINDOW_MS = 15 * 6e4;
 
@@ -433,7 +455,7 @@ function composeHatGrid(baseSprite, hat, variantIdx, horseColors) {
       grid[y + ext][x + horseOffsetX] = tagToColor(tag, horseColors);
     }
   }
-  const hatColors = hatColorsFor(hat, variantIdx);
+  const colors = hatColors(hat, variantIdx);
   for (let y = 0; y < hatH; y++) {
     const row = hat.rows[y];
     for (let x = 0; x < hatW; x++) {
@@ -441,7 +463,7 @@ function composeHatGrid(baseSprite, hat, variantIdx, horseColors) {
       if (ch === "." || ch === void 0) continue;
       const gx = hat.anchor_x + x + horseOffsetX;
       if (gx < 0 || gx >= canvasW) continue;
-      const color = ch === "A" ? hatColors.A : hatColors.Q ?? hatColors.A;
+      const color = channelColor(colors, ch);
       grid[y][gx] = color;
     }
   }
@@ -463,10 +485,6 @@ function tagToColor(tag, c) {
       return FIXED_COLORS.H;
   }
 }
-function hatColorsFor(hat, variantIdx) {
-  if (hat.rarity === "legendary") return hat.colors;
-  return hat.variants[variantIdx] ?? hat.variants[0];
-}
 
 // src/ui/half-blocks.ts
 var RESET = "\x1B[0m";
@@ -538,19 +556,19 @@ import { useEffect, useState } from "react";
 import { Box as Box2, Text as Text2 } from "ink";
 import { jsx as jsx2 } from "react/jsx-runtime";
 function AnimatedHorseSprite({ sprite, colors, hat }) {
-  const isLegendary = hat.rarity === "legendary";
-  const frames = isLegendary ? hat.animation.frames : [];
-  const fps = isLegendary ? hat.animation.fps : 1;
+  const animated = isAnimatedHat(hat);
+  const frames = animated ? hat.animation.frames : [];
+  const fps = animated ? hat.animation.fps : 1;
   const [idx, setIdx] = useState(0);
   useEffect(() => {
-    if (!isLegendary || frames.length <= 1) return;
+    if (!animated || frames.length <= 1) return;
     const interval = setInterval(
       () => setIdx((i) => (i + 1) % frames.length),
       Math.max(1, Math.round(1e3 / fps))
     );
     return () => clearInterval(interval);
-  }, [isLegendary, frames.length, fps]);
-  const renderedHat = isLegendary && frames[idx] ? { ...hat, colors: { ...hat.colors, A: frames[idx] } } : hat;
+  }, [animated, frames.length, fps]);
+  const renderedHat = animated && frames[idx] ? { ...hat, colors: { ...hat.colors, A: frames[idx] } } : hat;
   const { grid } = composeHatGrid(sprite, renderedHat, 0, colors);
   const lines = hexGridToHalfBlocks(grid);
   return /* @__PURE__ */ jsx2(Box2, { flexDirection: "column", children: lines.map((line, i) => /* @__PURE__ */ jsx2(Text2, { children: line }, i)) });
@@ -739,7 +757,7 @@ function HorseCreator({
         "]"
       ] })
     ] }),
-    /* @__PURE__ */ jsx3(Box3, { marginBottom: 1, children: previewHatDef ? previewHatDef.rarity === "legendary" ? /* @__PURE__ */ jsx3(AnimatedHorseSprite, { sprite: MAIN_SPRITE, colors, hat: previewHatDef }) : /* @__PURE__ */ jsx3(HorseSprite, { sprite: MAIN_SPRITE, colors, hat: { hat: previewHatDef, variant: previewHat?.variant ?? 0 } }) : /* @__PURE__ */ jsx3(HorseSprite, { sprite: MAIN_SPRITE, colors }) }),
+    /* @__PURE__ */ jsx3(Box3, { marginBottom: 1, children: previewHatDef ? isAnimatedHat(previewHatDef) ? /* @__PURE__ */ jsx3(AnimatedHorseSprite, { sprite: MAIN_SPRITE, colors, hat: previewHatDef }) : /* @__PURE__ */ jsx3(HorseSprite, { sprite: MAIN_SPRITE, colors, hat: { hat: previewHatDef, variant: previewHat?.variant ?? 0 } }) : /* @__PURE__ */ jsx3(HorseSprite, { sprite: MAIN_SPRITE, colors }) }),
     /* @__PURE__ */ jsx3(Box3, { flexDirection: "column", children: rows.map((r, i) => {
       const cursor = i === rowIdx ? "\u25BA" : " ";
       if (r.kind === "color") {
@@ -785,8 +803,8 @@ function renderHatLabel(hats, hatChoice, initialEquipped) {
   if (!collected) return /* @__PURE__ */ jsx3(Text3, { dimColor: true, children: "?" });
   const hat = hatById(collected.id);
   const name = hat?.name ?? collected.id;
-  const variantSuffix = hat && hat.rarity !== "legendary" && collected.variant !== void 0 ? ` #${collected.variant + 1}` : "";
-  const rarityColor = hat ? hat.rarity === "legendary" ? "yellow" : hat.rarity === "epic" ? "magenta" : hat.rarity === "rare" ? "blue" : "gray" : "gray";
+  const variantSuffix = hat && !isAnimatedHat(hat) && collected.variant !== void 0 ? ` #${collected.variant + 1}` : "";
+  const rarityColor = hat ? hat.rarity === "limited" ? "magentaBright" : hat.rarity === "legendary" ? "yellow" : hat.rarity === "epic" ? "magenta" : hat.rarity === "rare" ? "blue" : "gray" : "gray";
   const equippedMark = initialEquipped === hatChoice ? " \u2713" : "";
   return /* @__PURE__ */ jsxs(Fragment, { children: [
     name,
@@ -839,12 +857,13 @@ function apiBase() {
 var HEARTBEAT_INTERVAL_MS = 6e4;
 var SCAN_TIMEOUT_MS = HEARTBEAT_INTERVAL_MS * 0.75;
 var HEARTBEAT_RETRY_DELAYS_MS = [1e3, 2e3, 4e3, 8e3, 15e3];
+var PRIMARY_SILENT_THRESHOLD = 10;
 
 // src/version.ts
 import { createRequire } from "module";
 function readVersion() {
-  if ("3.0.0".length > 0) {
-    return "3.0.0";
+  if ("3.1.2".length > 0) {
+    return "3.1.2";
   }
   try {
     const req = createRequire(import.meta.url);
@@ -879,7 +898,11 @@ function activeRacesDir() {
   return path2.join(homeDir(), "active-races");
 }
 function claudeProjectsDir() {
-  return process.env.TOKEN_DERBY_CLAUDE_DIR ?? path2.join(os2.homedir(), ".claude", "projects");
+  const override = process.env.TOKEN_DERBY_CLAUDE_DIR;
+  if (override) return override;
+  const configDir = process.env.CLAUDE_CONFIG_DIR;
+  if (configDir) return path2.join(configDir, "projects");
+  return path2.join(os2.homedir(), ".claude", "projects");
 }
 function codexSessionsDir() {
   return process.env.TOKEN_DERBY_CODEX_DIR ?? path2.join(os2.homedir(), ".codex");
@@ -1541,7 +1564,7 @@ function ModelList(props) {
   ] }) });
 }
 function StatusScreen(props) {
-  const { race, ownHorseId, ownHorseName, ownColors, ownUserName, lastHeartbeatAgoSec, lastHeartbeatOk, stalled, stallReason, primaryModel } = props;
+  const { race, ownHorseId, ownHorseName, ownColors, ownUserName, lastHeartbeatAgoSec, lastHeartbeatOk, stalled, stallReason, primarySilent, primarySourceDir, primaryModel } = props;
   if (!race) {
     return /* @__PURE__ */ jsx7(Box7, { flexDirection: "column", children: /* @__PURE__ */ jsx7(Text7, { children: "Joining race\u2026" }) });
   }
@@ -1612,6 +1635,15 @@ function StatusScreen(props) {
         "\u26A0 ",
         stallReason ?? "Can't read token usage",
         ". Your race continues."
+      ] }),
+      !stalled && primarySilent && /* @__PURE__ */ jsxs5(Text7, { color: "yellow", children: [
+        "\u26A0 No ",
+        MODEL_LABELS[primaryModel ?? "claude"],
+        " transcripts in ",
+        PRIMARY_SILENT_THRESHOLD,
+        " beats",
+        primarySourceDir ? ` \u2014 nothing under ${primarySourceDir}` : "",
+        ". Your race continues, but your horse cannot move until they can be read."
       ] })
     ] }),
     primaryModel && /* @__PURE__ */ jsx7(ModelList, { primaryModel }),
@@ -1851,6 +1883,24 @@ async function readCompleteLines(file, start, end) {
   }
 }
 
+// src/tokens/source-root.ts
+var SourceRootMissing = class extends Error {
+  constructor(dir) {
+    super(`No history directory at ${dir}`);
+    this.dir = dir;
+    this.name = "SourceRootMissing";
+  }
+  dir;
+};
+async function readRoot(dir, read) {
+  try {
+    return await read();
+  } catch (e) {
+    if (e?.code === "ENOENT") throw new SourceRootMissing(dir);
+    throw e;
+  }
+}
+
 // src/tokens/transcripts.ts
 var MAX_PROJECT_DEPTH = 8;
 function conversationId(file, root) {
@@ -1887,29 +1937,33 @@ async function sumTokens() {
   return { input, output };
 }
 async function listJsonlFiles(root) {
-  const projects = await fs4.readdir(root);
+  const entries = await readEntries(root, true);
   const out = [];
-  for (const project of projects) {
-    const projectDir = path6.join(root, project);
-    const stat4 = await fs4.stat(projectDir);
-    if (!stat4.isDirectory()) continue;
-    await collectJsonl(projectDir, MAX_PROJECT_DEPTH, out);
+  for (const entry of entries) {
+    if (!await isDirectory(entry, root)) continue;
+    await collectJsonl(path6.join(root, entry.name), MAX_PROJECT_DEPTH, out);
   }
   return out;
 }
 async function collectJsonl(dir, depth, out) {
   if (depth <= 0) return;
-  const entries = await fs4.readdir(dir);
-  for (const entry of entries) {
-    if (entry.endsWith(".jsonl")) {
-      out.push(path6.join(dir, entry));
-    } else if (depth > 1) {
-      const child = path6.join(dir, entry);
-      const st = await fs4.stat(child);
-      if (st.isDirectory()) await collectJsonl(child, depth - 1, out);
+  for (const entry of await readEntries(dir, false)) {
+    if (entry.name.endsWith(".jsonl")) {
+      out.push(path6.join(dir, entry.name));
+    } else if (depth > 1 && await isDirectory(entry, dir)) {
+      await collectJsonl(path6.join(dir, entry.name), depth - 1, out);
     }
   }
 }
+async function readEntries(dir, failLoud) {
+  if (failLoud) return readRoot(dir, () => fs4.readdir(dir, { withFileTypes: true }));
+  return fs4.readdir(dir, { withFileTypes: true }).catch(() => []);
+}
+async function isDirectory(entry, parent) {
+  if (entry.isDirectory()) return true;
+  if (!entry.isSymbolicLink()) return false;
+  return fs4.stat(path6.join(parent, entry.name)).then((st) => st.isDirectory()).catch(() => false);
+}
 function addNum(value) {
   return typeof value === "number" && Number.isFinite(value) ? value : 0;
 }
@@ -1942,11 +1996,8 @@ function num(v) {
 }
 async function sumCodexByConversation() {
   const root = codexSessionsDir();
-  await fs5.stat(root);
-  const files = [
-    ...await collectRollouts(path7.join(root, "sessions")),
-    ...await collectRollouts(path7.join(root, "archived_sessions"))
-  ];
+  await readRoot(root, () => fs5.stat(root));
+  const files = await listCodexRollouts(root);
   const cache = await ScanCache.open("codex");
   const totals = await mapWithConcurrency(
     files,
@@ -1968,6 +2019,12 @@ async function sumCodexTokens() {
   }
   return { input, output };
 }
+async function listCodexRollouts(root) {
+  return [
+    ...await collectRollouts(path7.join(root, "sessions")),
+    ...await collectRollouts(path7.join(root, "archived_sessions"))
+  ];
+}
 async function collectRollouts(dir) {
   let entries;
   try {
@@ -2038,7 +2095,7 @@ async function sumGeminiTokens() {
   return { input, output };
 }
 async function listChatFiles(root) {
-  const entries = await fs6.readdir(root);
+  const entries = await readRoot(root, () => fs6.readdir(root));
   const out = [];
   for (const entry of entries) {
     const chatsDir = path8.join(root, entry, "chats");
@@ -2136,7 +2193,7 @@ async function readAllSources(race, primary, progress) {
   const primaryByConv = /* @__PURE__ */ new Map();
   if (primaryResult.ok) {
     for (const [id, totals] of primaryResult.map) primaryByConv.set(id, scoreFor(race, totals));
-  } else if (primaryResult.err?.code !== "ENOENT") {
+  } else if (!(primaryResult.err instanceof SourceRootMissing)) {
     const err = primaryResult.err;
     return { stall: `Can't read ${primary} token usage: ${err?.message ?? String(err)}` };
   }
@@ -2203,6 +2260,7 @@ var RaceScoreTracker = class {
   seq;
   stalls = 0;
   lastStall = null;
+  primaryEmptyBeats = 0;
   primary;
   primaryTop5;
   constructor(init, primary, primaryTop5) {
@@ -2235,6 +2293,7 @@ var RaceScoreTracker = class {
       const v = reading.secondary[key];
       if (v > 0) this.lastGood[key] = v;
     }
+    this.primaryEmptyBeats = reading.primaryByConv.size === 0 ? this.primaryEmptyBeats + 1 : 0;
     for (const [id, v] of reading.primaryByConv) {
       const prev = this.primaryConvLast[id] ?? 0;
       if (v > prev) this.primaryConvLast[id] = v;
@@ -2286,6 +2345,10 @@ var RaceScoreTracker = class {
   get stalled() {
     return this.stalls >= STALL_THRESHOLD;
   }
+  /** The primary source has produced no conversations for long enough to be worth saying. */
+  get primarySilent() {
+    return this.primaryEmptyBeats >= PRIMARY_SILENT_THRESHOLD;
+  }
   /** Human-readable cause of the most recent stall (null once a good read recovers). */
   get stallReason() {
     return this.lastStall;
@@ -2314,6 +2377,75 @@ var RaceScoreTracker = class {
   }
 };
 
+// src/tokens/source-probe.ts
+import * as fs7 from "fs/promises";
+var ROOTS = {
+  claude: claudeProjectsDir,
+  codex: codexSessionsDir,
+  gemini: geminiTmpDir
+};
+var LISTERS = {
+  claude: listJsonlFiles,
+  codex: listCodexRollouts,
+  gemini: listChatFiles
+};
+var LABELS2 = { claude: "Claude", codex: "Codex", gemini: "Gemini" };
+function sourceDir(key) {
+  return ROOTS[key]();
+}
+async function probeSource(key) {
+  const dir = ROOTS[key]();
+  const exists = await fs7.stat(dir).then((st) => st.isDirectory()).catch(() => false);
+  if (!exists) return { key, dir, exists: false, projects: 0, transcripts: 0 };
+  const entries = await fs7.readdir(dir, { withFileTypes: true }).catch(() => []);
+  const projects = entries.filter((e) => e.isDirectory() || e.isSymbolicLink()).length;
+  const files = await LISTERS[key](dir).catch(() => []);
+  return { key, dir, exists: true, projects, transcripts: files.length };
+}
+function overrideVar(key) {
+  return `TOKEN_DERBY_${key.toUpperCase()}_DIR`;
+}
+async function confirmEmptySource(opts) {
+  if (opts.probe.transcripts > 0) return true;
+  opts.warn(describeEmptySource(opts.probe));
+  if (!opts.interactive) return true;
+  return opts.ask();
+}
+function describeEmptySource(probe) {
+  const label = LABELS2[probe.key];
+  const populated = probe.exists && probe.projects > 0;
+  const reason = !probe.exists ? "does not exist" : populated ? `holds ${probe.projects} project ${probe.projects === 1 ? "directory" : "directories"}, none of which could be read` : "exists, but holds no transcripts";
+  const lines = [
+    `\u26A0 No ${label} transcripts found \u2014 your horse will not move.`,
+    ``,
+    `  Looked in: ${probe.dir}`,
+    `             (${reason})`,
+    ``
+  ];
+  if (populated) {
+    lines.push(
+      `  The directory is there and has history in it, so this is usually a`,
+      `  dangling symlink or a permissions problem on one of those projects.`,
+      `  To find dangling links:`,
+      `    find ${probe.dir} -type l ! -exec test -e {} \\; -print`,
+      ``
+    );
+  }
+  lines.push(
+    `  Token Derby counts ${label} usage from this machine's own filesystem.`,
+    `  If ${label} runs in a container, over SSH, or on another machine, join`,
+    `  the race from there instead.`
+  );
+  if (probe.key === "claude") {
+    lines.push(
+      `  If CLAUDE_CONFIG_DIR relocated your config, Token Derby follows it \u2014`,
+      `  check it points at the config root, not the projects directory.`
+    );
+  }
+  lines.push(``, `  To read them from somewhere else: export ${overrideVar(probe.key)}=<dir>`);
+  return lines.join("\n");
+}
+
 // src/runtime/run-race.tsx
 import { jsx as jsx8, jsxs as jsxs6 } from "react/jsx-runtime";
 function RunRace({ active, initialState, pendingMode, ownUserName }) {
@@ -2330,6 +2462,7 @@ function RunRace({ active, initialState, pendingMode, ownUserName }) {
   const ctrl = useRef(new AbortController());
   const [stalled, setStalled] = useState5(false);
   const [stallReason, setStallReason] = useState5(null);
+  const [primarySilent, setPrimarySilent] = useState5(false);
   useEffect2(() => {
     const t = setInterval(() => setTickNow(/* @__PURE__ */ new Date()), 1e3);
     return () => clearInterval(t);
@@ -2361,6 +2494,7 @@ function RunRace({ active, initialState, pendingMode, ownUserName }) {
         if (pendingRef.current && !isStall(reading)) tracker.reprime();
         setStalled(tracker.stalled);
         setStallReason(tracker.stalled ? tracker.stallReason : null);
+        setPrimarySilent(tracker.primarySilent);
         return tracker.nextBeat();
       },
       sendBeat: async (snapshot) => {
@@ -2428,6 +2562,8 @@ function RunRace({ active, initialState, pendingMode, ownUserName }) {
         lastHeartbeatOk: lastHbOk,
         stalled,
         stallReason,
+        primarySilent,
+        primarySourceDir: sourceDir(active.primary_model),
         primaryModel: active.primary_model
       }
     ),
@@ -2495,6 +2631,28 @@ async function buildInitialState(args) {
   };
 }
 
+// src/ui/prompt.ts
+async function promptYesNo(question, opts = {}) {
+  const input = opts.input ?? process.stdin;
+  const output = opts.output ?? process.stdout;
+  if (input === process.stdin) resetStdinAfterInk();
+  const readline6 = await import("readline/promises");
+  const rl = readline6.createInterface({ input, output });
+  const a = (await rl.question(question)).trim().toLowerCase();
+  rl.close();
+  if (a === "") return opts.defaultYes !== false;
+  return a === "y" || a === "yes";
+}
+function resetStdinAfterInk() {
+  if (process.stdin.isTTY && typeof process.stdin.setRawMode === "function") {
+    process.stdin.setRawMode(false);
+  }
+  while (process.stdin.read() !== null) {
+  }
+  process.stdin.pause();
+  process.stdin.ref();
+}
+
 // src/commands/join.ts
 function parsePrimaryFlag(argv) {
   for (let i = 0; i < argv.length; i++) {
@@ -2589,6 +2747,19 @@ async function joinCommand(joinCode, argv = []) {
     if (primaryFlag) chosenPrimary = primaryFlag;
     else if (process.stdout.isTTY) chosenPrimary = await pickPrimary();
   }
+  const effectivePrimary = ownHorse?.primary_model ?? chosenPrimary;
+  const proceed = await confirmEmptySource({
+    probe: await probeSource(effectivePrimary),
+    interactive: Boolean(process.stdin.isTTY && process.stdout.isTTY),
+    warn: (text) => console.error(`
+${text}
+`),
+    ask: () => promptYesNo("Join anyway? [y/N] ", { defaultYes: false })
+  });
+  if (!proceed) {
+    console.log("Cancelled.");
+    return 1;
+  }
   let joinResp;
   try {
     joinResp = await joinRace(code, { stable_horse_id: chosenStableHorseId, primary_model: chosenPrimary });
@@ -2889,25 +3060,6 @@ async function webCommand(deps = {}) {
   return 0;
 }
 
-// src/ui/prompt.ts
-async function promptYesNo(question) {
-  resetStdinAfterInk();
-  const readline6 = await import("readline/promises");
-  const rl = readline6.createInterface({ input: process.stdin, output: process.stdout });
-  const a = (await rl.question(question)).trim().toLowerCase();
-  rl.close();
-  return a === "" || a === "y" || a === "yes";
-}
-function resetStdinAfterInk() {
-  if (process.stdin.isTTY && typeof process.stdin.setRawMode === "function") {
-    process.stdin.setRawMode(false);
-  }
-  while (process.stdin.read() !== null) {
-  }
-  process.stdin.pause();
-  process.stdin.ref();
-}
-
 // src/commands/login.ts
 function parseDeviceNameFlag(argv) {
   for (let i = 0; i < argv.length; i++) {
@@ -3477,13 +3629,13 @@ import { useEffect as useEffect3, useState as useState7 } from "react";
 import { Box as Box10, Text as Text10 } from "ink";
 import { jsx as jsx10 } from "react/jsx-runtime";
 function HatSprite({ hat, variant, centerIn }) {
-  const colors = hatColorsFor2(hat, variant ?? 0);
+  const colors = hatColors(hat, variant ?? 0);
   const grid = makeHatGrid(hat, colors, centerIn);
   const lines = hexGridToHalfBlocks(grid);
   return /* @__PURE__ */ jsx10(Box10, { flexDirection: "column", children: lines.map((line, i) => /* @__PURE__ */ jsx10(Text10, { children: line }, i)) });
 }
 function AnimatedHatSprite({ hat, variant, centerIn }) {
-  if (hat.rarity !== "legendary") {
+  if (!isAnimatedHat(hat)) {
     return /* @__PURE__ */ jsx10(HatSprite, { hat, variant, centerIn });
   }
   const frames = hat.animation.frames;
@@ -3500,10 +3652,6 @@ function AnimatedHatSprite({ hat, variant, centerIn }) {
   const framed = { ...hat, colors: { ...hat.colors, A: frames[idx] } };
   return /* @__PURE__ */ jsx10(HatSprite, { hat: framed, variant, centerIn });
 }
-function hatColorsFor2(hat, variantIdx) {
-  if (hat.rarity === "legendary") return hat.colors;
-  return hat.variants[variantIdx] ?? hat.variants[0];
-}
 function makeHatGrid(hat, colors, centerIn) {
   const w = centerIn?.w ?? hat.width;
   const h = centerIn?.h ?? hat.rows.length;
@@ -3518,7 +3666,7 @@ function makeHatGrid(hat, colors, centerIn) {
       const gx = x + offX;
       const gy = y + offY;
       if (gx < 0 || gx >= w || gy < 0 || gy >= h) continue;
-      grid[gy][gx] = ch === "A" ? colors.A : colors.Q ?? colors.A;
+      grid[gy][gx] = channelColor(colors, ch);
     }
   }
   return grid;
@@ -3532,7 +3680,8 @@ var TIER_PALETTE = {
   common: ["#FFFFFF", "#DDDDDD", "#AAAAAA", "#9E9E9E"],
   rare: ["#42A5F5", "#1E88E5", "#90CAF9", "#0277BD"],
   epic: ["#AB47BC", "#8E24AA", "#CE93D8", "#6A1B9A"],
-  legendary: ["#FFD700", "#FF7F00", "#FF0000", "#FF00FF", "#00BFFF", "#7CFC00", "#8B00FF"]
+  legendary: ["#FFD700", "#FF7F00", "#FF0000", "#FF00FF", "#00BFFF", "#7CFC00", "#8B00FF"],
+  limited: ["#F472B6", "#EC4899", "#FF4FA3", "#FBCFE8", "#FFFFFF"]
 };
 var CONFETTI_CHARS = ["\u2726", "\u2727", "\u22C6", "\u2605", "\u2606", "\u2728", "*", "\u2022", "\u25C6", "\u25C7"];
 var SCENE_W = 32;
@@ -3635,7 +3784,7 @@ function ConfettiBurst({ tier }) {
 var CLOSED_HOLD_MS = 3e3;
 function RollReveal({ outcome, onDone }) {
   const isNoHat = outcome.kind === "no_hat";
-  const isLegendary = outcome.kind !== "no_hat" && outcome.hat.rarity === "legendary";
+  const isShowpiece = outcome.kind !== "no_hat" && (outcome.hat.rarity === "legendary" || outcome.hat.rarity === "limited");
   const [phase, setPhase] = useState8("closed");
   useEffect4(() => {
     const timers = [];
@@ -3647,10 +3796,10 @@ function RollReveal({ outcome, onDone }) {
     } else {
       timers.push(setTimeout(() => setPhase("burst"), CLOSED_HOLD_MS + 700));
       timers.push(setTimeout(() => setPhase("reveal"), CLOSED_HOLD_MS + 1650));
-      timers.push(setTimeout(onDone, CLOSED_HOLD_MS + (isLegendary ? 4650 : 2650)));
+      timers.push(setTimeout(onDone, CLOSED_HOLD_MS + (isShowpiece ? 4650 : 2650)));
     }
     return () => timers.forEach(clearTimeout);
-  }, [isNoHat, isLegendary, onDone]);
+  }, [isNoHat, isShowpiece, onDone]);
   if (phase === "closed") return /* @__PURE__ */ jsx11(GiftBox, { frame: BOX_CLOSED, color: BOX_COLOR });
   if (phase === "open1") return /* @__PURE__ */ jsx11(GiftBox, { frame: BOX_OPENING_1, color: BOX_COLOR });
   if (phase === "open2") return /* @__PURE__ */ jsx11(GiftBox, { frame: BOX_OPENING_2, color: BOX_COLOR });
@@ -3659,7 +3808,7 @@ function RollReveal({ outcome, onDone }) {
     return /* @__PURE__ */ jsx11(ConfettiBurst, { tier: outcome.hat.rarity });
   }
   if (outcome.kind === "no_hat") return /* @__PURE__ */ jsx11(GiftBox, { frame: BOX_EMPTY, color: BOX_COLOR });
-  return outcome.hat.rarity === "legendary" ? /* @__PURE__ */ jsx11(AnimatedHatSprite, { hat: outcome.hat, centerIn: { w: SCENE_W, h: SCENE_H } }) : /* @__PURE__ */ jsx11(HatSprite, { hat: outcome.hat, variant: outcome.variant, centerIn: { w: SCENE_W, h: SCENE_H } });
+  return isAnimatedHat(outcome.hat) ? /* @__PURE__ */ jsx11(AnimatedHatSprite, { hat: outcome.hat, centerIn: { w: SCENE_W, h: SCENE_H } }) : /* @__PURE__ */ jsx11(HatSprite, { hat: outcome.hat, variant: outcome.variant, centerIn: { w: SCENE_W, h: SCENE_H } });
 }
 
 // src/ui/reveal.ts
@@ -3750,7 +3899,7 @@ async function rollCommand() {
     await runReveal(outcome);
     if (result.result === "hat") {
       const hat = hatById(result.collected.id);
-      const variantSuffix = hat.rarity !== "legendary" && result.collected.variant !== void 0 ? ` #${result.collected.variant + 1}` : "";
+      const variantSuffix = !isAnimatedHat(hat) && result.collected.variant !== void 0 ? ` #${result.collected.variant + 1}` : "";
       console.log(`
 \u2728 ${hat.name}${variantSuffix} [${hat.rarity.toUpperCase()}]
 `);
@@ -3788,8 +3937,9 @@ async function claimCommand(token) {
     console.error("Usage: token-derby claim <token>");
     return 2;
   }
+  let probe;
   try {
-    await probeClaim(token);
+    probe = await probeClaim(token);
   } catch (e) {
     if (e instanceof ApiError) {
       console.error(`Error: ${e.code} ${e.message}`);
@@ -3811,7 +3961,9 @@ async function claimCommand(token) {
     console.error("No horses in your stable. Run `token-derby stable create` first.");
     return 1;
   }
-  console.log("\n\u{1F381} A cosmetic has been awarded to you.\n");
+  console.log(probe.entry_count > 1 ? `
+\u{1F381} A pack of ${probe.entry_count} cosmetics \u2014 one of them will be yours.
+` : "\n\u{1F381} A cosmetic has been awarded to you.\n");
   const picked = await new Promise((resolve) => {
     const app = render7(React15.createElement(HorsePicker, {
       horses: stable.horses,
@@ -3855,7 +4007,7 @@ async function claimCommand(token) {
   await runReveal(outcome);
   if (result.result === "hat") {
     const hat2 = hatById(result.collected.id);
-    const variantSuffix2 = hat2.rarity !== "legendary" && result.collected.variant !== void 0 ? ` #${result.collected.variant + 1}` : "";
+    const variantSuffix2 = !isAnimatedHat(hat2) && result.collected.variant !== void 0 ? ` #${result.collected.variant + 1}` : "";
     console.log(`
 \u2728 ${hat2.name}${variantSuffix2} [${hat2.rarity.toUpperCase()}]
 `);
@@ -3881,12 +4033,9 @@ ${picked.name} already has ${hat?.name ?? result.hat_id}${variantSuffix}. +${res
 
 // src/commands/org-join.ts
 async function orgJoinCommand(token) {
-  if (!token) {
-    console.error("Usage: token-derby organisation join <join-token>");
-    return 2;
-  }
+  const join_token = token?.trim();
   try {
-    const resp = await joinOrganisation({ join_token: token });
+    const resp = await joinOrganisation(join_token ? { join_token } : {});
     console.log(`Joined organisation: ${resp.org_name}`);
     return 0;
   } catch (e) {
@@ -3964,7 +4113,9 @@ Stable management:
   token-derby stable delete <name>        Remove a horse from your stable
 
 Organisations:
-  token-derby organisation join <token>   Join an organisation with a join token
+  token-derby organisation join [token]   Join an organisation with a join token,
+                                          or leave the token out to join by your
+                                          verified email domain
   token-derby web                         Open the web org manager (create orgs,
                                           manage schedules, webhooks, members)
 
@@ -4027,7 +4178,7 @@ async function main() {
     const sub = argv[1];
     if (sub === "join") return orgJoinCommand(argv[2]);
     console.error(`Organisation management has moved to the web: token-derby web`);
-    console.error(`The only CLI organisation command is: organisation join <token>`);
+    console.error(`The only CLI organisation command is: organisation join [token]`);
     return 2;
   }
   if (cmd === "create") {