2026 OpenClaw Frontend auf Remote Mac:
ESLint/Stylelint-JSON parsen & Fix-Branch-Entwurf

Lint-Drift zwischen Laptop und Remote Runner entsteht fast immer, wenn Node-Version, Plugin-Auflösung oder Arbeitsverzeichnis leicht abweichen; hübsche Terminalfarben helfen OpenClaw nicht, wenn keine stabile JSON-Datei existiert.

1. Pfad- und Glob-Inkonsistenz: relativer Startpunkt auf dem Remote Mac weicht vom lokalen Editor ab, wodurch eslint . andere Dateien sieht als erwartet.
2. Verwechslung Exit-Code vs. Parserfehler: ein Linter mit Funden endet regulär mit Status ungleich null, während die JSON-Datei dennoch gültig ist — CI braucht getrennte Prüfungen.
3. Stille Auto-Fixes: ohne Fix-Branch-Entwurf landen Massenänderungen auf main und kollidieren mit parallelen Features; Auditierbarkeit leidet ebenso wie bei undokumentierten Skriptänderungen in package.json.

Die folgende Tabelle priorisiert maschinenlesbare Ausgaben für Parser, Agenten und Schwellen-Gates; sie ergänzt visuelle Checks in der Pre-Release-Kette.

Grundinstallation: im Repository-Root npm ci oder pnpm install --frozen-lockfile ausführen; node -v und Paketmanagerversion in jede Log-Datei schreiben. ESLint und Stylelint als Projektabhängigkeiten pinnen, globale CLI nur, wenn die Pipeline dasselbe Executable referenziert.

Pfadkonvention artifacts/lint/: nicht versionieren, aber CI-Upload erlauben. Namensschema eslint.<short_sha>.json und stylelint.<short_sha>.json; optional summary.<short_sha>.md für Menschen. Parallel dazu stderr nach artifacts/lint/*.log umleiten, damit OpenClaw Stacktraces von gültigem JSON trennt.

mkdir -p artifacts/lint
npx eslint . --ext .ts,.tsx,.js,.mjs,.cjs --format json > "artifacts/lint/eslint.${SHORT_SHA}.json" 2> "artifacts/lint/eslint.${SHORT_SHA}.log"
npx stylelint "**/*.{css,scss}" --formatter json > "artifacts/lint/stylelint.${SHORT_SHA}.json" 2> "artifacts/lint/stylelint.${SHORT_SHA}.log"

• ☐ Sicherheit: keine Secrets in Config-Kommentaren ausgeben; Reports nur in private Artefakt-Speicher legen.
• ☐ Reproduzierbarkeit: pwd und git rev-parse HEAD in den Kopf jeder JSON-Begleitdatei schreiben.

Schritt 1 — Baseline: sauberen Worktree auf dem Ziel-Branch checken, identische Umgebungsvariablen wie in der Referenz-CI setzen, CI=true erzwingen, damit Linter kein TTY simulieren.

Schritt 2 — JSON erzeugen: obige Befehle ausführen; Dateigröße beobachten — bei sehr großen Projekten nach Paketgrenzen splitten oder nur geänderte Pfade über git diff --name-only füttern.

Schritt 3 — Schema sanity: mit jq empty oder kleinem Node-Skript validieren; Zähler errorCount je Regel aggregieren und Top-Regeln für Slack/Webhook-Kurzmeldung ausgeben.

Schritt 4 — OpenClaw: absoluten Pfad der JSON-Dateien und die Aggregates in die Task-Payload; Anweisung, einen Fix-Branch-Entwurf mit klar benannten Commits vorzuschlagen, ohne direkt zu pushen, sofern Policy das verbietet.

Schritt 5 — Branch anlegen: git checkout -b fix/lint-openclaw-${SHORT_SHA}; Report-Markdown hinzufügen; optional zweiter Commit nur mit eslint --fix nach expliziter Freigabe.

Schritt 6 — Review-Gate: Pull-Request als Entwurf markieren, mindestens einen menschlichen Review für Style- und API-Risiken einplanen; bei Monorepos pro Paket eigene Zusammenfassungstabellen erzeugen.

Reihenfolge auf dem Remote Mac-Runner: Dependency-Install und Lockfile-Check, danach JSON-Lint-Job, erst dann Bundles, statische Assets und teure Browserjobs. So vermeiden Sie Wartezeit, wenn offensichtliche Regelverletzungen ohnehin blockieren.

Policy-Beispiel: errorCount > 0 → Pipeline rot; warningCount über Schwellen → gelbes Gate mit manueller Freigabe. Artefakte an den nächsten Schritt weiterreichen, etwa Lighthouse oder Smoke, damit derselbe Commit-Kontext dokumentiert bleibt.

Zahlen & Parameter zum Zitieren: typische JSON-Größe 0,5–20 MB je nach Repo; Aggregations-Skript soll unter zehn Sekunden bleiben, sonst parallelisieren. Drei Review-Fragen: Welche Regeln sind neu? Welche Verzeichnisse waren ausgeschlossen? Stimmt die Stylelint-customSyntax-Version mit dem Bundler überein?

Leere JSON trotz lokaler Treffer: Arbeitsverzeichnis prüfen, --ignore-path und Editor-Settings vergleichen, Symlinks auf dem Runner.

Parser bricht: zuerst Datei-Encoding und Trailing-Kommas ausschließen; dann Plugin-Versionen gegen Lockfile diffen.

Performance: --cache für ESLint auf dem Remote Host aktivieren, Cache-Pfad unter artifacts/eslint-cache/ definieren und pro Branch isolieren.