pleumrouter 0.5.31 → 0.5.33

package/bin/pleum.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { readFileSync } from "node:fs";
 import { login, loginDevice, logout } from "../src/login.mjs";
-import { launch, launchHelp } from "../src/launch.mjs";
+import { launch, launchHelp, recoverAgySettings } from "../src/launch.mjs";
 import { wire, unwire, wireHelp, unwireHelp } from "../src/wire.mjs";
 import { run } from "../src/run.mjs";
 import { listModels } from "../src/models.mjs";
@@ -11,12 +11,17 @@ import { top } from "../src/top.mjs";
 import { health } from "../src/health.mjs";
 import { completion } from "../src/completion.mjs";
 import { upgrade } from "../src/upgrade.mjs";
+import { runUpdateCommand } from "../src/update.mjs";
 import { mainMenu, runAgentMenu } from "../src/menu.mjs";
 import { lang } from "../src/lang.mjs";
 import { RECIPES } from "../src/recipes.mjs";
 import { t } from "../src/i18n.mjs";
 import { sanitizeTerminalText } from "../src/ansi.mjs";
 
+// 이전 비정상 종료로 인한 잔존 백업 설정(agy 등)이 있으면 즉시 안전 복구
+recoverAgySettings();
+
+
 // 명령 구문(왼쪽)은 로케일과 무관 — 설명(오른쪽)만 번역, 폭은 가장 긴 구문 기준으로 계산.
 function buildHelp() {
   const rows = [
@@ -39,7 +44,8 @@ function buildHelp() {
     ["pleum health", t("Check gateway connectivity and login status")],
     ["pleum lang [code]", t("Show/change display language (en|ko|ja|zh|es)")],
     ["pleum completion <zsh|bash>", t("Print a shell completion script")],
-    ["pleum upgrade", t("Reinstall the latest version")],
+    ["pleum update [--force]", t("Update CLI to the latest version")],
+    ["pleum upgrade", t("Alias for pleum update --force")],
     ["pleum version", t("Print the version")],
   ];
   const width = Math.max(...rows.map(([cmd]) => cmd.length)) + 2;
@@ -141,8 +147,9 @@ try {
     case "completion":
       completion(rest[0]);
       break;
+    case "update":
     case "upgrade":
-      upgrade();
+      await runUpdateCommand(rest);
       break;
     case "version":
     case "-v":

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pleumrouter",
-  "version": "0.5.31",
+  "version": "0.5.33",
   "description": "Official PleumRouter terminal CLI — launch any coding agent against PleumRouter.",
   "type": "module",
   "bin": {

package/src/completion.mjs

@@ -3,7 +3,7 @@
 import { t } from "./i18n.mjs";
 import { launchToolNames } from "./recipes.mjs";
 
-const COMMANDS = "login logout lang launch wire unwire run models top balance usage health version upgrade completion help";
+const COMMANDS = "login logout lang launch wire unwire run models top balance usage health version update upgrade completion help";
 const TOOLS = launchToolNames().join(" ");
 
 function bash() {

package/src/config.mjs

@@ -241,3 +241,16 @@ export async function authFetch(path, init = {}) {
   });
 }
 
+/** 자동 업데이트 활성화 여부 (기본값: true). */
+export function isAutoUpdateEnabled(cfg = readConfig()) {
+  return cfg?.auto_update !== false;
+}
+
+/** 자동 업데이트 설정 저장. */
+export function setAutoUpdateEnabled(enabled) {
+  const cfg = readConfig() ?? {};
+  cfg.auto_update = Boolean(enabled);
+  writeConfig(cfg);
+}
+
+

package/src/interactive.mjs

@@ -92,6 +92,13 @@ export function keyFeeder() {
   };
 }
 
+// 문자열의 터미널 줄 수 계산 — 개행 문자(\n)가 있어도 줄 단위로 쪼개어 실제 출력 행 수를 정확히 합산
+export function rowsFor(s, width = terminalWidth()) {
+  return String(s)
+    .split("\n")
+    .reduce((sum, line) => sum + Math.max(1, Math.ceil(displayWidth(line) / Math.max(width, 1))), 0);
+}
+
 // 화살표 이동 · 타이핑 필터 · Enter 선택 · Esc/Ctrl+C 취소(null).
 // 비TTY면 즉시 null — 호출자가 기존 번호 피커 등으로 폴백한다.
 // process.exit는 절대 호출하지 않는다(취소 처리는 호출자 몫).
@@ -112,7 +119,6 @@ export async function select(items, {
     let windowStart = 0;
     let lastRows = 0;
 
-    const rowsFor = (s) => Math.max(1, Math.ceil(displayWidth(s) / Math.max(terminalWidth(), 1)));
     const erase = () => {
       if (!lastRows) return;
       output.write("\r" + (lastRows > 1 ? `\x1b[${lastRows - 1}A` : "") + "\x1b[0J");
@@ -130,14 +136,14 @@ export async function select(items, {
       windowStart = Math.max(0, Math.min(windowStart, Math.max(0, pool.length - limit)));
 
       const shown = pool.slice(windowStart, windowStart + limit);
-      const lines = [
+      const rawLines = [
         `${style.plum("?")} ${style.bold(message)} ${style.dim(t("type to filter · ↑↓ move · Enter select · Esc cancel"))}`,
         `${style.gray("›")} ${query}`,
       ];
       if (windowStart > 0) {
-        lines.push(style.dim(`  ${t("↑ {n} more above", { n: windowStart })}`));
+        rawLines.push(style.dim(`  ${t("↑ {n} more above", { n: windowStart })}`));
       }
-      lines.push(
+      rawLines.push(
         ...shown.map((it, idx) => {
           const itemIndex = windowStart + idx;
           return itemIndex === cursor
@@ -147,10 +153,11 @@ export async function select(items, {
       );
       const remainingBelow = pool.length - (windowStart + shown.length);
       if (remainingBelow > 0) {
-        lines.push(style.dim(`  ${t("… {n} more — type to narrow down", { n: remainingBelow })}`));
+        rawLines.push(style.dim(`  ${t("… {n} more — type to narrow down", { n: remainingBelow })}`));
       }
-      if (!pool.length) lines.push(style.dim(`  ${t("No matches")}`));
+      if (!pool.length) rawLines.push(style.dim(`  ${t("No matches")}`));
       erase();
+      const lines = rawLines.flatMap((l) => String(l).split("\n"));
       const frame = lines.join("\n");
       output.write(frame);
       lastRows = lines.reduce((n, l) => n + rowsFor(l), 0);

package/src/launch.mjs

@@ -146,16 +146,28 @@ export async function launch(tool, model, passthrough, { exit = true } = {}) {
     if (exit) process.exit(130);
   };
 
+  const onException = (err) => {
+    cleanup();
+    if (err) console.error(err);
+    if (exit) process.exit(1);
+  };
+
   process.once("SIGINT", onSignal);
   process.once("SIGTERM", onSignal);
   process.once("SIGHUP", onSignal);
+  process.once("SIGQUIT", onSignal);
   process.once("exit", cleanup);
+  process.once("uncaughtException", onException);
+  process.once("unhandledRejection", onException);
 
   const removeListeners = () => {
     process.removeListener("SIGINT", onSignal);
     process.removeListener("SIGTERM", onSignal);
     process.removeListener("SIGHUP", onSignal);
+    process.removeListener("SIGQUIT", onSignal);
     process.removeListener("exit", cleanup);
+    process.removeListener("uncaughtException", onException);
+    process.removeListener("unhandledRejection", onException);
   };
 
   const activeCtx = getActiveContext();
@@ -228,6 +240,12 @@ export function setupAgySettings(model, {
   rm = rmSync,
 } = {}) {
   const { settingsPath, backupPath } = paths;
+
+  // 비정상 종료로 남은 이전 백업이 있으면 먼저 안전 복구
+  if (exists(backupPath)) {
+    recoverAgySettings({ paths, read, write, exists, rm });
+  }
+
   const originalExists = exists(settingsPath);
   let originalContent = null;
   let parsed = null;
@@ -241,7 +259,8 @@ export function setupAgySettings(model, {
     }
   }
 
-  // 1. 비정상 종료 대비 백업 메타데이터 저장
+  // 1. 비정상 종료 대비 백업 메타데이터 저장 (gemini 값은 pleum의 잔재이므로 백업에서도 배제)
+  const hadProvider = Boolean(parsed && "modelProvider" in parsed && parsed.modelProvider !== "gemini");
   try {
     mkdir(dirname(backupPath), { recursive: true, mode: 0o700 });
     write(
@@ -250,8 +269,8 @@ export function setupAgySettings(model, {
         {
           settingsPath,
           originalExists,
-          originalHadModelProvider: Boolean(parsed && "modelProvider" in parsed),
-          originalModelProvider: parsed?.modelProvider ?? null,
+          originalHadModelProvider: hadProvider,
+          originalModelProvider: hadProvider ? parsed?.modelProvider : null,
           originalHadModel: Boolean(parsed && "model" in parsed),
           originalModel: parsed?.model ?? null,
           originalContent,
@@ -280,7 +299,7 @@ export function setupAgySettings(model, {
         if (currentContent) {
           try {
             const currentObj = JSON.parse(currentContent);
-            if (parsed && "modelProvider" in parsed) {
+            if (hadProvider && parsed?.modelProvider) {
               currentObj.modelProvider = parsed.modelProvider;
             } else {
               delete currentObj.modelProvider;
@@ -328,7 +347,7 @@ export function recoverAgySettings({
         const curContent = read(settingsPath, "utf8");
         try {
           const curObj = JSON.parse(curContent);
-          if (backup.originalHadModelProvider) {
+          if (backup.originalHadModelProvider && backup.originalModelProvider && backup.originalModelProvider !== "gemini") {
             curObj.modelProvider = backup.originalModelProvider;
           } else {
             delete curObj.modelProvider;

package/src/locales/es.mjs

@@ -288,5 +288,44 @@ export const ES = {
   "by tag": "por etiqueta",
   "by user": "por usuario",
   "Failed to fetch balance ({status})": "Error al obtener el saldo ({status})",
+
+  // Update & Auto-update
+  "Update CLI to the latest version": "Actualizar CLI a la última versión",
+  "Alias for pleum update --force": "Alias de pleum update --force",
+  "Auto update": "Actualización automática",
+  "Enabled (updates automatically on start)": "Activada (comprueba y actualiza al inicio)",
+  "Disabled": "Desactivada",
+  "Update available": "Actualización disponible",
+  "Update available: v{current} → v{latest}": "Actualización disponible: v{current} → v{latest}",
+  "Update available: v{current} → v{latest}. Run 'pleum update' to update.": "Actualización disponible: v{current} → v{latest}. Ejecute 'pleum update' para actualizar.",
+  "Auto-updating PleumRouter CLI...": "Actualizando automáticamente PleumRouter CLI...",
+  "Updating pleumrouter CLI...": "Actualizando PleumRouter CLI...",
+  "Updating pleumrouter (force reinstall)...": "Actualizando PleumRouter (reinstalación forzada)...",
+  "Already using the latest version of pleumrouter (v{version}).": "Ya está utilizando la última versión de PleumRouter (v{version}).",
+  "Use --force (-f) to reinstall anyway.": "Utilice --force (-f) para reinstalar de todos modos.",
+  "Updating pleumrouter from v{from} to v{to}...": "Actualizando PleumRouter de v{from} a v{to}...",
+  "Update completed! Please run `pleum` again to use the new version.": "¡Actualización completada! Ejecute `pleum` de nuevo para usar la nueva versión.",
+  "Update completed! Please run `pleum` again.": "¡Actualización completada! Ejecute `pleum` de nuevo.",
+
+  // Claude Code Tier Mapping
+  "Sonnet model": "Modelo Sonnet",
+  "Opus model": "Modelo Opus",
+  "Haiku model": "Modelo Haiku",
+
+  // Codex & agy Effort
+  "Select reasoning effort": "Seleccionar esfuerzo de razonamiento",
+  "Medium (Recommended)": "Medio (Recomendado)",
+  "Balanced reasoning speed and depth": "Velocidad y profundidad de razonamiento equilibradas",
+  "High (Deep reasoning)": "Alto (Razonamiento profundo)",
+  "Maximum reasoning depth for complex tasks": "Máxima profundidad de razonamiento para tareas complejas",
+  "Low (Fast response)": "Bajo (Respuesta rápida)",
+  "Lightweight reasoning for quick answers": "Razonamiento ligero para respuestas rápidas",
+  "High (Recommended)": "Alto (Recomendado)",
+  "High reasoning effort for standard tasks": "Alto esfuerzo de razonamiento para tareas estándar",
+  "Max (Maximum reasoning)": "Máximo (Razonamiento extremo)",
+  "Full reasoning effort for difficult problems": "Esfuerzo de razonamiento completo para problemas difíciles",
+  "Medium (Standard)": "Medio (Estándar)",
+  "Balanced reasoning effort": "Esfuerzo de razonamiento equilibrado",
+  "Low reasoning effort for rapid iteration": "Bajo esfuerzo de razonamiento para iteraciones rápidas",
 };
 

package/src/locales/ja.mjs

@@ -288,5 +288,44 @@ export const JA = {
   "by tag": "タグ別",
   "by user": "ユーザー別",
   "Failed to fetch balance ({status})": "残高の取得に失敗しました ({status})",
+
+  // Update & Auto-update
+  "Update CLI to the latest version": "CLIを最新バージョンにアップデート",
+  "Alias for pleum update --force": "pleum update --force のエイリアス",
+  "Auto update": "自動アップデート",
+  "Enabled (updates automatically on start)": "有効 (起動時に自動確認・更新)",
+  "Disabled": "無効",
+  "Update available": "更新可能",
+  "Update available: v{current} → v{latest}": "アップデートがあります: v{current} → v{latest}",
+  "Update available: v{current} → v{latest}. Run 'pleum update' to update.": "アップデートがあります: v{current} → v{latest}。「pleum update」を実行して更新してください。",
+  "Auto-updating PleumRouter CLI...": "PleumRouter CLI を自動アップデート中...",
+  "Updating pleumrouter CLI...": "PleumRouter CLI をアップデート中...",
+  "Updating pleumrouter (force reinstall)...": "PleumRouter をアップデート中 (強制再インストール)...",
+  "Already using the latest version of pleumrouter (v{version}).": "すでに最新バージョンの PleumRouter を使用しています (v{version})。",
+  "Use --force (-f) to reinstall anyway.": "強制再インストールするには --force (-f) を使用してください。",
+  "Updating pleumrouter from v{from} to v{to}...": "PleumRouter を v{from} から v{to} へアップデート中...",
+  "Update completed! Please run `pleum` again to use the new version.": "アップデート完了！新しいバージョンを使うには `pleum` を再起動してください。",
+  "Update completed! Please run `pleum` again.": "アップデート完了！`pleum` を再起動してください。",
+
+  // Claude Code Tier Mapping
+  "Sonnet model": "Sonnet モデル",
+  "Opus model": "Opus モデル",
+  "Haiku model": "Haiku モデル",
+
+  // Codex & agy Effort
+  "Select reasoning effort": "推論強度 (effort) の選択",
+  "Medium (Recommended)": "中 (推奨)",
+  "Balanced reasoning speed and depth": "推論速度と深さのバランス",
+  "High (Deep reasoning)": "高 (深層推論)",
+  "Maximum reasoning depth for complex tasks": "複雑なタスク向けの最大の推論深度",
+  "Low (Fast response)": "低 (高速応答)",
+  "Lightweight reasoning for quick answers": "素早い応答のための軽量推論",
+  "High (Recommended)": "高 (推奨)",
+  "High reasoning effort for standard tasks": "標準タスク向けの高い推論強度",
+  "Max (Maximum reasoning)": "最大 (極限推論)",
+  "Full reasoning effort for difficult problems": "難関タスク向けの最大の推論強度",
+  "Medium (Standard)": "中 (標準)",
+  "Balanced reasoning effort": "バランスの取れた標準的な推論強度",
+  "Low reasoning effort for rapid iteration": "迅速なイテレーション向けの低い推論強度",
 };
 

package/src/locales/ko.mjs

@@ -351,5 +351,44 @@ export const KO = {
   "by tag": "태그별",
   "by user": "사용자별",
   "Failed to fetch balance ({status})": "잔액 조회 실패 ({status})",
+
+  // Update & Auto-update
+  "Update CLI to the latest version": "CLI를 최신 버전으로 업데이트",
+  "Alias for pleum update --force": "pleum update --force의 별칭",
+  "Auto update": "자동 업데이트",
+  "Enabled (updates automatically on start)": "켜짐 (시작 시 자동 확인 및 업데이트)",
+  "Disabled": "꺼짐",
+  "Update available": "업데이트 가능",
+  "Update available: v{current} → v{latest}": "업데이트 가능: v{current} → v{latest}",
+  "Update available: v{current} → v{latest}. Run 'pleum update' to update.": "업데이트 가능: v{current} → v{latest}. 'pleum update'를 실행하여 업데이트하세요.",
+  "Auto-updating PleumRouter CLI...": "PleumRouter CLI 자동 업데이트 중...",
+  "Updating pleumrouter CLI...": "PleumRouter CLI 업데이트 중...",
+  "Updating pleumrouter (force reinstall)...": "PleumRouter 업데이트 중 (강제 재설치)...",
+  "Already using the latest version of pleumrouter (v{version}).": "이미 최신 버전의 PleumRouter를 사용 중입니다 (v{version}).",
+  "Use --force (-f) to reinstall anyway.": "재설치하려면 --force (-f) 옵션을 사용하세요.",
+  "Updating pleumrouter from v{from} to v{to}...": "PleumRouter를 v{from}에서 v{to}로 업데이트 중...",
+  "Update completed! Please run `pleum` again to use the new version.": "업데이트 완료! 새 버전을 사용하려면 `pleum`을 다시 실행하세요.",
+  "Update completed! Please run `pleum` again.": "업데이트 완료! `pleum`을 다시 실행하세요.",
+
+  // Claude Code Tier Mapping
+  "Sonnet model": "Sonnet 모델",
+  "Opus model": "Opus 모델",
+  "Haiku model": "Haiku 모델",
+
+  // Codex & agy Effort
+  "Select reasoning effort": "추론 강도(effort) 선택",
+  "Medium (Recommended)": "보통 (추천)",
+  "Balanced reasoning speed and depth": "추론 속도와 깊이의 균형",
+  "High (Deep reasoning)": "높음 (심층 추론)",
+  "Maximum reasoning depth for complex tasks": "복잡한 작업을 위한 최대 추론 깊이",
+  "Low (Fast response)": "낮음 (빠른 응답)",
+  "Lightweight reasoning for quick answers": "빠른 응답을 위한 가벼운 추론",
+  "High (Recommended)": "높음 (추천)",
+  "High reasoning effort for standard tasks": "일반 작업을 위한 높은 추론 강도",
+  "Max (Maximum reasoning)": "최대 (한계 추론)",
+  "Full reasoning effort for difficult problems": "고난도 문제를 위한 최대 추론 강도",
+  "Medium (Standard)": "보통 (표준)",
+  "Balanced reasoning effort": "균형 잡힌 표준 추론 강도",
+  "Low reasoning effort for rapid iteration": "빠른 반복 작업을 위한 낮은 추론 강도",
 };
 

package/src/locales/zh.mjs

@@ -288,5 +288,44 @@ export const ZH = {
   "by tag": "按标签",
   "by user": "按用户",
   "Failed to fetch balance ({status})": "获取余额失败 ({status})",
+
+  // Update & Auto-update
+  "Update CLI to the latest version": "将 CLI 更新到最新版本",
+  "Alias for pleum update --force": "pleum update --force 的别名",
+  "Auto update": "自动更新",
+  "Enabled (updates automatically on start)": "已启用 (启动时自动检查并更新)",
+  "Disabled": "已禁用",
+  "Update available": "有可用更新",
+  "Update available: v{current} → v{latest}": "有可用更新: v{current} → v{latest}",
+  "Update available: v{current} → v{latest}. Run 'pleum update' to update.": "有可用更新: v{current} → v{latest}。运行 'pleum update' 进行更新。",
+  "Auto-updating PleumRouter CLI...": "正在自动更新 PleumRouter CLI...",
+  "Updating pleumrouter CLI...": "正在更新 PleumRouter CLI...",
+  "Updating pleumrouter (force reinstall)...": "正在更新 PleumRouter (强制重新安装)...",
+  "Already using the latest version of pleumrouter (v{version}).": "已在使用最新版本的 PleumRouter (v{version})。",
+  "Use --force (-f) to reinstall anyway.": "如需强制重新安装，请使用 --force (-f)。",
+  "Updating pleumrouter from v{from} to v{to}...": "正在将 PleumRouter 从 v{from} 更新到 v{to}...",
+  "Update completed! Please run `pleum` again to use the new version.": "更新完成！请重新运行 `pleum` 以使用新版本。",
+  "Update completed! Please run `pleum` again.": "更新完成！请重新运行 `pleum`。",
+
+  // Claude Code Tier Mapping
+  "Sonnet model": "Sonnet 模型",
+  "Opus model": "Opus 模型",
+  "Haiku model": "Haiku 模型",
+
+  // Codex & agy Effort
+  "Select reasoning effort": "选择推理强度 (effort)",
+  "Medium (Recommended)": "中 (推荐)",
+  "Balanced reasoning speed and depth": "推理速度与深度的平衡",
+  "High (Deep reasoning)": "高 (深度推理)",
+  "Maximum reasoning depth for complex tasks": "适合复杂任务的最大推理深度",
+  "Low (Fast response)": "低 (快速响应)",
+  "Lightweight reasoning for quick answers": "快速解答的轻量推理",
+  "High (Recommended)": "高 (推荐)",
+  "High reasoning effort for standard tasks": "标准任务的高推理强度",
+  "Max (Maximum reasoning)": "最大 (极值推理)",
+  "Full reasoning effort for difficult problems": "困难问题的全力推理强度",
+  "Medium (Standard)": "中 (标准)",
+  "Balanced reasoning effort": "平衡的标准推理强度",
+  "Low reasoning effort for rapid iteration": "快速迭代的低推理强度",
 };
 

package/src/menu.mjs

@@ -13,7 +13,7 @@ import { spawn } from "node:child_process";
 import { createInterface } from "node:readline";
 import { style, displayWidth, terminalWidth, terminalHeight, hyperlink, sanitizeTerminalText } from "./ansi.mjs";
 import { keyFeeder, select } from "./interactive.mjs";
-import { readConfig, writeConfig, isLoggedIn, touchSession, getActiveContext } from "./config.mjs";
+import { readConfig, writeConfig, isLoggedIn, touchSession, getActiveContext, isAutoUpdateEnabled } from "./config.mjs";
 import { RECIPES, MANUAL, DEFAULT_MODEL } from "./recipes.mjs";
 import { onPath, launch } from "./launch.mjs";
 import { fetchModels, matchModels, listModels, formatModelLabel, fetchCoreCodingModels, CORE_MODEL_PROVIDERS } from "./models.mjs";
@@ -24,6 +24,7 @@ import { usage } from "./usage.mjs";
 import { balance } from "./balance.mjs";
 import { health } from "./health.mjs";
 import { runSettings } from "./settings.mjs";
+import { checkLatestVersion, performUpdate } from "./update.mjs";
 import { t } from "./i18n.mjs";
 
 // 값은 t() 키(영어 원문)만 담는다 — 여기서 t()를 호출하면 모듈 로드 시점(import 1회)에
@@ -200,6 +201,80 @@ export async function pickModelFor(item, defaultModel) {
   }
 }
 
+export async function pickClaudeCodeTiers(agentItem) {
+  const cfg = readConfig() ?? {};
+  const savedTiers = cfg.claude_tiers || {};
+  const defaultTiers = {
+    sonnet: "claude-sonnet-5",
+    opus: "claude-opus-5-5",
+    haiku: DEFAULT_MODEL,
+  };
+  const baseTiers = {
+    sonnet: savedTiers.sonnet || defaultTiers.sonnet,
+    opus: savedTiers.opus || defaultTiers.opus,
+    haiku: savedTiers.haiku || defaultTiers.haiku,
+  };
+
+  // 1/3단계: Sonnet 모델 지정 (10개 핵심 추천 + 200+ 전체 검색 + 프로바이더 라우팅)
+  const sonnet = await pickModelFor(
+    { title: `${agentItem.title} (1/3) — ${t("Sonnet model")}` },
+    baseTiers.sonnet,
+  );
+  if (!sonnet) return null;
+
+  // 2/3단계: Opus 모델 지정 (10개 핵심 추천 + 200+ 전체 검색 + 프로바이더 라우팅)
+  const opus = await pickModelFor(
+    { title: `${agentItem.title} (2/3) — ${t("Opus model")}` },
+    baseTiers.opus,
+  );
+  if (!opus) return null;
+
+  // 3/3단계: Haiku 모델 지정 (10개 핵심 추천 + 200+ 전체 검색 + 프로바이더 라우팅)
+  const haiku = await pickModelFor(
+    { title: `${agentItem.title} (3/3) — ${t("Haiku model")}` },
+    baseTiers.haiku,
+  );
+  if (!haiku) return null;
+
+  const resultTiers = { sonnet, opus, haiku };
+  cfg.claude_tiers = resultTiers;
+  writeConfig(cfg);
+  return resultTiers;
+}
+
+export async function pickCodexEffort(defaultEffort = "medium") {
+  const options = [
+    { id: "medium", title: `⚡ ${t("Medium (Recommended)")}`, desc: t("Balanced reasoning speed and depth") },
+    { id: "high", title: `🔥 ${t("High (Deep reasoning)")}`, desc: t("Maximum reasoning depth for complex tasks") },
+    { id: "low", title: `⚡ ${t("Low (Fast response)")}`, desc: t("Lightweight reasoning for quick answers") },
+  ];
+  const initialIndex = options.findIndex((x) => x.id === defaultEffort);
+  const picked = await select(options, {
+    message: `Codex — ${t("Select reasoning effort")}`,
+    formatItem: (x) => `${x.title}  ${style.dim(x.desc)}`,
+    limit: 5,
+    initialCursor: initialIndex >= 0 ? initialIndex : 0,
+  });
+  return picked ? picked.id : null;
+}
+
+export async function pickAgyEffort(defaultEffort = "high") {
+  const options = [
+    { id: "high", title: `⚡ ${t("High (Recommended)")}`, desc: t("High reasoning effort for standard tasks") },
+    { id: "max", title: `🚀 ${t("Max (Maximum reasoning)")}`, desc: t("Full reasoning effort for difficult problems") },
+    { id: "medium", title: `⚖️ ${t("Medium (Standard)")}`, desc: t("Balanced reasoning effort") },
+    { id: "low", title: `⚡ ${t("Low (Fast response)")}`, desc: t("Low reasoning effort for rapid iteration") },
+  ];
+  const initialIndex = options.findIndex((x) => x.id === defaultEffort);
+  const picked = await select(options, {
+    message: `Antigravity CLI (agy) — ${t("Select reasoning effort")}`,
+    formatItem: (x) => `${x.title}  ${style.dim(x.desc)}`,
+    limit: 6,
+    initialCursor: initialIndex >= 0 ? initialIndex : 0,
+  });
+  return picked ? picked.id : null;
+}
+
 // 미설치 도구: ollama처럼 확인 후 그 자리에서 설치(stdio 상속). 성공 시 true.
 async function ensureInstalled(r) {
   if (!autoInstallable(r)) {
@@ -244,7 +319,10 @@ export async function runList(items, { header, footer, initialCursor = 0 } = {})
   let windowStart = 0;
   let lastRows = 0;
 
-  const rowsFor = (s) => Math.max(1, Math.ceil(displayWidth(s) / Math.max(terminalWidth(), 1)));
+  const rowsFor = (s) =>
+    String(s)
+      .split("\n")
+      .reduce((sum, line) => sum + Math.max(1, Math.ceil(displayWidth(line) / Math.max(terminalWidth(), 1))), 0);
   const erase = () => {
     if (!lastRows) return;
     output.write("\r" + (lastRows > 1 ? `\x1b[${lastRows - 1}A` : "") + "\x1b[0J");
@@ -296,8 +374,9 @@ export async function runList(items, { header, footer, initialCursor = 0 } = {})
     lines.push(style.dim(footer));
 
     erase();
-    output.write(lines.join("\n"));
-    lastRows = lines.reduce((n, l) => n + rowsFor(l), 0);
+    const frameLines = lines.flatMap((l) => String(l).split("\n"));
+    output.write(frameLines.join("\n"));
+    lastRows = frameLines.reduce((n, l) => n + rowsFor(l), 0);
   };
 
   const move = (dir) => {
@@ -375,7 +454,7 @@ export async function runList(items, { header, footer, initialCursor = 0 } = {})
   });
 }
 
-async function menuSelect() {
+async function menuSelect(updateInfo = null) {
   const version = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8")).version;
   const cfg = readConfig();
   const items = buildItems({
@@ -384,8 +463,19 @@ async function menuSelect() {
   });
   const last = cfg?.last_selection;
   const initialCursor = last ? Math.max(0, items.findIndex((it) => it.id === last)) : 0;
+  const headerLines = [`${style.bold(style.plum("PleumRouter"))} ${style.dim(`pleum ${version}`)}`];
+  if (updateInfo?.isOutdated) {
+    headerLines.push(
+      style.yellow(
+        `💡 ${t("Update available: v{current} → v{latest}. Run 'pleum update' to update.", {
+          current: updateInfo.currentVersion,
+          latest: updateInfo.latestVersion,
+        })}`,
+      ),
+    );
+  }
   return runList(items, {
-    header: `${style.bold(style.plum("PleumRouter"))} ${style.dim(`pleum ${version}`)}`,
+    header: headerLines.join("\n"),
     footer: t("↑/↓ move • enter run • → set model • esc quit"),
     initialCursor,
   });
@@ -403,7 +493,7 @@ async function agentSelect() {
 }
 
 // 에이전트 실행 메뉴 — bare pleum의 "에이전트 실행"과 pleum launch (인자 없음)가 공유.
-// 에이전트를 고르면 곧바로 핵심 10개 모델 피커를 띄워 기본 모델(deepseek-v4.1-flash) 또는
+// 에이전트를 고르면 곧바로 모델/티어/추론 피커를 띄워 기본 모델 또는
 // 선택한 우리 모델로 코딩 에이전트를 실행한다.
 export async function runAgentMenu({ loop = false } = {}) {
   const io = process.stdin;
@@ -430,15 +520,53 @@ export async function runAgentMenu({ loop = false } = {}) {
     }
 
     const agentSaved = readConfig()?.launch_models ?? {};
-    let chosenModel = agentPicked.model;
-    if (!chosenModel) {
-      const defaultForTool = agentSaved[agentItem.tool] || DEFAULT_MODEL;
-      chosenModel = await pickModelFor(agentItem, defaultForTool);
-      if (!chosenModel) continue; // Esc 취소 시 에이전트 목록으로 복귀
+    let launchModelPayload = null;
+
+    if (agentItem.tool === "claude") {
+      const tiers = await pickClaudeCodeTiers(agentItem);
+      if (!tiers) continue;
+      launchModelPayload = tiers;
+      saveModel("claude", tiers.sonnet);
+    } else if (agentItem.tool === "codex") {
+      let chosenModel = agentPicked.model;
+      if (!chosenModel) {
+        const defaultForTool = agentSaved[agentItem.tool] || DEFAULT_MODEL;
+        chosenModel = await pickModelFor(agentItem, defaultForTool);
+        if (!chosenModel) continue;
+      }
+      saveModel("codex", chosenModel);
+      const cfg = readConfig() ?? {};
+      const effort = await pickCodexEffort(cfg.codex_effort || "medium");
+      if (!effort) continue;
+      cfg.codex_effort = effort;
+      writeConfig(cfg);
+      launchModelPayload = { model: chosenModel, effort };
+    } else if (agentItem.tool === "agy") {
+      let chosenModel = agentPicked.model;
+      if (!chosenModel) {
+        const defaultForTool = agentSaved[agentItem.tool] || DEFAULT_MODEL;
+        chosenModel = await pickModelFor(agentItem, defaultForTool);
+        if (!chosenModel) continue;
+      }
+      saveModel("agy", chosenModel);
+      const cfg = readConfig() ?? {};
+      const effort = await pickAgyEffort(cfg.agy_effort || "high");
+      if (!effort) continue;
+      cfg.agy_effort = effort;
+      writeConfig(cfg);
+      launchModelPayload = { model: chosenModel, effort };
+    } else {
+      let chosenModel = agentPicked.model;
+      if (!chosenModel) {
+        const defaultForTool = agentSaved[agentItem.tool] || DEFAULT_MODEL;
+        chosenModel = await pickModelFor(agentItem, defaultForTool);
+        if (!chosenModel) continue;
+      }
+      saveModel(agentItem.tool, chosenModel);
+      launchModelPayload = chosenModel;
     }
 
-    saveModel(agentItem.tool, chosenModel);
-    await launch(agentItem.tool, chosenModel, [], { exit: false });
+    await launch(agentItem.tool, launchModelPayload, [], { exit: false });
     console.log();
     if (!loop) return true;
   }
@@ -457,8 +585,24 @@ export async function mainMenu() {
   if (!isLoggedIn()) await login();
   else await touchSession().catch(() => {});
 
+  let updateInfo = null;
+  try {
+    updateInfo = await checkLatestVersion();
+    if (updateInfo?.isOutdated) {
+      if (isAutoUpdateEnabled()) {
+        console.log(`💡 ${t("Update available: v{current} → v{latest}", { current: updateInfo.currentVersion, latest: updateInfo.latestVersion })}`);
+        console.log(`▶ ${t("Auto-updating PleumRouter CLI...")}\n`);
+        const code = await performUpdate();
+        if (code === 0) {
+          console.log(`\n✓ ${t("Update completed! Please run `pleum` again.")}`);
+          return true;
+        }
+      }
+    }
+  } catch {}
+
   for (;;) {
-    const picked = await menuSelect();
+    const picked = await menuSelect(updateInfo);
     if (picked === undefined) return false; // 비TTY
     if (picked === null || picked === "quit") return true; // esc/q/ctrl+c — ollama처럼 조용히 종료
 

package/src/recipes.mjs

@@ -42,16 +42,29 @@ export const RECIPES = {
     },
     // 함정: ANTHROPIC_BASE_URL은 반드시 루트(/v1 없이) — CLI가 /v1/messages를 스스로 덧붙인다.
     // /v1을 넣으면 /v1/v1/messages가 되어 실패.
-    env: (key) => ({
-      ANTHROPIC_BASE_URL: ROOT,
-      ANTHROPIC_API_KEY: key,
-      ANTHROPIC_AUTH_TOKEN: key,
-      // /model 이 GET {ANTHROPIC_BASE_URL}/v1/models 를 치게 한다. 기본값은 꺼져 있다.
-      CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY: "1",
-      ANTHROPIC_SMALL_MODEL: "anthropic/deepseek-ai/DeepSeek-V4.1-Flash",
-      ANTHROPIC_DEFAULT_HAIKU_MODEL: "anthropic/deepseek-ai/DeepSeek-V4.1-Flash",
-    }),
-    args: (m) => ["--model", (m || DEFAULT_MODEL).startsWith("anthropic/") ? (m || DEFAULT_MODEL) : `anthropic/${m || DEFAULT_MODEL}`],
+    env: (key, m) => {
+      const isObj = m && typeof m === "object";
+      const sonnet = (isObj ? m.sonnet : m) || "claude-sonnet-5";
+      const opus = (isObj ? m.opus : null) || "claude-opus-5-5";
+      const haiku = (isObj ? m.haiku : null) || DEFAULT_MODEL;
+      const toAnthropic = (x) => (x.startsWith("anthropic/") ? x : `anthropic/${x}`);
+      return {
+        ANTHROPIC_BASE_URL: ROOT,
+        ANTHROPIC_API_KEY: key,
+        ANTHROPIC_AUTH_TOKEN: key,
+        // /model 이 GET {ANTHROPIC_BASE_URL}/v1/models 를 치게 한다. 기본값은 꺼져 있다.
+        CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY: "1",
+        ANTHROPIC_DEFAULT_SONNET_MODEL: toAnthropic(sonnet),
+        ANTHROPIC_DEFAULT_OPUS_MODEL: toAnthropic(opus),
+        ANTHROPIC_DEFAULT_HAIKU_MODEL: toAnthropic(haiku),
+        ANTHROPIC_SMALL_MODEL: toAnthropic(haiku),
+      };
+    },
+    args: (m) => {
+      const isObj = m && typeof m === "object";
+      const main = (isObj ? m.sonnet : m) || DEFAULT_MODEL;
+      return ["--model", main.startsWith("anthropic/") ? main : `anthropic/${main}`];
+    },
   },
   codex: {
     label: "Codex CLI",
@@ -63,7 +76,11 @@ export const RECIPES = {
       referer: "https://github.com/openai/codex",
     },
     env: (key) => ({ PLEUM_API_KEY: key }),
-    args: () => [],
+    args: (m) => {
+      const isObj = m && typeof m === "object";
+      const effort = isObj ? m.effort : null;
+      return effort ? ["-c", `model_reasoning_effort="${effort}"`] : [];
+    },
   },
   agy: {
     label: "Antigravity CLI",
@@ -80,7 +97,14 @@ export const RECIPES = {
       GEMINI_API_KEY: key,
       GOOGLE_API_KEY: key,
     }),
-    args: (m) => ["--model", m || DEFAULT_MODEL],
+    args: (m) => {
+      const isObj = m && typeof m === "object";
+      const model = (isObj ? m.model : m) || DEFAULT_MODEL;
+      const effort = isObj ? m.effort : null;
+      const res = ["--model", model];
+      if (effort) res.push("--effort", effort);
+      return res;
+    },
   },
   opencode: {
     label: "opencode",
@@ -378,12 +402,15 @@ export function tomlBasicString(value) {
   return `"${escaped}"`;
 }
 
-export function codexToml(model) {
-  const m = model || DEFAULT_MODEL;
+export function codexToml(model, effort) {
+  const isObj = model && typeof model === "object";
+  const m = (isObj ? model.model : model) || DEFAULT_MODEL;
+  const eff = (isObj ? model.effort : effort) || null;
+  const effortLine = eff ? `model_reasoning_effort = ${tomlBasicString(eff)}\n` : "";
   return `# Generated by pleum CLI. Isolated CODEX_HOME — your ~/.codex is untouched.
 model = ${tomlBasicString(m)}
 model_provider = "pleum"
-
+${effortLine}
 [model_providers.pleum]
 name = "PleumRouter"
 base_url = ${tomlBasicString(V1)}
@@ -401,7 +428,9 @@ export function mergeAgySettings(existingJson, model) {
       throw new Error("agy settings.json must be a JSON object");
     }
   }
-  return { ...obj, modelProvider: "gemini", model: model || DEFAULT_MODEL };
+  const isObj = model && typeof model === "object";
+  const m = (isObj ? model.model : model) || DEFAULT_MODEL;
+  return { ...obj, modelProvider: "gemini", model: m };
 }
 
 export function piModelsJson(model) {

package/src/settings.mjs

@@ -8,7 +8,7 @@
 import { readFileSync } from "node:fs";
 import { style, sanitizeTerminalText } from "./ansi.mjs";
 import { select, confirm } from "./interactive.mjs";
-import { readConfig, writeConfig, isLoggedIn, getActiveContext } from "./config.mjs";
+import { readConfig, writeConfig, isLoggedIn, getActiveContext, isAutoUpdateEnabled, setAutoUpdateEnabled } from "./config.mjs";
 import { getLocale, LANGS, t } from "./i18n.mjs";
 import { RECIPES } from "./recipes.mjs";
 import { fetchModels, matchModels, formatModelLabel } from "./models.mjs";
@@ -18,12 +18,25 @@ import { completion } from "./completion.mjs";
 import { lang } from "./lang.mjs";
 import { switchCreditWorkspace } from "./balance.mjs";
 import { runList, saveModel } from "./menu.mjs";
+import { checkLatestVersion, isNewerVersion, runUpdateCommand } from "./update.mjs";
 
 // Settings 서브메뉴 항목(순수 함수 — 테스트 대상).
-export function buildSettingsItems({ lang, loggedIn, keyPrefix, version, activeContext = { type: "personal" } }) {
+export function buildSettingsItems({
+  lang,
+  loggedIn,
+  keyPrefix,
+  version,
+  activeContext = { type: "personal" },
+  autoUpdate = true,
+  latestVersion = null,
+}) {
   const contextDesc = activeContext?.type === "team" && activeContext.org_name
     ? `${t("Team")}: ${activeContext.org_name}`
     : t("Personal Credit");
+  const updateDesc = latestVersion && isNewerVersion(version, latestVersion)
+    ? `${t("Current version: {version}", { version })} → v${latestVersion} (${t("Update available")})`
+    : t("Current version: {version}", { version });
+
   return [
     { id: "settings:lang", title: t("Language"), desc: `${t("current")}: ${LANGS[lang] ?? lang}` },
     { id: "settings:models", title: t("Default models"), desc: t("Set the default model used per agent") },
@@ -38,7 +51,12 @@ export function buildSettingsItems({ lang, loggedIn, keyPrefix, version, activeC
           : `${t("Logged in")} (${t("key")} ${keyPrefix}…)`
         : t("Not logged in"),
     },
-    { id: "settings:update", title: t("Update CLI"), desc: t("Current version: {version}", { version }) },
+    {
+      id: "settings:auto_update",
+      title: t("Auto update"),
+      desc: autoUpdate ? t("Enabled (updates automatically on start)") : t("Disabled"),
+    },
+    { id: "settings:update", title: t("Update CLI"), desc: updateDesc },
     { id: "settings:completion", title: t("Shell completion"), desc: t("Print a zsh/bash completion script") },
   ];
 }
@@ -73,12 +91,18 @@ function clearSavedModel(tool) {
 
 async function settingsSelect() {
   const cfg = readConfig();
+  let updateInfo = null;
+  try {
+    updateInfo = await checkLatestVersion();
+  } catch {}
   const items = buildSettingsItems({
     lang: getLocale(),
     loggedIn: isLoggedIn(cfg),
     keyPrefix: cfg?.access_token ? "oauth" : cfg?.key ? cfg.key.slice(0, 8) : null,
     version: readVersion(),
     activeContext: getActiveContext(cfg),
+    autoUpdate: isAutoUpdateEnabled(cfg),
+    latestVersion: updateInfo?.latestVersion,
   });
   return runList(items, {
     header: style.bold(style.plum(t("Settings"))),
@@ -164,12 +188,14 @@ export async function runSettings() {
       case "settings:account":
         await runAccount();
         continue;
+      case "settings:auto_update": {
+        const next = !isAutoUpdateEnabled();
+        setAutoUpdateEnabled(next);
+        continue;
+      }
       case "settings:update":
-        // upgrade()는 자식(npm install) 종료 시 process.exit()을 호출한다. 여기서 continue해
-        // 메뉴를 다시 그리면 raw-mode 화면과 npm 출력이 뒤섞이다 프로세스가 갑자기 죽으므로,
-        // mainMenu()의 chat 케이스처럼 즉시 루프를 벗어난다.
-        console.log(t("Reinstalling — pleum will exit when finished. Run `pleum` again afterward."));
-        upgrade();
+        console.log(t("Updating pleumrouter CLI..."));
+        await runUpdateCommand([], { exit: false });
         return "quit";
       case "settings:completion":
         await runCompletion();

package/src/update.mjs

@@ -0,0 +1,157 @@
+import { spawn } from "node:child_process";
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+import { t } from "./i18n.mjs";
+
+const REGISTRY_URL = "https://registry.npmjs.org/pleumrouter/latest";
+const CHECK_INTERVAL_MS = 60 * 60 * 1000; // 1시간 캐시
+
+export function readCliVersion() {
+  try {
+    const pkg = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8"));
+    return pkg.version;
+  } catch {
+    return "0.0.0";
+  }
+}
+
+export function parseSemver(v) {
+  if (!v) return [0, 0, 0];
+  const clean = String(v).trim().replace(/^v/, "");
+  const parts = clean.split("-")[0].split(".").map((n) => parseInt(n, 10) || 0);
+  return [parts[0] ?? 0, parts[1] ?? 0, parts[2] ?? 0];
+}
+
+export function isNewerVersion(current, latest) {
+  const [cMaj, cMin, cPat] = parseSemver(current);
+  const [lMaj, lMin, lPat] = parseSemver(latest);
+  if (lMaj !== cMaj) return lMaj > cMaj;
+  if (lMin !== cMin) return lMin > cMin;
+  return lPat > cPat;
+}
+
+export function getUpdateCachePath() {
+  return join(homedir(), ".pleum", "update-cache.json");
+}
+
+export function readUpdateCache(cachePath = getUpdateCachePath()) {
+  try {
+    if (!existsSync(cachePath)) return null;
+    return JSON.parse(readFileSync(cachePath, "utf8"));
+  } catch {
+    return null;
+  }
+}
+
+export function writeUpdateCache(latestVersion, cachePath = getUpdateCachePath()) {
+  try {
+    const dir = join(homedir(), ".pleum");
+    mkdirSync(dir, { recursive: true, mode: 0o700 });
+    writeFileSync(
+      cachePath,
+      JSON.stringify({ last_check: Date.now(), latest_version: latestVersion }, null, 2),
+      { mode: 0o600 },
+    );
+  } catch {}
+}
+
+export async function fetchLatestVersionFromRegistry({ timeoutMs = 2000, fetchFn = globalThis.fetch } = {}) {
+  try {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    const res = await fetchFn(REGISTRY_URL, {
+      signal: controller.signal,
+      headers: { Accept: "application/json" },
+    });
+    clearTimeout(timer);
+    if (!res.ok) return null;
+    const data = await res.json();
+    return data?.version ?? null;
+  } catch {
+    return null;
+  }
+}
+
+export async function checkLatestVersion({
+  force = false,
+  timeoutMs = 2000,
+  currentVersion = null,
+  cachePath = getUpdateCachePath(),
+  fetchFn = globalThis.fetch,
+} = {}) {
+  const cur = currentVersion || readCliVersion();
+  const cached = readUpdateCache(cachePath);
+
+  if (!force && cached?.latest_version && typeof cached.last_check === "number") {
+    if (Date.now() - cached.last_check < CHECK_INTERVAL_MS) {
+      return {
+        currentVersion: cur,
+        latestVersion: cached.latest_version,
+        isOutdated: isNewerVersion(cur, cached.latest_version),
+      };
+    }
+  }
+
+  const remote = await fetchLatestVersionFromRegistry({ timeoutMs, fetchFn });
+  if (remote) {
+    writeUpdateCache(remote, cachePath);
+    return {
+      currentVersion: cur,
+      latestVersion: remote,
+      isOutdated: isNewerVersion(cur, remote),
+    };
+  }
+
+  // 네트워크 실패 시 기존 캐시가 있으면 재활용, 없으면 현재 버전으로 안전 폴백
+  const fallbackLatest = cached?.latest_version || cur;
+  return {
+    currentVersion: cur,
+    latestVersion: fallbackLatest,
+    isOutdated: isNewerVersion(cur, fallbackLatest),
+  };
+}
+
+export function performUpdate({ bin = null } = {}) {
+  const npmCmd = bin || (process.platform === "win32" ? "npm.cmd" : "npm");
+  return new Promise((resolve) => {
+    const child = spawn(npmCmd, ["install", "-g", "pleumrouter@latest"], {
+      stdio: "inherit",
+      shell: false,
+    });
+    child.on("error", (e) => {
+      console.error(`✗ ${e.message}`);
+      resolve(1);
+    });
+    child.on("exit", (code) => resolve(code ?? 0));
+  });
+}
+
+export async function runUpdateCommand(args = [], { exit = true } = {}) {
+  const force = args.includes("--force") || args.includes("-f");
+  const cur = readCliVersion();
+
+  if (force) {
+    console.log(`▶ ${t("Updating pleumrouter (force reinstall)...")}\n`);
+    const code = await performUpdate();
+    if (exit) process.exit(code);
+    return code;
+  }
+
+  const { latestVersion, isOutdated } = await checkLatestVersion({ force: true });
+
+  if (!isOutdated) {
+    console.log(`✓ ${t("Already using the latest version of pleumrouter (v{version}).", { version: cur })}`);
+    console.log(t("Use --force (-f) to reinstall anyway."));
+    if (exit) process.exit(0);
+    return 0;
+  }
+
+  console.log(`▶ ${t("Updating pleumrouter from v{from} to v{to}...", { from: cur, to: latestVersion })}\n`);
+  const code = await performUpdate();
+  if (code === 0) {
+    console.log(`\n✓ ${t("Update completed! Please run `pleum` again to use the new version.")}`);
+  }
+  if (exit) process.exit(code);
+  return code;
+}

package/src/upgrade.mjs

@@ -1,16 +1,10 @@
-import { spawn } from "node:child_process";
+import { performUpdate, runUpdateCommand } from "./update.mjs";
 
-// 최신 버전으로 전역 재설치. brew tap 보류 상태라 npm 경로([[project_pleum_cli]]).
-export function upgrade() {
-  console.log("▶ npm install -g pleumrouter@latest\n");
-  const bin = process.platform === "win32" ? "npm.cmd" : "npm";
-  const child = spawn(bin, ["install", "-g", "pleumrouter@latest"], {
-    stdio: "inherit",
-    shell: false,
-  });
-  child.on("error", (e) => {
-    console.error(`✗ ${e.message}`);
-    process.exit(1);
-  });
-  child.on("exit", (code) => process.exit(code ?? 0));
+export { performUpdate, runUpdateCommand };
+
+// 최신 버전으로 전역 재설치. 하위 호환을 위해 유지하며 process.exit() 호출 규약을 보존한다.
+export async function upgrade() {
+  const code = await runUpdateCommand(["--force"], { exit: false });
+  process.exit(code ?? 0);
 }
+