Feature/define visited places cache

.github/test-ci-locally.ps1

@@ -1,5 +1,5 @@
 # Local CI/CD Testing Script
-# This script replicates the GitHub Actions workflow locally for testing
+# This script replicates the GitHub Actions workflows locally for testing
 
 Write-Host "========================================" -ForegroundColor Cyan
 Write-Host "Intervals.NET.Caching CI/CD Local Test" -ForegroundColor Cyan
@@ -8,19 +8,28 @@ Write-Host ""
 
 # Environment variables (matching GitHub Actions)
 $env:SOLUTION_PATH = "Intervals.NET.Caching.sln"
-$env:PROJECT_PATH = "src/Intervals.NET.Caching/Intervals.NET.Caching.csproj"
-$env:WASM_VALIDATION_PATH = "src/Intervals.NET.Caching.WasmValidation/Intervals.NET.Caching.WasmValidation.csproj"
-$env:UNIT_TEST_PATH = "tests/Intervals.NET.Caching.Unit.Tests/Intervals.NET.Caching.Unit.Tests.csproj"
-$env:INTEGRATION_TEST_PATH = "tests/Intervals.NET.Caching.Integration.Tests/Intervals.NET.Caching.Integration.Tests.csproj"
-$env:INVARIANTS_TEST_PATH = "tests/Intervals.NET.Caching.Invariants.Tests/Intervals.NET.Caching.Invariants.Tests.csproj"
+
+# SlidingWindow
+$env:SWC_PROJECT_PATH = "src/Intervals.NET.Caching.SlidingWindow/Intervals.NET.Caching.SlidingWindow.csproj"
+$env:SWC_WASM_VALIDATION_PATH = "src/Intervals.NET.Caching.SlidingWindow.WasmValidation/Intervals.NET.Caching.SlidingWindow.WasmValidation.csproj"
+$env:SWC_UNIT_TEST_PATH = "tests/Intervals.NET.Caching.SlidingWindow.Unit.Tests/Intervals.NET.Caching.SlidingWindow.Unit.Tests.csproj"
+$env:SWC_INTEGRATION_TEST_PATH = "tests/Intervals.NET.Caching.SlidingWindow.Integration.Tests/Intervals.NET.Caching.SlidingWindow.Integration.Tests.csproj"
+$env:SWC_INVARIANTS_TEST_PATH = "tests/Intervals.NET.Caching.SlidingWindow.Invariants.Tests/Intervals.NET.Caching.SlidingWindow.Invariants.Tests.csproj"
+
+# VisitedPlaces
+$env:VPC_PROJECT_PATH = "src/Intervals.NET.Caching.VisitedPlaces/Intervals.NET.Caching.VisitedPlaces.csproj"
+$env:VPC_WASM_VALIDATION_PATH = "src/Intervals.NET.Caching.VisitedPlaces.WasmValidation/Intervals.NET.Caching.VisitedPlaces.WasmValidation.csproj"
+$env:VPC_UNIT_TEST_PATH = "tests/Intervals.NET.Caching.VisitedPlaces.Unit.Tests/Intervals.NET.Caching.VisitedPlaces.Unit.Tests.csproj"
+$env:VPC_INTEGRATION_TEST_PATH = "tests/Intervals.NET.Caching.VisitedPlaces.Integration.Tests/Intervals.NET.Caching.VisitedPlaces.Integration.Tests.csproj"
+$env:VPC_INVARIANTS_TEST_PATH = "tests/Intervals.NET.Caching.VisitedPlaces.Invariants.Tests/Intervals.NET.Caching.VisitedPlaces.Invariants.Tests.csproj"
 
 # Track failures
 $failed = $false
 
 # Step 1: Restore solution dependencies
-Write-Host "[Step 1/9] Restoring solution dependencies..." -ForegroundColor Yellow
+Write-Host "[Step 1/12] Restoring solution dependencies..." -ForegroundColor Yellow
 dotnet restore $env:SOLUTION_PATH
-if ($LASTEXITCODE -ne 0) { 
+if ($LASTEXITCODE -ne 0) {
     Write-Host "? Restore failed" -ForegroundColor Red
     $failed = $true
 }
@@ -30,9 +39,9 @@ else {
 Write-Host ""
 
 # Step 2: Build solution
-Write-Host "[Step 2/9] Building solution (Release)..." -ForegroundColor Yellow
+Write-Host "[Step 2/12] Building solution (Release)..." -ForegroundColor Yellow
 dotnet build $env:SOLUTION_PATH --configuration Release --no-restore
-if ($LASTEXITCODE -ne 0) { 
+if ($LASTEXITCODE -ne 0) {
     Write-Host "? Build failed" -ForegroundColor Red
     $failed = $true
 }
@@ -41,56 +50,104 @@ else {
 }
 Write-Host ""
 
-# Step 3: Validate WebAssembly compatibility
-Write-Host "[Step 3/9] Validating WebAssembly compatibility..." -ForegroundColor Yellow
-dotnet build $env:WASM_VALIDATION_PATH --configuration Release --no-restore
-if ($LASTEXITCODE -ne 0) { 
-    Write-Host "? WebAssembly validation failed" -ForegroundColor Red
+# Step 3: Validate SlidingWindow WebAssembly compatibility
+Write-Host "[Step 3/12] Validating SlidingWindow WebAssembly compatibility..." -ForegroundColor Yellow
+dotnet build $env:SWC_WASM_VALIDATION_PATH --configuration Release --no-restore
+if ($LASTEXITCODE -ne 0) {
+    Write-Host "? SlidingWindow WebAssembly validation failed" -ForegroundColor Red
+    $failed = $true
+}
+else {
+    Write-Host "? SlidingWindow WebAssembly compilation successful - library is compatible with net8.0-browser" -ForegroundColor Green
+}
+Write-Host ""
+
+# Step 4: Validate VisitedPlaces WebAssembly compatibility
+Write-Host "[Step 4/12] Validating VisitedPlaces WebAssembly compatibility..." -ForegroundColor Yellow
+dotnet build $env:VPC_WASM_VALIDATION_PATH --configuration Release --no-restore
+if ($LASTEXITCODE -ne 0) {
+    Write-Host "? VisitedPlaces WebAssembly validation failed" -ForegroundColor Red
     $failed = $true
 }
 else {
-    Write-Host "? WebAssembly compilation successful - library is compatible with net8.0-browser" -ForegroundColor Green
+    Write-Host "? VisitedPlaces WebAssembly compilation successful - library is compatible with net8.0-browser" -ForegroundColor Green
 }
 Write-Host ""
 
-# Step 4: Run Unit Tests
-Write-Host "[Step 4/9] Running Unit Tests with coverage..." -ForegroundColor Yellow
-dotnet test $env:UNIT_TEST_PATH --configuration Release --no-build --verbosity normal --collect:"XPlat Code Coverage" --results-directory ./TestResults/Unit
-if ($LASTEXITCODE -ne 0) { 
-    Write-Host "? Unit tests failed" -ForegroundColor Red
+# Step 5: Run SlidingWindow Unit Tests
+Write-Host "[Step 5/12] Running SlidingWindow Unit Tests with coverage..." -ForegroundColor Yellow
+dotnet test $env:SWC_UNIT_TEST_PATH --configuration Release --no-build --verbosity normal --collect:"XPlat Code Coverage" --results-directory ./TestResults/SWC/Unit
+if ($LASTEXITCODE -ne 0) {
+    Write-Host "? SlidingWindow Unit tests failed" -ForegroundColor Red
     $failed = $true
 }
 else {
-    Write-Host "? Unit tests passed" -ForegroundColor Green
+    Write-Host "? SlidingWindow Unit tests passed" -ForegroundColor Green
 }
 Write-Host ""
 
-# Step 5: Run Integration Tests
-Write-Host "[Step 5/9] Running Integration Tests with coverage..." -ForegroundColor Yellow
-dotnet test $env:INTEGRATION_TEST_PATH --configuration Release --no-build --verbosity normal --collect:"XPlat Code Coverage" --results-directory ./TestResults/Integration
-if ($LASTEXITCODE -ne 0) { 
-    Write-Host "? Integration tests failed" -ForegroundColor Red
+# Step 6: Run SlidingWindow Integration Tests
+Write-Host "[Step 6/12] Running SlidingWindow Integration Tests with coverage..." -ForegroundColor Yellow
+dotnet test $env:SWC_INTEGRATION_TEST_PATH --configuration Release --no-build --verbosity normal --collect:"XPlat Code Coverage" --results-directory ./TestResults/SWC/Integration
+if ($LASTEXITCODE -ne 0) {
+    Write-Host "? SlidingWindow Integration tests failed" -ForegroundColor Red
     $failed = $true
 }
 else {
-    Write-Host "? Integration tests passed" -ForegroundColor Green
+    Write-Host "? SlidingWindow Integration tests passed" -ForegroundColor Green
 }
 Write-Host ""
 
-# Step 6: Run Invariants Tests
-Write-Host "[Step 6/9] Running Invariants Tests with coverage..." -ForegroundColor Yellow
-dotnet test $env:INVARIANTS_TEST_PATH --configuration Release --no-build --verbosity normal --collect:"XPlat Code Coverage" --results-directory ./TestResults/Invariants
-if ($LASTEXITCODE -ne 0) { 
-    Write-Host "? Invariants tests failed" -ForegroundColor Red
+# Step 7: Run SlidingWindow Invariants Tests
+Write-Host "[Step 7/12] Running SlidingWindow Invariants Tests with coverage..." -ForegroundColor Yellow
+dotnet test $env:SWC_INVARIANTS_TEST_PATH --configuration Release --no-build --verbosity normal --collect:"XPlat Code Coverage" --results-directory ./TestResults/SWC/Invariants
+if ($LASTEXITCODE -ne 0) {
+    Write-Host "? SlidingWindow Invariants tests failed" -ForegroundColor Red
     $failed = $true
 }
 else {
-    Write-Host "? Invariants tests passed" -ForegroundColor Green
+    Write-Host "? SlidingWindow Invariants tests passed" -ForegroundColor Green
 }
 Write-Host ""
 
-# Step 7: Check coverage files
-Write-Host "[Step 7/9] Checking coverage files..." -ForegroundColor Yellow
+# Step 8: Run VisitedPlaces Unit Tests
+Write-Host "[Step 8/12] Running VisitedPlaces Unit Tests with coverage..." -ForegroundColor Yellow
+dotnet test $env:VPC_UNIT_TEST_PATH --configuration Release --no-build --verbosity normal --collect:"XPlat Code Coverage" --results-directory ./TestResults/VPC/Unit
+if ($LASTEXITCODE -ne 0) {
+    Write-Host "? VisitedPlaces Unit tests failed" -ForegroundColor Red
+    $failed = $true
+}
+else {
+    Write-Host "? VisitedPlaces Unit tests passed" -ForegroundColor Green
+}
+Write-Host ""
+
+# Step 9: Run VisitedPlaces Integration Tests
+Write-Host "[Step 9/12] Running VisitedPlaces Integration Tests with coverage..." -ForegroundColor Yellow
+dotnet test $env:VPC_INTEGRATION_TEST_PATH --configuration Release --no-build --verbosity normal --collect:"XPlat Code Coverage" --results-directory ./TestResults/VPC/Integration
+if ($LASTEXITCODE -ne 0) {
+    Write-Host "? VisitedPlaces Integration tests failed" -ForegroundColor Red
+    $failed = $true
+}
+else {
+    Write-Host "? VisitedPlaces Integration tests passed" -ForegroundColor Green
+}
+Write-Host ""
+
+# Step 10: Run VisitedPlaces Invariants Tests
+Write-Host "[Step 10/12] Running VisitedPlaces Invariants Tests with coverage..." -ForegroundColor Yellow
+dotnet test $env:VPC_INVARIANTS_TEST_PATH --configuration Release --no-build --verbosity normal --collect:"XPlat Code Coverage" --results-directory ./TestResults/VPC/Invariants
+if ($LASTEXITCODE -ne 0) {
+    Write-Host "? VisitedPlaces Invariants tests failed" -ForegroundColor Red
+    $failed = $true
+}
+else {
+    Write-Host "? VisitedPlaces Invariants tests passed" -ForegroundColor Green
+}
+Write-Host ""
+
+# Step 11: Check coverage files
+Write-Host "[Step 11/12] Checking coverage files..." -ForegroundColor Yellow
 $coverageFiles = Get-ChildItem -Path "./TestResults" -Filter "coverage.cobertura.xml" -Recurse
 if ($coverageFiles.Count -gt 0) {
     Write-Host "? Found $($coverageFiles.Count) coverage file(s)" -ForegroundColor Green
@@ -103,26 +160,31 @@ else {
 }
 Write-Host ""
 
-# Step 8: Build NuGet package
-Write-Host "[Step 8/9] Creating NuGet package..." -ForegroundColor Yellow
+# Step 12: Build NuGet packages
+Write-Host "[Step 12/12] Creating NuGet packages..." -ForegroundColor Yellow
 if (Test-Path "./artifacts") {
     Remove-Item -Path "./artifacts" -Recurse -Force
 }
-dotnet pack $env:PROJECT_PATH --configuration Release --no-build --output ./artifacts
-if ($LASTEXITCODE -ne 0) { 
-    Write-Host "? Package creation failed" -ForegroundColor Red
+dotnet pack $env:SWC_PROJECT_PATH --configuration Release --no-build --output ./artifacts
+if ($LASTEXITCODE -ne 0) {
+    Write-Host "? Package creation failed (SlidingWindow)" -ForegroundColor Red
     $failed = $true
 }
-else {
+dotnet pack $env:VPC_PROJECT_PATH --configuration Release --no-build --output ./artifacts
+if ($LASTEXITCODE -ne 0) {
+    Write-Host "? Package creation failed (VisitedPlaces)" -ForegroundColor Red
+    $failed = $true
+}
+if (-not $failed) {
     $packages = Get-ChildItem -Path "./artifacts" -Filter "*.nupkg"
-    Write-Host "? Package created successfully" -ForegroundColor Green
+    Write-Host "? Packages created successfully" -ForegroundColor Green
     foreach ($pkg in $packages) {
         Write-Host "   - $($pkg.Name)" -ForegroundColor Gray
     }
 }
 Write-Host ""
 
-# Step 9: Summary
+# Summary
 Write-Host "========================================" -ForegroundColor Cyan
 Write-Host "Test Summary" -ForegroundColor Cyan
 Write-Host "========================================" -ForegroundColor Cyan
@@ -135,7 +197,7 @@ else {
     Write-Host ""
     Write-Host "Next steps:" -ForegroundColor Cyan
     Write-Host "  - Review coverage reports in ./TestResults/" -ForegroundColor Gray
-    Write-Host "  - Inspect NuGet package in ./artifacts/" -ForegroundColor Gray
-    Write-Host "  - Push to trigger GitHub Actions workflow" -ForegroundColor Gray
+    Write-Host "  - Inspect NuGet packages in ./artifacts/" -ForegroundColor Gray
+    Write-Host "  - Push to trigger GitHub Actions workflows" -ForegroundColor Gray
     exit 0
 }

.github/workflows/intervals-net-caching.yml → .github/workflows/intervals-net-caching-swc.yml

@@ -1,67 +1,75 @@
-name: CI/CD - Intervals.NET.Caching
+name: CI/CD - Intervals.NET.Caching.SlidingWindow
 
 on:
   push:
     branches: [ master, main ]
     paths:
       - 'src/Intervals.NET.Caching/**'
-      - 'src/Intervals.NET.Caching.WasmValidation/**'
-      - 'tests/**'
-      - '.github/workflows/Intervals.NET.Caching.yml'
+      - 'src/Intervals.NET.Caching.SlidingWindow/**'
+      - 'src/Intervals.NET.Caching.SlidingWindow.WasmValidation/**'
+      - 'tests/Intervals.NET.Caching.SlidingWindow.Unit.Tests/**'
+      - 'tests/Intervals.NET.Caching.SlidingWindow.Integration.Tests/**'
+      - 'tests/Intervals.NET.Caching.SlidingWindow.Invariants.Tests/**'
+      - 'tests/Intervals.NET.Caching.SlidingWindow.Tests.Infrastructure/**'
+      - '.github/workflows/intervals-net-caching-swc.yml'
   pull_request:
     branches: [ master, main ]
     paths:
       - 'src/Intervals.NET.Caching/**'
-      - 'src/Intervals.NET.Caching.WasmValidation/**'
-      - 'tests/**'
-      - '.github/workflows/Intervals.NET.Caching.yml'
+      - 'src/Intervals.NET.Caching.SlidingWindow/**'
+      - 'src/Intervals.NET.Caching.SlidingWindow.WasmValidation/**'
+      - 'tests/Intervals.NET.Caching.SlidingWindow.Unit.Tests/**'
+      - 'tests/Intervals.NET.Caching.SlidingWindow.Integration.Tests/**'
+      - 'tests/Intervals.NET.Caching.SlidingWindow.Invariants.Tests/**'
+      - 'tests/Intervals.NET.Caching.SlidingWindow.Tests.Infrastructure/**'
+      - '.github/workflows/intervals-net-caching-swc.yml'
   workflow_dispatch:
 
 env:
   DOTNET_VERSION: '8.x.x'
   SOLUTION_PATH: 'Intervals.NET.Caching.sln'
-  PROJECT_PATH: 'src/Intervals.NET.Caching/Intervals.NET.Caching.csproj'
-  WASM_VALIDATION_PATH: 'src/Intervals.NET.Caching.WasmValidation/Intervals.NET.Caching.WasmValidation.csproj'
-  UNIT_TEST_PATH: 'tests/Intervals.NET.Caching.Unit.Tests/Intervals.NET.Caching.Unit.Tests.csproj'
-  INTEGRATION_TEST_PATH: 'tests/Intervals.NET.Caching.Integration.Tests/Intervals.NET.Caching.Integration.Tests.csproj'
-  INVARIANTS_TEST_PATH: 'tests/Intervals.NET.Caching.Invariants.Tests/Intervals.NET.Caching.Invariants.Tests.csproj'
+  PROJECT_PATH: 'src/Intervals.NET.Caching.SlidingWindow/Intervals.NET.Caching.SlidingWindow.csproj'
+  WASM_VALIDATION_PATH: 'src/Intervals.NET.Caching.SlidingWindow.WasmValidation/Intervals.NET.Caching.SlidingWindow.WasmValidation.csproj'
+  UNIT_TEST_PATH: 'tests/Intervals.NET.Caching.SlidingWindow.Unit.Tests/Intervals.NET.Caching.SlidingWindow.Unit.Tests.csproj'
+  INTEGRATION_TEST_PATH: 'tests/Intervals.NET.Caching.SlidingWindow.Integration.Tests/Intervals.NET.Caching.SlidingWindow.Integration.Tests.csproj'
+  INVARIANTS_TEST_PATH: 'tests/Intervals.NET.Caching.SlidingWindow.Invariants.Tests/Intervals.NET.Caching.SlidingWindow.Invariants.Tests.csproj'
 
 jobs:
   build-and-test:
     runs-on: ubuntu-latest
-    
+
     steps:
       - name: Checkout code
         uses: actions/checkout@v4
-      
+
       - name: Setup .NET
         uses: actions/setup-dotnet@v4
         with:
           dotnet-version: ${{ env.DOTNET_VERSION }}
-      
+
       - name: Restore solution dependencies
         run: dotnet restore ${{ env.SOLUTION_PATH }}
-      
+
       - name: Build solution
         run: dotnet build ${{ env.SOLUTION_PATH }} --configuration Release --no-restore
-      
+
       - name: Validate WebAssembly compatibility
         run: |
           echo "::group::WebAssembly Validation"
-          echo "Building Intervals.NET.Caching.WasmValidation for net8.0-browser target..."
+          echo "Building Intervals.NET.Caching.SlidingWindow.WasmValidation for net8.0-browser target..."
           dotnet build ${{ env.WASM_VALIDATION_PATH }} --configuration Release --no-restore
-          echo "? WebAssembly compilation successful - library is compatible with net8.0-browser"
+          echo "WebAssembly compilation successful - library is compatible with net8.0-browser"
           echo "::endgroup::"
-      
+
       - name: Run Unit Tests with coverage
         run: dotnet test ${{ env.UNIT_TEST_PATH }} --configuration Release --no-build --verbosity normal --collect:"XPlat Code Coverage" --results-directory ./TestResults/Unit
-      
+
       - name: Run Integration Tests with coverage
         run: dotnet test ${{ env.INTEGRATION_TEST_PATH }} --configuration Release --no-build --verbosity normal --collect:"XPlat Code Coverage" --results-directory ./TestResults/Integration
-      
+
       - name: Run Invariants Tests with coverage
         run: dotnet test ${{ env.INVARIANTS_TEST_PATH }} --configuration Release --no-build --verbosity normal --collect:"XPlat Code Coverage" --results-directory ./TestResults/Invariants
-      
+
       - name: Upload coverage reports to Codecov
         uses: codecov/codecov-action@v4
         with:
@@ -76,30 +84,30 @@ jobs:
     runs-on: ubuntu-latest
     needs: build-and-test
     if: github.event_name == 'push' && (github.ref == 'refs/heads/main' || github.ref == 'refs/heads/master')
-    
+
     steps:
       - name: Checkout code
         uses: actions/checkout@v4
-      
+
       - name: Setup .NET
         uses: actions/setup-dotnet@v4
         with:
           dotnet-version: ${{ env.DOTNET_VERSION }}
-      
+
       - name: Restore dependencies
-        run: dotnet restore ${{ env.PROJECT_PATH }}
-      
-      - name: Build Intervals.NET.Caching
+        run: dotnet restore ${{ env.SOLUTION_PATH }}
+
+      - name: Build Intervals.NET.Caching.SlidingWindow
         run: dotnet build ${{ env.PROJECT_PATH }} --configuration Release --no-restore
-      
-      - name: Pack Intervals.NET.Caching
+
+      - name: Pack Intervals.NET.Caching.SlidingWindow
         run: dotnet pack ${{ env.PROJECT_PATH }} --configuration Release --no-build --output ./artifacts
-      
-      - name: Publish Intervals.NET.Caching to NuGet
-        run: dotnet nuget push ./artifacts/Intervals.NET.Caching.*.nupkg --api-key ${{ secrets.NUGET_API_KEY }} --source https://api.nuget.org/v3/index.json --skip-duplicate
-      
+
+      - name: Publish packages to NuGet
+        run: dotnet nuget push ./artifacts/*.nupkg --api-key ${{ secrets.NUGET_API_KEY }} --source https://api.nuget.org/v3/index.json --skip-duplicate
+
       - name: Upload package artifacts
         uses: actions/upload-artifact@v4
         with:
-          name: Intervals.NET.Caching-package
+          name: nuget-packages-swc
           path: ./artifacts/*.nupkg