Render toolkit documentation chunks consistently

[jottakka]

Summary

• centralize documentation-chunk ordering for rendered toolkit pages
• include the same before/replace/after content in copied Markdown

Test plan

• pnpm exec vitest run tests/documentation-chunks.test.ts tests/toolkit-markdown.test.ts

---

Note

Low Risk
Documentation serialization and refactor only; no auth, API, or data-path changes.

Overview
Centralizes documentation-chunk ordering in sortDocumentationChunks and wires the page renderer’s sortChunksDeterministically export to that shared helper so UI and exports use the same priority → header → content ordering.

Extends toToolkitMarkdown so copied/agent markdown includes toolkit- and tool-level documentationChunks at the same injection points as the live docs: before / replace / after per location (description, parameters, auth, header, footer, etc.). replace chunks override default sections (e.g. custom parameters text instead of the table); whitespace-only replacements still suppress the default block.

Tests cover sorting edge cases, chunk placement, replacement behavior, and repeated content across locations.

^{Reviewed by Cursor Bugbot for commit 90aab58. Bugbot is set up for automated code reviews on this repo. Configure here.}

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
docs	Ready	Preview, Comment	Jul 16, 2026 8:20pm

[cursor]

Cursor Bugbot has reviewed your changes using high effort and found 2 potential issues.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 90aab58. Configure here.}

[cursor]

Current version of PR was reviewed by /review-bugbot on Jul 16, 15:51 GMT-3. It flagged 1 finding.

Show 1 finding

1. Chunk headers omitted from markdown

app/_lib/toolkit-markdown.ts:30 · Medium Severity

documentationBlocks serializes only chunk.content and never chunk.header, so copy-page markdown diverges from the toolkit docs UI where ChunkContent renders header as the callout/section title. Chunks that keep title and body separate also disappear entirely when content is empty, because the loop skips any chunk whose trimmed content is falsy.

^{Bugbot on commit d166368 is skipped.}