coding_agent_search/analytics/mod.rs
1//! Shared analytics query library.
2//!
3//! Extracts SQL, bucketing, and derived-metric logic from CLI commands into a
4//! reusable module consumed by both `cass analytics *` CLI commands and the
5//! FrankenTUI analytics dashboards.
6//!
7//! # Module structure
8//!
9//! - [`types`] — filter, grouping, result structs, error type
10//! - [`bucketing`] — day_id / hour_id ↔ ISO date conversions
11//! - [`derive`] — safe derived-metric computation
12//! - [`query`] — SQL query builders against rollup tables
13//! - [`validate`] — rollup invariant checks, drift detection, perf guardrails
14
15pub mod bucketing;
16pub mod derive;
17pub mod query;
18pub mod types;
19pub mod validate;
20
21// Re-export the most commonly used items at the crate::analytics level.
22pub use types::{
23 AnalyticsError, AnalyticsFilter, AnalyticsResult, BreakdownResult, BreakdownRow, CoverageInfo,
24 DerivedMetrics, Dim, DriftInfo, DriftSignal, GroupBy, Metric, SessionScatterPoint,
25 SourceFilter, StatusResult, TableInfo, TimeseriesResult, ToolReport, ToolRow, UnpricedModel,
26 UnpricedModelsReport, UsageBucket,
27};
28pub use validate::{ValidateConfig, ValidationReport};