Keep generated sidebar links aligned with toolkit routes

[jottakka]

Summary

• reuse the canonical toolkit-slug contract when generating sidebar metadata
• normalize invalid categories and safely serialize generated labels and keys

Dependency

Depends on #1065 for the shared route and slug contract.

Test plan

• pnpm exec vitest run --root toolkit-docs-generator --config vitest.config.ts tests/scripts/sync-toolkit-sidebar.test.ts

---

Note

Low Risk
Docs-generator-only changes with stricter slug/category validation; depends on the shared slug module from #1065.

Overview
Generated integrations sidebar metadata now uses the shared getToolkitSlug helper instead of local slug parsing, so nav hrefs match app static routes and unsafe docsLink segments fall back to kebab-case or normalized IDs.

Category paths are clamped with normalizeCategory: only known category keys are used; anything else (e.g. path-like values) is routed under others. _meta.tsx output uses JSON.stringify for titles, hrefs, and non-identifier keys so quotes, backslashes, and newlines in labels cannot break the generated file.

Tests cover unknown categories, bad docsLink slugs, legacy toolkit IDs, and label escaping.

^{Reviewed by Cursor Bugbot for commit 6a921fc. 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:21pm

[cursor]

Current version of PR was reviewed by /review-bugbot on Jul 16, 15:31 GMT-3. It flagged 0 findings.

^{Bugbot on commit 7f18a7e is skipped.}