indexer

type CallSite struct {
	CalleeName string `json:"callee_name"`
	Line       int    `json:"line"`
}

type CallerNode struct {
	CallerFile string       `json:"caller_file"`
	CallerName string       `json:"caller_name"` // empty string means file scope
	CalleeName string       `json:"callee_name"`
	Line       int          `json:"line"`
	Cycle      bool         `json:"cycle,omitempty"` // true when this node was already seen — not expanded
	Callers    []CallerNode `json:"callers,omitempty"`
}

type CallerRow struct {
	CallerFile string `json:"caller_file"` // file that contains the call
	CallerName string `json:"caller_name"` // enclosing symbol (empty = file scope)
	CalleeName string `json:"callee_name"` // the symbol being called (== queried name)
	Line       int    `json:"line"`        // 1-based line of the call site
}

type DeadCodeQuery struct {
	// Type restricts results to a specific symbol type (e.g. "function", "method").
	// Empty means all callable types (function + method).
	Type string

	// FilePath filters results to symbols in files whose path contains this substring.
	FilePath string

	// UnexportedOnly restricts results to symbols whose name starts with a
	// lowercase letter — i.e. unexported in Go convention. Reduces false
	// positives for public APIs.
	UnexportedOnly bool
}

type DeadSymbol struct {
	Name     string `json:"name"`
	Type     string `json:"type"`
	FilePath string `json:"file_path"`
	Line     int    `json:"line"`
}

type DirNode struct {
	Path        string          `json:"path"`                // relative directory path, e.g. "pkg/indexer"
	FileCount   int             `json:"file_count"`          // files directly in this dir
	SymbolCount int             `json:"symbol_count"`        // symbols across all files in this dir
	Languages   map[string]int  `json:"languages,omitempty"` // language → file count for this dir
	Children    []*DirNode      `json:"children,omitempty"`  // sorted subdirectories
	Files       []FileTreeEntry `json:"files,omitempty"`     // immediate files in this dir
}

type FileEntry struct {
	Language  string       `json:"language"`
	SHA256    string       `json:"sha256"`
	Mtime     string       `json:"mtime"` // RFC3339 UTC mtime recorded at index time
	Size      int64        `json:"size"`  // file size in bytes recorded at index time
	IndexedAt time.Time    `json:"indexed_at"`
	Symbols   []SymbolInfo `json:"symbols"`
	Calls     []CallSite   `json:"calls,omitempty"`
}

type FileError struct {
	Path string
	Err  error
}

type FileMeta struct {
	Hash  string // sha256 hex
	Mtime string // RFC3339 UTC modification time at index time
	Size  int64  // file size in bytes at index time
}

type FileTreeEntry struct {
	Path        string `json:"path"`
	Language    string `json:"language"`
	SymbolCount int    `json:"symbol_count"`
}

type HotspotEntry struct {
	CalleeName string `json:"callee_name"`
	CallCount  int    `json:"call_count"`
	FilePath   string `json:"file_path"` // empty when callee is not in the symbol index (e.g. stdlib)
}

type IndexStats struct {
	Unchanged  int
	Updated    int
	Added      int
	Removed    int
	Errors     int
	FileErrors []FileError
}

type LanguageStat struct {
	Language    string `json:"language"`
	FileCount   int    `json:"file_count"`
	SymbolCount int    `json:"symbol_count"`
}

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

type RefQuery struct {
	CallerFile string // filter by the file that contains the call
	CallerName string // filter by the enclosing symbol name
	CalleeName string // filter by the name of the called function/method
}

type RefRow struct {
	ID         int    `json:"id"`
	CallerFile string `json:"caller_file"`
	CallerName string `json:"caller_name"`
	CalleeName string `json:"callee_name"`
	Line       int    `json:"line"`
}

type RepoReport struct {
	RepoID      string           `json:"repo_id"`
	Root        string           `json:"root"`
	GitHead     string           `json:"git_head,omitempty"`
	IndexedAt   string           `json:"indexed_at"`
	FileCount   int              `json:"file_count"`
	SymbolCount int              `json:"symbol_count"`
	Languages   []LanguageStat   `json:"languages"`
	SymbolTypes []SymbolTypeStat `json:"symbol_types"`
}

type SchemaMismatchError struct {
	Stored  int // version recorded in the existing index
	Current int // version expected by this binary
}

type SearchQuery struct {
	// Name matches the symbol name exactly (case-sensitive).
	Name string

	// NameLike matches symbol names using SQL LIKE with a trailing wildcard
	// (e.g. "Foo" becomes "Foo%"). Ignored when Name is set.
	NameLike string

	// FuzzyName performs an FTS5 MATCH query over symbol names.
	// Supports prefix queries (e.g. "Exec*"), multi-token ("execute async"),
	// and phrase search ("\"execute async\"").
	// Ignored when Name is set. Takes precedence over NameLike.
	FuzzyName string

	// Parent matches the enclosing class/struct/interface name exactly.
	// Use "*" to match any non-empty parent (i.e. any method of any class).
	Parent string

	// Type filters by symbol type (e.g. Function, Method, Class).
	// Zero value means no type filter.
	Type SymbolType

	// FilePath filters to symbols belonging to this exact file path.
	FilePath string
}

type SymbolInfo struct {
	Name      string     `json:"name"`
	Type      SymbolType `json:"type"`
	StartLine int        `json:"start_line"`
	EndLine   int        `json:"end_line"`
	// Parent holds the name of the enclosing class/struct/interface for methods,
	// constructors, and properties. Empty for top-level symbols.
	Parent string `json:"parent,omitempty"`
	// BodySnippet holds the first up-to-10 lines of the symbol's source body.
	// Populated at index time from the already-read file bytes; not persisted
	// in query results (omitempty keeps JSON output clean).
	BodySnippet string `json:"body_snippet,omitempty"`
}

type SymbolRow struct {
	SymbolInfo
	FilePath string `json:"file_path"`
}

type SymbolType string

type SymbolTypeStat struct {
	Type  string `json:"type"`
	Count int    `json:"count"`
}