pleumrouter 0.3.1 → 0.5.0

package/src/recipes.mjs

@@ -1,8 +1,15 @@
 import { ROOT, V1 } from "./config.mjs";
 
-// 도구별 설정의 진실 원천. 출처: frontend .../docs/cookbook/agent-integration.
+// 도구별 설정의 진실 원천. 출처: frontend .../docs/cookbook/agent-integration + 에이전트별 공식 문서 조사(2026-07).
 // type "env"        → 환경변수만 세팅하고 바로 실행.
 // type "codex-home" → 격리된 CODEX_HOME에 config.toml을 써서 실행(사용자 ~/.codex 보존).
+// note 필드는 t() 키(영어 원문)만 담는다 — 여기서 t()를 호출하면 모듈 로드 시점에 번역이
+// 고정돼 같은 프로세스 안에서 언어를 바꿔도(Settings) 안내문이 갱신되지 않는다.
+// 실제 번역은 소비 지점(launch.mjs)에서 매번 t()를 호출해 얻는다.
+//
+// 커스텀 엔드포인트를 지원하지 않아 PleumRouter로 라우팅할 수 없는 도구는 등록하지 않는다(조사 결과, 2026-07):
+//   Gemini CLI(구글 백엔드 전용, PR#2899 머지 거부) · Cursor CLI(구독 백엔드 전용, 공식 확인) ·
+//   Amp(Sourcegraph 백엔드 전용) · OpenClaw(멀티채널 게이트웨이 데몬 — 세션형 코딩 CLI가 아님 + 파일설정 전용).
 export const RECIPES = {
   claude: {
     label: "Claude Code",
@@ -18,6 +25,14 @@ export const RECIPES = {
     }),
     args: (m) => (m ? ["--model", `anthropic/${m}`] : []),
   },
+  codex: {
+    label: "Codex CLI",
+    bin: "codex",
+    type: "codex-home",
+    install: "npm i -g @openai/codex",
+    env: (key) => ({ PLEUM_API_KEY: key }),
+    args: () => [],
+  },
   aider: {
     label: "Aider",
     bin: "aider",
@@ -31,7 +46,7 @@ export const RECIPES = {
     bin: "goose",
     type: "env",
     install: "https://block.github.io/goose/docs/getting-started/installation",
-    note: "Goose는 모델을 설정에서 지정합니다 — `goose configure`에서 openai/<id> 형식 사용.",
+    note: "Goose sets its model in its own config — use the openai/<id> format in `goose configure`.",
     env: (key) => ({ OPENAI_API_BASE: V1, OPENAI_API_KEY: key }),
     args: () => [],
   },
@@ -40,16 +55,73 @@ export const RECIPES = {
     bin: "openhands",
     type: "env",
     install: "python -m pip install openhands-ai",
-    note: "OpenHands는 모델명 앞에 openai/ 접두사를 붙여 설정하세요.",
+    note: "For OpenHands, prefix the model name with openai/ in its config.",
     env: (key) => ({ OPENAI_API_BASE: V1, OPENAI_API_KEY: key }),
     args: () => [],
   },
-  codex: {
-    label: "Codex CLI",
-    bin: "codex",
-    type: "codex-home",
-    install: "npm i -g @openai/codex",
-    env: (key) => ({ PLEUM_API_KEY: key }),
+  opencode: {
+    label: "opencode",
+    bin: "opencode",
+    type: "env",
+    install: "npm i -g opencode-ai@latest",
+    // opencode는 커스텀 엔드포인트를 opencode.json provider 블록으로만 읽는다 — env var는 없다.
+    // 대신 OPENCODE_CONFIG_CONTENT(파일 대신 JSON 문자열을 그대로 읽는 env var)로 파일 없이 주입한다.
+    note: "Generates a temporary PleumRouter provider config for this run only — your own opencode.json is untouched.",
+    env: (key, model) => ({
+      PLEUM_API_KEY: key,
+      OPENCODE_CONFIG_CONTENT: JSON.stringify({
+        provider: {
+          pleum: {
+            npm: "@ai-sdk/openai-compatible",
+            name: "PleumRouter",
+            options: { baseURL: V1, apiKey: "{env:PLEUM_API_KEY}" },
+            models: { [model || "gpt-4.1"]: {} },
+          },
+        },
+      }),
+    }),
+    args: (m) => ["--model", `pleum/${m || "gpt-4.1"}`],
+  },
+  omp: {
+    label: "omp (Oh My Pi)",
+    bin: "omp",
+    type: "env",
+    install: "curl -fsSL https://omp.sh/install | sh",
+    // omp는 커스텀 OpenAI 호환 엔드포인트는 YAML 설정 파일로만 읽지만, 내장 anthropic
+    // provider만은 claude와 동일한 ANTHROPIC_BASE_URL env var로 리디렉션된다.
+    note: "Needs the Bun runtime (bun >= 1.3.14) on PATH. Only Claude-family models are routed via env vars.",
+    env: (key) => ({ ANTHROPIC_BASE_URL: ROOT, ANTHROPIC_API_KEY: key }),
+    args: (m) => (m ? ["--model", `anthropic/${m}`] : []),
+  },
+  hermes: {
+    label: "Hermes Agent",
+    bin: "hermes",
+    type: "env",
+    install: "curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash",
+    note: "Pick the model after it starts with the `hermes model` command.",
+    env: (key) => ({ OPENAI_BASE_URL: V1, OPENAI_API_KEY: key }),
+    args: () => [],
+  },
+  qwen: {
+    label: "Qwen Code",
+    bin: "qwen",
+    type: "env",
+    install: "npm install -g @qwen-code/qwen-code@latest",
+    env: (key, model) => ({ OPENAI_BASE_URL: V1, OPENAI_API_KEY: key, OPENAI_MODEL: model || "gpt-4.1" }),
+    args: () => [],
+  },
+  copilot: {
+    label: "GitHub Copilot CLI",
+    bin: "copilot",
+    type: "env",
+    install: "npm install -g @github/copilot",
+    note: "Needs GitHub Copilot CLI 2026-04 or later for BYOK provider routing support.",
+    env: (key, model) => ({
+      COPILOT_PROVIDER_BASE_URL: V1,
+      COPILOT_PROVIDER_TYPE: "openai",
+      COPILOT_PROVIDER_API_KEY: key,
+      COPILOT_MODEL: model || "gpt-4.1",
+    }),
     args: () => [],
   },
 };
@@ -72,22 +144,10 @@ wire_api = "responses"
 
 // provider 정의가 파일에 있어야 하는 도구 — 자동 실행 대신 설정 스니펫만 안내.
 export const MANUAL = {
-  opencode: {
-    label: "OpenCode",
-    file: "opencode.json",
-    snippet: () => `{
-  "provider": {
-    "pleum": {
-      "npm": "@ai-sdk/openai-compatible",
-      "name": "PleumRouter",
-      "options": { "baseURL": "${V1}", "apiKey": "{env:PLEUM_API_KEY}" },
-      "models": { "gpt-4.1": {} }
-    }
-  }
-}`,
-  },
   crush: {
     label: "Crush",
+    bin: "crush",
+    install: "npm install -g @charmland/crush",
     file: "crush.json",
     snippet: () => `{
   "providers": {

package/src/run.mjs

@@ -6,6 +6,7 @@ import { fetchModels, formatTable, matchModels } from "./models.mjs";
 import { style, divider } from "./ansi.mjs";
 import { createMarkdownStream } from "./markdown.mjs";
 import { spinner, select } from "./interactive.mjs";
+import { t } from "./i18n.mjs";
 
 const IMG_EXT = /\.(png|jpe?g|gif|webp|bmp)$/i;
 
@@ -67,14 +68,14 @@ export async function run(rest) {
   if (!model && !oneShot) {
     if (!process.stdin.isTTY) {
       // 비대화형(non-TTY) stdin이면 인터랙티브 모델 선택이 멈춰버리므로 명확히 안내하고 종료(L10).
-      console.error('모델을 지정하세요: pleum run <model> ["프롬프트"]  (비대화형 stdin에선 모델 선택 불가)');
+      console.error(t('Specify a model: pleum run <model> ["prompt"]  (model selection isn\'t available on non-interactive stdin)'));
       process.exit(1);
     }
     model = await pickModel(); // 인터랙티브 모델 선택
     if (!model) process.exit(1);
   }
   if (!model) {
-    console.error('사용법: pleum run <model> ["프롬프트"]\n모델 목록: pleum models');
+    console.error(t('Usage: pleum run <model> ["prompt"]\nModel list: pleum models'));
     process.exit(1);
   }
 
@@ -84,7 +85,7 @@ export async function run(rest) {
     if (Array.isArray(content)) {
       const n = content.filter((p) => p.type === "image_url").length;
       // 프롬프트 내 로컬 이미지 경로를 자동 첨부·업로드하므로 조용히 올리지 않고 명시 고지한다(M8).
-      console.error(`ℹ 프롬프트의 로컬 이미지 ${n}개를 첨부해 업로드합니다.`);
+      console.error(`ℹ ${t("Attaching and uploading {n} local image(s) from the prompt.", { n })}`);
     }
     const messages = [{ role: "user", content }];
     try {
@@ -204,7 +205,7 @@ async function repl(key, initialModel, initialVerbose) {
   const onClose = () => {
     if (pickerActive) return;
     saveHistory(rl.history);
-    console.log(`\n${style.dim("안녕히 가세요.")}`);
+    console.log(`\n${style.dim(t("Goodbye."))}`);
     process.exit(0);
   };
 
@@ -220,7 +221,7 @@ async function repl(key, initialModel, initialVerbose) {
       return;
     }
     lastSigint = now;
-    console.log(`\n${style.dim("한 번 더 Ctrl+C 하면 종료 (/exit 도 가능)")}`);
+    console.log(`\n${style.dim(t("Ctrl+C again to quit (or /exit)"))}`);
     rl.prompt();
   };
 
@@ -240,23 +241,25 @@ async function repl(key, initialModel, initialVerbose) {
 
   makeRl(loadHistory());
   console.log(`${style.bold(style.plum("PleumRouter"))} ${style.dim("·")} ${model}`);
-  console.log(style.dim('/help 명령 · /exit 종료 · 여러 줄은 """ 감싸기 · 생성 중 Ctrl+C=중단'));
+  console.log(style.dim(t('/help for commands · /exit to quit · wrap multi-line input in """ · Ctrl+C to stop generation')));
   console.log(divider());
   rl.prompt();
 }
 
-const SLASH_HELP = `명령:
-  /help, /?           이 도움말
-  /clear              대화 컨텍스트 초기화(시스템 프롬프트는 유지)
-  /system [텍스트]    시스템 프롬프트 설정(인자 없으면 현재값 표시)
-  /model [id]         세션 유지한 채 모델 전환(인자 없으면 화살표 선택)
-  /models [검색어]    모델 목록 보기
-  /save [이름]        현재 세션 저장(기본 last)
-  /load [이름]        세션 불러오기
-  /verbose            토큰·속도 통계 표시 토글
-  /exit, /quit        종료
-  여러 줄 입력: """ 한 줄 → 본문 → """ 한 줄
-  이미지: 메시지에 이미지 파일 경로를 그대로 포함(예: 이 그림 설명해줘 ./shot.png)`;
+// t() 키(영어 원문)만 담는다 — 모듈 로드 시점에 t()를 호출하면 같은 프로세스 안에서
+// 언어를 바꿔도(Settings) 이 도움말만 예전 언어로 남는다. 실제 번역은 소비 지점(handleSlash)에서.
+const SLASH_HELP = `Commands:
+  /help, /?           this help
+  /clear              reset the conversation context (keeps the system prompt)
+  /system [text]      set the system prompt (no arg shows the current value)
+  /model [id]         switch models mid-session (no arg = arrow-key picker)
+  /models [query]     browse the model list
+  /save [name]        save the current session (default: last)
+  /load [name]        load a saved session
+  /verbose            toggle token/speed stats
+  /exit, /quit        quit
+  Multi-line input: a line with """ → body → a line with """
+  Images: include an image file path right in the message (e.g. describe this ./shot.png)`;
 
 async function handleSlash(text, ctx) {
   const [cmd] = text.slice(1).split(/\s+/);
@@ -264,41 +267,41 @@ async function handleSlash(text, ctx) {
   switch (cmd) {
     case "help":
     case "?":
-      console.log(SLASH_HELP);
+      console.log(t(SLASH_HELP));
       break;
     case "clear":
       ctx.clear();
-      console.log(`${style.green("✓")} 컨텍스트 초기화`);
+      console.log(`${style.green("✓")} ${t("Context cleared")}`);
       break;
     case "system":
       if (arg) {
         ctx.system = arg;
-        console.log(`${style.green("✓")} 시스템 프롬프트 설정`);
+        console.log(`${style.green("✓")} ${t("System prompt set")}`);
       } else {
-        console.log(ctx.system ? `현재 시스템 프롬프트:\n${ctx.system}` : "시스템 프롬프트 없음");
+        console.log(ctx.system ? `${t("Current system prompt:")}\n${ctx.system}` : t("No system prompt"));
       }
       break;
     case "model":
       if (arg) {
         ctx.model = arg;
-        console.log(`${style.green("✓")} 모델 전환 → ${style.plum(arg)}`);
+        console.log(`${style.green("✓")} ${t("Switched model →")} ${style.plum(arg)}`);
       } else if (ctx.pickModel) {
         const picked = await ctx.pickModel();
         if (picked) {
           ctx.model = picked;
-          console.log(`${style.green("✓")} 모델 전환 → ${style.plum(picked)}`);
+          console.log(`${style.green("✓")} ${t("Switched model →")} ${style.plum(picked)}`);
         } else {
-          console.log(`현재 모델: ${style.plum(ctx.model)}`);
+          console.log(`${t("Current model:")} ${style.plum(ctx.model)}`);
         }
       } else {
-        console.log(`현재 모델: ${ctx.model}\n전환: /model <id>  ·  목록: /models`);
+        console.log(`${t("Current model:")} ${ctx.model}\n${t("switch: /model <id>  ·  list: /models")}`);
       }
       break;
     case "models":
       try {
         const models = await fetchModels();
         const rows = matchModels(models, arg);
-        console.log(rows.length ? formatTable(rows) : "일치하는 모델 없음");
+        console.log(rows.length ? formatTable(rows) : t("No matching models"));
       } catch (e) {
         console.error(`${style.red("✗")} ${e.message}`);
       }
@@ -306,25 +309,25 @@ async function handleSlash(text, ctx) {
     case "save":
       try {
         const name = saveSession(arg || "last", ctx.snapshot());
-        console.log(`${style.green("✓")} 세션 저장: ${name}`);
+        console.log(`${style.green("✓")} ${t("Session saved:")} ${name}`);
       } catch (e) {
-        console.error(`${style.red("✗")} 저장 실패: ${e.message}`);
+        console.error(`${style.red("✗")} ${t("Save failed: {error}", { error: e.message })}`);
       }
       break;
     case "load":
       try {
         ctx.restore(loadSession(arg || "last"));
-        console.log(`${style.green("✓")} 세션 불러옴 (모델: ${ctx.model})`);
+        console.log(`${style.green("✓")} ${t("Session loaded (model: {model})", { model: ctx.model })}`);
       } catch {
-        console.error(`${style.red("✗")} 세션 없음: ${arg || "last"}`);
+        console.error(`${style.red("✗")} ${t("No such session: {name}", { name: arg || "last" })}`);
       }
       break;
     case "verbose":
       ctx.verbose = !ctx.verbose;
-      console.log(`${style.green("✓")} 통계 ${ctx.verbose ? "켜짐" : "꺼짐"}`);
+      console.log(`${style.green("✓")} ${t("Stats {state}", { state: ctx.verbose ? t("on") : t("off") })}`);
       break;
     default:
-      console.log(`알 수 없는 명령: /${cmd}  (/help)`);
+      console.log(t("Unknown command: /{cmd}  (/help)", { cmd }));
   }
 }
 
@@ -332,7 +335,7 @@ async function handleSlash(text, ctx) {
 // 비용은 마지막 SSE 청크의 cost.krw — 스트리밍 응답엔 X-Cost-Krw 헤더가 없다(백엔드 계약).
 export async function streamChat(key, model, messages, { verbose = false, quiet = false, signal, fetchImpl = fetch } = {}) {
   const t0 = Date.now();
-  const sp = spinner(`${model} 생각 중…`);
+  const sp = spinner(t("{model} thinking…", { model }));
   let res;
   try {
     res = await fetchImpl(`${V1}/chat/completions`, {
@@ -344,7 +347,7 @@ export async function streamChat(key, model, messages, { verbose = false, quiet
   } catch (e) {
     sp.stop();
     if (isAbort(e)) {
-      console.error(style.dim("⏹ 중단됨"));
+      console.error(style.dim(t("⏹ aborted")));
       return "";
     }
     throw e;
@@ -400,7 +403,7 @@ export async function streamChat(key, model, messages, { verbose = false, quiet
   }
   sp.stop();
   md.finish();
-  if (aborted) console.error(style.dim("⏹ 생성 중단됨 — 부분 응답은 컨텍스트에 유지"));
+  if (aborted) console.error(style.dim(t("⏹ generation aborted — the partial reply stays in context")));
 
   const ms = Date.now() - t0;
   const genSec = (Date.now() - (firstAt || t0)) / 1000;
@@ -421,13 +424,13 @@ async function pickModel() {
   try {
     models = await fetchModels();
   } catch (e) {
-    console.error(`${style.red("✗")} 모델 목록 조회 실패: ${e.message}`);
+    console.error(`${style.red("✗")} ${t("Failed to fetch model list: {error}", { error: e.message })}`);
     return null;
   }
   if (!models.length) return null;
   if (process.stdin.isTTY && process.stdout.isTTY) {
     return select(models, {
-      message: "모델 선택",
+      message: t("Select a model"),
       formatItem: (m) => `${m.id}${m.display_name ? `  ${style.dim(m.display_name)}` : ""}`,
       matches: matchModels,
       limit: 12,
@@ -447,14 +450,14 @@ async function pickModelNumbered(models) {
       shown.forEach((m, i) =>
         console.log(`  ${String(i + 1).padStart(2)}. ${m.id}${m.display_name ? `  (${m.display_name})` : ""}`),
       );
-      if (pool.length > shown.length) console.log(`  … ${pool.length - shown.length}개 더 — 검색어로 좁히기`);
-      const ans = (await ask("\n번호 선택 또는 검색어 (Enter=취소): ")).trim();
+      if (pool.length > shown.length) console.log(`  ${t("… {n} more — narrow with a search term", { n: pool.length - shown.length })}`);
+      const ans = (await ask(`\n${t("Choose a number, or search (Enter to cancel): ")}`)).trim();
       if (!ans) return null;
       const n = Number(ans);
       if (Number.isInteger(n) && n >= 1 && n <= shown.length) return shown[n - 1].id;
       const next = matchModels(models, ans);
       pool = next.length ? next : models;
-      if (!next.length) console.log("일치 없음 — 전체 목록으로.");
+      if (!next.length) console.log(t("No matches — showing the full list."));
     }
   } finally {
     rl.close();

package/src/settings.mjs

@@ -0,0 +1,168 @@
+// 런처 Settings 서브메뉴 — agentSelect()(menu.mjs)와 동일한 "한 항목 → 서브메뉴" 패턴.
+// menu.mjs의 runList/saveModel을 가져오고 menu.mjs는 이 모듈의 runSettings를 가져오는
+// 순환 import가 있다 — 둘 다 함수 선언(export function)이라 ESM 인스턴스화 단계에서
+// 먼저 호이스팅되므로 안전하다. 다만 앞으로 이 파일을 고칠 때도 두 모듈 모두 상대방의
+// export를 "async 함수 바디 안에서만" 참조하는 규칙은 유지할 것(모듈 최상위에서 값으로
+// 즉시 참조하면 순환의 평가 순서에 따라 깨질 수 있다).
+
+import { readFileSync } from "node:fs";
+import { style } from "./ansi.mjs";
+import { select, confirm } from "./interactive.mjs";
+import { readConfig, writeConfig, clearCredentials } from "./config.mjs";
+import { getLocale, LANGS, t } from "./i18n.mjs";
+import { RECIPES } from "./recipes.mjs";
+import { fetchModels, matchModels } from "./models.mjs";
+import { login } from "./login.mjs";
+import { upgrade } from "./upgrade.mjs";
+import { completion } from "./completion.mjs";
+import { lang } from "./lang.mjs";
+import { runList, saveModel } from "./menu.mjs";
+
+// Settings 서브메뉴 항목(순수 함수 — 테스트 대상).
+export function buildSettingsItems({ lang, loggedIn, keyPrefix, 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") },
+    {
+      id: "settings:account",
+      title: t("Account"),
+      desc: loggedIn ? `${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:completion", title: t("Shell completion"), desc: t("Print a zsh/bash completion script") },
+  ];
+}
+
+// "Default models" 서브메뉴 항목(순수 함수 — 테스트 대상). chat + RECIPES 전부.
+// 필드명은 의도적으로 `tool`이 아니라 `toolId` — runList()의 → 키바인딩은 `it.tool`이
+// 있으면 자동으로 menu.mjs의 pickModelFor(클리어 옵션 없음)를 띄운다. 이 화면은 Enter로만
+// 진입해 "Use default (clear)"가 있는 자체 피커(pickDefaultModelFor)를 쓰므로 `tool`을
+// 피해 → 를 비활성 상태로 둔다(그래야 Enter 흐름과 중복 실행되지 않는다).
+export function buildDefaultModelItems({ savedModels = {} }) {
+  const tools = ["chat", ...Object.keys(RECIPES)];
+  return tools.map((tool) => ({
+    id: `defaultmodel:${tool}`,
+    toolId: tool,
+    title: tool === "chat" ? t("Chat with a model") : RECIPES[tool].label,
+    desc: savedModels[tool] ? `${t("model")}: ${savedModels[tool]}` : t("not set"),
+  }));
+}
+
+function readVersion() {
+  // bin/pleum.mjs의 version()과 동일한 1줄 패턴 복제 — bin/pleum.mjs는 entry-guard 없이
+  // process.argv 스위치를 최상위에서 바로 실행하는 진입점이라 import하면 CLI 디스패치가
+  // 함께 실행돼 버린다. menuSelect()도 같은 이유로 이 패턴을 복제해 쓰고 있다.
+  return JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8")).version;
+}
+
+function clearSavedModel(tool) {
+  const cfg = readConfig() ?? {};
+  if (cfg.launch_models) delete cfg.launch_models[tool];
+  writeConfig(cfg);
+}
+
+async function settingsSelect() {
+  const cfg = readConfig();
+  const items = buildSettingsItems({
+    lang: getLocale(),
+    loggedIn: Boolean(cfg?.key),
+    keyPrefix: cfg?.key ? cfg.key.slice(0, 8) : null,
+    version: readVersion(),
+  });
+  return runList(items, {
+    header: style.bold(style.plum(t("Settings"))),
+    footer: t("↑/↓ move • enter select • esc back"),
+  });
+}
+
+const CLEAR_OPTION = { id: "__clear__", display_name: null, isClear: true };
+
+async function pickDefaultModelFor(item) {
+  let models;
+  try {
+    models = await fetchModels();
+  } catch (e) {
+    console.log(`${style.red("✗")} ${t("Failed to fetch model list: {error}", { error: e.message })}`);
+    return undefined;
+  }
+  const picked = await select([CLEAR_OPTION, ...models], {
+    message: `${item.title} — ${t("select a model")}`,
+    formatItem: (x) => (x.isClear ? style.dim(t("Use default (clear)")) : `${x.id}${x.display_name ? `  ${style.dim(x.display_name)}` : ""}`),
+    matches: matchModels, // 쿼리 입력 시 CLEAR_OPTION은 자연히 필터링됨(id/display_name 불일치) — 별도 처리 불요
+    limit: 12,
+  });
+  return picked ?? undefined; // select()는 취소 시 null — pickModelFor 관례처럼 undefined로 정규화
+}
+
+async function runDefaultModels() {
+  for (;;) {
+    const items = buildDefaultModelItems({ savedModels: readConfig()?.launch_models ?? {} });
+    const picked = await runList(items, {
+      header: style.bold(style.plum(t("Default models"))),
+      footer: t("↑/↓ move • enter set model • esc back"),
+    });
+    if (picked === undefined) return undefined;
+    if (picked === null) return null;
+    if (picked === "quit") return "quit";
+    const result = await pickDefaultModelFor(picked.item);
+    if (!result) continue; // 취소/조회 실패 — 목록 다시 표시
+    if (result.isClear) clearSavedModel(picked.item.toolId);
+    else saveModel(picked.item.toolId, result.id);
+    // 메인 런처의 →(설정 즉시 실행)와 의도적으로 다르다 — 저장만 하고 목록으로 복귀.
+  }
+}
+
+async function runAccount() {
+  const cfg = readConfig();
+  if (cfg?.key) {
+    const ok = await confirm(t("Log out? [Y/n] "), { defaultYes: true });
+    if (ok) {
+      writeConfig(clearCredentials(cfg));
+      console.log(`✓ ${t("Logged out")}`);
+    }
+  } else {
+    await login();
+  }
+}
+
+async function runCompletion() {
+  const picked = await select(
+    [{ id: "zsh", label: "zsh" }, { id: "bash", label: "bash" }],
+    { message: t("Choose a shell"), formatItem: (x) => x.label },
+  );
+  if (picked) completion(picked.id); // 출력만 — rc 파일 자동 수정 없음(기존 completion.mjs 그대로)
+}
+
+// Settings 서브메뉴 루프. 반환값은 runList 규약을 그대로 전파: "quit"(ctrl+c 또는 재설치
+// 시작) · null(esc/q, 메인 메뉴로) · undefined(비TTY).
+export async function runSettings() {
+  for (;;) {
+    const picked = await settingsSelect();
+    if (picked === undefined) return undefined;
+    if (picked === null) return null;
+    if (picked === "quit") return "quit";
+    switch (picked.item.id) {
+      case "settings:lang":
+        await lang([]); // TTY 화살표 피커 재사용 — setLocale()이 i18n 캐시를 즉시 갱신하므로
+        continue; // 다음 루프의 buildSettingsItems() 재빌드로 새 언어가 자연히 반영된다
+      case "settings:models": {
+        const r = await runDefaultModels();
+        if (r === "quit") return "quit";
+        continue;
+      }
+      case "settings:account":
+        await runAccount();
+        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();
+        return "quit";
+      case "settings:completion":
+        await runCompletion();
+        continue;
+    }
+  }
+}

package/src/top.mjs

@@ -3,6 +3,7 @@
 
 import { V1 } from "./config.mjs";
 import { style, padDisplay, barChart, divider } from "./ansi.mjs";
+import { t } from "./i18n.mjs";
 
 export function parseTopArgs(rest = []) {
   let period = "weekly";
@@ -11,7 +12,7 @@ export function parseTopArgs(rest = []) {
     else if (["daily", "weekly", "monthly"].includes(rest[i])) period = rest[i];
   }
   if (!["daily", "weekly", "monthly"].includes(period)) {
-    throw new Error(`period는 daily|weekly|monthly 중 하나: ${period}`);
+    throw new Error(t("period must be one of daily|weekly|monthly: {period}", { period }));
   }
   return { period };
 }
@@ -25,14 +26,14 @@ const fmtTok = (n) => {
 
 // rankings 응답 → 표시 문자열(순수 함수 — fixture 테스트 대상).
 export function renderTop(data, styler = style) {
-  const periodKo = { daily: "일간", weekly: "주간", monthly: "월간" }[data.period] || data.period;
+  const periodLabel = { daily: t("daily"), weekly: t("weekly"), monthly: t("monthly") }[data.period] || data.period;
   const lines = [];
-  lines.push(`${styler.bold(styler.plum("모델 리더보드"))} ${styler.dim(`· ${periodKo} · 토큰 ${fmtTok(data.total_tokens ?? 0)}`)}`);
+  lines.push(`${styler.bold(styler.plum(t("Model leaderboard")))} ${styler.dim(`· ${periodLabel} · ${t("tokens")} ${fmtTok(data.total_tokens ?? 0)}`)}`);
   lines.push(divider(undefined, styler));
 
   const board = data.leaderboard || [];
   if (!board.length) {
-    lines.push(styler.dim("데이터 없음"));
+    lines.push(styler.dim(t("No data")));
   } else {
     const idW = Math.max(...board.map((r) => r.model.length), 5);
     for (const r of board) {
@@ -53,7 +54,7 @@ export function renderTop(data, styler = style) {
   const share = data.market_share || [];
   if (share.length) {
     lines.push("");
-    lines.push(styler.bold("제공자 점유율"));
+    lines.push(styler.bold(t("Provider share")));
     const nameW = Math.max(...share.map((s) => s.provider.length), 8);
     for (const s of share) {
       lines.push(
@@ -67,6 +68,6 @@ export function renderTop(data, styler = style) {
 export async function top(rest) {
   const { period } = parseTopArgs(rest);
   const res = await fetch(`${V1}/stats/rankings?period=${period}`);
-  if (!res.ok) throw new Error(`리더보드 조회 실패 (${res.status})`);
+  if (!res.ok) throw new Error(t("Failed to fetch leaderboard ({status})", { status: res.status }));
   console.log(renderTop(await res.json()));
 }