IDX-7034 Add Cache::try_insert and Cache::try_find

[dalloriam]

Changes

• Add non-blocking try_insert and try_find methods
• Replace ThreadSafe bool template param by a LockingStrategy enum
• Add TimedMutex to the LockingStrategy enum
• Enable passing a timeout to try_insert and try_find if locking strategy is TimedMutex

[Copilot]

Pull request overview

This PR introduces non-blocking and timed “try” cache operations (try_find / try_insert) and replaces the prior boolean thread-safety toggle with a more explicit LockingStrategy (None / Mutex / TimedMutex) to control locking behavior.

Changes:

• Add LockingStrategy and mutex-selection utilities, and plumb this through Cache and preset aliases.
• Add Cache::try_find / Cache::try_insert (immediate and timed variants) plus new tests covering contention/timeout behavior.
• Update performance benchmarks and a single-thread swap test to use the new locking strategy template parameter.

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
tests/src/cache_tests.cpp	Adds compile-time checks and runtime tests for try_find/try_insert, including contention and timed-lock scenarios.
include/cachemere/presets.h	Replaces bool ThreadSafe with LockingStrategy in preset aliases and updates docs accordingly.
include/cachemere/detail/locking.h	Introduces LockingStrategy, NullMutex, and mutex-type mapping utilities.
include/cachemere/cache.h	Reworks cache locking to use LockingStrategy and implements try_find/try_insert APIs.
benchmarks/performance/src/bench_cache.cpp	Updates benchmarks to instantiate caches with LockingStrategy::{Mutex,None} and fixes complexity type.

---

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