91 lines
2.8 KiB
Go
91 lines
2.8 KiB
Go
package epistemics
|
|
|
|
import (
|
|
"fmt"
|
|
"git.cin.su/m/Assistant/contracts/world"
|
|
)
|
|
|
|
type VolatilityMode string
|
|
|
|
const (
|
|
VolatilityImmutable VolatilityMode = "IMMUTABLE"
|
|
VolatilityVersionBound VolatilityMode = "VERSION_BOUND"
|
|
VolatilityVerySlow VolatilityMode = "VERY_SLOW"
|
|
VolatilitySlow VolatilityMode = "SLOW"
|
|
VolatilityMedium VolatilityMode = "MEDIUM"
|
|
VolatilityFast VolatilityMode = "FAST"
|
|
VolatilityEphemeral VolatilityMode = "EPHEMERAL"
|
|
VolatilityCustom VolatilityMode = "CUSTOM"
|
|
)
|
|
|
|
type TemporalApplicability struct {
|
|
ObservedAtUnixMillis int64
|
|
ValidFromUnixMillis *int64
|
|
ValidUntilUnixMillis *int64
|
|
LastVerifiedAtUnixMillis *int64
|
|
Volatility VolatilitySpec
|
|
VersionBindings []world.VersionBinding
|
|
}
|
|
type VolatilitySpec struct {
|
|
Mode VolatilityMode
|
|
ExpectedChangeIntervalMillis *int64
|
|
RevalidateAfterMillis *int64
|
|
HardStaleAfterMillis *int64
|
|
InvalidateOnVersionChange bool
|
|
RevalidationPolicyRef string
|
|
}
|
|
type FreshnessAssessmentState string
|
|
|
|
const (
|
|
FreshnessAssessmentCurrent FreshnessAssessmentState = "CURRENT"
|
|
FreshnessAssessmentAcceptable FreshnessAssessmentState = "ACCEPTABLE"
|
|
FreshnessAssessmentAging FreshnessAssessmentState = "AGING"
|
|
FreshnessAssessmentStale FreshnessAssessmentState = "STALE"
|
|
FreshnessAssessmentVersionMismatch FreshnessAssessmentState = "VERSION_MISMATCH"
|
|
FreshnessAssessmentHistoricalOnly FreshnessAssessmentState = "HISTORICAL_ONLY"
|
|
FreshnessAssessmentUnknown FreshnessAssessmentState = "UNKNOWN"
|
|
)
|
|
|
|
type FreshnessAssessment struct {
|
|
SourceKnowledgeRef string
|
|
TaskRef string
|
|
State FreshnessAssessmentState
|
|
Reason string
|
|
AgeMillis int64
|
|
VersionMatchState string
|
|
RevalidationAttemptRef string
|
|
AssessedAtUnixMillis int64
|
|
}
|
|
type RevalidationRequest struct {
|
|
ID string
|
|
SourceKnowledgeRef string
|
|
TaskRef string
|
|
RequiredVersionRefs []world.SemanticReference
|
|
RequestedAtUnixMillis int64
|
|
}
|
|
type RevalidationResponse struct {
|
|
RequestID string
|
|
Assessment FreshnessAssessment
|
|
NewEvidenceRefs []EvidenceRef
|
|
CompletedAtUnixMillis int64
|
|
}
|
|
|
|
func (v VolatilitySpec) Validate() error {
|
|
if v.Mode == "" {
|
|
return fmt.Errorf("volatility mode is required")
|
|
}
|
|
return nil
|
|
}
|
|
func (t TemporalApplicability) Validate() error {
|
|
if t.ObservedAtUnixMillis < 1 {
|
|
return fmt.Errorf("observed time is required")
|
|
}
|
|
return t.Volatility.Validate()
|
|
}
|
|
func (a FreshnessAssessment) Validate() error {
|
|
if a.SourceKnowledgeRef == "" || a.TaskRef == "" || a.State == "" || a.AgeMillis < 0 || a.AssessedAtUnixMillis < 1 {
|
|
return fmt.Errorf("freshness assessment is incomplete")
|
|
}
|
|
return nil
|
|
}
|