docs(context): condense repo-map to a digest; move gotchas and inventory to their own pages

repo-map.md was 173 KB (~43k tokens), too long to be part of every new
agent's context. The full gotcha text moves verbatim to context/gotchas.md
and the per-file inventory (with the old Wasm/CLI/Testing sections) to
context/file-inventory.md; the map keeps a one-or-two-line digest per
gotcha under the same numbers, so every `gotcha N` citation still resolves.

The doc-site manifest publishes the two new pages, and `gotchas` gets the
same gotcha-N anchors as `repo-map`.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

scripts/build-doc-site.mjs

@@ -34,6 +34,8 @@ const SECTIONS = [
       ["docs/design-notes.md", "design-notes", "Design notes"],
       ["context/design-principles.md", "design-principles", "Design principles"],
       ["context/repo-map.md", "repo-map", "Repository map"],
+      ["context/gotchas.md", "gotchas", "Gotchas (long form)"],
+      ["context/file-inventory.md", "file-inventory", "File inventory (long form)"],
     ],
   },
   {
@@ -613,7 +615,7 @@ for (const section of SECTIONS) {
   for (const [src, slug, title] of section.docs) {
     const depth = slug.split("/").length - 1;
     const ctx = { depth, cited, unresolved, anchors: new Set() };
-    if (slug === "repo-map") ctx.listItemId = (n) => (n >= 1 && n <= 200 ? `gotcha-${n}` : null);
+    if (slug === "repo-map" || slug === "gotchas") ctx.listItemId = (n) => (n >= 1 && n <= 200 ? `gotcha-${n}` : null);
     const md = readFileSync(join(root, src), "utf8");
     const { html, toc } = renderMarkdown(md, ctx);