scanner

type BranchLocation struct {
	// Either "local" or the name of a configured remote.
	Name string

	// Exists is true when this location's ref (refs/heads/<branch> for "local",
	// refs/remotes/<remote>/<branch> otherwise) exists and resolves to a commit;
	// false when the ref is missing.
	Exists bool

	// TipHash is the full hex object name of this ref's tip commit when Exists;
	// empty when not Exists.
	TipHash string
	// TipUnix is the tip commit's committer date in Unix seconds (from git show);
	// zero when not Exists.
	TipUnix int64
	// UniqueCount is commits reachable from this ref but not from any other
	// Exists location for the same branch (local plus each remote in the scan).
	// Zero when not Exists.
	UniqueCount int
	// Incoming/Outgoing compare this ref to the local branch ref only (remote
	// rows). Incoming is commits reachable from this remote but not local (+N);
	// Outgoing is commits on local not reachable from this remote (UI: -M).
	Incoming int
	Outgoing int
	// HistoriesUnrelated means git found no merge base between local and this
	// remote tip; the UI shows "differs" instead of numeric deltas.
	HistoriesUnrelated bool
}

type Config struct {
	ScanDirs struct {
		Include []string `yaml:"include"`
		Exclude []string `yaml:"exclude"`
	} `yaml:"scandirs"`
	GitIgnore struct {
		FileGlob []string `yaml:"fileglob"`
		DirGlob  []string `yaml:"dirglob"`
	} `yaml:"gitignore"`
	FollowSymlinks bool `yaml:"followsymlinks"`
	Branches       struct {
		HideLocalOnly struct {
			Regex []string `yaml:"regex"`
		} `yaml:"hidelocalonly"`
		// Default lists branch short names always shown in the branch pane when
		// present as a local ref, even when tips match every remote.
		Default []string `yaml:"default"`
	} `yaml:"branches"`
	// Edit holds argv for opening a repository from the UI (key "e").
	Edit struct {
		// Command is the program and arguments passed to exec (no shell).
		// Use the literal substring "{repo}" in any element to substitute the
		// absolute repository path. If no element contains "{repo}", the path
		// is appended as the final argument. Empty means ["code", <repo>].
		Command []string `yaml:"command"`
	} `yaml:"edit"`
	// contains filtered or unexported fields
}

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

type LocalBranchRef struct {
	// Name is the short branch name (the refs/heads/* ref without the prefix).
	Name string
	// TipHash is the full object name of the local ref tip; TipUnix is the tip
	// commit's committer date in Unix seconds (from branch listing / git show).
	TipHash string
	TipUnix int64
	// Current is true when this row is the checked-out branch.
	Current bool
	// Locations compares this local branch to same-named refs on each configured
	// remote; see [BranchLocation]. Empty when detached or before branch scan fills it.
	Locations []BranchLocation
}

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

type PorcelainEntry struct {
	// Staging and Worktree are the two status columns (index vs working tree).
	Staging  git.StatusCode
	Worktree git.StatusCode
	// Path is the file path, or the new path for a rename.
	Path string
	// OriginalPath is the old path for a rename; empty when not a rename.
	OriginalPath string
}

type PorcelainStatus struct {
	Entries []PorcelainEntry
}

type RepoStatus struct {
	// Branch is the checked-out branch short name, or when Detached the short
	// HEAD object name (see git rev-parse --short HEAD).
	Branch string

	// Detached is true when HEAD is not on a branch (detached HEAD).
	Detached bool

	// Porcelain is the parsed git status --porcelain output.
	Porcelain PorcelainStatus

	// Full list of local branches with remote comparison data (Branches)
	Branches []LocalBranchRef

	// FilteredBranches is the subset of Branches that pass config filtering
	// (e.g. hide local-only branches matching config patterns). It drives the
	// UI branch pane display and report inclusion decisions. HasUnpushedChanges
	// iterates Branches directly with inline config filtering, so it does not
	// use FilteredBranches. It is always a subset of Branches with the same order.
	FilteredBranches []LocalBranchRef
}

type ScanProgress struct {
	// ReposFound is how many git repositories have been discovered so far.
	ReposFound int
	// ReposChecked is how many of those have finished StatusForRepo (porcelain,
	// branch metadata, and config filtering), not git status alone.
	ReposChecked int
	// CurrentPath is the path currently being processed (for status display).
	CurrentPath string
}