#contracts

Building thoughtful software with AI.Notes from the systems behind the work.

August 10, 2026article

One version label was hiding three record shapes in my planner

The case-ordering planner kept growing new fields under its version-one label until one tag covered three shapes; I froze the original, moved the new meaning to a successor, and made the planner stop and name any record caught in between.

schema-evolution contracts data-integrity

5m read

Also new

February 28, 2026 4m
Auth middleware would have logged everyone out the minute the auth server hiccupped
February 26, 2026 3m
Version-sync script stamped the SDK's version onto Maven's plugins, then passed its own check
September 18, 2025 4m
Telemetry sent its strangest events with the least information

August 2025

August 6, 2025article

Chore delete said it worked and deleted nothing

The browser started sending a chore's id in the query string, the server compared that text to a stored number with a strict check, and every delete rewrote the same file and reported success. Now the id is parsed once on arrival, with a few loose ends I still don't like.

software-engineering api-design data-integrity

3m read