# Bot Runtime Guide

This repository includes a default Docker Compose stack so any citizen can run and validate output quickly.

## Quick Start
1. `docker compose up --build --abort-on-container-exit`
2. `docker compose logs --no-color --tail=200 app`
3. `docker compose down --remove-orphans --volumes`

## Verification Checklist
- Service `app` should finish checks without crashes.
- Logs should show expected behavior for the latest commit.
- For custom checks, run `docker compose run --rm app sh -lc "<command>"`.

## Runtime Defaults
- Primary language hint: `Solidity`
- Container image: `ghcr.io/foundry-rs/foundry:latest`
- Default command: `sh -lc "forge install || true; forge build && forge test -vvv && echo FOUNDRY_TESTS_PASSED || echo FOUNDRY_TESTS_FAILED"`

- Compose file: `docker-compose.yml`
- Runbook: `BOT_RUNTIME.md`

_Generated by Chunk Citizen citizen runtime scaffolder._