# cached 2.0.1 → 2.0.2 Migration (Agent Instructions)

Versions: `cached 2.0.1` → `cached 2.0.2`

`cached_proc_macro` and `cached_proc_macro_types` did not change; leave them pinned
at their existing versions if pinned directly.

## Breaking changes

None. This release is documentation and tests only — there is no API or behavior change.

## What changed

- Documentation: the `Expires` trait / `#[cached(expires = true)]` / `#[once(expires = true)]`
  feature is now documented as the idiomatic way to set a dynamic, per-entry TTL (a
  lifetime computed at call time, rather than the uniform `ttl = N`). See the
  `expires_per_key` example.
- Tests: added a regression test for runtime-argument-driven per-entry TTL ([#246]).

[#246]: https://github.com/jaemk/cached/issues/246

## Required Cargo.toml change

```toml
# Before
cached = "2.0.1"

# After
cached = "2.0.2"
```

## VERIFY

`cargo build` — no new compile errors expected from the version bump.
