reviewplan

type Action struct {
	ActionID  string
	Kind      ActionKind
	FindingID review.FindingID
	ThreadID  string
	PlannedAt time.Time
	Status    ActionStatus
	Required  bool
	Marker    MarkerPlacement

	InlineComment *InlineCommentPayload
	ThreadReply   *ThreadReplyPayload
	ResolveThread *ResolveThreadPayload
	RollupComment *RollupCommentPayload
	SubmitReview  *SubmitReviewPayload
}

type ActionIDGenerator func(ActionKind) (string, error)

type ActionKind string

type ActionStatus string

type AggregateUsage struct {
	TokensIn          *int
	TokensOut         *int
	CacheRead         *int
	CacheCreate       *int
	CostUSD           *float64
	CostEstimated     bool
	ComputeDurationMS *int64
}

type AnchoredFinding struct {
	FindingID    review.FindingID
	Severity     review.Severity
	FilePath     string
	Anchoring    review.Anchoring
	Side         *review.DiffSide
	Line         *int
	DiffPosition *int
	Body         string
}

type Diff struct {
	Files []DiffFile
}

type DiffFile struct {
	OldPath string
	Path    string
	Binary  bool
	Deleted bool
	Hunks   []DiffHunk
}

type DiffHunk struct {
	OldStart     int
	OldEnd       int
	NewStart     int
	NewEnd       int
	FallbackSide review.DiffSide
	FallbackLine int
	DiffPosition int
}

type EventOptions struct {
	MajorEventRequestsChanges bool
	PostingIdentityIsPRAuthor bool
	AllowSelfApprove          bool
}

type InlineCommentPayload struct {
	Body         string
	Path         string
	Side         review.DiffSide
	Line         int
	SubjectType  review.AnchorKind
	DiffPosition int
}

type MarkerPlacement struct {
	BodyBearing   bool
	Skip          bool
	ThreadSummary bool
	ActionKind    ActionKind
	Outcome       Outcome
}

type Outcome string

type Plan struct {
	Outcome          Outcome
	RollupMarkdown   string
	Actions          []Action
	AnchoredFindings []AnchoredFinding
	// Summary is the derived rollup metadata the rendered markdown was
	// built from; dry-run JSON exposes the same object.
	Summary Summary
}

type PostMode string

type ProviderCaps struct {
	NativeFileLevelComments bool
	ThreadResolution        bool
}

type Request struct {
	PostMode PostMode

	ProviderCaps ProviderCaps
	Diff         Diff

	Findings      []review.Finding
	Rollup        review.Rollup
	ThreadActions []review.ThreadAction
	// ThreadResponses are lifecycle-domain replies/resolutions for existing
	// inline discussion threads.
	ThreadResponses []review.ThreadResponseAction
	EventOptions    EventOptions

	NoDiff                  bool
	Profile                 string
	PostingIdentity         string
	HeadSHA                 string
	AgentDefinitionsChanged bool
	IncludeNits             bool
	MaxInlineComments       int

	// RunSummary is the execution metadata rendered in the rollup footer.
	RunSummary RunSummary
	// FindingReviewers maps each finding to the reviewer agent ID that
	// produced it; findings absent from the map group as unattributed.
	FindingReviewers map[review.FindingID]string

	Now         func() time.Time
	NewActionID ActionIDGenerator
}

type ResolveThreadPayload struct{}

type ReviewerCoverageSummary struct {
	AgentID        string
	Status         string
	Scope          []string
	InspectedFiles []string
	SkippedFiles   []string
	Constraints    []string
	Diagnostic     string
}

type ReviewerFailureSummary struct {
	AgentID string
	Error   string
}

type ReviewerSummary struct {
	Name     string
	Findings int
}

type RollupCommentPayload struct {
	Body string
}

type RunSummary struct {
	// ToolVersion is the raw version string (e.g. "0.3.63"); the renderer
	// adds the "cr " prefix.
	ToolVersion       string
	Adapter           string
	Model             string
	PostingIdentity   string
	SelectedReviewers []string
	ReviewerFailures  []ReviewerFailureSummary
	ReviewerCoverage  []ReviewerCoverageSummary
	WallDurationMS    *int64
	Workstreams       []WorkstreamUsage
}

type SubmitReviewPayload struct {
	Body  string
	Event review.ReviewEvent
}

type Summary struct {
	Reviewers []ReviewerSummary
	Threads   ThreadCounts
	Run       RunSummary
	// Totals is derived from Run.Workstreams by Build; it lives here rather
	// than on the caller-supplied RunSummary so callers cannot populate a
	// value that Build would silently overwrite.
	Totals AggregateUsage
}

type ThreadCounts struct {
	Considered int
	Summarized int
	Resolved   int
}

type ThreadReplyPayload struct {
	Body    string
	Summary bool
}

type ThreadResponseRequest struct {
	PostMode     PostMode
	ProviderCaps ProviderCaps
	Responses    []review.ThreadResponseAction

	Now         func() time.Time
	NewActionID ActionIDGenerator
}

type WorkstreamUsage struct {
	Name        string
	Model       string
	TokensIn    *int
	TokensOut   *int
	CacheRead   *int
	CacheCreate *int
	CostUSD     *float64
	// CostEstimated is true when CostUSD was derived from token prices because
	// the adapter did not report a real cost.
	CostEstimated bool
	DurationMS    *int64
}