@kikkimo/claude-launcher 2.5.0 → 3.0.0

package/CHANGELOG.md

@@ -5,6 +5,48 @@ 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

package/README.md

@@ -13,13 +13,16 @@ 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
@@ -27,10 +30,12 @@ An elegant interactive launcher for Claude Code with a beautiful Claude-style in
 ### 🚀 **Third-party API Management**
 - 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
@@ -88,20 +93,21 @@ node claude-launcher
 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, switch, and remove APIs
+   - Add, edit, switch, and remove APIs
    - View usage statistics with success/failure rates
    - Model upgrade settings (auto/manual upgrade)
-   - Import/export configurations
-7. **Language Settings** - Switch between 11 supported languages
+   - 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
 
@@ -120,7 +126,7 @@ $ claude-launcher
     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
 ```
@@ -133,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
 ```
@@ -154,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