Replace native PHP assertions with beberlei/assert for better error
messages and validation. Ensure required keys exist before accessing
them to prevent undefined array key warnings.

Add UrlReconstructor utility to rebuild complete URLs from parsed
components. Handles edge cases like missing schemes, invalid URLs,
and proper port handling (removes default ports 80/443).

- Add curlClose() method for proper resource cleanup
- Clean up handles with NULL callbacks in disable()
- Snapshot curl options before execution to prevent TraceableHttpClient issues
- Add special handling for CURLINFO_PRIVATE
- Improve gzip decompression with proper Accept-Encoding handling

Make wrapper_data property public to ensure stream_get_meta_data()
compatibility with NativeHttpClient. Add proper header handling for
both string and array formats.

Add namespaced proxy function to intercept stream_get_meta_data() calls
in Symfony\Component\HttpClient\Response namespace. This converts
StreamWrapperHook objects to arrays for NativeHttpClient compatibility.

Add wrapper class that adapts VCR Response objects to Symfony's
ResponseInterface. Handles header normalization, status codes, and
content retrieval with proper error handling.

Add main wrapper that intercepts Symfony HttpClient requests and
replays VCR responses. Handles:
- Automatic gzip decompression
- Streaming responses
- Request options normalization
- Error handling and exceptions

Add specialized wrapper for NativeHttpClient that extends VCRHttpClient
with additional compatibility fixes for PHP stream-based implementation.

Add helper class to convert between VCR Request/Response and Symfony
format. Handles header normalization, body conversion, and proper
HTTP method/URL extraction.

Add AST transformer that automatically wraps 'new CurlHttpClient()'
and 'new NativeHttpClient()' instantiations with VCRHttpClient.
Uses nikic/php-parser to modify code at runtime.

- Register 'symfony_http_client' hook in available hooks
- Add cache directories to transformation blacklist
- Update VCRFactory to instantiate the new hook

Add SymfonyHttpClientTestTrait with helper methods for testing
Symfony HttpClient with VCR. Simplifies test setup and provides
utility methods for common testing scenarios.

Add comprehensive integration tests covering:
- CurlHttpClient (GET, POST, PUT, DELETE)
- NativeHttpClient (GET, POST, PUT, DELETE)
- MockHttpClient
- TraceableHttpClient

Includes JsonPlaceholderClient helper for testing real API calls.

Test individual Symfony HttpClient implementations:
- CurlHttpClient with various options
- NativeHttpClient with stream_get_meta_data
- VCRNativeHttpClient wrapper
- ScopingHttpClient with multiple scopes
- TraceableHttpClient with request tracing

Test specific features:
- Authentication (Basic Auth, Bearer tokens)
- Concurrent/async requests
- Custom options (headers, timeout, user_data, query params)
- Error handling and edge cases

Test hook behavior:
- Code transformation effectiveness
- CurlHttpClient with curl hooks only (no transformation)
- NativeHttpClient with stream_wrapper hooks only

Add 38 cassette files with recorded HTTP responses for:
- CRUD operations (GET, POST, PUT, DELETE)
- Authentication scenarios
- Custom options and headers
- Multiple client types
- Error cases

Add comprehensive documentation explaining:
- When to use high-level vs low-level hooks
- VCRHttpClient vs CurlHook trade-offs
- Architecture decisions and design rationale
- Gzip decompression handling with Symfony

Add complete usage guide with:
- Automatic wrapping example (recommended)
- Manual wrapping alternative
- List of supported clients
- How it works explanation
- Link to HOOK_STRATEGY.md

Update baseline to reflect new code and fix reported issues
in Symfony HttpClient integration files.

- Ignore only dynamic cassettes (cassette* pattern)
- Update test files to use correct paths