CLI Runner

Swarm QA kann über die Kommandozeile gesteuert werden — ideal für CI/CD-Pipelines, automatisierte Workflows und Headless-Betrieb.

Verfügbare Befehle

Preset-basierte Läufe

# Quick Smoke (60s)
npm run swarm:quick -- --target https://example.com

# Standard Scan (180s)
npm run swarm:run -- --target https://example.com

# Deep Audit (420s)
npm run swarm:deep -- --target https://example.com

Allgemeine Syntax

npm run swarm:run -- --target <URL> [Optionen]

Optionen

Flag	Beschreibung	Standard
--target <URL>	Ziel-URL für den Scan	Erforderlich
--json	Ausgabe als JSON statt Konsolentext	Aus
--out <Pfad>	Ergebnisdatei schreiben	Keine Datei
--pdf	PDF-Bericht generieren	Aus
--agents <Liste>	Kommagetrennte Agent-Liste	Alle
--timeout <Sek>	Maximale Laufzeit in Sekunden	Preset-abhängig
--auth	Authentifizierung aus Projektkonfiguration verwenden	Aus

Beispiele

Ergebnisse als JSON speichern

npm run swarm:run -- --target https://example.com --json --out ./results/scan.json

Nur bestimmte Agenten ausführen

npm run swarm:run -- --target https://example.com --agents link-patrol,a11y-scout,http-guard

Deep Audit mit PDF-Export

npm run swarm:deep -- --target https://example.com --pdf --out ./reports/

CI/CD-Integration

In GitLab CI oder GitHub Actions können Sie den Exit-Code auswerten. Der CLI Runner gibt Exit-Code 1 zurück, wenn der Score unter dem konfigurierten Schwellenwert liegt.

Ausgabeformat

Konsolenausgabe (Standard)

Swarm QA — Standard Scan
Ziel: https://example.com
Score: 78/100

Findings:
  HOCH   [HTTP Guard]    Fehlende Content-Security-Policy
  MITTEL [Perf Sentinel] LCP über 2,5s auf /kontakt
  MITTEL [SEO Recon]     Fehlende Meta-Description auf /impressum
  INFO   [API Health]    /api/health antwortet in 45ms

JSON-Ausgabe

{
  "score": 78,
  "target": "https://example.com",
  "findings": [
    {
      "severity": "high",
      "agent": "http-guard",
      "message": "Fehlende Content-Security-Policy",
      "url": "https://example.com"
    }
  ]
}

Voraussetzung

Der CLI Runner benötigt eine installierte xyva.ai-Instanz mit konfiguriertem KI-Provider. Stellen Sie sicher, dass npm install ausgeführt wurde.

Pipeline-Integration

GitLab CI

swarm-scan:
  stage: test
  script:
    - npm run swarm:run -- --target $STAGING_URL --json --out swarm-results.json
  artifacts:
    paths:
      - swarm-results.json

Weiterführend

• Swarm QA Übersicht →
• Authentifizierung →
• Presets →