# l4d2-host-lib

Python host library and CLI for managing L4D2 instances.

## CLI

`l4d2ctl` exposes exactly these commands in v1:

- `install`
- `initialize <name> -f <spec.yaml>`
- `start <name>`
- `stop <name>`
- `delete <name>`

Subprocess failures are fail-fast. Raw stderr is written to stderr and the command exits with the same subprocess return code.

## Runtime Paths

The host library uses hard-coded runtime paths under `/opt/l4d2`:

- `/opt/l4d2/installation`
- `/opt/l4d2/overlays/<overlay>`
- `/opt/l4d2/instances/<name>`
- `/opt/l4d2/runtime/<name>/{upper,work,merged}`

## Web App Read APIs

These read APIs are provided for web app integration:

- `get_instance_status(name)`
- `stream_instance_logs(name, lines=200, follow=True)`