2026 OpenClaw Frontend auf Remote Mac:
package.json-Skripte erkennen & Pre-Release-Diff-Report

Führen Sie den Ablauf auf einem sauberen Arbeitsbaum desselben Branches aus, den Sie ausliefern wollen — typischerweise main oder ein Release-Kandidat. Auf dem Remote Mac prüfen Sie: SSH-Schlüssel oder Runner-Identität dürfen das Repo lesen, git ausführen und in ein Artefaktverzeichnis (z. B. artifacts/preflight/) schreiben, ohne sudo.

Installation & Tooling pinnen: Gleichen Sie node und den Paketmanager (npm, pnpm, yarn) mit der Produktions-CI ab. Bei Corepack die exakte Version im Report-Kopf dokumentieren. Fehlendes oder abweichendes Tooling ist die häufigste Ursache für „Skripte unverändert, Verhalten aber anders“.

OpenClaw-Konfiguration: Gewähren Sie dem Agenten read-only Repo-Zugriff plus Recht, Dateien in den Benachrichtigungskanal zu stellen. Registry-Tokens gehören nicht in package.json-Skripte; Secrets per CI-Env injizieren und aus generierten Diff-Reports fernhalten. In Monorepos den Snapshot-Schritt pro Workspace-Paket wiederholen, das Build, Test oder Deploy anstößt — siehe pnpm- & Turborepo-Checkliste für Cache- und Registry-Parität.

• ☐ Einmalig: Verzeichnis artifacts/preflight/ anlegen und in .gitignore belassen, aber CI-Upload-Schritt aktivieren.
• ☐ node -v, npm -v bzw. pnpm -v in jede Log-Datei schreiben.

Behandeln Sie scripts wie eine Release-API: Umbenennen von build, Hinzufügen eines release-Shims oder geänderte Flags bei test:e2e können Downstream-Automatisierung ungültig machen, obwohl Anwendungscode unberührt blieb.

Git-Diff-Umfang (Checkliste):

• ☐ Vergleichen Sie HEAD mit origin/main, dem vorherigen Tag oder git merge-base für Ihren Release-Zweig — im Report-Titel festhalten.
• ☐ Einbeziehen: package.json im Repo-Root und jedes packages/*/package.json (oder Ihr Glob), das an Build oder Deploy beteiligt ist.
• ☐ Optional eingrenzen mit git diff <range> -- package.json packages/, damit reine Dependency-Änderungen Reviewer nicht überfluten.

Skript-Snapshots (Checkliste): Pro Ziel-package.json das Objekt scripts extrahieren, Schlüssel alphabetisch sortieren und als formatiertes JSON (stabile Reihenfolge) speichern. Dateinamen wie scripts.<pkg>.<sha>.json neben einer scripts.<pkg>.baseline.json (eingecheckt oder aus dem letzten grünen Release). Ein Muster: node -e "const p=require('./package.json'); console.log(JSON.stringify(p.scripts||{}, null, 2))" durch Ihren Normalisierer pipen.

Wann auslösen: Bei jedem PR, der ein scoped package.json berührt; nächtlich auf main; unmittelbar vor dem Setzen eines Versions-Tags. Denselben Schritt an OpenClaw anbinden, damit ein Agent den Snapshot nach dem Merge ohne Laptop erneut erzeugen kann.

Pro Lauf eine Markdown- oder JSON-Datei veröffentlichen, die für Menschen und Automation dieselbe Wahrheitsquelle ist. Unten eine Report-Vorlage zum Einfügen in Ihren Generator.

# Skripte-Preflight — <repo> @ <short_sha>
Bereich: <from_ref>..<to_ref> | Node <version> | <npm|pnpm|yarn> <version>

## Kurzfassung
- Berührte Pakete: …
- Skripte neu: … | entfernt: … | geändert: …
- Risiko: niedrig / mittel / hoch (siehe Tabelle)

## Deltas pro Paket
### root
| Skript | Änderung | vermutete Auswirkung |
| build | Flag … | CI-Artefaktpfad |
| … | … | … |

## Erforderliche Folgeschritte
- [ ] Smoke- / E2E-Matrix erneut
- [ ] Runbook oder Deploy-Doku aktualisieren
- [ ] SRE informieren, wenn Deploy-Hooks wechseln

## Artefakte
- Pfade / URLs der Snapshot-JSON
- Roh-Unified-Diff als Anhang

Benachrichtigungen (Checkliste): Dreizeiler an Slack, Feishu oder generischen Webhook — Bereich, Anzahl geänderter Skripte, höchstes Risiko-Label — plus Link zum vollständigen Report. Für OpenClaw den Artefaktpfad in die Task-Payload legen, damit der Agent die Datei auf dem Remote Mac öffnet und Nacharbeit-Schritte anhängen kann.

Setzen Sie einen schnellen Job vor teuren Schritten (Build, Lighthouse, Playwright). Der Job soll: (1) bei ungültigem JSON abbrechen; (2) den Report schreiben; (3) mit Exit-Code ungleich null enden, wenn geschützte Skriptnamen ohne Allowlist-Datei oder Changelog-Eintrag wechseln.

Reihen Sie die Prüfung in Ihre Pre-Deploy-Kette ein — nach Dependency-Install und Lockfile-Check, vor KI-unterstütztem Smoke oder Browser-Arbeit — damit Skript-Drift sichtbar wird, bevor Minuten-Jobs starten.

Report als CI-Artefakt bereitstellen und optional GitHub-/GitLab-Check-Annotationen je geändertem Skript. Auf Apple-Silicon-Runnern CI=true setzen und Architektur loggen, um arm64-spezifische Annahmen in Skriptzeilen früh zu sehen.

Parse-Fehler: Trailing Commas oder doppelte Schlüssel in package.json lassen Node vor dem Diff abbrechen — lokal fixen, erneut laufen. npm pkg get scripts als zweiter Parser, wenn Sie npm-Normalisierung brauchen.

Falsches „kein Diff“: Gleichen Pfad im Monorepo vergleichen; oft wird das falsche package.json bearbeitet. Shell-Syntax in Skriptstrings verhält sich unter sh vs. zsh unterschiedlich — dokumentieren Sie die Shell der CI.

Merge-Konflikte: Bei konkurrierenden Umbenennungen lieber additive Aliase (build:legacy) für einen Release-Zyklus statt harte Brüche. Bei korrelierten Flakes siehe E2E-Log-Triage.

Vor dem „Release grün“ diese Liste abhaken. Sie richtet Vorabprüfungen mit dem übrigen OpenClaw-Web-Pipeline-Stack aus.