Problem
Every clet must be fully operable by keyboard alone — no mouse required, no hidden key combinations, no focus traps. Shell scripts can't use a mouse. AI agents certainly can't. This is a hard correctness requirement, not a nice-to-have.
Beyond correctness, the keybindings must be obvious: discoverable from the UI itself, consistent across clets, and documented in clet help <alias> output. Right now, some clets show their keys; some don't. A user who doesn't already know TG's conventions is guessing.
clet is also a natural integration harness for Terminal.Gui's keyboard handling. Issues found here should be filed upstream in gui-cs/Terminal.Gui — this repo can serve as a reproducible test bed.
Definition of done
Spec: add §6.9 keyboard-nav checklist
A manual (or TUIcast-driven) checklist covering:
Implementation: keybinding visibility
Upstream
Cost
Checklist: half a day to write. Execution: per-release manual (or automated via TUIcast once #BR-7 unblocks the harness). Keybinding docs: per-clet, small.
Originally tracked as #BR-9 in bar-raise backlog issue #11. Refactored from "accessibility test layer missing" — the real requirement is keyboard-completeness and discoverability, not screen-reader support specifically.
Problem
Every clet must be fully operable by keyboard alone — no mouse required, no hidden key combinations, no focus traps. Shell scripts can't use a mouse. AI agents certainly can't. This is a hard correctness requirement, not a nice-to-have.
Beyond correctness, the keybindings must be obvious: discoverable from the UI itself, consistent across clets, and documented in
clet help <alias>output. Right now, some clets show their keys; some don't. A user who doesn't already know TG's conventions is guessing.cletis also a natural integration harness for Terminal.Gui's keyboard handling. Issues found here should be filed upstream ingui-cs/Terminal.Gui— this repo can serve as a reproducible test bed.Definition of done
Spec: add §6.9 keyboard-nav checklist
A manual (or TUIcast-driven) checklist covering:
select,multi-select,attribute-picker,pick-file,pick-directory)confirmandmulti-selectclet rangelow/high fields navigable by Tab, adjusted by arrow keysImplementation: keybinding visibility
--helpoutput documents its non-obvious keybindingsUpstream
gui-cs/Terminal.Guiwith acletreproCost
Checklist: half a day to write. Execution: per-release manual (or automated via TUIcast once #BR-7 unblocks the harness). Keybinding docs: per-clet, small.
Originally tracked as #BR-9 in bar-raise backlog issue #11. Refactored from "accessibility test layer missing" — the real requirement is keyboard-completeness and discoverability, not screen-reader support specifically.