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

759 B

Hybrid Logical Clock Library Charter

Mission

Provide deterministic, monotonic HLC timestamps for distributed ordering.

Responsibilities

  • Maintain HLC core logic, parsing, and serialization.
  • Ensure TimeProvider usage for deterministic tests.
  • Track sprint tasks in TASKS.md and update the sprint tracker.

Key Paths

  • HybridLogicalClock.cs
  • HlcTimestamp.cs
  • PostgresHlcStateStore.cs

Required Reading

  • docs/modules/platform/architecture-overview.md
  • docs-archived/implplan/2025-12-29-csproj-audit/SPRINT_20251229_049_BE_csproj_audit_maint_tests.md

Working Agreement

    1. Keep timestamps monotonic and causally ordered.
    1. Use invariant parsing/formatting.
    1. Update TASKS.md and sprint statuses when work changes.