@kikkimo/claude-launcher 2.4.0 → 3.0.0

package/CHANGELOG.md

@@ -5,6 +5,77 @@ 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).
 
+## [3.0.0] - 2026-04-07
+
+### Added
+- **ANSI Screen Rendering Layer**: Full terminal rendering rewrite using alternate screen buffer (`\x1b[?1049h`) and absolute cursor positioning (`\x1b[H\x1b[2J`). Eliminates all position drift across page transitions. Program runs in isolated screen like vim/htop; exit restores original terminal content.
+  - New `lib/ui/screen.js` singleton: `render()`, `write()`, `enter()`, `exit()`, `exitForHandoff()`, `debug()`, `showCursor()`/`hideCursor()`, `setReadlineActive()`, `isActive()`
+  - Test mode (`SCREEN_TEST=1`): source-tagged write interception for automated leak detection
+  - Degradation: non-TTY passthrough, `SCREEN_NO_ALT=1` manual override
+- **Edit API Feature**: New menu item to modify API name, provider, base URL, and model (API key not editable)
+  - Field-by-field editing with per-field validation (reuses Add API validators)
+  - Provider selection via preset list (not free text), preserves provider-specific envVars/timeout/upgrade detection
+  - Provider/URL mismatch warning in field menu hint area
+  - Auto-save per field edit with success/cancel feedback
+- **Unified Password Guard**: Shared `passwordGuard()` function protects delete, edit, import, export operations
+  - Mode A (delete/edit): guard at dispatch layer with header display
+  - Mode B (export/import): guard inside handler after title page
+  - Handles wrong password, empty password, Esc cancel, Ctrl+C delegation distinctly
+  - Defense-in-depth: export/import return false when no password set
+- **API Table Pagination**: ←→ page navigation for API selection tables (remove/switch/edit)
+  - Dynamic items-per-page based on terminal height
+  - Per-page selection memory across page switches
+  - 3 pure testable helpers: `calculatePagination()`, `initPaginationState()`, `handlePageKeyPress()`
+  - Legacy >99 API defensive guard with display truncation + warning
+- **API Count Limit**: Maximum 99 APIs enforced in `addApi()` and import path
+- **Launch Handoff Lifecycle**: Clean `screen.exitForHandoff()` → normal terminal output → `relinquishConsoleToChild()` → spawn sequence
+  - `handleLaunchFailure()` promoted to module-level with `rollbackFn(errorMessage)` callback chain
+  - Pre-handoff errors show in alt-screen; post-handoff errors use press-key + 60s timeout + exit
+- **Menu Hint Enhancements**: Password-required hints (🔒) for edit/remove/export/import when password is set
+- **Navigation i18n**: Action words (edit/remove/switch/select) fully localized across 11 locales
+
+### Changed
+- **All Terminal Output**: 462 direct `console.clear/log/error/warn` and `process.stdout.write` calls replaced with `screen.render()`/`screen.write()`/`screen.debug()` across 12 files
+- **Menu Component**: `displayMenu()` and `navigate()` now use `screen.render()` for absolute positioning; `clearScreen` parameter removed from `navigate()` signature
+- **Interactive Table**: Refactored to `screen.render()` with pagination support; action text localized via i18n keys
+- **Signal Ownership**: Global SIGINT handler respects `handleCtrlC()` return value (first Ctrl+C = warning only); SIGTERM/uncaughtException/unhandledRejection handlers call `screen.exit()` before exit
+- **Launcher Lifecycle**: `relinquishConsoleToChild()` moved before `spawn()` for clean handoff; `updateApiModel()` delegates to `updateApiField()` for unified validation
+- **Default Config Language**: Changed from `zh` to `en` in `loadConfig()`/`loadConfigSync()` to match `LanguageManager` default; config file written on first run
+- **Hint Area Spacing**: Extra space after ℹ icon; multi-line hint indentation aligned
+
+### Fixed
+- **First-run Language Bug**: Deleting config and restarting no longer switches from English to Chinese on second launch
+- **Field Menu CJK Alignment**: Label padding uses `getStringWidth()`/`padStringToWidth()` for correct CJK character width
+
+## [2.5.0] - 2026-03-31
+
+### Added
+- **Claude Auto Mode Support**: New menu item "Launch Claude Code (Enable Auto Mode)" using `--enable-auto-mode` flag
+  - Enables auto mode as a selectable permission mode (switch with Shift+Tab in session)
+  - Currently supports Team plan; Enterprise/API plans rolling out
+- **Dynamic Menu Hints**: Context-sensitive hints displayed below the main menu based on selected item
+  - Auto Mode item: Shows plan support info and Shift+Tab usage instruction
+  - Third-party API items: Shows active API provider/model or prompts to configure
+  - Hints auto-hide when selecting other menu items
+- **GLM-5.1 & GLM-5-Turbo Models**: Added latest ZhiPu AI models for both `zhipu` and `zai` providers
+  - New models: `glm-5.1` (latest), `glm-5-turbo`
+  - Removed deprecated: `glm-4.5`, `glm-4.6`
+  - All older models now suggest upgrade to `glm-5.1`
+- **Kimi K2.5 Model**: Added latest Moonshot AI model for `moonshot` provider
+  - New model: `kimi-k2.5` (latest, multimodal, 256K context)
+  - Removed deprecated: `kimi-k2-0711-preview`, `kimi-k2-0905-preview`, `kimi-k2-turbo-preview`
+  - All older models now suggest upgrade to `kimi-k2.5`
+- **MiniMax M2.7 & M2.5 Models**: Added latest MiniMax models for both `minimax_cn` and `minimax_global` providers
+  - New models: `MiniMax-M2.7` (latest), `MiniMax-M2.5`
+  - Older models now suggest upgrade to `MiniMax-M2.7`
+- **Automated Test Suite**: Added test infrastructure with `npm test` entry point
+  - Provider model configuration tests (28 tests)
+  - Menu hintCallback rendering tests including navigate() stub tests (8 tests)
+
+### Changed
+- **Menu Structure**: Main menu now has 9 items (was 8), with Auto Mode at position 3
+- **i18n**: All 11 locale files updated with 4 new translation keys for Auto Mode and hints
+
 ## [2.4.0] - 2026-02-12
 
 ### Added

package/README.md

@@ -13,24 +13,29 @@ An elegant interactive launcher for Claude Code with a beautiful Claude-style in
 
 ### 🎨 **Beautiful Interface**
 - Claude-style interface with authentic orange/amber color scheme
+- ANSI alternate screen buffer for drift-free rendering (like vim/htop)
 - Arrow key navigation with smooth menu transitions
+- Paginated API tables with ←→ page navigation for large API lists
 - 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
+- Unified password guard for high-risk operations (edit, delete, import, export)
 - 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, MiniMax, GLM/ZhiPu AI, and custom APIs)
+- Full support for multiple third-party API providers (Anthropic, DeepSeek, Kimi K2.5, MiniMax M2.7, GLM-5.1/ZhiPu AI, and custom APIs)
 - Interactive API configuration with validation
+- **Edit API**: Modify name, provider, base URL, and model for existing APIs
 - API usage statistics with success/failure tracking
 - Model upgrade notifications and auto-upgrade support
 - Secure configuration backup and restore
 - Easy API switching, removal, and bulk clear
+- Maximum 99 APIs supported per configuration
 
 ### 🌍 **Enterprise-grade Features**
 - Global installation - use `claude-launcher` from anywhere
@@ -84,23 +89,25 @@ node claude-launcher
 
 1. **Launch Claude Code** - Standard Claude Code launch
 2. **Launch Claude Code (Skip Permissions)** - Launch with `--dangerously-skip-permissions`
-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** - Full API lifecycle management:
-   - Add, switch, and remove APIs
+3. **Launch Claude Code (Enable Auto Mode)** - Launch with `--enable-auto-mode` for classifier-gated auto approvals (Team plan; Shift+Tab to switch)
+4. **Launch Claude Code with Third-party API** - Use configured third-party API
+5. **Launch Claude Code with Third-party API (Skip Permissions)** - Combine third-party API with permission skipping
+6. **Third-party API Management** - Full API lifecycle management:
+   - Add, edit, switch, and remove APIs
    - View usage statistics with success/failure rates
    - Model upgrade settings (auto/manual upgrade)
-   - Import/export configurations
-6. **Language Settings** - Switch between 11 supported languages
-7. **Version Update Check** - Check for launcher updates
-8. **Exit** - Close the launcher
+   - Import/export configurations (password-protected)
+7. **Configuration Management** - Language, telemetry, launch mode, model upgrade settings
+8. **Version Update Check** - Check for launcher updates
+9. **Exit** - Close the launcher
 
 ### Interactive Navigation
 
-- **Arrow Keys**: Use ↑↓ to navigate, Enter to select
-- **Escape Key**: Press Esc to go back or exit
+- **Arrow Keys**: Use ↑↓ to navigate, ←→ to switch pages (in paginated tables), Enter to select
+- **Escape Key**: Press Esc to go back or cancel
+- **Ctrl+C**: First press shows warning, second press exits cleanly
 - **Multi-language**: All interface text adapts to your selected language
-- **Smart Tables**: Interactive tables for API management with clear visual feedback
+- **Smart Tables**: Paginated interactive tables for API management with per-page selection memory
 
 ### Example Session
 
@@ -115,10 +122,11 @@ $ claude-launcher
 
   → Launch Claude Code
     Launch Claude Code (Skip Permissions)
+    Launch Claude Code (Enable Auto Mode)
     Launch Claude Code with Third-party API
     Launch Claude Code with Third-party API (Skip Permissions)
     Third-party API Management
-    Language Settings
+    Configuration Management
     Version Update Check
     Exit
 ```
@@ -131,12 +139,13 @@ Access comprehensive API management through the dedicated menu:
 📋 Third-party API Management
 
   → Add New API
+    Edit API            → Select API → Edit name/provider/URL/model
     Remove API          → Delete Single API / Clear All APIs
     Switch Active API
     View Statistics     → View Details / Reset Statistics
     Model Upgrade       → Auto Upgrade [ON/OFF] / Manual Upgrade
-    Export Configuration
-    Import Configuration
+    Export Configuration  🔒 (password required)
+    Import Configuration  🔒 (password required)
     Change Password
     Back to Main Menu
 ```
@@ -152,7 +161,7 @@ The launcher automatically checks for model upgrades when you start:
 
 ### Modern Configuration System
 
-Claude Launcher 2.0 uses an advanced configuration system:
+Claude Launcher uses an advanced configuration system:
 
 1. **Encrypted JSON Storage**: Configuration stored at `~/.claude-launcher-apis.json`
 2. **Interactive Setup**: First-time wizard guides you through all options
@@ -171,7 +180,7 @@ Claude Launcher 2.0 uses an advanced configuration system:
 
 Configure any third-party API provider through the interactive interface:
 
-- **Supported Providers**: Anthropic, OpenAI, DeepSeek, Moonshot/Kimi, MiniMax (CN/Global), GLM/ZhiPu AI (GLM-4, GLM-5), and custom Anthropic-compatible APIs
+- **Supported Providers**: Anthropic, DeepSeek, Moonshot/Kimi (K2.5), MiniMax (CN/Global, M2.7), GLM/ZhiPu AI (GLM-5.1), and custom Anthropic-compatible APIs
 - **Secure Storage**: All API tokens encrypted before storage
 - **Validation**: Real-time validation of URLs, tokens, and models
 - **Usage Tracking**: Monitor API usage statistics with success/failure rates
@@ -212,6 +221,12 @@ cd claude-launcher
 npm install
 ```
 
+### Running Tests
+
+```bash
+npm test
+```
+
 ### Testing Locally
 
 ```bash