crg-dev-kit 1.0.0

package/lib/roi.js

@@ -0,0 +1,250 @@
+const fs = require('fs');
+const path = require('path');
+
+const ANALYTICS_DIR = path.join(process.env.HOME || process.env.USERPROFILE, '.crg-analytics');
+const HISTORY_FILE = path.join(process.env.HOME || process.env.USERPROFILE, '.claude', 'history.jsonl');
+
+function ensureDir() {
+  if (!fs.existsSync(ANALYTICS_DIR)) {
+    fs.mkdirSync(ANALYTICS_DIR, { recursive: true });
+  }
+}
+
+function getInstallDate(projectPath) {
+  const installFile = path.join(ANALYTICS_DIR, 'install.json');
+  try {
+    const data = JSON.parse(fs.readFileSync(installFile, 'utf8'));
+    if (projectPath) {
+      return data.projectPath === projectPath ? data.installedAt : null;
+    }
+    return data.installedAt;
+  } catch {
+    return null;
+  }
+}
+
+function setInstallDate(projectPath) {
+  ensureDir();
+  const installFile = path.join(ANALYTICS_DIR, 'install.json');
+  const record = {
+    projectPath: projectPath,
+    installedAt: new Date().toISOString()
+  };
+  fs.writeFileSync(installFile, JSON.stringify(record, null, 2));
+  return record;
+}
+
+function parseHistory(fromDate, toDate) {
+  const from = new Date(fromDate).getTime();
+  const to = new Date(toDate).getTime();
+
+  const stats = {
+    totalPrompts: 0,
+    totalTokens: 0,
+    sessions: new Map(),
+    modelUsage: {},
+    dailyTokens: {},
+    dailyPrompts: {}
+  };
+
+  if (!fs.existsSync(HISTORY_FILE)) {
+    return stats;
+  }
+
+  const lines = fs.readFileSync(HISTORY_FILE, 'utf8').split('\n').filter(Boolean);
+
+  for (const line of lines) {
+    try {
+      const entry = JSON.parse(line);
+      const ts = new Date(entry.timestamp || entry.ts || Date.now()).getTime();
+
+      if (ts < from || ts > to) continue;
+
+      stats.totalPrompts++;
+
+      const tokens = entry.tokens || entry.input_tokens + (entry.output_tokens || 0) || 0;
+      stats.totalTokens += tokens;
+
+      const sessionId = entry.session_id || entry.sessionId || 'unknown';
+      if (!stats.sessions.has(sessionId)) {
+        stats.sessions.set(sessionId, { prompts: 0, tokens: 0 });
+      }
+      const sess = stats.sessions.get(sessionId);
+      sess.prompts++;
+      sess.tokens += tokens;
+
+      const model = entry.model || entry.model_name || 'claude';
+      stats.modelUsage[model] = (stats.modelUsage[model] || 0) + tokens;
+
+      const day = new Date(ts).toISOString().split('T')[0];
+      stats.dailyTokens[day] = (stats.dailyTokens[day] || 0) + tokens;
+      stats.dailyPrompts[day] = (stats.dailyPrompts[day] || 0) + 1;
+    } catch {
+      continue;
+    }
+  }
+
+  const sessionCount = stats.sessions.size;
+  return {
+    totalPrompts: stats.totalPrompts,
+    totalTokens: stats.totalTokens,
+    avgTokensPerSession: sessionCount > 0 ? Math.round(stats.totalTokens / sessionCount) : 0,
+    avgTokensPerPrompt: stats.totalPrompts > 0 ? Math.round(stats.totalTokens / stats.totalPrompts) : 0,
+    sessionCount,
+    modelUsage: stats.modelUsage,
+    dailyTokens: stats.dailyTokens,
+    dailyPrompts: stats.dailyPrompts
+  };
+}
+
+function calculateROI(projectPath) {
+  const installDate = getInstallDate(projectPath);
+
+  if (!installDate) {
+    return {
+      error: 'CRG not installed. Run: npx crg-dev-kit install',
+      installed: false
+    };
+  }
+
+  const now = new Date();
+  const thirtyDaysBefore = new Date(now.getTime() - 30 * 24 * 60 * 60 * 1000);
+
+  const baselineStart = thirtyDaysBefore < new Date(installDate) ? thirtyDaysBefore : new Date(new Date(installDate).getTime() - 30 * 24 * 60 * 60 * 1000);
+  const baselineEnd = new Date(installDate);
+
+  const postStart = new Date(installDate);
+  const postEnd = now;
+
+  const baseline = parseHistory(baselineStart, baselineEnd);
+  const post = parseHistory(postStart, postEnd);
+
+  const baselineAvg = baseline.avgTokensPerSession || 1;
+  const postAvg = post.avgTokensPerSession || 0;
+
+  const tokenDelta = baselineAvg - postAvg;
+  const tokenSavingsPercent = baselineAvg > 0 ? Math.round((tokenDelta / baselineAvg) * 100) : 0;
+
+  const baselinePrompts = baseline.totalPrompts || 1;
+  const postPrompts = post.totalPrompts || 0;
+  const promptReduction = baselinePrompts - postPrompts;
+
+  const avgTokensPerPromptBefore = baseline.avgTokensPerPrompt || 1;
+  const avgTokensPerPromptAfter = post.avgTokensPerPrompt || 0;
+  const tokensSaved = (avgTokensPerPromptBefore - avgTokensPerPromptAfter) * postPrompts;
+
+  const timeSavedSeconds = promptReduction * 30;
+  const timeSavedHours = Math.round(timeSavedSeconds / 3600 * 10) / 10;
+
+  const costPerMillion = 10;
+  const estimatedCostSavings = Math.round(tokensSaved / 1000000 * costPerMillion * 100) / 100;
+
+  return {
+    installed: true,
+    installDate,
+    projectPath,
+    baseline: {
+      period: { start: baselineStart.toISOString(), end: baselineEnd.toISOString() },
+      totalPrompts: baseline.totalPrompts,
+      totalTokens: baseline.totalTokens,
+      avgTokensPerSession: baseline.avgTokensPerSession,
+      sessionCount: baseline.sessionCount
+    },
+    post: {
+      period: { start: postStart.toISOString(), end: postEnd.toISOString() },
+      totalPrompts: post.totalPrompts,
+      totalTokens: post.totalTokens,
+      avgTokensPerSession: post.avgTokensPerSession,
+      sessionCount: post.sessionCount
+    },
+    roi: {
+      tokenSavingsPercent,
+      tokenDelta,
+      tokensSaved: Math.max(0, tokensSaved),
+      promptReduction: Math.max(0, promptReduction),
+      timeSavedHours,
+      estimatedCostSavings,
+      verdict: tokenSavingsPercent > 10 ? 'positive' : tokenSavingsPercent > 0 ? 'neutral' : 'negative'
+    }
+  };
+}
+
+function getAllProjectsROI() {
+  const installFile = path.join(ANALYTICS_DIR, 'install.json');
+  try {
+    const installData = JSON.parse(fs.readFileSync(installFile, 'utf8'));
+    return calculateROI(installData.projectPath);
+  } catch {
+    return { error: 'No installation found', installed: false };
+  }
+}
+
+function generateROIReport(projectPath) {
+  const roi = calculateROI(projectPath);
+
+  if (roi.error) {
+    return `# CRG ROI Report\n\n${roi.error}`;
+  }
+
+  let report = `# CRG ROI Report
+
+**Project**: ${roi.projectPath}
+**Installed**: ${new Date(roi.installDate).toLocaleDateString()}
+
+## Summary
+
+| Metric | Before CRG | After CRG | Change |
+|--------|:----------:|:---------:|--------|
+| Avg Tokens/Session | ${roi.baseline.avgTokensPerSession.toLocaleString()} | ${roi.post.avgTokensPerSession.toLocaleString()} | ${roi.roi.tokenDelta >= 0 ? '-' : '+'}${Math.abs(roi.roi.tokenDelta).toLocaleString()} |
+| Total Prompts | ${roi.baseline.totalPrompts} | ${roi.post.totalPrompts} | ${roi.roi.promptReduction >= 0 ? '-' : '+'}${Math.abs(roi.roi.promptReduction)} |
+| Sessions | ${roi.baseline.sessionCount} | ${roi.post.sessionCount} | ${roi.post.sessionCount - roi.baseline.sessionCount} |
+
+## ROI Metrics
+
+| Metric | Value |
+|--------|-------|
+| **Token Savings** | ${roi.roi.tokenSavingsPercent}% |
+| **Tokens Saved** | ${roi.roi.tokensSaved.toLocaleString()} |
+| **Time Saved** | ${roi.roi.timeSavedHours} hours |
+| **Est. Cost Savings** | $${roi.roi.estimatedCostSavings} |
+| **Verdict** | ${roi.roi.verdict === 'positive' ? '✅ CRG is helping' : roi.roi.verdict === 'neutral' ? '➖ No significant change' : '⚠️ CRG may not be helping'}
+
+---
+
+*Generated: ${new Date().toISOString()}*
+*Data source: ~/.claude/history.jsonl*
+`;
+
+  return report;
+}
+
+function generateDailyBreakdown(fromDate, toDate) {
+  const data = parseHistory(fromDate, toDate);
+  const days = Object.keys(data.dailyTokens).sort();
+
+  if (days.length === 0) {
+    return 'No usage data found in the specified period.';
+  }
+
+  let report = `# Daily Usage Breakdown
+
+| Date | Tokens | Prompts |
+|------|-------:|--------:|
+`;
+
+  days.forEach(day => {
+    report += `| ${day} | ${data.dailyTokens[day].toLocaleString()} | ${data.dailyPrompts[day]} |\n`;
+  });
+
+  return report;
+}
+
+module.exports = {
+  getInstallDate,
+  setInstallDate,
+  parseHistory,
+  calculateROI,
+  getAllProjectsROI,
+  generateROIReport,
+  generateDailyBreakdown
+};

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "crg-dev-kit",
+  "version": "1.0.0",
+  "description": "One-click setup for code-review-graph — AI-powered codebase knowledge graph with token analytics",
+  "main": "server.js",
+  "bin": {
+    "crg-dev-kit": "./bin/cli.js"
+  },
+  "files": [
+    "bin/",
+    "assets/",
+    "lib/",
+    "server.js"
+  ],
+  "scripts": {
+    "start": "node server.js",
+    "test": "node tests/*.test.js"
+  },
+  "keywords": [
+    "code-review",
+    "knowledge-graph",
+    "mcp",
+    "claude-code",
+    "cursor",
+    "ai-tools",
+    "developer-tools",
+    "token-analytics"
+  ],
+  "author": "shloke",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/tirth8205/code-review-graph"
+  },
+  "engines": {
+    "node": ">=16"
+  }
+}