ingest

type CloneOpts struct {
	// Slug is the owner/repo slug used for directory naming.
	Slug string

	// Ref is the branch, tag, or commit SHA to check out.
	// Empty means the default branch.
	Ref string

	// DestDir is the parent directory where the clone will be placed.
	// A subdirectory named after the repo slug will be created inside.
	DestDir string

	// GithubToken is used for authenticated clones (private repos, higher rate limits).
	// Ignored when CloneURL is set (the URL already encodes credentials).
	GithubToken string

	// CloneURL is a pre-built HTTPS clone URL. When non-empty, it is used
	// directly and the GitHub-specific URL building logic is skipped.
	// Slug is still required for directory naming.
	CloneURL string

	// TokenFunc returns a fresh token for authenticated git operations.
	// When set, it is called before each refreshClone to obtain a current
	// installation token (ghs_, ~1h TTL). Overrides GithubToken for refreshes.
	// When nil, refreshClone relies on credentials embedded in .git/config.
	TokenFunc func(ctx context.Context) (string, error)
}

type CloneResult struct {
	// LocalPath is the absolute path to the cloned repository root.
	LocalPath string

	// Ref is the actual ref checked out (may differ if HEAD was resolved)..
	Ref string
}

type File struct {
	// Path is the absolute path to the file on disk.
	Path string

	// RelPath is the path relative to the repository root.
	RelPath string

	// Language is the detected programming language (e.g. "go", "python").
	Language string

	// Size is the file size in bytes.
	Size int64

	// ModTime is the file modification time.
	ModTime time.Time
}

type IngestOpts struct {
	// Root is the repository root directory (must already be on disk).
	Root string

	// Focus limits ingestion to files matching this glob pattern, subdirectory
	// prefix, or space-separated keywords (matched case-insensitively against
	// the relative path). Empty means ingest everything.
	Focus string

	// Languages limits ingestion to files of these languages.
	// Empty means accept all supported languages.
	Languages []string

	// MaxFileBytes skips files larger than this size. 0 means no limit.
	MaxFileBytes int64

	// MaxFiles is the maximum number of files to keep from the walk.
	// 0 means use the default cap (maxWalkFiles).
	MaxFiles int

	// FollowSymlinks controls whether symlinks are followed.
	FollowSymlinks bool

	// ExcludeTests skips test files (*_test.go) when true.
	ExcludeTests bool
}

type IngestResult struct {
	// Files is the ordered list of source files.
	Files []*File

	// Root is the repository root used for ingestion.
	Root string

	// TotalBytes is the total size of all ingested files.
	TotalBytes int64

	// SkippedCount is the number of files skipped (too large, ignored, binary).
	SkippedCount int

	// SkippedReasons tallies the number of silently-dropped files per reason.
	// Reasons: "gitignored", "test_excluded", "language_filter",
	// "oversize", "focus_excluded", "unknown_extension".
	// A file may be silently excluded (not counted in SkippedCount) for some
	// of these reasons — SkippedReasons captures all of them.
	SkippedReasons map[string]int
}

type WPPluginMeta struct {
	Name           string `json:"name"`
	Slug           string `json:"slug"`
	Version        string `json:"version"`
	DownloadLink   string `json:"download_link"`
	Author         string `json:"author"`
	ActiveInstalls int    `json:"active_installs"`
}

type WPPluginOpts struct {
	Slug    string
	Version string // optional; empty = latest
	DestDir string
}

type WPSearchResponse struct {
	Info    wpSearchInfo     `json:"info"`
	Page    int              `json:"-"`
	Pages   int              `json:"-"`
	Plugins []WPSearchResult `json:"plugins"`
}

type WPSearchResult struct {
	Name             string `json:"name"`
	Slug             string `json:"slug"`
	Version          string `json:"version"`
	Author           string `json:"author"`
	Rating           int    `json:"rating"`
	ActiveInstalls   int    `json:"active_installs"`
	ShortDescription string `json:"short_description"`
	DownloadLink     string `json:"download_link"`
}