fix: make example notes builder-facing

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

README.md

@@ -66,7 +66,7 @@ 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, selected goals, idea board, cited Spaces, latest build plan, planner calls, and the share caption. This
+builder profile, selected goals, idea board, cited Spaces, latest build plan, advisor actions, and the share caption. This
 keeps the note tied to auditable app evidence instead of a separate hand-written summary.
 
 ## Chapter Artifact

hackathon_advisor/field_notes.py

@@ -53,12 +53,12 @@ def build_field_notes_markdown(session: dict[str, Any], metadata: dict[str, Any]
     else:
         lines.append("No build plan has been generated yet.")
 
-    lines.extend(["", "## Turn Trace", ""])
+    lines.extend(["", "## Session Decisions", ""])
     if trace:
         for index, event in enumerate(trace, start=1):
-            lines.extend(_trace_section(index, event))
+            lines.extend(_decision_section(index, event))
     else:
-        lines.append("No tool trace was recorded.")
+        lines.append("No session decisions were recorded.")
 
     wood_map = last_artifact.get("wood_map") if isinstance(last_artifact.get("wood_map"), dict) else {}
     if wood_map:
@@ -122,14 +122,14 @@ def _idea_section(index: int, idea: dict[str, Any]) -> list[str]:
     return lines
 
 
-def _trace_section(index: int, event: dict[str, Any]) -> list[str]:
+def _decision_section(index: int, event: dict[str, Any]) -> list[str]:
     tools = _list_of_dicts(event.get("tools"))
-    tool_names = " -> ".join(_clean(tool.get("name")) for tool in tools if tool.get("name")) or "reply"
+    action_names = " -> ".join(_clean(tool.get("name")) for tool in tools if tool.get("name")) or "reply"
     lines = [
-        f"### Turn {index}",
+        f"### Decision {index}",
         "",
         f"- Input: {_clean(event.get('input'))}",
-        f"- Tools: {tool_names}",
+        f"- Advisor actions: {action_names}",
     ]
     verdict = _clean(event.get("verdict"))
     overall = event.get("overall")
@@ -141,7 +141,7 @@ def _trace_section(index: int, event: dict[str, Any]) -> list[str]:
     resolution = event.get("tool_resolution") if isinstance(event.get("tool_resolution"), dict) else {}
     call = resolution.get("call") if isinstance(resolution.get("call"), dict) else {}
     if call:
-        lines.append(f"- Planner call: `{_clean(call.get('name'))}`")
+        lines.append(f"- Recorded action: `{_clean(call.get('name'))}`")
     lines.append("")
     return lines
 

static/app.js

@@ -385,7 +385,7 @@ function applyDemoSession(data) {
   session.profile = session.profile || {};
   session.goals = Array.isArray(session.goals) ? session.goals : [];
   session.last_response = data.response || session.last_response || "";
-  session.ui_status = `Example loaded: ${data.turn_count || 0} advisor turns`;
+  session.ui_status = "Example idea board loaded with a plan and share page.";
   currentArtifact = data.artifact || session.last_artifact || null;
   ink.textContent = data.response || "Example session loaded.";
   ink.classList.remove("thinking");

tests/test_app.py

@@ -73,7 +73,9 @@ def test_field_notes_endpoint_exports_markdown() -> None:
     assert "Skills: frontend" in payload
     assert "Goals: Build notes" in payload
     assert "Targets: Field Notes" not in payload
-    assert "## Turn Trace" in payload
+    assert "## Session Decisions" in payload
+    assert "## Turn Trace" not in payload
+    assert "Planner call" not in payload
     assert "Write build notes from the exact decisions" in payload
 
 

tests/test_field_notes.py

@@ -31,8 +31,13 @@ def test_field_notes_markdown_contains_session_decisions() -> None:
     assert "A local-first archive cartographer for family photos" in markdown
     assert "## Build Plan" in markdown
     assert "Write build notes from the exact decisions" in markdown
+    assert "## Session Decisions" in markdown
+    assert "### Decision 2" in markdown
+    assert "Recorded action: `make_plan`" in markdown
     assert "Closest cited Spaces" in markdown
     assert "Page " in markdown
     assert "## Wood Map" in markdown
     assert "echo score" in markdown
-    assert "Planner call: `make_plan`" in markdown
+    assert "## Turn Trace" not in markdown
+    assert "Planner call" not in markdown
+    assert "tool trace" not in markdown.lower()

tests/test_frontend_copy.py

@@ -10,6 +10,7 @@ def test_main_interface_copy_is_builder_facing() -> None:
     assert "Closest project echoes" in html
     assert "Press Plan to draft build steps for the selected idea." in app_js
     assert "Loading an example idea board." in app_js
+    assert "Example idea board loaded with a plan and share page." in app_js
     assert "/api/artifact.png" in app_js
     assert "renderArtifactCanvas" not in app_js
     assert "canvas.toDataURL" not in app_js
@@ -25,6 +26,7 @@ def test_main_interface_copy_is_builder_facing() -> None:
         "Still riffling the inked pages.",
         "YOU VS THE WOOD",
         "current Wood",
+        "advisor turns",
     ]
     for phrase in stale_jargon:
         assert phrase not in combined