pleumrouter 0.3.0 → 0.3.1

package/README.md

@@ -29,6 +29,7 @@ cat error.log | npx pleumrouter run gpt-4.1 "원인은?"   # 파이프
 
 | 명령 | 설명 |
 |------|------|
+| `pleum` | (인자 없음, TTY) 인터랙티브 런처 메뉴 — 채팅·에이전트 실행·잔액·리더보드를 키보드·마우스로. ↑/↓·휠 이동 · enter·클릭 실행 · →·우클릭 모델 설정 · esc 종료. 미설치 에이전트는 확인 후 자동 설치, 실행 종료 후 메뉴 복귀. 파이프에선 도움말 출력 |
 | `pleum login [--device]` | 브라우저로 로그인 → CLI가 API 키를 자동 발급·저장(`~/.pleum/config.json`). `--device`는 SSH·CI |
 | `pleum logout` | 저장된 키 삭제 |
 | `pleum launch [tool] [--model id] [-- args]` | 에이전트 실행. `--` 뒤 인자는 도구로 그대로 전달. 도구 생략 시 지원 목록·설치 여부 표시 |

package/bin/pleum.mjs

@@ -11,9 +11,11 @@ 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 { mainMenu } from "../src/menu.mjs";
 
 const HELP = `pleum — PleumRouter 터미널 CLI
 
+  pleum                              (인자 없음) 인터랙티브 런처 메뉴 — 키보드·마우스 (TTY 전용)
   pleum login [--device]             브라우저로 로그인 + 키 자동 저장
                                      --device: 브라우저 없는 환경(SSH·CI)
   pleum logout                       저장된 키 삭제
@@ -114,6 +116,9 @@ try {
       version();
       break;
     case undefined:
+      // TTY면 ollama풍 런처 메뉴, 파이프/스크립트면 기존 도움말.
+      if (!(await mainMenu())) console.log(HELP);
+      break;
     case "-h":
     case "--help":
     case "help":

package/package.json

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

package/src/ansi.mjs

@@ -49,8 +49,15 @@ export function createStyler(level = detectColorLevel()) {
 export const style = createStyler();
 
 export function stripAnsi(s) {
-  // eslint 불필요 — CSI 시퀀스만 제거하면 충분(우리가 쓰는 코드 전부 CSI).
-  return String(s).replace(/\x1b\[[0-9;]*[A-Za-z]/g, "");
+  // CSI(색·커서·마우스) + OSC(하이퍼링크) — displayWidth가 폭을 잘못 세지 않게 둘 다 제거.
+  return String(s)
+    .replace(/\x1b\][^\x07\x1b]*(?:\x07|\x1b\\)/g, "")
+    .replace(/\x1b\[[0-9;<]*[A-Za-z]/g, "");
+}
+
+// OSC 8 클릭 가능한 하이퍼링크. 무색(파이프·NO_COLOR·dumb)이면 텍스트만.
+export function hyperlink(url, text = url, level = style.level) {
+  return level ? `\x1b]8;;${url}\x1b\\${text}\x1b]8;;\x1b\\` : text;
 }
 
 // 터미널 표시 폭 — CJK(한글 등) 전각 문자는 2칸. 정렬·줄수 계산용.

package/src/interactive.mjs

@@ -27,10 +27,17 @@ 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; ) {
@@ -38,12 +45,32 @@ 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];
           if (code === "A") out.push({ type: "up" });
           else if (code === "B") out.push({ type: "down" });
-          else out.push({ type: "unknown" }); // 좌우 화살표 등은 무시
+          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는 무시
           i += 2 + m[1].length + 1;
           continue;
         }
@@ -62,7 +89,52 @@ export function parseKeys(chunk) {
   return out;
 }
 
+// 청크 경계에서 잘린 CSI/SGR 시퀀스를 다음 청크와 이어 붙이는 스트림 래퍼(순수 폐쇄 — 테스트 대상).
+// 1003 모션 홍수에서 \x1b[<… 가 중간에 잘리면 escape로 오인돼 UI가 닫히는 것을 방지.
+// 외톨이 \x1b(=ESC 키)는 즉시 escape 처리(기존 트레이드오프 유지).
+export function keyFeeder() {
+  let carry = "";
+  return (chunk) => {
+    let data = carry + chunk;
+    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, {
@@ -79,6 +151,9 @@ 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 = () => {
@@ -104,41 +179,73 @@ export async function select(items, {
       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`);
       resolve(value);
     };
 
+    const feed = keyFeeder();
     const onData = (chunk) => {
-      for (const key of parseKeys(chunk)) {
+      let dirty = false; // CPR만 온 턴에 재렌더하면 렌더→CPR 질의→응답 무한 루프
+      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 === "up") cursor = Math.max(0, cursor - 1);
+        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);
         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") {
           query += key.value;
           cursor = 0;
-        }
+        } else continue;
+        dirty = true;
       }
-      render();
+      if (dirty) render();
     };
 
     input.setEncoding("utf8"); // 멀티바이트(한글) 조각 자동 재조립
     input.setRawMode(true);
     input.resume();
     output.write("\x1b[?25l");
+    setMouse(output, true);
     input.on("data", onData);
     render();
   });

package/src/launch.mjs

@@ -5,8 +5,8 @@ import { join, delimiter } from "node:path";
 import { requireKey } from "./config.mjs";
 import { RECIPES, MANUAL, codexToml } from "./recipes.mjs";
 
-// PATH에서 실행 파일을 찾는다(설치 여부 표시용).
-function onPath(bin) {
+// PATH에서 실행 파일을 찾는다(설치 여부 표시용). menu.mjs도 사용.
+export function onPath(bin) {
   const exts = process.platform === "win32" ? [".cmd", ".exe", ".bat", ""] : [""];
   return (process.env.PATH || "")
     .split(delimiter)
@@ -28,7 +28,8 @@ export function launchHelp() {
   console.log("\n예: pleum launch claude --model claude-sonnet-4");
 }
 
-export async function launch(tool, model, passthrough) {
+// exit:false면 process.exit 대신 자식 종료 코드를 반환 — 런처 메뉴의 실행 후 복귀용.
+export async function launch(tool, model, passthrough, { exit = true } = {}) {
   const key = requireKey();
   const r = RECIPES[tool];
 
@@ -59,20 +60,27 @@ export async function launch(tool, model, passthrough) {
   if (r.note) console.log(`ℹ ${r.note}`);
   console.log(`▶ ${r.label} 실행: ${r.bin} ${args.join(" ")}\n`);
 
-  const child = spawn(r.bin, args, {
-    env,
-    stdio: "inherit",
-    shell: process.platform === "win32",
+  return await new Promise((resolve) => {
+    const child = spawn(r.bin, args, {
+      env,
+      stdio: "inherit",
+      shell: process.platform === "win32",
+    });
+    child.on("error", (e) => {
+      if (e.code === "ENOENT") {
+        console.error(`✗ '${r.bin}'를 찾을 수 없습니다. 설치:\n  ${r.install}`);
+        if (exit) process.exit(127);
+        return resolve(127);
+      }
+      console.error(`✗ ${e.message}`);
+      if (exit) process.exit(1);
+      resolve(1);
+    });
+    child.on("exit", (code) => {
+      if (exit) process.exit(code ?? 0);
+      resolve(code ?? 0);
+    });
   });
-  child.on("error", (e) => {
-    if (e.code === "ENOENT") {
-      console.error(`✗ '${r.bin}'를 찾을 수 없습니다. 설치:\n  ${r.install}`);
-      process.exit(127);
-    }
-    console.error(`✗ ${e.message}`);
-    process.exit(1);
-  });
-  child.on("exit", (code) => process.exit(code ?? 0));
 }
 
 function printManual(tool, key) {

package/src/menu.mjs

@@ -0,0 +1,360 @@
+// Ollama 0.31 런처풍 시작 메뉴 — bare `pleum`(TTY)에서 뜬다. 비TTY면 false 반환(호출자가 HELP 폴백).
+// 동작 패리티(ollama cmd/tui/tui.go·cmd/launch 소스 분석 기반):
+//   · 인라인 렌더(대체 화면 아님), ▸ 커서 + dim 설명 2줄 항목, 하단 키 안내
+//   · "더 보기…"는 커서가 닿는 순간 그 자리에서 펼쳐지고, pinned 구간으로 올라가면 접힘
+//   · →(configure) = 모델 피커를 강제로 띄우고 선택 즉시 실행(+ launch_models에 저장)
+//   · Enter = 저장된 모델(launch_models)로 바로 실행, 미설치면 Y/n 확인 후 자동 설치
+//   · 실행 종료 후 메뉴로 복귀(ollama runInteractiveTUI 루프), last_selection 커서 복원
+//   · 키: ↑/k ↓/j · enter/space 실행 · →/l 모델 설정 · esc/q/ctrl+c 종료
+// 마우스(ollama엔 없음 — SGR 1002/1003/1006 직접 구현):
+//   · 호버=하이라이트 · 좌클릭=바로 실행 · 우클릭=모델 설정 · 휠=이동
+//   · 인라인 렌더라 프레임 상단 행이 가변 — 렌더마다 DSR \x1b[6n으로 끝 행을 얻어 좌표 매핑
+
+import { readFileSync } from "node:fs";
+import { spawn } from "node:child_process";
+import { createInterface } from "node:readline";
+import { style, displayWidth, terminalWidth, hyperlink } from "./ansi.mjs";
+import { keyFeeder, select, setMouse, lineIndexAt } from "./interactive.mjs";
+import { readConfig, writeConfig } from "./config.mjs";
+import { RECIPES } from "./recipes.mjs";
+import { onPath, launch } from "./launch.mjs";
+import { fetchModels, matchModels, listModels } from "./models.mjs";
+import { run } from "./run.mjs";
+import { login } from "./login.mjs";
+import { top } from "./top.mjs";
+import { usage } from "./usage.mjs";
+import { balance } from "./balance.mjs";
+import { health } from "./health.mjs";
+
+const TOOL_DESC = {
+  claude: "Anthropic 코딩 에이전트 — 서브에이전트 지원",
+  codex: "OpenAI 코딩 에이전트",
+  aider: "터미널 페어 프로그래밍",
+  goose: "Block의 로컬 우선 에이전트",
+  openhands: "자율 개발 에이전트",
+};
+
+const autoInstallable = (r) => !/^https?:/.test(r.install); // URL이면 수동 설치 안내만
+
+// 메뉴 항목 빌드(순수 함수 — 테스트 대상). tool이 있는 항목만 →(모델 설정) 가능.
+export function buildItems({ loggedIn, installed, savedModels = {}, expanded = false }) {
+  const items = [];
+  if (!loggedIn) items.push({ id: "login", title: "로그인", desc: "브라우저로 로그인하고 API 키를 저장합니다" });
+  items.push({
+    id: "chat",
+    tool: "chat",
+    title: "모델과 채팅",
+    desc: `대화형 채팅을 시작합니다${savedModels.chat ? ` · 모델: ${savedModels.chat}` : ""}`,
+  });
+  const tools = expanded ? Object.keys(RECIPES) : ["claude", "codex"];
+  for (const t of tools) {
+    const r = RECIPES[t];
+    items.push({
+      id: `launch:${t}`,
+      tool: t,
+      title: `${r.label} 실행${installed[t] ? "" : autoInstallable(r) ? "  (설치)" : "  (미설치)"}`,
+      desc: installed[t]
+        ? `${TOOL_DESC[t]}${savedModels[t] ? ` · 모델: ${savedModels[t]}` : ""}`
+        : autoInstallable(r)
+          ? `Enter로 바로 설치 — ${r.install}`
+          : `수동 설치: ${hyperlink(r.install)}`,
+    });
+  }
+  if (expanded) {
+    items.push(
+      { id: "models", title: "모델 목록", desc: "전체 모델 — 가격·컨텍스트 포함" },
+      { id: "top", title: "리더보드", desc: "모델 랭킹·제공자 점유율" },
+      { id: "usage", title: "지출 리포트", desc: "최근 30일 내 지출" },
+      { id: "balance", title: "잔액", desc: "크레딧 잔액 조회" },
+      { id: "health", title: "상태 점검", desc: "게이트웨이 연결·로그인 상태" },
+    );
+  } else {
+    items.push({ id: "more", title: "더 보기…", desc: "다른 에이전트 · 모델 목록 · 잔액 · 리더보드" });
+  }
+  return items;
+}
+
+// 항목별 기본 모델 저장(launch_models). 로그인 전에도 동작 — /v1/models는 공개.
+function saveModel(tool, id) {
+  const cfg = readConfig() ?? {};
+  cfg.launch_models = { ...cfg.launch_models, [tool]: id };
+  writeConfig(cfg);
+}
+
+// 마지막 메뉴 선택 저장 — 다음 실행 시 커서 복원(ollama last_selection과 동일).
+function saveLastSelection(id) {
+  const cfg = readConfig() ?? {};
+  cfg.last_selection = id;
+  writeConfig(cfg);
+}
+
+async function pickModelFor(item) {
+  let models;
+  try {
+    models = await fetchModels();
+  } catch (e) {
+    console.log(`${style.red("✗")} 모델 목록 조회 실패: ${e.message}`);
+    return undefined;
+  }
+  const m = await select(models, {
+    message: `${item.title.replace(/\s+\((설치|미설치)\)/, "")} — 모델 선택`,
+    formatItem: (x) => `${x.id}${x.display_name ? `  ${style.dim(x.display_name)}` : ""}`,
+    matches: matchModels,
+    limit: 12,
+  });
+  return m?.id;
+}
+
+// 미설치 도구: ollama처럼 확인 후 그 자리에서 설치(stdio 상속). 성공 시 true.
+async function ensureInstalled(r) {
+  if (!autoInstallable(r)) {
+    console.log(`${r.label}는 수동 설치가 필요합니다:\n  ${style.bold(hyperlink(r.install))}`);
+    return false;
+  }
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  const ans = await new Promise((res) => rl.question(`${r.label}가 설치되어 있지 않습니다. 지금 설치할까요? [Y/n] `, res));
+  rl.close();
+  if (/^n/i.test(ans.trim())) {
+    console.log(`설치 취소 — 수동 설치: ${r.install}`);
+    return false;
+  }
+  console.log(style.dim(`$ ${r.install}`));
+  const code = await new Promise((res) => {
+    const c = spawn(r.install, { shell: true, stdio: "inherit" });
+    c.on("exit", (n) => res(n ?? 1));
+    c.on("error", () => res(1));
+  });
+  if (code !== 0) {
+    console.log(`${style.red("✗")} 설치 실패 (exit ${code})`);
+    return false;
+  }
+  console.log(`${style.green("✓")} ${r.label} 설치 완료`);
+  return true;
+}
+
+// 클릭 y좌표 → 항목 인덱스(순수 함수 — 테스트 대상).
+// 프레임 구조: [헤더, 공백, 항목별 2줄…, 공백, 푸터]. 항목 밖(헤더/공백/푸터)이면 -1.
+export function itemIndexAt(y, cprRow, lines, itemCount, rowsFor) {
+  const li = lineIndexAt(y, cprRow, lines, rowsFor);
+  if (li < 2) return -1;
+  const idx = (li - 2) >> 1;
+  return idx < itemCount ? idx : -1;
+}
+
+// 화살표+마우스 메뉴 루프 — {item, model?} 또는 null(Esc) 반환. 비TTY면 undefined.
+async function menuSelect() {
+  const input = process.stdin;
+  const output = process.stdout;
+  if (!input.isTTY || !output.isTTY || typeof input.setRawMode !== "function") return undefined;
+
+  const installed = Object.fromEntries(Object.entries(RECIPES).map(([t, r]) => [t, onPath(r.bin)]));
+  const version = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8")).version;
+  let expanded = false;
+  const rebuild = () => {
+    const cfg = readConfig();
+    return buildItems({ loggedIn: Boolean(cfg?.key), installed, savedModels: cfg?.launch_models ?? {}, expanded });
+  };
+
+  let items = rebuild();
+  const pinnedCount = items.length - 1; // "더 보기…" 자리 — 여기 닿으면 펼침, 위로 벗어나면 접힘
+  let cursor = 0;
+
+  // last_selection 커서 복원 — 더 보기 그룹에 있었으면 펼친 채 시작(ollama shouldExpandOthers).
+  const last = readConfig()?.last_selection;
+  if (last) {
+    let idx = items.findIndex((it) => it.id === last);
+    if (idx < 0) {
+      expanded = true;
+      items = rebuild();
+      idx = items.findIndex((it) => it.id === last);
+      if (idx < 0) {
+        expanded = false;
+        items = rebuild();
+      }
+    }
+    if (idx >= 0) cursor = idx;
+  }
+
+  let lastRows = 0;
+  let lastLines = [];
+  let cprRow = 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");
+    lastRows = 0;
+  };
+  const render = () => {
+    const lines = [
+      `${style.bold(style.plum("PleumRouter"))} ${style.dim(`pleum ${version}`)}`,
+      "",
+      ...items.flatMap((it, i) =>
+        i === cursor
+          ? [`${style.plum("▸")} ${style.bold(it.title)}`, `    ${style.dim(it.desc)}`]
+          : [`  ${it.title}`, `    ${style.dim(it.desc)}`],
+      ),
+      "",
+      style.dim("↑/↓·휠 이동 • enter·클릭 실행 • →·우클릭 모델 설정 • esc 종료"),
+    ];
+    erase();
+    output.write(lines.join("\n"));
+    lastRows = lines.reduce((n, l) => n + rowsFor(l), 0);
+    lastLines = lines;
+    output.write("\x1b[6n"); // CPR 질의 — 마우스 좌표 매핑용
+  };
+
+  const moveTo = (next) => {
+    if (!expanded && next === pinnedCount) {
+      expanded = true; // "더 보기…"에 커서가 닿으면 그 자리에서 펼침
+      items = rebuild();
+      cursor = next;
+      return;
+    }
+    if (expanded && next < pinnedCount) {
+      expanded = false; // pinned 구간으로 돌아가면 접힘
+      items = rebuild();
+      cursor = next;
+      return;
+    }
+    cursor = next;
+  };
+  const move = (dir) => moveTo(Math.max(0, Math.min(items.length - 1, cursor + dir)));
+  const itemAt = (y) => itemIndexAt(y, cprRow, lastLines, items.length, rowsFor);
+
+  return new Promise((resolve) => {
+    const suspend = () => {
+      input.off("data", onData);
+      input.setRawMode(false);
+      setMouse(output, false);
+      output.write("\x1b[?25h");
+      erase();
+    };
+    const resume = () => {
+      input.setRawMode(true);
+      input.resume();
+      output.write("\x1b[?25l");
+      setMouse(output, true);
+      input.on("data", onData);
+      render();
+    };
+    const finish = (value) => {
+      suspend();
+      input.pause();
+      resolve(value);
+    };
+    // 모델 셀렉터는 자체 raw-mode·마우스 관리 — 메뉴 입력을 내려놓고 넘긴다.
+    // 선택되면 ollama처럼 즉시 실행으로 이어가고, 취소면 메뉴 복귀.
+    const configure = async (it) => {
+      suspend();
+      const picked = await pickModelFor(it);
+      if (picked) {
+        input.pause();
+        resolve({ item: it, model: picked });
+        return;
+      }
+      resume();
+    };
+
+    const feed = keyFeeder();
+    const onData = async (chunk) => {
+      let dirty = false; // CPR만 온 턴에 재렌더하면 렌더→CPR 질의→응답 무한 루프
+      for (const key of feed(chunk)) {
+        if (key.type === "ctrlc" || key.type === "escape" || (key.type === "char" && key.value === "q")) {
+          return finish(null);
+        }
+        if (key.type === "cpr") {
+          cprRow = key.row;
+          continue;
+        }
+        if (key.type === "enter" || (key.type === "char" && key.value === " ")) {
+          return finish({ item: items[cursor] });
+        }
+        if (key.type === "mouse") {
+          if (key.wheel === "up") move(-1);
+          else if (key.wheel === "down") move(1);
+          else if (key.motion) {
+            const idx = itemAt(key.y);
+            if (idx < 0 || idx === cursor) continue;
+            moveTo(idx);
+          } else if (!key.release && key.btn === 0) {
+            const idx = itemAt(key.y);
+            if (idx < 0) continue;
+            const wasMore = !expanded && items[idx]?.id === "more";
+            moveTo(idx);
+            if (!wasMore) return finish({ item: items[cursor] });
+          } else if (!key.release && key.btn === 2) {
+            const idx = itemAt(key.y);
+            if (idx < 0 || !items[idx].tool) continue;
+            moveTo(idx);
+            return void (await configure(items[cursor]));
+          } else continue;
+        } else if (key.type === "up" || (key.type === "char" && key.value === "k")) move(-1);
+        else if (key.type === "down" || (key.type === "char" && key.value === "j")) move(1);
+        else if (key.type === "right" || (key.type === "char" && key.value === "l")) {
+          const it = items[cursor];
+          if (!it.tool) continue;
+          return void (await configure(it));
+        } else continue;
+        dirty = true;
+      }
+      if (dirty) render();
+    };
+
+    input.setEncoding("utf8");
+    input.setRawMode(true);
+    input.resume();
+    output.write("\x1b[?25l");
+    setMouse(output, true);
+    input.on("data", onData);
+    render();
+  });
+}
+
+// bare `pleum` 진입점. 비TTY면 false(호출자가 HELP 출력), 그 외 true.
+// ollama처럼 실행이 끝나면 메뉴로 복귀하는 루프(REPL 채팅·Esc 종료 제외).
+export async function mainMenu() {
+  for (;;) {
+    const picked = await menuSelect();
+    if (picked === undefined) return false; // 비TTY
+    if (picked === null) return true; // Esc — ollama처럼 조용히 종료
+
+    const { item, model } = picked;
+    if (item.id !== "login") saveLastSelection(item.id);
+    if (model && item.tool) saveModel(item.tool, model);
+    const saved = readConfig()?.launch_models ?? {};
+
+    switch (item.id) {
+      case "login":
+        await login();
+        continue; // 로그인 후 메뉴로 복귀
+      case "chat": {
+        const m = model ?? saved.chat;
+        await run(m ? [m] : []); // REPL 종료는 run 내부 process.exit — 메뉴 복귀 없음
+        return true;
+      }
+      case "models":
+        await listModels([]);
+        continue;
+      case "top":
+        await top([]);
+        continue;
+      case "usage":
+        await usage([]);
+        continue;
+      case "balance":
+        await balance();
+        continue;
+      case "health":
+        await health();
+        continue;
+      default: {
+        const r = RECIPES[item.tool];
+        if (!onPath(r.bin) && !(await ensureInstalled(r))) continue;
+        await launch(item.tool, model ?? saved[item.tool], [], { exit: false });
+        console.log(); // 에이전트 출력과 다음 메뉴 사이 여백
+        continue; // ollama처럼 에이전트 종료 후 메뉴 복귀
+      }
+    }
+  }
+}