git

type Scope struct {
	// Paths restricts the checkout to these directories. Empty means the whole repository.
	//
	// Directory prefixes, not general globs: `services/web` and `services/web/**` both mean the
	// same subtree. That is what sparse checkout can express, and expressing it any other way
	// would mean downloading the repository to throw most of it away.
	Paths []string

	// Ignore removes matching paths after checkout, applied last so it can carve out of Paths.
	// Gitignore-style: a trailing `/` matches a directory and everything under it, `*` matches
	// within a path segment, `**` matches across them.
	Ignore []string
}

type Tree struct {
	// Dir is the checkout on disk.
	Dir string
	// Revision is the SHA that was materialised, as `git rev-parse HEAD` reports it. Empty only
	// when git could not be asked, which is not worth failing a scan over.
	Revision string
	// Dirty counts uncommitted files in the source. For a clone they are what the tree is
	// missing; for a working-tree copy they are what it uniquely contains. WorkingTree says
	// which, so nothing has to infer it from a count.
	Dirty int
	// WorkingTree reports that this copy came from a checkout on disk, uncommitted work included,
	// rather than from a commit — so it is not reproducible.
	WorkingTree bool
}