schema

type AnalysisOutput struct {
	SchemaVersion    string                         `json:"schema_version"`
	Subject          string                         `json:"subject"`
	Confidence       float64                        `json:"confidence"`
	ConfidenceNote   string                         `json:"confidence_note,omitempty"`
	External         []string                       `json:"external"`
	MustRead         []MustReadEntry                `json:"must_read"`
	MustReadNote     string                         `json:"must_read_note,omitempty"`
	LikelyModify     map[string][]LikelyModifyEntry `json:"likely_modify"`
	LikelyModifyNote string                         `json:"likely_modify_note,omitempty"`
	Tests            []TestEntry                    `json:"tests"`
	TestsNote        string                         `json:"tests_note,omitempty"`
	Related          map[string][]RelatedEntry      `json:"related"`
	RelatedNote      string                         `json:"related_note,omitempty"`
	BlastRadius      *BlastRadius                   `json:"blast_radius,omitempty"`
	Hotspots         []string                       `json:"hotspots,omitempty"`
	CircularDeps     [][]string                     `json:"circular_deps,omitempty"`
	Stats            *IndexStats                    `json:"stats,omitempty"`
}

type BlastRadius struct {
	Level     string  `json:"level"`
	Detail    string  `json:"detail"`
	Fragility float64 `json:"fragility,omitempty"`
}

type ChangeReport struct {
	SchemaVersion string `json:"schema_version"`

	// The git ref range analyzed (e.g., "main..HEAD").
	RefRange string `json:"ref_range"`

	// Files changed in the diff.
	ChangedFiles []ChangedFile `json:"changed_files"`

	// Summary statistics about the change.
	Summary ChangeSummary `json:"summary"`

	// Aggregated blast radius across all changed files.
	BlastRadius *BlastRadius `json:"blast_radius"`

	// Combined must_read: files required to understand all changes.
	MustRead []MustReadEntry `json:"must_read"`

	// Combined likely_modify: additional files likely needing changes.
	LikelyModify map[string][]LikelyModifyEntry `json:"likely_modify"`

	// Combined test coverage for all changed files.
	Tests []TestEntry `json:"tests"`

	// Cross-file coupling: pairs of changed files that are structurally connected.
	Coupling []CouplingPair `json:"coupling,omitempty"`

	// Aggregated hotspots across all changed files.
	Hotspots []string `json:"hotspots,omitempty"`

	// Circular dependencies involving changed files.
	CircularDeps [][]string `json:"circular_deps,omitempty"`

	// Test coverage gaps: changed files with no direct test coverage.
	TestGaps []string `json:"test_gaps,omitempty"`

	// Hidden coupling: co-change partners not in the diff.
	HiddenCoupling []HiddenCouplingEntry `json:"hidden_coupling,omitempty"`

	// Index stats at time of analysis.
	Stats *IndexStats `json:"stats,omitempty"`
}

type ChangeSummary struct {
	TotalFiles    int `json:"total_files"`
	Added         int `json:"added"`
	Modified      int `json:"modified"`
	Deleted       int `json:"deleted"`
	Renamed       int `json:"renamed"`
	IndexedFiles  int `json:"indexed_files"`
	TestFiles     int `json:"test_files"`
	HighRiskFiles int `json:"high_risk_files"`
}

type ChangedFile struct {
	File   string `json:"file"`
	Status string `json:"status"`

	// Per-file blast radius (nil for deleted/unindexed files).
	BlastRadius *BlastRadius `json:"blast_radius,omitempty"`

	// Whether this file is indexed (new files may not be).
	Indexed bool `json:"indexed"`
}

type CouplingPair struct {
	FileA     string `json:"file_a"`
	FileB     string `json:"file_b"`
	Direction string `json:"direction"`
}

type ExternalDependency struct {
	Specifier  string `json:"specifier"`
	Reason     string `json:"reason"`
	LineNumber int    `json:"line_number"`
}

type HiddenCouplingEntry struct {
	ChangedFile string `json:"changed_file"`
	Partner     string `json:"partner"`
	Frequency   int    `json:"frequency"`
}

type IndexStats struct {
	TotalFiles      int `json:"total_files"`
	TotalEdges      int `json:"total_edges"`
	UnresolvedCount int `json:"unresolved_count"`
}

type LikelyModifyEntry struct {
	File       string   `json:"file"`
	Confidence string   `json:"confidence"`
	Signals    []string `json:"signals"`
	Symbols    []string `json:"symbols,omitempty"`
	Role       string   `json:"role,omitempty"`
}

type MustReadEntry struct {
	File        string   `json:"file"`
	Symbols     []string `json:"symbols,omitempty"`
	Definitions []string `json:"definitions,omitempty"`
	Stable      bool     `json:"stable,omitempty"`
	Direction   string   `json:"direction,omitempty"`
	Role        string   `json:"role,omitempty"`
	Circular    bool     `json:"circular,omitempty"`
}

type RelatedEntry struct {
	File    string   `json:"file"`
	Signals []string `json:"signals"`
}

type TestEntry struct {
	File   string `json:"file"`
	Direct bool   `json:"direct"`
}