**Objetivos del laboratorio (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

**Ver informes en el navegador:**```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

**Control de costos** — tres variables de entorno / indicadores CLI:

| Indicador | Var. entorno | Predeterminado |
|---|---|---|
| `--model` | `TENGU_AGENT_MODEL` | `claude-sonnet-4-6` |
| `--max-tokens` | `TENGU_AGENT_MAX_TOKENS` | `2048` |
| `--timeout` | `TENGU_AGENT_TIMEOUT` | `60` (minutos, `0`=ilimitado) |

### Cómo funciona```
START → initializer → strategist ─┬─→ executor → analyst ─┬─→ strategist (loop)
                                   │                        └─→ reporter → END
                                   ├─→ human_gate → executor
                                   └─→ reporter → END

---

## Archivos de Configuración

Tengu utiliza tres archivos de configuración. Editar el incorrecto es la fuente más común de confusión al cambiar entre flujos de trabajo locales y Docker.

| Archivo | Cuándo usarlo | Qué controla |
|---------|---------------|--------------|
| `tengu.toml` (raíz) | Ejecución local: `uv run tengu`, `uv run python autonomous_tengu.py` | Configuración del servidor MCP: `allowed_hosts`, rutas de herramientas, límites de tasa, sigilo |
| `docker/tengu.toml` | Ejecución vía Docker: `make docker-up`, `make docker-agent` | Mismos ajustes que la raíz, pero preconfigurado para redes Docker (`172.16.0.0/12`, alias DNS de servicios). Incrustado en la imagen en tiempo de compilación — **requiere reconstrucción** después de cambios (`make docker-rebuild-tengu`) |
| `.env` | Tanto local como Docker | Secretos y variables de ejecución: `ANTHROPIC_API_KEY`, `TENGU_AGENT_TARGET`, `TENGU_AGENT_MODEL`, `TENGU_AGENT_MAX_TOKENS`, etc. Leído por `docker compose` y `load_dotenv()` |
| `.env.example` | Solo referencia | Plantilla que enumera todas las variables de entorno disponibles |

**Configuración rápida para modo copiloto (local):** edite `tengu.toml` en la raíz del proyecto — agregue su objetivo a `[targets] allowed_hosts`.

**Configuración rápida para modo agente (Docker):** edite `docker/tengu.toml`, luego ejecute `make docker-rebuild-tengu` antes de `make docker-agent`.

> **Error común:** si los escaneos fallan con `TargetNotAllowedError` dentro de Docker, probablemente editó `tengu.toml` (raíz) en lugar de `docker/tengu.toml`. Docker usa su propia copia incrustada en la imagen. Después de editar, ejecute `make docker-rebuild-tengu`.

---

## Seguridad por Diseño

Tengu está diseñado como un **multiplicador de fuerza para pentesters humanos**, no como una herramienta de ataque autónoma.

| Control | Descripción |
|---------|-------------|
| **Lista blanca de objetivos** | Solo se escanean objetivos pre-aprobados en `tengu.toml` |
| **Sanitización de entrada** | Todas las entradas se validan contra patrones estrictos antes de llegar a cualquier herramienta |
| **Límite de tasa** | Ventana deslizante + límites de ranuras concurrentes evitan DoS accidental |
| **Registro de auditoría** | Cada invocación de herramienta se registra en `./logs/tengu-audit.log` en formato JSON |
| **Humano en el ciclo** | `msf_run_module`, `hydra_attack` e `impacket_kerberoast` requieren confirmación explícita |
| **Sin shell=True — nunca** | Todas las llamadas a subprocesos usan `asyncio.create_subprocess_exec` |

---

## Desarrollo```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