**Laborziele (Juice Shop, DVWA):**```bash
make docker-lab
make docker-agent          # default model (sonnet)
make docker-agent-haiku    # cheaper — claude-haiku-4-5, max_tokens=1024
make docker-agent-sonnet   # balanced — claude-sonnet-4-6, max_tokens=4096

**Berichte im Browser anzeigen:**```bash
make docker-report-view          # http://localhost:8888 — styled HTML, all reports
make docker-report-browse        # same, auto-opens browser
REPORT_PORT=9999 make docker-report-view   # custom port

**Cost control** — drei Umgebungsvariablen / CLI-Flags:

| Flag | Umgebungsvariable | Standard |
|---|---|---|
| `--model` | `TENGU_AGENT_MODEL` | `claude-sonnet-4-6` |
| `--max-tokens` | `TENGU_AGENT_MAX_TOKENS` | `2048` |
| `--timeout` | `TENGU_AGENT_TIMEOUT` | `60` (Minuten, `0`=unbegrenzt) |

### So funktioniert es```
START → initializer → strategist ─┬─→ executor → analyst ─┬─→ strategist (loop)
                                   │                        └─→ reporter → END
                                   ├─→ human_gate → executor
                                   └─→ reporter → END

---

## Konfigurationsdateien

Tengu verwendet drei Konfigurationsdateien. Die Bearbeitung der falschen Datei ist die häufigste Ursache für Verwirrung beim Wechsel zwischen lokalen und Docker-Workflows.

| Datei | Verwendungszweck | Steuerung |
|------|-------------|------------------|
| `tengu.toml` (Stamm) | Lokal ausführen: `uv run tengu`, `uv run python autonomous_tengu.py` | MCP-Server-Konfiguration: `allowed_hosts`, Tool-Pfade, Ratenlimits, Stealth |
| `docker/tengu.toml` | Ausführen über Docker: `make docker-up`, `make docker-agent` | Gleiche Einstellungen wie root, aber vorkonfiguriert für Docker-Netzwerk (`172.16.0.0/12`, Service-DNS-Aliase). Wird zur Build-Zeit in das Image eingebacken — **Neubau erforderlich** nach Änderungen (`make docker-rebuild-tengu`) |
| `.env` | Sowohl lokal als auch Docker | Geheimnisse und Laufzeitvariablen: `ANTHROPIC_API_KEY`, `TENGU_AGENT_TARGET`, `TENGU_AGENT_MODEL`, `TENGU_AGENT_MAX_TOKENS`, etc. Gelesen von `docker compose` und `load_dotenv()` |
| `.env.example` | Nur als Referenz | Vorlage, die alle verfügbaren Umgebungsvariablen auflistet |

**Schnellkonfiguration für Copilot-Modus (lokal):** Bearbeiten Sie `tengu.toml` im Projektstamm — fügen Sie Ihr Ziel zu `[targets] allowed_hosts` hinzu.

**Schnellkonfiguration für Agent-Modus (Docker):** Bearbeiten Sie `docker/tengu.toml`, führen Sie dann `make docker-rebuild-tengu` vor `make docker-agent` aus.

> **Häufige Falle:** Wenn Scans mit `TargetNotAllowedError` in Docker fehlschlagen, haben Sie wahrscheinlich `tengu.toml` (Stamm) statt `docker/tengu.toml` bearbeitet. Docker verwendet eine eigene Kopie, die in das Image eingebacken ist. Führen Sie nach der Bearbeitung `make docker-rebuild-tengu` aus.

---

## Sicherheit durch Design

Tengu ist als **Kraftverstärker für menschliche Pentester** konzipiert, nicht als autonomes Angriffstool.

| Kontrolle | Beschreibung |
|---------|-------------|
| **Zielerlaubnisliste** | Es werden nur vorab genehmigte Ziele in `tengu.toml` gescannt |
| **Eingabebereinigung** | Alle Eingaben werden vor Erreichen eines Tools anhand strenger Muster validiert |
| **Ratenbegrenzung** | Gleitfenster + gleichzeitige Slot-Limits verhindern unbeabsichtigte DoS-Angriffe |
| **Prüfprotokollierung** | Jeder Tool-Aufruf wird im JSON-Format in `./logs/tengu-audit.log` protokolliert |
| **Human-in-the-Loop** | `msf_run_module`, `hydra_attack` und `impacket_kerberoast` erfordern explizite Bestätigung |
| **Kein shell=True — niemals** | Alle Unterprozessaufrufe verwenden `asyncio.create_subprocess_exec` |

---

## Entwicklung```bash
make install-dev    # Install Python deps + dev extras
make test           # Run unit + security tests
make lint           # ruff check
make typecheck      # mypy strict
make check          # lint + typecheck
make coverage       # pytest --cov
make inspect        # Open MCP Inspector
make doctor         # Check which pentest tools are installed