cc-context-stats 1.6.0 → 1.6.2

package/CHANGELOG.md

@@ -7,6 +7,29 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.6.2] - 2026-03-13
+
+### Fixed
+
+- **Delta calculation parity** - Python statusline now reads correct CSV indices (3+5+6) for context usage delta, matching Node.js behavior
+- **Missing duplicate-entry guard** - Python statusline now skips state file writes when token count is unchanged, preventing file bloat
+- **Missing state file rotation** - Python statusline now calls rotation after writes (10k/5k threshold), matching Node.js
+- **Missing git timeout** - Added 5-second timeout to git subprocess calls in standalone Python statusline script
+- **Broad exception handling** - Narrowed `except Exception` to `(OSError, ValueError)` for state reads and `OSError` for writes
+- **Stale CSV format comments** - Added missing `context_window_size` field to header comments in both Python and Node.js scripts
+
+### Added
+
+- **Delta parity tests** - 4 new bats tests verifying Python/Node.js produce identical deltas, handle first-run/decrease/dedup correctly
+
+## [1.6.1] - 2026-03-13
+
+### Fixed
+
+- **Footer version drift** - Corrected stale version `1.2.3` in bash script and `1.0.0` default in Python renderer to match actual release version
+- **Footer project name** - Renamed `claude-statusline` to `cc-context-stats` in the footer display across bash and Python implementations
+- **Install version embedding** - Install scripts now read version from `package.json` and embed it into the installed script, preventing future version drift
+
 ## [1.6.0] - 2026-03-13
 
 ### Added

package/README.md

@@ -15,7 +15,7 @@
 
 **Never run out of context unexpectedly** - monitor your session context in real-time.
 
-![Context Stats](images/context-status-dumbzone.png)
+![Context Stats](images/v1.6.1.png)
 
 ## Why Context Stats?
 

package/docs/context-stats.md

@@ -68,7 +68,7 @@ Session Summary
   Output Tokens:       43,429
   Session Duration:    2h 29m
 
-Powered by claude-statusline v1.2.0 - https://github.com/luongnv89/cc-context-stats
+Powered by cc-context-stats v1.6.1 - https://github.com/luongnv89/cc-context-stats
 ```
 
 ## Features

package/install

@@ -237,10 +237,17 @@ install_token_graph() {
         download_file "scripts/token-graph.sh" "$DEST"
     fi
 
-    # Embed commit hash
+    # Embed version and commit hash
+    local pkg_version
+    if [ "$INSTALL_MODE" = "local" ]; then
+        pkg_version=$(grep -o '"version": *"[^"]*"' "$SCRIPT_DIR/package.json" | head -1 | grep -o '"[^"]*"$' | tr -d '"')
+    else
+        pkg_version=$(curl -fsSL "${GITHUB_RAW_URL}/package.json" 2>/dev/null | grep -o '"version": *"[^"]*"' | head -1 | grep -o '"[^"]*"$' | tr -d '"')
+    fi
+    [ -n "$pkg_version" ] && sed -i.bak "s/VERSION=\"[^\"]*\"/VERSION=\"$pkg_version\"/" "$DEST" && rm -f "$DEST.bak"
     sed -i.bak "s/COMMIT_HASH=\"dev\"/COMMIT_HASH=\"$commit_hash\"/" "$DEST" && rm -f "$DEST.bak"
     chmod +x "$DEST"
-    echo -e "${GREEN}✓${RESET} Installed: $DEST (v1.0.0-$commit_hash)"
+    echo -e "${GREEN}✓${RESET} Installed: $DEST (v${pkg_version:-1.6.0}-$commit_hash)"
 
     # Check if ~/.local/bin is in PATH
     if [[ ":$PATH:" != *":$LOCAL_BIN:"* ]]; then

package/install.sh

@@ -181,7 +181,14 @@ install_context_stats() {
         download_file "scripts/context-stats.sh" "$DEST"
     fi
 
-    # Embed commit hash
+    # Embed version and commit hash
+    local pkg_version
+    if [ "$INSTALL_MODE" = "local" ]; then
+        pkg_version=$(grep -o '"version": *"[^"]*"' "$SCRIPT_DIR/package.json" | head -1 | grep -o '"[^"]*"$' | tr -d '"')
+    else
+        pkg_version=$(curl -fsSL "${GITHUB_RAW_URL}/package.json" 2>/dev/null | grep -o '"version": *"[^"]*"' | head -1 | grep -o '"[^"]*"$' | tr -d '"')
+    fi
+    [ -n "$pkg_version" ] && sed -i.bak "s/VERSION=\"[^\"]*\"/VERSION=\"$pkg_version\"/" "$DEST" && rm -f "$DEST.bak"
     sed -i.bak "s/COMMIT_HASH=\"dev\"/COMMIT_HASH=\"$commit_hash\"/" "$DEST" && rm -f "$DEST.bak"
     chmod +x "$DEST"
     echo -e "${GREEN}✓${RESET} Installed: $DEST"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cc-context-stats",
-  "version": "1.6.0",
+  "version": "1.6.2",
   "description": "Monitor your Claude Code session context in real-time - track token usage and never run out of context",
   "main": "scripts/statusline.js",
   "scripts": {

package/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "cc-context-stats"
-version = "1.6.0"
+version = "1.6.2"
 description = "Monitor your Claude Code session context in real-time - track token usage and never run out of context"
 readme = "README.md"
 license = { text = "MIT" }

package/scripts/context-stats.sh

@@ -22,7 +22,7 @@
 
 # === CONFIGURATION ===
 # shellcheck disable=SC2034
-VERSION="1.2.3"
+VERSION="1.6.1"
 COMMIT_HASH="dev" # Will be replaced during installation
 STATE_DIR=~/.claude/statusline
 CONFIG_FILE=~/.claude/statusline.conf
@@ -873,7 +873,7 @@ render_summary() {
 }
 
 render_footer() {
-    echo -e "${DIM}Powered by ${CYAN}claude-statusline${DIM} v${VERSION}-${COMMIT_HASH} - https://github.com/luongnv89/cc-context-stats${RESET}"
+    echo -e "${DIM}Powered by ${CYAN}cc-context-stats${DIM} v${VERSION}-${COMMIT_HASH} - https://github.com/luongnv89/cc-context-stats${RESET}"
     echo ""
 }
 

package/scripts/statusline.js

@@ -24,7 +24,7 @@
  *   timestamp,total_input_tokens,total_output_tokens,current_usage_input_tokens,
  *   current_usage_output_tokens,current_usage_cache_creation,current_usage_cache_read,
  *   total_cost_usd,total_lines_added,total_lines_removed,session_id,model_id,
- *   workspace_project_dir
+ *   workspace_project_dir,context_window_size
  */
 
 const { execSync } = require('child_process');

package/scripts/statusline.py

@@ -21,7 +21,10 @@ Create/edit ~/.claude/statusline.conf and set:
 When AC is enabled, 22.5% of context window is reserved for autocompact buffer.
 
 State file format (CSV):
-  timestamp,total_input_tokens,total_output_tokens,current_usage_input_tokens,current_usage_output_tokens,current_usage_cache_creation,current_usage_cache_read,total_cost_usd,total_lines_added,total_lines_removed,session_id,model_id,workspace_project_dir
+  timestamp,total_input_tokens,total_output_tokens,current_usage_input_tokens,
+  current_usage_output_tokens,current_usage_cache_creation,current_usage_cache_read,
+  total_cost_usd,total_lines_added,total_lines_removed,session_id,model_id,
+  workspace_project_dir,context_window_size
 """
 
 import json
@@ -30,6 +33,42 @@ import re
 import shutil
 import subprocess
 import sys
+import tempfile
+
+ROTATION_THRESHOLD = 10_000
+ROTATION_KEEP = 5_000
+
+
+def maybe_rotate_state_file(state_file):
+    """Rotate a state file if it exceeds ROTATION_THRESHOLD lines.
+
+    Keeps the most recent ROTATION_KEEP lines via atomic temp-file + rename.
+    """
+    try:
+        if not os.path.exists(state_file):
+            return
+        with open(state_file) as f:
+            lines = f.readlines()
+        if len(lines) <= ROTATION_THRESHOLD:
+            return
+        keep = lines[-ROTATION_KEEP:]
+        fd, tmp_path = tempfile.mkstemp(
+            dir=os.path.dirname(state_file), suffix=".tmp"
+        )
+        try:
+            with os.fdopen(fd, "w") as tmp_f:
+                tmp_f.writelines(keep)
+            os.replace(tmp_path, state_file)
+        except BaseException:
+            try:
+                os.unlink(tmp_path)
+            except OSError:
+                pass
+            raise
+    except OSError as e:
+        sys.stderr.write(
+            f"[statusline] warning: failed to rotate state file: {e}\n"
+        )
 
 # ANSI Colors
 BLUE = "\033[0;34m"
@@ -106,6 +145,7 @@ def get_git_info(project_dir):
             cwd=project_dir,
             capture_output=True,
             text=True,
+            timeout=5,
         )
         branch = result.stdout.strip()
 
@@ -118,13 +158,14 @@ def get_git_info(project_dir):
             cwd=project_dir,
             capture_output=True,
             text=True,
+            timeout=5,
         )
         changes = len([line for line in result.stdout.split("\n") if line.strip()])
 
         if changes > 0:
             return f" | {MAGENTA}{branch}{RESET} {CYAN}[{changes}]{RESET}"
         return f" | {MAGENTA}{branch}{RESET}"
-    except Exception:
+    except (subprocess.TimeoutExpired, OSError):
         return ""
 
 
@@ -302,19 +343,27 @@ def main():
             try:
                 if os.path.exists(state_file):
                     has_prev = True
-                    # Read last line to get previous token count
+                    # Read last line to get previous context usage
                     with open(state_file) as f:
                         lines = f.readlines()
                         if lines:
                             last_line = lines[-1].strip()
                             if "," in last_line:
-                                prev_tokens = int(last_line.split(",")[1])
+                                parts = last_line.split(",")
+                                # Calculate previous context usage:
+                                # cur_input + cache_creation + cache_read
+                                # CSV indices: cur_in[3], cache_create[5], cache_read[6]
+                                prev_cur_input = int(parts[3]) if len(parts) > 3 else 0
+                                prev_cache_creation = int(parts[5]) if len(parts) > 5 else 0
+                                prev_cache_read = int(parts[6]) if len(parts) > 6 else 0
+                                prev_tokens = prev_cur_input + prev_cache_creation + prev_cache_read
                             else:
+                                # Old format - single value
                                 prev_tokens = int(last_line or 0)
-            except Exception as e:
+            except (OSError, ValueError) as e:
                 sys.stderr.write(f"[statusline] warning: failed to read state file: {e}\n")
                 prev_tokens = 0
-            # Calculate delta
+            # Calculate delta (difference in context window usage)
             delta = used_tokens - prev_tokens
             # Only show positive delta (and skip first run when no previous state)
             if has_prev and delta > 0:
@@ -323,34 +372,39 @@ def main():
                 else:
                     delta_display = f"{delta / 1000:.1f}k"
                 delta_info = f" {DIM}[+{delta_display}]{RESET}"
-            # Append current usage with comprehensive format
-            # Format: timestamp,total_input_tokens,total_output_tokens,current_usage_input_tokens,current_usage_output_tokens,current_usage_cache_creation,current_usage_cache_read,total_cost_usd,total_lines_added,total_lines_removed,session_id,model_id,workspace_project_dir
-            try:
-                cur_input_tokens = current_usage.get("input_tokens", 0)
-                cur_output_tokens = current_usage.get("output_tokens", 0)
-                state_data = ",".join(
-                    str(x)
-                    for x in [
-                        int(time.time()),
-                        total_input_tokens,
-                        total_output_tokens,
-                        cur_input_tokens,
-                        cur_output_tokens,
-                        cache_creation,
-                        cache_read,
-                        cost_usd,
-                        lines_added,
-                        lines_removed,
-                        session_id or "",
-                        model_id,
-                        workspace_project_dir.replace(",", "_"),
-                        total_size,
-                    ]
-                )
-                with open(state_file, "a") as f:
-                    f.write(f"{state_data}\n")
-            except Exception as e:
-                sys.stderr.write(f"[statusline] warning: failed to write state file: {e}\n")
+            # Only append if context usage changed (avoid duplicates from multiple refreshes)
+            if not has_prev or used_tokens != prev_tokens:
+                # Append current usage with comprehensive format
+                # Format: ts,total_in,total_out,cur_in,cur_out,cache_create,cache_read,
+                #         cost_usd,lines_added,lines_removed,session_id,model_id,project_dir,
+                #         context_window_size
+                try:
+                    cur_input_tokens = current_usage.get("input_tokens", 0)
+                    cur_output_tokens = current_usage.get("output_tokens", 0)
+                    state_data = ",".join(
+                        str(x)
+                        for x in [
+                            int(time.time()),
+                            total_input_tokens,
+                            total_output_tokens,
+                            cur_input_tokens,
+                            cur_output_tokens,
+                            cache_creation,
+                            cache_read,
+                            cost_usd,
+                            lines_added,
+                            lines_removed,
+                            session_id or "",
+                            model_id,
+                            workspace_project_dir.replace(",", "_"),
+                            total_size,
+                        ]
+                    )
+                    with open(state_file, "a") as f:
+                        f.write(f"{state_data}\n")
+                    maybe_rotate_state_file(state_file)
+                except OSError as e:
+                    sys.stderr.write(f"[statusline] warning: failed to write state file: {e}\n")
 
     # Display session_id if enabled
     if show_session and session_id:

package/src/claude_statusline/__init__.py

@@ -3,7 +3,7 @@
 Never run out of context unexpectedly - monitor your session context in real-time.
 """
 
-__version__ = "1.6.0"
+__version__ = "1.6.2"
 
 from claude_statusline.core.config import Config
 from claude_statusline.core.state import StateFile

package/src/claude_statusline/graphs/renderer.py

@@ -351,7 +351,7 @@ class GraphRenderer:
         )
         self._emit()
 
-    def render_footer(self, version: str = "1.0.0", commit_hash: str = "dev") -> None:
+    def render_footer(self, version: str = "1.6.1", commit_hash: str = "dev") -> None:
         """Render the footer with version info.
 
         Args:
@@ -359,7 +359,7 @@ class GraphRenderer:
             commit_hash: Git commit hash
         """
         self._emit(
-            f"{self.colors.dim}Powered by {self.colors.cyan}claude-statusline"
+            f"{self.colors.dim}Powered by {self.colors.cyan}cc-context-stats"
             f"{self.colors.dim} v{version}-{commit_hash} - "
             f"https://github.com/luongnv89/cc-context-stats{self.colors.reset}"
         )

package/tests/bash/test_delta_parity.bats

@@ -0,0 +1,199 @@
+#!/usr/bin/env bats
+
+# Delta calculation parity tests: Python vs Node.js statusline scripts
+# Verifies both implementations compute identical deltas from identical state.
+
+strip_ansi() {
+    printf '%s' "$1" | sed -e $'s/\033\[[0-9;]*m//g' -e 's/\\033\[[0-9;]*m//g'
+}
+
+setup() {
+    PROJECT_ROOT="$(cd "$BATS_TEST_DIRNAME/../.." && pwd)"
+    PYTHON_SCRIPT="$PROJECT_ROOT/scripts/statusline.py"
+    NODE_SCRIPT="$PROJECT_ROOT/scripts/statusline.js"
+
+    # Create isolated temp HOME so state files don't pollute real ~/.claude/
+    TEST_HOME=$(mktemp -d)
+    export HOME="$TEST_HOME"
+
+    # Normalize terminal width for deterministic output
+    export COLUMNS=200
+
+    # Enable delta display
+    mkdir -p "$TEST_HOME/.claude"
+    echo "show_delta=true" > "$TEST_HOME/.claude/statusline.conf"
+
+    # Create a non-git temp working directory so both scripts skip git info
+    TEST_WORKDIR=$(mktemp -d)
+    cd "$TEST_WORKDIR"
+}
+
+teardown() {
+    rm -rf "$TEST_HOME"
+    rm -rf "$TEST_WORKDIR"
+}
+
+# Helper: create a JSON payload with specific token values and session_id
+make_payload() {
+    local session="$1" input_tokens="$2" cache_creation="$3" cache_read="$4"
+    cat <<EOF
+{
+  "model": {"display_name": "Opus 4.5"},
+  "workspace": {"current_dir": "$TEST_WORKDIR", "project_dir": "$TEST_WORKDIR"},
+  "session_id": "$session",
+  "context_window": {
+    "context_window_size": 200000,
+    "current_usage": {
+      "input_tokens": $input_tokens,
+      "cache_creation_input_tokens": $cache_creation,
+      "cache_read_input_tokens": $cache_read
+    }
+  }
+}
+EOF
+}
+
+# ============================================
+# Delta Calculation Parity Tests
+# ============================================
+
+@test "delta parity: both scripts show identical delta after two sequential payloads" {
+    # First payload: 30k context usage (10k input + 10k cache_create + 10k cache_read)
+    local py_session="delta-parity-py"
+    local node_session="delta-parity-node"
+
+    local payload1_py=$(make_payload "$py_session" 10000 10000 10000)
+    local payload1_node=$(make_payload "$node_session" 10000 10000 10000)
+
+    # Run first payload (seeds state file, no delta shown)
+    echo "$payload1_py" | python3 "$PYTHON_SCRIPT" > /dev/null 2>&1
+    echo "$payload1_node" | node "$NODE_SCRIPT" > /dev/null 2>&1
+
+    # Second payload: 80k context usage (40k input + 20k cache_create + 20k cache_read)
+    # Expected delta = 80k - 30k = 50k
+    local payload2_py=$(make_payload "$py_session" 40000 20000 20000)
+    local payload2_node=$(make_payload "$node_session" 40000 20000 20000)
+
+    local py_output=$(echo "$payload2_py" | python3 "$PYTHON_SCRIPT" 2>/dev/null)
+    local node_output=$(echo "$payload2_node" | node "$NODE_SCRIPT" 2>/dev/null)
+
+    local py_clean=$(strip_ansi "$py_output")
+    local node_clean=$(strip_ansi "$node_output")
+
+    # Both should contain [+50,000] delta
+    if [[ "$py_clean" != *"[+50,000]"* ]]; then
+        echo "Python output missing expected delta [+50,000]"
+        echo "Python output: $py_clean"
+        return 1
+    fi
+    if [[ "$node_clean" != *"[+50,000]"* ]]; then
+        echo "Node.js output missing expected delta [+50,000]"
+        echo "Node.js output: $node_clean"
+        return 1
+    fi
+
+    # Compare outputs ignoring session_id suffix (which intentionally differs)
+    # Strip the trailing session ID from both outputs for comparison
+    local py_no_session=$(echo "$py_clean" | sed 's/ delta-parity-py$//')
+    local node_no_session=$(echo "$node_clean" | sed 's/ delta-parity-node$//')
+
+    if [ "$py_no_session" != "$node_no_session" ]; then
+        echo "DELTA PARITY MISMATCH (ignoring session_id)"
+        echo "Python:  $py_no_session"
+        echo "Node.js: $node_no_session"
+        return 1
+    fi
+}
+
+@test "delta parity: no delta shown on first run (no previous state)" {
+    local py_session="delta-first-py"
+    local node_session="delta-first-node"
+
+    local payload_py=$(make_payload "$py_session" 50000 10000 5000)
+    local payload_node=$(make_payload "$node_session" 50000 10000 5000)
+
+    local py_output=$(echo "$payload_py" | python3 "$PYTHON_SCRIPT" 2>/dev/null)
+    local node_output=$(echo "$payload_node" | node "$NODE_SCRIPT" 2>/dev/null)
+
+    local py_clean=$(strip_ansi "$py_output")
+    local node_clean=$(strip_ansi "$node_output")
+
+    # Neither should show a delta on first run
+    if [[ "$py_clean" == *"[+"* ]]; then
+        echo "Python should not show delta on first run"
+        echo "Python output: $py_clean"
+        return 1
+    fi
+    if [[ "$node_clean" == *"[+"* ]]; then
+        echo "Node.js should not show delta on first run"
+        echo "Node.js output: $node_clean"
+        return 1
+    fi
+}
+
+@test "delta parity: no delta shown when tokens decrease (context reset)" {
+    local py_session="delta-decrease-py"
+    local node_session="delta-decrease-node"
+
+    # First payload: high usage
+    local payload1_py=$(make_payload "$py_session" 80000 20000 10000)
+    local payload1_node=$(make_payload "$node_session" 80000 20000 10000)
+
+    echo "$payload1_py" | python3 "$PYTHON_SCRIPT" > /dev/null 2>&1
+    echo "$payload1_node" | node "$NODE_SCRIPT" > /dev/null 2>&1
+
+    # Second payload: lower usage (context was reset/compacted)
+    local payload2_py=$(make_payload "$py_session" 20000 5000 5000)
+    local payload2_node=$(make_payload "$node_session" 20000 5000 5000)
+
+    local py_output=$(echo "$payload2_py" | python3 "$PYTHON_SCRIPT" 2>/dev/null)
+    local node_output=$(echo "$payload2_node" | node "$NODE_SCRIPT" 2>/dev/null)
+
+    local py_clean=$(strip_ansi "$py_output")
+    local node_clean=$(strip_ansi "$node_output")
+
+    # Neither should show delta when tokens decrease
+    if [[ "$py_clean" == *"[+"* ]]; then
+        echo "Python should not show delta when tokens decrease"
+        echo "Python output: $py_clean"
+        return 1
+    fi
+    if [[ "$node_clean" == *"[+"* ]]; then
+        echo "Node.js should not show delta when tokens decrease"
+        echo "Node.js output: $node_clean"
+        return 1
+    fi
+}
+
+@test "delta parity: duplicate guard prevents writing when tokens unchanged" {
+    local py_session="delta-dedup-py"
+    local node_session="delta-dedup-node"
+
+    local payload_py=$(make_payload "$py_session" 50000 10000 5000)
+    local payload_node=$(make_payload "$node_session" 50000 10000 5000)
+
+    # Run same payload three times
+    echo "$payload_py" | python3 "$PYTHON_SCRIPT" > /dev/null 2>&1
+    echo "$payload_py" | python3 "$PYTHON_SCRIPT" > /dev/null 2>&1
+    echo "$payload_py" | python3 "$PYTHON_SCRIPT" > /dev/null 2>&1
+
+    echo "$payload_node" | node "$NODE_SCRIPT" > /dev/null 2>&1
+    echo "$payload_node" | node "$NODE_SCRIPT" > /dev/null 2>&1
+    echo "$payload_node" | node "$NODE_SCRIPT" > /dev/null 2>&1
+
+    local py_state="$TEST_HOME/.claude/statusline/statusline.${py_session}.state"
+    local node_state="$TEST_HOME/.claude/statusline/statusline.${node_session}.state"
+
+    # Both should have written only 1 line (duplicate guard)
+    local py_lines=$(wc -l < "$py_state" | tr -d ' ')
+    local node_lines=$(wc -l < "$node_state" | tr -d ' ')
+
+    if [ "$py_lines" -ne 1 ]; then
+        echo "Python wrote $py_lines lines (expected 1 — duplicate guard failed)"
+        return 1
+    fi
+    if [ "$node_lines" -ne 1 ]; then
+        echo "Node.js wrote $node_lines lines (expected 1 — duplicate guard failed)"
+        return 1
+    fi
+}