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        []sources.ID // Sources that had conflicting values
	Values         []any        // The conflicting values
	Resolution     string       // How the conflict was resolved
	SelectedSource sources.ID   // 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        sources.ID // Source that provided the value
	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 Report struct {
	Resources map[string]ResourceProvenance // key is "resourceType:resourceID"
}

type ResourceProvenance struct {
	Type   sources.ResourceType
	ID     string
	Fields map[string]Field
}

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

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

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

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

	// Clear removes all provenance data
	Clear()
}