effects

type Capture struct {
	Mode       string `json:"mode"`
	SourceRef  string `json:"source_ref,omitempty"`
	CapturedAt string `json:"captured_at"`
}

type CaptureRequest struct {
	ResourceKind     string
	Path             string
	URL              string
	Reference        string
	Now              time.Time
	Client           *http.Client
	AllowUnsafeLocal bool
	Resolve          func(string) ([]net.IP, error)
	Dial             func(context.Context, string, string) (net.Conn, error)
}

type CaptureResult struct {
	Observation Observation `json:"observation"`
	Complete    bool        `json:"complete"`
	Reason      string      `json:"reason,omitempty"`
}

type Collector struct {
	Name    string `json:"name"`
	Version string `json:"version"`
	Mode    string `json:"mode"`
}

type ComposeRunOptions struct {
	ComposeFile              string
	Project                  string
	WorkingDir               string
	DockerBinary             string
	Service                  string
	MountedPath              string
	ProxyURL                 string
	Reset                    []string
	Seed                     []string
	Run                      []string
	Diff                     []string
	Accept                   []string
	Repeat                   []string
	Timeout                  time.Duration
	Now                      time.Time
	Capture                  func(CaptureRequest) (CaptureResult, error)
	PostgresCollector        func(context.Context) (CaptureResult, error)
	PostgresReference        string
	PostgresCollectorCommand []string
}

type ComposeRunResult struct {
	Status       string          `json:"status"`
	ReasonCodes  []string        `json:"reason_codes,omitempty"`
	Project      string          `json:"project"`
	ComposeFile  string          `json:"compose_file"`
	Observations []CaptureResult `json:"observations,omitempty"`
	Before       []CaptureResult `json:"before,omitempty"`
	After        []CaptureResult `json:"after,omitempty"`
	Changed      bool            `json:"changed,omitempty"`
	Commands     []string        `json:"commands,omitempty"`
}

type Contract struct {
	SchemaID      string      `json:"schema_id"`
	SchemaVersion string      `json:"schema_version"`
	ContractID    string      `json:"contract_id"`
	Name          string      `json:"name"`
	Predicates    []Predicate `json:"predicates"`
}

type Correlation struct {
	ActionDigest     string   `json:"action_digest,omitempty"`
	ActivationDigest string   `json:"activation_digest,omitempty"`
	ProofDigest      string   `json:"proof_digest,omitempty"`
	RunID            string   `json:"run_id,omitempty"`
	LifecycleID      string   `json:"lifecycle_id,omitempty"`
	ProofRefs        []string `json:"proof_refs,omitempty"`
}

type CorrelationExpectation struct {
	ActionDigest     string
	ActivationDigest string
	ProofDigest      string
}

type GradeOptions struct {
	TrustedCollectorPublicKey ed25519.PublicKey
	// AllowFixtureTestProvenance is reserved for the committed fixture generator
	// and package tests; the production CLI does not expose this bypass.
	AllowFixtureTestProvenance bool
	ExpectedCorrelation        *CorrelationExpectation
}

type GradeResult struct {
	SchemaID       string                `json:"schema_id"`
	SchemaVersion  string                `json:"schema_version"`
	ContractID     string                `json:"contract_id"`
	SnapshotID     string                `json:"snapshot_id"`
	Status         string                `json:"status"`
	EvidenceStatus string                `json:"evidence_status"`
	ReasonCodes    []string              `json:"reason_codes"`
	Evaluations    []PredicateEvaluation `json:"evaluations"`
}

type Observation struct {
	State        string   `json:"state"`
	Digest       string   `json:"digest,omitempty"`
	Count        *int64   `json:"count,omitempty"`
	Identity     string   `json:"identity,omitempty"`
	Owner        string   `json:"owner,omitempty"`
	TTLSeconds   *int64   `json:"ttl_seconds,omitempty"`
	ObservedAt   string   `json:"observed_at"`
	EvidenceRefs []string `json:"evidence_refs,omitempty"`
}

type Predicate struct {
	ID       string `json:"id"`
	Kind     string `json:"kind"`
	Field    string `json:"field"`
	Operator string `json:"operator,omitempty"`
	Expected any    `json:"expected,omitempty"`
}

type PredicateEvaluation struct {
	ID          string   `json:"id"`
	Kind        string   `json:"kind"`
	Field       string   `json:"field"`
	Status      string   `json:"status"`
	ReasonCodes []string `json:"reason_codes,omitempty"`
	Observed    any      `json:"observed,omitempty"`
	Expected    any      `json:"expected,omitempty"`
}

type Provenance struct {
	Mode      string              `json:"mode"`
	PublicKey string              `json:"public_key"`
	Signature proofsign.Signature `json:"signature"`
}

type Redaction struct {
	Mode   string   `json:"mode"`
	Fields []string `json:"fields,omitempty"`
}

type Selector struct {
	Resource string            `json:"resource"`
	Scope    string            `json:"scope,omitempty"`
	Name     string            `json:"name,omitempty"`
	Path     string            `json:"path,omitempty"`
	URL      string            `json:"url,omitempty"`
	Labels   map[string]string `json:"labels,omitempty"`
}

type Snapshot struct {
	SchemaID               string      `json:"schema_id"`
	SchemaVersion          string      `json:"schema_version"`
	SnapshotID             string      `json:"snapshot_id"`
	ResourceKind           string      `json:"resource_kind"`
	Selector               Selector    `json:"selector"`
	Before                 Observation `json:"before"`
	After                  Observation `json:"after"`
	Collector              Collector   `json:"collector"`
	Capture                Capture     `json:"capture"`
	Redaction              Redaction   `json:"redaction"`
	Correlation            Correlation `json:"correlation"`
	Provenance             Provenance  `json:"provenance"`
	Completeness           string      `json:"completeness"`
	Enforcement            string      `json:"enforcement"`
	EvidenceRefs           []string    `json:"evidence_refs,omitempty"`
	CanonicalContentDigest string      `json:"canonical_content_digest"`
}

type ValidationResult struct {
	Valid       bool     `json:"valid"`
	ReasonCodes []string `json:"reason_codes,omitempty"`
}