claude-statusline 2.1.2

package/dist/ui/width.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"width.js","sourceRoot":"","sources":["../../src/ui/width.ts"],"names":[],"mappings":"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","sourcesContent":["import { Config } from '../core/config.js';\n\n/**\n * Terminal width detection utilities\n * Ported from bash implementation with cross-platform Node.js support\n */\n\n/**\n * Get terminal width using multiple detection methods\n * Ordered from most reliable to fallback methods\n */\nexport async function getTerminalWidth(config: Config): Promise<number> {\n  // Method 0: Respect manual width override first (for testing)\n  if (config.forceWidth && config.forceWidth > 0) {\n    return config.forceWidth;\n  }\n\n  // Method 1: Try COLUMNS environment variable\n  const columnsEnv = process.env.COLUMNS;\n  if (columnsEnv) {\n    const columns = parseInt(columnsEnv, 10);\n    if (!isNaN(columns) && columns > 0) {\n      return columns;\n    }\n  }\n\n  // Method 2: Try Node.js process.stdout.columns\n  if (process.stdout.columns && process.stdout.columns > 0) {\n    return process.stdout.columns;\n  }\n\n  // Method 3: Try tput command (Unix/Linux/macOS)\n  const tputWidth = await tryCommand('tput', ['cols']);\n  if (tputWidth) {\n    return tputWidth;\n  }\n\n  // Method 4: Try stty command (Unix/Linux/macOS)\n  const sttyWidth = await tryStty();\n  if (sttyWidth) {\n    return sttyWidth;\n  }\n\n  // Method 5: Check Claude Code specific environment\n  const claudeWidth = process.env.CLAUDE_CODE_TERMINAL_WIDTH;\n  if (claudeWidth) {\n    const width = parseInt(claudeWidth, 10);\n    if (!isNaN(width) && width > 0) {\n      return width;\n    }\n  }\n\n  // Method 6: Terminal-specific defaults\n  const termProgram = process.env.TERM_PROGRAM;\n  const term = process.env.TERM;\n\n  if (termProgram === 'vscode' && process.env.VSCODE_PID) {\n    return 120; // VS Code default\n  }\n\n  if (['ghostty', 'wezterm', 'iterm'].includes(termProgram || '')) {\n    return 120; // Modern terminals default to wider\n  }\n\n  if (term && ['alacritty', 'kitty', 'wezterm', 'ghostty', 'xterm-256color'].includes(term)) {\n    return 120; // Modern terminals\n  }\n\n  // Method 7: Check for Windows Terminal\n  if (process.env.WT_SESSION || process.env.WT_PROFILE_ID) {\n    return 120; // Windows Terminal\n  }\n\n  // Final fallback: conservative 80-column default\n  return 80;\n}\n\n/**\n * Execute a command and parse numeric output\n */\nasync function tryCommand(command: string, args: string[]): Promise<number | null> {\n  try {\n    const { exec } = await import('child_process');\n    const { promisify } = await import('util');\n    const execAsync = promisify(exec);\n\n    const { stdout } = await execAsync(`${command} ${args.join(' ')}`, {\n      timeout: 1000, // 1 second timeout\n      encoding: 'utf-8',\n    });\n\n    const width = parseInt(stdout.trim(), 10);\n    if (!isNaN(width) && width > 0) {\n      return width;\n    }\n  } catch {\n    // Command failed or not available\n  }\n\n  return null;\n}\n\n/**\n * Try stty size command\n */\nasync function tryStty(): Promise<number | null> {\n  try {\n    const { exec } = await import('child_process');\n    const { promisify } = await import('util');\n    const execAsync = promisify(exec);\n\n    const { stdout } = await execAsync('stty size', {\n      timeout: 1000,\n      encoding: 'utf-8',\n    });\n\n    // stty size returns: \"rows cols\"\n    const parts = stdout.trim().split(' ');\n    if (parts.length === 2) {\n      const width = parseInt(parts[1] || '0', 10);\n      if (!isNaN(width) && width > 0) {\n        return width;\n      }\n    }\n  } catch {\n    // stty failed or not available\n  }\n\n  return null;\n}\n\n/**\n * Debug width detection (matches bash implementation)\n */\nexport async function debugWidthDetection(config: Config): Promise<void> {\n  if (!config.debugWidth) {\n    return;\n  }\n\n  console.error('[WIDTH DEBUG] Debug mode enabled');\n\n  console.error('[WIDTH DEBUG] Methods tried:');\n\n  // Test process.stdout.columns\n  if (process.stdout.columns) {\n    console.error(`[WIDTH DEBUG] process.stdout.columns: ${process.stdout.columns}`);\n  } else {\n    console.error('[WIDTH DEBUG] process.stdout.columns: not available');\n  }\n\n  // Test COLUMNS variable\n  const columnsEnv = process.env.COLUMNS;\n  if (columnsEnv) {\n    console.error(`[WIDTH DEBUG] COLUMNS variable: ${columnsEnv}`);\n  } else {\n    console.error('[WIDTH DEBUG] COLUMNS variable: not set');\n  }\n\n  // Test tput\n  const tputWidth = await tryCommand('tput', ['cols']);\n  if (tputWidth) {\n    console.error(`[WIDTH DEBUG] tput cols: ${tputWidth}`);\n  } else {\n    console.error('[WIDTH DEBUG] tput: not available or failed');\n  }\n\n  // Test stty\n  const sttyWidth = await tryStty();\n  if (sttyWidth) {\n    console.error(`[WIDTH DEBUG] stty size: ${sttyWidth}`);\n  } else {\n    console.error('[WIDTH DEBUG] stty: not available or failed');\n  }\n\n  // Test environment variables\n  console.error(`[WIDTH DEBUG] CLAUDE_CODE_STATUSLINE_FORCE_WIDTH: ${config.forceWidth || 'not set'}`);\n  console.error(`[WIDTH DEBUG] COLUMNS variable: ${columnsEnv || 'not set'}`);\n  console.error(`[WIDTH DEBUG] CLAUDE_CODE_TERMINAL_WIDTH: ${process.env.CLAUDE_CODE_TERMINAL_WIDTH || 'not set'}`);\n  console.error(`[WIDTH DEBUG] TERM_PROGRAM: ${process.env.TERM_PROGRAM || 'not set'}`);\n  console.error(`[WIDTH DEBUG] TERM: ${process.env.TERM || 'not set'}`);\n\n  // Show final result\n  const finalWidth = await getTerminalWidth(config);\n  console.error(`[WIDTH DEBUG] Final detected width: ${finalWidth}`);\n  console.error(`[WIDTH DEBUG] Statusline will use: ${finalWidth - config.rightMargin} columns max`);\n}\n\n/**\n * Text truncation utilities\n */\n\n/**\n * Simple text truncation with ellipsis\n */\nexport function truncateText(text: string, maxLength: number): string {\n  if (text.length <= maxLength) {\n    return text;\n  }\n\n  // Edge case: if maxLength is too small, return minimal result\n  if (maxLength < 4) {\n    return '..';\n  }\n\n  return `${text.substring(0, maxLength - 2)}..`;\n}\n\n/**\n * Smart truncation with branch prioritization (matches bash implementation)\n */\nexport function smartTruncate(\n  project: string,\n  gitInfo: string,\n  maxLen: number,\n  _config: Config\n): string {\n  // Step 1: Check if everything fits\n  if (project.length + gitInfo.length <= maxLen) {\n    return '';\n  }\n\n  // Step 2: Truncate project only (preserve branch)\n  const projLen = maxLen - gitInfo.length - 2;\n  if (projLen >= 5) {\n    return `${project.substring(0, projLen)}..${gitInfo}`;\n  }\n\n  // Step 3: Truncate project + branch (preserve indicators)\n  let indicators = '';\n  const bracketMatch = gitInfo.match(/\\[([^\\]]+)\\]/);\n  if (bracketMatch) {\n    indicators = bracketMatch[1] || '';\n  }\n\n  const branchLen = maxLen - indicators.length - 8;\n  if (branchLen >= 8) {\n    const gitPrefix = gitInfo.substring(0, Math.min(gitInfo.length, branchLen));\n    return `${project.substring(0, 4)}..${gitPrefix}..${indicators ? ` [${indicators}]` : ''}`;\n  }\n\n  // Step 4: Basic fallback\n  return `${project.substring(0, maxLen)}..`;\n}\n\n/**\n * Soft wrapping function (experimental)\n */\nexport function softWrapText(\n  text: string,\n  maxLength: number,\n  wrapChar: 'newline' | 'space' = 'newline',\n  modelPrefix: string = '*'\n): string {\n  if (text.length <= maxLength) {\n    return text;\n  }\n\n  if (wrapChar === 'newline') {\n    // Smart wrap: try to break at space or safe character\n    let breakPos = maxLength;\n    let foundBreak = false;\n\n    // Look for safe break points (spaces)\n    for (let i = Math.min(maxLength - 1, text.length - 1); i > Math.max(maxLength - 20, 0) && i >= 0; i--) {\n      const char = text[i];\n      if (char === ' ') {\n        breakPos = i;\n        foundBreak = true;\n        break;\n      }\n    }\n\n    // If no safe break found and we're very close to max_length, just fit without wrapping\n    if (!foundBreak && maxLength - text.length > -3) {\n      return text;\n    }\n\n    // Adjust break position to avoid splitting multi-byte UTF-8 characters\n    // UTF-8 continuation bytes have their two most significant bits set to 10 (0x80 to 0xBF)\n    while (breakPos > 0 && (text.charCodeAt(breakPos) & 0xC0) === 0x80) {\n      breakPos--;\n    }\n\n    const firstLine = text.substring(0, breakPos);\n    let secondLine = text.substring(breakPos);\n\n    // Remove leading space from second line if we broke at space\n    if (secondLine.startsWith(' ')) {\n      secondLine = secondLine.substring(1);\n    }\n\n    // Only wrap if second line has meaningful content\n    if (secondLine) {\n      return `${firstLine}\\n${modelPrefix}${secondLine}`;\n    } else {\n      return firstLine;\n    }\n  } else {\n    // Use space separator for wrapping\n    let breakPos = maxLength;\n\n    // Adjust break position to avoid splitting multi-byte UTF-8 characters\n    // UTF-8 continuation bytes have their two most significant bits set to 10 (0x80 to 0xBF)\n    while (breakPos > 0 && (text.charCodeAt(breakPos) & 0xC0) === 0x80) {\n      breakPos--;\n    }\n\n    const firstLine = text.substring(0, breakPos);\n    const secondLine = text.substring(breakPos);\n    return `${firstLine} ${secondLine}`;\n  }\n}"]}

package/dist/utils/runtime.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Runtime detection utilities for optimizing performance based on the JavaScript runtime
+ */
+export type Runtime = 'node' | 'bun' | 'unknown';
+interface RuntimeInfo {
+    runtime: Runtime;
+    version: string;
+    isBun: boolean;
+    isNode: boolean;
+}
+/**
+ * Detect the current JavaScript runtime
+ */
+export declare function detectRuntime(): RuntimeInfo;
+/**
+ * Get the optimal executable for git commands based on runtime
+ */
+export declare function getGitExecutable(): string;
+/**
+ * Check if the runtime supports native performance optimizations
+ */
+export declare function supportsNativeOptimizations(): boolean;
+/**
+ * Get runtime-specific performance recommendations
+ */
+export declare function getPerformanceRecommendations(): string[];
+/**
+ * Log runtime information for debugging
+ */
+export declare function logRuntimeInfo(): void;
+export {};

package/dist/utils/runtime.js

@@ -0,0 +1,82 @@
+/**
+ * Runtime detection utilities for optimizing performance based on the JavaScript runtime
+ */
+/**
+ * Detect the current JavaScript runtime
+ */
+export function detectRuntime() {
+    // Check for Bun
+    if (typeof globalThis !== 'undefined' && 'Bun' in globalThis) {
+        // @ts-ignore - Bun is a global when running in Bun runtime
+        const bunVersion = globalThis.Bun?.version || 'unknown';
+        return {
+            runtime: 'bun',
+            version: bunVersion,
+            isBun: true,
+            isNode: false,
+        };
+    }
+    // Check for Node.js
+    if (typeof process !== 'undefined' && process.versions && process.versions.node) {
+        return {
+            runtime: 'node',
+            version: process.versions.node,
+            isBun: false,
+            isNode: true,
+        };
+    }
+    // Unknown runtime
+    return {
+        runtime: 'unknown',
+        version: 'unknown',
+        isBun: false,
+        isNode: false,
+    };
+}
+/**
+ * Get the optimal executable for git commands based on runtime
+ */
+export function getGitExecutable() {
+    // On Windows, use git.exe
+    if (process.platform === 'win32') {
+        return 'git.exe';
+    }
+    // On Unix-like systems, use git
+    return 'git';
+}
+/**
+ * Check if the runtime supports native performance optimizations
+ */
+export function supportsNativeOptimizations() {
+    const { runtime } = detectRuntime();
+    return runtime === 'bun';
+}
+/**
+ * Get runtime-specific performance recommendations
+ */
+export function getPerformanceRecommendations() {
+    const { runtime, version } = detectRuntime();
+    const recommendations = [];
+    if (runtime === 'node') {
+        recommendations.push('Consider using Bun runtime for 42% better performance');
+        const majorVersion = parseInt(version.split('.')[0] || '0');
+        if (majorVersion < 20) {
+            recommendations.push('Upgrade to Node.js 20+ for better performance');
+        }
+    }
+    else if (runtime === 'bun') {
+        recommendations.push('Using optimal Bun runtime');
+    }
+    else {
+        recommendations.push('Unknown runtime - performance may vary');
+    }
+    return recommendations;
+}
+/**
+ * Log runtime information for debugging
+ */
+export function logRuntimeInfo() {
+    const { runtime, version } = detectRuntime();
+    console.debug(`Running on ${runtime} ${version}`);
+}
+//# sourceMappingURL=runtime.js.map

package/dist/utils/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../src/utils/runtime.ts"],"names":[],"mappings":"AAAA;;GAEG;AAWH;;GAEG;AACH,MAAM,UAAU,aAAa;IAC3B,gBAAgB;IAChB,IAAI,OAAO,UAAU,KAAK,WAAW,IAAI,KAAK,IAAI,UAAU,EAAE,CAAC;QAC7D,2DAA2D;QAC3D,MAAM,UAAU,GAAI,UAAkB,CAAC,GAAG,EAAE,OAAO,IAAI,SAAS,CAAC;QACjE,OAAO;YACL,OAAO,EAAE,KAAK;YACd,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,IAAI;YACX,MAAM,EAAE,KAAK;SACd,CAAC;IACJ,CAAC;IAED,oBAAoB;IACpB,IAAI,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QAChF,OAAO;YACL,OAAO,EAAE,MAAM;YACf,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,IAAI;YAC9B,KAAK,EAAE,KAAK;YACZ,MAAM,EAAE,IAAI;SACb,CAAC;IACJ,CAAC;IAED,kBAAkB;IAClB,OAAO;QACL,OAAO,EAAE,SAAS;QAClB,OAAO,EAAE,SAAS;QAClB,KAAK,EAAE,KAAK;QACZ,MAAM,EAAE,KAAK;KACd,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC9B,0BAA0B;IAC1B,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACjC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,gCAAgC;IAChC,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,2BAA2B;IACzC,MAAM,EAAE,OAAO,EAAE,GAAG,aAAa,EAAE,CAAC;IACpC,OAAO,OAAO,KAAK,KAAK,CAAC;AAC3B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,6BAA6B;IAC3C,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,aAAa,EAAE,CAAC;IAC7C,MAAM,eAAe,GAAa,EAAE,CAAC;IAErC,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;QACvB,eAAe,CAAC,IAAI,CAAC,uDAAuD,CAAC,CAAC;QAC9E,MAAM,YAAY,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;QAC5D,IAAI,YAAY,GAAG,EAAE,EAAE,CAAC;YACtB,eAAe,CAAC,IAAI,CAAC,+CAA+C,CAAC,CAAC;QACxE,CAAC;IACH,CAAC;SAAM,IAAI,OAAO,KAAK,KAAK,EAAE,CAAC;QAC7B,eAAe,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;IACpD,CAAC;SAAM,CAAC;QACN,eAAe,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAC;IACjE,CAAC;IAED,OAAO,eAAe,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,aAAa,EAAE,CAAC;IAC7C,OAAO,CAAC,KAAK,CAAC,cAAc,OAAO,IAAI,OAAO,EAAE,CAAC,CAAC;AACpD,CAAC","sourcesContent":["/**\n * Runtime detection utilities for optimizing performance based on the JavaScript runtime\n */\n\nexport type Runtime = 'node' | 'bun' | 'unknown';\n\ninterface RuntimeInfo {\n  runtime: Runtime;\n  version: string;\n  isBun: boolean;\n  isNode: boolean;\n}\n\n/**\n * Detect the current JavaScript runtime\n */\nexport function detectRuntime(): RuntimeInfo {\n  // Check for Bun\n  if (typeof globalThis !== 'undefined' && 'Bun' in globalThis) {\n    // @ts-ignore - Bun is a global when running in Bun runtime\n    const bunVersion = (globalThis as any).Bun?.version || 'unknown';\n    return {\n      runtime: 'bun',\n      version: bunVersion,\n      isBun: true,\n      isNode: false,\n    };\n  }\n\n  // Check for Node.js\n  if (typeof process !== 'undefined' && process.versions && process.versions.node) {\n    return {\n      runtime: 'node',\n      version: process.versions.node,\n      isBun: false,\n      isNode: true,\n    };\n  }\n\n  // Unknown runtime\n  return {\n    runtime: 'unknown',\n    version: 'unknown',\n    isBun: false,\n    isNode: false,\n  };\n}\n\n/**\n * Get the optimal executable for git commands based on runtime\n */\nexport function getGitExecutable(): string {\n  // On Windows, use git.exe\n  if (process.platform === 'win32') {\n    return 'git.exe';\n  }\n\n  // On Unix-like systems, use git\n  return 'git';\n}\n\n/**\n * Check if the runtime supports native performance optimizations\n */\nexport function supportsNativeOptimizations(): boolean {\n  const { runtime } = detectRuntime();\n  return runtime === 'bun';\n}\n\n/**\n * Get runtime-specific performance recommendations\n */\nexport function getPerformanceRecommendations(): string[] {\n  const { runtime, version } = detectRuntime();\n  const recommendations: string[] = [];\n\n  if (runtime === 'node') {\n    recommendations.push('Consider using Bun runtime for 42% better performance');\n    const majorVersion = parseInt(version.split('.')[0] || '0');\n    if (majorVersion < 20) {\n      recommendations.push('Upgrade to Node.js 20+ for better performance');\n    }\n  } else if (runtime === 'bun') {\n    recommendations.push('Using optimal Bun runtime');\n  } else {\n    recommendations.push('Unknown runtime - performance may vary');\n  }\n\n  return recommendations;\n}\n\n/**\n * Log runtime information for debugging\n */\nexport function logRuntimeInfo(): void {\n  const { runtime, version } = detectRuntime();\n  console.debug(`Running on ${runtime} ${version}`);\n}"]}

package/docs/ARCHITECTURE.md

@@ -0,0 +1,336 @@
+# Architecture
+
+This document describes the technical architecture and design decisions for Claude Statusline v2.0.
+
+## Overview
+
+Claude Statusline is a TypeScript CLI tool that provides git status indicators and environment context for Claude Code. The architecture prioritizes:
+
+- **Performance**: Native JavaScript optimizations over bash interpretation
+- **Security**: Type safety and input validation
+- **Modularity**: Clean separation of concerns
+- **Maintainability**: Testable, documented code
+
+## Project Structure
+
+```
+claude-statusline/
+├── src/                           # TypeScript source code
+│   ├── core/                      # Core functionality
+│   │   ├── config.ts             # Configuration management with Zod validation
+│   │   ├── security.ts           # Input validation and sanitization
+│   │   └── cache.ts              # TTL-based caching system
+│   ├── git/                       # Git operations
+│   │   └── status.ts             # Git status parsing and indicator formatting
+│   ├── ui/                        # User interface components
+│   │   ├── symbols.ts            # Symbol detection and Nerd Font support
+│   │   └── width.ts              # Terminal width detection and text truncation
+│   ├── env/                       # Environment detection
+│   │   └── context.ts            # Development tool version detection
+│   └── index.ts                   # Main entry point
+├── bin/                           # Executable wrappers
+│   └── claude-statusline         # Main executable with shebang
+├── tests/                         # Test suite
+├── scripts/                       # Development utilities
+│   └── benchmark.js              # Performance benchmarking
+└── dist/                          # Compiled JavaScript (generated)
+```
+
+## Core Modules
+
+### Configuration System (`core/config.ts`)
+
+**Purpose**: Centralized configuration management with validation
+
+**Features**:
+- **Zod schema validation** for runtime type safety
+- **Multiple config sources**: Files (JSON/YAML), environment variables, defaults
+- **Hierarchical precedence**: CLI args > env vars > config files > defaults
+- **Backward compatibility** with v1.0 environment variables
+
+**Key Design Decisions**:
+- Use Zod for both compile-time (TypeScript) and runtime validation
+- Support both JSON and YAML for user preference
+- Environment variable inheritance for smooth v1.0 → v2.0 migration
+
+```typescript
+const ConfigSchema = z.object({
+  cacheTTL: z.number().default(300),
+  noEmoji: z.boolean().default(false),
+  // ... other config fields
+});
+```
+
+### Security Module (`core/security.ts`)
+
+**Purpose**: Input validation and sanitization
+
+**Features**:
+- **JSON input validation** with structure and length checks
+- **Path traversal prevention** with comprehensive pattern matching
+- **Command injection protection** for all shell interactions
+- **String sanitization** for safe display
+
+**Security Layers**:
+1. **TypeScript compile-time** type checking
+2. **Zod runtime** validation
+3. **Custom validation** functions for security-critical inputs
+4. **Sanitization** before display or processing
+
+### Caching System (`core/cache.ts`)
+
+**Purpose**: Performance optimization with TTL-based caching
+
+**Features**:
+- **File-based caching** with automatic cleanup
+- **TTL support** per cache entry
+- **Parallel operations** for performance
+- **Cache statistics** for monitoring
+
+**Cache Strategy**:
+- **Tool versions**: 5-minute TTL (Node.js, Python)
+- **Docker version**: 30-minute TTL (less frequent changes)
+- **Git information**: 1-minute TTL (branch can change frequently)
+
+### Git Operations (`git/status.ts`)
+
+**Purpose**: Git repository status parsing and indicator generation
+
+**Dependencies**: `simple-git` library for cross-platform git operations
+
+**Features**:
+- **Comprehensive status parsing**: staged, unstaged, untracked, conflicts
+- **Remote tracking**: ahead/behind status detection
+- **Multiple git methods**: fallbacks for different git versions
+- **Cross-platform compatibility**: Windows, macOS, Linux
+
+**Status Parsing Logic**:
+```typescript
+// Parse git --porcelain format
+// XY PATH where X=staged, Y=unstaged
+if (stagedChar === 'M') indicators.staged++;
+if (unstagedChar === 'M') indicators.modified++;
+// ... handle all cases
+```
+
+### Symbol Management (`ui/symbols.ts`)
+
+**Purpose**: Terminal font detection and symbol selection
+
+**Features**:
+- **Nerd Font auto-detection** with multiple methods
+- **ASCII fallback** symbol sets
+- **Terminal-specific detection** (VSCode, iTerm, etc.)
+- **Platform-specific font detection**
+
+**Detection Methods**:
+1. **Environment variables**: `NERD_FONT=1`, `TERM_PROGRAM`
+2. **Font list analysis**: `fc-list`, `system_profiler`
+3. **Installation patterns**: Common Nerd Font locations
+4. **Terminal heuristics**: Known Nerd Font-capable terminals
+
+### Width Management (`ui/width.ts`)
+
+**Purpose**: Terminal width detection and text truncation
+
+**Features**:
+- **Multiple width detection methods** with fallbacks
+- **Smart truncation** with branch prioritization
+- **Soft wrapping** support for long content
+- **Responsive design** for different terminal sizes
+
+**Width Detection Priority**:
+1. **Manual override**: `CLAUDE_CODE_STATUSLINE_FORCE_WIDTH`
+2. **Environment**: `COLUMNS`, `CLAUDE_CODE_TERMINAL_WIDTH`
+3. **Node.js**: `process.stdout.columns`
+4. **System commands**: `tput cols`, `stty size`
+5. **Terminal defaults**: Based on `TERM_PROGRAM`, `TERM`
+
+### Environment Detection (`env/context.ts`)
+
+**Purpose**: Development tool version detection and caching
+
+**Features**:
+- **Parallel version detection** for performance
+- **Cross-platform command execution**
+- **Intelligent caching** with different TTL per tool
+- **Graceful fallbacks** for missing tools
+
+**Supported Tools**:
+- **Node.js**: `node --version`
+- **Python**: `python3 --version` → `python --version`
+- **Docker**: `docker --version`
+
+## Data Flow
+
+```
+Claude Code Input
+       ↓
+   Security Validation
+       ↓
+   Configuration Loading
+       ↓
+┌─────────────────────────┐
+│  Parallel Operations    │
+├─────────┬───────────────┤
+│ Git     │ Environment   │
+│ Status  │ Detection     │
+└─────────┴───────────────┘
+       ↓
+   Symbol Selection
+       ↓
+   Width Detection
+       ↓
+   Statusline Assembly
+       ↓
+   Output to Claude Code
+```
+
+## Performance Considerations
+
+### Native JavaScript Optimizations
+
+**v2.0 vs v1.0 Performance Gains**:
+- **JSON parsing**: Native `JSON.parse()` vs bash regex
+- **Parallel execution**: `Promise.all()` vs sequential bash commands
+- **Caching**: Built-in Node.js caching vs file operations
+- **String operations**: Optimized V8 engine vs bash string manipulation
+
+### Caching Strategy
+
+**Cache Hierarchy**:
+1. **In-memory**: Process-level caching during execution
+2. **File-based**: Persistent cache across executions
+3. **TTL-based**: Automatic cache invalidation
+
+**Cache Keys**:
+- Environment versions: `node_version`, `python3_version`
+- Git information: `git_branch_<base64_dir>`, `git_remote_<base64_dir>`
+
+### Memory Management
+
+- **Minimal memory footprint**: Stream processing where possible
+- **Efficient data structures**: Use appropriate TypeScript types
+- **Cache cleanup**: Automatic TTL-based expiration
+
+## Security Architecture
+
+### Input Validation Layers
+
+1. **TypeScript**: Compile-time type checking
+2. **Zod**: Runtime schema validation
+3. **Custom validation**: Security-specific checks
+4. **Sanitization**: Output sanitization
+
+### Threat Model
+
+**Protected Against**:
+- **Command injection**: All shell commands use parameterized execution
+- **Path traversal**: Comprehensive path validation
+- **Buffer overflow**: Length limits on all inputs
+- **Code injection**: JSON parsing with structure validation
+
+**Assumptions**:
+- **Claude Code input is trusted** but validated
+- **File system access is limited** to user directories
+- **Network access is not required** for core functionality
+
+## Cross-Platform Compatibility
+
+### Platform-Specific Considerations
+
+**Windows**:
+- **Path handling**: Backward/forward slashes
+- **Command execution**: `cmd.exe` vs `powershell`
+- **Font detection**: Windows-specific font locations
+- **Terminal detection**: Windows Terminal, ConHost
+
+**macOS**:
+- **Font detection**: Homebrew Nerd Font installations
+- **Command availability**: BSD vs GNU command variants
+- **File permissions**: Executable bit handling
+
+**Linux**:
+- **Font detection**: Fontconfig, system fonts
+- **Terminal diversity**: Wide range of terminal emulators
+- **Package managers**: Different font installation methods
+
+### Compatibility Strategy
+
+1. **Node.js API**: Use cross-platform Node.js modules
+2. **Conditional logic**: Platform-specific code paths where needed
+3. **Fallbacks**: Multiple methods for critical operations
+4. **Testing**: Multi-platform testing in CI/CD
+
+## Testing Strategy
+
+### Test Categories
+
+1. **Unit Tests**: Individual module functionality
+2. **Integration Tests**: Module interaction testing
+3. **Security Tests**: Input validation and attack prevention
+4. **Performance Tests**: Benchmarking against baseline
+5. **Cross-Platform Tests**: Compatibility verification
+
+### Test Structure
+
+```
+tests/
+├── security.test.ts      # Security validation tests
+├── runner.test.ts        # Main functionality tests
+├── git/                  # Git operation tests
+├── core/                 # Core module tests
+├── ui/                   # UI component tests
+└── env/                  # Environment detection tests
+```
+
+## Future Extensibility
+
+### Plugin Architecture (Planned)
+
+**Design Goals**:
+- **Modular plugins**: Easy to add new indicators
+- **Configuration-driven**: Plugin enable/disable via config
+- **Performance isolation**: Plugin failures don't affect core
+- **Type safety**: Plugin interface definitions
+
+**Plugin Interface Sketch**:
+```typescript
+interface StatuslinePlugin {
+  name: string;
+  version: string;
+  execute(context: PluginContext): Promise<string | null>;
+}
+```
+
+### Configuration Schema Evolution
+
+**Backward Compatibility**:
+- **Schema versioning**: Config format versioning
+- **Migration paths**: Automatic config upgrades
+- **Fallback handling**: Graceful degradation for old configs
+
+## Dependencies
+
+### Runtime Dependencies
+
+- **simple-git**: Git operations with cross-platform support
+- **zod**: Runtime type validation and schema definition
+- **yaml**: YAML configuration file support
+
+### Development Dependencies
+
+- **TypeScript**: Type safety and modern JavaScript features
+- **ESLint + Prettier**: Code quality and formatting
+- **Node.js test runner**: Native testing framework
+
+### Dependency Strategy
+
+- **Minimal dependencies**: Only essential runtime dependencies
+- **Well-maintained packages**: Active development and security
+- **Alternative options**: Multiple packages considered for each need
+- **Security scanning**: Regular dependency vulnerability scans
+
+---
+
+This architecture is designed to balance performance, security, and maintainability while providing a solid foundation for future enhancements.

package/docs/FEATURE_COMPARISON.md

@@ -0,0 +1,178 @@
+# Feature Comparison: TypeScript v2.0 vs Bash v1.0
+
+Comprehensive comparison between Bash v1.0 and TypeScript v2.0 implementations.
+
+**Ready to upgrade?** See the [Migration Guide](./MIGRATION.md) for step-by-step instructions.
+
+## Performance Overview
+
+| Version | Execution Time | Performance | Notes |
+|---------|----------------|-------------|-------|
+| **TypeScript v2.0** | **~5ms (Bun) / ~28ms (Node.js)** | ✅ Excellent | Native JS optimizations |
+| Bash v1.0 | ~99ms | ✅ Good | Optimized bash implementation |
+| Bash v1.0 (first run) | ~888ms | ⚠️ Slow | One-time cache population |
+
+## Feature Matrix
+
+| Feature | Bash v1.0 | TypeScript v2.0 | Notes |
+|---------|-----------|------------------|-------|
+| **Core Functionality** |
+| Git status indicators | ✅ | ✅ | Branch, staged, modified, untracked, etc. |
+| Environment context | ✅ | ✅ | Node.js, Python, Docker versions |
+| Smart truncation | ✅ | ✅ | Prevents statusline overflow |
+| ASCII/Nerd Font detection | ✅ | ✅ | Auto-detects terminal capabilities |
+| Security validation | ✅ | ✅ | Input validation, path sanitization |
+| Soft-wrapping | ✅ | ✅ | Advanced text wrapping options |
+| **Configuration** |
+| Environment variables | ✅ | ✅ | Legacy support in both |
+| Configuration files | ❌ | ✅ | `.claude-statusline.json/.yaml` |
+| JSON Schema validation | ❌ | ✅ | Editor autocompletion & validation |
+| Project-specific configs | ❌ | ✅ | Override global settings |
+| **Platform Support** |
+| Linux/macOS | ✅ | ✅ | Full support |
+| Windows | ❌ | ✅ | Native Node.js support |
+| Cross-platform caching | ✅ | ✅ | Both have caching systems |
+| **Distribution** |
+| Manual download | ✅ | ✅ | Download from releases |
+| npm distribution | ❌ | ✅ | `npm install -g claude-statusline` |
+| bun distribution | ❌ | ✅ | `bun install -g claude-statusline` |
+| **Development Experience** |
+| TypeScript types | ❌ | ✅ | Full type safety |
+| Editor integration | ❌ | ✅ | JSON Schema support |
+| Debug options | ✅ | ✅ | Enhanced debugging in v2.0 |
+| Unit tests | ✅ | ✅ | Both have test suites |
+| **Advanced Features** |
+| Width debugging | ❌ | ✅ | `debugWidth` option |
+| Force width override | ❌ | ✅ | `forceWidth` option |
+| Configurable symbols | ❌ | ✅ | Custom Nerd Font/ASCII symbols |
+| YAML config support | ❌ | ✅ | Alternative config format |
+| Cache management | ✅ | ✅ | TTL-based caching |
+
+## Detailed Feature Breakdown
+
+### Core Git Status Features
+
+Both versions provide comprehensive git status:
+
+| Indicator | Bash v1.0 | TypeScript v2.0 | Symbol |
+|-----------|-----------|------------------|--------|
+| Stashed changes | ✅ | ✅ | ⚑ / $ |
+| Staged files | ✅ | ✅ | + |
+| Modified files | ✅ | ✅ | ! |
+| Untracked files | ✅ | ✅ | ? |
+| Renamed files | ✅ | ✅ | » / > |
+| Deleted files | ✅ | ✅ | ✘ / X |
+| Merge conflicts | ✅ | ✅ | × / C |
+| Ahead of upstream | ✅ | ✅ | ↑ / A |
+| Behind upstream | ✅ | ✅ | ↓ / B |
+| Diverged branches | ✅ | ✅ | ⇕ / D |
+
+### Configuration Capabilities
+
+#### Bash v1.0
+- Environment variables only
+- Limited customization options
+- No persistent configuration storage
+
+#### TypeScript v2.0
+- Configuration files with JSON Schema validation
+- Project-specific overrides
+- Rich customization options
+- Multiple config formats (JSON/YAML)
+
+### Platform Compatibility
+
+#### Bash v1.0
+- ✅ Linux
+- ✅ macOS
+- ❌ Windows (requires WSL)
+- ❌ Limited Windows Subsystem support
+
+#### TypeScript v2.0
+- ✅ Linux
+- ✅ macOS
+- ✅ Windows (native)
+- ✅ Cross-platform Node.js runtime
+
+### Distribution Methods
+
+#### Bash v1.0
+- Manual download from GitHub releases
+- Direct script execution
+- Self-contained bash script
+
+#### TypeScript v2.0
+- npm registry (`npm install -g claude-statusline`)
+- bun package manager (`bun install -g claude-statusline`)
+- GitHub releases (compiled binaries)
+
+### Development & Debugging
+
+#### Bash v1.0
+- Manual debugging with `bash -x`
+- Basic logging capabilities
+- Limited tooling support
+
+#### TypeScript v2.0
+- Built-in debugging options (`debugWidth`)
+- Comprehensive test suite
+- VS Code integration via JSON Schema
+- TypeScript development experience
+
+## Migration Decision Guide
+
+### Stay with Bash v1.0 if:
+- ✅ You need maximum stability
+- ✅ You prefer bash-only solutions
+- ✅ You're on Linux/macOS only
+- ✅ You want minimal dependencies
+- ✅ You're comfortable with environment variables
+
+### Upgrade to TypeScript v2.0 if:
+- ✅ You need Windows support
+- ✅ You want configuration files
+- ✅ You prefer npm package management
+- ✅ You want better performance
+- ✅ You need advanced customization
+- ✅ You want TypeScript development tools
+
+### Gradual Migration Path:
+1. **Install TypeScript v2.0** alongside bash v1.0
+2. **Copy your environment variables** to a config file
+3. **Test with your current workflow**
+4. **Switch when ready**
+
+## Performance Benchmarks
+
+Based on typical usage scenarios:
+
+| Scenario | Bash v1.0 | TypeScript v2.0 | Improvement |
+|----------|-----------|------------------|-------------|
+| **Cold start** | 888ms | 45ms | **19.5x faster** |
+| **Warm start** | 99ms | 30ms | **3.3x faster** |
+| **No git status** | 37ms | 15ms | **2.5x faster** |
+| **Environment context** | 77ms | 25ms | **3.1x faster** |
+
+## Compatibility Matrix
+
+| Use Case | Bash v1.0 | TypeScript v2.0 | Recommendation |
+|---------|-----------|------------------|----------------|
+| **Linux CLI user** | ✅ Perfect | ✅ Perfect | Either works |
+| **macOS CLI user** | ✅ Perfect | ✅ Perfect | Either works |
+| **Windows user** | ❌ No support | ✅ Perfect | **Use v2.0** |
+| **npm/bun user** | ❌ Manual install | ✅ Native install | **Use v2.0** |
+| **Configuration files** | ❌ Not supported | ✅ Full support | **Use v2.0** |
+| **Minimal dependencies** | ✅ Bash only | ✅ Node.js only | Either works |
+| **Maximum performance** | ✅ Good | ✅ Excellent | **Prefer v2.0** |
+
+## Summary
+
+**TypeScript v2.0 represents a significant evolution** while maintaining full backward compatibility with the core features that made bash v1.0 successful. The main advantages are:
+
+- **19.5x performance improvement** on cold start
+- **Native Windows support**
+- **Modern configuration system**
+- **Package manager integration**
+- **Enhanced development experience**
+
+**Bash v1.0 remains viable** for users who prefer maximum stability and minimal dependencies on Unix-like systems.