This file records the manual screen-reader acceptance check for release readiness. Automated tests cover focus policy, labels, localisation, and review state logic, but they cannot verify actual screen-reader speech.

Target Environment

• Platform: Windows 11 25H2, AMD64, build 26200.8457
• Screen reader: NVDA 2026.1.1 (2026.1.1.55980)
• Application revision: current tip at the time of each release readiness check
• Latest recorded manual validation: 2026-05-26
• Languages checked: English, Spanish, and Galician
• Input method: keyboard only
• Usage basis: daily screen-reader use, plus focused checks of newer workflows

Current Pre-Release Manual Check

The current release-candidate workflows have received a focused Windows/NVDA check in the maintained languages where practical. The manual release checklist has been completed for this pass:

• timed exam setup, timeout and exam-finished notices, progress tones, grading/review, and summary
• quiz setup, question choices, delayed answer review, and summary
• reorganised File, Deck, Card, Study, Tools, View, and Help menus
• sectioned learning dashboard, Copy to Clipboard, and Save Report
• Tools -> Generate Audio availability after metadata edits and when audio_generation=disabled protects a manual-audio deck
• full deck export, full deck backup, and export with study history dialogues

Accepted Behaviour

Screen Reader and Keyboard

• On startup, focus lands on the ready-screen summary.
• The ready-screen summary reports deck size, scheduled cards, minimum session size, and the review database path.
• If minimum-fill cards are included, the ready-screen summary reports the due count in parentheses after the scheduled count.
• The prompt list is reachable from the keyboard and supports arrow-key navigation.
• Ready-list filtering and sorting remain reachable without trapping focus.
• Ready-list filtering, sorting, card editing, and reverse-card changes keep the same card selected when that card remains visible; adding a card selects the newly added card; deleting a card selects the next visible card in the current list order.
• Pressing Alt+Enter on a selected prompt-list item opens the card details dialogue.
• Alt-S starts a scheduled session from the ready screen in English.
• Alt-M starts a scheduled session from the ready screen in Spanish.
• Alt-T starts an unscheduled full-deck session from the ready screen in English.
• Alt-F starts an unscheduled full-deck session from the ready screen in Spanish.
• Alt-Q quits from the ready screen in English.
• Alt-S quits from the ready screen in Spanish.
• Alt-A opens the add-card dialogue in English.
• Alt-D opens the add-card dialogue in Spanish.
• Alt-E opens the edit-card dialogue for the selected card.
• Delete opens removal for the selected card when focus is in the prompt list.
• Ctrl-F flags or unflags the selected prompt-list card, and flags or unflags the current card during review.
• The prompt-list context menu and Card menu expose Flag/Unflag for the selected card, and review exposes a tabbable Flag/Unflag button after the confidence and recall rating buttons.
• Add, edit, remove, options, and statistics dialogues expose usable labels, focus order, and keyboard paths.
• Pressing Enter accepts the options dialogue when appropriate.
• Pressing Enter activates Continue on the statistics dialogue.
• During review, prompt text is focusable before the pre-response rating.
• Number keys 1 through 4 activate the pre-response rating controls.
• Space activates Reveal Response and skips the pre-response rating.
• Response text is focusable before the recall feedback rating.
• Number keys 1 through 4 activate the recall feedback controls.
• e opens the edit-card dialogue after the response is revealed, and focus returns to the previously focused post-response control afterwards.
• 0 ends the current session early from either rating phase.
• After Continue from session statistics, focus returns to the prompt list.
• English, Spanish, and Galician UI strings are understandable and retain the expected keyboard paths.
• Deck -> Edit Deck Metadata remains usable with a screen reader, including deck metadata fields, prompt and response voice fields, and voice engine selection.
• Tools -> Generate Audio is disabled when required deck voice metadata is absent or when the deck is marked as manual audio, becomes available after complete metadata is saved and generation is allowed, and exposes a progress bar that NVDA can track without verbose repeated status text.
• The ready-list Play/Stop Audio control and Ctrl+P preview the selected card's prompt and response audio and remain usable with keyboard and screen reader.

Sighted Low-Vision Use

The visual-accessibility pass should be checked with the application in both ordinary light/dark Windows themes and Windows high contrast themes. Cosimo should keep native widget colours rather than hard-coded foreground or background colours, so system contrast settings remain in control.

• Text, list, and review controls should remain legible at the default Windows text scale and at increased text scale.
• The prompt and response areas should be close enough together during review that a magnifier user does not need excessive vertical navigation between the active question, response, and rating controls.
• Rating controls should be grouped in a compact grid with stable tab order: 0, 1, 2, 3, 4, then the secondary review actions.
• On a maximised window, rating controls should remain clustered rather than stretching across the whole display, so a magnifier user does not need to scan from the far left to the far right to find related actions.
• Review buttons should have larger hit targets and should not rely on colour alone to communicate meaning.
• Main-window controls should remain usable when the window is maximised and when inspected through a screen magnifier.
• The ready-screen top status line should remain short enough to fit ordinary window widths; longer review database details belong in the ready summary.
• Statistics, card details, and learning dashboard dialogues should use the same larger report text and button targets while retaining native colours.

Accepted Known Issue

When tabbing or shift-tabbing into the ready-screen prompt list, NVDA may announce the selected item twice. Arrow-key navigation inside the list, selection, editing, removal, and review startup remain functional. This is accepted as a native list-control announcement defect rather than a blocker.

When the ready-screen prompt list is empty, NVDA may announce the list as "unknown" rather than reporting that it has no items. The empty list remains reachable and focusable; the ready summary and filter counts are the reliable way to confirm that the current filter has no cards. This is accepted as a native list-control announcement defect rather than a blocker.

Release Rule

Any regression in keyboard-only operation, focus order, accessible naming, dialogue acceptance, rating shortcuts, or the accepted screen-reader flow should block release until fixed or explicitly recorded here as an accepted known issue. New language flows should receive the same manual check before release.