bootstrapspec

type Entry struct {
	// Raw is the compact-JSON entry as resolved (used verbatim in the
	// "addon not found" error, like bash's ${entry}).
	Raw string
	// Key is the <name-or-path> as written (bash: _raw).
	Key string
	// Name is the entry identity: basename / map-key, or the explicit
	// `name:` override.
	Name string
	// Dir is the resolved addon directory (never changed by `name:`).
	Dir string
	// Explicit reports whether Name came from an explicit `name:` override
	// (a name collision on it is a hard error, not a tolerated clash).
	Explicit bool
	// Builtin reports a bare framework-addon entry (Dir resolved through
	// internal/assets: the project's .lok8s/addons/<name> when present, else
	// the copy embedded in the binary) as opposed to a cluster-local target
	// or an absolute path.
	Builtin bool
	// Legacy is the whole-map-is-helm-values shim: Value is the inline
	// helm values.
	Legacy bool
	// Value is the map value (nil for a scalar entry or a null value).
	Value *yaml.Node
	// Values is the `values:` node, nil when the key is absent (a present
	// key with a null value is a null node).
	Values *yaml.Node
	// ValueFiles are the `valueFiles:` paths, resolved against the cluster
	// dir; every one exists.
	ValueFiles []string
	// Env are the `env:` KEY=tostring(value) pairs, in map order (an empty
	// key is dropped).
	Env []EnvVar
	// Wait marks a global barrier gate (`wait: true`).
	Wait bool
	// Deps are the dependsOn entry names, in order.
	Deps []string
	// contains filtered or unexported fields
}

type EnvVar struct {
	Key   string
	Value string
}

type Item struct {
	Raw  string
	Node *yaml.Node
}

type Parser struct {
	Paths *config.Paths
	// Report receives each validation failure as a printf pair (the bash
	// error() text, without the [error] prefix). nil = silent.
	Report func(format string, a ...any)
	// MergeValueFiles runs at the point bash merged valueFiles (files in
	// list order, the inline `values:` on top). values is the `values:`
	// node, nil when absent. A non-nil error fails the entry with the bash
	// "failed to merge" message. nil = no merge.
	MergeValueFiles func(files []string, values *yaml.Node) error
}