provenance

type AuditResult struct {
	Valid       bool
	Issues      []string
	Warnings    []string
	Coverage    float64  // Percentage of fields with provenance
	Conflicts   int      // Number of unresolved conflicts
	MissingData []string // Fields without provenance
}

type Auditor interface {
	// Audit checks provenance for completeness and consistency
	Audit(provenance Map) *AuditResult

	// ValidateAuthority ensures authority scores are valid
	ValidateAuthority(provenance Map) []string

	// CheckCoverage verifies all required fields have provenance
	CheckCoverage(provenance Map, requiredFields []string) []string
}

type ConflictInfo struct {
	Sources        []types.SourceID // Sources that had conflicting values
	Values         []any            // The conflicting values
	Resolution     string           // How the conflict was resolved
	SelectedSource types.SourceID   // Which source was selected
}

type Field struct {
	Current   Provenance     // Current value and its source
	History   []Provenance   // Historical values
	Conflicts []ConflictInfo // Any conflicts that were resolved
}

type Map map[string][]Provenance // key is "resourceType:resourceID:fieldPath"

type Provenance struct {
	Source        types.SourceID // Source that provided the value (e.g., "providers", "models_dev_git")
	Field         string         // Field path
	Value         any            // The actual value
	Timestamp     time.Time      // When the value was set
	Authority     float64        // Authority score (0.0 to 1.0)
	Confidence    float64        // Confidence in the value (0.0 to 1.0)
	Reason        string         // Reason for selecting this value
	PreviousValue any            // Previous value if updated
}

type ProvenanceFile struct {
	Provenance Map `yaml:"provenance"`
}

type Report struct {
	Resources map[string]ResourceProvenance // key is "resourceType:resourceID"
}

type ResourceProvenance struct {
	Type   types.ResourceType // Resource type (e.g., "model", "provider", "author")
	ID     string
	Fields map[string]Field
}

type Tracker interface {
	// Track records provenance for a field
	Track(resourceType types.ResourceType, resourceID string, field string, history Provenance)

	// Find retrieves provenance for a specific field
	FindByField(resourceType types.ResourceType, resourceID string, field string) []Provenance

	// FindByResource retrieves all provenance for a resource
	FindByResource(resourceType types.ResourceType, resourceID string) map[string][]Provenance

	// Map returns the complete provenance map
	Map() Map

	// Clear removes all provenance data
	Clear()
}