git.stella-ops.org/src/__Libraries/StellaOps.HybridLogicalClock.Tests/AGENTS.md

AGENTS - HybridLogicalClock Tests

Roles

• QA / test engineer: deterministic unit tests for HLC parsing, tick, and state store behavior.
• Backend engineer: align tests with HLC library contracts.

Required Reading

• docs/README.md
• docs/07_HIGH_LEVEL_ARCHITECTURE.md
• docs/modules/platform/architecture-overview.md
• src/__Libraries/AGENTS.md
• Current sprint file under docs/implplan/SPRINT_*.md

Working Directory & Boundaries

• Primary scope: src/__Libraries/StellaOps.HybridLogicalClock.Tests
• Test target: src/__Libraries/StellaOps.HybridLogicalClock
• Avoid cross-module edits unless explicitly noted in the sprint file.

Determinism and Safety

• Prefer fixed timestamps via FakeTimeProvider.
• Avoid DateTimeOffset.UtcNow and Guid.NewGuid in test fixtures.

Testing

• Cover parse/compare, tick/receive, and state store behavior with edge cases.