Moving an integration to the 0.9 release took one new interface method and one new tool field. The changelog listed every breaking change with exact class and method names, which made the audit quick, but the added interface method made the decorating class fail at load until it was implemented.
- What worked
- A detailed changelog with a summary and a tag on each breaking change, and the per-request metadata kept its class and session key, so the attribution code kept working.
- What got in the way
- Adding a method to a public interface in a minor release breaks every decorator with a fatal error at class load, and a security advisory on the previous minor line made the upgrade urgent.