desktop/src-tauri/crates/core/src/metrics.rs

Comment 1, line 1

//! Statistics: sum exclusive input buckets, calculate cache ratios, aggregate and diagnose contradictions.

//! input_total sums three exclusive input buckets; total_tokens = input_total + output_total.

//! cache_input_ratio = SUM(cache_read) / SUM(input_total), restricted to records with both fields known.

/// Mathematical contradiction metadata: code, field and numeric explanation without conversation bodies.

/// Sum known values without overflow; any unknown component makes the complete sum unknown.

/// input_total sums three known exclusive buckets; otherwise use the existing total, or None.

/// The second result component describes field quality.

/// Sum known input_total/output_total; otherwise retain usage.total_tokens and its quality.

/// Domain validation rejects negatives. Diagnose contradictions such as cache exceeding input;

/// do not hide them by replacing negative results with max(0, ...).

/// Exact integer numerator/denominator; None for a zero denominator or no valid samples (display —).

/// Cache-input ratio over records with known input_total and input_cache_read.

/// Return (ratio, valid record count); ratio is None without valid samples or with a zero denominator.