tokengolf 0.4.2 → 0.5.0

package/hooks/session-end.js

@@ -23,10 +23,10 @@ function writeTTY(text) {
 }
 
 function termWidth(str) {
-  // Compute display width of a string, handling emoji variation selectors and surrogates.
+  // Compute display width of a string for achievement line wrapping.
+  // Handles emoji variation selectors and surrogates:
   // - Supplementary plane chars (> U+FFFF) → 2 cols
-  // - U+FE0F (emoji variation selector after BMP char) → upgrades prev from 1→2, adds 0 itself
-  // - U+FE0F after supplementary → 0 (already 2)
+  // - U+FE0F (emoji variation selector after BMP char) → upgrades prev from 1→2
   // - U+FE0E, ZWJ, zero-width chars → 0
   // - Everything else → 1
   /* eslint-disable no-control-regex */
@@ -52,7 +52,7 @@ function termWidth(str) {
 }
 
 function renderScorecard(run) {
-  const W = Math.min(Math.max((process.stdout.columns || 88) - 4, 72), 120);
+  const W = Math.min(Math.max((process.stdout.columns || 88) - 8, 40), 80);
   const won = run.status === 'won';
   const flowMode = !run.budget;
 
@@ -65,28 +65,13 @@ function renderScorecard(run) {
     RESET = '\x1b[0m',
     BOLD = '\x1b[1m';
   const bc = won ? Y : R;
+  const BLK = '██';
 
-  const tl = '╔',
-    tr = '╗',
-    bl = '╚',
-    br = '╝';
-  const h = '═',
-    v = '║';
-  const ml = '╠',
-    mr = '╣';
-
-  function bar() {
-    return bc + ml + h.repeat(W) + mr + RESET;
-  }
-  function top() {
-    return bc + tl + h.repeat(W) + tr + RESET;
-  }
-  function bot() {
-    return bc + bl + h.repeat(W) + br + RESET;
-  }
   function row(content) {
-    const pad = Math.max(0, W - termWidth(content) - 2);
-    return bc + v + RESET + ' ' + content + ' '.repeat(pad) + ' ' + bc + v + RESET;
+    return bc + BLK + RESET + '  ' + content;
+  }
+  function bar() {
+    return bc + BLK + RESET + '  ' + DIM + '─'.repeat(W) + RESET;
   }
 
   const mc = getModelClass(run.model);
@@ -147,7 +132,7 @@ function renderScorecard(run) {
   for (const token of achTokens) {
     const sep = currentLine ? '  ' : '';
     const testLen = termWidth(currentLine + sep + token);
-    if (currentLine && testLen > W - 2) {
+    if (currentLine && testLen > W) {
       achLines.push(currentLine);
       currentLine = token;
     } else {
@@ -160,7 +145,7 @@ function renderScorecard(run) {
   const thinkRow =
     ti > 0 ? `${M}🔮 ${ti} ultrathink${ti > 1 ? ' invocations' : ' invocation'}${RESET}` : null;
 
-  const lines = [top(), row(header), row(questStr), bar(), row(midRow)];
+  const lines = ['', row(header), row(questStr), bar(), row(midRow)];
 
   if (thinkRow) {
     lines.push(bar());
@@ -180,7 +165,7 @@ function renderScorecard(run) {
       `${DIM}tokengolf scorecard${RESET}  ·  ${DIM}tokengolf start${RESET}  ·  ${DIM}tokengolf stats${RESET}`
     )
   );
-  lines.push(bot());
+  lines.push('');
 
   return lines.join('\n');
 }

package/install.sh

@@ -0,0 +1,69 @@
+#!/usr/bin/env bash
+# TokenGolf installer
+# Usage: curl -fsSL https://raw.githubusercontent.com/josheche/tokengolf/main/install.sh | bash
+set -euo pipefail
+
+BOLD='\033[1m'
+DIM='\033[2m'
+GREEN='\033[32m'
+YELLOW='\033[33m'
+RED='\033[31m'
+CYAN='\033[36m'
+RESET='\033[0m'
+
+info()  { printf "${BOLD}${CYAN}▶${RESET} %s\n" "$1"; }
+ok()    { printf "${BOLD}${GREEN}✓${RESET} %s\n" "$1"; }
+warn()  { printf "${BOLD}${YELLOW}!${RESET} %s\n" "$1"; }
+err()   { printf "${BOLD}${RED}✗${RESET} %s\n" "$1" >&2; }
+
+echo ""
+printf "${YELLOW}██${RESET}  ${BOLD}TokenGolf Installer${RESET}\n"
+printf "${YELLOW}██${RESET}  ${DIM}Every token matters.${RESET}\n"
+echo ""
+
+# Check Node.js
+if ! command -v node &>/dev/null; then
+  err "Node.js is required but not installed."
+  echo ""
+  echo "  Install Node.js (v18+) from:"
+  echo "    https://nodejs.org"
+  echo "    brew install node"
+  echo "    curl -fsSL https://fnm.vercel.app/install | bash"
+  echo ""
+  exit 1
+fi
+
+NODE_VERSION=$(node -v | sed 's/v//' | cut -d. -f1)
+if [ "$NODE_VERSION" -lt 18 ]; then
+  err "Node.js v18+ required (found v$(node -v | sed 's/v//'))"
+  exit 1
+fi
+
+ok "Node.js $(node -v) detected"
+
+# Check npm
+if ! command -v npm &>/dev/null; then
+  err "npm is required but not installed."
+  exit 1
+fi
+
+# Install tokengolf globally
+info "Installing tokengolf via npm..."
+npm install -g tokengolf
+
+ok "tokengolf installed ($(tokengolf --version 2>/dev/null || echo 'unknown version'))"
+
+# Patch Claude Code hooks (only if Claude Code is installed)
+if [ -d "$HOME/.claude" ]; then
+  info "Installing Claude Code hooks..."
+  tokengolf install
+else
+  warn "Claude Code not detected — skipping hook setup."
+  printf "  Run ${CYAN}tokengolf install${RESET} after installing Claude Code.\n"
+fi
+
+echo ""
+printf "${YELLOW}██${RESET}  ${BOLD}${GREEN}Ready to play!${RESET}\n"
+printf "${YELLOW}██${RESET}  ${DIM}Open Claude Code and /exit to see your first scorecard.${RESET}\n"
+printf "${YELLOW}██${RESET}  ${DIM}Or run: tokengolf start${RESET}\n"
+echo ""

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tokengolf",
-  "version": "0.4.2",
+  "version": "0.5.0",
   "description": "Gamify your Claude Code sessions. Flow mode tracks you. Roguelike mode trains you.",
   "type": "module",
   "bin": {
@@ -36,5 +36,6 @@
   },
   "engines": {
     "node": ">=18.0.0"
-  }
+  },
+  "license": "MIT"
 }

package/scripts/update-homebrew.sh

@@ -0,0 +1,39 @@
+#!/usr/bin/env bash
+# Updates the Homebrew formula after npm publish.
+# Usage: ./scripts/update-homebrew.sh
+set -euo pipefail
+
+VERSION=$(node -p "require('./package.json').version")
+TARBALL="https://registry.npmjs.org/tokengolf/-/tokengolf-${VERSION}.tgz"
+TAP_DIR="${TAP_DIR:-../homebrew-tokengolf}"
+FORMULA="${TAP_DIR}/Formula/tokengolf.rb"
+
+echo "Updating Homebrew formula to v${VERSION}..."
+
+# Fetch SHA256 of the published tarball
+SHA=$(curl -sfL "$TARBALL" | shasum -a 256 | cut -d' ' -f1)
+if [ -z "$SHA" ]; then
+  echo "Error: could not fetch tarball at ${TARBALL}" >&2
+  echo "Has the version been published to npm?" >&2
+  exit 1
+fi
+
+echo "  tarball: ${TARBALL}"
+echo "  sha256:  ${SHA}"
+
+# Update formula (BSD sed on macOS; GNU sed on Linux omits the '')
+if [[ "$OSTYPE" == "darwin"* ]]; then
+  sed -i '' "s|url \".*\"|url \"${TARBALL}\"|" "$FORMULA"
+  sed -i '' "s|sha256 \".*\"|sha256 \"${SHA}\"|" "$FORMULA"
+else
+  sed -i "s|url \".*\"|url \"${TARBALL}\"|" "$FORMULA"
+  sed -i "s|sha256 \".*\"|sha256 \"${SHA}\"|" "$FORMULA"
+fi
+
+# Commit and push
+cd "$TAP_DIR"
+git add Formula/tokengolf.rb
+git commit -m "tokengolf ${VERSION}"
+git push
+
+echo "Done — brew upgrade tokengolf will now pull v${VERSION}"

package/src/components/ActiveRun.js

@@ -10,6 +10,7 @@ import {
   formatElapsed,
   FLOORS,
 } from '../lib/score.js';
+import { ACCENT_BORDER, ACCENT_PADDING } from '../lib/ui.js';
 
 export function ActiveRun({ run: initialRun }) {
   const { exit } = useApp();
@@ -48,9 +49,12 @@ export function ActiveRun({ run: initialRun }) {
       </Box>
 
       <Box
-        borderStyle="round"
+        borderStyle={ACCENT_BORDER}
         borderColor="yellow"
-        paddingX={1}
+        borderRight={false}
+        borderTop={false}
+        borderBottom={false}
+        paddingLeft={ACCENT_PADDING}
         paddingY={1}
         flexDirection="column"
         gap={1}
@@ -121,7 +125,7 @@ export function ActiveRun({ run: initialRun }) {
         </Box>
 
         {pct >= 80 && pct < 100 && (
-          <Box borderStyle="single" borderColor="red" paddingX={1}>
+          <Box paddingLeft={1}>
             <Text color="red" bold>
               ⚠️ BUDGET WARNING — {formatCost(run.budget - run.spent)} left
             </Text>

package/src/components/ScoreCard.js

@@ -11,6 +11,7 @@ import {
   getOpusPct,
   MODEL_CLASSES,
 } from '../lib/score.js';
+import { ACCENT_BORDER, ACCENT_PADDING } from '../lib/ui.js';
 
 export function ScoreCard({ run }) {
   const { exit } = useApp();
@@ -37,9 +38,12 @@ export function ScoreCard({ run }) {
     <Box flexDirection="column" paddingX={1} paddingY={1} gap={1}>
       {/* Big status header */}
       <Box
-        borderStyle="double"
+        borderStyle={ACCENT_BORDER}
         borderColor={won ? 'yellow' : 'red'}
-        paddingX={2}
+        borderRight={false}
+        borderTop={false}
+        borderBottom={false}
+        paddingLeft={ACCENT_PADDING}
         paddingY={1}
         flexDirection="column"
         gap={1}
@@ -213,13 +217,7 @@ export function ScoreCard({ run }) {
 
         {/* Death tip */}
         {!won && run.budget && (
-          <Box
-            borderStyle="single"
-            borderColor="red"
-            paddingX={1}
-            marginTop={1}
-            flexDirection="column"
-          >
+          <Box marginTop={1} flexDirection="column" paddingLeft={1}>
             <Text color="red" bold>
               Cause of death: Budget exceeded by {formatCost(run.spent - run.budget)}
             </Text>

package/src/components/StartRun.js

@@ -3,12 +3,16 @@ import { Box, Text, useApp } from 'ink';
 import { TextInput, Select, ConfirmInput } from '@inkjs/ui';
 import { setCurrentRun } from '../lib/state.js';
 import { getModelClass, getEffortLevel, getModelBudgets, FLOORS } from '../lib/score.js';
+import { ACCENT_BORDER, ACCENT_PADDING } from '../lib/ui.js';
 
 const MODEL_OPTIONS = [
-  { label: '⚔️  Sonnet  — Balanced. The default run.  [Normal]', value: 'claude-sonnet-4-6' },
-  { label: '🏹 Haiku   — Glass cannon. Hard mode.     [Hard]', value: 'claude-haiku-4-5-20251001' },
-  { label: '⚜️  Paladin — Opus plans, Sonnet executes. [Calculated]', value: 'opusplan' },
-  { label: '🧙 Opus    — Powerful but expensive.      [Easy]', value: 'claude-opus-4-6' },
+  { label: '⚔️  Sonnet  — Balanced. The default run.  [Standard]', value: 'claude-sonnet-4-6' },
+  {
+    label: '🏹 Haiku   — Glass cannon. Hard mode.     [Nightmare]',
+    value: 'claude-haiku-4-5-20251001',
+  },
+  { label: '⚜️  Paladin — Opus plans, Sonnet executes. [Tactical]', value: 'opusplan' },
+  { label: '🧙 Opus    — Powerful but expensive.      [Casual]', value: 'claude-opus-4-6' },
 ];
 
 const EFFORT_OPTIONS_BASE = [
@@ -62,9 +66,12 @@ export function StartRun() {
       <Box
         flexDirection="column"
         gap={1}
-        borderStyle="single"
+        borderStyle={ACCENT_BORDER}
         borderColor="gray"
-        paddingX={1}
+        borderRight={false}
+        borderTop={false}
+        borderBottom={false}
+        paddingLeft={ACCENT_PADDING}
         paddingY={1}
       >
         {/* Quest */}
@@ -176,9 +183,21 @@ export function StartRun() {
         {step === 'confirm' && (
           <Box flexDirection="column" gap={1} marginTop={1}>
             <Box
-              borderStyle="round"
+              borderStyle={{
+                topLeft: ' ',
+                top: ' ',
+                topRight: ' ',
+                left: '██',
+                right: ' ',
+                bottomLeft: ' ',
+                bottom: ' ',
+                bottomRight: ' ',
+              }}
               borderColor="yellow"
-              paddingX={1}
+              borderRight={false}
+              borderTop={false}
+              borderBottom={false}
+              paddingLeft={ACCENT_PADDING}
               paddingY={1}
               flexDirection="column"
             >

package/src/components/StatsView.js

@@ -1,6 +1,7 @@
 import React from 'react';
 import { Box, Text, useApp, useInput } from 'ink';
 import { getTier, getModelClass, getBudgetPct, formatCost } from '../lib/score.js';
+import { ACCENT_BORDER, ACCENT_PADDING } from '../lib/ui.js';
 
 export function StatsView({ stats }) {
   const { exit } = useApp();
@@ -33,7 +34,16 @@ export function StatsView({ stats }) {
       </Box>
 
       {/* Top line */}
-      <Box borderStyle="single" borderColor="gray" paddingX={1} paddingY={1} gap={4}>
+      <Box
+        borderStyle={ACCENT_BORDER}
+        borderColor="gray"
+        borderRight={false}
+        borderTop={false}
+        borderBottom={false}
+        paddingLeft={ACCENT_PADDING}
+        paddingY={1}
+        gap={4}
+      >
         <Box flexDirection="column">
           <Text color="gray" dimColor>
             RUNS
@@ -85,9 +95,21 @@ export function StatsView({ stats }) {
             <Box flexDirection="column" gap={0}>
               <Text color="yellow">🏆 Personal Best</Text>
               <Box
-                borderStyle="round"
+                borderStyle={{
+                  topLeft: ' ',
+                  top: ' ',
+                  topRight: ' ',
+                  left: '██',
+                  right: ' ',
+                  bottomLeft: ' ',
+                  bottom: ' ',
+                  bottomRight: ' ',
+                }}
                 borderColor="yellow"
-                paddingX={1}
+                borderRight={false}
+                borderTop={false}
+                borderBottom={false}
+                paddingLeft={ACCENT_PADDING}
                 paddingY={1}
                 flexDirection="column"
               >
@@ -141,16 +163,14 @@ export function StatsView({ stats }) {
           <Text color="gray" dimColor>
             Recent achievements:
           </Text>
-          <Box flexWrap="wrap" gap={1}>
+          <Box flexWrap="wrap" columnGap={2}>
             {stats.achievements.slice(0, 12).map((a, i) => (
-              <Box key={i} borderStyle="single" borderColor="gray" paddingX={1}>
-                <Text>
-                  {a.emoji}{' '}
-                  <Text color="gray" dimColor>
-                    {a.label}
-                  </Text>
+              <Text key={i}>
+                {a.emoji}{' '}
+                <Text color="gray" dimColor>
+                  {a.label}
                 </Text>
-              </Box>
+              </Text>
             ))}
           </Box>
         </Box>

package/src/lib/score.js

@@ -37,28 +37,28 @@ export const MODEL_CLASSES = {
     name: 'Haiku',
     label: 'Rogue',
     emoji: '🏹',
-    difficulty: 'Hard',
+    difficulty: 'Nightmare',
     color: 'red',
   },
   sonnet: {
     name: 'Sonnet',
     label: 'Fighter',
     emoji: '⚔️',
-    difficulty: 'Normal',
+    difficulty: 'Standard',
     color: 'cyan',
   },
   opusplan: {
     name: 'Paladin',
     label: 'Paladin',
     emoji: '⚜️',
-    difficulty: 'Calculated',
+    difficulty: 'Tactical',
     color: 'yellow',
   },
   opus: {
     name: 'Opus',
     label: 'Warlock',
     emoji: '🧙',
-    difficulty: 'Easy',
+    difficulty: 'Casual',
     color: 'magenta',
   },
 };

package/src/lib/ui.js

@@ -0,0 +1,16 @@
+// Shared UI constants for Ink components
+
+// Design D: left-only ██ block accent bar.
+// paddingLeft: 3 = 2 visible spaces after ██ (border eats 1)
+export const ACCENT_BORDER = {
+  topLeft: ' ',
+  top: ' ',
+  topRight: ' ',
+  left: '██',
+  right: ' ',
+  bottomLeft: ' ',
+  bottom: ' ',
+  bottomRight: ' ',
+};
+
+export const ACCENT_PADDING = 3;