docs(tools): show safety-tier icons on scope index grid cards

Swap each `grid-item-card` header on the six scope index pages
(server, session, window, pane, buffer, hook) from a plain tool
name + `:link:`/`:link-type:` to an inline `{tooliconl}` role. The
role resolves to the tool's detail page and prefixes the linked
name with the existing emoji safety badge — 🔍 readonly, ✏️
mutating, 💣 destructive — so readers can see each tool's risk
posture at a glance while scanning a scope grid. Dropping `:link:`
avoids nested `<a>` (`{tooliconl}` already produces one); click
target shifts from whole-card to the title link.

Author: tony

docs/tools/buffer/index.md

@@ -7,27 +7,19 @@ There is **no** `list_buffers` tool. The user's OS clipboard often syncs into tm
 ::::{grid} 1 2 2 3
 :gutter: 2 2 3 3
 
-:::{grid-item-card} load_buffer
-:link: load-buffer
-:link-type: ref
+:::{grid-item-card} {tooliconl}`load-buffer`
 Stage content into a new tmux paste buffer.
 :::
 
-:::{grid-item-card} paste_buffer
-:link: paste-buffer
-:link-type: ref
+:::{grid-item-card} {tooliconl}`paste-buffer`
 Push a staged buffer into a pane.
 :::
 
-:::{grid-item-card} show_buffer
-:link: show-buffer
-:link-type: ref
+:::{grid-item-card} {tooliconl}`show-buffer`
 Read a staged buffer's contents back.
 :::
 
-:::{grid-item-card} delete_buffer
-:link: delete-buffer
-:link-type: ref
+:::{grid-item-card} {tooliconl}`delete-buffer`
 Free the server-side state of a staged buffer.
 :::
 

docs/tools/hook/index.md

@@ -13,15 +13,11 @@ Until one of those paths is implemented, the surface here is visibility only.
 ::::{grid} 1 2 2 3
 :gutter: 2 2 3 3
 
-:::{grid-item-card} show_hooks
-:link: show-hooks
-:link-type: ref
+:::{grid-item-card} {tooliconl}`show-hooks`
 Enumerate bindings at a scope.
 :::
 
-:::{grid-item-card} show_hook
-:link: show-hook
-:link-type: ref
+:::{grid-item-card} {tooliconl}`show-hook`
 Inspect a single binding.
 :::
 

docs/tools/pane/index.md

@@ -5,123 +5,83 @@ Pane-scoped tools — read and drive individual terminals, wait for output, copy
 ::::{grid} 1 2 2 3
 :gutter: 2 2 3 3
 
-:::{grid-item-card} capture_pane
-:link: capture-pane
-:link-type: ref
+:::{grid-item-card} {tooliconl}`capture-pane`
 Read visible or scrollback text from a pane.
 :::
 
-:::{grid-item-card} search_panes
-:link: search-panes
-:link-type: ref
+:::{grid-item-card} {tooliconl}`search-panes`
 Search text across many panes in one call.
 :::
 
-:::{grid-item-card} snapshot_pane
-:link: snapshot-pane
-:link-type: ref
+:::{grid-item-card} {tooliconl}`snapshot-pane`
 Capture content plus cursor, mode, and scroll state in one call.
 :::
 
-:::{grid-item-card} get_pane_info
-:link: get-pane-info
-:link-type: ref
+:::{grid-item-card} {tooliconl}`get-pane-info`
 Read pane metadata without content.
 :::
 
-:::{grid-item-card} display_message
-:link: display-message
-:link-type: ref
+:::{grid-item-card} {tooliconl}`display-message`
 Evaluate a tmux format string against a target.
 :::
 
-:::{grid-item-card} send_keys
-:link: send-keys
-:link-type: ref
+:::{grid-item-card} {tooliconl}`send-keys`
 Send keystrokes or commands to a pane.
 :::
 
-:::{grid-item-card} paste_text
-:link: paste-text
-:link-type: ref
+:::{grid-item-card} {tooliconl}`paste-text`
 Paste multi-line text via tmux buffer.
 :::
 
-:::{grid-item-card} pipe_pane
-:link: pipe-pane
-:link-type: ref
+:::{grid-item-card} {tooliconl}`pipe-pane`
 Fork pane output to a file or program.
 :::
 
-:::{grid-item-card} select_pane
-:link: select-pane
-:link-type: ref
+:::{grid-item-card} {tooliconl}`select-pane`
 Switch focus to a pane.
 :::
 
-:::{grid-item-card} swap_pane
-:link: swap-pane
-:link-type: ref
+:::{grid-item-card} {tooliconl}`swap-pane`
 Swap two panes' positions.
 :::
 
-:::{grid-item-card} set_pane_title
-:link: set-pane-title
-:link-type: ref
+:::{grid-item-card} {tooliconl}`set-pane-title`
 Set a pane's human-readable title.
 :::
 
-:::{grid-item-card} clear_pane
-:link: clear-pane
-:link-type: ref
+:::{grid-item-card} {tooliconl}`clear-pane`
 Clear a pane's scrollback.
 :::
 
-:::{grid-item-card} resize_pane
-:link: resize-pane
-:link-type: ref
+:::{grid-item-card} {tooliconl}`resize-pane`
 Resize a pane.
 :::
 
-:::{grid-item-card} enter_copy_mode
-:link: enter-copy-mode
-:link-type: ref
+:::{grid-item-card} {tooliconl}`enter-copy-mode`
 Enter tmux copy mode for scrollback navigation.
 :::
 
-:::{grid-item-card} exit_copy_mode
-:link: exit-copy-mode
-:link-type: ref
+:::{grid-item-card} {tooliconl}`exit-copy-mode`
 Exit copy mode.
 :::
 
-:::{grid-item-card} wait_for_text
-:link: wait-for-text
-:link-type: ref
+:::{grid-item-card} {tooliconl}`wait-for-text`
 Block until a pattern appears in a pane.
 :::
 
-:::{grid-item-card} wait_for_content_change
-:link: wait-for-content-change
-:link-type: ref
+:::{grid-item-card} {tooliconl}`wait-for-content-change`
 Block until pane content changes.
 :::
 
-:::{grid-item-card} wait_for_channel
-:link: wait-for-channel
-:link-type: ref
+:::{grid-item-card} {tooliconl}`wait-for-channel`
 Block until a tmux wait-for channel is signalled.
 :::
 
-:::{grid-item-card} signal_channel
-:link: signal-channel
-:link-type: ref
+:::{grid-item-card} {tooliconl}`signal-channel`
 Signal a waiting channel.
 :::
 
-:::{grid-item-card} kill_pane
-:link: kill-pane
-:link-type: ref
+:::{grid-item-card} {tooliconl}`kill-pane`
 Terminate a pane. Destructive.
 :::
 

docs/tools/server/index.md

@@ -5,57 +5,39 @@ Server & process-level tools — discover sessions, control the tmux daemon, rea
 ::::{grid} 1 2 2 3
 :gutter: 2 2 3 3
 
-:::{grid-item-card} list_sessions
-:link: list-sessions
-:link-type: ref
+:::{grid-item-card} {tooliconl}`list-sessions`
 List all sessions on the tmux server.
 :::
 
-:::{grid-item-card} list_servers
-:link: list-servers
-:link-type: ref
+:::{grid-item-card} {tooliconl}`list-servers`
 Discover tmux daemons on the system.
 :::
 
-:::{grid-item-card} get_server_info
-:link: get-server-info
-:link-type: ref
+:::{grid-item-card} {tooliconl}`get-server-info`
 Query server process identity and version.
 :::
 
-:::{grid-item-card} create_session
-:link: create-session
-:link-type: ref
+:::{grid-item-card} {tooliconl}`create-session`
 Create a new tmux session.
 :::
 
-:::{grid-item-card} kill_server
-:link: kill-server
-:link-type: ref
+:::{grid-item-card} {tooliconl}`kill-server`
 Terminate the tmux daemon. Destructive.
 :::
 
-:::{grid-item-card} show_option
-:link: show-option
-:link-type: ref
+:::{grid-item-card} {tooliconl}`show-option`
 Read a tmux option (server / session / window / pane scope).
 :::
 
-:::{grid-item-card} set_option
-:link: set-option
-:link-type: ref
+:::{grid-item-card} {tooliconl}`set-option`
 Set a tmux option.
 :::
 
-:::{grid-item-card} show_environment
-:link: show-environment
-:link-type: ref
+:::{grid-item-card} {tooliconl}`show-environment`
 Read the server's environment variables.
 :::
 
-:::{grid-item-card} set_environment
-:link: set-environment
-:link-type: ref
+:::{grid-item-card} {tooliconl}`set-environment`
 Set an environment variable on the server.
 :::
 

docs/tools/session/index.md

@@ -5,33 +5,23 @@ Session-scoped tools — enumerate windows, rename or kill a session, switch win
 ::::{grid} 1 2 2 3
 :gutter: 2 2 3 3
 
-:::{grid-item-card} list_windows
-:link: list-windows
-:link-type: ref
+:::{grid-item-card} {tooliconl}`list-windows`
 Enumerate windows inside a session.
 :::
 
-:::{grid-item-card} select_window
-:link: select-window
-:link-type: ref
+:::{grid-item-card} {tooliconl}`select-window`
 Switch to a window by id, index, or direction.
 :::
 
-:::{grid-item-card} create_window
-:link: create-window
-:link-type: ref
+:::{grid-item-card} {tooliconl}`create-window`
 Create a new window inside a session.
 :::
 
-:::{grid-item-card} rename_session
-:link: rename-session
-:link-type: ref
+:::{grid-item-card} {tooliconl}`rename-session`
 Rename an existing session.
 :::
 
-:::{grid-item-card} kill_session
-:link: kill-session
-:link-type: ref
+:::{grid-item-card} {tooliconl}`kill-session`
 Terminate a session. Destructive.
 :::
 

docs/tools/window/index.md

@@ -5,45 +5,31 @@ Window-scoped tools — enumerate panes, split / rename / relayout / resize / mo
 ::::{grid} 1 2 2 3
 :gutter: 2 2 3 3
 
-:::{grid-item-card} list_panes
-:link: list-panes
-:link-type: ref
+:::{grid-item-card} {tooliconl}`list-panes`
 Enumerate panes inside a window.
 :::
 
-:::{grid-item-card} split_window
-:link: split-window
-:link-type: ref
+:::{grid-item-card} {tooliconl}`split-window`
 Split a window into a new pane.
 :::
 
-:::{grid-item-card} rename_window
-:link: rename-window
-:link-type: ref
+:::{grid-item-card} {tooliconl}`rename-window`
 Rename an existing window.
 :::
 
-:::{grid-item-card} select_layout
-:link: select-layout
-:link-type: ref
+:::{grid-item-card} {tooliconl}`select-layout`
 Apply one of tmux's named layouts.
 :::
 
-:::{grid-item-card} resize_window
-:link: resize-window
-:link-type: ref
+:::{grid-item-card} {tooliconl}`resize-window`
 Resize a window (client view).
 :::
 
-:::{grid-item-card} move_window
-:link: move-window
-:link-type: ref
+:::{grid-item-card} {tooliconl}`move-window`
 Reorder a window or move it across sessions.
 :::
 
-:::{grid-item-card} kill_window
-:link: kill-window
-:link-type: ref
+:::{grid-item-card} {tooliconl}`kill-window`
 Terminate a window. Destructive.
 :::