controller

type BuildIndexRequest struct {
	RepoName string `json:"repo_name" binding:"required"`
	UseHead  bool   `json:"use_head"` // Use git HEAD version instead of working directory
}

type BuildIndexResponse struct {
	RepoName string `json:"repo_name"`
	Status   string `json:"status"`
	Message  string `json:"message,omitempty"`
}

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

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

type CommitData struct {
	SHA       string
	Author    string
	Date      time.Time
	IsMerge   bool
	FileStats []FileStatData
}

type CommitDiffData struct {
	SHA    string
	Author string
	Date   time.Time
	Hunks  []HunkData
}

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

type ExecuteCypherRequest struct {
	Query  string         `json:"query" binding:"required"`
	Params map[string]any `json:"params"`
}

type FileChurnData struct {
	LinesAdded   int
	LinesDeleted int
	CommitCount  int
	Authors      map[string]bool
	FirstCommit  time.Time
	LastCommit   time.Time
}

type FileContext struct {
	// FileID is the unique identifier for this file version from MySQL
	FileID int32

	// FilePath is the absolute path to the file
	FilePath string

	// RelativePath is the path relative to the repository root
	RelativePath string

	// Content is the file content (already read to avoid multiple I/O)
	Content []byte

	// FileSHA is the SHA256 hash of the file content
	FileSHA string

	// CommitID is the git commit SHA if the file is committed (nil if ephemeral)
	CommitID *string

	// Ephemeral indicates if this is an uncommitted/working directory version
	Ephemeral bool
}

type FileDiffData struct {
	Commits []CommitDiffData
}

type FileProcessor interface {
	// Init initializes the processor for a repository before any files are processed
	// This is called once per repository at the start of processing
	// Use this for setup operations like creating database tables or initializing stores
	Init(ctx context.Context, repo *config.Repository) error

	// ProcessFile processes a single file in the repository
	// ctx: context for cancellation
	// repo: repository configuration
	// fileCtx: file context containing FileID, path, content, and metadata
	// Returns an error if processing fails
	ProcessFile(ctx context.Context, repo *config.Repository, fileCtx *FileContext) error

	// PostProcess performs repository-level operations after all files are processed
	// This is called once after all files have been processed
	PostProcess(ctx context.Context, repo *config.Repository) error

	// Name returns the name of this processor (for logging purposes)
	Name() string
}

type FileStatData struct {
	FilePath     string
	LinesAdded   int
	LinesDeleted int
	// For function-level attribution
	HunkRanges []HunkRange
}

type FindClassesRequest struct {
	RepoName string `json:"repo_name" binding:"required"`
	Name     string `json:"name"`
	NameLike string `json:"name_like"`
	FilePath string `json:"file_path"`
	FileID   *int32 `json:"file_id"`
	Limit    int    `json:"limit"`
	Offset   int    `json:"offset"`
}

type FindMethodsRequest struct {
	RepoName  string      `json:"repo_name" binding:"required"`
	Name      string      `json:"name"`
	NameLike  string      `json:"name_like"`
	ClassName string      `json:"class_name"`
	ClassID   *ast.NodeID `json:"class_id"`
	FilePath  string      `json:"file_path"`
	FileID    *int32      `json:"file_id"`
	Limit     int         `json:"limit"`
	Offset    int         `json:"offset"`
}

type FlexibleFunctionID struct {
	ID           int64
	FunctionName string
	ClassName    string
}

type FunctionChurnMetrics struct {
	LinesAdded   int
	LinesDeleted int
	CommitCount  int
	Authors      map[string]bool
}

type GetCallGraphRequest struct {
	RepoName        string              `json:"repo_name" binding:"required"`
	FunctionID      *FlexibleFunctionID `json:"function_id"`
	FunctionName    string              `json:"function_name"`
	ClassName       string              `json:"class_name"`
	FilePath        string              `json:"file_path"`
	Direction       string              `json:"direction"` // "outgoing", "incoming", "both"
	MaxDepth        int                 `json:"max_depth"`
	IncludeExternal bool                `json:"include_external"`
}

type GetClassRequest struct {
	RepoName       string `json:"repo_name" binding:"required"`
	ClassID        int64  `json:"class_id" binding:"required"`
	IncludeMethods bool   `json:"include_methods"`
	IncludeFields  bool   `json:"include_fields"`
}

type GetCodeSnippetRequest struct {
	RepoName  string `json:"repo_name" binding:"required"`
	FilePath  string `json:"file_path" binding:"required"`
	StartLine int    `json:"start_line" binding:"required,min=1"`
	EndLine   int    `json:"end_line" binding:"required,min=1"`
}

type GetCodeSnippetResponse struct {
	RepoName   string `json:"repo_name"`
	FilePath   string `json:"file_path"`
	StartLine  int    `json:"start_line"`
	EndLine    int    `json:"end_line"`
	Code       string `json:"code"`
	TotalLines int    `json:"total_lines"`
}

type GetDataDependentsRequest struct {
	RepoName        string `json:"repo_name" binding:"required"`
	NodeID          int64  `json:"node_id"`
	VariableName    string `json:"variable_name"`
	FilePath        string `json:"file_path"`
	MaxDepth        int    `json:"max_depth"`
	IncludeIndirect bool   `json:"include_indirect"`
}

type GetEntitySummaryRequest struct {
	RepoName   string `json:"repo_name" binding:"required"`
	FilePath   string `json:"file_path" binding:"required"`
	EntityType string `json:"entity_type" binding:"required"` // "function" or "class"
	EntityName string `json:"entity_name" binding:"required"`
}

type GetFileSummariesRequest struct {
	RepoName   string `json:"repo_name" binding:"required"`
	FilePath   string `json:"file_path" binding:"required"`
	EntityType string `json:"entity_type"` // Optional: "function", "class", or empty for all
}

type GetFileSummariesResponse struct {
	FilePath  string                 `json:"file_path"`
	Summaries []*summary.CodeSummary `json:"summaries"`
	Count     int                    `json:"count"`
}

type GetFileSummaryRequest struct {
	RepoName string `json:"repo_name" binding:"required"`
	FilePath string `json:"file_path" binding:"required"`
}

type GetImpactRequest struct {
	RepoName         string `json:"repo_name" binding:"required"`
	NodeID           int64  `json:"node_id"`
	Name             string `json:"name"`
	NodeType         string `json:"node_type"` // "function", "class", "field", "variable"
	FilePath         string `json:"file_path"`
	MaxDepth         int    `json:"max_depth"`
	IncludeCallGraph bool   `json:"include_call_graph"`
	IncludeDataFlow  bool   `json:"include_data_flow"`
}

type GetMethodRequest struct {
	RepoName string `json:"repo_name" binding:"required"`
	MethodID int64  `json:"method_id" binding:"required"`
}

type GetSummaryStatsRequest struct {
	RepoName string `json:"repo_name" binding:"required"`
}

type GetSummaryStatsResponse struct {
	RepoName string           `json:"repo_name"`
	Stats    *db.SummaryStats `json:"stats"`
}

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

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

type HunkData struct {
	OldStart     int
	OldCount     int
	NewStart     int
	NewCount     int
	LinesAdded   int
	LinesDeleted int
}

type HunkRange struct {
	OldStart int
	OldCount int
	NewStart int
	NewCount int
}

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

type IndexFileRequest struct {
	RepoName      string   `json:"repo_name" binding:"required"`
	RelativePaths []string `json:"relative_paths" binding:"required"`
}

type IndexFileResponse struct {
	RepoName string              `json:"repo_name"`
	Files    []IndexedFileResult `json:"files"`
	Message  string              `json:"message"`
}

type IndexedFileResult struct {
	RelativePath string   `json:"relative_path"`
	FileID       int32    `json:"file_id,omitempty"`
	FileSHA      string   `json:"file_sha,omitempty"`
	Processors   []string `json:"processors_run,omitempty"`
	Success      bool     `json:"success"`
	Error        string   `json:"error,omitempty"`
}

type ListClassesRequest struct {
	RepoName string `json:"repo_name" binding:"required"`
	Limit    int    `json:"limit"`
	Offset   int    `json:"offset"`
}

type ListFilesRequest struct {
	RepoName string `json:"repo_name" binding:"required"`
	Limit    int    `json:"limit"`
	Offset   int    `json:"offset"`
}

type ListMethodsRequest struct {
	RepoName string `json:"repo_name" binding:"required"`
	Limit    int    `json:"limit"`
	Offset   int    `json:"offset"`
}

type ListReposResponse struct {
	Repos []string `json:"repos"`
}

type MethodSignatureResult struct {
	MethodName     string   `json:"method_name"`
	ClassName      string   `json:"class_name,omitempty"`
	Signature      string   `json:"signature"`
	ReturnType     string   `json:"return_type,omitempty"`
	ParameterTypes []string `json:"parameter_types,omitempty"`
	ParameterNames []string `json:"parameter_names,omitempty"`
	FilePath       string   `json:"file_path"`
	StartLine      int      `json:"start_line"`
	EndLine        int      `json:"end_line"`
	Score          float32  `json:"score"`
	NormalizedText string   `json:"normalized_text,omitempty"` // The normalized text used for embedding
}

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

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

type SearchMethodsBySignatureRequest struct {
	RepoName string `json:"repo_name" binding:"required"`
	Query    string `json:"query" binding:"required"` // Natural language query like "find user by email"
	Limit    int    `json:"limit"`                    // Max results (default 10)
}

type SearchMethodsBySignatureResponse struct {
	RepoName string                  `json:"repo_name"`
	Query    string                  `json:"query"`
	Results  []MethodSignatureResult `json:"results"`
	Success  bool                    `json:"success"`
	Message  string                  `json:"message,omitempty"`
}

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

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

type SummaryProcessorConfig struct {
	Enabled      bool
	WorkerCount  int
	SkipIfExists bool // Skip if summary exists and context unchanged
	BatchSize    int
}