graph

type AmbiguousSymbolError struct {
	Input   string
	Matches []SymbolMatch
}

type CallResult struct {
	// Symbol information
	SymbolID   string `json:"symbol_id"`
	SymbolName string `json:"symbol_name"`
	Kind       string `json:"kind"`
	FilePath   string `json:"file_path"`
	Line       int    `json:"line"`

	// Depth from the query target (1 = direct caller/callee).
	Depth int `json:"depth"`

	// Path from root to this symbol (for tree output).
	Path []string `json:"path,omitempty"`
}

type OutputFormat string

type PathNode struct {
	SymbolID   string `json:"symbol_id"`
	SymbolName string `json:"symbol_name"`
	FilePath   string `json:"file_path"`
	Line       int    `json:"line"`
}

type PathQueryResult struct {
	APIVersion string `json:"api_version"`
	Query      string `json:"query"`
	From       string `json:"from"`
	To         string `json:"to"`

	// Paths found (may be multiple if --all)
	Paths []PathResult `json:"paths"`

	// Stats
	PathFound bool `json:"path_found"`
	PathCount int  `json:"path_count"`
	Truncated bool `json:"truncated,omitempty"`
	MaxDepth  int  `json:"max_depth"`

	// Errors/warnings
	Warnings []string `json:"warnings,omitempty"`
}

type PathResult struct {
	// Symbols in the path, from source to target.
	Symbols []PathNode `json:"symbols"`

	// Length of the path (number of hops).
	Length int `json:"length"`
}

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

type QueryConfig struct {
	// MaxDepth limits traversal depth. 0 = unlimited (up to DefaultMaxDepth).
	MaxDepth int

	// MaxResults limits number of results. 0 = unlimited (up to DefaultMaxResults).
	MaxResults int

	// IncludeTests includes test files in results.
	IncludeTests bool

	// IncludeStdlib includes standard library calls.
	IncludeStdlib bool

	// Exact requires exact symbol match (no fuzzy).
	Exact bool

	// FailIfEmpty returns error if no results found.
	FailIfEmpty bool
}

type QueryResult struct {
	APIVersion string `json:"api_version"`
	Query      string `json:"query"`
	Symbol     string `json:"symbol"`

	// Results
	Results []CallResult `json:"results"`

	// Counts
	DirectCount     int `json:"direct_count"`
	TransitiveCount int `json:"transitive_count"`
	TotalCount      int `json:"total_count"`

	// Query info
	MaxDepthUsed int  `json:"max_depth_used"`
	Truncated    bool `json:"truncated,omitempty"`

	// Errors/warnings
	Warnings []string `json:"warnings,omitempty"`
}

type SymbolMatch struct {
	ID       string
	Name     string
	FilePath string
	Line     int
}

type SymbolNotFoundError struct {
	Input       string
	Suggestions []string
}

type SymbolResolver interface {
	// ResolveSymbol resolves a symbol input to a Symbol.
	// Returns nil if not found, error on ambiguous match.
	ResolveSymbol(input string, exact bool) (*initializer.Symbol, error)
}