fix(plugins): eliminate 8,200+ sidebar 301s by reconciling arborescence titles with canonical allPlugins titles

[vfanucci]

Summary

• Root cause identified: PluginSidebar.vue and PluginElements.vue build subgroup URLs from arborescencePlugins[i].title (via /plugins/arborescence API). The canonical URL validation in [...slug].astro uses allPlugins[i].title (via /plugins/subgroups API). When these two APIs return different titles for the same subgroup, the sidebar generates non-canonical slugs → 301 redirects on every plugin page.
• Fix: In buildPluginPageProps.ts, overwrite each arborescence subgroup's title with the canonical title from allPlugins before the sidebar consumes it. allPlugins is already the source of truth for generateNavigation.ts and the route guard — this simply ensures the sidebar uses the same data.
• Impact: Eliminates ~8,243 navigation 301s (88% of 9,346 total internal 301s found by Screaming Frog audit). The remaining ~959 are editorial links in MDX content and tracked separately in fix: 8,200+ internal navigation links pointing to 301 redirects on plugin pages #4576.

Changed file

src/utils/plugins/buildPluginPageProps.ts — 16 lines added, 1 changed

// Build a canonical title map from allPlugins (source of truth for URL slugs).
// The /plugins/subgroups API and the /plugins/arborescence API are separate endpoints
// that can return different `title` values for the same subgroup. Since
// subGroupHref() and getElementHref() both use slugify(subGroupName(plugin)) — which
// reads plugin.title — a title mismatch causes the sidebar to generate non-canonical
// URLs that trigger 301 redirects instead of serving the page directly.
const canonicalTitleBySubGroup = new Map(
    allPlugins
        .filter((p) => p.subGroup !== undefined)
        .map((p) => [p.subGroup!, p.title]),
)

const prunedRootPlugin = arborescencePlugins?.find((p) => p.subGroup === undefined)
const prunedPluginsWithoutDeprecated = (arborescencePlugins ?? []).map((p) => {
    if (!p.subGroup) return p
    const canonicalTitle = canonicalTitleBySubGroup.get(p.subGroup)
    return canonicalTitle !== undefined ? { ...p, title: canonicalTitle } : p
})

Test plan

• Open any multi-subgroup plugin page (e.g. /plugins/plugin-slack/chat/io.kestra.plugin.slack.chat.ChatMessage) and inspect all sidebar <a href> values — none should match an old-style slug (e.g. slack-chats, docker-task-runner, cosmos-db, aws-cli, gcp-cli)
• Verify navigation links in the sidebar resolve as 200, not 301, in DevTools Network tab
• Check that the sidebar still renders the correct display names (the fix only changes which title is used for the URL slug, not the display label shown to users — both APIs should agree on display names too)
• Re-run Screaming Frog after deploy and confirm the count of navigation 301s drops from ~8,243 to near zero

Closes #4576

🤖 Generated with Claude Code