[cachekit-release-bot]

🤖 I have created a release beep boop

0.26.0 (2026-11-03)

⚠ BREAKING CHANGES

• decorators: an L1-only cache (@cache(backend=None), @cache.local(), or any plaintext, non-interop decorator that finds no backend configured) times its TTLs and its stale-while-revalidate refresh on the OS monotonic clock that the Rust extension reads, not on time.monotonic(). Patching time.monotonic (pytest's monkeypatch, freezegun's freeze_time or tick) no longer expires its entries or brings a refresh due: a test that needs an entry gone calls fn.invalidate_cache(...) or fn.cache_clear(). Caches with a backend are unchanged.

Features

• cachekitio: report L1 hit latency and add a telemetry off switch (LAB-12079) (#691) (0cc1a9c)
• decorators: let async @cache opt out of the miss-path distributed lock (LAB-7166) (#667) (1e2295d)

Bug Fixes

• decorators: clear an L1-only cache whole on invalidate-all and let the memo own the kill (LAB-12024) (#677) (5aeaa63)
• metrics: skip thread-state retirement once the interpreter is exiting (LAB-12087) (#679) (42d7aea)
• monitoring: make enable_prometheus_metrics=False stop recording (LAB-12038) (#681) (3d81a93)
• perf: name the cachekit, Python and CPU a terrain recording ran (LAB-11993) (#687) (251a2fa)
• perf: terrain canary records the L2 label without its padding (LAB-11993) (#676) (4b2c65c)
• rust: decode StandardSerializer MessagePack in safe Rust (LAB-12250) (#694) (53bd1f3)

Performance Improvements

• decorators: a backed L1 hit skips the stats context and log kwargs (LAB-12115) (#686) (9c1bd7f)
• decorators: answer the L1-only hit in one lock-free call into the extension (LAB-12024) (#673) (8b17e51)
• deps: bump cachekit-core to 0.7.4 (LAB-12129) (#684) (9485ca8)
• ir: make measured startup the same in every run and re-record every budget (LAB-12297) (#699) (7146959)
• ir: run the 2,600 Ir/op paths over 300,000 calls (LAB-12245) (#697) (0e15cb6)
• l1: auto and orjson L1 hits skip re-verification and the per-read copy (LAB-12119) (#696) (9ce58b6)
• l1: skip the structure walk and object hook on a kept L1 entry (LAB-12023) (#671) (7fbdfbe)
• l1: sweep expired entries from a deadline heap in short lock holds (LAB-12117) (#683) (63cf745)
• memcached: pick the server natively, as pymemcache's rendezvous hash does (LAB-12116) (#680) (a79cc90)
• redis: an uncontended async miss waits on 3 round trips, not 5 (LAB-12118) (#682) (1ef1d05)
• serializers: decode StandardSerializer reads in Rust, bounds and decode in one pass (LAB-12030) (#674) (39b1bdf)
• write-behind: park an idle writer thread instead of starting one per miss (LAB-12005) (#692) (96141b7)

---

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

• Source mode: Auto
• Repository: cachekit-io/cachekit-py
• Branch: main
• File: .coderabbit.yaml
• Commit: 24ee43d
• Layers: Repository YAML
• Review profile: ASSERTIVE
• Plan: Advanced
• Run ID: 025b8cd3-a54f-4aad-961e-e435e10d8b92

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

• Autofix · 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

CodeRabbit Verify

• Run CodeRabbit Verify to test the changes in this pull request.

[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!

[github-actions]

Instruction budget: FAIL

Head 8ee28e800b6de813b43e7962de5bffe9e89f3d01 measured against base v0.25.1 (312836d), last release on the same runner, on cpython-3.12-x86_64 (3.12.3). Workflow run

Verdict	Path	Head Ir/op	Base Ir/op	Delta
FAIL	byte_storage_store_40b	2,780	2,746	+1.24%
WARN	object_cache_put_full	198,952	198,360	+0.30%
WARN	serializer_arrow	2,226,826	2,211,935	+0.67%
new	l1_hit_backed	–	–	–
new	l1_hit_backed_auto	–	–	–
LOWER	l1_hit	3,314	13,131	-74.76%
LOWER	l2_hit	186,048	196,460	-5.30%
LOWER	l2_hit_async_metrics	186,235	195,620	-4.80%
LOWER	minimal_l1_hit	3,315	12,009	-72.40%
LOWER	secure_l1_hit	139,024	156,110	-10.94%
LOWER	serializer_auto	70,832	72,504	-2.31%
LOWER	serializer_default	52,393	64,349	-18.58%
LOWER	serializer_default_records	1,060,465	1,481,413	-28.42%
LOWER	serializer_encrypted	97,226	109,077	-10.86%
LOWER	serializer_orjson	24,402	24,807	-1.63%
ok	byte_storage_store_64k	724,685	724,630	+0.01%
ok	file_set	86,608	86,707	-0.11%
ok	miss	242,386	242,467	-0.03%

A path fails at +1% or more against the base. This check is not required: a deliberate cost increase is accepted at merge. Method: docs/performance.md, Instruction budgets.

[27Bslash6]

@kody start-review

[kodus-27b]

Code Review Completed! 🔥

The code review was successfully completed based on your current configurations.

Kody Guide: Usage and Configuration

Interacting with Kody

• Request a Review: Ask Kody to review your PR manually by adding a comment with the `@kody start-review` command at the root of your PR.

• Provide Feedback: Help Kody learn and improve by reacting to its comments with a 👍 for helpful suggestions or a 👎 if improvements are needed.

Providing Context (Files & MCPs)

Add these hints in your PR description (or a comment) to unlock deeper checks:

• Ticket / Acceptance Criteria: `Refs: ABC-123` (Linear/Jira/Asana/ClickUp/Trello) or a direct ticket link.
• Bugfix Validation: a Sentry/Datadog/Bugsnag event link (or paste the stack trace/error message).
• Endpoint Risk: mention the route (e.g., `POST /api/payments`) or controller/action name.
• Attach a repo file as context: use an explicit marker like `@file:docs/guide.mdx#L10-L50` (replace with your real path).
• API Contract Docs: include `@file:openapi.yaml` or `@file:swagger.json` when changing routes/schemas.
• Definition of Done / Standards: include `@file:DOD.md` or `@file:CONTRIBUTING.md` if your repo has them.
• Design System Source of Truth: include `@file:ui/index.ts` (replace with your DS entrypoint path).
• Feature Flags: include the flag key/name and `@file:flags.ts` / `@file:config.json` (and optionally the PostHog flag name).
• Edge/CDN Rules: link the Cloudflare rule/zone or describe the intended redirect/header behavior.
• Attach an MCP tool output: use `@mcp<provider|tool>` (replace with an installed MCP provider + tool, e.g., `@mcp<sentry|events.search>`).

Current Kody Configuration

Review Options

The following review options are enabled or disabled:

Options	Enabled
Bug	✅
Performance	✅
Security	✅
Business Logic	✅

Access your configuration settings here.