Feature: TUI Help Panel Overlay Coverage
  Scenarios exercising the context-sensitive help overlay widget.

  Scenario: resolve_help_context detects the active prompt mode
    When I resolve help context for an empty prompt
    Then the resolved help context should be "Main Screen"
    When I resolve help context for prompt text "/persona list"
    Then the resolved help context should be "Slash Commands"
    When I resolve help context for prompt text "inspect @README.md"
    Then the resolved help context should be "Reference Picker"
    When I resolve help context for prompt text "!ls"
    Then the resolved help context should be "Shell Mode"

  Scenario: help panel overlay renders context-specific content
    Given a fresh help panel overlay
    When I show help for context "Main Screen"
    Then the standalone help panel text should contain "Help: Main Screen"
    And the standalone help panel text should contain "ctrl+q"
    And the standalone help panel text should contain "enter"

  Scenario: help panel overlay toggle hides the current context
    Given a fresh help panel overlay
    When I toggle help for context "Slash Commands"
    Then the help panel should be visible
    And the standalone help panel text should contain "Help: Slash Commands"
    When I toggle help for context "Slash Commands"
    Then the help panel should be hidden

  Scenario: help panel Main Screen keybindings match actual app BINDINGS
    Given a fresh help panel overlay
    When I show help for context "Main Screen"
    Then the standalone help panel text should contain "ctrl+t"
    And the standalone help panel text should not contain "ctrl+tab"
    And the standalone help panel text should not contain "tab"

  Scenario: help panel global keybindings match actual app BINDINGS
    Given a fresh help panel overlay
    When I show help for context "Main Screen"
    Then the standalone help panel text should contain "ctrl+q"
    And the standalone help panel text should contain "F1"
