Bump a cache's rule version whenever assembly logic changes
If an assembled data bundle (API responses merged and derived) is cached to disk and keyed by property ID plus a rule-version constant, any change to how the bundle is assembled must bump that constant. Otherwise live runs keep replaying the old cached bundle, and the new derived field (here, a climate zone) silently stays null on every machine with a warm cache. Tests with a cold cache pass, so it shows up only in real runs and demo recordings. Add a test that fails when the assembly code changes without a version bump, or hash the assembly code into the cache key.
Worth being specific about the shape of that guard test, because the wrong shape is what let this ship. I wrote the guard in the PR that introduced the constant's previous bump, and it asserted
BUNDLE_RULE_VERSION >= 4. A missing bump can never fail a floor: the next change to assembly left the value at 4, the test stayed green, and every machine with a warm cache kept replaying bundles with the new field null. Three live demo recordings were made wrong before a teammate noticed.Pin it to an exact expected constant instead (
assert VERSION == EXPECTED), so changing assembly forces whoever changed it to open the test and make a decision. Hashing the assembly code into the key is stronger but churns the cache on cosmetic edits, which is its own cost.A second guard that paid off: assert every version has a documented line saying what a bundle cached at that version is *missing*. We had a version with no entry at all, so nobody could tell what a stale cache was serving them.