fix(docs-gen): smarter sentence split for frontmatter descriptions

PR #1157 review (Copilot + CodeRabbit) flagged that several tool pages
had truncated frontmatter, e.g. manage_asset rendering as:
  description: "Performs asset operations (import, create, modify, delete, etc"

Root cause: the generator used `description.split(".")[0]` to derive the
frontmatter blurb. That cuts at the FIRST period — including periods
inside abbreviations and parenthesized lists ("etc.) in Unity."), so
the rendered description stopped mid-clause.

Fix: introduce `_first_sentence()` that splits on real sentence
boundaries — `.` / `!` / `?` followed by whitespace + capital, or a
paragraph break — and falls back to the whole string if no boundary
exists. Also caps absurdly long single-sentence descriptions at ~240
chars to keep frontmatter compact.

All three call sites that used the old split:
- frontmatter `description:` in render_tool_page
- group-index bullets in render_group_index
- catalog-index bullets in render_catalog_index

Regenerated all 43 tool pages + 9 group landings + catalog index +
resources catalog. Verified `--check` passes round-trip and full
website build is clean.

manage_asset now reads: "Performs asset operations (import, create,
modify, delete, etc.) in Unity."

Author: Scriptwonder

tools/generate_docs_reference.py

@@ -227,6 +227,33 @@ def introspect_params(func: Any) -> list[ParamDoc]:
 # ---------------------------------------------------------------------------
 
 
+_SENTENCE_BOUNDARY = re.compile(r"(?<=[.!?])\s+(?=[A-Z])|\n\s*\n")
+
+
+def _first_sentence(description: str) -> str:
+    """Return the first sentence of a tool description, suitable for
+    frontmatter / catalog blurbs.
+
+    The earlier implementation used `description.split(".")[0]` which
+    cut the string at the first period — including periods inside
+    abbreviations and parenthesized lists (e.g. `etc.) in Unity`),
+    producing truncated frontmatter like `"...modify, delete, etc"`.
+
+    Split on a real sentence boundary instead: a `.`, `!`, or `?`
+    followed by whitespace + a capital letter (or a paragraph break).
+    Fall back to the entire string if no boundary is found, then
+    smart-truncate to keep frontmatter compact.
+    """
+    text = (description or "").strip().replace('"', "'")
+    if not text:
+        return ""
+    first = _SENTENCE_BOUNDARY.split(text, maxsplit=1)[0].strip()
+    # Cap absurdly long single-sentence descriptions
+    if len(first) > 240:
+        first = first[:237].rstrip() + "…"
+    return first
+
+
 def _escape_table_cell(s: str) -> str:
     return s.replace("|", "\\|").replace("\n", " ")
 
@@ -262,7 +289,7 @@ def render_tool_page(tool: dict[str, Any], existing_examples: str) -> str:
     params = introspect_params(func)
 
     # Sidebar/title metadata
-    desc_for_meta = description.split(".")[0].strip().replace('"', "'") or name
+    desc_for_meta = _first_sentence(description) or name
     front_matter = textwrap.dedent(
         f"""\
         ---
@@ -315,7 +342,7 @@ def render_group_index(group: str, tools: list[dict[str, Any]], group_blurb: str
     bullets = []
     for tool in sorted(tools, key=lambda t: t["name"]):
         n = tool["name"]
-        d = (tool.get("description") or "").split(".")[0].strip()
+        d = _first_sentence(tool.get("description") or "")
         bullets.append(f"- **[`{n}`](./{n}.md)** — {d}")
     body = "\n".join(bullets) if bullets else "_No tools in this group._"
 
@@ -354,7 +381,7 @@ def render_catalog_index(tools_by_group: dict[str, list[dict[str, Any]]],
         sections.append(group_blurbs.get(group, ""))
         for tool in sorted(tools, key=lambda t: t["name"]):
             n = tool["name"]
-            d = (tool.get("description") or "").split(".")[0].strip()
+            d = _first_sentence(tool.get("description") or "")
             sections.append(f"- **[`{n}`](./{group}/{n}.md)** — {d}")
         sections.append("")
 

website/docs/reference/tools/animation/index.md

@@ -8,4 +8,4 @@ description: "MCP for Unity tools in the animation group."
 
 Animator control & AnimationClip creation
 
-- **[`manage_animation`](./manage_animation.md)** — Manage Unity animation: Animator control and AnimationClip creation
+- **[`manage_animation`](./manage_animation.md)** — Manage Unity animation: Animator control and AnimationClip creation.

website/docs/reference/tools/animation/manage_animation.md

@@ -1,7 +1,7 @@
 ---
 title: manage_animation
 sidebar_label: manage_animation
-description: "Manage Unity animation: Animator control and AnimationClip creation"
+description: "Manage Unity animation: Animator control and AnimationClip creation."
 ---
 
 # `manage_animation`

website/docs/reference/tools/core/apply_text_edits.md

@@ -1,7 +1,7 @@
 ---
 title: apply_text_edits
 sidebar_label: apply_text_edits
-description: "Apply small text edits to a C# script identified by URI"
+description: "Apply small text edits to a C# script identified by URI."
 ---
 
 # `apply_text_edits`

website/docs/reference/tools/core/batch_execute.md

@@ -1,7 +1,7 @@
 ---
 title: batch_execute
 sidebar_label: batch_execute
-description: "Executes multiple MCP commands in a single batch for dramatically better performance"
+description: "Executes multiple MCP commands in a single batch for dramatically better performance."
 ---
 
 # `batch_execute`

website/docs/reference/tools/core/create_script.md

@@ -1,7 +1,7 @@
 ---
 title: create_script
 sidebar_label: create_script
-description: "Create a new C# script at the given project path"
+description: "Create a new C# script at the given project path."
 ---
 
 # `create_script`

website/docs/reference/tools/core/debug_request_context.md

@@ -1,7 +1,7 @@
 ---
 title: debug_request_context
 sidebar_label: debug_request_context
-description: "Return the current FastMCP request context details (client_id, session_id, and meta dump)"
+description: "Return the current FastMCP request context details (client_id, session_id, and meta dump)."
 ---
 
 # `debug_request_context`

website/docs/reference/tools/core/delete_script.md

@@ -1,7 +1,7 @@
 ---
 title: delete_script
 sidebar_label: delete_script
-description: "Delete a C# script by URI or Assets-relative path"
+description: "Delete a C# script by URI or Assets-relative path."
 ---
 
 # `delete_script`

website/docs/reference/tools/core/execute_custom_tool.md

@@ -1,7 +1,7 @@
 ---
 title: execute_custom_tool
 sidebar_label: execute_custom_tool
-description: "Execute a project-scoped custom tool registered by Unity"
+description: "Execute a project-scoped custom tool registered by Unity."
 ---
 
 # `execute_custom_tool`

website/docs/reference/tools/core/execute_menu_item.md

@@ -1,7 +1,7 @@
 ---
 title: execute_menu_item
 sidebar_label: execute_menu_item
-description: "Execute a Unity menu item by path"
+description: "Execute a Unity menu item by path."
 ---
 
 # `execute_menu_item`