@da-trollefsen/claude-wrapped 1.0.0

package/claude_code_wrapped/ui.py

@@ -0,0 +1,782 @@
+"""Rich-based terminal UI for Claude Code Wrapped."""
+
+import sys
+import time
+from datetime import datetime, timedelta
+
+from rich.align import Align
+from rich.console import Console, Group
+from rich.live import Live
+from rich.panel import Panel
+from rich.progress import BarColumn, Progress, SpinnerColumn, TextColumn
+from rich.style import Style
+from rich.table import Table
+from rich.text import Text
+
+from .stats import WrappedStats, format_tokens
+
+# Minimal color palette
+COLORS = {
+    "orange": "#E67E22",
+    "purple": "#9B59B6",
+    "blue": "#3498DB",
+    "green": "#27AE60",
+    "white": "#ECF0F1",
+    "gray": "#7F8C8D",
+    "dark": "#2C3E50",
+}
+
+# GitHub-style contribution colors (light to dark green)
+CONTRIB_COLORS = ["#161B22", "#0E4429", "#006D32", "#26A641", "#39D353"]
+
+
+def wait_for_keypress():
+    """Wait for user to press Enter."""
+    input()
+    return '\n'
+
+
+def format_year_display(year: int | None) -> str:
+    """Format year for display - returns 'All time' if year is None."""
+    return "All time" if year is None else str(year)
+
+
+def create_dramatic_stat(value: str, label: str, subtitle: str = "", color: str = COLORS["orange"], extra_lines: list[tuple[str, str]] = None) -> Text:
+    """Create a dramatic full-screen stat reveal."""
+    text = Text()
+    text.append("\n\n\n\n\n")
+    text.append(f"{value}\n", style=Style(color=color, bold=True))
+    text.append(f"{label}\n\n", style=Style(color=COLORS["white"], bold=True))
+    if subtitle:
+        text.append(subtitle, style=Style(color=COLORS["gray"]))
+    if extra_lines:
+        text.append("\n\n")
+        for line, line_color in extra_lines:
+            text.append(f"{line}\n", style=Style(color=line_color))
+    text.append("\n\n\n\n")
+    text.append("press [ENTER] to continue", style=Style(color=COLORS["dark"]))
+    return text
+
+
+def create_title_slide(year: int | None) -> Text:
+    """Create the opening title."""
+    title = Text()
+    title.append("\n\n\n")
+    title.append("  ░█████╗░██╗░░░░░░█████╗░██╗░░░██╗██████╗░███████╗\n", style="#C96442")
+    title.append("  ██╔══██╗██║░░░░░██╔══██╗██║░░░██║██╔══██╗██╔════╝\n", style="#C96442")
+    title.append("  ██║░░╚═╝██║░░░░░███████║██║░░░██║██║░░██║█████╗░░\n", style="#C96442")
+    title.append("  ██║░░██╗██║░░░░░██╔══██║██║░░░██║██║░░██║██╔══╝░░\n", style="#C96442")
+    title.append("  ╚█████╔╝███████╗██║░░██║╚██████╔╝██████╔╝███████╗\n", style="#C96442")
+    title.append("  ░╚════╝░╚══════╝╚═╝░░╚═╝░╚═════╝░╚═════╝░╚══════╝\n", style="#C96442")
+    title.append("\n")
+    title.append("              C O D E   W R A P P E D\n", style=Style(color=COLORS["white"], bold=True))
+    year_display = format_year_display(year)
+    title.append(f"                    {year_display}\n\n", style=Style(color=COLORS["purple"], bold=True))
+    title.append("                   by ", style=Style(color=COLORS["gray"]))
+    title.append("Trollefsen", style=Style(color=COLORS["blue"], bold=True, link="https://github.com/da-troll"))
+    title.append("\n\n\n")
+    title.append("               press [ENTER] to begin", style=Style(color=COLORS["dark"]))
+    title.append("\n\n")
+    return title
+
+
+def create_big_stat(value: str, label: str, color: str = COLORS["orange"]) -> Text:
+    """Create a big statistic display."""
+    text = Text()
+    text.append(f"{value}\n", style=Style(color=color, bold=True))
+    text.append(label, style=Style(color=COLORS["gray"]))
+    return text
+
+
+def create_contribution_graph(daily_stats: dict, year: int | None) -> Panel:
+    """Create a GitHub-style contribution graph for the full year or all-time."""
+    if not daily_stats:
+        return Panel("No activity data", title="Activity", border_style=COLORS["gray"])
+
+    # Calculate date range
+    if year is None:
+        # All-time: use actual date range from daily_stats
+        dates = [datetime.strptime(d, "%Y-%m-%d") for d in daily_stats.keys()]
+        start_date = min(dates) if dates else datetime.now()
+        end_date = max(dates) if dates else datetime.now()
+    else:
+        # Always show full year: Jan 1 to Dec 31 (or today if current year)
+        start_date = datetime(year, 1, 1)
+        today = datetime.now()
+        if year == today.year:
+            end_date = today
+        else:
+            end_date = datetime(year, 12, 31)
+
+    max_count = max(s.message_count for s in daily_stats.values()) if daily_stats else 1
+
+    weeks = []
+    current = start_date - timedelta(days=start_date.weekday())
+
+    while current <= end_date + timedelta(days=7):
+        week = []
+        for day in range(7):
+            date = current + timedelta(days=day)
+            date_str = date.strftime("%Y-%m-%d")
+            if date_str in daily_stats:
+                count = daily_stats[date_str].message_count
+                level = min(4, 1 + int((count / max_count) * 3)) if count > 0 else 0
+            else:
+                level = 0
+            week.append(level)
+        weeks.append(week)
+        current += timedelta(days=7)
+
+    graph = Text()
+    days_labels = ["Mon", "   ", "Wed", "   ", "Fri", "   ", "   "]
+
+    for row in range(7):
+        graph.append(f"{days_labels[row]} ", style=Style(color=COLORS["gray"]))
+        for week in weeks:
+            color = CONTRIB_COLORS[week[row]]
+            graph.append("■ ", style=Style(color=color))
+        graph.append("\n")
+
+    legend = Text()
+    legend.append("\n     Less ", style=Style(color=COLORS["gray"]))
+    for color in CONTRIB_COLORS:
+        legend.append("■ ", style=Style(color=color))
+    legend.append("More", style=Style(color=COLORS["gray"]))
+
+    content = Group(graph, Align.center(legend))
+
+    # Calculate total days for context
+    today = datetime.now()
+    if year is None:
+        # All-time: calculate total days from date range
+        total_days = (end_date - start_date).days + 1
+    elif year == today.year:
+        total_days = (today - datetime(year, 1, 1)).days + 1
+    else:
+        total_days = 366 if year % 4 == 0 else 365
+    active_count = len([d for d in daily_stats.values() if d.message_count > 0])
+
+    return Panel(
+        Align.center(content),
+        title=f"Activity · {active_count} of {total_days} days",
+        border_style=Style(color=COLORS["green"]),
+        padding=(0, 2),
+    )
+
+
+def create_hour_chart(distribution: list[int]) -> Panel:
+    """Create a clean hourly distribution chart."""
+    max_val = max(distribution) if any(distribution) else 1
+    chars = "▁▂▃▄▅▆▇█"
+
+    content = Text()
+    for i, val in enumerate(distribution):
+        idx = int((val / max_val) * (len(chars) - 1)) if max_val > 0 else 0
+        if 6 <= i < 12:
+            color = COLORS["orange"]
+        elif 12 <= i < 18:
+            color = COLORS["blue"]
+        elif 18 <= i < 24:
+            color = COLORS["purple"]
+        else:
+            color = COLORS["gray"]
+        content.append(chars[idx], style=Style(color=color))
+
+    # Build aligned label (24 chars to match 24 bars)
+    # Labels at positions: 0, 6, 12, 18, with end marker
+    content.append("\n")
+    content.append("0     6     12    18    24", style=Style(color=COLORS["gray"]))
+
+    return Panel(
+        Align.center(content),
+        title="Hours",
+        border_style=Style(color=COLORS["purple"]),
+        padding=(0, 1),
+    )
+
+
+def create_weekday_chart(distribution: list[int]) -> Panel:
+    """Create a clean weekday distribution chart."""
+    days = ["Mon", "Tue", "Wed", "Thu", "Fri", "Sat", "Sun"]
+    max_val = max(distribution) if any(distribution) else 1
+
+    content = Text()
+    for i, (day, count) in enumerate(zip(days, distribution)):
+        bar_len = int((count / max_val) * 12) if max_val > 0 else 0
+        bar = "█" * bar_len + "░" * (12 - bar_len)
+        content.append(f"{day} ", style=Style(color=COLORS["gray"]))
+        content.append(bar, style=Style(color=COLORS["blue"]))
+        content.append(f" {count:,}\n", style=Style(color=COLORS["gray"]))
+
+    return Panel(
+        content,
+        title="Days",
+        border_style=Style(color=COLORS["blue"]),
+        padding=(0, 1),
+    )
+
+
+def create_top_list(items: list[tuple[str, int]], title: str, color: str) -> Panel:
+    """Create a clean top items list."""
+    content = Text()
+    max_val = max(v for _, v in items) if items else 1
+
+    for i, (name, count) in enumerate(items[:5], 1):
+        content.append(f"{i}. ", style=Style(color=COLORS["gray"]))
+        content.append(f"{name[:12]:<12} ", style=Style(color=COLORS["white"]))
+        bar_len = int((count / max_val) * 8)
+        content.append("▓" * bar_len, style=Style(color=color))
+        content.append("░" * (8 - bar_len), style=Style(color=COLORS["dark"]))
+        content.append(f" {count:,}\n", style=Style(color=COLORS["gray"]))
+
+    return Panel(
+        content,
+        title=title,
+        border_style=Style(color=color),
+        padding=(0, 1),
+    )
+
+
+def create_personality_card(stats: WrappedStats) -> Panel:
+    """Create the personality card."""
+    personality = determine_personality(stats)
+
+    content = Text()
+    content.append(f"\n  {personality['emoji']}  ", style=Style(bold=True))
+    content.append(f"{personality['title']}\n\n", style=Style(color=COLORS["purple"], bold=True))
+    content.append(f"  {personality['description']}\n", style=Style(color=COLORS["gray"]))
+
+    return Panel(
+        content,
+        title="Your Type",
+        border_style=Style(color=COLORS["purple"]),
+        padding=(0, 1),
+    )
+
+
+def determine_personality(stats: WrappedStats) -> dict:
+    """Determine user's coding personality based on stats."""
+    night_hours = sum(stats.hourly_distribution[22:]) + sum(stats.hourly_distribution[:6])
+    day_hours = sum(stats.hourly_distribution[6:22])
+    top_tool = stats.top_tools[0][0] if stats.top_tools else None
+    weekend_msgs = stats.weekday_distribution[5] + stats.weekday_distribution[6]
+    weekday_msgs = sum(stats.weekday_distribution[:5])
+
+    if night_hours > day_hours * 0.4:
+        return {"emoji": "🦉", "title": "Night Owl", "description": "The quiet hours are your sanctuary."}
+    elif stats.streak_longest >= 14:
+        return {"emoji": "🔥", "title": "Streak Master", "description": f"{stats.streak_longest} days. Unstoppable."}
+    elif top_tool == "Edit":
+        return {"emoji": "🎨", "title": "The Refactorer", "description": "You see beauty in clean code."}
+    elif top_tool == "Bash":
+        return {"emoji": "⚡", "title": "Terminal Warrior", "description": "Command line is your domain."}
+    elif stats.total_projects >= 5:
+        return {"emoji": "🚀", "title": "Empire Builder", "description": f"{stats.total_projects} projects. Legend."}
+    elif weekend_msgs > weekday_msgs * 0.5:
+        return {"emoji": "🌙", "title": "Weekend Warrior", "description": "Passion fuels your weekends."}
+    elif stats.models_used.get("Opus", 0) > stats.models_used.get("Sonnet", 0):
+        return {"emoji": "🎯", "title": "Perfectionist", "description": "Only the best will do."}
+    else:
+        return {"emoji": "💻", "title": "Dedicated Dev", "description": "Steady and reliable."}
+
+
+def get_fun_facts(stats: WrappedStats) -> list[tuple[str, str]]:
+    """Generate fun facts / bloopers based on stats - only 3 key facts."""
+    facts = []
+
+    # Late night coding days (midnight to 5am)
+    if stats.late_night_days > 0:
+        facts.append(("🌙", f"You coded after midnight on {stats.late_night_days} days. Sleep is overrated."))
+
+    # Most active day insight
+    if stats.most_active_day:
+        day_name = stats.most_active_day[0].strftime("%A")
+        facts.append(("📅", f"Your biggest day was a {day_name}. {stats.most_active_day[1]:,} messages. Epic."))
+
+    # Streak fact
+    if stats.streak_longest >= 1:
+        facts.append(("🔥", f"Your {stats.streak_longest}-day streak was legendary. Consistency wins."))
+
+    return facts
+
+
+def create_fun_facts_slide(facts: list[tuple[str, str]]) -> Text:
+    """Create a fun facts slide."""
+    text = Text()
+    text.append("\n\n")
+    text.append("  B L O O P E R S  &  F U N  F A C T S\n\n", style=Style(color=COLORS["purple"], bold=True))
+
+    for emoji, fact in facts:
+        text.append(f"    {emoji}  ", style=Style(bold=True))
+        text.append(f"{fact}\n\n", style=Style(color=COLORS["white"]))
+
+    text.append("\n")
+    text.append("    press [ENTER] for credits", style=Style(color=COLORS["dark"]))
+    text.append("\n")
+    return text
+
+
+def simplify_model_name(model: str) -> str:
+    """Simplify a full model ID to a display name."""
+    model_lower = model.lower()
+    if 'opus-4-5' in model_lower or 'opus-4.5' in model_lower:
+        return 'Opus 4.5'
+    elif 'opus-4-1' in model_lower or 'opus-4.1' in model_lower:
+        return 'Opus 4.1'
+    elif 'opus' in model_lower:
+        return 'Opus'
+    elif 'sonnet-4-5' in model_lower or 'sonnet-4.5' in model_lower:
+        return 'Sonnet 4.5'
+    elif 'sonnet' in model_lower:
+        return 'Sonnet'
+    elif 'haiku-4-5' in model_lower or 'haiku-4.5' in model_lower:
+        return 'Haiku 4.5'
+    elif 'haiku' in model_lower:
+        return 'Haiku'
+    return model
+
+
+def create_monthly_cost_table(stats: WrappedStats) -> Panel:
+    """Create a monthly cost breakdown table like ccusage."""
+    from .pricing import format_cost
+
+    table = Table(
+        show_header=True,
+        header_style=Style(color=COLORS["white"], bold=True),
+        border_style=Style(color=COLORS["dark"]),
+        box=None,
+        padding=(0, 1),
+    )
+
+    table.add_column("Month", style=Style(color=COLORS["gray"]))
+    table.add_column("Input", justify="right", style=Style(color=COLORS["blue"]))
+    table.add_column("Output", justify="right", style=Style(color=COLORS["orange"]))
+    table.add_column("Cache", justify="right", style=Style(color=COLORS["purple"]))
+    table.add_column("Cost", justify="right", style=Style(color=COLORS["green"], bold=True))
+
+    # Sort months chronologically
+    sorted_months = sorted(stats.monthly_costs.keys())
+
+    for month_key in sorted_months:
+        cost = stats.monthly_costs.get(month_key, 0)
+        tokens = stats.monthly_tokens.get(month_key, {})
+
+        # Format month name
+        try:
+            month_date = datetime.strptime(month_key, "%Y-%m")
+            month_name = month_date.strftime("%b %Y")
+        except ValueError:
+            month_name = month_key
+
+        input_tokens = tokens.get("input", 0)
+        output_tokens = tokens.get("output", 0)
+        cache_tokens = tokens.get("cache_create", 0) + tokens.get("cache_read", 0)
+
+        table.add_row(
+            month_name,
+            format_tokens(input_tokens),
+            format_tokens(output_tokens),
+            format_tokens(cache_tokens),
+            format_cost(cost),
+        )
+
+    # Add total row
+    if sorted_months:
+        table.add_row("", "", "", "", "")  # Separator
+        table.add_row(
+            "Total",
+            format_tokens(stats.total_input_tokens),
+            format_tokens(stats.total_output_tokens),
+            format_tokens(stats.total_cache_creation_tokens + stats.total_cache_read_tokens),
+            format_cost(stats.estimated_cost) if stats.estimated_cost else "N/A",
+            style=Style(bold=True),
+        )
+
+    return Panel(
+        table,
+        title="Monthly Cost Breakdown",
+        border_style=Style(color=COLORS["green"]),
+        padding=(0, 1),
+    )
+
+
+def create_credits_roll(stats: WrappedStats) -> list[Text]:
+    """Create end credits content."""
+    from .pricing import format_cost
+
+    frames = []
+
+    # Aggregate costs by simplified model name for display
+    display_costs: dict[str, float] = {}
+    for model, cost in stats.cost_by_model.items():
+        display_name = simplify_model_name(model)
+        display_costs[display_name] = display_costs.get(display_name, 0) + cost
+
+    # Frame 1: The Numbers (cost + tokens)
+    numbers = Text()
+    numbers.append("\n\n\n")
+    numbers.append("              T H E   N U M B E R S\n\n", style=Style(color=COLORS["green"], bold=True))
+    if stats.estimated_cost is not None:
+        numbers.append(f"              Estimated Cost  ", style=Style(color=COLORS["white"], bold=True))
+        numbers.append(f"{format_cost(stats.estimated_cost)}\n", style=Style(color=COLORS["green"], bold=True))
+        for model, cost in sorted(display_costs.items(), key=lambda x: -x[1]):
+            numbers.append(f"                {model}: {format_cost(cost)}\n", style=Style(color=COLORS["gray"]))
+    numbers.append(f"\n              Tokens  ", style=Style(color=COLORS["white"], bold=True))
+    numbers.append(f"{format_tokens(stats.total_tokens)}\n", style=Style(color=COLORS["orange"], bold=True))
+    numbers.append(f"                Input: {format_tokens(stats.total_input_tokens)}\n", style=Style(color=COLORS["gray"]))
+    numbers.append(f"                Output: {format_tokens(stats.total_output_tokens)}\n", style=Style(color=COLORS["gray"]))
+    numbers.append("\n\n")
+    numbers.append("    [ENTER]", style=Style(color=COLORS["dark"]))
+    frames.append(numbers)
+
+    # Frame 2: Timeline (full year context)
+    timeline = Text()
+    timeline.append("\n\n\n")
+    timeline.append("              T I M E L I N E\n\n", style=Style(color=COLORS["orange"], bold=True))
+    timeline.append("              Period         ", style=Style(color=COLORS["white"], bold=True))
+    # Use sentence case for "All time" in timeline
+    period_text = "All time" if stats.year is None else str(stats.year)
+    timeline.append(f"{period_text}\n", style=Style(color=COLORS["orange"], bold=True))
+    if stats.first_message_date:
+        timeline.append("              Journey started ", style=Style(color=COLORS["white"], bold=True))
+        timeline.append(f"{stats.first_message_date.strftime('%B %d, %Y')}\n", style=Style(color=COLORS["gray"]))
+    # Calculate total days
+    today = datetime.now()
+    if stats.year is None:
+        # All-time: calculate days from first to last message
+        if stats.first_message_date and stats.last_message_date:
+            total_days = (stats.last_message_date - stats.first_message_date).days + 1
+        else:
+            total_days = stats.active_days
+    elif stats.year == today.year:
+        total_days = (today - datetime(stats.year, 1, 1)).days + 1
+    else:
+        total_days = 366 if stats.year % 4 == 0 else 365
+    timeline.append(f"\n              Active days    ", style=Style(color=COLORS["white"], bold=True))
+    timeline.append(f"{stats.active_days}", style=Style(color=COLORS["orange"], bold=True))
+    timeline.append(f" of {total_days}\n", style=Style(color=COLORS["gray"]))
+    if stats.most_active_hour is not None:
+        hour_label = "AM" if stats.most_active_hour < 12 else "PM"
+        hour_12 = stats.most_active_hour % 12 or 12
+        timeline.append(f"              Peak hour      ", style=Style(color=COLORS["white"], bold=True))
+        timeline.append(f"{hour_12}:00 {hour_label}\n", style=Style(color=COLORS["purple"], bold=True))
+    timeline.append("\n\n")
+    timeline.append("    [ENTER]", style=Style(color=COLORS["dark"]))
+    frames.append(timeline)
+
+    # Frame 3: Averages
+    from .pricing import format_cost
+    averages = Text()
+    averages.append("\n\n\n")
+    averages.append("              A V E R A G E S\n\n", style=Style(color=COLORS["blue"], bold=True))
+    averages.append("              Messages\n", style=Style(color=COLORS["white"], bold=True))
+    averages.append(f"                Per day:   {stats.avg_messages_per_day:.1f}\n", style=Style(color=COLORS["gray"]))
+    averages.append(f"                Per week:  {stats.avg_messages_per_week:.1f}\n", style=Style(color=COLORS["gray"]))
+    averages.append(f"                Per month: {stats.avg_messages_per_month:.1f}\n", style=Style(color=COLORS["gray"]))
+    if stats.estimated_cost is not None:
+        averages.append("\n              Cost\n", style=Style(color=COLORS["white"], bold=True))
+        averages.append(f"                Per day:   {format_cost(stats.avg_cost_per_day)}\n", style=Style(color=COLORS["gray"]))
+        averages.append(f"                Per week:  {format_cost(stats.avg_cost_per_week)}\n", style=Style(color=COLORS["gray"]))
+        averages.append(f"                Per month: {format_cost(stats.avg_cost_per_month)}\n", style=Style(color=COLORS["gray"]))
+    averages.append("\n\n")
+    averages.append("    [ENTER]", style=Style(color=COLORS["dark"]))
+    frames.append(averages)
+
+    # Frame 4: Longest Streak (if significant)
+    if stats.streak_longest >= 3 and stats.streak_longest_start and stats.streak_longest_end:
+        streak = Text()
+        streak.append("\n\n\n")
+        streak.append("              L O N G E S T   S T R E A K\n\n", style=Style(color=COLORS["blue"], bold=True))
+        streak.append(f"              {stats.streak_longest}", style=Style(color=COLORS["blue"], bold=True))
+        streak.append(" days of consistent coding\n\n", style=Style(color=COLORS["white"], bold=True))
+        streak.append(f"              From  ", style=Style(color=COLORS["white"], bold=True))
+        streak.append(f"{stats.streak_longest_start.strftime('%B %d, %Y')}\n", style=Style(color=COLORS["gray"]))
+        streak.append(f"              To    ", style=Style(color=COLORS["white"], bold=True))
+        streak.append(f"{stats.streak_longest_end.strftime('%B %d, %Y')}\n", style=Style(color=COLORS["gray"]))
+        streak.append("\n              Consistency is the key to mastery.\n", style=Style(color=COLORS["gray"]))
+        if stats.streak_current > 0:
+            streak.append(f"\n              Current streak: {stats.streak_current} days\n", style=Style(color=COLORS["gray"]))
+        streak.append("\n\n")
+        streak.append("    [ENTER]", style=Style(color=COLORS["dark"]))
+        frames.append(streak)
+
+    # Frame 5: Longest Conversation
+    if stats.longest_conversation_messages > 0:
+        longest = Text()
+        longest.append("\n\n\n")
+        longest.append("              L O N G E S T   C O N V E R S A T I O N\n\n", style=Style(color=COLORS["purple"], bold=True))
+        longest.append(f"              Messages  ", style=Style(color=COLORS["white"], bold=True))
+        longest.append(f"{stats.longest_conversation_messages:,}\n", style=Style(color=COLORS["purple"], bold=True))
+        if stats.longest_conversation_tokens > 0:
+            longest.append(f"              Tokens    ", style=Style(color=COLORS["white"], bold=True))
+            longest.append(f"{format_tokens(stats.longest_conversation_tokens)}\n", style=Style(color=COLORS["orange"], bold=True))
+        if stats.longest_conversation_date:
+            longest.append(f"              Date      ", style=Style(color=COLORS["white"], bold=True))
+            longest.append(f"{stats.longest_conversation_date.strftime('%B %d, %Y')}\n", style=Style(color=COLORS["gray"]))
+        longest.append("\n              That's one epic coding session!\n", style=Style(color=COLORS["gray"]))
+        longest.append("\n\n")
+        longest.append("    [ENTER]", style=Style(color=COLORS["dark"]))
+        frames.append(longest)
+
+    # Frame 6: Cast (models)
+    cast = Text()
+    cast.append("\n\n\n")
+    cast.append("              S T A R R I N G\n\n", style=Style(color=COLORS["purple"], bold=True))
+    for model, count in stats.models_used.most_common(3):
+        cast.append(f"              Claude {model}", style=Style(color=COLORS["white"], bold=True))
+        cast.append(f"  ({count:,} messages)\n", style=Style(color=COLORS["gray"]))
+    cast.append("\n\n\n")
+    cast.append("    [ENTER]", style=Style(color=COLORS["dark"]))
+    frames.append(cast)
+
+    # Frame 7: Projects
+    if stats.top_projects:
+        projects = Text()
+        projects.append("\n\n\n")
+        projects.append("              P R O J E C T S\n\n", style=Style(color=COLORS["blue"], bold=True))
+        for proj, count in stats.top_projects[:5]:
+            projects.append(f"              {proj}", style=Style(color=COLORS["white"], bold=True))
+            projects.append(f"  ({count:,} messages)\n", style=Style(color=COLORS["gray"]))
+        projects.append("\n\n\n")
+        projects.append("    [ENTER]", style=Style(color=COLORS["dark"]))
+        frames.append(projects)
+
+    # Frame 8: Final card
+    final = Text()
+    final.append("\n\n\n\n")
+    if stats.year is not None:
+        final.append("              See you in ", style=Style(color=COLORS["gray"]))
+        final.append(f"{stats.year + 1}", style=Style(color=COLORS["orange"], bold=True))
+    else:
+        final.append("              Keep coding!", style=Style(color=COLORS["orange"], bold=True))
+    final.append("\n\n\n\n", style=Style(color=COLORS["gray"]))
+    final.append("              ", style=Style())
+    final.append("Banker.so", style=Style(color=COLORS["blue"], bold=True, link="https://banker.so"))
+    final.append(" presents\n\n", style=Style(color=COLORS["gray"]))
+    final.append("    [ENTER] to exit", style=Style(color=COLORS["dark"]))
+    frames.append(final)
+
+    return frames
+
+
+def render_wrapped(stats: WrappedStats, console: Console | None = None, animate: bool = True):
+    """Render the complete wrapped experience."""
+    if console is None:
+        console = Console(style=Style(bgcolor="#2c2c2c"))
+
+    # === CINEMATIC MODE ===
+    if animate:
+        # Loading
+        console.clear()
+        loading_text = "Unwrapping your history..." if stats.year is None else "Unwrapping your year..."
+        with Progress(
+            SpinnerColumn(style=COLORS["orange"]),
+            TextColumn(f"[bold]{loading_text}[/bold]"),
+            BarColumn(complete_style=COLORS["orange"], finished_style=COLORS["green"]),
+            console=console,
+            transient=True,
+        ) as progress:
+            task = progress.add_task("", total=100)
+            for _ in range(100):
+                time.sleep(0.012)
+                progress.update(task, advance=1)
+
+        console.clear()
+
+        # Title slide - wait for keypress
+        console.print(Align.center(create_title_slide(stats.year)))
+        wait_for_keypress()
+        console.clear()
+
+        # Slide 1: Messages with date range
+        first_date = stats.first_message_date.strftime("%d %B") if stats.first_message_date else "the beginning"
+        last_date = stats.last_message_date.strftime("%d %B %Y") if stats.last_message_date else "today"
+        messages_subtitle = f"From {first_date} to {last_date}"
+        console.print(Align.center(create_dramatic_stat(
+            f"{stats.total_messages:,}", "MESSAGES", messages_subtitle, COLORS["orange"]
+        )))
+        wait_for_keypress()
+        console.clear()
+
+        # Slide 2: Averages
+        from .pricing import format_cost
+        averages_text = Text()
+        averages_text.append("\n\n\n\n")
+        averages_text.append("On average, you sent\n\n", style=Style(color=COLORS["gray"]))
+        averages_text.append(f"{stats.avg_messages_per_day:.0f}", style=Style(color=COLORS["orange"], bold=True))
+        averages_text.append(" messages per day\n", style=Style(color=COLORS["white"]))
+        averages_text.append(f"{stats.avg_messages_per_week:.0f}", style=Style(color=COLORS["blue"], bold=True))
+        averages_text.append(" messages per week\n", style=Style(color=COLORS["white"]))
+        averages_text.append(f"{stats.avg_messages_per_month:.0f}", style=Style(color=COLORS["purple"], bold=True))
+        averages_text.append(" messages per month\n\n", style=Style(color=COLORS["white"]))
+        if stats.estimated_cost is not None:
+            averages_text.append("Costing about ", style=Style(color=COLORS["gray"]))
+            averages_text.append(f"{format_cost(stats.avg_cost_per_day)}/day", style=Style(color=COLORS["green"], bold=True))
+            averages_text.append(f" · {format_cost(stats.avg_cost_per_week)}/week", style=Style(color=COLORS["green"]))
+            averages_text.append(f" · {format_cost(stats.avg_cost_per_month)}/month\n", style=Style(color=COLORS["green"]))
+        averages_text.append("\n\n\n")
+        averages_text.append("press [ENTER] to continue", style=Style(color=COLORS["dark"]))
+        console.print(Align.center(averages_text))
+        wait_for_keypress()
+        console.clear()
+
+        # Slide 3: Tokens
+        def format_tokens_dramatic(tokens: int) -> str:
+            if tokens >= 1_000_000_000:
+                return f"{tokens / 1_000_000_000:.1f} Bn"
+            if tokens >= 1_000_000:
+                return f"{tokens / 1_000_000:.0f} M"
+            if tokens >= 1_000:
+                return f"{tokens / 1_000:.0f} K"
+            return str(tokens)
+
+        tokens_text = Text()
+        tokens_text.append("\n\n\n\n\n")
+        tokens_text.append("That's\n\n", style=Style(color=COLORS["gray"]))
+        tokens_text.append(f"{format_tokens_dramatic(stats.total_tokens)}\n", style=Style(color=COLORS["green"], bold=True))
+        tokens_text.append("TOKENS\n\n", style=Style(color=COLORS["white"], bold=True))
+        tokens_text.append("processed through the AI", style=Style(color=COLORS["gray"]))
+        tokens_text.append("\n\n\n\n")
+        tokens_text.append("press [ENTER] to continue", style=Style(color=COLORS["dark"]))
+        console.print(Align.center(tokens_text))
+        wait_for_keypress()
+        console.clear()
+
+        # Slide 4: Streak + Personality (merged)
+        personality = determine_personality(stats)
+        streak_text = Text()
+        streak_text.append("\n\n\n\n")
+        streak_text.append(f"{stats.streak_longest}\n", style=Style(color=COLORS["blue"], bold=True))
+        streak_text.append("DAY STREAK\n\n", style=Style(color=COLORS["white"], bold=True))
+        streak_text.append(f"{personality['emoji']}  ", style=Style(bold=True))
+        streak_text.append(f"{personality['title']}\n", style=Style(color=COLORS["purple"], bold=True))
+        streak_text.append(f"{personality['description']}\n", style=Style(color=COLORS["gray"]))
+        streak_text.append("\n\n\n")
+        streak_text.append("press [ENTER] to continue", style=Style(color=COLORS["dark"]))
+        console.print(Align.center(streak_text))
+        wait_for_keypress()
+        console.clear()
+
+    # === DASHBOARD VIEW ===
+    console.print()
+
+    # Header
+    header = Text()
+    header.append("═" * 60 + "\n", style=Style(color=COLORS["orange"]))
+    header.append("  CLAUDE CODE WRAPPED ", style=Style(color=COLORS["white"], bold=True))
+    header.append(format_year_display(stats.year), style=Style(color=COLORS["orange"], bold=True))
+    header.append("\n" + "═" * 60, style=Style(color=COLORS["orange"]))
+    console.print(Align.center(header))
+    console.print()
+
+    # Big stats row
+    stats_table = Table(show_header=False, box=None, padding=(0, 3), expand=True)
+    stats_table.add_column(justify="center")
+    stats_table.add_column(justify="center")
+    stats_table.add_column(justify="center")
+    stats_table.add_column(justify="center")
+
+    stats_table.add_row(
+        create_big_stat(f"{stats.total_messages:,}", "messages", COLORS["orange"]),
+        create_big_stat(str(stats.total_sessions), "sessions", COLORS["purple"]),
+        create_big_stat(format_tokens(stats.total_tokens), "tokens", COLORS["green"]),
+        create_big_stat(f"{stats.streak_longest}d", "best streak", COLORS["blue"]),
+    )
+    console.print(Align.center(stats_table))
+    console.print()
+
+    # Contribution graph
+    console.print(create_contribution_graph(stats.daily_stats, stats.year))
+
+    # Charts row
+    charts = Table(show_header=False, box=None, padding=(0, 1), expand=True)
+    charts.add_column(ratio=1)
+    charts.add_column(ratio=2)
+    charts.add_row(
+        create_personality_card(stats),
+        create_weekday_chart(stats.weekday_distribution),
+    )
+    console.print(charts)
+
+    # Hour chart
+    console.print(create_hour_chart(stats.hourly_distribution))
+
+    # Top lists
+    lists = Table(show_header=False, box=None, padding=(0, 1), expand=True)
+    lists.add_column(ratio=1)
+    lists.add_column(ratio=1)
+    lists.add_row(
+        create_top_list(stats.top_tools[:5], "Top Tools", COLORS["orange"]),
+        create_top_list(stats.top_projects, "Top Projects", COLORS["green"]),
+    )
+    console.print(lists)
+
+    # MCPs (if any)
+    if stats.top_mcps:
+        console.print(create_top_list(stats.top_mcps, "MCP Servers", COLORS["purple"]))
+
+    # Monthly cost table
+    if stats.monthly_costs:
+        console.print(create_monthly_cost_table(stats))
+
+    # Insights
+    insights = Text()
+    if stats.most_active_day:
+        insights.append("  Peak day: ", style=Style(color=COLORS["gray"]))
+        insights.append(f"{stats.most_active_day[0].strftime('%b %d')}", style=Style(color=COLORS["orange"], bold=True))
+        insights.append(f" ({stats.most_active_day[1]:,} msgs)", style=Style(color=COLORS["gray"]))
+    if stats.most_active_hour is not None:
+        insights.append("  •  Peak hour: ", style=Style(color=COLORS["gray"]))
+        insights.append(f"{stats.most_active_hour}:00", style=Style(color=COLORS["purple"], bold=True))
+    if stats.primary_model:
+        insights.append("  •  Favorite: ", style=Style(color=COLORS["gray"]))
+        insights.append(f"Claude {stats.primary_model}", style=Style(color=COLORS["blue"], bold=True))
+
+    console.print()
+    console.print(Align.center(insights))
+
+    # === CREDITS SEQUENCE ===
+    if animate:
+        console.print()
+        continue_text = Text()
+        continue_text.append("\n    press [ENTER] for fun facts & credits", style=Style(color=COLORS["dark"]))
+        console.print(Align.center(continue_text))
+        wait_for_keypress()
+        console.clear()
+
+        # Fun facts
+        facts = get_fun_facts(stats)
+        if facts:
+            console.print(Align.center(create_fun_facts_slide(facts)))
+            wait_for_keypress()
+            console.clear()
+
+        # Credits roll
+        for frame in create_credits_roll(stats):
+            console.print(Align.center(frame))
+            wait_for_keypress()
+            console.clear()
+
+    # Final footer
+    console.print()
+    footer = Text()
+    footer.append("─" * 60 + "\n\n", style=Style(color=COLORS["dark"]))
+    footer.append("Thanks for building with Claude ", style=Style(color=COLORS["gray"]))
+    footer.append("✨\n\n", style=Style(color=COLORS["orange"]))
+    footer.append("Created by ", style=Style(color=COLORS["gray"]))
+    footer.append("Daniel Tollefsen", style=Style(color=COLORS["white"], bold=True, link="https://github.com/da-troll"))
+    footer.append(" · ", style=Style(color=COLORS["dark"]))
+    footer.append("github.com/da-troll/claude-wrapped", style=Style(color=COLORS["blue"], link="https://github.com/da-troll/claude-wrapped"))
+    footer.append("\n")
+    console.print(Align.center(footer))
+
+
+if __name__ == "__main__":
+    from .reader import load_all_messages
+    from .stats import aggregate_stats
+
+    print("Loading data...")
+    messages = load_all_messages(year=2025)
+    stats = aggregate_stats(messages, 2025)
+
+    render_wrapped(stats)