Make terminal accessibility feedback and key help independently discoverable #18

New issue

Open

opened 2026-09-08 09:17:23 +00:00 by phg · 0 comments

phg commented

2026-09-08 09:17:23 +00:00

Owner

Context

Accessibility audit from #10 found that state wording in the table and message rail is generally independent of color, but the application has no tested accessibility contract for transient feedback or a complete in-app keyboard reference. The terminal and Textual stack also cannot currently guarantee screen-reader announcements.

Acceptance criteria

The in-app help surface exposes every reachable application shortcut and identifies modal-specific shortcuts where the modal provides them.
Success, warning, failure, progress, and persistent safety feedback have textual wording that remains meaningful with color and symbols unavailable.
Tests cover the wording for one representative result in each feedback category and assert that Help lists all application bindings.
Documentation distinguishes the supported 256-color keyboard-first baseline from unsupported screen-reader announcement guarantees.
mise run check passes.

Context Accessibility audit from #10 found that state wording in the table and message rail is generally independent of color, but the application has no tested accessibility contract for transient feedback or a complete in-app keyboard reference. The terminal and Textual stack also cannot currently guarantee screen-reader announcements. Acceptance criteria - The in-app help surface exposes every reachable application shortcut and identifies modal-specific shortcuts where the modal provides them. - Success, warning, failure, progress, and persistent safety feedback have textual wording that remains meaningful with color and symbols unavailable. - Tests cover the wording for one representative result in each feedback category and assert that Help lists all application bindings. - Documentation distinguishes the supported 256-color keyboard-first baseline from unsupported screen-reader announcement guarantees. - `mise run check` passes.