feat(web): FE overhaul — SWR centralized data layer + dashboard + islands

- Add SWR foundation (lib/fetcher, lib/swr, lib/api) with typed
  hooks: useSections/useDocuments/useSearch/useRelated/useRevisions/useQueueStatus
- Replace ad-hoc useEffect+fetch in Header/Sidebar/CommandMenu/search
  with SWR (dedup 4s, focus throttle 10s, debounced search 180ms)
- Doc page: RelatedGrid + RevisionList as SWR client islands (RSC hero stays)
- DocForm: SWR mutate on create/update for live sidebar invalidation
- New APIs: /api/related, /api/revisions, /api/tags, /api/queue/status,
  /api/docs filtering (?section=&status=)
- New UI: DocumentCard, SectionCard, SearchBar, TagCloud, QueueBadge,
  EmptyState, dashboard (/dashboard with QueueStrip live + section stats)
- Layout wraps SWRProvider; no TanStack code (SWR-only per spec)
- Verified: next build passes (16.3.4 Turbopack), no manual fetch sprawl remains

Co-Authored-By: internal-model

apps/web/app/hooks/useDocuments.ts

@@ -0,0 +1,30 @@
+"use client";
+
+import useSWR from "swr";
+import { fetcher } from "@/lib/fetcher";
+import type { DocumentMeta } from "@mcpedia/types";
+
+type DocsEnvelope = DocumentMeta[] | { docs: DocumentMeta[] };
+
+function normalize(data: DocsEnvelope | undefined): DocumentMeta[] {
+  if (!data) return [];
+  if (Array.isArray(data)) return data;
+  return (data as { docs: DocumentMeta[] }).docs ?? [];
+}
+
+export function useDocuments(section?: string, status = "published") {
+  const params = new URLSearchParams();
+  if (section) params.set("section", section);
+  if (status) params.set("status", status);
+  const qs = params.toString();
+  const key = qs ? `/api/docs?${qs}` : "/api/docs";
+
+  const swr = useSWR<DocsEnvelope>(key, fetcher, {
+    revalidateOnFocus: false,
+  });
+
+  return {
+    ...swr,
+    docs: normalize(swr.data),
+  };
+}