Repository navigation
Description
Parent
#34 — the Obelus v1.2 spec (docs/specs/obelus-v1.2.md). Covers stories 185–187.
Blocked by #35 — the Band control is the tablist this ticket wires up.
What to build
Three defects, all on the rail.
No tab-panel linkage. src/App.tsx renders role="tablist" with tabs carrying aria-selected,
but no panel has role="tabpanel", and there is no aria-controls / id pairing. After #35 the
Band control is the tablist; wire it properly.
Nothing is announced. A Run finishing, a Run failing and a Judge Verdict arriving all change the
screen silently. A Writer using a screen reader is left waiting on a spinner they cannot see. Add one
polite aria-live region and route those three events through it.
Contrast and size. Disabled Pass names use text-stone-400 on the rail's stone-100/60 — about
2.3:1, against a 4.5:1 minimum. Cost estimates are text-[11px] and held badges text-[10px]. Raise
both. Keep disabled Passes visibly distinct from enabled ones — the fix is legibility, not sameness.
Where
src/App.tsx— the Band control and its panels; the live region.src/editor/ModelPassesPanel.tsx,RulePassesPanel.tsx,JudgePanel.tsx— the announced events
and the two type sizes.- Tailwind classes throughout the rail.
Acceptance criteria
- The Band control is a
tablist; each Band's panel is atabpanelwith matching
aria-controlsandid. (story 185) - A polite
aria-liveregion announces a Run finishing, a Run failing and a Verdict arriving.
(story 186) - Every text/background pair on the rail meets 4.5:1, disabled Pass names included. (story 187)
- No text on the rail is below 12px. (story 187)
- A disabled Pass is still visibly distinguishable from an enabled one.
- Keyboard focus is visible on every control the rail adds, and the Band control is operable by
keyboard alone.
Verification
Compute the contrast ratios and record them in the closing comment — the pairs you changed, before
and after. The ARIA wiring and the announcements are an observable checklist, stated the same way.
No DOM layer. Do not add Testing Library, jsdom or an axe runner; a test layer needs its own ticket
and an ADR — see the spec's Testing Decisions.
Constitution
Unchanged. Nothing here inserts model-derived text. The live region announces that a Run finished; it
does not read model output aloud as advice.
Activity
feat: accessibility: the rail, announcements, contrast (#42)