tokengolf 0.4.1 → 0.4.2

package/src/lib/demo-fixtures.js

@@ -0,0 +1,496 @@
+// Shared fixture data for all demo variants
+// Each fixture is a realistic run/stats object ready to render
+
+const NOW = '2026-03-10T14:00:00Z';
+const AGO = (mins) => new Date(Date.now() - mins * 60000).toISOString();
+
+// ─── ScoreCard fixtures ─────────────────────────────────────────────
+
+export const SCORECARD_FIXTURES = [
+  {
+    title: 'Won · Sonnet · LEGENDARY · multi-model · achievements',
+    run: {
+      id: 'run_demo_1',
+      quest: 'add pagination to /users endpoint',
+      model: 'claude-sonnet-4-6',
+      budget: 1.5,
+      spent: 0.23,
+      status: 'won',
+      mode: 'roguelike',
+      effort: 'high',
+      fastMode: false,
+      floor: 5,
+      totalFloors: 5,
+      promptCount: 6,
+      totalToolCalls: 18,
+      toolCalls: { Read: 8, Edit: 4, Bash: 3, Grep: 2, Glob: 1 },
+      failedToolCalls: 0,
+      subagentSpawns: 0,
+      turnCount: 14,
+      thinkingInvocations: 0,
+      thinkingTokens: 0,
+      sessionCount: 1,
+      fainted: false,
+      compactionEvents: [],
+      modelBreakdown: { 'claude-sonnet-4-6': 0.19, 'claude-haiku-4-5-20251001': 0.04 },
+      achievements: [
+        { key: 'sniper', label: 'Sniper — Under 25% budget', emoji: '🎯' },
+        { key: 'silver_sonnet', label: 'Silver — Completed with Sonnet', emoji: '🥈' },
+        { key: 'no_rest', label: 'No Rest for the Wicked — One session', emoji: '🔥' },
+        { key: 'clean_run', label: 'Clean Run — Zero failed tool calls', emoji: '✅' },
+        { key: 'toolbox', label: 'Toolbox — 5+ distinct tool types', emoji: '🧰' },
+        { key: 'silent_run', label: 'Silent Run — No extended thinking', emoji: '🤫' },
+      ],
+      startedAt: AGO(12),
+      endedAt: NOW,
+    },
+  },
+  {
+    title: 'Won · Flow mode · minimal',
+    run: {
+      id: 'run_demo_2',
+      quest: null,
+      model: 'claude-sonnet-4-6',
+      budget: null,
+      spent: 0.0034,
+      status: 'won',
+      mode: 'flow',
+      effort: null,
+      fastMode: false,
+      floor: 1,
+      totalFloors: 5,
+      promptCount: 2,
+      totalToolCalls: 5,
+      toolCalls: { Read: 3, Edit: 2 },
+      failedToolCalls: 0,
+      subagentSpawns: 0,
+      turnCount: 3,
+      thinkingInvocations: 0,
+      thinkingTokens: 0,
+      sessionCount: 1,
+      fainted: false,
+      compactionEvents: [],
+      modelBreakdown: { 'claude-sonnet-4-6': 0.0034 },
+      achievements: [
+        { key: 'penny', label: 'Penny Pincher — Under $0.10', emoji: '🪙' },
+        { key: 'cheap_shots', label: 'Cheap Shots — Under $0.01/prompt', emoji: '💲' },
+      ],
+      startedAt: AGO(3),
+      endedAt: NOW,
+    },
+  },
+  {
+    title: 'Won · Opus · ultrathink · EFFICIENT',
+    run: {
+      id: 'run_demo_3',
+      quest: 'refactor auth middleware to support SAML SSO',
+      model: 'claude-opus-4-6',
+      budget: 7.5,
+      spent: 3.41,
+      status: 'won',
+      mode: 'roguelike',
+      effort: 'max',
+      fastMode: false,
+      floor: 5,
+      totalFloors: 5,
+      promptCount: 8,
+      totalToolCalls: 32,
+      toolCalls: { Read: 12, Edit: 8, Bash: 6, Grep: 4, Write: 2 },
+      failedToolCalls: 1,
+      subagentSpawns: 3,
+      turnCount: 24,
+      thinkingInvocations: 4,
+      thinkingTokens: 12400,
+      sessionCount: 2,
+      fainted: true,
+      compactionEvents: [{ trigger: 'auto', context_window: { used_percentage: 92 } }],
+      modelBreakdown: { 'claude-opus-4-6': 3.22, 'claude-haiku-4-5-20251001': 0.19 },
+      achievements: [
+        { key: 'efficient', label: 'Efficient — Under 50% budget', emoji: '⚡' },
+        { key: 'bronze_opus', label: 'Bronze — Completed with Opus', emoji: '🥉' },
+        { key: 'archmagus', label: 'Archmagus — Opus max effort, completed', emoji: '👑' },
+        { key: 'deep_thinker', label: 'Deep Thinker — 3+ ultrathink invocations', emoji: '🌀' },
+        { key: 'spell_cast', label: 'Spell Cast — Used extended thinking', emoji: '🔮' },
+        { key: 'came_back', label: 'Came Back — Fainted and finished', emoji: '🧟' },
+        { key: 'overencumbered', label: 'Overencumbered — Auto-compacted', emoji: '📦' },
+        { key: 'summoner', label: 'Summoner — 3+ subagents spawned', emoji: '📡' },
+      ],
+      startedAt: AGO(95),
+      endedAt: NOW,
+    },
+  },
+  {
+    title: 'Won · Haiku · Diamond · one-shot',
+    run: {
+      id: 'run_demo_4',
+      quest: 'fix typo in README badge URL',
+      model: 'claude-haiku-4-5-20251001',
+      budget: 0.15,
+      spent: 0.0089,
+      status: 'won',
+      mode: 'roguelike',
+      effort: null,
+      fastMode: false,
+      floor: 5,
+      totalFloors: 5,
+      promptCount: 1,
+      totalToolCalls: 3,
+      toolCalls: { Read: 1, Edit: 1, Bash: 1 },
+      failedToolCalls: 0,
+      subagentSpawns: 0,
+      turnCount: 2,
+      thinkingInvocations: 0,
+      thinkingTokens: 0,
+      sessionCount: 1,
+      fainted: false,
+      compactionEvents: [],
+      modelBreakdown: { 'claude-haiku-4-5-20251001': 0.0089 },
+      achievements: [
+        { key: 'diamond', label: 'Diamond — Haiku under $0.10', emoji: '💎' },
+        { key: 'gold_haiku', label: 'Gold — Completed with Haiku', emoji: '🥇' },
+        { key: 'one_shot', label: 'One Shot — Single prompt', emoji: '🥊' },
+        { key: 'sniper', label: 'Sniper — Under 25% budget', emoji: '🎯' },
+        { key: 'penny', label: 'Penny Pincher — Under $0.10', emoji: '🪙' },
+        { key: 'speedrun', label: 'Speedrun — Under 5 minutes', emoji: '⏱️' },
+        { key: 'lone_wolf', label: 'Lone Wolf — No subagents', emoji: '🐺' },
+        { key: 'surgeon', label: 'Surgeon — 1-3 edits, under budget', emoji: '🔪' },
+      ],
+      startedAt: AGO(2),
+      endedAt: NOW,
+    },
+  },
+  {
+    title: 'Died · Sonnet · BUSTED · death marks',
+    run: {
+      id: 'run_demo_5',
+      quest: 'migrate postgres schema to v3',
+      model: 'claude-sonnet-4-6',
+      budget: 1.5,
+      spent: 3.87,
+      status: 'died',
+      mode: 'roguelike',
+      effort: 'high',
+      fastMode: false,
+      floor: 3,
+      totalFloors: 5,
+      promptCount: 22,
+      totalToolCalls: 48,
+      toolCalls: { Read: 18, Edit: 12, Bash: 10, Grep: 5, Write: 3 },
+      failedToolCalls: 7,
+      subagentSpawns: 2,
+      turnCount: 34,
+      thinkingInvocations: 2,
+      thinkingTokens: 5200,
+      sessionCount: 1,
+      fainted: false,
+      compactionEvents: [
+        { trigger: 'auto', context_window: { used_percentage: 94 } },
+        { trigger: 'auto', context_window: { used_percentage: 91 } },
+      ],
+      modelBreakdown: { 'claude-sonnet-4-6': 3.52, 'claude-haiku-4-5-20251001': 0.35 },
+      achievements: [
+        { key: 'hubris', label: 'Hubris — Ultrathink, busted anyway', emoji: '🤦' },
+        { key: 'blowout', label: 'Blowout — Spent 2× budget', emoji: '💥' },
+        { key: 'fumble', label: 'Fumble — 5+ failed tool calls', emoji: '🤡' },
+        { key: 'tool_happy', label: 'Tool Happy — 30+ tool calls, died', emoji: '🔨' },
+        { key: 'expensive_taste', label: 'Expensive Taste — $0.50+/prompt', emoji: '🍷' },
+      ],
+      startedAt: AGO(45),
+      endedAt: NOW,
+    },
+  },
+  {
+    title: 'Died · Haiku · SO CLOSE',
+    run: {
+      id: 'run_demo_6',
+      quest: 'fix N+1 query in dashboard loader',
+      model: 'claude-haiku-4-5-20251001',
+      budget: 0.4,
+      spent: 0.43,
+      status: 'died',
+      mode: 'roguelike',
+      effort: null,
+      fastMode: false,
+      floor: 4,
+      totalFloors: 5,
+      promptCount: 9,
+      totalToolCalls: 15,
+      toolCalls: { Read: 7, Edit: 4, Bash: 3, Grep: 1 },
+      failedToolCalls: 1,
+      subagentSpawns: 0,
+      turnCount: 12,
+      thinkingInvocations: 0,
+      thinkingTokens: 0,
+      sessionCount: 1,
+      fainted: false,
+      compactionEvents: [],
+      modelBreakdown: { 'claude-haiku-4-5-20251001': 0.43 },
+      achievements: [
+        { key: 'so_close', label: 'So Close — Died within 10% of budget', emoji: '😭' },
+        { key: 'silent_death', label: 'Silent Death — Died with 2 prompts', emoji: '🪦' },
+      ],
+      startedAt: AGO(18),
+      endedAt: NOW,
+    },
+  },
+  {
+    title: 'Won · Paladin · Architect · multi-model breakdown',
+    run: {
+      id: 'run_demo_7',
+      quest: 'design and implement webhook retry system',
+      model: 'opusplan',
+      budget: 4.5,
+      spent: 2.18,
+      status: 'won',
+      mode: 'roguelike',
+      effort: 'high',
+      fastMode: false,
+      floor: 5,
+      totalFloors: 5,
+      promptCount: 10,
+      totalToolCalls: 28,
+      toolCalls: { Read: 10, Edit: 7, Bash: 5, Grep: 3, Write: 2, Agent: 1 },
+      failedToolCalls: 0,
+      subagentSpawns: 1,
+      turnCount: 20,
+      thinkingInvocations: 2,
+      thinkingTokens: 8100,
+      sessionCount: 1,
+      fainted: false,
+      compactionEvents: [],
+      modelBreakdown: {
+        'claude-opus-4-6': 1.42,
+        'claude-sonnet-4-6': 0.68,
+        'claude-haiku-4-5-20251001': 0.08,
+      },
+      achievements: [
+        { key: 'paladin', label: 'Paladin — Opus planning mode', emoji: '⚜️' },
+        { key: 'efficient', label: 'Efficient — Under 50% budget', emoji: '⚡' },
+        { key: 'architect', label: 'Architect — Opus handled 65% of cost', emoji: '🏛️' },
+        { key: 'spell_cast', label: 'Spell Cast — Used extended thinking', emoji: '🔮' },
+        { key: 'clean_run', label: 'Clean Run — Zero failed tool calls', emoji: '✅' },
+        { key: 'toolbox', label: 'Toolbox — 6 distinct tool types', emoji: '🧰' },
+      ],
+      startedAt: AGO(35),
+      endedAt: NOW,
+    },
+  },
+];
+
+// ─── ActiveRun fixtures ─────────────────────────────────────────────
+
+export const ACTIVERUN_FIXTURES = [
+  {
+    title: 'Roguelike · Sonnet · early run · Floor 1',
+    run: {
+      id: 'run_demo_a1',
+      quest: 'implement rate limiting middleware',
+      model: 'claude-sonnet-4-6',
+      budget: 1.5,
+      spent: 0.12,
+      status: 'active',
+      mode: 'roguelike',
+      effort: 'high',
+      floor: 1,
+      totalFloors: 5,
+      promptCount: 3,
+      totalToolCalls: 8,
+      toolCalls: { Read: 4, Grep: 2, Glob: 2 },
+      startedAt: AGO(8),
+    },
+  },
+  {
+    title: 'Roguelike · Opus · mid-run · Floor 3 · budget warning',
+    run: {
+      id: 'run_demo_a2',
+      quest: 'refactor database connection pooling',
+      model: 'claude-opus-4-6',
+      budget: 7.5,
+      spent: 6.34,
+      status: 'active',
+      mode: 'roguelike',
+      effort: 'max',
+      floor: 3,
+      totalFloors: 5,
+      promptCount: 12,
+      totalToolCalls: 35,
+      toolCalls: { Read: 14, Edit: 9, Bash: 8, Grep: 3, Write: 1 },
+      startedAt: AGO(42),
+    },
+  },
+  {
+    title: 'Flow mode · Haiku · light session',
+    run: {
+      id: 'run_demo_a3',
+      quest: 'Flow',
+      model: 'claude-haiku-4-5-20251001',
+      budget: null,
+      spent: 0.018,
+      status: 'active',
+      mode: 'flow',
+      effort: null,
+      floor: 1,
+      totalFloors: 5,
+      promptCount: 4,
+      totalToolCalls: 11,
+      toolCalls: { Read: 6, Grep: 3, Bash: 2 },
+      startedAt: AGO(5),
+    },
+  },
+  {
+    title: 'Roguelike · Haiku · Floor 4 · CLOSE CALL',
+    run: {
+      id: 'run_demo_a4',
+      quest: 'fix flaky test in CI pipeline',
+      model: 'claude-haiku-4-5-20251001',
+      budget: 0.4,
+      spent: 0.31,
+      status: 'active',
+      mode: 'roguelike',
+      effort: null,
+      floor: 4,
+      totalFloors: 5,
+      promptCount: 7,
+      totalToolCalls: 16,
+      toolCalls: { Read: 6, Bash: 5, Edit: 3, Grep: 2 },
+      startedAt: AGO(15),
+    },
+  },
+];
+
+// ─── StatsView fixtures ─────────────────────────────────────────────
+
+export const STATS_FIXTURES = [
+  {
+    title: 'Veteran player — 24 runs, mixed results',
+    stats: {
+      total: 24,
+      wins: 18,
+      deaths: 6,
+      winRate: 75,
+      avgSpend: 1.42,
+      bestRun: {
+        quest: 'fix typo in README badge URL',
+        model: 'claude-haiku-4-5-20251001',
+        spent: 0.0089,
+        budget: 0.15,
+      },
+      recentRuns: [
+        {
+          status: 'won',
+          quest: 'add pagination to /users',
+          spent: 0.23,
+          budget: 1.5,
+          model: 'claude-sonnet-4-6',
+        },
+        {
+          status: 'won',
+          quest: 'refactor auth middleware',
+          spent: 3.41,
+          budget: 7.5,
+          model: 'claude-opus-4-6',
+        },
+        {
+          status: 'died',
+          quest: 'migrate postgres schema',
+          spent: 3.87,
+          budget: 1.5,
+          model: 'claude-sonnet-4-6',
+        },
+        {
+          status: 'won',
+          quest: 'fix N+1 query',
+          spent: 0.08,
+          budget: 0.4,
+          model: 'claude-haiku-4-5-20251001',
+        },
+        { status: 'won', quest: null, spent: 0.0034, model: 'claude-sonnet-4-6' },
+        {
+          status: 'won',
+          quest: 'webhook retry system',
+          spent: 2.18,
+          budget: 4.5,
+          model: 'opusplan',
+        },
+        {
+          status: 'died',
+          quest: 'rewrite billing module',
+          spent: 12.4,
+          budget: 7.5,
+          model: 'claude-opus-4-6',
+        },
+        {
+          status: 'won',
+          quest: 'add dark mode toggle',
+          spent: 0.41,
+          budget: 1.5,
+          model: 'claude-sonnet-4-6',
+        },
+      ],
+      achievements: [
+        { emoji: '🎯', label: 'Sniper' },
+        { emoji: '🥈', label: 'Silver' },
+        { emoji: '🔥', label: 'No Rest' },
+        { emoji: '✅', label: 'Clean Run' },
+        { emoji: '🧰', label: 'Toolbox' },
+        { emoji: '💎', label: 'Diamond' },
+        { emoji: '🥊', label: 'One Shot' },
+        { emoji: '🪙', label: 'Penny Pincher' },
+        { emoji: '⏱️', label: 'Speedrun' },
+        { emoji: '🐺', label: 'Lone Wolf' },
+        { emoji: '🔪', label: 'Surgeon' },
+        { emoji: '⚡', label: 'Efficient' },
+      ],
+    },
+  },
+  {
+    title: 'New player — 3 runs',
+    stats: {
+      total: 3,
+      wins: 2,
+      deaths: 1,
+      winRate: 67,
+      avgSpend: 0.89,
+      bestRun: {
+        quest: 'add loading spinner',
+        model: 'claude-sonnet-4-6',
+        spent: 0.34,
+        budget: 1.5,
+      },
+      recentRuns: [
+        {
+          status: 'won',
+          quest: 'add loading spinner',
+          spent: 0.34,
+          budget: 1.5,
+          model: 'claude-sonnet-4-6',
+        },
+        {
+          status: 'died',
+          quest: 'setup auth flow',
+          spent: 1.92,
+          budget: 1.5,
+          model: 'claude-sonnet-4-6',
+        },
+        { status: 'won', quest: null, spent: 0.41, model: 'claude-sonnet-4-6' },
+      ],
+      achievements: [
+        { emoji: '🥈', label: 'Silver' },
+        { emoji: '🔥', label: 'No Rest' },
+      ],
+    },
+  },
+  {
+    title: 'Empty — no runs yet',
+    stats: {
+      total: 0,
+      wins: 0,
+      deaths: 0,
+      winRate: 0,
+      avgSpend: 0,
+      bestRun: null,
+      recentRuns: [],
+      achievements: [],
+    },
+  },
+];

package/src/lib/demo-hud.js

@@ -0,0 +1,3 @@
+// Demo: HUD statusline variants (ANSI, no Ink)
+import { runDemo } from './demo.js';
+export { runDemo as runHudDemo };

package/src/lib/demo-render.js

@@ -0,0 +1,16 @@
+// Shared render helper for demo mode — provides a fake stdin so useInput doesn't crash
+import { Readable } from 'stream';
+import { render } from 'ink';
+
+function makeFakeStdin() {
+  const s = new Readable({ read() {} });
+  s.setRawMode = () => s;
+  s.ref = () => s;
+  s.unref = () => s;
+  s.isTTY = true;
+  return s;
+}
+
+export function demoRender(element) {
+  return render(element, { stdin: makeFakeStdin() });
+}

package/src/lib/demo-scorecard.js

@@ -0,0 +1,56 @@
+// Demo: ScoreCard variants (Ink)
+import React from 'react';
+import { Box, Text } from 'ink';
+import { demoRender } from './demo-render.js';
+import { ScoreCard } from '../components/ScoreCard.js';
+import { SCORECARD_FIXTURES } from './demo-fixtures.js';
+
+function DemoScoreCard({ fixture }) {
+  return (
+    <Box flexDirection="column">
+      <Box paddingX={1}>
+        <Text color="gray" dimColor>
+          {'─'.repeat(50)}
+        </Text>
+      </Box>
+      <Box paddingX={1}>
+        <Text color="gray" dimColor italic>
+          {fixture.title}
+        </Text>
+      </Box>
+      <ScoreCard run={fixture.run} />
+    </Box>
+  );
+}
+
+export function runScoreCardDemo(index) {
+  const fixtures = index != null ? [SCORECARD_FIXTURES[index]] : SCORECARD_FIXTURES;
+  if (!fixtures[0]) {
+    console.log(
+      `Invalid index. ${SCORECARD_FIXTURES.length} scorecards available (0-${SCORECARD_FIXTURES.length - 1}).`
+    );
+    process.exit(1);
+  }
+
+  console.log('');
+  console.log('\x1b[1m\x1b[36m⛳ TokenGolf — ScoreCard Demo\x1b[0m');
+  console.log(`\x1b[2m${fixtures.length} variant${fixtures.length > 1 ? 's' : ''}\x1b[0m`);
+
+  return new Promise((resolve) => {
+    let i = 0;
+    function renderNext() {
+      if (i >= fixtures.length) {
+        resolve();
+        return;
+      }
+      const fixture = fixtures[i];
+      const inst = demoRender(React.createElement(DemoScoreCard, { fixture }));
+      setTimeout(() => {
+        inst.unmount();
+        i++;
+        renderNext();
+      }, 100);
+    }
+    renderNext();
+  });
+}

package/src/lib/demo-stats.js

@@ -0,0 +1,56 @@
+// Demo: StatsView variants (Ink)
+import React from 'react';
+import { Box, Text } from 'ink';
+import { demoRender } from './demo-render.js';
+import { StatsView } from '../components/StatsView.js';
+import { STATS_FIXTURES } from './demo-fixtures.js';
+
+function DemoStatsView({ fixture }) {
+  return (
+    <Box flexDirection="column">
+      <Box paddingX={1}>
+        <Text color="gray" dimColor>
+          {'─'.repeat(50)}
+        </Text>
+      </Box>
+      <Box paddingX={1}>
+        <Text color="gray" dimColor italic>
+          {fixture.title}
+        </Text>
+      </Box>
+      <StatsView stats={fixture.stats} />
+    </Box>
+  );
+}
+
+export function runStatsDemo(index) {
+  const fixtures = index != null ? [STATS_FIXTURES[index]] : STATS_FIXTURES;
+  if (!fixtures[0]) {
+    console.log(
+      `Invalid index. ${STATS_FIXTURES.length} variants available (0-${STATS_FIXTURES.length - 1}).`
+    );
+    process.exit(1);
+  }
+
+  console.log('');
+  console.log('\x1b[1m\x1b[36m⛳ TokenGolf — StatsView Demo\x1b[0m');
+  console.log(`\x1b[2m${fixtures.length} variant${fixtures.length > 1 ? 's' : ''}\x1b[0m`);
+
+  return new Promise((resolve) => {
+    let i = 0;
+    function renderNext() {
+      if (i >= fixtures.length) {
+        resolve();
+        return;
+      }
+      const fixture = fixtures[i];
+      const inst = demoRender(React.createElement(DemoStatsView, { fixture }));
+      setTimeout(() => {
+        inst.unmount();
+        i++;
+        renderNext();
+      }, 100);
+    }
+    renderNext();
+  });
+}