@mauricode/token-derby 2.12.3 → 2.13.0

package/README.md

@@ -11,7 +11,7 @@ Token Derby runs on the **real** output tokens your Claude Code produces — tha
 ## Install
 
 ```bash
-npm i -g @mauricode/token-derby
+npm i -g @mauricode/token-derby@latest
 ```
 
 Requires Node 20+.
@@ -64,6 +64,16 @@ The CLI sums `message.usage.output_tokens` across every `*.jsonl` under `~/.clau
 
 Races can optionally also count *fresh input tokens* — i.e. `input_tokens + cache_creation_input_tokens` (your new context this turn) in addition to output. `cache_read_input_tokens` is never counted, since those reflect passive context size rather than work. The race creator opts in at `token-derby create` time; thresholds for Stampede!, Pulled Away!, and the heartbeat rate cap scale 10× in these races so the achievement cadence stays comparable.
 
+## Stamina
+
+Some races turn on stamina. Push a horse far above a sustainable pace and it tires — its tokens still count, but at a fraction of face value until it recovers. A normal working pace never triggers this; stamina only bites once you're running well past what the race considers sustainable.
+
+Staying connected and easing off is how you recover. Disconnecting does not — a long gap since your last heartbeat earns the same recovery as one ordinary tick, not a bonus for the time you were away, so crashing is not a rest strategy. That's on top of the crash penalty above: you lose the tokens from the gap *and* you don't recover any faster for it.
+
+Nothing here asks you to hold work back. A flat-out day still beats a lazy one — it just doesn't beat it by as much as the raw token count would suggest once your horse tires.
+
+Stamina is off by default; org owners turn it on and tune it from the Race Settings tab of `token-derby web`. When it's on, the live view shows your horse's stamina as a percentage and bar, plus a multiplier once you're actually losing score to fatigue.
+
 ## Other models (Codex, Gemini)
 
 At join you pick one **primary** model — Claude, Codex, or Gemini — counted 1:1.

package/dist/bin.js

@@ -252,6 +252,39 @@ function toTag(c, y) {
   }
 }
 
+// ../shared/dist/scoring.js
+function scoredOf(horse) {
+  return horse.scored_tokens ?? horse.current_tokens;
+}
+var STAMINA = {
+  SUSTAINABLE_PACE: 4e3,
+  DRAIN_PER_MIN: 4,
+  MAX_DRAIN_PER_MIN: 6,
+  RECOVER_PER_MIN: 2,
+  RECOVER_TICK_CAP_MS: 9e4,
+  TAPER_FLOOR: 25,
+  TIRED_MULTIPLIER: 0.5
+};
+function resolveStaminaConfig(race) {
+  const c = race.stamina_config ?? {};
+  return {
+    sustainable_pace: c.sustainable_pace ?? STAMINA.SUSTAINABLE_PACE,
+    drain_per_min: c.drain_per_min ?? STAMINA.DRAIN_PER_MIN,
+    max_drain_per_min: c.max_drain_per_min ?? STAMINA.MAX_DRAIN_PER_MIN,
+    recover_per_min: c.recover_per_min ?? STAMINA.RECOVER_PER_MIN,
+    taper_floor: c.taper_floor ?? STAMINA.TAPER_FLOOR,
+    tired_multiplier: c.tired_multiplier ?? STAMINA.TIRED_MULTIPLIER
+  };
+}
+var STAMINA_PARAM_BOUNDS = {
+  sustainable_pace: { min: 1e3, max: 2e4, step: 250, default: STAMINA.SUSTAINABLE_PACE },
+  drain_per_min: { min: 1, max: 12, step: 1, default: STAMINA.DRAIN_PER_MIN },
+  max_drain_per_min: { min: 2, max: 20, step: 1, default: STAMINA.MAX_DRAIN_PER_MIN },
+  recover_per_min: { min: 1, max: 8, step: 1, default: STAMINA.RECOVER_PER_MIN },
+  taper_floor: { min: 10, max: 60, step: 5, default: STAMINA.TAPER_FLOOR },
+  tired_multiplier: { min: 0.2, max: 0.9, step: 0.05, default: STAMINA.TIRED_MULTIPLIER }
+};
+
 // src/ui/HorseSprite.tsx
 import { Box, Text } from "ink";
 
@@ -788,8 +821,8 @@ var HEARTBEAT_RETRY_DELAYS_MS = [1e3, 2e3, 4e3, 8e3, 15e3];
 // src/version.ts
 import { createRequire } from "module";
 function readVersion() {
-  if ("2.12.3".length > 0) {
-    return "2.12.3";
+  if ("2.13.0".length > 0) {
+    return "2.13.0";
   }
   try {
     const req = createRequire(import.meta.url);
@@ -1326,6 +1359,8 @@ async function createRaceCommand(organisationName) {
     const counts_input = countInputRaw === "y" || countInputRaw === "yes";
     const top5Raw = (await rl.question("Count only each racer's 5 most-active conversations toward their primary model's score? [y/N]: ")).trim().toLowerCase();
     const primary_top5 = top5Raw === "y" || top5Raw === "yes";
+    const staminaRaw = (await rl.question("Stamina \u2014 horses that run flat out tire and score less until they recover? [y/N]: ")).trim().toLowerCase();
+    const stamina = staminaRaw === "y" || staminaRaw === "yes";
     const resp = await createRace({
       name,
       start_time: start,
@@ -1334,7 +1369,8 @@ async function createRaceCommand(organisationName) {
       ...max !== void 0 ? { max_participants: max } : {},
       ...org ? { organisation_name: org } : {},
       ...counts_input ? { counts_input: true } : {},
-      ...primary_top5 ? { primary_top5: true } : {}
+      ...primary_top5 ? { primary_top5: true } : {},
+      ...stamina ? { stamina: true } : {}
     });
     console.log("");
     console.log("  \u2554\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2557");
@@ -1353,6 +1389,9 @@ async function createRaceCommand(organisationName) {
     if (primary_top5) {
       console.log("  Primary score counts only each racer's top 5 conversations per beat.");
     }
+    if (stamina) {
+      console.log("  Stamina on \u2014 horses running above a sustainable pace will tire.");
+    }
     console.log(`  Share with participants:  token-derby join ${resp.join_code}`);
     return 0;
   } catch (e) {
@@ -1415,7 +1454,7 @@ import { Box as Box8, Text as Text8, useApp } from "ink";
 
 // src/ui/StatusScreen.tsx
 import { Box as Box7, Text as Text7 } from "ink";
-import { jsx as jsx7, jsxs as jsxs5 } from "react/jsx-runtime";
+import { Fragment as Fragment2, jsx as jsx7, jsxs as jsxs5 } from "react/jsx-runtime";
 var MODEL_LABELS = { claude: "Claude", codex: "Codex", gemini: "Gemini" };
 function ModelList(props) {
   const { primaryModel } = props;
@@ -1439,6 +1478,32 @@ function StatusScreen(props) {
   const elapsedPct = elapsed(race);
   const timeLeft = formatDuration(race.time_left_seconds);
   const lvl = levelInfo((own?.xp ?? 0) + (own?.live_xp ?? 0));
+  const divisionField = own?.division === void 0 ? [] : race.horses.filter((h) => h.division === own.division);
+  const divisionRank = own ? divisionField.indexOf(own) + 1 : 0;
+  const showDivision = (race.league_division_names?.length ?? 0) > 0 && divisionRank > 0;
+  const staminaRow = race.stamina === true ? staminaLine(own, race) : null;
+  const rows = [
+    { label: "Tokens (race):", value: String(own?.final_scored_tokens ?? (own ? scoredOf(own) : 0)) },
+    ...staminaRow ? [staminaRow] : [],
+    { label: "Position:", value: `${own?.rank ?? "\u2014"} of ${race.horses.length}` },
+    ...showDivision ? [{ label: "Position (Division):", value: `${divisionRank} of ${divisionField.length}` }] : [],
+    { label: "Leader:", value: leaderText(leader) },
+    ...showDivision ? [{ label: "Leader (Division):", value: leaderText(divisionField[0]) }] : [],
+    { label: "Race elapsed:", value: `${(elapsedPct * 100).toFixed(0)}%  ${bar(elapsedPct, 20)}` },
+    { label: "Time left:", value: timeLeft },
+    {
+      label: "XP:",
+      value: lvl.next_level_xp === null ? `${lvl.xp} (max level)  ${bar(1, 20)}` : `${lvl.xp_into_level}/${lvl.xp_for_level} \u2192 Lvl. ${lvl.level + 1}  ${bar(lvl.progress, 20)}`
+    },
+    {
+      label: "Last heartbeat:",
+      value: /* @__PURE__ */ jsxs5(Fragment2, { children: [
+        lastHeartbeatAgoSec === null ? "\u2014" : `${lastHeartbeatAgoSec}s ago`,
+        " ",
+        /* @__PURE__ */ jsx7(Text7, { color: lastHeartbeatOk ? "green" : "yellow", children: lastHeartbeatOk ? "\u2713" : "\u26A0" })
+      ] })
+    }
+  ];
   return /* @__PURE__ */ jsxs5(Box7, { flexDirection: "column", borderStyle: "round", paddingX: 1, children: [
     /* @__PURE__ */ jsxs5(Text7, { children: [
       "\u{1F3C7} TOKEN DERBY \u2500\u2500\u2500 ",
@@ -1470,40 +1535,7 @@ function StatusScreen(props) {
       ] })
     ] }),
     /* @__PURE__ */ jsxs5(Box7, { flexDirection: "column", marginTop: 1, children: [
-      /* @__PURE__ */ jsxs5(Text7, { children: [
-        "Tokens (race):  ",
-        own?.current_tokens ?? 0
-      ] }),
-      /* @__PURE__ */ jsxs5(Text7, { children: [
-        "Position:       ",
-        own?.rank ?? "\u2014",
-        " of ",
-        race.horses.length
-      ] }),
-      /* @__PURE__ */ jsxs5(Text7, { children: [
-        "Leader:         ",
-        leader ? `${leader.name}${leader.user_name ? ` (${leader.user_name})` : ""} \u2014 ${leader.current_tokens}` : "\u2014"
-      ] }),
-      /* @__PURE__ */ jsxs5(Text7, { children: [
-        "Race elapsed:   ",
-        (elapsedPct * 100).toFixed(0),
-        "%  ",
-        bar(elapsedPct, 20)
-      ] }),
-      /* @__PURE__ */ jsxs5(Text7, { children: [
-        "Time left:      ",
-        timeLeft
-      ] }),
-      /* @__PURE__ */ jsxs5(Text7, { children: [
-        "XP:             ",
-        lvl.next_level_xp === null ? `${lvl.xp} (max level)  ${bar(1, 20)}` : `${lvl.xp_into_level}/${lvl.xp_for_level} \u2192 Lvl. ${lvl.level + 1}  ${bar(lvl.progress, 20)}`
-      ] }),
-      /* @__PURE__ */ jsxs5(Text7, { children: [
-        "Last heartbeat: ",
-        lastHeartbeatAgoSec === null ? "\u2014" : `${lastHeartbeatAgoSec}s ago`,
-        " ",
-        /* @__PURE__ */ jsx7(Text7, { color: lastHeartbeatOk ? "green" : "yellow", children: lastHeartbeatOk ? "\u2713" : "\u26A0" })
-      ] }),
+      /* @__PURE__ */ jsx7(StatLines, { rows }),
       stalled && /* @__PURE__ */ jsxs5(Text7, { color: "yellow", children: [
         "\u26A0 ",
         stallReason ?? "Can't read token usage",
@@ -1514,6 +1546,17 @@ function StatusScreen(props) {
     /* @__PURE__ */ jsx7(Box7, { marginTop: 1, children: /* @__PURE__ */ jsx7(Text7, { dimColor: true, children: "Press Ctrl+C to crash out of the race." }) })
   ] });
 }
+function StatLines(props) {
+  const width = Math.max(...props.rows.map((r) => r.label.length)) + 1;
+  return /* @__PURE__ */ jsx7(Fragment2, { children: props.rows.map((r) => /* @__PURE__ */ jsxs5(Text7, { children: [
+    r.label.padEnd(width),
+    r.value
+  ] }, r.label)) });
+}
+function leaderText(h) {
+  if (!h) return "\u2014";
+  return `${h.name}${h.user_name ? ` (${h.user_name})` : ""} \u2014 ${h.final_scored_tokens ?? scoredOf(h)}`;
+}
 function elapsed(race) {
   const start = new Date(race.start_time).getTime();
   const end = new Date(race.end_time).getTime();
@@ -1526,6 +1569,22 @@ function bar(pct, width) {
   const filled = Math.round(pct * width);
   return "\u2593".repeat(filled) + "\u2591".repeat(width - filled);
 }
+function staminaLine(own, race) {
+  const stamina = own?.stamina ?? 100;
+  const cfg = resolveStaminaConfig(race);
+  const floor = cfg.taper_floor;
+  const band = stamina > 50 ? "green" : stamina >= floor ? "amber" : "red";
+  const color = band === "green" ? "green" : band === "amber" ? "yellow" : "red";
+  const pct = Math.max(0, Math.min(1, stamina / 100));
+  const multiplier = band === "red" ? cfg.tired_multiplier + (1 - cfg.tired_multiplier) * (stamina / floor) : null;
+  return {
+    label: "Stamina:",
+    value: /* @__PURE__ */ jsxs5(Text7, { color, children: [
+      `${Math.round(stamina)}%  ${bar(pct, 20)}`,
+      multiplier !== null ? `  \xD7${multiplier.toFixed(2)}` : ""
+    ] })
+  };
+}
 function statusColor(status) {
   if (status === "live") return "green";
   if (status === "pending") return "yellow";