tokengolf 0.3.0 → 0.4.0

package/eslint.config.js

@@ -0,0 +1,39 @@
+import js from '@eslint/js';
+import prettier from 'eslint-config-prettier';
+
+const sharedGlobals = {
+  process: 'readonly',
+  console: 'readonly',
+  setTimeout: 'readonly',
+  clearTimeout: 'readonly',
+  setInterval: 'readonly',
+  clearInterval: 'readonly',
+  Buffer: 'readonly',
+  URL: 'readonly',
+};
+
+const sharedRules = {
+  'no-unused-vars': ['warn', { argsIgnorePattern: '^_' }],
+  'no-console': 'off',
+  'no-empty': ['error', { allowEmptyCatch: true }],
+};
+
+export default [
+  js.configs.recommended,
+  prettier,
+  {
+    files: ['src/**/*.js', 'hooks/**/*.js'],
+    languageOptions: {
+      ecmaVersion: 'latest',
+      sourceType: 'module',
+      parserOptions: {
+        ecmaFeatures: { jsx: true },
+      },
+      globals: sharedGlobals,
+    },
+    rules: sharedRules,
+  },
+  {
+    ignores: ['dist/**', 'node_modules/**'],
+  },
+];

package/hooks/post-tool-use-failure.js

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+
+const STATE_FILE = path.join(os.homedir(), '.tokengolf', 'current-run.json');
+
+let input = '';
+process.stdin.setEncoding('utf8');
+process.stdin.on('data', (chunk) => {
+  input += chunk;
+});
+process.stdin.on('end', () => {
+  try {
+    const run = JSON.parse(fs.readFileSync(STATE_FILE, 'utf8'));
+    if (!run || run.status !== 'active') process.exit(0);
+
+    const updated = {
+      ...run,
+      failedToolCalls: (run.failedToolCalls || 0) + 1,
+    };
+    fs.writeFileSync(STATE_FILE, JSON.stringify(updated, null, 2));
+  } catch {
+    // silent fail
+  }
+  process.exit(0);
+});

package/hooks/post-tool-use.js

@@ -7,7 +7,9 @@ const STATE_FILE = path.join(os.homedir(), '.tokengolf', 'current-run.json');
 
 let input = '';
 process.stdin.setEncoding('utf8');
-process.stdin.on('data', chunk => { input += chunk; });
+process.stdin.on('data', (chunk) => {
+  input += chunk;
+});
 process.stdin.on('end', () => {
   try {
     const run = JSON.parse(fs.readFileSync(STATE_FILE, 'utf8'));
@@ -29,12 +31,14 @@ process.stdin.on('end', () => {
     const pct = updated.spent / updated.budget;
     if (pct >= 0.8 && pct < 1.0) {
       const remaining = (updated.budget - updated.spent).toFixed(4);
-      process.stdout.write(JSON.stringify({
-        hookSpecificOutput: {
-          hookEventName: 'PostToolUse',
-          systemMessage: `⚠️ TokenGolf: $${updated.spent.toFixed(4)} of $${updated.budget.toFixed(2)} spent (${Math.round(pct * 100)}%). Only $${remaining} left. Be concise and targeted.`,
-        },
-      }));
+      process.stdout.write(
+        JSON.stringify({
+          hookSpecificOutput: {
+            hookEventName: 'PostToolUse',
+            systemMessage: `⚠️ TokenGolf: $${updated.spent.toFixed(4)} of $${updated.budget.toFixed(2)} spent (${Math.round(pct * 100)}%). Only $${remaining} left. Be concise and targeted.`,
+          },
+        })
+      );
     }
   } catch {
     // silent fail

package/hooks/pre-compact.js

@@ -7,15 +7,21 @@ const STATE_FILE = path.join(os.homedir(), '.tokengolf', 'current-run.json');
 
 try {
   let stdin = '';
-  try { stdin = fs.readFileSync('/dev/stdin', 'utf8'); } catch {}
+  try {
+    stdin = fs.readFileSync('/dev/stdin', 'utf8');
+  } catch {}
 
   let event = {};
-  try { event = JSON.parse(stdin); } catch {}
+  try {
+    event = JSON.parse(stdin);
+  } catch {}
 
   const trigger = event.trigger || 'auto'; // 'manual' or 'auto'
 
   let run = null;
-  try { run = JSON.parse(fs.readFileSync(STATE_FILE, 'utf8')); } catch {}
+  try {
+    run = JSON.parse(fs.readFileSync(STATE_FILE, 'utf8'));
+  } catch {}
   if (!run || run.status !== 'active') process.exit(0);
 
   const compactionEvents = run.compactionEvents || [];

package/hooks/session-end.js

@@ -2,12 +2,15 @@
 import { fileURLToPath } from 'url';
 import path from 'path';
 import fs from 'fs';
+import os from 'os';
 
 const __dir = path.dirname(fileURLToPath(import.meta.url));
 const { autoDetectCost } = await import(path.join(__dir, '../src/lib/cost.js'));
 const { getCurrentRun, clearCurrentRun } = await import(path.join(__dir, '../src/lib/state.js'));
 const { saveRun } = await import(path.join(__dir, '../src/lib/store.js'));
-const { getTier, getModelClass, getEffortLevel, getEfficiencyRating, getBudgetPct } = await import(path.join(__dir, '../src/lib/score.js'));
+const { getTier, getModelClass, getEffortLevel, getEfficiencyRating, getBudgetPct } = await import(
+  path.join(__dir, '../src/lib/score.js')
+);
 
 function writeTTY(text) {
   try {
@@ -19,26 +22,70 @@ function writeTTY(text) {
   }
 }
 
+function termWidth(str) {
+  // Compute display width of a string, handling 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+FE0E, ZWJ, zero-width chars → 0
+  // - Everything else → 1
+  /* eslint-disable no-control-regex */
+  const plain = str.replace(/\x1b\[[0-9;]*m/g, '');
+  /* eslint-enable no-control-regex */
+  const cps = [...plain].map((c) => c.codePointAt(0));
+  let width = 0;
+  for (let i = 0; i < cps.length; i++) {
+    const cp = cps[i];
+    if (cp === 0xfe0f) {
+      // Emoji presentation selector: if previous was a narrow BMP char, upgrade it to 2
+      if (i > 0 && cps[i - 1] <= 0xffff && cps[i - 1] !== 0x200d) width += 1;
+      continue;
+    }
+    if (cp === 0xfe0e || cp === 0x200d || (cp >= 0x200b && cp <= 0x200f)) continue;
+    if (cp > 0xffff) {
+      width += 2;
+      continue;
+    }
+    width += 1;
+  }
+  return width;
+}
+
 function renderScorecard(run) {
   const W = Math.min(Math.max((process.stdout.columns || 88) - 4, 72), 120);
   const won = run.status === 'won';
   const flowMode = !run.budget;
 
-  const R = '\x1b[31m', G = '\x1b[32m', Y = '\x1b[33m', C = '\x1b[36m';
-  const M = '\x1b[35m', DIM = '\x1b[2m', RESET = '\x1b[0m', BOLD = '\x1b[1m';
+  const R = '\x1b[31m',
+    G = '\x1b[32m',
+    Y = '\x1b[33m',
+    C = '\x1b[36m';
+  const M = '\x1b[35m',
+    DIM = '\x1b[2m',
+    RESET = '\x1b[0m',
+    BOLD = '\x1b[1m';
   const bc = won ? Y : R;
 
-  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; }
+  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) {
-    // Strip ANSI for length calculation
-    const plain = content.replace(/\x1b\[[0-9;]*m/g, '');
-    const pad = Math.max(0, W - plain.length - 2);
+    const pad = Math.max(0, W - termWidth(content) - 2);
     return bc + v + RESET + ' ' + content + ' '.repeat(pad) + ' ' + bc + v + RESET;
   }
 
@@ -50,8 +97,8 @@ function renderScorecard(run) {
   const header = won
     ? `${BOLD}${Y}🏆  SESSION COMPLETE${RESET}`
     : fainted
-    ? `${BOLD}${Y}💤  FAINTED — Run Continues${RESET}`
-    : `${BOLD}${R}💀  BUDGET BUSTED${RESET}`;
+      ? `${BOLD}${Y}💤  FAINTED — Run Continues${RESET}`
+      : `${BOLD}${R}💀  BUDGET BUSTED${RESET}`;
 
   const questStr = run.quest
     ? `${BOLD}${run.quest.slice(0, 60)}${RESET}`
@@ -61,54 +108,78 @@ function renderScorecard(run) {
   const spentThisSession = run.spent - spentBefore;
   const multiSession = sessions > 1 && spentBefore > 0;
 
-  const spentStr = `${won ? G : R}$${run.spent.toFixed(4)}${RESET}` +
+  const spentStr =
+    `${won ? G : R}$${run.spent.toFixed(4)}${RESET}` +
     (multiSession ? `  ${DIM}(+$${spentThisSession.toFixed(4)} this session)${RESET}` : '');
 
   let midRow = spentStr;
   if (!flowMode) {
     const pct = getBudgetPct(run.spent, run.budget);
     const eff = getEfficiencyRating(run.spent, run.budget);
-    const effC = eff.color === 'magenta' ? M : eff.color === 'cyan' ? C : eff.color === 'green' ? G : eff.color === 'yellow' ? Y : R;
+    const effC =
+      eff.color === 'magenta'
+        ? M
+        : eff.color === 'cyan'
+          ? C
+          : eff.color === 'green'
+            ? G
+            : eff.color === 'yellow'
+              ? Y
+              : R;
     midRow += `  ${DIM}/${RESET}$${run.budget.toFixed(2)}  ${pct}%  ${effC}${eff.emoji} ${eff.label}${RESET}`;
   }
 
   const effortInfo = run.effort ? getEffortLevel(run.effort) : null;
   const modelSuffix = [
-    run.effort && run.effort !== 'medium' && effortInfo ? effortInfo.label : null,
+    run.effort && effortInfo ? effortInfo.label : null,
     run.fastMode ? '⚡Fast' : null,
-  ].filter(Boolean).join('·');
+  ]
+    .filter(Boolean)
+    .join('·');
   midRow += `  ${C}${mc.emoji} ${mc.name}${modelSuffix ? '·' + modelSuffix : ''}${RESET}`;
   midRow += `  ${tier.emoji} ${tier.label}`;
   if (multiSession) midRow += `  ${DIM}${sessions} sessions${RESET}`;
 
   const achievements = run.achievements || [];
-  const achStr = achievements.map(a => `${a.emoji} ${a.key}`).join('  ');
+  const achTokens = achievements.map((a) => `${a.emoji} ${a.key}`);
+  const achLines = [];
+  let currentLine = '';
+  for (const token of achTokens) {
+    const sep = currentLine ? '  ' : '';
+    const testLen = termWidth(currentLine + sep + token);
+    if (currentLine && testLen > W - 2) {
+      achLines.push(currentLine);
+      currentLine = token;
+    } else {
+      currentLine += sep + token;
+    }
+  }
+  if (currentLine) achLines.push(currentLine);
 
   const ti = run.thinkingInvocations || 0;
-  const thinkRow = ti > 0
-    ? `${M}🔮 ${ti} ultrathink${ti > 1 ? ' invocations' : ' invocation'}${RESET}`
-    : null;
-
-  const lines = [
-    top(),
-    row(header),
-    row(questStr),
-    bar(),
-    row(midRow),
-  ];
+  const thinkRow =
+    ti > 0 ? `${M}🔮 ${ti} ultrathink${ti > 1 ? ' invocations' : ' invocation'}${RESET}` : null;
+
+  const lines = [top(), row(header), row(questStr), bar(), row(midRow)];
 
   if (thinkRow) {
     lines.push(bar());
     lines.push(row(thinkRow));
   }
 
-  if (achievements.length > 0) {
+  if (achLines.length > 0) {
     lines.push(bar());
-    lines.push(row(achStr));
+    for (const line of achLines) {
+      lines.push(row(line));
+    }
   }
 
   lines.push(bar());
-  lines.push(row(`${DIM}tokengolf scorecard${RESET}  ·  ${DIM}tokengolf start${RESET}  ·  ${DIM}tokengolf stats${RESET}`));
+  lines.push(
+    row(
+      `${DIM}tokengolf scorecard${RESET}  ·  ${DIM}tokengolf start${RESET}  ·  ${DIM}tokengolf stats${RESET}`
+    )
+  );
   lines.push(bot());
 
   return lines.join('\n');
@@ -116,27 +187,71 @@ function renderScorecard(run) {
 
 try {
   let stdin = '';
-  try { stdin = fs.readFileSync('/dev/stdin', 'utf8'); } catch {}
+  try {
+    stdin = fs.readFileSync('/dev/stdin', 'utf8');
+  } catch {}
 
   let event = {};
-  try { event = JSON.parse(stdin); } catch {}
+  try {
+    event = JSON.parse(stdin);
+  } catch {}
   const reason = event.reason || 'other';
 
+  // Read authoritative cost from StatusLine sidecar (same source as the HUD)
+  let liveCost = null;
+  try {
+    const raw = fs
+      .readFileSync(path.join(os.homedir(), '.tokengolf', 'session-cost'), 'utf8')
+      .trim();
+    const parsed = parseFloat(raw);
+    if (!isNaN(parsed) && parsed > 0) liveCost = parsed;
+  } catch {}
+  // SessionEnd event may also carry cost (future-proofing)
+  const eventCost = event.cost?.total_cost_usd ?? null;
+  // Priority: liveCost (StatusLine sidecar) > eventCost > transcript parsing
+  const authoritativeCost = liveCost ?? eventCost;
+
   const run = getCurrentRun();
   if (!run || run.status !== 'active') process.exit(0);
 
-  const result = autoDetectCost(run);
-  if (!result) process.exit(0); // no transcripts found, nothing to save
+  let result = autoDetectCost(run);
+  if (!result && authoritativeCost === null) process.exit(0); // no data at all
+  if (!result) result = { spent: 0, modelBreakdown: {}, thinkingInvocations: 0, thinkingTokens: 0 };
+  // Always prefer authoritative cost over manual transcript recomputation
+  if (authoritativeCost !== null) {
+    // Scale model breakdown to match authoritative total (transcript ratios are correct, amounts are not)
+    if (result.modelBreakdown && Object.keys(result.modelBreakdown).length > 0) {
+      const parsedTotal = Object.values(result.modelBreakdown).reduce((s, v) => s + v, 0);
+      if (parsedTotal > 0) {
+        const scale = authoritativeCost / parsedTotal;
+        for (const model of Object.keys(result.modelBreakdown)) {
+          result.modelBreakdown[model] *= scale;
+        }
+      }
+    }
+    result.spent = authoritativeCost;
+  }
+
+  // Merge model breakdown by family (e.g. claude-opus-4-6 + claude-opus-4-20250514 → Opus)
+  if (result.modelBreakdown && Object.keys(result.modelBreakdown).length > 0) {
+    const merged = {};
+    for (const [model, cost] of Object.entries(result.modelBreakdown)) {
+      const m = model.toLowerCase();
+      const family = m.includes('haiku') ? 'Haiku' : m.includes('sonnet') ? 'Sonnet' : 'Opus';
+      merged[family] = (merged[family] || 0) + cost;
+    }
+    result.modelBreakdown = merged;
+  }
 
   // reason 'other' = unexpected exit (usage limit hit = Fainted)
   // clean exits: 'clear', 'logout', 'prompt_input_exit', 'bypass_permissions_disabled'
   const cleanExits = ['clear', 'logout', 'prompt_input_exit', 'bypass_permissions_disabled'];
-  const fainted = !cleanExits.includes(reason) && reason !== 'other' ? false
-    : reason === 'other';
+  const fainted = !cleanExits.includes(reason) && reason !== 'other' ? false : reason === 'other';
 
   let status;
   if (run.budget && result.spent > run.budget) status = 'died';
-  else if (fainted) status = 'resting'; // hit limit, run continues next session
+  else if (fainted)
+    status = 'resting'; // hit limit, run continues next session
   else status = 'won';
 
   const thinkingFields = {
@@ -148,7 +263,14 @@ try {
   if (status === 'resting') {
     const { setCurrentRun } = await import(path.join(__dir, '../src/lib/state.js'));
     setCurrentRun({ ...run, spent: result.spent, fainted: true, ...thinkingFields });
-    const saved = { ...run, spent: result.spent, modelBreakdown: result.modelBreakdown, status, fainted: true, ...thinkingFields };
+    const saved = {
+      ...run,
+      spent: result.spent,
+      modelBreakdown: result.modelBreakdown,
+      status,
+      fainted: true,
+      ...thinkingFields,
+    };
     writeTTY('\n' + renderScorecard({ ...saved, achievements: [] }) + '\n\n');
     process.exit(0);
   }
@@ -163,6 +285,10 @@ try {
   });
 
   clearCurrentRun();
+  // Clean up sidecar cost file
+  try {
+    fs.unlinkSync(path.join(os.homedir(), '.tokengolf', 'session-cost'));
+  } catch {}
 
   writeTTY('\n' + renderScorecard(saved) + '\n\n');
 } catch {

package/hooks/session-start.js

@@ -4,7 +4,7 @@ import path from 'path';
 import os from 'os';
 
 const STATE_FILE = path.join(os.homedir(), '.tokengolf', 'current-run.json');
-const STATE_DIR  = path.join(os.homedir(), '.tokengolf');
+const STATE_DIR = path.join(os.homedir(), '.tokengolf');
 
 function detectEffort() {
   const fromEnv = process.env.CLAUDE_CODE_EFFORT_LEVEL;
@@ -13,28 +13,40 @@ function detectEffort() {
     path.join(os.homedir(), '.claude', 'settings.json'),
     path.join(process.env.PWD || process.cwd(), '.claude', 'settings.json'),
   ]) {
-    try { const s = JSON.parse(fs.readFileSync(p, 'utf8')); if (s.effortLevel) return s.effortLevel; } catch {}
+    try {
+      const s = JSON.parse(fs.readFileSync(p, 'utf8'));
+      if (s.effortLevel) return s.effortLevel;
+    } catch {}
   }
   return null;
 }
 
 function detectFastMode() {
   try {
-    const s = JSON.parse(fs.readFileSync(path.join(os.homedir(), '.claude', 'settings.json'), 'utf8'));
+    const s = JSON.parse(
+      fs.readFileSync(path.join(os.homedir(), '.claude', 'settings.json'), 'utf8')
+    );
     return s.fastMode === true;
-  } catch { return false; }
+  } catch {
+    return false;
+  }
 }
 
 try {
   const cwd = process.env.PWD || process.cwd();
 
   let run = null;
-  try { run = JSON.parse(fs.readFileSync(STATE_FILE, 'utf8')); } catch { /* no run */ }
+  try {
+    run = JSON.parse(fs.readFileSync(STATE_FILE, 'utf8'));
+  } catch {
+    /* no run */
+  }
 
   if (!run || run.status !== 'active') {
     // Flow mode: auto-start a tracking run for this session
     if (!fs.existsSync(STATE_DIR)) fs.mkdirSync(STATE_DIR, { recursive: true });
     run = {
+      id: `run_${Date.now()}`,
       quest: null,
       model: 'claude-sonnet-4-6',
       budget: null,
@@ -48,6 +60,12 @@ try {
       promptCount: 0,
       totalToolCalls: 0,
       toolCalls: {},
+      failedToolCalls: 0,
+      subagentSpawns: 0,
+      turnCount: 0,
+      thinkingInvocations: 0,
+      thinkingTokens: 0,
+      fainted: false,
       cwd,
       sessionCount: 1,
       compactionEvents: [],
@@ -88,12 +106,14 @@ Efficiency tips:
 - Be specific — avoid exploratory reads when you know the target
 - Scope bash commands tightly`;
 
-  process.stdout.write(JSON.stringify({
-    hookSpecificOutput: {
-      hookEventName: 'SessionStart',
-      additionalContext: context,
-    },
-  }));
+  process.stdout.write(
+    JSON.stringify({
+      hookSpecificOutput: {
+        hookEventName: 'SessionStart',
+        additionalContext: context,
+      },
+    })
+  );
 } catch {
   // silent fail
 }

package/hooks/session-stop.js

@@ -7,7 +7,9 @@ const STATE_FILE = path.join(os.homedir(), '.tokengolf', 'current-run.json');
 
 let input = '';
 process.stdin.setEncoding('utf8');
-process.stdin.on('data', chunk => { input += chunk; });
+process.stdin.on('data', (chunk) => {
+  input += chunk;
+});
 process.stdin.on('end', () => {
   try {
     const event = JSON.parse(input);
@@ -20,6 +22,8 @@ process.stdin.on('end', () => {
     if (!run || run.status !== 'active') process.exit(0);
 
     fs.writeFileSync(STATE_FILE, JSON.stringify({ ...run, spent: cost }, null, 2));
-  } catch { /* no run or no cost data */ }
+  } catch {
+    /* no run or no cost data */
+  }
   process.exit(0);
 });

package/hooks/statusline.sh

@@ -15,21 +15,30 @@ try:
 except: sys.exit(0)
 
 cost    = (session.get('cost') or {}).get('total_cost_usd') or run.get('spent', 0)
+# Persist CC's authoritative cost so session-end can read it (SessionEnd doesn't receive cost in stdin)
+try:
+    with open(os.path.join(os.path.expanduser('~'), '.tokengolf', 'session-cost'), 'w') as _cf: _cf.write(str(cost))
+except: pass
 ctx_pct = (session.get('context_window') or {}).get('used_percentage') or None
 quest   = (run.get('quest') or 'Flow')[:32]
 budget  = run.get('budget')
 floor   = f"{run.get('floor',1)}/{run.get('totalFloors',5)}"
-m       = run.get('model', '').lower()
-if   'haiku'  in m: model, model_emoji = 'Haiku',  '🏹'
-elif 'sonnet' in m: model, model_emoji = 'Sonnet', '⚔️'
-elif 'opus'   in m: model, model_emoji = 'Opus',   '🧙'
-else:               model, model_emoji = '?',       '?'
-effort  = run.get('effort')
+sm = session.get('model') or {}; m = (sm.get('id','') or run.get('model','') if isinstance(sm,dict) else sm or run.get('model','')).lower()
+# opusplan must be checked before opus (opusplan contains 'opus' as substring)
+if   'opusplan' in m: model, model_emoji = 'Paladin', '⚜️'
+elif 'haiku'    in m: model, model_emoji = 'Haiku',   '🏹'
+elif 'sonnet'   in m: model, model_emoji = 'Sonnet',  '⚔️'
+elif 'opus'     in m: model, model_emoji = 'Opus',    '🧙'
+else:                 model, model_emoji = '?',        '?'
+try:
+    with open(os.path.expanduser('~/.claude/settings.json')) as _sf: _s = json.load(_sf)
+except: _s = {}
+effort  = _s.get('effortLevel')
 fast    = run.get('fastMode', False)
 fainted = run.get('fainted', False)
 
 label_parts = [f'{model_emoji} {model}']
-if effort and effort != 'medium': label_parts.append(effort.capitalize())
+if effort: label_parts.append(effort.capitalize())
 if fast: label_parts.append('⚡Fast')
 model_label = '·'.join(label_parts)
 

package/hooks/stop.js

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+
+const STATE_FILE = path.join(os.homedir(), '.tokengolf', 'current-run.json');
+
+let input = '';
+process.stdin.setEncoding('utf8');
+process.stdin.on('data', (chunk) => {
+  input += chunk;
+});
+process.stdin.on('end', () => {
+  try {
+    const run = JSON.parse(fs.readFileSync(STATE_FILE, 'utf8'));
+    if (!run || run.status !== 'active') process.exit(0);
+
+    const updated = {
+      ...run,
+      turnCount: (run.turnCount || 0) + 1,
+    };
+    fs.writeFileSync(STATE_FILE, JSON.stringify(updated, null, 2));
+  } catch {
+    // silent fail
+  }
+  process.exit(0);
+});

package/hooks/subagent-start.js

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+
+const STATE_FILE = path.join(os.homedir(), '.tokengolf', 'current-run.json');
+
+let input = '';
+process.stdin.setEncoding('utf8');
+process.stdin.on('data', (chunk) => {
+  input += chunk;
+});
+process.stdin.on('end', () => {
+  try {
+    const run = JSON.parse(fs.readFileSync(STATE_FILE, 'utf8'));
+    if (!run || run.status !== 'active') process.exit(0);
+
+    const updated = {
+      ...run,
+      subagentSpawns: (run.subagentSpawns || 0) + 1,
+    };
+    fs.writeFileSync(STATE_FILE, JSON.stringify(updated, null, 2));
+  } catch {
+    // silent fail
+  }
+  process.exit(0);
+});

package/hooks/user-prompt-submit.js

@@ -16,12 +16,14 @@ try {
 
   // Nudge at 50% — once (between 50-60%)
   if (pct >= 0.5 && pct < 0.6) {
-    process.stdout.write(JSON.stringify({
-      hookSpecificOutput: {
-        hookEventName: 'UserPromptSubmit',
-        additionalContext: `[TokenGolf] Halfway point. $${updated.spent.toFixed(4)} of $${updated.budget.toFixed(2)} spent. Quest: "${updated.quest}" — stay focused.`,
-      },
-    }));
+    process.stdout.write(
+      JSON.stringify({
+        hookSpecificOutput: {
+          hookEventName: 'UserPromptSubmit',
+          additionalContext: `[TokenGolf] Halfway point. $${updated.spent.toFixed(4)} of $${updated.budget.toFixed(2)} spent. Quest: "${updated.quest}" — stay focused.`,
+        },
+      })
+    );
   }
 } catch {
   // silent fail