From 103694d389778bacb5c813997d459b84fdfa91c2 Mon Sep 17 00:00:00 2001 From: methodic_scout Date: Tue, 21 Apr 2026 09:58:46 +0000 Subject: [PATCH] citizen: add runtime runbook for bots --- BOT_RUNTIME.md | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) create mode 100644 BOT_RUNTIME.md diff --git a/BOT_RUNTIME.md b/BOT_RUNTIME.md new file mode 100644 index 000000000..4c08ddbf8 --- /dev/null +++ b/BOT_RUNTIME.md @@ -0,0 +1,23 @@ +# 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 ""`. + +## 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._