crg-dev-kit 1.0.0

package/bin/cli.js

@@ -0,0 +1,250 @@
+#!/usr/bin/env node
+const { spawn, execFile } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+const os = require('os');
+
+const pkg = require('../package.json');
+const ASSETS = path.join(__dirname, '..', 'assets');
+const args = process.argv.slice(2);
+const cmd = args[0];
+const roi = require('../lib/roi');
+
+const NO_ROI = args.includes('--no-roi');
+
+function printHelp() {
+  console.log(`
+  \x1b[36mCRG Dev Kit\x1b[0m — One-click code-review-graph setup
+
+  \x1b[1mUsage:\x1b[0m
+    npx crg-dev-kit [command] [options]
+
+  \x1b[1mCommands:\x1b[0m
+    install, setup    Copy setup scripts to current project
+    start, serve      Launch the dashboard (default)
+    uninstall         Remove CRG files from current project
+    status            Check if CRG is installed in current project
+    roi               Show ROI report (token savings)
+    tutorial          Launch interactive tutorial
+    help              Show this help message
+    version           Show version
+
+  \x1b[1mOptions:\x1b[0m
+    --port <number>   Dashboard port (default: 8742)
+    --no-open         Don't auto-open browser
+    --communities     Include community detection flag
+    --no-roi          Skip ROI tracking (installs without analytics)
+
+  \x1b[1mExamples:\x1b[0m
+    npx crg-dev-kit                    # Open dashboard
+    npx crg-dev-kit install            # Copy scripts to project
+    npx crg-dev-kit start --port 9000  # Custom port
+    npx crg-dev-kit status             # Check installation
+`);
+}
+
+function printVersion() {
+  console.log(`crg-dev-kit v${pkg.version}`);
+}
+
+function copyFiles() {
+  const cwd = process.cwd();
+  const files = [
+    { name: 'setup-crg.sh', executable: true },
+    { name: 'setup-crg.ps1', executable: false },
+    { name: 'check-crg.sh', executable: true },
+    { name: 'CLAUDE.md', executable: false },
+    { name: 'crg-cheatsheet.pdf', executable: false },
+    { name: 'README.md', executable: false },
+  ];
+
+  let copied = 0;
+  files.forEach(f => {
+    const src = path.join(ASSETS, f.name);
+    const dst = path.join(cwd, f.name);
+    if (fs.existsSync(src)) {
+      if (fs.existsSync(dst)) {
+        console.log(`  \x1b[33m~\x1b[0m ${f.name} \x1b[2m(already exists, skipping)\x1b[0m`);
+        return;
+      }
+      fs.copyFileSync(src, dst);
+      if (f.executable) {
+        try { fs.chmodSync(dst, '755'); } catch {}
+      }
+      console.log(`  \x1b[32m✓\x1b[0m ${f.name}`);
+      copied++;
+    }
+  });
+
+  // Track install date (only if --no-roi not set)
+  if (!NO_ROI) {
+    roi.setInstallDate(cwd);
+    console.log('\n  \x1b[36m✓ Install date recorded for ROI tracking\x1b[0m');
+  }
+
+  if (copied === 0) {
+    console.log('\n  \x1b[33mFiles already exist, install date updated.\x1b[0m');
+    return;
+  }
+
+  const isWin = process.platform === 'win32';
+  console.log(`\n  \x1b[32m${copied} file(s) copied to ${cwd}\x1b[0m\n`);
+  console.log('  \x1b[1mNext steps:\x1b[0m');
+  if (isWin) {
+    console.log('    .\\setup-crg.ps1 -WithCommunities');
+    console.log('    code-review-graph status');
+  } else {
+    console.log('    bash setup-crg.sh --with-communities');
+    console.log('    bash check-crg.sh');
+  }
+  console.log('');
+}
+
+function checkStatus() {
+  const cwd = process.cwd();
+  const checks = [
+    { file: 'setup-crg.sh', label: 'Linux/macOS setup script' },
+    { file: 'setup-crg.ps1', label: 'Windows setup script' },
+    { file: 'check-crg.sh', label: 'Health check script' },
+    { file: 'CLAUDE.md', label: 'AI configuration' },
+  ];
+
+  console.log('\n  \x1b[36mCRG Installation Status\x1b[0m\n');
+  let found = 0;
+  checks.forEach(c => {
+    const exists = fs.existsSync(path.join(cwd, c.file));
+    if (exists) found++;
+    console.log(`  ${exists ? '\x1b[32m✓\x1b[0m' : '\x1b[31m✗\x1b[0m'} ${c.label}`);
+  });
+
+  // Check if code-review-graph is installed
+  const checkCRG = () => {
+    return new Promise(resolve => {
+      execFile('code-review-graph', ['--version'], (err) => {
+        resolve(!err);
+      });
+    });
+  };
+
+  checkCRG().then(installed => {
+    console.log(`  ${installed ? '\x1b[32m✓\x1b[0m' : '\x1b[31m✗\x1b[0m'} code-review-graph CLI`);
+    const total = checks.length + 1;
+    const score = found + (installed ? 1 : 0);
+    console.log(`\n  ${score}/${total} components present`);
+    if (score === total) {
+      console.log('  \x1b[32m✓ Fully set up!\x1b[0m\n');
+    } else if (score >= 3) {
+      console.log('  \x1b[33m~ Partially set up. Run install command.\x1b[0m\n');
+    } else {
+      console.log('  \x1b[31m✗ Not set up. Run: npx crg-dev-kit install\x1b[0m\n');
+    }
+  });
+}
+
+function uninstallFiles() {
+  const cwd = process.cwd();
+  const files = ['setup-crg.sh', 'setup-crg.ps1', 'check-crg.sh', 'CLAUDE.md', 'crg-cheatsheet.pdf', 'README.md'];
+  let removed = 0;
+
+  files.forEach(f => {
+    const dst = path.join(cwd, f);
+    if (fs.existsSync(dst)) {
+      fs.unlinkSync(dst);
+      console.log(`  \x1b[31m✗\x1b[0m ${f}`);
+      removed++;
+    }
+  });
+
+  if (removed === 0) {
+    console.log('\n  \x1b[33mNo CRG files found to remove.\x1b[0m\n');
+  } else {
+    console.log(`\n  \x1b[31m${removed} file(s) removed from ${cwd}\x1b[0m\n`);
+  }
+}
+
+function startServer() {
+  let port = 8742;
+  let noOpen = false;
+
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === '--port' && args[i + 1]) {
+      port = parseInt(args[i + 1], 10);
+      if (isNaN(port) || port < 1024 || port > 65535) {
+        console.error('\x1b[31mError: Port must be between 1024 and 65535\x1b[0m');
+        process.exit(1);
+      }
+      i++;
+    }
+    if (args[i] === '--no-open') noOpen = true;
+  }
+
+  const serverPath = path.join(__dirname, '..', 'server.js');
+  const server = require(serverPath);
+  server.start(port, noOpen);
+}
+
+function showROI() {
+  const cwd = process.cwd();
+  const report = roi.generateROIReport(cwd);
+  console.log('\n' + report);
+}
+
+function runTutorial() {
+  const tutorialPath = path.join(__dirname, 'tutorial.js');
+  const tutorial = require(tutorialPath);
+}
+
+// Command routing
+switch (cmd) {
+  case 'install':
+  case 'setup':
+    copyFiles();
+    break;
+
+  case 'uninstall':
+  case 'remove':
+    uninstallFiles();
+    break;
+
+  case 'status':
+  case 'check':
+    checkStatus();
+    break;
+
+  case 'start':
+  case 'serve':
+  case 'dashboard':
+    startServer();
+    break;
+
+  case 'help':
+  case '--help':
+  case '-h':
+    printHelp();
+    break;
+
+  case 'version':
+  case '--version':
+  case '-v':
+    printVersion();
+    break;
+
+  case 'roi':
+    showROI();
+    break;
+
+  case 'tutorial':
+    runTutorial();
+    break;
+
+  default:
+    // No command or unknown command = start server
+    if (!cmd || cmd.startsWith('-')) {
+      startServer();
+    } else {
+      console.log(`\x1b[31mUnknown command: ${cmd}\x1b[0m`);
+      console.log('Run \x1b[1mnpx crg-dev-kit help\x1b[0m for usage.\n');
+      process.exit(1);
+    }
+    break;
+}

package/bin/tutorial.js

@@ -0,0 +1,198 @@
+#!/usr/bin/env node
+const readline = require('readline');
+
+const colors = {
+  reset: '\x1b[0m',
+  bright: '\x1b[1m',
+  dim: '\x1b[2m',
+  cyan: '\x1b[36m',
+  yellow: '\x1b[33m',
+  green: '\x1b[32m',
+  red: '\x1b[31m',
+  gray: '\x1b[90m'
+};
+
+function c(color, text) {
+  return colors[color] + text + colors.reset;
+}
+
+const rl = readline.createInterface({
+  input: process.stdin,
+  output: process.stdout
+});
+
+const menu = `
+${c('cyan','╔════════════════════════════════════════════════════════════╗')}
+${c('cyan','║')}  ${c('bright','🎯 CODE SCOPE INTERACTIVE TUTORIAL')}                  ${c('cyan','║')}
+${c('cyan','╚════════════════════════════════════════════════════════════╝')}
+
+  ${c('cyan','1.')} What is Code Scope?
+  ${c('cyan','2.')} See how it works (before/after)
+  ${c('cyan','3.')} Try a demo query
+  ${c('cyan','4.')} Your project stats
+  ${c('cyan','5.')} FAQ
+  ${c('cyan','6.')} Exit
+
+`;
+
+const whatIsCodeScope = `
+${c('yellow','🔍 WHAT IS CODE SCOPE?')}
+
+Code Scope gives your AI coding assistant (Claude Code, Cursor, etc.)
+a ${c('bright','knowledge graph')} of your codebase.
+
+Instead of reading every file, Claude can query:
+  • Who calls this function?
+  • What tests cover this file?
+  • What's affected by this change?
+
+Think of it like a ${c('bright','GPS for your code')} — instead of
+reading every road sign, you ask "how do I get there?"
+
+${c('gray','─'.repeat(60))}
+${c('gray','Press Enter to go back...')}
+`;
+
+const beforeAfter = `
+${c('yellow','⚡ BEFORE VS AFTER')}
+
+${c('red','BEFORE:')}
+  You ask: "Who calls auth_user()?"
+  Claude: Reads 542 JavaScript files...
+  Tokens: ~50,000
+  Time: 30 seconds
+  
+${c('green','AFTER:')}
+  You ask: "Who calls auth_user()?"
+  Claude: Queries knowledge graph
+  Tokens: ~400 (structured JSON)
+  Time: 1 second
+
+${c('bright','Result: ~100x fewer tokens, 30x faster')}
+
+${c('gray','─'.repeat(60))}
+${c('gray','Press Enter to go back...')}
+`;
+
+const demoQuery = `
+${c('yellow','🎮 DEMO: TRY A QUERY')}
+
+In your project, Claude can answer questions like:
+
+${c('cyan','▸ "Find callers of login()"')}
+  → Shows all functions that call login()
+  
+${c('cyan','▸ "Find tests for auth.ts"')}
+  → Shows test files for auth module
+  
+${c('cyan','▸ "Use detect_changes"')}
+  → Risk-scoped code review
+  
+${c('cyan','▸ "Show me architecture"')}
+  → Get community structure
+
+${c('gray','After restarting Claude Code, try one of these!')}
+${c('gray','─'.repeat(60))}
+${c('gray','Press Enter to go back...')}
+`;
+
+const projectStats = () => {
+  const { execSync } = require('child_process');
+  try {
+    const stats = execSync('code-review-graph status 2>/dev/null', { encoding: 'utf8' });
+    return `${c('yellow','📊 YOUR PROJECT STATS')}
+
+${stats}
+${c('gray','─'.repeat(60))}
+${c('gray','Press Enter to go back...')}`;
+  } catch {
+    return `${c('yellow','📊 YOUR PROJECT STATS')}
+
+Run ${c('cyan','code-review-graph status')} in your project first!
+
+${c('gray','─'.repeat(60))}
+${c('gray','Press Enter to go back...')}`;
+  }
+};
+
+const faq = `
+${c('yellow','❓ FAQ')}
+
+${c('cyan','Q: Does this slow down my workflow?')}
+A: No. Graph builds once, updates incrementally.
+
+${c('cyan','Q: Does it read my code?')}
+A: Only once to build. After that, queries the graph.
+
+${c('cyan','Q: Is my data safe?')}
+A: 100% local. No cloud. No telemetry.
+
+${c('cyan','Q: What if I don\'t want ROI tracking?')}
+A: Use ${c('cyan','--no-roi')} flag: 
+   npx crg-dev-kit install --no-roi
+
+${c('gray','─'.repeat(60))}
+${c('gray','Press Enter to go back...')}
+`;
+
+function showScreen(screenName) {
+  console.clear();
+  
+  if (screenName === 'main') {
+    console.log(menu);
+    rl.question(c('gray','Choose: '), (answer) => {
+      handleChoice(answer.trim());
+    });
+  } else if (screenName === 'stats') {
+    console.log(projectStats());
+    rl.question('', () => {
+      showScreen('main');
+    });
+  } else {
+    const screens = {
+      '1': whatIsCodeScope,
+      '2': beforeAfter,
+      '3': demoQuery,
+      '4': 'stats',
+      '5': faq
+    };
+    const content = screens[screenName];
+    if (content === 'stats') {
+      showScreen('stats');
+    } else {
+      console.log(content);
+      rl.question('', () => {
+        showScreen('main');
+      });
+    }
+  }
+}
+
+function handleChoice(choice) {
+  if (choice === '6' || choice === 'exit' || choice === 'q') {
+    console.clear();
+    console.log(c('green','\n🎉 Thanks for trying Code Scope!'));
+    console.log(c('gray','  Run ') + c('cyan','npx crg-dev-kit') + c('gray',' anytime for dashboard'));
+    console.log(c('gray','  Run ') + c('cyan','npx crg-dev-kit roi') + c('gray',' for ROI report\n'));
+    rl.close();
+    process.exit(0);
+  }
+  
+  const validChoices = ['1', '2', '3', '4', '5'];
+  if (validChoices.includes(choice)) {
+    showScreen(choice);
+  } else {
+    console.log(c('red','Invalid choice. Try 1-6.'));
+    showScreen('main');
+  }
+}
+
+console.clear();
+console.log(`
+${c('cyan','╔════════════════════════════════════════════════════════════╗')}
+${c('cyan','║')}  ${c('bright','🎯 Welcome to Code Scope Interactive Tutorial!')}        ${c('cyan','║')}
+${c('cyan','║')}                                                            ${c('cyan','║')}
+${c('cyan','║')}  Learn how to use the knowledge graph in 2 minutes     ${c('cyan','║')}
+${c('cyan','╚════════════════════════════════════════════════════════════╝')}
+`);
+setTimeout(() => showScreen('main'), 500);

package/lib/analytics.js

@@ -0,0 +1,250 @@
+const fs = require('fs');
+const path = require('path');
+const crypto = require('crypto');
+
+const ANALYTICS_DIR = path.join(process.env.HOME || process.env.USERPROFILE, '.crg-analytics');
+const SESSIONS_FILE = path.join(ANALYTICS_DIR, 'sessions.json');
+const TOKEN_BASELINES = path.join(ANALYTICS_DIR, 'baselines.json');
+
+const TOKEN_ESTIMATES = {
+  read_file_per_100_lines: 75,
+  get_review_context: 400,
+  detect_changes: 300,
+  query_graph: 200,
+  semantic_search: 250,
+  get_impact_radius: 350,
+  get_architecture_overview: 600,
+  list_graph_stats: 100,
+  get_flow: 450,
+  list_flows: 300,
+  get_community: 350,
+  list_communities: 200,
+  refactor_tool: 500,
+  get_review_context_tool: 400,
+};
+
+function ensureDir() {
+  if (!fs.existsSync(ANALYTICS_DIR)) {
+    fs.mkdirSync(ANALYTICS_DIR, { recursive: true });
+  }
+}
+
+function readJSON(file, fallback) {
+  try {
+    return JSON.parse(fs.readFileSync(file, 'utf8'));
+  } catch {
+    return fallback;
+  }
+}
+
+function writeJSON(file, data) {
+  ensureDir();
+  fs.writeFileSync(file, JSON.stringify(data, null, 2));
+}
+
+function estimateTokensWithoutCRG(fileCount, avgLinesPerFile, operation = 'review') {
+  const totalLines = fileCount * avgLinesPerFile;
+  const naiveTokens = Math.ceil(totalLines / 100) * TOKEN_ESTIMATES.read_file_per_100_lines;
+  const contextTokens = naiveTokens * 1.2;
+  return Math.ceil(contextTokens);
+}
+
+function estimateTokensWithCRG(toolsUsed) {
+  let total = 0;
+  toolsUsed.forEach(tool => {
+    const toolName = tool.name || tool;
+    const count = tool.count || 1;
+    total += (TOKEN_ESTIMATES[toolName] || 300) * count;
+  });
+  return total;
+}
+
+function createSession(projectPath, operation) {
+  ensureDir();
+  const sessions = readJSON(SESSIONS_FILE, []);
+  const session = {
+    id: crypto.randomUUID(),
+    project: projectPath,
+    operation: operation || 'code_review',
+    startTime: new Date().toISOString(),
+    toolsUsed: [],
+    filesReviewed: 0,
+    avgLinesPerFile: 0,
+    tokensWithoutCRG: 0,
+    tokensWithCRG: 0,
+    savings: 0,
+    status: 'active'
+  };
+  sessions.push(session);
+  writeJSON(SESSIONS_FILE, sessions);
+  return session;
+}
+
+function logToolUsage(sessionId, toolName, count = 1) {
+  const sessions = readJSON(SESSIONS_FILE, []);
+  const session = sessions.find(s => s.id === sessionId);
+  if (!session) return null;
+
+  const existing = session.toolsUsed.find(t => t.name === toolName);
+  if (existing) {
+    existing.count += count;
+  } else {
+    session.toolsUsed.push({ name: toolName, count });
+  }
+
+  session.tokensWithCRG = estimateTokensWithCRG(session.toolsUsed);
+  session.tokensWithoutCRG = estimateTokensWithoutCRG(
+    session.filesReviewed || 5,
+    session.avgLinesPerFile || 100,
+    session.operation
+  );
+  session.savings = session.tokensWithoutCRG > 0
+    ? Math.round((1 - session.tokensWithCRG / session.tokensWithoutCRG) * 100)
+    : 0;
+
+  writeJSON(SESSIONS_FILE, sessions);
+  return session;
+}
+
+function endSession(sessionId, filesReviewed, avgLinesPerFile) {
+  const sessions = readJSON(SESSIONS_FILE, []);
+  const session = sessions.find(s => s.id === sessionId);
+  if (!session) return null;
+
+  session.filesReviewed = filesReviewed;
+  session.avgLinesPerFile = avgLinesPerFile;
+  session.tokensWithoutCRG = estimateTokensWithoutCRG(filesReviewed, avgLinesPerFile, session.operation);
+  session.tokensWithCRG = estimateTokensWithCRG(session.toolsUsed);
+  session.savings = session.tokensWithoutCRG > 0
+    ? Math.round((1 - session.tokensWithCRG / session.tokensWithoutCRG) * 100)
+    : 0;
+  session.endTime = new Date().toISOString();
+  session.status = 'completed';
+
+  writeJSON(SESSIONS_FILE, sessions);
+  return session;
+}
+
+function getProjectStats(projectPath) {
+  const sessions = readJSON(SESSIONS_FILE, []);
+  const projectSessions = sessions.filter(s =>
+    s.project === projectPath && s.status === 'completed'
+  );
+
+  if (projectSessions.length === 0) return null;
+
+  const totalTokensWithoutCRG = projectSessions.reduce((sum, s) => sum + (s.tokensWithoutCRG || 0), 0);
+  const totalTokensWithCRG = projectSessions.reduce((sum, s) => sum + (s.tokensWithCRG || 0), 0);
+  const avgSavings = projectSessions.reduce((sum, s) => sum + (s.savings || 0), 0) / projectSessions.length;
+  const totalSessions = projectSessions.length;
+  const totalFilesReviewed = projectSessions.reduce((sum, s) => sum + (s.filesReviewed || 0), 0);
+
+  const toolUsage = {};
+  projectSessions.forEach(s => {
+    s.toolsUsed.forEach(t => {
+      toolUsage[t.name] = (toolUsage[t.name] || 0) + t.count;
+    });
+  });
+
+  return {
+    project: projectPath,
+    totalSessions,
+    totalFilesReviewed,
+    totalTokensWithoutCRG,
+    totalTokensWithCRG,
+    totalTokensSaved: totalTokensWithoutCRG - totalTokensWithCRG,
+    avgSavingsPercent: Math.round(avgSavings),
+    estimatedCostSavings: Math.round((totalTokensWithoutCRG - totalTokensWithCRG) / 1000 * 0.01 * 100) / 100,
+    toolUsage,
+    lastSession: projectSessions[projectSessions.length - 1].endTime,
+    sessions: projectSessions.slice(-10)
+  };
+}
+
+function getAllStats() {
+  const sessions = readJSON(SESSIONS_FILE, []);
+  const completedSessions = sessions.filter(s => s.status === 'completed');
+
+  if (completedSessions.length === 0) return null;
+
+  const projectPaths = [...new Set(completedSessions.map(s => s.project))];
+  const projectStats = projectPaths.map(p => getProjectStats(p));
+
+  const totalTokensWithoutCRG = projectStats.reduce((sum, p) => sum + p.totalTokensWithoutCRG, 0);
+  const totalTokensWithCRG = projectStats.reduce((sum, p) => sum + p.totalTokensWithCRG, 0);
+  const avgSavings = projectStats.reduce((sum, p) => sum + p.avgSavingsPercent, 0) / projectStats.length;
+
+  return {
+    totalProjects: projectPaths.length,
+    totalSessions: completedSessions.length,
+    totalTokensWithoutCRG,
+    totalTokensWithCRG,
+    totalTokensSaved: totalTokensWithoutCRG - totalTokensWithCRG,
+    avgSavingsPercent: Math.round(avgSavings),
+    estimatedCostSavings: Math.round((totalTokensWithoutCRG - totalTokensWithCRG) / 1000 * 0.01 * 100) / 100,
+    projects: projectStats
+  };
+}
+
+function generateReport(projectPath) {
+  const stats = projectPath ? getProjectStats(projectPath) : getAllStats();
+  if (!stats) return 'No analytics data found. Run code reviews with CRG to start tracking.';
+
+  let report = `# CRG Token Analytics Report\n\n`;
+  report += `Generated: ${new Date().toISOString()}\n\n`;
+
+  if (stats.totalProjects) {
+    report += `## Overview\n\n`;
+    report += `| Metric | Value |\n|--------|-------|\n`;
+    report += `| Projects Tracked | ${stats.totalProjects} |\n`;
+    report += `| Total Sessions | ${stats.totalSessions} |\n`;
+    report += `| Avg Token Savings | ${stats.avgSavingsPercent}% |\n`;
+    report += `| Total Tokens Saved | ${stats.totalTokensSaved.toLocaleString()} |\n`;
+    report += `| Est. Cost Savings | $${stats.estimatedCostSavings} |\n\n`;
+
+    report += `## Projects\n\n`;
+    stats.projects.forEach(p => {
+      report += `### ${p.project}\n\n`;
+      report += `| Metric | Value |\n|--------|-------|\n`;
+      report += `| Sessions | ${p.totalSessions} |\n`;
+      report += `| Files Reviewed | ${p.totalFilesReviewed} |\n`;
+      report += `| Token Savings | ${p.avgSavingsPercent}% |\n`;
+      report += `| Tokens Saved | ${p.totalTokensSaved.toLocaleString()} |\n\n`;
+    });
+  } else {
+    report += `## Session Summary\n\n`;
+    report += `| Metric | Value |\n|--------|-------|\n`;
+    report += `| Sessions | ${stats.totalSessions} |\n`;
+    report += `| Files Reviewed | ${stats.totalFilesReviewed} |\n`;
+    report += `| Token Savings | ${stats.avgSavingsPercent}% |\n`;
+    report += `| Tokens Without CRG | ${stats.totalTokensWithoutCRG.toLocaleString()} |\n`;
+    report += `| Tokens With CRG | ${stats.totalTokensWithCRG.toLocaleString()} |\n`;
+    report += `| Tokens Saved | ${stats.totalTokensSaved.toLocaleString()} |\n`;
+    report += `| Est. Cost Savings | $${stats.estimatedCostSavings} |\n\n`;
+
+    if (Object.keys(stats.toolUsage).length > 0) {
+      report += `## Tool Usage\n\n`;
+      report += `| Tool | Times Used |\n|------|------------|\n`;
+      Object.entries(stats.toolUsage)
+        .sort((a, b) => b[1] - a[1])
+        .forEach(([tool, count]) => {
+          report += `| ${tool} | ${count} |\n`;
+        });
+      report += '\n';
+    }
+  }
+
+  return report;
+}
+
+module.exports = {
+  createSession,
+  logToolUsage,
+  endSession,
+  getProjectStats,
+  getAllStats,
+  generateReport,
+  estimateTokensWithoutCRG,
+  estimateTokensWithCRG,
+  TOKEN_ESTIMATES
+};