@kikkimo/claude-launcher 2.5.0 → 3.1.0

package/lib/utils/stdin-manager.js

@@ -11,6 +11,7 @@ const EventEmitter = require('events');
 const crypto = require('crypto');
 const colors = require('../ui/colors');
 const i18n = require('../i18n');
+const screen = require('../ui/screen');
 
 /**
  * Generate a cryptographically unique ID
@@ -111,7 +112,7 @@ class StdinManager extends EventEmitter {
      */
     _debug(...args) {
         if (this.debugMode) {
-            console.error('[StdinManager]', ...args);
+            screen.debug('[StdinManager] ' + args.join(' '));
         }
     }
 
@@ -389,8 +390,8 @@ class StdinManager extends EventEmitter {
             // Clear the warning text only in TTY mode to avoid spamming ANSI codes
             if (process.stdout && process.stdout.isTTY) {
                 // Clear the warning text (2 lines: empty line + warning line)
-                process.stdout.write('\x1b[1A\r\x1b[K'); // Up 1 line, clear warning
-                process.stdout.write('\x1b[1A\r\x1b[K'); // Up 1 line, clear empty line
+                screen.write('\x1b[1A\r\x1b[K'); // Up 1 line, clear warning
+                screen.write('\x1b[1A\r\x1b[K'); // Up 1 line, clear empty line
             }
             this._debug('Ctrl+C cancelled by user input');
         }
@@ -432,8 +433,8 @@ class StdinManager extends EventEmitter {
         // Clear the warning text only in TTY mode to avoid spamming ANSI codes
         if (process.stdout && process.stdout.isTTY) {
             // Clear the warning text (2 lines: empty line + warning line)
-            process.stdout.write('\x1b[1A\r\x1b[K'); // Up 1 line, clear warning
-            process.stdout.write('\x1b[1A\r\x1b[K'); // Up 1 line, clear empty line
+            screen.write('\x1b[1A\r\x1b[K'); // Up 1 line, clear warning
+            screen.write('\x1b[1A\r\x1b[K'); // Up 1 line, clear empty line
         }
         this._debug('Ctrl+C timer expired - warning cleared, returning to normal operation');
     }
@@ -464,8 +465,8 @@ class StdinManager extends EventEmitter {
 
         if (this.ctrlCCount === 1) {
             // First Ctrl+C - show warning
-            console.log('');
-            console.log(colors.yellow + '⚠️  ' + i18n.tSync('messages.prompts.ctrl_c_again') + colors.reset);
+            screen.write('\n');
+            screen.write(colors.yellow + '⚠️  ' + i18n.tSync('messages.prompts.ctrl_c_again') + colors.reset + '\n');
 
             // Clear any existing timer
             if (this.ctrlCTimer) {
@@ -486,8 +487,8 @@ class StdinManager extends EventEmitter {
                 this.ctrlCTimer = null;
             }
 
-            console.log('');
-            console.log(colors.green + i18n.tSync('ui.general.goodbye') + colors.reset);
+            screen.write('\n');
+            screen.write(colors.green + i18n.tSync('ui.general.goodbye') + colors.reset + '\n');
 
             // Clean up stdin before exit
             // Use clearAll=true since we're exiting anyway
@@ -497,6 +498,7 @@ class StdinManager extends EventEmitter {
                 // Ignore cleanup errors during exit
             }
 
+            screen.exit();
             process.exit(0);
         }
     }

package/lib/utils/version-checker.js

@@ -27,17 +27,34 @@ async function loadConfig() {
         // Add new fields for backward compatibility
         if (config.autoModelUpgrade === undefined) config.autoModelUpgrade = false;
         if (config.lastModelUpgradeCheck === undefined) config.lastModelUpgradeCheck = 0;
+        if (config.disableTelemetry === undefined) config.disableTelemetry = true;
+        if (config.showModelUpgradeNotification === undefined) config.showModelUpgradeNotification = true;
+        if (config.apiLaunchMode === undefined) config.apiLaunchMode = 'direct';
+        if (config.noFlicker === undefined) config.noFlicker = true;
 
         return config;
     } catch (error) {
-        // Return default config if file doesn't exist
-        return {
-            language: 'zh',
+        const defaultConfig = {
+            language: 'en',
             lastVersionCheck: 0,
             cachedLatestVersion: null,
             autoModelUpgrade: false,
-            lastModelUpgradeCheck: 0
+            lastModelUpgradeCheck: 0,
+            disableTelemetry: true,
+            showModelUpgradeNotification: true,
+            apiLaunchMode: 'direct',
+            noFlicker: false,
         };
+
+        // Write default config on first run so subsequent reads are consistent
+        try {
+            const configPath = getConfigPath();
+            await fs.writeFile(configPath, JSON.stringify(defaultConfig, null, 2), 'utf8');
+        } catch (_) {
+            // Silently fail
+        }
+
+        return defaultConfig;
     }
 }
 
@@ -249,11 +266,55 @@ async function setAutoModelUpgrade(enabled) {
     await saveConfig(config);
 }
 
+/**
+ * Load configuration from file synchronously
+ * Used by launcher.js where async is not available
+ */
+function loadConfigSync() {
+    try {
+        const fsSync = require('fs');
+        const data = fsSync.readFileSync(getConfigPath(), 'utf8');
+        const config = JSON.parse(data);
+
+        if (config.autoModelUpgrade === undefined) config.autoModelUpgrade = false;
+        if (config.lastModelUpgradeCheck === undefined) config.lastModelUpgradeCheck = 0;
+        if (config.disableTelemetry === undefined) config.disableTelemetry = true;
+        if (config.showModelUpgradeNotification === undefined) config.showModelUpgradeNotification = true;
+        if (config.apiLaunchMode === undefined) config.apiLaunchMode = 'direct';
+        if (config.noFlicker === undefined) config.noFlicker = true;
+
+        return config;
+    } catch (_) {
+        const defaultConfig = {
+            language: 'en',
+            lastVersionCheck: 0,
+            cachedLatestVersion: null,
+            autoModelUpgrade: false,
+            lastModelUpgradeCheck: 0,
+            disableTelemetry: true,
+            showModelUpgradeNotification: true,
+            apiLaunchMode: 'direct',
+            noFlicker: false,
+        };
+
+        // Write default config on first run so subsequent reads are consistent
+        try {
+            const fsSync = require('fs');
+            fsSync.writeFileSync(getConfigPath(), JSON.stringify(defaultConfig, null, 2), 'utf8');
+        } catch (__) {
+            // Silently fail
+        }
+
+        return defaultConfig;
+    }
+}
+
 module.exports = {
     checkForUpdates,
     forceCheckForUpdates,
     clearCache,
     loadConfig,
+    loadConfigSync,
     saveConfig,
     setAutoModelUpgrade
 };

package/lib/validators.js

@@ -120,11 +120,112 @@ function maskApiToken(token) {
     }
 }
 
+// ============================================================
+// Environment variable constants & validators
+// ============================================================
+
+const RESERVED_ENV_KEYS = [
+    'ANTHROPIC_BASE_URL',
+    'ANTHROPIC_AUTH_TOKEN',
+    'ANTHROPIC_API_KEY',
+    'ANTHROPIC_MODEL',
+    'ANTHROPIC_SMALL_FAST_MODEL',
+    'CLAUDE_CODE_OAUTH_TOKEN',
+    'DISABLE_TELEMETRY',
+    'CLAUDE_CODE_NO_FLICKER',
+];
+
+const PREDEFINED_RUNTIME_KEYS = [
+    'API_TIMEOUT_MS',
+    'CLAUDE_CODE_ATTRIBUTION_HEADER',
+    'CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC',
+    'CLAUDE_CODE_EFFORT_LEVEL',
+    'CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS',
+    'CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK',
+];
+
+const PREDEFINED_MODEL_ENV_KEYS = [
+    'ANTHROPIC_CUSTOM_MODEL_OPTION',
+    'ANTHROPIC_CUSTOM_MODEL_OPTION_NAME',
+    'ANTHROPIC_DEFAULT_SONNET_MODEL',
+    'ANTHROPIC_DEFAULT_OPUS_MODEL',
+    'ANTHROPIC_DEFAULT_HAIKU_MODEL',
+    'CLAUDE_CODE_SUBAGENT_MODEL',
+];
+
+const TYPE_A_FIELDS = [
+    'CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC',
+    'CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS',
+    'CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK',
+];
+
+const TYPE_B_FIELDS = [
+    'CLAUDE_CODE_ATTRIBUTION_HEADER',
+];
+
+const ALL_PREDEFINED_KEYS = new Set([
+    ...RESERVED_ENV_KEYS,
+    ...PREDEFINED_RUNTIME_KEYS,
+    ...PREDEFINED_MODEL_ENV_KEYS,
+]);
+
+function validateEnvKey(key) {
+    if (typeof key !== 'string' || key.trim() === '') {
+        return { valid: false, error: 'custom_env_key_empty' };
+    }
+    if (ALL_PREDEFINED_KEYS.has(key.trim())) {
+        return { valid: false, error: 'custom_env_key_reserved' };
+    }
+    return { valid: true, value: key.trim() };
+}
+
+function validateTypeATriState(value) {
+    if (value === '' || value === '1' || value === 'off') {
+        return { valid: true, value };
+    }
+    return { valid: false, error: 'tri_state_type_a_invalid' };
+}
+
+function validateTypeBTriState(value) {
+    if (value === '' || value === '1' || value === '0') {
+        return { valid: true, value };
+    }
+    return { valid: false, error: 'tri_state_type_b_invalid' };
+}
+
+function validateRuntimeEnvValue(key, value) {
+    if (typeof value !== 'string') {
+        return { valid: false, error: 'env_value_not_string' };
+    }
+    if (TYPE_A_FIELDS.includes(key)) return validateTypeATriState(value);
+    if (TYPE_B_FIELDS.includes(key)) return validateTypeBTriState(value);
+    if (key === 'API_TIMEOUT_MS') {
+        if (value === '') return { valid: true, value };
+        if (/^\d+$/.test(value) && parseInt(value, 10) > 0) return { valid: true, value };
+        return { valid: false, error: 'env_value_timeout_invalid' };
+    }
+    if (key === 'CLAUDE_CODE_EFFORT_LEVEL') {
+        if (value === '') return { valid: true, value };
+        if (['low','medium','high','xhigh','max','auto'].includes(value)) return { valid: true, value };
+        return { valid: false, error: 'env_value_effort_invalid' };
+    }
+    return { valid: true, value };
+}
+
 module.exports = {
     validateBaseUrl,
     validateAuthToken,
     validateModel,
     validateApiName,
     maskSensitiveData,
-    maskApiToken
+    maskApiToken,
+    RESERVED_ENV_KEYS,
+    PREDEFINED_RUNTIME_KEYS,
+    PREDEFINED_MODEL_ENV_KEYS,
+    TYPE_A_FIELDS,
+    TYPE_B_FIELDS,
+    validateEnvKey,
+    validateTypeATriState,
+    validateTypeBTriState,
+    validateRuntimeEnvValue,
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kikkimo/claude-launcher",
-  "version": "2.5.0",
+  "version": "3.1.0",
   "description": "Interactive launcher for Claude Code with beautiful Claude-style interface",
   "main": "claude-launcher",
   "bin": {
@@ -8,7 +8,7 @@
   },
   "scripts": {
     "start": "node claude-launcher",
-    "test": "node test/providers.test.js && node test/menu-hints.test.js",
+    "test": "node test/providers.test.js && node test/menu-hints.test.js && node test/version-checker.test.js && node test/api-manager.test.js && node test/launcher.test.js && node test/config-management.test.js && node test/api-select.test.js && node test/env-vars-validators.test.js && node test/env-vars-providers.test.js && node test/env-vars-config.test.js && node test/env-vars-migration.test.js && node test/env-vars-add-api.test.js && node test/env-vars-write-interfaces.test.js && node test/env-vars-import-export.test.js && node test/env-vars-ui.test.js",
     "prepublishOnly": "echo \"Publishing claude-launcher...\"",
     "postinstall": "echo \"Claude Launcher installed successfully! Run 'claude-launcher' to start.\"",
     "publish:public": "npm publish --access public"