refactor: rename planner targets to goals

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

DESIGN.md

@@ -267,7 +267,7 @@ code.** Keep live context to ~800–1200 tokens of *curated* view, never raw dat
 Few tools, few params each, short descriptions (1B-friendly). Heavy logic in code.
 
 **Jargon alias layer (input normalization).** Before any tool call and before display, run ASR/user text through a
-deterministic fuzzy/alias map over our small CLOSED vocab (model names, prize names, side quests) — e.g. RapidFuzz
+deterministic fuzzy/alias map over our small CLOSED vocab (model names and goal names) — e.g. RapidFuzz
 `token_set_ratio` / double-metaphone — mapping "neutron"/"nemo tron" → Nemotron, "mini cpm" → MiniCPM5, "zero gpu" →
 ZeroGPU. Surface the correction ("heard: neutron → Nemotron") as a trust-building, slightly delightful moment.
 
@@ -287,12 +287,12 @@ into a local snapshot + EmbeddingGemma index (keeps Off the Grid at runtime).
 
 | Tool | Signature | Purpose |
 |---|---|---|
-| `save_idea` | `(title, pitch, track, models[], side_quests[])` | add/update a candidate on the idea board |
+| `save_idea` | `(title, pitch)` | add/update a candidate on the idea board |
 | `score_idea` | `(id)` | fixed (hardcoded) rubric → scores + gaps; the 1B only triggers + verbalizes |
 | `compare_ideas` | `()` | rank the board, articulate tradeoffs |
-| `make_plan` | `(id)` | build plan + side quests it picks up "for free" |
+| `make_plan` | `(id)` | build plan + goals the current direction can support |
 | `update_profile` | `(field, value)` | record skills/time/prefs → Layer B |
-| `set_target` | `(side_quests[])` | change targeted prizes → updates Layer A bias |
+| `set_goals` | `(goals[])` | change selected goals → updates Layer A bias |
 
 ---
 

hackathon_advisor/agent.py

@@ -128,7 +128,7 @@ class AdvisorEngine:
         if call.name == "update_profile":
             return self._profile_turn(call, normalized, corrections, state, tool_events)
 
-        if call.name == "set_target":
+        if call.name == "set_goals":
             return self._target_turn(call, normalized, corrections, state, tool_events)
 
         return self._idea_research_turn(call, normalized, corrections, state, tool_events)
@@ -355,13 +355,13 @@ class AdvisorEngine:
         state: dict[str, Any],
         tool_events: list[ToolEvent],
     ) -> TurnResult:
-        targets = normalize_targets(call.arguments.get("side_quests"), default=[])
+        targets = normalize_targets(call.arguments.get("goals"), default=[])
         state["targets"] = targets
         idea = self._current_idea(state)
         if idea is not None:
             idea.targets = targets
             self._store_idea(state, idea)
-        tool_events.append(ToolEvent("set_target", f"Set {len(targets)} target quests."))
+        tool_events.append(ToolEvent("set_goals", f"Set {len(targets)} goals."))
         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, [], {})

hackathon_advisor/tool_contracts.py

@@ -85,7 +85,7 @@ TOOL_SPECS: dict[str, ToolSpec] = {
         name="list_projects",
         description="Read prominent Build Small project cards from the offline snapshot.",
         fields={
-            "track": ToolField("string", "Optional prize, badge, model, or topic filter."),
+            "track": ToolField("string", "Optional model, goal, or topic filter."),
             "sort": ToolField("string", "Sort key.", enum=("likes", "recent", "title")),
         },
     ),
@@ -110,9 +110,6 @@ TOOL_SPECS: dict[str, ToolSpec] = {
         fields={
             "title": ToolField("string", "Short idea title.", required=True),
             "pitch": ToolField("string", "One-sentence idea pitch.", required=True),
-            "track": ToolField("string", "Primary target track or award."),
-            "models": ToolField("array", "Model ids the idea may use.", items_type="string"),
-            "side_quests": ToolField("array", "Badge or side quest targets.", items_type="string"),
         },
     ),
     "score_idea": ToolSpec(
@@ -143,10 +140,10 @@ TOOL_SPECS: dict[str, ToolSpec] = {
             "value": ToolField("string", "Profile value to remember.", required=True),
         },
     ),
-    "set_target": ToolSpec(
-        name="set_target",
-        description="Change the badge, model, or award targets used to bias ideation.",
-        fields={"side_quests": ToolField("array", "Targets to prioritize.", required=True, items_type="string")},
+    "set_goals": ToolSpec(
+        name="set_goals",
+        description="Change the selected goals used to bias ideation and planning.",
+        fields={"goals": ToolField("array", "Goal ids to prioritize.", required=True, items_type="string")},
     ),
 }
 

tests/test_agent.py

@@ -180,9 +180,9 @@ def test_planner_profile_and_targets_update_state() -> None:
     profile = profile_engine.turn("remember this", {})
     target_engine = AdvisorEngine(
         index,
-        planner=StaticPlanner(ToolCall("set_target", {"side_quests": ["Off the Grid", "Field Notes"]})),
+        planner=StaticPlanner(ToolCall("set_goals", {"goals": ["Off the Grid", "Field Notes"]})),
     )
-    targeted = target_engine.turn("target prizes", profile.state)
+    targeted = target_engine.turn("set goals", profile.state)
 
     assert targeted.state["profile"]["skills"] == "frontend"
     assert targeted.state["targets"] == ["Off the Grid", "Field Notes"]

tests/test_tool_contracts.py

@@ -21,7 +21,13 @@ def test_tool_schemas_are_model_ready() -> None:
         "save_idea",
         "score_idea",
         "make_plan",
+        "set_goals",
     }
+    schema_text = str(schemas)
+    assert "set_target" not in schema_text
+    assert "side_quests" not in schema_text
+    assert "prize" not in schema_text.lower()
+    assert "badge" not in schema_text.lower()
 
 
 def test_parse_and_validate_minicpm_xml_tool_call() -> None: