api

type APIError struct {
	Error   string `json:"error"`
	Code    string `json:"code,omitempty"`
	Details string `json:"details,omitempty"`
}

type FactResponse struct {
	Fact *types.Fact `json:"fact"`
}

type FactsIndexResponse struct {
	Facts []types.Fact `json:"facts"`
	Count int          `json:"count"`
	Stats FactsStats   `json:"stats"`
}

type FactsStats struct {
	TotalFacts int `json:"total_facts"`
	MaxFacts   int `json:"max_facts"`
}

type FileMetadataResponse struct {
	File *types.FileEntry `json:"file"`
}

type FilesIndexResponse struct {
	Index *types.FileIndex `json:"index"`
}

type FilesQueryParams struct {
	Q        string `json:"q,omitempty"`
	Category string `json:"category,omitempty"`
	Days     int    `json:"days,omitempty"`
	Entity   string `json:"entity,omitempty"`
	Tag      string `json:"tag,omitempty"`
	Topic    string `json:"topic,omitempty"`
	Limit    int    `json:"limit"`
}

type FilesQueryResponse struct {
	Files []graph.SearchResult `json:"files"`
	Count int                  `json:"count"`
	Query FilesQueryParams     `json:"query"`
}

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

type HealthMetricsProvider interface {
	GetSnapshot() HealthSnapshot
}

type HealthSnapshot struct {
	StartTime        time.Time
	Uptime           string
	UptimeSeconds    float64
	FilesProcessed   int
	APICalls         int
	CacheHits        int
	Errors           int
	LastBuildTime    time.Time
	LastBuildSuccess bool
	IndexFileCount   int
	WatcherActive    bool

	// Semantic provider info
	SemanticEnabled  bool
	SemanticProvider string
	SemanticModel    string

	// Cache versioning stats
	CacheVersion       string
	CacheTotalEntries  int
	CacheLegacyEntries int
	CacheTotalSize     int64
}

type IndexProvider interface {
	GetIndex(ctx context.Context) (*types.FileIndex, error)
}

type RebuildHandler interface {
	// Rebuild triggers an immediate index rebuild
	Rebuild() error
	// RebuildWithSync triggers a rebuild and optionally syncs graph with filesystem
	// When sync is true, stale graph nodes (files no longer on disk) are removed
	RebuildWithSync(sync bool) error
	// ClearGraph clears all data from the graph
	ClearGraph() error
	// IsRebuilding returns true if a rebuild is in progress
	IsRebuilding() bool
}

type RebuildResponse struct {
	Status  string `json:"status"`
	Message string `json:"message"`
}

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

type SSEEvent struct {
	Type      string           `json:"type"`
	Timestamp string           `json:"timestamp"`
	Data      *types.FileIndex `json:"data,omitempty"`
}

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