docs

type BuildCommand struct {
	Name    string // e.g., "build", "test", "lint"
	Command string // e.g., "go build ./..."
	Source  string // which file suggested it
}

type CodePattern struct {
	Name        string // e.g., "Cobra CLI", "Registry Pattern"
	Description string
}

type Detection struct {
	File       string
	Components []TechComponent
	Commands   []BuildCommand
}

type Detector struct {
	File   string // filename to look for, e.g., "go.mod"
	Detect func(repoPath string) *Detection
}

type DirEntry struct {
	Path  string
	IsDir bool
	Depth int
}

type RepoAnalysis struct {
	Name          string
	Language      string
	Description   string
	DirectoryTree []DirEntry
	TechStack     []TechComponent
	BuildCommands []BuildCommand
	Patterns      []CodePattern
	HasREADME     bool
	HasAGENTSMD   bool
}

type TechComponent struct {
	Name    string // e.g., "Go", "Node.js", "Python"
	Version string // e.g., "1.24", "18", "3.11"
	Source  string // file that detected it, e.g., "go.mod"
}