claude-roi 0.2.3 → 0.3.0

package/src/index.js

@@ -15,42 +15,20 @@ const { version: VERSION } = JSON.parse(
   readFileSync(new URL('../package.json', import.meta.url), 'utf8')
 );
 
-async function main() {
-  const program = new Command();
-  program
-    .name('claude-roi')
-    .description('Correlate Claude Code token usage with git output to measure AI coding agent ROI')
-    .version(VERSION)
-    .option('-p, --port <number>', 'port to serve dashboard', '3457')
-    .option('-d, --days <number>', 'number of days to look back', '30')
-    .option('--no-open', 'do not auto-open browser')
-    .option('--json', 'output raw JSON to stdout instead of starting server')
-    .option('--project <name>', 'filter to specific project')
-    .option('--refresh', 'force full re-parse, ignore cache');
-
-  program.parse();
-  const opts = program.opts();
-  const port = parseInt(opts.port, 10);
-  const days = parseInt(opts.days, 10);
-
-  console.log(`\x1b[36mclaude-roi\x1b[0m v${VERSION}`);
-
-  const claudeDir = path.join(os.homedir(), '.claude', 'projects');
-
+async function buildPayload(claudeDir, days, project, forceRefresh = false) {
   // Step 1: Parse sessions (with caching)
   let sessions;
   let fileIndex;
   const startParse = Date.now();
 
-  if (opts.refresh) {
+  if (forceRefresh) {
     deleteCache();
     console.log('Cache cleared, performing full parse...');
   }
 
-  const cached = opts.refresh ? null : loadCache();
+  const cached = forceRefresh ? null : loadCache();
 
   if (cached) {
-    // Incremental parse: only process new/modified files
     const stale = getStaleFiles(claudeDir, cached.fileIndex);
     const newCount = stale.newFiles.length;
     const modifiedCount = stale.modifiedFiles.length;
@@ -58,33 +36,24 @@ async function main() {
     const cachedCount = Object.keys(cached.fileIndex).length - modifiedCount - deletedCount;
 
     if (newCount === 0 && modifiedCount === 0 && deletedCount === 0) {
-      // Nothing changed, use cache as-is
       sessions = cached.sessions;
       fileIndex = cached.fileIndex;
       console.log(`Parsing sessions... ${cached.sessions.length} cached (${Date.now() - startParse}ms)`);
     } else {
-      // Parse only new/modified files
-      const { sessions: freshSessions, fileIndex: freshIndex } = await parseAllProjects(claudeDir, days, opts.project);
-
-      // For a simpler approach: just do a full re-parse when files change
-      // This avoids complex merging logic while still benefiting from caching
-      // when nothing has changed
+      const { sessions: freshSessions, fileIndex: freshIndex } = await parseAllProjects(claudeDir, days, project);
       sessions = freshSessions;
       fileIndex = freshIndex;
       console.log(`Parsing sessions... ${newCount} new, ${modifiedCount} updated, ${Math.max(0, cachedCount)} cached (${Date.now() - startParse}ms)`);
     }
   } else {
-    // Full parse
-    const result = await parseAllProjects(claudeDir, days, opts.project);
+    const result = await parseAllProjects(claudeDir, days, project);
     sessions = result.sessions;
     fileIndex = result.fileIndex;
     console.log(`Parsing sessions... ${sessions.length} parsed (${Date.now() - startParse}ms)`);
   }
 
   if (sessions.length === 0) {
-    console.log('\x1b[33mNo Claude Code sessions found.\x1b[0m');
-    console.log('Make sure you have used Claude Code and session files exist in ~/.claude/projects/');
-    process.exit(0);
+    return null;
   }
 
   // Step 2: Analyze git repos
@@ -107,14 +76,48 @@ async function main() {
   // Save cache for next run
   saveCache(sessions, fileIndex);
 
-  // Step 5: Output
+  return payload;
+}
+
+async function main() {
+  const program = new Command();
+  program
+    .name('claude-roi')
+    .description('Correlate Claude Code token usage with git output to measure AI coding agent ROI')
+    .version(VERSION)
+    .option('-p, --port <number>', 'port to serve dashboard', '3457')
+    .option('-d, --days <number>', 'number of days to look back', '30')
+    .option('--no-open', 'do not auto-open browser')
+    .option('--json', 'output raw JSON to stdout instead of starting server')
+    .option('--project <name>', 'filter to specific project')
+    .option('--refresh', 'force full re-parse, ignore cache');
+
+  program.parse();
+  const opts = program.opts();
+  const port = parseInt(opts.port, 10);
+  const days = parseInt(opts.days, 10);
+
+  console.log(`\x1b[36mclaude-roi\x1b[0m v${VERSION}`);
+
+  const claudeDir = path.join(os.homedir(), '.claude', 'projects');
+
+  const payload = await buildPayload(claudeDir, days, opts.project, opts.refresh);
+
+  if (!payload) {
+    console.log('\x1b[33mNo Claude Code sessions found.\x1b[0m');
+    console.log('Make sure you have used Claude Code and session files exist in ~/.claude/projects/');
+    process.exit(0);
+  }
+
+  // Output
   if (opts.json) {
     process.stdout.write(JSON.stringify(payload, null, 2));
     process.exit(0);
   }
 
-  // Start server
-  const app = createServer(payload);
+  // Start server — pass a rebuild function so /api/refresh can re-run the pipeline
+  const rebuild = () => buildPayload(claudeDir, days, opts.project, true);
+  const app = createServer(payload, rebuild);
   const server = app.listen(port, () => {
     const url = `http://localhost:${port}`;
     console.log(`\x1b[32mDashboard:\x1b[0m ${url}`);

package/src/metrics.js

@@ -9,6 +9,14 @@ function formatBigNumber(n) {
   return n.toString();
 }
 
+function formatDuration(minutes) {
+  if (minutes < 60) return `${minutes} minutes`;
+  const hrs = Math.floor(minutes / 60);
+  const mins = minutes % 60;
+  if (mins === 0) return `${hrs} hr${hrs > 1 ? 's' : ''}`;
+  return `${hrs} hr${hrs > 1 ? 's' : ''} ${mins} min`;
+}
+
 function sessionTokens(s) {
   return s.totalInputTokens + s.totalOutputTokens + s.cacheReadTokens + s.cacheCreationTokens;
 }
@@ -254,7 +262,7 @@ function generateInsights(summary, correlatedSessions, modelBreakdown, sessionBu
   if (avgDuration > 0) {
     insights.push({
       type: 'info',
-      text: `Average session duration: ${Math.round(avgDuration)} minutes.`,
+      text: `Average session duration: ${formatDuration(Math.round(avgDuration))}.`,
     });
   }
 
@@ -272,7 +280,7 @@ function generateInsights(summary, correlatedSessions, modelBreakdown, sessionBu
     const avgDelayMs = delays.reduce((s, d) => s + d, 0) / delays.length;
     const avgDelayHours = avgDelayMs / (1000 * 60 * 60);
     if (avgDelayHours < 1) {
-      insights.push({ type: 'success', text: `On average, commits happen ${Math.round(avgDelayHours * 60)} minutes after a session ends.` });
+      insights.push({ type: 'success', text: `On average, commits happen ${formatDuration(Math.round(avgDelayHours * 60))} after a session ends.` });
     } else {
       insights.push({ type: 'info', text: `On average, commits happen ${avgDelayHours.toFixed(1)} hours after a session ends.` });
     }

package/src/server.js

@@ -5,8 +5,9 @@ import path from 'node:path';
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 
-export function createServer(payload) {
+export function createServer(initialPayload, rebuildFn) {
   const app = express();
+  let payload = initialPayload;
 
   // Serve dashboard HTML
   const dashboardHtml = readFileSync(path.join(__dirname, 'dashboard.html'), 'utf-8');
@@ -20,6 +21,22 @@ export function createServer(payload) {
     res.json(payload);
   });
 
+  // Re-run the full pipeline: clear cache, re-parse sessions, re-analyze git, recompute metrics
+  app.post('/api/refresh', async (req, res) => {
+    if (!rebuildFn) return res.status(501).json({ error: 'Refresh not available' });
+    try {
+      console.log('\x1b[36m[refresh]\x1b[0m Re-parsing sessions and recomputing metrics...');
+      const newPayload = await rebuildFn();
+      if (!newPayload) return res.status(404).json({ error: 'No sessions found after refresh' });
+      payload = newPayload;
+      console.log('\x1b[32m[refresh]\x1b[0m Done');
+      res.json({ ok: true });
+    } catch (err) {
+      console.error('\x1b[31m[refresh]\x1b[0m Error:', err.message);
+      res.status(500).json({ error: err.message });
+    }
+  });
+
   // Hero stats + insights
   app.get('/api/summary', (req, res) => {
     res.json({