appbundle

type ActionTemplate struct {
	ID   string `json:"id"`
	Name string `json:"name"`
	// CronSchedule is a five-field cron expression evaluated in UTC. Empty
	// means manual dispatch only.
	CronSchedule  string          `json:"cron_schedule,omitempty"`
	JobType       string          `json:"job_type"`
	JobGroup      string          `json:"job_group"`
	JobOperation  string          `json:"job_operation"`
	CompositePlan json.RawMessage `json:"composite_plan"`
}

type ComponentSpec struct {
	InstallComponentID string `json:"install_component_id"`
	ComponentID        string `json:"component_id"`
	ComponentName      string `json:"component_name"`
	ComponentType      string `json:"component_type"`
	HelmReleaseName    string `json:"helm_release_name,omitempty"`
	HelmNamespace      string `json:"helm_namespace,omitempty"`
}

type DriftTemplate struct {
	ID            string          `json:"id"`
	ComponentID   string          `json:"component_id,omitempty"`
	ComponentName string          `json:"component_name"`
	JobType       string          `json:"job_type"`
	JobGroup      string          `json:"job_group"`
	JobOperation  string          `json:"job_operation"`
	CompositePlan json.RawMessage `json:"composite_plan"`
}

type Envelope struct {
	Version   string          `json:"version"`
	OrgID     string          `json:"org_id"`
	AppID     string          `json:"app_id"`
	InstallID string          `json:"install_id"`
	CreatedAt time.Time       `json:"created_at"`
	Source    string          `json:"source"`
	AppConfig json.RawMessage `json:"app_config,omitempty"`
	Inputs    []InputSpec     `json:"inputs,omitempty"`
	// ForceDefaultCloudAuth rewrites every cloud-auth block in the composite
	// plans to use the runner process's ambient credentials. Exported plans
	// reference roles provisioned by the sandbox, which don't exist yet when
	// an offline run starts from scratch.
	ForceDefaultCloudAuth bool            `json:"force_default_cloud_auth,omitempty"`
	Components            []ComponentSpec `json:"components,omitempty"`
	Steps                 []Step          `json:"steps"`
	// Operation templates are immutable execution templates, not saved plans:
	// every run instantiates a fresh runtime job from the pinned plan.
	Actions  []ActionTemplate  `json:"actions,omitempty"`
	Drift    []DriftTemplate   `json:"drift,omitempty"`
	Runbooks []RunbookTemplate `json:"runbooks,omitempty"`
	// OutputBindings map component-output placeholder tokens baked into
	// composite plans to the producing step's terraform outputs, letting the
	// runner render cross-component references after the producer applies.
	OutputBindings []OutputBinding `json:"output_bindings,omitempty"`
}

type InputSpec struct {
	Name        string `json:"name"`
	Type        string `json:"type"`
	Description string `json:"description,omitempty"`
	Secret      bool   `json:"secret,omitempty"`
	Required    bool   `json:"required,omitempty"`
	Default     string `json:"default,omitempty"`
	// Bindable reports whether plan export replaced this input's reference
	// value with a placeholder, so a customer-supplied value takes effect
	// offline. Non-bindable inputs keep the value baked at publish time.
	Bindable bool `json:"bindable,omitempty"`
}

type OutputBinding struct {
	Token         string `json:"token"`
	ComponentName string `json:"component_name"`
	StepID        string `json:"step_id"`
	OutputPath    string `json:"output_path"`
}

type RunbookStep struct {
	Kind  string `json:"kind"`
	RefID string `json:"ref_id,omitempty"`
	// Component scopes a health-gate to one component by name; empty gates
	// on every component's health.
	Component string `json:"component,omitempty"`
}

type RunbookTemplate struct {
	ID    string        `json:"id"`
	Name  string        `json:"name"`
	Steps []RunbookStep `json:"steps"`
}

type Step struct {
	ID           string   `json:"id"`
	Name         string   `json:"name"`
	JobType      string   `json:"job_type"`
	JobOperation string   `json:"job_operation"`
	JobGroup     string   `json:"job_group"`
	DependsOn    []string `json:"depends_on,omitempty"`
	// PlanFromStep names an earlier step whose execution result (a rendered
	// plan, e.g. a tfplan) is injected into this step's composite plan as
	// apply_plan_contents at fetch time. This replaces the control plane's
	// plan-approval chaining for offline runs.
	PlanFromStep  string          `json:"plan_from_step,omitempty"`
	CompositePlan json.RawMessage `json:"composite_plan"`
}