SubMiner/backlog/tasks/task-26 - Add-session-help-modal-with-dynamic-keybinding-color-legend-and-keyboard-mouse-navigation.md

id, title, status, assignee, created_date, labels, dependencies, priority

id	title	status	assignee	created_date	labels	dependencies	priority
TASK-26	Add session help modal with dynamic keybinding/color legend and keyboard/mouse navigation	To Do		2026-02-13 16:49			high

Description

Create a help modal that auto-generates its content from the project/app layout and current configuration, showing the active keybindings and color keys for the current session in a presentable way. The modal should be navigable with arrow keys and Vim-style hjkl-style movement behavior internally but without labeling hjkl in UI, and support mouse interaction. Escape closes/goes back. Open the modal with y-h, and if that binding is already taken, use y-k as fallback.

Acceptance Criteria

• #1 Help modal content is generated automatically from current keybinding config and project/app layout rather than hardcoded static text.
• #2 Modal displays current session keybindings and active color-key mappings in a clear, grouped layout with section separation for readability.
• #3 Modal can be opened with y-h when available; if y-h is already bound, modal opens with y-k instead.
• #4 Close behavior: Escape exits the modal and returns to previous focus/state.
• #5 Modal supports mouse-based interaction for standard focus/selection actions.
• #6 Navigation inside modal supports arrow keys for movement between focusable items.
• #7 Modal supports internal navigation semantics equivalent to hjkl directional movement for users, while UI text/labels do not mention hjkl keys.
• #8 No visible UI mention of Vim key names is shown in modal labels/help copy.
• #9 Modal opens from current session without requiring a restart and reflects updated config changes without code changes.
• #10 If the shortcut is unavailable due to conflicts, user-visible fallback behavior/error is deterministic and documented.

Definition of Done

• #1 Auto-generated help modal displays up-to-date keybinding + color mapping data and supports both keyboard (arrow/fallback path) and mouse navigation with Escape-to-close.