pipeline

type BuildContext struct {
	Opts           PipelineOptions
	Config         *types.ForgeConfig
	Spec           *agentspec.AgentSpec
	GeneratedFiles map[string]string // relPath -> absPath
	Warnings       []string
	Verbose        bool
	PluginConfig   *plugins.AgentConfig // Set by FrameworkAdapterStage
	WrapperFile    string               // Relative path to generated wrapper (empty = no wrapper)

	// Container packaging extensions
	DevMode            bool
	ProdMode           bool
	EgressResolved     any // *egress.EgressConfig (avoid import cycle)
	SkillRequirements  any // *skills.AggregatedRequirements (avoid import cycle)
	SkillEntries       any // []contract.SkillEntry (avoid import cycle)
	SecurityAudit      any // *analyzer.AuditReport (avoid import cycle)
	SkillsCount        int
	ToolCategoryCounts map[string]int

	// SkillPipRequirements holds container-relative paths to skill
	// requirements.txt files (e.g. "skills/pdf-tools/requirements.txt")
	// discovered under skills/. Each becomes a `pip install -r` step in the
	// generated Dockerfile, and their presence forces python3/pip into the
	// bin manifest so the interpreter is provisioned (#405 D1).
	SkillPipRequirements []string

	// Bin resolution for smart Dockerfile generation
	BinManifest  any // *packaging.BinManifest (avoid import cycle)
	PreferAlpine bool
	PreferSlim   bool

	// ForgeCLIVersion is the version of the forge CLI binary (e.g. "v0.9.0").
	// Used to pull the correct release when framework is "forge".
	ForgeCLIVersion string

	// LocalBins maps binary name → host file path (from --local-bin flags).
	LocalBins map[string]string
}

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

type PipelineOptions struct {
	WorkDir        string
	OutputDir      string
	ConfigPath     string
	Env            map[string]string
	SigningKeyPath string // Ed25519 private key for signing build output
}

type Stage interface {
	Name() string
	Execute(ctx context.Context, bc *BuildContext) error
}