Skip to content

fix(examples): load built-ins independently and resolve compact GitHub SHAs - #340

Merged
ttbombadil merged 7 commits into
feature/browser-emulationfrom
fix/examples-loading
Oct 24, 2026
Merged

ttbombadil merged 7 commits into
feature/browser-emulationfrom
fix/examples-loading

Conversation

@ttbombadil

Copy link
Copy Markdown
Collaborator

Der Beispielekatalog scheiterte beim Auflösen von GitHub-Refs, sobald die Commit-JSON-Antwort größer als das Manifestlimit war. Dadurch fehlten auch die eingebauten Beispiele im Menü. Die Ref-Auflösung lädt jetzt ausschließlich den SHA; eingebaute Beispiele laden unabhängig von der externen Quelle.

  • Kontrollierte SHA-Repräsentation mit eigenem 256-Byte-Limit; bestehende Host-, Token-, Timeout- und Quota-Regeln bleiben aktiv.
  • Neuer lokaler Endpoint /api/examples/builtin/catalog; Menü mit getrennten Ladezuständen, dauerhafter Fehlermeldung und gruppenweisem Retry.
  • Alte Katalog- und Detailantworten überschreiben nach Quellenwechsel keine neuere Auswahl, keinen Editorinhalt und keinen Tutor-Kontext.
  • SSOT, ADR, Architektur, Sicherheits-, Nutzer-, Installations- und Testdokumentation aktualisiert; Ausführungsplan mit Prüfbelegen enthalten.

Validierung auf Node.js 24.20.0:

  • TypeScript, ESLint, Dokumentationsprüfung und Produktionsbuild grün; initialer Ladepfad 690.578 / 710.000 Bytes.
  • 3.594 App- und 635 Emulator-Unit-Tests, 126 Integrationstests, 53 E2E-Tests bestanden. Je ein bestehender Unit-/Integrationstest regulär übersprungen.
  • Letzter E2E-Lauf: 52 direkt bestanden, ein vorhandener Monaco-Starttest nach konfiguriertem Retry bestanden; alle Beispieltests bestanden direkt.
  • E2E isoliert auf Port 3100; nur temporäre Kopien der beiden älteren Specs mit festem Port wurden angepasst, die versionierten Specs blieben unverändert.
  • Reale Quelle mit Standard-Manifestlimit: 10 eingebaute und 51 externe Beispiele, Tutor-Daten gültig.
  • Unabhängiges Gesamt-Review; zwei ergänzende Korrekturen per Red-Green-Regression und erneuten vollständigen Läufen abgesichert.

Bestehende Test-Anpassungen: SHA-Text ersetzt JSON in Resolver-/Quota-Fixtures; Route-Harness erhält den lokalen Katalog-Port; Menü-Fixtures bedienen zwei Katalog-URLs und prüfen den dauerhaften Fehlerzustand. Vorhandene Quota-, Auth-, Detail-, Board- und Tastaturassertionen bleiben erhalten.

Der reguläre Pre-Push-Hook einschließlich frischer Coverage und SonarQube-Quality-Gate ist für 42b419151119290a512bb55fb5d83291baccca5b erfolgreich durchgelaufen. Die drei zuvor gemeldeten Menübefunde wurden im Code korrigiert; keine Hook- oder Schwellenwertänderung.

@ttbombadil
ttbombadil merged commit 6d43090 into feature/browser-emulation Oct 24, 2026
6 checks passed
@ttbombadil
ttbombadil deleted the fix/examples-loading branch October 24, 2026 08:31
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant