feat(shell-docs): cutover docs to shell-docs IA with manifest-driven docs_mode

Replaces the v1 docs surface for 11 frameworks by porting their v1 MDX
into showcase/shell-docs/src/content/docs/integrations/ and flipping
the route handler to render those trees directly. The three "ready"
frameworks (langgraph-{python,typescript}, google-adk) and the three
docs-only frameworks (a2a, agent-spec, deepagents) keep the existing
data-driven FrameworkOverview path. Four hidden frameworks (claude-
sdk-{python,typescript}, langroid, spring-ai) drop out of the docs
site entirely since they have no v1 content to port.

The mode flip is config-driven via a new `docs_mode` field on each
manifest.yaml (showcase/integrations/<slug>/manifest.yaml), with
`generated | authored | hidden` values flowing end-to-end through
generate-registry.ts → registry.json → a new getDocsMode(slug)
helper → page.tsx Tier-1 gate, content resolution priority, and
sidebar source switching:

  generated  Tier 1 data-driven FrameworkOverview + agnostic root
             MDX (unchanged behavior, kept for langgraph-* /
             google-adk / a2a / agent-spec / deepagents).
  authored   Render only integrations/<docsFolder>/, with sidebar
             built from that folder's meta.json. No root-MDX
             fallback.
  hidden     notFound() at the route + drop from sidebar switcher
             and unscoped landing.

To support authored index.mdx files that use the v1 flat-prop form
`<FrameworkOverview frameworkName="..." frameworkIcon={<XIcon/>} ...>`,
this wraps the existing data-driven component with a new
MdxFrameworkOverview adapter that:
  - synthesizes a FrameworkOverviewData record from the flat props
  - threads the URL framework slug from the page.tsx render site
    into `currentFramework` (so rewriteHref correctly rewrites
    /langgraph/* to /langgraph-fastapi/* for shared-folder ports)
  - passes the JSX icon node through an `iconOverride` slot on
    the existing component, sidestepping the iconKey registry for
    MDX-authored pages

Also fixes a stripLeadingImports regression on bare-style imports
(no trailing `;`) that silently consumed the JSX body, drops two
TS1117 duplicate-key stubs for MicrosoftIcon/PydanticAIIcon, ports
two index.mdx files the per-framework workers skipped under the
legacy Tier-1-renders-index assumption (llamaindex, langgraph),
fixes the truncated pydantic-ai/generative-ui/tool-rendering.mdx
+ removes props.components from display-only.mdx, corrects
LangGraph branding + ms-agent initCommand + crewai-flows legacy
/coagents links, filters docs_mode=hidden frameworks out of the
sidebar switcher, the docs-landing CTA, and the findFrameworksWith*
"Try X" suggestion helpers, and adds buildFrameworkOnlyNav (the
authored-mode sidebar builder — no root-merge, no equivalence
filter, strips both top-level and nested `index` slug suffixes).

End-to-end verification: probe-shell-docs.ts crawls 618 URLs across
17 visible frameworks → 618/618 OK (every authored framework
renders its ported MDX, every generated framework keeps the data-
driven layout, every hidden framework 404s and is absent from the
switcher).

Author: tylerslaton

showcase/integrations/ag2/manifest.yaml

@@ -11,6 +11,7 @@ repo: https://github.com/CopilotKit/CopilotKit/tree/main/showcase/integrations/a
 copilotkit_version: 2.0.0
 backend_url: https://showcase-ag2-production.up.railway.app
 deployed: true
+docs_mode: authored
 sort_order: 100
 generative_ui:
   - constrained-explicit

showcase/integrations/agno/manifest.yaml

@@ -11,6 +11,7 @@ repo: https://github.com/CopilotKit/CopilotKit/tree/main/showcase/integrations/a
 copilotkit_version: 2.0.0
 backend_url: https://showcase-agno-production.up.railway.app
 deployed: true
+docs_mode: authored
 sort_order: 90
 generative_ui:
   - constrained-explicit

showcase/integrations/built-in-agent/manifest.yaml

@@ -11,6 +11,7 @@ repo: https://github.com/CopilotKit/CopilotKit/tree/main/showcase/integrations/b
 copilotkit_version: 2.0.0
 backend_url: https://showcase-built-in-agent-production.up.railway.app
 deployed: true
+docs_mode: authored
 sort_order: 5
 generative_ui:
   - constrained-explicit

showcase/integrations/claude-sdk-python/manifest.yaml

@@ -12,6 +12,7 @@ repo: https://github.com/CopilotKit/CopilotKit/tree/main/showcase/integrations/c
 copilotkit_version: 2.0.0
 backend_url: https://showcase-claude-sdk-python-production.up.railway.app
 deployed: true
+docs_mode: hidden
 sort_order: 70
 generative_ui:
   - constrained-explicit

showcase/integrations/claude-sdk-typescript/manifest.yaml

@@ -9,6 +9,7 @@ repo: https://github.com/CopilotKit/CopilotKit/tree/main/showcase/integrations/c
 copilotkit_version: 2.0.0
 backend_url: https://showcase-claude-sdk-typescript-production.up.railway.app
 deployed: true
+docs_mode: hidden
 sort_order: 80
 generative_ui:
   - constrained-explicit

showcase/integrations/crewai-crews/manifest.yaml

@@ -9,6 +9,7 @@ repo: https://github.com/CopilotKit/CopilotKit/tree/main/showcase/integrations/c
 copilotkit_version: 2.0.0
 backend_url: https://showcase-crewai-crews-production.up.railway.app
 deployed: true
+docs_mode: authored
 sort_order: 40
 generative_ui:
   - constrained-explicit

showcase/integrations/google-adk/manifest.yaml

@@ -13,6 +13,7 @@ repo: https://github.com/CopilotKit/CopilotKit/tree/main/showcase/integrations/g
 copilotkit_version: 2.0.0
 backend_url: https://showcase-google-adk-production.up.railway.app
 deployed: true
+docs_mode: generated
 sort_order: 15
 generative_ui:
   - constrained-explicit

showcase/integrations/langgraph-fastapi/manifest.yaml

@@ -9,6 +9,7 @@ repo: https://github.com/CopilotKit/CopilotKit/tree/main/showcase/integrations/l
 copilotkit_version: 2.0.0
 backend_url: https://showcase-langgraph-fastapi-production.up.railway.app
 deployed: true
+docs_mode: authored
 sort_order: 12
 generative_ui:
   - constrained-explicit

showcase/integrations/langgraph-python/manifest.yaml

@@ -13,6 +13,7 @@ repo: https://github.com/CopilotKit/CopilotKit/tree/main/showcase/integrations/l
 copilotkit_version: 2.0.0
 backend_url: https://showcase-langgraph-python-production.up.railway.app
 deployed: true
+docs_mode: generated
 sort_order: 10
 generative_ui:
   - constrained-explicit

showcase/integrations/langgraph-typescript/manifest.yaml

@@ -12,6 +12,7 @@ repo: https://github.com/CopilotKit/CopilotKit/tree/main/showcase/integrations/l
 copilotkit_version: 2.0.0
 backend_url: https://showcase-langgraph-typescript-production.up.railway.app
 deployed: true
+docs_mode: generated
 sort_order: 11
 generative_ui:
   - constrained-explicit