cchubber 0.5.3 → 0.5.5

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,13 +1,15 @@
 {
   "name": "cchubber",
-  "version": "0.5.3",
+  "version": "0.5.5",
   "description": "What you spent. Why you spent it. Is that normal. — Claude Code usage diagnosis with beautiful HTML reports.",
   "type": "module",
   "bin": {
     "cchubber": "./src/cli/index.js"
   },
   "scripts": {
-    "start": "node src/cli/index.js"
+    "start": "node src/cli/index.js",
+    "test": "node test/smoke.js",
+    "release": "bash release.sh"
   },
   "keywords": [
     "claude",

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
@@ -1062,6 +1064,7 @@ ${cacheHealth.totalCacheBreaks > 0 ? `
   // Community leaderboard — stats fetched at generation time, embedded as JSON
   var MY_RATIO = ${cacheHealth.efficiencyRatio || 0};
   var MY_GRADE = '${cacheHealth.grade?.letter || '?'}';
+  var MY_COST = '${(() => { const c = totalCost; return c<10?'<10':c<50?'10-50':c<200?'50-200':c<500?'200-500':c<1000?'500-1K':c<5000?'1K-5K':'5K+'; })()}';
   var gradeColors = {A:'#10b981',B:'#22d3ee',C:'#f59e0b',D:'#f97316',F:'#ef4444'};
   var stats = ${JSON.stringify(report.communityStats || null)};
 
@@ -1123,20 +1126,24 @@ ${cacheHealth.totalCacheBreaks > 0 ? `
       });
 
       // Leaderboard table — re-graded, with user's position injected
+      // Filter: minimum activity to qualify (exclude <$10 and $10-50 users — too little data for meaningful grade)
+      var validCosts = {'50-200':1,'200-500':1,'500-1K':1,'1K-5K':1,'5K+':1};
       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)});
+      var sorted = recent.filter(function(r){return r.ratio && (validCosts[r.cost] || r.cost===MY_COST)}).sort(function(a,b){return (a.ratio||9999)-(b.ratio||9999)});
 
-      // Find where the user would rank
+      // Insert user's own entry into the sorted list at the right position
+      var myEntry = {ratio:MY_RATIO, grade:MY_GRADE, cost:MY_COST, opus:${report.modelRouting?.opusPct ?? 'null'}, country:'You', os:'${process.platform}', isMe:true};
       var myRank = sorted.findIndex(function(e){return (e.ratio||0) >= MY_RATIO});
       if(myRank < 0) myRank = sorted.length;
+      sorted.splice(myRank, 0, myEntry);
 
       // 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){
+      if(!userInTop){
         showIndices.push(-1); // separator
-        if(myRank > 0) showIndices.push(myRank-1);
+        if(myRank > 1) showIndices.push(myRank-1);
         showIndices.push(myRank);
         if(myRank+1 < sorted.length) showIndices.push(myRank+1);
       }
@@ -1145,28 +1152,28 @@ ${cacheHealth.totalCacheBreaks > 0 ? `
       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>';
+          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 = idx === myRank;
+        var g = entry.isMe ? MY_GRADE : getGrade(entry);
+        var isMe = entry.isMe;
         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 '+(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 += '<td class="px-4 py-3 text-sm font-mono text-[#c7c4d7] text-right">'+(entry.opus!=null?entry.opus:'?')+'%</td>';
+        html += '<td class="px-8 py-3 text-sm text-[#908fa0]">'+(isMe?'You':(entry.country||'?'))+'</td>';
         html += '</tr>';
       }
       tbody.innerHTML = html;
 
       // Update percentile text with rank
       document.getElementById('community-percentile').innerHTML =
-        'You\'re <strong style="color:#c0c1ff">#'+(myRank+1)+' of '+sorted.length+'</strong> users by cache efficiency. Better than <strong style="color:#c0c1ff">'+pctile+'%</strong>';
+        "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>