Code generation policy

Decision: - Do not commit generated protobuf outputs (e.g., core/src-gen). - Generated code is produced during Docker build (and optionally in CI).

Rationale

  • Avoids noisy diffs and merge conflicts.
  • Ensures generation is reproducible from pinned toolchains.
  • Keeps the repo focused on source-of-truth (.proto).

How it works

  • core/Dockerfile installs and pins:
    • buf
    • protoc
    • proto-lens-protoc
  • During image build, protobuf modules are generated into core/src-gen/.

Local development

If you want to generate locally:

bash scripts/proto-generate.sh