docs: a reference page per diagnostic code, generated from the repair skill (#1658)

* docs: a reference page per diagnostic code, generated from the repair skill

One page per diagnostic code under /reference/solid-js/diagnostics, plus an
index with the console report explained (the message, the `in` line, the
`at` line, the element argument) and a table of every code. The pages are
written by scripts/extract-diagnostics.mjs from the reactivity-diagnostics
skill and diagnostics.json in a solidjs/solid checkout, for a person: what
you saw, why it fires, how to fix it, and the @solidjs/diagnostics
assertion that guards it. The console footer links these pages.

DEV/OBSERVE reference pages document DiagnosticEvent.loc and the `at`
line; the vite-plugin options page gains the `locations` sourceNames kind
and the root it is relative to; the guides link the index.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Ka6h98478umeFadcRV1KLY

* docs: regenerate GRAPH_GROWTH page for the session-wide count (#4103)

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Ka6h98478umeFadcRV1KLY

---------

Co-authored-by: Claude <noreply@anthropic.com>

Author: ryansolid

README.md

@@ -90,6 +90,17 @@ pnpm dev
 
 This will start your the app at [localhost:3000](http://localhost:3000) or the next available port.
 
+### Generated reference pages
+
+Two scripts write reference pages from a local checkout of [solidjs/solid](https://github.com/solidjs/solid) (branch `next`); the pages they write carry a comment naming the script, and edits belong upstream, not in the page.
+
+```sh
+pnpm sync:ref --source ../solid --skip-fetch   # solid-js, @solidjs/web, @solidjs/signals from the JSDoc
+pnpm sync:diagnostics --source ../solid         # one page per diagnostic code from the repair skill
+```
+
+Without `--source`, `sync:ref` makes a sparse checkout under `/tmp/solid-v2-source` that `sync:diagnostics` reads too.
+
 ### Framework and Theme
 
 The docs are built on [SolidBase](https://solidbase.dev) and uses the [Osmium Theme](./osmium).

package.json

@@ -16,6 +16,7 @@
 		"check:lint": "eslint --flag unstable_native_nodejs_ts_config .",
 		"check:types": "tsc --noEmit",
 		"sync:ref": "node scripts/extract-solid-ref.mjs",
+		"sync:diagnostics": "node scripts/extract-diagnostics.mjs",
 		"check:examples": "node scripts/check-examples.mjs",
 		"lint:tone": "node scripts/lint-tone.mjs"
 	},

scripts/build-llms.mjs

@@ -177,6 +177,7 @@ async function buildSmallCorpus(title) {
 		"",
 		`Index: ${new URL("/llms.txt", SITE_ORIGIN)}`,
 		`Full corpus: ${new URL("/llms-full.txt", SITE_ORIGIN)}`,
+		`Diagnostic codes: ${new URL("/reference/solid-js/diagnostics.md", SITE_ORIGIN)} (one page per code, linked from each console report)`,
 		"",
 		primerBody,
 		"",