docs: lowercase internal docs + migrate website docs to public-docs/ (#634)

* docs: rename to lowercase + drop leftover plans

Rename docs in docs/ to lowercase kebab-case for consistency and update
all references in CLAUDE.md, CONTRIBUTING.md, CHANGELOG.md,
packages/server/CLAUDE.md, and inter-doc links.

Drop two leftover design plan docs:
- docs/ATTACHMENT_BASED_REVIEW_CONTEXT_PLAN.md
- docs/plan-approval-normalization.md

* docs: drop stale uppercase entries from case-insensitive rename

* feat(website): power /docs from public-docs/ markdown tree

Move website docs out of TSX route components and into a root-level
public-docs/ directory of plain markdown files with frontmatter
(title, description, nav, order).

- Add packages/website/src/docs.ts loader using import.meta.glob with
  ?raw to compile the markdown into the bundle at build time.
- Replace the 9 hand-written docs/*.tsx routes with a single $.tsx
  catch-all that renders any slug via react-markdown.
- Drive the docs sidebar nav from frontmatter order/nav.
- Auto-discover docs routes in vite.config.ts so the sitemap stays in
  sync without manual edits.

* fix(website): bind dev server to 0.0.0.0 so port collisions trigger fallback

`host: "127.0.0.1"` (or unset) lets macOS coexist with another process
holding an IPv6 dual-stack `*:8082` socket, so Vite never sees
EADDRINUSE and silently binds alongside it. Forcing IPv4 wildcard
makes the conflict real, and Vite's default `strictPort: false`
falls through to the next free port.

* fix(website): restore docs page styling after markdown migration

Add a .docs-prose class that mirrors the styling the original
docs/*.tsx components hand-rolled (h1/h2/h3 sizes, paragraph/list
spacing, link colors, code blocks, callout-style blockquotes).

ReactMarkdown was emitting unstyled HTML because the previous
wrapper class only had inline-code rules — headings and code
blocks fell back to user-agent defaults.

packages/website/vite.config.ts

@@ -1,3 +1,4 @@
+import fs from "node:fs";
 import path from "node:path";
 import { defineConfig, type UserConfig } from "vite";
 import tsConfigPaths from "vite-tsconfig-paths";
@@ -8,24 +9,37 @@ import tailwindcss from "@tailwindcss/vite";
 
 const repoRoot = path.resolve(__dirname, "../..");
 const siteHost = "https://paseo.sh";
+
+function discoverDocsRoutes(): string[] {
+  const docsDir = path.join(repoRoot, "public-docs");
+  if (!fs.existsSync(docsDir)) return ["/docs"];
+  const routes = new Set<string>(["/docs"]);
+  const walk = (dir: string) => {
+    for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+      const full = path.join(dir, entry.name);
+      if (entry.isDirectory()) {
+        walk(full);
+        continue;
+      }
+      if (!entry.name.endsWith(".md")) continue;
+      const rel = path.relative(docsDir, full).replace(/\.md$/, "");
+      if (rel === "index") continue;
+      routes.add(`/docs/${rel.split(path.sep).join("/")}`);
+    }
+  };
+  walk(docsDir);
+  return [...routes].sort();
+}
+
 const sitemapPages = [
   "/",
   "/changelog",
   "/claude-code",
   "/codex",
-  "/docs",
   "/download",
   "/opencode",
   "/privacy",
-  "/docs/best-practices",
-  "/docs/cli",
-  "/docs/configuration",
-  "/docs/providers",
-  "/docs/skills",
-  "/docs/security",
-  "/docs/updates",
-  "/docs/voice",
-  "/docs/worktrees",
+  ...discoverDocsRoutes(),
 ].map((routePath) => ({
   path: routePath,
 }));
@@ -33,7 +47,9 @@ const sitemapPages = [
 export default defineConfig((): UserConfig => {
   return {
     server: {
+      host: "0.0.0.0",
       port: 8082,
+      strictPort: false,
       fs: {
         allow: [repoRoot],
       },