#4035 docs: one name per page, clean sidebar links, a compact llms-small.txt

Summary

Follow-ups from the agent-device.dev dogfooding pass (#3991):

• One name per docs page. Nine page titles used Title Case and "&" while the sidebar used sentence case ("Quick Start" vs "Quick start", "Security & Trust" vs "Security and trust"). Titles now take the sentence case, and the sidebar reads each page's title, so the H1, sidebar, search and llms.txt agree.
• Clean docs links. Starlight wrote sidebar and prev/next hrefs as built files (/docs/x.html), so every click went through a 308. The route middleware now drops .html from them.
• A compact llms-small.txt. It was 451 KB (91% of llms-full.txt) with the capability tables flattened. It now leaves out Commands, Capabilities, the Node.js API and the gesture migration guide, which agents read from the installed CLI (agent-device help, agent-device capabilities) or only when needed: 248 KB. llms-full.txt keeps every page.

Links whose text was an old title (33, in the docs and README) use the new titles, and llms.txt labels its docs links from each page's title at build time and names what llms-small.txt omits. A shared cleanHref (src/site/urls.ts) replaces the .html regexes in the route middleware and the landing search.

Validation

At 523b285, pnpm check:affected --run --head HEAD selected and passed command-docs, docs-links and docs-prose; the Fallow audit passes. Earlier, at 85bda31, pnpm check:affected --run --head HEAD selected and passed docs-links and docs-prose. A site build shows no .html hrefs on docs pages and llms-small.txt at 248 KB.

🤖 Generated with Claude Code