reviewgate

type Changes struct {
	Root  string
	Repos []RepoChanges
}

type HeldPush struct {
	// Repo is the top-level directory of the repository pushed from.
	Repo string `json:"repo"`
	// Remote is the remote name git was given, or the URL when the push
	// named one directly. URL is where git would have pushed.
	Remote string `json:"remote"`
	URL    string `json:"url,omitempty"`
	// Src is the source as git passed it ("HEAD", "refs/heads/main"); empty
	// for a deletion. SrcRef is the ref it named when held ("" when it named
	// a commit), SrcSHA the object it resolved to then.
	Src    string `json:"src,omitempty"`
	SrcRef string `json:"src_ref,omitempty"`
	SrcSHA string `json:"src_sha,omitempty"`
	// Dst is the ref on the remote ("refs/heads/main").
	Dst string `json:"dst"`
	// Force reports a forced update; Expect is the value git was shown for
	// Dst, which a replay leases against.
	Force  bool   `json:"force,omitempty"`
	Expect string `json:"expect,omitempty"`
	// At is when git asked.
	At time.Time `json:"at"`
}

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

type Input struct {
	Goal         string
	Conventions  string // the project's instructions to its agents
	TaskID       int
	TaskTitle    string
	TaskDesc     string
	AgentReport  string // the agent's final message
	Changes      *Changes
	Instructions string // the operator's extra review criteria
	// Round is 1 for the first review; later rounds follow a fix turn and
	// carry what the previous round asked for.
	Round         int
	PriorFindings []pm.ReviewFinding
	PriorSummary  string
	// CanReadFiles tells the reviewer it may open files for context, which
	// is true for a harness reviewer given read-only tools.
	CanReadFiles bool
}

type RepoChanges struct {
	// Dir is the repository's top-level directory; Rel the same relative to
	// the project ("." for the project's own repository).
	Dir string
	Rel string
	// Base is the commit the diff starts from ("" means the empty tree: the
	// whole repository is new). Head is HEAD when the changes were collected
	// ("" before the first commit).
	Base string
	Head string
	// Branch is the checked-out branch ("" when HEAD is detached).
	Branch string
	// Tree is the tree `git add -A` would commit from the working state. It
	// is what a merge performed after the review must match.
	Tree string
	// Commits lists Base..Head, newest first ("<short sha> <subject>");
	// CommitCount is the full count.
	Commits     []string
	CommitCount int
	// Files, Insertions and Deletions summarise the diff, untracked files
	// included.
	Files      int
	Insertions int
	Deletions  int
	// Uncommitted reports changes in the working tree that are not in Head.
	Uncommitted bool
	// CloopFiles lists changed paths under .cloop/, which are cloop's own
	// bookkeeping and shown by name only.
	CloopFiles []string
	// Diff is the unified diff of the working tree against Base, with new
	// untracked files rendered as additions. Truncated reports it was cut.
	Diff      string
	Truncated bool
	// Held are the pushes the agent attempted from this repository.
	Held []HeldPush
}

type Reviewer struct {
	Provider provider.Provider
	// ProviderName and Model name it for the record. Model is passed to
	// the provider; empty means the provider's default.
	ProviderName string
	Model        string
	Effort       string
	Timeout      time.Duration
}

type Round struct {
	// Verdict is nil when Err is set.
	Verdict *Verdict
	Err     error
	// Tokens the reviewer spent, and the model the provider reports.
	InputTokens  int
	OutputTokens int
	Model        string
}

type Snapshot struct {
	// Root is the directory the task works in.
	Root string
	// Heads maps each repository's top-level directory to its HEAD commit
	// ("" for a repository with no commits yet).
	Heads map[string]string
}

type Verdict struct {
	Approved bool
	Summary  string
	Findings []pm.ReviewFinding
}