package capability

type ReflexID string
type ReflexLifecycle string
type ReflexKind string

const (
	ReflexCandidate         ReflexLifecycle = "CANDIDATE"
	ReflexValidating        ReflexLifecycle = "VALIDATING"
	ReflexActive            ReflexLifecycle = "ACTIVE"
	ReflexDegraded          ReflexLifecycle = "DEGRADED"
	ReflexStale             ReflexLifecycle = "STALE"
	ReflexRevalidating      ReflexLifecycle = "REVALIDATING"
	ReflexSuspended         ReflexLifecycle = "SUSPENDED"
	ReflexRetired           ReflexLifecycle = "RETIRED"
	ReflexDeterministicCode ReflexKind      = "DETERMINISTIC_CODE"
	ReflexRule              ReflexKind      = "RULE"
	ReflexWorkflow          ReflexKind      = "WORKFLOW"
	ReflexQueryTemplate     ReflexKind      = "QUERY_TEMPLATE"
	ReflexSmallModelChain   ReflexKind      = "SMALL_MODEL_CHAIN"
	ReflexBoundedAdapter    ReflexKind      = "BOUNDED_ADAPTER_OPERATION"
)

type ShadowPolicy struct {
	Enabled                  bool
	SampleRateMillis         int64
	ComparatorRef            string
	MaxShadowCostMicros      *int64
	EligibleErrorCostClasses []string
}
type RevalidationPolicy struct {
	MaxAgeMillis                         *int64
	RevalidateOnDependencyRevisionChange bool
	RevalidateOnWorldVersionChange       bool
	RevalidateAfterFailureCount          *int64
	RevalidateAfterCorrectionCount       *int64
	SampleAuditRateMillis                *int64
}
type Reflex struct {
	ID             ReflexID
	PrincipalID    string
	SourceSkillRef SkillID
	CreatedAt      int64
}
type ReflexRevision struct {
	ReflexID                   ReflexID
	Revision                   int64
	SourceSkillRevision        int64
	Kind                       ReflexKind
	Applicability              ApplicabilitySpec
	ImplementationRef          string
	ImplementationVersion      string
	ArtifactDigest             string
	DependencyRefs             []string
	ValidationEvidenceRefs     []SkillEvidenceRef
	KnownFailureExperienceRefs []SkillEvidenceRef
	Shadow                     ShadowPolicy
	Revalidation               RevalidationPolicy
	LastValidatedAt            int64
	Lifecycle                  ReflexLifecycle
	RecordedAt                 int64
	SupersedesRevision         int64
	ExecutionCount             int64
	FailureCount               int64
	DivergenceCount            int64
}

// ShadowComparison is evidence produced by a bounded shadow sample. It is not
// permission to rewrite a Reflex; SELF/governed evaluation decide next steps.
type ShadowComparison struct {
	ReflexID       ReflexID
	ReflexRevision int64
	EvidenceRefs   []SkillEvidenceRef
	VerifierPassed bool
	Diverged       bool
	ObservedAt     int64
}