WIT-first contract compiler for stable Rust, protobuf, JSON Schema, and versioned adapters
The repository contains two runnable examples with committed generated output.
examples/single exercises:
witforge.toml;--check mode.git clone https://github.com/asamarts/witforge.git
cd witforge/examples/single
witforge check wit/v0.1
witforge rust --config witforge.toml
witforge proto --config witforge.toml
witforge schema --config witforge.toml
witforge glue --config witforge.toml
The exact generated files are under
examples/single/generated.
The generated-output guide walks through representative sections.
examples/evolved contains released v0.1 and draft v0.2. It demonstrates lock continuity, diff, release freezing, and generated version adapters.
cd witforge/examples/evolved
witforge check wit/v0.2 --against wit/v0.1/wire.lock
witforge diff wit/v0.1 wit/v0.2
witforge rust --config witforge.toml
The example adds defaultable fields. Version-adapter generation accepts them, but diff --check
still reports a source/generated-API break. Use plain diff to review the example; add --check
when project policy forbids those changes.
Generated output is committed for review and checked for drift in CI. Run any generator without
--check to update it, review the diff, then run the same command with --check.