report

type Block struct {
	Type    BlockType `json:"type"`
	ID      string    `json:"id"`
	Summary string    `json:"summary"`

	// Shared optional fields.
	Impact         string   `json:"impact,omitempty"`
	Recommendation string   `json:"recommendation,omitempty"`
	Details        string   `json:"details,omitempty"`
	RelatedFiles   []string `json:"related_files,omitempty"`

	// finding
	Importance string `json:"importance,omitempty"`

	// check
	Status           string `json:"status,omitempty"`
	Evidence         string `json:"evidence,omitempty"`
	Limitation       string `json:"limitation,omitempty"`
	RequiredToVerify string `json:"required_to_verify,omitempty"`

	// warning
	Severity string `json:"severity,omitempty"`

	// question, next
	Options              []Option `json:"options,omitempty"`
	ResponseType         string   `json:"response_type,omitempty"`
	RecommendationReason string   `json:"recommendation_reason,omitempty"`

	// unclassified
	ReasonUnclassified string `json:"reason_unclassified,omitempty"`
	SuggestedType      string `json:"suggested_type,omitempty"`
}

type BlockType string

type Choice struct {
	// Block indexes Report.Blocks; Option indexes that block's Options.
	Block, Option int
	// Number is what the user presses, 1-based. Options past the ninth get 0:
	// there is no key for them, so the card shows them without a number.
	Number int
}

type Line struct {
	Kind LineKind
	// Text is the whole line as plain text, indentation included.
	Text string
	// Indent is how many columns of Text are indentation, and Tag and Body
	// are the rest split where a painter styles them differently: the glyph
	// or "? next" before a summary, "Sends:" before an instruction. Tag is
	// empty on lines that have no such split, and Body is then the rest.
	Indent int
	Tag    string
	Body   string
	// Block is the index into Report.Blocks, or -1 for lines that belong to
	// no block.
	Block int
	// BlockID is that block's id, for callers that track selection by id.
	BlockID string
	// Option is the 1-based number of the option this line is about, or 0.
	Option int
	// More says the block has fields or details this rendering folds away,
	// which the card marks at the end of the row.
	More bool
	// Choices are the options a LineChoices line offers, in order.
	Choices []LineChoice
}

type LineChoice struct {
	Number int
	Label  string
	// Recommended says this option is the block's pick. Primary says it is
	// also the report's primary recommendation — the one the card highlights
	// as the pick. A secondary recommended block keeps Recommended without
	// Primary, so the card can paint it as an outline chip.
	Recommended bool
	Primary     bool
}

type LineKind int

type Option struct {
	ID          string `json:"id"`
	Label       string `json:"label"`
	Description string `json:"description,omitempty"`
	Consequence string `json:"consequence,omitempty"`
	Preview     string `json:"preview,omitempty"`
	Effect      string `json:"effect"`
	// Instruction is what a dispatch option sends as the next prompt. It is
	// shown in full on the card, so the user sees what picking it will do.
	Instruction string `json:"instruction,omitempty"`
}

type Options struct {
	// Expanded holds the ids of blocks whose details are shown.
	Expanded map[string]bool
	// ExpandAll shows every block's details, which is what a headless run and
	// the full viewer do.
	ExpandAll bool
	// HideNotRun collapses check blocks that ran nothing into a
	// one-line footnote, which is what the live card does: the check stays
	// mandatory, but a docs-only edit no longer spends two lines saying so.
	// ExpandAll or an entry in Expanded still shows the block in full, and
	// the scrollback transcript (which expands everything) is unaffected.
	HideNotRun bool
}

type Problem struct {
	Path    string `json:"path"`
	Code    string `json:"code"`
	Message string `json:"message"`
}

type Report struct {
	TaskStatus Status  `json:"task_status"`
	Headline   string  `json:"headline"`
	Blocks     []Block `json:"blocks"`
}

type Rules struct {
	// MaxBlocks bounds the block list. Zero selects DefaultMaxBlocks.
	MaxBlocks int
	// Mutated says whether the turn changed anything. It decides what
	// "completed" has to show: a turn that edited files says how it checked
	// them, while a turn that only read and explained is finished without a
	// check block. Demanding one of a question-answering turn is how the
	// explanation ends up inside a block that checked nothing.
	Mutated bool
}

type Status string