TASK-051-002: Rename Protocol/RFC9111 → Protocol/Caching

st0o0 · st0o0 · commit 2c2ba281cd33 · 2026-04-07T06:56:40.000+02:00
Move all 8 files from src/TurboHttp/Protocol/RFC9111/ to src/TurboHttp/Protocol/Caching/,
update namespace declarations from TurboHttp.Protocol.RFC9111 to TurboHttp.Protocol.Caching,
and update 25 consumer files (using directives) across production code and tests.
Remove the empty RFC9111/ folder. Build green, all tests passing.
diff --git a/.maggus/features/feature_051.md b/.maggus/features/feature_051.md
@@ -77,10 +77,10 @@ and their namespace declarations updated.
 **Parallel:** no
 
 **Acceptance Criteria:**
-- [ ] `src/TurboHttp/Protocol/Caching/` contains all files previously in `RFC9111/`
-- [ ] `src/TurboHttp/Protocol/RFC9111/` does not exist
-- [ ] All namespace declarations updated to `TurboHttp.Protocol.Caching`
-- [ ] No other content changed
+- [x] `src/TurboHttp/Protocol/Caching/` contains all files previously in `RFC9111/`
+- [x] `src/TurboHttp/Protocol/RFC9111/` does not exist
+- [x] All namespace declarations updated to `TurboHttp.Protocol.Caching`
+- [x] No other content changed
 
 ---
 
diff --git a/src/TurboHttp.IntegrationTests/H10/CacheIntegrationTests.cs b/src/TurboHttp.IntegrationTests/H10/CacheIntegrationTests.cs
@@ -1,6 +1,6 @@
 using System.Net;
 using TurboHttp.IntegrationTests.Shared;
-using TurboHttp.Protocol.RFC9111;
+using TurboHttp.Protocol.Caching;
 
 namespace TurboHttp.IntegrationTests.H10;
 
diff --git a/src/TurboHttp.IntegrationTests/H10/FeatureInteractionH10IntegrationTests.cs b/src/TurboHttp.IntegrationTests/H10/FeatureInteractionH10IntegrationTests.cs
@@ -2,7 +2,7 @@
 using System.Text.Json;
 using TurboHttp.IntegrationTests.Shared;
 using TurboHttp.Protocol.Semantics;
-using TurboHttp.Protocol.RFC9111;
+using TurboHttp.Protocol.Caching;
 
 namespace TurboHttp.IntegrationTests.H10;
 
diff --git a/src/TurboHttp.IntegrationTests/H11/CacheIntegrationTests.cs b/src/TurboHttp.IntegrationTests/H11/CacheIntegrationTests.cs
@@ -1,6 +1,6 @@
 using System.Net;
 using TurboHttp.IntegrationTests.Shared;
-using TurboHttp.Protocol.RFC9111;
+using TurboHttp.Protocol.Caching;
 
 namespace TurboHttp.IntegrationTests.H11;
 
diff --git a/src/TurboHttp.IntegrationTests/H11/FeatureInteractionIntegrationTests.cs b/src/TurboHttp.IntegrationTests/H11/FeatureInteractionIntegrationTests.cs
@@ -2,7 +2,7 @@
 using System.Text.Json;
 using TurboHttp.IntegrationTests.Shared;
 using TurboHttp.Protocol.Semantics;
-using TurboHttp.Protocol.RFC9111;
+using TurboHttp.Protocol.Caching;
 
 namespace TurboHttp.IntegrationTests.H11;
 
diff --git a/src/TurboHttp.IntegrationTests/H2/CacheIntegrationTests.cs b/src/TurboHttp.IntegrationTests/H2/CacheIntegrationTests.cs
@@ -1,6 +1,6 @@
 using System.Net;
 using TurboHttp.IntegrationTests.Shared;
-using TurboHttp.Protocol.RFC9111;
+using TurboHttp.Protocol.Caching;
 
 namespace TurboHttp.IntegrationTests.H2;
 
diff --git a/src/TurboHttp.IntegrationTests/H2/FeatureInteractionH2IntegrationTests.cs b/src/TurboHttp.IntegrationTests/H2/FeatureInteractionH2IntegrationTests.cs
@@ -2,7 +2,7 @@
 using System.Text.Json;
 using TurboHttp.IntegrationTests.Shared;
 using TurboHttp.Protocol.Semantics;
-using TurboHttp.Protocol.RFC9111;
+using TurboHttp.Protocol.Caching;
 
 namespace TurboHttp.IntegrationTests.H2;
 
diff --git a/src/TurboHttp.IntegrationTests/TLS/CacheIntegrationTests.cs b/src/TurboHttp.IntegrationTests/TLS/CacheIntegrationTests.cs
@@ -1,6 +1,6 @@
 using System.Net;
 using TurboHttp.IntegrationTests.Shared;
-using TurboHttp.Protocol.RFC9111;
+using TurboHttp.Protocol.Caching;
 
 namespace TurboHttp.IntegrationTests.TLS;
 
diff --git a/src/TurboHttp.IntegrationTests/TLS/FeatureInteractionTlsIntegrationTests.cs b/src/TurboHttp.IntegrationTests/TLS/FeatureInteractionTlsIntegrationTests.cs
@@ -2,7 +2,7 @@
 using System.Text.Json;
 using TurboHttp.IntegrationTests.Shared;
 using TurboHttp.Protocol.Semantics;
-using TurboHttp.Protocol.RFC9111;
+using TurboHttp.Protocol.Caching;
 
 namespace TurboHttp.IntegrationTests.TLS;
 
diff --git a/src/TurboHttp.StreamTests/Caching/CacheBidiAsyncBodySpec.cs b/src/TurboHttp.StreamTests/Caching/CacheBidiAsyncBodySpec.cs
@@ -2,7 +2,7 @@
 using System.Net;
 using Akka.Streams;
 using Akka.Streams.Dsl;
-using TurboHttp.Protocol.RFC9111;
+using TurboHttp.Protocol.Caching;
 using TurboHttp.Streams.Stages.Features;
 
 namespace TurboHttp.StreamTests.Caching;
diff --git a/src/TurboHttp.StreamTests/Caching/CacheBidiStageSpec.cs b/src/TurboHttp.StreamTests/Caching/CacheBidiStageSpec.cs
@@ -2,7 +2,7 @@
 using System.Net;
 using Akka.Streams;
 using Akka.Streams.Dsl;
-using TurboHttp.Protocol.RFC9111;
+using TurboHttp.Protocol.Caching;
 using TurboHttp.Streams.Stages.Features;
 
 namespace TurboHttp.StreamTests.Caching;
diff --git a/src/TurboHttp.StreamTests/Streams/01_StageOrderingTests.cs b/src/TurboHttp.StreamTests/Streams/01_StageOrderingTests.cs
@@ -5,7 +5,7 @@
 using TurboHttp.Internal;
 using TurboHttp.Protocol.Cookies;
 using TurboHttp.Protocol.Semantics;
-using TurboHttp.Protocol.RFC9111;
+using TurboHttp.Protocol.Caching;
 using TurboHttp.Streams;
 using TurboHttp.Streams.Stages.Features;
 using TurboHttp.Streams.Stages.Routing;
diff --git a/src/TurboHttp.StreamTests/Streams/02_StageOrderingIntegrationTests.cs b/src/TurboHttp.StreamTests/Streams/02_StageOrderingIntegrationTests.cs
@@ -5,7 +5,7 @@
 using TurboHttp.Internal;
 using TurboHttp.Protocol.Cookies;
 using TurboHttp.Protocol.Semantics;
-using TurboHttp.Protocol.RFC9111;
+using TurboHttp.Protocol.Caching;
 using TurboHttp.Streams;
 
 namespace TurboHttp.StreamTests.Streams;
diff --git a/src/TurboHttp.StreamTests/Streams/11_EngineBidiFlowCompositionTests.cs b/src/TurboHttp.StreamTests/Streams/11_EngineBidiFlowCompositionTests.cs
@@ -5,7 +5,7 @@
 using TurboHttp.Internal;
 using TurboHttp.Protocol.Cookies;
 using TurboHttp.Protocol.Semantics;
-using TurboHttp.Protocol.RFC9111;
+using TurboHttp.Protocol.Caching;
 using TurboHttp.Streams;
 
 namespace TurboHttp.StreamTests.Streams;
diff --git a/src/TurboHttp.Tests/Caching/CacheControlParserSpec.cs b/src/TurboHttp.Tests/Caching/CacheControlParserSpec.cs
@@ -1,4 +1,4 @@
-using TurboHttp.Protocol.RFC9111;
+using TurboHttp.Protocol.Caching;
 
 namespace TurboHttp.Tests.Caching;
 
diff --git a/src/TurboHttp.Tests/Caching/CacheFreshnessSpec.cs b/src/TurboHttp.Tests/Caching/CacheFreshnessSpec.cs
@@ -1,5 +1,5 @@
 using System.Net;
-using TurboHttp.Protocol.RFC9111;
+using TurboHttp.Protocol.Caching;
 
 namespace TurboHttp.Tests.Caching;
 
diff --git a/src/TurboHttp.Tests/Caching/CacheInvalidationSpec.cs b/src/TurboHttp.Tests/Caching/CacheInvalidationSpec.cs
@@ -1,5 +1,5 @@
 using System.Net;
-using TurboHttp.Protocol.RFC9111;
+using TurboHttp.Protocol.Caching;
 
 namespace TurboHttp.Tests.Caching;
 
diff --git a/src/TurboHttp.Tests/Caching/CacheQualifiedDirectiveSpec.cs b/src/TurboHttp.Tests/Caching/CacheQualifiedDirectiveSpec.cs
@@ -1,5 +1,5 @@
 using System.Net;
-using TurboHttp.Protocol.RFC9111;
+using TurboHttp.Protocol.Caching;
 
 namespace TurboHttp.Tests.Caching;
 
diff --git a/src/TurboHttp.Tests/Caching/CacheStoreSpec.cs b/src/TurboHttp.Tests/Caching/CacheStoreSpec.cs
@@ -1,5 +1,5 @@
 using System.Net;
-using TurboHttp.Protocol.RFC9111;
+using TurboHttp.Protocol.Caching;
 
 namespace TurboHttp.Tests.Caching;
 
diff --git a/src/TurboHttp.Tests/Caching/CacheValidationSpec.cs b/src/TurboHttp.Tests/Caching/CacheValidationSpec.cs
@@ -1,5 +1,5 @@
 using System.Net;
-using TurboHttp.Protocol.RFC9111;
+using TurboHttp.Protocol.Caching;
 
 namespace TurboHttp.Tests.Caching;
 
diff --git a/src/TurboHttp.Tests/Hosting/04_TurboHttpClientBuilderFeatureTests.cs b/src/TurboHttp.Tests/Hosting/04_TurboHttpClientBuilderFeatureTests.cs
@@ -2,7 +2,7 @@
 using Microsoft.Extensions.Options;
 using TurboHttp.Protocol.Cookies;
 using TurboHttp.Protocol.Semantics;
-using TurboHttp.Protocol.RFC9111;
+using TurboHttp.Protocol.Caching;
 
 namespace TurboHttp.Tests.Hosting;
 
diff --git a/src/TurboHttp/Protocol/Caching/CacheControl.cs b/src/TurboHttp/Protocol/Caching/CacheControl.cs
@@ -1,4 +1,4 @@
-namespace TurboHttp.Protocol.RFC9111;
+namespace TurboHttp.Protocol.Caching;
 
 /// <summary>
 /// RFC 9111 §5.2 — Parsed representation of the Cache-Control header.
diff --git a/src/TurboHttp/Protocol/Caching/CacheControlParser.cs b/src/TurboHttp/Protocol/Caching/CacheControlParser.cs
@@ -1,4 +1,4 @@
-namespace TurboHttp.Protocol.RFC9111;
+namespace TurboHttp.Protocol.Caching;
 
 /// <summary>
 /// RFC 9111 §5.2 — Parses the Cache-Control header value into a <see cref="CacheControl"/> record.
@@ -235,4 +235,4 @@ private static int FindUnquotedComma(ReadOnlySpan<char> span)
 
         return fields.Count > 0 ? fields : null;
     }
-}
+}
diff --git a/src/TurboHttp/Protocol/Caching/CacheEntry.cs b/src/TurboHttp/Protocol/Caching/CacheEntry.cs
@@ -1,4 +1,4 @@
-namespace TurboHttp.Protocol.RFC9111;
+namespace TurboHttp.Protocol.Caching;
 
 /// <summary>
 /// RFC 9111 §3 — A stored response entry in the HTTP cache.
diff --git a/src/TurboHttp/Protocol/Caching/CacheFreshnessEvaluator.cs b/src/TurboHttp/Protocol/Caching/CacheFreshnessEvaluator.cs
@@ -1,4 +1,4 @@
-namespace TurboHttp.Protocol.RFC9111;
+namespace TurboHttp.Protocol.Caching;
 
 /// <summary>
 /// RFC 9111 §4.2 — Evaluates whether a cached response is still fresh.
@@ -211,4 +211,4 @@ public static CacheLookupResult Evaluate(CacheEntry? entry, HttpRequestMessage r
         return CacheLookupResult.MustRevalidate(entry,
             $"RFC 9111 §4.2: Entry is stale (lifetime={freshnessLifetime.TotalSeconds:F0}s, age={currentAge.TotalSeconds:F0}s).");
     }
-}
+}
diff --git a/src/TurboHttp/Protocol/Caching/CacheLookupResult.cs b/src/TurboHttp/Protocol/Caching/CacheLookupResult.cs
@@ -1,4 +1,4 @@
-namespace TurboHttp.Protocol.RFC9111;
+namespace TurboHttp.Protocol.Caching;
 
 /// <summary>
 /// RFC 9111 §4 — Outcome of a cache lookup.
diff --git a/src/TurboHttp/Protocol/Caching/CachePolicy.cs b/src/TurboHttp/Protocol/Caching/CachePolicy.cs
@@ -1,4 +1,4 @@
-namespace TurboHttp.Protocol.RFC9111;
+namespace TurboHttp.Protocol.Caching;
 
 /// <summary>
 /// RFC 9111 §3 — Configuration for the HTTP cache store behaviour.
@@ -24,4 +24,4 @@ public sealed record CachePolicy
     /// RFC 9111 §3.1.
     /// </summary>
     public bool SharedCache { get; init; }
-}
+}
diff --git a/src/TurboHttp/Protocol/Caching/CacheStore.cs b/src/TurboHttp/Protocol/Caching/CacheStore.cs
@@ -1,6 +1,6 @@
 using System.Net;
 
-namespace TurboHttp.Protocol.RFC9111;
+namespace TurboHttp.Protocol.Caching;
 
 /// <summary>
 /// RFC 9111 §3 — Thread-safe in-memory LRU cache store for HTTP responses.
@@ -516,4 +516,4 @@ private static string GetVaryKey(CacheEntry entry)
 
         return string.Join("&", parts);
     }
-}
+}
diff --git a/src/TurboHttp/Protocol/Caching/CacheValidationRequestBuilder.cs b/src/TurboHttp/Protocol/Caching/CacheValidationRequestBuilder.cs
@@ -1,6 +1,6 @@
 using System.Net;
 
-namespace TurboHttp.Protocol.RFC9111;
+namespace TurboHttp.Protocol.Caching;
 
 /// <summary>
 /// RFC 9111 §4.3 — Builds conditional revalidation requests and merges 304 responses.
@@ -161,4 +161,4 @@ public static bool TryFreshenFromHead(HttpResponseMessage headResponse, CacheEnt
 
         return true;
     }
-}
+}
diff --git a/src/TurboHttp/Streams/PipelineDescriptor.cs b/src/TurboHttp/Streams/PipelineDescriptor.cs
@@ -1,6 +1,6 @@
 using TurboHttp.Protocol.Cookies;
 using TurboHttp.Protocol.Semantics;
-using TurboHttp.Protocol.RFC9111;
+using TurboHttp.Protocol.Caching;
 
 namespace TurboHttp.Streams;
 
diff --git a/src/TurboHttp/Streams/Stages/Features/CacheBidiStage.cs b/src/TurboHttp/Streams/Stages/Features/CacheBidiStage.cs
@@ -4,7 +4,7 @@
 using Akka.Streams;
 using Akka.Streams.Stage;
 using TurboHttp.Diagnostics;
-using TurboHttp.Protocol.RFC9111;
+using TurboHttp.Protocol.Caching;
 
 namespace TurboHttp.Streams.Stages.Features;
 
diff --git a/src/TurboHttp/TurboClientDescriptor.cs b/src/TurboHttp/TurboClientDescriptor.cs
@@ -1,6 +1,6 @@
 using TurboHttp.Protocol.Cookies;
 using TurboHttp.Protocol.Semantics;
-using TurboHttp.Protocol.RFC9111;
+using TurboHttp.Protocol.Caching;
 
 namespace TurboHttp;
 
diff --git a/src/TurboHttp/TurboHttpClientBuilderExtensions.cs b/src/TurboHttp/TurboHttpClientBuilderExtensions.cs
@@ -1,7 +1,7 @@
 using Microsoft.Extensions.DependencyInjection;
 using TurboHttp.Protocol.Cookies;
 using TurboHttp.Protocol.Semantics;
-using TurboHttp.Protocol.RFC9111;
+using TurboHttp.Protocol.Caching;
 
 namespace TurboHttp;
 
diff --git a/src/TurboHttp/TurboHttpClientFactory.cs b/src/TurboHttp/TurboHttpClientFactory.cs
@@ -1,7 +1,7 @@
 using Akka.Actor;
 using Microsoft.Extensions.Options;
 using TurboHttp.Protocol.Cookies;
-using TurboHttp.Protocol.RFC9111;
+using TurboHttp.Protocol.Caching;
 using TurboHttp.Streams;
 
 namespace TurboHttp;
