**Лабораторные цели (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

**Просмотр отчетов в браузере:**```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

**Контроль стоимости** — три переменные окружения / флаги CLI:

| Флаг | Переменная окружения | По умолчанию |
|---|---|---|
| `--model` | `TENGU_AGENT_MODEL` | `claude-sonnet-4-6` |
| `--max-tokens` | `TENGU_AGENT_MAX_TOKENS` | `2048` |
| `--timeout` | `TENGU_AGENT_TIMEOUT` | `60` (минут, `0`=без ограничения) |

### Как это работает```
START → initializer → strategist ─┬─→ executor → analyst ─┬─→ strategist (loop)
                                   │                        └─→ reporter → END
                                   ├─→ human_gate → executor
                                   └─→ reporter → END

---

## Конфигурационные файлы

Tengu использует три конфигурационных файла. Редактирование не того файла — самый частый источник путаницы при переключении между локальным и Docker-воркфлоу.

| Файл | Когда использовать | Что контролирует |
|------|-------------------|------------------|
| `tengu.toml` (корень) | При локальном запуске: `uv run tengu`, `uv run python autonomous_tengu.py` | Конфигурация MCP-сервера: `allowed_hosts`, пути инструментов, лимиты, стелс |
| `docker/tengu.toml` | При запуске через Docker: `make docker-up`, `make docker-agent` | Те же настройки, что и в корне, но предварительно настроены для Docker-сети (`172.16.0.0/12`, DNS-алиасы сервисов). Встраивается в образ во время сборки — после изменений требуется **пересборка** (`make docker-rebuild-tengu`) |
| `.env` | Локально и Docker | Секреты и переменные времени выполнения: `ANTHROPIC_API_KEY`, `TENGU_AGENT_TARGET`, `TENGU_AGENT_MODEL`, `TENGU_AGENT_MAX_TOKENS` и т.д. Читается `docker compose` и `load_dotenv()` |
| `.env.example` | Только для справки | Шаблон со списком всех доступных переменных окружения |

**Быстрая настройка для режима copilot (локально):** отредактируйте `tengu.toml` в корне проекта — добавьте вашу цель в `[targets] allowed_hosts`.

**Быстрая настройка для режима agent (Docker):** отредактируйте `docker/tengu.toml`, затем выполните `make docker-rebuild-tengu` перед `make docker-agent`.

> **Частая ошибка:** если сканирование завершается ошибкой `TargetNotAllowedError` внутри Docker, вы, вероятно, отредактировали `tengu.toml` (корень) вместо `docker/tengu.toml`. Docker использует свою копию, встроенную в образ. После редактирования выполните `make docker-rebuild-tengu`.

---

## Безопасность по замыслу

Tengu создан как **усилитель возможностей для людей-пентестеров**, а не как автономный инструмент для атак.

| Контроль | Описание |
|----------|----------|
| **Белый список целей** | Сканируются только предварительно одобренные цели из `tengu.toml` |
| **Очистка ввода** | Все входные данные проверяются на соответствие строгим шаблонам перед передачей любому инструменту |
| **Ограничение скорости** | Скользящее окно + ограничения на количество одновременных запросов предотвращают случайный DoS |
| **Аудит логов** | Каждый вызов инструмента записывается в `./logs/tengu-audit.log` в формате JSON |
| **Контроль человека** | `msf_run_module`, `hydra_attack` и `impacket_kerberoast` требуют явного подтверждения |
| **Никогда shell=True** | Все вызовы подпроцессов используют `asyncio.create_subprocess_exec` |

---

## Разработка

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