fix: clear stale seals for project references

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

hackathon_advisor/model_runtime.py

@@ -2,6 +2,7 @@ from __future__ import annotations
 
 from dataclasses import dataclass
 import os
+import re
 from typing import Any, Protocol
 
 from hackathon_advisor.tools import idea_from_text
@@ -43,8 +44,13 @@ class RuleBasedPlanner:
     def plan(self, message: str, state: dict[str, Any]) -> ToolResolution:
         text = " ".join(message.strip().split())
         lower = text.lower()
+        project_id = _project_reference_id(text)
         if not text:
             output = '<function name="list_projects">{"sort":"likes"}</function>'
+        elif _wants_project_list(lower):
+            output = '<function name="list_projects">{"sort":"likes"}</function>'
+        elif project_id:
+            output = f'<function name="get_project">{{"id":{_json_string(project_id)}}}</function>'
         elif any(term in lower for term in ("compare", "choose", "rank")):
             output = '<function name="compare_ideas">{}</function>'
         elif any(term in lower for term in ("plan", "roadmap", "next step", "milestone")):
@@ -179,6 +185,48 @@ def _json_string(value: str) -> str:
     return json.dumps(value, ensure_ascii=False)
 
 
+def _wants_project_list(lower_text: str) -> bool:
+    exact_phrases = (
+        "projects",
+        "spaces",
+        "current map",
+        "project map",
+    )
+    command_prefixes = (
+        "list projects",
+        "list spaces",
+        "show projects",
+        "show spaces",
+        "show current map",
+        "show project map",
+        "open current map",
+        "browse projects",
+        "browse spaces",
+    )
+    return lower_text in exact_phrases or any(lower_text.startswith(prefix) for prefix in command_prefixes)
+
+
+def _project_reference_id(text: str) -> str:
+    prefixes = (
+        "read project ",
+        "open project ",
+        "show project ",
+        "read space ",
+        "open space ",
+        "show space ",
+    )
+    lower = text.lower()
+    raw = ""
+    for prefix in prefixes:
+        if lower.startswith(prefix):
+            raw = text[len(prefix) :].strip()
+            break
+    if not raw:
+        return ""
+    raw = re.sub(r"^https?://huggingface\.co/spaces/", "", raw, flags=re.IGNORECASE)
+    return raw.split()[0].strip(".,;:!?\"'")
+
+
 def _title(text: str) -> str:
     title = text[:64].strip(" .") or "Unwritten Page"
     if any(char.isupper() or char.isdigit() for char in title):

static/app.js

@@ -598,10 +598,15 @@ function handleEvent(event) {
     session.goals = Array.isArray(session.goals) ? session.goals : [];
     session.last_response = event.response || session.last_response || "";
     delete session.ui_status;
+    const toolName = session.last_tool_resolution?.call?.name || "";
+    const projectReferenceOnly =
+      !event.score && !event.artifact?.title && ["list_projects", "get_project"].includes(toolName);
     if (event.score?.echoes?.length) {
       renderCitations(event.score.echoes);
     } else if (event.projects?.length) {
       renderProjects(event.projects);
+    } else if (projectReferenceOnly) {
+      renderProjects([], "No project page matched this request.");
     }
     if (event.whitespace?.length) renderWhitespace(event.whitespace);
     renderGoals(session.goals);
@@ -613,6 +618,8 @@ function handleEvent(event) {
       renderScore(event.score);
       ink.classList.toggle("bleed", event.score.verdict.startsWith("ECHO"));
       ink.classList.toggle("gold", event.score.verdict.startsWith("UNWRITTEN"));
+    } else if (projectReferenceOnly) {
+      renderProjectReferenceState();
     } else if (!event.projects?.length) {
       const idea = currentIdea();
       renderSelectedIdeaSeal(idea);
@@ -627,6 +634,15 @@ function handleEvent(event) {
   }
 }
 
+function renderProjectReferenceState() {
+  currentArtifact = null;
+  renderScore(null);
+  setVerdictDisplay("READY", 0, null);
+  sealCopyEl.textContent = "Project pages are shown below. Score an idea to press a new seal.";
+  ink.classList.remove("bleed", "gold");
+  renderWoodMap(null);
+}
+
 function renderIdeas(ideas) {
   if (ideaCountEl) ideaCountEl.textContent = ideas.length;
   ideasEl.innerHTML = "";

tests/test_agent.py

@@ -179,6 +179,23 @@ def test_planner_get_project_drives_project_response() -> None:
     assert result.tool_events[0].name == "get_project"
 
 
+def test_rule_project_reference_does_not_create_or_score_idea() -> None:
+    index = ProjectIndex.from_files(Path("data/projects.json"), Path("data/project_index.json"))
+    engine = AdvisorEngine(index)
+    first = engine.turn("A local-first archive cartographer for family photos", {})
+
+    result = engine.turn("read project lolaby", first.state)
+
+    assert result.projects
+    assert result.projects[0].slug == "lolaby"
+    assert result.score is None
+    assert result.artifact == {}
+    assert len(result.state["ideas"]) == 1
+    assert result.state["ideas"][0]["title"] == first.artifact["title"]
+    assert result.state["last_artifact"]["title"] == first.artifact["title"]
+    assert result.state["last_tool_resolution"]["call"]["name"] == "get_project"
+
+
 def test_planner_profile_and_goals_update_state() -> None:
     index = ProjectIndex.from_files(Path("data/projects.json"), Path("data/project_index.json"))
     planned = AdvisorEngine(index).turn("A local-first archive cartographer for family photos", {})

tests/test_model_runtime.py

@@ -50,6 +50,32 @@ def test_rule_planner_defaults_blank_to_list_projects() -> None:
     assert resolution.call.name == "list_projects"
 
 
+def test_rule_planner_routes_project_reference_commands() -> None:
+    planner = RuleBasedPlanner()
+
+    listed = planner.plan("show current map", {})
+    project = planner.plan("read project lolaby", {})
+    project_url = planner.plan("open space https://huggingface.co/spaces/build-small-hackathon/lolaby", {})
+
+    assert listed.status == "valid"
+    assert listed.call.name == "list_projects"
+    assert project.status == "valid"
+    assert project.call.name == "get_project"
+    assert project.call.arguments["id"] == "lolaby"
+    assert project_url.status == "valid"
+    assert project_url.call.name == "get_project"
+    assert project_url.call.arguments["id"] == "build-small-hackathon/lolaby"
+
+
+def test_rule_planner_keeps_project_words_inside_ideas() -> None:
+    planner = RuleBasedPlanner()
+
+    resolution = planner.plan("A dashboard that helps teams show projects to mentors", {})
+
+    assert resolution.status == "valid"
+    assert resolution.call.name == "save_idea"
+
+
 def test_rule_planner_splits_explicit_idea_pitch() -> None:
     planner = RuleBasedPlanner()