@roastcodes/ttdash 6.1.4 → 6.1.6

package/server/report/utils.js

@@ -1,5 +1,15 @@
 const { version: APP_VERSION } = require('../../package.json');
 const { getLanguage, getLocale, translate } = require('./i18n');
+const modelNormalizationSpec = require('../model-normalization.json');
+
+const DISPLAY_ALIASES = modelNormalizationSpec.displayAliases.map((alias) => ({
+  ...alias,
+  matcher: new RegExp(alias.pattern, 'i'),
+}));
+const PROVIDER_MATCHERS = modelNormalizationSpec.providerMatchers.map((matcher) => ({
+  ...matcher,
+  matcher: new RegExp(matcher.pattern, 'i'),
+}));
 
 const MODEL_COLORS = {
   'Opus 4.6': 'rgb(175, 92, 224)',
@@ -10,8 +20,8 @@ const MODEL_COLORS = {
   'GPT-5.4': 'rgb(230, 98, 56)',
   'GPT-5': 'rgb(230, 98, 56)',
   'Gemini 3 Flash Preview': 'rgb(237, 188, 8)',
-  'Gemini': 'rgb(237, 188, 8)',
-  'OpenCode': 'rgb(51, 181, 193)',
+  Gemini: 'rgb(237, 188, 8)',
+  OpenCode: 'rgb(51, 181, 193)',
 };
 
 const WEEKDAYS = ['Mo', 'Di', 'Mi', 'Do', 'Fr', 'Sa', 'So'];
@@ -23,58 +33,158 @@ function titleCaseSegment(segment) {
   return segment.charAt(0).toUpperCase() + segment.slice(1);
 }
 
-function normalizeModelName(raw) {
-  const lower = String(raw || '').toLowerCase().trim();
-  if (lower.includes('gpt-5-4') || lower.includes('gpt-5.4')) return 'GPT-5.4';
-  if (lower.includes('gpt-5')) return 'GPT-5';
-  if (lower.includes('opus-4-6') || lower.includes('opus-4.6')) return 'Opus 4.6';
-  if (lower.includes('opus-4-5') || lower.includes('opus-4.5')) return 'Opus 4.5';
-  if (lower.includes('sonnet-4-6') || lower.includes('sonnet-4.6')) return 'Sonnet 4.6';
-  if (lower.includes('sonnet-4-5') || lower.includes('sonnet-4.5')) return 'Sonnet 4.5';
-  if (lower.includes('haiku-4-5') || lower.includes('haiku-4.5')) return 'Haiku 4.5';
-  if (lower.includes('gemini-3-flash-preview')) return 'Gemini 3 Flash Preview';
-  if (lower.includes('gemini')) return 'Gemini';
-  if (lower.includes('opencode')) return 'OpenCode';
-  if (lower.includes('haiku')) return 'Haiku';
-
-  const stripped = String(raw || '')
+function capitalize(segment) {
+  if (!segment) return '';
+  return segment.charAt(0).toUpperCase() + segment.slice(1);
+}
+
+function formatVersion(version) {
+  return version.replace(/-/g, '.');
+}
+
+function canonicalizeModelName(raw) {
+  const normalized = String(raw || '')
     .trim()
-    .replace(/^(claude|anthropic|openai|google|vertex|models)\//i, '')
-    .replace(/^(claude|anthropic|openai|google|vertex|models)-/i, '')
+    .toLowerCase()
     .replace(/^model[:/ -]*/i, '')
+    .replace(/^(anthropic|openai|google|vertex|models)[/-]/i, '')
+    .replace(/\./g, '-')
     .replace(/[_/]+/g, '-')
     .replace(/\s+/g, '-')
     .replace(/-{2,}/g, '-')
     .replace(/^-|-$/g, '');
 
-  const familyMatch = stripped.match(/(gpt|opus|sonnet|haiku|gemini|o\d|oai|grok|llama|mistral|command|deepseek|qwen)[- ]?([a-z0-9.-]+)?/i);
+  const suffixStart = normalized.lastIndexOf('-');
+  if (suffixStart > 0) {
+    const suffix = normalized.slice(suffixStart + 1);
+    if (suffix.length === 8 && suffix.startsWith('20') && /^\d+$/.test(suffix)) {
+      return normalized.slice(0, suffixStart);
+    }
+  }
+
+  return normalized;
+}
+
+function parseClaudeName(rest) {
+  const parts = rest.split('-', 2);
+  if (parts.length < 2) {
+    return `Claude ${capitalize(rest)}`;
+  }
+
+  return `${capitalize(parts[0] || '')} ${formatVersion(parts[1] || '')}`.trim();
+}
+
+function parseGptName(rest) {
+  const parts = rest.split('-');
+  const variant = parts[0] || '';
+  const minor = parts[1] || '';
+
+  if (minor && minor.length <= 2 && /^\d+$/.test(minor)) {
+    const version = `${variant}.${minor}`;
+    if (parts.length > 2) {
+      const suffix = parts.slice(2).map(capitalize).join(' ');
+      return `GPT-${version}${suffix ? ` ${suffix}` : ''}`;
+    }
+    return `GPT-${version}`;
+  }
+
+  if (parts.length > 1) {
+    const suffix = parts.slice(1).map(capitalize).join(' ');
+    return `GPT-${variant}${suffix ? ` ${suffix}` : ''}`;
+  }
+
+  return `GPT-${rest}`;
+}
+
+function parseGeminiName(rest) {
+  const parts = rest.split('-');
+  if (parts.length < 2) {
+    return `Gemini ${rest}`;
+  }
+
+  const versionParts = [];
+  const tierParts = [];
+
+  for (const part of parts) {
+    if (/^\d+$/.test(part) && tierParts.length === 0) {
+      versionParts.push(part);
+    } else {
+      tierParts.push(capitalize(part));
+    }
+  }
+
+  const version = versionParts.join('.');
+  const tier = tierParts.join(' ');
+
+  return tier ? `Gemini ${version} ${tier}` : `Gemini ${version}`;
+}
+
+function parseCodexName(rest) {
+  const normalized = rest.replace(/-latest$/i, '');
+  if (!normalized) {
+    return 'Codex';
+  }
+  return `Codex ${normalized.split('-').map(capitalize).join(' ')}`;
+}
+
+function parseOSeries(name) {
+  const separatorIndex = name.indexOf('-');
+  if (separatorIndex === -1) {
+    return name;
+  }
+  return `${name.slice(0, separatorIndex)} ${capitalize(name.slice(separatorIndex + 1))}`;
+}
+
+function normalizeModelName(raw) {
+  const canonical = canonicalizeModelName(raw);
+
+  for (const alias of DISPLAY_ALIASES) {
+    if (alias.matcher.test(canonical)) return alias.name;
+  }
+
+  if (canonical.startsWith('claude-')) {
+    return parseClaudeName(canonical.slice('claude-'.length));
+  }
+
+  if (canonical.startsWith('gpt-')) {
+    return parseGptName(canonical.slice('gpt-'.length));
+  }
+
+  if (canonical.startsWith('gemini-')) {
+    return parseGeminiName(canonical.slice('gemini-'.length));
+  }
+
+  if (canonical.startsWith('codex-')) {
+    return parseCodexName(canonical.slice('codex-'.length));
+  }
+
+  if (/^o\d/i.test(canonical)) {
+    return parseOSeries(canonical);
+  }
+
+  const familyMatch = canonical.match(
+    /^(gpt|opus|sonnet|haiku|gemini|codex|o\d|oai|grok|llama|mistral|command|deepseek|qwen)(?:-([a-z0-9-]+))?$/i,
+  );
   if (familyMatch) {
     const family = familyMatch[1];
-    const suffix = familyMatch[2] ? familyMatch[2].replace(/-/g, '.') : '';
+    if (/^codex$/i.test(family)) {
+      return parseCodexName(familyMatch[2] || '');
+    }
+    if (/^(o\d)$/i.test(family)) return parseOSeries(canonical);
+
+    const suffix = familyMatch[2] ? formatVersion(familyMatch[2]) : '';
     if (/^gpt$/i.test(family) && suffix) return `GPT-${suffix.toUpperCase()}`;
-    if (/^(o\d)$/i.test(family)) return family.toUpperCase();
     return `${titleCaseSegment(family)}${suffix ? ` ${suffix}` : ''}`.trim();
   }
 
-  return stripped
-    .split('-')
-    .filter(Boolean)
-    .map(titleCaseSegment)
-    .join(' ') || String(raw || '');
+  return canonical.split('-').filter(Boolean).map(titleCaseSegment).join(' ') || String(raw || '');
 }
 
 function getModelProvider(raw) {
-  const lower = String(raw || '').toLowerCase();
-  if (lower.includes('gpt') || lower.includes('openai') || lower.includes('/o1') || lower.includes('/o3') || /\bo\d\b/.test(lower)) return 'OpenAI';
-  if (lower.includes('claude') || lower.includes('opus') || lower.includes('sonnet') || lower.includes('haiku')) return 'Anthropic';
-  if (lower.includes('gemini')) return 'Google';
-  if (lower.includes('grok') || lower.includes('xai')) return 'xAI';
-  if (lower.includes('llama') || lower.includes('meta-llama') || lower.includes('meta/')) return 'Meta';
-  if (lower.includes('command') || lower.includes('cohere')) return 'Cohere';
-  if (lower.includes('mistral')) return 'Mistral';
-  if (lower.includes('deepseek')) return 'DeepSeek';
-  if (lower.includes('qwen') || lower.includes('alibaba')) return 'Alibaba';
-  if (lower.includes('opencode')) return 'OpenCode';
+  const canonical = canonicalizeModelName(raw);
+  for (const matcher of PROVIDER_MATCHERS) {
+    if (matcher.matcher.test(canonical)) return matcher.provider;
+  }
   return 'Other';
 }
 
@@ -127,7 +237,8 @@ function recalculateDayFromBreakdowns(day, modelBreakdowns) {
     thinkingTokens,
     totalCost,
     requestCount,
-    totalTokens: inputTokens + outputTokens + cacheCreationTokens + cacheReadTokens + thinkingTokens,
+    totalTokens:
+      inputTokens + outputTokens + cacheCreationTokens + cacheReadTokens + thinkingTokens,
     modelsUsed: modelBreakdowns.map((item) => item.modelName),
     modelBreakdowns,
   };
@@ -138,8 +249,12 @@ function filterByProviders(data, selectedProviders) {
   const selected = new Set(selectedProviders);
   return data
     .map((day) => {
-      const filteredBreakdowns = day.modelBreakdowns.filter((entry) => selected.has(getModelProvider(entry.modelName)));
-      return filteredBreakdowns.length > 0 ? recalculateDayFromBreakdowns(day, filteredBreakdowns) : null;
+      const filteredBreakdowns = day.modelBreakdowns.filter((entry) =>
+        selected.has(getModelProvider(entry.modelName)),
+      );
+      return filteredBreakdowns.length > 0
+        ? recalculateDayFromBreakdowns(day, filteredBreakdowns)
+        : null;
     })
     .filter(Boolean);
 }
@@ -149,17 +264,19 @@ function filterByModels(data, selectedModels) {
   const selected = new Set(selectedModels);
   return data
     .map((day) => {
-      const filteredBreakdowns = day.modelBreakdowns.filter((entry) => selected.has(normalizeModelName(entry.modelName)));
-      return filteredBreakdowns.length > 0 ? recalculateDayFromBreakdowns(day, filteredBreakdowns) : null;
+      const filteredBreakdowns = day.modelBreakdowns.filter((entry) =>
+        selected.has(normalizeModelName(entry.modelName)),
+      );
+      return filteredBreakdowns.length > 0
+        ? recalculateDayFromBreakdowns(day, filteredBreakdowns)
+        : null;
     })
     .filter(Boolean);
 }
 
 function aggregateToDailyFormat(data, viewMode) {
   if (viewMode === 'daily') return data;
-  const groupKey = viewMode === 'monthly'
-    ? (date) => date.slice(0, 7)
-    : (date) => date.slice(0, 4);
+  const groupKey = viewMode === 'monthly' ? (date) => date.slice(0, 7) : (date) => date.slice(0, 4);
   const groups = new Map();
 
   for (const day of data) {
@@ -239,7 +356,8 @@ function toWeekdayData(data) {
   }
   return WEEKDAYS.map((label, index) => {
     const values = weekdayCosts[index];
-    const average = values.length > 0 ? values.reduce((sum, value) => sum + value, 0) / values.length : 0;
+    const average =
+      values.length > 0 ? values.reduce((sum, value) => sum + value, 0) / values.length : 0;
     return { day: label, cost: average };
   });
 }
@@ -338,7 +456,8 @@ function computeMetrics(data) {
     totalCacheCreate += day.cacheCreationTokens;
     totalThinking += day.thinkingTokens;
     activeDays += day._aggregatedDays || 1;
-    if (day.requestCount > 0 || day.modelBreakdowns.some((entry) => entry.requestCount > 0)) hasRequestData = true;
+    if (day.requestCount > 0 || day.modelBreakdowns.some((entry) => entry.requestCount > 0))
+      hasRequestData = true;
     if (day.totalCost > topDay.cost) topDay = { date: day.date, cost: day.totalCost };
     if (day.totalCost < cheapestDay.cost) cheapestDay = { date: day.date, cost: day.totalCost };
 
@@ -416,7 +535,12 @@ function computeModelRows(data) {
         _dates: new Set(),
       };
       current.cost += breakdown.cost;
-      current.tokens += breakdown.inputTokens + breakdown.outputTokens + breakdown.cacheCreationTokens + breakdown.cacheReadTokens + breakdown.thinkingTokens;
+      current.tokens +=
+        breakdown.inputTokens +
+        breakdown.outputTokens +
+        breakdown.cacheCreationTokens +
+        breakdown.cacheReadTokens +
+        breakdown.thinkingTokens;
       current.requests += breakdown.requestCount;
       if (!current._dates.has(day.date)) {
         current._dates.add(day.date);
@@ -454,7 +578,12 @@ function computeProviderRows(data) {
         _dates: new Set(),
       };
       current.cost += breakdown.cost;
-      current.tokens += breakdown.inputTokens + breakdown.outputTokens + breakdown.cacheCreationTokens + breakdown.cacheReadTokens + breakdown.thinkingTokens;
+      current.tokens +=
+        breakdown.inputTokens +
+        breakdown.outputTokens +
+        breakdown.cacheCreationTokens +
+        breakdown.cacheReadTokens +
+        breakdown.thinkingTokens;
       current.requests += breakdown.requestCount;
       if (!current._dates.has(day.date)) {
         current._dates.add(day.date);
@@ -464,7 +593,13 @@ function computeProviderRows(data) {
     }
   }
   return Array.from(rows.values())
-    .map(({ _dates, ...entry }) => entry)
+    .map((entry) => ({
+      name: entry.name,
+      cost: entry.cost,
+      tokens: entry.tokens,
+      requests: entry.requests,
+      days: entry.days,
+    }))
     .sort((a, b) => b.cost - a.cost);
 }
 
@@ -491,7 +626,12 @@ function formatDate(dateStr, mode = 'short', language = 'de') {
   }
   const date = new Date(`${dateStr}T00:00:00`);
   if (mode === 'long') {
-    return date.toLocaleDateString(locale, { weekday: 'short', day: '2-digit', month: '2-digit', year: 'numeric' });
+    return date.toLocaleDateString(locale, {
+      weekday: 'short',
+      day: '2-digit',
+      month: '2-digit',
+      year: 'numeric',
+    });
   }
   return date.toLocaleDateString(locale, { day: '2-digit', month: '2-digit' });
 }
@@ -504,7 +644,10 @@ function formatDateAxis(dateStr, language = 'de') {
     const date = new Date(Number(year), Number(month) - 1);
     return date.toLocaleDateString(locale, { month: 'short', year: '2-digit' });
   }
-  return new Date(`${dateStr}T00:00:00`).toLocaleDateString(locale, { day: '2-digit', month: '2-digit' });
+  return new Date(`${dateStr}T00:00:00`).toLocaleDateString(locale, {
+    day: '2-digit',
+    month: '2-digit',
+  });
 }
 
 function formatFilterValue(value, language = 'de') {
@@ -527,16 +670,127 @@ function formatInteger(value, language = 'de') {
   return Math.round(value || 0).toLocaleString(getLocale(language));
 }
 
-function formatCompact(value, language = 'de') {
+function formatPercent(value, language = 'de') {
+  return `${(value || 0).toLocaleString(getLocale(language), {
+    minimumFractionDigits: 1,
+    maximumFractionDigits: 1,
+  })}%`;
+}
+
+function formatCompactNumber(value, language = 'de') {
   if (!Number.isFinite(value)) return '0';
-  if (value >= 1e9) return `${(value / 1e9).toFixed(1)}B`;
-  if (value >= 1e6) return `${(value / 1e6).toFixed(1)}M`;
-  if (value >= 1e3) return `${(value / 1e3).toFixed(1)}k`;
+
+  const abs = Math.abs(value);
+  const locale = getLocale(language);
+
+  if (abs >= 1e9) {
+    const suffix = language === 'en' ? 'B' : ' Mrd.';
+    return `${(value / 1e9).toLocaleString(locale, {
+      minimumFractionDigits: 1,
+      maximumFractionDigits: 1,
+    })}${suffix}`;
+  }
+
+  if (abs >= 1e6) {
+    const suffix = language === 'en' ? 'M' : ' Mio.';
+    return `${(value / 1e6).toLocaleString(locale, {
+      minimumFractionDigits: 1,
+      maximumFractionDigits: 1,
+    })}${suffix}`;
+  }
+
+  if (abs >= 1e3) {
+    const suffix = language === 'en' ? 'k' : ' Tsd.';
+    return `${(value / 1e3).toLocaleString(locale, {
+      minimumFractionDigits: 1,
+      maximumFractionDigits: 1,
+    })}${suffix}`;
+  }
+
   return formatInteger(value, language);
 }
 
-function formatPercent(value) {
-  return `${(value || 0).toFixed(1)}%`;
+function formatCompact(value, language = 'de') {
+  return formatCompactNumber(value, language);
+}
+
+function formatCompactAxis(value, language = 'de') {
+  return formatCompactNumber(value, language);
+}
+
+function summarizeSelection(
+  values,
+  language,
+  { emptyKey, maxVisible = 3, normalize = (value) => value } = {},
+) {
+  const normalized = (values || []).map(normalize).filter(Boolean);
+
+  if (normalized.length === 0) {
+    return translate(language, emptyKey);
+  }
+
+  const visible = normalized.slice(0, maxVisible);
+  const hidden = normalized.length - visible.length;
+  const suffix =
+    hidden > 0 ? ` ${translate(language, 'report.filters.andMore', { count: hidden })}` : '';
+
+  return `${visible.join(', ')}${suffix}`;
+}
+
+function truncateLabel(value, maxLength = 28) {
+  const stringValue = String(value || '');
+  if (stringValue.length <= maxLength) return stringValue;
+  return `${stringValue.slice(0, Math.max(1, maxLength - 1)).trimEnd()}…`;
+}
+
+function buildInsights(metrics, { filteredDaily, filtered, language }) {
+  const insights = [];
+
+  if (filteredDaily.length > 0 && filteredDaily.length < 7) {
+    insights.push({
+      tone: 'warn',
+      title: translate(language, 'report.insights.coverageTitle'),
+      body: translate(language, 'report.insights.coverageBody', {
+        days: formatInteger(filteredDaily.length, language),
+        periods: formatInteger(filtered.length, language),
+      }),
+    });
+  }
+
+  if (metrics.topProvider) {
+    insights.push({
+      tone: metrics.topProvider.share >= 60 ? 'warn' : 'accent',
+      title: translate(language, 'report.insights.providerTitle'),
+      body: translate(language, 'report.insights.providerBody', {
+        provider: metrics.topProvider.name,
+        share: formatPercent(metrics.topProvider.share, language),
+      }),
+    });
+  }
+
+  if (metrics.cacheHitRate > 0) {
+    insights.push({
+      tone: metrics.cacheHitRate >= 20 ? 'good' : 'accent',
+      title: translate(language, 'report.insights.cacheTitle'),
+      body: translate(language, 'report.insights.cacheBody', {
+        share: formatPercent(metrics.cacheHitRate, language),
+      }),
+    });
+  }
+
+  if (metrics.busiestWeek) {
+    insights.push({
+      tone: 'accent',
+      title: translate(language, 'report.insights.peakWindowTitle'),
+      body: translate(language, 'report.insights.peakWindowBody', {
+        start: formatDate(metrics.busiestWeek.start, 'long', language),
+        end: formatDate(metrics.busiestWeek.end, 'long', language),
+        cost: formatCurrency(metrics.busiestWeek.cost, language),
+      }),
+    });
+  }
+
+  return insights.slice(0, 4);
 }
 
 function periodUnit(viewMode, language = 'de') {
@@ -547,7 +801,10 @@ function periodUnit(viewMode, language = 'de') {
 
 function applyReportFilters(allDailyData, filters) {
   const sorted = sortByDate(allDailyData);
-  const preProvider = filterByMonth(filterByDateRange(sorted, filters.startDate, filters.endDate), filters.selectedMonth);
+  const preProvider = filterByMonth(
+    filterByDateRange(sorted, filters.startDate, filters.endDate),
+    filters.selectedMonth,
+  );
   const preModel = filterByProviders(preProvider, filters.selectedProviders || []);
   const filteredDaily = filterByModels(preModel, filters.selectedModels || []);
   const filtered = aggregateToDailyFormat(filteredDaily, filters.viewMode || 'daily');
@@ -573,26 +830,99 @@ function buildReportData(allDailyData, options = {}) {
   const metrics = computeMetrics(filtered);
   const modelRows = computeModelRows(filtered).slice(0, 12);
   const providerRows = computeProviderRows(filtered).slice(0, 8);
-  const recentRows = sortByDate(filtered).slice(-12).reverse().map((entry) => ({
-    period: entry.date,
-    label: formatDate(entry.date, 'long', language),
-    cost: entry.totalCost,
-    costLabel: formatCurrency(entry.totalCost, language),
-    tokens: entry.totalTokens,
-    tokensLabel: formatCompact(entry.totalTokens, language),
-    requests: entry.requestCount,
-    requestsLabel: formatInteger(entry.requestCount, language),
-  }));
+  const periodLabel = periodUnit(filters.viewMode, language);
+  const notAvailable = translate(language, 'report.common.notAvailable');
+  const selectedProvidersLabel = summarizeSelection(filters.selectedProviders, language, {
+    emptyKey: 'report.filters.all',
+  });
+  const selectedModelsLabel = summarizeSelection(filters.selectedModels, language, {
+    emptyKey: 'report.filters.all',
+    normalize: normalizeModelName,
+  });
+  const monthLabel =
+    formatFilterValue(filters.selectedMonth, language) || translate(language, 'report.filters.all');
+  const startDateLabel =
+    formatFilterValue(filters.startDate || null, language) ||
+    translate(language, 'report.filters.noFilter');
+  const endDateLabel =
+    formatFilterValue(filters.endDate || null, language) ||
+    translate(language, 'report.filters.noFilter');
+  const peakPeriodLabel = metrics.topDay
+    ? formatDate(metrics.topDay.date, 'long', language)
+    : notAvailable;
+  const topModelValue = metrics.topModel ? metrics.topModel.name : notAvailable;
+  const topProviderValue = metrics.topProvider ? metrics.topProvider.name : notAvailable;
+  const insights = buildInsights(metrics, { filteredDaily, filtered, language });
+  const avgPeriodCost = filtered.length > 0 ? metrics.totalCost / filtered.length : 0;
+  const recentRows = sortByDate(filtered)
+    .slice(-12)
+    .reverse()
+    .map((entry) => ({
+      period: entry.date,
+      label: formatDate(entry.date, 'long', language),
+      cost: entry.totalCost,
+      costLabel: formatCurrency(entry.totalCost, language),
+      tokens: entry.totalTokens,
+      tokensLabel: formatCompact(entry.totalTokens, language),
+      requests: entry.requestCount,
+      requestsLabel: formatInteger(entry.requestCount, language),
+    }));
 
   const summaryCards = [
-    { label: translate(language, 'common.costs'), value: formatCurrency(metrics.totalCost, language), note: metrics.topProvider ? `${metrics.topProvider.name} ${formatPercent(metrics.topProvider.share)}` : 'n/a', tone: 'accent' },
-    { label: translate(language, 'common.tokens'), value: formatCompact(metrics.totalTokens, language), note: `CPM ${formatCurrency(metrics.costPerMillion, language)}`, tone: 'accent' },
-    { label: translate(language, 'common.requests'), value: formatInteger(metrics.totalRequests, language), note: metrics.hasRequestData ? `${formatPercent(metrics.cacheHitRate)} Cache` : 'n/a', tone: 'good' },
-    { label: `Ø ${translate(language, 'common.cost')} / ${periodUnit(filters.viewMode, language)}`, value: formatCurrency(metrics.avgDailyCost, language), note: `${reportDataLabel(filters.viewMode, language)}`, tone: 'accent' },
-    { label: translate(language, 'common.model'), value: metrics.topModel ? metrics.topModel.name : 'n/a', note: metrics.topModel ? formatPercent(metrics.topModelShare) : 'n/a', tone: 'warn' },
-    { label: translate(language, 'common.dateRange'), value: metrics.topDay ? metrics.topDay.date : 'n/a', note: metrics.topDay ? formatCurrency(metrics.topDay.cost, language) : 'n/a', tone: 'warn' },
+    {
+      label: translate(language, 'common.costs'),
+      value: formatCurrency(metrics.totalCost, language),
+      note: metrics.topProvider
+        ? `${metrics.topProvider.name} ${formatPercent(metrics.topProvider.share, language)}`
+        : notAvailable,
+      tone: 'accent',
+    },
+    {
+      label: translate(language, 'common.tokens'),
+      value: formatCompact(metrics.totalTokens, language),
+      note: `CPM ${formatCurrency(metrics.costPerMillion, language)}`,
+      tone: 'accent',
+    },
+    {
+      label: translate(language, 'common.requests'),
+      value: formatInteger(metrics.totalRequests, language),
+      note: metrics.hasRequestData
+        ? `${formatPercent(metrics.cacheHitRate, language)} Cache`
+        : notAvailable,
+      tone: 'good',
+    },
+    {
+      label: `Ø ${translate(language, 'common.cost')} / ${periodLabel}`,
+      value: formatCurrency(avgPeriodCost, language),
+      note: `${reportDataLabel(filters.viewMode, language)}`,
+      tone: 'accent',
+    },
+    {
+      label: translate(language, 'common.model'),
+      value: topModelValue,
+      note: metrics.topModel ? formatPercent(metrics.topModelShare, language) : notAvailable,
+      tone: 'warn',
+    },
+    {
+      label: translate(language, 'report.summary.peakPeriod'),
+      value: peakPeriodLabel,
+      note: metrics.topDay ? formatCurrency(metrics.topDay.cost, language) : notAvailable,
+      tone: 'warn',
+    },
   ];
 
+  const interpretationSummary = translate(language, 'report.interpretation.summary', {
+    days: formatInteger(filteredDaily.length, language),
+    periods: formatInteger(filtered.length, language),
+    peak: peakPeriodLabel,
+    topModel: topModelValue,
+    topProvider: topProviderValue,
+  });
+
+  const interpretationFooter = translate(language, 'report.interpretation.footer', {
+    version: APP_VERSION,
+  });
+
   return {
     meta: {
       language,
@@ -607,20 +937,23 @@ function buildReportData(allDailyData, options = {}) {
       }),
       reportTitle: options.reportTitle || translate(language, 'report.title'),
       filterSummary: {
+        viewModeKey: filters.viewMode,
         viewMode: translate(language, `viewModes.${filters.viewMode}`),
         selectedMonth: filters.selectedMonth,
-        selectedMonthLabel: formatFilterValue(filters.selectedMonth, language),
+        selectedMonthLabel: monthLabel,
         selectedProviders: filters.selectedProviders,
+        selectedProvidersLabel,
         selectedModels: filters.selectedModels,
+        selectedModelsLabel,
         startDate: filters.startDate || null,
-        startDateLabel: formatFilterValue(filters.startDate || null, language),
+        startDateLabel,
         endDate: filters.endDate || null,
-        endDateLabel: formatFilterValue(filters.endDate || null, language),
+        endDateLabel,
       },
       dateRange,
       periods: filtered.length,
       days: filteredDaily.length,
-      periodUnit: periodUnit(filters.viewMode, language),
+      periodUnit: periodLabel,
     },
     metrics,
     summaryCards,
@@ -643,13 +976,69 @@ function buildReportData(allDailyData, options = {}) {
     })),
     recentPeriods: recentRows,
     labels: {
-      dateRangeText: dateRange ? `${formatDate(dateRange.start, 'long', language)} - ${formatDate(dateRange.end, 'long', language)}` : translate(language, 'common.noData'),
-      topModel: metrics.topModel ? `${metrics.topModel.name} (${metrics.topModelShare.toFixed(1)}%)` : 'n/a',
-      topProvider: metrics.topProvider ? `${metrics.topProvider.name} (${metrics.topProvider.share.toFixed(1)}%)` : 'n/a',
-      topDay: metrics.topDay ? `${formatDate(metrics.topDay.date, 'long', language)} (${metrics.topDay.cost.toFixed(2)} USD)` : 'n/a',
+      dateRangeText: dateRange
+        ? `${formatDate(dateRange.start, 'long', language)} - ${formatDate(dateRange.end, 'long', language)}`
+        : translate(language, 'common.noData'),
+      topModel: metrics.topModel
+        ? `${metrics.topModel.name} (${formatPercent(metrics.topModelShare, language)})`
+        : notAvailable,
+      topProvider: metrics.topProvider
+        ? `${metrics.topProvider.name} (${formatPercent(metrics.topProvider.share, language)})`
+        : notAvailable,
+      topDay: metrics.topDay
+        ? `${formatDate(metrics.topDay.date, 'long', language)} (${formatCurrency(metrics.topDay.cost, language)})`
+        : notAvailable,
+    },
+    interpretation: {
+      summary: interpretationSummary,
+      footer: interpretationFooter,
+    },
+    insights: {
+      items: insights,
+    },
+    text: {
+      headerEyebrow: translate(language, 'report.header.eyebrow'),
+      sections: {
+        overview: translate(language, 'report.sections.overview'),
+        insights: translate(language, 'report.sections.insights'),
+        filters: translate(language, 'report.sections.filters'),
+        modelsProviders: translate(language, 'report.sections.modelsProviders'),
+        recentPeriods: translate(language, 'report.sections.recentPeriods'),
+        interpretation: translate(language, 'report.sections.interpretation'),
+      },
+      fields: {
+        dateRange: translate(language, 'report.fields.dateRange'),
+        view: translate(language, 'report.fields.view'),
+        generated: translate(language, 'report.fields.generated'),
+        month: translate(language, 'report.fields.month'),
+        selectedProviders: translate(language, 'report.fields.selectedProviders'),
+        selectedModels: translate(language, 'report.fields.selectedModels'),
+        startDate: translate(language, 'report.fields.startDate'),
+        endDate: translate(language, 'report.fields.endDate'),
+      },
+      tables: {
+        topModels: translate(language, 'report.tables.topModels'),
+        providers: translate(language, 'report.tables.providers'),
+        columns: {
+          model: translate(language, 'report.tables.columns.model'),
+          provider: translate(language, 'report.tables.columns.provider'),
+          cost: translate(language, 'report.tables.columns.cost'),
+          tokens: translate(language, 'report.tables.columns.tokens'),
+          requests: translate(language, 'report.tables.columns.requests'),
+          period: translate(language, 'report.tables.columns.period'),
+        },
+      },
+      charts: {
+        costTrend: translate(language, 'report.charts.costTrend'),
+        topModels: translate(language, 'report.charts.topModels'),
+        tokenTrend: translate(language, 'report.charts.tokenTrend'),
+      },
     },
     formatting: {
-      axisDates: filtered.map((entry) => ({ date: entry.date, label: formatDateAxis(entry.date, language) })),
+      axisDates: filtered.map((entry) => ({
+        date: entry.date,
+        label: formatDateAxis(entry.date, language),
+      })),
     },
   };
 }
@@ -668,7 +1057,15 @@ function reportDataLabel(viewMode, language = 'de') {
 module.exports = {
   applyReportFilters,
   buildReportData,
+  formatCompact,
+  formatCompactAxis,
+  formatCurrency,
   formatDate,
   formatDateAxis,
   getModelColor,
+  truncateLabel,
+  __test__: {
+    getModelProvider,
+    normalizeModelName,
+  },
 };