Add hackathon award evidence checklist

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

FIELD_NOTES.md

@@ -52,3 +52,5 @@ Kokoro is still the intended model-backed TTS path. For local resilience, the fr
 Reader settings are manifest-backed: the app exposes known Kokoro voices and speed bounds through `/api/article-manifest`, then the custom frontend renders the controls and passes the selected voice to `/api/speak`.
 
 Every model-facing backend path reports `elapsed_ms`. The frontend surfaces the latest end-to-end reader latency and stores per-item timing in the transcript, giving the build report concrete evidence for the small-model responsiveness claim.
+
+The app exposes `/api/award-evidence` and renders that data in the session panel, so the live demo can point directly to the hackathon bonus targets it is designed to satisfy.

README.md

@@ -93,3 +93,5 @@ Kokoro remains the planned tiny-model TTS path. During local demos, if the serve
 The reader bar exposes Kokoro voice selection and speaking speed controls. Defaults come from `/api/article-manifest` so the UI, docs, and backend stay aligned.
 
 Reader-brain, image-description, speech, and image-generation responses include `elapsed_ms`. The session panel and transcript show recent latency so the Field Notes can discuss responsiveness with concrete numbers.
+
+The session panel also renders a manifest-backed demo checklist for Tiny Titan, Llama Champion, Off-Brand, and Field Notes evidence.

app.py

@@ -87,6 +87,33 @@ READER_SETTINGS: dict[str, Any] = {
     "speed": {"min": 0.75, "max": 1.35, "step": 0.05},
 }
 
+AWARD_EVIDENCE: list[dict[str, str]] = [
+    {
+        "id": "tiny-titan",
+        "label": "Tiny Titan",
+        "status": "ready",
+        "evidence": "All planned model roles use models at or below 4B parameters.",
+    },
+    {
+        "id": "llama-champion",
+        "label": "Llama Champion",
+        "status": "ready",
+        "evidence": "The reader-brain path targets a GGUF model through a llama.cpp OpenAI-compatible endpoint.",
+    },
+    {
+        "id": "off-brand",
+        "label": "Off-Brand",
+        "status": "ready",
+        "evidence": "The visible app is custom HTML, CSS, and JavaScript served by Gradio Server.",
+    },
+    {
+        "id": "field-notes",
+        "label": "Field Notes",
+        "status": "ready",
+        "evidence": "The repo records model choices, fallbacks, latency reporting, and accessibility behavior.",
+    },
+]
+
 ARTICLE_MANIFEST: dict[str, Any] = {
     "title": "A tiny model reader that turns articles into guided narration",
     "reader_controls": [
@@ -103,6 +130,7 @@ ARTICLE_MANIFEST: dict[str, Any] = {
     "images": ARTICLE_IMAGES,
     "models": MODEL_MANIFEST,
     "reader_settings": READER_SETTINGS,
+    "award_evidence": AWARD_EVIDENCE,
 }
 
 app = Server(title="Tiny Narrator")
@@ -348,6 +376,11 @@ async def article_manifest() -> JSONResponse:
     return _json({"ok": True, **ARTICLE_MANIFEST})
 
 
+@app.get("/api/award-evidence")
+async def award_evidence() -> JSONResponse:
+    return _json({"ok": True, "items": AWARD_EVIDENCE})
+
+
 @app.post("/api/reader-brain")
 async def reader_brain_endpoint(payload: ReaderBrainRequest) -> JSONResponse:
     return _json(reader_brain_core(payload.node_type, payload.text, payload.position, payload.mode))

scripts/verify.py

@@ -89,6 +89,7 @@ def verify_routes() -> None:
     assert_true("voiceControl" in home.text, "Home route should include voice control")
     assert_true("speedValue" in home.text, "Home route should include speed value output")
     assert_true("transcriptLog" in home.text, "Home route should include transcript log")
+    assert_true("awardEvidenceList" in home.text, "Home route should include award evidence list")
 
     health = client.get("/api/health")
     assert_true(health.status_code == 200, "Health route should return 200")
@@ -119,6 +120,19 @@ def verify_routes() -> None:
         len(manifest_payload["reader_settings"]["voices"]) >= 4,
         "Manifest should expose multiple Kokoro voice choices",
     )
+    assert_true(
+        len(manifest_payload["award_evidence"]) == 4,
+        "Manifest should expose four award evidence items",
+    )
+
+    awards = client.get("/api/award-evidence")
+    assert_true(awards.status_code == 200, "Award evidence route should return 200")
+    award_payload = awards.json()
+    assert_true(award_payload["ok"], "Award evidence payload should be ok")
+    assert_true(
+        {item["id"] for item in award_payload["items"]} == {"tiny-titan", "llama-champion", "off-brand", "field-notes"},
+        "Award evidence route should cover the targeted bonuses",
+    )
 
     image_descriptions = client.get("/api/image-descriptions")
     assert_true(image_descriptions.status_code == 200, "Image descriptions route should return 200")

static/app.css

@@ -286,6 +286,10 @@ dd {
   margin-top: 22px;
 }
 
+.award-header {
+  margin-top: 22px;
+}
+
 .history-header button {
   min-height: 34px;
   border-radius: 6px;
@@ -327,6 +331,45 @@ dd {
   font-size: 0.92rem;
 }
 
+.award-list {
+  display: grid;
+  gap: 10px;
+  margin: 12px 0 0;
+  padding: 0;
+  list-style: none;
+}
+
+.award-list li {
+  border: 1px solid var(--line);
+  border-radius: 8px;
+  padding: 10px 12px;
+  background: var(--surface);
+}
+
+.award-title {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 8px;
+  font-size: 0.82rem;
+  font-weight: 850;
+  text-transform: uppercase;
+}
+
+.award-status {
+  border-radius: 999px;
+  background: rgba(31, 111, 104, 0.12);
+  color: var(--accent-strong);
+  padding: 2px 8px;
+  font-size: 0.7rem;
+}
+
+.award-evidence {
+  margin: 6px 0 0;
+  color: var(--muted);
+  font-size: 0.88rem;
+}
+
 .reader-bar {
   position: fixed;
   right: clamp(14px, 3vw, 32px);

static/app.js

@@ -15,6 +15,7 @@ const speedValue = document.querySelector("#speedValue");
 const transcriptLog = document.querySelector("#transcriptLog");
 const copyTranscriptButton = document.querySelector("#copyTranscriptButton");
 const clearTranscriptButton = document.querySelector("#clearTranscriptButton");
+const awardEvidenceList = document.querySelector("#awardEvidenceList");
 
 const controls = {
   prev: document.querySelector("#prevButton"),
@@ -123,6 +124,33 @@ async function loadManifest() {
   }
 }
 
+async function loadAwardEvidence() {
+  try {
+    const payload = await postJson("/api/award-evidence");
+    awardEvidenceList.innerHTML = payload.items
+      .map((item) => `
+        <li>
+          <div class="award-title">
+            <span>${escapeHtml(item.label)}</span>
+            <span class="award-status">${escapeHtml(item.status)}</span>
+          </div>
+          <p class="award-evidence">${escapeHtml(item.evidence)}</p>
+        </li>
+      `)
+      .join("");
+  } catch {
+    awardEvidenceList.innerHTML = `
+      <li>
+        <div class="award-title">
+          <span>Checklist</span>
+          <span class="award-status">offline</span>
+        </div>
+        <p class="award-evidence">Award evidence is unavailable.</p>
+      </li>
+    `;
+  }
+}
+
 async function loadImageDescriptions() {
   imageStatus.textContent = "Describing";
   try {
@@ -403,6 +431,7 @@ controls.play.addEventListener("click", () => {
 });
 
 loadManifest();
+loadAwardEvidence();
 loadImageDescriptions();
 updateSpeedValue();
 

static/index.html

@@ -118,6 +118,10 @@
           <button id="clearTranscriptButton" type="button">Clear</button>
         </div>
         <ol id="transcriptLog" class="transcript-log" aria-label="Narration transcript"></ol>
+        <div class="award-header">
+          <h3>Demo Checklist</h3>
+        </div>
+        <ul id="awardEvidenceList" class="award-list" aria-label="Hackathon bonus evidence"></ul>
       </aside>
     </main>