Greptile Summary

This PR introduces a CircuitBreaker cache adapter that wraps any Adapter + UtopiaCircuitBreaker pair, routes all cache operations through the breaker with typed fallbacks, and adds a Feature\Telemetry interface so telemetry can be forwarded to adapters that opt in. Issues flagged in earlier review rounds (dependency in require, exact version pin, telemetry not reaching the inner adapter) have all been addressed in this revision.

• src/Cache/Adapter/CircuitBreaker.php — new production adapter; delegates all Adapter methods through the breaker and correctly propagates telemetry to both the breaker and any TelemetryAware inner adapter.
• src/Cache/Cache.php — setTelemetry() now also forwards to the adapter when it implements Feature\Telemetry; this fires once on construction (via NoTelemetry) and again on explicit caller assignment.
• composer.json — utopia-php/circuit-breaker promoted to require with a 0.3.* range; PHP floor raised to >=8.2 to match the package's requirement.

Confidence Score: 5/5

Safe to merge; the adapter is well-tested, dependency placement and version constraints are correct, and telemetry propagation works as documented.

All changes are additive and isolated to the new CircuitBreaker adapter and the telemetry hook in Cache::setTelemetry. The dependency is correctly placed in require, the version constraint allows patch updates, and the test suite covers healthy pass-through, fallback on failure, breaker short-circuiting, and telemetry propagation to both the breaker and inner adapters.

No files require special attention.

Important Files Changed

_{Reviews (11): Last reviewed commit: "Use camel case telemetry test name" | Re-trigger Greptile}