byuckchon-frontend-cli 1.9.0 → 1.9.1

package/README.md

@@ -284,6 +284,8 @@ TTY 안에서 자동으로 ink 모드로 뜨고, 파이프/CI 같은 비-TTY 환
 | ------------------- | ------------------------------------------ |
 | `/help`             | 도움말                                     |
 | `/clear`            | 대화 컨텍스트 초기화                        |
+| `/history`          | 이전 대화 선택 후 해당 컨텍스트 이어가기     |
+| `/retry`            | 마지막 사용자 요청 다시 실행                |
 | `/model [id]`       | 세션 모델 변경 (인자 없으면 목록)           |
 | `/cost`             | 누적 토큰/비용                              |
 | `/image <path>`     | 다음 메시지에 이미지 첨부 (Vision 모델 권장) |
@@ -294,6 +296,10 @@ TTY 안에서 자동으로 ink 모드로 뜨고, 파이프/CI 같은 비-TTY 환
 | `/rag on\|off`      | RAG 컨텍스트 주입 즉석 토글                 |
 | `/exit`             | 종료 (`Ctrl+C` 도 가능)                     |
 
+Ink 모드에서 `/history`를 실행하면 `↑↓`로 세션을 선택하고 `Enter`로 불러올 수 있습니다.
+선택한 세션에서 `d`를 누른 뒤 `y`로 확인하면 해당 기록을 삭제합니다. 메시지를 한 번도
+보내지 않고 종료한 빈 세션은 저장되거나 목록에 표시되지 않습니다.
+
 이미지 첨부는 png / jpg / jpeg / gif / webp 만 지원하며,
 Claude / GPT 비전 모델에 멀티파트 메시지로 전달됩니다.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "byuckchon-frontend-cli",
-  "version": "1.9.0",
+  "version": "1.9.1",
   "description": "Byuckchon Frontend Workbench — project starter + AI chat + codebase RAG + OpenAPI codegen",
   "type": "module",
   "engines": {

package/src/commands/chat.js

@@ -17,10 +17,12 @@ import { printInlineThumbnail } from '../ai/imagePreview.js';
 import {
   createSession,
   saveSession,
+  deleteSession,
   listSessions,
   loadSession,
   loadLatestSession,
 } from '../history/store.js';
+import { findLastRetryableUser, formatSessionList } from '../history/management.js';
 import { getCachedOpenApi } from '../openapi/cache.js';
 import { summarizeOpenApi } from '../openapi/summary.js';
 
@@ -162,8 +164,6 @@ export async function chatCommand(opts = {}) {
     // 모델은 사용자가 명시했거나 글로벌 설정으로 갱신 가능 — 세션의 model 은 표시용.
     session.model = resolved.meta.id;
   }
-  await saveSession(session); // 빈 파일이라도 디스크에 만들어둠
-
   // ink 는 stdin/stdout 둘 다 TTY 이어야 정상 동작.
   // - --plain 플래그가 명시되거나 비-TTY 면 readline 폴백.
   // - 글로벌 ui.mode 가 "plain" 이면 한글 IME 가 깨지는 케이스를 자동 회피.
@@ -206,9 +206,36 @@ async function runInkApp({ cfg, resolved, system, session, openapiInfo, conventi
 
   const initialConfig = { ...cfg, system, openapiInfo, conventionFiles };
 
+  let activeSession = session;
+
   const onSessionUpdate = async (messages) => {
-    session.messages = messages;
-    await saveSession(session);
+    const target = activeSession;
+    const hasConversation = messages.some(
+      (message) =>
+        (message.role === 'user' || message.role === 'assistant') &&
+        typeof message.text === 'string' &&
+        message.text.trim(),
+    );
+    if (!hasConversation && !target._persisted) return;
+    target.messages = messages;
+    await saveSession(target);
+  };
+
+  const onSessionSwitch = async (id) => {
+    const loaded = await loadSession(id);
+    loaded.model = resolved.meta.id;
+    activeSession = loaded;
+    return loaded;
+  };
+
+  const onSessionDelete = async (id) => {
+    const deletingActive = activeSession.id === id;
+    const result = await deleteSession(id);
+    if (!deletingActive) return { ...result, replacementSession: null };
+
+    const replacementSession = await createSession({ model: resolved.meta.id });
+    activeSession = replacementSession;
+    return { ...result, replacementSession };
   };
 
   const { waitUntilExit } = render(
@@ -217,6 +244,8 @@ async function runInkApp({ cfg, resolved, system, session, openapiInfo, conventi
       initialResolved: resolved,
       session,
       onSessionUpdate,
+      onSessionSwitch,
+      onSessionDelete,
     }),
     { exitOnCtrlC: false },
   );
@@ -291,7 +320,9 @@ async function runReadlineFallback({ cfg, resolved, system, session, openapiInfo
     console.log(chalk.dim(`  세션: ${session.id} (${session.messages.length} turns 이어가기)`));
   }
   console.log(
-    chalk.dim('  /image <경로> · /paste(클립보드 이미지) · /clear-attach · /exit\n'),
+    chalk.dim(
+      '  /history · /retry · /image <경로> · /paste · /clear-attach · /exit\n',
+    ),
   );
 
   // 다음 메시지에 함께 보낼 이미지 첨부 목록.
@@ -341,6 +372,21 @@ async function runReadlineFallback({ cfg, resolved, system, session, openapiInfo
   const history = (session?.messages ?? [])
     .filter((m) => m.role === 'user' || m.role === 'assistant')
     .map((m) => ({ role: m.role, content: m.text ?? '' }));
+  const persistHistory = async () => {
+    if (!session) return;
+    session.messages = history.map((message) => {
+      // 이미지 바이트는 세션 파일에 저장하지 않고 사용자 텍스트만 보존한다.
+      if (Array.isArray(message.content)) {
+        const textPart = message.content.find((part) => part.type === 'text');
+        return {
+          role: message.role,
+          text: textPart?.text ?? '[이미지 첨부]',
+        };
+      }
+      return { role: message.role, text: message.content };
+    });
+    await saveSession(session);
+  };
   const ask = () => rl.prompt();
 
   rl.on('close', () => {
@@ -359,6 +405,29 @@ async function runReadlineFallback({ cfg, resolved, system, session, openapiInfo
       rl.close();
       return;
     }
+    if (line === '/history') {
+      try {
+        const sessions = await listSessions();
+        console.log(chalk.dim('\n' + formatSessionList(sessions)));
+        console.log(chalk.dim('\n  이어가기: bc chat --resume <id>'));
+      } catch (err) {
+        console.log(chalk.red('  대화 목록을 불러올 수 없습니다: ' + err.message));
+      }
+      ask();
+      continue;
+    }
+    let retryContent = null;
+    if (line === '/retry') {
+      const retry = findLastRetryableUser(history);
+      if (!retry) {
+        console.log(chalk.red('  다시 실행할 사용자 요청이 없습니다.'));
+        ask();
+        continue;
+      }
+      retryContent = retry.message.content;
+      history.splice(retry.index);
+      console.log(chalk.dim('  마지막 요청을 다시 실행합니다.'));
+    }
     // 이미지 첨부 관련 슬래시 명령 — plain 모드에서도 지원.
     if (line.startsWith('/image')) {
       await addImage(line.slice('/image'.length).trim());
@@ -388,7 +457,9 @@ async function runReadlineFallback({ cfg, resolved, system, session, openapiInfo
     }
 
     // 일반 메시지 — 첨부가 있으면 멀티모달 content 로 구성.
-    if (pendingAttachments.length) {
+    if (retryContent != null) {
+      history.push({ role: 'user', content: retryContent });
+    } else if (pendingAttachments.length) {
       const parts = [{ type: 'text', text: line }];
       try {
         for (const att of pendingAttachments) {
@@ -403,6 +474,11 @@ async function runReadlineFallback({ cfg, resolved, system, session, openapiInfo
     } else {
       history.push({ role: 'user', content: line });
     }
+    try {
+      await persistHistory();
+    } catch {
+      /* 저장 실패가 AI 요청을 막지는 않게 한다. */
+    }
     rl.pause();
 
     const projectRoot = cfg.paths.projectFile
@@ -457,21 +533,11 @@ async function runReadlineFallback({ cfg, resolved, system, session, openapiInfo
     }
     if (acc) history.push({ role: 'assistant', content: acc });
 
-    // 세션 자동 저장 — readline 모드에서도 끊김 대비.
-    if (session) {
-      session.messages = history.map((h) => {
-        // 멀티모달(content 가 배열) 인 경우 text 파트만 추출해 저장 (이미지 바이트는 세션에 안 남김).
-        if (Array.isArray(h.content)) {
-          const textPart = h.content.find((p) => p.type === 'text');
-          return { role: h.role, text: textPart?.text ?? '[이미지 첨부]' };
-        }
-        return { role: h.role, text: h.content };
-      });
-      try {
-        await saveSession(session);
-      } catch {
-        /* noop */
-      }
+    // 응답까지 포함한 최신 상태로 다시 저장한다.
+    try {
+      await persistHistory();
+    } catch {
+      /* noop */
     }
 
     rl.resume();

package/src/history/management.js

@@ -0,0 +1,30 @@
+function messageText(message) {
+  if (typeof message?.text === 'string') return message.text;
+  if (typeof message?.content === 'string') return message.content;
+  if (Array.isArray(message?.content)) {
+    return message.content.find((part) => part.type === 'text')?.text ?? '[이미지 첨부]';
+  }
+  return '';
+}
+
+export function findLastRetryableUser(messages) {
+  for (let index = messages.length - 1; index >= 0; index -= 1) {
+    const message = messages[index];
+    if (message.role === 'user' && messageText(message).trim()) {
+      return { index, message, text: messageText(message) };
+    }
+  }
+  return null;
+}
+
+export function formatSessionList(sessions, { limit = 10 } = {}) {
+  if (!sessions.length) return '저장된 이전 세션이 없습니다.';
+  return sessions
+    .slice(0, limit)
+    .map((session) => {
+      const when = session.updatedAt?.replace('T', ' ').slice(0, 19) ?? '';
+      const preview = session.preview || '(빈 세션)';
+      return `${session.id}  ${when}  ${session.turns} turns\n  ${preview}`;
+    })
+    .join('\n');
+}

package/src/history/store.js

@@ -49,7 +49,7 @@ export async function createSession({ model, cwd = process.cwd() } = {}) {
     cwd,
     messages: [],
   };
-  return { ...session, _file: path.join(dir, `${id}.json`) };
+  return { ...session, _file: path.join(dir, `${id}.json`), _persisted: false };
 }
 
 export async function saveSession(session) {
@@ -64,6 +64,7 @@ export async function saveSession(session) {
     messages: session.messages,
   };
   await fs.writeFile(file, JSON.stringify(data, null, 2) + '\n', 'utf8');
+  session._persisted = true;
 }
 
 export async function listSessions(cwd = process.cwd(), { limit = 20 } = {}) {
@@ -77,19 +78,27 @@ export async function listSessions(cwd = process.cwd(), { limit = 20 } = {}) {
   }
   const files = entries.filter((f) => f.endsWith('.json')).sort().reverse();
   const out = [];
-  for (const name of files.slice(0, limit)) {
+  for (const name of files) {
+    if (out.length >= limit) break;
     const file = path.join(dir, name);
     try {
       const raw = await fs.readFile(file, 'utf8');
       const data = JSON.parse(raw);
-      const firstUser = data.messages?.find((m) => m.role === 'user');
+      const conversation = (data.messages ?? []).filter(
+        (message) =>
+          (message.role === 'user' || message.role === 'assistant') &&
+          typeof message.text === 'string' &&
+          message.text.trim(),
+      );
+      if (conversation.length === 0) continue;
+      const firstUser = conversation.find((message) => message.role === 'user');
       out.push({
         id: data.id,
         file,
         startedAt: data.startedAt,
         updatedAt: data.updatedAt,
         model: data.model,
-        turns: data.messages?.length ?? 0,
+        turns: conversation.length,
         preview: firstUser?.text?.slice(0, 60) ?? '(빈 세션)',
       });
     } catch {
@@ -107,7 +116,7 @@ export async function loadSession(idOrFile, cwd = process.cwd()) {
   }
   const raw = await fs.readFile(file, 'utf8');
   const data = JSON.parse(raw);
-  return { ...data, _file: file };
+  return { ...data, _file: file, _persisted: true };
 }
 
 export async function loadLatestSession(cwd = process.cwd()) {
@@ -115,3 +124,22 @@ export async function loadLatestSession(cwd = process.cwd()) {
   if (list.length === 0) return null;
   return loadSession(list[0].id, cwd);
 }
+
+export async function deleteSession(id, cwd = process.cwd()) {
+  const normalized = String(id ?? '').replace(/\.json$/, '');
+  if (!/^[a-zA-Z0-9_-]+$/.test(normalized)) {
+    const error = new Error(`잘못된 세션 ID: ${id}`);
+    error.code = 'BC_INVALID_SESSION_ID';
+    throw error;
+  }
+
+  const dir = await getHistoryDir(cwd);
+  const file = path.join(dir, `${normalized}.json`);
+  try {
+    await fs.unlink(file);
+    return { id: normalized, file, deleted: true };
+  } catch (error) {
+    if (error.code === 'ENOENT') return { id: normalized, file, deleted: false };
+    throw error;
+  }
+}

package/src/ui/ChatApp.js

@@ -14,6 +14,8 @@ import { toSdkMessages, isImagePath } from '../ai/messageContent.js';
 import { buildTools } from '../ai/tools.js';
 import { searchIndex } from '../indexer/search.js';
 import { loadIndex, buildIndex } from '../indexer/store.js';
+import { listSessions } from '../history/store.js';
+import { findLastRetryableUser } from '../history/management.js';
 
 const h = React.createElement;
 
@@ -287,6 +289,8 @@ function AttachBar({ pending }) {
 const SLASH_COMMANDS = [
   { cmd: '/help', hint: '', desc: '명령 도움말' },
   { cmd: '/clear', hint: '', desc: '대화 컨텍스트 비우기' },
+  { cmd: '/history', hint: '', desc: '프로젝트의 이전 대화 목록' },
+  { cmd: '/retry', hint: '', desc: '마지막 사용자 요청 다시 실행' },
   { cmd: '/model', hint: '<id>', desc: '세션 모델 변경 (인자 없으면 목록)' },
   { cmd: '/cost', hint: '', desc: '누적 토큰/비용' },
   { cmd: '/image', hint: '<path>', desc: '이미지 첨부 (Finder 에서 끌어다 놔도 됨)' },
@@ -350,7 +354,45 @@ function SlashMenu({ items, activeIndex }) {
   );
 }
 
-export function ChatApp({ initialConfig, initialResolved, session, onSessionUpdate }) {
+function HistoryMenu({ items, activeIndex, activeSessionId, deleteId }) {
+  if (items.length === 0) return null;
+  return h(
+    Box,
+    {
+      flexDirection: 'column',
+      borderStyle: 'single',
+      borderColor: 'gray',
+      paddingX: 1,
+    },
+    h(Text, { bold: true }, '이전 대화'),
+    ...items.map((item, index) => {
+      const active = index === activeIndex;
+      const current = item.id === activeSessionId;
+      const when = item.updatedAt?.replace('T', ' ').slice(0, 16) ?? '';
+      return h(
+        Text,
+        {
+          key: item.id,
+          color: item.id === deleteId ? 'red' : active ? 'cyan' : undefined,
+          bold: active,
+        },
+        `${active ? '›' : ' '} ${item.id}${current ? ' (현재)' : ''}  ${when}  ${item.turns} turns\n  ${item.preview}`,
+      );
+    }),
+    deleteId
+      ? h(Text, { color: 'red' }, `${deleteId} 세션을 삭제할까요? y/n`)
+      : h(Text, { dimColor: true }, '↑↓ 선택 · Enter 불러오기 · d 삭제 · Esc 취소'),
+  );
+}
+
+export function ChatApp({
+  initialConfig,
+  initialResolved,
+  session,
+  onSessionUpdate,
+  onSessionSwitch,
+  onSessionDelete,
+}) {
   const app = useApp();
   const { stdout } = useStdout();
   const [cfg, setCfg] = useState(initialConfig);
@@ -380,12 +422,17 @@ export function ChatApp({ initialConfig, initialResolved, session, onSessionUpda
   const [indexProgress, setIndexProgress] = useState('');
   const [ragEnabled, setRagEnabled] = useState(true);
   const [menuIndex, setMenuIndex] = useState(0);
+  const [historyItems, setHistoryItems] = useState([]);
+  const [historyIndex, setHistoryIndex] = useState(0);
+  const [historyDeleteId, setHistoryDeleteId] = useState(null);
+  const [activeSessionId, setActiveSessionId] = useState(session?.id ?? null);
   const [, force] = useState(0);
   const rerender = useCallback(() => force((n) => n + 1), []);
 
   // 슬래시 메뉴: input 상태에 따라 동적으로 계산.
   const slashItems = state === 'idle' ? filterSlashCommands(input) : [];
   const slashOpen = slashItems.length > 0;
+  const historyOpen = state === 'idle' && historyItems.length > 0;
   // input 이 바뀌면 선택 인덱스를 0 으로 리셋 (필터 변경 시 자연스럽게).
   useEffect(() => {
     setMenuIndex(0);
@@ -507,6 +554,29 @@ export function ChatApp({ initialConfig, initialResolved, session, onSessionUpda
       app.exit();
       return;
     }
+    if (historyOpen) {
+      if (historyDeleteId) {
+        if (char.toLowerCase() === 'y') {
+          void deleteHistorySession();
+        } else if (char.toLowerCase() === 'n' || key.escape) {
+          setHistoryDeleteId(null);
+        }
+        return;
+      }
+      if (key.upArrow) {
+        setHistoryIndex((index) => Math.max(0, index - 1));
+      } else if (key.downArrow) {
+        setHistoryIndex((index) => Math.min(historyItems.length - 1, index + 1));
+      } else if (key.escape) {
+        setHistoryItems([]);
+      } else if (char.toLowerCase() === 'd') {
+        const selected = historyItems[historyIndex];
+        if (selected) setHistoryDeleteId(selected.id);
+      } else if (key.return) {
+        void selectHistorySession();
+      }
+      return;
+    }
     if (!slashOpen) return;
     if (key.upArrow) {
       setMenuIndex((i) => Math.max(0, i - 1));
@@ -552,6 +622,33 @@ export function ChatApp({ initialConfig, initialResolved, session, onSessionUpda
       pushSystemInfo('대화 컨텍스트를 비웠습니다.');
       return true;
     }
+    if (cmd === 'history') {
+      try {
+        const sessions = await listSessions();
+        if (!sessions.length) {
+          pushSystemInfo('저장된 이전 세션이 없습니다.');
+          return true;
+        }
+        setHistoryItems(sessions.slice(0, 10));
+        setHistoryIndex(0);
+        setHistoryDeleteId(null);
+      } catch (err) {
+        pushSystemError('대화 목록을 불러올 수 없습니다: ' + err.message);
+      }
+      return true;
+    }
+    if (cmd === 'retry') {
+      const retry = findLastRetryableUser(messages);
+      if (!retry) {
+        pushSystemError('다시 실행할 사용자 요청이 없습니다.');
+        return true;
+      }
+      await sendMessage(retry.text, {
+        baseMessages: messages.slice(0, retry.index),
+        attachments: retry.message.attachments ?? [],
+      });
+      return true;
+    }
     if (cmd === 'cost') {
       pushSystemInfo(meterRef.current.format());
       return true;
@@ -656,13 +753,70 @@ export function ChatApp({ initialConfig, initialResolved, session, onSessionUpda
     return true;
   };
 
-  const sendMessage = async (text) => {
+  const selectHistorySession = async () => {
+    const selected = historyItems[historyIndex];
+    if (!selected || !onSessionSwitch) return;
+
+    setHistoryItems([]);
+    setState('thinking');
+    try {
+      const loaded = await onSessionSwitch(selected.id);
+      setActiveSessionId(loaded.id);
+      setPendingAttachments([]);
+      setMessages([
+        ...(loaded.messages ?? []),
+        {
+          role: 'system-info',
+          text: `세션 ${loaded.id} 컨텍스트를 불러왔습니다.`,
+        },
+      ]);
+    } catch (err) {
+      pushSystemError('세션을 불러올 수 없습니다: ' + (err?.message ?? String(err)));
+    } finally {
+      setState('idle');
+    }
+  };
+
+  const deleteHistorySession = async () => {
+    const id = historyDeleteId;
+    if (!id || !onSessionDelete) return;
+
+    setHistoryDeleteId(null);
+    try {
+      const result = await onSessionDelete(id);
+      const remaining = historyItems.filter((item) => item.id !== id);
+      setHistoryItems(remaining);
+      setHistoryIndex((index) => Math.min(index, Math.max(0, remaining.length - 1)));
+
+      if (result.replacementSession) {
+        setActiveSessionId(result.replacementSession.id);
+        setPendingAttachments([]);
+        setMessages([
+          {
+            role: 'system-info',
+            text: `세션 ${id}을 삭제하고 새 세션을 시작했습니다.`,
+          },
+        ]);
+      } else {
+        pushSystemInfo(
+          result.deleted ? `세션 ${id}을 삭제했습니다.` : `세션 ${id}을 찾을 수 없습니다.`,
+        );
+      }
+    } catch (err) {
+      pushSystemError('세션을 삭제할 수 없습니다: ' + (err?.message ?? String(err)));
+    }
+  };
+
+  const sendMessage = async (
+    text,
+    { baseMessages = messages, attachments = pendingAttachments } = {},
+  ) => {
     const userMsg = {
       role: 'user',
       text,
-      attachments: pendingAttachments,
+      attachments,
     };
-    const newMessages = [...messages, userMsg];
+    const newMessages = [...baseMessages, userMsg];
     setMessages(newMessages);
     setPendingAttachments([]);
     setState('thinking');
@@ -896,12 +1050,20 @@ export function ChatApp({ initialConfig, initialResolved, session, onSessionUpda
       }),
     ),
     h(AttachBar, { pending: pendingAttachments }),
+    historyOpen
+      ? h(HistoryMenu, {
+          items: historyItems,
+          activeIndex: historyIndex,
+          activeSessionId,
+          deleteId: historyDeleteId,
+        })
+      : null,
     slashOpen ? h(SlashMenu, { items: slashItems, activeIndex: menuIndex }) : null,
     h(
       Box,
       { marginTop: 0 },
       h(Text, { color: 'magenta', bold: true }, 'you › '),
-      state === 'idle'
+      state === 'idle' && !historyOpen
         ? h(TextInput, {
             value: input,
             onChange: setInput,
@@ -912,7 +1074,15 @@ export function ChatApp({ initialConfig, initialResolved, session, onSessionUpda
             // 가짜 커서가 있으면 한글 IME 미리보기가 한 칸 어긋나 보일 수 있다.
             showCursor: false,
           })
-        : h(Text, { dimColor: true }, '(응답 받는 중 — 잠시만)'),
+        : h(
+            Text,
+            { dimColor: true },
+            historyOpen
+              ? historyDeleteId
+                ? '(y 또는 n을 입력하세요)'
+                : '(이전 대화를 선택하세요)'
+              : '(응답 받는 중 — 잠시만)',
+          ),
     ),
   );
 }