Projekt-Import

Der dritte Wizard-Schritt sagt dem Portal, mit welchem Projekt der lokale Agent arbeiten soll. Den eigentlichen Filesystem-Scan macht der Agent und meldet Ergebnisse über die WebSocket-Bridge.

Was erkannt wird

Wenn du den Agent auf einen Projekt-Root zeigen lässt, parst er:

• playwright.config.ts / .js — Projekte, baseURL, Reporter, Retries
• package.json — Playwright-Version, Scripts (test, e2e, test:e2e)
• Dateibaum — POMs, Fixtures, Helpers, Test-Specs
• node_modules und Playwright-Browser-Binaries

Das Portal rendert eine Summary-Card mit Counts und Links direkt ins Test Hub.

Drei Wege zum Import

1. Aktuelles Agent-Verzeichnis

Der einfachste Fall. Du hast den Agent mit --project . aus dem Projekt-Root gestartet; der Wizard bietet ihn als Default an.

2. Anderen Pfad wählen

Der Agent kann mehrere Pfade bedienen, wenn du ihn mit --project /pfad/zum/parent startest. Der Wizard listet Unterordner mit Playwright-Config.

3. Neues Projekt initialisieren

Hat der Pfad keine Playwright-Config, klick Initialisieren. Der Agent führt aus:

npm init playwright@latest

Du wählst TypeScript oder JavaScript, das Test-Verzeichnis und ob ein GitHub-Actions-Workflow dazu soll. Der Agent streamt den Install-Output ins Portal.

Multi-Projekt-Workflows

Du kannst das Portal mit mehreren Agents auf demselben Rechner verbinden — jeder zeigt auf ein anderes Projekt:

# Terminal 1
npx @xyva/agent start --project ~/code/shop --port 7900

# Terminal 2
npx @xyva/agent start --project ~/code/admin --port 7901

Wechsel im Agent-Badge in der Portal-Topbar. Jeder Agent hat eigenen Wizard-State, KI-Provider-Settings und Run-History.

Empfohlener Ablauf

1. Den Agent im Projekt-Root starten, bevor du den Wizard öffnest.
2. Erkannte Playwright-Version und baseURL bestätigen.
3. Test Hub öffnen — sind alle Specs sichtbar?
4. Weiter zu Preflight-Checks.

Troubleshooting

Symptom	Fix
No Playwright config found	Auf den Projekt-Root zeigen, nicht auf den Workspace-Root
Specs fehlen im Tree	testDir in playwright.config.ts prüfen
Agent reagiert nicht	npx @xyva/agent start --project . neu starten
Falsches Projekt angezeigt	Agent stoppen (Ctrl+C), mit richtigem --project neu starten

Nächste Schritte

• Preflight-Checks
• Lokaler Agent
• Lauf-Historie