contract

type Bundle struct {
	Contract *Contract
	RawYAML  []byte // Original YAML bytes; populated for local reads.
	FS       fs.FS
}

type Capability struct {
	Type    string             `yaml:"type" json:"type"`
	Ref     string             `yaml:"ref,omitempty" json:"ref,omitempty"`         // extension only
	Binding *CapabilityBinding `yaml:"binding,omitempty" json:"binding,omitempty"` // standard types only
}

type CapabilityBinding struct {
	Type      string `yaml:"type" json:"type"`                     // "http" (the only supported transport)
	Interface string `yaml:"interface" json:"interface"`           // declared interface providing the address/port anchor
	Path      string `yaml:"path,omitempty" json:"path,omitempty"` // relative to the resolved endpoint; must start with "/" (INV-6)
}

type Configuration struct {
	Name     string         `yaml:"name" json:"name"`
	Schema   string         `yaml:"schema,omitempty" json:"schema,omitempty"`
	Ref      string         `yaml:"ref,omitempty" json:"ref,omitempty"`
	Values   map[string]any `yaml:"values,omitempty" json:"values,omitempty"`
	Required bool           `yaml:"required" json:"required"` // MANDATORY in schema; true = confirmed absence is a violation
}

type Contract struct {
	PactoVersion   string          `yaml:"pactoVersion" json:"pactoVersion"`
	Service        Service         `yaml:"service" json:"service"`
	Interfaces     []Interface     `yaml:"interfaces,omitempty" json:"interfaces,omitempty"`
	Configurations []Configuration `yaml:"configurations,omitempty" json:"configurations,omitempty"`
	Dependencies   []Dependency    `yaml:"dependencies,omitempty" json:"dependencies,omitempty"`
	State          *State          `yaml:"state,omitempty" json:"state,omitempty"`
	Workload       string          `yaml:"workload,omitempty" json:"workload,omitempty"`
	Capabilities   []Capability    `yaml:"capabilities,omitempty" json:"capabilities,omitempty"`
	Policies       []Policy        `yaml:"policies,omitempty" json:"policies,omitempty"`
	Readiness      *Readiness      `yaml:"readiness,omitempty" json:"readiness,omitempty"`
	Metadata       map[string]any  `yaml:"metadata,omitempty" json:"metadata,omitempty"`
	Extensions     map[string]any  `yaml:"extensions,omitempty" json:"extensions,omitempty"`
}

type Dependency struct {
	Name          string `yaml:"name" json:"name"`
	Ref           string `yaml:"ref" json:"ref"`
	Required      bool   `yaml:"required" json:"required"`
	Compatibility string `yaml:"compatibility" json:"compatibility"`
}

type Interface struct {
	Name       string `yaml:"name" json:"name"`
	Type       string `yaml:"type" json:"type"`
	Ref        string `yaml:"ref" json:"ref"`
	Visibility string `yaml:"visibility,omitempty" json:"visibility,omitempty"`
}

type OCIReference struct {
	Registry   string
	Repository string
	Tag        string
	Digest     string
}

type Owner struct {
	Team     string         `yaml:"team,omitempty" json:"team,omitempty"`
	DRI      string         `yaml:"dri,omitempty" json:"dri,omitempty"`
	Contacts []OwnerContact `yaml:"contacts,omitempty" json:"contacts,omitempty"`
}

type OwnerContact struct {
	Type    string `yaml:"type" json:"type"`
	Value   string `yaml:"value" json:"value"`
	Purpose string `yaml:"purpose,omitempty" json:"purpose,omitempty"`
}

type ParseError struct {
	Path    string
	Message string
	Err     error // underlying cause, if any
}

type Persistence struct {
	Scope      string `yaml:"scope" json:"scope"`
	Durability string `yaml:"durability" json:"durability"`
}

type Policy struct {
	Name   string `yaml:"name" json:"name"`
	Schema string `yaml:"schema,omitempty" json:"schema,omitempty"`
	Ref    string `yaml:"ref,omitempty" json:"ref,omitempty"`
	Target string `yaml:"target,omitempty" json:"target,omitempty"`
}

type Range struct {
	// contains filtered or unexported fields
}

type Readiness struct {
	// MinScore is the gate: the derived readiness score must be >= this value for
	// the contract to be considered ready. It is on the same 0..100 scale as the
	// score. Omitted means 100 (every weighted claim must be done); set lower to
	// tolerate partial completion. Enforced by `pacto validate --readiness` and
	// the operator.
	MinScore *int `yaml:"minScore,omitempty" json:"minScore,omitempty"`
	// Expires is the single assessment-level freshness boundary (YYYY-MM-DD).
	// After this date every in-scope claim earns zero weight and the gate fails.
	Expires string `yaml:"expires" json:"expires"`
	// PartialCredit is the fraction of a claim's weight earned when its status is
	// "partial". Omitted means 0.5.
	PartialCredit *float64 `yaml:"partialCredit,omitempty" json:"partialCredit,omitempty"`
	// History records the revision log of the readiness assessment.
	History []ReadinessRevision `yaml:"history,omitempty" json:"history,omitempty"`
	Claims  []ReadinessClaim    `yaml:"claims,omitempty" json:"claims,omitempty"`
}

type ReadinessClaim struct {
	ID          string `yaml:"id" json:"id"`
	Type        string `yaml:"type" json:"type"`
	Category    string `yaml:"category,omitempty" json:"category,omitempty"`
	Status      string `yaml:"status" json:"status"`
	Evidence    string `yaml:"evidence" json:"evidence"`
	Weight      int    `yaml:"weight" json:"weight"`
	Description string `yaml:"description,omitempty" json:"description,omitempty"`
}

type ReadinessRevision struct {
	Date        string `yaml:"date" json:"date"`
	Version     string `yaml:"version" json:"version"`
	Author      string `yaml:"author" json:"author"`
	Description string `yaml:"description" json:"description"`
}

type ReferenceRef struct {
	Kind string
	Name string
	Ref  string
}

type Service struct {
	Name    string `yaml:"name" json:"name"`
	Version string `yaml:"version" json:"version"`
	Owner   Owner  `yaml:"owner,omitempty" json:"owner,omitempty"`
}

type State struct {
	Type            string      `yaml:"type" json:"type"`
	Persistence     Persistence `yaml:"persistence" json:"persistence"`
	DataCriticality string      `yaml:"dataCriticality" json:"dataCriticality"`
}

type ValidationError struct {
	Path    string
	Code    string
	Message string
}

type ValidationWarning struct {
	Path    string
	Code    string
	Message string
}