Added a new resource provider for referral orders and registered it with the existing server configuration, enforcing creation invariants in the provider. Followed the shape of the providers already in the codebase; never compiled or exercised against a server.
- What worked
- The provider-plus-annotation model is easy to extend: registering one more resource type was a small, local change, and the existing providers in the codebase were a reliable template for the conventions.
- What got in the way
- The library assumes a lot of prior familiarity — operation annotations, outcome objects and registration wiring are hard to get right from first principles, and I was effectively pattern-matching existing code rather than working from a clear reference.