Merge pull request #33 from iazaran/cost-aware-caching-and-fixes

Cost aware caching and fixes

Author: iazaran

README.md

@@ -47,56 +47,6 @@ composer test-coverage
 # Generates HTML coverage report in ./coverage/ directory
 ```
 
-### Test New Features
-```bash
-# Test Laravel 12 SWR methods
-vendor/bin/phpunit tests/Unit/Laravel12/Laravel12SWRTest.php
-
-# Test HTTP command execution
-vendor/bin/phpunit tests/Unit/Http/HttpCommandExecutionTest.php
-
-# Test performance monitoring
-vendor/bin/phpunit tests/Unit/Monitoring/PerformanceMonitoringTest.php
-
-# Test complete feature integration
-vendor/bin/phpunit tests/Feature/EnhancedSmartCacheControllerTest.php
-```
-
-## New Enhanced Features Testing
-
-SmartCache v1.5+ includes comprehensive testing for new enterprise features:
-
-### Laravel 12 SWR Methods Testing
-- **SWR (Stale-While-Revalidate)** pattern validation
-- **Stale serving** with extended TTL support
-- **Refresh-ahead** proactive caching
-- **Flexible caching** with custom duration arrays
-- **Cross-compatibility** between facade and helper methods
-- **Optimization integration** with SWR patterns
-
-### HTTP Command Execution Testing
-- **Command discovery** and metadata retrieval
-- **Programmatic execution** of cache commands
-- **Parameter handling** and validation
-- **Error handling** and graceful failures
-- **Security validation** for non-managed keys
-- **Facade integration** for HTTP commands
-
-### Performance Monitoring Testing
-- **Metrics collection** for hits, misses, and writes
-- **Cache efficiency** calculation and reporting
-- **Optimization impact** tracking and analysis
-- **Performance analysis** with automated recommendations
-- **Metrics persistence** across application instances
-- **Dashboard integration** capabilities
-
-### Integration Testing
-- **Real-world scenarios** like e-commerce platforms
-- **Multi-pattern usage** combining SWR methods
-- **Performance monitoring integration** with caching operations
-- **HTTP command execution** in application context
-- **Complete feature workflows** from cache to monitoring
-
 ## Testing Best Practices
 
 When contributing to SmartCache, follow these testing guidelines:
@@ -129,59 +79,6 @@ php8.2 vendor/bin/phpunit
 php8.3 vendor/bin/phpunit
 ```
 
-## Test Structure
-
-SmartCache maintains **comprehensive test coverage** with **252 tests** organized for maintainability:
-
-```
-tests/
-├── bootstrap.php                    # Test bootstrap (sets up environment)
-├── TestCase.php                    # Base test class with common utilities
-├── Unit/                           # Unit tests (isolated component testing)
-│   ├── SmartCacheTest.php          # Core SmartCache functionality
-│   ├── Console/                    # Console command tests
-│   │   ├── ClearCommandTest.php
-│   │   └── StatusCommandTest.php
-│   ├── Http/                       # HTTP-related tests
-│   │   └── HttpCommandExecutionTest.php  # HTTP command execution
-│   ├── Laravel12/                  # Laravel 12+ features
-│   │   └── Laravel12SWRTest.php    # SWR methods (swr, stale, refreshAhead)
-│   ├── Monitoring/                 # Performance monitoring
-│   │   └── PerformanceMonitoringTest.php
-│   ├── Providers/                  # Service provider tests
-│   │   └── SmartCacheServiceProviderTest.php
-│   ├── Services/                   # Service tests
-│   │   └── CacheInvalidationServiceTest.php
-│   ├── Strategies/                 # Strategy tests
-│   │   ├── CompressionStrategyTest.php
-│   │   └── ChunkingStrategyTest.php
-│   ├── Traits/                     # Trait tests
-│   │   └── ModelIntegrationTest.php
-│   ├── DependencyTrackingTest.php
-│   ├── PatternBasedInvalidationTest.php
-│   ├── StrategyOrderingTest.php
-│   └── TagBasedInvalidationTest.php
-├── Feature/                        # Integration tests
-│   ├── SmartCacheIntegrationTest.php
-│   ├── AdvancedInvalidationIntegrationTest.php
-│   └── EnhancedSmartCacheControllerTest.php  # Full feature integration
-└── Fixtures/                       # Test fixtures and data
-```
-
-## Test Categories
-
-### Unit Tests
-- Test individual components in isolation
-- Use mocks to avoid external dependencies
-- Fast execution
-- Located in `tests/Unit/`
-
-### Feature Tests  
-- Test complete workflows and integration
-- Use real Laravel components
-- Test the package as end users would use it
-- Located in `tests/Feature/`
-
 ## Key Testing Features
 
 ### 1. Orchestra Testbench Integration
@@ -358,4 +255,4 @@ class MyIntegrationTest extends TestCase
 - Use smaller test datasets when possible
 - Clean up test data in tearDown methods
 
-This testing setup ensures your SmartCache package works correctly across different environments without requiring a full Laravel installation.
+

TESTING.md

@@ -110,6 +110,22 @@
         'log_errors' => true,
     ],
 
+    /*
+    |--------------------------------------------------------------------------
+    | Cost-Aware Caching
+    |--------------------------------------------------------------------------
+    |
+    | Enable cost-aware caching to track the "value" of each cached key based on
+    | regeneration cost, access frequency, and size. This allows SmartCache to
+    | provide intelligent eviction suggestions and value-based scoring.
+    |
+    */
+    'cost_aware' => [
+        'enabled' => true,
+        'max_tracked_keys' => 1000, // Maximum number of keys to track metadata for
+        'metadata_ttl' => 86400, // How long to keep cost metadata (seconds)
+    ],
+
     /*
     |--------------------------------------------------------------------------
     | Performance Monitoring