Module logging 

Logging and observability infrastructure for xchecker

This module provides structured logging capabilities with timing, resource usage tracking, and verbose output support.

Implements FR-OBS-001: Structured logging with tracing support

Structs

FileOperation

Represents a file operation for logging

Logger

Logger for verbose output and observability (R7.5, NFR5)

MemoryStats

Memory usage statistics

PerformanceMetrics

Performance metrics for benchmarking (NFR1)

PerformanceTargets

Performance targets for validation (NFR1)

TimingInfo

Timing information for operations

TimingPercentiles

Timing percentiles for performance analysis

Functions

init_tracing

Initialize tracing subscriber for structured logging (FR-OBS-001)

log_cache_stats

Log cache statistics (standalone function for use outside Logger)

log_doctor_report

Log doctor report to console (wires Doctor into logging)

log_phase_complete

Log phase completion with duration (FR-OBS-001)

log_phase_error

Log phase error with context (FR-OBS-001, FR-OBS-002, FR-OBS-003)

log_phase_start

Log phase start with structured fields (FR-OBS-001)

phase_span

Create a span for phase execution with structured fields (FR-OBS-001)