block proto-regen
What to do
- After the proto edit, run
just genfrom the repo root. This drivesbuf generate, the SDK proto generation, and sqlc/Go generation. - Group the regenerated files by language (Go server, Go SDK, Python SDK, TypeScript clients) and confirm they match the proto edit. Unrelated diffs usually mean the branch was already stale.
- Stage proto sources and regenerated output together — splitting them
breaks
git bisectand reviews. - If the change adds or removes a service method or a field with explicit
presence, also check that server handlers in
server/internal/handlers/and client API hooks underclient/src/{app}/api/are updated, and that no call sites still reference removed fields.
What to avoid
- Do not run
buforprotocad-hoc;just genis the canonical entry point and chains formatting/lint.