recipebuilder

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

type Config struct {
	// CloudboxBase is the cloudbox origin (scheme+host); recipesPath is appended.
	CloudboxBase string
	// AccessToken is the per-outpost bearer; must carry recipes:read.
	AccessToken string
	// RuntimeContainer is the <AgentName>-runtime container whose k3s containerd
	// receives the built images.
	RuntimeContainer string
	// WorkDir holds cloned git build contexts. Empty → <TempDir>/outpost-recipes.
	WorkDir string
	// Platform is the build target, e.g. "linux/arm64". Empty → linux/<GOARCH>
	// (native — the whole point: no cross-arch, no manifest lists).
	Platform string
	// Interval between polls. <=0 → defaultInterval.
	Interval time.Duration
	// HTTPClient for the recipe fetch. nil → http.DefaultClient.
	HTTPClient *http.Client
	// Runner performs clone/build/load. nil → a bashy-shelling execRunner
	// (BashyBin must then be set).
	Runner Runner
	// BashyBin is the resolved `bashy` executable for the default execRunner.
	BashyBin string
}

type InlineRecipeSpec struct {
	Name       string
	Tag        string
	LocalRef   string
	ContextDir string
	Dockerfile string
	Includes   []string
	BaseImages []string
}

type Recipe struct {
	Name           string
	Tag            string
	LocalRef       string   // what the node loads it as (localhost/cluster/<n>)
	ContextType    string   // git | local | inline_tar
	ContextRepo    string   // git remote (context_type=git)
	ContextRef     string   // pinned commit/ref (context_type=git)
	ContextSubdir  string   // build context root within the checkout
	ContextPath    string   // local path (context_type=local; same-host only)
	ContextArchive string   // base64 tar or tar.gz bytes (context_type=inline_tar)
	Dockerfile     string   // relative to the context root
	BaseImages     []string // declared bases (mirrored to GHCR out of band)
	ContextSha256  string   // provenance of source (verified, not output digest)
}

type Runner interface {
	// Clone resolves a git build context (repo@ref) into dest.
	Clone(ctx context.Context, repo, ref, dest string) error
	// Build builds contextDir's dockerfile natively into ref.
	Build(ctx context.Context, platform, dockerfile, ref, contextDir string) error
	// Load streams the built image into the node's k3s containerd (via the
	// <name>-runtime container's `k3s ctr images import`).
	Load(ctx context.Context, ref, runtimeContainer string) error
	// ImagePresent checks the image store of the current runtime container, not
	// the host build cache. Runtime recreation can erase containerd while the
	// recipe digest remains unchanged.
	ImagePresent(ctx context.Context, ref, runtimeContainer string) (bool, error)
}