Add runtime status to readiness checks

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

FIELD_NOTES.md

@@ -30,7 +30,7 @@ Runtime setup is also data-backed. `/api/runtime-setup` lists the app command, l
 
 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 copyable curl and PowerShell-friendly `curl.exe` commands for quick reproduction. Deployed demos can set `PUBLIC_BASE_URL` so those commands point at the public Space instead of localhost.
 
-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, executable demo API checks, and command base URL checks. POST checks must include sample bodies before readiness passes.
+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, runtime status, accessibility audit, image receipts, executable demo API checks, and command base URL checks. POST checks must include sample bodies before readiness passes.
 
 The copyable judge evidence bundle lives at `/api/evidence-bundle`. The session panel's Copy Evidence button uses that endpoint to put the core receipts, including `PUBLIC_BASE_URL`, runtime status, and readiness, on the clipboard as formatted JSON.
 

README.md

@@ -82,7 +82,7 @@ The verifier checks syntax, static assets, Space metadata consistency, determini
 
 `/api/image-descriptions` includes image-generation provenance for every article illustration: the planned FLUX.2 klein model, prompt, seed, bundled asset URL, and fallback-ready status.
 
-`/api/submission-readiness` aggregates the judging receipts into one pass/fail payload covering model budget, award evidence, custom frontend assets, runtime setup, accessibility, image receipts, demo API checks, and command base URL checks.
+`/api/submission-readiness` aggregates the judging receipts into one pass/fail payload covering model budget, award evidence, custom frontend assets, runtime setup, runtime status, accessibility, image receipts, demo API checks, and command base URL checks.
 
 The readiness rollup only passes the demo API check when POST entries include executable sample bodies.
 

SUBMISSION.md

@@ -43,7 +43,7 @@ The prototype is designed for a live hackathon demo: every model-facing path has
 - `/api/accessibility-audit`: semantic queue, keyboard navigation, reader cursor state, shortcut safety, live narration, alt text, transcript, user control, and fallback evidence.
 - `/api/demo-script`: repeatable judge runbook and API checks.
 - `/api/image-descriptions`: generated article image descriptions plus prompt, seed, model, asset URL, and fallback status receipts.
-- `/api/submission-readiness`: one pass/fail rollup for model budget, award evidence, custom frontend, runtime setup, accessibility, image receipts, and demo API checks.
+- `/api/submission-readiness`: one pass/fail rollup for model budget, award evidence, custom frontend, runtime setup, runtime status, accessibility, image receipts, and demo API checks.
 - `/api/evidence-bundle`: copyable JSON bundle containing the core judge evidence receipts, runtime status, and readiness rollup.
 
 The checks in `/api/demo-script` include copyable 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`.

app.py

@@ -304,6 +304,7 @@ def demo_script_core() -> dict[str, Any]:
 def submission_readiness_core() -> dict[str, Any]:
     model_budget = model_budget_core()
     runtime_setup = runtime_setup_core()
+    runtime_status = _runtime_status_core()
     accessibility = accessibility_audit_core()
     demo_script = demo_script_core()
     image_descriptions = describe_article_images_core()
@@ -316,6 +317,13 @@ def submission_readiness_core() -> dict[str, Any]:
         PUBLIC_BASE_URL in item["curl"] and PUBLIC_BASE_URL in item["powershell"]
         for item in demo_script["api_checks"]
     )
+    runtime_statuses = {
+        runtime_status["reader_brain"]["status"],
+        runtime_status["vision"]["status"],
+        runtime_status["speech"]["status"],
+        runtime_status["image_generation"]["status"],
+    }
+    runtime_status_ready = runtime_statuses <= {"online", "fallback-ready", "placeholder-ready"}
     checks = [
         {
             "id": "tiny_titan_budget",
@@ -341,6 +349,12 @@ def submission_readiness_core() -> dict[str, Any]:
             "status": "pass" if runtime_roles == expected_roles else "fail",
             "evidence": "Runtime setup covers reader brain, speech, vision, and image generation paths.",
         },
+        {
+            "id": "runtime_status",
+            "label": "Runtime status",
+            "status": "pass" if runtime_status_ready else "fail",
+            "evidence": "Runtime status labels every model path as online, fallback-ready, or placeholder-ready.",
+        },
         {
             "id": "reader_accessibility",
             "label": "Reader accessibility",

scripts/verify.py

@@ -466,6 +466,7 @@ def verify_routes() -> None:
             "award_targets",
             "custom_frontend",
             "runtime_setup",
+            "runtime_status",
             "reader_accessibility",
             "image_receipts",
             "demo_api_checks",
@@ -473,6 +474,8 @@ def verify_routes() -> None:
         },
         "Submission readiness should aggregate model, award, frontend, runtime, accessibility, image, and demo evidence",
     )
+    runtime_status_check = next(item for item in readiness_payload["checks"] if item["id"] == "runtime_status")
+    assert_true(runtime_status_check["status"] == "pass", "Submission readiness should pass runtime status checks")
     demo_api_check = next(item for item in readiness_payload["checks"] if item["id"] == "demo_api_checks")
     assert_true(demo_api_check["status"] == "pass", "Submission readiness should pass executable demo API checks")
     command_base_check = next(item for item in readiness_payload["checks"] if item["id"] == "command_base_url")