pleumrouter 0.3.1 → 0.5.0

package/README.md

@@ -29,9 +29,9 @@ cat error.log | npx pleumrouter run gpt-4.1 "원인은?"   # 파이프
 
 | 명령 | 설명 |
 |------|------|
-| `pleum` | (인자 없음, TTY) 인터랙티브 런처 메뉴 — 채팅·에이전트 실행·잔액·리더보드를 키보드·마우스로. ↑/↓·휠 이동 · enter·클릭 실행 · →·우클릭 모델 설정 · esc 종료. 미설치 에이전트는 확인 후 자동 설치, 실행 종료 후 메뉴 복귀. 파이프에선 도움말 출력 |
+| `pleum` | (인자 없음, TTY) 인터랙티브 런처 메뉴 — 키보드 전용. ↑/↓ 이동 · enter 실행 · → 모델 설정 · esc 종료(서브메뉴에선 뒤로) · ctrl+c 즉시 종료. "에이전트 실행" 진입 시 Claude Code·Codex·opencode·omp·Hermes Agent·Qwen Code·GitHub Copilot CLI 등 지원 에이전트 전체를 설치 여부와 함께 볼 수 있고, 미설치는 확인 후 자동 설치(또는 설정 파일 안내). "설정" 진입 시 언어·에이전트별 기본 모델·계정(로그인/로그아웃)·CLI 업데이트·셸 자동완성을 한곳에서 관리. 실행 종료 후 메뉴 복귀. 파이프에선 도움말 출력 |
 | `pleum login [--device]` | 브라우저로 로그인 → CLI가 API 키를 자동 발급·저장(`~/.pleum/config.json`). `--device`는 SSH·CI |
-| `pleum logout` | 저장된 키 삭제 |
+| `pleum logout` | 저장된 API 키만 삭제(언어·기본 모델 등 나머지 설정은 유지) |
 | `pleum launch [tool] [--model id] [-- args]` | 에이전트 실행. `--` 뒤 인자는 도구로 그대로 전달. 도구 생략 시 지원 목록·설치 여부 표시 |
 | `pleum run [model] ["프롬프트"]` | 채팅 — 대화형 REPL, 1회 실행, stdin 파이프. 모델 생략 시 화살표로 선택 |
 | `pleum models [query] [--json]` | 모델 목록(공개) — provider·컨텍스트·가격(₩/1M) 컬럼, `--json`은 스크립트용 |
@@ -40,6 +40,7 @@ cat error.log | npx pleumrouter run gpt-4.1 "원인은?"   # 파이프
 | `pleum balance` | 크레딧 잔액 조회 |
 | `pleum usage [--by model\|provider\|api_key\|day] [--days N]` | 내 지출 리포트(막대 차트) — 최신 로그인 키 필요(`usage:read`) |
 | `pleum health` | 게이트웨이 연결·DB·Redis·환율·로그인 상태 점검(셀프호스트 진단용) |
+| `pleum lang [code]` | 표시 언어 조회/변경 — `en`(기본)·`ko`·`ja`·`zh`·`es`. 인자 없이 TTY면 화살표로 선택, `PLEUM_LANG` 환경변수로도 덮어쓰기 가능 |
 | `pleum completion <zsh\|bash>` | 셸 자동완성 스크립트 출력 |
 | `pleum upgrade` | 최신 버전으로 재설치 |
 | `pleum version` | 버전 출력 |
@@ -69,10 +70,11 @@ cat error.log | npx pleumrouter run gpt-4.1 "원인은?"   # 파이프
 
 ## 자동 실행 지원 도구
 
-`claude` · `aider` · `codex` · `goose` · `openhands` — env(또는 격리된 `CODEX_HOME`)만
-세팅하고 바로 실행한다. 사용자의 기존 설정 파일은 건드리지 않는다.
+`claude` · `aider` · `codex` · `goose` · `openhands` · `opencode` · `omp` · `hermes` · `qwen` · `copilot` —
+env(또는 격리된 `CODEX_HOME`/임시 설정 문자열)만 세팅하고 바로 실행한다. 사용자의 기존 설정 파일은
+건드리지 않는다.
 
-`opencode` · `crush` 는 provider 정의가 파일에 필요해 설정 스니펫만 안내한다.
+`crush` 는 provider 정의가 파일에 필요해 설정 스니펫만 안내한다.
 
 ## 환경변수
 

package/bin/pleum.mjs

@@ -10,41 +10,53 @@ 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 { clearConfig } from "../src/config.mjs";
+import { readConfig, writeConfig, clearCredentials } from "../src/config.mjs";
 import { mainMenu } from "../src/menu.mjs";
+import { lang } from "../src/lang.mjs";
+import { RECIPES } from "../src/recipes.mjs";
+import { t } from "../src/i18n.mjs";
 
-const HELP = `pleum — PleumRouter 터미널 CLI
+// 명령 구문(왼쪽)은 로케일과 무관 — 설명(오른쪽)만 번역, 폭은 가장 긴 구문 기준으로 계산.
+function buildHelp() {
+  const rows = [
+    ["pleum", t("(no args) interactive launcher menu — keyboard only (TTY only)")],
+    ["pleum login [--device]", t("Log in via browser + auto-save the key")],
+    ["", t("--device: browser-less environments (SSH/CI)")],
+    ["pleum logout", t("Delete the saved key")],
+    ["pleum launch [tool] [--model id]", t("Run a coding agent against PleumRouter")],
+    ["", `(${Object.keys(RECIPES).join(" · ")})`],
+    ["", t("omit the tool to see the supported list and install status")],
+    ['pleum run [model] ["prompt"]', t("Terminal chat (REPL) / one-shot / pipe")],
+    ["", t("omit the model for an arrow-key picker; /help lists commands")],
+    ["pleum models [query] [--json]", t("Model list (price, context included)")],
+    ["pleum models <id> --info", t("Model detail (price, perf, per-provider uptime)")],
+    ["pleum top [--period weekly]", t("Model leaderboard · provider share (daily|weekly|monthly)")],
+    ["pleum balance", t("Check your credit balance")],
+    ["pleum usage [--by model] [--days 30]", t("Your spend report (model|provider|api_key|day)")],
+    ["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 version", t("Print the version")],
+  ];
+  const width = Math.max(...rows.map(([cmd]) => cmd.length)) + 2;
+  const body = rows.map(([cmd, desc]) => `  ${cmd.padEnd(width)}${desc}`).join("\n");
 
-  pleum                              (인자 없음) 인터랙티브 런처 메뉴 — 키보드·마우스 (TTY 전용)
-  pleum login [--device]             브라우저로 로그인 + 키 자동 저장
-                                     --device: 브라우저 없는 환경(SSH·CI)
-  pleum logout                       저장된 키 삭제
-  pleum launch [tool] [--model id]   코딩 에이전트를 PleumRouter로 실행
-                                     (claude · aider · codex · goose · openhands)
-                                     도구 생략 시 지원 목록·설치 여부 표시
-  pleum run [model] ["프롬프트"]      터미널 채팅(REPL) / 1회 실행 / 파이프
-                                     모델 생략 시 화살표로 선택, /help 로 명령
-  pleum models [query] [--json]      모델 목록(가격·컨텍스트 포함)
-  pleum models <id> --info           모델 상세(가격·성능·provider별 uptime)
-  pleum top [--period weekly]        모델 리더보드·제공자 점유율(daily|weekly|monthly)
-  pleum balance                      크레딧 잔액 조회
-  pleum usage [--by model] [--days 30]  내 지출 리포트(model|provider|api_key|day)
-  pleum health                       게이트웨이 연결·로그인 상태 점검
-  pleum completion <zsh|bash>        셸 자동완성 스크립트 출력
-  pleum upgrade                      최신 버전으로 재설치
-  pleum version                      버전 출력
+  const examples = [
+    ["pleum launch claude --model claude-sonnet-4", null],
+    ["pleum launch codex --model gpt-4.1 -- --full-auto", null],
+    ["pleum run gpt-4.1", t("interactive")],
+    [`pleum run gpt-4.1 "${t("Summarize in one line: ...")}"`, t("one-shot")],
+    [`cat error.log | pleum run gpt-4.1 "${t("what caused this?")}"`, t("pipe")],
+    ["pleum models deepseek/deepseek-chat --info", t("model detail")],
+    ["pleum usage --by day --days 7", t("last 7 days, by day")],
+    ["pleum login --device", t("SSH/CI environment")],
+  ];
+  const exWidth = Math.max(...examples.map(([cmd]) => cmd.length)) + 2;
+  const exBody = examples.map(([cmd, note]) => `  ${note ? cmd.padEnd(exWidth) + `# ${note}` : cmd}`).join("\n");
 
-예:
-  pleum launch claude --model claude-sonnet-4
-  pleum launch codex --model gpt-4.1 -- --full-auto
-  pleum run gpt-4.1                          # 대화형
-  pleum run gpt-4.1 "한 줄로 요약: ..."       # 1회 실행
-  cat error.log | pleum run gpt-4.1 "원인은?"  # 파이프
-  pleum models deepseek/deepseek-chat --info # 모델 상세
-  pleum usage --by day --days 7              # 최근 1주 일별 지출
-  pleum login --device                       # SSH/CI 환경
-
-base_url 덮어쓰기: PLEUM_BASE_URL 환경변수`;
+  return `pleum — ${t("PleumRouter terminal CLI")}\n\n${body}\n\n${t("Examples:")}\n${exBody}\n\n${t("Override base_url: PLEUM_BASE_URL environment variable")}`;
+}
 
 // `--model id`/`-m id`를 뽑고, 나머지는 도구로 그대로 넘긴다. `--` 이후는 전부 패스스루.
 function parseLaunchArgs(args) {
@@ -72,9 +84,14 @@ try {
       if (rest.includes("--device")) await loginDevice();
       else await login();
       break;
-    case "logout":
-      clearConfig();
-      console.log("✓ 로그아웃됨");
+    case "logout": {
+      const cfg = readConfig();
+      if (cfg) writeConfig(clearCredentials(cfg)); // 로그인 이력 없으면(cfg=null) 빈 파일을 새로 만들지 않는다
+      console.log(`✓ ${t("Logged out")}`);
+      break;
+    }
+    case "lang":
+      await lang(rest);
       break;
     case "launch": {
       const tool = rest[0];
@@ -117,15 +134,15 @@ try {
       break;
     case undefined:
       // TTY면 ollama풍 런처 메뉴, 파이프/스크립트면 기존 도움말.
-      if (!(await mainMenu())) console.log(HELP);
+      if (!(await mainMenu())) console.log(buildHelp());
       break;
     case "-h":
     case "--help":
     case "help":
-      console.log(HELP);
+      console.log(buildHelp());
       break;
     default:
-      console.error(`알 수 없는 명령: ${cmd}\n\n${HELP}`);
+      console.error(`${t("Unknown command: {cmd}", { cmd })}\n\n${buildHelp()}`);
       process.exit(1);
   }
 } catch (e) {

package/package.json

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

package/src/balance.mjs

@@ -1,5 +1,6 @@
 import { V1, requireKey } from "./config.mjs";
 import { style } from "./ansi.mjs";
+import { t } from "./i18n.mjs";
 
 export async function balance() {
   const key = requireKey();
@@ -8,18 +9,18 @@ export async function balance() {
   });
   if (!res.ok) {
     const body = await res.text().catch(() => "");
-    console.error(`잔액 조회 실패 (HTTP ${res.status})${body ? `: ${body.slice(0, 200)}` : ""}`);
+    console.error(`${t("Failed to check balance (HTTP {status})", { status: res.status })}${body ? `: ${body.slice(0, 200)}` : ""}`);
     if (res.status === 401) {
-      console.error(style.dim("서버가 아직 API 키 잔액 조회를 지원하지 않거나 키가 만료됐을 수 있습니다 — pleum login 재시도."));
+      console.error(style.dim(t("The server may not support API-key balance checks yet, or the key may have expired — try pleum login again.")));
     }
     process.exit(1);
   }
   const data = await res.json();
   const plm = data.balance_krw;
   const usd = data.balance_usd != null ? style.dim(` / $${data.balance_usd.toFixed(4)}`) : "";
-  console.log(`잔액: ${style.bold(style.plum(`${plm.toLocaleString("ko-KR")} PLM`))}${usd}`);
+  console.log(`${t("Balance:")} ${style.bold(style.plum(`${plm.toLocaleString("ko-KR")} PLM`))}${usd}`);
   const threshold = data.auto_charge_threshold_krw;
   if (threshold != null && plm < threshold) {
-    console.log(style.yellow(`⚠ 잔액이 자동충전 임계값(${threshold.toLocaleString("ko-KR")} PLM) 아래입니다.`));
+    console.log(style.yellow(`⚠ ${t("Balance is below the auto-charge threshold ({threshold} PLM).", { threshold: threshold.toLocaleString("ko-KR") })}`));
   }
 }

package/src/completion.mjs

@@ -1,10 +1,13 @@
 // Shell 자동완성 스크립트 출력. 명령·도구는 정적, 모델명은 `pleum models`에서 동적으로 채운다.
 // 설치: pleum completion zsh >> ~/.zshrc  ·  pleum completion bash >> ~/.bashrc
-const COMMANDS = "login logout launch run models top balance usage health version upgrade completion help";
-const TOOLS = "claude aider codex goose openhands opencode crush";
+import { t } from "./i18n.mjs";
+import { RECIPES, MANUAL } from "./recipes.mjs";
+
+const COMMANDS = "login logout lang launch run models top balance usage health version upgrade completion help";
+const TOOLS = [...Object.keys(RECIPES), ...Object.keys(MANUAL)].join(" ");
 
 function bash() {
-  return `# pleum bash completion — eval "$(pleum completion bash)" 또는 ~/.bashrc에 추가
+  return `# pleum bash completion — eval "$(pleum completion bash)" (${t("or add to ~/.bashrc")})
 _pleum() {
   local cur prev; cur="\${COMP_WORDS[COMP_CWORD]}"; prev="\${COMP_WORDS[COMP_CWORD-1]}"
   if [ "$COMP_CWORD" -eq 1 ]; then
@@ -21,7 +24,7 @@ complete -F _pleum pleum`;
 
 function zsh() {
   return `#compdef pleum
-# pleum zsh completion — eval "$(pleum completion zsh)" 또는 fpath에 _pleum로 추가
+# pleum zsh completion — eval "$(pleum completion zsh)" (${t("or add _pleum to fpath")})
 _pleum() {
   if (( CURRENT == 2 )); then
     compadd ${COMMANDS}; return
@@ -39,9 +42,9 @@ export function completion(shell) {
   if (shell === "bash") return void console.log(bash());
   if (shell === "zsh") return void console.log(zsh());
   console.error(
-    "사용법: pleum completion <zsh|bash>\n" +
-      '  zsh:  eval "$(pleum completion zsh)"   (또는 ~/.zshrc에 추가)\n' +
-      '  bash: eval "$(pleum completion bash)"  (또는 ~/.bashrc에 추가)',
+    t("Usage: pleum completion <zsh|bash>") + "\n" +
+      `  zsh:  eval "$(pleum completion zsh)"   (${t("or add to ~/.zshrc")})\n` +
+      `  bash: eval "$(pleum completion bash)"  (${t("or add to ~/.bashrc")})`,
   );
   process.exit(1);
 }

package/src/config.mjs

@@ -1,6 +1,7 @@
 import { homedir } from "node:os";
 import { join } from "node:path";
-import { readFileSync, writeFileSync, mkdirSync, rmSync } from "node:fs";
+import { readFileSync, writeFileSync, mkdirSync } from "node:fs";
+import { t } from "./i18n.mjs";
 
 // 공개 게이트웨이 루트. 셀프호스트/스테이징은 PLEUM_BASE_URL로 덮어쓴다.
 export const ROOT = (process.env.PLEUM_BASE_URL ?? "https://router.pleum.ai")
@@ -28,19 +29,23 @@ export function writeConfig(cfg) {
   writeFileSync(FILE, JSON.stringify(cfg, null, 2), { mode: 0o600 });
 }
 
-export function clearConfig() {
-  try {
-    rmSync(FILE);
-  } catch {
-    // 이미 없음 — 무시
-  }
+// 로그인 저장 — 기존 설정(lang·launch_models·last_selection)을 보존한 채 자격증명만 병합.
+// login/loginDevice가 매번 writeConfig({key, base_url})로 전체를 덮어쓰던 버그의 수정.
+export function mergeLoginConfig(existing, patch) {
+  return { ...(existing ?? {}), ...patch };
+}
+
+// 로그아웃 — key·base_url(자격증명)만 제거. lang·launch_models 등 나머지 설정은 보존.
+export function clearCredentials(existing) {
+  const { key, base_url, ...rest } = existing ?? {};
+  return rest;
 }
 
 // 키가 필요한 명령의 공통 가드. 없으면 안내 후 종료.
 export function requireKey() {
   const cfg = readConfig();
   if (!cfg?.key) {
-    console.error("로그인이 필요합니다. 먼저 실행하세요:\n  pleum login");
+    console.error(t("Login required. Run this first:\n  pleum login"));
     process.exit(1);
   }
   return cfg.key;

package/src/health.mjs

@@ -3,6 +3,7 @@
 
 import { ROOT, V1, readConfig } from "./config.mjs";
 import { style, divider } from "./ansi.mjs";
+import { t } from "./i18n.mjs";
 
 const ok = (s) => `${style.green("●")} ${s}`;
 const bad = (s) => `${style.red("●")} ${s}`;
@@ -14,24 +15,24 @@ export function renderHealth({ root, health, error, ms, keyPrefix }, styler = st
   lines.push(`${styler.bold(styler.plum("pleum health"))} ${styler.dim(`· ${root}`)}`);
   lines.push(divider(undefined, styler));
   if (error) {
-    lines.push(bad(`게이트웨이 연결 실패: ${error}`));
+    lines.push(bad(t("Gateway connection failed: {error}", { error })));
   } else {
     const isOk = (v) => v === "ok" || v === true; // 백엔드는 "ok" 문자열
-    lines.push((isOk(health.status) ? ok : warn)(`게이트웨이 ${health.status}${ms != null ? styler.dim(` (${ms}ms)`) : ""}`));
-    if (health.db != null) lines.push((isOk(health.db) ? ok : bad)(`DB ${isOk(health.db) ? "정상" : health.db}`));
-    if (health.redis != null) lines.push((isOk(health.redis) ? ok : bad)(`Redis ${isOk(health.redis) ? "정상" : health.redis}`));
-    if (health.providers_configured != null) lines.push(ok(`providers ${health.providers_configured}개 구성됨`));
+    lines.push((isOk(health.status) ? ok : warn)(`${t("Gateway")} ${health.status}${ms != null ? styler.dim(` (${ms}ms)`) : ""}`));
+    if (health.db != null) lines.push((isOk(health.db) ? ok : bad)(`DB ${isOk(health.db) ? t("healthy") : health.db}`));
+    if (health.redis != null) lines.push((isOk(health.redis) ? ok : bad)(`Redis ${isOk(health.redis) ? t("healthy") : health.redis}`));
+    if (health.providers_configured != null) lines.push(ok(t("{n} providers configured", { n: health.providers_configured })));
     const fx = health.fx_rate;
     if (fx != null) {
       const rate = typeof fx === "object" ? fx.rate : fx; // {rate, applied_rate, source}
       const src = typeof fx === "object" && fx.source ? styler.dim(` (${fx.source})`) : "";
-      if (rate != null) lines.push(ok(`환율 USD/KRW ${rate}${src}`));
+      if (rate != null) lines.push(ok(t("FX rate USD/KRW {rate}{src}", { rate, src })));
     }
   }
   lines.push(
     keyPrefix
-      ? ok(`로그인됨 ${styler.dim(`(키 ${keyPrefix}…)`)}`)
-      : warn(`로그인 안 됨 ${styler.dim("— pleum login")}`),
+      ? ok(`${t("Logged in")} ${styler.dim(`(${t("key")} ${keyPrefix}…)`)}`)
+      : warn(`${t("Not logged in")} ${styler.dim("— pleum login")}`),
   );
   return lines.join("\n");
 }

package/src/i18n.mjs

@@ -0,0 +1,37 @@
+// gettext 스타일 i18n — 영어 원문 자체가 키. 사전에 없으면 원문(영어) 폴백.
+// 기본 로케일은 영어; PLEUM_LANG 환경변수 또는 `pleum lang <code>`로 저장된
+// ~/.pleum/config.json의 lang이 있으면 그것을 쓴다(env가 우선).
+
+import { readConfig, writeConfig } from "./config.mjs";
+import { KO } from "./locales/ko.mjs";
+import { JA } from "./locales/ja.mjs";
+import { ZH } from "./locales/zh.mjs";
+import { ES } from "./locales/es.mjs";
+
+export const LANGS = { en: "English", ko: "한국어", ja: "日本語", zh: "中文", es: "Español" };
+const DICTS = { ko: KO, ja: JA, zh: ZH, es: ES };
+
+let cached; // 프로세스 수명 동안 1회 확정 — CLI는 매 실행이 새 프로세스라 재조회 불필요
+export function getLocale() {
+  if (cached) return cached;
+  const env = process.env.PLEUM_LANG;
+  if (env && LANGS[env]) return (cached = env);
+  const cfg = readConfig();
+  if (cfg?.lang && LANGS[cfg.lang]) return (cached = cfg.lang);
+  return (cached = "en");
+}
+
+export function setLocale(code) {
+  if (!LANGS[code]) throw new Error(`Unsupported language: ${code} (${Object.keys(LANGS).join(", ")})`);
+  cached = code;
+  const cfg = readConfig() ?? {};
+  cfg.lang = code;
+  writeConfig(cfg);
+}
+
+// vars의 {key} 플레이스홀더를 치환. 번역 누락 키는 영어 원문을 그대로 보여준다.
+export function t(key, vars) {
+  const locale = getLocale();
+  const template = locale === "en" ? key : (DICTS[locale]?.[key] ?? key);
+  return vars ? template.replace(/\{(\w+)\}/g, (_, k) => (vars[k] ?? `{${k}}`)) : template;
+}

package/src/interactive.mjs

@@ -1,6 +1,21 @@
-// 스피너 + raw-mode 화살표 셀렉터 — zero-dep 라인 플로우 인터랙션.
+// 스피너 + raw-mode 화살표 셀렉터 — zero-dep 라인 플로우 인터랙션(키보드 전용).
 
+import { createInterface } from "node:readline";
 import { style, displayWidth, terminalWidth } from "./ansi.mjs";
+import { t } from "./i18n.mjs";
+
+// Y/n 확인. message는 "[Y/n] " 접미사까지 포함한 완성 문자열(ensureInstalled 관례 —
+// 로케일별 표기를 번역 쪽이 소유). 비TTY면 프롬프트 없이 defaultYes 즉시 반환
+// (select()의 비TTY 가드와 동일 패턴 — 테스트 용이성 겸용).
+export async function confirm(message, { defaultYes = true, input = process.stdin, output = process.stdout } = {}) {
+  if (!input.isTTY || !output.isTTY) return defaultYes;
+  const rl = createInterface({ input, output });
+  const ans = await new Promise((res) => rl.question(message, res));
+  rl.close();
+  const a = ans.trim().toLowerCase();
+  if (!a) return defaultYes;
+  return a.startsWith("y");
+}
 
 const FRAMES = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
 
@@ -27,17 +42,10 @@ export function spinner(text, { stream = process.stderr, intervalMs = 80 } = {})
   };
 }
 
-// 마우스 리포팅 켬/끔 — bubbletea와 동일 조합(1002 버튼추적 + 1003 모든모션 + 1006 SGR 좌표).
-// 미지원 모드는 터미널이 무시하므로 셋 다 켜고, 끌 때도 셋 다 리셋한다.
-export const MOUSE_ON = "\x1b[?1002h\x1b[?1003h\x1b[?1006h";
-export const MOUSE_OFF = "\x1b[?1002l\x1b[?1003l\x1b[?1006l";
-
 // raw-mode 입력 청크 → 키 이벤트 배열(순수 함수 — 테스트 대상).
 // 화살표(\x1b[A/B)와 일반 문자가 한 청크에 섞여 와도 순서대로 분해한다.
 // 청크 끝의 외톨이 ESC는 escape(취소)로 처리 — 실터미널은 화살표 3바이트를
 // 한 이벤트로 보내므로 실사용에서 오인될 일은 거의 없다.
-// SGR 마우스(\x1b[<Cb;Cx;CyM|m): Cb 비트 0-1=버튼(0좌 2우), 32=모션, 64=휠(64업 65다운).
-// CPR(\x1b[row;colR): DSR \x1b[6n 응답 — 인라인 렌더의 마우스 좌표 매핑용.
 export function parseKeys(chunk) {
   const out = [];
   for (let i = 0; i < chunk.length; ) {
@@ -45,21 +53,6 @@ export function parseKeys(chunk) {
     if (ch === "\x1b") {
       if (chunk[i + 1] === "[") {
         const rest = chunk.slice(i + 2);
-        const mouse = /^<(\d+);(\d+);(\d+)([Mm])/.exec(rest);
-        if (mouse) {
-          const cb = Number(mouse[1]);
-          out.push({
-            type: "mouse",
-            btn: cb & 0b11,
-            x: Number(mouse[2]),
-            y: Number(mouse[3]),
-            motion: Boolean(cb & 32),
-            release: mouse[4] === "m",
-            wheel: cb & 64 ? ((cb & 0b11) === 0 ? "up" : (cb & 0b11) === 1 ? "down" : null) : null,
-          });
-          i += 2 + mouse[0].length;
-          continue;
-        }
         const m = /^([0-9;]*)([A-Za-z~])/.exec(rest);
         if (m) {
           const code = m[2];
@@ -67,10 +60,7 @@ export function parseKeys(chunk) {
           else if (code === "B") out.push({ type: "down" });
           else if (code === "C") out.push({ type: "right" });
           else if (code === "D") out.push({ type: "left" });
-          else if (code === "R") {
-            const [row, col] = m[1].split(";").map(Number);
-            out.push({ type: "cpr", row: row || 0, col: col || 0 });
-          } else out.push({ type: "unknown" }); // 기타 CSI는 무시
+          else out.push({ type: "unknown" }); // 기타 CSI는 무시
           i += 2 + m[1].length + 1;
           continue;
         }
@@ -89,56 +79,24 @@ export function parseKeys(chunk) {
   return out;
 }
 
-// 청크 경계에서 잘린 CSI/SGR 시퀀스를 다음 청크와 이어 붙이는 스트림 래퍼(순수 폐쇄 — 테스트 대상).
-// 1003 모션 홍수에서 \x1b[<… 가 중간에 잘리면 escape로 오인돼 UI가 닫히는 것을 방지.
+// 청크 경계에서 잘린 CSI 시퀀스를 다음 청크와 이어 붙이는 스트림 래퍼(순수 폐쇄 — 테스트 대상).
 // 외톨이 \x1b(=ESC 키)는 즉시 escape 처리(기존 트레이드오프 유지).
 export function keyFeeder() {
   let carry = "";
   return (chunk) => {
     let data = carry + chunk;
-    const cut = /\x1b\[[<0-9;]*$/.exec(data);
+    const cut = /\x1b\[[0-9;]*$/.exec(data);
     carry = cut ? cut[0] : "";
     if (cut) data = data.slice(0, cut.index);
     return parseKeys(data);
   };
 }
 
-// 절대 y(1-기반)를 인라인 프레임의 라인 인덱스로 변환(순수 함수 — 테스트 대상).
-// endRow = 프레임 마지막 줄의 절대 행(CPR로 얻음). 줄바꿈은 rowsFor(라인별 시각 행수)로 반영.
-export function lineIndexAt(y, endRow, lines, rowsFor) {
-  if (!endRow) return -1;
-  const total = lines.reduce((n, l) => n + rowsFor(l), 0);
-  const top = endRow - total + 1;
-  if (y < top || y > endRow) return -1;
-  let row = top;
-  for (let i = 0; i < lines.length; i++) {
-    const h = rowsFor(lines[i]);
-    if (y < row + h) return i;
-    row += h;
-  }
-  return -1;
-}
-
-// 마우스 리포팅 토글 + 비정상 종료 안전망(프로세스 exit 시 터미널 모드 복원).
-let mouseActive = false;
-let exitHooked = false;
-export function setMouse(output, on) {
-  if (!exitHooked) {
-    exitHooked = true;
-    process.on("exit", () => {
-      if (mouseActive) process.stdout.write(MOUSE_OFF + "\x1b[?25h");
-    });
-  }
-  mouseActive = on;
-  output.write(on ? MOUSE_ON : MOUSE_OFF);
-}
-
 // 화살표 이동 · 타이핑 필터 · Enter 선택 · Esc/Ctrl+C 취소(null).
-// 마우스: 호버=하이라이트, 휠=이동, 좌클릭=선택.
 // 비TTY면 즉시 null — 호출자가 기존 번호 피커 등으로 폴백한다.
 // process.exit는 절대 호출하지 않는다(취소 처리는 호출자 몫).
 export async function select(items, {
-  message = "선택",
+  message = t("Select"),
   formatItem = String,
   matches = (all, q) => (q ? all.filter((it) => String(formatItem(it)).toLowerCase().includes(q.toLowerCase())) : all),
   limit = 10,
@@ -151,9 +109,6 @@ export async function select(items, {
     let query = "";
     let cursor = 0;
     let lastRows = 0;
-    let lastLines = [];
-    let shownCount = 0;
-    let cprRow = 0; // 프레임 마지막 줄의 절대 행 — DSR \x1b[6n 응답으로 갱신
 
     const rowsFor = (s) => Math.max(1, Math.ceil(displayWidth(s) / Math.max(terminalWidth(), 1)));
     const erase = () => {
@@ -167,35 +122,25 @@ export async function select(items, {
       if (cursor >= pool.length) cursor = Math.max(0, pool.length - 1);
       const shown = pool.slice(0, limit);
       const lines = [
-        `${style.plum("?")} ${style.bold(message)} ${style.dim("타이핑=필터 · ↑↓=이동 · Enter=선택 · Esc=취소")}`,
+        `${style.plum("?")} ${style.bold(message)} ${style.dim(t("type to filter · ↑↓ move · Enter select · Esc cancel"))}`,
         `${style.gray("›")} ${query}`,
         ...shown.map((it, i) =>
           i === cursor ? `${style.plum("❯")} ${style.bold(formatItem(it))}` : `  ${style.dim(formatItem(it))}`,
         ),
       ];
-      if (pool.length > shown.length) lines.push(style.dim(`  … ${pool.length - shown.length}개 더 — 타이핑으로 좁히기`));
-      if (!pool.length) lines.push(style.dim("  일치 없음"));
+      if (pool.length > shown.length) lines.push(style.dim(`  ${t("… {n} more — type to narrow down", { n: pool.length - shown.length })}`));
+      if (!pool.length) lines.push(style.dim(`  ${t("No matches")}`));
       erase();
       const frame = lines.join("\n");
       output.write(frame);
       lastRows = lines.reduce((n, l) => n + rowsFor(l), 0);
-      lastLines = lines;
-      shownCount = shown.length;
-      output.write("\x1b[6n"); // CPR 질의 — 마우스 좌표 매핑용
       return pool;
     };
 
-    // 클릭/호버 y좌표 → 표시 중인 항목 인덱스(항목 라인은 3번째 줄부터). 밖이면 -1.
-    const itemAt = (y) => {
-      const li = lineIndexAt(y, cprRow, lastLines, rowsFor);
-      return li >= 2 && li < 2 + shownCount ? li - 2 : -1;
-    };
-
     const finish = (value) => {
       input.off("data", onData);
       input.setRawMode(false);
       input.pause();
-      setMouse(output, false);
       output.write("\x1b[?25h");
       erase();
       if (value != null) output.write(`${style.green("✓")} ${formatItem(value)}\n`);
@@ -204,32 +149,14 @@ export async function select(items, {
 
     const feed = keyFeeder();
     const onData = (chunk) => {
-      let dirty = false; // CPR만 온 턴에 재렌더하면 렌더→CPR 질의→응답 무한 루프
+      let dirty = false;
       for (const key of feed(chunk)) {
         if (key.type === "ctrlc" || key.type === "escape") return finish(null);
-        if (key.type === "cpr") {
-          cprRow = key.row;
-          continue;
-        }
         if (key.type === "enter") {
           const pool = matches(items, query);
           return finish(pool[cursor] ?? null);
         }
-        if (key.type === "mouse") {
-          if (key.wheel === "up") cursor = Math.max(0, cursor - 1);
-          else if (key.wheel === "down") cursor = Math.min(limit - 1, cursor + 1);
-          else if (key.motion) {
-            const idx = itemAt(key.y);
-            if (idx < 0 || idx === cursor) continue;
-            cursor = idx;
-          } else if (key.btn === 0 && !key.release) {
-            const idx = itemAt(key.y);
-            if (idx < 0) continue;
-            cursor = idx;
-            const pool = matches(items, query);
-            return finish(pool[cursor] ?? null);
-          } else continue;
-        } else if (key.type === "up") cursor = Math.max(0, cursor - 1);
+        if (key.type === "up") cursor = Math.max(0, cursor - 1);
         else if (key.type === "down") cursor = Math.min(limit - 1, cursor + 1);
         else if (key.type === "backspace") query = query.slice(0, -1);
         else if (key.type === "char") {
@@ -245,7 +172,6 @@ export async function select(items, {
     input.setRawMode(true);
     input.resume();
     output.write("\x1b[?25l");
-    setMouse(output, true);
     input.on("data", onData);
     render();
   });

package/src/lang.mjs

@@ -0,0 +1,33 @@
+// `pleum lang [code]` — 표시 언어 조회/변경. 인자 없이 TTY면 화살표 선택.
+import { LANGS, getLocale, setLocale, t } from "./i18n.mjs";
+import { select } from "./interactive.mjs";
+import { style } from "./ansi.mjs";
+
+export async function lang(rest = []) {
+  const code = rest[0];
+  if (code) {
+    if (!LANGS[code]) {
+      console.error(t("Unsupported language: {code}\n  Available: {list}", { code, list: Object.keys(LANGS).join(", ") }));
+      process.exit(1);
+    }
+    setLocale(code);
+    console.log(`${style.green("✓")} ${t("Language set to {name}", { name: LANGS[code] })}`);
+    return;
+  }
+
+  const current = getLocale();
+  if (process.stdin.isTTY && process.stdout.isTTY) {
+    const items = Object.entries(LANGS).map(([id, name]) => ({ id, name }));
+    const picked = await select(items, {
+      message: t("Choose a language"),
+      formatItem: (it) => `${it.name}${it.id === current ? style.dim(`  (${t("current")})`) : ""}`,
+    });
+    if (picked) {
+      setLocale(picked.id);
+      console.log(`${style.green("✓")} ${t("Language set to {name}", { name: picked.name })}`);
+    }
+    return;
+  }
+  console.log(t("Current language: {name}", { name: LANGS[current] }));
+  console.log(t("Available: {list}", { list: Object.entries(LANGS).map(([id, name]) => `${id} (${name})`).join(", ") }));
+}