work work hard work

docs/implplan/SPRINT_1200_001_README.md

@@ -1,14 +1,15 @@
 # Router Rate Limiting - Sprint Package README
 
 **Package Created:** 2025-12-17
-**For:** Implementation agents
+**For:** Implementation agents / reviewers
+**Status:** DOING (Sprints 1–3 DONE; Sprint 4 DONE (N/A); Sprint 5 DOING; Sprint 6 TODO)
 **Advisory Source:** `docs/product-advisories/unprocessed/15-Dec-2025 - Designing 202 + Retry‑After Backpressure Control.md`
 
 ---
 
 ## Package Contents
 
-This sprint package contains everything needed to implement centralized rate limiting in Stella Router.
+This sprint package contains the original plan plus the landed implementation for centralized rate limiting in Stella Router.
 
 ### Core Sprint Files
 
@@ -18,15 +19,19 @@ This sprint package contains everything needed to implement centralized rate lim
 | `SPRINT_1200_001_001_router_rate_limiting_core.md` | Sprint 1: Core implementation | Implementer - 5-7 days |
 | `SPRINT_1200_001_002_router_rate_limiting_per_route.md` | Sprint 2: Per-route granularity | Implementer - 2-3 days |
 | `SPRINT_1200_001_003_router_rate_limiting_rule_stacking.md` | Sprint 3: Rule stacking | Implementer - 2-3 days |
+| `SPRINT_1200_001_004_router_rate_limiting_service_migration.md` | Sprint 4: Service migration (closed N/A) | Project manager / reviewer |
+| `SPRINT_1200_001_005_router_rate_limiting_tests.md` | Sprint 5: Comprehensive testing | QA / implementer |
+| `SPRINT_1200_001_006_router_rate_limiting_docs.md` | Sprint 6: Documentation & rollout prep | Docs / implementer |
 | `SPRINT_1200_001_IMPLEMENTATION_GUIDE.md` | Technical reference | **READ FIRST** before coding |
 
-### Documentation Files (To Be Created in Sprint 6)
+### Documentation Files
 
 | File | Purpose | Created In |
 |------|---------|------------|
+| `docs/router/rate-limiting-routes.md` | Per-route configuration guide | Sprint 2 |
 | `docs/router/rate-limiting.md` | User-facing configuration guide | Sprint 6 |
 | `docs/operations/router-rate-limiting.md` | Operational runbook | Sprint 6 |
-| `docs/modules/router/architecture.md` | Architecture documentation | Sprint 6 |
+| `docs/modules/router/rate-limiting.md` | Module-level rate-limiting dossier | Sprint 6 |
 
 ---
 
@@ -306,6 +311,38 @@ Copy this to master tracker and update as you progress:
 
 ## File Structure (After Implementation)
 
+### Actual (landed)
+
+```
+src/__Libraries/StellaOps.Router.Gateway/RateLimit/
+  CircuitBreaker.cs
+  EnvironmentRateLimiter.cs
+  InMemoryValkeyRateLimitStore.cs
+  InstanceRateLimiter.cs
+  LimitInheritanceResolver.cs
+  RateLimitConfig.cs
+  RateLimitDecision.cs
+  RateLimitMetrics.cs
+  RateLimitMiddleware.cs
+  RateLimitRule.cs
+  RateLimitRouteMatcher.cs
+  RateLimitService.cs
+  RateLimitServiceCollectionExtensions.cs
+  ValkeyRateLimitStore.cs
+
+tests/StellaOps.Router.Gateway.Tests/
+  LimitInheritanceResolverTests.cs
+  InMemoryValkeyRateLimitStoreTests.cs
+  InstanceRateLimiterTests.cs
+  RateLimitConfigTests.cs
+  RateLimitRouteMatcherTests.cs
+  RateLimitServiceTests.cs
+
+docs/router/rate-limiting-routes.md
+```
+
+### Original plan (reference)
+
 ```
 src/__Libraries/StellaOps.Router.Gateway/
 ├── RateLimit/
@@ -351,8 +388,8 @@ __Tests/
 │   ├── RouteMatchingTests.cs
 │   └── InheritanceResolverTests.cs
 
-tests/load/k6/
-└── rate-limit-scenarios.js
+tests/load/
+└── router-rate-limiting-load-test.js
 ```
 
 ---
@@ -443,7 +480,9 @@ rate_limiting:
 - **Sprint 1:** `SPRINT_1200_001_001_router_rate_limiting_core.md`
 - **Sprint 2:** `SPRINT_1200_001_002_router_rate_limiting_per_route.md`
 - **Sprint 3:** `SPRINT_1200_001_003_router_rate_limiting_rule_stacking.md`
-- **Sprint 4-6:** To be created by implementer (templates in master tracker)
+- **Sprint 4:** `SPRINT_1200_001_004_router_rate_limiting_service_migration.md` (closed N/A)
+- **Sprint 5:** `SPRINT_1200_001_005_router_rate_limiting_tests.md`
+- **Sprint 6:** `SPRINT_1200_001_006_router_rate_limiting_docs.md`
 
 ### Technical Guides
 - **Implementation Guide:** `SPRINT_1200_001_IMPLEMENTATION_GUIDE.md` (comprehensive)
@@ -460,4 +499,4 @@ rate_limiting:
 
 ---
 
-**Ready to implement?** Start with the Implementation Guide, then proceed to Sprint 1!
+**Already implemented.** Review the master tracker and run `dotnet test StellaOps.Router.slnx -c Release`.