새 crate `kebab-tui` 가 §8 facade rule 따라 `kebab-app` 만 import.
Ratatui 0.28 + crossterm 0.28 기반 shell 이 다음을 제공:

- `App` 구조체: config + focus + library + 3 Option sub-state slot
  (search/ask/inspect — p9-2/3/4 가 자기 모듈에서 채우는 parallel-safety
  contract). p9-1 외에 App 정의 손대지 않음.
- `Pane` enum (Library/Search/Ask/Inspect/Jobs).
- `KeyOutcome` (Continue/Quit/SwitchPane/Refresh).
- `LibraryState` + 내부 inner: docs / list_state / filter / filter_edit /
  needs_refresh / loading / pending_g.
- `render_library` (Frame, area, &App) — heading/body, filter overlay
  toggleable, Korean/wide-char 너비는 unicode-width 로 계산.
- `handle_key_library`: j/k/Down/Up 이동, gg/G 끝, f 필터 overlay,
  /=>Search ?=>Ask Enter=>Inspect, q/Esc 종료. error overlay 가 켜
  있으면 어떤 키든 dismiss.
- 필터 overlay: tags_any (CSV) + lang 두 필드, Tab cycle, Enter
  apply→Refresh, Esc cancel.
- `ErrorOverlay`: anyhow chain 캡쳐 후 popup 렌더 (Clear + 빨간 border).
- 터미널 lifecycle: `TuiTerminal` 가 enter raw mode + alt screen,
  Drop 이 종료 시 (panic 포함) restore — 사용자 쉘 깨지지 않게.
- 비동기 없음: facade 호출은 main thread 동기. v1 의 brief hang 수용.

CLI: `kebab tui` 서브커맨드 추가, --config 받아 App::new + run.

테스트 10건 (`tests/library.rs`, TestBackend 사용):
- 빈 library / 3-doc render / q,Esc quit / / Search 전환 / ? Ask 전환
- Enter 빈 list 무동작 / Enter Inspect 전환 / j 이동 (3-step clamp) /
  f 필터 overlay → 입력 → Enter Refresh.

Test seam: `App::populate_library_for_testing` (#[doc(hidden)]) 가
`pub(crate)` inner 를 우회. spec parallel-safety contract 그대로 유지.

Spec deviation (HOTFIXES `2026-05-02 P9-1`):
- `render_library` 의 `<B: Backend>` generic 제거 — ratatui 0.28 의 Frame
  이 backend-agnostic.
- `populate_library_for_testing` 추가 (test seam, 공식 API 아님).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

@@ -0,0 +11,4 @@
+kebab-core   = { path = "../kebab-core" }
+kebab-config = { path = "../kebab-config" }
+# UI facade rule (design §8): UI crates may only touch `kebab-app`. The
+# search / store / embed / llm / rag layers stay invisible behind it.

@@ -0,0 +61,4 @@
+pub struct AskState;
+
+/// Forward-declared opaque sub-state. p9-4 fills the body.
+pub struct InspectState;

@@ -0,0 +16,4 @@
+pub struct ErrorOverlay {
+    pub title: String,
+    /// Each chain link as a separate line, root-cause last.
+    pub chain: Vec<String>,

@@ -0,0 +195,4 @@
+        .unwrap_or_else(|_| "?".to_string());
+    let updated_short = updated.split('T').next().unwrap_or("?");
+    format!(
+        "{title:<title_w$}  {tags:<12}  {updated_short:<10}  {chunk_count}",

@@ -0,0 +47,4 @@
+                        Pane::Search | Pane::Ask | Pane::Inspect | Pane::Jobs => {
+                            handle_key_library(app, key)
+                        }
+                    };

@@ -0,0 +32,4 @@
+        // propagated them; just log and let the OS recover any
+        // remaining noise.
+        let _ = disable_raw_mode();
+        let _ = execute!(stdout(), LeaveAlternateScreen);

@@ -16,1 +16,4 @@
 
+## 2026-05-02 — P9-1 TUI Library: render_library generic + test seam
+
+**Discovered**: P9-1 implementation start.

@@ -0,0 +195,4 @@
+        .unwrap_or_else(|_| "?".to_string());
+    let updated_short = updated.split('T').next().unwrap_or("?");
+    // `<width$>` is std::fmt's named-arg width form (`title_w` is the
+    // named arg below; `$` says "use it as the padding width"). See

@@ -0,0 +97,4 @@
+            Constraint::Length(1),
+        ])
+        .split(f.area());
+    render_header(f, outer[0], app);

@@ -0,0 +127,4 @@
+        Span::raw(" / "),
+        Span::raw(pane_label),
+    ]);
+    f.render_widget(Paragraph::new(line), area);