proposal

type Change struct {
	// Label names the Service the pin belongs to, as an operator reads
	// it: "stack" or "stack/service". It titles the change and seeds the
	// branch name.
	Label string
	// RepositoryPath is the Compose file's path inside the repository.
	RepositoryPath string
	// ExpectedContent is the live reviewed document. A repository whose
	// base branch holds something else has drifted, and the Proposal is
	// refused rather than opened against unknown content.
	ExpectedContent string
	// ProposedContent is the same document with one image pinned.
	ProposedContent string
	// Digest is the digest being pinned.
	Digest string
}

type Port interface {
	Propose(change Change) (Result, error)
	// BranchExists reports whether any Proposal branch for the label is on
	// the forge, so an interrupted Proposal request can be proven settled.
	BranchExists(label string) (bool, error)
}

type Result struct {
	URL     string
	Created bool
}