docs(toolsets): Declare the vocabulary the badges need

why: gp-sphinx no longer ships a default vocabulary, so a project that
declares none renders every tool without a toolset badge. That is the
right default there — a docs tool should not badge a project's tools
with words it never used — and it makes declaring one this project's
job.

The pin also moves to an exact rev. A branch ref resolves to whatever
that branch pointed at when the cache was warmed, which is not a thing
a lockfile should depend on.

what:
- Declare `fastmcp_toolsets` in `docs/conf.py`, in precedence order,
  with the tooltip and icon each badge carries
- Retitle the hand-written tool groups from Inspect/Act/Destroy to the
  four toolsets, splitting Act into `manage` and `execute`
- Pin `sphinx-autodoc-fastmcp` to a rev rather than a branch

Author: tony

docs/conf.py

@@ -173,6 +173,31 @@ def _patched_tool_collector_tool(self: ToolCollector, **kwargs: t.Any) -> t.Any:
     "BufferRef",
     "BufferContent",
 )
+# sphinx-autodoc-fastmcp ships no default vocabulary: it documents
+# projects whose tags it does not choose. Declaration order is
+# precedence, and the summary tables follow it.
+conf["fastmcp_toolsets"] = (
+    {
+        "tag": "teardown",
+        "tooltip": "Teardown \u2014 deletes tmux objects or scrollback",
+        "icon": "\U0001f4a3",
+    },
+    {
+        "tag": "execute",
+        "tooltip": "Execute \u2014 starts or drives a pane process",
+        "icon": "\u270f\ufe0f",
+    },
+    {
+        "tag": "manage",
+        "tooltip": "Manage \u2014 changes tmux structure or presentation",
+        "icon": "\U0001f527",
+    },
+    {
+        "tag": "inspect",
+        "tooltip": "Inspect \u2014 reads tmux state and terminal output",
+        "icon": "\U0001f50d",
+    },
+)
 conf["fastmcp_section_badge_map"] = {
     "Inspect": "inspect",
     "Execute": "execute",

docs/tools/index.md

@@ -82,7 +82,8 @@ shell-agnostic guidance.
 
 ## Inspect
 
-Read tmux state without changing anything.
+Read tmux state and terminal output. Starts no process, and hands no input
+of yours to one.
 
 ::::{grid} 1 2 3 3
 :gutter: 2 2 3 3
@@ -215,9 +216,14 @@ Inspect a single tmux hook by name.
 
 ::::
 
-## Act
+## Manage
 
-Create or modify tmux objects.
+Change tmux structure or presentation. Takes no input of yours that anything
+later executes.
+
+## Execute
+
+Start a pane process, deliver input to one, or store a value tmux later runs.
 
 ::::{grid} 1 2 3 3
 :gutter: 2 2 3 3
@@ -392,9 +398,9 @@ Wake clients blocked on a ``wait-for`` channel.
 
 ::::
 
-## Destroy
+## Teardown
 
-Tear down tmux objects. Not reversible.
+Delete tmux objects or retained scrollback. Not reversible.
 
 ::::{grid} 1 2 3 3
 :gutter: 2 2 3 3

pyproject.toml

@@ -119,7 +119,7 @@ build-backend = "hatchling.build"
 # sphinx-vite-builder, which needs pnpm that CI runners do not carry.
 # Revert once #77 lands and a release is cut.
 [tool.uv.sources]
-sphinx-autodoc-fastmcp = { git = "https://github.com/git-pull/gp-sphinx", branch = "scope-overhaul", subdirectory = "packages/sphinx-autodoc-fastmcp" }
+sphinx-autodoc-fastmcp = { git = "https://github.com/git-pull/gp-sphinx", rev = "4cc6cf4069fcf06853dd473a803079e10d007755", subdirectory = "packages/sphinx-autodoc-fastmcp" }
 
 [tool.uv.exclude-newer-package]
 # git-pull packages release in lockstep with their workspaces, so a