mirror of
https://github.com/CopilotKit/CopilotKit.git
synced 2026-09-14 16:26:20 +08:00
Sam Julien
8efa8a5ce9
## Summary Critical-path content fixes from the shell-docs QA triage. Fixes everything that breaks copy-paste or click-through on existing pages. **Items addressed:** - 2.2, 8.1, 13.1, 13.2 — code-block import hygiene - 12.1, 14.1, 15.1, 15.2, 22.1 — cross-page link sweep - 9.1, 9.2 — `gpt-5.2*` → `gpt-5.4*` sweep + extend model-name CI validator - 7.1 — `migrations.enabled` premium walkthrough corrections ## Visual inspection 1. Start the dev server: ```bash nx run shell-docs:dev ``` Open http://localhost:3003. 2. **Imports — copy-paste check.** Visit each page below; copy each `route.ts` / `app/layout.tsx` / `app/page.tsx` block into a scratch TypeScript file and verify it has all needed imports: - `/built-in-agent/quickstart` (BIA, default integration — should now import `CopilotKit` from `@copilotkit/react-core/v2`) - `/agent-spec/quickstart` - `/microsoft-agent-framework/quickstart` - Switch framework picker to each of: `langgraph`, `mastra`, `pydantic-ai`, `adk`, `agno`, `aws-strands`, `llamaindex`. Re-check the same blocks. - `/auth`, `/agentic-protocols/mcp`, `/backend/copilot-runtime`, `/multimodal-attachments` — verify code blocks now show import lines. 3. **Links — click-through check.** On each page below, click every external link in the prose: - `/agentic-protocols` (the index — 7 link rewrites; all should resolve) - `/multimodal-attachments` (the migration Callout should be GONE) - `/faq` ("What's available?" table — the rows should be plain bold labels, not links) - `/langgraph/agent-app-context` (mid-prose link should now point at langgraph fw page, not BIA) - `/inspector` (the agent-app-context relative link should resolve to langgraph fw page) - `/troubleshooting/common-issues` (the `copilot-runtime` and `model-selection` links should now resolve) 4. **Model names — search check.** In the dev server (or via grep), confirm `gpt-5.2` and `gpt-5.2-mini` no longer appear anywhere in `showcase/shell-docs/src/content/`. All references should now be `gpt-5.4` / `gpt-5.4-mini`. 5. **Premium walkthrough — read-through.** Walk `/premium/self-hosting` end to end as if installing fresh. The walkthrough should now tell you to set `migrations.enabled: true` BEFORE the install command. The "Job will appear as Completed" prose should only fire if migrations were enabled. 6. **Anti-checks (these should NOT have changed):** - The legitimate `gpt-4o`, `gpt-4.1`, `gpt-5.4` references in JSDoc / source code. - Code blocks where imports were intentionally omitted because a prior block on the same page established them. - Reference pages under `/reference/v1/` (those are owned by a separate PR).