Audit date: 2026-04-28
Scope: Kalika notebook workbench, including the research shell, notebook outline, cell inspector, command palette, LaTeX/math rendering, expression explorer, canvas workspace, minimap, explicit dataflow controls, high-contrast theme, reduced motion, reading font, and responsive mobile layout.
Phase 113 Final Compliance Pass#
e2e/phase-113-accessibility-compliance.spec.tsis the final Phase 113.9.1.4 gate. It inventories the primary Kalika workbench surfaces and verifies WCAG 2.1 AA coverage for the default shell, command palette, research assistant, LaTeX/math editor, plotting surface, canvas/dataflow workspace, paper generation, citations, diagrams, share links, collaboration, and knowledge graph browser.- The audit checks every visible interactive control in the workbench for a computed accessible name, keyboard focusability, and assistive-technology exposure. It samples visible focus indicators across linear and canvas modes so controls do not depend on sighted pointer interaction.
- Screen-reader math coverage uses Playwright ARIA snapshots for the live LaTeX preview, asserting that the browser accessibility tree exposes the spoken integral label, MathML-backed math node, expression explorer, plain language alternative, and Nemeth/UEB Braille alternatives.
- Keyboard-only coverage exercises command palette search, notebook outline selection, math palette open/close, math alternatives, research assistant open/close, canvas dataflow port connection, and workflow execution.
- The pass fixed two defects surfaced by the audit: default-theme muted metadata contrast on research-assistant and math-palette text, and canvas node keyboard bubbling that previously prevented focused child port buttons from receiving Enter activation.
Automated Coverage#
e2e/accessibility-audit.spec.tsruns axe-core with WCAG 2.1 A/AA tags against the default shell, math cell, command palette, canvas/dataflow workspace, and high-contrast mobile preference state.e2e/phase-113-accessibility-compliance.spec.tsruns the expanded final audit described above, including visible-control inventory, focus affordance sampling, ARIA snapshot math signoff, and keyboard-only operation coverage.- The same spec runs Pa11y against the core accessibility controls with both
HTML_CodeSniffer and axe runners at
WCAG2AAafter applying high contrast, extra-large math/code text, and reduced motion. - Screen-reader contracts are asserted in Playwright for math output:
aria-label,aria-live,role="application", MathJax-backed accessible rendering, spoken descriptions, expression explorer focus navigation, simple language alternatives, and Nemeth Braille output. - Keyboard-only coverage verifies stage navigation, edit-mode entry/exit, command palette dialog semantics, combobox focus, and dataflow controls.
- Layout coverage verifies the high-contrast mobile viewport does not create horizontal overflow.
Native Screen-Reader Checklist#
Native screen-reader execution is not available in this Linux Codex/CI environment, so VoiceOver and NVDA cannot be launched directly here. Before a release signoff, run the following manual checks on the named operating systems:
- VoiceOver on macOS Safari and Chrome:
- Navigate the notebook outline, stage, command palette, and inspector using only keyboard plus VoiceOver commands.
- Confirm the LaTeX preview announces the spoken math description and the expression explorer updates from integral to bounds, function, variable, and result.
- Confirm simple-language and Nemeth Braille alternatives are reachable and announced as toggled controls.
- NVDA on Windows Chrome and Firefox:
- Repeat the notebook outline, stage, command palette, and inspector navigation pass.
- Confirm MathJax-backed math output is exposed through the accessibility tree without duplicate decorative MathML announcements.
- Confirm canvas nodes, ports, minimap, and dataflow connection summaries remain discoverable without pointer input.
- High-contrast and reduced-motion pass:
- Enable the Kalika high-contrast theme, extra-large math/code text, reading font, and reduced motion.
- Confirm active controls preserve clear focus indication and readable text.
- Confirm no interactive control is skipped, trapped, or announced without a usable name.
Current Result#
The automated WCAG 2.1 AA gate is enforced by the Kalika Playwright E2E suite. Native VoiceOver/NVDA validation is documented above as a platform-bound manual release check because those OS assistive technologies are unavailable in the current Linux automation environment.