@torka/claude-qol 0.1.0

package/scripts/context-monitor.py

@@ -0,0 +1,175 @@
+#!/usr/bin/env python3
+"""
+Claude Code Context Monitor
+Real-time context usage monitoring with visual indicators and session analytics
+https://code.claude.com/docs/en/statusline
+"""
+
+import json
+import sys
+import os
+
+
+def context_window_info(window):
+    """
+    Build context info from the statusline `context_window` payload.
+    Expected shape:
+    {
+        "context_window_size": int,
+        "current_usage": {
+            "input_tokens": int,
+            "output_tokens": int,
+            "cache_creation_input_tokens": int,
+            "cache_read_input_tokens": int
+        }
+    }
+    """
+    if not isinstance(window, dict):
+        return None
+
+    size = window.get("context_window_size")
+    if not size or size <= 0:
+        return None
+
+    usage = window.get("current_usage")
+
+    # If no calls yet, usage may be null; treat as 0% used.
+    if usage is None:
+        return {
+            "percent": 0,
+            "tokens": 0,
+            "method": "context_window",
+        }
+
+    if not isinstance(usage, dict):
+        return None
+
+    tokens = (
+        usage.get("input_tokens", 0)
+        + usage.get("output_tokens", 0)
+        + usage.get("cache_creation_input_tokens", 0)
+        + usage.get("cache_read_input_tokens", 0)
+    )
+
+    percent = (tokens / size) * 100 if size > 0 else 0
+
+    return {
+        "percent": max(0, min(100, percent)),
+        "tokens": tokens,
+        "method": "context_window",
+    }
+
+
+def get_context_display(context_info):
+    """Generate context display with visual indicators."""
+    if not context_info:
+        return "🔵 ???"
+    
+    percent = context_info.get('percent', 0)
+    percent = max(0, min(100, percent))
+    warning = context_info.get('warning')
+    
+    # Color based on usage level
+    if percent >= 95:
+        color = "\033[31;1m"  # Blinking red
+        alert = "CRIT"
+    elif percent >= 90:
+        color = "\033[31m"    # Red
+        alert = "HIGH"
+    elif percent >= 75:
+        color = "\033[91m"    # Light red
+        alert = ""
+    elif percent >= 50:
+        color = "\033[33m"    # Yellow
+        alert = ""
+    else:
+        color = "\033[32m"    # Green
+        alert = ""
+    
+    # Create progress bar
+    segments = 8
+    filled = int((percent / 100) * segments)
+    bar = "█" * filled + "▁" * (segments - filled)
+    
+    # Special warnings
+    if warning == 'auto-compact':
+        alert = "AUTO-COMPACT!"
+    elif warning == 'low':
+        alert = "LOW!"
+    
+    reset = "\033[0m"
+    alert_str = f" {alert}" if alert else ""
+    
+    return f"{color}{bar}{reset} {percent:.0f}%{alert_str}"
+
+def get_directory_display(workspace_data):
+    """Get directory display name."""
+    current_dir = workspace_data.get('current_dir', '')
+    project_dir = workspace_data.get('project_dir', '')
+    cwd = workspace_data.get('cwd', '')
+
+    if current_dir and project_dir:
+        if current_dir.startswith(project_dir):
+            rel_path = current_dir[len(project_dir):].lstrip('/')
+            return rel_path or os.path.basename(project_dir)
+        else:
+            return os.path.basename(current_dir)
+    elif project_dir:
+        return os.path.basename(project_dir)
+    elif cwd:
+        return os.path.basename(cwd)
+    elif current_dir:
+        return os.path.basename(current_dir)
+    else:
+        return "unknown"
+
+def get_git_branch():
+    """Get the current git branch name by reading .git/HEAD directly."""
+    try:
+        git_dir = ".git"
+        if os.path.isdir(git_dir):
+            head_file = os.path.join(git_dir, "HEAD")
+            if os.path.isfile(head_file):
+                with open(head_file, 'r') as f:
+                    ref = f.read().strip()
+                    if ref.startswith('ref: refs/heads/'):
+                        return ref.replace('ref: refs/heads/', '')
+                    # Detached HEAD state
+                    return ref[:8]
+        return None
+    except Exception:
+        return None
+
+def main():
+    try:
+        # Read JSON input from Claude Code
+        data = json.load(sys.stdin)
+        
+        # Extract information
+        model_data = data.get('model', {})
+        model_name = model_data.get('display_name') or model_data.get('name') or model_data.get('id') or 'Claude'
+        model_id = model_data.get('id') or model_data.get('name') or model_name
+
+        workspace = data.get('workspace', {})
+        context_window = data.get('context_window') or {}
+
+        # Build status components
+        context_info = context_window_info(context_window)
+        context_display = get_context_display(context_info)
+        directory = get_directory_display(workspace)
+        git_branch = get_git_branch()
+        git_display = f" \033[96m🌿 {git_branch}\033[0m" if git_branch else ""
+
+        model_display = f"\033[94m[{model_name}]\033[0m"
+
+        # Combine all components
+        status_line = f"{model_display} \033[93m📁 {directory}\033[0m{git_display} 🧠 {context_display}"
+        
+        print(status_line)
+        
+    except Exception as e:
+        # Fallback display on any error
+        print(f"\033[94m[Claude]\033[0m \033[93m📁 {os.path.basename(os.getcwd())}\033[0m 🧠 \033[31m[Error: {str(e)[:20]}]\033[0m")
+
+if __name__ == "__main__":
+    main()

package/uninstall.js

@@ -0,0 +1,167 @@
+#!/usr/bin/env node
+/**
+ * @torka/claude-qol - Pre-uninstall script
+ * Removes QoL files from the .claude directory
+ */
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+// ANSI colors for output
+const colors = {
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  blue: '\x1b[34m',
+  red: '\x1b[31m',
+  reset: '\x1b[0m',
+  bold: '\x1b[1m',
+};
+
+function log(message, color = 'reset') {
+  console.log(`${colors[color]}${message}${colors.reset}`);
+}
+
+function logSuccess(message) {
+  log(`  ✓ ${message}`, 'green');
+}
+
+function logSkip(message) {
+  log(`  ○ ${message}`, 'yellow');
+}
+
+/**
+ * Files that were installed by this package
+ * Only remove files we installed, not user-modified files
+ */
+const INSTALLED_FILES = {
+  scripts: [
+    'auto_approve_safe.py',
+    'auto_approve_safe.rules.json',
+    'context-monitor.py',
+  ],
+  commands: [
+    'optimize-auto-approve-hook.md',
+  ],
+};
+
+/**
+ * Determine the target .claude directory based on installation context
+ */
+function getTargetBase() {
+  const isGlobal = process.env.npm_config_global === 'true';
+
+  if (isGlobal) {
+    return path.join(os.homedir(), '.claude');
+  }
+
+  let projectRoot = process.env.INIT_CWD || process.cwd();
+
+  while (projectRoot !== path.dirname(projectRoot)) {
+    const packageJsonPath = path.join(projectRoot, 'package.json');
+    if (fs.existsSync(packageJsonPath)) {
+      try {
+        const pkg = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
+        if (pkg.name !== '@torka/claude-qol') {
+          return path.join(projectRoot, '.claude');
+        }
+      } catch (e) {
+        // Continue walking up
+      }
+    }
+    projectRoot = path.dirname(projectRoot);
+  }
+
+  return path.join(process.env.INIT_CWD || process.cwd(), '.claude');
+}
+
+/**
+ * Remove a file if it exists and matches what we installed
+ */
+function removeFile(filePath, stats) {
+  if (fs.existsSync(filePath)) {
+    try {
+      fs.unlinkSync(filePath);
+      stats.removed.push(filePath);
+      logSuccess(`Removed: ${path.relative(stats.targetBase, filePath)}`);
+    } catch (error) {
+      stats.failed.push({ path: filePath, error: error.message });
+      log(`  ✗ Failed to remove: ${path.relative(stats.targetBase, filePath)}`, 'red');
+    }
+  } else {
+    stats.notFound.push(filePath);
+    logSkip(`Not found: ${path.relative(stats.targetBase, filePath)}`);
+  }
+}
+
+/**
+ * Remove empty directories
+ */
+function removeEmptyDir(dirPath) {
+  if (fs.existsSync(dirPath)) {
+    const files = fs.readdirSync(dirPath);
+    if (files.length === 0) {
+      fs.rmdirSync(dirPath);
+      return true;
+    }
+  }
+  return false;
+}
+
+/**
+ * Main uninstall function
+ */
+function uninstall() {
+  const targetBase = getTargetBase();
+  const isGlobal = process.env.npm_config_global === 'true';
+
+  log('\n' + colors.bold + '📦 @torka/claude-qol - Uninstalling...' + colors.reset);
+  log(`   Target: ${targetBase}`, 'blue');
+  log(`   Mode: ${isGlobal ? 'Global' : 'Project-level'}\n`, 'blue');
+
+  if (!fs.existsSync(targetBase)) {
+    log('   .claude directory not found, nothing to remove.\n', 'yellow');
+    return;
+  }
+
+  const stats = {
+    removed: [],
+    notFound: [],
+    failed: [],
+    targetBase,
+  };
+
+  // Remove files by category
+  for (const [dir, files] of Object.entries(INSTALLED_FILES)) {
+    log(`\n${colors.bold}${dir}/${colors.reset}`);
+    for (const file of files) {
+      const filePath = path.join(targetBase, dir, file);
+      removeFile(filePath, stats);
+    }
+
+    // Try to remove empty directories
+    const dirPath = path.join(targetBase, dir);
+    if (removeEmptyDir(dirPath)) {
+      log(`  ○ Removed empty directory: ${dir}/`, 'yellow');
+    }
+  }
+
+  // Summary
+  log('\n' + colors.bold + '📊 Uninstall Summary' + colors.reset);
+  log(`   Files removed: ${stats.removed.length}`, 'green');
+  log(`   Files not found: ${stats.notFound.length}`, 'yellow');
+  if (stats.failed.length > 0) {
+    log(`   Failed to remove: ${stats.failed.length}`, 'red');
+  }
+
+  log('\n' + colors.yellow + '⚠️  Note: settings.local.json was not modified.' + colors.reset);
+  log('   You may want to manually remove hook/statusLine configurations.\n');
+}
+
+// Run uninstall
+try {
+  uninstall();
+} catch (error) {
+  log(`Uninstall warning: ${error.message}`, 'yellow');
+  // Don't exit with error code - allow npm uninstall to complete
+}