Protokoll: Welle I nachgetragen (Komponenten-Rendering, Chip-Farben, Dev-Server-Fallstrick)

Die Welle-I-Notizen waren zuvor durch eine parallele Schreibsitzung aus plans/doku-audit.md
verschwunden (Datei war zuletzt in 06c5f0d geaendert, meine Welle-I-Edition fehlte im Commit).
Jetzt erneut eingetragen und committet - inklusive der fehlenden Ueberschrift 'Review-Fehler'.

plans/doku-audit.md

@@ -822,6 +822,24 @@ Anlass: Nutzer-Befund, dass Fehlerblöcke den Leser wie ein Kind ansprechen („
 
 
 
+### Welle I — Darstellung: Komponenten und Inline-Code · Stand 2026-10-17 ✅
+
+Zwei Befunde aus der Sichtprüfung des Nutzers bzw. beim Nachmessen der gerenderten Seiten:
+
+| Befund | Umfang | Fix | Nachweis |
+|---|---|---|---|
+| **Starlight-Komponenten wurden überhaupt nicht gerendert** | **58 Seiten waren `.md`**: `<Aside>`/`<Steps>`/`<Tabs>`/`<Card>` blieben rohe HTML-Tags, die `import`-Zeile stand als Text auf **57 Seiten** | alle 58 Seiten auf `.mdx` umgestellt und MDX-konform gemacht (Import erhalten, Block-Tags in eigene Zeilen, HTML-Kommentare → `{/* … */}`, geschweifte Klammern im Fließtext escaped), fehlender Import in `reference/hooks-daten` ergänzt | vorher **0** gerenderte Asides → nachher **432 Asides, 87 Steps-Listen, 159 Tab-Gruppen**, 0 geleakte Imports, 0 rohe Tags |
+| **Inline-Code im Dark Mode kaum unterscheidbar** (zweimal nachgeschärft) | alle Seiten mit Code-Spans (Tabellen „Methode/Pfad", Scopes, Feldnamen) | eigene Chip-Farben in `src/styles/custom.css` (`--tibi-inline-bg/-border/-text`); `td:first-child code` bricht nicht mitten im Wort. Erste Fassung `#333945` war dem Nutzer zu nah am Seitenhintergrund → jetzt dunkel `#49525f` mit Rahmen `#6b7686` und weißem Text, hell `#dde2ea` mit Rahmen `#b9c1cd` | am gerenderten Screenshot gemessen: Chip/Seite **2,24:1** dunkel (vorher 1,53), Text/Chip **7,9:1**; hell **13,7:1** Textkontrast |
+| Regressionsschutz | — | `scripts/audit-docs.mjs` prüft jetzt zusätzlich: Komponente ohne Import, Komponente in `.md`, geleakte Import-Zeile und rohe Komponenten-Tags im gebauten `dist/` | Gegenprobe: eine Seite testweise auf `.md` zurückgestellt → Skript meldet den Fehler sofort |
+
+**Welle-I-Review (general Subagent):** Urteil „nicht abnehmbar ohne Fixes", davon **1 echter Fehler**: die globale Umwandlung `<!-- … -->` → `{/* … */}` hatte in `projekt/ssr-website.mdx` auch fünf **Code-Beispiele** erwischt (`<!--HEAD-->`, `<!--HTML-->`, `<!--PRELOAD-->`, `<!--SSR.ERROR-->`, `<!--SSR.COMMENT-->`) → zurückgedreht und im gebauten HTML verifiziert (`&lt;!--HEAD--&gt;`). Restliche Review-Punkte abgehakt: Escapes korrekt, 0 rohe Komponenten-Tags außerhalb von Code, 0 Seiten mit fehlendem Import, Slugs/Sidebar unverändert, `gen:schemas` idempotent, Codeblöcke unberührt.
+
+**Betriebs-Fallstrick: umbenannte Seiten und der laufende Dev-Server.** `astro dev` (Container `tibi-docs-docs-1`) hält den Content-Graph im Speicher, und `.astro/` wird zwischen Dev-Server und `astro build` geteilt. Nach dem Rename brach der laufende Server mit „The slug `reference/rest-system` … does not exist" ab, obwohl Datei und Sidebar stimmten. Fix: `docker restart tibi-docs-docs-1`, danach alle Routen gegenprüfen (70/70 → `200`). Regel steht in `AGENTS.md` §4; nicht parallel `astro build` und `astro dev` auf demselben `.astro/` laufen lassen.
+
+**Nebenfund (Produkt, nicht Doku):** `de.json` enthält zwei ASCII-Umschreibungen („ausfuehrbare … fuer", „Ausfuehren") — als Issue **tibi-admin-nova #6** angelegt, weil die Doku UI-Texte wörtlich zitieren muss.
+
+### Review-Fehler (Anti-Halluzination)
+
 | Behauptung eines Prüfers | Gegenbeleg | Ergebnis |
 |---|---|---|
 | „`…/comment/count` landet nicht auf `:id`" (Seitenreview Projekt) | `setup.go:514` (`/_count` als Literal) vs. `:536` (`:id`) | Doku war richtig, Prüfer falsch |