@tekyzinc/gsd-t 3.29.11 → 4.0.14

package/bin/gsd-t-token-capture.cjs

@@ -1,321 +0,0 @@
-'use strict';
-/**
- * GSD-T Token Capture Wrapper (M41 D1)
- *
- * Single reusable module every GSD-T spawn call site uses. Parses the
- * `usage` envelope from Claude's result frame, appends a row to
- * `.gsd-t/token-log.md`, and appends a schema-v1 JSONL record to
- * `.gsd-t/metrics/token-usage.jsonl`.
- *
- * Zero external deps. `.cjs` so it loads in both ESM-default projects
- * and CJS projects without transpilation.
- *
- * Contracts:
- *   - .gsd-t/contracts/metrics-schema-contract.md (schema v1)
- *   - .gsd-t/contracts/stream-json-sink-contract.md v1.1.0 (usage semantics)
- *
- * Missing `usage` → write `—` in Tokens column. Never `0`, never `N/A`.
- */
-
-const fs = require('fs');
-const path = require('path');
-
-const SCHEMA_VERSION = 2;
-
-const NEW_HEADER = '| Datetime-start | Datetime-end | Command | Step | Model | Duration(s) | Tokens | Notes | Domain | Task | Ctx% |';
-const NEW_SEP    = '|---|---|---|---|---|---|---|---|---|---|---|';
-
-function pad2(n) { return String(n).padStart(2, '0'); }
-function fmtDateTime(d) {
-  return `${d.getFullYear()}-${pad2(d.getMonth()+1)}-${pad2(d.getDate())} ${pad2(d.getHours())}:${pad2(d.getMinutes())}`;
-}
-
-function _parseUsageFromResult(result) {
-  if (!result || typeof result !== 'object') return undefined;
-  if (result.usage && typeof result.usage === 'object') return result.usage;
-  if (result.result && typeof result.result === 'object' && result.result.usage && typeof result.result.usage === 'object') {
-    return result.result.usage;
-  }
-  return undefined;
-}
-
-function _formatTokensCell(usage) {
-  if (!usage || typeof usage !== 'object') return '—';
-  const inp = Number(usage.input_tokens || 0);
-  const out = Number(usage.output_tokens || 0);
-  const cr  = Number(usage.cache_read_input_tokens || 0);
-  const cc  = Number(usage.cache_creation_input_tokens || 0);
-  const costNum = (typeof usage.total_cost_usd === 'number') ? usage.total_cost_usd : (typeof usage.cost_usd === 'number' ? usage.cost_usd : null);
-  const cost = (costNum == null) ? '—' : `$${costNum.toFixed(2)}`;
-  if (!inp && !out && !cr && !cc && cost === '—') return '—';
-  return `in=${inp} out=${out} cr=${cr} cc=${cc} ${cost}`;
-}
-
-function _ensureDir(p) {
-  const dir = path.dirname(p);
-  if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
-}
-
-function _ensureTokenLogHeader(tokenLogPath) {
-  if (!fs.existsSync(tokenLogPath)) {
-    _ensureDir(tokenLogPath);
-    fs.writeFileSync(tokenLogPath, `# GSD-T Token Log\n\n${NEW_HEADER}\n${NEW_SEP}\n`);
-    return;
-  }
-  const text = fs.readFileSync(tokenLogPath, 'utf8');
-  if (text.includes(NEW_HEADER)) return;
-  // Old header detection: first header line that starts with `| Datetime-start`
-  const lines = text.split('\n');
-  const headerIdx = lines.findIndex(l => /^\|\s*Datetime-start\s*\|/.test(l));
-  if (headerIdx < 0) {
-    // No header at all — append new one
-    fs.writeFileSync(tokenLogPath, text.trimEnd() + `\n\n${NEW_HEADER}\n${NEW_SEP}\n`);
-    return;
-  }
-  // Replace old header + separator with new header + separator, preserve existing rows
-  const sepIdx = headerIdx + 1;
-  lines[headerIdx] = NEW_HEADER;
-  if (lines[sepIdx] && /^\|[\s\-|]+\|$/.test(lines[sepIdx])) {
-    lines[sepIdx] = NEW_SEP;
-  } else {
-    lines.splice(sepIdx, 0, NEW_SEP);
-  }
-  fs.writeFileSync(tokenLogPath, lines.join('\n'));
-}
-
-function _appendTokenLogRow(tokenLogPath, row) {
-  _ensureTokenLogHeader(tokenLogPath);
-  const line = `| ${row.startedAt} | ${row.endedAt} | ${row.command} | ${row.step} | ${row.model} | ${row.durationSec}s | ${row.tokensCell} | ${row.notes} | ${row.domain} | ${row.task} | ${row.ctxPct} |\n`;
-  fs.appendFileSync(tokenLogPath, line);
-}
-
-function _appendJsonlRecord(jsonlPath, record) {
-  _ensureDir(jsonlPath);
-  fs.appendFileSync(jsonlPath, JSON.stringify(record) + '\n');
-}
-
-function _buildJsonlRecord({ command, step, model, startedAt, endedAt, durationSec, usage, domain, task, notes, ctxPct, milestone, source, sessionId, turnId, sessionType, toolAttribution, compactionPressure, cw_id }) {
-  const u = usage || {};
-  const cost = (typeof u.total_cost_usd === 'number') ? u.total_cost_usd : (typeof u.cost_usd === 'number' ? u.cost_usd : null);
-  const rec = {
-    schemaVersion: SCHEMA_VERSION,
-    ts: new Date().toISOString(),
-    source: source || 'live',
-    command,
-    step,
-    model,
-    startedAt,
-    endedAt,
-    durationMs: durationSec * 1000,
-    inputTokens: Number(u.input_tokens || 0),
-    outputTokens: Number(u.output_tokens || 0),
-    cacheReadInputTokens: Number(u.cache_read_input_tokens || 0),
-    cacheCreationInputTokens: Number(u.cache_creation_input_tokens || 0),
-    costUSD: cost,
-    domain: domain || null,
-    task: task || null,
-    milestone: milestone || null,
-    ctxPct: ctxPct == null ? null : ctxPct,
-    notes: notes || null,
-    hasUsage: !!usage,
-  };
-  if (sessionId != null)  rec.session_id  = String(sessionId);
-  if (turnId != null)     rec.turn_id     = String(turnId);
-  if (sessionType != null) rec.sessionType = sessionType;
-  if (Array.isArray(toolAttribution) && toolAttribution.length) rec.tool_attribution = toolAttribution;
-  if (compactionPressure && typeof compactionPressure === 'object') rec.compaction_pressure = compactionPressure;
-  // M44 D7 v2.1.0: optional per-Context-Window attribution key.
-  // Omitted (not null, not "") when the caller does not supply it, so
-  // pre-D7 callers continue to produce byte-identical rows.
-  if (cw_id != null && cw_id !== '') rec.cw_id = String(cw_id);
-  return rec;
-}
-
-function _inferMilestone(projectDir) {
-  try {
-    const progress = fs.readFileSync(path.join(projectDir, '.gsd-t', 'progress.md'), 'utf8');
-    const m = /\*\*(M\d+)\b/.exec(progress) || /## Status:\s*(M\d+)/.exec(progress);
-    return m ? m[1] : null;
-  } catch (_) { return null; }
-}
-
-function _resolveCtxPct(projectDir) {
-  try {
-    const tb = require('./token-budget.cjs');
-    const s = tb.getSessionStatus(projectDir);
-    return (s && typeof s.pct === 'number') ? s.pct : (s && s.pct) || 'N/A';
-  } catch (_) { return 'N/A'; }
-}
-
-function _parseStartedAt(s) {
-  if (!s) return Date.now();
-  if (/^\d{4}-\d{2}-\d{2} \d{2}:\d{2}$/.test(s)) {
-    const [d, t] = s.split(' ');
-    return new Date(`${d}T${t}:00`).getTime();
-  }
-  const parsed = Date.parse(s);
-  return Number.isFinite(parsed) ? parsed : Date.now();
-}
-
-/**
- * Record a single spawn row to both token-log.md and token-usage.jsonl.
- *
- * @param {object} opts
- * @param {string} opts.projectDir
- * @param {string} opts.command        e.g. 'gsd-t-execute'
- * @param {string} opts.step           e.g. 'Step 4'
- * @param {string} opts.model          e.g. 'sonnet'
- * @param {string} opts.startedAt      'YYYY-MM-DD HH:MM'
- * @param {string} opts.endedAt        'YYYY-MM-DD HH:MM'
- * @param {object} [opts.usage]        Claude usage envelope; undefined → '—'
- * @param {string} [opts.domain]
- * @param {string} [opts.task]
- * @param {string|number} [opts.ctxPct]
- * @param {string} [opts.notes]
- * @param {'live'|'backfill'} [opts.source]
- * @param {string} [opts.sessionId]          v2 — stable session identifier
- * @param {string|number} [opts.turnId]      v2 — per-turn identifier within sessionId
- * @param {'in-session'|'headless'} [opts.sessionType]  v2 — channel classifier
- * @param {Array}  [opts.toolAttribution]    v2 — D2 joiner output; usually omitted by spawn callers
- * @param {object} [opts.compactionPressure] v2 — D5 runway snapshot; usually omitted by spawn callers
- * @param {string} [opts.cw_id]              v2.1.0 — per-Context-Window attribution key (M44 D7).
- *                                            Pass-through only; the wrapper does not derive it.
- *                                            Omitted from the row when absent (NOT null, NOT "").
- * @returns {{tokenLogPath: string, jsonlPath: string}}
- */
-function recordSpawnRow(opts) {
-  const projectDir = opts.projectDir || '.';
-  const tokenLogPath = opts.tokenLogPath || path.join(projectDir, '.gsd-t', 'token-log.md');
-  const jsonlPath   = opts.jsonlPath   || path.join(projectDir, '.gsd-t', 'metrics', 'token-usage.jsonl');
-
-  const startMs = _parseStartedAt(opts.startedAt);
-  const endMs   = _parseStartedAt(opts.endedAt);
-  const durationSec = Math.max(0, Math.round((endMs - startMs) / 1000));
-
-  const tokensCell = _formatTokensCell(opts.usage);
-  const notes = (opts.notes == null || opts.notes === '') ? '-' : String(opts.notes).replace(/\|/g, '\\|');
-  const domain = (opts.domain == null || opts.domain === '') ? '-' : String(opts.domain);
-  const task   = (opts.task   == null || opts.task   === '') ? '-' : String(opts.task);
-  const ctxPct = (opts.ctxPct == null) ? 'N/A' : String(opts.ctxPct);
-
-  // skipMarkdownLog: JSONL is canonical (D3). The markdown log is a legacy view
-  // kept in sync for human-readable tailing; high-frequency producers (D1
-  // per-turn in-session rows, D2 joiner) should write JSONL-only and rely on
-  // `gsd-t tokens --regenerate-log` for the markdown rendering.
-  if (!opts.skipMarkdownLog) {
-    _appendTokenLogRow(tokenLogPath, {
-      startedAt: opts.startedAt,
-      endedAt: opts.endedAt,
-      command: opts.command,
-      step: opts.step,
-      model: opts.model,
-      durationSec,
-      tokensCell,
-      notes,
-      domain,
-      task,
-      ctxPct,
-    });
-  }
-
-  const milestone = opts.milestone || _inferMilestone(projectDir);
-  _appendJsonlRecord(jsonlPath, _buildJsonlRecord({
-    command: opts.command,
-    step: opts.step,
-    model: opts.model,
-    startedAt: opts.startedAt,
-    endedAt: opts.endedAt,
-    durationSec,
-    usage: opts.usage,
-    domain: opts.domain || null,
-    task: opts.task || null,
-    notes: opts.notes || null,
-    ctxPct: opts.ctxPct == null ? null : opts.ctxPct,
-    milestone,
-    source: opts.source || 'live',
-    sessionId: opts.sessionId,
-    turnId: opts.turnId,
-    sessionType: opts.sessionType,
-    toolAttribution: opts.toolAttribution,
-    compactionPressure: opts.compactionPressure,
-    cw_id: opts.cw_id,
-  }));
-
-  return { tokenLogPath, jsonlPath };
-}
-
-/**
- * Wrap an async spawn callable; capture timing + usage + write the row.
- *
- * @param {object} opts
- * @param {string} opts.command
- * @param {string} opts.step
- * @param {string} opts.model
- * @param {string} opts.description
- * @param {string} [opts.projectDir='.']
- * @param {() => Promise<any>} opts.spawnFn
- * @param {string} [opts.domain]
- * @param {string} [opts.task]
- * @returns {Promise<{result: any, usage: any|undefined, rowWritten: {tokenLogPath, jsonlPath}}>}
- */
-async function captureSpawn(opts) {
-  if (!opts || typeof opts.spawnFn !== 'function') {
-    throw new Error('captureSpawn: spawnFn is required and must be a function');
-  }
-  const projectDir = opts.projectDir || '.';
-  const startDate = new Date();
-  const startedAt = fmtDateTime(startDate);
-  const startMs = startDate.getTime();
-
-  // Visible banner before the spawn fires
-  process.stdout.write(`⚙ [${opts.model}] ${opts.command} → ${opts.description}\n`);
-
-  let result, caught;
-  try {
-    result = await opts.spawnFn();
-  } catch (err) {
-    caught = err;
-  }
-
-  const endDate = new Date();
-  const endedAt = fmtDateTime(endDate);
-
-  const usage = caught ? undefined : _parseUsageFromResult(result);
-  const ctxPct = _resolveCtxPct(projectDir);
-  const notes = caught ? `spawn_error: ${String(caught && caught.message || caught).slice(0, 200)}` : (opts.notes || '-');
-
-  const rowWritten = recordSpawnRow({
-    projectDir,
-    command: opts.command,
-    step: opts.step,
-    model: opts.model,
-    startedAt,
-    endedAt,
-    usage,
-    domain: opts.domain,
-    task: opts.task,
-    ctxPct,
-    notes,
-    sessionId: opts.sessionId,
-    turnId: opts.turnId,
-    sessionType: opts.sessionType,
-    toolAttribution: opts.toolAttribution,
-    compactionPressure: opts.compactionPressure,
-    cw_id: opts.cw_id,
-  });
-
-  if (caught) throw caught;
-  return { result, usage, rowWritten };
-}
-
-module.exports = {
-  captureSpawn,
-  recordSpawnRow,
-  _parseUsageFromResult,
-  _formatTokensCell,
-  _ensureTokenLogHeader,
-  _buildJsonlRecord,
-  SCHEMA_VERSION,
-  NEW_HEADER,
-  NEW_SEP,
-};

package/bin/gsd-t-token-dashboard.cjs

@@ -1,353 +0,0 @@
-'use strict';
-/**
- * GSD-T Token Dashboard (M41 D4)
- *
- * Cumulative historical view of `.gsd-t/metrics/token-usage.jsonl`.
- * Feeds the `gsd-t tokens` CLI and the token-block tail of `gsd-t status`.
- *
- * Zero external deps. `.cjs` for ESM/CJS compat.
- */
-
-const fs = require('fs');
-const path = require('path');
-const readline = require('readline');
-
-const DEFAULT_JSONL_PATH = (projectDir) => path.join(projectDir, '.gsd-t', 'metrics', 'token-usage.jsonl');
-
-function _safeParse(line) {
-  try { return JSON.parse(line); } catch (_) { return null; }
-}
-
-function _day(startedAt) {
-  if (!startedAt) return 'unknown';
-  // YYYY-MM-DD slice works for both ISO and our 'YYYY-MM-DD HH:MM' format.
-  return String(startedAt).slice(0, 10);
-}
-
-function _cost(r) {
-  return (typeof r.costUSD === 'number' && r.costUSD >= 0) ? r.costUSD : 0;
-}
-
-/**
- * Aggregate token-usage records.
- *
- * @param {object} opts
- * @param {string} opts.projectDir
- * @param {string} [opts.since]       YYYY-MM-DD (inclusive)
- * @param {string} [opts.milestone]   e.g. 'M41'
- * @returns {Promise<object>}
- */
-async function aggregate(opts) {
-  const projectDir = opts.projectDir || '.';
-  const jsonlPath = opts.jsonlPath || DEFAULT_JSONL_PATH(projectDir);
-  const sinceDay = opts.since || null;
-  const milestone = opts.milestone || null;
-
-  const agg = {
-    totalRecords: 0,
-    totalCostUSD: 0,
-    totalInputTokens: 0,
-    totalOutputTokens: 0,
-    totalCacheReadTokens: 0,
-    totalCacheCreateTokens: 0,
-    byDay: {},
-    byCommand: {},
-    byModel: {},
-    topSpawns: [],
-    rolling7d: { days: 0, totalCostUSD: 0, dailyAvgUSD: 0, monthlyProjectionUSD: 0 },
-    currentMilestone: milestone,
-    source: jsonlPath,
-  };
-
-  if (!fs.existsSync(jsonlPath)) {
-    return agg;
-  }
-
-  const rs = fs.createReadStream(jsonlPath, { encoding: 'utf8' });
-  const rl = readline.createInterface({ input: rs, crlfDelay: Infinity });
-
-  const rawRecords = [];
-
-  for await (const line of rl) {
-    const trimmed = line && line.trim();
-    if (!trimmed) continue;
-    const r = _safeParse(trimmed);
-    if (!r || typeof r !== 'object') continue;
-
-    const day = _day(r.startedAt);
-    if (sinceDay && day < sinceDay) continue;
-    if (milestone && r.milestone && r.milestone !== milestone) continue;
-    if (milestone && !r.milestone) continue;
-
-    rawRecords.push(r);
-
-    agg.totalRecords += 1;
-    agg.totalCostUSD += _cost(r);
-    agg.totalInputTokens += Number(r.inputTokens || 0);
-    agg.totalOutputTokens += Number(r.outputTokens || 0);
-    agg.totalCacheReadTokens += Number(r.cacheReadInputTokens || 0);
-    agg.totalCacheCreateTokens += Number(r.cacheCreationInputTokens || 0);
-
-    // byDay
-    if (!agg.byDay[day]) agg.byDay[day] = { day, records: 0, costUSD: 0, inputTokens: 0, outputTokens: 0 };
-    const d = agg.byDay[day];
-    d.records += 1;
-    d.costUSD += _cost(r);
-    d.inputTokens += Number(r.inputTokens || 0);
-    d.outputTokens += Number(r.outputTokens || 0);
-
-    // byCommand
-    const cmd = r.command || 'unknown';
-    if (!agg.byCommand[cmd]) agg.byCommand[cmd] = { command: cmd, records: 0, costUSD: 0, inputTokens: 0, outputTokens: 0 };
-    const c = agg.byCommand[cmd];
-    c.records += 1;
-    c.costUSD += _cost(r);
-    c.inputTokens += Number(r.inputTokens || 0);
-    c.outputTokens += Number(r.outputTokens || 0);
-
-    // byModel
-    const m = r.model || 'unknown';
-    if (!agg.byModel[m]) agg.byModel[m] = { model: m, records: 0, costUSD: 0, inputTokens: 0, cacheReadTokens: 0, cacheHitRate: 0 };
-    const mm = agg.byModel[m];
-    mm.records += 1;
-    mm.costUSD += _cost(r);
-    mm.inputTokens += Number(r.inputTokens || 0);
-    mm.cacheReadTokens += Number(r.cacheReadInputTokens || 0);
-  }
-
-  // Top 10 spawns by cost desc
-  agg.topSpawns = rawRecords
-    .slice()
-    .sort((a, b) => _cost(b) - _cost(a))
-    .slice(0, 10)
-    .map((r) => ({
-      startedAt: r.startedAt,
-      command: r.command,
-      step: r.step,
-      model: r.model,
-      costUSD: _cost(r),
-      inputTokens: r.inputTokens || 0,
-      outputTokens: r.outputTokens || 0,
-    }));
-
-  // Cache-hit rate per model
-  for (const key of Object.keys(agg.byModel)) {
-    const mm = agg.byModel[key];
-    const denom = mm.inputTokens + mm.cacheReadTokens;
-    mm.cacheHitRate = denom > 0 ? mm.cacheReadTokens / denom : 0;
-  }
-
-  // Rolling 7-day window by calendar day
-  const now = Date.now();
-  const sevenDaysMs = 7 * 24 * 60 * 60 * 1000;
-  const cutoffMs = now - sevenDaysMs;
-  let rollingCost = 0;
-  const rollingDays = new Set();
-  for (const r of rawRecords) {
-    const ts = Date.parse(String(r.startedAt).replace(' ', 'T') + (r.startedAt && r.startedAt.length === 16 ? ':00Z' : ''));
-    if (Number.isFinite(ts) && ts >= cutoffMs) {
-      rollingCost += _cost(r);
-      rollingDays.add(_day(r.startedAt));
-    }
-  }
-  agg.rolling7d.days = rollingDays.size;
-  agg.rolling7d.totalCostUSD = rollingCost;
-  agg.rolling7d.dailyAvgUSD = rollingCost / 7;
-  agg.rolling7d.monthlyProjectionUSD = agg.rolling7d.dailyAvgUSD * 30;
-
-  return agg;
-}
-
-function _fmtMoney(n) {
-  if (n == null || !Number.isFinite(n)) return '-';
-  return `$${n.toFixed(2)}`;
-}
-function _fmtPct(n) {
-  if (!Number.isFinite(n)) return '-';
-  return `${(n * 100).toFixed(1)}%`;
-}
-function _fmtInt(n) {
-  return String(Number(n || 0).toLocaleString('en-US'));
-}
-
-function renderTable(agg) {
-  const lines = [];
-  lines.push('═══ Token Dashboard ═══');
-  lines.push(`Records: ${_fmtInt(agg.totalRecords)} | Total cost: ${_fmtMoney(agg.totalCostUSD)} | Input: ${_fmtInt(agg.totalInputTokens)} | Output: ${_fmtInt(agg.totalOutputTokens)}`);
-  if (agg.currentMilestone) lines.push(`Milestone filter: ${agg.currentMilestone}`);
-  lines.push('');
-
-  lines.push('── By Day ──');
-  const days = Object.values(agg.byDay).sort((a, b) => a.day.localeCompare(b.day));
-  if (days.length === 0) lines.push('  (no data)');
-  for (const d of days) {
-    lines.push(`  ${d.day}  ${String(d.records).padStart(4)} spawns   ${_fmtMoney(d.costUSD).padStart(8)}   in=${_fmtInt(d.inputTokens)}  out=${_fmtInt(d.outputTokens)}`);
-  }
-  lines.push('');
-
-  lines.push('── By Command ──');
-  const cmds = Object.values(agg.byCommand).sort((a, b) => b.costUSD - a.costUSD);
-  if (cmds.length === 0) lines.push('  (no data)');
-  for (const c of cmds) {
-    lines.push(`  ${c.command.padEnd(30)} ${String(c.records).padStart(4)}   ${_fmtMoney(c.costUSD).padStart(8)}`);
-  }
-  lines.push('');
-
-  lines.push('── By Model ──');
-  const models = Object.values(agg.byModel).sort((a, b) => b.costUSD - a.costUSD);
-  if (models.length === 0) lines.push('  (no data)');
-  for (const m of models) {
-    lines.push(`  ${m.model.padEnd(20)} ${String(m.records).padStart(4)}   ${_fmtMoney(m.costUSD).padStart(8)}   cache-hit: ${_fmtPct(m.cacheHitRate)}`);
-  }
-  lines.push('');
-
-  lines.push('── Top 10 Spawns by Cost ──');
-  if (agg.topSpawns.length === 0) lines.push('  (no data)');
-  for (let i = 0; i < agg.topSpawns.length; i++) {
-    const s = agg.topSpawns[i];
-    lines.push(`  ${String(i + 1).padStart(2)}. ${s.startedAt}  ${String(s.command || '').padEnd(22)} ${String(s.step || '').padEnd(14)} ${_fmtMoney(s.costUSD)}`);
-  }
-  lines.push('');
-
-  lines.push('── Rolling 7-Day Projection ──');
-  lines.push(`  7-day cost: ${_fmtMoney(agg.rolling7d.totalCostUSD)} across ${agg.rolling7d.days} day(s)`);
-  lines.push(`  Daily avg:  ${_fmtMoney(agg.rolling7d.dailyAvgUSD)}`);
-  lines.push(`  Monthly projection (× 30): ${_fmtMoney(agg.rolling7d.monthlyProjectionUSD)}`);
-
-  return lines.join('\n');
-}
-
-function renderJson(agg) {
-  return JSON.stringify(agg, null, 2);
-}
-
-/**
- * Renders exactly 2 content lines + 1 separator = 3 output lines total.
- */
-function renderStatusBlock(agg) {
-  const sep = '───';
-  if (!agg || agg.totalRecords === 0) {
-    return sep + '\nTokens: no data yet (run a command to populate)\n(run `gsd-t tokens` for full dashboard)';
-  }
-  const line1 = `Tokens: ${_fmtInt(agg.totalRecords)} spawns, ${_fmtMoney(agg.totalCostUSD)} total${agg.currentMilestone ? ` (${agg.currentMilestone})` : ''}`;
-  const line2 = `Rolling 7d: ${_fmtMoney(agg.rolling7d.totalCostUSD)} (${_fmtMoney(agg.rolling7d.dailyAvgUSD)}/day → ${_fmtMoney(agg.rolling7d.monthlyProjectionUSD)}/mo proj.)`;
-  return `${sep}\n${line1}\n${line2}`;
-}
-
-/**
- * Synchronous variant of aggregate() — for callers that need a blocking read
- * (e.g. the `gsd-t status` tail where we can't await). Uses fs.readFileSync
- * and shares the same record-processing loop. Safe for typical JSONL sizes
- * (<100k lines); prefer aggregate() for large files or background work.
- */
-function aggregateSync(opts) {
-  const projectDir = opts.projectDir || '.';
-  const jsonlPath = opts.jsonlPath || DEFAULT_JSONL_PATH(projectDir);
-  const sinceDay = opts.since || null;
-  const milestone = opts.milestone || null;
-
-  const agg = {
-    totalRecords: 0,
-    totalCostUSD: 0,
-    totalInputTokens: 0,
-    totalOutputTokens: 0,
-    totalCacheReadTokens: 0,
-    totalCacheCreateTokens: 0,
-    byDay: {},
-    byCommand: {},
-    byModel: {},
-    topSpawns: [],
-    rolling7d: { days: 0, totalCostUSD: 0, dailyAvgUSD: 0, monthlyProjectionUSD: 0 },
-    currentMilestone: milestone,
-    source: jsonlPath,
-  };
-
-  if (!fs.existsSync(jsonlPath)) return agg;
-
-  const raw = fs.readFileSync(jsonlPath, 'utf8');
-  const lines = raw.split('\n');
-  const rawRecords = [];
-
-  for (const line of lines) {
-    const trimmed = line && line.trim();
-    if (!trimmed) continue;
-    const r = _safeParse(trimmed);
-    if (!r || typeof r !== 'object') continue;
-
-    const day = _day(r.startedAt);
-    if (sinceDay && day < sinceDay) continue;
-    if (milestone && r.milestone && r.milestone !== milestone) continue;
-    if (milestone && !r.milestone) continue;
-
-    rawRecords.push(r);
-    agg.totalRecords += 1;
-    agg.totalCostUSD += _cost(r);
-    agg.totalInputTokens += Number(r.inputTokens || 0);
-    agg.totalOutputTokens += Number(r.outputTokens || 0);
-    agg.totalCacheReadTokens += Number(r.cacheReadInputTokens || 0);
-    agg.totalCacheCreateTokens += Number(r.cacheCreationInputTokens || 0);
-  }
-
-  const now = Date.now();
-  const cutoffMs = now - 7 * 24 * 60 * 60 * 1000;
-  let rollingCost = 0;
-  const rollingDays = new Set();
-  for (const r of rawRecords) {
-    const ts = Date.parse(String(r.startedAt).replace(' ', 'T') + (r.startedAt && r.startedAt.length === 16 ? ':00Z' : ''));
-    if (Number.isFinite(ts) && ts >= cutoffMs) {
-      rollingCost += _cost(r);
-      rollingDays.add(_day(r.startedAt));
-    }
-  }
-  agg.rolling7d.days = rollingDays.size;
-  agg.rolling7d.totalCostUSD = rollingCost;
-  agg.rolling7d.dailyAvgUSD = rollingCost / 7;
-  agg.rolling7d.monthlyProjectionUSD = agg.rolling7d.dailyAvgUSD * 30;
-
-  return agg;
-}
-
-/**
- * Render a "Top 10 tools by cost" section by invoking the D2 attribution
- * library and its CLI renderer. Used by `gsd-t tokens --show-tool-costs`.
- *
- * @param {object} opts
- * @param {string} opts.projectDir
- * @param {string} [opts.since]
- * @param {string} [opts.milestone]
- * @param {'table'|'json'} [opts.format]
- * @returns {string} rendered section (multi-line string)
- */
-function renderToolCostsSection(opts) {
-  const projectDir = opts.projectDir || '.';
-  const toolCost = require('./gsd-t-tool-cost.cjs');
-  const attribution = require('./gsd-t-tool-attribution.cjs');
-  const turnsPath = path.join(projectDir, '.gsd-t', 'metrics', 'token-usage.jsonl');
-  const eventsGlob = path.join(projectDir, '.gsd-t', 'events');
-  if (!fs.existsSync(turnsPath)) {
-    return '── Top 10 tools by cost ──\n  (no data)';
-  }
-  const joined = attribution.joinTurnsAndEvents({
-    turnsPath,
-    eventsGlob,
-    since: opts.since || undefined,
-    milestone: opts.milestone || undefined,
-  });
-  const agg = attribution.aggregateByTool(joined).slice(0, 10);
-  if (opts.format === 'json') {
-    return '\n── Top 10 tools by cost (JSON) ──\n' + agg.map((r) => JSON.stringify(r)).join('\n');
-  }
-  return '\n── Top 10 tools by cost ──\n' +
-    toolCost.renderTable(agg, { groupBy: 'tool', since: opts.since, milestone: opts.milestone });
-}
-
-module.exports = {
-  aggregate,
-  aggregateSync,
-  renderTable,
-  renderJson,
-  renderStatusBlock,
-  renderToolCostsSection,
-  _safeParse,
-  _day,
-};