Function _cmd_stats

uncommon_route/cli.py:1397–1525

(args: list[str])

def _cmd_stats(args: list[str]) -> None:
    from uncommon_route.stats import RouteStats

    rs = RouteStats()
    if not args:
        args = ["summary"]
    sub = args[0]

    if sub == "summary":
        s = rs.summary()
        if s.total_requests == 0:
            print("  No routing data recorded yet.")
            print("  Start the proxy with `uncommon-route serve` and send requests.")
            return
        hours = s.time_range_s / 3600
        print(f"\n  Routing Statistics ({hours:.1f}h window, {s.total_requests} requests)")
        print(f"  {'─' * 50}")
        print(f"  Avg confidence: {s.avg_confidence:.2f}")
        print(f"  Avg savings:    {s.avg_savings:.0%}")
        print(f"  Avg latency:    {s.avg_latency_us / 1000.0:.3f}ms")
        print(f"  Avg reduction:  {s.avg_input_reduction_ratio:.0%}")
        print(f"  Avg cache hit:  {s.avg_cache_hit_ratio:.0%}")
        print(f"  Total cost:     ${s.total_actual_cost:.4f} (estimated: ${s.total_estimated_cost:.4f})")
        print(
            f"  Input tokens:   {s.total_input_tokens_before} -> {s.total_input_tokens_after}"
            f"  | artifacts: {s.total_artifacts_created}"
            f"  | compacted: {s.total_compacted_messages}"
        )
        print(
            f"  Upstream usage: in {s.total_usage_input_tokens}"
            f"  | out {s.total_usage_output_tokens}"
            f"  | cache-read {s.total_cache_read_input_tokens}"
            f"  | cache-write {s.total_cache_write_input_tokens}"
            f"  | breakpoints {s.total_cache_breakpoints}"
        )
        print(
            f"  Semantic:       calls {s.total_semantic_calls}"
            f"  | summaries {s.total_semantic_summaries}"
            f"  | checkpoints {s.total_checkpoints_created}"
            f"  | rehydrated {s.total_rehydrated_artifacts}"
            f"  | failures {s.total_semantic_failures}"
            f"  | quality-fallbacks {s.total_semantic_quality_fallbacks}"
        )

        if s.by_tier:
            print("\n  By Tier:")
            for tier in ("SIMPLE", "MEDIUM", "COMPLEX"):
                ts = s.by_tier.get(tier)
                if not ts:
                    continue
                pct = ts.count / s.total_requests * 100
                print(
                    f"    {tier:<10} │ {ts.count:>5} ({pct:4.1f}%)"
                    f"  │ conf: {ts.avg_confidence:.2f}"
                    f"  │ savings: {ts.avg_savings:.0%}"
                    f"  │ ${ts.total_cost:.4f}"
                )