git

type FileChange struct {
	Path     string // repo-relative, forward slashes; the new path for renames
	OldPath  string // previous path for renames/copies, "" otherwise
	Kind     Kind
	Staged   bool // the index differs from HEAD
	Unstaged bool // the working tree differs from the index (always true for untracked)
	Added    int  // lines added vs HEAD; 0 when Binary
	Deleted  int  // lines deleted vs HEAD; 0 when Binary
	Binary   bool
	// Submodule marks a submodule, or with Kind Untracked a nested repository
	// git does not look into. Neither has lines of its own, so Added and
	// Deleted stay 0.
	Submodule bool
}

type Kind uint8

type Repo struct {
	Name string // path relative to the scan root, forward slashes; the folder name when the root is itself in a repo
	Path string // absolute working-tree root, OS-native separators
}

type Status struct {
	Branch   string // current branch, "" when detached
	Head     string // short commit hash, "" for a repo without commits
	Upstream string
	Ahead    int
	Behind   int
	Files    []FileChange // sorted by Path
	// Fingerprint changes whenever the set of changes or the content of any
	// changed file changes, so polling can skip work when nothing moved. A
	// snapshot taken while a changed file was being written gets a
	// fingerprint of its own, so the next poll is never skipped as a repeat.
	Fingerprint string
}