tracking

type Alert struct {
	Type      string
	Severity  string
	Message   string
	Timestamp time.Time
}

type AlertThreshold struct {
	DailyTokenLimit  int64
	DailyCostLimit   float64
	WeeklyTokenLimit int64
	WeeklyCostLimit  float64
}

type AuditLog struct {
	ID           int64     `json:"id"`
	TeamID       int64     `json:"team_id"`
	UserID       *int64    `json:"user_id,omitempty"`
	Action       string    `json:"action"` // "create", "update", "delete", "login", etc.
	ResourceType string    `json:"resource_type"`
	ResourceID   string    `json:"resource_id,omitempty"`
	OldValue     string    `json:"old_value,omitempty"`
	NewValue     string    `json:"new_value,omitempty"`
	IPAddress    string    `json:"ip_address,omitempty"`
	UserAgent    string    `json:"user_agent,omitempty"`
	CreatedAt    time.Time `json:"created_at"`
}

type CheckpointEventRecord struct {
	ID          int64     `json:"id"`
	CommandID   int64     `json:"command_id"`
	SessionID   string    `json:"session_id"`
	Trigger     string    `json:"trigger"`
	Reason      string    `json:"reason"`
	FillPct     float64   `json:"fill_pct"`
	Quality     float64   `json:"quality"`
	CooldownSec int       `json:"cooldown_sec"`
	CreatedAt   time.Time `json:"created_at"`
}

type CheckpointTelemetry struct {
	Days        int                    `json:"days"`
	TotalEvents int64                  `json:"total_events"`
	ByTrigger   map[string]int64       `json:"by_trigger"`
	LastEvent   *CheckpointEventRecord `json:"last_event,omitempty"`
}

type CommandBreakdown struct {
	Command      string  `json:"command"`
	Count        int     `json:"count"`
	InputTokens  int     `json:"input_tokens"`
	OutputTokens int     `json:"output_tokens"`
	SavedTokens  int     `json:"saved_tokens"`
	SavingsPct   float64 `json:"savings_pct"`
}

type CommandCost struct {
	Command     string
	TimesRun    int
	TokensSaved int
	CostSaved   float64
}

type CommandFailureCount struct {
	Command string `json:"command"`
	Count   int    `json:"count"`
}

type CommandRecord struct {
	ID             int64     `json:"id"`
	Command        string    `json:"command"`
	OriginalOutput string    `json:"original_output,omitempty"`
	FilteredOutput string    `json:"filtered_output,omitempty"`
	OriginalTokens int       `json:"original_tokens"`
	FilteredTokens int       `json:"filtered_tokens"`
	SavedTokens    int       `json:"saved_tokens"`
	ProjectPath    string    `json:"project_path"`
	SessionID      string    `json:"session_id,omitempty"`
	ExecTimeMs     int64     `json:"exec_time_ms"`
	Timestamp      time.Time `json:"timestamp"`
	ParseSuccess   bool      `json:"parse_success"`
	// AI Agent attribution fields
	AgentName   string `json:"agent_name,omitempty"`   // e.g., "Claude Code", "OpenCode", "Cursor"
	ModelName   string `json:"model_name,omitempty"`   // e.g., "claude-3-opus", "gpt-4", "gemini-pro"
	Provider    string `json:"provider,omitempty"`     // e.g., "Anthropic", "OpenAI", "Google"
	ModelFamily string `json:"model_family,omitempty"` // e.g., "claude", "gpt", "gemini"
	// Smart context read metadata
	ContextKind         string `json:"context_kind,omitempty"`          // e.g., "read", "delta", "mcp"
	ContextMode         string `json:"context_mode,omitempty"`          // requested mode: auto, graph, delta, ...
	ContextResolvedMode string `json:"context_resolved_mode,omitempty"` // effective mode after auto-resolution
	ContextTarget       string `json:"context_target,omitempty"`        // file path or target identifier
	ContextRelatedFiles int    `json:"context_related_files,omitempty"` // number of related files included
	ContextBundle       bool   `json:"context_bundle,omitempty"`        // whether multiple files were delivered together
}

type CommandStats struct {
	Command        string  `json:"command"`
	ExecutionCount int     `json:"execution_count"`
	TotalSaved     int     `json:"total_saved"`
	TotalOriginal  int     `json:"total_original"`
	ReductionPct   float64 `json:"reduction_percent"`
}

type CostAggregation struct {
	ID                  int64     `json:"id"`
	TeamID              int64     `json:"team_id"`
	DateBucket          string    `json:"date_bucket"` // YYYY-MM-DD
	Period              string    `json:"period"`      // "daily", "weekly", "monthly"
	TotalCommands       int       `json:"total_commands"`
	TotalOriginalTokens int       `json:"total_original_tokens"`
	TotalFilteredTokens int       `json:"total_filtered_tokens"`
	TotalSavedTokens    int       `json:"total_saved_tokens"`
	EstimatedCostUSD    float64   `json:"estimated_cost_usd"`
	EstimatedSavingsUSD float64   `json:"estimated_savings_usd"`
	AvgReductionPercent float64   `json:"avg_reduction_percent"`
	CreatedAt           time.Time `json:"created_at"`
	UpdatedAt           time.Time `json:"updated_at"`
}

type CostEstimate struct {
	TokensSaved      int
	EstimatedSavings float64
	Currency         string
	CostPer1MTokens  float64
}

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

type CostProjection struct {
	MonthlyEstimate float64
	YearlyEstimate  float64
	GrowthRate      float64 // Monthly growth rate
}

type CostReport struct {
	GeneratedAt      time.Time
	Period           string
	TotalTokensSaved int64
	EstimatedSavings float64
	Currency         string
	Model            string
	DailyBreakdown   []DailyCost
	TopCommands      []CommandCost
	Projections      CostProjection
}

type DailyCost struct {
	Date         string
	TokensSaved  int
	CostSaved    float64
	CommandCount int
}

type FilterEffectiveness struct {
	FilterName          string     `json:"filter_name"`
	TeamID              *int64     `json:"team_id,omitempty"`
	UsageCount          int        `json:"usage_count"`
	AvgEffectiveness    float64    `json:"avg_effectiveness"`
	TotalSaved          int        `json:"total_saved"`
	AvgProcessingTimeUs float64    `json:"avg_processing_time_us"`
	FirstUsed           *time.Time `json:"first_used,omitempty"`
	LastUsed            *time.Time `json:"last_used,omitempty"`
}

type FilterMetric struct {
	ID                 int64     `json:"id"`
	FilterName         string    `json:"filter_name"`
	TeamID             *int64    `json:"team_id,omitempty"`
	CommandID          *int64    `json:"command_id,omitempty"`
	TokensBefore       int       `json:"tokens_before"`
	TokensAfter        int       `json:"tokens_after"`
	TokensSaved        int       `json:"tokens_saved"`
	ProcessingTimeUs   int64     `json:"processing_time_us"`
	EffectivenessScore float64   `json:"effectiveness_score"`
	IsActive           bool      `json:"is_active"`
	CreatedAt          time.Time `json:"created_at"`
}

type GainSummary struct {
	TotalCommands   int                `json:"total_commands"`
	TotalInput      int                `json:"total_input"`
	TotalOutput     int                `json:"total_output"`
	TotalSaved      int                `json:"total_saved"`
	AvgSavingsPct   float64            `json:"avg_savings_pct"`
	TotalExecTimeMs int64              `json:"total_exec_time_ms"`
	AvgExecTimeMs   int64              `json:"avg_exec_time_ms"`
	ByCommand       []CommandBreakdown `json:"by_command"`
	DailyStats      []PeriodStats      `json:"daily_stats,omitempty"`
	WeeklyStats     []PeriodStats      `json:"weekly_stats,omitempty"`
	MonthlyStats    []PeriodStats      `json:"monthly_stats,omitempty"`
	RecentCommands  []CommandRecord    `json:"recent_commands,omitempty"`
}

type GainSummaryOptions struct {
	ProjectPath    string
	IncludeDaily   bool
	IncludeWeekly  bool
	IncludeMonthly bool
	IncludeHistory bool
}

type LayerStatRecord struct {
	LayerName   string
	TokensSaved int
	DurationUs  int64
}

type ParseFailureRecord struct {
	ID                int64     `json:"id"`
	Timestamp         time.Time `json:"timestamp"`
	RawCommand        string    `json:"raw_command"`
	ErrorMessage      string    `json:"error_message"`
	FallbackSucceeded bool      `json:"fallback_succeeded"`
}

type ParseFailureSummary struct {
	Total          int64                 `json:"total"`
	RecoveryRate   float64               `json:"recovery_rate"`
	TopCommands    []CommandFailureCount `json:"top_commands"`
	RecentFailures []ParseFailureRecord  `json:"recent_failures"`
}

type PeriodStats struct {
	Period       string  `json:"period"`        // Date string (YYYY-MM-DD, YYYY-W##, YYYY-MM)
	Commands     int     `json:"commands"`      // Number of commands
	InputTokens  int     `json:"input_tokens"`  // Total input tokens
	OutputTokens int     `json:"output_tokens"` // Total output tokens (after filtering)
	SavedTokens  int     `json:"saved_tokens"`  // Tokens saved
	SavingsPct   float64 `json:"savings_pct"`   // Percentage saved
	ExecTimeMs   int64   `json:"exec_time_ms"`  // Total execution time
}

type ReportFilter struct {
	ProjectPath string     `json:"project_path,omitempty"`
	SessionID   string     `json:"session_id,omitempty"`
	Command     string     `json:"command,omitempty"`
	StartTime   *time.Time `json:"start_time,omitempty"`
	EndTime     *time.Time `json:"end_time,omitempty"`
}

type SavingsSummary struct {
	TotalCommands int     `json:"total_commands"`
	TotalSaved    int     `json:"total_saved"`
	TotalOriginal int     `json:"total_original"`
	TotalFiltered int     `json:"total_filtered"`
	ReductionPct  float64 `json:"reduction_percent"`
}

type SessionInfo struct {
	SessionID   string    `json:"session_id"`
	StartedAt   time.Time `json:"started_at"`
	ProjectPath string    `json:"project_path"`
}

type Team struct {
	ID                 int64     `json:"id"`
	Name               string    `json:"name"`
	Slug               string    `json:"slug"`
	Description        string    `json:"description,omitempty"`
	OwnerID            *int64    `json:"owner_id,omitempty"`
	MonthlyTokenBudget int       `json:"monthly_token_budget"`
	CreatedAt          time.Time `json:"created_at"`
	UpdatedAt          time.Time `json:"updated_at"`
}

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

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

type TrackerInterface interface {
	Record(record *CommandRecord) error
	GetSavings(projectPath string) (*SavingsSummary, error)
	GetRecentCommands(projectPath string, limit int) ([]CommandRecord, error)
	Query(query string, args ...any) (*sql.Rows, error)
	Close() error
}

type TrendData struct {
	TeamID                 int64   `json:"team_id"`
	DateBucket             string  `json:"date_bucket"`
	TotalCommands          int     `json:"total_commands"`
	TotalOriginalTokens    int     `json:"total_original_tokens"`
	TotalFilteredTokens    int     `json:"total_filtered_tokens"`
	TotalSavedTokens       int     `json:"total_saved_tokens"`
	EstimatedCostUSD       float64 `json:"estimated_cost_usd"`
	EstimatedSavingsUSD    float64 `json:"estimated_savings_usd"`
	AvgReductionPercent    float64 `json:"avg_reduction_percent"`
	ActualReductionPercent float64 `json:"actual_reduction_percent"`
}

type User struct {
	ID        int64      `json:"id"`
	Email     string     `json:"email"`
	TeamID    int64      `json:"team_id"`
	FullName  string     `json:"full_name,omitempty"`
	AvatarURL string     `json:"avatar_url,omitempty"`
	Role      string     `json:"role"` // "admin", "editor", "viewer"
	IsActive  bool       `json:"is_active"`
	LastLogin *time.Time `json:"last_login,omitempty"`
	CreatedAt time.Time  `json:"created_at"`
	UpdatedAt time.Time  `json:"updated_at"`
}