buildtarget

type BuildResult struct {
	Service  string
	Tag      string
	Skipped  bool
	SkipMsg  string
	Duration time.Duration
	Err      error
}

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

type Spec struct {
	// Service is the KCL Service.name, surfaced in log lines and used
	// as the ${SERVICE} substitution token.
	Service string

	// Image is the raw Service.image string. Used as the ${IMAGE}
	// substitution token. The user composes the registry into their
	// command via ${REGISTRY}/${IMAGE}:${TAG} (matching External's
	// ${IMAGE} semantics).
	Image string

	// Tag is the build-resolved image tag (git describe or --tag
	// override). Used as the ${TAG} substitution token.
	Tag string

	// TargetArch is the resolved deploy-target GOARCH (amd64/arm64).
	// Used as the ${TARGETARCH} substitution token so user commands
	// can cross-compile and pass --platform=linux/<arch> to docker
	// buildx without re-deriving the arch.
	TargetArch string

	// Registry is the configured docker registry (from forge.yaml
	// docker.registry or the resolved push target). Used as the
	// ${REGISTRY} substitution token.
	Registry string

	// ProjectDir is the project root containing forge.yaml. Used as
	// the ${PROJECT_DIR} substitution token AND as the cwd fallback
	// when BuildCwd is empty.
	ProjectDir string

	// Env is the deploy-env name (dev/staging/prod). Used as the
	// ${ENV} substitution token so a build_cmd can branch on env (e.g.
	// a different Dockerfile or build-arg per env). Mirrors the
	// deploy-side External provider's ${ENV} token.
	Env string

	// BuildCmd is the shell command to exec via `sh -c`. Required —
	// callers should NOT construct a Spec without a build_cmd set.
	BuildCmd string

	// BuildCwd is the working directory the command runs from.
	// Relative paths are resolved against ProjectDir. Empty means
	// "use ProjectDir directly." Missing-on-disk is a warn-and-skip
	// (see Runner.Build).
	BuildCwd string

	// BuildEnv carries extra env vars merged into the command's
	// environment AND added to the substitution map (built-in tokens
	// win on conflict — same precedence External uses).
	BuildEnv map[string]string
}

type State struct {
	Service  string `json:"service"`
	Image    string `json:"image"`
	Tag      string `json:"tag"`
	Registry string `json:"registry,omitempty"`
	PushedAt string `json:"pushed_at"`
	// Digest is the content-addressed manifest digest of the pushed image
	// (canonical `sha256:...`, no `@` prefix, no repo), captured best-effort
	// from the registry after the user's build_cmd builds+pushes. EMPTY when
	// the digest couldn't be resolved (local-only ref, registry unreachable,
	// or buildx/docker absent) — capture never fails the build. Mirrors
	// internal/cli.BuildState.Digest so `forge deploy` pins the immutable
	// `<image>@<digest>` reference for external builds too, instead of
	// falling back to the mutable env tag (the stale-arch-cache footgun).
	Digest string `json:"digest,omitempty"`
	// Platforms is the OS/arch set the pushed manifest advertises, captured
	// alongside Digest. Informational; empty when the lookup failed.
	Platforms []string `json:"platforms,omitempty"`
}