cchubber 0.5.2 → 0.5.4

package/README.md

@@ -9,9 +9,7 @@ Your Claude Code usage, diagnosed. One command.
 npx cchubber
 ```
 
-Reads your local data, generates an HTML report. No API keys, no accounts, runs entirely offline.
-
-Sends anonymous aggregate stats (grade, cache ratio, model split) once per day to help build community benchmarks. No tokens, no file contents, no project names. Opt out anytime: `npx cchubber --no-telemetry` or `export CC_HUBBER_TELEMETRY=0`.
+Reads your local data, generates an HTML report. No API keys, no accounts. Sends anonymous stats for community benchmarks ([details](#telemetry)). Opt out: `--no-telemetry`.
 
 Built during the March 2026 cache crisis because nobody could tell if they'd been hit. Thousands of users burning through limits 10-20x faster than normal, and Anthropic's only answer was "we're investigating." We wanted receipts.
 
@@ -103,6 +101,35 @@ Everything is local. CC Hubber reads files that already exist on your machine.
 
 CC Hubber tells you why, and whether it's normal. Inflection detection, cache break estimation, model routing savings, session intelligence, trend-weighted grading. Different tools for different questions.
 
+## Telemetry
+
+CC Hubber sends anonymous usage stats once per day to power community benchmarks. This is what makes the leaderboard rank, grade calibration, and community comparisons in your recommendations work. Without it, every user gets the same generic thresholds instead of real benchmarks.
+
+**What's collected:**
+- Cache health: grade, ratio, hit rate, break count
+- Cost: bucketed range (e.g. "$500-1K"), not exact amounts
+- Models: opus/sonnet/haiku split percentages
+- Sessions: count, average duration, tool usage counts
+- Config: CLAUDE.md token count, hook count, MCP server names, skill count
+- Environment: OS, architecture, Node version, Claude Code version
+- Tech stack: boolean flags (uses React, TypeScript, Tailwind, etc.)
+- Anonymous machine ID (random hash, not tied to any account)
+
+**What's NOT collected:**
+- No file contents, project names, or directory paths
+- No API keys, tokens, or credentials
+- No conversation text or prompts
+- No personal information (name, email, IP address)
+
+**Opt out anytime:**
+```bash
+npx cchubber --no-telemetry
+# or permanently:
+export CC_HUBBER_TELEMETRY=0
+```
+
+Full source: [`src/telemetry.js`](src/telemetry.js)
+
 ## License
 
 MIT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cchubber",
-  "version": "0.5.2",
+  "version": "0.5.4",
   "description": "What you spent. Why you spent it. Is that normal. — Claude Code usage diagnosis with beautiful HTML reports.",
   "type": "module",
   "bin": {

package/src/renderers/html-report.js

@@ -748,7 +748,9 @@ ${cacheHealth.totalCacheBreaks > 0 ? `
 
   function chart(d){
     if(!svg)return;
-    if(!d.length){svg.innerHTML='<text x="450" y="100" text-anchor="middle" fill="#908fa0" font-size="13" font-family="Inter,sans-serif">No data</text>';return}
+    if(!d.length){svg.innerHTML='<text x="450" y="100" text-anchor="middle" fill="#908fa0" font-size="13" font-family="Inter,sans-serif">No data for this period</text>';return}
+    var total=d.reduce(function(s,x){return s+x.cost},0);
+    if(total<0.01){svg.innerHTML='<text x="450" y="100" text-anchor="middle" fill="#908fa0" font-size="13" font-family="Inter,sans-serif">No cost data — costs are only calculated from token counts, not the costUSD field</text>';return}
     var mx=Math.max.apply(null,d.map(function(x){return x.cost}))*1.1;if(mx<0.01)mx=1;
     var s='';
     // grid lines
@@ -1122,25 +1124,51 @@ ${cacheHealth.totalCacheBreaks > 0 ? `
         }
       });
 
-      // Leaderboard table — re-graded
+      // Leaderboard table — re-graded, with user's position injected
       var tbody = document.getElementById('leaderboard-body');
       var sorted = recent.filter(function(r){return r.ratio}).sort(function(a,b){return (a.ratio||9999)-(b.ratio||9999)});
 
+      // Find where the user would rank
+      var myRank = sorted.findIndex(function(e){return (e.ratio||0) >= MY_RATIO});
+      if(myRank < 0) myRank = sorted.length;
+
+      // Show top 10 + user's position (if not in top 10)
+      var showIndices = [];
+      for(var si=0;si<Math.min(10,sorted.length);si++) showIndices.push(si);
+      var userInTop = myRank < 10;
+      if(!userInTop && myRank < sorted.length){
+        showIndices.push(-1); // separator
+        if(myRank > 0) showIndices.push(myRank-1);
+        showIndices.push(myRank);
+        if(myRank+1 < sorted.length) showIndices.push(myRank+1);
+      }
+
       var html = '';
-      sorted.forEach(function(entry, i){
+      for(var si2=0;si2<showIndices.length;si2++){
+        var idx = showIndices[si2];
+        if(idx === -1){
+          html += '<tr><td colspan="6" class="px-8 py-1 text-center text-[10px] text-[#908fa0]">···</td></tr>';
+          continue;
+        }
+        var entry = sorted[idx];
+        if(!entry) continue;
         var g = getGrade(entry);
-        var isMe = Math.abs((entry.ratio||0) - MY_RATIO) < 50;
-        var rowStyle = isMe ? 'background:rgba(192,193,255,0.06);border-left:2px solid #c0c1ff;' : '';
+        var isMe = idx === myRank;
+        var rowStyle = isMe ? 'background:rgba(192,193,255,0.08);border-left:3px solid #c0c1ff;' : '';
         html += '<tr style="border-bottom:1px solid rgba(70,69,84,0.1);'+rowStyle+'">';
-        html += '<td class="px-8 py-3 text-sm font-mono text-[#908fa0]">#'+(i+1)+'</td>';
+        html += '<td class="px-8 py-3 text-sm font-mono '+(isMe?'text-[#c0c1ff] font-bold':'text-[#908fa0]')+'">#'+(idx+1)+(isMe?' ← you':'')+'</td>';
         html += '<td class="px-4 py-3 text-sm font-bold text-center" style="color:'+gradeColors[g]+'">'+g+'</td>';
         html += '<td class="px-4 py-3 text-sm font-mono text-[#c7c4d7] text-right">'+(entry.ratio||'?')+':1</td>';
         html += '<td class="px-4 py-3 text-sm font-mono text-[#908fa0]">'+(entry.cost||'?')+'</td>';
         html += '<td class="px-4 py-3 text-sm font-mono text-[#c7c4d7] text-right">'+(entry.opus||'?')+'%</td>';
         html += '<td class="px-8 py-3 text-sm text-[#908fa0]">'+(entry.country||'?')+'</td>';
         html += '</tr>';
-      });
+      }
       tbody.innerHTML = html;
+
+      // Update percentile text with rank
+      document.getElementById('community-percentile').innerHTML =
+        "You are <strong style=\\"color:#c0c1ff\\">#"+(myRank+1)+" of "+sorted.length+"</strong> users by cache efficiency. Better than <strong style=\\"color:#c0c1ff\\">"+pctile+"%</strong>";
   })(stats);
 })();
 </script>