facter

type Aggregate struct {
	// Chunks maps a chunk name to the function that computes it.
	Chunks map[string]ChunkFunc
	// Requires maps a chunk name to the chunk names that must run before it. It is
	// the Go analogue of a chunk's :require option and only affects ordering.
	Requires map[string][]string
	// Merge combines the resolved chunk results into the fact's value. When nil,
	// the results are deep-merged. It is the Go analogue of the aggregate block;
	// returning ok=false means the aggregate produced no value.
	Merge func(chunks map[string]any) (any, bool)
}

type ChunkFunc func(ctx *ResolutionContext) (any, bool)

type Confine func(f *Facter) bool

type Engine interface {
	// Value resolves a fact by dotted path (Facter.value / Facter[]).
	Value(path string) (any, bool)
	// ToHash resolves every built-in fact into one nested map.
	ToHash() map[string]any
	// Names lists the registered built-in fact names.
	Names() []string
	// LoadExternalFacts loads external (out-of-process) facts from dirs.
	LoadExternalFacts(dirs ...string) error
}

type Executor interface {
	// Execute runs command and returns its trimmed stdout, or ("", false) on any
	// failure (empty command, launch error, non-zero exit).
	Execute(command string) (string, bool)
	// Which returns the resolved path of binary on PATH, or ("", false) when it is
	// not found.
	Which(binary string) (string, bool)
}

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

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

type Options struct {
	// Weight sets an explicit resolution weight; it only takes effect when
	// HasWeight is true, mirroring Ruby's has_weight. Higher wins.
	Weight int
	// HasWeight marks Weight as explicit. When false, the resolution's weight is
	// the number of its confines, exactly as Ruby Facter defaults it.
	HasWeight bool
	// Timeout bounds how long the resolver may run; zero means no bound. A
	// resolution that times out contributes no value and the next one is tried.
	Timeout time.Duration
	// Confine lists predicates that must all pass for the resolution to be
	// considered.
	Confine []Confine
}

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

type ResolveFunc func(ctx *ResolutionContext) (any, bool)