dispatch

type Actor struct {
	ID             string `json:"id"`
	Kind           string `json:"kind"`
	Role           string `json:"role"`
	IsEntityAuthor bool   `json:"is_entity_author"`
}

type ChangeProposalState struct {
	ID       int    `json:"id"`
	HeadRepo string `json:"head_repo"`
	BaseRepo string `json:"base_repo"`
	HeadRef  string `json:"head_ref"`
	BaseRef  string `json:"base_ref"`
	HeadSHA  string `json:"head_sha,omitempty"`
	AuthorID string `json:"author_id"`
	IsFork   bool   `json:"is_fork"`
}

type Dispatcher interface {
	// Name returns a human-readable identifier (e.g. "gcf").
	Name() string

	// Provision creates the dispatch infrastructure and returns
	// org-level variables to store (e.g. mint URL).
	Provision(ctx context.Context) (variables map[string]string, err error)

	// StoreAgentPEM persists a role's PEM key in the mint's secret store.
	// Called once per role during App setup so partial failures are survivable.
	StoreAgentPEM(ctx context.Context, role string, pem []byte) error

	// OrgSecretNames returns the names of org-level secrets this
	// dispatcher manages.
	OrgSecretNames() []string

	// OrgVariableNames returns the names of org-level variables this
	// dispatcher manages.
	OrgVariableNames() []string
}

type Entity struct {
	Kind                 string                `json:"kind"`
	ID                   int                   `json:"id"`
	URL                  string                `json:"url"`
	Key                  string                `json:"key,omitempty"`
	LinkedChangeProposal *LinkedChangeProposal `json:"linked_change_proposal,omitempty"`
}

type EventRouter interface {
	Route(event *NormalizedEvent) ([]string, error)
}

type LinkedChangeProposal struct {
	ID  int    `json:"id"`
	URL string `json:"url"`
}

type NormalizedEvent struct {
	Repo       string     `json:"repo"`
	Entity     Entity     `json:"entity"`
	Transition Transition `json:"transition"`
	Actor      Actor      `json:"actor"`
	State      State      `json:"state"`
	Source     Source     `json:"source"`
}

type Source struct {
	System    string `json:"system"`
	RawType   string `json:"raw_type"`
	RawAction string `json:"raw_action,omitempty"`
}

type State struct {
	Labels         []string             `json:"labels"`
	ChangeProposal *ChangeProposalState `json:"change_proposal,omitempty"`
}

type Transition struct {
	Kind    string             `json:"kind"`
	Label   *TransitionLabel   `json:"label,omitempty"`
	Comment *TransitionComment `json:"comment,omitempty"`
	Review  *TransitionReview  `json:"review,omitempty"`
}

type TransitionComment struct {
	Command     string `json:"command,omitempty"`
	Body        string `json:"body"`
	Instruction string `json:"instruction,omitempty"`
}

type TransitionLabel struct {
	Name   string `json:"name"`
	Action string `json:"action"`
}

type TransitionReview struct {
	State      string `json:"state"`
	ReviewerID string `json:"reviewer_id"`
}