@sejuneoh/aitop 0.0.0-stage → 0.21.1

package/src/doctor.mjs

@@ -0,0 +1,218 @@
+// 도구별 연결 점검: 기록 폴더를 찾았는지, 기록이 몇 개이고 언제 마지막으로 쓰였는지, 지금 몇 개가 실행 중인지,
+// 가장 최근 기록을 읽을 수 있는지. aitop --doctor, 빈 화면, --json 의 tools 가 같은 결과를 쓴다.
+// 기록 내용은 읽어 내보내지 않는다 (Gemini 는 형식 확인용으로 JSON 키 이름만 보인다).
+import { readdirSync, statSync, existsSync, openSync, readSync, closeSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir, platform } from 'node:os';
+import { findProcesses, isCodex, isGemini, isAgy, canListProcesses, isAlive } from './procs.mjs';
+import { AGY_ROOT } from './sources/antigravity.mjs';
+import { loadSqlite, openReadOnly } from './sqlite.mjs';
+import { fmtAgo, pad, stripControl } from './text.mjs';
+import { BRAND } from './brand.mjs';
+import { findNotifier, isWsl } from './notify.mjs';
+
+const UNIT = { s: '초', m: '분', h: '시간', d: '일' };
+const ago = (ms) => fmtAgo(ms).replace(/[smhd]$/, (u) => UNIT[u]);
+
+const HOME = homedir();
+const CLAUDE = process.env.CLAUDE_CONFIG_DIR ?? join(HOME, '.claude');
+const CODEX = join(process.env.CODEX_HOME ?? join(HOME, '.codex'), 'sessions');
+const GEMINI = join(process.env.GEMINI_HOME ?? join(HOME, '.gemini'), 'tmp');
+
+const tilde = (p) => (p.startsWith(HOME + '/') ? '~' + p.slice(HOME.length) : p);
+const ls = (dir) => {
+  try {
+    return readdirSync(dir, { withFileTypes: true });
+  } catch {
+    return [];
+  }
+};
+
+// 폴더 아래 depth 단계까지 내려가며 조건에 맞는 파일을 모은다.
+function walk(dir, depth, match, out = []) {
+  for (const e of ls(dir)) {
+    const p = join(dir, e.name);
+    if (e.isDirectory() && depth > 0) walk(p, depth - 1, match, out);
+    else if (e.isFile() && match(e.name)) out.push(p);
+  }
+  return out;
+}
+
+function newest(files) {
+  let best = null;
+  for (const path of files) {
+    try {
+      const m = statSync(path).mtimeMs;
+      if (!best || m > best.mtime) best = { path, mtime: m };
+    } catch {}
+  }
+  return best;
+}
+
+// 파일 첫 줄이 JSON 으로 읽히면 true, 아니면 false. 비어 있거나 첫 줄이 64KB 를 넘으면 판정하지 않는다(null).
+function firstLineIsJson(path) {
+  let fd;
+  try {
+    fd = openSync(path, 'r');
+    const buf = Buffer.alloc(65536);
+    const n = readSync(fd, buf, 0, buf.length, 0);
+    const text = buf.subarray(0, n).toString('utf8');
+    const end = text.indexOf('\n');
+    if (!n || (end < 0 && n === buf.length)) return null;
+    JSON.parse(end < 0 ? text : text.slice(0, end));
+    return true;
+  } catch {
+    return false;
+  } finally {
+    if (fd != null) closeSync(fd);
+  }
+}
+
+// 키 이름도 사용자 글이나 경로일 수 있으므로 식별자처럼 생긴 것만 보인다.
+const KEY_NAME = /^[A-Za-z_][\w.-]{0,40}$/;
+
+// JSON 파일 맨 위 키 이름만 (값은 보지 않는다). 앞 64KB 로 읽지 못하면(큰 파일) 맨 위 수준 들여쓰기의 "키": 줄에서 찾는다.
+function topKeys(path) {
+  let fd;
+  try {
+    fd = openSync(path, 'r');
+    const buf = Buffer.alloc(65536);
+    const n = readSync(fd, buf, 0, buf.length, 0);
+    const text = buf.subarray(0, n).toString('utf8');
+    let keys;
+    try {
+      let obj = JSON.parse(text);
+      if (Array.isArray(obj)) obj = obj[0];
+      keys = obj && typeof obj === 'object' ? Object.keys(obj) : [];
+    } catch {
+      try {
+        keys = Object.keys(JSON.parse(text.split('\n')[0]));
+      } catch {
+        keys = [...text.matchAll(/^ {0,2}\t?"([^"\n]{1,60})"\s*:/gm)].map((m) => m[1]);
+      }
+    }
+    return [...new Set(keys)].filter((k) => KEY_NAME.test(k)).slice(0, 12);
+  } catch {
+    return [];
+  } finally {
+    if (fd != null) closeSync(fd);
+  }
+}
+
+function claude() {
+  const dir = join(CLAUDE, 'projects');
+  const files = existsSync(dir) ? walk(dir, 1, (n) => n.endsWith('.jsonl')) : null;
+  const last = files && newest(files);
+  const running = canListProcesses()
+    ? ls(join(CLAUDE, 'sessions')).filter((e) => /^\d+\.json$/.test(e.name) && isAlive(Number(e.name.split('.')[0]))).length
+    : null;
+  if (!files) return { tool: 'claude', state: 'missing', path: tilde(dir), records: 0, lastAt: null, running, readable: null, hint: 'claude 를 한 번 실행하면 생깁니다' };
+  return { tool: 'claude', state: 'ok', path: tilde(dir), records: files.length, lastAt: last?.mtime ?? null, running, readable: last ? firstLineIsJson(last.path) : null, hint: null };
+}
+
+function codex() {
+  const files = existsSync(CODEX) ? walk(CODEX, 3, (n) => n.startsWith('rollout-') && n.endsWith('.jsonl')) : null;
+  const last = files && newest(files);
+  const running = canListProcesses() ? findProcesses(isCodex).length : null;
+  if (!files) return { tool: 'codex', state: 'missing', path: tilde(CODEX), records: 0, lastAt: null, running, readable: null, hint: 'codex 를 한 번 실행하면 생깁니다' };
+  return { tool: 'codex', state: 'ok', path: tilde(CODEX), records: files.length, lastAt: last?.mtime ?? null, running, readable: last ? firstLineIsJson(last.path) : null, hint: null };
+}
+
+// Gemini 는 세션 기록 형식을 아직 모른다. 프로세스만 세고, 기록 폴더가 있으면 형식 확인용 키 이름을 남긴다.
+function gemini() {
+  const files = existsSync(GEMINI) ? walk(GEMINI, 3, (n) => n.endsWith('.json') || n.endsWith('.jsonl')) : null;
+  const last = files && newest(files);
+  return {
+    tool: 'gemini',
+    state: 'limited',
+    path: tilde(GEMINI),
+    found: Boolean(files),
+    records: files?.length ?? 0,
+    lastAt: last?.mtime ?? null,
+    running: canListProcesses() ? findProcesses(isGemini).length : null,
+    readable: null,
+    keys: last ? topKeys(last.path) : [],
+    hint: '프로세스만 감지합니다 (세션·토큰은 아직 지원하지 않음)',
+  };
+}
+
+// Antigravity CLI: 요약 DB 를 열어 대화 목록을 읽을 수 있는지 본다. node:sqlite 가 없으면 프로세스만 센다.
+function agy() {
+  const dir = join(AGY_ROOT, 'conversations');
+  const running = canListProcesses() ? findProcesses(isAgy).length : null;
+  const files = existsSync(dir) ? walk(dir, 0, (n) => n.endsWith('.db')) : null;
+  if (!files) return { tool: 'agy', state: 'missing', path: tilde(AGY_ROOT), records: 0, lastAt: null, running, readable: null, hint: 'agy 를 한 번 실행하면 생깁니다 (Gemini 탭에 보입니다)' };
+  const last = newest(files.flatMap((f) => [f, `${f}-wal`]).filter((f) => existsSync(f)));
+  if (!loadSqlite()) return { tool: 'agy', state: 'limited', path: tilde(AGY_ROOT), records: files.length, lastAt: last?.mtime ?? null, running, readable: null, hint: `Node ${process.versions.node} 에서는 기록을 읽기 전용으로 열 수 없어 프로세스만 감지합니다 (Node 22.15 이상 필요)` };
+  let readable = false;
+  let db;
+  try {
+    db = openReadOnly(join(AGY_ROOT, 'conversation_summaries.db'));
+    db.prepare('select count(*) n from conversation_summaries').get();
+    readable = true;
+  } catch {
+  } finally {
+    db?.close();
+  }
+  return { tool: 'agy', state: 'ok', path: tilde(AGY_ROOT), records: files.length, lastAt: last?.mtime ?? null, running, readable, hint: null };
+}
+
+export function checkTools() {
+  const tools = {};
+  for (const fn of [claude, codex, gemini, agy]) {
+    const r = fn();
+    tools[r.tool] = r;
+  }
+  const n = findNotifier();
+  return { platform: platform(), processes: canListProcesses(), tools, notifier: n ? { kind: n.kind, path: tilde(n.path) } : null };
+}
+
+// --notify 에 쓸 데스크톱 알림 도구.
+export function notifierText(n, plat = platform()) {
+  if (n) return `✓ 알림    ${n.kind} (${n.path}) · --notify 로 켬`;
+  const want = plat === 'darwin' ? 'osascript' : 'notify-send';
+  const wsl = plat === 'linux' && isWsl() ? ' (WSL 은 notify-send 만 쓴다)' : '';
+  return `○ 알림    ${want} 없음 · --notify 를 켜도 알림을 건너뜀${wsl}`;
+}
+
+// JSON 용: 시각은 ISO 문자열로.
+export function toolsJson(tools) {
+  if (!tools) return null;
+  return Object.fromEntries(Object.entries(tools).map(([k, t]) => [k, { ...t, lastAt: t.lastAt ? new Date(t.lastAt).toISOString() : null }]));
+}
+
+// 점검 결과를 사람이 읽는 조각으로 바꾼다. 빈 화면과 --doctor 가 같은 문구를 쓴다.
+export const MARK = { ok: '✓', missing: '✗', limited: '○' };
+export const STATE_TEXT = { ok: '찾음', missing: '없음', limited: '일부 지원' };
+
+export function describe(t, now = Date.now()) {
+  const parts = [];
+  if (t.found === false && t.state === 'limited') parts.push('기록 폴더 없음');
+  else if (t.state !== 'missing') parts.push(`기록 ${t.records.toLocaleString('en-US')}개`);
+  if (t.lastAt) parts.push(`마지막 ${ago(now - t.lastAt)} 전`);
+  parts.push(t.running == null ? '실행 수 확인 불가 (Linux·WSL·macOS 만 지원)' : `실행 ${t.running}`);
+  if (t.readable === false) parts.push('최근 기록 읽기 실패');
+  if (t.keys?.length) parts.push(`키: ${t.keys.join(', ')}`);
+  return { mark: MARK[t.state], state: STATE_TEXT[t.state], path: t.path, detail: parts.join(' · '), hint: t.hint };
+}
+
+// aitop --doctor 의 사람용 출력.
+export function doctorText(result, version, now = Date.now()) {
+  const os = `${result.platform}, 프로세스 ${result.processes ? '확인 가능' : '확인 불가'}`;
+  const out = [`${BRAND.logo} aitop ${version} 연결 점검 (${os})`, ''];
+  for (const t of Object.values(result.tools)) {
+    const d = describe(t, now);
+    out.push(`${d.mark} ${pad(t.tool, 7)}${pad(d.state, 10)}${d.path}`);
+    out.push(`         ${d.detail}`);
+    if (d.hint) out.push(`         → ${d.hint}`);
+  }
+  if ('notifier' in result) out.push('', notifierText(result.notifier, result.platform));
+  // 설정 파일: 무시한 키와 값, 받지 않은 onWaiting 을 알린다.
+  const cfg = result.config;
+  if (cfg) {
+    out.push('', `${cfg.problems.length ? '!' : '✓'} 설정   ${pad(cfg.exists ? '있음' : '없음 (기본값)', 10)}${tilde(cfg.path)}`);
+    for (const p of cfg.problems) out.push(`         ! ${p}`);
+  }
+  if (result.log) out.push('', `${result.log.on ? '✓' : '○'} 디버그 ${pad(result.log.on ? '켬' : '꺼짐', 10)}${tilde(result.log.path)}${result.log.on ? '' : ' · --debug 로 켬'}`);
+  return stripControl(out.join('\n'));
+}

package/src/frames.mjs

@@ -0,0 +1,24 @@
+// 실시간 화면의 애니메이션 타이머. 움직이는 표시가 있을 때만 ms 마다 onFrame 을 부르고, 없으면 멈춘다.
+// sync() 는 화면을 그릴 때마다 불러 상태에 맞춰 타이머를 켜고 끈다. timers 는 테스트에서 바꿔 끼운다.
+export function frameTimer({ animating, onFrame, ms = 120, timers = globalThis }) {
+  let id = null;
+  const stop = () => {
+    if (id == null) return;
+    timers.clearInterval(id);
+    id = null;
+  };
+  const fire = () => {
+    if (!animating()) return stop();
+    onFrame();
+  };
+  return {
+    sync() {
+      if (!animating()) stop();
+      else if (id == null) id = timers.setInterval(fire, ms);
+    },
+    stop,
+    get running() {
+      return id != null;
+    },
+  };
+}

package/src/help.mjs

@@ -0,0 +1,111 @@
+// 키 안내의 한 곳: 화면 안 도움말(ui/chrome.mjs 의 help)과 aitop --help 의 키 줄이 이 표에서 만들어진다.
+// 화면 모듈을 불러오지 않는다 (bin 이 색·테마를 정하기 전에 불러도 되게).
+
+// 화면별 키. [키, 설명, 짧은 이름, --help 에 쓸 키(없으면 첫 글자 묶음)]
+export const VIEWS = {
+  table: {
+    title: '세션 표',
+    keys: [
+      ['/', '세션 검색 (이름·폴더·모델). Enter 적용, Esc 지우기', '검색'],
+      ['↑↓ j k', '세션 선택', '선택', '↑↓/jk'],
+      ['n', '다음 볼 세션으로 (응답 대기 → 완료 · 확인 전)', '다음 볼 세션'],
+      ['s', '정렬: 기본 → 비용순 → 컨텍스트순 → 최근순. 응답 대기는 늘 맨 위', '정렬'],
+      ['g', '묶기: 없음 → 프로젝트 → 도구. 묶음 머리에 세션 수·비용', '묶기'],
+      ['c', '비용 기준: API 환산 ↔ 캐시 제외. 표·헤더·상세가 같이 바뀐다 (예산은 늘 API 환산)', '비용 기준'],
+      ['p', '고른 세션을 맨 위(응답 대기 아래)에 고정·해제. 여러 개는 고정한 순서, 이번 실행에만', '고정'],
+      ['f Tab', '고른 세션의 변경 파일 목록으로', '변경 파일'],
+      ['d', '상세 패널 열기·닫기', '상세'],
+      ['e', '종료된 세션(24시간) 보이기·숨기기', '종료 세션 토글'],
+      ['Esc', '한 단계 뒤로 (도움말·검색 닫기, diff → 파일 목록 → 세션). 종료하지 않음', '뒤로'],
+    ],
+  },
+  detail: {
+    title: '상세 패널',
+    keys: [
+      ['↑↓ j k', '다른 세션을 고르면 상세도 따라 바뀐다', '세션 바꾸기', '↑↓/jk'],
+      ['f Tab', '변경 파일 목록으로', '변경 파일'],
+      ['d', '상세 패널 닫기', '닫기'],
+    ],
+  },
+  files: {
+    title: '변경 파일 목록',
+    keys: [
+      ['↑↓ j k', '파일 고르기', '고르기', '↑↓/jk'],
+      ['←→', '지시 탭: 이번 지시 · 편집이 있던 이전 지시 T번호 · 전체', '지시 탭'],
+      ['Enter l', '고른 파일의 diff 보기', 'diff'],
+      ['Esc h f Tab', '세션 표로', '뒤로'],
+    ],
+  },
+  diff: {
+    title: 'diff',
+    keys: [
+      ['↑↓ j k', '한 줄씩 스크롤', '스크롤', '↑↓/jk'],
+      ['space PgDn PgUp', '한 페이지씩', '페이지', 'space'],
+      ['[ ]', '이전·다음 파일', '이전·다음 파일', '[ ]'],
+      ['Esc h ← f Tab', '파일 목록으로', '뒤로'],
+    ],
+  },
+  filtered: {
+    title: '검색어가 걸린 표',
+    keys: [
+      ['↑↓ j k', '검색 결과 안에서 세션 선택', '선택', '↑↓/jk'],
+      ['Esc', '검색어 지우기 (표 전체로)', '검색어 지우기'],
+      ['/', '지금 검색어를 지우고 새로 입력', '새 검색'],
+    ],
+  },
+  // 검색어를 입력하는 동안은 ? 도 검색어로 들어가므로 도움말에서는 '다른 화면' 과 --help 에만 나온다.
+  search: {
+    title: '검색 입력 중',
+    keys: [
+      ['글자', '검색어 입력 (이름·폴더·모델, 대소문자 무시)', '입력'],
+      ['Backspace', '한 글자 지우기', '지우기'],
+      ['Enter', '검색어를 남기고 표로', '적용'],
+      ['Esc', '검색 취소 (검색어 지우기)', '취소'],
+    ],
+  },
+};
+
+// 어느 화면에서나 듣는 키. 화면마다 되풀이하지 않고 도움말에서는 지금 화면 키 바로 아래 한 번만 보인다.
+export const COMMON = {
+  title: '어디서나',
+  keys: [
+    ['?', '이 도움말 열기·닫기', '도움말'],
+    ['q Ctrl-C', '나가기', '나가기'],
+  ],
+};
+
+// 화면 안 도움말의 옵션 묶음. 자세한 설명은 aitop --help.
+export const OPTIONS = [
+  ['--notify', '응답 대기가 생기면 데스크톱 알림'],
+  ['--on-waiting <명령>', '응답 대기가 생기면 명령 실행'],
+  ['--budget-day <달러>', '하루 예산. 헤더에 예상 비용 경고'],
+  ['--show-requests', '응답 대기 요청 전체를 상세·--json 에'],
+  ['--color-blind', '적록 색약용 색 (대기·돈·경고를 노랑·파랑 계열로)'],
+  ['--debug', '디버그 로그를 남긴다'],
+  ['--print-config', '설정 값과 출처, 설정 파일 위치'],
+  ['AITOP_AMBIGUOUS=wide', '·→─● 를 2칸으로 그리는 터미널용 (1칸 기호로)'],
+];
+
+// 지금 보는 화면: 파일 목록·diff 에 들어가 있으면 그 화면, 아니면 세션 표. 검색어는 표에 붙는 것이라 helpSections 가 따로 본다.
+export function helpContext(view) {
+  if (view.focus === 'diff' || view.focus === 'files') return view.focus;
+  return 'table';
+}
+
+const cliKey = ([k, , , cli]) => cli ?? k.split(' ')[0];
+// 한 화면의 키를 한 줄로: '/ 검색 · ↑↓/jk 선택 · ...'
+// 'common' 은 어디서나 쓰는 키. 없는 화면 이름은 예전처럼 오류로 드러낸다.
+export const keysLine = (name) => (name === 'common' ? COMMON : VIEWS[name]).keys.map((e) => `${cliKey(e)} ${e[2]}`).join(' · ');
+
+// aitop --help 끝의 키 안내.
+export function keysText() {
+  return [`키: ${keysLine('table')} · ${keysLine('common')}`, ...['files', 'diff', 'filtered', 'search'].map((n) => `  ${VIEWS[n].title}: ${keysLine(n)}`)].join('\n');
+}
+
+// 지금 설정 값 한 줄 (예: 예산 $50 · 알림 켜짐 · 디버그 꺼짐). settings 가 없으면 null.
+export function settingsLine(s) {
+  if (!s) return null;
+  const onOff = (v) => (v ? '켜짐' : '꺼짐');
+  const usd = (x) => (Number.isInteger(x) ? `$${x}` : `$${x.toFixed(2)}`);
+  return [`예산 ${s.budgetDay > 0 ? usd(s.budgetDay) : '없음'}`, `알림 ${onOff(s.notify)}`, ...(s.onWaiting ? ['대기 명령 있음'] : []), `디버그 ${onOff(s.debug)}`].join(' · ');
+}

package/src/json.mjs

@@ -0,0 +1,57 @@
+import { projectBudget } from './budget.mjs';
+import { toolsJson } from './doctor.mjs';
+
+// aitop --json 출력. 다른 스크립트나 AI 가 읽기 쉬운 모양으로 세션 목록과 사용량 합계를 담는다.
+// 텍스트는 수집 단계에서 이미 비밀값 가림이 적용돼 있다.
+
+const pickTokens = (t = {}) => ({ total: t.total ?? 0, input: t.input ?? 0, output: t.output ?? 0, cacheRead: t.cacheRead ?? 0, cacheWrite: t.cacheWrite ?? 0, main: t.main ?? null, sub: t.sub ?? null, subCount: t.subCount ?? null });
+
+const iso = (ms) => (ms ? new Date(ms).toISOString() : null);
+// 비용(달러)은 소수 넷째 자리까지 반올림한다.
+const money = (x) => (typeof x === 'number' ? Math.round(x * 1e4) / 1e4 : (x ?? null));
+// 최근 1시간 비용 (5분 칸 단위 근사).
+const lastHourOf = (h) => (h ? { cost: money(h.cost), costNoCache: money(h.costNoCache), unknown: Boolean(h.unknown) } : null);
+// last7days.daily: 날짜별 API 환산 비용 (오래된 날 → 오늘). unknown 은 가격표에 없는 모델이 섞인 날.
+const dailyOf = (days) => (days ? { daily: days.map((d) => ({ date: d.date, cost: money(d.cost), unknown: Boolean(d.unknown) })) } : {});
+const usageOf = (u) => (u ? { ...u, ...('cost' in u ? { cost: money(u.cost) } : {}) } : u);
+
+// version 은 aitop 버전, tools 는 aitop --doctor 와 같은 도구별 점검 결과다.
+// opts.showRequests: 응답 대기 요청 전체(waitDetail)를 넣는다. 기본은 꺼져 있다.
+// opts.budgetDay: 하루 예산. 있으면 usage.budget 에 예산, 오늘 끝 예상 비용(API 정가 환산, 화면과 같은 기준), 단계를 넣는다.
+export function toJson(data, version = null, opts = {}) {
+  const b = data.usage ? projectBudget(data.usage, opts.budgetDay, { now: data.at ?? Date.now() }) : null;
+  return {
+    version,
+    at: iso(data.at),
+    tools: toolsJson(data.tools?.tools),
+    usage: data.usage ? { today: usageOf(data.usage.today), last7days: { ...usageOf(data.usage.week), ...dailyOf(data.usage.days7) }, lastHour: lastHourOf(data.usage.lastHour), complete: data.usage.loading == null, ...(b ? { budget: { day: b.day, projected: money(b.projected), unknown: b.unknown, level: b.level } } : {}) } : null,
+    sessions: data.sessions.map((s) => ({
+      tool: s.tool,
+      id: s.id,
+      name: s.name ?? null,
+      project: s.project ?? null,
+      cwd: s.cwd ?? null,
+      branch: s.branch ?? null,
+      model: s.model ?? null,
+      kind: s.kind ?? null,
+      pid: s.pid ?? null,
+      live: Boolean(s.live),
+      status: s.status,
+      phase: s.phase?.text ?? null,
+      waitingFor: s.waitingFor ?? null,
+      // 허락을 기다리는 요청의 전체 내용 (Bash 명령, 파일 경로 등). --show-requests 를 켰을 때만 넣는다. 비밀값 가림은 최선을 다할 뿐이다.
+      ...(opts.showRequests ? { waitDetail: s.waitDetail ?? null } : {}),
+      now: s.now || null,
+      startedAt: iso(s.startedAt),
+      updatedAt: iso(s.updatedAt),
+      tokens: pickTokens(s.tokens),
+      cost: money(s.cost),
+      costNoCache: money(s.costNoCache),
+      costUnknown: Boolean(s.costUnknown),
+      context: { used: s.context?.used ?? 0, window: s.context?.window ?? null },
+      // 변경 내용(diff)은 넣지 않고 파일별 통계만 넣는다. 줄 수는 편집마다 더한 누적값이다 (git diff 아님).
+      files: (s.files ?? []).map((f) => ({ path: f.path, created: Boolean(f.created), edits: f.edits, writtenLines: f.add, deletedLines: f.del, updatedAt: iso(f.at), agents: f.agents ?? [] })),
+      members: (s.members ?? []).map((m) => ({ name: m.name, task: m.task ?? null, model: m.model ?? null, status: m.status, phase: m.phase?.text ?? null, tokens: m.tokens ?? 0, cost: money(m.cost) })),
+    })),
+  };
+}

package/src/keys.mjs

@@ -0,0 +1,154 @@
+// 키 입력 처리. 화면 상태(view)를 바꾸고, 종료·갱신·세션 이동처럼 밖에서 해야 할 일은 act 로 부른다.
+// view.focus: null(세션 선택) → 'files'(변경 파일 목록) → 'diff'(고른 파일의 변경 내용). Esc 는 한 단계씩 뒤로 가고 종료하지 않는다.
+// view.tab: 변경 파일을 보는 지시 탭 ('now' 이번 지시, 지시 번호, 'all' 전체). turns.mjs 참고.
+import { turnTabs, visibleFiles } from './turns.mjs';
+import { detailOpen } from './ui/chrome.mjs';
+import { nextGroup, nextSort, togglePin } from './order.mjs';
+
+export const KEY = { up: '\x1b[A', down: '\x1b[B', right: '\x1b[C', left: '\x1b[D', pageUp: '\x1b[5~', pageDown: '\x1b[6~', esc: '\x1b', enter: '\r', tab: '\t', ctrlC: '\x03', backspace: '\x7f' };
+
+const isUp = (k) => k === KEY.up || k === 'k';
+const isDown = (k) => k === KEY.down || k === 'j';
+const isBack = (k) => k === KEY.esc || k === 'h';
+
+export function selectedSession(view) {
+  return view.data?.sessions.find((s) => s.id === view.selectedId) ?? null;
+}
+
+const hasFiles = (view) => Boolean(selectedSession(view)?.files?.length);
+// 지금 탭에 보이는 파일
+const filesOf = (view) => visibleFiles(selectedSession(view), view.tab);
+
+// 갱신 뒤에 고른 파일이 탭에서 빠졌거나 세션에 고친 파일이 없어졌으면 포커스를 맞춘다.
+export function fixFocus(view) {
+  if (!view.focus) return;
+  if (!hasFiles(view) || !view.showDetail) {
+    view.focus = null;
+    return;
+  }
+  const files = filesOf(view);
+  if (files.some((f) => f.path === view.filePath)) return;
+  // 보던 diff 의 파일이 탭에서만 빠졌으면(새 지시가 들어와 이번 지시가 바뀜) 닫지 않고 전체 탭으로 옮긴다.
+  if (view.focus === 'diff' && selectedSession(view).files.some((f) => f.path === view.filePath)) {
+    view.tab = 'all';
+    return;
+  }
+  view.filePath = files[0]?.path ?? null;
+  view.focus = 'files';
+}
+
+// 이번 지시에 고친 파일이 없어도 목록에는 들어간다. ←/→ 로 다른 지시를 볼 수 있다.
+function enterFiles(view) {
+  if (!hasFiles(view)) return;
+  view.showDetail = true;
+  view.focus = 'files';
+  const files = filesOf(view);
+  if (!files.some((f) => f.path === view.filePath)) view.filePath = files[0]?.path ?? null;
+}
+
+function stepTab(view, delta) {
+  const tabs = turnTabs(selectedSession(view));
+  const i = Math.max(0, tabs.findIndex((t) => t.key === (view.tab ?? 'now')));
+  view.tab = tabs[Math.min(tabs.length - 1, Math.max(0, i + delta))].key;
+  const files = filesOf(view);
+  if (!files.some((f) => f.path === view.filePath)) view.filePath = files[0]?.path ?? null;
+}
+
+function stepFile(view, delta) {
+  const files = filesOf(view);
+  const i = Math.max(0, files.findIndex((f) => f.path === view.filePath));
+  view.filePath = files[Math.min(files.length - 1, Math.max(0, i + delta))]?.path ?? null;
+}
+
+function filesKey(view, key) {
+  if (isUp(key)) stepFile(view, -1);
+  else if (isDown(key)) stepFile(view, 1);
+  else if (key === KEY.left || key === KEY.right) stepTab(view, key === KEY.left ? -1 : 1);
+  else if (key === KEY.enter || key === 'l') {
+    if (!view.filePath) return true;
+    view.focus = 'diff';
+    view.diffScroll = 0;
+  } else if (isBack(key) || key === 'f' || key === KEY.tab) view.focus = null;
+  else return false;
+  return true;
+}
+
+function diffKey(view, key) {
+  const page = view.diffPage ?? 10;
+  if (isUp(key)) view.diffScroll = Math.max(0, (view.diffScroll ?? 0) - 1);
+  else if (isDown(key)) view.diffScroll = (view.diffScroll ?? 0) + 1;
+  else if (key === ' ' || key === KEY.pageDown) view.diffScroll = (view.diffScroll ?? 0) + page;
+  else if (key === KEY.pageUp) view.diffScroll = Math.max(0, (view.diffScroll ?? 0) - page);
+  else if (key === '[' || key === ']') {
+    stepFile(view, key === '[' ? -1 : 1);
+    view.diffScroll = 0;
+  } else if (isBack(key) || key === KEY.left) view.focus = 'files';
+  else return false;
+  return true;
+}
+
+// 검색 중에는 글자를 검색어로 받는다. Enter 는 검색어를 남기고 목록으로, Esc 는 검색을 지운다.
+function searchKey(view, key, act) {
+  if (key === KEY.enter) view.searching = false;
+  else if (key === KEY.esc) {
+    view.searching = false;
+    view.filter = '';
+  } else if (key === KEY.backspace || key === '\b') view.filter = [...(view.filter ?? '')].slice(0, -1).join('');
+  else if (!/[\x00-\x1f\x7f]/.test(key)) view.filter = (view.filter ?? '') + key;
+  act.keepVisible();
+}
+
+// 도움말은 모달이다: 열려 있는 동안은 스크롤(↑↓ j k space PgUp PgDn), 닫기(? Esc), 나가기(q)만 듣고 나머지 키는 버린다.
+// 스크롤 끝과 한 페이지 줄 수는 마지막으로 그린 도움말이 정한다 (view.helpMax, view.helpPage).
+function helpKey(view, key, act) {
+  if (key === '?' || key === KEY.esc) view.help = false;
+  else if (key === 'q') act.quit();
+  else {
+    const page = view.helpPage ?? 10;
+    const step = isUp(key) ? -1 : isDown(key) ? 1 : key === ' ' || key === KEY.pageDown ? page : key === KEY.pageUp ? -page : 0;
+    if (step) view.helpScroll = Math.min(view.helpMax ?? 0, Math.max(0, (view.helpScroll ?? 0) + step));
+  }
+}
+
+export function onKey(view, key, act) {
+  if (key === KEY.ctrlC) return act.quit();
+  if (view.help) return helpKey(view, key, act);
+  if (view.searching) return searchKey(view, key, act);
+  if (key === '?') {
+    view.help = true;
+    view.helpScroll = 0;
+    return;
+  }
+  if (key === 'q') return act.quit();
+  if (view.focus === 'diff' && diffKey(view, key)) return;
+  if (view.focus === 'files' && filesKey(view, key)) return;
+  if (key === KEY.esc) {
+    view.filter = '';
+    return;
+  }
+  if (key === 'f' || key === KEY.tab) return enterFiles(view);
+  if (key === '/') {
+    view.searching = true;
+    view.filter = '';
+    view.focus = null;
+  } else if (isUp(key)) act.move(-1);
+  else if (isDown(key)) act.move(1);
+  else if (key === 'n') act.next();
+  // 정렬·묶기는 순서만 바꾸고 선택은 같은 세션 id 에 남는다.
+  else if (key === 's') view.sort = nextSort(view.sort);
+  else if (key === 'g') view.group = nextGroup(view.group);
+  // 고정(p)은 이번 실행에만 기억한다. 고른 세션은 그대로 남고 자리만 위로 옮긴다.
+  // 파일 목록·diff 에 들어가 있을 때는 키 안내에 없으므로 받지 않는다.
+  else if (key === 'p') {
+    if (view.selectedId != null && !view.focus) view.pins = togglePin(view.pins, view.selectedId);
+  }
+  else if (key === 'c') view.costMode = view.costMode === 'net' ? 'api' : 'net';
+  else if (key === 'd') {
+    // view.rows: 마지막으로 그린 화면 높이. 'auto' 일 때 지금 보이는 상태를 뒤집는 데 쓴다.
+    view.showDetail = !detailOpen(view, view.rows ?? Infinity);
+    if (!view.showDetail) view.focus = null;
+  } else if (key === 'e') {
+    view.showEnded = !view.showEnded;
+    act.refresh();
+  }
+}