evidence

type GateEvidencePinRequest struct {
	GateDir         string
	RunID           string
	Round           int
	ReviewedHeadSHA *string
}

type GateEvidencePinResult struct {
	Ref    string
	SHA    string
	Pinned bool
}

type Request struct {
	// RepoDir is any non-bare worktree (or bare gate dir) of the repository.
	// Objects are written into its store and pushed from there; nothing is
	// checked out, so a detached HEAD or a shallow clone is fine - the orphan
	// branch shares no history with the shallow code branches.
	RepoDir string
	// PushURL is the remote the evidence branch is pushed to. It is the same
	// target the pipeline pushes the code branch to, so fork contributions
	// keep their evidence in the fork the PR head lives in.
	PushURL string
	// Branch is the evidence branch name (already normalized).
	Branch string
	// Dir is an optional directory prefix inside the evidence branch.
	Dir string
	// Segments are further in-branch directory segments below Dir, typically
	// the slugged code-branch name.
	Segments []string
	// SourceDir is the local directory holding the run's evidence files.
	SourceDir string
	// Message is the evidence commit message.
	Message string
	// ForbiddenBranches names branches that must never receive evidence (the
	// run's own branch and the repository default branch). The marker check
	// already refuses them; this turns the refusal into a message that names
	// the misconfiguration.
	ForbiddenBranches []string
}

type Result struct {
	// Branch is the evidence branch that now holds the files.
	Branch string
	// CommitSHA is the evidence commit to build stable links against.
	CommitSHA string
	// Dir is the in-branch directory the run's files live under, "" at root.
	Dir string
	// Files are the published paths relative to Dir, slash separated.
	Files []string
}