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 CodebaseComponent struct {
	Name        string
	Root        string
	Language    string
	Kind        string // frontend, backend, cli, mobile, shared-library, infrastructure, unknown
	Frameworks  []string
	ConfigFiles []string
	EntryPoints []string
	KeyDirs     []string
	FileCount   int
	Evidence    []string
}

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

	// ParserPlugins adds local executable parsers for project-specific source
	// formats. Plugins are opt-in and run only on the machine indexing the repo.
	ParserPlugins     []ParserPluginConfig
	ParserPluginPaths []string

	// Processing options
	MaxOutputKB   int
	HashAlgorithm HashAlgorithm
	Incremental   bool
	Verbose       bool
	// SkipFileHash avoids reading source contents only to compute metadata that
	// a caller does not consume. Graph scans use file size and modification time
	// to validate their symbol cache, so hashing every source file is redundant.
	SkipFileHash bool

	// SymbolCache lets repeat consumers reuse symbols for unchanged files. The
	// cache is validated against path, language, size, and hash or modification time;
	// missing or stale entries are extracted normally.
	SymbolCache map[string]SymbolCacheEntry

	// Progress receives deterministic scan milestones. It is optional so index
	// generation stays quiet and script-friendly unless a CLI or UI opts in.
	Progress func(ProgressEvent)

	// MaxFilesPerDir caps how many files are listed per directory in the
	// Repository Layout tree. 0 or negative means unlimited (list every file).
	MaxFilesPerDir int

	// MaxFiles caps markdown candidate selection. Structural extraction covers
	// all scanned files for graph consumers. 0 or negative means unlimited.
	MaxFiles int

	// Optional second-pass AI enhancement. The normal high-performance scan still
	// runs first; when enabled, EnhancementFunc receives a bounded macro-analysis
	// prompt and returns additional markdown insights for future agents.
	EnhanceIndex     bool
	EnhancementModel string
	EnhancementFunc  func(prompt string) (string, error)

	// 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 {
	// PackagePath is a repository-resolved package identity, when available.
	PackagePath string `json:",omitempty"`
	// 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 {
	PackagePath string      `json:"package_path,omitempty"`
	ModTimeNano int64       `json:"mod_time_nano,omitempty"`
	Language    string      `json:"language,omitempty"`
	Symbols     *SymbolInfo `json:"symbols,omitempty"`
	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 {
	MaxFiles       int            `json:"max_files"`
	MaxFilesPerDir int            `json:"max_files_per_dir"`
	Format         OutputFormat   `json:"format,omitempty"`
	Version        int            `json:"version,omitempty"`
	Root           string         `json:"root,omitempty"`
	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 ParserPluginAdapter struct {
	// contains filtered or unexported fields
}

type ParserPluginConfig struct {
	Name               string   `yaml:"name" json:"name"`
	Command            string   `yaml:"command" json:"command"`
	Args               []string `yaml:"args,omitempty" json:"args,omitempty"`
	Extensions         []string `yaml:"extensions" json:"extensions"`
	DetectionFiles     []string `yaml:"detection_files,omitempty" json:"detection_files,omitempty"`
	IgnoreDirs         []string `yaml:"ignore_dirs,omitempty" json:"ignore_dirs,omitempty"`
	IgnoreGlobs        []string `yaml:"ignore_globs,omitempty" json:"ignore_globs,omitempty"`
	EntrypointPatterns []string `yaml:"entrypoint_patterns,omitempty" json:"entrypoint_patterns,omitempty"`
	ConfigPatterns     []string `yaml:"config_patterns,omitempty" json:"config_patterns,omitempty"`
	Priority           int      `yaml:"priority,omitempty" json:"priority,omitempty"`
	TimeoutMS          int      `yaml:"timeout_ms,omitempty" json:"timeout_ms,omitempty"`
}

type ParserPluginRequest struct {
	Version  int    `json:"version"`
	Root     string `json:"root"`
	Path     string `json:"path"`
	Content  string `json:"content"`
	MaxBytes int64  `json:"max_bytes"`
}

type ParserPluginResponse struct {
	Symbols *SymbolInfo `json:"symbols"`
	Error   string      `json:"error,omitempty"`
}

type ProgressEvent struct {
	Phase     string
	Current   string
	Completed int
	Total     int
}

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 {
	// GraphFiles contains all scanned files, independent of markdown limits.
	GraphFiles []*FileEntry
	// All files found (before candidate selection)
	Files []*FileEntry

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

	// Directory structure summary
	DirTree *DirNode

	// Macro structure inferred from config files, language roots, and framework
	// indicators. This helps monorepos expose distinct frontend/backend/mobile/CLI
	// components instead of flattening everything into one generic file list.
	IsMonorepo bool
	Components []*CodebaseComponent

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

type StoreLocation string

type SymbolCacheEntry struct {
	Hash     string      `json:"hash,omitempty"`
	Language string      `json:"language"`
	Size     int64       `json:"size"`
	ModTime  int64       `json:"mod_time"`
	Symbols  *SymbolInfo `json:"symbols"`
}

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

	// References are resolved, language-level references to other symbols.
	// Unlike text in a signature, these preserve qualified names such as
	// aws_s3_bucket.logs and can therefore form precise graph edges.
	References []string

	// Framework/library indicators
	Frameworks []string

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

type TerraformAdapter struct{}

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

type TypeScriptAdapter struct{}