Engineering reference
This book describes the runnable implementation of Supercast: the dependency-free Rust core, the JSON adapter, SQLite journals, evaluation tools, and the local build and release process. It accompanies the Forecasting Handbook, which explains how to use the methods responsibly.
The API reference is generated from the executable’s request schema. Every operation page includes a request, any setup needed, an actual response with commit times redacted, and independently specified checks on the result. The documentation gate fails if an operation has no example, an example no longer works, or a generated page drifts.
Find the right level
| Need | Chapter |
|---|---|
| Build and run locally | Installation |
| Call Rust functions directly | Architecture and Rust API |
| Understand numerical corner cases | Numerical contracts |
| Integrate a tool-calling process | Protocol and operation index |
| Recover from an error or retry | Errors |
| Understand persistence guarantees | Storage |
| Evaluate predictions correctly | Evaluation contracts |
| Maintain or release the project | Testing, operations, extension guide |
The protocol is application-specific newline-delimited JSON, not MCP. It can be wrapped by an agent framework without coupling the core to a model provider. Source verification, model inference, scheduling and factual adjudication remain inputs from that application.
The implemented journal stores binary forecasts. Categorical and continuous scoring tools are also available as standalone calculations. Their existence does not imply a categorical/continuous journal type or an automatically fitted distribution model.
All documented commands are local. No build script publishes to a registry, sends forecasts to other people, or silently schedules future activity.