kebab/tasks/INDEX.md

title, source, date

title	source	date
KB 작업 단위 인덱스	kebab_local_rust_report.md	2026-04-27

KB 작업 단위 인덱스

kebab_local_rust_report.md 의 Phase 로드맵을 아키텍처 수준 작업 단위로 분해. 각 task 문서는 독립적으로 착수/검수 가능한 단위.

의존 그래프

P0 ── P1 ── P2 ── P3 ── P4 ── P5
                              │
                              ├─ P6 (image)
                              ├─ P7 (pdf)
                              ├─ P8 (audio)
                              └─ P9 (TUI/desktop)

P0P5 는 직렬. P6P9 는 P5 이후 병렬 가능.

작업 단위

#	코드	제목	핵심 산출 crate	선행
P0	phase-0-skeleton.md	Workspace 뼈대 + 도메인 계약	kebab-core, kebab-parse-types, kebab-config, kebab-app, kebab-cli	–
P1	phase-1-markdown-ingestion.md	Markdown ingestion 파이프라인	kebab-source-fs, kebab-parse-md, kebab-normalize, kebab-chunk, kebab-store-sqlite	P0
P2	phase-2-lexical-search.md	SQLite FTS5 lexical 검색 + citation	kebab-search (lexical)	P1
P3	phase-3-vector-hybrid.md	Local embedding + LanceDB + hybrid	kebab-embed, kebab-embed-local, kebab-store-vector, kebab-search	P2
P4	phase-4-local-llm-rag.md	Local LLM + RAG + grounded answer	kebab-llm, kebab-llm-local, kebab-rag	P3
P5	phase-5-evaluation.md	Golden query / regression eval	kebab-eval	P4
P6	phase-6-image.md	이미지 ingestion (OCR + caption)	kebab-parse-image	P5
P7	phase-7-pdf.md	PDF text + page citation	kebab-parse-pdf	P5
P8	phase-8-audio.md	음성 transcription + timestamp citation	kebab-parse-audio	P5
P9	phase-9-ui.md	TUI + desktop app	kebab-tui, kebab-desktop	P5

Component task decomposition (per phase)

각 phase 의 component-level 분해. AI sub-agent 1세션 = 1 task 가 sweet spot.

• P0 — p0/ — 1 component
  • p0-1 skeleton
• P1 — p1/ — 6 components
  • p1-1 source-fs
  • p1-2 parse-md frontmatter
  • p1-3 parse-md blocks
  • p1-4 normalize
  • p1-5 chunk
  • p1-6 store-sqlite
• P2 — p2/ — 2 components
  • p2-1 fts-schema
  • p2-2 lexical-retriever
• P3 — p3/ — 5 components
  • p3-1 embedder-trait
  • p3-2 fastembed-adapter
  • p3-3 lancedb-store
  • p3-4 hybrid-fusion
  • p3-5 app-wiring
• P4 — p4/ — 3 components
  • p4-1 llm-trait
  • p4-2 ollama-adapter
  • p4-3 rag-pipeline
• P5 — p5/ — 2 components
  • p5-1 golden-fixture-runner
  • p5-2 metrics-compare
• P6 — p6/ — 4 components
  • p6-1 image-extractor-exif
  • p6-2 ocr-adapter
  • p6-3 caption-adapter
  • p6-4 image-ingest-wiring
• P7 — p7/ — 3 components
  • p7-1 pdf-text-extractor
  • p7-2 pdf-page-chunker
  • p7-3 pdf-ingest-wiring
• P8 — p8/ — 2 components
  • p8-1 whisper-adapter
  • p8-2 segment-chunker
• P9 — p9/ — 5 components + 도그푸딩 피드백
  • p9-1 tui-library
  • p9-2 tui-search
  • p9-3 tui-ask
  • p9-4 tui-inspect
  • p9-5 desktop-tauri
  • p9-dogfooding 피드백 인덱스 — 사용자가 직접 돌려보며 수집한 UX 잡음 → p9-fb-01 ~ 20 으로 분해 + 구현 20/20 ✅ (2026-05-03 완료)
  • p9-fb-01 ingest progress callback
  • p9-fb-02 CLI progress display
  • p9-fb-03 TUI ingest background
  • p9-fb-04 ingest cancellation
  • p9-fb-05 config path policy
  • p9-fb-06 kebab reset
  • p9-fb-07 MD title fallback
  • p9-fb-08 search debounce
  • p9-fb-09 editor restore
  • p9-fb-10 CJK input
  • p9-fb-11 ask markdown render
  • p9-fb-12 mode machine
  • p9-fb-13 cheatsheet
  • p9-fb-14 color theme
  • p9-fb-15 RAG multi-turn core
  • p9-fb-16 TUI ask conversation
  • p9-fb-17 chat session storage (V004)
  • p9-fb-18 CLI ask session/repl
  • p9-fb-19 search cache
  • p9-fb-20 citation surface
  • p9-fb-21 Insert-key + F1 visibility (post-도그푸딩)
  • p9-fb-22 cursor mid-string editing + Ask follow-tail (post-도그푸딩)
  • p9-fb-24 status bar + Library header + page scroll (post-도그푸딩)

Post-merge 핫픽스

머지 후 발견된 버그들과 그 follow-up PR들은 HOTFIXES.md에 dated 로그로 기록한다. 원래 task spec은 frozen 상태로 두고, post-merge 동작 변경은 HOTFIXES.md를 source of truth로 본다.

모든 task 공통 규약

• 의존성 경계 (Allowed / Forbidden) 위반 금지. report §19 참조.
• citation 없는 검색 결과 / RAG 응답 금지.
• 원본 파일 파괴 금지. 파생물만 재생성.
• 모든 record 에 version (parser/chunker/embedding/index/prompt) 기록.
• 각 phase 완료 = cargo check --workspace && cargo test --workspace 통과 + 해당 phase 의 완료 조건 CLI 데모 통과.