git.stella-ops.org/src/Telemetry/AGENTS.md

Telemetry Module Charter

Mission

• Provide deterministic telemetry context, propagation, and metrics outputs.

Responsibilities

• Propagate trace, tenant, and correlation context across services.
• Implement redaction, sampling, and metrics aggregation.
• Keep telemetry output stable and offline-friendly.

Required Reading

• docs/README.md
• docs/07_HIGH_LEVEL_ARCHITECTURE.md
• docs/modules/platform/architecture-overview.md
• docs/modules/telemetry/architecture.md
• docs/modules/telemetry/guides/telemetry-standards.md

Working Agreement

• Use TimeProvider and IGuidGenerator for timestamps and IDs.
• Use invariant formatting for numeric and date outputs.
• Avoid external network dependencies in core telemetry paths.

Testing Strategy

• Unit tests for context propagation, redaction, and metrics calculations.
• Determinism tests for sampling windows and output ordering.