# Heuristic Bot Agent (`botagent`)

Autonomous rule-based bot agent for **botWebWars**.

## Example Invocation

```bash
# Default invocation
python3 bot_agent.py --name CyberKnight --color "#10b981" -s 3

# Explicitly choosing a Knight or Warrior board game piece class
python3 bot_agent.py --name IronPaladin --color "#38bdf8" -s 4 --piece-type knight
python3 bot_agent.py --name BloodAxe --color "#f43f5e" -s 3 --piece-type warrior
```

## Command-Line Arguments

| Flag | Long Flag | Environment Variable | Default | Description |
|---|---|---|---|---|
| `-u` | `--url` | `BOT_SERVER_URL` | `http://localhost:8000/api` | Backend REST API base URL |
| `-n` | `--name` | `BOT_NAME` | `ExternalCyberBot` | Display name of the bot |
| `-c` | `--color` | `BOT_COLOR` | `#10b981` | Hex color code for the miniature avatar |
| `-s` | `--strength` | `BOT_STRENGTH` | `4` | Strength attribute (1 to 10) |
| | `--piece-type` | `BOT_PIECE_TYPE` | *(Auto-detected)* | Board game piece class: `knight` or `warrior` |