feat(kebab-tui): p9-fb-13 follow-up — verb-form hint line redesign #90

altair823 · 2026-05-03T11:14:54Z

altair823 commented

2026-05-03 11:14:54 +00:00

Summary

p9-fb-13 (cheatsheet) follow-up — closes the deferred verb-form hint line
redesign. spec status in_progress → completed.

pub fn footer_hints(focus: Pane, mode: Mode, filter_open: bool) -> &'static str
신규 (run.rs). 기존 render_footer 의 영문 key=action 형식이 한국어
동사구로 변경 — "위로" / "아래로" / "필터" / "타이핑 검색어" /
"Esc 로 NORMAL 모드" 등 — (pane, mode, filter_open) 조합에 따라 자동
분기. NORMAL 모드는 navigation verbs, INSERT 모드는 typing + Esc
reminder. Library filter overlay 는 overlay-only key 3 개로 override.

Why

p9-fb-13 partial 머지 시 verb-form hint 재구성은 render_footer 가
"동일 역할" 한다는 이유로 follow-up 으로 deferral. 실제로는:

영문 key=action 가 한국어 산문에 어긋남.
mode-aware 가 아니어서 INSERT 사용자에게 Esc 로 NORMAL 모드 안내가
없음 (도그푸딩 핵심 confusion 지점).
INSERT 에서 j/k 가 typed char 인데 hint 가 nav 로 표기 — 잘못된
signal.

Test plan

8 새 unit test (run::footer_hints_tests::*) — 모든 (pane, mode,
filter_open) 조합 non-empty exhaustive + Library Normal/filter,
Search Normal/Insert, Ask Normal/Insert, Inspect Normal 별 verb
fragment 존재 검증.
cargo test -p kebab-tui — 전체 green.
cargo clippy -p kebab-tui --all-targets -- -D warnings — clean.

Spec contract

tasks/p9/p9-fb-13-tui-cheatsheet.md — status: in_progress →
completed, 3 DoD boxes 모두 ticked, follow-up Notes line 추가.
tasks/HOTFIXES.md — "Per-pane hint line redesign" deferred 절
아래에 "Follow-up shipped" 단락 추가.
README.md — kebab tui row 에 한국어 동사구 hint 동작 설명 추가.
HANDOFF.md — 2026-05-03 entry 추가.

Scope discipline

run.rs + lib.rs (re-export) + 4 doc 파일. zero new external deps,
zero changes outside kebab-tui src + tasks/docs.

## Summary p9-fb-13 (cheatsheet) follow-up — closes the deferred verb-form hint line redesign. spec status `in_progress` → `completed`. `pub fn footer_hints(focus: Pane, mode: Mode, filter_open: bool) -> &'static str` 신규 (run.rs). 기존 `render_footer` 의 영문 `key=action` 형식이 한국어 동사구로 변경 — `"위로"` / `"아래로"` / `"필터"` / `"타이핑 검색어"` / `"Esc 로 NORMAL 모드"` 등 — (pane, mode, filter_open) 조합에 따라 자동 분기. NORMAL 모드는 navigation verbs, INSERT 모드는 typing + Esc reminder. Library filter overlay 는 overlay-only key 3 개로 override. ## Why p9-fb-13 partial 머지 시 verb-form hint 재구성은 `render_footer` 가 "동일 역할" 한다는 이유로 follow-up 으로 deferral. 실제로는: - 영문 `key=action` 가 한국어 산문에 어긋남. - mode-aware 가 아니어서 INSERT 사용자에게 `Esc 로 NORMAL 모드` 안내가 없음 (도그푸딩 핵심 confusion 지점). - INSERT 에서 `j/k` 가 typed char 인데 hint 가 nav 로 표기 — 잘못된 signal. ## Test plan - 8 새 unit test (`run::footer_hints_tests::*`) — 모든 (pane, mode, filter_open) 조합 non-empty exhaustive + Library Normal/filter, Search Normal/Insert, Ask Normal/Insert, Inspect Normal 별 verb fragment 존재 검증. - `cargo test -p kebab-tui` — 전체 green. - `cargo clippy -p kebab-tui --all-targets -- -D warnings` — clean. ## Spec contract - `tasks/p9/p9-fb-13-tui-cheatsheet.md` — `status: in_progress` → `completed`, 3 DoD boxes 모두 ticked, follow-up Notes line 추가. - `tasks/HOTFIXES.md` — "Per-pane hint line redesign" deferred 절 아래에 "Follow-up shipped" 단락 추가. - `README.md` — `kebab tui` row 에 한국어 동사구 hint 동작 설명 추가. - `HANDOFF.md` — 2026-05-03 entry 추가. ## Scope discipline `run.rs` + `lib.rs` (re-export) + 4 doc 파일. zero new external deps, zero changes outside kebab-tui src + tasks/docs.

altair823 added 2 commits 2026-05-03 11:15:01 +00:00

chore(p9-fb-10): fill HOTFIXES PR # placeholder → #88 3877d235ec

feat(kebab-tui): p9-fb-13 follow-up — verb-form hint line redesign a48f4be5c3

`pub fn footer_hints(focus: Pane, mode: Mode, filter_open: bool) -> &'static str`
신규 (run.rs). 기존 `render_footer` 의 영문 `key=action` 형식이 한국어
동사구로 — `"위로"` / `"아래로"` / `"필터"` / `"타이핑 검색어"` /
`"Esc 로 NORMAL 모드"` 등 — 변경되고 (pane, mode, filter_open) 조합에
따라 자동 분기. NORMAL 모드는 navigation verbs, INSERT 모드는
typing + Esc reminder. Library filter overlay 는 overlay-only key 3
개로 override.

8 unit tests pin: 모든 (pane, mode, filter) 조합 non-empty exhaustive
+ Library Normal/filter, Search Normal/Insert, Ask Normal/Insert,
Inspect Normal 별 verb fragment 존재 검증.

spec status `in_progress` → `completed` — p9-fb-13 partial 의 deferred
verb-form 항목이 닫힘.

altair823 added 1 commit 2026-05-03 11:17:06 +00:00

review(p9-fb-13-verb-hint): self-correct Search/Ask Esc semantic — '뒤로' not '종료' 9873d9b650

Search/Ask Esc returns to prior pane (back), not quit app. The hint
'Esc 종료' would mislead users into thinking Esc terminates the
session.

claude-reviewer-01 approved these changes 2026-05-03 11:17:47 +00:00

claude-reviewer-01 left a comment

회차 1 — APPROVE.

본 PR 의 핵심 변화 (영문 key=action → 한국어 동사구 + mode-aware + filter overlay 분기) 가 spec 의 deferred 항목을 정확히 닫음.

검토한 항목:

pub fn footer_hints(...) 가 pure fn 으로 추출되어 테스트 가능 — 8 unit test 가 모든 (pane, mode, filter) 조합 exhaustive non-empty + 핵심 verb fragments 의 존재를 pin.
INSERT 모드 hint 가 Esc 로 NORMAL 모드 reminder 를 포함 — 도그푸딩의 핵심 confusion 지점 (사용자가 NORMAL 로 돌아갈 줄 모름) 직접 해결.
Search Insert / Ask Insert 의 NORMAL-only 명령은 괄호 안에 표기 — Insert 에서는 typed char 임을 시각적으로 전달.
Library filter overlay 가 overlay-only key 3 개로 override — overlay 동안 다른 키가 무시됨을 정확히 반영.
Self-correct 1 건: 회차 0 (push 직후) 에 Search/Ask 의 Esc 종료 가 의미상 잘못됨을 발견 — 두 pane 의 Esc 는 실제로는 prior pane 으로 back 이지 quit 이 아님. Esc 뒤로 로 정정 (commit 9873d9b).
모든 hint 문자열에 한국어 산문 + ASCII 키 식별자 inline 패턴 — 프로젝트 작성 규칙 일관.
spec contract: status flip + DoD 3 box ticked + Notes 추가만, frozen 계약 unchanged.
HOTFIXES 의 "deferred" 절 아래 "Follow-up shipped" 단락이 link.

본 PR scope 내에서 추가 actionable 없음. 머지 OK.

회차 1 — APPROVE. 본 PR 의 핵심 변화 (영문 `key=action` → 한국어 동사구 + mode-aware + filter overlay 분기) 가 spec 의 deferred 항목을 정확히 닫음. **검토한 항목**: - `pub fn footer_hints(...)` 가 pure fn 으로 추출되어 테스트 가능 — 8 unit test 가 모든 (pane, mode, filter) 조합 exhaustive non-empty + 핵심 verb fragments 의 존재를 pin. - INSERT 모드 hint 가 `Esc 로 NORMAL 모드` reminder 를 포함 — 도그푸딩의 핵심 confusion 지점 (사용자가 NORMAL 로 돌아갈 줄 모름) 직접 해결. - Search Insert / Ask Insert 의 NORMAL-only 명령은 괄호 안에 표기 — Insert 에서는 typed char 임을 시각적으로 전달. - Library filter overlay 가 overlay-only key 3 개로 override — overlay 동안 다른 키가 무시됨을 정확히 반영. - Self-correct 1 건: 회차 0 (push 직후) 에 Search/Ask 의 `Esc 종료` 가 의미상 잘못됨을 발견 — 두 pane 의 Esc 는 실제로는 prior pane 으로 back 이지 quit 이 아님. `Esc 뒤로` 로 정정 (commit `9873d9b`). - 모든 hint 문자열에 한국어 산문 + ASCII 키 식별자 inline 패턴 — 프로젝트 작성 규칙 일관. - spec contract: status flip + DoD 3 box ticked + Notes 추가만, frozen 계약 unchanged. - HOTFIXES 의 "deferred" 절 아래 "Follow-up shipped" 단락이 link. 본 PR scope 내에서 추가 actionable 없음. 머지 OK.

altair823 merged commit 14dce12e4c into main

2026-05-03 12:30:44 +00:00

altair823 referenced this issue from a commit

2026-05-03 12:30:45 +00:00

Merge pull request 'feat(kebab-tui): p9-fb-13 follow-up — verb-form hint line redesign' (#90) from feat/p9-fb-13-verb-hint into main

altair823 deleted branch feat/p9-fb-13-verb-hint

2026-05-03 12:31:02 +00:00

Sign in to join this conversation.

2 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: altair823-org/kebab#90