review

type Credential struct {
	EnvVar string
	Value  string
}

type DetachSpec struct {
	RunID       string
	RepoPath    string // checkout on the primary
	OrgID       string
	PromptsDir  string // relative to RepoPath; empty for the default
	Parallelism int
	Model       string
	Timeout     time.Duration
	Image       string // snapshot for the primary's reviewer sidecars; empty for its config default
	DestroyPool bool   // delete the primary's reviewer sidecars when the review ends
	// Install is a shell fragment that puts chunk at $HOME/chunk, run before
	// the review starts. Empty when the binary is already there.
	Install string
}

type Execer func(ctx context.Context, entry *sidecar.PoolEntry, script string, env map[string]string, onOutput circleci.OutputFn, onSubmitted func(commandID string)) (exitCode int, err error)

type Finding struct {
	// ID is unique within a run. The daemon assigns it; a review's own output
	// does not carry one.
	ID string `json:"id,omitempty"`
	// Prompt names the review that reported it.
	Prompt string `json:"prompt,omitempty"`
	// File is a repository-relative path with forward slashes.
	File string `json:"file"`
	// Line is the 1-based line the finding is about; zero means the file as a
	// whole or a line the reviewer did not give.
	Line     int    `json:"line,omitempty"`
	Severity string `json:"severity"`
	Body     string `json:"body"`
	// Patch is an optional unified diff that would fix the finding.
	Patch string `json:"patch,omitempty"`
}

type Options struct {
	Credential Credential
	// BaseURL is forwarded to claude when it is not Anthropic's own, so a
	// credential issued by a gateway is sent to that gateway.
	BaseURL    string
	Model      string        // optional; claude's default when empty
	Timeout    time.Duration // per review; DefaultTimeout when zero
	StatusFn   iostream.StatusFunc
	ProgressFn func(ProgressEvent) // optional; called on each prompt state change
	// StructuredFindings runs each review with FindingsSchema as its
	// --json-schema, parses the findings into Result.Parsed and puts the prose
	// in Result.Output. A review whose answer has no structured output fails.
	// Off, Result.Parsed stays empty.
	StructuredFindings bool
	// AllowedTools overrides the read-only tool set. Empty means read-only, which
	// is what every review uses.
	AllowedTools []string
	// OnSubmitted is called once per prompt with the remote command ID, as soon
	// as the exec is accepted and before its output is streamed. It is how a
	// caller registers the run for output replay, which has to happen while the
	// command is still in flight.
	OnSubmitted func(entry *sidecar.PoolEntry, prompt, commandID string)
}

type Parsed struct {
	// Findings are the valid findings, in the order given, at most MaxFindings.
	Findings []Finding
	// Dropped counts entries that were present but unusable (no file, no body, a
	// path outside the repository) or over the cap.
	Dropped int
	// Prose is the review's prose.
	Prose string
}

type ProgressEvent struct {
	Prompt    string
	SidecarID string
	State     PromptState
	Duration  time.Duration
	Error     string
}

type Prompt struct {
	Name string
	Body string
}

type PromptState int

type Result struct {
	Prompt    string
	SidecarID string
	Output    string
	Error     string
	Duration  time.Duration
	// Parsed holds the structured findings when Options.StructuredFindings is
	// set.
	Parsed Parsed
}

type RunStatus struct {
	State    string // RunRunning, RunDone, RunMissing or RunDied
	ExitCode int    // meaningful when State is RunDone
	Body     string // the report when done, the log tail when running
	Log      string // the log tail when done
}