circuitbreaker, retry plugin

Author: Surfoo

.github/workflows/ci.yml

@@ -17,31 +17,31 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        php-version: [ '8.1', '8.2', '8.3', '8.4']
+        php-version: [ '8.2', '8.3', '8.4', '8.5']
     steps:
-      - uses: "actions/checkout@v4"
+      - uses: "actions/checkout@v6"
       - uses: "shivammathur/setup-php@v2"
         with:
           php-version: "${{ matrix.php-version }}"
           coverage: "none"
           ini-values: "memory_limit=-1, zend.assertions=1, error_reporting=-1, display_errors=On"
           tools: "composer:v2"
-      - uses: "ramsey/composer-install@v2"
+      - uses: "ramsey/composer-install@v3"
       - name: "Lint the PHP source code"
         run: "./vendor/bin/parallel-lint src tests"
 
   coding-standards:
     name: "Coding Standards"
     runs-on: "ubuntu-latest"
     steps:
-      - uses: "actions/checkout@v2"
+      - uses: "actions/checkout@v6"
       - uses: "shivammathur/setup-php@v2"
         with:
           php-version: "latest"
           coverage: "none"
           ini-values: "memory_limit=-1"
           tools: "composer:v2"
-      - uses: "ramsey/composer-install@v2"
+      - uses: "ramsey/composer-install@v3"
       - name: "Check coding standards"
         run: "./vendor/bin/phpcs src --standard=psr2 --exclude=Generic.Files.LineLength -sp --colors"
 
@@ -51,9 +51,9 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        php-version: [ '8.1', '8.2', '8.3', '8.4' ]
+        php-version: [ '8.2', '8.3', '8.4', '8.5' ]
     steps:
-      - uses: "actions/checkout@v4"
+      - uses: "actions/checkout@v6"
       - uses: "shivammathur/setup-php@v2"
         with:
           php-version: "${{ matrix.php-version }}"

CHANGELOG.md

@@ -4,6 +4,15 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [4.0.0] - 2025-12
+### Added
+    - Full HTTP observability tools: structured logging with token masking, per-status log levels, and custom logger support.
+    - Reliability features: retry strategies (exponential and fixed), circuit breaker, and a combined reliability plugin.
+    - New documentation set under `docs/` with getting started, authentication, configuration, reliability, and domain-by-domain usage examples.
+
+### Changed
+    - Raised minimum supported PHP version to 8.2.
+
 ## [3.20.0] - 2023-04-27
 ### Added
     - isReferenceCode() and isGeocode() methods
@@ -56,4 +65,4 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [3.11.0] - 2020-05-22
 ### Added
-    - http options [from Guzzle](http://docs.guzzlephp.org/en/stable/request-options.html) added to all methods if needed (last argument)
+    - http options [from Guzzle](http://docs.guzzlephp.org/en/stable/request-options.html) added to all methods if needed (last argument)

CLAUDE.md

@@ -1,4 +1,4 @@
-PHP project (>=8.1) with Symfony.
+PHP project (>=8.2) with Symfony.
 
 This project is a PHP library for using the Geocaching API.
 - Official API Swagger: https://api.groundspeak.com/api-docs/v1/swagger

README.md

@@ -15,7 +15,7 @@ You can follow changes about the documentation and the API here:
 
 ## Requirements
 
-- PHP >= 8.1
+- PHP >= 8.2
 - [composer](https://getcomposer.org/doc/00-intro.md#system-requirements).
 
 ## Composer
@@ -32,13 +32,9 @@ First, you must have your API key from Groundspeak, but access to the API are no
 
 You can find an example of implementation (with OAuth 2) in this repository: https://github.com/Surfoo/geocaching-api-demo
 
-## Usage Guide
+## Documentation
 
-See [`USAGE.md`](./USAGE.md) for detailed usage instructions, including:
-
-- Basic usage examples
-- Complete API method reference
-- HTTP logging configuration
+Start with [`docs/README.md`](./docs/README.md) for getting started, authentication, configuration, reliability patterns, and domain-by-domain API examples.
 
 ## HTTP Request/Response Logging