cc-context-stats 1.7.0 → 1.8.1

package/package.json

@@ -1,8 +1,12 @@
 {
   "name": "cc-context-stats",
-  "version": "1.7.0",
+  "version": "1.8.1",
   "description": "Monitor your Claude Code session context in real-time - track token usage and never run out of context",
   "main": "scripts/statusline.js",
+  "bin": {
+    "context-stats": "scripts/context-stats.sh",
+    "claude-statusline": "scripts/statusline.js"
+  },
   "scripts": {
     "test": "jest",
     "test:watch": "jest --watch",
@@ -34,6 +38,10 @@
     "jest": "^29.7.0",
     "prettier": "^3.8.1"
   },
+  "files": [
+    "scripts/statusline.js",
+    "scripts/context-stats.sh"
+  ],
   "engines": {
     "node": ">=18"
   }

package/scripts/context-stats.sh

@@ -22,7 +22,7 @@
 
 # === CONFIGURATION ===
 # shellcheck disable=SC2034
-VERSION="1.6.1"
+VERSION="1.8.0"
 COMMIT_HASH="dev" # Will be replaced during installation
 STATE_DIR=~/.claude/statusline
 CONFIG_FILE=~/.claude/statusline.conf

package/scripts/statusline.js

@@ -36,6 +36,61 @@ const os = require('os');
 const ROTATION_THRESHOLD = 10000;
 const ROTATION_KEEP = 5000;
 
+// Model Intelligence constants (hardcoded, not configurable)
+const MI_WEIGHT_CPS = 0.60;
+const MI_WEIGHT_ES = 0.25;
+const MI_WEIGHT_PS = 0.15;
+const MI_GREEN_THRESHOLD = 0.65;
+const MI_YELLOW_THRESHOLD = 0.35;
+const MI_PRODUCTIVITY_TARGET = 0.2;
+
+/**
+ * Compute Model Intelligence score.
+ * Returns { mi, cps, es, ps }.
+ */
+function computeMI(usedTokens, contextWindowSize, cacheRead, totalContext,
+                   deltaLines, deltaOutput, beta = 1.5) {
+    // Guard clause
+    if (contextWindowSize === 0) {
+        return { mi: 1.0, cps: 1.0, es: 1.0, ps: 0.5 };
+    }
+
+    // CPS
+    const u = usedTokens / contextWindowSize;
+    const cps = u > 0 ? Math.max(0, 1 - Math.pow(u, beta)) : 1.0;
+
+    // ES
+    let es;
+    if (totalContext === 0) {
+        es = 1.0;
+    } else {
+        const cacheHitRatio = cacheRead / totalContext;
+        es = 0.3 + 0.7 * cacheHitRatio;
+    }
+
+    // PS
+    let ps;
+    if (deltaOutput === null || deltaOutput === undefined || deltaOutput <= 0) {
+        ps = 0.5;
+    } else {
+        const ratio = deltaLines / deltaOutput;
+        const normalized = Math.min(1.0, ratio / MI_PRODUCTIVITY_TARGET);
+        ps = 0.2 + 0.8 * normalized;
+    }
+
+    const mi = MI_WEIGHT_CPS * cps + MI_WEIGHT_ES * es + MI_WEIGHT_PS * ps;
+    return { mi, cps, es, ps };
+}
+
+/**
+ * Return ANSI color code for MI score.
+ */
+function getMIColor(mi, greenColor, yellowColor, redColor) {
+    if (mi > MI_GREEN_THRESHOLD) return greenColor || GREEN;
+    if (mi > MI_YELLOW_THRESHOLD) return yellowColor || YELLOW;
+    return redColor || RED;
+}
+
 /**
  * Rotate a state file if it exceeds ROTATION_THRESHOLD lines.
  * Keeps the most recent ROTATION_KEEP lines via atomic temp-file + rename.
@@ -141,8 +196,24 @@ function visibleWidth(s) {
 /**
  * Return the terminal width in columns, defaulting to 80.
  */
+/**
+ * Return the terminal width in columns.
+ *
+ * When running inside Claude Code's statusline subprocess, neither $COLUMNS
+ * nor process.stdout.columns can detect the real terminal width (they return
+ * undefined or 80). If COLUMNS is not explicitly set and we'd fall back to 80,
+ * use a generous default of 200 so that no parts are unnecessarily dropped;
+ * Claude Code's own UI handles any overflow/truncation.
+ */
 function getTerminalWidth() {
-    return process.stdout.columns || parseInt(process.env.COLUMNS, 10) || 80;
+    if (process.env.COLUMNS) {
+        return parseInt(process.env.COLUMNS, 10) || 200;
+    }
+    const cols = process.stdout.columns;
+    if (cols && cols !== 80) {
+        return cols;
+    }
+    return 200;
 }
 
 /**
@@ -220,6 +291,8 @@ function readConfig() {
         showSession: true,
         showIoTokens: true,
         reducedMotion: false,
+        showMI: true,
+        miCurveBeta: 1.5,
         colors: {},
     };
     const configPath = path.join(os.homedir(), '.claude', 'statusline.conf');
@@ -280,6 +353,13 @@ show_session=true
                 config.showIoTokens = valueTrimmed !== 'false';
             } else if (keyTrimmed === 'reduced_motion') {
                 config.reducedMotion = valueTrimmed !== 'false';
+            } else if (keyTrimmed === 'show_mi') {
+                config.showMI = valueTrimmed !== 'false';
+            } else if (keyTrimmed === 'mi_curve_beta') {
+                const parsed = parseFloat(rawValue);
+                if (!isNaN(parsed)) {
+                    config.miCurveBeta = parsed;
+                }
             } else if (COLOR_CONFIG_KEYS[keyTrimmed]) {
                 const ansi = parseColor(rawValue);
                 if (ansi) {
@@ -340,7 +420,10 @@ process.stdin.on('end', () => {
     let contextInfo = '';
     let acInfo = '';
     let deltaInfo = '';
+    let miInfo = '';
     let sessionInfo = '';
+    const showMI = config.showMI;
+    const miCurveBeta = config.miCurveBeta;
     const totalSize = data.context_window?.context_window_size || 0;
     const currentUsage = data.context_window?.current_usage;
     const totalInputTokens = data.context_window?.total_input_tokens || 0;
@@ -399,10 +482,10 @@ process.stdin.on('end', () => {
             ctxColor = cRed;
         }
 
-        contextInfo = ` | ${ctxColor}${freeDisplay} free (${freePct.toFixed(1)}%)${RESET}`;
+        contextInfo = ` | ${ctxColor}${freeDisplay} (${freePct.toFixed(1)}%)${RESET}`;
 
-        // Calculate and display token delta if enabled
-        if (showDelta) {
+        // Read previous entry if needed for delta OR MI
+        if (showDelta || showMI) {
             const stateDir = path.join(os.homedir(), '.claude', 'statusline');
             if (!fs.existsSync(stateDir)) {
                 fs.mkdirSync(stateDir, { recursive: true });
@@ -432,10 +515,13 @@ process.stdin.on('end', () => {
             const stateFile = path.join(stateDir, stateFileName);
             let hasPrev = false;
             let prevTokens = 0;
+            let prevOutputTokens = 0;
+            let prevLinesAdded = 0;
+            let prevLinesRemoved = 0;
             try {
                 if (fs.existsSync(stateFile)) {
                     hasPrev = true;
-                    // Read last line to get previous context usage
+                    // Read last line to get previous state
                     const content = fs.readFileSync(stateFile, 'utf8').trim();
                     const lines = content.split('\n');
                     const lastLine = lines[lines.length - 1];
@@ -448,6 +534,10 @@ process.stdin.on('end', () => {
                         const prevCacheCreation = parseInt(parts[5], 10) || 0;
                         const prevCacheRead = parseInt(parts[6], 10) || 0;
                         prevTokens = prevCurInput + prevCacheCreation + prevCacheRead;
+                        // For MI productivity score
+                        prevOutputTokens = parseInt(parts[2], 10) || 0;
+                        prevLinesAdded = parseInt(parts[8], 10) || 0;
+                        prevLinesRemoved = parseInt(parts[9], 10) || 0;
                     } else {
                         // Old format - single value
                         prevTokens = parseInt(lastLine, 10) || 0;
@@ -459,20 +549,40 @@ process.stdin.on('end', () => {
                 );
                 prevTokens = 0;
             }
-            // Calculate delta (difference in context window usage)
-            const delta = usedTokens - prevTokens;
-            // Only show positive delta (and skip first run when no previous state)
-            if (hasPrev && delta > 0) {
-                const deltaDisplay = tokenDetail
-                    ? delta.toLocaleString('en-US')
-                    : `${(delta / 1000).toFixed(1)}k`;
-                deltaInfo = ` ${DIM}[+${deltaDisplay}]${RESET}`;
+
+            // Calculate and display token delta if enabled
+            if (showDelta) {
+                const delta = usedTokens - prevTokens;
+                if (hasPrev && delta > 0) {
+                    const deltaDisplay = tokenDetail
+                        ? delta.toLocaleString('en-US')
+                        : `${(delta / 1000).toFixed(1)}k`;
+                    deltaInfo = ` ${DIM}[+${deltaDisplay}]${RESET}`;
+                }
             }
+
+            // Calculate and display MI score if enabled
+            if (showMI) {
+                let deltaLines, deltaOutput;
+                if (hasPrev) {
+                    const deltaLA = linesAdded - prevLinesAdded;
+                    const deltaLR = linesRemoved - prevLinesRemoved;
+                    deltaLines = deltaLA + deltaLR;
+                    deltaOutput = totalOutputTokens - prevOutputTokens;
+                } else {
+                    deltaLines = 0;
+                    deltaOutput = null;
+                }
+                const miResult = computeMI(
+                    usedTokens, totalSize, cacheRead, usedTokens,
+                    deltaLines, deltaOutput, miCurveBeta
+                );
+                const miColor = getMIColor(miResult.mi, cGreen, cYellow, cRed);
+                miInfo = ` ${miColor}MI:${miResult.mi.toFixed(2)}${RESET}`;
+            }
+
             // Only append if context usage changed (avoid duplicates from multiple refreshes)
             if (!hasPrev || usedTokens !== prevTokens) {
-                // 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
                 try {
                     const timestamp = Math.floor(Date.now() / 1000);
                     const curInputTokens = currentUsage.input_tokens || 0;
@@ -512,11 +622,11 @@ process.stdin.on('end', () => {
     // Output: [Model] dir | branch [n] | free (%) [+delta] [AC] session
     const base = `${DIM}[${model}]${RESET} ${cBlue}${dirName}${RESET}`;
     const maxWidth = getTerminalWidth();
-    const parts = [base, gitInfo, contextInfo, deltaInfo, acInfo, sessionInfo];
+    const parts = [base, gitInfo, contextInfo, deltaInfo, miInfo, acInfo, sessionInfo];
     console.log(fitToWidth(parts, maxWidth));
 });
 
 // Export for testing
 if (typeof module !== 'undefined' && module.exports) {
-    module.exports = { maybeRotateStateFile, ROTATION_THRESHOLD, ROTATION_KEEP };
+    module.exports = { maybeRotateStateFile, ROTATION_THRESHOLD, ROTATION_KEEP, computeMI };
 }

package/.editorconfig

@@ -1,60 +0,0 @@
-# EditorConfig for claude-statusline project
-# https://editorconfig.org
-
-root = true
-
-# Default settings for all files
-[*]
-charset = utf-8
-end_of_line = lf
-insert_final_newline = true
-trim_trailing_whitespace = true
-indent_style = space
-indent_size = 4
-
-# Shell scripts
-[*.{sh,bash}]
-indent_style = space
-indent_size = 4
-
-# Python
-[*.py]
-indent_style = space
-indent_size = 4
-max_line_length = 100
-
-# JavaScript
-[*.js]
-indent_style = space
-indent_size = 4
-max_line_length = 100
-
-# JSON files
-[*.json]
-indent_style = space
-indent_size = 2
-
-# YAML files
-[*.{yml,yaml}]
-indent_style = space
-indent_size = 2
-
-# TOML files
-[*.toml]
-indent_style = space
-indent_size = 4
-
-# Markdown
-[*.md]
-indent_style = space
-indent_size = 2
-trim_trailing_whitespace = false
-
-# Makefile
-[Makefile]
-indent_style = tab
-
-# Bats test files
-[*.bats]
-indent_style = space
-indent_size = 4

package/.eslintrc.json

@@ -1,35 +0,0 @@
-{
-  "env": {
-    "node": true,
-    "es2022": true,
-    "jest": true
-  },
-  "parserOptions": {
-    "ecmaVersion": 2022,
-    "sourceType": "commonjs"
-  },
-  "extends": ["eslint:recommended"],
-  "rules": {
-    "indent": ["error", 4],
-    "linebreak-style": ["error", "unix"],
-    "quotes": ["error", "single", { "avoidEscape": true }],
-    "semi": ["error", "always"],
-    "no-unused-vars": ["error", { "argsIgnorePattern": "^_" }],
-    "no-console": "off",
-    "eqeqeq": ["error", "always"],
-    "curly": ["error", "all"],
-    "brace-style": ["error", "1tbs"],
-    "comma-dangle": ["error", "only-multiline"],
-    "comma-spacing": ["error", { "before": false, "after": true }],
-    "keyword-spacing": ["error", { "before": true, "after": true }],
-    "space-before-blocks": ["error", "always"],
-    "object-curly-spacing": ["error", "always"],
-    "array-bracket-spacing": ["error", "never"],
-    "no-trailing-spaces": "error",
-    "eol-last": ["error", "always"],
-    "max-len": ["warn", { "code": 100, "ignoreStrings": true, "ignoreTemplateLiterals": true }],
-    "prefer-const": "error",
-    "no-var": "error"
-  },
-  "ignorePatterns": ["node_modules/", "coverage/", "*.min.js"]
-}

package/.github/ISSUE_TEMPLATE/bug_report.md

@@ -1,49 +0,0 @@
----
-name: Bug Report
-about: Report a bug to help us improve
-title: '[BUG] '
-labels: bug
-assignees: ''
----
-
-## Bug Description
-
-A clear and concise description of what the bug is.
-
-## Steps to Reproduce
-
-1. Install cc-context-stats via '...'
-2. Run '...'
-3. See error
-
-## Expected Behavior
-
-A clear and concise description of what you expected to happen.
-
-## Actual Behavior
-
-What actually happened instead.
-
-## Screenshots
-
-If applicable, add screenshots to help explain your problem.
-
-## Environment
-
-- OS: [e.g., macOS 14.0, Ubuntu 22.04, Windows 11]
-- Shell: [e.g., zsh, bash, PowerShell]
-- cc-context-stats version: [e.g., 1.6.0]
-- Installation method: [npm, pip, shell script]
-- Node.js version: [if applicable]
-- Python version: [if applicable]
-- Claude Code version: [if applicable]
-
-## Additional Context
-
-Add any other context about the problem here.
-
-## State File Content (if relevant)
-
-```
-# Paste output of: cat ~/.claude/statusline/statusline.*.state
-```

package/.github/ISSUE_TEMPLATE/feature_request.md

@@ -1,31 +0,0 @@
----
-name: Feature Request
-about: Suggest an idea for this project
-title: '[FEATURE] '
-labels: enhancement
-assignees: ''
----
-
-## Problem Statement
-
-A clear and concise description of what the problem is.
-Ex. I'm always frustrated when [...]
-
-## Proposed Solution
-
-A clear and concise description of what you want to happen.
-
-## Alternatives Considered
-
-A clear and concise description of any alternative solutions or features you've considered.
-
-## Use Cases
-
-Describe specific use cases where this feature would be beneficial:
-
-1. Use case 1
-2. Use case 2
-
-## Additional Context
-
-Add any other context, mockups, or screenshots about the feature request here.

package/.github/PULL_REQUEST_TEMPLATE.md

@@ -1,33 +0,0 @@
-## Description
-
-Brief description of the changes in this PR.
-
-## Related Issue
-
-Fixes #(issue number)
-
-## Type of Change
-
-- [ ] Bug fix (non-breaking change which fixes an issue)
-- [ ] New feature (non-breaking change which adds functionality)
-- [ ] Breaking change (fix or feature that would cause existing functionality to change)
-- [ ] Documentation update
-- [ ] Refactoring (no functional changes)
-
-## Checklist
-
-- [ ] My code follows the project's style guidelines
-- [ ] I have performed a self-review of my code
-- [ ] I have made corresponding changes to the documentation
-- [ ] My changes generate no new warnings
-- [ ] I have added tests that prove my fix is effective or that my feature works
-- [ ] New and existing unit tests pass locally with my changes
-- [ ] All three implementations (bash, Python, Node.js) produce consistent output (if applicable)
-
-## Screenshots (if applicable)
-
-Add screenshots to help explain your changes.
-
-## Additional Notes
-
-Any additional information that reviewers should know.

package/.github/dependabot.yml

@@ -1,44 +0,0 @@
-version: 2
-updates:
-  # GitHub Actions
-  - package-ecosystem: "github-actions"
-    directory: "/"
-    schedule:
-      interval: "weekly"
-      day: "monday"
-    commit-message:
-      prefix: "ci"
-    labels:
-      - "dependencies"
-      - "github-actions"
-
-  # npm dependencies
-  - package-ecosystem: "npm"
-    directory: "/"
-    schedule:
-      interval: "weekly"
-      day: "monday"
-    commit-message:
-      prefix: "deps"
-    labels:
-      - "dependencies"
-      - "javascript"
-    groups:
-      dev-dependencies:
-        patterns:
-          - "*"
-        update-types:
-          - "minor"
-          - "patch"
-
-  # pip dependencies
-  - package-ecosystem: "pip"
-    directory: "/"
-    schedule:
-      interval: "weekly"
-      day: "monday"
-    commit-message:
-      prefix: "deps"
-    labels:
-      - "dependencies"
-      - "python"