- Use Ruby 4.0 for development; preserve Ruby 3.3 compatibility.
- Public code lives under
lib/, signatures undersig/, tests undertest/. sumup/apisowns the OpenAPI source. Changecodegen/for generated defects, runbundle exec rake generate, and inspect output. Never edit generated files.- The generator is a separate Go module under
codegen/; run its tests withgo -C codegen test ./.... Go is required for development, not by gem consumers. - Keep transport and event logic in shared runtime files. Resource classes expose
the method names specified by
x-codegen.method_name. - Use StandardRB, Minitest, Rake, and RBS. Run
bundle exec rake checkfor changes. - Tests must use fake transports and must not make live API requests.
- Preserve unknown response fields and enum values, explicit nulls, the distinct event-signature protocol, and the default of zero retries.
- Keep README examples focused on integrators. Generation and release mechanics belong in CONTRIBUTING.md.
- Preserve unrelated work. Commit and publish only when explicitly requested.