refactor: focus app ui on builders

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

README.md

@@ -32,7 +32,7 @@ The current milestone is a deployable, deterministic vertical slice:
 - Offline search over project titles, tags, models, and descriptions.
 - Jargon correction for hackathon/model terms.
 - One-turn advisor loop with overlap citations, whitespace suggestions, scoring, and plans.
-- Custom `gradio.Server` frontend with streaming API events.
+- Custom `gradio.Server` frontend focused on the builder's idea workflow, with submission evidence kept in API exports.
 
 See [DESIGN.md](DESIGN.md) for the full product and model plan.
 
@@ -60,8 +60,9 @@ source, project order, and digest before the app starts.
 
 ## Trace Artifact
 
-The app exposes a `trace_artifact` Gradio API endpoint and a `JSONL` button in the UI. Both emit the same JSONL schema:
-a manifest row followed by one row per agent turn. `data/sample_trace.jsonl` is a checked-in, Hub-published sample trace.
+The app exposes a `trace_artifact` Gradio API endpoint for submission evidence and debugging. It emits a manifest row
+followed by one row per agent turn. `data/sample_trace.jsonl` is a checked-in, Hub-published sample trace. This endpoint
+is intentionally kept out of the main user workflow.
 
 ## Field Notes Artifact
 
@@ -77,45 +78,45 @@ the private Field Notes artifact.
 
 ## LoRA Dataset Artifact
 
-The `lora_dataset` Gradio API endpoint and `LoRA` button export a compact chat JSONL dataset from successful session
-turns. Each included turn yields a tool-call example and an advisor-response example for `openbmb/MiniCPM5-1B`, with the
-selected targets, parsed XML tool call, tool observations, and score context preserved. This prepares the Well-Tuned
-path without claiming that the adapter has already been trained or published.
+The `lora_dataset` Gradio API endpoint exports a compact chat JSONL dataset from successful session turns. Each included
+turn yields a tool-call example and an advisor-response example for `openbmb/MiniCPM5-1B`, with the selected targets,
+parsed XML tool call, tool observations, and score context preserved. This prepares the Well-Tuned path without claiming
+that the adapter has already been trained or published.
 
 ## LoRA Training Kit
 
-`/api/lora-training-kit.zip` and the `Train` button export a training kit for the deterministic demo session: SFT JSONL,
-training recipe, adapter model-card draft, and the exact training command. The included
-`scripts/train_minicpm_lora.py` entrypoint supports a dependency-light `--dry-run` validation path and a real
-`transformers + PEFT` training path after installing `pip install -e '.[train]'`. The Prize Ledger still marks
-Well-Tuned as training-kit-ready until a real adapter is trained and published.
+`/api/lora-training-kit.zip` exports a training kit for the deterministic demo session: SFT JSONL, training recipe,
+adapter model-card draft, and the exact training command. The included `scripts/train_minicpm_lora.py` entrypoint
+supports a dependency-light `--dry-run` validation path and a real `transformers + PEFT` training path after installing
+`pip install -e '.[train]'`. The Prize Ledger still marks Well-Tuned as training-kit-ready until a real adapter is
+trained and published.
 
 ## Submission Packet
 
-The `submission_packet` Gradio API endpoint and `Packet` button export a Markdown submission bundle for the current
-session: live links, snapshot provenance, a timed demo script, artifact checklist, Prize Ledger evidence, model budget,
-session trace summary, social post draft, and open badge gaps. This keeps the final submission story tied to the same
-auditable state as the app instead of a separate hand-curated checklist.
+The `submission_packet` Gradio API endpoint exports a Markdown submission bundle for the current session: live links,
+snapshot provenance, a timed demo script, artifact checklist, Prize Ledger evidence, model budget, session trace
+summary, social post draft, and open badge gaps. This keeps the final submission story tied to the same auditable state
+as the app instead of a separate hand-curated checklist.
 
 ## Demo Rehearsal
 
-`/api/demo-session` and the `Demo` button load a deterministic two-turn rehearsal: a complete project idea, profile,
-target badges, score seal, build plan, trace, wood map, and export-ready artifacts. It is built by running the same
-advisor engine as a normal user session, so the demo state can be used immediately with JSONL, Notes, Chapter, LoRA,
-Packet, and PNG exports.
+`/api/demo-session` and the `Example` button load a deterministic two-turn sample: a complete project idea, profile,
+target badges, score seal, build plan, trace, and wood map. It is built by running the same advisor engine as a normal
+user session, so the visible app stays focused on the builder's idea while API exports remain available for submission
+evidence.
 
 ## Demo Evidence Bundle
 
-`/api/demo-bundle.zip` and the `Bundle` button download a server-built ZIP for the deterministic demo session. The
-bundle includes a manifest, demo session JSON, Prize Ledger JSON, trace JSONL, Field Notes, Almanac chapter, LoRA SFT
-JSONL, LoRA training kit, Submission Packet, and a PNG export note. This gives judges or collaborators one auditable
-package without depending on browser `localStorage`.
+`/api/demo-bundle.zip` downloads a server-built ZIP for the deterministic demo session. The bundle includes a manifest,
+demo session JSON, Prize Ledger JSON, trace JSONL, Field Notes, Almanac chapter, LoRA SFT JSONL, LoRA training kit,
+Submission Packet, and a PNG export note. This gives judges or collaborators one auditable package without depending on
+browser `localStorage`.
 
 ## Prize Ledger
 
-`/api/prize-ledger` and the in-app Prize Ledger panel expose submission evidence: the documented model stack, total
-parameter budget, Tiny Titan eligibility, runtime backend, and badge readiness. This keeps the demo's prize claims tied
-to visible app state rather than hidden notes.
+`/api/prize-ledger` exposes submission evidence: the documented model stack, total parameter budget, Tiny Titan
+eligibility, runtime backend, and badge readiness. It is kept as an API artifact rather than a primary in-app panel so
+the user-facing app stays centered on idea evaluation.
 
 ## Wood Map
 

static/app.js

@@ -63,7 +63,7 @@ exportButton.addEventListener("click", () => {
   exportArtifact(currentArtifact);
 });
 
-exportTraceButton.addEventListener("click", async () => {
+exportTraceButton?.addEventListener("click", async () => {
   await exportTrace();
 });
 
@@ -75,19 +75,19 @@ exportChapterButton.addEventListener("click", async () => {
   await exportChapter();
 });
 
-exportLoraButton.addEventListener("click", async () => {
+exportLoraButton?.addEventListener("click", async () => {
   await exportLoraDataset();
 });
 
-exportTrainKitButton.addEventListener("click", () => {
+exportTrainKitButton?.addEventListener("click", () => {
   window.location.assign("/api/lora-training-kit.zip");
 });
 
-exportPacketButton.addEventListener("click", async () => {
+exportPacketButton?.addEventListener("click", async () => {
   await exportSubmissionPacket();
 });
 
-exportBundleButton.addEventListener("click", () => {
+exportBundleButton?.addEventListener("click", () => {
   window.location.assign("/api/demo-bundle.zip");
 });
 
@@ -181,7 +181,7 @@ async function loadDemoSession() {
   setCommandDisabled(true);
   ink.classList.remove("bleed", "gold");
   ink.classList.add("thinking");
-  ink.textContent = "The demo pages are turning.";
+  ink.textContent = "A sample page is being inked.";
   corrections.textContent = "";
   try {
     const response = await fetch("/api/demo-session");
@@ -225,12 +225,12 @@ function applyDemoSession(data) {
     renderProjects(data.projects || []);
   }
   exportButton.disabled = !currentArtifact;
-  exportTraceButton.disabled = !(session.trace?.length);
-  exportNotesButton.disabled = !(session.trace?.length);
-  exportChapterButton.disabled = !(session.ideas?.length);
-  exportLoraButton.disabled = !(session.trace?.length);
-  exportPacketButton.disabled = !(session.trace?.length);
-  corrections.textContent = `demo: ${data.turn_count || 0} recorded turns`;
+  setButtonDisabled(exportTraceButton, !(session.trace?.length));
+  setButtonDisabled(exportNotesButton, !(session.trace?.length));
+  setButtonDisabled(exportChapterButton, !(session.ideas?.length));
+  setButtonDisabled(exportLoraButton, !(session.trace?.length));
+  setButtonDisabled(exportPacketButton, !(session.trace?.length));
+  corrections.textContent = `example loaded: ${data.turn_count || 0} advisor turns`;
   saveSession();
 }
 
@@ -263,11 +263,11 @@ function renderRestoredSession(data) {
   renderIdeas(session.ideas || []);
   renderPlan(session.last_plan || []);
   renderTrace(session.trace || []);
-  exportTraceButton.disabled = !(session.trace?.length);
-  exportNotesButton.disabled = !(session.trace?.length);
-  exportChapterButton.disabled = !(session.ideas?.length);
-  exportLoraButton.disabled = !(session.trace?.length);
-  exportPacketButton.disabled = !(session.trace?.length);
+  setButtonDisabled(exportTraceButton, !(session.trace?.length));
+  setButtonDisabled(exportNotesButton, !(session.trace?.length));
+  setButtonDisabled(exportChapterButton, !(session.ideas?.length));
+  setButtonDisabled(exportLoraButton, !(session.trace?.length));
+  setButtonDisabled(exportPacketButton, !(session.trace?.length));
 }
 
 function readSavedSession() {
@@ -354,6 +354,7 @@ function renderProfile(profile) {
 }
 
 function renderPrizeLedger(ledger) {
+  if (!prizeLedgerEl) return;
   prizeLedgerEl.innerHTML = "";
   if (!ledger) {
     prizeLedgerEl.innerHTML = `<div class="empty">No prize ledger loaded.</div>`;
@@ -447,11 +448,11 @@ function handleEvent(event) {
       renderWoodMap(event.artifact.wood_map || null);
       exportButton.disabled = false;
     }
-    exportTraceButton.disabled = !(session.trace?.length);
-    exportNotesButton.disabled = !(session.trace?.length);
-    exportChapterButton.disabled = !(session.ideas?.length);
-    exportLoraButton.disabled = !(session.trace?.length);
-    exportPacketButton.disabled = !(session.trace?.length);
+    setButtonDisabled(exportTraceButton, !(session.trace?.length));
+    setButtonDisabled(exportNotesButton, !(session.trace?.length));
+    setButtonDisabled(exportChapterButton, !(session.ideas?.length));
+    setButtonDisabled(exportLoraButton, !(session.trace?.length));
+    setButtonDisabled(exportPacketButton, !(session.trace?.length));
     saveSession();
   }
 }
@@ -604,6 +605,7 @@ function renderPlan(steps) {
 }
 
 function renderTrace(trace) {
+  if (!traceEl) return;
   traceEl.innerHTML = "";
   if (!trace.length) {
     traceEl.innerHTML = `<div class="empty">No tool marks yet.</div>`;
@@ -621,6 +623,10 @@ function renderTrace(trace) {
   }
 }
 
+function setButtonDisabled(button, disabled) {
+  if (button) button.disabled = disabled;
+}
+
 function setCommandDisabled(disabled) {
   document.querySelectorAll(".command-row button").forEach((button) => {
     if (button.id === "export-train-kit") return;

static/index.html

@@ -27,19 +27,14 @@
               <button id="submit" type="submit" title="Ink the page">Ink</button>
             </form>
             <div class="command-row" aria-label="Advisor commands">
-              <button type="button" id="load-demo" title="Load a complete demo session">Demo</button>
+              <button type="button" id="load-demo" title="Load a sample idea">Example</button>
               <button type="button" data-command="write bolder and find whitespace" title="Find a gold margin">
                 Gap
               </button>
               <button type="button" data-command="make a build plan" title="Draft a build plan">Plan</button>
               <button type="button" data-command="compare ideas" title="Compare the idea board">Rank</button>
-              <button type="button" id="export-trace" title="Export the tool trace" disabled>JSONL</button>
               <button type="button" id="export-notes" title="Export Field Notes" disabled>Notes</button>
               <button type="button" id="export-chapter" title="Export the Almanac chapter" disabled>Chapter</button>
-              <button type="button" id="export-lora" title="Export the LoRA SFT dataset" disabled>LoRA</button>
-              <button type="button" id="export-train-kit" title="Download the LoRA training kit">Train</button>
-              <button type="button" id="export-packet" title="Export the submission packet" disabled>Packet</button>
-              <button type="button" id="export-bundle" title="Download the demo evidence bundle">Bundle</button>
               <button type="button" id="export-artifact" title="Export the current fate page" disabled>PNG</button>
               <button type="button" id="reset-session" title="Clear the saved session">Reset</button>
             </div>
@@ -66,10 +61,6 @@
                 <h2>Profile</h2>
                 <div id="profile" class="profile-grid"></div>
               </article>
-              <article class="wide-panel">
-                <h2>Prize Ledger</h2>
-                <div id="prize-ledger" class="prize-ledger"></div>
-              </article>
               <article>
                 <h2>Idea Board</h2>
                 <div id="ideas" class="idea-list"></div>
@@ -86,10 +77,6 @@
                 <h2>Build Plan</h2>
                 <ol id="plan" class="plan-list"></ol>
               </article>
-              <article>
-                <h2>Trace</h2>
-                <div id="trace" class="trace-list"></div>
-              </article>
             </div>
           </section>
         </div>