@kikkimo/claude-launcher 1.0.0 → 2.1.0

package/CHANGELOG.md

@@ -5,6 +5,152 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.1.0] - 2025-10-27
+
+### Added
+- **GLM (ZhiPu AI) Provider Support**: Full integration for ZhiPu AI's GLM models with two provider options:
+  - `zhipu`: For mainland China users (智谱清言)
+  - `zai`: For international users (Z.ai Global)
+  - Support for GLM-4.5 and GLM-4.6 models
+  - Extended timeout configuration (50 minutes) for large response handling
+  - Optimized network traffic settings for better performance
+- **Moonshot Provider Enhancements**: Added extended timeout configuration and traffic optimization for Moonshot AI provider
+- **Enhanced Ctrl+C Interaction**: Comprehensive Ctrl+C handling with four distinct scenarios:
+  - Basic trigger with warning message display
+  - Auto-cancel after 3-second timeout
+  - Double Ctrl+C for immediate exit confirmation
+  - Any other key press to cancel warning and continue operation
+- **StdinManager Centralized Control**: New singleton class for unified stdin state management:
+  - Scope-based stdin acquisition with automatic cleanup
+  - Detach/reattach mechanism for proper scope isolation
+  - Suspension API for child process coordination
+  - Comprehensive Ctrl+C state tracking and handling
+- **Provider-specific Configuration System**: Dynamic provider configuration framework:
+  - Flexible environment variable configuration per provider
+  - Provider-specific optimization display with validation
+  - Internationalized provider notes and recommendations
+- **Complete i18n Coverage**: Extended internationalization support to all supported languages (English, Simplified Chinese, Traditional Chinese, German, French, Spanish, Italian, Portuguese, Japanese, Korean, Russian):
+  - Provider optimization messages (timeout, traffic control, custom variables)
+  - Provider-specific notes and recommendations
+  - Consistent terminology across all supported languages
+- **Automated Test Suites**: Comprehensive test coverage for stdin management:
+  - Interactive test scripts for manual validation
+  - Automated test scripts for CI/CD integration
+  - Test fixture files for isolated testing
+
+### Changed
+- **Provider Configuration Architecture**: Refactored from hardcoded switch statements to dynamic config lookup system
+- **Stdin Operations**: Migrated all stdin operations to use centralized StdinManager:
+  - Menu navigation
+  - Interactive tables
+  - Prompt inputs
+  - Confirmation dialogs
+  - Password input
+- **Console Control Handover**: Redesigned parent-child process coordination:
+  - Clean console relinquishment before launching Claude Code
+  - Suspension-aware SIGINT handling
+  - Proper console restoration after child process exit
+- **Error Handling**: Unified error handling with `handleLaunchFailure` function
+- **Ctrl+C Monitoring**: Disabled during Claude Code subprocess launch to prevent interception conflicts
+- **Test Configuration Files**: Renamed test-config.json to test-config.fixture for better semantic clarity
+
+### Fixed
+- **Stdin State Management**: Resolved critical hanging issues in CLI interaction:
+  - Fixed Promise deadlocks caused by cross-scope listener interference
+  - Eliminated dangerous `removeAllListeners` calls that destroyed active listeners
+  - Added proper timeout handling (60 seconds) for user input operations
+  - Fixed redundant isPaused check that incorrectly tested both property and method
+- **Listener Conflicts**: Prevented stdin listener conflicts between nested scopes:
+  - Implemented scope-aware listener management
+  - Added detach/reattach pattern for safe scope transitions
+  - Tracked active scope for accurate nested scope handling
+  - Fixed waitForKey listener removal bug causing Promise hangs on Ctrl+C
+- **Password Input**: Properly cleanup and reject Promise on Ctrl+C to prevent resource leaks
+- **Input Processing**: Fixed consecutive operation hangs (e.g., API switch followed by deletion)
+- **Ctrl+C Reliability**: Enhanced Ctrl+C responsiveness across all interfaces with proper state tracking
+- **Terminal State Cleanup**: Improved stdin cleanup before and after Claude Code launch
+- **Character Encoding**: Replaced mojibake characters (����, ��) with proper Unicode glyphs (↑↓, →) in menu
+- **ANSI Escape Sequences**: Added TTY checks to prevent ANSI codes from polluting non-TTY output (logs, CI/CD)
+- **Global Signal Handlers**: Removed dangerous `removeAllListeners('SIGINT/SIGTERM')` calls that could break other modules
+- **Timeout Display**: Added validation for API_TIMEOUT_MS parsing to prevent NaN display in provider optimizations
+- **Test File Tracking**: Removed incorrect .gitignore rules that prevented test files from being tracked
+- **Code Quality**: Removed unused variables and dead code from test files
+
+### Security
+- **Enhanced Secret Masking**: Expanded environment variable masking to detect and hide:
+  - API tokens, keys, secrets
+  - Passwords, credentials, authentication tokens
+  - Case-insensitive pattern matching for reliable detection
+  - Applied masking to both base and custom provider environment variables
+- **Consistent Security Protection**: Unified secret masking across all environment variable displays
+
+### Refactored
+- **Provider Environment Variables**: Moved from inline switch statements to provider configuration objects
+- **Stdin Management**: Complete migration to centralized StdinManager pattern across all modules
+- **Launch Logic**: Restructured Claude Code launching with clear control handover phases
+- **State Restoration**: Eliminated duplicate state restoration in StdinScope.release() for cleaner control flow
+- **Test Organization**: Improved test file naming conventions and structure
+
+### Documentation
+- **README Updates**: Documented GLM API support in both English and Chinese versions
+- **Provider Documentation**: Added comprehensive provider-specific feature descriptions
+- **Configuration Guide**: Enhanced API configuration documentation with provider-specific details
+
+## [2.0.0] - 2025-09-21
+
+### Added
+- **Multi-language Support**: Complete internationalization (i18n) system with support for English, Chinese, German, French, Japanese, Korean, Russian, and Spanish
+- **Third-party API Management**: Full support for multiple third-party API providers with secure configuration management
+- **Interactive API Selection Tables**: Beautiful table-based interface for API switching and removal operations
+- **Version Update Checking**: Automatic and manual version update detection with configurable check intervals
+- **Password-Protected Import/Export**: Secure configuration backup and restore with password encryption
+- **Modular Architecture**: Complete refactor to modular design with separated concerns:
+  - `ApiManager` class for API configuration management
+  - Dedicated authentication modules with password strength validation
+  - UI components for menus, prompts, and interactive tables
+  - Crypto utilities for secure data encryption
+  - Language management system with locale support
+- **Enhanced Menu System**: Global menu objects to prevent screen flickering during navigation
+- **API Usage Statistics**: Track and display API usage patterns and statistics
+- **Advanced Input Validation**: Comprehensive validation for URLs, auth tokens, and model configurations
+- **CJK Character Support**: Improved handling of Chinese, Japanese, and Korean characters in UI
+- **First-time Setup Wizard**: Guided setup process for new users with password configuration options
+
+### Changed
+- **Complete Architecture Overhaul**: Migrated from monolithic script to modular architecture with 28+ separate modules
+- **Enhanced Security Model**: Upgraded from basic encryption to industry-standard AES-256-CBC with machine-specific keys
+- **Improved User Experience**: Redesigned all user interactions with consistent Claude-style theming
+- **Better Error Handling**: Comprehensive error management with user-friendly messages in multiple languages
+- **Stdin Management**: Robust stdin cleanup and management to prevent navigation issues
+- **Menu Navigation**: Enhanced arrow key navigation with better state management
+- **Configuration Storage**: Migrated from `.env` files to encrypted JSON configuration format
+
+### Fixed
+- **Memory Leaks**: Resolved EventEmitter memory leaks in input handling
+- **Screen Flickering**: Eliminated menu recreation issues that caused display flickering
+- **Input State Management**: Fixed stdin cleanup issues that prevented proper navigation
+- **API Token Security**: Improved token masking and secure storage mechanisms
+- **Cross-platform Compatibility**: Enhanced support for different terminal environments
+- **Process Termination**: Better handling of Ctrl+C and graceful shutdown sequences
+- **Duplicate Detection**: Robust checking for duplicate API configurations
+- **Unicode Handling**: Fixed string width calculations for international characters
+
+### Refactored
+- **Code Organization**: Split monolithic launcher into focused, testable modules
+- **API Management**: Centralized API configuration handling with the `ApiManager` class
+- **Authentication System**: Dedicated password handling with strength validation
+- **UI Components**: Separated interface logic into reusable components
+- **Error Handling**: Centralized error management with consistent user feedback
+- **Import/Export Logic**: Streamlined configuration backup and restore processes
+- **Language System**: Implemented comprehensive i18n framework for multi-language support
+
+### Security
+- **Enhanced Encryption**: Upgraded to AES-256-CBC encryption for all sensitive data
+- **Password Strength Validation**: Enforced strong password requirements for configuration protection
+- **Secure Token Storage**: Improved API token encryption and masking in displays
+- **Machine-specific Keys**: Maintained machine-binding for configuration security
+- **Input Sanitization**: Enhanced validation for all user inputs to prevent security issues
+
 ## [1.0.0] - 2025-07-20
 
 ### Added

package/README.md

@@ -1,6 +1,8 @@
 # Claude Launcher
 
-An elegant interactive launcher for Claude Code with a beautiful Claude-style interface. Launch Claude Code with various configurations through an intuitive command-line menu.
+[![npm version](https://img.shields.io/npm/v/@kikkimo/claude-launcher.svg?style=flat-square)](https://www.npmjs.com/package/@kikkimo/claude-launcher) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](https://opensource.org/licenses/MIT) [![Node.js Version](https://img.shields.io/badge/node-%3E%3D20.0.0-brightgreen.svg?style=flat-square)](https://nodejs.org/) [![npm downloads](https://img.shields.io/npm/dm/@kikkimo/claude-launcher.svg?style=flat-square)](https://www.npmjs.com/package/@kikkimo/claude-launcher) [![DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/kikkimo/claude-launcher)
+
+An elegant interactive launcher for Claude Code with a beautiful Claude-style interface and comprehensive third-party API management. Launch Claude Code with various configurations through an intuitive multilingual command-line menu.
 
 ## 📖 Documentation
 
@@ -9,13 +11,33 @@ An elegant interactive launcher for Claude Code with a beautiful Claude-style in
 
 ## ✨ Features
 
-- 🎨 **Claude-style interface** with authentic orange/amber color scheme
-- ⌨️ **Arrow key navigation** with fallback to number selection
-- 🔐 **Encrypted API key storage** using AES-256-CBC encryption
-- 🚀 **Multiple launch options** including permission skipping and Kimi K2 API
-- 🌍 **Global installation** - use `claude-launcher` from anywhere
-- 🔧 **Smart configuration** - automatically finds/creates config files
-- 💻 **Cross-platform** - Windows, macOS, and Linux support
+### 🎨 **Beautiful Interface**
+- Claude-style interface with authentic orange/amber color scheme
+- Arrow key navigation with smooth menu transitions
+- Interactive tables for API selection and management
+- Multi-language support (English, Simplified Chinese, Traditional Chinese, German, French, Spanish, Italian, Portuguese, Japanese, Korean, Russian)
+
+### 🔐 **Advanced Security**
+- AES-256-CBC encryption for all sensitive data
+- Machine-specific encryption keys for enhanced security
+- Password-protected configuration import/export
+- Secure API token storage with masked display
+- Strong password requirements and validation
+
+### 🚀 **Third-party API Management**
+- Full support for multiple third-party API providers (OpenAI, Anthropic, DeepSeek, Kimi, GLM (ZhiPu AI), and more)
+- Interactive API configuration with validation
+- API usage statistics and tracking
+- Secure configuration backup and restore
+- Easy API switching and removal
+
+### 🌍 **Enterprise-grade Features**
+- Global installation - use `claude-launcher` from anywhere
+- Modular architecture with 28+ specialized modules
+- Comprehensive error handling and recovery
+- Version update checking with automatic notifications
+- Cross-platform support (Windows, macOS, Linux)
+- First-time setup wizard for new users
 
 ## 🚀 Quick Start
 
@@ -29,9 +51,12 @@ An elegant interactive launcher for Claude Code with a beautiful Claude-style in
    claude-launcher
    ```
 
-3. **For Kimi API users:** When prompted for the first time, enter your Kimi API key starting with `sk-`
+3. **First-time setup:** The launcher will guide you through:
+   - Language selection (11 languages available)
+   - Security setup (password configuration for import/export)
+   - Third-party API configuration (if desired)
 
-That's it! The launcher will guide you through the setup process.
+That's it! The intuitive interface will guide you through all available options.
 
 ## 📦 Installation
 
@@ -54,19 +79,23 @@ node claude-launcher
 
 ## 🎮 Usage
 
-### Available Launch Options
+### Available Options
 
 1. **Launch Claude Code** - Standard Claude Code launch
 2. **Launch Claude Code (Skip Permissions)** - Launch with `--dangerously-skip-permissions`
-3. **Launch Claude Code with Kimi K2 API** - Use Kimi API with encrypted storage
-4. **Launch Claude Code with Kimi K2 API (Skip Permissions)** - Combine Kimi API with permission skipping
-5. **Exit** - Close the launcher
+3. **Launch Claude Code with Third-party API** - Use configured third-party API
+4. **Launch Claude Code with Third-party API (Skip Permissions)** - Combine third-party API with permission skipping
+5. **Third-party API Management** - Configure, switch, remove APIs, view statistics
+6. **Language Settings** - Switch between 11 supported languages
+7. **Version Update Check** - Check for launcher updates
+8. **Exit** - Close the launcher
 
 ### Interactive Navigation
 
-- **Arrow Keys**: Use ↑↓ to navigate, Enter to select (in TTY environments)
-- **Number Selection**: Type 1-5 and press Enter (in non-TTY environments)
-- **Quick Exit**: Press Esc or Q to quit anytime
+- **Arrow Keys**: Use ↑↓ to navigate, Enter to select
+- **Escape Key**: Press Esc to go back or exit
+- **Multi-language**: All interface text adapts to your selected language
+- **Smart Tables**: Interactive tables for API management with clear visual feedback
 
 ### Example Session
 
@@ -81,44 +110,77 @@ $ claude-launcher
 
   → Launch Claude Code
     Launch Claude Code (Skip Permissions)
-    Launch Claude Code with Kimi K2 API
-    Launch Claude Code with Kimi K2 API (Skip Permissions)
+    Launch Claude Code with Third-party API
+    Launch Claude Code with Third-party API (Skip Permissions)
+    Third-party API Management
+    Language Settings
+    Version Update Check
     Exit
 ```
 
+### Third-party API Management
+
+Access comprehensive API management through the dedicated menu:
+
+```bash
+📋 Third-party API Management
+
+  → Add New API
+    Remove API
+    Switch Active API
+    View Statistics
+    Export Configuration
+    Import Configuration
+    Change Password
+    Back to Main Menu
+```
+
 ## ⚙️ Configuration
 
-### Automatic Configuration
+### Modern Configuration System
 
-On first run, if you select a Kimi API option and no configuration exists, the launcher will:
+Claude Launcher 2.0 uses an advanced configuration system:
 
-1. Automatically create a configuration file at `~/.claude-launcher.env`
-2. Guide you through entering your Kimi API key
-3. Encrypt and store your API key securely using machine-specific encryption
+1. **Encrypted JSON Storage**: Configuration stored at `~/.claude-launcher-apis.json`
+2. **Interactive Setup**: First-time wizard guides you through all options
+3. **Multi-language Support**: Interface adapts to your preferred language
+4. **Security First**: All sensitive data encrypted with AES-256-CBC
 
-### Manual Configuration
+### First-time Setup Process
 
-If you prefer to set up manually, the config file locations are searched in this order:
+1. **Language Selection**: Choose from 11 supported languages
+2. **Security Setup**:
+   - Set up password protection for import/export (recommended)
+   - Or skip for basic usage (limited features)
+3. **API Configuration**: Add third-party APIs as needed
 
-1. `.claude-launcher.env` in current directory
-2. `.claude-launcher.env` in your home directory
-3. `.claude-launcher.env` in the installation directory
+### Third-party API Configuration
 
-### Configuration File Format
+Configure any third-party API provider through the interactive interface:
 
-```env
-KIMI_API_KEY=your_encrypted_api_key_here
-KIMI_BASE_URL=https://api.moonshot.cn/anthropic/
-```
+- **Supported Providers**: OpenAI, Anthropic, DeepSeek, Kimi, GLM (ZhiPu AI), and custom APIs
+- **Secure Storage**: All API tokens encrypted before storage
+- **Validation**: Real-time validation of URLs, tokens, and models
+- **Usage Tracking**: Monitor API usage statistics
+- **Provider-specific Features**: Optimized configuration for each provider with helpful notes and recommendations
+
+### Configuration Import/Export
+
+With password protection enabled:
 
-**Note**: The `KIMI_API_KEY` is automatically encrypted when entered through the launcher. Do not manually edit encrypted values.
+- **Export**: Secure backup of all configurations
+- **Import**: Restore configurations on new machines
+- **Password Protected**: All exports encrypted with your password
+- **Automatic Validation**: Import validation ensures data integrity
 
-### Security Features
+### Enhanced Security Features
 
-- **AES-256-CBC Encryption**: API keys are encrypted using industry-standard encryption
-- **Machine-specific Keys**: Encryption keys are derived from machine-specific data
-- **Local Storage Only**: Encrypted keys cannot be decrypted on other machines
-- **Secure Input**: API key input supports copy/paste and validation
+- **AES-256-CBC Encryption**: All sensitive data encrypted with industry-standard algorithms
+- **Machine-specific Keys**: Encryption keys derived from unique machine characteristics
+- **Password Protection**: Optional password layer for configuration import/export
+- **Secure Token Display**: API tokens masked in all interface displays
+- **Strong Password Requirements**: Enforced password complexity for maximum security
+- **Local Storage Only**: All data remains on your machine, cannot be decrypted elsewhere
 
 ## 📋 Requirements
 
@@ -174,4 +236,4 @@ If you encounter any issues or have questions:
 
 ---
 
-**Note**: This launcher is designed to work with Claude Code and Kimi K2 API. Make sure you have Claude Code installed before using this tool.
+**Note**: This launcher is designed to work with Claude Code and various third-party APIs. Make sure you have Claude Code installed before using this tool. For third-party API usage, ensure you have valid API credentials from your preferred provider.