cc-context-stats 1.15.0 → 1.16.0

package/README.md

@@ -110,13 +110,17 @@ The CLI gives you the full session picture when the status line is not enough.
 | Model Intelligence | How quickly quality is degrading as context grows |
 | Zone distribution | Where the session spent most of its time |
 | Final context composition | How much of the final request was cache, reads, or new input |
-| Cache activity trend | When cache creation and cache reads changed over time |
+| Cache activity trend | When cache creation and cache reads changed over time, with TTL countdown |
 
 | Status bar view | Context growth | Cumulative graph |
 |:---:|:---:|:---:|
 | ![Green statusline](images/1.10/statusline-green.png) | ![Delta graph](images/1.10/1.10-delta.png) | ![Cumulative graph](images/1.10/1.10-cumulative.png) |
 
-| MI view | Status bar warning state | 
+| Cumulative graph | Cache graph |
+|:---:|:---:|
+| ![Cumulative graph](images/1.10/1.10-cumulative.png) | ![Cache graph](images/1.16.0/1.16-cache.png) |
+
+| MI view | Status bar warning state |
 |:---:|:---:|
 | ![Model Intelligence view](images/1.10/1.10.0-model-intelligence.png) | ![Yellow statusline](images/1.10/1.10-statusline.png) |
 
@@ -127,13 +131,14 @@ Each image shows a different slice of the same session:
 - `1.10-cumulative.png` shows overall context usage over time.
 - `1.10.0-model-intelligence.png` shows the MI view as context pressure rises.
 - `1.10-statusline.png` shows the warning state when the session is getting tight.
+- `1.16-cache.png` shows cache creation and read tokens per request with a TTL countdown.
 
 ## Export Report
 
 Export a session when you want the timeline, charts, and summary in one Markdown file.
 
 ```bash
-context-stats export <session_id> --output report.md
+context-stats <session_id> export --output report.md
 ```
 
 The report starts with the command that produced it, then folds the headline facts into an executive snapshot.
@@ -154,7 +159,7 @@ Example output:
 
 ## Generate
 
-    context-stats export 8bb55603-45b8-4bdf-aa04-d51366610b1a --output report.md
+    context-stats 8bb55603-45b8-4bdf-aa04-d51366610b1a export --output report.md
 
 ## Executive Snapshot
 | Signal | Value | Why it matters |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cc-context-stats",
-  "version": "1.15.0",
+  "version": "1.16.0",
   "description": "Monitor your Claude Code session context in real-time - track token usage and never run out of context",
   "main": "scripts/statusline.js",
   "bin": {
@@ -43,8 +43,5 @@
   ],
   "engines": {
     "node": ">=18"
-  },
-  "dependencies": {
-    "cc-context-stats": "^1.15.0"
   }
 }

package/scripts/context-stats.sh

@@ -26,7 +26,7 @@
 
 # === CONFIGURATION ===
 # shellcheck disable=SC2034
-VERSION="1.11.1"
+VERSION="1.16.0"
 COMMIT_HASH="dev" # Will be replaced during installation
 STATE_DIR=~/.claude/statusline
 CONFIG_FILE=~/.claude/statusline.conf
@@ -988,17 +988,35 @@ dispatch_python_subcommand() {
     local subcommand=$1
     shift
 
+    local py_cmd=""
     if command -v python3 >/dev/null 2>&1; then
-        python3 -m claude_statusline.cli.context_stats "$subcommand" "$@"
-        return $?
+        py_cmd="python3"
+    elif command -v python >/dev/null 2>&1; then
+        py_cmd="python"
+    else
+        error_exit "Python 3 is required for '$subcommand'."
     fi
 
-    if command -v python >/dev/null 2>&1; then
-        python -m claude_statusline.cli.context_stats "$subcommand" "$@"
-        return $?
+    # Check installed package is available and version matches this script
+    local installed_version
+    installed_version=$($py_cmd -c "import claude_statusline; print(claude_statusline.__version__)" 2>/dev/null || echo "")
+
+    if [ -z "$installed_version" ]; then
+        echo -e "${RED}✗${RESET} Python package 'cc-context-stats' is not installed." >&2
+        echo "  Install it with: pip3 install cc-context-stats==$VERSION" >&2
+        return 1
+    fi
+
+    if [ "$installed_version" != "$VERSION" ]; then
+        echo -e "${RED}✗${RESET} Python package version mismatch:" >&2
+        echo "    Script version:   $VERSION" >&2
+        echo "    Package version:  $installed_version" >&2
+        echo "  Run: pip3 install --upgrade cc-context-stats" >&2
+        return 1
     fi
 
-    error_exit "Python 3 is required for '$subcommand'."
+    $py_cmd -m claude_statusline.cli.context_stats "$subcommand" "$@"
+    return $?
 }
 
 # Render graphs once