**Cibles de laboratoire (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

**Consulter les rapports dans le navigateur :**```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

**Contrôle des coûts** — trois variables d'environnement / indicateurs CLI :

| Indicateur | Variable env. | Défaut |
|---|---|---|
| `--model` | `TENGU_AGENT_MODEL` | `claude-sonnet-4-6` |
| `--max-tokens` | `TENGU_AGENT_MAX_TOKENS` | `2048` |
| `--timeout` | `TENGU_AGENT_TIMEOUT` | `60` (minutes, `0`=illimité) |

### Comment ça fonctionne```
START → initializer → strategist ─┬─→ executor → analyst ─┬─→ strategist (loop)
                                   │                        └─→ reporter → END
                                   ├─→ human_gate → executor
                                   └─→ reporter → END

---

## Fichiers de configuration

Tengu utilise trois fichiers de configuration. Modifier le mauvais fichier est la source la plus fréquente de confusion lors du passage entre les workflows local et Docker.

| Fichier | Quand l'utiliser | Ce qu'il contrôle |
|---------|-----------------|-------------------|
| `tengu.toml` (racine) | Exécution locale : `uv run tengu`, `uv run python autonomous_tengu.py` | Configuration du serveur MCP : `allowed_hosts`, chemins des outils, limites de débit, furtivité |
| `docker/tengu.toml` | Exécution via Docker : `make docker-up`, `make docker-agent` | Mêmes paramètres que la racine, mais préconfigurés pour le réseau Docker (`172.16.0.0/12`, alias DNS de service). Intégré dans l'image lors de la construction — **reconstruction nécessaire** après modifications (`make docker-rebuild-tengu`) |
| `.env` | Local et Docker | Secrets et variables d'exécution : `ANTHROPIC_API_KEY`, `TENGU_AGENT_TARGET`, `TENGU_AGENT_MODEL`, `TENGU_AGENT_MAX_TOKENS`, etc. Lus par `docker compose` et `load_dotenv()` |
| `.env.example` | Référence uniquement | Modèle listant toutes les variables d'environnement disponibles |

**Configuration rapide pour le mode copilote (local) :** modifiez `tengu.toml` à la racine du projet —
ajoutez votre cible à `[targets] allowed_hosts`.

**Configuration rapide pour le mode agent (Docker) :** modifiez `docker/tengu.toml`, puis exécutez
`make docker-rebuild-tengu` avant `make docker-agent`.

> **Piège courant :** si les scans échouent avec `TargetNotAllowedError` dans Docker, vous
> avez probablement modifié `tengu.toml` (racine) au lieu de `docker/tengu.toml`. Docker utilise sa
> propre copie intégrée dans l'image. Après modification, exécutez `make docker-rebuild-tengu`.

---

## Sécurité par Conception

Tengu est conçu comme un **multiplicateur de force pour les testeurs d'intrusion humains**, pas comme un outil d'attaque autonome.

| Contrôle | Description |
|----------|-------------|
| **Liste blanche des cibles** | Seules les cibles pré-approuvées dans `tengu.toml` sont scannées |
| **Assainissement des entrées** | Toutes les entrées sont validées selon des modèles stricts avant d'atteindre un outil |
| **Limitation de débit** | Fenêtre glissante + limites de créneaux simultanés empêchent un DoS accidentel |
| **Journalisation d'audit** | Chaque invocation d'outil est enregistrée dans `./logs/tengu-audit.log` au format JSON |
| **Humain dans la boucle** | `msf_run_module`, `hydra_attack` et `impacket_kerberoast` exigent une confirmation explicite |
| **Jamais shell=True** | Tous les appels de sous-processus utilisent `asyncio.create_subprocess_exec` |

---

## Développement```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