zcf 3.4.0 → 3.4.2

package/dist/cli.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import cac from 'cac';
 import ansis from 'ansis';
-import { ah as ensureI18nInitialized, ai as i18n, aK as readCcrConfig, aF as isCcrInstalled, aG as installCcr, aL as configureCcrFeature, al as promptBoolean, aM as handleExitPromptError, aN as handleGeneralError, aO as COMETIX_COMMAND_NAME, aP as COMETIX_COMMANDS, aQ as installCometixLine, aj as addNumbersToChoices, aR as checkAndUpdateTools, aS as runCodexUpdate, aT as resolveCodeType$1, aq as readJsonConfig, aU as writeJsonConfig, q as ZCF_CONFIG_FILE, aA as readZcfConfig, D as DEFAULT_CODE_TOOL_TYPE, u as isCodeToolType, aV as displayBanner, ay as updateZcfConfig, aW as version, aX as resolveAiOutputLanguage, aY as updatePromptOnly, aZ as selectAndInstallWorkflows, a_ as checkClaudeCodeVersionAndPrompt, w as resolveCodeToolType$1, a$ as displayBannerWithInfo, s as CODE_TOOL_BANNERS, b0 as runCodexUninstall, b1 as configureCodexMcp, b2 as configureCodexApi, b3 as runCodexWorkflowImportWithLanguageSelection, b4 as runCodexFullInit, i as init, b5 as switchCodexProvider, b6 as listCodexProviders, au as readCodexConfig, b7 as switchToOfficialLogin, b8 as switchToProvider, b9 as readZcfConfigAsync, ba as initI18n, bb as selectScriptLanguage, az as changeLanguage } from './chunks/simple-config.mjs';
+import { ak as ensureI18nInitialized, al as i18n, aN as readCcrConfig, aI as isCcrInstalled, aJ as installCcr, aO as configureCcrFeature, ao as promptBoolean, aP as handleExitPromptError, aQ as handleGeneralError, aR as COMETIX_COMMAND_NAME, aS as COMETIX_COMMANDS, aT as installCometixLine, am as addNumbersToChoices, aU as checkAndUpdateTools, aV as runCodexUpdate, aW as resolveCodeType$1, at as readJsonConfig, aX as writeJsonConfig, q as ZCF_CONFIG_FILE, aD as readZcfConfig, D as DEFAULT_CODE_TOOL_TYPE, u as isCodeToolType, aY as displayBanner, aB as updateZcfConfig, aZ as version, a_ as resolveAiOutputLanguage, a$ as updatePromptOnly, b0 as selectAndInstallWorkflows, b1 as checkClaudeCodeVersionAndPrompt, w as resolveCodeToolType$1, b2 as displayBannerWithInfo, s as CODE_TOOL_BANNERS, b3 as runCodexUninstall, b4 as configureCodexMcp, b5 as configureCodexApi, b6 as runCodexWorkflowImportWithLanguageSelection, b7 as runCodexFullInit, i as init, b8 as switchCodexProvider, b9 as listCodexProviders, ax as readCodexConfig, ba as switchToOfficialLogin, bb as switchToProvider, bc as readZcfConfigAsync, bd as initI18n, be as selectScriptLanguage, aC as changeLanguage } from './chunks/simple-config.mjs';
 import { existsSync } from 'node:fs';
 import { homedir } from 'node:os';
 import inquirer from 'inquirer';
@@ -687,7 +687,7 @@ class ZcfUninstaller {
         result.removed.push(".claude.json (includes MCP configuration)");
       }
       try {
-        const { uninstallCodeTool } = await import('./chunks/simple-config.mjs').then(function (n) { return n.bk; });
+        const { uninstallCodeTool } = await import('./chunks/simple-config.mjs').then(function (n) { return n.bn; });
         const success = await uninstallCodeTool("claude-code");
         if (success) {
           result.removed.push("@anthropic-ai/claude-code");
@@ -923,7 +923,7 @@ async function uninstall(options = {}) {
     }
     const uninstaller = new ZcfUninstaller(options.lang || "en");
     if (codeType === "codex") {
-      const { runCodexUninstall } = await import('./chunks/simple-config.mjs').then(function (n) { return n.bj; });
+      const { runCodexUninstall } = await import('./chunks/simple-config.mjs').then(function (n) { return n.bm; });
       await runCodexUninstall();
       return;
     }
@@ -1193,7 +1193,7 @@ async function update(options = {}) {
       }
       return;
     }
-    const { resolveTemplateLanguage } = await import('./chunks/simple-config.mjs').then(function (n) { return n.bi; });
+    const { resolveTemplateLanguage } = await import('./chunks/simple-config.mjs').then(function (n) { return n.bl; });
     const configLang = await resolveTemplateLanguage(
       options.configLang,
       // Command line option
@@ -1627,8 +1627,8 @@ async function listCodexProvidersWithDisplay() {
     const current = isCurrent ? ansis.yellow(` (${i18n.t("common:current")})`) : "";
     console.log(`${status}${ansis.white(provider.name)}${current}`);
     console.log(`    ${ansis.cyan(`ID: ${provider.id}`)} ${ansis.gray(`(${provider.baseUrl})`)}`);
-    if (provider.envKey) {
-      console.log(`    ${ansis.gray(`Env: ${provider.envKey}`)}`);
+    if (provider.tempEnvKey) {
+      console.log(`    ${ansis.gray(`Env: ${provider.tempEnvKey}`)}`);
     }
     console.log();
   });

package/dist/i18n/locales/en/codex.json

@@ -3,6 +3,10 @@
   "alreadyInstalled": "⚠️ Codex CLI already installed, skipping installation",
   "updatingCli": "🔄 Updating Codex CLI...",
   "updateSuccess": "✔ Codex CLI updated",
+  "detectedHomebrew": "Detected Codex installed via Homebrew, will update using Homebrew",
+  "detectedNpm": "Detected Codex installed via npm, will update using npm",
+  "unknownInstallMethod": "⚠️ Unable to detect Codex installation method",
+  "fallingBackToNpm": "Falling back to npm update method",
   "workflowInstall": "✔ Codex workflow templates installed",
   "backupSuccess": "✔ Backup created at {{path}}",
   "apiModePrompt": "Select API configuration mode",
@@ -115,5 +119,6 @@
   "providerManager.providerNameRequired": "Provider name is required",
   "providerManager.baseUrlRequired": "Base URL is required",
   "providerManager.wireApiInvalid": "Wire API must be either \"responses\" or \"chat\"",
-  "providerManager.unknownError": "Unknown error"
+  "providerManager.unknownError": "Unknown error",
+  "envKeyMigrationComplete": "✔ env_key to temp_env_key migration completed"
 }

package/dist/i18n/locales/en/common.json

@@ -15,5 +15,6 @@
   "backupCreated": "📁 Configuration backup created: {{path}}",
   "current": "current",
   "claudeCode": "Claude Code",
-  "codex": "Codex"
+  "codex": "Codex",
+  "yes": "Yes"
 }

package/dist/i18n/locales/en/configuration.json

@@ -62,6 +62,8 @@
   "selectMemoryOption": "Select configuration option",
   "selectOutputStyles": "Select output styles to install",
   "selectedStyles": "Selected styles",
+  "singleConfigSaved": "Configuration {{name}} saved",
+  "singleConfigSaveFailed": "Failed to save configuration",
   "updateDocsOnly": "Update workflow-related md files only with backup",
   "updatingPrompts": "Updating Claude Code memory documents...",
   "enterCustomModel": "Enter custom model name",

package/dist/i18n/locales/en/installation.json

@@ -32,6 +32,12 @@
   "wslInstallSuccess": "Claude Code successfully installed in WSL environment",
   "selectInstallMethod": "Please select installation method for {{codeType}}:",
   "recommendedMethod": "Recommended",
+  "notRecommended": "Not Recommended",
+  "installMethodNpm": "npm",
+  "installMethodHomebrew": "homebrew",
+  "installMethodCurl": "curl",
+  "installMethodPowershell": "powershell",
+  "installMethodCmd": "cmd",
   "installingWith": "Installing {{codeType}} using {{method}}...",
   "installMethodSuccess": "Successfully installed using {{method}}",
   "installMethodFailed": "Failed to install using {{method}}",
@@ -43,5 +49,32 @@
   "uninstallFailed": "Failed to uninstall using {{method}}",
   "manualUninstallRequired": "{{codeType}} requires manual uninstallation",
   "binaryLocation": "Binary location: {{path}}",
-  "failedToLocateBinary": "Failed to locate {{command}} binary"
+  "failedToLocateBinary": "Failed to locate {{command}} binary",
+  "verificationSuccess": "installation verified successfully",
+  "verificationFailed": "installation verification failed",
+  "symlinkCreated": "Symlink created at {{path}}",
+  "foundAtPath": "Found at: {{path}}",
+  "manualSymlinkHint": "You may need to manually add the tool to your PATH or create a symlink",
+  "duplicateInstallationsDetected": "⚠️ Multiple Claude Code installations detected",
+  "duplicateInstallationsWarning": "Having multiple installations may cause version confusion and update issues",
+  "currentActiveInstallation": "Current active installation",
+  "inactiveInstallations": "Inactive installations",
+  "installationSource": "Installation source",
+  "installationPath": "Path",
+  "installationVersion": "Version",
+  "sourceHomebrewCask": "Homebrew Cask",
+  "sourceNpm": "npm global",
+  "sourceNpmHomebrewNode": "npm (via Homebrew Node)",
+  "sourceCurl": "curl installation",
+  "sourceOther": "Other",
+  "recommendRemoveNpm": "Recommend removing npm installation to maintain single installation source",
+  "confirmRemoveDuplicate": "Remove redundant {source}?",
+  "removingDuplicateInstallation": "Removing redundant installation...",
+  "duplicateRemoved": "Redundant installation removed",
+  "duplicateRemovalFailed": "Failed to remove redundant installation",
+  "keepBothInstallations": "Keep both installations (not recommended)",
+  "duplicateWarningContinue": "Acknowledged duplicate installation risk, continue",
+  "versionMismatchWarning": "⚠️ Version mismatch: npm is {npmVersion}, Homebrew is {homebrewVersion}",
+  "activatingHomebrew": "Activating Homebrew installation...",
+  "autoRemovingNpm": "Silent mode: Auto-removing npm installation and keeping Homebrew..."
 }

package/dist/i18n/locales/zh-CN/codex.json

@@ -3,6 +3,10 @@
   "alreadyInstalled": "⚠️ Codex CLI 已安装，跳过安装步骤",
   "updatingCli": "🔄 正在更新 Codex CLI...",
   "updateSuccess": "✔ Codex CLI 更新完成",
+  "detectedHomebrew": "检测到 Codex 通过 Homebrew 安装，将使用 Homebrew 更新",
+  "detectedNpm": "检测到 Codex 通过 npm 安装，将使用 npm 更新",
+  "unknownInstallMethod": "⚠️ 无法检测 Codex 安装方式",
+  "fallingBackToNpm": "回退到 npm 更新方式",
   "workflowInstall": "✔ 已安装 Codex 工作流模板",
   "backupSuccess": "✔ 已创建备份 {{path}}",
   "apiModePrompt": "请选择 API 配置模式",
@@ -115,5 +119,6 @@
   "providerManager.providerNameRequired": "提供商名称是必需的",
   "providerManager.baseUrlRequired": "基础 URL 是必需的",
   "providerManager.wireApiInvalid": "Wire API 必须是 \"responses\" 或 \"chat\"",
-  "providerManager.unknownError": "未知错误"
+  "providerManager.unknownError": "未知错误",
+  "envKeyMigrationComplete": "✔ 已完成 env_key 到 temp_env_key 的迁移"
 }

package/dist/i18n/locales/zh-CN/common.json

@@ -15,5 +15,6 @@
   "backupCreated": "📁 已创建配置备份：{{path}}",
   "current": "当前",
   "claudeCode": "Claude Code",
-  "codex": "Codex"
+  "codex": "Codex",
+  "yes": "是"
 }

package/dist/i18n/locales/zh-CN/configuration.json

@@ -62,6 +62,8 @@
   "selectMemoryOption": "选择配置选项",
   "selectOutputStyles": "选择要安装的输出风格",
   "selectedStyles": "已选择风格",
+  "singleConfigSaved": "配置 {{name}} 已保存",
+  "singleConfigSaveFailed": "配置保存失败",
   "updateDocsOnly": "仅更新工作流相关md并备份旧配置",
   "updatingPrompts": "正在更新 Claude Code 记忆文档...",
   "enterCustomModel": "请输入自定义模型名称",

package/dist/i18n/locales/zh-CN/installation.json

@@ -32,6 +32,12 @@
   "wslInstallSuccess": "Claude Code 已成功安装在 WSL 环境中",
   "selectInstallMethod": "请选择 {{codeType}} 的安装方式：",
   "recommendedMethod": "推荐",
+  "notRecommended": "不推荐",
+  "installMethodNpm": "npm",
+  "installMethodHomebrew": "homebrew",
+  "installMethodCurl": "curl",
+  "installMethodPowershell": "powershell",
+  "installMethodCmd": "cmd",
   "installingWith": "正在使用 {{method}} 安装 {{codeType}}...",
   "installMethodSuccess": "使用 {{method}} 安装成功",
   "installMethodFailed": "使用 {{method}} 安装失败",
@@ -43,5 +49,32 @@
   "uninstallFailed": "使用 {{method}} 卸载失败",
   "manualUninstallRequired": "{{codeType}} 需要手动卸载",
   "binaryLocation": "可执行文件位置：{{path}}",
-  "failedToLocateBinary": "无法定位 {{command}} 可执行文件"
+  "failedToLocateBinary": "无法定位 {{command}} 可执行文件",
+  "verificationSuccess": "安装验证成功",
+  "verificationFailed": "安装验证失败",
+  "symlinkCreated": "已在 {{path}} 创建符号链接",
+  "foundAtPath": "在此路径找到: {{path}}",
+  "manualSymlinkHint": "您可能需要手动将工具添加到 PATH 或创建符号链接",
+  "duplicateInstallationsDetected": "⚠️ 检测到多个 Claude Code 安装",
+  "duplicateInstallationsWarning": "同时存在多个安装可能导致版本混乱和更新异常",
+  "currentActiveInstallation": "当前活动安装",
+  "inactiveInstallations": "未激活的安装",
+  "installationSource": "安装来源",
+  "installationPath": "路径",
+  "installationVersion": "版本",
+  "sourceHomebrewCask": "Homebrew Cask",
+  "sourceNpm": "npm 全局安装",
+  "sourceNpmHomebrewNode": "npm (通过 Homebrew Node)",
+  "sourceCurl": "curl 安装",
+  "sourceOther": "其他",
+  "recommendRemoveNpm": "建议删除 npm 安装以保持单一安装源",
+  "confirmRemoveDuplicate": "是否删除冗余的 {source}？",
+  "removingDuplicateInstallation": "正在删除冗余安装...",
+  "duplicateRemoved": "冗余安装已删除",
+  "duplicateRemovalFailed": "删除冗余安装失败",
+  "keepBothInstallations": "保留两个安装（不推荐）",
+  "duplicateWarningContinue": "已知晓多重安装风险，继续使用",
+  "versionMismatchWarning": "⚠️ 版本不一致：npm 版本为 {npmVersion}，Homebrew 版本为 {homebrewVersion}",
+  "activatingHomebrew": "正在激活 Homebrew 安装...",
+  "autoRemovingNpm": "静默模式：自动删除 npm 安装并保留 Homebrew..."
 }

package/dist/index.d.mts

@@ -65,6 +65,15 @@ interface InitOptions {
 }
 declare function init(options?: InitOptions): Promise<void>;
 
+declare function getPlatform(): 'windows' | 'macos' | 'linux';
+declare function commandExists(command: string): Promise<boolean>;
+/**
+ * Get recommended install methods for a code tool based on current platform
+ * Returns methods in priority order (most recommended first)
+ */
+type CodeType = 'claude-code' | 'codex';
+type InstallMethod$1 = 'npm' | 'homebrew' | 'curl' | 'powershell' | 'cmd' | 'npm-global' | 'native';
+
 interface McpService {
     id: string;
     name: string;
@@ -92,7 +101,7 @@ interface ClaudeConfiguration {
     };
     env?: Record<string, string>;
     primaryApiKey?: string;
-    installMethod?: 'npm' | 'native';
+    installMethod?: InstallMethod$1;
 }
 
 declare function getMcpConfigPath(): string;
@@ -185,14 +194,6 @@ declare function switchToOfficialLogin(): boolean;
  */
 declare function promptApiConfigurationAction(): Promise<'modify-partial' | 'modify-all' | 'keep-existing' | null>;
 
-declare function getPlatform(): 'windows' | 'macos' | 'linux';
-declare function commandExists(command: string): Promise<boolean>;
-/**
- * Get recommended install methods for a code tool based on current platform
- * Returns methods in priority order (most recommended first)
- */
-type CodeType = 'claude-code' | 'codex';
-
 declare function isClaudeCodeInstalled(): Promise<boolean>;
 /**
  * Install Claude Code with method selection support
@@ -235,7 +236,7 @@ declare function uninstallCodeTool(codeType: CodeType): Promise<boolean>;
  * Set installMethod in both ~/.claude.json and zcf-config
  * This ensures Claude Code knows it was installed via npm for proper auto-updates
  */
-declare function setInstallMethod(method?: InstallMethod | 'native', codeType?: CodeType): Promise<void>;
+declare function setInstallMethod(method: InstallMethod, codeType?: CodeType): Promise<void>;
 /**
  * Detect installed version of a code tool
  * Returns version string or null if not installed
@@ -253,6 +254,40 @@ declare function executeInstallMethod(method: InstallMethod, codeType: CodeType)
  * Handle installation failure with retry options
  */
 declare function handleInstallFailure(codeType: CodeType, failedMethods: InstallMethod[]): Promise<boolean>;
+/**
+ * Installation verification result
+ */
+interface VerificationResult {
+    success: boolean;
+    commandPath: string | null;
+    version: string | null;
+    needsSymlink: boolean;
+    symlinkCreated: boolean;
+    error?: string;
+}
+/**
+ * Verify installation by checking command availability and version
+ * If command is not in PATH but found in Homebrew paths, attempt to create symlink
+ */
+declare function verifyInstallation(codeType: CodeType): Promise<VerificationResult>;
+/**
+ * Symlink creation result
+ */
+interface SymlinkResult {
+    success: boolean;
+    symlinkPath: string | null;
+    error?: string;
+}
+/**
+ * Create symlink in Homebrew bin directory for commands installed via npm
+ * This handles the case where npm global packages are installed to
+ * /opt/homebrew/Cellar/node/{version}/bin/ but that path is not in the user's PATH
+ */
+declare function createHomebrewSymlink(command: string, sourcePath: string): Promise<SymlinkResult>;
+/**
+ * Display verification result to user with appropriate messages
+ */
+declare function displayVerificationResult(result: VerificationResult, codeType: CodeType): void;
 
 /**
  * Clean up and deduplicate permissions array
@@ -278,5 +313,5 @@ declare function importRecommendedEnv(): Promise<void>;
 declare function importRecommendedPermissions(): Promise<void>;
 declare function openSettingsJson(): Promise<void>;
 
-export { AI_OUTPUT_LANGUAGES, API_DEFAULT_URL, API_ENV_KEY, CLAUDE_DIR, CLAUDE_MD_FILE, CLAUDE_VSC_CONFIG_FILE, CODEX_AGENTS_FILE, CODEX_AUTH_FILE, CODEX_CONFIG_FILE, CODEX_DIR, CODEX_PROMPTS_DIR, CODE_TOOL_ALIASES, CODE_TOOL_BANNERS, CODE_TOOL_TYPES, ClAUDE_CONFIG_FILE, DEFAULT_CODE_TOOL_TYPE, LANG_LABELS, LEGACY_ZCF_CONFIG_FILES, SETTINGS_FILE, SUPPORTED_LANGS, ZCF_CONFIG_DIR, ZCF_CONFIG_FILE, addCompletedOnboarding, applyAiLanguageDirective, backupExistingConfig, backupMcpConfig, buildMcpServerConfig, cleanupPermissions, commandExists, configureApi, copyConfigFiles, detectInstalledVersion, ensureApiKeyApproved, ensureClaudeDir, executeInstallMethod, fixWindowsMcpConfig, getAiOutputLanguageLabel, getExistingApiConfig, getExistingModelConfig, getInstallationStatus, getMcpConfigPath, getPlatform, handleInstallFailure, importRecommendedEnv, importRecommendedPermissions, init, installClaudeCode, installCodex, isClaudeCodeInstalled, isCodeToolType, isCodexInstalled, isLocalClaudeCodeInstalled, manageApiKeyApproval, mergeAndCleanPermissions, mergeConfigs, mergeMcpServers, mergeSettingsFile, openSettingsJson, promptApiConfigurationAction, readMcpConfig, removeApiKeyFromRejected, removeLocalClaudeCode, resolveCodeToolType, selectInstallMethod, setInstallMethod, setPrimaryApiKey, switchToOfficialLogin, uninstallCodeTool, updateCustomModel, updateDefaultModel, writeMcpConfig };
-export type { AiOutputLanguage, ApiConfig, ClaudeConfiguration, CodeToolType, InstallationStatus, McpServerConfig, McpService, SupportedLang };
+export { AI_OUTPUT_LANGUAGES, API_DEFAULT_URL, API_ENV_KEY, CLAUDE_DIR, CLAUDE_MD_FILE, CLAUDE_VSC_CONFIG_FILE, CODEX_AGENTS_FILE, CODEX_AUTH_FILE, CODEX_CONFIG_FILE, CODEX_DIR, CODEX_PROMPTS_DIR, CODE_TOOL_ALIASES, CODE_TOOL_BANNERS, CODE_TOOL_TYPES, ClAUDE_CONFIG_FILE, DEFAULT_CODE_TOOL_TYPE, LANG_LABELS, LEGACY_ZCF_CONFIG_FILES, SETTINGS_FILE, SUPPORTED_LANGS, ZCF_CONFIG_DIR, ZCF_CONFIG_FILE, addCompletedOnboarding, applyAiLanguageDirective, backupExistingConfig, backupMcpConfig, buildMcpServerConfig, cleanupPermissions, commandExists, configureApi, copyConfigFiles, createHomebrewSymlink, detectInstalledVersion, displayVerificationResult, ensureApiKeyApproved, ensureClaudeDir, executeInstallMethod, fixWindowsMcpConfig, getAiOutputLanguageLabel, getExistingApiConfig, getExistingModelConfig, getInstallationStatus, getMcpConfigPath, getPlatform, handleInstallFailure, importRecommendedEnv, importRecommendedPermissions, init, installClaudeCode, installCodex, isClaudeCodeInstalled, isCodeToolType, isCodexInstalled, isLocalClaudeCodeInstalled, manageApiKeyApproval, mergeAndCleanPermissions, mergeConfigs, mergeMcpServers, mergeSettingsFile, openSettingsJson, promptApiConfigurationAction, readMcpConfig, removeApiKeyFromRejected, removeLocalClaudeCode, resolveCodeToolType, selectInstallMethod, setInstallMethod, setPrimaryApiKey, switchToOfficialLogin, uninstallCodeTool, updateCustomModel, updateDefaultModel, verifyInstallation, writeMcpConfig };
+export type { AiOutputLanguage, ApiConfig, ClaudeConfiguration, CodeToolType, InstallationStatus, McpServerConfig, McpService, SupportedLang, VerificationResult };

package/dist/index.d.ts

@@ -65,6 +65,15 @@ interface InitOptions {
 }
 declare function init(options?: InitOptions): Promise<void>;
 
+declare function getPlatform(): 'windows' | 'macos' | 'linux';
+declare function commandExists(command: string): Promise<boolean>;
+/**
+ * Get recommended install methods for a code tool based on current platform
+ * Returns methods in priority order (most recommended first)
+ */
+type CodeType = 'claude-code' | 'codex';
+type InstallMethod$1 = 'npm' | 'homebrew' | 'curl' | 'powershell' | 'cmd' | 'npm-global' | 'native';
+
 interface McpService {
     id: string;
     name: string;
@@ -92,7 +101,7 @@ interface ClaudeConfiguration {
     };
     env?: Record<string, string>;
     primaryApiKey?: string;
-    installMethod?: 'npm' | 'native';
+    installMethod?: InstallMethod$1;
 }
 
 declare function getMcpConfigPath(): string;
@@ -185,14 +194,6 @@ declare function switchToOfficialLogin(): boolean;
  */
 declare function promptApiConfigurationAction(): Promise<'modify-partial' | 'modify-all' | 'keep-existing' | null>;
 
-declare function getPlatform(): 'windows' | 'macos' | 'linux';
-declare function commandExists(command: string): Promise<boolean>;
-/**
- * Get recommended install methods for a code tool based on current platform
- * Returns methods in priority order (most recommended first)
- */
-type CodeType = 'claude-code' | 'codex';
-
 declare function isClaudeCodeInstalled(): Promise<boolean>;
 /**
  * Install Claude Code with method selection support
@@ -235,7 +236,7 @@ declare function uninstallCodeTool(codeType: CodeType): Promise<boolean>;
  * Set installMethod in both ~/.claude.json and zcf-config
  * This ensures Claude Code knows it was installed via npm for proper auto-updates
  */
-declare function setInstallMethod(method?: InstallMethod | 'native', codeType?: CodeType): Promise<void>;
+declare function setInstallMethod(method: InstallMethod, codeType?: CodeType): Promise<void>;
 /**
  * Detect installed version of a code tool
  * Returns version string or null if not installed
@@ -253,6 +254,40 @@ declare function executeInstallMethod(method: InstallMethod, codeType: CodeType)
  * Handle installation failure with retry options
  */
 declare function handleInstallFailure(codeType: CodeType, failedMethods: InstallMethod[]): Promise<boolean>;
+/**
+ * Installation verification result
+ */
+interface VerificationResult {
+    success: boolean;
+    commandPath: string | null;
+    version: string | null;
+    needsSymlink: boolean;
+    symlinkCreated: boolean;
+    error?: string;
+}
+/**
+ * Verify installation by checking command availability and version
+ * If command is not in PATH but found in Homebrew paths, attempt to create symlink
+ */
+declare function verifyInstallation(codeType: CodeType): Promise<VerificationResult>;
+/**
+ * Symlink creation result
+ */
+interface SymlinkResult {
+    success: boolean;
+    symlinkPath: string | null;
+    error?: string;
+}
+/**
+ * Create symlink in Homebrew bin directory for commands installed via npm
+ * This handles the case where npm global packages are installed to
+ * /opt/homebrew/Cellar/node/{version}/bin/ but that path is not in the user's PATH
+ */
+declare function createHomebrewSymlink(command: string, sourcePath: string): Promise<SymlinkResult>;
+/**
+ * Display verification result to user with appropriate messages
+ */
+declare function displayVerificationResult(result: VerificationResult, codeType: CodeType): void;
 
 /**
  * Clean up and deduplicate permissions array
@@ -278,5 +313,5 @@ declare function importRecommendedEnv(): Promise<void>;
 declare function importRecommendedPermissions(): Promise<void>;
 declare function openSettingsJson(): Promise<void>;
 
-export { AI_OUTPUT_LANGUAGES, API_DEFAULT_URL, API_ENV_KEY, CLAUDE_DIR, CLAUDE_MD_FILE, CLAUDE_VSC_CONFIG_FILE, CODEX_AGENTS_FILE, CODEX_AUTH_FILE, CODEX_CONFIG_FILE, CODEX_DIR, CODEX_PROMPTS_DIR, CODE_TOOL_ALIASES, CODE_TOOL_BANNERS, CODE_TOOL_TYPES, ClAUDE_CONFIG_FILE, DEFAULT_CODE_TOOL_TYPE, LANG_LABELS, LEGACY_ZCF_CONFIG_FILES, SETTINGS_FILE, SUPPORTED_LANGS, ZCF_CONFIG_DIR, ZCF_CONFIG_FILE, addCompletedOnboarding, applyAiLanguageDirective, backupExistingConfig, backupMcpConfig, buildMcpServerConfig, cleanupPermissions, commandExists, configureApi, copyConfigFiles, detectInstalledVersion, ensureApiKeyApproved, ensureClaudeDir, executeInstallMethod, fixWindowsMcpConfig, getAiOutputLanguageLabel, getExistingApiConfig, getExistingModelConfig, getInstallationStatus, getMcpConfigPath, getPlatform, handleInstallFailure, importRecommendedEnv, importRecommendedPermissions, init, installClaudeCode, installCodex, isClaudeCodeInstalled, isCodeToolType, isCodexInstalled, isLocalClaudeCodeInstalled, manageApiKeyApproval, mergeAndCleanPermissions, mergeConfigs, mergeMcpServers, mergeSettingsFile, openSettingsJson, promptApiConfigurationAction, readMcpConfig, removeApiKeyFromRejected, removeLocalClaudeCode, resolveCodeToolType, selectInstallMethod, setInstallMethod, setPrimaryApiKey, switchToOfficialLogin, uninstallCodeTool, updateCustomModel, updateDefaultModel, writeMcpConfig };
-export type { AiOutputLanguage, ApiConfig, ClaudeConfiguration, CodeToolType, InstallationStatus, McpServerConfig, McpService, SupportedLang };
+export { AI_OUTPUT_LANGUAGES, API_DEFAULT_URL, API_ENV_KEY, CLAUDE_DIR, CLAUDE_MD_FILE, CLAUDE_VSC_CONFIG_FILE, CODEX_AGENTS_FILE, CODEX_AUTH_FILE, CODEX_CONFIG_FILE, CODEX_DIR, CODEX_PROMPTS_DIR, CODE_TOOL_ALIASES, CODE_TOOL_BANNERS, CODE_TOOL_TYPES, ClAUDE_CONFIG_FILE, DEFAULT_CODE_TOOL_TYPE, LANG_LABELS, LEGACY_ZCF_CONFIG_FILES, SETTINGS_FILE, SUPPORTED_LANGS, ZCF_CONFIG_DIR, ZCF_CONFIG_FILE, addCompletedOnboarding, applyAiLanguageDirective, backupExistingConfig, backupMcpConfig, buildMcpServerConfig, cleanupPermissions, commandExists, configureApi, copyConfigFiles, createHomebrewSymlink, detectInstalledVersion, displayVerificationResult, ensureApiKeyApproved, ensureClaudeDir, executeInstallMethod, fixWindowsMcpConfig, getAiOutputLanguageLabel, getExistingApiConfig, getExistingModelConfig, getInstallationStatus, getMcpConfigPath, getPlatform, handleInstallFailure, importRecommendedEnv, importRecommendedPermissions, init, installClaudeCode, installCodex, isClaudeCodeInstalled, isCodeToolType, isCodexInstalled, isLocalClaudeCodeInstalled, manageApiKeyApproval, mergeAndCleanPermissions, mergeConfigs, mergeMcpServers, mergeSettingsFile, openSettingsJson, promptApiConfigurationAction, readMcpConfig, removeApiKeyFromRejected, removeLocalClaudeCode, resolveCodeToolType, selectInstallMethod, setInstallMethod, setPrimaryApiKey, switchToOfficialLogin, uninstallCodeTool, updateCustomModel, updateDefaultModel, verifyInstallation, writeMcpConfig };
+export type { AiOutputLanguage, ApiConfig, ClaudeConfiguration, CodeToolType, InstallationStatus, McpServerConfig, McpService, SupportedLang, VerificationResult };

package/dist/index.mjs

@@ -1,4 +1,4 @@
-export { z as AI_OUTPUT_LANGUAGES, A as API_DEFAULT_URL, v as API_ENV_KEY, C as CLAUDE_DIR, e as CLAUDE_MD_FILE, h as CLAUDE_VSC_CONFIG_FILE, n as CODEX_AGENTS_FILE, l as CODEX_AUTH_FILE, k as CODEX_CONFIG_FILE, j as CODEX_DIR, p as CODEX_PROMPTS_DIR, t as CODE_TOOL_ALIASES, s as CODE_TOOL_BANNERS, r as CODE_TOOL_TYPES, f as ClAUDE_CONFIG_FILE, D as DEFAULT_CODE_TOOL_TYPE, y as LANG_LABELS, L as LEGACY_ZCF_CONFIG_FILES, S as SETTINGS_FILE, x as SUPPORTED_LANGS, Z as ZCF_CONFIG_DIR, q as ZCF_CONFIG_FILE, M as addCompletedOnboarding, a1 as applyAiLanguageDirective, T as backupExistingConfig, H as backupMcpConfig, J as buildMcpServerConfig, c as cleanupPermissions, a as commandExists, V as configureApi, U as copyConfigFiles, ad as detectInstalledVersion, N as ensureApiKeyApproved, R as ensureClaudeDir, af as executeInstallMethod, K as fixWindowsMcpConfig, B as getAiOutputLanguageLabel, a0 as getExistingApiConfig, $ as getExistingModelConfig, a9 as getInstallationStatus, E as getMcpConfigPath, g as getPlatform, ag as handleInstallFailure, b as importRecommendedEnv, d as importRecommendedPermissions, i as init, a5 as installClaudeCode, a7 as installCodex, a4 as isClaudeCodeInstalled, u as isCodeToolType, a6 as isCodexInstalled, a8 as isLocalClaudeCodeInstalled, P as manageApiKeyApproval, m as mergeAndCleanPermissions, W as mergeConfigs, I as mergeMcpServers, _ as mergeSettingsFile, o as openSettingsJson, a3 as promptApiConfigurationAction, F as readMcpConfig, O as removeApiKeyFromRejected, aa as removeLocalClaudeCode, w as resolveCodeToolType, ae as selectInstallMethod, ac as setInstallMethod, Q as setPrimaryApiKey, a2 as switchToOfficialLogin, ab as uninstallCodeTool, X as updateCustomModel, Y as updateDefaultModel, G as writeMcpConfig } from './chunks/simple-config.mjs';
+export { z as AI_OUTPUT_LANGUAGES, A as API_DEFAULT_URL, v as API_ENV_KEY, C as CLAUDE_DIR, e as CLAUDE_MD_FILE, h as CLAUDE_VSC_CONFIG_FILE, n as CODEX_AGENTS_FILE, l as CODEX_AUTH_FILE, k as CODEX_CONFIG_FILE, j as CODEX_DIR, p as CODEX_PROMPTS_DIR, t as CODE_TOOL_ALIASES, s as CODE_TOOL_BANNERS, r as CODE_TOOL_TYPES, f as ClAUDE_CONFIG_FILE, D as DEFAULT_CODE_TOOL_TYPE, y as LANG_LABELS, L as LEGACY_ZCF_CONFIG_FILES, S as SETTINGS_FILE, x as SUPPORTED_LANGS, Z as ZCF_CONFIG_DIR, q as ZCF_CONFIG_FILE, M as addCompletedOnboarding, a1 as applyAiLanguageDirective, T as backupExistingConfig, H as backupMcpConfig, J as buildMcpServerConfig, c as cleanupPermissions, a as commandExists, V as configureApi, U as copyConfigFiles, ai as createHomebrewSymlink, ad as detectInstalledVersion, aj as displayVerificationResult, N as ensureApiKeyApproved, R as ensureClaudeDir, af as executeInstallMethod, K as fixWindowsMcpConfig, B as getAiOutputLanguageLabel, a0 as getExistingApiConfig, $ as getExistingModelConfig, a9 as getInstallationStatus, E as getMcpConfigPath, g as getPlatform, ag as handleInstallFailure, b as importRecommendedEnv, d as importRecommendedPermissions, i as init, a5 as installClaudeCode, a7 as installCodex, a4 as isClaudeCodeInstalled, u as isCodeToolType, a6 as isCodexInstalled, a8 as isLocalClaudeCodeInstalled, P as manageApiKeyApproval, m as mergeAndCleanPermissions, W as mergeConfigs, I as mergeMcpServers, _ as mergeSettingsFile, o as openSettingsJson, a3 as promptApiConfigurationAction, F as readMcpConfig, O as removeApiKeyFromRejected, aa as removeLocalClaudeCode, w as resolveCodeToolType, ae as selectInstallMethod, ac as setInstallMethod, Q as setPrimaryApiKey, a2 as switchToOfficialLogin, ab as uninstallCodeTool, X as updateCustomModel, Y as updateDefaultModel, ah as verifyInstallation, G as writeMcpConfig } from './chunks/simple-config.mjs';
 import 'node:fs';
 import 'node:process';
 import 'ansis';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "zcf",
   "type": "module",
-  "version": "3.4.0",
+  "version": "3.4.2",
   "description": "Zero-Config Code Flow - One-click configuration tool for Code Cli",
   "author": {
     "name": "Miao Da",