**ラボターゲット (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

**コスト管理** — 3つの環境変数 / 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は3つの設定ファイルを使用します。ローカルと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` | 参照のみ | 利用可能なすべての環境変数をリストしたテンプレート |

**クイック設定（コパイロットモード・ローカル）:** プロジェクトルートの `tengu.toml` を編集し、ターゲットを `[targets] allowed_hosts` に追加します。

**クイック設定（エージェントモード・Docker）:** `docker/tengu.toml` を編集し、`make docker-agent` の前に `make docker-rebuild-tengu` を実行します。

> **よくある落とし穴:** Docker内でスキャンが `TargetNotAllowedError` で失敗する場合、おそらく `tengu.toml`（ルート）ではなく `docker/tengu.toml` を編集する必要があります。Dockerはイメージに組み込まれた独自のコピーを使用します。編集後は `make docker-rebuild-tengu` を実行してください。

---

## 安全設計

Tenguは**人間のペネトレーションテスターの力を増幅するもの**として構築されており、自律型攻撃ツールではありません。

| 制御 | 説明 |
|---------|-------------|
| **ターゲット許可リスト** | `tengu.toml` で事前に承認されたターゲットのみがスキャンされます。 |
| **入力サニタイズ** | すべての入力は、ツールに渡される前に厳格なパターンに対して検証されます。 |
| **レート制限** | スライディングウィンドウと同時スロット制限により、偶発的なDoSを防止します。 |
| **監査ログ** | すべてのツール呼び出しは JSON 形式で `./logs/tengu-audit.log` に記録されます。 |
| **ヒューマンインザループ** | `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