coordinate

type CRSRecorder interface {
	// RecordToolStep records a tool execution step in the CRS.
	RecordToolStep(ctx context.Context, toolName string, resultCount int, duration time.Duration, err error)
}

type ChangePlan struct {
	// ID is a unique identifier for this plan.
	ID string `json:"plan_id"`

	// GraphID is the ID of the graph this plan was created for.
	GraphID string `json:"graph_id,omitempty"`

	// Description explains the overall change.
	Description string `json:"description"`

	// PrimaryChange is the original change request.
	PrimaryChange ChangeRequest `json:"primary_change"`

	// FileChanges lists all changes needed across files.
	FileChanges []FileChange `json:"file_changes"`

	// Order lists file paths in the order changes should be applied.
	// Target file first, then dependent files.
	Order []string `json:"order"`

	// TotalFiles is the number of files affected.
	TotalFiles int `json:"total_files"`

	// TotalChanges is the total number of individual changes.
	TotalChanges int `json:"total_changes"`

	// RiskLevel is the overall risk assessment.
	RiskLevel RiskLevel `json:"risk_level"`

	// Confidence is how confident we are in the plan (0.0-1.0).
	Confidence float64 `json:"confidence"`

	// Warnings contains important warnings about the plan.
	Warnings []string `json:"warnings,omitempty"`

	// Limitations lists what we couldn't analyze.
	Limitations []string `json:"limitations,omitempty"`

	// CreatedAt is when the plan was created (Unix milliseconds UTC).
	CreatedAt int64 `json:"created_at"`
}

type ChangeRequest struct {
	// TargetID is the symbol ID to change.
	TargetID string `json:"target_id"`

	// ChangeType categorizes the change.
	ChangeType ChangeType `json:"change_type"`

	// NewSignature is the proposed new signature (for signature changes).
	NewSignature string `json:"new_signature,omitempty"`

	// NewName is the proposed new name (for renames).
	NewName string `json:"new_name,omitempty"`

	// NewPackage is the target package (for moves).
	NewPackage string `json:"new_package,omitempty"`

	// Description explains the change in human terms.
	Description string `json:"description,omitempty"`
}

type ChangeSet struct {
	// PrimaryChange is the main change being requested.
	PrimaryChange ChangeRequest `json:"primary_change"`

	// Description explains the overall change set.
	Description string `json:"description"`
}

type ChangeType string

type FileChange struct {
	// FilePath is the relative path to the file.
	FilePath string `json:"file_path"`

	// SymbolID is the symbol being changed (if applicable).
	SymbolID string `json:"symbol_id,omitempty"`

	// ChangeType categorizes how this file is affected.
	ChangeType FileChangeType `json:"change_type"`

	// CurrentCode is the current code that will be replaced.
	CurrentCode string `json:"current_code"`

	// ProposedCode is the new code to use.
	ProposedCode string `json:"proposed_code"`

	// StartLine is the 1-indexed starting line of the change.
	StartLine int `json:"start_line"`

	// EndLine is the 1-indexed ending line of the change.
	EndLine int `json:"end_line"`

	// Reason explains why this change is needed.
	Reason string `json:"reason"`
}

type FileChangeType string

type FileDiff struct {
	// FilePath is the relative path to the file.
	FilePath string `json:"file_path"`

	// Hunks contains the diff sections.
	Hunks []Hunk `json:"hunks"`

	// LinesAdded is the total lines added.
	LinesAdded int `json:"lines_added"`

	// LinesRemoved is the total lines removed.
	LinesRemoved int `json:"lines_removed"`

	// ChangeType is how this file is affected.
	ChangeType FileChangeType `json:"change_type"`

	// Reason explains why this file is changing.
	Reason string `json:"reason"`
}

type Hunk struct {
	// StartLine is the 1-indexed starting line in the old file.
	StartLine int `json:"start_line"`

	// OldLines are the lines being removed (with - prefix).
	OldLines []string `json:"old_lines"`

	// NewLines are the lines being added (with + prefix).
	NewLines []string `json:"new_lines"`

	// Context contains context lines around the change.
	Context []string `json:"context,omitempty"`
}

type MultiFileChangeCoordinator struct {
	// contains filtered or unexported fields
}

type NopCRSRecorder struct{}

type PlanOptions struct {
	// MaxCallers limits how many callers to update.
	MaxCallers int

	// MaxHops limits indirect caller depth.
	MaxHops int

	// IncludeTests includes test file updates.
	IncludeTests bool

	// GenerateStubs generates stub implementations for interface changes.
	GenerateStubs bool

	// ContextLines is the number of context lines in diffs.
	ContextLines int
}

type RiskLevel string

type ValidationError struct {
	// FilePath is the file containing the error.
	FilePath string `json:"file_path"`

	// Line is the 1-indexed line number.
	Line int `json:"line"`

	// Message describes the error.
	Message string `json:"message"`

	// Severity indicates how serious the error is.
	Severity string `json:"severity"` // "error", "warning"
}

type ValidationResult struct {
	// Valid indicates if the plan is valid.
	Valid bool `json:"valid"`

	// SyntaxErrors contains parsing errors.
	SyntaxErrors []ValidationError `json:"syntax_errors,omitempty"`

	// TypeErrors contains type-related errors.
	TypeErrors []ValidationError `json:"type_errors,omitempty"`

	// ImportErrors contains import resolution errors.
	ImportErrors []ValidationError `json:"import_errors,omitempty"`

	// Warnings contains non-fatal issues.
	Warnings []string `json:"warnings,omitempty"`
}