docs+web: MCP docs & new diagrams, stale-claim fixes, hide public auth CTAs

Merged
BE
2mo ago
+503-228

Summary

  • Repo docs: architecture.md gains a full MCP Server section (route gating, RFC 9728 discovery, auth chain, tenantScope, 9-tool scope table) + endpoint/data-flow rows. CONTEXT.md gains MCP glossary entries. self-hosting.md gains the MCP env-var block.
  • Website docs: five new on-brand diagrams (Contract, Context fan-in, Commands, Gauge, MCP); new "MCP Server" section on /docs; new in-app /docs/mcp page + sidebar link; public/docs.md MCP section.
  • Stale fixes: FAQ "auto-review off by default" → on (2 spots); public/docs.md praise row → summary-only per Review Laws.
  • Auth hidden: navbar Sign in/Get started removed (SignedIn → Dashboard kept); all install/get-started CTAs repointed to the GitHub repo. /sign-in, /sign-up routes still work — just unlinked. Service is qbraid-only for now.

Test plan

  • pnpm lint — same 12 pre-existing warnings, none in touched files
  • pnpm typecheck — clean
  • /docs and /docs/mcp render 200 locally
  • Visual check of the five new diagrams

Summary by cubic

Removes live MCP setup claims because the public tree has no MCP backend; MCP now remains a roadmap item. It also updates product copy and public entry points to reflect the current AGPL self-hosted service.

  • Corrects hosted and self-hosted auto-review defaults and limits praise to the summary.
  • Adds four docs diagrams and documents the test command in the architecture flow.
  • Removes public Sign in/Get started links while keeping Dashboard for signed-in users; /sign-in and /sign-up remain available but unlinked.
  • Unifies self-host copy across pricing, CTAs, and demo lore (GitHub links, $0 · AGPL, 20-dev team/mo math) and strips fake liveness indicators.
  • Fixes AA contrast on amber text/buttons and converts the comparison matrix to a semantic <table> with scoped headers.