Pin the catalogue parser with a test, after it broke twice in silence

[oblomov-dev]

scripts/link-samples.mjs reads SAMPLES.md out of a checkout of another repository, and its row pattern has now stopped matching twice — first when the catalogue grew the @docs links under the keywords, then today when it grew the " @summary sentence in normal type above them.

Both times the symptom was the bad kind. Not a red run — a wrong answer:

`z2ui5_cl_smp_app_493` is not in the sample catalogue — renamed, deleted, or a typo

which is precisely the sentence this check exists to say truthfully. A parser that fails open like that is worse than one that throws.

What changes

The parser moves into scripts/lib/catalogue.mjs — link-samples resolves a checkout and rewrites pages at import time, which is why it could not be tested where it was — and test/catalogue.test.mjs pins one row of every shape the three sample repositories generate:

fixture row	shape
**Basics I** — Hello World	title + sub only (the oldest)
+ <sub>keywords</sub>	as it was until today
+ summary + keywords + docs	today's, all four blocks
no bold header	titled by its section
<br><span>…</span>	a block with a tag nobody here has seen

That last one failed when it was written, which is the point of writing it: the pattern accepted <sub> blocks and bare text and nothing else, so a future <span> would have taken the whole row down. A block is now <br> plus anything — this script reads the title, the class and the path, and what the other blocks say is the reader's business.

The row shape is maintained in abap2UI5/samples, /samples-controls and /samples-stack, and read here and in abap2UI5/ai-mcp: a contract between five programs, of which this repository owns none.

npm test (2 tests) now runs first in npm run check.

---

Generated by Claude Code

[Copilot]

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.