Add visible repeat reader control

Co-authored-by: Codex <codex@openai.com>

FIELD_NOTES.md

@@ -46,7 +46,7 @@ When screen reader mode turns on, the reader cursor starts at the focused articl
 
 Reader shortcuts deliberately ignore form controls. A user can adjust the Kokoro voice, speed slider, and auto-advance checkbox without the page treating those keystrokes as navigation commands.
 
-The reader bar exposes the same shortcut contract through `aria-keyshortcuts`. Escape also has a visible Stop button, which keeps the assistive command model available to pointer users and easy for judges to inspect.
+The reader bar exposes the same shortcut contract through `aria-keyshortcuts`. Repeat and Stop also have visible buttons, which keeps the assistive command model available to pointer users and easy for judges to inspect.
 
 Each narration is also added to a visible transcript log. This gives the demo a second accessible surface: users can review what was spoken, copy the session transcript, or clear it before exploring another part of the article.
 

README.md

@@ -107,7 +107,7 @@ When screen-reader mode turns on, it selects the focused or most visible article
 
 Global reader shortcuts ignore buttons, links, selects, and inputs so the voice, speed, and auto-advance controls remain usable while reader mode is active.
 
-Reader buttons expose `aria-keyshortcuts`, and the Escape shortcut is mirrored by a visible Stop control so pointer and keyboard users share the same command surface.
+Reader buttons expose `aria-keyshortcuts`, and the Repeat and Stop shortcuts are mirrored by visible controls so pointer and keyboard users share the same command surface.
 
 The session panel keeps a transcript of recent narration with copy and clear controls, making the spoken path inspectable during demos and useful for the Field Notes write-up.
 

SUBMISSION.md

@@ -48,7 +48,7 @@ The prototype is designed for a live hackathon demo: every model-facing path has
 
 The checks in `/api/demo-script` include curl and PowerShell-friendly `curl.exe` commands generated from `PUBLIC_BASE_URL`, and the POST checks include sample JSON bodies for `/api/reader-brain` and `/api/speak`.
 
-The accessibility audit also documents reader-mode details that matter during judging: the active item is exposed as a reader cursor with focus, visible outline, stable id, and `aria-current`; global shortcuts ignore form controls so voice, speed, and auto-advance settings remain usable while reader mode is active; reader controls expose `aria-keyshortcuts` and a visible Stop command for Escape.
+The accessibility audit also documents reader-mode details that matter during judging: the active item is exposed as a reader cursor with focus, visible outline, stable id, and `aria-current`; global shortcuts ignore form controls so voice, speed, and auto-advance settings remain usable while reader mode is active; reader controls expose `aria-keyshortcuts` plus visible Repeat and Stop commands.
 
 The image receipts keep the generated-asset claim inspectable: each article illustration names the planned `black-forest-labs/FLUX.2-klein-4B` path, prompt, seed, and bundled fallback asset.
 

app.py

@@ -421,7 +421,7 @@ def accessibility_audit_core() -> dict[str, Any]:
             "id": "keyboard_navigation",
             "label": "Keyboard navigation",
             "status": "pass",
-            "evidence": "Reader controls expose Space, N, P, H, I, S, R, and Esc shortcuts through the manifest and aria-keyshortcuts.",
+            "evidence": "Reader controls expose Space, N, P, H, I, S, R, and Esc shortcuts through the manifest, visible buttons, and aria-keyshortcuts.",
         },
         {
             "id": "reader_cursor",

scripts/verify.py

@@ -37,9 +37,10 @@ def verify_static_assets() -> None:
     assert_true('data-reader-type="heading"' in index_html, "Article should mark heading reader nodes")
     assert_true('data-reader-type="image"' in index_html, "Article should mark image reader nodes")
     assert_true('aria-live="polite"' in index_html, "Article should expose an aria-live narration region")
-    for shortcut in ['aria-keyshortcuts="Space"', 'aria-keyshortcuts="N"', 'aria-keyshortcuts="S"']:
+    for shortcut in ['aria-keyshortcuts="Space"', 'aria-keyshortcuts="N"', 'aria-keyshortcuts="R"', 'aria-keyshortcuts="S"']:
         assert_true(shortcut in index_html, f"Reader controls should expose {shortcut}")
     assert_true("transcriptLog" in index_html, "Article should expose a visible transcript log")
+    assert_true("repeatButton" in index_html, "Reader controls should expose a visible repeat command")
     assert_true("stopButton" in index_html, "Reader controls should expose a visible stop command")
     assert_true("demoScriptList" in index_html, "Article should expose the judge demo runbook")
     assert_true("demoApiCheckList" in index_html, "Article should expose judge API evidence checks")
@@ -58,6 +59,7 @@ def verify_static_assets() -> None:
     )
     assert_true("aria-current" in app_js, "Reader mode should expose the active item as current")
     assert_true("shouldHandleReaderShortcut" in app_js, "Reader shortcuts should not hijack form controls")
+    assert_true("controls.repeat.click()" in app_js, "R should route through the visible repeat command")
     assert_true("controls.stop.click()" in app_js, "Escape should route through the visible stop command")
     assert_true("reader-node-" in app_js, "Reader nodes should receive stable ids for control context")
     assert_true("narrate(node.index)" in app_js, "Reader mode should support click-to-read article items")

static/app.js

@@ -38,6 +38,7 @@ const controls = {
   heading: document.querySelector("#headingButton"),
   image: document.querySelector("#imageButton"),
   summary: document.querySelector("#summaryButton"),
+  repeat: document.querySelector("#repeatButton"),
   stop: document.querySelector("#stopButton"),
 };
 
@@ -670,12 +671,21 @@ function nextByType(type) {
   liveNarration.textContent = `No ${readerTypeLabel(type).toLowerCase()} items in this article.`;
 }
 
+function repeatCurrentItem() {
+  if (currentIndex >= 0) {
+    narrate(currentIndex);
+  } else {
+    liveNarration.textContent = "No reader item selected.";
+  }
+}
+
 toggle.addEventListener("click", () => setEnabled(!enabled));
 controls.next.addEventListener("click", () => narrate(Math.min(currentIndex + 1, nodes.length - 1)));
 controls.prev.addEventListener("click", () => narrate(Math.max(currentIndex - 1, 0)));
 controls.heading.addEventListener("click", () => nextByType("heading"));
 controls.image.addEventListener("click", () => nextByType("image"));
 controls.summary.addEventListener("click", () => summarizeCurrentSection());
+controls.repeat.addEventListener("click", () => repeatCurrentItem());
 controls.stop.addEventListener("click", () => {
   stopAudio();
   liveNarration.textContent = "Reading stopped.";
@@ -776,6 +786,6 @@ document.addEventListener("keydown", (event) => {
   if (key === "h") controls.heading.click();
   if (key === "i") controls.image.click();
   if (key === "s") controls.summary.click();
-  if (key === "r" && currentIndex >= 0) narrate(currentIndex);
+  if (key === "r") controls.repeat.click();
   if (key === "escape") controls.stop.click();
 });

static/index.html

@@ -163,6 +163,7 @@
       <button id="headingButton" type="button" title="Next heading" aria-keyshortcuts="H">Heading</button>
       <button id="imageButton" type="button" title="Next image" aria-keyshortcuts="I">Image</button>
       <button id="summaryButton" type="button" title="Summarize current section" aria-keyshortcuts="S">Summary</button>
+      <button id="repeatButton" type="button" title="Repeat current item" aria-keyshortcuts="R">Repeat</button>
       <button id="stopButton" type="button" title="Stop audio" aria-keyshortcuts="Escape">Stop</button>
       <label>
         Voice