cchubber 0.5.4 → 0.5.6

package/package.json

@@ -1,13 +1,15 @@
 {
   "name": "cchubber",
-  "version": "0.5.4",
+  "version": "0.5.6",
   "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/analyzers/value-tracker.js

@@ -0,0 +1,102 @@
+/**
+ * Value Tracker — measures whether you're getting less for your money over time.
+ *
+ * Two core metrics:
+ * - Output per message: are Claude's responses getting shorter? (model degradation)
+ * - Output per dollar: are you getting less work per dollar? (pricing/caching changes)
+ *
+ * Uses z-score anomaly detection (2 SD) to flag days where value drops significantly.
+ */
+
+export function analyzeValueTrend(dailyFromJSONL) {
+  if (!dailyFromJSONL || dailyFromJSONL.length < 3) {
+    return { available: false };
+  }
+
+  // Calculate per-day metrics
+  const daily = dailyFromJSONL
+    .filter(d => d.outputTokens > 0 && d.messageCount > 0)
+    .map(d => ({
+      date: d.date,
+      outputPerMsg: Math.round(d.outputTokens / d.messageCount),
+      outputPerDollar: d.cost > 0 ? Math.round(d.outputTokens / d.cost) : 0,
+      outputTokens: d.outputTokens,
+      messageCount: d.messageCount,
+      cost: d.cost || 0,
+    }));
+
+  if (daily.length < 3) return { available: false };
+
+  // Overall averages
+  const avgOutputPerMsg = Math.round(daily.reduce((s, d) => s + d.outputPerMsg, 0) / daily.length);
+  const avgOutputPerDollar = daily.filter(d => d.outputPerDollar > 0).length > 0
+    ? Math.round(daily.filter(d => d.outputPerDollar > 0).reduce((s, d) => s + d.outputPerDollar, 0) / daily.filter(d => d.outputPerDollar > 0).length)
+    : 0;
+
+  // Recent 7 days vs older — is value declining?
+  const sorted = [...daily].sort((a, b) => a.date.localeCompare(b.date));
+  const recent = sorted.slice(-7);
+  const older = sorted.slice(0, -7);
+
+  let trend = 'stable';
+  let trendDetail = '';
+
+  if (older.length >= 3) {
+    const recentAvgPerMsg = Math.round(recent.reduce((s, d) => s + d.outputPerMsg, 0) / recent.length);
+    const olderAvgPerMsg = Math.round(older.reduce((s, d) => s + d.outputPerMsg, 0) / older.length);
+
+    const recentAvgPerDollar = recent.filter(d => d.outputPerDollar > 0).length > 0
+      ? Math.round(recent.filter(d => d.outputPerDollar > 0).reduce((s, d) => s + d.outputPerDollar, 0) / recent.filter(d => d.outputPerDollar > 0).length)
+      : 0;
+    const olderAvgPerDollar = older.filter(d => d.outputPerDollar > 0).length > 0
+      ? Math.round(older.filter(d => d.outputPerDollar > 0).reduce((s, d) => s + d.outputPerDollar, 0) / older.filter(d => d.outputPerDollar > 0).length)
+      : 0;
+
+    const msgChange = olderAvgPerMsg > 0 ? ((recentAvgPerMsg - olderAvgPerMsg) / olderAvgPerMsg * 100) : 0;
+    const dollarChange = olderAvgPerDollar > 0 ? ((recentAvgPerDollar - olderAvgPerDollar) / olderAvgPerDollar * 100) : 0;
+
+    if (msgChange < -20) {
+      trend = 'declining';
+      trendDetail = `Output per message dropped ${Math.abs(Math.round(msgChange))}% recently (${olderAvgPerMsg} → ${recentAvgPerMsg} tokens/msg)`;
+    } else if (msgChange > 20) {
+      trend = 'improving';
+      trendDetail = `Output per message increased ${Math.round(msgChange)}% recently (${olderAvgPerMsg} → ${recentAvgPerMsg} tokens/msg)`;
+    } else {
+      trendDetail = `Output per message stable (${recentAvgPerMsg} tokens/msg, was ${olderAvgPerMsg})`;
+    }
+  }
+
+  // Z-score anomaly detection — flag days where value drops >2 SD
+  const values = daily.map(d => d.outputPerMsg);
+  const mean = values.reduce((s, v) => s + v, 0) / values.length;
+  const variance = values.reduce((s, v) => s + Math.pow(v - mean, 2), 0) / values.length;
+  const stdDev = Math.sqrt(variance);
+
+  const anomalies = [];
+  if (stdDev > 0) {
+    for (const d of daily) {
+      const z = (d.outputPerMsg - mean) / stdDev;
+      if (z < -2) {
+        anomalies.push({
+          date: d.date,
+          type: 'low_output',
+          outputPerMsg: d.outputPerMsg,
+          expected: avgOutputPerMsg,
+          deviation: Math.abs(Math.round(z * 10) / 10),
+          detail: `${d.outputPerMsg} tokens/msg vs ${avgOutputPerMsg} avg (${Math.abs(Math.round(z * 10) / 10)}σ below)`,
+        });
+      }
+    }
+  }
+
+  return {
+    available: true,
+    daily: daily.map(d => ({ date: d.date, outputPerMsg: d.outputPerMsg, outputPerDollar: d.outputPerDollar })),
+    avgOutputPerMsg,
+    avgOutputPerDollar,
+    trend,
+    trendDetail,
+    anomalies,
+    dayCount: daily.length,
+  };
+}

package/src/cli/index.js

@@ -25,6 +25,7 @@ import { generateRecommendations } from '../analyzers/recommendations.js';
 import { detectInflectionPoints } from '../analyzers/inflection-detector.js';
 import { analyzeSessionIntelligence } from '../analyzers/session-intelligence.js';
 import { analyzeModelRouting } from '../analyzers/model-routing.js';
+import { analyzeValueTrend } from '../analyzers/value-tracker.js';
 import { renderHTML } from '../renderers/html-report.js';
 import { renderTerminal } from '../renderers/terminal-summary.js';
 import { shouldSendTelemetry, sendTelemetry } from '../telemetry.js';
@@ -134,6 +135,9 @@ async function main() {
   const inflection = detectInflectionPoints(dailyFromJSONL);
   const sessionIntel = analyzeSessionIntelligence(sessionMeta, jsonlEntries);
   const modelRouting = analyzeModelRouting(costAnalysis, jsonlEntries);
+  const valueTrend = analyzeValueTrend(dailyFromJSONL);
+  if (valueTrend.available) console.log(`  ✓ Value trend: ${valueTrend.avgOutputPerMsg} tokens/msg avg (${valueTrend.trend})`);
+
   const recommendations = generateRecommendations(costAnalysis, cacheHealth, claudeMdStack, anomalies, inflection, sessionIntel, modelRouting, projectBreakdown);
 
   if (inflection) console.log(`  ✓ Inflection: ${inflection.summary}`);
@@ -166,6 +170,7 @@ async function main() {
     claudeMdStack,
     oauthUsage,
     recommendations,
+    valueTrend,
     communityStats,
     history: getHistory(),
   };

package/src/renderers/html-report.js

@@ -372,6 +372,39 @@ ${inflection && inflection.multiplier >= 1.5 ? `
   <svg id="cost-chart-svg" viewBox="0 0 900 200" preserveAspectRatio="xMidYMid meet"></svg>
 </section>
 
+${report.valueTrend?.available ? `
+<!-- VALUE TREND -->
+<section class="bg-[#1b1c1d] p-8 rounded-xl border border-[rgba(70,69,84,0.15)]">
+  <div class="flex items-center justify-between mb-6">
+    <h3 class="text-xl font-bold text-[#e3e2e3]">Output Value</h3>
+    <span class="text-[10px] font-mono text-[#908fa0]">${report.valueTrend.trend === 'declining' ? 'DECLINING' : report.valueTrend.trend === 'improving' ? 'IMPROVING' : 'STABLE'}</span>
+  </div>
+  <div class="grid grid-cols-2 gap-6 mb-6">
+    <div class="bg-[#0d0e0f] p-5 rounded-lg">
+      <span class="text-[10px] uppercase tracking-[0.05em] text-[#908fa0] block mb-2">Tokens per Message</span>
+      <span class="font-mono text-2xl font-bold text-[#e3e2e3]">${report.valueTrend.avgOutputPerMsg.toLocaleString()}</span>
+      <span class="text-[10px] text-[#908fa0] block mt-1">avg output tokens per turn</span>
+    </div>
+    <div class="bg-[#0d0e0f] p-5 rounded-lg">
+      <span class="text-[10px] uppercase tracking-[0.05em] text-[#908fa0] block mb-2">Tokens per Dollar</span>
+      <span class="font-mono text-2xl font-bold text-[#e3e2e3]">${report.valueTrend.avgOutputPerDollar.toLocaleString()}</span>
+      <span class="text-[10px] text-[#908fa0] block mt-1">output tokens per $1 spent</span>
+    </div>
+  </div>
+  ${report.valueTrend.trendDetail ? `<p class="text-[12px] text-[#908fa0] mb-4">${esc(report.valueTrend.trendDetail)}</p>` : ''}
+  ${report.valueTrend.anomalies?.length > 0 ? `
+  <div class="space-y-2">
+    <span class="text-[10px] uppercase tracking-[0.05em] text-[#908fa0] block">Low Output Days (2+ SD below average)</span>
+    ${report.valueTrend.anomalies.slice(0, 5).map(a => `
+    <div class="p-3 bg-[#0d0e0f] rounded-lg flex items-center justify-between">
+      <span class="text-[12px] font-mono text-[#908fa0]">${a.date}</span>
+      <span class="text-[12px] text-[#e3e2e3]">${a.outputPerMsg} tokens/msg</span>
+      <span class="text-[10px] font-mono px-2 py-0.5 rounded" style="background:rgba(255,180,171,0.15);color:#ffb4ab">${a.deviation}σ below</span>
+    </div>`).join('')}
+  </div>` : ''}
+</section>
+` : ''}
+
 <!-- 5. SESSION INTELLIGENCE + MODEL DISTRIBUTION -->
 <section class="grid grid-cols-1 lg:grid-cols-2 gap-8">
 
@@ -1064,6 +1097,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)};
 
@@ -1125,20 +1159,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);
       }
@@ -1147,28 +1185,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 are <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>