fix: label exported goals for users

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

README.md

@@ -66,18 +66,18 @@ is intentionally kept out of the main user workflow.
 ## Field Notes Artifact
 
 The `field_notes` Gradio API endpoint and `Notes` button export a Markdown build note from the exact session state:
-builder profile, target badges, idea board, cited Spaces, latest build plan, planner calls, and the share caption. This
-keeps the Field Notes badge path tied to auditable app evidence instead of a separate hand-written summary.
+builder profile, selected goals, idea board, cited Spaces, latest build plan, planner calls, and the share caption. This
+keeps the note tied to auditable app evidence instead of a separate hand-written summary.
 
 ## Chapter Artifact
 
 The `chapter` Gradio API endpoint and `Chapter` button export the public-facing idea board as an Almanac chapter:
-one fate page per idea, each with verdict, score, targets, and closest cited pages. It is the shareable companion to
-the private Field Notes artifact.
+one idea page per saved direction, each with verdict, score, selected goals, and closest cited pages. It is the
+shareable companion to the working notes artifact.
 
 ## Idea Board Ranking
 
-The `Rank` command rescans the saved idea board, recalculates each seal against the current targets, selects the
+The `Rank` command rescans the saved idea board, recalculates each seal against the selected goals, selects the
 strongest page as the active idea, and drafts the next build step. The app then moves that page to the top of the Idea
 Board and refreshes the seal, wood map, plan, and PNG artifact around the chosen direction.
 Users can also click any Idea Board page to make it current before pressing `Plan`.
@@ -121,7 +121,7 @@ as the app instead of a separate hand-curated checklist.
 ## Demo Rehearsal
 
 `/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
+selected goals, 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.
 
@@ -151,7 +151,7 @@ watchdog updates the page text so the demo never sits in a silent blank state du
 
 ## Session Persistence
 
-The frontend stores the current advisor session in browser `localStorage`: profile notes, selected targets, idea board,
+The frontend stores the current advisor session in browser `localStorage`: profile notes, selected goals, idea board,
 trace, latest build plan, and last share artifact. Refreshing the Space restores the same cockpit state; the `Reset`
 button clears the saved session and returns to the current snapshot defaults.
 

hackathon_advisor/chapter.py

@@ -3,22 +3,24 @@ from __future__ import annotations
 from datetime import datetime, timezone
 from typing import Any
 
+from hackathon_advisor.tools import target_label
+
 
 def build_chapter_markdown(session: dict[str, Any], metadata: dict[str, Any]) -> str:
     ideas = _list_of_dicts(session.get("ideas"))
-    targets = [str(target) for target in session.get("targets") or []]
+    goals = _goal_labels(session.get("targets"))
     artifact = session.get("last_artifact") if isinstance(session.get("last_artifact"), dict) else {}
     lines = [
         "# The Unwritten Almanac Chapter",
         "",
         f"Generated: {datetime.now(timezone.utc).isoformat(timespec='seconds')}",
         f"Snapshot: {_clean(metadata.get('snapshot_generated_at'))} · {_clean(metadata.get('project_count'))} pages",
-        f"Targets: {', '.join(targets) if targets else 'No specific targets'}",
+        f"Goals: {', '.join(goals) if goals else 'No specific goals'}",
         "",
     ]
 
     if not ideas:
-        lines.extend(["No fate pages have been written yet.", ""])
+        lines.extend(["No idea pages have been written yet.", ""])
         return "\n".join(lines)
 
     for index, idea in enumerate(ideas, start=1):
@@ -33,7 +35,7 @@ def build_chapter_markdown(session: dict[str, Any], metadata: dict[str, Any]) ->
 def _idea_page(index: int, idea: dict[str, Any]) -> list[str]:
     title = _clean(idea.get("title") or f"Page {index}")
     pitch = _clean(idea.get("pitch"))
-    targets = [str(target) for target in idea.get("targets") or []]
+    goals = _goal_labels(idea.get("targets"))
     score = idea.get("score") if isinstance(idea.get("score"), dict) else {}
     verdict = _clean(score.get("verdict")) if score else "DRAFT"
     overall = _clean(score.get("overall")) if score else "0.0"
@@ -41,14 +43,14 @@ def _idea_page(index: int, idea: dict[str, Any]) -> list[str]:
         f"## Page {index}: {title}",
         "",
         f"Verdict: {verdict} · {overall}/10",
-        f"Targets: {', '.join(targets) if targets else 'No specific targets'}",
+        f"Goals: {', '.join(goals) if goals else 'No specific goals'}",
         "",
-        pitch or "No prophecy text recorded.",
+        pitch or "No pitch recorded.",
         "",
     ]
     echoes = _list_of_dicts(score.get("echoes")) if score else []
     if echoes:
-        lines.extend(["Closest inked pages:", ""])
+        lines.extend(["Closest cited pages:", ""])
         for echo in echoes[:3]:
             project = echo.get("project") if isinstance(echo.get("project"), dict) else {}
             page = _clean(echo.get("page_number")) or "?"
@@ -69,6 +71,12 @@ def _list_of_dicts(value: Any) -> list[dict[str, Any]]:
     return [item for item in value if isinstance(item, dict)]
 
 
+def _goal_labels(value: Any) -> list[str]:
+    if not isinstance(value, list):
+        return []
+    return [target_label(str(target)) for target in value]
+
+
 def _clean(value: Any) -> str:
     if value is None:
         return ""

hackathon_advisor/field_notes.py

@@ -3,12 +3,14 @@ from __future__ import annotations
 from datetime import datetime, timezone
 from typing import Any
 
+from hackathon_advisor.tools import target_label
+
 
 def build_field_notes_markdown(session: dict[str, Any], metadata: dict[str, Any]) -> str:
     ideas = _list_of_dicts(session.get("ideas"))
     trace = _list_of_dicts(session.get("trace"))
     profile = session.get("profile") if isinstance(session.get("profile"), dict) else {}
-    targets = [str(target) for target in session.get("targets") or []]
+    goals = _goal_labels(session.get("targets"))
     last_plan = [str(step) for step in session.get("last_plan") or []]
     last_artifact = session.get("last_artifact") if isinstance(session.get("last_artifact"), dict) else {}
 
@@ -35,7 +37,7 @@ def build_field_notes_markdown(session: dict[str, Any], metadata: dict[str, Any]
                 lines.append(f"- {field.title()}: {value}")
     else:
         lines.append("- No profile notes recorded.")
-    lines.append(f"- Targets: {', '.join(targets) if targets else 'No specific targets'}")
+    lines.append(f"- Goals: {', '.join(goals) if goals else 'No specific goals'}")
 
     lines.extend(["", "## Idea Board", ""])
     if ideas:
@@ -49,7 +51,7 @@ def build_field_notes_markdown(session: dict[str, Any], metadata: dict[str, Any]
         for index, step in enumerate(last_plan, start=1):
             lines.append(f"{index}. {_clean(step)}")
     else:
-        lines.append("No build plan was pressed yet.")
+        lines.append("No build plan has been generated yet.")
 
     lines.extend(["", "## Turn Trace", ""])
     if trace:
@@ -89,13 +91,13 @@ def build_field_notes_markdown(session: dict[str, Any], metadata: dict[str, Any]
 def _idea_section(index: int, idea: dict[str, Any]) -> list[str]:
     title = _clean(idea.get("title") or f"Idea {index}")
     pitch = _clean(idea.get("pitch"))
-    targets = [str(target) for target in idea.get("targets") or []]
+    goals = _goal_labels(idea.get("targets"))
     score = idea.get("score") if isinstance(idea.get("score"), dict) else {}
     lines = [
         f"### {index}. {title}",
         "",
         f"- Pitch: {pitch or 'No pitch recorded.'}",
-        f"- Targets: {', '.join(targets) if targets else 'No specific targets'}",
+        f"- Goals: {', '.join(goals) if goals else 'No specific goals'}",
     ]
     if score:
         lines.append(f"- Seal: {_clean(score.get('overall'))}/10 - {_clean(score.get('verdict'))}")
@@ -150,6 +152,12 @@ def _list_of_dicts(value: Any) -> list[dict[str, Any]]:
     return [item for item in value if isinstance(item, dict)]
 
 
+def _goal_labels(value: Any) -> list[str]:
+    if not isinstance(value, list):
+        return []
+    return [target_label(str(target)) for target in value]
+
+
 def _clean(value: Any) -> str:
     if value is None:
         return ""

tests/test_app.py

@@ -69,7 +69,8 @@ def test_field_notes_endpoint_exports_markdown() -> None:
 
     assert payload.startswith("# Hackathon Advisor Field Notes")
     assert "Skills: frontend" in payload
-    assert "Targets: Field Notes" in payload
+    assert "Goals: Build notes" in payload
+    assert "Targets: Field Notes" not in payload
     assert "## Turn Trace" in payload
     assert "Record the trace and write build notes" in payload
 
@@ -83,7 +84,9 @@ def test_chapter_endpoint_exports_markdown() -> None:
     assert payload.startswith("# The Unwritten Almanac Chapter")
     assert "## Page 1:" in payload
     assert "## Page 2:" in payload
-    assert "Closest inked pages:" in payload
+    assert "Goals:" in payload
+    assert "Targets:" not in payload
+    assert "Closest cited pages:" in payload
 
 
 def test_lora_dataset_endpoint_exports_sft_jsonl() -> None:

tests/test_chapter.py

@@ -23,8 +23,9 @@ def test_chapter_markdown_contains_idea_pages_and_citations() -> None:
     assert markdown.startswith("# The Unwritten Almanac Chapter")
     assert "## Page 1:" in markdown
     assert "## Page 2:" in markdown
-    assert "Targets:" in markdown
-    assert "Closest inked pages:" in markdown
+    assert "Goals:" in markdown
+    assert "Targets:" not in markdown
+    assert "Closest cited pages:" in markdown
     assert "Page 30:" in markdown
 
 
@@ -37,4 +38,4 @@ def test_empty_chapter_markdown_is_explicit() -> None:
         },
     )
 
-    assert "No fate pages have been written yet." in markdown
+    assert "No idea pages have been written yet." in markdown

tests/test_field_notes.py

@@ -26,7 +26,8 @@ def test_field_notes_markdown_contains_session_decisions() -> None:
 
     assert "# Hackathon Advisor Field Notes" in markdown
     assert "frontend prototyping" in markdown
-    assert "Targets: Field Notes" in markdown
+    assert "Goals: Build notes" in markdown
+    assert "Targets: Field Notes" not in markdown
     assert "A local-first archive cartographer for family photos" in markdown
     assert "## Build Plan" in markdown
     assert "Record the trace and write build notes" in markdown