altair823
d2944de754
Plan task 6 follow-up flip — separate one-line commit so spec history reflects reality. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
64 lines
2.0 KiB
Markdown
64 lines
2.0 KiB
Markdown
---
|
|
phase: P9
|
|
component: kebab-tui
|
|
task_id: p9-fb-03
|
|
title: "TUI ingest as background worker + status bar"
|
|
status: completed
|
|
depends_on: [p9-fb-01]
|
|
unblocks: []
|
|
contract_source: ../../docs/superpowers/specs/2026-04-27-kebab-final-form-design.md
|
|
contract_sections: [§7 ingest, §10 UX]
|
|
source_feedback: p9-dogfooding-feedback.md item 1
|
|
---
|
|
|
|
# p9-fb-03 — TUI ingest background + status bar
|
|
|
|
## Goal
|
|
|
|
TUI 에서 `:ingest` (또는 `r` 키) 누르면 ingest 가 background thread 에서 돌고, status bar 가 progress 그리기. blocking 하지 않음.
|
|
|
|
## Allowed dependencies
|
|
|
|
- 기존 kebab-tui deps (ratatui, crossterm, kebab-app, kebab-config).
|
|
- 신규 X.
|
|
|
|
## Public surface
|
|
|
|
`kebab-tui::App` 에 `ingest_state: Option<IngestState>` slot. p9-3/4 와 동일 parallel-safe pattern.
|
|
|
|
```rust
|
|
pub(crate) struct IngestState {
|
|
rx: Receiver<IngestEvent>,
|
|
counts: AggregateCounts,
|
|
current_path: Option<String>,
|
|
started_at: Instant,
|
|
cancel_tx: Sender<()>, // p9-fb-04 와 wiring
|
|
}
|
|
```
|
|
|
|
## Behavior contract
|
|
|
|
- ingest worker thread 는 `kebab_app::ingest_with_config_progress(cfg, scope, false, Some(tx))` 호출.
|
|
- main loop 가 매 frame 마다 `rx.try_recv()` drain → counts 갱신 + status bar 라인 갱신.
|
|
- status bar 위치: 화면 하단 1 줄. 형식: `ingest: 142/1024 (14%) parsing notes/foo.md [0:42]`.
|
|
- 완료/abort 시 status bar 가 final line (`✓ ingest: 1024 docs, 4521 chunks, 12.3s` 또는 `✗ aborted at 142/1024`) 잠시 유지 후 자동 hide.
|
|
- ingest 중 다른 pane 이동 자유 — Library / Search 등은 그대로 동작 (DB 는 read 가능, partial 결과 surface).
|
|
|
|
## Test plan
|
|
|
|
| kind | description |
|
|
|------|-------------|
|
|
| unit | IngestState event drain 이 counts 누적 |
|
|
| integration | TUI run-loop 모의 + IngestEvent stream → status line 텍스트 snapshot |
|
|
|
|
## DoD
|
|
|
|
- [ ] `cargo test -p kebab-tui` 통과
|
|
- [ ] README TUI 절에 background ingest + status bar 동작 명시
|
|
- [ ] 키 cheatsheet 에 `r` (refresh/ingest) 추가
|
|
|
|
## Out of scope
|
|
|
|
- desktop (P9-5) progress 표시
|
|
- ingest cancel UI (p9-fb-04)
|