Contributing

Development Workflow

Build, test, validate, and review Beelzebub changes locally.

go test ./...
go vet ./...
make validate-specs
make validate-all

Integration tests require Docker and use integration_test/docker-compose.yml. Keep protocol behavior covered by focused tests, update examples and schemas with configuration changes, and include security impact and captured-data considerations in pull requests.

Edit on GitHub

External Plugin

Install the hello-demon blueprint, wire it to a route, and verify a compiled extension.

Runtime Change Checklist

Keep code, schemas, examples, validation, and documentation aligned when the runtime evolves.