Module validate 

Analytics validation library.

Provides deterministic checks for:

• Track A invariants — usage_daily matches SUM(message_metrics).
• Track B invariants — token_daily_stats matches SUM(token_usage).
• Cross-track drift — Track A vs Track B deltas by day + agent.
• Performance guardrails — timing budgets for queries and rebuilds.

Output is a structured ValidationReport that serialises to JSON for cass analytics validate --json.

Structs

Check

A single validation check result.

DriftEntry

A cross-track drift entry.

PerfMeasurement

A single performance measurement.

RepairDecision

Grouped repair decision derived from a validation report.

RepairPlan

Summary of automatic repair opportunities in a validation report.

ReportMeta

Report metadata.

SamplingMeta

Sampling metadata.

ValidateConfig

Controls sampling vs deep-scan behaviour.

ValidationReport

Full validation report.

Enums

RepairKind

Safe automatic repair class for a validation failure.

Severity

Severity level for a single check.

Functions

build_repair_plan

Build a safe automatic repair plan from a validation report.

perf_breakdown_guardrail

Run a performance guardrail for breakdown queries.

perf_query_guardrail

Run a performance guardrail check: time a basic timeseries query.

run_validation

Run the full validation suite and return a structured report.