ccburn 0.2.0__tar.gz → 0.2.2__tar.gz

{ccburn-0.2.0/src/ccburn.egg-info → ccburn-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ccburn
-Version: 0.2.0
+Version: 0.2.2
 Summary: Terminal-based Claude Code usage limit visualizer with real-time burn-up charts
 Author: JuanjoFuchs
 License-Expression: MIT
@@ -46,6 +46,9 @@ Dynamic: license-file
 [![Python](https://img.shields.io/pypi/pyversions/ccburn)](https://pypi.org/project/ccburn/)
 [![GitHub Release](https://img.shields.io/github/v/release/JuanjoFuchs/ccburn)](https://github.com/JuanjoFuchs/ccburn/releases)
 [![WinGet](https://img.shields.io/badge/WinGet-pending-yellow)](https://github.com/microsoft/winget-pkgs/pulls?q=is%3Apr+ccburn)
+[![npm downloads](https://img.shields.io/npm/dt/ccburn?label=npm%20downloads)](https://www.npmjs.com/package/ccburn)
+[![PyPI downloads](https://img.shields.io/pepy/dt/ccburn?label=pypi%20downloads)](https://pepy.tech/project/ccburn)
+[![GitHub downloads](https://img.shields.io/github/downloads/JuanjoFuchs/ccburn/total?label=github%20downloads)](https://github.com/JuanjoFuchs/ccburn/releases)
 [![License](https://img.shields.io/github/license/JuanjoFuchs/ccburn)](LICENSE)
 
 <p align="center">

{ccburn-0.2.0 → ccburn-0.2.2}/README.md

@@ -7,6 +7,9 @@
 [![Python](https://img.shields.io/pypi/pyversions/ccburn)](https://pypi.org/project/ccburn/)
 [![GitHub Release](https://img.shields.io/github/v/release/JuanjoFuchs/ccburn)](https://github.com/JuanjoFuchs/ccburn/releases)
 [![WinGet](https://img.shields.io/badge/WinGet-pending-yellow)](https://github.com/microsoft/winget-pkgs/pulls?q=is%3Apr+ccburn)
+[![npm downloads](https://img.shields.io/npm/dt/ccburn?label=npm%20downloads)](https://www.npmjs.com/package/ccburn)
+[![PyPI downloads](https://img.shields.io/pepy/dt/ccburn?label=pypi%20downloads)](https://pepy.tech/project/ccburn)
+[![GitHub downloads](https://img.shields.io/github/downloads/JuanjoFuchs/ccburn/total?label=github%20downloads)](https://github.com/JuanjoFuchs/ccburn/releases)
 [![License](https://img.shields.io/github/license/JuanjoFuchs/ccburn)](LICENSE)
 
 <p align="center">

{ccburn-0.2.0 → ccburn-0.2.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "ccburn"
-version = "0.2.0"
+version = "0.2.2"
 description = "Terminal-based Claude Code usage limit visualizer with real-time burn-up charts"
 authors = [{name = "JuanjoFuchs"}]
 readme = "README.md"

{ccburn-0.2.0 → ccburn-0.2.2}/src/ccburn/display/chart.py

@@ -10,8 +10,10 @@ from rich.jupyter import JupyterMixin
 
 try:
     from ..data.models import LimitData, UsageSnapshot
+    from ..utils.formatting import get_utilization_color
 except ImportError:
     from ccburn.data.models import LimitData, UsageSnapshot
+    from ccburn.utils.formatting import get_utilization_color
 
 
 class BurnupChart(JupyterMixin):
@@ -143,8 +145,11 @@ class BurnupChart(JupyterMixin):
                     values.append(util_pct)
 
             if times:
-                # Determine line color based on current utilization
-                color = self._get_plotext_color(self.limit_data.utilization)
+                # Calculate budget pace for color determination
+                elapsed_hours = (now - original_window_start).total_seconds() / 3600
+                budget_pace = min(elapsed_hours / original_window_hours, 1.0)
+                # Determine line color based on utilization AND burn rate
+                color = self._get_plotext_color(self.limit_data.utilization, budget_pace)
                 # Use fillx=True for area chart effect (fills down to x-axis)
                 plt.plot(
                     times,
@@ -258,23 +263,27 @@ class BurnupChart(JupyterMixin):
 
         return plt.build()
 
-    def _get_plotext_color(self, utilization: float) -> tuple[int, int, int]:
-        """Get plotext RGB color based on utilization.
+    def _get_plotext_color(
+        self, utilization: float, budget_pace: float = 0.0
+    ) -> tuple[int, int, int]:
+        """Get plotext RGB color based on utilization and burn rate.
 
         Args:
             utilization: Current utilization (0-1)
+            budget_pace: How much of window has elapsed (0-1)
 
         Returns:
             RGB tuple for plotext - bright vivid colors matching Rich progress bars
         """
-        if utilization < 0.5:
-            return (0, 255, 0)  # Bright green
-        elif utilization < 0.75:
-            return (255, 255, 0)  # Bright yellow
-        elif utilization < 0.9:
-            return (255, 165, 0)  # Orange
-        else:
-            return (255, 0, 0)  # Bright red
+        # Reuse shared color logic, map Rich color names to RGB
+        color_name = get_utilization_color(utilization, budget_pace)
+        color_map = {
+            "green": (0, 255, 0),
+            "yellow": (255, 255, 0),
+            "bright_red": (255, 165, 0),  # Orange
+            "red": (255, 0, 0),
+        }
+        return color_map.get(color_name, (255, 255, 0))
 
 
 def create_simple_chart(

{ccburn-0.2.0 → ccburn-0.2.2}/src/ccburn/display/gauges.py

@@ -1,5 +1,7 @@
 """Progress bar gauges for ccburn TUI."""
 
+import sys
+
 from rich.progress import ProgressBar
 from rich.style import Style
 from rich.table import Table
@@ -15,26 +17,48 @@ except ImportError:
     from ccburn.utils.formatting import format_reset_time, get_utilization_color
 
 
-def get_pace_emoji(utilization: float, budget_pace: float) -> str:
+def _supports_emoji() -> bool:
+    """Detect if the console supports emoji characters.
+
+    Returns:
+        True if emoji are likely supported, False otherwise.
+    """
+    # Check if stdout encoding supports emoji
+    try:
+        encoding = getattr(sys.stdout, "encoding", None) or ""
+        if encoding.lower() in ("utf-8", "utf8"):
+            return True
+        # Try to encode an emoji to test
+        "🔥".encode(encoding)
+        return True
+    except (UnicodeEncodeError, LookupError):
+        return False
+
+
+def get_pace_emoji(utilization: float, budget_pace: float, ascii_fallback: bool = False) -> str:
     """Get emoji indicator based on utilization vs budget pace.
 
     Args:
         utilization: Current utilization (0-1)
         budget_pace: Expected budget pace (0-1)
+        ascii_fallback: If True, use ASCII characters instead of emoji
 
     Returns:
         Emoji: 🧊 (behind), 🔥 (on pace), 🚨 (ahead)
+        ASCII: [_] (behind), [=] (on pace), [!] (ahead)
     """
+    use_ascii = ascii_fallback or not _supports_emoji()
+
     if budget_pace == 0:
-        return "🔥"
+        return "[=]" if use_ascii else "🔥"
 
     ratio = utilization / budget_pace
     if ratio < 0.85:
-        return "🧊"  # Behind pace - ice cold, under budget
+        return "[_]" if use_ascii else "🧊"  # Behind pace - ice cold, under budget
     elif ratio > 1.15:
-        return "🚨"  # Ahead of pace - alarm!
+        return "[!]" if use_ascii else "🚨"  # Ahead of pace - alarm!
     else:
-        return "🔥"  # On pace - normal burn
+        return "[=]" if use_ascii else "🔥"  # On pace - normal burn
 
 
 def create_header(limit_type: LimitType, limit_data: LimitData | None) -> Table:
@@ -110,9 +134,9 @@ def create_gauge_section(
     utilization_percent = limit_data.utilization * 100
     pace_percent = budget_pace * 100
 
-    # Usage bar - color by threshold
+    # Usage bar - color by threshold AND burn rate
     # complete_style = filled portion (bright), style = unfilled portion (dim)
-    usage_color = get_utilization_color(limit_data.utilization)
+    usage_color = get_utilization_color(limit_data.utilization, budget_pace)
     usage_bar = ProgressBar(
         total=100,
         completed=utilization_percent,

{ccburn-0.2.0 → ccburn-0.2.2}/src/ccburn/utils/formatting.py

@@ -87,24 +87,45 @@ def format_reset_time(resets_at: datetime, now: datetime | None = None) -> str:
     return f"Resets {day_name} {time_str}"
 
 
-def get_utilization_color(utilization: float) -> str:
-    """Get color based on utilization percentage.
+def get_utilization_color(utilization: float, budget_pace: float = 0.0) -> str:
+    """Get color based on utilization and burn rate.
 
     Args:
-        utilization: Float between 0 and 1
+        utilization: Current usage (0-1)
+        budget_pace: How much of window has elapsed (0-1)
 
     Returns:
-        Color name: "green", "yellow", "orange", or "red"
+        Color name: "green", "yellow", "bright_red", or "red"
     """
-    if utilization < 0.5:
-        return "green"
-    elif utilization < 0.75:
-        return "yellow"
-    elif utilization < 0.9:
-        return "bright_red"  # Rich uses "bright_red" for orange-like
-    else:
+    # Critical: always red at very high utilization
+    if utilization >= 0.9:
         return "red"
 
+    # Calculate burn ratio if we have meaningful data
+    burn_ratio = 1.0
+    if budget_pace >= 0.05 and utilization >= 0.01:
+        burn_ratio = utilization / budget_pace
+
+    # High utilization: at least orange, red if also burning fast
+    if utilization >= 0.75:
+        return "red" if burn_ratio > 1.5 else "bright_red"
+
+    # Moderate utilization: color based on burn rate
+    if utilization >= 0.5:
+        if burn_ratio > 2.0:
+            return "red"
+        if burn_ratio > 1.5:
+            return "bright_red"
+        return "yellow"
+
+    # Low utilization: escalate only if burning very fast
+    if burn_ratio > 3.0:
+        return "bright_red"  # Will hit limit at ~33% of window
+    if burn_ratio > 2.0:
+        return "yellow"  # Will hit limit at ~50% of window
+
+    return "green"
+
 
 def get_status_indicator(utilization: float, budget_pace: float) -> str:
     """Get status indicator for compact output.

{ccburn-0.2.0 → ccburn-0.2.2/src/ccburn.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ccburn
-Version: 0.2.0
+Version: 0.2.2
 Summary: Terminal-based Claude Code usage limit visualizer with real-time burn-up charts
 Author: JuanjoFuchs
 License-Expression: MIT
@@ -46,6 +46,9 @@ Dynamic: license-file
 [![Python](https://img.shields.io/pypi/pyversions/ccburn)](https://pypi.org/project/ccburn/)
 [![GitHub Release](https://img.shields.io/github/v/release/JuanjoFuchs/ccburn)](https://github.com/JuanjoFuchs/ccburn/releases)
 [![WinGet](https://img.shields.io/badge/WinGet-pending-yellow)](https://github.com/microsoft/winget-pkgs/pulls?q=is%3Apr+ccburn)
+[![npm downloads](https://img.shields.io/npm/dt/ccburn?label=npm%20downloads)](https://www.npmjs.com/package/ccburn)
+[![PyPI downloads](https://img.shields.io/pepy/dt/ccburn?label=pypi%20downloads)](https://pepy.tech/project/ccburn)
+[![GitHub downloads](https://img.shields.io/github/downloads/JuanjoFuchs/ccburn/total?label=github%20downloads)](https://github.com/JuanjoFuchs/ccburn/releases)
 [![License](https://img.shields.io/github/license/JuanjoFuchs/ccburn)](LICENSE)
 
 <p align="center">