**Alvos de laboratório (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 relatórios no 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

**Controle de custo** — três variáveis de ambiente / flags de CLI:

| Flag | Variável de ambiente | Padrão |
|---|---|---|
| `--model` | `TENGU_AGENT_MODEL` | `claude-sonnet-4-6` |
| `--max-tokens` | `TENGU_AGENT_MAX_TOKENS` | `2048` |
| `--timeout` | `TENGU_AGENT_TIMEOUT` | `60` (minutos, `0`=ilimitado) |

### Como Funciona```
START → initializer → strategist ─┬─→ executor → analyst ─┬─→ strategist (loop)
                                   │                        └─→ reporter → END
                                   ├─→ human_gate → executor
                                   └─→ reporter → END

---

## Arquivos de Configuração

O Tengu usa três arquivos de configuração. Editar o arquivo errado é a fonte mais comum de confusão ao alternar entre fluxos de trabalho local e Docker.

| Arquivo | Quando usar | O que controla |
|---------|-------------|----------------|
| `tengu.toml` (raiz) | Executando localmente: `uv run tengu`, `uv run python autonomous_tengu.py` | Config do servidor MCP: `allowed_hosts`, caminhos das ferramentas, limites de taxa, furtividade |
| `docker/tengu.toml` | Executando via Docker: `make docker-up`, `make docker-agent` | Mesmas configurações da raiz, mas pré-configurado para rede Docker (`172.16.0.0/12`, aliases de DNS de serviço). Incorporado na imagem durante a construção — **reconstrução necessária** após alterações (`make docker-rebuild-tengu`) |
| `.env` | Tanto local quanto Docker | Segredos e variáveis de tempo de execução: `ANTHROPIC_API_KEY`, `TENGU_AGENT_TARGET`, `TENGU_AGENT_MODEL`, `TENGU_AGENT_MAX_TOKENS`, etc. Lido por `docker compose` e `load_dotenv()` |
| `.env.example` | Apenas referência | Modelo listando todas as variáveis de ambiente disponíveis |

**Configuração rápida para modo copiloto (local):** edite `tengu.toml` na raiz do projeto — adicione seu alvo em `[targets] allowed_hosts`.

**Configuração rápida para modo agente (Docker):** edite `docker/tengu.toml`, então execute `make docker-rebuild-tengu` antes de `make docker-agent`.

> **Armadilha comum:** se as varreduras falharem com `TargetNotAllowedError` dentro do Docker, provavelmente você editou `tengu.toml` (raiz) em vez de `docker/tengu.toml`. O Docker usa sua própria cópia incorporada na imagem. Após editar, execute `make docker-rebuild-tengu`.

---

## Segurança por Projeto

O Tengu foi construído como um **multiplicador de força para testadores de penetração humanos**, não como uma ferramenta de ataque autônoma.

| Controle | Descrição |
|----------|-----------|
| **Lista de permissão de alvos** | Apenas alvos pré-aprovados em `tengu.toml` são escaneados |
| **Sanitização de entrada** | Todas as entradas são validadas contra padrões rigorosos antes de atingir qualquer ferramenta |
| **Limitação de taxa** | Janela deslizante + limites de slot simultâneos impedem DoS acidental |
| **Registro de auditoria** | Cada invocação de ferramenta registrada em `./logs/tengu-audit.log` no formato JSON |
| **Humano no circuito** | `msf_run_module`, `hydra_attack` e `impacket_kerberoast` exigem confirmação explícita |
| **Sem shell=True — nunca** | Todas as chamadas de subprocesso usam `asyncio.create_subprocess_exec` |

---

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