analytics

type AnalyticsRepository interface {
	Save(ctx context.Context, record *RecordRequest) error
	Query(ctx context.Context, req *MetricsRequest) (*MetricsResponse, error)
	GetTopCommands(ctx context.Context, limit int) ([]CommandStats, error)
}

type AnalyticsService interface {
	// Record saves a command execution record.
	Record(ctx context.Context, req *RecordRequest) error

	// GetMetrics returns aggregated metrics.
	GetMetrics(ctx context.Context, req *MetricsRequest) (*MetricsResponse, error)

	// GetEconomics returns cost analysis.
	GetEconomics(ctx context.Context) (*EconomicsResponse, error)

	// GetTopCommands returns the most used commands.
	GetTopCommands(ctx context.Context, limit int) ([]CommandStats, error)
}

type CommandStats struct {
	Command    string
	Count      int64
	AvgSavings float64
	TotalSaved int64
	LastUsed   time.Time
}

type EconomicsResponse struct {
	TokensSaved        int64
	EstimatedCostSaved float64
	ModelUsed          string
	CostPerToken       float64
	QuotaUsed          float64
	QuotaRemaining     float64
}

type FilterUsage struct {
	FilterName string
	Count      int64
	AvgSavings float64
}

type HourlyCount struct {
	Hour  int
	Count int64
}

type MetricsRequest struct {
	StartTime time.Time
	EndTime   time.Time
	SessionID string
}

type MetricsResponse struct {
	TotalCommands      int64
	TotalTokensSaved   int64
	TotalTokensIn      int64
	TotalTokensOut     int64
	AverageSavings     float64
	P50LatencyMs       float64
	P99LatencyMs       float64
	TopFilters         []FilterUsage
	HourlyDistribution []HourlyCount
}

type RecordRequest struct {
	Command        string        // Command executed
	OriginalTokens int           // Tokens before compression
	FilteredTokens int           // Tokens after compression
	Duration       time.Duration // Execution duration
	ExitCode       int           // Command exit code
	FilterMode     string        // Filter mode used
	SessionID      string        // Session identifier
}

type Service struct {
	// contains filtered or unexported fields
}