save progress

src/Router/__Libraries/StellaOps.Messaging.Transport.InMemory/AGENTS.md

@@ -0,0 +1,24 @@
+# Messaging InMemory Transport Agent Charter
+
+## Mission
+- Provide deterministic in-memory transport for messaging abstractions.
+
+## Responsibilities
+- Keep in-memory behavior predictable and test-friendly.
+- Preserve deterministic ordering and time handling where possible.
+
+## Required Reading
+- docs/07_HIGH_LEVEL_ARCHITECTURE.md
+- docs/modules/router/architecture.md
+
+## Working Directory & Scope
+- Primary: src/Router/__Libraries/StellaOps.Messaging.Transport.InMemory
+- Allowed shared projects: src/Router/__Libraries/StellaOps.Messaging
+
+## Testing Expectations
+- Add unit tests for queue leasing, event streams, and cache/idempotency behavior.
+- Keep tests offline-friendly without external dependencies.
+
+## Working Agreement
+- Update sprint status in docs/implplan/SPRINT_*.md and local TASKS.md.
+- Keep outputs deterministic and avoid non-ASCII logs.

src/Router/__Libraries/StellaOps.Messaging.Transport.InMemory/TASKS.md

@@ -0,0 +1,10 @@
+# StellaOps.Messaging.Transport.InMemory Task Board
+
+This board mirrors active sprint tasks for this module.
+Source of truth: `docs/implplan/SPRINT_20251229_049_BE_csproj_audit_maint_tests.md`.
+
+| Task ID | Status | Notes |
+| --- | --- | --- |
+| AUDIT-0381-M | DONE | Maintainability audit for InMemory transport. |
+| AUDIT-0381-T | DONE | Test coverage audit for InMemory transport. |
+| AUDIT-0381-A | TODO | Pending approval. |

src/Router/__Libraries/StellaOps.Messaging.Transport.Postgres/AGENTS.md

@@ -0,0 +1,24 @@
+# Messaging Postgres Transport Agent Charter
+
+## Mission
+- Provide PostgreSQL-backed messaging transport with reliable queue and stream semantics.
+
+## Responsibilities
+- Keep SQL safe, parameterized, and deterministic across environments.
+- Ensure schema/table naming is validated or quoted to avoid injection and drift.
+
+## Required Reading
+- docs/07_HIGH_LEVEL_ARCHITECTURE.md
+- docs/modules/router/architecture.md
+
+## Working Directory & Scope
+- Primary: src/Router/__Libraries/StellaOps.Messaging.Transport.Postgres
+- Allowed shared projects: src/Router/__Libraries/StellaOps.Messaging
+
+## Testing Expectations
+- Add tests for queue leasing, retry semantics, cache TTL, event stream ordering, and idempotency.
+- Keep tests offline-friendly; use opt-in container fixtures if needed.
+
+## Working Agreement
+- Update sprint status in docs/implplan/SPRINT_*.md and local TASKS.md.
+- Keep outputs deterministic and avoid non-ASCII logs.

src/Router/__Libraries/StellaOps.Messaging.Transport.Postgres/TASKS.md

@@ -0,0 +1,10 @@
+# StellaOps.Messaging.Transport.Postgres Task Board
+
+This board mirrors active sprint tasks for this module.
+Source of truth: `docs/implplan/SPRINT_20251229_049_BE_csproj_audit_maint_tests.md`.
+
+| Task ID | Status | Notes |
+| --- | --- | --- |
+| AUDIT-0382-M | DONE | Maintainability audit for Postgres transport. |
+| AUDIT-0382-T | DONE | Test coverage audit for Postgres transport. |
+| AUDIT-0382-A | TODO | Pending approval. |

src/Router/__Libraries/StellaOps.Messaging.Transport.Valkey/AGENTS.md

@@ -0,0 +1,24 @@
+# Messaging Valkey Transport Agent Charter
+
+## Mission
+- Provide Valkey/Redis-backed messaging transport with stream, cache, and idempotency primitives.
+
+## Responsibilities
+- Keep retry semantics lossless and metadata-preserving.
+- Ensure transport behavior is deterministic and observable under failure.
+
+## Required Reading
+- docs/07_HIGH_LEVEL_ARCHITECTURE.md
+- docs/modules/router/architecture.md
+
+## Working Directory & Scope
+- Primary: src/Router/__Libraries/StellaOps.Messaging.Transport.Valkey
+- Allowed shared projects: src/Router/__Libraries/StellaOps.Messaging
+
+## Testing Expectations
+- Maintain integration tests for stream queues and idempotency.
+- Add unit tests for cache, rate limiter, event stream, sorted index, and token store.
+
+## Working Agreement
+- Update sprint status in docs/implplan/SPRINT_*.md and local TASKS.md.
+- Keep outputs deterministic and avoid non-ASCII logs.

src/Router/__Libraries/StellaOps.Messaging.Transport.Valkey/TASKS.md

@@ -0,0 +1,10 @@
+# StellaOps.Messaging.Transport.Valkey Task Board
+
+This board mirrors active sprint tasks for this module.
+Source of truth: `docs/implplan/SPRINT_20251229_049_BE_csproj_audit_maint_tests.md`.
+
+| Task ID | Status | Notes |
+| --- | --- | --- |
+| AUDIT-0383-M | DONE | Maintainability audit for Valkey transport. |
+| AUDIT-0383-T | DONE | Test coverage audit for Valkey transport. |
+| AUDIT-0383-A | TODO | Pending approval. |

src/Router/__Libraries/StellaOps.Messaging/AGENTS.md

@@ -0,0 +1,24 @@
+# Messaging Library Agent Charter
+
+## Mission
+- Provide transport-agnostic messaging abstractions and plugin discovery for Router services.
+
+## Responsibilities
+- Keep abstractions deterministic and stable across transports.
+- Ensure plugin discovery and DI wiring are predictable and testable.
+
+## Required Reading
+- docs/07_HIGH_LEVEL_ARCHITECTURE.md
+- docs/modules/router/architecture.md
+
+## Working Directory & Scope
+- Primary: src/Router/__Libraries/StellaOps.Messaging
+- Allowed shared projects: src/Router/__Libraries/StellaOps.Messaging.Transport.*
+
+## Testing Expectations
+- Add unit tests for plugin loader behavior and option validation defaults.
+- Keep tests offline-friendly without external brokers.
+
+## Working Agreement
+- Update sprint status in docs/implplan/SPRINT_*.md and local TASKS.md.
+- Keep outputs deterministic and avoid non-ASCII logs.

src/Router/__Libraries/StellaOps.Messaging/TASKS.md

@@ -0,0 +1,10 @@
+# StellaOps.Messaging Task Board
+
+This board mirrors active sprint tasks for this module.
+Source of truth: `docs/implplan/SPRINT_20251229_049_BE_csproj_audit_maint_tests.md`.
+
+| Task ID | Status | Notes |
+| --- | --- | --- |
+| AUDIT-0379-M | DONE | Maintainability audit for StellaOps.Messaging. |
+| AUDIT-0379-T | DONE | Test coverage audit for StellaOps.Messaging. |
+| AUDIT-0379-A | TODO | Pending approval. |

src/Router/__Libraries/StellaOps.Microservice.AspNetCore/AGENTS.md

@@ -0,0 +1,24 @@
+# ASP.NET Core Router Bridge Agent Charter
+
+## Mission
+- Bridge ASP.NET Core endpoints into Router discovery and dispatch.
+
+## Responsibilities
+- Maintain deterministic endpoint discovery and correct authorization mapping.
+- Keep route matching aligned with ASP.NET behavior and honor bridge options.
+
+## Required Reading
+- docs/07_HIGH_LEVEL_ARCHITECTURE.md
+- docs/modules/platform/architecture-overview.md
+
+## Working Directory & Scope
+- Primary: src/Router/__Libraries/StellaOps.Microservice.AspNetCore
+- Tests: src/__Libraries/__Tests/StellaOps.Microservice.AspNetCore.Tests
+
+## Testing Expectations
+- Cover discovery options, auth mapping, and dispatch edge cases (constraints, cancellation).
+- Prefer deterministic inputs; avoid wall-clock and random IDs in test assertions.
+
+## Working Agreement
+- Update sprint status in docs/implplan/SPRINT_*.md and local TASKS.md.
+- Keep outputs deterministic and avoid non-ASCII logs.

src/Router/__Libraries/StellaOps.Microservice.AspNetCore/TASKS.md

@@ -0,0 +1,10 @@
+# StellaOps.Microservice.AspNetCore Task Board
+
+This board mirrors active sprint tasks for this module.
+Source of truth: `docs/implplan/SPRINT_20251229_049_BE_csproj_audit_maint_tests.md`.
+
+| Task ID | Status | Notes |
+| --- | --- | --- |
+| AUDIT-0388-M | DONE | Maintainability audit for StellaOps.Microservice.AspNetCore. |
+| AUDIT-0388-T | DONE | Test coverage audit for StellaOps.Microservice.AspNetCore. |
+| AUDIT-0388-A | TODO | Pending approval. |

src/Router/__Libraries/StellaOps.Microservice.SourceGen/AGENTS.md

@@ -0,0 +1,24 @@
+# Microservice Source Generator Agent Charter
+
+## Mission
+- Generate deterministic endpoint metadata and schema providers at compile time.
+
+## Responsibilities
+- Keep generated output stable and diagnostics actionable.
+- Avoid schema collisions or silent drops.
+
+## Required Reading
+- docs/07_HIGH_LEVEL_ARCHITECTURE.md
+- docs/modules/platform/architecture-overview.md
+
+## Working Directory & Scope
+- Primary: src/Router/__Libraries/StellaOps.Microservice.SourceGen
+- Tests: src/Router/__Tests/StellaOps.Microservice.SourceGen.Tests
+
+## Testing Expectations
+- Cover schema generation, diagnostics, and duplicate handling.
+- Ensure generator output is deterministic across runs.
+
+## Working Agreement
+- Update sprint status in docs/implplan/SPRINT_*.md and local TASKS.md.
+- Keep outputs deterministic and avoid non-ASCII logs.

src/Router/__Libraries/StellaOps.Microservice.SourceGen/TASKS.md

@@ -0,0 +1,10 @@
+# StellaOps.Microservice.SourceGen Task Board
+
+This board mirrors active sprint tasks for this module.
+Source of truth: `docs/implplan/SPRINT_20251229_049_BE_csproj_audit_maint_tests.md`.
+
+| Task ID | Status | Notes |
+| --- | --- | --- |
+| AUDIT-0390-M | DONE | Maintainability audit for StellaOps.Microservice.SourceGen. |
+| AUDIT-0390-T | DONE | Test coverage audit for StellaOps.Microservice.SourceGen. |
+| AUDIT-0390-A | TODO | Pending approval. |

src/Router/__Libraries/StellaOps.Microservice/AGENTS.md

@@ -0,0 +1,24 @@
+# Microservice SDK Agent Charter
+
+## Mission
+- Provide Router microservice SDK primitives for discovery, dispatch, and schema validation.
+
+## Responsibilities
+- Keep request/response handling deterministic and stream-safe.
+- Preserve schema and endpoint metadata without silent drops.
+
+## Required Reading
+- docs/07_HIGH_LEVEL_ARCHITECTURE.md
+- docs/modules/platform/architecture-overview.md
+
+## Working Directory & Scope
+- Primary: src/Router/__Libraries/StellaOps.Microservice
+- Tests: src/Router/__Tests/StellaOps.Microservice.Tests
+
+## Testing Expectations
+- Cover dispatch, schema validation, YAML overrides, and streaming helpers.
+- Prefer deterministic inputs; avoid wall-clock or random IDs in tests.
+
+## Working Agreement
+- Update sprint status in docs/implplan/SPRINT_*.md and local TASKS.md.
+- Keep outputs deterministic and avoid non-ASCII logs.

src/Router/__Libraries/StellaOps.Microservice/TASKS.md

@@ -0,0 +1,10 @@
+# StellaOps.Microservice Task Board
+
+This board mirrors active sprint tasks for this module.
+Source of truth: `docs/implplan/SPRINT_20251229_049_BE_csproj_audit_maint_tests.md`.
+
+| Task ID | Status | Notes |
+| --- | --- | --- |
+| AUDIT-0387-M | DONE | Maintainability audit for StellaOps.Microservice. |
+| AUDIT-0387-T | DONE | Test coverage audit for StellaOps.Microservice. |
+| AUDIT-0387-A | TODO | Pending approval. |

src/Router/__Tests/StellaOps.Messaging.Transport.Valkey.Tests/AGENTS.md

@@ -0,0 +1,24 @@
+# Messaging Valkey Transport Tests Agent Charter
+
+## Mission
+- Validate Valkey transport behavior with integration coverage for queues and idempotency.
+
+## Responsibilities
+- Keep tests opt-in and skip cleanly when Docker/Valkey is unavailable.
+- Ensure tests are deterministic and avoid non-ASCII output.
+
+## Required Reading
+- docs/07_HIGH_LEVEL_ARCHITECTURE.md
+- docs/modules/router/architecture.md
+
+## Working Directory & Scope
+- Primary: src/Router/__Tests/StellaOps.Messaging.Transport.Valkey.Tests
+- Allowed shared projects: src/Router/__Libraries/StellaOps.Messaging.Transport.Valkey
+
+## Testing Expectations
+- Use the Valkey container fixture with opt-in env gating.
+- Add tests for cache, event streams, rate limiting, sorted index, and token store as needed.
+
+## Working Agreement
+- Update sprint status in docs/implplan/SPRINT_*.md and local TASKS.md.
+- Keep outputs deterministic and avoid non-ASCII logs.

src/Router/__Tests/StellaOps.Messaging.Transport.Valkey.Tests/TASKS.md

@@ -0,0 +1,10 @@
+# StellaOps.Messaging.Transport.Valkey.Tests Task Board
+
+This board mirrors active sprint tasks for this module.
+Source of truth: `docs/implplan/SPRINT_20251229_049_BE_csproj_audit_maint_tests.md`.
+
+| Task ID | Status | Notes |
+| --- | --- | --- |
+| AUDIT-0384-M | DONE | Maintainability audit for Valkey transport tests. |
+| AUDIT-0384-T | DONE | Test coverage audit for Valkey transport tests. |
+| AUDIT-0384-A | DONE | Waived (test project). |

src/Router/__Tests/StellaOps.Microservice.SourceGen.Tests/AGENTS.md

@@ -0,0 +1,23 @@
+# Microservice SourceGen Tests Agent Charter
+
+## Mission
+- Validate the source generator diagnostics and generated output.
+
+## Responsibilities
+- Keep tests deterministic and compiler-independent.
+- Exercise schema generation and duplicate detection paths.
+
+## Required Reading
+- docs/07_HIGH_LEVEL_ARCHITECTURE.md
+- docs/modules/platform/architecture-overview.md
+
+## Working Directory & Scope
+- Primary: src/Router/__Tests/StellaOps.Microservice.SourceGen.Tests
+
+## Testing Expectations
+- Cover diagnostics, schema provider output, and edge cases.
+- Avoid wall-clock or random IDs in assertions.
+
+## Working Agreement
+- Update sprint status in docs/implplan/SPRINT_*.md and local TASKS.md.
+- Keep outputs deterministic and avoid non-ASCII logs.

src/Router/__Tests/StellaOps.Microservice.SourceGen.Tests/TASKS.md

@@ -0,0 +1,10 @@
+# StellaOps.Microservice.SourceGen.Tests Task Board
+
+This board mirrors active sprint tasks for this module.
+Source of truth: `docs/implplan/SPRINT_20251229_049_BE_csproj_audit_maint_tests.md`.
+
+| Task ID | Status | Notes |
+| --- | --- | --- |
+| AUDIT-0391-M | DONE | Maintainability audit for StellaOps.Microservice.SourceGen.Tests. |
+| AUDIT-0391-T | DONE | Test coverage audit for StellaOps.Microservice.SourceGen.Tests. |
+| AUDIT-0391-A | DONE | Waived (test project). |

src/Router/__Tests/StellaOps.Microservice.Tests/AGENTS.md

@@ -0,0 +1,23 @@
+# Router Microservice SDK Tests Agent Charter
+
+## Mission
+- Validate Router microservice SDK primitives and validation behavior.
+
+## Responsibilities
+- Keep tests deterministic and minimize timing-based assertions.
+- Cover schema validation and connection manager behaviors.
+
+## Required Reading
+- docs/07_HIGH_LEVEL_ARCHITECTURE.md
+- docs/modules/platform/architecture-overview.md
+
+## Working Directory & Scope
+- Primary: src/Router/__Tests/StellaOps.Microservice.Tests
+
+## Testing Expectations
+- Prefer deterministic inputs; avoid Task.Delay for timing checks where possible.
+- Avoid wall-clock and random IDs in assertions.
+
+## Working Agreement
+- Update sprint status in docs/implplan/SPRINT_*.md and local TASKS.md.
+- Keep outputs deterministic and avoid non-ASCII logs.

src/Router/__Tests/StellaOps.Microservice.Tests/TASKS.md

@@ -0,0 +1,10 @@
+# StellaOps.Microservice.Tests (Router) Task Board
+
+This board mirrors active sprint tasks for this module.
+Source of truth: `docs/implplan/SPRINT_20251229_049_BE_csproj_audit_maint_tests.md`.
+
+| Task ID | Status | Notes |
+| --- | --- | --- |
+| AUDIT-0393-M | DONE | Maintainability audit for Router StellaOps.Microservice.Tests. |
+| AUDIT-0393-T | DONE | Test coverage audit for Router StellaOps.Microservice.Tests. |
+| AUDIT-0393-A | DONE | Waived (test project). |

src/Router/__Tests/__Libraries/StellaOps.Messaging.Testing/AGENTS.md

@@ -0,0 +1,24 @@
+# Messaging Testing Library Agent Charter
+
+## Mission
+- Provide reusable fixtures and builders for messaging transport tests.
+
+## Responsibilities
+- Keep fixtures deterministic and offline-friendly.
+- Ensure container-based fixtures have clear skip or opt-in behavior.
+
+## Required Reading
+- docs/07_HIGH_LEVEL_ARCHITECTURE.md
+- docs/modules/router/architecture.md
+
+## Working Directory & Scope
+- Primary: src/Router/__Tests/__Libraries/StellaOps.Messaging.Testing
+- Allowed shared projects: src/Router/__Libraries/StellaOps.Messaging.Transport.*
+
+## Testing Expectations
+- Provide stable fixtures with fixed time or IDs when possible.
+- Keep tests and fixtures free of network dependencies unless explicitly required.
+
+## Working Agreement
+- Update sprint status in docs/implplan/SPRINT_*.md and local TASKS.md.
+- Keep outputs deterministic and avoid non-ASCII logs.

src/Router/__Tests/__Libraries/StellaOps.Messaging.Testing/TASKS.md

@@ -0,0 +1,10 @@
+# StellaOps.Messaging.Testing Task Board
+
+This board mirrors active sprint tasks for this module.
+Source of truth: `docs/implplan/SPRINT_20251229_049_BE_csproj_audit_maint_tests.md`.
+
+| Task ID | Status | Notes |
+| --- | --- | --- |
+| AUDIT-0380-M | DONE | Maintainability audit for StellaOps.Messaging.Testing. |
+| AUDIT-0380-T | DONE | Test coverage audit for StellaOps.Messaging.Testing. |
+| AUDIT-0380-A | DONE | Waived (test project). |