Cacheable feature improvements and documentation updates

[agrberg]

Summary

• Forward keyword arguments and blocks through cached methods — key_format and unless procs now receive **kwargs, and blocks are forwarded through the caching layer
• Warn when default cache key format is used with arguments — emits a stderr warning when arguments are passed but not included in the cache key
• Make MemoryAdapter thread-safe — wraps all operations with Monitor for safe concurrent access
• Support per-class cache adapter configuration — classes can set their own adapter via self.cache_adapter = instead of only using the global
• Stop polluting Cacheable namespace with interceptor constants — interceptor modules are now anonymous, stored as instance variables
• Update documentation and examples — README reflects all new features, examples use **kwargs with a date: keyword argument, star counts refreshed

Test plan

• bundle exec rake passes (RuboCop clean, 64 specs, 0 failures)
• All four example files run and produce output matching their comments
• Visually confirm README renders correctly on GitHub after merge

🤖 Generated with Claude Code

[Copilot]

Pull request overview

This PR enhances the Cacheable gem’s caching interceptor to better support modern Ruby calling patterns (kwargs + blocks), improves safety and configurability of caching backends, and updates docs/examples accordingly.

Changes:

• Forward **kwargs and blocks through cacheable wrappers; pass **kwargs into key_format / unless.
• Add a stderr warning when the default cache key format is used with arguments.
• Make MemoryAdapter thread-safe and add per-class cache adapter support; switch interceptor modules to anonymous (no Cacheable::... constants).

Reviewed changes

Copilot reviewed 13 out of 14 changed files in this pull request and generated 6 comments.

Show a summary per file

File	Description
spec/spec_helper.rb	Switch test bootstrapping to bundler/setup.
spec/cacheable/cacheable_spec.rb	Add specs for kwargs/block forwarding, warnings, and per-class adapters; adjust interceptor naming assertions.
lib/cacheable/method_generator.rb	Forward kwargs/blocks, use class-specific adapters, and warn when default key format is used with args.
lib/cacheable/cache_adapters/memory_adapter.rb	Add Monitor synchronization for thread-safety.
lib/cacheable/cache_adapter.rb	Implement per-class adapter fallback to global adapter.
lib/cacheable.rb	Create per-class anonymous interceptor module and store it on the class (no namespace constants).
examples/simple_example.rb	Refresh example output values.
examples/custom_key_example.rb	Update example to use kwargs-based key_format and date: kwarg.
examples/conditional_example.rb	Update conditional caching example for kwargs and date: kwarg.
examples/class_method_example.rb	Refresh example output values.
README.md	Document kwargs/block behavior, default-key-format warning, and per-class adapters; refresh examples/output.
Gemfile.lock	Normalize platforms and ffi entry.
CLAUDE.md	Add repository guidance for Claude Code.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

Pull request overview

Copilot reviewed 14 out of 15 changed files in this pull request and generated no new comments.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[agrberg]

@rofreg Claude and I worked thought a number of improvements I'd had on my mind and some I didn't even consider previously! Let me know if you'd rather pull any of these additions out. They were made with the intention that it should not require a major version bump / break any existing integrations (save maybe the warning in folk's logs).