core

type ApprovalArtifact struct {
	Path string `json:"path"`
	Hash string `json:"hash"`
}

type ApprovalHandoff struct {
	HumanApprovalRequired bool               `json:"humanApprovalRequired"`
	Gate                  string             `json:"gate"`
	Findings              []gates.Finding    `json:"findings"`
	ReviewedArtifacts     []ApprovalArtifact `json:"reviewedArtifacts"`
	HumanInstruction      string             `json:"humanInstruction"`
	Assurance             string             `json:"assurance"`
}

type ApprovalIdentity struct {
	Artifacts     []ApprovalArtifact `json:"artifacts"`
	AggregateHash string             `json:"aggregate_hash"`
}

type ApprovalOperationFacts struct {
	Operation       string `json:"operation"`
	HumanOnly       bool   `json:"humanOnly"`
	AgentCallable   bool   `json:"agentCallable"`
	CreatesEvidence bool   `json:"createsEvidence"`
	Assurance       string `json:"assurance"`
}

type ApprovalRecord struct {
	SchemaVersion   int                `json:"schema_version"`
	ID              string             `json:"id"`
	Change          string             `json:"change"`
	Gate            string             `json:"gate"`
	LifecycleFrom   Lifecycle          `json:"lifecycle_from"`
	LifecycleTo     Lifecycle          `json:"lifecycle_to"`
	Approver        string             `json:"approver"`
	ActorClass      string             `json:"actor_class"`
	Artifacts       []ApprovalArtifact `json:"artifacts"`
	AggregateHash   string             `json:"aggregate_hash"`
	RegistryVersion string             `json:"registry_version"`
	PolicyDigest    string             `json:"policy_digest"`
	RevisionBefore  uint64             `json:"revision_before"`
	RevisionAfter   uint64             `json:"revision_after"`
	Timestamp       string             `json:"timestamp"`
	Reason          string             `json:"reason"`
	Assurance       string             `json:"assurance"`
}

type ApprovalRoute string

type ApprovalStatus struct {
	Change           string          `json:"change"`
	Current          bool            `json:"current"`
	Approval         *ApprovalRecord `json:"approval,omitempty"`
	BlockingArtifact string          `json:"blocking_artifact,omitempty"`
	Reason           string          `json:"reason,omitempty"`
	Recovery         string          `json:"recovery,omitempty"`
}

type ApproveIntent struct {
	GitEmail, EnvironmentApprover string
	ClaimedApprover, Reason       string
	Interactive, Confirmed        bool
	Route                         ApprovalRoute
	AfterHistory                  func() error
}

type ArchiveOptions struct {
	Actor string
	Now   time.Time
	Hook  persist.Hook
}

type ArchiveResult struct {
	SchemaVersion  int      `json:"schema_version"`
	Change         string   `json:"change"`
	Source         string   `json:"source"`
	Target         string   `json:"target"`
	ChangeHash     string   `json:"change_hash"`
	Accepted       []string `json:"accepted"`
	EvidenceSet    string   `json:"evidence_set"`
	Approver       string   `json:"approver"`
	SyncRecord     string   `json:"sync_record"`
	TransactionID  string   `json:"transaction"`
	HistoryID      string   `json:"history_id"`
	RevisionBefore uint64   `json:"revision_before"`
	RevisionAfter  uint64   `json:"revision_after"`
}

type Attempt = record.AttemptPayload

type AttemptRequest struct {
	TaskID           string
	Authority        TaskTransitionAuthority
	ExpectedRevision uint64
	AfterHistory     func() error
}

type CheckResult struct {
	Root            string          `json:"root"`
	Change          string          `json:"change"`
	StateRevision   uint64          `json:"stateRevision"`
	RegistryVersion string          `json:"registryVersion"`
	PolicyDigest    string          `json:"policyDigest"`
	Findings        []gates.Finding `json:"findings"`
	Success         bool            `json:"success"`
}

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

type CompleteRequest struct {
	TaskID           string
	ExpectedRevision uint64
	Authority        CompletionAuthority
	// Profile is empty for the default loop. Production adds blockers on top of
	// every core guard below; it never replaces or relaxes one.
	Profile          string
	PolicyTransition *PolicyTransition
	BeforeHistory    func() error
	AfterHistory     func() error
}

type Completion struct {
	SchemaVersion  int    `json:"schema_version"`
	Change         string `json:"change"`
	TaskID         string `json:"task"`
	AttemptID      string `json:"attempt"`
	EvidenceID     string `json:"evidence"`
	RevisionBefore uint64 `json:"revision_before"`
	RevisionAfter  uint64 `json:"revision_after"`
	HistoryID      string `json:"history_id"`
}

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

type Friction = record.FrictionPayload

type FrictionEligibility struct {
	Domain   string `json:"domain"`
	Records  int    `json:"records"`
	Eligible bool   `json:"eligible"`
}

type FrictionRequest struct {
	TaskID           string
	Operation        string
	Domain           string
	Consequence      string
	Actor            string
	ExpectedRevision uint64
}

type Lifecycle string

type Operation struct {
	ID      string          `json:"id"`
	Summary string          `json:"summary"`
	Actor   OperationActor  `json:"actor"`
	Effect  OperationEffect `json:"effect"`
	// Lifecycles is the set of change lifecycle stages the operation applies
	// to. It is empty exactly when the operation resolves no existing change.
	Lifecycles []Lifecycle `json:"lifecycles"`
	// RequiresChange means the operation resolves an existing change and its
	// harness-owned state; `new` names a change but creates it, so it is false.
	RequiresRoot    bool                `json:"requiresRoot"`
	RequiresChange  bool                `json:"requiresChange"`
	RequiresTask    bool                `json:"requiresTask"`
	AuthoritySource string              `json:"authoritySource"`
	ScopeSource     string              `json:"scopeSource"`
	Arguments       []OperationArgument `json:"arguments"`
	Flags           []OperationFlag     `json:"flags"`
	Exits           []OperationExit     `json:"exits"`
	ResultType      string              `json:"resultType,omitempty"`
	AgentVisible    bool                `json:"agentVisible"`
	// Executable is false for a registered contract whose handler does not
	// exist yet. A non-executable entry can never be dispatched or advertised
	// as callable.
	Executable bool `json:"executable"`
	// Example is display data only. It is never parsed, expanded, or executed.
	Example string `json:"example"`
}

type OperationActor string

type OperationArgument struct {
	Name        string `json:"name"`
	Required    bool   `json:"required"`
	Description string `json:"description"`
}

type OperationEffect string

type OperationExit struct {
	Code    int    `json:"code"`
	Class   string `json:"class"`
	Meaning string `json:"meaning"`
}

type OperationFact struct {
	Field string `json:"field"`
	Value string `json:"value"`
}

type OperationFacts struct {
	SchemaVersion int         `json:"schemaVersion"`
	Operations    []Operation `json:"operations"`
}

type OperationFlag struct {
	Name        string   `json:"name"`
	Type        string   `json:"type"`
	Required    bool     `json:"required,omitempty"`
	Enum        []string `json:"enum,omitempty"`
	Default     string   `json:"default,omitempty"`
	Description string   `json:"description"`
}

type Policy struct {
	Profile            Profile
	FullDesign         bool
	BidirectionalTrace bool
	AcceptanceReach    bool
	RequiredChecks     []evidence.RequiredCheck
}

type PolicyTransition struct {
	From     string
	To       string
	Approver string
	Reason   string
}

type Profile string

type Readiness string

type ReadinessBlocker struct {
	Code   string `json:"code"`
	Owner  string `json:"owner"`
	Action string `json:"action"`
}

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

type ReadinessOutcome struct {
	Classification string            `json:"classification"`
	Blocker        *ReadinessBlocker `json:"blocker,omitempty"`
}

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

type ScopeResult struct {
	AttemptID     string   `json:"attempt_id"`
	BaselineHEAD  string   `json:"baseline_head"`
	ChangedPaths  []string `json:"changed_paths"`
	DeclaredFiles []string `json:"declared_files"`
	Assurance     string   `json:"assurance"`
	Valid         bool     `json:"valid"`
}

type StartAttemptIntent struct {
	TaskID           string
	ExpectedRevision uint64
	Actor            string
}

type SyncCapability struct {
	Capability string `json:"capability"`
	Path       string `json:"path"`
	Before     string `json:"before,omitempty"`
	After      string `json:"after"`
	Created    bool   `json:"created"`
	NoOp       bool   `json:"no_op"`
}

type SyncOptions struct {
	GitEmail, EnvironmentApprover string
	ClaimedApprover, Reason       string
	Route                         ApprovalRoute
	Interactive, Confirmed        bool
	Now                           time.Time
	Hook                          persist.Hook
}

type SyncResult struct {
	SchemaVersion  int              `json:"schema_version"`
	Change         string           `json:"change"`
	Approver       string           `json:"approver"`
	PlanHash       string           `json:"plan_hash"`
	EvidenceSet    string           `json:"evidence_set"`
	Capabilities   []SyncCapability `json:"capabilities"`
	TransactionID  string           `json:"transaction,omitempty"`
	HistoryID      string           `json:"history_id"`
	ArchiveTarget  string           `json:"archive_target"`
	RevisionBefore uint64           `json:"revision_before"`
	RevisionAfter  uint64           `json:"revision_after"`
	NoOp           bool             `json:"no_op"`
}

type TaskActivity string

type TaskActivityProjection struct {
	ID       string       `json:"id"`
	Activity TaskActivity `json:"activity"`
}

type TaskActivityRefusal struct {
	*failure.Refusal
	Owner string
}

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

type TaskGraphRefusal struct {
	*failure.Refusal
	Owner string
}

type TaskReadiness struct {
	ID           string            `json:"id"`
	Activity     TaskActivity      `json:"activity"`
	Readiness    Readiness         `json:"readiness"`
	Wave         int               `json:"wave"`
	Dependencies []string          `json:"dependencies"`
	Blocker      *ReadinessBlocker `json:"blocker,omitempty"`
}

type TaskTransition struct {
	SchemaVersion int          `json:"schema_version"`
	TaskID        string       `json:"task"`
	From          TaskActivity `json:"from"`
	To            TaskActivity `json:"to"`
}

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

type TaskTransitionRequest struct {
	TaskID           string
	To               TaskActivity
	Authority        TaskTransitionAuthority
	ExpectedRevision uint64
	AfterHistory     func() error
}