refactor: show builder goals in app

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

app.py

@@ -19,7 +19,7 @@ from hackathon_advisor.lora_training_kit import TRAINING_KIT_FILENAME, build_lor
 from hackathon_advisor.prize_ledger import prize_ledger
 from hackathon_advisor.submission_packet import build_submission_packet_markdown
 from hackathon_advisor.tool_contracts import resolve_tool_call, tool_schemas
-from hackathon_advisor.tools import TARGETS
+from hackathon_advisor.tools import TARGETS, target_profiles
 from hackathon_advisor.trace_export import build_trace_jsonl, trace_metadata
 
 
@@ -71,6 +71,7 @@ def bootstrap() -> dict:
         "top_projects": [project.to_public_dict() for project in index.top_projects(limit=8)],
         "whitespace": [item.to_dict() for item in index.find_whitespace(limit=5)],
         "target_options": TARGETS,
+        "target_profiles": target_profiles(),
         "default_targets": TARGETS[:3],
         "profile_fields": PROFILE_FIELDS,
         "prize_ledger": prize_ledger(runtime_status),

hackathon_advisor/agent.py

@@ -16,6 +16,7 @@ from hackathon_advisor.tools import (
     ToolEvent,
     idea_from_text,
     normalize_targets,
+    target_label,
     targets_from_state,
 )
 from hackathon_advisor.wood_map import build_wood_map
@@ -349,7 +350,8 @@ class AdvisorEngine:
             idea.targets = targets
             self._store_idea(state, idea)
         tool_events.append(ToolEvent("set_target", f"Set {len(targets)} target quests."))
-        response = "The seal will now bias toward: " + (", ".join(targets) or "no specific targets")
+        labels = [target_label(target) for target in targets]
+        response = "The seal will now bias toward: " + (", ".join(labels) or "no specific goals")
         return self._result(normalized, corrections, response, state, tool_events, [], [], None, [], {})
 
     def _idea_for_optional_id(self, call: ToolCall, state: dict[str, Any]) -> Idea | None:

hackathon_advisor/demo_rehearsal.py

@@ -5,7 +5,7 @@ from typing import Any
 
 DEMO_PROMPT = (
     "A local-first archive cartographer for family photos that runs offline, cites nearby Spaces, "
-    "and exports Field Notes."
+    "and exports build notes."
 )
 DEMO_PLAN_PROMPT = "make a build plan"
 DEMO_PROFILE = {

hackathon_advisor/tools.py

@@ -17,6 +17,48 @@ TARGETS = [
     "Field Notes",
 ]
 
+TARGET_PROFILE_BY_ID = {
+    "Off the Grid": {
+        "label": "Local-first",
+        "description": "Favor ideas that work without proprietary inference APIs.",
+    },
+    "Well-Tuned": {
+        "label": "Trainable",
+        "description": "Shape good turns into a tiny fine-tune dataset.",
+    },
+    "Off-Brand": {
+        "label": "Distinct voice",
+        "description": "Leave room for an interface and tone people remember.",
+    },
+    "Llama Champion": {
+        "label": "llama.cpp path",
+        "description": "Prefer small-model choices that can run locally.",
+    },
+    "Sharing is Caring": {
+        "label": "Shareable artifact",
+        "description": "Make an output people can save, post, or compare.",
+    },
+    "Field Notes": {
+        "label": "Build notes",
+        "description": "Keep decisions easy to write up from the session trace.",
+    },
+}
+
+
+def target_profiles() -> list[dict[str, str]]:
+    return [
+        {
+            "id": target,
+            "label": TARGET_PROFILE_BY_ID[target]["label"],
+            "description": TARGET_PROFILE_BY_ID[target]["description"],
+        }
+        for target in TARGETS
+    ]
+
+
+def target_label(target: str) -> str:
+    return TARGET_PROFILE_BY_ID.get(target, {}).get("label", target)
+
 
 def normalize_targets(raw_targets: Any, default: list[str] | None = None) -> list[str]:
     if raw_targets is None:
@@ -111,7 +153,7 @@ class AdvisorTools:
             "Refresh the Space snapshot, then tune the bleed threshold against the closest echoes.",
             "Build the smallest happy path: input, citations, score seal, and shareable artifact.",
             "Add one prize hook only after the core loop is smooth enough to demo without narration.",
-            "Record the trace and write Field Notes from the exact build decisions.",
+            "Record the trace and write build notes from the exact decisions.",
         ]
         if any("Well" in target for target in idea.targets):
             plan.insert(4, "Prepare a tiny LoRA dataset from successful advisor turns before training.")

static/app.js

@@ -28,6 +28,8 @@ let session = {};
 let clientPromise = Client.connect(window.location.origin);
 let currentArtifact = null;
 let targetOptions = [];
+let targetProfiles = [];
+let targetProfileById = new Map();
 let profileFields = [];
 let turnWatchdog = null;
 let sawTurnToken = false;
@@ -134,7 +136,11 @@ async function runTurn(message) {
 async function bootstrap() {
   const response = await fetch("/api/bootstrap");
   const data = await response.json();
-  targetOptions = data.target_options || [];
+  const rawProfiles = Array.isArray(data.target_profiles) ? data.target_profiles : [];
+  const rawOptions = Array.isArray(data.target_options) ? data.target_options : [];
+  targetProfiles = normalizeTargetProfiles(rawProfiles, rawOptions);
+  targetOptions = targetProfiles.map((target) => target.id);
+  targetProfileById = new Map(targetProfiles.map((target) => [target.id, target]));
   profileFields = data.profile_fields || [];
   session = {
     profile: {},
@@ -262,6 +268,22 @@ function normalizeSession(savedSession, defaultSession) {
   return normalized;
 }
 
+function normalizeTargetProfiles(profiles, options) {
+  const byId = new Map(
+    profiles
+      .filter((profile) => profile && typeof profile.id === "string")
+      .map((profile) => [
+        profile.id,
+        {
+          id: profile.id,
+          label: String(profile.label || profile.id),
+          description: String(profile.description || ""),
+        },
+      ]),
+  );
+  return options.map((id) => byId.get(id) || { id, label: id, description: "" });
+}
+
 function saveSession() {
   try {
     window.localStorage.setItem(SESSION_STORAGE_KEY, JSON.stringify(session));
@@ -282,15 +304,24 @@ function renderTargets(selectedTargets) {
   const selected = new Set(selectedTargets || []);
   targetsEl.innerHTML = "";
   if (!targetOptions.length) {
-    targetsEl.innerHTML = `<div class="empty">No seals loaded.</div>`;
+    targetsEl.innerHTML = `<div class="empty">No goals loaded.</div>`;
     return;
   }
   for (const option of targetOptions) {
+    const profile = targetProfileById.get(option) || { label: option, description: "" };
     const label = document.createElement("label");
     label.className = "target-toggle";
     label.innerHTML = `
-      <input type="checkbox" data-target="${escapeAttribute(option)}" ${selected.has(option) ? "checked" : ""} />
-      <span>${escapeHtml(option)}</span>
+      <input
+        type="checkbox"
+        data-target="${escapeAttribute(option)}"
+        aria-label="${escapeAttribute(profile.label)}"
+        ${selected.has(option) ? "checked" : ""}
+      />
+      <span class="target-copy">
+        <strong>${escapeHtml(profile.label)}</strong>
+        ${profile.description ? `<small>${escapeHtml(profile.description)}</small>` : ""}
+      </span>
     `;
     targetsEl.append(label);
   }
@@ -378,7 +409,7 @@ function renderIdeas(ideas) {
   }
   for (const idea of visibleIdeas(ideas)) {
     const score = idea.score?.overall ? Number(idea.score.overall).toFixed(1) : "0.0";
-    const targets = (idea.targets || []).slice(0, 3).join(" · ");
+    const targets = (idea.targets || []).slice(0, 3).map(targetDisplayName).join(" · ");
     const item = document.createElement("div");
     item.className = "idea";
     item.innerHTML = `
@@ -398,6 +429,10 @@ function visibleIdeas(ideas) {
   return current ? [current, ...remaining] : ideas.slice(-4).reverse();
 }
 
+function targetDisplayName(target) {
+  return targetProfileById.get(target)?.label || target;
+}
+
 function renderScore(score) {
   const rows = [
     ["Originality", score?.originality || 0],

static/index.html

@@ -33,7 +33,7 @@
               </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-notes" title="Export Field Notes" disabled>Notes</button>
+              <button type="button" id="export-notes" title="Export build notes" disabled>Notes</button>
               <button type="button" id="export-chapter" title="Export the Almanac chapter" disabled>Chapter</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>
@@ -54,7 +54,7 @@
                 <div id="wood-map" class="wood-map"></div>
               </article>
               <article>
-                <h2>Targets</h2>
+                <h2>Goals</h2>
                 <div id="targets" class="target-list"></div>
               </article>
               <article>

static/styles.css

@@ -363,16 +363,16 @@ button:disabled {
 }
 
 .target-list {
-  grid-template-columns: repeat(2, minmax(0, 1fr));
+  grid-template-columns: 1fr;
   gap: 7px;
 }
 
 .target-toggle {
   min-width: 0;
-  min-height: 36px;
+  min-height: 50px;
   display: flex;
-  align-items: center;
-  gap: 7px;
+  align-items: flex-start;
+  gap: 8px;
   color: #2a170d;
   font-size: 0.76rem;
   line-height: 1.2;
@@ -384,11 +384,27 @@ button:disabled {
   flex: 0 0 auto;
   width: 16px;
   height: 16px;
+  margin-top: 2px;
   accent-color: var(--leaf);
 }
 
-.target-toggle span {
+.target-copy {
   min-width: 0;
+  display: grid;
+  gap: 3px;
+}
+
+.target-copy strong {
+  color: #2a170d;
+  font-size: 0.8rem;
+  line-height: 1.2;
+}
+
+.target-copy small {
+  color: var(--muted-ink);
+  font-size: 0.72rem;
+  line-height: 1.25;
+  font-weight: 800;
 }
 
 .profile-field {

tests/test_agent.py

@@ -137,6 +137,7 @@ def test_planner_profile_and_targets_update_state() -> None:
 
     assert targeted.state["profile"]["skills"] == "frontend"
     assert targeted.state["targets"] == ["Off the Grid", "Field Notes"]
+    assert "Local-first, Build notes" in targeted.response
 
 
 def test_session_targets_apply_to_new_and_current_ideas() -> None:

tests/test_app.py

@@ -41,6 +41,9 @@ def test_bootstrap_exposes_index_metadata() -> None:
     assert payload["runtime"]["tool_count"] >= 8
     assert payload["top_projects"]
     assert payload["default_targets"] == payload["target_options"][:3]
+    assert [target["id"] for target in payload["target_profiles"]] == payload["target_options"]
+    assert payload["target_profiles"][0]["label"] == "Local-first"
+    assert "description" in payload["target_profiles"][0]
     assert "skills" in payload["profile_fields"]
     assert payload["prize_ledger"]["tiny_titan_eligible"] is True
 
@@ -68,7 +71,7 @@ def test_field_notes_endpoint_exports_markdown() -> None:
     assert "Skills: frontend" in payload
     assert "Targets: Field Notes" in payload
     assert "## Turn Trace" in payload
-    assert "Record the trace and write Field Notes" in payload
+    assert "Record the trace and write build notes" in payload
 
 
 def test_chapter_endpoint_exports_markdown() -> None:

tests/test_field_notes.py

@@ -29,7 +29,7 @@ def test_field_notes_markdown_contains_session_decisions() -> None:
     assert "Targets: Field Notes" in markdown
     assert "A local-first archive cartographer for family photos" in markdown
     assert "## Build Plan" in markdown
-    assert "Record the trace and write Field Notes" in markdown
+    assert "Record the trace and write build notes" in markdown
     assert "Closest cited Spaces" in markdown
     assert "Page " in markdown
     assert "## Wood Map" in markdown