search

type IndexStats struct {
	TotalDocs   uint64 `json:"total_docs"`
	IndexedAt   string `json:"indexed_at,omitempty"`
	IndexPath   string `json:"index_path,omitempty"`
	StorageSize int64  `json:"storage_size_bytes,omitempty"`
}

type IndexedNode struct {
	ID         string `json:"id"`
	Type       string `json:"type"`
	Label      string `json:"label"`
	Doc        string `json:"doc"`         // Docstring/description
	Package    string `json:"package"`     // Package name
	SourceFile string `json:"source_file"` // File path
	Module     string `json:"module"`      // Module name
	Signature  string `json:"signature"`   // Function/method signature
	AllText    string `json:"all_text"`    // Combined searchable text
}

type SearchOptions struct {
	Limit     int      // Maximum results to return (default 20)
	Offset    int      // Skip first N results
	NodeTypes []string // Filter by node types (function, class, etc.)
	FuzzyDist int      // Fuzzy matching edit distance (0=exact, 1-2=fuzzy)
	Highlight bool     // Include highlighted fragments
}

type SearchOutput struct {
	Query      string          `json:"query"`
	TotalHits  uint64          `json:"total_hits"`
	MaxScore   float64         `json:"max_score"`
	Results    []*SearchResult `json:"results"`
	Took       string          `json:"took"`
	Facets     map[string]any  `json:"facets,omitempty"`
	Truncated  bool            `json:"truncated,omitempty"`
	IndexStats *IndexStats     `json:"index_stats,omitempty"`
}

type SearchResult struct {
	ID         string   `json:"id"`
	Score      float64  `json:"score"`
	Type       string   `json:"type"`
	Label      string   `json:"label,omitempty"`
	Package    string   `json:"package,omitempty"`
	SourceFile string   `json:"source_file,omitempty"`
	Snippet    string   `json:"snippet,omitempty"`
	Fragments  []string `json:"fragments,omitempty"`
}

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