From 1b8b83fee1e083df04d889265d1bf18f9f7b2eb6 Mon Sep 17 00:00:00 2001
From: iris <iris@hyperhive.local>
Date: Sat, 4 Jul 2026 18:32:04 +0200
Subject: [PATCH] fix(terminal-rendering): move fmtToolUse table after numbered
 list

The heading was inserted between items 3 and 4, breaking GFM ordered
list numbering (Forgejo renders items 4+ restarting at 1). Move the
subsection to after item 5 and update the in-prose reference to use
an anchor link instead of 'see table below'.
---
 docs/terminal-rendering.md | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/docs/terminal-rendering.md b/docs/terminal-rendering.md
index a7eb5f23..d535cc3c 100644
--- a/docs/terminal-rendering.md
+++ b/docs/terminal-rendering.md
@@ -122,8 +122,15 @@ suffix, so the terminal degrades cleanly against older event shapes.
      custom renderings); on miss fall through to a flat
      `.tool-use` row with `fmtToolUse → fmtArgsGeneric`.
      `fmtToolUse` surfaces the salient arg per built-in tool
-     (see table below); `fmtArgsGeneric` handles everything
-     else.
+     (see [`fmtToolUse` patterns](#fmttooluse-patterns) below);
+     `fmtArgsGeneric` handles everything else.
+4. `type == "user"` → walk `message.content[]` for
+   `tool_result`; `renderToolResult` correlates via
+   `tool_use_id → toolNameById` to default-open `recv`
+   results with a markdown body, else short = flat /
+   long = collapsed details.
+5. Unrecognised shape → `.sys` row (amber, `!` glyph).
+
 ### `fmtToolUse` patterns
 
 The `short` name strips the `mcp__hyperhive__` / `mcp__bash__` /
@@ -180,13 +187,6 @@ name as-is.
 | `download_file*` | `download_file* room` |
 | **Everything else** | `fmtArgsGeneric` — see [Extra-MCP tools](#extra-mcp-tools) |
 
-4. `type == "user"` → walk `message.content[]` for
-   `tool_result`; `renderToolResult` correlates via
-   `tool_use_id → toolNameById` to default-open `recv`
-   results with a markdown body, else short = flat /
-   long = collapsed details.
-5. Unrecognised shape → `.sys` row (amber, `!` glyph).
-
 ## Markdown
 
 `mdNode(text)` wraps `marked.parse(text)` (the `marked` v4.x npm