2026 Frontend-Pitfall-Checkliste:
Biome + TypeScript inkrementell auf Remote Mac

Problem 1 — Thread-Sturm: Biome parallelisiert Dateiarbeit in einem Worker-Pool, während tsc typischerweise einen großen Einzelprozess-Graphen hält. Zusammen können sie Performance-Kerne überzeichnen und SSH-Sessions einfrieren. Problem 2 — vergiftete Caches: Nach Branch-Wechseln ohne Invalidierung von tsbuildinfo laufen Pipelines grün, lokal bricht der Build — ein klassisches Inkremental-Szenario 2026. Problem 3 — falsche Stufen-Reihenfolge: Wer teure Browser- oder E2E-Jobs vor billigen Lint- und Typ-Gates ausführt, verschwendet bei jedem Push Minuten auf einem Remote Mac, der ohnehin geteilt ist.

Die Pipeline sollte deshalb zuerst schnelle, deterministische Signale liefern und erst danach schwere Artefakte bauen. Das schont nicht nur Wandzeit, sondern hält auch die SSH-Interaktivität für Debugging erhalten, wenn mehrere Entwickler denselben Host nutzen.

Die folgende Tabelle richtet Regel-Inhaber für Formatierung und Linting an Inhaber des Typ-Graphen aus. Biome deckt Format und statische Regeln ab; TypeScript-Inkremental speichert Typinformation zwischen Läufen und verkürzt tsc-Wandzeiten in CI/CD.

macOS bietet kein taskset wie Linux. Praktische „Bindung“ bedeutet Richtlinie statt manuelles Pinning einzelner Threads: Halten Sie ein bis zwei Kerne frei für Remotedesktop, sshd und Hintergrunddienste. Behandeln Sie sysctl hw.ncpu als Obergrenze, nicht als Ziel-Parallelität für alle Node-Prozesse gleichzeitig.

Stellen Sie read-mostly-Caches zwischen Commits wieder her, solange Lockfiles unverändert sind. Trennen Sie Caches strikt pro Branch oder mischen Sie den Lockfile-Hash in den Schlüssel. Kombinieren Sie diesen Abschnitt mit dem package.json-Skript-Preflight, damit Skriptänderungen die richtigen Layer invalidieren.

• TypeScript: Verzeichnis mit jedem tsBuildInfoFile sowie ggf. node_modules/.cache, falls Ihr Wrapper Hilfsdaten ablegt.
• Biome: Repo-Root mit biome.json und interne Cache-Ordner der jeweiligen Version nach dem ersten Lauf.
• Clean-Regel: Build-Info löschen, wenn sich package.json, Workspace-Globs oder Compiler-Optionen ändern.

Ohne saubere Schlüssel reproduzieren Sie zufällig alte Graphen — genau das fällt erst in Stufe B der Vorab-Freigabe auf, wenn Warm- und Cold-Lauf stark divergieren.

Ordnen Sie Jobs vom günstigsten Signal zum teuersten Artefakt: Dependencies installieren, dann Biome, dann inkrementelles tsc --noEmit, danach Unit-Tests, Bundler, schließlich Smoke- und Pre-Deploy-Checks. Die CD sollte keinen Build promoten, der nur Biome bestanden hat, aber die Typprüfung übersprungen hat — Biome ersetzt den Typchecker nicht.

In GitHub Actions, GitLab CI oder Jenkins bleibt die Idee gleich: Matrix-Jobs pro Paket nur dann, wenn der Host genug isolierte Ressourcen hat; sonst serielle Gates mit geteilten Cache-Uploads. Dokumentieren Sie die Reihenfolge im Runbook, damit On-Call nicht raten muss, welcher Schritt welchen Cache braucht.

Stufe A: Auf exakt dem Release-SHA Biome und inkrementelles tsc einmal mit leeren Caches ausführen — Reproduzierbarkeit beweisen. Stufe B: Der Warm-Lauf muss spürbar schneller sein (z. B. mindestens rund 30 %); sonst sind Cache-Keys oder Pfade wahrscheinlich falsch. Stufe C: Den in der CD-Dokumentation beschriebenen Smoke-Pfad vor dem Tag ausführen; Fehler dem verwendeten Cache-Schlüssel zuordnen.