codebaseindex

type Adapter interface {
	// Name returns the adapter identifier (e.g., "go", "python")
	Name() string

	// DetectionFiles returns files that indicate this language is used
	// (e.g., "go.mod", "requirements.txt")
	DetectionFiles() []string

	// FileExtensions returns file extensions this adapter handles
	// (e.g., ".go", ".py")
	FileExtensions() []string

	// IgnoreDirs returns directories to ignore for this language
	// (e.g., "vendor", "node_modules")
	IgnoreDirs() []string

	// IgnoreGlobs returns glob patterns to ignore
	// (e.g., "*.generated.go", "*.min.js")
	IgnoreGlobs() []string

	// EntrypointPatterns returns file patterns that indicate entrypoints
	// (e.g., "main.go", "index.ts")
	EntrypointPatterns() []string

	// ConfigPatterns returns file patterns that indicate config files
	// (e.g., "go.mod", "package.json")
	ConfigPatterns() []string

	// ExtractSymbols extracts symbols from file content
	// Only first maxBytes of content is provided for performance
	ExtractSymbols(path string, content []byte) (*SymbolInfo, error)

	// ScoreFile returns a score modifier for file prioritization
	// Higher scores = more important files
	ScoreFile(path string, depth int, isEntrypoint, isConfig bool) int
}

type AdapterOverride struct {
	IgnoreDirs      []string
	IgnoreGlobs     []string
	PriorityFiles   []string
	ReplaceDefaults bool
}

type ChangeSet struct {
	Added    []*FileEntry
	Modified []*FileEntry
	Deleted  []string
}

type CodeConvention struct {
	Language   string
	Name       string
	Rationale  string
	Guidance   string
	Evidence   []string
	Confidence float64
}

type Config struct {
	// Root path to scan (defaults to current directory)
	Root string

	// Output configuration
	OutputPath    string
	OutputFormat  OutputFormat // summary, structured, or full
	Store         StoreLocation
	Encrypt       bool
	EncryptionKey string

	// Expose configuration
	ExposeVariable bool
	MemoryEnabled  bool
	MemoryKey      string

	// Adapter overrides per language
	AdapterOverrides map[string]*AdapterOverride

	// Processing options
	MaxOutputKB   int
	HashAlgorithm HashAlgorithm
	Incremental   bool
	Verbose       bool

	// qmd integration (optional)
	Qmd *QmdConfig

	// Derived values (computed at runtime)
	RepoFileSlug string // lowercase slug for filenames
	RepoVarSlug  string // uppercase slug for variables
}

type DiffResult struct {
	Added      []string
	Modified   []string
	Deleted    []string
	Unchanged  int
	StoredAt   time.Time
	StoredHash string
}

type DirNode struct {
	Name     string
	Path     string
	Children []*DirNode
	Files    []string // File names only (not full entries)
	Depth    int
}

type FileEntry struct {
	// Relative path from repo root
	Path string

	// File metadata
	Size    int64
	ModTime time.Time
	Hash    string // xxhash or sha256 depending on config

	// Token estimation (Size / 4 as rough approximation)
	EstimatedTokens int

	// Scoring
	Score        int
	Depth        int
	IsEntrypoint bool
	IsConfig     bool
	IsGenerated  bool

	// Language association
	Language string

	// Extracted symbols (populated during extraction phase)
	Symbols *SymbolInfo
}

type FileMetadata struct {
	Path    string `json:"path"`
	Hash    string `json:"hash"`
	Size    int64  `json:"size"`
	ModTime int64  `json:"mod_time"` // Unix timestamp
}

type FlutterAdapter struct{}

type FunctionInfo struct {
	Name       string
	Signature  string
	IsExported bool
	IsMethod   bool
	Receiver   string // For methods
	Comments   string
}

type GoAdapter struct{}

type HashAlgorithm string

type IndexMetadata struct {
	GeneratedAt time.Time      `json:"generated_at"`
	RepoName    string         `json:"repo_name"`
	ContentHash string         `json:"content_hash"`
	FileCount   int            `json:"file_count"`
	Files       []FileMetadata `json:"files"`
	Languages   []string       `json:"languages"`
}

type JavaAdapter struct{}

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

type OutputFormat string

type PythonAdapter struct{}

type QmdConfig struct {
	// Collection name to register with qmd
	Collection string `yaml:"collection"`

	// Whether to run qmd embed after registration
	Embed bool `yaml:"embed"`

	// Context description for the collection
	Context string `yaml:"context"`

	// File mask for indexing (default: "**/*.md")
	Mask string `yaml:"mask"`

	// Enable TurboQuant vector quantization on embeddings
	Quantize bool `yaml:"quantize,omitempty"`

	// Quantization bit width: 1-4 (default: 2)
	QuantizeBits int `yaml:"quantize_bits,omitempty"`
}

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

type Result struct {
	// The generated markdown content (primary format)
	Content string

	// Additional format outputs (generated on demand)
	Summary    string // Always generated - compact overview for agents
	Structured string // Categorized index if format != summary
	Full       string // Complete index if format == full

	// Path where the index was written
	OutputPath string

	// Hash of the plaintext content
	ContentHash string

	// Whether the index was updated (for incremental mode)
	Updated bool

	// Format used for Content
	Format OutputFormat

	// Metadata
	GeneratedAt time.Time
	RepoName    string
	Languages   []string
	FileCount   int
	Duration    time.Duration

	// Categorization (populated during structured/full generation)
	Categories map[string][]string // category -> file paths
}

type ScanResult struct {
	// All files found (before candidate selection)
	Files []*FileEntry

	// Selected candidate files for indexing
	Candidates []*FileEntry

	// Directory structure summary
	DirTree *DirNode

	// Statistics
	TotalFiles    int
	TotalDirs     int
	IgnoredFiles  int
	IgnoredDirs   int
	TotalBytes    int64
	ProcessedTime time.Duration
}

type StoreLocation string

type SymbolInfo struct {
	// Package/module declaration
	Package string

	// Imports/dependencies
	Imports []string

	// Functions and methods
	Functions []FunctionInfo

	// Types (structs, classes, interfaces)
	Types []TypeInfo

	// Constants and variables
	Constants []string
	Variables []string

	// Framework/library indicators
	Frameworks []string

	// Risk indicators (auth, crypto, db, concurrency)
	RiskTags []string
}

type TypeInfo struct {
	Name       string
	Kind       string // struct, interface, class, enum, etc.
	IsExported bool
	Fields     []string
	Methods    []string
	Comments   string
}

type TypeScriptAdapter struct{}