altair823-org/kebab
0
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 40 Wiki Activity

40 Releases 40 Tags

RSS Feed
  • v0.1.0 2319206522
    Compare

    kebab v0.1.0 — first release Stable

    altair823 released this 2026-05-05 02:26:29 +00:00 | 758 commits to main since this release

    kebab v0.1.0

    첫 공식 릴리즈. Single-user local-first knowledge base + RAG, 모든 inference local (Ollama + fastembed + whisper.cpp).

    주요 surface

    CLI

    • kebab init — XDG 기본 경로에 ~/.config/kebab/config.toml 생성.
    • kebab ingest [<path>] [--force-reingest] — workspace 색인. 두 번째 ingest 부터 변하지 않은 doc 자동 skip (blake3 + parser/chunker/embedding version cascade). --force-reingest 로 우회.
    • kebab search "<query>" [--mode lexical|vector|hybrid] — FTS5 / Lance / hybrid retrieval.
    • kebab ask "<query>" [--show-citations] [--session <id>] — RAG 답변 + 근거 인용. --session <id> 로 multi-turn.
    • kebab list docs / kebab inspect doc|chunk <id> — corpus inspection.
    • kebab doctor — 설정 / 모델 / DB health check.
    • kebab reset [--all|--data-only|--vector-only|--config-only] [--yes] — XDG 데이터 wipe.
    • kebab eval run / compare — golden query 회귀 측정.

    TUI (kebab tui)

    • 4 pane (Library / Search / Ask / Inspect) + vim-style mode (Normal / Insert).
    • Library: 컬럼 헤더 (TITLE / TAGS / UPDATED / CHUNKS) + display-width 정렬 (Hangul / CJK 안전).
    • Search: 200 ms debounce + background worker + stale 결과 자동 폐기 (generation counter).
    • Ask: multi-turn transcript, markdown 렌더, follow-tail auto-scroll.
    • 입력 cursor: ← / → / Home / End / Delete 로 mid-string 편집 (모든 input pane).
    • Page scroll: PgUp / PgDn (Ask 트랜스크립트 + Inspect, 10 줄 step).
    • Status bar (항상 노출): kebab v<version> │ <pane> │ <docs> docs │ <state> — streaming / searching / indexing / idle cascade. ingest progress 흡수.
    • Cheatsheet popup: F1 토글, 모든 pane 의 키바인딩 + global toggle 표.

    저장 / 격리

    • SQLite V001~V006 migration. V006 = incremental ingest (last_chunker_version / last_embedding_version per-doc).
    • LanceDB vector store, fastembed embedder.
    • Wire schema v1 (ingest_report / search_hit / answer / doctor / ingest_progress).

    Phase 진행

    P0 ~ P5 직렬 + P6 ~ P9 P5 이후 병렬. 본 릴리즈는 P9 (UI) 의 도그푸딩 사이클 1회 완성 + post-merge follow-up (p9-fb-21 ~ p9-fb-24) 포함.

    도그푸딩 follow-up 하이라이트

    • p9-fb-22 — TUI 입력 cursor mid-string 편집 + Ask follow-tail auto-scroll. Gitea #94, #95.
    • p9-fb-23 — Incremental ingest (변하지 않은 doc skip).
    • p9-fb-24 — TUI status/key bar + Library 컬럼 헤더 + Ask/Inspect PgUp/PgDn.

    다음

    • P9-5 Tauri desktop 진행 중.
    • 후속 도그푸딩 사이클.

    참조

    • README.md — quick start + 명령 표.
    • HANDOFF.md — phase 진행도 + 다음 task 후보.
    • docs/ARCHITECTURE.md — 내부 구조 + 의존 그래프.
    • docs/superpowers/specs/2026-04-27-kebab-final-form-design.md — frozen design contract.
    • tasks/HOTFIXES.md — post-merge deviation 로그.
    Downloads