Preflight-Checks
Der letzte Wizard-Schritt ist ein System-Check, den der lokale Agent gegen deine Maschine und dein Projekt fährt. Alles grün heißt: testbereit.
Was geprüft wird
| Check | Was der Agent abfragt |
|---|---|
| Node.js | node --version ≥ 20 |
| Git | git --version ≥ 2.30 |
| Filesystem | Lese-/Schreibrechte im Projekt-Root und ~/.xyva/ |
| Playwright | @playwright/test auflösbar; Browser-Binaries vorhanden |
| Browser-Binaries | Chromium / Firefox / WebKit in passender Version |
| Netzwerk | Ausgehender HTTPS-Zugriff zum KI-Provider (falls verbunden) |
| Bridge | Aktive WebSocket-Session zwischen Agent und Portal |
Rote Checks beheben
| Roter Check | Fix |
|---|---|
| Node < 20 | Node 20 LTS oder 22 LTS installieren, Agent neu starten |
| Git fehlt | Git installieren, im PATH verfügbar machen |
| FS-Schreibzugriff blockiert | Antivirus/EDR prüfen, Terminal mit korrektem User starten |
| Playwright fehlt | npm install -D @playwright/test im Projekt |
| Browser fehlen | Browser installieren im Wizard, oder npx playwright install |
| Provider unerreichbar | Proxy / VPN prüfen; siehe Proxy & Netzwerk |
| Bridge getrennt | npx @xyva/agent start neu, Portal refreshen |
Der Wizard re-runnt jeden Check beim Klick auf Erneut prüfen, sodass du in einem zweiten Terminal fixen kannst, ohne den Wizard neu zu starten.
Was "grün" dir gibt
Sind alle Checks grün:
- Das Portal öffnet das Overview-Dashboard
- Test Hub listet die Specs aus dem Agent-Filesystem
- Runner ist startbereit
- Swarm QA schaltet frei, sobald du eine Ziel-URL setzt
- Brain leuchtet auf, wenn KI verbunden ist
Empfohlener Ablauf
- Alle roten Checks vor Fertigstellen beheben.
- Preflight unter Settings → System-Status jederzeit erneut ausführen — z. B. nach Node-Upgrade, Browser-Update oder Key-Rotation.
- Baseline pinnen, indem du den Preflight-Report exportierst — hilft beim Onboarding neuer Teamkollegen.