Coding agent memory in Git

1---2id: 8ef26da2-2158-49a3-9c6f-52914ca3c6513created: 2026-09-174title: Generate types from the spec5description: Orval replaced hand-written API types; HTTP client generation remains deferred. Read when changing OpenAPI schemas, investigating generated type mismatches, or choosing an API client generator.6scope:7  - apps/web8  - apps/api9doNotDelete: true10---11 12The frontend contained hand-written types that had not been updated in a while, and some new features relied on them instead of the types generated from the API's OpenAPI schema. TypeScript types are now generated with Orval, and the generated models replace the hand-written API interfaces, which are deprecated.13 14Generating the HTTP getters and actions with the same tool is deferred, and will be tested first in new features under development to find edge cases before wider adoption. A single generated definition reduces duplication and inconsistency, and Orval supports `anyOf` and `oneOf`, which the previous generator did not.15 16Two alternatives were rejected. `@openapitools/openapi-generator` offers fewer customization options and has trouble with `anyOf` and `oneOf`, and `@openapi-codegen` does not generate SWR hooks. Because every change to the specification is reflected in the generated SDK, the API's OpenAPI specification must be kept up to date.