altair823
f9714aa5cb
마지막 commit. 모든 .md 안의 `kb` 단어 일괄 갱신. - 19 개 crate 이름 (`kb-core`, `kb-app`, …) → `kebab-*` (Rust 모듈 path 표기 `kb_*` → `kebab_*` 포함). - 미래 component (`kb-tui`, `kb-desktop`, `kb-asr-whisper`, `kb-ocr`, `kb-mcp`, `kb-vlm`, `kb-rerank`, `kb-vision-ocr`, `kb-index`, `kb-smoke`, `kb-architecture`) → `kebab-*` (P6+ 가 시작될 때 같은 prefix 사용). - CLI 명령 예제: `kb ingest` / `kb search` / `kb ask` / `kb init` / `kb doctor` / `kb inspect` / `kb list` / `kb eval` → `kebab <verb>`. fenced code block + 인라인 backtick 모두. - XDG paths + env vars + binary 경로 (`target/release/kb` → `target/release/kebab`) 동기화. - design doc / 최초 보고서 / SMOKE / HOTFIXES / phase epic / task spec 모든 reference 통일. - task-decomposition.md 의 `git -c user.name=kb` 는 과거 git history 기록용 author 정보라 그대로 유지 (실제 git history 의 author 는 변경 불가). - `tasks/phase-5-evaluation.md` 의 `status: planned` → `completed` 도 같이 (P5-1 + P5-2 PR 머지 후 미반영분). ## 검증 - `grep -rEn "\bkb-[a-z]|\bkb_[a-z]|\.config/kb\b|kb\.sqlite|\bKB_[A-Z]" --include="*.md"` 0 hits (task-decomposition.md 의 git author 제외). - 모든 file path reference 살아있음 (renamed file 들 모두 새 path 로 update). 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
3.7 KiB
3.7 KiB
phase, title, status, depends_on, source
| phase | title | status | depends_on | source | |
|---|---|---|---|---|---|
| P9 | TUI + desktop app | planned |
|
kebab_local_rust_report.md §16, §17 Phase 9 |
P9 — TUI + desktop app
목표
CLI 위에 사용성 레이어 추가. domain/검색/RAG 가 안정된 뒤 마지막에 붙임.
순서
kebab-tui (먼저) → kebab-desktop (나중)
이유: TUI 는 domain 변화에 빠르게 적응 가능. desktop 은 packaging/배포 비용 큼.
P9.A — kebab-tui (Ratatui)
산출 crate
kebab-tui— Ratatui + crossterm 기반 terminal UI.
화면 구성
| 화면 | 내용 |
|---|---|
| Library | document 목록, tag/lang 필터, indexing 상태 |
| Search | 검색창 + 결과 list + preview pane (citation 포함) |
| Ask | RAG 질문창 + 답변 + citation 토글 |
| Inspect | document/chunk 상세 (heading path, source span, provenance) |
| Jobs | indexing/embedding/transcription 진행 |
키바인딩 1차
Tab : 화면 전환
/ : 검색 모드
? : ask 모드
Enter : 결과 열기
g : citation 으로 점프 (외부 editor: $EDITOR +line file)
q : 종료
의존성 경계
kebab-tui→kebab-app만. parser/store/LLM 직접 호출 금지.- 비동기 I/O (검색/ask) 는
kebab-app비동기 wrapper 또는 thread + channel.
완료 조건
- document list / search / ask / inspect 4개 화면 동작
- 검색 결과 → editor 점프 (citation line 정확히)
- indexing job 진행률 표시
- CLI 와 동일 facade 호출 (기능 누락 0)
P9.B — kebab-desktop
후보 비교
| 후보 | 장점 | 단점 |
|---|---|---|
| Tauri | Rust backend + web frontend. native webview, 작은 binary | web frontend 별도 stack (TS/JS) |
| egui/eframe | 순수 Rust, immediate-mode | 디자인 자유도/접근성 한계 |
추천: Tauri 1차. 기존 kebab-app facade 그대로 backend 로 노출. frontend 는 가볍게 (svelte/solid/vanilla).
산출 crate / 구조
kebab-desktop(Tauri app crate)kebab-desktop-frontend/(web 자산)
Tauri command 는 kebab-app 함수 1:1 wrap. 신규 비즈니스 로직 추가 금지.
화면 구성 (1차)
| 패널 | 내용 |
|---|---|
| Library | document grid, multimodal 썸네일 (이미지/PDF/audio waveform) |
| Search | hybrid search + filter + citation preview |
| Ask | RAG chat. citation 클릭 시 source pane 동기화 |
| Source viewer | Markdown 렌더, PDF page viewer, image viewer (region overlay), audio player (segment seek) |
| Settings | model 선택, indexing 옵션, 경로 |
Citation 클릭 동작
- Markdown: 내장 viewer 의 해당 line range scroll + highlight.
- PDF: page jump + (선택) span highlight.
- Image: region bounding box overlay.
- Audio: segment 시작 시각으로 seek + 재생.
의존성 경계
- frontend 는 Tauri command (=
kebab-appwrapper) 만 호출. SQLite/LanceDB 직접 접근 금지. - 모델 다운로드/실행은 backend 책임.
완료 조건
- document, image, PDF, audio citation 모두 viewer 에서 점프 동작
- hybrid search + RAG chat 동작
- indexing/embedding/transcription job UI 표시
- macOS dmg 배포 가능 (M4 기준 동작 확인)
공통 리스크 / 주의
- UI 부터 만들면 domain 흔들릴 때 비용 폭주. P5 까지 안정시킨 뒤 진입 (§16.3).
- TUI 와 desktop 모두 facade 만 호출. UI 안에 비즈니스 로직 들어가면 P10 같은 신규 phase 마다 양쪽 다시 손봐야 함.
- desktop packaging (코드 서명, notarization) 은 별도 작업. 1차 릴리스는 unsigned dev build OK.
- Tauri 채택 시 web stack 이 "최소"여야 함. 프레임워크 선택은 1주일 안에 결론.