Normalize integration card categories to match routes

[jottakka]

Summary

• Extract a client-safe toolkit-category helper (INTEGRATION_CATEGORIES + normalizeCategory) so browser cards never import server-only route code
• Use that helper in toIntegrationLink, sidebar sync, and keep route generation on the same allow-list
• Backfill catalog category from toolkit JSON (same source of truth as routes), not only docsLink

Independent of #1065: closes the remaining card/route category contract gap Bugbot found there.

Test plan

• pnpm exec vitest --run --exclude '.worktrees/**' tests/integration-index-links.test.ts toolkit-docs-generator/tests/app-lib/toolkit-category.test.ts toolkit-docs-generator/tests/app-lib/toolkit-static-params.test.ts toolkit-docs-generator/tests/scripts/sync-toolkit-sidebar.test.ts
• Confirm an unknown/empty category card URL lands on /others/... and matches listValidIntegrationLinks when a page exists there

Made with Cursor

[vercel]

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

Project	Deployment	Actions	Updated (UTC)
docs	Ready	Preview, Comment	Jul 21, 2026 3:59pm

[jottakka]

Independent follow-up to #1065: share a client-safe normalizeCategory so integration cards, catalog enrichment, sidebar, and routes agree on category segments (and JSON wins for docsLink/category).

[jottakka]

Folded into #1065 per Teal’s review (category normalize on cards + client-safe helper). Safe to close this PR as superseded once #1065 is updated — the commits were cherry-picked there.

[jottakka]

Superseded by #1065 (category normalize + client-safe helper were folded in there).

[cursor]

Cursor Bugbot has reviewed your changes using high effort and found 1 potential issue.

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

^{Reviewed by Cursor Bugbot for commit 99ec991. Configure here.}