Development
Every development and CI target runs in the image built from Dockerfile.dev, with the checkout mounted at /work. The host needs Docker and Make, not a Go toolchain.
Contents
Package layout
A provider-neutral engine plus provider drivers. Your code holds elelem.Driver, elelem.Client and elelem.Request; provider SDK types stay locked inside their driver package and never leak out.
client.go, request.go, engine.go request construction and execution
user_message_queue.go bounded user input between provider rounds
driver.go, errors.go provider boundary and sentinels
prompt.go, content.go immutable prompts and message content parts
model.go, params.go model metadata and generation parameters
events.go callback event types
message.go, transcript.go transcript primitives and repair
usage.go token and retry accounting
tool.go, toolimages.go tools, hooks, message injection, tool images
limit.go, tokens.go history budgeting
retry.go retry decorator
structured.go typed structured responses
log_reason.go stable reason values for log lines
elelemtest/ scripted Driver (imports no test framework)
elelemtest/conformance/ driver contract suite
elelemtest/mocks/ generated Driver mock
drivers/openai/ OpenAI-compatible transport
drivers/anthropic/ Anthropic transport
drivers/zaicoding/ Z.ai Coding transport
mcp/ MCP server tools as elelem tools
sdkprobe/ opt-in live probes of the raw provider SDKs (build tag sdkprobe)
Three placements the filename alone won’t give you: the round and tool loop lives in engine.go, every sentinel the root package exports lives in errors.go (each driver package has its own), and structured.go holds RunInto together with the request-validation helpers it shares with request.go.
Make targets
| Target | Does |
|---|---|
make dev-image | Builds the pinned development and CI image. Every other Go target depends on it. |
make dep | go mod tidy and go mod vendor. Dependencies are vendored in vendor/. |
make generate | go generate ./..., which regenerates the Driver mock in elelemtest/mocks/ with mockery. |
make lint | Fails on any go fix diff, then runs golangci-lint with .golangci.yml. |
make lint-fix | Applies go fix and golangci-lint fixes. |
make test | go test -race ./... |
make test-coverage | scripts/test-coverage.sh: the race-enabled suite with coverage across every package except the generated mocks. It writes coverage-percent.txt and fails below MIN_TEST_COVERAGE, 90 by default. |
make sec | scripts/sec.sh: govulncheck and semgrep, merged into sec.sarif. Fails on any finding. |
make docs | Builds this site with GitHub’s Pages image into .testing/docs-site. |
make shell | A shell in the development image. |
make help | Every target. |
CI
.github/workflows/pipeline.yml runs on every branch push: make lint, make test-coverage, make sec (the SARIF goes to code scanning) and make generate, which fails the run when a committed generated file no longer matches. Default-branch runs then refresh the coverage, version, license and imported-by badges. A weekly scheduled run keeps the imported-by badge current.
A v* tag does not rerun the checks. It waits for that commit’s default-branch run to pass, then cuts the GitHub release from the annotated tag message and refreshes the badges with that run’s coverage.