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 considered unexported by
	// their language conventions: lowercase first letter for Go, and no
	// filtering for Rust (pub visibility cannot be inferred from the name).
	// 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"`
	Imports   []ImportSite `json:"imports,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 ImpactAgentHint string

type ImpactAlternativePlan struct {
	Name                   string   `json:"name"`
	Description            string   `json:"description"`
	ExpectedRiskScoreDelta int      `json:"expected_risk_score_delta"`
	Tradeoffs              []string `json:"tradeoffs,omitempty"`
}

type ImpactBoundary struct {
	Kind        ImpactBoundaryKind `json:"kind"`
	SourceRepo  string             `json:"source_repo"`
	TargetRepo  string             `json:"target_repo"`
	RiskScore   int                `json:"risk_score"`
	ReasonCodes []ImpactReasonCode `json:"reason_codes"`
}

type ImpactBoundaryKind string

type ImpactBreakType string

type ImpactChange struct {
	Kind           ImpactChangeKind `json:"kind"`
	From           string           `json:"from,omitempty"`
	To             string           `json:"to,omitempty"`
	ParamName      string           `json:"param_name,omitempty"`
	ParamTypeFrom  string           `json:"param_type_from,omitempty"`
	ParamTypeTo    string           `json:"param_type_to,omitempty"`
	ReturnTypeFrom string           `json:"return_type_from,omitempty"`
	ReturnTypeTo   string           `json:"return_type_to,omitempty"`
	Notes          string           `json:"notes,omitempty"`
}

type ImpactChangeKind string

type ImpactCheckType string

type ImpactDiagnostics struct {
	IndexRefreshed     bool     `json:"index_refreshed"`
	IndexAgeSeconds    int      `json:"index_age_seconds"`
	WorkspaceLinksUsed int      `json:"workspace_links_used"`
	AnalysisDepth      int      `json:"analysis_depth"`
	Warnings           []string `json:"warnings,omitempty"`
}

type ImpactEdgeType string

type ImpactEvidence struct {
	Type ImpactEdgeType  `json:"type"`
	From ImpactSymbolRef `json:"from"`
	To   ImpactSymbolRef `json:"to"`
	Meta map[string]any  `json:"meta,omitempty"`
}

type ImpactItem struct {
	ID               string             `json:"id"`
	Target           ImpactSymbolRef    `json:"target"`
	Distance         int                `json:"distance"`
	RiskScore        int                `json:"risk_score"`
	Confidence       float64            `json:"confidence"`
	RiskTier         ImpactRiskTier     `json:"risk_tier"`
	Likelihood       ImpactLikelihood   `json:"likelihood"`
	BreakTypes       []ImpactBreakType  `json:"break_types"`
	ReasonCodes      []ImpactReasonCode `json:"reason_codes"`
	Evidence         []ImpactEvidence   `json:"evidence"`
	Owner            *ImpactOwnerRef    `json:"owner,omitempty"`
	SuggestedActions []string           `json:"suggested_actions,omitempty"`
}

type ImpactLikelihood string

type ImpactOptions struct {
	MaxDepth            int  `json:"max_depth,omitempty"`
	IncludeTests        bool `json:"include_tests,omitempty"`
	IncludeCrossRepo    bool `json:"include_cross_repo,omitempty"`
	IncludeAlternatives bool `json:"include_alternatives,omitempty"`
}

type ImpactOwnerNotification struct {
	Owner            ImpactOwnerRef `json:"owner"`
	Reason           string         `json:"reason"`
	Priority         ImpactPriority `json:"priority"`
	RelatedImpactIDs []string       `json:"related_impact_ids,omitempty"`
}

type ImpactOwnerRef struct {
	ID          string          `json:"id"`
	Type        ImpactOwnerType `json:"type"`
	DisplayName string          `json:"display_name,omitempty"`
	Confidence  float64         `json:"confidence,omitempty"`
}

type ImpactOwnerType string

type ImpactPlanningSignals struct {
	RequiresSplitMigration        bool              `json:"requires_split_migration"`
	RequiresCrossRepoCoordination bool              `json:"requires_cross_repo_coordination"`
	RecommendedStrategy           ImpactStrategy    `json:"recommended_strategy"`
	SuggestedBatchCount           int               `json:"suggested_batch_count"`
	SafeToDoInSinglePR            bool              `json:"safe_to_do_in_single_pr"`
	NeedsManualReview             bool              `json:"needs_manual_review"`
	AgentHints                    []ImpactAgentHint `json:"agent_hints,omitempty"`
}

type ImpactPriority string

type ImpactPropagationOptions struct {
	MaxDepth         int                          `json:"max_depth,omitempty"`
	IncludeCrossRepo bool                         `json:"include_cross_repo,omitempty"`
	RepoRoots        map[string]string            `json:"repo_roots,omitempty"`
	WorkspaceLinks   []ImpactWorkspaceLink        `json:"workspace_links,omitempty"`
	Metadata         map[string]map[string]string `json:"metadata,omitempty"`
}

type ImpactPropagationResult struct {
	Start    ImpactSymbolRef `json:"start"`
	Impacts  []ImpactItem    `json:"impacts"`
	Scope    ImpactScope     `json:"scope"`
	Warnings []string        `json:"warnings,omitempty"`
}

type ImpactReasonCode string

type ImpactRecommendedStep struct {
	Step             int      `json:"step"`
	Action           string   `json:"action"`
	Rationale        string   `json:"rationale"`
	RelatedImpactIDs []string `json:"related_impact_ids,omitempty"`
	Blocking         bool     `json:"blocking"`
}

type ImpactRequiredCheck struct {
	ID       string          `json:"id"`
	Type     ImpactCheckType `json:"type"`
	Target   string          `json:"target"`
	Command  string          `json:"command,omitempty"`
	Priority ImpactPriority  `json:"priority"`
	Blocking bool            `json:"blocking"`
	Why      string          `json:"why,omitempty"`
}

type ImpactRiskTier string

type ImpactScope struct {
	DirectCallers      int `json:"direct_callers"`
	IndirectCallers    int `json:"indirect_callers"`
	AffectedSymbols    int `json:"affected_symbols"`
	AffectedFiles      int `json:"affected_files"`
	AffectedRepos      int `json:"affected_repos"`
	CrossBoundaryEdges int `json:"cross_boundary_edges"`
}

type ImpactScoreResult struct {
	Item        ImpactItem               `json:"item"`
	Explanation ImpactScoringExplanation `json:"explanation"`
}

type ImpactScores struct {
	RiskScore  int            `json:"risk_score"`
	Confidence float64        `json:"confidence"`
	RiskTier   ImpactRiskTier `json:"risk_tier"`
}

type ImpactScoringConfig struct {
	BaseByReason           map[ImpactReasonCode]int `json:"base_by_reason,omitempty"`
	BreakTypeWeight        map[ImpactBreakType]int  `json:"break_type_weight,omitempty"`
	DistancePenaltyStep    int                      `json:"distance_penalty_step,omitempty"`
	DistancePenaltyCap     int                      `json:"distance_penalty_cap,omitempty"`
	CrossRepoBonus         int                      `json:"cross_repo_bonus,omitempty"`
	MinConfidence          float64                  `json:"min_confidence,omitempty"`
	MaxConfidence          float64                  `json:"max_confidence,omitempty"`
	ConfidenceDistanceStep float64                  `json:"confidence_distance_step,omitempty"`
	ScoreBoostScale        float64                  `json:"score_boost_scale,omitempty"`
}

type ImpactScoringExplanation struct {
	BaseByReasons      map[ImpactReasonCode]int `json:"base_by_reasons"`
	BreakTypeWeightSum int                      `json:"break_type_weight_sum"`
	DistancePenalty    int                      `json:"distance_penalty"`
	CrossRepoBonus     int                      `json:"cross_repo_bonus"`
	RawScore           int                      `json:"raw_score"`
	FinalScore         int                      `json:"final_score"`
	Confidence         float64                  `json:"confidence"`
	RiskTier           ImpactRiskTier           `json:"risk_tier"`
}

type ImpactSimulationInput struct {
	Symbol    string            `json:"symbol"`
	Workspace string            `json:"workspace"`
	Repo      string            `json:"repo,omitempty"`
	Change    ImpactChange      `json:"change"`
	Options   *ImpactOptions    `json:"options,omitempty"`
	Metadata  map[string]string `json:"metadata,omitempty"`
}

type ImpactSimulationResult struct {
	SchemaVersion      string                    `json:"schema_version"`
	RunID              string                    `json:"run_id"`
	GeneratedAt        string                    `json:"generated_at"`
	Input              ImpactSimulationInput     `json:"input"`
	Scores             ImpactScores              `json:"scores"`
	Scope              ImpactScope               `json:"scope"`
	Summary            ImpactSummary             `json:"summary"`
	Impacts            []ImpactItem              `json:"impacts"`
	HighRiskBoundaries []ImpactBoundary          `json:"high_risk_boundaries"`
	RecommendedOrder   []ImpactRecommendedStep   `json:"recommended_order"`
	RequiredChecks     []ImpactRequiredCheck     `json:"required_checks"`
	NotifyOwners       []ImpactOwnerNotification `json:"notify_owners"`
	Alternatives       []ImpactAlternativePlan   `json:"alternatives"`
	PlanningSignals    ImpactPlanningSignals     `json:"planning_signals"`
	Diagnostics        ImpactDiagnostics         `json:"diagnostics"`
}

type ImpactStrategy string

type ImpactSummary struct {
	Headline string   `json:"headline"`
	Bullets  []string `json:"bullets"`
}

type ImpactSymbolRef struct {
	Symbol string `json:"symbol"`
	File   string `json:"file"`
	Repo   string `json:"repo"`
	Line   int    `json:"line,omitempty"`
}

type ImpactWorkspaceLink struct {
	ID        int64  `json:"id"`
	SrcRepoID string `json:"src_repo_id"`
	SrcSymbol string `json:"src_symbol"`
	SrcFile   string `json:"src_file,omitempty"`
	DstRepoID string `json:"dst_repo_id"`
	DstSymbol string `json:"dst_symbol"`
	DstFile   string `json:"dst_file,omitempty"`
	Note      string `json:"note,omitempty"`
}

type ImportQuery struct {
	FilePath   string // filter by the file that contains the import
	ImportPath string // filter by the imported module/namespace path
}

type ImportRow struct {
	FilePath   string `json:"file_path"`
	ImportPath string `json:"import_path"`
	Alias      string `json:"alias,omitempty"`
	Line       int    `json:"line"`
}

type ImportSite struct {
	ImportPath string `json:"import_path"`
	Alias      string `json:"alias,omitempty"`
	Line       int    `json:"line"`
}

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 NormalizedQuery struct {
	Original string
	Tokens   []NormalizedToken
}

type NormalizedToken struct {
	Original  string
	Canonical string
	Expanded  []string
}

type QueryNormalizer interface {
	NormalizeQuery(q string) NormalizedQuery
}

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 results to symbols in files whose path contains this substring.
	FilePath string

	// Limit caps the number of rows returned. Zero means no limit.
	Limit int
}

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 a deduplicated bag of semantic tokens (identifiers,
	// string literals, comments) extracted from the symbol's full AST subtree.
	// Populated at index time; 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"`
}