Add copyable judge evidence bundle

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

FIELD_NOTES.md

@@ -32,6 +32,8 @@ The judge runbook lives at `/api/demo-script` and is rendered in the session pan
 
 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.
 
+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 on the clipboard as formatted JSON.
+
 Image provenance lives in `/api/image-descriptions`. Each article illustration carries the planned FLUX.2 klein model id, prompt, seed, asset URL, and fallback status, and the session panel renders those receipts so the generated-image claim is inspectable.
 
 Accessibility evidence lives at `/api/accessibility-audit`. It records the reader-mode choices that matter most for this prototype: semantic reading order, keyboard navigation, reader cursor state, shortcut safety, live narration, image alt text, transcript review, user-controlled playback, and fallback resilience.

README.md

@@ -52,7 +52,7 @@ Start the app:
 python app.py
 ```
 
-Open the local URL printed by Gradio. The custom frontend calls `/api/reader-brain`, `/api/image-descriptions`, `/api/describe-image`, `/api/speak`, `/api/generate-image`, `/api/model-budget`, `/api/runtime-setup`, `/api/demo-script`, `/api/accessibility-audit`, and `/api/submission-readiness`.
+Open the local URL printed by Gradio. The custom frontend calls `/api/reader-brain`, `/api/image-descriptions`, `/api/describe-image`, `/api/speak`, `/api/generate-image`, `/api/model-budget`, `/api/runtime-setup`, `/api/demo-script`, `/api/accessibility-audit`, `/api/submission-readiness`, and `/api/evidence-bundle`.
 
 Useful environment variables:
 
@@ -83,6 +83,8 @@ The verifier checks syntax, static assets, Space metadata consistency, determini
 
 `/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, and demo API checks.
 
+`/api/evidence-bundle` returns a copyable JSON bundle of the main judging receipts. The Submission Readiness panel includes a Copy Evidence button that writes this bundle to the clipboard.
+
 ## Screen Reader Mode
 
 The frontend builds a reading queue from semantic article nodes. When screen-reader mode is on:
@@ -124,6 +126,8 @@ The session panel renders the judge runbook and API evidence checks from `/api/d
 
 A submission-readiness panel reads `/api/submission-readiness`, giving judges one compact rollup of the claims the live app can prove.
 
+The Copy Evidence button reads `/api/evidence-bundle` and copies the core judge receipts as formatted JSON for quick review or submission notes.
+
 A runtime-plan panel reads `/api/runtime-setup` and summarizes each model path's runtime plus fallback, keeping the live demo honest about what is online and what is deterministic.
 
 `/api/runtime-status` performs a short readiness check for llama.cpp and local speech dependencies, then reports which fallback paths are ready for a live demo.

SUBMISSION.md

@@ -44,6 +44,7 @@ The prototype is designed for a live hackathon demo: every model-facing path has
 - `/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/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`.
 
@@ -53,6 +54,8 @@ The image receipts keep the generated-asset claim inspectable: each article illu
 
 The submission-readiness panel and API give judges a compact checklist for the whole build, so the live demo can move from individual receipts to an overall readiness view.
 
+The Copy Evidence button pulls `/api/evidence-bundle` and writes the formatted JSON bundle to the clipboard for quick judging notes.
+
 ## Reliability notes
 
 The demo remains navigable when local models are unavailable. The reader brain falls back to deterministic narration, image descriptions fall back to cached alt text, speech falls back to browser speech plus transcript, and generated images fall back to bundled article assets. Fallback states are labeled instead of hidden.

app.py

@@ -354,6 +354,23 @@ def submission_readiness_core() -> dict[str, Any]:
     }
 
 
+def evidence_bundle_core() -> dict[str, Any]:
+    return {
+        "ok": True,
+        "title": "Tiny Narrator judge evidence bundle",
+        "frontend": "custom Gradio Server HTML/CSS/JS",
+        "bonus_targets": ARTICLE_MANIFEST["bonus_targets"],
+        "models": MODEL_MANIFEST,
+        "award_evidence": {"ok": True, "items": AWARD_EVIDENCE},
+        "model_budget": model_budget_core(),
+        "runtime_setup": runtime_setup_core(),
+        "demo_script": demo_script_core(),
+        "accessibility_audit": accessibility_audit_core(),
+        "image_descriptions": describe_article_images_core(),
+        "submission_readiness": submission_readiness_core(),
+    }
+
+
 def accessibility_audit_core() -> dict[str, Any]:
     checks = [
         {
@@ -792,6 +809,11 @@ async def submission_readiness() -> JSONResponse:
     return _json(submission_readiness_core())
 
 
+@app.get("/api/evidence-bundle")
+async def evidence_bundle() -> JSONResponse:
+    return _json(evidence_bundle_core())
+
+
 @app.get("/api/runtime-status")
 async def runtime_status() -> JSONResponse:
     return _json(_runtime_status_core())
@@ -862,6 +884,11 @@ def submission_readiness_api() -> str:
     return json.dumps(submission_readiness_core())
 
 
+@app.api(name="evidence_bundle")
+def evidence_bundle_api() -> str:
+    return json.dumps(evidence_bundle_core())
+
+
 @app.api(name="speak")
 def speak_api(text: str, voice: str = "af_heart", speed: float = 1.0) -> str:
     return json.dumps(speak_core(text, voice, speed))

scripts/verify.py

@@ -42,8 +42,10 @@ def verify_static_assets() -> None:
     assert_true("demoApiCheckList" in index_html, "Article should expose judge API evidence checks")
     assert_true("imageReceiptList" in index_html, "Article should expose generated image receipts")
     assert_true("submissionReadinessList" in index_html, "Article should expose submission readiness checks")
+    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("/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(
         "haltPlayback({ clearAutoAdvance: false });" in app_js,
@@ -63,6 +65,7 @@ def verify_static_assets() -> None:
         "/api/accessibility-audit",
         "/api/demo-script",
         "/api/submission-readiness",
+        "/api/evidence-bundle",
     ]:
         assert_true(endpoint in submission, f"Submission packet should mention {endpoint}")
     assert_true(
@@ -210,6 +213,7 @@ def verify_routes() -> None:
     assert_true("awardEvidenceList" in home.text, "Home route should include award evidence list")
     assert_true("submissionReadinessStatus" in home.text, "Home route should include submission readiness status")
     assert_true("submissionReadinessList" in home.text, "Home route should include submission readiness list")
+    assert_true("copyEvidenceButton" in home.text, "Home route should include copy evidence button")
     assert_true("budgetStatus" in home.text, "Home route should include model budget status")
     assert_true("modelBudgetList" in home.text, "Home route should include model budget list")
     assert_true("runtimeSetupStatus" in home.text, "Home route should include runtime setup status")
@@ -390,6 +394,17 @@ def verify_routes() -> None:
         "Submission readiness should aggregate model, award, frontend, runtime, accessibility, image, and demo evidence",
     )
 
+    evidence = client.get("/api/evidence-bundle")
+    assert_true(evidence.status_code == 200, "Evidence bundle route should return 200")
+    evidence_payload = evidence.json()
+    assert_true(evidence_payload["ok"], "Evidence bundle payload should be ok")
+    assert_true(evidence_payload["submission_readiness"]["all_passed"], "Evidence bundle should include passing readiness")
+    assert_true(evidence_payload["model_budget"]["all_models_within_limit"], "Evidence bundle should include Tiny Titan proof")
+    assert_true(
+        {"demo_script", "accessibility_audit", "image_descriptions"} <= set(evidence_payload),
+        "Evidence bundle should include demo script, accessibility audit, and image descriptions",
+    )
+
     runtime = client.get("/api/runtime-status")
     assert_true(runtime.status_code == 200, "Runtime status route should return 200")
     runtime_payload = runtime.json()

static/app.css

@@ -334,7 +334,8 @@ dd {
   text-transform: uppercase;
 }
 
-.history-header button {
+.history-header button,
+.submission-header button {
   min-height: 34px;
   border-radius: 6px;
   padding: 0 10px;

static/app.js

@@ -23,6 +23,7 @@ const demoApiCheckList = document.querySelector("#demoApiCheckList");
 const awardEvidenceList = document.querySelector("#awardEvidenceList");
 const submissionReadinessStatus = document.querySelector("#submissionReadinessStatus");
 const submissionReadinessList = document.querySelector("#submissionReadinessList");
+const copyEvidenceButton = document.querySelector("#copyEvidenceButton");
 const budgetStatus = document.querySelector("#budgetStatus");
 const modelBudgetList = document.querySelector("#modelBudgetList");
 const runtimeSetupStatus = document.querySelector("#runtimeSetupStatus");
@@ -698,6 +699,20 @@ clearTranscriptButton.addEventListener("click", () => {
   renderTranscript();
   liveNarration.textContent = "Transcript cleared.";
 });
+copyEvidenceButton.addEventListener("click", async () => {
+  try {
+    const payload = await postJson("/api/evidence-bundle");
+    const text = JSON.stringify(payload, null, 2);
+    if (!navigator.clipboard) {
+      liveNarration.textContent = "Evidence bundle loaded, but clipboard access is unavailable.";
+      return;
+    }
+    await navigator.clipboard.writeText(text);
+    liveNarration.textContent = "Evidence bundle copied.";
+  } catch (error) {
+    liveNarration.textContent = `Evidence bundle failed: ${error.message}`;
+  }
+});
 controls.play.addEventListener("click", () => {
   if (!enabled) return;
   if (currentIndex < 0) {

static/index.html

@@ -135,6 +135,7 @@
         <div class="submission-header">
           <h3>Submission Readiness</h3>
           <span id="submissionReadinessStatus">Checking</span>
+          <button id="copyEvidenceButton" type="button">Copy Evidence</button>
         </div>
         <ul id="submissionReadinessList" class="award-list" aria-label="Submission readiness checks"></ul>
         <div class="budget-header">