Add curl commands to demo checks

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

FIELD_NOTES.md

@@ -28,7 +28,7 @@ The app exposes the same budget through `/api/model-budget`, including numeric `
 
 Runtime setup is also data-backed. `/api/runtime-setup` lists the app command, llama.cpp launch command, model-specific runtime paths, environment values, and fallbacks. The session panel renders a compact version so the demo can distinguish real model wiring from deterministic safety nets.
 
-The judge runbook lives at `/api/demo-script` and is rendered in the session panel with its API evidence checks. It keeps the live presentation repeatable by pairing visible actions with API checks for health, model budget, runtime setup, runtime status, image descriptions, reader narration, and speech.
+The judge runbook lives at `/api/demo-script` and is rendered in the session panel with its API evidence checks. It keeps the live presentation repeatable by pairing visible actions with API checks for health, model budget, runtime setup, runtime status, image descriptions, reader narration, and speech. Each API check includes a curl command for quick reproduction.
 
 Submission readiness lives at `/api/submission-readiness`. It aggregates the demo-critical checks into one payload: model budget, award evidence, custom frontend assets, runtime setup, accessibility audit, image receipts, and executable demo API checks. POST checks must include sample bodies before readiness passes.
 

README.md

@@ -75,7 +75,7 @@ The verifier checks syntax, static assets, Space metadata consistency, determini
 
 `/api/runtime-setup` exposes the commands, environment values, and fallback paths used for the model stack so the demo can be reproduced from the same data the UI displays.
 
-`/api/demo-script` exposes a compact judge runbook with the visible actions and API checks that prove the submission claims. The session panel renders those actions and API evidence checks as the Judge Runbook.
+`/api/demo-script` exposes a compact judge runbook with the visible actions, API checks, sample bodies, and curl commands that prove the submission claims. The session panel renders those actions and API evidence checks as the Judge Runbook.
 
 `/api/accessibility-audit` exposes structured evidence for semantic reading order, keyboard navigation, reader cursor state, shortcut safety, live narration, image alt text, transcript review, user-controlled playback, and fallback resilience.
 

SUBMISSION.md

@@ -46,7 +46,7 @@ The prototype is designed for a live hackathon demo: every model-facing path has
 - `/api/submission-readiness`: one pass/fail rollup for model budget, award evidence, custom frontend, runtime setup, accessibility, image receipts, and demo API checks.
 - `/api/evidence-bundle`: copyable JSON bundle containing the core judge evidence receipts.
 
-The POST checks in `/api/demo-script` include sample JSON bodies for `/api/reader-brain` and `/api/speak`.
+The checks in `/api/demo-script` include curl commands, and the POST checks include sample JSON bodies for `/api/reader-brain` and `/api/speak`.
 
 The accessibility audit also documents two 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.
 

app.py

@@ -213,7 +213,48 @@ def runtime_setup_core() -> dict[str, Any]:
     }
 
 
+def demo_curl_command(check: dict[str, Any]) -> str:
+    url = f"http://localhost:7860{check['path']}"
+    if check["method"] == "GET":
+        return f"curl {url}"
+    sample_body = json.dumps(check["sample_body"], separators=(",", ":"))
+    return f"curl -X POST {url} -H \"Content-Type: application/json\" -d '{sample_body}'"
+
+
 def demo_script_core() -> dict[str, Any]:
+    api_checks = [
+        {"method": "GET", "path": "/api/health", "expect": "custom Gradio Server app and model manifest"},
+        {"method": "GET", "path": "/api/model-budget", "expect": "all_models_within_limit is true"},
+        {"method": "GET", "path": "/api/runtime-setup", "expect": "llama.cpp, Kokoro, vision, and image paths"},
+        {"method": "GET", "path": "/api/runtime-status", "expect": "online or fallback-ready runtime labels"},
+        {"method": "GET", "path": "/api/accessibility-audit", "expect": "all reader-mode checks pass"},
+        {"method": "GET", "path": "/api/image-descriptions", "expect": "three article image descriptions"},
+        {"method": "GET", "path": "/api/submission-readiness", "expect": "all submission readiness checks pass"},
+        {
+            "method": "POST",
+            "path": "/api/reader-brain",
+            "expect": "concise narration or fallback narration",
+            "sample_body": {
+                "node_type": "heading",
+                "text": "The model map",
+                "position": "item 4 of 10",
+                "mode": "narrate",
+            },
+        },
+        {
+            "method": "POST",
+            "path": "/api/speak",
+            "expect": "Kokoro audio or audible browser fallback path",
+            "sample_body": {
+                "text": "Heading. The model map.",
+                "voice": READER_SETTINGS["default_voice"],
+                "speed": READER_SETTINGS["default_speed"],
+            },
+        },
+    ]
+    for check in api_checks:
+        check["curl"] = demo_curl_command(check)
+
     return {
         "ok": True,
         "title": "Tiny Narrator judge demo",
@@ -245,36 +286,7 @@ def demo_script_core() -> dict[str, Any]:
                 "evidence": "Tiny Titan, Llama Champion, Off-Brand, and Field Notes evidence is visible.",
             },
         ],
-        "api_checks": [
-            {"method": "GET", "path": "/api/health", "expect": "custom Gradio Server app and model manifest"},
-            {"method": "GET", "path": "/api/model-budget", "expect": "all_models_within_limit is true"},
-            {"method": "GET", "path": "/api/runtime-setup", "expect": "llama.cpp, Kokoro, vision, and image paths"},
-            {"method": "GET", "path": "/api/runtime-status", "expect": "online or fallback-ready runtime labels"},
-            {"method": "GET", "path": "/api/accessibility-audit", "expect": "all reader-mode checks pass"},
-            {"method": "GET", "path": "/api/image-descriptions", "expect": "three article image descriptions"},
-            {"method": "GET", "path": "/api/submission-readiness", "expect": "all submission readiness checks pass"},
-            {
-                "method": "POST",
-                "path": "/api/reader-brain",
-                "expect": "concise narration or fallback narration",
-                "sample_body": {
-                    "node_type": "heading",
-                    "text": "The model map",
-                    "position": "item 4 of 10",
-                    "mode": "narrate",
-                },
-            },
-            {
-                "method": "POST",
-                "path": "/api/speak",
-                "expect": "Kokoro audio or audible browser fallback path",
-                "sample_body": {
-                    "text": "Heading. The model map.",
-                    "voice": READER_SETTINGS["default_voice"],
-                    "speed": READER_SETTINGS["default_speed"],
-                },
-            },
-        ],
+        "api_checks": api_checks,
     }
 
 

scripts/verify.py

@@ -45,6 +45,7 @@ def verify_static_assets() -> None:
     assert_true("copyEvidenceButton" in index_html, "Article should expose a copyable evidence bundle button")
     assert_true("loadDemoScript" in app_js, "Frontend should render the structured demo script")
     assert_true("payload.api_checks" in app_js, "Frontend should render structured demo API checks")
+    assert_true("demo-api-command" in app_js, "Frontend should render copyable demo commands")
     assert_true("/api/evidence-bundle" in app_js, "Frontend should fetch the evidence bundle for copying")
     assert_true("function haltPlayback" in app_js, "Reader controls should expose a shared playback halt helper")
     assert_true(
@@ -344,6 +345,14 @@ def verify_routes() -> None:
         all(item.get("sample_body") for item in demo_payload["api_checks"] if item["method"] == "POST"),
         "Every POST demo check should include an executable sample body",
     )
+    assert_true(
+        all(item["curl"].startswith("curl ") for item in demo_payload["api_checks"]),
+        "Every demo API check should include a curl command",
+    )
+    assert_true(
+        "-d '" in reader_check["curl"] and "/api/reader-brain" in reader_check["curl"],
+        "Reader-brain curl command should include the sample JSON body",
+    )
     reader_sample = client.post(reader_check["path"], json=reader_check["sample_body"])
     assert_true(reader_sample.status_code == 200, "Reader-brain sample payload should be executable")
     reader_sample_payload = reader_sample.json()

static/app.css

@@ -465,6 +465,16 @@ dd {
   font-size: 0.78rem;
 }
 
+.demo-api-command {
+  grid-column: 1 / -1;
+  display: block;
+  padding: 8px;
+  border-radius: 6px;
+  background: #f7f3ee;
+  color: var(--ink);
+  white-space: normal;
+}
+
 .budget-list {
   display: grid;
   gap: 8px;

static/app.js

@@ -252,6 +252,7 @@ async function loadDemoScript() {
           <span>${escapeHtml(item.method)}</span>
           <code>${escapeHtml(item.path)}</code>
           <p>${escapeHtml(item.expect)}${item.sample_body ? " Sample body included." : ""}</p>
+          <code class="demo-api-command">${escapeHtml(item.curl)}</code>
         </li>
       `)
       .join("");