# 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.