chore(main): release 0.22.0

[cachekit-release-bot]

🤖 I have created a release beep boop

0.22.0 (2026-10-04)

⚠ BREAKING CHANGES

• cachekitio: replace httpx with urllib3 for CachekitIO requests (LAB-7931) (#502)
• decorators: refuse an encrypting serializer at decoration (LAB-5320) (#467)

Features

• cachekitio: replace httpx with urllib3 for CachekitIO requests (LAB-7931) (#502) (3fe6772)
• cachekitio: send a cachekit-py/<version> User-Agent (LAB-7052) (#479) (9dc474a)
• invalidation: announce each invalidation on a Redis pub/sub channel (LAB-652) (#470) (5733626)
• invalidation: detect a silent Redis peer on the listener with TCP_USER_TIMEOUT (LAB-7586) (#499) (986e4ff)
• invalidation: opt-in listener evicts L1 on other processes' invalidations (LAB-652) (#472) (1ae8f12)
• l1: a forked child starts with an empty L1 (LAB-652) (#471) (5097c12)

Bug Fixes

• arrow: reject dict values that pyarrow stores as the wrong column (LAB-7490) (#459) (5cec332)
• cachekitio: build the sync client on HTTP/1.1 with a 32-connection pool (LAB-7062) (#489) (80dbf5c)
• cachekitio: never reuse a parent's pooled connection after fork (LAB-7146) (#468) (15c1351)
• cachekitio: parse X-CacheKit-Fresh-For with the spec grammar (LAB-7838) (#504) (6cb5f4d)
• cachekitio: retry a write once on 503 with a short Retry-After (LAB-7686) (#477) (77a16a5)
• circuit-breaker: stop the decorated function's exceptions tripping the breaker (LAB-5319) (#485) (af48926)
• decorators: degrade on async lock errors instead of raising or polling (LAB-5346) (#473) (6f901f6)
• decorators: refuse an encrypting serializer at decoration (LAB-5320) (#467) (ef4a7f2)
• invalidation: delete the pre-0.20.0 twin on no-args invalidation (LAB-5308) (#464) (f8365d3)
• invalidation: recommend --py-call-uwsgi-fork-hooks, never --py-call-osafterfork, for uWSGI (LAB-7855) (#491) (3e192f7)
• invalidation: throttle the listener's reconnect WARNING to one a minute (LAB-7638) (#482) (b3a6c8a)
• l1: bound one entry to an eighth of the L1 budget (LAB-7823) (#487) (35b6791)
• metrics: size the duration and size histogram buckets for ms and bytes (LAB-7587) (#476) (f1a52bd)
• object-cache: repair L1-only caches in a forked child (LAB-7856) (#494) (0a78131)
• redaction: digest keys holding an unpaired surrogate instead of raising (LAB-7624) (#497) (000b110)
• redis: decide on hiredis before redis imports so 3.14t keeps the GIL off (LAB-7077) (#465) (c19ab6b)
• swr: release refresh slots stranded on stopped event loops (LAB-7295) (#488) (b41c626)

Performance Improvements

• cachekitio: fan out whole-function invalidation deletes, 16 at a time (LAB-7070) (#478) (72026b1)
• cachekitio: keep idle connections 390 s with TCP keepalive 60/10/3 (LAB-7061) (#483) (c695bf2)
• cachekitio: skip the uncontended double-check read and release the miss lock in the background (LAB-7064) (#480) (f4b8dfe)
• decorators: decide refresh_ttl_on_get from Fresh-For, refresh in the background (LAB-7074) (#435) (cc9bf65)
• metrics: recover the perf-ir drift on the L2 and miss paths (LAB-7801) (#481) (d200c3a)
• serializers: memoize CK frame headers and pack AutoSerializer values without rebuilding the tree (LAB-7069) (#441) (c2e907a)

---

This PR was generated with Release Please. See documentation.

[coderabbitai]

Important

Review skipped

Bot user detected.

To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

• Configuration used: Repository: cachekit-io/cachekit-py/.coderabbit.yaml
• Review profile: ASSERTIVE
• Plan: Advanced
• Run ID: 67c91566-124a-4fcb-95d0-e0d740f24b41

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

• Autopilot · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ All tests successful. No failed tests found.

📢 Thoughts on this report? Let us know!

[cachekit-release-bot]

🤖 Created releases:

• v0.22.0

🌻