status

type CategoryBreakdown struct {
	Pass    int `json:"pass"`
	Partial int `json:"partial"`
	Fail    int `json:"fail"`
	Total   int `json:"total"`
}

type EvalStatus struct {
	Exists   bool   `json:"exists"`
	Decision string `json:"decision"` // pass, conditional, fail
	Findings struct {
		Critical int `json:"critical"`
		High     int `json:"high"`
		Medium   int `json:"medium"`
		Low      int `json:"low"`
		Info     int `json:"info"`
	} `json:"findings"`
	// Categories breakdown from rubric evaluation
	Categories *CategoryBreakdown `json:"categories,omitempty"`
}

type Finding struct {
	Spec        types.SpecType `json:"spec"`
	Severity    string         `json:"severity"` // critical, high, medium, low, info
	Description string         `json:"description"`
}

type GraphMetrics struct {
	TotalRequirements int     `json:"total_requirements"`
	TotalUserStories  int     `json:"total_user_stories"`
	TotalConstraints  int     `json:"total_constraints"`
	TotalDecisions    int     `json:"total_decisions"`
	TraceCoverage     float64 `json:"trace_coverage"` // Percentage of requirements traced to TRD
	ConflictCount     int     `json:"conflict_count"`
	GraphPath         string  `json:"graph_path,omitempty"`
}

type KeyDecision struct {
	Area   string `json:"area"`   // e.g., "Local Dev", "Cloud", "IaC"
	Choice string `json:"choice"` // e.g., "AWS with Pulumi Go SDK"
}

type PipelineStage struct {
	Type   types.SpecType `json:"type"`
	Status StageStatus    `json:"status"` // complete, pending, missing
	Label  string         `json:"label"`  // Display label (e.g., "MRD", "spec.md")
}

type Report struct {
	Project      string                `json:"project"`
	Path         string                `json:"path"`
	GeneratedAt  time.Time             `json:"generated_at"`
	Readiness    types.ReadinessStatus `json:"readiness"`
	Specs        []SpecStatus          `json:"specs"`
	Summary      Summary               `json:"summary"`
	GraphMetrics *GraphMetrics         `json:"graph_metrics,omitempty"`
}

type RichReport struct {
	*Report

	// Pipeline is the ordered list of specs with their statuses for visualization.
	Pipeline []PipelineStage `json:"pipeline"`

	// AggregateCategories is the total category breakdown across all specs.
	AggregateCategories CategoryBreakdown `json:"aggregate_categories"`

	// CompletionPercent is the percentage of specs that are complete.
	CompletionPercent int `json:"completion_percent"`

	// Highlights maps spec type to a brief highlight string (LLM-generated).
	// Example: "MRD" -> "Market analysis, competitive positioning"
	Highlights map[types.SpecType]string `json:"highlights,omitempty"`

	// MediumFindings is a list of non-blocking medium-severity findings (LLM-generated).
	MediumFindings []Finding `json:"medium_findings,omitempty"`

	// NextSteps is a prioritized list of recommended next actions (LLM-generated).
	NextSteps []string `json:"next_steps,omitempty"`

	// KeyDecisions are important architectural/design decisions extracted from specs (LLM-generated).
	KeyDecisions []KeyDecision `json:"key_decisions,omitempty"`

	// ReadySummary is a one-line summary of readiness state (LLM-generated).
	ReadySummary string `json:"ready_summary,omitempty"`
}

type SpecStatus struct {
	Type       types.SpecType     `json:"type"`
	Category   types.SpecCategory `json:"category"`
	Filename   string             `json:"filename"`
	Exists     bool               `json:"exists"`
	Required   bool               `json:"required"`
	Status     types.SpecStatus   `json:"status"`
	EvalStatus *EvalStatus        `json:"eval_status,omitempty"`
	Approval   *types.Approval    `json:"approval,omitempty"`
}

type StageStatus string

type Summary struct {
	TotalSpecs     int `json:"total_specs"`
	PresentSpecs   int `json:"present_specs"`
	EvaluatedSpecs int `json:"evaluated_specs"`
	ApprovedSpecs  int `json:"approved_specs"`
	BlockingIssues int `json:"blocking_issues"`
}