cchubber 0.5.5 → 0.5.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cchubber",
-  "version": "0.5.5",
+  "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": {

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">