fix: Address CodeRabbit review comments on generate-llms-txt

- Add try/catch for categories.json loading with clear error message
- Add existsSync check before reading about.adoc
- Expand decodeHtmlEntities named entity map (rsquo, ldquo, rdquo,
  mdash, ndash, nbsp, hellip)

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

Author: raifdmueller

scripts/extract-metadata.js

@@ -26,7 +26,21 @@ if (!fs.existsSync(OUTPUT_DIR)) {
  */
 function decodeHtmlEntities(str) {
   if (!str) return str
-  const named = { amp: '&', lt: '<', gt: '>', quot: '"', apos: "'" }
+  const named = {
+    amp: '&',
+    lt: '<',
+    gt: '>',
+    quot: '"',
+    apos: "'",
+    rsquo: '\u2019',
+    lsquo: '\u2018',
+    rdquo: '\u201d',
+    ldquo: '\u201c',
+    mdash: '\u2014',
+    ndash: '\u2013',
+    nbsp: '\u00a0',
+    hellip: '\u2026',
+  }
   return str.replace(/&#(\d+);|&([a-z]+);/gi, (match, num, name) => {
     if (num) return String.fromCharCode(parseInt(num, 10))
     return named[name] || match

scripts/generate-llms-txt.js

@@ -13,9 +13,15 @@ const path = require('path')
 
 const ROOT = path.join(__dirname, '..')
 
-const categories = JSON.parse(
-  fs.readFileSync(path.join(ROOT, 'website/public/data/categories.json'), 'utf-8')
-)
+const categoriesPath = path.join(ROOT, 'website/public/data/categories.json')
+let categories
+try {
+  categories = JSON.parse(fs.readFileSync(categoriesPath, 'utf-8'))
+} catch (err) {
+  console.error('❌ Fehler beim Laden von categories.json:', err.message)
+  console.error('   Bitte zuerst `node scripts/extract-metadata.js` ausführen.')
+  process.exit(1)
+}
 
 // ─── AsciiDoc table converter ────────────────────────────────────────────────
 
@@ -199,11 +205,13 @@ function generateLlmsTxt() {
   ]
 
   // Introductory content from about.adoc
-  const aboutAdoc = fs.readFileSync(path.join(ROOT, 'docs/about.adoc'), 'utf-8')
-  lines.push(adocToMarkdown(aboutAdoc))
-  lines.push('')
-  lines.push('---')
-  lines.push('')
+  const aboutPath = path.join(ROOT, 'docs/about.adoc')
+  if (fs.existsSync(aboutPath)) {
+    lines.push(adocToMarkdown(fs.readFileSync(aboutPath, 'utf-8')))
+    lines.push('')
+    lines.push('---')
+    lines.push('')
+  }
 
   // Anchors by category
   for (const category of categories) {